@redvars/peacock 3.8.1 → 3.8.3

package/dist/custom-elements-jsdocs.json

@@ -3,7 +3,7 @@
     "label": "Accordion",
     "tag": "wc-accordion",
     "rawTag": "accordion",
-    "summary": "A vertically stacked set of expansion panels. Follows Material Design 3 expansion panel guidelines.",
+    "summary": "A vertically stacked set of expansion panels.",
     "example": "```html\n<wc-accordion>\n  <wc-accordion-item>\n    <span slot=\"heading\">Panel 1</span>\n    <span slot=\"description\">Summary text</span>\n    Content\n  </wc-accordion-item>\n  <wc-accordion-item>\n    <span slot=\"heading\">Panel 2</span>\n    Content\n  </wc-accordion-item>\n</wc-accordion>\n```",
     "tags": "display",
     "customElement": {
@@ -42,183 +42,270 @@
     }
   },
   {
-    "label": "Avatar",
-    "tag": "wc-avatar",
-    "rawTag": "avatar",
-    "summary": "The Avatar component is used to represent user, and displays the profile picture, initials or fallback icon.",
-    "cssprop": "--avatar-text-color - Controls the color of the text inside the avatar.",
-    "example": "```html\n<wc-avatar name=\"Shivaji Varma\" src=\"https://peacock.redvars.com/assets/img/avatar.xs.webp\" style='--avatar-size: 4rem'></wc-avatar>\n```",
-    "tags": "display",
+    "label": "Alert",
+    "tag": "wc-alert",
+    "rawTag": "alert",
+    "summary": "Alerts show short, prominent contextual messages with optional icon and description.",
+    "cssprop": "--alert-border-radius - Border radius of the alert surface.",
+    "example": "```html\n<wc-alert variant=\"note\" description=\"Use semantic roles that preserve a 3:1 contrast ratio.\"></wc-alert>\n```",
+    "tags": "display, feedback",
     "customElement": {
       "kind": "class",
       "description": "",
       "cssProperties": [
         {
-          "description": "Controls the border radius of the avatar.",
-          "name": "--avatar-border-radius"
+          "description": "Background color of the alert container.",
+          "name": "--alert-container-color"
         },
         {
-          "description": "Controls the color of the avatar container.",
-          "name": "--avatar-container-color"
+          "description": "Label text color.",
+          "name": "--alert-label-text-color"
         },
         {
-          "description": "Controls the size of the avatar.",
-          "name": "--avatar-size"
+          "description": "Description text color.",
+          "name": "--alert-description-text-color"
         },
         {
-          "description": "Controls the color of the text inside the avatar.",
-          "name": "--avatar-text-color"
+          "description": "Icon color.",
+          "name": "--alert-icon-color"
+        },
+        {
+          "description": "Border radius of the alert surface.",
+          "name": "--alert-border-radius"
         }
       ],
       "attributes": [
         {
-          "name": "name",
+          "name": "variant",
           "type": {
-            "text": "string"
+            "text": "AlertVariant"
           },
-          "default": "''",
-          "fieldName": "name"
+          "default": "'note'",
+          "description": "Visual intent of the alert.",
+          "fieldName": "variant",
+          "expandedType": {
+            "text": "'note' | 'info' | 'success' | 'warning' | 'error'"
+          }
         },
         {
-          "name": "src",
+          "name": "label",
           "type": {
             "text": "string | undefined"
           },
-          "fieldName": "src"
+          "description": "Optional explicit label text. Falls back to a variant-based label.",
+          "fieldName": "label"
+        },
+        {
+          "name": "icon",
+          "type": {
+            "text": "string | undefined"
+          },
+          "description": "Optional explicit icon name. Falls back to a variant-based icon.",
+          "fieldName": "icon"
+        },
+        {
+          "name": "description",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "description": "Optional description text when a default slot is not provided.",
+          "fieldName": "description"
         }
       ],
       "superclass": {
         "name": "LitElement",
         "package": "lit"
       },
-      "tagName": "wc-avatar",
+      "tagName": "wc-alert",
       "customElement": true,
       "rawTag": {
-        "name": "avatar",
+        "name": "alert",
         "description": ""
       }
     }
   },
   {
-    "label": "Badge",
-    "tag": "wc-badge",
-    "rawTag": "badge",
-    "summary": "The badge component is used to display a small amount of information to the user.",
-    "cssprop": "--badge-color - Controls the color of the badge.",
-    "example": "```html\n<wc-badge value=\"1\"></wc-badge>\n```",
-    "tags": "display",
+    "label": "App Bar",
+    "tag": "wc-app-bar",
+    "rawTag": "app-bar",
+    "summary": "A top app bar for page-level navigation and actions.",
+    "overview": "<p>The app bar component implements the top app bar pattern. It provides a\nconsistent header for screens, housing a navigation icon, a page title/headline, and\noptional trailing action icons.</p>\n\n<p>Four size variants are available: <strong>small</strong> (64dp, single-row),\n<strong>center-aligned</strong> (64dp, centred headline), <strong>medium</strong>\n(112dp, headline below the row), and <strong>large</strong> (152dp, large headline).</p>\n\n<p>Use the <code>leading</code> slot for a navigation icon (e.g. a hamburger or back\nbutton), the default slot for the headline text, and the <code>trailing</code> slot for\naction icon buttons.</p>",
+    "slot": "trailing - Trailing action icon buttons placed at the end of the bar.",
+    "cssprop": "--app-bar-shadow - Box-shadow applied when the bar is scrolled / elevated.",
+    "example": "```html\n<!-- Large app bar -->\n<wc-app-bar variant=\"large\">\n  <wc-icon-button slot=\"leading\" variant=\"text\"><wc-icon name=\"arrow_back\"></wc-icon></wc-icon-button>\n  Large Headline\n  <wc-icon-button slot=\"trailing\" variant=\"text\"><wc-icon name=\"more_vert\"></wc-icon></wc-icon-button>\n</wc-app-bar>\n```",
+    "tags": "navigation display",
     "customElement": {
       "kind": "class",
       "description": "",
       "cssProperties": [
         {
-          "description": "Controls the color of the badge.",
-          "name": "--badge-color"
+          "description": "Background color of the app bar.",
+          "name": "--app-bar-container-color"
+        },
+        {
+          "description": "Height of the bar in small / center-aligned variants.",
+          "name": "--app-bar-container-height"
+        },
+        {
+          "description": "Color of the headline text.",
+          "name": "--app-bar-headline-color"
+        },
+        {
+          "description": "Color of the leading slot icons.",
+          "name": "--app-bar-leading-icon-color"
+        },
+        {
+          "description": "Color of the trailing slot icons.",
+          "name": "--app-bar-trailing-icon-color"
+        },
+        {
+          "description": "Box-shadow applied when the bar is scrolled / elevated.",
+          "name": "--app-bar-shadow"
+        }
+      ],
+      "slots": [
+        {
+          "description": "Navigation icon placed at the start of the bar.",
+          "name": "leading"
+        },
+        {
+          "description": "Headline / title text.",
+          "name": ""
+        },
+        {
+          "description": "Trailing action icon buttons placed at the end of the bar.",
+          "name": "trailing"
         }
       ],
       "attributes": [
         {
-          "name": "value",
+          "name": "variant",
           "type": {
-            "text": "string"
+            "text": "'small' | 'center-aligned' | 'medium' | 'large'"
           },
-          "default": "''",
-          "description": "The value to display in the badge.",
-          "fieldName": "value"
+          "default": "'small'",
+          "description": "Visual variant of the app bar.\n- `\"small\"`: 64dp single-row bar with leading, title, and trailing (default).\n- `\"center-aligned\"`: 64dp single-row bar with a centred headline.\n- `\"medium\"`: Two-row bar (64dp top row + 48dp headline row).\n- `\"large\"`: Two-row bar with a larger headline (64dp top row + 88dp headline row).",
+          "fieldName": "variant"
+        },
+        {
+          "name": "scrolled",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false",
+          "description": "Whether the bar is in its scrolled state, which adds a shadow and optionally\nchanges the container color to indicate elevation above page content.",
+          "fieldName": "scrolled"
         }
       ],
       "superclass": {
         "name": "LitElement",
         "package": "lit"
       },
-      "tagName": "wc-badge",
+      "tagName": "wc-app-bar",
       "customElement": true,
       "rawTag": {
-        "name": "badge",
+        "name": "app-bar",
         "description": ""
       }
     }
   },
   {
-    "label": "Banner",
-    "tag": "wc-banner",
-    "rawTag": "banner",
-    "summary": "Banners show short, prominent contextual messages with optional icon and description.",
-    "cssprop": "--banner-border-radius - Border radius of the banner surface.",
-    "example": "```html\n<wc-banner variant=\"note\" description=\"Use semantic roles that preserve a 3:1 contrast ratio.\"></wc-banner>\n```",
-    "tags": "display, feedback",
+    "label": "Avatar",
+    "tag": "wc-avatar",
+    "rawTag": "avatar",
+    "summary": "The Avatar component is used to represent user, and displays the profile picture, initials or fallback icon.",
+    "cssprop": "--avatar-text-color - Controls the color of the text inside the avatar.",
+    "example": "```html\n<wc-avatar name=\"Shivaji Varma\" src=\"https://peacock.redvars.com/assets/img/avatar.xs.webp\" style='--avatar-size: 4rem'></wc-avatar>\n```",
+    "tags": "display",
     "customElement": {
       "kind": "class",
       "description": "",
       "cssProperties": [
         {
-          "description": "Background color of the banner container.",
-          "name": "--banner-container-color"
-        },
-        {
-          "description": "Label text color.",
-          "name": "--banner-label-text-color"
+          "description": "Controls the border radius of the avatar.",
+          "name": "--avatar-border-radius"
         },
         {
-          "description": "Description text color.",
-          "name": "--banner-description-text-color"
+          "description": "Controls the color of the avatar container.",
+          "name": "--avatar-container-color"
         },
         {
-          "description": "Icon color.",
-          "name": "--banner-icon-color"
+          "description": "Controls the size of the avatar.",
+          "name": "--avatar-size"
         },
         {
-          "description": "Border radius of the banner surface.",
-          "name": "--banner-border-radius"
+          "description": "Controls the color of the text inside the avatar.",
+          "name": "--avatar-text-color"
         }
       ],
       "attributes": [
         {
-          "name": "variant",
+          "name": "name",
           "type": {
-            "text": "BannerVariant"
+            "text": "string"
           },
-          "default": "'note'",
-          "description": "Visual intent of the banner.",
-          "fieldName": "variant",
-          "expandedType": {
-            "text": "'note' | 'info' | 'success' | 'warning' | 'error'"
-          }
+          "default": "''",
+          "description": "Full name of the person. Used to derive initials when no `src` is provided.",
+          "fieldName": "name"
         },
         {
-          "name": "label",
+          "name": "src",
           "type": {
             "text": "string | undefined"
           },
-          "description": "Optional explicit label text. Falls back to a variant-based label.",
-          "fieldName": "label"
-        },
+          "description": "URL of the avatar image. When provided, the image is displayed instead of initials.",
+          "fieldName": "src"
+        }
+      ],
+      "superclass": {
+        "name": "LitElement",
+        "package": "lit"
+      },
+      "tagName": "wc-avatar",
+      "customElement": true,
+      "rawTag": {
+        "name": "avatar",
+        "description": ""
+      }
+    }
+  },
+  {
+    "label": "Badge",
+    "tag": "wc-badge",
+    "rawTag": "badge",
+    "summary": "The badge component is used to display a small amount of information to the user.",
+    "cssprop": "--badge-color - Controls the color of the badge.",
+    "example": "```html\n<wc-badge value=\"1\"></wc-badge>\n```",
+    "tags": "display",
+    "customElement": {
+      "kind": "class",
+      "description": "",
+      "cssProperties": [
         {
-          "name": "icon",
-          "type": {
-            "text": "string | undefined"
-          },
-          "description": "Optional explicit icon name. Falls back to a variant-based icon.",
-          "fieldName": "icon"
-        },
+          "description": "Controls the color of the badge.",
+          "name": "--badge-color"
+        }
+      ],
+      "attributes": [
         {
-          "name": "description",
+          "name": "value",
           "type": {
             "text": "string"
           },
           "default": "''",
-          "description": "Optional description text when a default slot is not provided.",
-          "fieldName": "description"
+          "description": "The value to display in the badge.",
+          "fieldName": "value"
         }
       ],
       "superclass": {
         "name": "LitElement",
         "package": "lit"
       },
-      "tagName": "wc-banner",
+      "tagName": "wc-badge",
       "customElement": true,
       "rawTag": {
-        "name": "banner",
+        "name": "badge",
         "description": ""
       }
     }
@@ -227,7 +314,7 @@
     "label": "Bottom Sheet",
     "tag": "wc-bottom-sheet",
     "rawTag": "bottom-sheet",
-    "summary": "Bottom sheets slide up from the bottom of the screen to reveal additional content. Supports standard and modal variants per Material Design 3.",
+    "summary": "Bottom sheets slide up from the bottom of the screen to reveal additional content. Supports standard and modal variants.",
     "cssprop": "--bottom-sheet-max-height - Maximum height of the sheet.",
     "example": "```html\nBottom Sheet\n```",
     "tags": "navigation, overlay",
@@ -493,51 +580,69 @@
         {
           "name": "size",
           "type": {
-            "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
+            "text": "ButtonSize"
           },
           "default": "'sm'",
           "description": "Button size.\nPossible values are `\"xs\"`, `\"sm\"`, `\"md\"`, `\"lg\"`, `\"xl\"`. Defaults to `\"sm\"`.",
-          "fieldName": "size"
+          "fieldName": "size",
+          "expandedType": {
+            "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
+          }
         },
         {
-          "name": "type",
+          "name": "level",
           "type": {
-            "text": "'primary' | 'secondary' | 'tertiary' | undefined"
+            "text": "ButtonLevel | undefined"
           },
-          "description": "Type is preset of color and variant. Type will be only applied.",
-          "fieldName": "type"
+          "description": "Level is preset of color and variant. If Level provided it overrides the default color and variant.",
+          "fieldName": "level",
+          "expandedType": {
+            "text": "'primary' | 'secondary' | 'tertiary' | 'danger' | undefined"
+          }
+        },
+        {
+          "name": "shape",
+          "type": {
+            "text": "ButtonShape"
+          },
+          "default": "'square'",
+          "description": "Shape of the button container.",
+          "fieldName": "shape",
+          "expandedType": {
+            "text": "'round' | 'square'"
+          }
         },
         {
           "name": "variant",
           "type": {
-            "text": "| 'elevated'\n    | 'filled'\n    | 'tonal'\n    | 'outlined'\n    | 'text'\n    | 'neo'"
+            "text": "string"
           },
           "default": "'filled'",
-          "description": "The visual style of the button.\n\n Possible variant values:\n`\"filled\"` is a filled button.\n`\"outlined\"` is an outlined button.\n`\"text\"` is a transparent button.\n`\"tonal\"` is a light color button.\n`\"elevated\"` is elevated button",
           "fieldName": "variant",
+          "description": "The visual style of the button.\n\n Possible variant values:\n`\"filled\"` is a filled button.\n`\"outlined\"` is an outlined button.\n`\"text\"` is a transparent button.\n`\"tonal\"` is a light color button.\n`\"elevated\"` is elevated button",
           "expandedType": {
             "text": "'elevated' | 'filled' | 'tonal' | 'outlined' | 'text' | 'neo'"
+          },
+          "inheritedFrom": {
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
           "name": "color",
           "type": {
-            "text": "| 'primary'\n    | 'success'\n    | 'danger'\n    | 'warning'\n    | 'surface'\n    | 'on-surface'"
+            "text": "string"
           },
           "default": "'primary'",
-          "description": "Defines the primary color of the button. This can be set to predefined color names to apply specific color themes.",
           "fieldName": "color",
+          "description": "Defines the primary color of the button. This can be set to predefined color names to apply specific color themes.",
           "expandedType": {
             "text": "'primary' | 'success' | 'danger' | 'warning' | 'surface' | 'on-surface'"
-          }
-        },
-        {
-          "name": "configAria",
-          "type": {
-            "text": "{ [key: string]: any } | undefined"
           },
-          "description": "Additional ARIA attributes to pass to the inner button/anchor element.",
-          "fieldName": "configAria"
+          "inheritedFrom": {
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
+          }
         },
         {
           "name": "skeleton",
@@ -545,6 +650,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, renders the button in a loading skeleton state.",
           "fieldName": "skeleton"
         },
         {
@@ -553,6 +659,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the button acts as a toggle. Use with `selected`.",
           "fieldName": "toggle"
         },
         {
@@ -561,57 +668,28 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true (and `toggle` is set), the button is in the selected/pressed state.",
           "fieldName": "selected"
         },
-        {
-          "name": "throttleDelay",
-          "type": {
-            "text": "number"
-          },
-          "default": "200",
-          "description": "Sets the delay for throttle in milliseconds. Defaults to 200 milliseconds.",
-          "fieldName": "throttleDelay"
-        },
         {
           "name": "tooltip",
           "type": {
             "text": "string | undefined"
           },
+          "description": "Optional tooltip text displayed on hover.",
           "fieldName": "tooltip"
         },
-        {
-          "name": "pressed",
-          "type": {
-            "text": "boolean"
-          },
-          "default": "false",
-          "description": "States",
-          "fieldName": "pressed"
-        },
-        {
-          "name": "htmlType",
-          "type": {
-            "text": "'button' | 'submit' | 'reset'"
-          },
-          "default": "'button'",
-          "description": "The type of the underlying `<button>` element. Maps to the native `type` attribute.\nPossible values are `\"button\"`, `\"submit\"`, `\"reset\"`. Defaults to `\"button\"`.",
-          "fieldName": "htmlType",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
         {
           "name": "disabled",
+          "fieldName": "disabled",
           "type": {
             "text": "boolean"
           },
           "default": "false",
           "description": "When `true`, the button is disabled and cannot be interacted with. Reflects to the `disabled` attribute. Defaults to `false`.",
-          "fieldName": "disabled",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinFormAssociated",
+            "module": "src/__internal/mixins/form-associated.ts"
           }
         },
         {
@@ -623,8 +701,8 @@
           "description": "When `true`, the button is visually styled as disabled and cannot be interacted with, but remains focusable.\nUse this in combination with `disabledReason` to communicate why the button is unavailable.\nReflects to the `soft-disabled` attribute. Defaults to `false`.",
           "fieldName": "softDisabled",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
@@ -636,107 +714,126 @@
           "description": "A human-readable explanation of why the button is disabled or soft-disabled.\nRendered as a visually hidden tooltip and linked via `aria-describedby` for accessibility.\nMaps to the `disabled-reason` attribute.",
           "fieldName": "disabledReason",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
-          "name": "form",
+          "name": "throttleDelay",
           "type": {
-            "text": "string"
+            "text": "number | undefined"
           },
-          "default": "''",
-          "description": "The `id` of the `<form>` element to associate the button with.\nIf omitted, the button is associated with its nearest ancestor form.\nMaps to the native `form` attribute.",
-          "fieldName": "form",
+          "description": "Sets the delay for throttle in milliseconds. When undefined (default), no throttle is applied.",
+          "fieldName": "throttleDelay",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
-          "name": "name",
+          "name": "href",
           "type": {
-            "text": "string"
+            "text": "string | undefined"
           },
-          "default": "''",
-          "description": "The name of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `name` attribute.",
-          "fieldName": "name",
+          "fieldName": "href",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "value",
+          "name": "target",
           "type": {
-            "text": "string"
+            "text": "'_self' | '_parent' | '_blank' | '_top' | string"
           },
-          "default": "''",
-          "description": "The value of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `value` attribute.",
-          "fieldName": "value",
+          "default": "'_self'",
+          "fieldName": "target",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "href",
+          "name": "rel",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "The URL that the hyperlink points to. When set, the component renders as an `<a>` element.\nMaps to the native `href` attribute.",
-          "fieldName": "href",
+          "default": "''",
+          "fieldName": "rel",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "target",
+          "name": "download",
           "type": {
-            "text": "'_self' | '_parent' | '_blank' | '_top' | string"
+            "text": "string"
           },
-          "default": "'_self'",
-          "description": "Where to display the linked URL. Maps to the native `target` attribute.\nPossible values are `\"_self\"`, `\"_blank\"`, `\"_parent\"`, `\"_top\"`, or a custom frame name.\nWhen using `\"_blank\"`, consider setting `rel=\"noopener noreferrer\"` for security. Defaults to `\"_self\"`.",
-          "fieldName": "target",
+          "default": "''",
+          "fieldName": "download",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "rel",
+          "name": "type",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "The relationship between the current document and the linked URL.\nMaps to the native `rel` attribute on the rendered `<a>` element.\nWhen `target=\"_blank\"`, use `\"noopener noreferrer\"` to prevent tab-napping attacks.",
-          "fieldName": "rel",
+          "default": "'submit'",
+          "fieldName": "type",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinFormSubmitter",
+            "module": "src/__internal/mixins/form-submitter.ts"
           }
         },
         {
-          "name": "download",
+          "name": "value",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "Causes the browser to download the linked URL instead of navigating to it.\nIf a string value is provided, it is used as the suggested filename.\nOmit or leave undefined to preserve normal navigation behaviour.\nMaps to the native `download` attribute. Only applies when `href` is set.",
-          "fieldName": "download",
+          "default": "''",
+          "fieldName": "value",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinFormSubmitter",
+            "module": "src/__internal/mixins/form-submitter.ts"
+          }
+        },
+        {
+          "name": "name",
+          "fieldName": "name",
+          "inheritedFrom": {
+            "name": "mixinFormAssociated",
+            "module": "src/__internal/mixins/form-associated.ts"
           }
         }
       ],
       "mixins": [
         {
-          "name": "NativeButtonMixin",
-          "package": "@/__mixins/NativeButtonMixin.js"
+          "name": "mixinBaseButton",
+          "module": "/src/button/base-button/base-button.js"
         },
         {
-          "name": "NativeHyperlinkMixin",
-          "package": "@/__mixins/NativeHyperlinkMixin.js"
+          "name": "mixinHyperlink",
+          "package": "@/__internal/mixins/hyperlink.js"
+        },
+        {
+          "name": "mixinDelegatesAria",
+          "package": "@/__internal/aria/delegate.js"
+        },
+        {
+          "name": "mixinFormSubmitter",
+          "package": "@/__internal/mixins/form-submitter.js"
+        },
+        {
+          "name": "mixinFormAssociated",
+          "package": "@/__internal/mixins/form-associated.js"
+        },
+        {
+          "name": "mixinElementInternals",
+          "package": "@/__internal/mixins/element-internals.js"
         }
       ],
       "superclass": {
@@ -756,7 +853,7 @@
     "tag": "wc-button-group",
     "rawTag": "button-group",
     "summary": "Group a series of buttons together on a single line with the button group, and super-power.",
-    "example": "```html\n<wc-button-group variant=\"connected\">\n <wc-icon-button toggle selected><wc-icon name=\"home\"></wc-icon></wc-icon-button>\n <wc-icon-button toggle><wc-icon name=\"alarm\"></wc-icon></wc-icon-button>\n</wc-button-group>\n```",
+    "example": "```html\n<wc-button-group connected>\n <wc-icon-button toggle=\"true\" shape=\"wide\" selected>\n   <wc-icon name=\"format_bold\"></wc-icon>\n </wc-icon-button>\n <wc-icon-button toggle=\"true\" shape=\"wide\">\n   <wc-icon name=\"format_italic\"></wc-icon>\n </wc-icon-button>\n <wc-icon-button toggle=\"true\" shape=\"wide\">\n   <wc-icon name=\"format_underlined\"></wc-icon>\n </wc-icon-button>\n</wc-button-group>\n```",
     "tags": "controls",
     "customElement": {
       "kind": "class",
@@ -772,27 +869,18 @@
           "fieldName": "size"
         },
         {
-          "name": "variant",
+          "name": "connected",
           "type": {
-            "text": "'standard' | 'connected'"
-          },
-          "default": "'standard'",
-          "description": "Layout variant of the button group.\n`\"standard\"` shows buttons with a small gap between them.\n`\"connected\"` places buttons with a 2px gap; in horizontal orientation outer buttons have fully\nrounded outer corners and middle buttons keep standard rounded corners. In vertical orientation\nall buttons keep their default corner shape.\nDefaults to `\"standard\"`.",
-          "fieldName": "variant"
-        },
-        {
-          "name": "orientation",
-          "type": {
-            "text": "'horizontal' | 'vertical'"
+            "text": "boolean"
           },
-          "default": "'horizontal'",
-          "description": "Orientation of the button group.\n`\"horizontal\"` lays buttons out in a row.\n`\"vertical\"` stacks buttons in a column.\nDefaults to `\"horizontal\"`.",
-          "fieldName": "orientation"
+          "default": "false",
+          "description": "Layout variant of the button group.\n`\"standard\"` shows buttons with a small gap between them.\n`\"connected\"` places buttons with a 2px gap;\nrounded outer corners and middle buttons keep standard rounded corners.\nDefaults to `\"standard\"`.",
+          "fieldName": "connected"
         },
         {
           "name": "color",
           "type": {
-            "text": "| 'primary'\n    | 'success'\n    | 'danger'\n    | 'warning'\n    | 'surface'\n    | 'on-surface' | undefined"
+            "text": "ButtonColor | undefined"
           },
           "description": "Color applied to all buttons in the group.\nPossible values are `\"primary\"`, `\"success\"`, `\"danger\"`, `\"warning\"`, `\"surface\"`, `\"on-surface\"`.",
           "fieldName": "color",
@@ -801,12 +889,12 @@
           }
         },
         {
-          "name": "button-variant",
+          "name": "variant",
           "type": {
             "text": "| 'filled'\n    | 'tonal'\n    | 'outlined' | undefined"
           },
           "description": "Visual style applied to all buttons in the group.\nPossible values are `\"filled\"`, `\"tonal\"`, `\"outlined\"`.",
-          "fieldName": "buttonVariant",
+          "fieldName": "variant",
           "expandedType": {
             "text": "'filled' | 'tonal' | 'outlined' | undefined"
           }
@@ -828,7 +916,7 @@
     "label": "Calendar",
     "tag": "wc-calendar",
     "rawTag": "calendar",
-    "summary": "A Material 3 inspired full calendar component for displaying events in day, week, or month views.",
+    "summary": "A full calendar component for displaying events in day, week, or month views.",
     "cssprop": "--calendar-event-border-color - Left border color for calendar events.",
     "fires": "date-change - Dispatched when the context date changes. Detail contains `{ date }`.",
     "example": "```html\n<wc-calendar view=\"week\" style=\"height: 600px\"></wc-calendar>\n```",
@@ -1058,7 +1146,7 @@
     "label": "Canvas",
     "tag": "wc-canvas",
     "rawTag": "canvas",
-    "summary": "A Material 3 inspired SVG canvas for drawing shapes, lines, and connectors on a dotted grid.",
+    "summary": "A SVG canvas for drawing shapes, lines, and connectors on a dotted grid.",
     "cssprop": "--canvas-arrow-color - Stroke color for arrow markers. Defaults to on-surface.",
     "example": "```html\n<wc-canvas id=\"my-canvas\"></wc-canvas>\n<script>\n  document.querySelector('#my-canvas').shapes = [\n    { type: 'circle', x: 0, y: 0, radius: 0.25, color: 'red' },\n  ];\n</script>\n```",
     "customElement": {
@@ -1139,7 +1227,7 @@
     "label": "Card",
     "tag": "wc-card",
     "rawTag": "card",
-    "summary": "A Material 3 inspired card surface for grouping related content.",
+    "summary": "A card surface for grouping related content.",
     "cssprop": "--card-gap - Gap between slotted children.",
     "example": "```html\n<wc-card variant=\"outlined\" style=\"padding-block: 1rem;\">\n  <wc-card-content>\n    <h3 class=\"text-headline\">Title</h3>\n    <p class=\"text-body\">Supportive text</p>\n  </wc-card-content>\n</wc-card>\n```",
     "customElement": {
@@ -1199,10 +1287,9 @@
         {
           "name": "throttleDelay",
           "type": {
-            "text": "number"
+            "text": "number | undefined"
           },
-          "default": "200",
-          "description": "Sets the delay for throttle in milliseconds. Defaults to 200 milliseconds.",
+          "description": "Sets the delay for throttle in milliseconds. When null (default), no throttle is applied.",
           "fieldName": "throttleDelay"
         },
         {
@@ -1214,7 +1301,7 @@
           "fieldName": "href",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         },
         {
@@ -1227,7 +1314,7 @@
           "fieldName": "target",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         },
         {
@@ -1239,7 +1326,7 @@
           "fieldName": "rel",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         },
         {
@@ -1251,14 +1338,14 @@
           "fieldName": "download",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         }
       ],
       "mixins": [
         {
           "name": "NativeHyperlinkMixin",
-          "package": "@/__mixins/NativeHyperlinkMixin.js"
+          "package": "@/__internal/mixins/NativeHyperlinkMixin.js"
         }
       ],
       "superclass": {
@@ -1461,7 +1548,7 @@
     "label": "Chart Bar",
     "tag": "wc-chart-bar",
     "rawTag": "chart-bar",
-    "summary": "A vertical bar chart that follows Material Design 3 color and spacing tokens.",
+    "summary": "A vertical bar chart that follows color and spacing tokens.",
     "tags": "charts",
     "example": "```html\n<wc-chart-bar width=\"520\" height=\"320\"></wc-chart-bar>\n<script>\n  document.querySelector('wc-chart-bar').data = [\n    { name: 'apples', label: 'Apples', value: 20 },\n    { name: 'bananas', label: 'Bananas', value: 35 },\n    { name: 'cherries', label: 'Cherries', value: 15 },\n  ];\n</script>\n```",
     "customElement": {
@@ -1658,7 +1745,7 @@
     "label": "Chart Stacked Bar",
     "tag": "wc-chart-stacked-bar",
     "rawTag": "chart-stacked-bar",
-    "summary": "A stacked bar chart that groups series by category using Material Design 3 tokens.",
+    "summary": "A stacked bar chart that groups series by category using tokens.",
     "tags": "charts",
     "example": "```html\n<wc-chart-stacked-bar width=\"560\" height=\"360\"></wc-chart-stacked-bar>\n<script>\n  document.querySelector('wc-chart-stacked-bar').data = [\n    {\n      name: 'q1',\n      label: 'Q1',\n      segments: [\n        { name: 'mobile', label: 'Mobile', value: 40 },\n        { name: 'web', label: 'Web', value: 25 },\n        { name: 'store', label: 'Store', value: 15 },\n      ],\n    },\n    {\n      name: 'q2',\n      label: 'Q2',\n      segments: [\n        { name: 'mobile', label: 'Mobile', value: 32 },\n        { name: 'web', label: 'Web', value: 30 },\n        { name: 'store', label: 'Store', value: 18 },\n      ],\n    },\n  ];\n</script>\n```",
     "customElement": {
@@ -1737,7 +1824,7 @@
     "tag": "wc-checkbox",
     "rawTag": "checkbox",
     "summary": "Captures boolean input with an optional indeterminate mode.",
-    "overview": "<p>Checkboxes allow users to select one or more items from a set. Checkboxes can turn an option on or off.</p>\n<p>Material Design 3 checkboxes feature a smooth animation and clear visual states for checked, unchecked, and indeterminate.</p>",
+    "overview": "<p>Checkboxes allow users to select one or more items from a set. Checkboxes can turn an option on or off.</p>\n<p>checkboxes feature a smooth animation and clear visual states for checked, unchecked, and indeterminate.</p>",
     "cssprop": "--checkbox-state-layer-size: Size of the state layer for touch target.",
     "fires": "focus - Dispatched when the checkbox receives focus.",
     "tags": "input, form",
@@ -1936,59 +2023,60 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, renders the chip in a loading skeleton state.",
           "fieldName": "skeleton"
         },
-        {
-          "name": "toggle",
-          "type": {
-            "text": "boolean"
-          },
-          "default": "false",
-          "fieldName": "toggle"
-        },
         {
           "name": "selected",
           "type": {
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the chip is in the selected/pressed state.",
           "fieldName": "selected"
         },
         {
           "name": "throttleDelay",
           "type": {
-            "text": "number"
+            "text": "number | undefined"
           },
-          "default": "200",
-          "description": "Sets the delay for throttle in milliseconds. Defaults to 200 milliseconds.",
-          "fieldName": "throttleDelay"
+          "description": "Sets the delay for throttle in milliseconds. When null (default), no throttle is applied.",
+          "fieldName": "throttleDelay",
+          "inheritedFrom": {
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
+          }
         },
         {
           "name": "tooltip",
           "type": {
             "text": "string | undefined"
           },
+          "description": "Optional tooltip text displayed on hover.",
           "fieldName": "tooltip"
         },
         {
-          "name": "pressed",
+          "name": "variant",
           "type": {
-            "text": "boolean"
+            "text": "string"
           },
-          "default": "false",
-          "fieldName": "pressed"
+          "default": "''",
+          "fieldName": "variant",
+          "inheritedFrom": {
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
+          }
         },
         {
-          "name": "htmlType",
+          "name": "color",
           "type": {
-            "text": "'button' | 'submit' | 'reset'"
+            "text": "string"
           },
-          "default": "'button'",
-          "description": "The type of the underlying `<button>` element. Maps to the native `type` attribute.\nPossible values are `\"button\"`, `\"submit\"`, `\"reset\"`. Defaults to `\"button\"`.",
-          "fieldName": "htmlType",
+          "default": "''",
+          "fieldName": "color",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
@@ -2000,8 +2088,8 @@
           "description": "When `true`, the button is disabled and cannot be interacted with. Reflects to the `disabled` attribute. Defaults to `false`.",
           "fieldName": "disabled",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
@@ -2013,8 +2101,8 @@
           "description": "When `true`, the button is visually styled as disabled and cannot be interacted with, but remains focusable.\nUse this in combination with `disabledReason` to communicate why the button is unavailable.\nReflects to the `soft-disabled` attribute. Defaults to `false`.",
           "fieldName": "softDisabled",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
@@ -2026,47 +2114,8 @@
           "description": "A human-readable explanation of why the button is disabled or soft-disabled.\nRendered as a visually hidden tooltip and linked via `aria-describedby` for accessibility.\nMaps to the `disabled-reason` attribute.",
           "fieldName": "disabledReason",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "form",
-          "type": {
-            "text": "string"
-          },
-          "default": "''",
-          "description": "The `id` of the `<form>` element to associate the button with.\nIf omitted, the button is associated with its nearest ancestor form.\nMaps to the native `form` attribute.",
-          "fieldName": "form",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "name",
-          "type": {
-            "text": "string"
-          },
-          "default": "''",
-          "description": "The name of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `name` attribute.",
-          "fieldName": "name",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "value",
-          "type": {
-            "text": "string"
-          },
-          "default": "''",
-          "description": "The value of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `value` attribute.",
-          "fieldName": "value",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
@@ -2074,11 +2123,10 @@
           "type": {
             "text": "string | undefined"
           },
-          "description": "The URL that the hyperlink points to. When set, the component renders as an `<a>` element.\nMaps to the native `href` attribute.",
           "fieldName": "href",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
@@ -2087,46 +2135,53 @@
             "text": "'_self' | '_parent' | '_blank' | '_top' | string"
           },
           "default": "'_self'",
-          "description": "Where to display the linked URL. Maps to the native `target` attribute.\nPossible values are `\"_self\"`, `\"_blank\"`, `\"_parent\"`, `\"_top\"`, or a custom frame name.\nWhen using `\"_blank\"`, consider setting `rel=\"noopener noreferrer\"` for security. Defaults to `\"_self\"`.",
           "fieldName": "target",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
           "name": "rel",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "The relationship between the current document and the linked URL.\nMaps to the native `rel` attribute on the rendered `<a>` element.\nWhen `target=\"_blank\"`, use `\"noopener noreferrer\"` to prevent tab-napping attacks.",
+          "default": "''",
           "fieldName": "rel",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
           "name": "download",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "Causes the browser to download the linked URL instead of navigating to it.\nIf a string value is provided, it is used as the suggested filename.\nOmit or leave undefined to preserve normal navigation behaviour.\nMaps to the native `download` attribute. Only applies when `href` is set.",
+          "default": "''",
           "fieldName": "download",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         }
       ],
       "mixins": [
         {
-          "name": "NativeButtonMixin",
-          "package": "@/__mixins/NativeButtonMixin.js"
+          "name": "mixinBaseButton",
+          "package": "@/button/base-button/base-button.js"
         },
         {
-          "name": "NativeHyperlinkMixin",
-          "package": "@/__mixins/NativeHyperlinkMixin.js"
+          "name": "mixinHyperlink",
+          "package": "@/__internal/mixins/hyperlink.js"
+        },
+        {
+          "name": "mixinDelegatesAria",
+          "package": "@/__internal/aria/delegate.js"
+        },
+        {
+          "name": "mixinElementInternals",
+          "package": "@/__internal/mixins/element-internals.js"
         }
       ],
       "superclass": {
@@ -2295,7 +2350,7 @@
           "type": {
             "text": "string"
           },
-          "default": "\"\"",
+          "default": "''",
           "fieldName": "name"
         },
         {
@@ -2430,34 +2485,119 @@
           "type": {
             "text": "string"
           },
-          "default": "''",
+          "default": "''",
+          "fieldName": "value"
+        },
+        {
+          "name": "format",
+          "type": {
+            "text": "boolean | undefined"
+          },
+          "default": "true",
+          "fieldName": "format"
+        },
+        {
+          "name": "hideCopy",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false",
+          "fieldName": "hideCopy"
+        }
+      ],
+      "superclass": {
+        "name": "LitElement",
+        "package": "lit"
+      },
+      "tagName": "wc-code-highlighter",
+      "customElement": true,
+      "rawTag": {
+        "name": "code-highlighter",
+        "description": ""
+      }
+    }
+  },
+  {
+    "label": "Color Picker",
+    "tag": "wc-color-picker",
+    "rawTag": "color-picker",
+    "summary": "A color picker component for selecting colors via a hue/saturation/value interface.",
+    "overview": "<p>The color picker presents a 2D saturation–brightness panel with a hue slider below it.\nAn optional alpha slider allows controlling opacity. The current hex value is displayed in\nan editable text field.</p>",
+    "cssprop": "--color-picker-sv-height - Height of the saturation/brightness panel. Defaults to 160px.",
+    "fires": "change - Dispatched when a color change is committed (pointer up, key, or input blur).",
+    "example": "```html\n<wc-color-picker value=\"#ff573380\" alpha></wc-color-picker>\n```",
+    "customElement": {
+      "kind": "class",
+      "description": "",
+      "cssProperties": [
+        {
+          "description": "Overall width of the component. Defaults to 240px.",
+          "name": "--color-picker-width"
+        },
+        {
+          "description": "Height of the saturation/brightness panel. Defaults to 160px.",
+          "name": "--color-picker-sv-height"
+        }
+      ],
+      "events": [
+        {
+          "name": "type",
+          "type": {
+            "text": "CustomEvent"
+          }
+        },
+        {
+          "type": {
+            "text": "CustomEvent<{value: string, alpha: number}>"
+          },
+          "description": "Dispatched continuously while the color is being changed.",
+          "name": "input"
+        },
+        {
+          "type": {
+            "text": "CustomEvent<{value: string, alpha: number}>"
+          },
+          "description": "Dispatched when a color change is committed (pointer up, key, or input blur).",
+          "name": "change"
+        }
+      ],
+      "attributes": [
+        {
+          "name": "value",
+          "type": {
+            "text": "string"
+          },
+          "default": "'#2352d5'",
+          "description": "The current color as a 6-digit hex string (e.g. `\"#ff5733\"`).",
           "fieldName": "value"
         },
         {
-          "name": "format",
+          "name": "alpha",
           "type": {
-            "text": "boolean | undefined"
+            "text": "boolean"
           },
-          "default": "true",
-          "fieldName": "format"
+          "default": "false",
+          "description": "Whether to show the alpha (opacity) slider and input.",
+          "fieldName": "alpha"
         },
         {
-          "name": "hideCopy",
+          "name": "disabled",
           "type": {
             "text": "boolean"
           },
           "default": "false",
-          "fieldName": "hideCopy"
+          "description": "Whether the color picker is disabled.",
+          "fieldName": "disabled"
         }
       ],
       "superclass": {
         "name": "LitElement",
         "package": "lit"
       },
-      "tagName": "wc-code-highlighter",
+      "tagName": "wc-color-picker",
       "customElement": true,
       "rawTag": {
-        "name": "code-highlighter",
+        "name": "color-picker",
         "description": ""
       }
     }
@@ -2512,6 +2652,7 @@
             "text": "ContainerSize"
           },
           "default": "'full'",
+          "description": "Max-width breakpoint of the container.\nPossible values are `\"max\"`, `\"xl\"`, `\"lg\"`, `\"md\"`, `\"sm\"`, `\"full\"`. Defaults to `\"full\"`.",
           "fieldName": "size",
           "expandedType": {
             "text": "'max' | 'xl' | 'lg' | 'md' | 'sm' | 'full'"
@@ -2744,6 +2885,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, renders the divider vertically. Defaults to horizontal.",
           "fieldName": "vertical"
         }
       ],
@@ -2942,7 +3084,7 @@
     "tag": "wc-fab",
     "rawTag": "fab",
     "summary": "The FAB (Floating Action Button) represents the primary action on a screen.",
-    "overview": "<p>A Floating Action Button (FAB) is a circular button that represents the primary action on a screen. It follows the Material Design 3 specification and supports four color roles and two variants.</p>",
+    "overview": "<p>A Floating Action Button (FAB) is a circular button that represents the primary action on a screen. It follows the specification and supports four color roles and two variants.</p>",
     "cssprop": "--fab-container-elevation-level: Elevation level of the FAB. Defaults to 3.",
     "fires": "click - Dispatched when the FAB is clicked.",
     "example": "```html\n<wc-fab><wc-icon name=\"add\"></wc-icon></wc-fab>\n```",
@@ -2989,23 +3131,31 @@
         {
           "name": "color",
           "type": {
-            "text": "| 'surface'\n    | 'primary'\n    | 'secondary'\n    | 'tertiary'"
+            "text": "string"
           },
           "default": "'surface'",
-          "description": "The color role of the FAB.\n`\"surface\"` uses the surface color role.\n`\"primary\"` uses the primary color role.\n`\"secondary\"` uses the secondary color role.\n`\"tertiary\"` uses the tertiary color role.",
           "fieldName": "color",
+          "description": "The color role of the FAB.\n`\"surface\"` uses the surface color role.\n`\"primary\"` uses the primary color role.\n`\"secondary\"` uses the secondary color role.\n`\"tertiary\"` uses the tertiary color role.",
           "expandedType": {
             "text": "'surface' | 'primary' | 'secondary' | 'tertiary'"
+          },
+          "inheritedFrom": {
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
           "name": "variant",
           "type": {
-            "text": "'tonal' | 'filled'"
+            "text": "string"
           },
           "default": "'tonal'",
+          "fieldName": "variant",
           "description": "The style variant of the FAB.\n`\"tonal\"` uses container colors.\n`\"filled\"` uses solid role colors.",
-          "fieldName": "variant"
+          "inheritedFrom": {
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
+          }
         },
         {
           "name": "size",
@@ -3025,23 +3175,6 @@
           "description": "If `true`, the FAB is in a lowered (resting) state with reduced elevation.",
           "fieldName": "lowered"
         },
-        {
-          "name": "configAria",
-          "type": {
-            "text": "{ [key: string]: any } | undefined"
-          },
-          "description": "Additional ARIA attributes to pass to the inner button/anchor element.",
-          "fieldName": "configAria"
-        },
-        {
-          "name": "throttleDelay",
-          "type": {
-            "text": "number"
-          },
-          "default": "200",
-          "description": "Sets the delay for throttle in milliseconds. Defaults to 200 milliseconds.",
-          "fieldName": "throttleDelay"
-        },
         {
           "name": "tooltip",
           "type": {
@@ -3074,39 +3207,17 @@
           "default": "false",
           "fieldName": "selected"
         },
-        {
-          "name": "pressed",
-          "type": {
-            "text": "boolean"
-          },
-          "default": "false",
-          "description": "States",
-          "fieldName": "pressed"
-        },
-        {
-          "name": "htmlType",
-          "type": {
-            "text": "'button' | 'submit' | 'reset'"
-          },
-          "default": "'button'",
-          "description": "The type of the underlying `<button>` element. Maps to the native `type` attribute.\nPossible values are `\"button\"`, `\"submit\"`, `\"reset\"`. Defaults to `\"button\"`.",
-          "fieldName": "htmlType",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
         {
           "name": "disabled",
+          "fieldName": "disabled",
           "type": {
             "text": "boolean"
           },
           "default": "false",
           "description": "When `true`, the button is disabled and cannot be interacted with. Reflects to the `disabled` attribute. Defaults to `false`.",
-          "fieldName": "disabled",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinFormAssociated",
+            "module": "src/__internal/mixins/form-associated.ts"
           }
         },
         {
@@ -3118,8 +3229,8 @@
           "description": "When `true`, the button is visually styled as disabled and cannot be interacted with, but remains focusable.\nUse this in combination with `disabledReason` to communicate why the button is unavailable.\nReflects to the `soft-disabled` attribute. Defaults to `false`.",
           "fieldName": "softDisabled",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
@@ -3131,107 +3242,126 @@
           "description": "A human-readable explanation of why the button is disabled or soft-disabled.\nRendered as a visually hidden tooltip and linked via `aria-describedby` for accessibility.\nMaps to the `disabled-reason` attribute.",
           "fieldName": "disabledReason",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
-          "name": "form",
+          "name": "throttleDelay",
           "type": {
-            "text": "string"
+            "text": "number | undefined"
           },
-          "default": "''",
-          "description": "The `id` of the `<form>` element to associate the button with.\nIf omitted, the button is associated with its nearest ancestor form.\nMaps to the native `form` attribute.",
-          "fieldName": "form",
+          "description": "Sets the delay for throttle in milliseconds. When undefined (default), no throttle is applied.",
+          "fieldName": "throttleDelay",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
-          "name": "name",
+          "name": "href",
           "type": {
-            "text": "string"
+            "text": "string | undefined"
           },
-          "default": "''",
-          "description": "The name of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `name` attribute.",
-          "fieldName": "name",
+          "fieldName": "href",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "value",
+          "name": "target",
           "type": {
-            "text": "string"
+            "text": "'_self' | '_parent' | '_blank' | '_top' | string"
           },
-          "default": "''",
-          "description": "The value of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `value` attribute.",
-          "fieldName": "value",
+          "default": "'_self'",
+          "fieldName": "target",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "href",
+          "name": "rel",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "The URL that the hyperlink points to. When set, the component renders as an `<a>` element.\nMaps to the native `href` attribute.",
-          "fieldName": "href",
+          "default": "''",
+          "fieldName": "rel",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "target",
+          "name": "download",
           "type": {
-            "text": "'_self' | '_parent' | '_blank' | '_top' | string"
+            "text": "string"
           },
-          "default": "'_self'",
-          "description": "Where to display the linked URL. Maps to the native `target` attribute.\nPossible values are `\"_self\"`, `\"_blank\"`, `\"_parent\"`, `\"_top\"`, or a custom frame name.\nWhen using `\"_blank\"`, consider setting `rel=\"noopener noreferrer\"` for security. Defaults to `\"_self\"`.",
-          "fieldName": "target",
+          "default": "''",
+          "fieldName": "download",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "rel",
+          "name": "type",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "The relationship between the current document and the linked URL.\nMaps to the native `rel` attribute on the rendered `<a>` element.\nWhen `target=\"_blank\"`, use `\"noopener noreferrer\"` to prevent tab-napping attacks.",
-          "fieldName": "rel",
+          "default": "'submit'",
+          "fieldName": "type",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinFormSubmitter",
+            "module": "src/__internal/mixins/form-submitter.ts"
           }
         },
         {
-          "name": "download",
+          "name": "value",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "Causes the browser to download the linked URL instead of navigating to it.\nIf a string value is provided, it is used as the suggested filename.\nOmit or leave undefined to preserve normal navigation behaviour.\nMaps to the native `download` attribute. Only applies when `href` is set.",
-          "fieldName": "download",
+          "default": "''",
+          "fieldName": "value",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinFormSubmitter",
+            "module": "src/__internal/mixins/form-submitter.ts"
+          }
+        },
+        {
+          "name": "name",
+          "fieldName": "name",
+          "inheritedFrom": {
+            "name": "mixinFormAssociated",
+            "module": "src/__internal/mixins/form-associated.ts"
           }
         }
       ],
       "mixins": [
         {
-          "name": "NativeButtonMixin",
-          "package": "@/__mixins/NativeButtonMixin.js"
+          "name": "mixinBaseButton",
+          "module": "/src/button/base-button/base-button.js"
         },
         {
-          "name": "NativeHyperlinkMixin",
-          "package": "@/__mixins/NativeHyperlinkMixin.js"
+          "name": "mixinHyperlink",
+          "package": "@/__internal/mixins/hyperlink.js"
+        },
+        {
+          "name": "mixinDelegatesAria",
+          "package": "@/__internal/aria/delegate.js"
+        },
+        {
+          "name": "mixinFormSubmitter",
+          "package": "@/__internal/mixins/form-submitter.js"
+        },
+        {
+          "name": "mixinFormAssociated",
+          "package": "@/__internal/mixins/form-associated.js"
+        },
+        {
+          "name": "mixinElementInternals",
+          "package": "@/__internal/mixins/element-internals.js"
         }
       ],
       "superclass": {
@@ -3264,6 +3394,7 @@
             "text": "string"
           },
           "default": "''",
+          "description": "Label text shown above the field input.",
           "fieldName": "label"
         },
         {
@@ -3272,6 +3403,7 @@
             "text": "string"
           },
           "default": "''",
+          "description": "Help text (deprecated — prefer `helperText`).",
           "fieldName": "help"
         },
         {
@@ -3280,6 +3412,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, marks the field as required and shows a required indicator.",
           "fieldName": "required"
         },
         {
@@ -3288,6 +3421,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the field and its slotted input are disabled.",
           "fieldName": "disabled"
         },
         {
@@ -3296,6 +3430,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the field and its slotted input are read-only.",
           "fieldName": "readonly"
         },
         {
@@ -3304,6 +3439,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, renders the field in a loading skeleton state.",
           "fieldName": "skeleton"
         },
         {
@@ -3312,6 +3448,7 @@
             "text": "string"
           },
           "default": "''",
+          "description": "Helper/hint text shown in the field footer.",
           "fieldName": "helperText"
         },
         {
@@ -3320,6 +3457,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the field is in an error state and `errorText` is shown.",
           "fieldName": "error"
         },
         {
@@ -3328,6 +3466,7 @@
             "text": "string"
           },
           "default": "''",
+          "description": "Error message displayed when `error` is true.",
           "fieldName": "errorText"
         },
         {
@@ -3336,6 +3475,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the field is in a warning state and `warningText` is shown.",
           "fieldName": "warning"
         },
         {
@@ -3344,6 +3484,7 @@
             "text": "string"
           },
           "default": "''",
+          "description": "Warning message displayed when `warning` is true.",
           "fieldName": "warningText"
         },
         {
@@ -3352,6 +3493,7 @@
             "text": "string"
           },
           "default": "''",
+          "description": "Character / word count string displayed at the trailing end of the footer.",
           "fieldName": "textCount"
         },
         {
@@ -3360,6 +3502,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, applies focused styling (controlled externally by the slotted input).",
           "fieldName": "focused"
         },
         {
@@ -3368,6 +3511,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, applies populated styling (controlled externally by the slotted input).",
           "fieldName": "populated"
         },
         {
@@ -3376,6 +3520,7 @@
             "text": "'filled' | 'outlined' | 'default'"
           },
           "default": "'default'",
+          "description": "Visual variant of the field container.",
           "fieldName": "variant"
         },
         {
@@ -3383,6 +3528,7 @@
           "type": {
             "text": "HTMLElement | undefined"
           },
+          "description": "Reference to the host input element; used to forward click-on-label focus.",
           "fieldName": "host"
         }
       ],
@@ -3586,7 +3732,7 @@
             "text": "boolean"
           },
           "default": "false",
-          "description": "Makes the focus ring visible.",
+          "description": "When true, the focus ring is visible. Toggled automatically based on `:focus-visible` state.",
           "fieldName": "visible"
         },
         {
@@ -3595,7 +3741,7 @@
             "text": "boolean"
           },
           "default": "false",
-          "description": "Makes the focus ring animate inwards instead of outwards.",
+          "description": "When true, the ring animates inward instead of outward (for use inside containers).",
           "fieldName": "inward"
         }
       ],
@@ -3616,7 +3762,7 @@
     "tag": "wc-html-editor",
     "rawTag": "html-editor",
     "summary": "A Tiptap-powered HTML editor with visual and source editing modes.",
-    "overview": "<p>The HTML Editor provides a rich-text editing experience built on Tiptap.\nIt wraps the editable area in a Material 3 styled <code>wc-field</code>,\nexposes common formatting actions, and includes a segmented switch between\n<strong>Visual</strong> and <strong>HTML</strong> source modes.</p>\n\n<p>Get and set the HTML content via the <code>value</code> property. The component\ndispatches a <code>change</code> event whenever the content is modified.\nMention suggestions are supported through the <code>mentions</code> property,\nwith optional externally managed lookup via the <code>search</code> event.</p>",
+    "overview": "<p>The HTML Editor provides a rich-text editing experience built on Tiptap.\nIt wraps the editable area in A styled <code>wc-field</code>,\nexposes common formatting actions, and includes a segmented switch between\n<strong>Visual</strong> and <strong>HTML</strong> source modes.</p>\n\n<p>Get and set the HTML content via the <code>value</code> property. The component\ndispatches a <code>change</code> event whenever the content is modified.\nMention suggestions are supported through the <code>mentions</code> property,\nwith optional externally managed lookup via the <code>search</code> event.</p>",
     "cssprop": "--html-editor-toolbar-border-color - Border color between toolbar and editing area.",
     "fires": "search - Fired in managed mention mode with { query, callback } detail.",
     "example": "```html\n<wc-html-editor\n  label=\"Description\"\n  value=\"<p>Hello <strong>world</strong></p>\"\n  .mentions=\"[{ label: 'Alex', value: 'alex' }]\"\n></wc-html-editor>\n```",
@@ -3877,6 +4023,7 @@
           "type": {
             "text": "string | undefined"
           },
+          "description": "URL of an external SVG file to fetch and render inline.",
           "fieldName": "src"
         },
         {
@@ -3885,6 +4032,7 @@
             "text": "IconProvider"
           },
           "default": "'material-symbols'",
+          "description": "Icon library provider. Defaults to `\"material-symbols\"`.",
           "fieldName": "provider",
           "expandedType": {
             "text": "'material-symbols' | 'material-icons'"
@@ -3995,51 +4143,69 @@
         {
           "name": "size",
           "type": {
-            "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
+            "text": "ButtonSize"
           },
           "default": "'sm'",
           "description": "Button size.\nPossible values are `\"xs\"`, `\"sm\"`, `\"md\"`, `\"lg\"`, `\"xl\"`. Defaults to `\"sm\"`.",
-          "fieldName": "size"
+          "fieldName": "size",
+          "expandedType": {
+            "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
+          }
         },
         {
-          "name": "type",
+          "name": "level",
           "type": {
-            "text": "'primary' | 'secondary' | 'tertiary' | undefined"
+            "text": "ButtonLevel | undefined"
           },
           "description": "Type is preset of color and variant. Type will be only applied.",
-          "fieldName": "type"
+          "fieldName": "level",
+          "expandedType": {
+            "text": "'primary' | 'secondary' | 'tertiary' | 'danger' | undefined"
+          }
+        },
+        {
+          "name": "shape",
+          "type": {
+            "text": "ButtonShape | undefined"
+          },
+          "default": "'square'",
+          "description": "Shape of the button container.",
+          "fieldName": "shape",
+          "expandedType": {
+            "text": "'round' | 'square' | undefined"
+          }
         },
         {
           "name": "variant",
           "type": {
-            "text": "| 'elevated'\n    | 'filled'\n    | 'tonal'\n    | 'outlined'\n    | 'text'\n    | 'neo'"
+            "text": "string"
           },
           "default": "'filled'",
-          "description": "The visual style of the button.\n\n Possible variant values:\n`\"filled\"` is a filled button.\n`\"outlined\"` is an outlined button.\n`\"text\"` is a transparent button.\n`\"tonal\"` is a light color button.\n`\"elevated\"` is elevated button",
           "fieldName": "variant",
+          "description": "The visual style of the button.\n\n Possible variant values:\n`\"filled\"` is a filled button.\n`\"outlined\"` is an outlined button.\n`\"text\"` is a transparent button.\n`\"tonal\"` is a light color button.\n`\"elevated\"` is elevated button",
           "expandedType": {
             "text": "'elevated' | 'filled' | 'tonal' | 'outlined' | 'text' | 'neo'"
+          },
+          "inheritedFrom": {
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
           "name": "color",
           "type": {
-            "text": "| 'primary'\n    | 'success'\n    | 'danger'\n    | 'warning'\n    | 'surface'\n    | 'on-surface'"
+            "text": "string"
           },
           "default": "'primary'",
-          "description": "Defines the primary color of the button. This can be set to predefined color names to apply specific color themes.",
           "fieldName": "color",
+          "description": "Defines the primary color of the button. This can be set to predefined color names to apply specific color themes.",
           "expandedType": {
             "text": "'primary' | 'success' | 'danger' | 'warning' | 'surface' | 'on-surface'"
-          }
-        },
-        {
-          "name": "configAria",
-          "type": {
-            "text": "{ [key: string]: any } | undefined"
           },
-          "description": "Additional ARIA attributes to pass to the inner button/anchor element.",
-          "fieldName": "configAria"
+          "inheritedFrom": {
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
+          }
         },
         {
           "name": "skeleton",
@@ -4047,6 +4213,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, renders the button in a loading skeleton state.",
           "fieldName": "skeleton"
         },
         {
@@ -4055,6 +4222,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the button acts as a toggle. Use with `selected`.",
           "fieldName": "toggle"
         },
         {
@@ -4063,56 +4231,28 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true (and `toggle` is set), the button is in the selected/pressed state.",
           "fieldName": "selected"
         },
-        {
-          "name": "throttleDelay",
-          "type": {
-            "text": "number"
-          },
-          "default": "200",
-          "description": "Sets the delay for throttle in milliseconds. Defaults to 200 milliseconds.",
-          "fieldName": "throttleDelay"
-        },
         {
           "name": "tooltip",
           "type": {
             "text": "string | undefined"
           },
+          "description": "Optional tooltip text displayed on hover.",
           "fieldName": "tooltip"
         },
-        {
-          "name": "pressed",
-          "type": {
-            "text": "boolean"
-          },
-          "default": "false",
-          "fieldName": "pressed"
-        },
-        {
-          "name": "htmlType",
-          "type": {
-            "text": "'button' | 'submit' | 'reset'"
-          },
-          "default": "'button'",
-          "description": "The type of the underlying `<button>` element. Maps to the native `type` attribute.\nPossible values are `\"button\"`, `\"submit\"`, `\"reset\"`. Defaults to `\"button\"`.",
-          "fieldName": "htmlType",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
         {
           "name": "disabled",
+          "fieldName": "disabled",
           "type": {
             "text": "boolean"
           },
           "default": "false",
           "description": "When `true`, the button is disabled and cannot be interacted with. Reflects to the `disabled` attribute. Defaults to `false`.",
-          "fieldName": "disabled",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinFormAssociated",
+            "module": "src/__internal/mixins/form-associated.ts"
           }
         },
         {
@@ -4124,8 +4264,8 @@
           "description": "When `true`, the button is visually styled as disabled and cannot be interacted with, but remains focusable.\nUse this in combination with `disabledReason` to communicate why the button is unavailable.\nReflects to the `soft-disabled` attribute. Defaults to `false`.",
           "fieldName": "softDisabled",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
@@ -4137,107 +4277,126 @@
           "description": "A human-readable explanation of why the button is disabled or soft-disabled.\nRendered as a visually hidden tooltip and linked via `aria-describedby` for accessibility.\nMaps to the `disabled-reason` attribute.",
           "fieldName": "disabledReason",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
-          "name": "form",
+          "name": "throttleDelay",
           "type": {
-            "text": "string"
+            "text": "number | undefined"
           },
-          "default": "''",
-          "description": "The `id` of the `<form>` element to associate the button with.\nIf omitted, the button is associated with its nearest ancestor form.\nMaps to the native `form` attribute.",
-          "fieldName": "form",
+          "description": "Sets the delay for throttle in milliseconds. When undefined (default), no throttle is applied.",
+          "fieldName": "throttleDelay",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
-          "name": "name",
+          "name": "href",
           "type": {
-            "text": "string"
+            "text": "string | undefined"
           },
-          "default": "''",
-          "description": "The name of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `name` attribute.",
-          "fieldName": "name",
+          "fieldName": "href",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "value",
+          "name": "target",
           "type": {
-            "text": "string"
+            "text": "'_self' | '_parent' | '_blank' | '_top' | string"
           },
-          "default": "''",
-          "description": "The value of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `value` attribute.",
-          "fieldName": "value",
+          "default": "'_self'",
+          "fieldName": "target",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "href",
+          "name": "rel",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "The URL that the hyperlink points to. When set, the component renders as an `<a>` element.\nMaps to the native `href` attribute.",
-          "fieldName": "href",
+          "default": "''",
+          "fieldName": "rel",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "target",
+          "name": "download",
           "type": {
-            "text": "'_self' | '_parent' | '_blank' | '_top' | string"
+            "text": "string"
           },
-          "default": "'_self'",
-          "description": "Where to display the linked URL. Maps to the native `target` attribute.\nPossible values are `\"_self\"`, `\"_blank\"`, `\"_parent\"`, `\"_top\"`, or a custom frame name.\nWhen using `\"_blank\"`, consider setting `rel=\"noopener noreferrer\"` for security. Defaults to `\"_self\"`.",
-          "fieldName": "target",
+          "default": "''",
+          "fieldName": "download",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
-          "name": "rel",
+          "name": "type",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "The relationship between the current document and the linked URL.\nMaps to the native `rel` attribute on the rendered `<a>` element.\nWhen `target=\"_blank\"`, use `\"noopener noreferrer\"` to prevent tab-napping attacks.",
-          "fieldName": "rel",
+          "default": "'submit'",
+          "fieldName": "type",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinFormSubmitter",
+            "module": "src/__internal/mixins/form-submitter.ts"
           }
         },
         {
-          "name": "download",
+          "name": "value",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "Causes the browser to download the linked URL instead of navigating to it.\nIf a string value is provided, it is used as the suggested filename.\nOmit or leave undefined to preserve normal navigation behaviour.\nMaps to the native `download` attribute. Only applies when `href` is set.",
-          "fieldName": "download",
+          "default": "''",
+          "fieldName": "value",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinFormSubmitter",
+            "module": "src/__internal/mixins/form-submitter.ts"
+          }
+        },
+        {
+          "name": "name",
+          "fieldName": "name",
+          "inheritedFrom": {
+            "name": "mixinFormAssociated",
+            "module": "src/__internal/mixins/form-associated.ts"
           }
         }
       ],
       "mixins": [
         {
-          "name": "NativeButtonMixin",
-          "package": "@/__mixins/NativeButtonMixin.js"
+          "name": "mixinBaseButton",
+          "module": "/src/button/base-button/base-button.js"
         },
         {
-          "name": "NativeHyperlinkMixin",
-          "package": "@/__mixins/NativeHyperlinkMixin.js"
+          "name": "mixinHyperlink",
+          "package": "@/__internal/mixins/hyperlink.js"
+        },
+        {
+          "name": "mixinDelegatesAria",
+          "package": "@/__internal/aria/delegate.js"
+        },
+        {
+          "name": "mixinFormSubmitter",
+          "package": "@/__internal/mixins/form-submitter.js"
+        },
+        {
+          "name": "mixinFormAssociated",
+          "package": "@/__internal/mixins/form-associated.js"
+        },
+        {
+          "name": "mixinElementInternals",
+          "package": "@/__internal/mixins/element-internals.js"
         }
       ],
       "superclass": {
@@ -4508,173 +4667,31 @@
     "label": "Item",
     "tag": "wc-item",
     "rawTag": "item",
-    "summary": "A Material 3 item with start, text and end slots.",
-    "example": "```html\n<wc-item selected>\n  <wc-icon slot=\"start\" name=\"home\"></wc-icon>\n  <div slot=\"overline\">Overline</div>\n  <div slot=\"headline\">Headline</div>\n  <div slot=\"supporting-text\">Supporting text</div>\n  <div slot=\"trailing-supporting-text\">Trailing</div>\n  <wc-icon slot=\"end\" name=\"chevron_right\"></wc-icon>\n</wc-item>\n```",
+    "summary": "A primitive element used to build higher-level item components such as menu-item, navigation-item, and list-item. Provides start, text, and end slots for flexible content composition.",
+    "example": "```html\n<wc-item>\n  <wc-icon slot=\"start\" name=\"notifications\"></wc-icon>\n\n  <span slot=\"headline\">Notifications</span>\n  <span slot=\"supporting-text\">Manage alerts and reminders</span>\n\n  <span slot=\"trailing-supporting-text\">3</span>\n  <wc-icon slot=\"end\" name=\"chevron_right\"></wc-icon>\n</wc-item>\n```",
     "tags": "display",
     "customElement": {
       "kind": "class",
       "description": "",
       "attributes": [
         {
-          "name": "tabindex"
-        },
-        {
-          "name": "selected",
-          "type": {
-            "text": "boolean"
-          },
-          "default": "false",
-          "fieldName": "selected"
-        },
-        {
-          "name": "htmlType",
-          "type": {
-            "text": "'button' | 'submit' | 'reset'"
-          },
-          "default": "'button'",
-          "description": "The type of the underlying `<button>` element. Maps to the native `type` attribute.\nPossible values are `\"button\"`, `\"submit\"`, `\"reset\"`. Defaults to `\"button\"`.",
-          "fieldName": "htmlType",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "disabled",
-          "type": {
-            "text": "boolean"
-          },
-          "default": "false",
-          "description": "When `true`, the button is disabled and cannot be interacted with. Reflects to the `disabled` attribute. Defaults to `false`.",
-          "fieldName": "disabled",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "soft-disabled",
+          "name": "multiline",
           "type": {
             "text": "boolean"
           },
           "default": "false",
-          "description": "When `true`, the button is visually styled as disabled and cannot be interacted with, but remains focusable.\nUse this in combination with `disabledReason` to communicate why the button is unavailable.\nReflects to the `soft-disabled` attribute. Defaults to `false`.",
-          "fieldName": "softDisabled",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "disabled-reason",
-          "type": {
-            "text": "string"
-          },
-          "default": "''",
-          "description": "A human-readable explanation of why the button is disabled or soft-disabled.\nRendered as a visually hidden tooltip and linked via `aria-describedby` for accessibility.\nMaps to the `disabled-reason` attribute.",
-          "fieldName": "disabledReason",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "form",
-          "type": {
-            "text": "string"
-          },
-          "default": "''",
-          "description": "The `id` of the `<form>` element to associate the button with.\nIf omitted, the button is associated with its nearest ancestor form.\nMaps to the native `form` attribute.",
-          "fieldName": "form",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "name",
-          "type": {
-            "text": "string"
-          },
-          "default": "''",
-          "description": "The name of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `name` attribute.",
-          "fieldName": "name",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "value",
-          "type": {
-            "text": "string"
-          },
-          "default": "''",
-          "description": "The value of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `value` attribute.",
-          "fieldName": "value",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "href",
-          "type": {
-            "text": "string | undefined"
-          },
-          "description": "The URL that the hyperlink points to. When set, the component renders as an `<a>` element.\nMaps to the native `href` attribute.",
-          "fieldName": "href",
-          "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
-          }
-        },
-        {
-          "name": "target",
-          "type": {
-            "text": "'_self' | '_parent' | '_blank' | '_top' | string"
-          },
-          "default": "'_self'",
-          "description": "Where to display the linked URL. Maps to the native `target` attribute.\nPossible values are `\"_self\"`, `\"_blank\"`, `\"_parent\"`, `\"_top\"`, or a custom frame name.\nWhen using `\"_blank\"`, consider setting `rel=\"noopener noreferrer\"` for security. Defaults to `\"_self\"`.",
-          "fieldName": "target",
-          "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
-          }
-        },
-        {
-          "name": "rel",
-          "type": {
-            "text": "string | undefined"
-          },
-          "description": "The relationship between the current document and the linked URL.\nMaps to the native `rel` attribute on the rendered `<a>` element.\nWhen `target=\"_blank\"`, use `\"noopener noreferrer\"` to prevent tab-napping attacks.",
-          "fieldName": "rel",
-          "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
-          }
-        },
-        {
-          "name": "download",
-          "type": {
-            "text": "string | undefined"
-          },
-          "description": "Causes the browser to download the linked URL instead of navigating to it.\nIf a string value is provided, it is used as the suggested filename.\nOmit or leave undefined to preserve normal navigation behaviour.\nMaps to the native `download` attribute. Only applies when `href` is set.",
-          "fieldName": "download",
-          "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
-          }
+          "description": "Only needed for SSR.\n\nAdd this attribute when an item has two lines to avoid a Flash Of Unstyled\nContent. This attribute is not needed for single line items or items with\nthree or more lines.",
+          "fieldName": "multiline"
         }
       ],
       "mixins": [
         {
-          "name": "NativeButtonMixin",
-          "package": "@/__mixins/NativeButtonMixin.js"
+          "name": "mixinDelegatesAria",
+          "package": "@/__internal/aria/delegate.js"
         },
         {
-          "name": "NativeHyperlinkMixin",
-          "package": "@/__mixins/NativeHyperlinkMixin.js"
+          "name": "mixinElementInternals",
+          "package": "@/__internal/mixins/element-internals.js"
         }
       ],
       "superclass": {
@@ -4792,7 +4809,7 @@
       "mixins": [
         {
           "name": "NativeHyperlinkMixin",
-          "package": "@/__mixins/NativeHyperlinkMixin.js"
+          "package": "@/__internal/mixins/NativeHyperlinkMixin.js"
         }
       ],
       "superclass": {
@@ -4815,7 +4832,7 @@
           "fieldName": "href",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         },
         {
@@ -4828,7 +4845,7 @@
           "fieldName": "target",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         },
         {
@@ -4840,7 +4857,7 @@
           "fieldName": "rel",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         },
         {
@@ -4852,7 +4869,7 @@
           "fieldName": "download",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         }
       ]
@@ -4862,8 +4879,8 @@
     "label": "List",
     "tag": "wc-list",
     "rawTag": "list",
-    "summary": "A Material 3 list container for one or more list items.",
-    "example": "```html\n<wc-list>\n  <wc-list-item>\n    <wc-icon slot=\"leading\" name=\"inbox\"></wc-icon>\n    Inbox\n    <span slot=\"trailing\">24</span>\n  </wc-list-item>\n</wc-list>\n```",
+    "summary": "A list container for one or more list items.",
+    "example": "```html\n<wc-list>\n  <wc-list-item>\n    <wc-icon slot=\"leading\" name=\"inbox\"></wc-icon>\n    Inbox\n    <span slot=\"trailing\">24</span>\n  </wc-list-item>\n   <wc-list-item>\n      <wc-avatar slot=\"leading\" name=\"Shivaji Varma\"></wc-avatar>\n       Shivaji Varma\n      <span slot=\"supporting-text\">Software Engineer</span>\n      <span slot=\"trailing-supporting-text\">7</span>\n      <wc-icon slot=\"trailing\" name=\"chevron_right\"></wc-icon>\n    </wc-list-item>\n</wc-list>\n```",
     "tags": "display",
     "customElement": {
       "kind": "class",
@@ -4872,7 +4889,7 @@
         {
           "name": "variant",
           "type": {
-            "text": "'standard' | 'vibrant'"
+            "text": "'standard' | 'segmented'"
           },
           "default": "'standard'",
           "fieldName": "variant"
@@ -4894,7 +4911,7 @@
     "label": "List Item",
     "tag": "wc-list-item",
     "rawTag": "list-item",
-    "summary": "A Material 3 list item with leading, trailing and content slots.",
+    "summary": "A list item with leading, trailing and content slots.",
     "example": "```html\n<wc-list-item selected>\n  <wc-icon slot=\"leading\" name=\"person\"></wc-icon>\n  Profile\n  <wc-icon slot=\"trailing\" name=\"chevron_right\"></wc-icon>\n</wc-list-item>\n```",
     "tags": "display",
     "customElement": {
@@ -4910,16 +4927,44 @@
           "fieldName": "selected"
         },
         {
-          "name": "htmlType",
+          "name": "skeleton",
           "type": {
-            "text": "'button' | 'submit' | 'reset'"
+            "text": "boolean"
           },
-          "default": "'button'",
-          "description": "The type of the underlying `<button>` element. Maps to the native `type` attribute.\nPossible values are `\"button\"`, `\"submit\"`, `\"reset\"`. Defaults to `\"button\"`.",
-          "fieldName": "htmlType",
+          "default": "false",
+          "description": "When true, renders the list-item in a loading skeleton state.",
+          "fieldName": "skeleton"
+        },
+        {
+          "name": "actionable",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false",
+          "fieldName": "actionable"
+        },
+        {
+          "name": "variant",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "fieldName": "variant",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
+          }
+        },
+        {
+          "name": "color",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "fieldName": "color",
+          "inheritedFrom": {
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
@@ -4931,8 +4976,8 @@
           "description": "When `true`, the button is disabled and cannot be interacted with. Reflects to the `disabled` attribute. Defaults to `false`.",
           "fieldName": "disabled",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
@@ -4944,8 +4989,8 @@
           "description": "When `true`, the button is visually styled as disabled and cannot be interacted with, but remains focusable.\nUse this in combination with `disabledReason` to communicate why the button is unavailable.\nReflects to the `soft-disabled` attribute. Defaults to `false`.",
           "fieldName": "softDisabled",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
@@ -4957,47 +5002,20 @@
           "description": "A human-readable explanation of why the button is disabled or soft-disabled.\nRendered as a visually hidden tooltip and linked via `aria-describedby` for accessibility.\nMaps to the `disabled-reason` attribute.",
           "fieldName": "disabledReason",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "form",
-          "type": {
-            "text": "string"
-          },
-          "default": "''",
-          "description": "The `id` of the `<form>` element to associate the button with.\nIf omitted, the button is associated with its nearest ancestor form.\nMaps to the native `form` attribute.",
-          "fieldName": "form",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
-          }
-        },
-        {
-          "name": "name",
-          "type": {
-            "text": "string"
-          },
-          "default": "''",
-          "description": "The name of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `name` attribute.",
-          "fieldName": "name",
-          "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
-          "name": "value",
+          "name": "throttleDelay",
           "type": {
-            "text": "string"
+            "text": "number | undefined"
           },
-          "default": "''",
-          "description": "The value of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `value` attribute.",
-          "fieldName": "value",
+          "description": "Sets the delay for throttle in milliseconds. When undefined (default), no throttle is applied.",
+          "fieldName": "throttleDelay",
           "inheritedFrom": {
-            "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "name": "mixinBaseButton",
+            "module": "src/button/base-button/base-button.ts"
           }
         },
         {
@@ -5005,11 +5023,10 @@
           "type": {
             "text": "string | undefined"
           },
-          "description": "The URL that the hyperlink points to. When set, the component renders as an `<a>` element.\nMaps to the native `href` attribute.",
           "fieldName": "href",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
@@ -5018,46 +5035,53 @@
             "text": "'_self' | '_parent' | '_blank' | '_top' | string"
           },
           "default": "'_self'",
-          "description": "Where to display the linked URL. Maps to the native `target` attribute.\nPossible values are `\"_self\"`, `\"_blank\"`, `\"_parent\"`, `\"_top\"`, or a custom frame name.\nWhen using `\"_blank\"`, consider setting `rel=\"noopener noreferrer\"` for security. Defaults to `\"_self\"`.",
           "fieldName": "target",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
           "name": "rel",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "The relationship between the current document and the linked URL.\nMaps to the native `rel` attribute on the rendered `<a>` element.\nWhen `target=\"_blank\"`, use `\"noopener noreferrer\"` to prevent tab-napping attacks.",
+          "default": "''",
           "fieldName": "rel",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         },
         {
           "name": "download",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "Causes the browser to download the linked URL instead of navigating to it.\nIf a string value is provided, it is used as the suggested filename.\nOmit or leave undefined to preserve normal navigation behaviour.\nMaps to the native `download` attribute. Only applies when `href` is set.",
+          "default": "''",
           "fieldName": "download",
           "inheritedFrom": {
-            "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "name": "mixinHyperlink",
+            "module": "src/__internal/mixins/hyperlink.ts"
           }
         }
       ],
       "mixins": [
         {
-          "name": "NativeButtonMixin",
-          "package": "@/__mixins/NativeButtonMixin.js"
+          "name": "mixinBaseButton",
+          "package": "@/button/base-button/base-button.js"
         },
         {
-          "name": "NativeHyperlinkMixin",
-          "package": "@/__mixins/NativeHyperlinkMixin.js"
+          "name": "mixinHyperlink",
+          "package": "@/__internal/mixins/hyperlink.js"
+        },
+        {
+          "name": "mixinDelegatesAria",
+          "package": "@/__internal/aria/delegate.js"
+        },
+        {
+          "name": "mixinElementInternals",
+          "package": "@/__internal/mixins/element-internals.js"
         }
       ],
       "superclass": {
@@ -5115,6 +5139,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "Whether the menu is currently visible.",
           "fieldName": "open"
         },
         {
@@ -5123,6 +5148,7 @@
             "text": "'standard' | 'vibrant'"
           },
           "default": "'standard'",
+          "description": "Visual variant of the menu. `\"vibrant\"` applies stronger color emphasis.",
           "fieldName": "variant"
         },
         {
@@ -5131,6 +5157,7 @@
             "text": "string"
           },
           "default": "''",
+          "description": "ID of the anchor element the menu is positioned relative to.",
           "fieldName": "anchor"
         },
         {
@@ -5139,6 +5166,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, renders the menu in a static preview state (always visible, no animation).",
           "fieldName": "preview"
         },
         {
@@ -5147,6 +5175,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the menu will not close when a click occurs outside it.",
           "fieldName": "stayOpenOnOutsideClick"
         },
         {
@@ -5155,6 +5184,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the menu will not close when focus leaves it.",
           "fieldName": "stayOpenOnFocusout"
         },
         {
@@ -5163,6 +5193,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "Set to true when this menu is being used as a submenu inside another menu.",
           "fieldName": "isSubmenu"
         },
         {
@@ -5171,6 +5202,7 @@
             "text": "Placement"
           },
           "default": "'bottom-start'",
+          "description": "Floating UI placement of the menu relative to its anchor.",
           "fieldName": "placement"
         },
         {
@@ -5179,6 +5211,7 @@
             "text": "number"
           },
           "default": "6",
+          "description": "Distance in pixels between the menu and its anchor element.",
           "fieldName": "offset"
         }
       ],
@@ -5211,11 +5244,11 @@
             "text": "string"
           },
           "default": "''",
-          "description": "The value of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `value` attribute.",
+          "description": "The value associated with this menu item, used to identify it on selection.",
           "fieldName": "value",
           "inheritedFrom": {
             "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "module": "src/__internal/mixins/NativeButtonMixin.ts"
           }
         },
         {
@@ -5224,6 +5257,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "Whether this menu item is currently selected/highlighted.",
           "fieldName": "selected"
         },
         {
@@ -5232,6 +5266,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the menu stays open after this item is activated.",
           "fieldName": "keepOpen"
         },
         {
@@ -5240,6 +5275,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, indicates this item has an associated submenu.",
           "fieldName": "hasSubmenu"
         },
         {
@@ -5248,6 +5284,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "Whether the associated submenu is currently open.",
           "fieldName": "submenuOpen"
         },
         {
@@ -5256,6 +5293,7 @@
             "text": "'standard' | 'vibrant'"
           },
           "default": "'standard'",
+          "description": "Visual variant of the menu item.",
           "fieldName": "variant"
         },
         {
@@ -5268,7 +5306,7 @@
           "fieldName": "htmlType",
           "inheritedFrom": {
             "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "module": "src/__internal/mixins/NativeButtonMixin.ts"
           }
         },
         {
@@ -5281,7 +5319,7 @@
           "fieldName": "disabled",
           "inheritedFrom": {
             "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "module": "src/__internal/mixins/NativeButtonMixin.ts"
           }
         },
         {
@@ -5294,7 +5332,7 @@
           "fieldName": "softDisabled",
           "inheritedFrom": {
             "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "module": "src/__internal/mixins/NativeButtonMixin.ts"
           }
         },
         {
@@ -5307,7 +5345,7 @@
           "fieldName": "disabledReason",
           "inheritedFrom": {
             "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "module": "src/__internal/mixins/NativeButtonMixin.ts"
           }
         },
         {
@@ -5320,7 +5358,7 @@
           "fieldName": "form",
           "inheritedFrom": {
             "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "module": "src/__internal/mixins/NativeButtonMixin.ts"
           }
         },
         {
@@ -5333,7 +5371,7 @@
           "fieldName": "name",
           "inheritedFrom": {
             "name": "NativeButtonMixin",
-            "module": "src/__mixins/NativeButtonMixin.ts"
+            "module": "src/__internal/mixins/NativeButtonMixin.ts"
           }
         },
         {
@@ -5345,7 +5383,7 @@
           "fieldName": "href",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         },
         {
@@ -5358,7 +5396,7 @@
           "fieldName": "target",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         },
         {
@@ -5370,7 +5408,7 @@
           "fieldName": "rel",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         },
         {
@@ -5382,18 +5420,18 @@
           "fieldName": "download",
           "inheritedFrom": {
             "name": "NativeHyperlinkMixin",
-            "module": "src/__mixins/NativeHyperlinkMixin.ts"
+            "module": "src/__internal/mixins/NativeHyperlinkMixin.ts"
           }
         }
       ],
       "mixins": [
         {
           "name": "NativeButtonMixin",
-          "package": "@/__mixins/NativeButtonMixin.js"
+          "package": "@/__internal/mixins/NativeButtonMixin.js"
         },
         {
           "name": "NativeHyperlinkMixin",
-          "package": "@/__mixins/NativeHyperlinkMixin.js"
+          "package": "@/__internal/mixins/NativeHyperlinkMixin.js"
         }
       ],
       "superclass": {
@@ -5412,7 +5450,7 @@
     "label": "Modal",
     "tag": "wc-modal",
     "rawTag": "modal",
-    "summary": "A Material Design 3 dialog/modal for displaying content in a layer above the page, with optional header, body, and footer slots.",
+    "summary": "A dialog/modal for displaying content in a layer above the page, with optional header, body, and footer slots.",
     "cssprop": "--modal-max-height - Maximum height of the dialog.",
     "example": "```html\nMODAL\n```",
     "tags": "overlay, dialog, feedback",
@@ -5537,7 +5575,7 @@
     "label": "Navigation Rail",
     "tag": "wc-navigation-rail",
     "rawTag": "navigation-rail",
-    "summary": "A vertical side navigation for medium-sized screens, following Material Design 3 specs.",
+    "summary": "A vertical side navigation for medium-sized screens,.",
     "overview": "<p>Navigation rail provides access to primary destinations in an app using icons—with or without labels—on a vertical rail.</p>\n<p>Use navigation rail on medium-sized screens (tablets) with 3–7 destinations.</p>",
     "slot": "footer - Content pinned to the bottom of the rail.",
     "cssprop": "--nav-rail-active-label-color - Color of active labels. Defaults to on-surface.",
@@ -5706,10 +5744,10 @@
         {
           "name": "throttleDelay",
           "type": {
-            "text": "number"
+            "text": "number | null"
           },
-          "default": "200",
-          "description": "Sets the delay for throttle in milliseconds. Defaults to 200 milliseconds.",
+          "default": "null",
+          "description": "Sets the delay for throttle in milliseconds. When null (default), no throttle is applied.",
           "fieldName": "throttleDelay"
         }
       ],
@@ -6394,7 +6432,7 @@
     "label": "Search",
     "tag": "wc-search",
     "rawTag": "search",
-    "summary": "A Material 3 search bar for filtering and finding content.",
+    "summary": "A search bar for filtering and finding content.",
     "overview": "<p>The search component provides a text input designed for search interactions.\nIt supports outlined and filled variants, an optional clear button, and leading/trailing icon slots.</p>",
     "cssprop": "--search-outline-width - Border width for the outlined variant.",
     "fires": "search - Dispatched when the user submits the search (presses Enter).",
@@ -6632,8 +6670,8 @@
     "label": "Segmented Button Group",
     "tag": "wc-segmented-button-group",
     "rawTag": "segmented-button-group",
-    "summary": "A container for segmented buttons following Material Design 3.",
-    "overview": "<p>Segmented buttons help people select options, switch views, or sort elements. They follow the Material Design 3 specification.</p>\n<p>Use <code>multi-select</code> to allow more than one segment to be selected at a time. By default only one segment can be active (single-select).</p>",
+    "summary": "A container for segmented buttons.",
+    "overview": "<p>Segmented buttons help people select options, switch views, or sort elements. They follow the specification.</p>\n<p>Use <code>multi-select</code> to allow more than one segment to be selected at a time. By default only one segment can be active (single-select).</p>",
     "cssprop": "--segmented-button-group-shape: Border-radius of the group container.",
     "fires": "change - Dispatched when the selection changes. Detail contains <code>{ value, values }</code>.",
     "example": "```html\n<wc-segmented-button-group>\n  <wc-segmented-button value=\"day\">Day</wc-segmented-button>\n  <wc-segmented-button value=\"week\" selected>Week</wc-segmented-button>\n  <wc-segmented-button value=\"month\">Month</wc-segmented-button>\n</wc-segmented-button-group>\n```",
@@ -7169,7 +7207,7 @@
     "label": "Side Sheet",
     "tag": "wc-side-sheet",
     "rawTag": "side-sheet",
-    "summary": "Side sheets slide in from the edge of the screen to reveal supplemental content. Supports standard and modal variants per Material Design 3.",
+    "summary": "Side sheets slide in from the edge of the screen to reveal supplemental content. Supports standard and modal variants.",
     "cssprop": "--side-sheet-width - Width of the side sheet.",
     "example": "```html\nSide Sheet\n\n```",
     "tags": "navigation, overlay",
@@ -7260,6 +7298,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the skeleton animation is shown.",
           "fieldName": "visible"
         }
       ],
@@ -7444,6 +7483,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "Whether the snackbar is currently visible.",
           "fieldName": "open"
         },
         {
@@ -7452,6 +7492,7 @@
             "text": "string"
           },
           "default": "''",
+          "description": "The message text to display. Can also be provided via the default slot.",
           "fieldName": "message"
         },
         {
@@ -7460,6 +7501,7 @@
             "text": "string"
           },
           "default": "''",
+          "description": "Label for the optional action button. When empty, no action button is rendered.",
           "fieldName": "actionLabel"
         },
         {
@@ -7468,6 +7510,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, a dismiss icon button is shown on the trailing end.",
           "fieldName": "showCloseIcon"
         },
         {
@@ -7476,6 +7519,7 @@
             "text": "number"
           },
           "default": "4000",
+          "description": "Auto-hide duration in milliseconds. Set to `0` to disable auto-hide.",
           "fieldName": "duration"
         },
         {
@@ -7484,6 +7528,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, the snackbar content is allowed to wrap to multiple lines.",
           "fieldName": "multiline"
         },
         {
@@ -7492,6 +7537,7 @@
             "text": "boolean"
           },
           "default": "false",
+          "description": "When true, renders the snackbar in a static preview state (always visible, no animation).",
           "fieldName": "preview"
         }
       ],
@@ -8017,10 +8063,9 @@
         {
           "name": "throttleDelay",
           "type": {
-            "text": "number"
+            "text": "number | undefined"
           },
-          "default": "200",
-          "description": "Sets the delay for throttle in milliseconds. Defaults to 200 milliseconds.",
+          "description": "Sets the delay for throttle in milliseconds. When null (default), no throttle is applied.",
           "fieldName": "throttleDelay"
         }
       ],
@@ -8780,8 +8825,8 @@
     "label": "Toolbar",
     "tag": "wc-toolbar",
     "rawTag": "toolbar",
-    "summary": "A Material 3 toolbar / app bar for navigation and actions.",
-    "overview": "<p>The toolbar component implements the Material 3 app bar pattern. It supports a\ndocked (attached) variant for bottom-panel navigation and a floating (detached pill-shaped)\nvariant. The floating variant supports both horizontal and vertical orientations.</p>\n\n<p>Render toolbar actions directly as children of the component. The docked variant is\noptimized for a horizontal action row, while the floating variant supports both horizontal\nand vertical layouts.</p>",
+    "summary": "A toolbar / app bar for navigation and actions.",
+    "overview": "<p>The toolbar component implements the app bar pattern. It supports a\ndocked (attached) variant for bottom-panel navigation and a floating (detached pill-shaped)\nvariant. The floating variant supports both horizontal and vertical orientations.</p>\n\n<p>Render toolbar actions directly as children of the component. The docked variant is\noptimized for a horizontal action row, while the floating variant supports both horizontal\nand vertical layouts.</p>",
     "cssprop": "--toolbar-shadow - Box-shadow of the toolbar.",
     "example": "```html\n<!-- Floating vertical toolbar -->\n<wc-toolbar variant=\"floating\" orientation=\"vertical\">\n  <wc-icon-button variant=\"tonal\"><wc-icon name=\"home\"></wc-icon></wc-icon-button>\n  <wc-icon-button variant=\"text\"><wc-icon name=\"search\"></wc-icon></wc-icon-button>\n  <wc-icon-button variant=\"text\"><wc-icon name=\"favorite\"></wc-icon></wc-icon-button>\n</wc-toolbar>\n```",
     "tags": "display navigation",