@aurodesignsystem-dev/auro-formkit 0.0.0-pr1491.1 → 0.0.0-pr1491.2

package/custom-elements.json

@@ -7832,128 +7832,174 @@
     },
     {
       "kind": "javascript-module",
-      "path": "components/form/src/auro-form.js",
+      "path": "components/dropdown/src/auro-dropdown.js",
       "declarations": [
         {
           "kind": "class",
-          "description": "The `auro-form` element provides users a way to create and manage forms in a consistent manner.",
-          "name": "AuroForm",
+          "description": "The `auro-dropdown` element provides a way to place content in a bib that can be toggled.",
+          "name": "AuroDropdown",
+          "cssParts": [
+            {
+              "description": "The trigger content container.",
+              "name": "trigger"
+            },
+            {
+              "description": "The collapsed/expanded state icon container.",
+              "name": "chevron"
+            },
+            {
+              "description": "The size of the dropdown bib. (height, width, maxHeight, maxWidth only)",
+              "name": "size"
+            },
+            {
+              "description": "The helpText content container.",
+              "name": "helpText"
+            }
+          ],
           "slots": [
             {
-              "description": "The default slot for form elements.",
-              "name": "default"
+              "description": "Default slot for the dropdown bib content.",
+              "name": ""
+            },
+            {
+              "description": "Defines the content of the helpText.",
+              "name": "helpText"
+            },
+            {
+              "description": "Defines the content of the trigger.",
+              "name": "trigger"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "formElementTags",
+              "name": "shadowRootOptions",
               "static": true,
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "commonWrapperClasses",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "object"
+                }
+              },
+              "readonly": true
+            },
             {
               "kind": "method",
-              "name": "_isElementTag",
-              "parameters": [
-                {
-                  "name": "elementTag",
-                  "description": "The HTML tag name like `auro-datepicker`.",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "element",
-                  "description": "The actual HTML element to compare.",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
+              "name": "_intializeDefaults",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
                 }
-              ],
-              "description": "Compare tag name with element to identify it (for API purposes).",
+              }
+            },
+            {
+              "kind": "method",
+              "name": "hide",
+              "description": "Public method to hide the dropdown.",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "void"
                 }
-              },
-              "privacy": "private"
+              }
             },
             {
               "kind": "method",
-              "name": "_isInElementCollection",
+              "name": "show",
+              "description": "Public method to show the dropdown.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "focus",
+              "description": "When bib is open, focus on the first element inside of bib.\nIf not, trigger element will get focus."
+            },
+            {
+              "kind": "method",
+              "name": "setActiveDescendant",
               "parameters": [
-                {
-                  "name": "collection",
-                  "description": "The array to use for tag name search.",
-                  "type": {
-                    "text": "string[]"
-                  }
-                },
                 {
                   "name": "element",
-                  "description": "The element to compare against the master list.",
+                  "description": "The element to set as the active descendant, or null to clear.",
                   "type": {
-                    "text": "HTMLElement"
+                    "text": "HTMLElement|null"
                   }
                 }
               ],
-              "description": "Shared code for determining if an element is something we care about (submit, form element, etc.).",
+              "description": "Sets the active descendant element for accessibility.\nUses ariaActiveDescendantElement to cross shadow DOM boundaries.\nThis function is used in components that contain `auro-dropdown` to set the active descendant.",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "void"
                 }
-              },
-              "privacy": "private"
+              }
             },
             {
               "kind": "method",
-              "name": "isFormElement",
+              "name": "register",
+              "static": true,
               "parameters": [
                 {
-                  "name": "element",
-                  "description": "The element to check (attr or tag name).",
+                  "name": "name",
+                  "default": "\"auro-dropdown\"",
+                  "description": "The name of the element that you want to register.",
+                  "optional": true,
                   "type": {
-                    "text": "HTMLElement"
+                    "text": "string"
                   }
                 }
               ],
-              "description": "Check if the tag name is a form element.",
+              "description": "This will register this element with the browser."
+            },
+            {
+              "kind": "field",
+              "name": "focusableEntityQuery",
+              "description": "Accessor for reusing the focusable entity query string.",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "string"
                 }
               },
-              "privacy": "private"
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "_eventIsValidFormEvent",
+              "name": "handleDropdownToggle",
               "parameters": [
                 {
                   "name": "event",
-                  "description": "The event to validate.",
+                  "description": "The custom event that contains the dropdown toggle information.",
                   "type": {
-                    "text": "Event"
+                    "text": "CustomEvent"
                   }
                 }
               ],
-              "description": "Validates if an event is from a valid form element with a name.",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
+              "description": "Handles the custom event `auroDropdown-toggled` to update the visibility of the dropdown bib.",
               "privacy": "private"
             },
             {
-              "kind": "field",
-              "name": "buttonElementTags",
-              "static": true,
-              "readonly": true
+              "kind": "method",
+              "name": "exposeCssParts",
+              "description": "Exposes CSS parts for styling from parent components.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
               "kind": "method",
-              "name": "isButtonElement",
+              "name": "isCustomSlotContent",
               "parameters": [
                 {
                   "name": "element",
@@ -7963,1846 +8009,1800 @@
                   }
                 }
               ],
-              "description": "Check if the tag name is a button element.",
+              "description": "Determines if content is within a custom slot.",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "Boolean"
                 }
-              },
-              "privacy": "private"
+              }
             },
             {
-              "kind": "field",
-              "name": "value",
-              "description": "Returns the current values of all named form elements as a key-value object, keyed by each element's `name` attribute.",
+              "kind": "method",
+              "name": "handleFocusin",
+              "description": "Function to support",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Record<string, string | number | boolean | string[] | null>"
+                  "text": "void"
                 }
-              },
-              "readonly": true
+              }
             },
             {
-              "kind": "field",
-              "name": "submitElements",
-              "description": "Getter for internal _submitElements.",
+              "kind": "method",
+              "name": "updateFocusTrap",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleFocusout",
+              "description": "Function to support",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "HTMLButtonElement[]"
+                  "text": "void"
                 }
-              },
-              "privacy": "private",
-              "readonly": true
+              }
             },
             {
-              "kind": "field",
-              "name": "resetElements",
-              "description": "Returns a collection of elements that will reset the form.",
-              "return": {
-                "type": {
-                  "text": "HTMLButtonElement[]"
+              "kind": "method",
+              "name": "bindFocusEventToTrigger",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The original focus event.",
+                  "type": {
+                    "text": "Event"
+                  }
                 }
-              },
-              "privacy": "private",
-              "readonly": true
+              ],
+              "description": "Creates and dispatches a duplicate focus event on the trigger element.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_calculateValidity",
-              "description": "Infer validity status based on current formState.",
+              "name": "setupTriggerFocusEventBinding",
+              "description": "Sets up event listeners to deliver focus and blur events from nested Auro components within the trigger slot to trigger.\nThis ensures that focus/blur events originating from within these components are propagated to the trigger element itself.",
               "privacy": "private"
             },
             {
-              "kind": "field",
-              "name": "validity",
-              "description": "Returns `'valid'` if all required and interacted-with form elements are valid, `'invalid'` if any are not, or `null` if the form has not been interacted with yet.",
+              "kind": "method",
+              "name": "clearTriggerFocusEventBinding",
+              "description": "Clears focus and blur event listeners from nested Auro components within the trigger slot.",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "\"valid\" | \"invalid\" | null"
+                  "text": "void"
                 }
-              },
-              "readonly": true
+              }
             },
             {
               "kind": "method",
-              "name": "_setInitialState",
-              "description": "Determines whether the form is in its initial (untouched) state and updates `_isInitialState` accordingly.",
-              "return": {
-                "type": {
-                  "text": "void"
+              "name": "clearTriggerA11yAttributes",
+              "parameters": [
+                {
+                  "name": "triggerElement"
                 }
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "isInitialState",
-              "description": "Returns `true` if no form element has been interacted with or had its value changed since the form was initialized or last reset.",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "readonly": true
+              ]
             },
             {
               "kind": "method",
-              "name": "setDisabledStateOnButtons",
-              "description": "Enables or disables submit and reset buttons based on the current form state and validity.",
+              "name": "handleTriggerContentSlotChange",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "Native slotchange event.",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Handles changes to the trigger content slot and updates related properties.\n\nIt first updates the floater settings\nThen, it retrieves the assigned nodes from the event target and checks if any of\nthe nodes contain non-empty text content, updating the `hasTriggerContent` property accordingly.",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              },
-              "privacy": "private"
+              }
             },
             {
               "kind": "method",
-              "name": "queryAuroElements",
-              "description": "Construct the query strings from elements, append them together, execute, and return the NodeList.",
-              "return": {
-                "type": {
-                  "text": "NodeList"
-                }
-              },
+              "name": "handleDefaultSlot",
+              "description": "Handles the default slot change event and updates the content.\n\nThis method retrieves all nodes assigned to the default slot of the event target and appends them\nto the `bibContent` element. If a callback function `onSlotChange` is defined, it is invoked to\nnotify about the slot change.",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_addElementToState",
+              "name": "renderBasicHtml",
               "parameters": [
                 {
-                  "name": "element",
-                  "description": "The element to add to our state.",
+                  "name": "helpTextClasses",
+                  "description": "Classes to apply to the help text container.",
                   "type": {
-                    "text": "HTMLElement"
+                    "text": "Object"
                   }
                 }
               ],
-              "description": "Store an element in state and on the _elements array.",
-              "privacy": "private"
+              "description": "Returns HTML for the common portion of the layouts.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "html"
+                }
+              }
             },
             {
               "kind": "method",
-              "name": "initializeState",
-              "description": "Initialize (or reinitialize) the form state.",
+              "name": "renderLayoutClassic",
+              "description": "Returns HTML for the classic layout. Does not support type=\"*\".",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "html"
                 }
-              },
-              "privacy": "private"
+              }
             },
             {
               "kind": "method",
-              "name": "reset",
-              "description": "Resets all form elements to their initial state and fires a `reset` event. The event's `detail.previousValue` contains the form values captured immediately before the reset.",
+              "name": "renderLayoutSnowflake",
+              "description": "Returns HTML for the snowflake layout. Does not support type=\"*\".",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "html"
                 }
               }
             },
             {
               "kind": "method",
-              "name": "submit",
-              "description": "Validates all form elements. If all are valid, fires a `submit` event with `detail.value` containing the current form values. If any element is invalid, its error state is surfaced and the `submit` event is not fired.",
+              "name": "renderLayoutEmphasized",
+              "description": "Returns HTML for the emphasized layout. Does not support type=\"*\".",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Promise<void>"
+                  "text": "html"
                 }
               }
             },
             {
               "kind": "method",
-              "name": "register",
-              "static": true,
+              "name": "renderLayout",
               "parameters": [
                 {
-                  "name": "name",
-                  "default": "\"auro-form\"",
-                  "description": "The custom element tag name to register.",
+                  "name": "ForcedLayout",
+                  "description": "Used to force a specific layout, pass in the layout name to use.",
                   "optional": true,
                   "type": {
                     "text": "string"
                   }
                 }
               ],
-              "description": "Registers the `auro-form` custom element with the browser under a given tag name."
-            },
-            {
-              "kind": "method",
-              "name": "sharedInputListener",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The event that is fired from the form element.",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "description": "Shared input listener for all form elements.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "sharedValidationListener",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The event that is fired from the form element.",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "description": "Shared validation listener for all form elements.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "handleKeyDown",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The keyboard event.",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                }
-              ],
-              "description": "Handle Enter key press on form elements.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_attachEventListeners",
-              "description": "Attaches input, validation, and keydown listeners to all tracked form and button elements.\nRemoves existing listeners first to avoid duplicates on re-initialization.",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "mutationEventListener",
-              "description": "Mutation observer for form elements. Slot change does not trigger unless\nroot-level elements are added/removed. This is a workaround to ensure\nnested form elements are also observed.",
+              "description": "Logic to determine the layout of the component.",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "HTMLCollection"
                 }
-              },
-              "privacy": "private"
+              }
             },
             {
-              "kind": "method",
-              "name": "onSlotChange",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The slot change event.",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "description": "Slot change event listener. This is the main entry point for the form element.",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "isPopoverVisible",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
               },
-              "privacy": "private"
+              "description": "If true, the dropdown bib is displayed.",
+              "default": "false",
+              "attribute": "open",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "formState",
-              "privacy": "private",
+              "name": "isBibFullscreen",
+              "privacy": "public",
               "type": {
-                "text": "FormState"
+                "text": "boolean"
               },
-              "default": "{}"
+              "description": "If true, the dropdown bib is taking the fullscreen when it's open.",
+              "default": "false",
+              "attribute": "isBibFullscreen",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "_validity",
-              "privacy": "private",
+              "name": "matchWidth",
+              "privacy": "public",
               "type": {
-                "text": "\"valid\" | \"invalid\" | null"
+                "text": "boolean"
               },
-              "default": "null"
+              "description": "If declared, the popover and trigger will be set to the same width.",
+              "default": "false",
+              "attribute": "matchWidth",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "_isInitialState",
-              "privacy": "private",
+              "name": "noHideOnThisFocusLoss",
+              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "default": "true"
+              "description": "If declared, the dropdown will not hide when moving focus outside the element.",
+              "default": "false",
+              "attribute": "noHideOnThisFocusLoss",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "_elements",
-              "privacy": "private",
+              "name": "errorMessage",
+              "privacy": "public",
               "type": {
-                "text": "(HTMLElement & {reset: () => void})[]"
+                "text": "string"
               },
-              "default": "[]"
+              "description": "Contains the help text message for the current validity error.",
+              "default": "undefined",
+              "attribute": "errorMessage"
             },
             {
               "kind": "field",
-              "name": "_submitElements",
-              "privacy": "private",
+              "name": "layout",
+              "privacy": "public",
               "type": {
-                "text": "HTMLButtonElement[]"
+                "text": "string"
               },
-              "default": "[]"
+              "description": "Sets the layout of the dropdown.",
+              "default": "undefined",
+              "attribute": "layout",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
             },
             {
               "kind": "field",
-              "name": "_resetElements",
-              "privacy": "private",
+              "name": "shape",
+              "privacy": "public",
               "type": {
-                "text": "HTMLButtonElement[]"
+                "text": "string"
               },
-              "default": "[]"
+              "attribute": "shape",
+              "reflects": true,
+              "default": "undefined",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
             },
             {
               "kind": "field",
-              "name": "mutationObservers",
+              "name": "size",
+              "privacy": "public",
               "type": {
-                "text": "MutationObserver[]"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "[]"
-            }
-          ],
-          "events": [
+              "attribute": "size",
+              "reflects": true,
+              "default": "undefined",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
+            },
             {
-              "name": "change",
+              "kind": "field",
+              "name": "parentBorder",
+              "privacy": "private",
               "type": {
-                "text": "Event"
+                "text": "boolean"
               },
-              "description": "Fires when a child form element's value changes or the form is initialized."
+              "description": "Defines if the trigger should size based on the parent element providing the border UI.",
+              "default": "false",
+              "attribute": "parentBorder",
+              "reflects": true
             },
             {
-              "name": "reset",
+              "kind": "field",
+              "name": "bibElement",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "a11yRole",
+              "privacy": "public",
               "type": {
-                "text": "CustomEvent"
+                "text": "string"
               },
-              "description": "Fires when the form is reset. The event detail contains the previous value of the form before reset."
+              "description": "The value for the role attribute of the trigger element."
             },
             {
-              "name": "submit",
+              "kind": "field",
+              "name": "appearance",
+              "privacy": "public",
               "type": {
-                "text": "CustomEvent"
+                "text": "'default' | 'inverse'"
               },
-              "description": "Fires when the form is submitted. The event detail contains the current value of the form."
+              "description": "Defines whether the component will be on lighter or darker backgrounds.",
+              "default": "'default'",
+              "attribute": "appearance",
+              "reflects": true
             },
             {
-              "description": "Fires when a child form element receives user input.",
-              "name": "input"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "auro-form",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AuroForm",
-          "declaration": {
-            "name": "AuroForm",
-            "module": "components/form/src/auro-form.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/form/src/index.js",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AuroForm",
-          "declaration": {
-            "name": "AuroForm",
-            "module": "components/form/src/index.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/form/src/registered.js",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/dropdown/src/auro-dropdown.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "The `auro-dropdown` element provides a way to place content in a bib that can be toggled.",
-          "name": "AuroDropdown",
-          "cssParts": [
-            {
-              "description": "The trigger content container.",
-              "name": "trigger"
+              "kind": "field",
+              "name": "autoPlacement",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, bib's position will be automatically calculated where to appear.",
+              "attribute": "autoPlacement",
+              "reflects": true
             },
             {
-              "description": "The collapsed/expanded state icon container.",
-              "name": "chevron"
+              "kind": "field",
+              "name": "disableEventShow",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the dropdown will only show by calling the API .show() public method.",
+              "attribute": "disableEventShow",
+              "reflects": true
             },
             {
-              "description": "The size of the dropdown bib. (height, width, maxHeight, maxWidth only)",
-              "name": "size"
+              "kind": "field",
+              "name": "simple",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, applies a border around the trigger slot.",
+              "attribute": "simple",
+              "reflects": true
             },
             {
-              "description": "The helpText content container.",
-              "name": "helpText"
-            }
-          ],
-          "slots": [
-            {
-              "description": "Default slot for the dropdown bib content.",
-              "name": ""
+              "kind": "field",
+              "name": "chevron",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the dropdown displays a chevron on the right.",
+              "attribute": "chevron",
+              "reflects": true
             },
             {
-              "description": "Defines the content of the helpText.",
-              "name": "helpText"
+              "kind": "field",
+              "name": "disabled",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the dropdown is not interactive.",
+              "attribute": "disabled",
+              "reflects": true
             },
-            {
-              "description": "Defines the content of the trigger.",
-              "name": "trigger"
-            }
-          ],
-          "members": [
             {
               "kind": "field",
-              "name": "shadowRootOptions",
-              "static": true,
-              "readonly": true
+              "name": "disableKeyboardHandling",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the dropdown will not handle keyboard events and will require the consumer to manage this behavior.",
+              "attribute": "disableKeyboardHandling",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "commonWrapperClasses",
+              "name": "dropdownWidth",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "object"
-                }
+              "type": {
+                "text": "number"
               },
-              "readonly": true
+              "attribute": "dropdownWidth"
             },
             {
-              "kind": "method",
-              "name": "_intializeDefaults",
+              "kind": "field",
+              "name": "dropdownId",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "type": {
+                "text": "string"
+              },
+              "description": "The unique ID for the dropdown bib element."
             },
             {
-              "kind": "method",
-              "name": "hide",
-              "description": "Public method to hide the dropdown.",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "kind": "field",
+              "name": "error",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, will apply error UI to the dropdown.",
+              "attribute": "error",
+              "reflects": true
             },
             {
-              "kind": "method",
-              "name": "show",
-              "description": "Public method to show the dropdown.",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "kind": "field",
+              "name": "focusShow",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the bib will display when focus is applied to the trigger.",
+              "attribute": "focusShow",
+              "reflects": true
             },
             {
-              "kind": "method",
-              "name": "focus",
-              "description": "When bib is open, focus on the first element inside of bib.\nIf not, trigger element will get focus."
+              "kind": "field",
+              "name": "hoverToggle",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the trigger will toggle the dropdown on mouseover/mouseout.",
+              "attribute": "hoverToggle",
+              "reflects": true
             },
             {
-              "kind": "method",
-              "name": "setActiveDescendant",
-              "parameters": [
-                {
-                  "name": "element",
-                  "description": "The element to set as the active descendant, or null to clear.",
-                  "type": {
-                    "text": "HTMLElement|null"
-                  }
-                }
-              ],
-              "description": "Sets the active descendant element for accessibility.\nUses ariaActiveDescendantElement to cross shadow DOM boundaries.\nThis function is used in components that contain `auro-dropdown` to set the active descendant.",
+              "kind": "field",
+              "name": "hasTriggerContent",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "type": {
+                "text": "boolean"
+              },
+              "attribute": "hasTriggerContent"
             },
             {
-              "kind": "method",
-              "name": "register",
-              "static": true,
-              "parameters": [
-                {
-                  "name": "name",
-                  "default": "\"auro-dropdown\"",
-                  "description": "The name of the element that you want to register.",
-                  "optional": true,
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "This will register this element with the browser."
+              "kind": "field",
+              "name": "fullscreenBreakpoint",
+              "privacy": "public",
+              "type": {
+                "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
+              },
+              "description": "Defines the screen size breakpoint at which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
+              "default": "'sm'",
+              "attribute": "fullscreenBreakpoint",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "focusableEntityQuery",
-              "description": "Accessor for reusing the focusable entity query string.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
+              "name": "noFlip",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
               },
-              "readonly": true
+              "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
+              "attribute": "noFlip",
+              "reflects": true
             },
             {
-              "kind": "method",
-              "name": "handleDropdownToggle",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The custom event that contains the dropdown toggle information.",
-                  "type": {
-                    "text": "CustomEvent"
-                  }
-                }
-              ],
-              "description": "Handles the custom event `auroDropdown-toggled` to update the visibility of the dropdown bib.",
-              "privacy": "private"
+              "kind": "field",
+              "name": "shift",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
+              "attribute": "shift",
+              "reflects": true
             },
             {
-              "kind": "method",
-              "name": "exposeCssParts",
-              "description": "Exposes CSS parts for styling from parent components.",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "kind": "field",
+              "name": "noToggle",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the trigger will only show the dropdown bib.",
+              "attribute": "noToggle",
+              "reflects": true
             },
             {
-              "kind": "method",
-              "name": "isCustomSlotContent",
-              "parameters": [
-                {
-                  "name": "element",
-                  "description": "The element to check.",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ],
-              "description": "Determines if content is within a custom slot.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Boolean"
-                }
-              }
+              "kind": "field",
+              "name": "offset",
+              "privacy": "public",
+              "type": {
+                "text": "number"
+              },
+              "description": "Gap between the trigger element and bib.",
+              "default": "0",
+              "attribute": "offset",
+              "reflects": true
             },
             {
-              "kind": "method",
-              "name": "handleFocusin",
-              "description": "Function to support",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "onDark",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "attribute": "onDark",
+              "reflects": true,
+              "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
               }
             },
             {
-              "kind": "method",
-              "name": "updateFocusTrap",
-              "privacy": "private"
+              "kind": "field",
+              "name": "onSlotChange",
+              "privacy": "public",
+              "type": {
+                "text": "function"
+              },
+              "description": "If declared, and a function is set, that function will execute when the slot content is updated.",
+              "attribute": "onSlotChange"
             },
             {
-              "kind": "method",
-              "name": "handleFocusout",
-              "description": "Function to support",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "kind": "field",
+              "name": "placement",
+              "privacy": "public",
+              "type": {
+                "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
+              },
+              "description": "Position where the bib should appear relative to the trigger.",
+              "default": "'bottom-start'",
+              "attribute": "placement",
+              "reflects": true
             },
             {
-              "kind": "method",
-              "name": "bindFocusEventToTrigger",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The original focus event.",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "description": "Creates and dispatches a duplicate focus event on the trigger element.",
-              "privacy": "private"
+              "kind": "field",
+              "name": "tabIndex",
+              "privacy": "private",
+              "type": {
+                "text": "number"
+              },
+              "attribute": "tabIndex"
             },
             {
-              "kind": "method",
-              "name": "setupTriggerFocusEventBinding",
-              "description": "Sets up event listeners to deliver focus and blur events from nested Auro components within the trigger slot to trigger.\nThis ensures that focus/blur events originating from within these components are propagated to the trigger element itself.",
-              "privacy": "private"
+              "kind": "field",
+              "name": "bibDialogLabel",
+              "privacy": "private",
+              "type": {
+                "text": "string"
+              },
+              "description": "Accessible label for the dropdown bib dialog element."
             },
             {
-              "kind": "method",
-              "name": "clearTriggerFocusEventBinding",
-              "description": "Clears focus and blur event listeners from nested Auro components within the trigger slot.",
+              "kind": "field",
+              "name": "componentHasFocus",
+              "description": "Returns true if the element has focus.",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "boolean"
                 }
+              },
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
               }
             },
             {
               "kind": "method",
-              "name": "clearTriggerA11yAttributes",
-              "parameters": [
-                {
-                  "name": "triggerElement"
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "handleTriggerContentSlotChange",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "Native slotchange event.",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "description": "Handles changes to the trigger content slot and updates related properties.\n\nIt first updates the floater settings\nThen, it retrieves the assigned nodes from the event target and checks if any of\nthe nodes contain non-empty text content, updating the `hasTriggerContent` property accordingly.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "name": "resetShapeClasses",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
               }
             },
             {
               "kind": "method",
-              "name": "handleDefaultSlot",
-              "description": "Handles the default slot change event and updates the content.\n\nThis method retrieves all nodes assigned to the default slot of the event target and appends them\nto the `bibContent` element. If a callback function `onSlotChange` is defined, it is invoked to\nnotify about the slot change.",
-              "privacy": "private"
+              "name": "resetLayoutClasses",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
             },
             {
               "kind": "method",
-              "name": "renderBasicHtml",
-              "parameters": [
-                {
-                  "name": "helpTextClasses",
-                  "description": "Classes to apply to the help text container.",
-                  "type": {
-                    "text": "Object"
-                  }
-                }
-              ],
-              "description": "Returns HTML for the common portion of the layouts.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "html"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "renderLayoutClassic",
-              "description": "Returns HTML for the classic layout. Does not support type=\"*\".",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "html"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "renderLayoutSnowflake",
-              "description": "Returns HTML for the snowflake layout. Does not support type=\"*\".",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "html"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "renderLayoutEmphasized",
-              "description": "Returns HTML for the emphasized layout. Does not support type=\"*\".",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "html"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "renderLayout",
-              "parameters": [
-                {
-                  "name": "ForcedLayout",
-                  "description": "Used to force a specific layout, pass in the layout name to use.",
-                  "optional": true,
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Logic to determine the layout of the component.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "HTMLCollection"
-                }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "isPopoverVisible",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If true, the dropdown bib is displayed.",
-              "default": "false",
-              "attribute": "open",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "isBibFullscreen",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If true, the dropdown bib is taking the fullscreen when it's open.",
-              "default": "false",
-              "attribute": "isBibFullscreen",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "matchWidth",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, the popover and trigger will be set to the same width.",
-              "default": "false",
-              "attribute": "matchWidth",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "noHideOnThisFocusLoss",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, the dropdown will not hide when moving focus outside the element.",
-              "default": "false",
-              "attribute": "noHideOnThisFocusLoss",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "errorMessage",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "description": "Contains the help text message for the current validity error.",
-              "default": "undefined",
-              "attribute": "errorMessage"
-            },
-            {
-              "kind": "field",
-              "name": "layout",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "description": "Sets the layout of the dropdown.",
-              "default": "undefined",
-              "attribute": "layout",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "shape",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "attribute": "shape",
-              "reflects": true,
-              "default": "undefined",
+              "name": "updateComponentArchitecture",
               "inheritedFrom": {
                 "name": "AuroElement",
                 "module": "components/layoutElement/src/auroElement.js"
               }
-            },
+            }
+          ],
+          "events": [
             {
-              "kind": "field",
-              "name": "size",
-              "privacy": "public",
+              "name": "auroDropdown-idAdded",
               "type": {
-                "text": "string"
+                "text": "Object<key"
               },
-              "attribute": "size",
-              "reflects": true,
-              "default": "undefined",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "description": "Notifies consumers that the unique ID for the dropdown bib has been generated."
             },
             {
-              "kind": "field",
-              "name": "parentBorder",
-              "privacy": "private",
+              "name": "auroDropdown-triggerClick",
               "type": {
-                "text": "boolean"
+                "text": "CustomEvent"
               },
-              "description": "Defines if the trigger should size based on the parent element providing the border UI.",
-              "default": "false",
-              "attribute": "parentBorder",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "bibElement",
-              "privacy": "private"
+              "description": "Notifies that the trigger has been clicked."
             },
             {
-              "kind": "field",
-              "name": "a11yRole",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "description": "The value for the role attribute of the trigger element."
-            },
+              "description": "Notifies that the visibility of the dropdown bib has changed.",
+              "name": "auroDropdown-toggled"
+            }
+          ],
+          "attributes": [
             {
-              "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
+              "fieldName": "appearance"
             },
             {
-              "kind": "field",
               "name": "autoPlacement",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, bib's position will be automatically calculated where to appear.",
-              "attribute": "autoPlacement",
-              "reflects": true
+              "fieldName": "autoPlacement"
             },
             {
-              "kind": "field",
               "name": "disableEventShow",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, the dropdown will only show by calling the API .show() public method.",
-              "attribute": "disableEventShow",
-              "reflects": true
+              "fieldName": "disableEventShow"
             },
             {
-              "kind": "field",
               "name": "simple",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, applies a border around the trigger slot.",
-              "attribute": "simple",
-              "reflects": true
+              "fieldName": "simple"
             },
             {
-              "kind": "field",
               "name": "chevron",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, the dropdown displays a chevron on the right.",
-              "attribute": "chevron",
-              "reflects": true
+              "fieldName": "chevron"
             },
             {
-              "kind": "field",
               "name": "disabled",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, the dropdown is not interactive.",
-              "attribute": "disabled",
-              "reflects": true
+              "fieldName": "disabled"
             },
             {
-              "kind": "field",
               "name": "disableKeyboardHandling",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, the dropdown will not handle keyboard events and will require the consumer to manage this behavior.",
-              "attribute": "disableKeyboardHandling",
-              "reflects": true
+              "fieldName": "disableKeyboardHandling"
             },
             {
-              "kind": "field",
               "name": "dropdownWidth",
-              "privacy": "private",
               "type": {
                 "text": "number"
               },
-              "attribute": "dropdownWidth"
-            },
-            {
-              "kind": "field",
-              "name": "dropdownId",
-              "privacy": "private",
-              "type": {
-                "text": "string"
-              },
-              "description": "The unique ID for the dropdown bib element."
+              "fieldName": "dropdownWidth"
             },
             {
-              "kind": "field",
               "name": "error",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, will apply error UI to the dropdown.",
-              "attribute": "error",
-              "reflects": true
+              "fieldName": "error"
+            },
+            {
+              "name": "errorMessage",
+              "type": {
+                "text": "string"
+              },
+              "description": "Contains the help text message for the current validity error.",
+              "default": "undefined",
+              "fieldName": "errorMessage"
             },
             {
-              "kind": "field",
               "name": "focusShow",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, the bib will display when focus is applied to the trigger.",
-              "attribute": "focusShow",
-              "reflects": true
+              "fieldName": "focusShow"
+            },
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the dropdown bib is displayed.",
+              "default": "false",
+              "fieldName": "isPopoverVisible"
+            },
+            {
+              "name": "isBibFullscreen",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the dropdown bib is taking the fullscreen when it's open.",
+              "default": "false",
+              "fieldName": "isBibFullscreen"
             },
             {
-              "kind": "field",
               "name": "hoverToggle",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, the trigger will toggle the dropdown on mouseover/mouseout.",
-              "attribute": "hoverToggle",
-              "reflects": true
+              "fieldName": "hoverToggle"
             },
             {
-              "kind": "field",
               "name": "hasTriggerContent",
-              "privacy": "private",
               "type": {
                 "text": "boolean"
               },
-              "attribute": "hasTriggerContent"
+              "fieldName": "hasTriggerContent"
             },
             {
-              "kind": "field",
               "name": "fullscreenBreakpoint",
-              "privacy": "public",
               "type": {
                 "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
               },
               "description": "Defines the screen size breakpoint at which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
               "default": "'sm'",
-              "attribute": "fullscreenBreakpoint",
-              "reflects": true
+              "fieldName": "fullscreenBreakpoint"
+            },
+            {
+              "name": "layout",
+              "type": {
+                "text": "string"
+              },
+              "description": "Sets the layout of the dropdown.",
+              "default": "undefined",
+              "fieldName": "layout",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
+            },
+            {
+              "name": "parentBorder",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Defines if the trigger should size based on the parent element providing the border UI.",
+              "default": "false",
+              "fieldName": "parentBorder"
+            },
+            {
+              "name": "matchWidth",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the popover and trigger will be set to the same width.",
+              "default": "false",
+              "fieldName": "matchWidth"
             },
             {
-              "kind": "field",
               "name": "noFlip",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
-              "attribute": "noFlip",
-              "reflects": true
+              "fieldName": "noFlip"
             },
             {
-              "kind": "field",
               "name": "shift",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
-              "attribute": "shift",
-              "reflects": true
+              "fieldName": "shift"
+            },
+            {
+              "name": "noHideOnThisFocusLoss",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the dropdown will not hide when moving focus outside the element.",
+              "default": "false",
+              "fieldName": "noHideOnThisFocusLoss"
             },
             {
-              "kind": "field",
               "name": "noToggle",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
               "description": "If declared, the trigger will only show the dropdown bib.",
-              "attribute": "noToggle",
-              "reflects": true
+              "fieldName": "noToggle"
             },
             {
-              "kind": "field",
               "name": "offset",
-              "privacy": "public",
               "type": {
                 "text": "number"
               },
               "description": "Gap between the trigger element and bib.",
               "default": "0",
-              "attribute": "offset",
-              "reflects": true
+              "fieldName": "offset"
             },
             {
-              "kind": "field",
               "name": "onDark",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "attribute": "onDark",
-              "reflects": true,
               "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "fieldName": "onDark"
             },
             {
-              "kind": "field",
               "name": "onSlotChange",
-              "privacy": "public",
               "type": {
                 "text": "function"
               },
               "description": "If declared, and a function is set, that function will execute when the slot content is updated.",
-              "attribute": "onSlotChange"
+              "fieldName": "onSlotChange"
             },
             {
-              "kind": "field",
               "name": "placement",
-              "privacy": "public",
               "type": {
                 "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
               },
               "description": "Position where the bib should appear relative to the trigger.",
               "default": "'bottom-start'",
-              "attribute": "placement",
-              "reflects": true
+              "fieldName": "placement"
             },
             {
-              "kind": "field",
               "name": "tabIndex",
-              "privacy": "private",
               "type": {
                 "text": "number"
               },
-              "attribute": "tabIndex"
+              "fieldName": "tabIndex"
             },
             {
-              "kind": "field",
-              "name": "bibDialogLabel",
-              "privacy": "private",
+              "name": "shape",
               "type": {
                 "text": "string"
               },
-              "description": "Accessible label for the dropdown bib dialog element."
-            },
-            {
-              "kind": "field",
-              "name": "componentHasFocus",
-              "description": "Returns true if the element has focus.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "readonly": true,
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "resetShapeClasses",
+              "fieldName": "shape",
               "inheritedFrom": {
                 "name": "AuroElement",
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
             {
-              "kind": "method",
-              "name": "resetLayoutClasses",
+              "name": "size",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "size",
               "inheritedFrom": {
                 "name": "AuroElement",
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
             {
-              "kind": "method",
-              "name": "updateComponentArchitecture",
+              "name": "ondark",
+              "type": {
+                "text": "boolean"
+              },
+              "fieldName": "onDark",
               "inheritedFrom": {
                 "name": "AuroElement",
                 "module": "components/layoutElement/src/auroElement.js"
               }
             }
           ],
-          "events": [
-            {
-              "name": "auroDropdown-idAdded",
-              "type": {
-                "text": "Object<key"
-              },
-              "description": "Notifies consumers that the unique ID for the dropdown bib has been generated."
-            },
-            {
-              "name": "auroDropdown-triggerClick",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Notifies that the trigger has been clicked."
-            },
+          "superclass": {
+            "name": "AuroElement",
+            "module": "/components/layoutElement/src/auroElement.js"
+          },
+          "tagName": "auro-dropdown",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AuroDropdown",
+          "declaration": {
+            "name": "AuroDropdown",
+            "module": "components/dropdown/src/auro-dropdown.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/dropdown/src/auro-dropdownBib.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AuroDropdownBib",
+          "cssParts": [
             {
-              "description": "Notifies that the visibility of the dropdown bib has changed.",
-              "name": "auroDropdown-toggled"
+              "description": "Apply css to the bib container.",
+              "name": "bibContainer"
             }
           ],
-          "attributes": [
+          "members": [
             {
-              "name": "appearance",
-              "type": {
-                "text": "'default' | 'inverse'"
-              },
-              "description": "Defines whether the component will be on lighter or darker backgrounds.",
-              "default": "'default'",
-              "fieldName": "appearance"
+              "kind": "field",
+              "name": "mobileFullscreenBreakpoint"
             },
             {
-              "name": "autoPlacement",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, bib's position will be automatically calculated where to appear.",
-              "fieldName": "autoPlacement"
+              "kind": "method",
+              "name": "_setupCancelHandler",
+              "parameters": [
+                {
+                  "name": "dialog",
+                  "description": "The dialog element to attach the cancel listener to.",
+                  "type": {
+                    "text": "HTMLDialogElement"
+                  }
+                }
+              ],
+              "description": "Forwards the dialog's native `cancel` event (fired on ESC) as\nan `auro-bib-cancel` custom event so parent components can close.",
+              "privacy": "private"
             },
             {
-              "name": "disableEventShow",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, the dropdown will only show by calling the API .show() public method.",
-              "fieldName": "disableEventShow"
+              "kind": "method",
+              "name": "_lockTouchScroll",
+              "description": "Blocks touch-driven page scroll while a fullscreen modal dialog is open.\n\nThe showModal() function places the dialog in the browser's **top layer**,\nwhich is a separate rendering layer above the normal DOM. On mobile, the\ncompositor processes visual-viewport panning before top-layer touch\nhandling. This means the entire viewport — including the top-layer dialog\n— can be panned by a touch gesture, causing the page behind the dialog to\nscroll into view. To prevent this, we add a touchmove listener that cancels\nthe event if the touch started outside the dialog or any scrollable child within it.",
+              "privacy": "private"
             },
             {
-              "name": "simple",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, applies a border around the trigger slot.",
-              "fieldName": "simple"
+              "kind": "method",
+              "name": "_unlockTouchScroll",
+              "description": "Removes the touchmove listener added by _lockTouchScroll().",
+              "privacy": "private"
             },
             {
-              "name": "chevron",
+              "kind": "method",
+              "name": "open",
+              "parameters": [
+                {
+                  "name": "modal",
+                  "default": "true"
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "close",
+              "description": "Closes the dialog."
+            },
+            {
+              "kind": "field",
+              "name": "_mobileBreakpointName",
+              "privacy": "private",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "shape",
+              "privacy": "public",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "If declared, the dropdown displays a chevron on the right.",
-              "fieldName": "chevron"
+              "default": "\"rounded\"",
+              "attribute": "shape",
+              "reflects": true
             },
             {
-              "name": "disabled",
+              "kind": "field",
+              "name": "matchWidth",
+              "privacy": "private",
               "type": {
                 "text": "boolean"
               },
-              "description": "If declared, the dropdown is not interactive.",
-              "fieldName": "disabled"
+              "description": "If declared, the bib width will match the trigger width.",
+              "default": "false",
+              "attribute": "matchWidth",
+              "reflects": true
             },
             {
-              "name": "disableKeyboardHandling",
+              "kind": "field",
+              "name": "hasActiveDescendant",
+              "privacy": "private",
               "type": {
                 "text": "boolean"
               },
-              "description": "If declared, the dropdown will not handle keyboard events and will require the consumer to manage this behavior.",
-              "fieldName": "disableKeyboardHandling"
+              "description": "Tracks whether a menu option is currently highlighted.",
+              "default": "false",
+              "attribute": "hasActiveDescendant"
             },
             {
-              "name": "dropdownWidth",
               "type": {
-                "text": "number"
+                "text": "String"
               },
-              "fieldName": "dropdownWidth"
+              "description": "Defines the screen size breakpoint (`lg`, `md`, `sm`, or `xs`) at which the dropdown switches to fullscreen mode on mobile. When expanded, the dropdown will automatically display in fullscreen mode if the screen size is equal to or smaller than the selected breakpoint.",
+              "name": "fullscreenBreakpoint",
+              "kind": "field"
             },
             {
-              "name": "error",
+              "kind": "field",
+              "name": "isFullscreen",
+              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "description": "If declared, will apply error UI to the dropdown.",
-              "fieldName": "error"
+              "description": "If declared, will take the fullscreen when the bib is displayed.",
+              "attribute": "isFullscreen",
+              "reflects": true
             },
             {
-              "name": "errorMessage",
+              "kind": "field",
+              "name": "common",
+              "privacy": "public",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Contains the help text message for the current validity error.",
-              "default": "undefined",
-              "fieldName": "errorMessage"
+              "description": "If declared, will apply all styles for the common theme.",
+              "attribute": "common",
+              "reflects": true
             },
             {
-              "name": "focusShow",
+              "kind": "field",
+              "name": "inset",
+              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "description": "If declared, the bib will display when focus is applied to the trigger.",
-              "fieldName": "focusShow"
+              "description": "If declared, will apply extra padding to bib content.",
+              "attribute": "inset",
+              "reflects": true
             },
             {
-              "name": "open",
+              "kind": "field",
+              "name": "rounded",
+              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "description": "If true, the dropdown bib is displayed.",
-              "default": "false",
-              "fieldName": "isPopoverVisible"
+              "description": "If declared, will apply border-radius to the bib.",
+              "attribute": "rounded",
+              "reflects": true
             },
             {
-              "name": "isBibFullscreen",
+              "kind": "field",
+              "name": "bibTemplate",
+              "privacy": "public",
               "type": {
-                "text": "boolean"
+                "text": "object"
               },
-              "description": "If true, the dropdown bib is taking the fullscreen when it's open.",
-              "default": "false",
-              "fieldName": "isBibFullscreen"
+              "description": "A reference to the associated bib template element.",
+              "attribute": "bibTemplate"
             },
             {
-              "name": "hoverToggle",
+              "kind": "field",
+              "name": "dialogLabel",
+              "privacy": "private",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "If declared, the trigger will toggle the dropdown on mouseover/mouseout.",
-              "fieldName": "hoverToggle"
+              "description": "Accessible label for the dialog element, used when displayed as a modal.\nApplied via aria-labelledby on a visually hidden element rather than\naria-label because iOS VoiceOver does not reliably read aria-label\non <dialog> elements.",
+              "attribute": "dialogLabel"
             },
             {
-              "name": "hasTriggerContent",
+              "kind": "field",
+              "name": "dialogRole",
+              "privacy": "private",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "fieldName": "hasTriggerContent"
+              "description": "Overrides the native role of the dialog element.\nFor example, set to `\"presentation\"` on desktop combobox to prevent\nVoiceOver from announcing \"listbox inside of a dialog\".\nWhen `undefined`, the dialog keeps its native role.",
+              "attribute": "dialogRole"
+            }
+          ],
+          "events": [
+            {
+              "name": "auro-dropdownbib-connected",
+              "type": {
+                "text": "CustomEvent"
+              }
             },
             {
-              "name": "fullscreenBreakpoint",
+              "name": "auro-bib-cancel",
               "type": {
-                "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
+                "text": "CustomEvent"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "isFullscreen",
+              "type": {
+                "text": "boolean"
               },
-              "description": "Defines the screen size breakpoint at which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
-              "default": "'sm'",
-              "fieldName": "fullscreenBreakpoint"
+              "description": "If declared, will take the fullscreen when the bib is displayed.",
+              "fieldName": "isFullscreen"
             },
             {
-              "name": "layout",
+              "name": "common",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Sets the layout of the dropdown.",
-              "default": "undefined",
-              "fieldName": "layout",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "description": "If declared, will apply all styles for the common theme.",
+              "fieldName": "common"
             },
             {
-              "name": "parentBorder",
+              "name": "inset",
               "type": {
                 "text": "boolean"
               },
-              "description": "Defines if the trigger should size based on the parent element providing the border UI.",
-              "default": "false",
-              "fieldName": "parentBorder"
+              "description": "If declared, will apply extra padding to bib content.",
+              "fieldName": "inset"
             },
             {
               "name": "matchWidth",
               "type": {
                 "text": "boolean"
               },
-              "description": "If declared, the popover and trigger will be set to the same width.",
+              "description": "If declared, the bib width will match the trigger width.",
               "default": "false",
               "fieldName": "matchWidth"
             },
             {
-              "name": "noFlip",
+              "name": "rounded",
               "type": {
                 "text": "boolean"
               },
-              "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
-              "fieldName": "noFlip"
+              "description": "If declared, will apply border-radius to the bib.",
+              "fieldName": "rounded"
             },
             {
-              "name": "shift",
+              "name": "bibTemplate",
               "type": {
-                "text": "boolean"
+                "text": "object"
               },
-              "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
-              "fieldName": "shift"
+              "description": "A reference to the associated bib template element.",
+              "fieldName": "bibTemplate"
             },
             {
-              "name": "noHideOnThisFocusLoss",
+              "name": "shape",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "If declared, the dropdown will not hide when moving focus outside the element.",
-              "default": "false",
-              "fieldName": "noHideOnThisFocusLoss"
+              "default": "\"rounded\"",
+              "fieldName": "shape"
             },
             {
-              "name": "noToggle",
+              "name": "dialogLabel",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "If declared, the trigger will only show the dropdown bib.",
-              "fieldName": "noToggle"
+              "description": "Accessible label for the dialog element, used when displayed as a modal.\nApplied via aria-labelledby on a visually hidden element rather than\naria-label because iOS VoiceOver does not reliably read aria-label\non <dialog> elements.",
+              "fieldName": "dialogLabel"
             },
             {
-              "name": "offset",
+              "name": "dialogRole",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "description": "Gap between the trigger element and bib.",
-              "default": "0",
-              "fieldName": "offset"
+              "description": "Overrides the native role of the dialog element.\nFor example, set to `\"presentation\"` on desktop combobox to prevent\nVoiceOver from announcing \"listbox inside of a dialog\".\nWhen `undefined`, the dialog keeps its native role.",
+              "fieldName": "dialogRole"
             },
             {
-              "name": "onDark",
+              "name": "hasActiveDescendant",
               "type": {
                 "text": "boolean"
               },
-              "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
-              "fieldName": "onDark"
-            },
+              "description": "Tracks whether a menu option is currently highlighted.",
+              "default": "false",
+              "fieldName": "hasActiveDescendant"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AuroDropdownBib",
+          "declaration": {
+            "name": "AuroDropdownBib",
+            "module": "components/dropdown/src/auro-dropdownBib.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/dropdown/src/dropdownBibKeyboardStrategy.js",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "createDropdownBibKeyboardStrategy",
+          "parameters": [
             {
-              "name": "onSlotChange",
+              "name": "bib",
+              "description": "The dropdown bib element.",
               "type": {
-                "text": "function"
+                "text": "HTMLElement"
+              }
+            }
+          ],
+          "description": "Creates a keyboard strategy for dialog-specific key handling.\nAll other keydown behavior is left to the browser's native bubbling path.",
+          "return": {
+            "type": {
+              "text": "Object"
+            }
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "createDropdownBibKeyboardStrategy",
+          "declaration": {
+            "name": "createDropdownBibKeyboardStrategy",
+            "module": "components/dropdown/src/dropdownBibKeyboardStrategy.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/dropdown/src/iconVersion.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "9.2.0",
+            "module": "components/dropdown/src/iconVersion.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/dropdown/src/index.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AuroDropdown",
+          "declaration": {
+            "name": "AuroDropdown",
+            "module": "components/dropdown/src/index.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/dropdown/src/registered.js",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/form/src/auro-form.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "The `auro-form` element provides users a way to create and manage forms in a consistent manner.",
+          "name": "AuroForm",
+          "slots": [
+            {
+              "description": "The default slot for form elements.",
+              "name": "default"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "formElementTags",
+              "static": true,
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "_isElementTag",
+              "parameters": [
+                {
+                  "name": "elementTag",
+                  "description": "The HTML tag name like `auro-datepicker`.",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "element",
+                  "description": "The actual HTML element to compare.",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Compare tag name with element to identify it (for API purposes).",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
               },
-              "description": "If declared, and a function is set, that function will execute when the slot content is updated.",
-              "fieldName": "onSlotChange"
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_isInElementCollection",
+              "parameters": [
+                {
+                  "name": "collection",
+                  "description": "The array to use for tag name search.",
+                  "type": {
+                    "text": "string[]"
+                  }
+                },
+                {
+                  "name": "element",
+                  "description": "The element to compare against the master list.",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Shared code for determining if an element is something we care about (submit, form element, etc.).",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "isFormElement",
+              "parameters": [
+                {
+                  "name": "element",
+                  "description": "The element to check (attr or tag name).",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Check if the tag name is a form element.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_eventIsValidFormEvent",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The event to validate.",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Validates if an event is from a valid form element with a name.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "buttonElementTags",
+              "static": true,
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "isButtonElement",
+              "parameters": [
+                {
+                  "name": "element",
+                  "description": "The element to check.",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Check if the tag name is a button element.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "description": "Returns the current values of all named form elements as a key-value object, keyed by each element's `name` attribute.",
+              "return": {
+                "type": {
+                  "text": "Record<string, string | number | boolean | string[] | null>"
+                }
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "submitElements",
+              "description": "Getter for internal _submitElements.",
+              "return": {
+                "type": {
+                  "text": "HTMLButtonElement[]"
+                }
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "resetElements",
+              "description": "Returns a collection of elements that will reset the form.",
+              "return": {
+                "type": {
+                  "text": "HTMLButtonElement[]"
+                }
+              },
+              "privacy": "private",
+              "readonly": true
             },
             {
-              "name": "placement",
-              "type": {
-                "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
-              },
-              "description": "Position where the bib should appear relative to the trigger.",
-              "default": "'bottom-start'",
-              "fieldName": "placement"
+              "kind": "method",
+              "name": "_calculateValidity",
+              "description": "Infer validity status based on current formState.",
+              "privacy": "private"
             },
             {
-              "name": "tabIndex",
-              "type": {
-                "text": "number"
+              "kind": "field",
+              "name": "validity",
+              "description": "Returns `'valid'` if all required and interacted-with form elements are valid, `'invalid'` if any are not, or `null` if the form has not been interacted with yet.",
+              "return": {
+                "type": {
+                  "text": "\"valid\" | \"invalid\" | null"
+                }
               },
-              "fieldName": "tabIndex"
+              "readonly": true
             },
             {
-              "name": "shape",
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "_setInitialState",
+              "description": "Determines whether the form is in its initial (untouched) state and updates `_isInitialState` accordingly.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "fieldName": "shape",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "privacy": "private"
             },
             {
-              "name": "size",
-              "type": {
-                "text": "string"
+              "kind": "field",
+              "name": "isInitialState",
+              "description": "Returns `true` if no form element has been interacted with or had its value changed since the form was initialized or last reset.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
               },
-              "fieldName": "size",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "readonly": true
             },
             {
-              "name": "ondark",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "setDisabledStateOnButtons",
+              "description": "Enables or disables submit and reset buttons based on the current form state and validity.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "fieldName": "onDark",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
-            }
-          ],
-          "superclass": {
-            "name": "AuroElement",
-            "module": "/components/layoutElement/src/auroElement.js"
-          },
-          "tagName": "auro-dropdown",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AuroDropdown",
-          "declaration": {
-            "name": "AuroDropdown",
-            "module": "components/dropdown/src/auro-dropdown.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/dropdown/src/auro-dropdownBib.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "AuroDropdownBib",
-          "cssParts": [
-            {
-              "description": "Apply css to the bib container.",
-              "name": "bibContainer"
-            }
-          ],
-          "members": [
+              "privacy": "private"
+            },
             {
-              "kind": "field",
-              "name": "mobileFullscreenBreakpoint"
+              "kind": "method",
+              "name": "queryAuroElements",
+              "description": "Construct the query strings from elements, append them together, execute, and return the NodeList.",
+              "return": {
+                "type": {
+                  "text": "NodeList"
+                }
+              },
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_setupCancelHandler",
+              "name": "_addElementToState",
               "parameters": [
                 {
-                  "name": "dialog",
-                  "description": "The dialog element to attach the cancel listener to.",
+                  "name": "element",
+                  "description": "The element to add to our state.",
                   "type": {
-                    "text": "HTMLDialogElement"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Forwards the dialog's native `cancel` event (fired on ESC) as\nan `auro-bib-cancel` custom event so parent components can close.",
+              "description": "Store an element in state and on the _elements array.",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_lockTouchScroll",
-              "description": "Blocks touch-driven page scroll while a fullscreen modal dialog is open.\n\nThe showModal() function places the dialog in the browser's **top layer**,\nwhich is a separate rendering layer above the normal DOM. On mobile, the\ncompositor processes visual-viewport panning before top-layer touch\nhandling. This means the entire viewport — including the top-layer dialog\n— can be panned by a touch gesture, causing the page behind the dialog to\nscroll into view. To prevent this, we add a touchmove listener that cancels\nthe event if the touch started outside the dialog or any scrollable child within it.",
+              "name": "initializeState",
+              "description": "Initialize (or reinitialize) the form state.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_unlockTouchScroll",
-              "description": "Removes the touchmove listener added by _lockTouchScroll().",
-              "privacy": "private"
+              "name": "reset",
+              "description": "Resets all form elements to their initial state and fires a `reset` event. The event's `detail.previousValue` contains the form values captured immediately before the reset.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
               "kind": "method",
-              "name": "open",
-              "parameters": [
-                {
-                  "name": "modal",
-                  "default": "true"
+              "name": "submit",
+              "description": "Validates all form elements. If all are valid, fires a `submit` event with `detail.value` containing the current form values. If any element is invalid, its error state is surfaced and the `submit` event is not fired.",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
                 }
-              ]
+              }
             },
             {
               "kind": "method",
-              "name": "close",
-              "description": "Closes the dialog."
+              "name": "register",
+              "static": true,
+              "parameters": [
+                {
+                  "name": "name",
+                  "default": "\"auro-form\"",
+                  "description": "The custom element tag name to register.",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Registers the `auro-form` custom element with the browser under a given tag name."
             },
             {
-              "kind": "field",
-              "name": "_mobileBreakpointName",
-              "privacy": "private",
-              "default": "undefined"
+              "kind": "method",
+              "name": "sharedInputListener",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The event that is fired from the form element.",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Shared input listener for all form elements.",
+              "privacy": "private"
             },
             {
-              "kind": "field",
-              "name": "shape",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"rounded\"",
-              "attribute": "shape",
-              "reflects": true
+              "kind": "method",
+              "name": "sharedValidationListener",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The event that is fired from the form element.",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Shared validation listener for all form elements.",
+              "privacy": "private"
             },
             {
-              "kind": "field",
-              "name": "matchWidth",
-              "privacy": "private",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, the bib width will match the trigger width.",
-              "default": "false",
-              "attribute": "matchWidth",
-              "reflects": true
+              "kind": "method",
+              "name": "handleKeyDown",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The keyboard event.",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Handle Enter key press on form elements.",
+              "privacy": "private"
             },
             {
-              "kind": "field",
-              "name": "hasActiveDescendant",
-              "privacy": "private",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Tracks whether a menu option is currently highlighted.",
-              "default": "false",
-              "attribute": "hasActiveDescendant"
+              "kind": "method",
+              "name": "_attachEventListeners",
+              "description": "Attaches input, validation, and keydown listeners to all tracked form and button elements.\nRemoves existing listeners first to avoid duplicates on re-initialization.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "privacy": "private"
             },
             {
-              "type": {
-                "text": "String"
+              "kind": "method",
+              "name": "mutationEventListener",
+              "description": "Mutation observer for form elements. Slot change does not trigger unless\nroot-level elements are added/removed. This is a workaround to ensure\nnested form elements are also observed.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "description": "Defines the screen size breakpoint (`lg`, `md`, `sm`, or `xs`) at which the dropdown switches to fullscreen mode on mobile. When expanded, the dropdown will automatically display in fullscreen mode if the screen size is equal to or smaller than the selected breakpoint.",
-              "name": "fullscreenBreakpoint",
-              "kind": "field"
+              "privacy": "private"
             },
             {
-              "kind": "field",
-              "name": "isFullscreen",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "onSlotChange",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The slot change event.",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Slot change event listener. This is the main entry point for the form element.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "description": "If declared, will take the fullscreen when the bib is displayed.",
-              "attribute": "isFullscreen",
-              "reflects": true
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "common",
-              "privacy": "public",
+              "name": "formState",
+              "privacy": "private",
               "type": {
-                "text": "boolean"
+                "text": "FormState"
               },
-              "description": "If declared, will apply all styles for the common theme.",
-              "attribute": "common",
-              "reflects": true
+              "default": "{}"
             },
             {
               "kind": "field",
-              "name": "inset",
-              "privacy": "public",
+              "name": "_validity",
+              "privacy": "private",
               "type": {
-                "text": "boolean"
+                "text": "\"valid\" | \"invalid\" | null"
               },
-              "description": "If declared, will apply extra padding to bib content.",
-              "attribute": "inset",
-              "reflects": true
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "rounded",
-              "privacy": "public",
+              "name": "_isInitialState",
+              "privacy": "private",
               "type": {
                 "text": "boolean"
               },
-              "description": "If declared, will apply border-radius to the bib.",
-              "attribute": "rounded",
-              "reflects": true
+              "default": "true"
             },
             {
               "kind": "field",
-              "name": "bibTemplate",
-              "privacy": "public",
+              "name": "_elements",
+              "privacy": "private",
               "type": {
-                "text": "object"
+                "text": "(HTMLElement & {reset: () => void})[]"
               },
-              "description": "A reference to the associated bib template element.",
-              "attribute": "bibTemplate"
+              "default": "[]"
             },
             {
               "kind": "field",
-              "name": "dialogLabel",
+              "name": "_submitElements",
               "privacy": "private",
               "type": {
-                "text": "string"
+                "text": "HTMLButtonElement[]"
               },
-              "description": "Accessible label for the dialog element, used when displayed as a modal.\nApplied via aria-labelledby on a visually hidden element rather than\naria-label because iOS VoiceOver does not reliably read aria-label\non <dialog> elements.",
-              "attribute": "dialogLabel"
+              "default": "[]"
             },
             {
               "kind": "field",
-              "name": "dialogRole",
+              "name": "_resetElements",
               "privacy": "private",
               "type": {
-                "text": "string"
+                "text": "HTMLButtonElement[]"
               },
-              "description": "Overrides the native role of the dialog element.\nFor example, set to `\"presentation\"` on desktop combobox to prevent\nVoiceOver from announcing \"listbox inside of a dialog\".\nWhen `undefined`, the dialog keeps its native role.",
-              "attribute": "dialogRole"
-            }
-          ],
-          "events": [
-            {
-              "name": "auro-dropdownbib-connected",
-              "type": {
-                "text": "CustomEvent"
-              }
+              "default": "[]"
             },
             {
-              "name": "auro-bib-cancel",
+              "kind": "field",
+              "name": "mutationObservers",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "MutationObserver[]"
+              },
+              "privacy": "private",
+              "default": "[]"
             }
           ],
-          "attributes": [
-            {
-              "name": "isFullscreen",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, will take the fullscreen when the bib is displayed.",
-              "fieldName": "isFullscreen"
-            },
-            {
-              "name": "common",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, will apply all styles for the common theme.",
-              "fieldName": "common"
-            },
-            {
-              "name": "inset",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, will apply extra padding to bib content.",
-              "fieldName": "inset"
-            },
-            {
-              "name": "matchWidth",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, the bib width will match the trigger width.",
-              "default": "false",
-              "fieldName": "matchWidth"
-            },
-            {
-              "name": "rounded",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, will apply border-radius to the bib.",
-              "fieldName": "rounded"
-            },
-            {
-              "name": "bibTemplate",
-              "type": {
-                "text": "object"
-              },
-              "description": "A reference to the associated bib template element.",
-              "fieldName": "bibTemplate"
-            },
+          "events": [
             {
-              "name": "shape",
+              "name": "change",
               "type": {
-                "text": "string"
+                "text": "Event"
               },
-              "default": "\"rounded\"",
-              "fieldName": "shape"
+              "description": "Fires when a child form element's value changes or the form is initialized."
             },
             {
-              "name": "dialogLabel",
+              "name": "reset",
               "type": {
-                "text": "string"
+                "text": "CustomEvent"
               },
-              "description": "Accessible label for the dialog element, used when displayed as a modal.\nApplied via aria-labelledby on a visually hidden element rather than\naria-label because iOS VoiceOver does not reliably read aria-label\non <dialog> elements.",
-              "fieldName": "dialogLabel"
+              "description": "Fires when the form is reset. The event detail contains the previous value of the form before reset."
             },
             {
-              "name": "dialogRole",
+              "name": "submit",
               "type": {
-                "text": "string"
+                "text": "CustomEvent"
               },
-              "description": "Overrides the native role of the dialog element.\nFor example, set to `\"presentation\"` on desktop combobox to prevent\nVoiceOver from announcing \"listbox inside of a dialog\".\nWhen `undefined`, the dialog keeps its native role.",
-              "fieldName": "dialogRole"
+              "description": "Fires when the form is submitted. The event detail contains the current value of the form."
             },
             {
-              "name": "hasActiveDescendant",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Tracks whether a menu option is currently highlighted.",
-              "default": "false",
-              "fieldName": "hasActiveDescendant"
+              "description": "Fires when a child form element receives user input.",
+              "name": "input"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
+          "tagName": "auro-form",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AuroDropdownBib",
-          "declaration": {
-            "name": "AuroDropdownBib",
-            "module": "components/dropdown/src/auro-dropdownBib.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/dropdown/src/dropdownBibKeyboardStrategy.js",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "createDropdownBibKeyboardStrategy",
-          "parameters": [
-            {
-              "name": "bib",
-              "description": "The dropdown bib element.",
-              "type": {
-                "text": "HTMLElement"
-              }
-            }
-          ],
-          "description": "Creates a keyboard strategy for dialog-specific key handling.\nAll other keydown behavior is left to the browser's native bubbling path.",
-          "return": {
-            "type": {
-              "text": "Object"
-            }
-          }
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "createDropdownBibKeyboardStrategy",
-          "declaration": {
-            "name": "createDropdownBibKeyboardStrategy",
-            "module": "components/dropdown/src/dropdownBibKeyboardStrategy.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/dropdown/src/iconVersion.js",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
+          "name": "AuroForm",
           "declaration": {
-            "name": "9.2.0",
-            "module": "components/dropdown/src/iconVersion.js"
+            "name": "AuroForm",
+            "module": "components/form/src/auro-form.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/dropdown/src/index.js",
+      "path": "components/form/src/index.js",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "AuroDropdown",
+          "name": "AuroForm",
           "declaration": {
-            "name": "AuroDropdown",
-            "module": "components/dropdown/src/index.js"
+            "name": "AuroForm",
+            "module": "components/form/src/index.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/dropdown/src/registered.js",
+      "path": "components/form/src/registered.js",
       "declarations": [],
       "exports": []
     },