@warp-ds/elements 2.9.1 → 2.10.0-next.1

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@warp-ds/elements",
-  "version": "2.9.1-next.6",
+  "version": "2.9.2-next.1",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -397,76 +397,185 @@
         },
         {
           "name": "w-button",
-          "description": "Buttons are used to perform actions, widh different visuals for different needs.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/buttons-button--docs)\n---\n",
+          "description": "Performs an action or renders a link with button styling.\nUse button variants to match action priority, risk, and context.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/buttons-button--docs)\n---\n",
           "doc-url": "",
           "attributes": [
             {
               "name": "type",
+              "description": "Native button type.\nControls whether the internal button behaves as a regular button, submits a form, or resets a form. Defaults to `button`.",
               "value": { "type": "'button' | 'submit' | 'reset'" }
             },
             {
               "name": "autofocus",
+              "description": "Focuses the button when it is first rendered.\nApplies only when the component renders a native button. Link buttons with `href` do not autofocus through this component.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "variant",
+              "description": "Visual style of the button.\nDefaults to `secondary`. Use the variant that matches the action priority, risk, and placement.",
               "value": {
                 "type": "'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'quiet' | 'utilityQuiet' | 'overlay' | 'overlayInverted' | 'overlayQuiet' | 'overlayInvertedQuiet' | 'pill' | 'link'"
               }
             },
             {
               "name": "quiet",
+              "description": "Deprecated quiet visual treatment flag\nUse `variant=\"quiet\"` instead.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "icon-only",
+              "description": "Marks the button as icon-only.\nUse this when the button has no visible text. Include accessible text in the slotted content so the internal button has a name.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "small",
+              "description": "Renders the compact button size.\nUse this in dense layouts where the default button size is too large.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "loading",
+              "description": "Shows the loading state.\nUse after the user has triggered an action and the action is in progress.",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "href", "value": { "type": "string" } },
-            { "name": "target", "value": { "type": "string" } },
+            {
+              "name": "href",
+              "description": "URL for rendering the button as a link.\nWhen set, the component renders `w-link` instead of a native `button`.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "target",
+              "description": "Link browsing context.\nPassed to the rendered link when `href` is set.",
+              "value": { "type": "string" }
+            },
             {
               "name": "disabled",
+              "description": "Visually disables the button.\nDisabled buttons are discouraged because they can hide the reason an action is unavailable.",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "rel", "value": { "type": "string" } },
+            {
+              "name": "rel",
+              "description": "Link relationship.\nPassed to the rendered link when `href` is set. If `target=\"_blank\"` is set and `rel` is omitted, `noopener` is used.",
+              "value": { "type": "string" }
+            },
             {
               "name": "full-width",
+              "description": "Makes the button fill its parent width.\nUseful in narrow layouts where the button should span the available inline space.",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "button-class", "value": { "type": "string" } },
-            { "name": "name", "value": { "type": "string" } },
-            { "name": "value", "value": { "type": "string" } }
+            {
+              "name": "button-class",
+              "description": "Deprecated class applied to the internal control\nThis class is applied inside the shadow DOM and is unlikely to have the desired effect. Use attributes or CSS variables to customize the button appearance.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "name",
+              "description": "Form control name.\nUsed when the button participates in form handling.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "value",
+              "description": "Form control value.\nUsed with `name` when the button participates in form handling. Resets to its initial value when the form is reset.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "commandfor",
+              "description": "The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "command",
+              "description": "The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+              "value": { "type": "string" }
+            }
           ],
           "events": [],
           "js": {
             "properties": [
-              { "name": "type", "type": "'button' | 'submit' | 'reset'" },
-              { "name": "autofocus", "type": "boolean" },
+              {
+                "name": "type",
+                "description": "Native button type.\nControls whether the internal button behaves as a regular button, submits a form, or resets a form. Defaults to `button`.",
+                "type": "'button' | 'submit' | 'reset'"
+              },
+              {
+                "name": "autofocus",
+                "description": "Focuses the button when it is first rendered.\nApplies only when the component renders a native button. Link buttons with `href` do not autofocus through this component.",
+                "type": "boolean"
+              },
               {
                 "name": "variant",
+                "description": "Visual style of the button.\nDefaults to `secondary`. Use the variant that matches the action priority, risk, and placement.",
                 "type": "'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'quiet' | 'utilityQuiet' | 'overlay' | 'overlayInverted' | 'overlayQuiet' | 'overlayInvertedQuiet' | 'pill' | 'link'"
               },
-              { "name": "quiet", "type": "boolean" },
-              { "name": "iconOnly", "type": "boolean" },
-              { "name": "small", "type": "boolean" },
-              { "name": "loading", "type": "boolean" },
-              { "name": "href", "type": "string" },
-              { "name": "target", "type": "string" },
-              { "name": "disabled", "type": "boolean" },
-              { "name": "rel", "type": "string" },
-              { "name": "fullWidth", "type": "boolean" },
-              { "name": "buttonClass", "type": "string" },
-              { "name": "name", "type": "string" },
-              { "name": "value", "type": "string" },
-              { "name": "ariaValueTextLoading" }
+              {
+                "name": "quiet",
+                "description": "Deprecated quiet visual treatment flag\nUse `variant=\"quiet\"` instead.",
+                "type": "boolean"
+              },
+              {
+                "name": "iconOnly",
+                "description": "Marks the button as icon-only.\nUse this when the button has no visible text. Include accessible text in the slotted content so the internal button has a name.",
+                "type": "boolean"
+              },
+              {
+                "name": "small",
+                "description": "Renders the compact button size.\nUse this in dense layouts where the default button size is too large.",
+                "type": "boolean"
+              },
+              {
+                "name": "loading",
+                "description": "Shows the loading state.\nUse after the user has triggered an action and the action is in progress.",
+                "type": "boolean"
+              },
+              {
+                "name": "href",
+                "description": "URL for rendering the button as a link.\nWhen set, the component renders `w-link` instead of a native `button`.",
+                "type": "string"
+              },
+              {
+                "name": "target",
+                "description": "Link browsing context.\nPassed to the rendered link when `href` is set.",
+                "type": "string"
+              },
+              {
+                "name": "disabled",
+                "description": "Visually disables the button.\nDisabled buttons are discouraged because they can hide the reason an action is unavailable.",
+                "type": "boolean"
+              },
+              {
+                "name": "rel",
+                "description": "Link relationship.\nPassed to the rendered link when `href` is set. If `target=\"_blank\"` is set and `rel` is omitted, `noopener` is used.",
+                "type": "string"
+              },
+              {
+                "name": "fullWidth",
+                "description": "Makes the button fill its parent width.\nUseful in narrow layouts where the button should span the available inline space.",
+                "type": "boolean"
+              },
+              {
+                "name": "buttonClass",
+                "description": "Deprecated class applied to the internal control\nThis class is applied inside the shadow DOM and is unlikely to have the desired effect. Use attributes or CSS variables to customize the button appearance.",
+                "type": "string"
+              },
+              {
+                "name": "name",
+                "description": "Form control name.\nUsed when the button participates in form handling.",
+                "type": "string"
+              },
+              {
+                "name": "value",
+                "description": "Form control value.\nUsed with `name` when the button participates in form handling. Resets to its initial value when the form is reset.",
+                "type": "string"
+              },
+              {
+                "name": "commandfor",
+                "description": "The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+                "type": "string"
+              },
+              {
+                "name": "command",
+                "description": "The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.",
+                "type": "string"
+              }
             ],
             "events": []
           }
@@ -1242,16 +1351,18 @@
         },
         {
           "name": "w-modal",
-          "description": "Modals (or dialogs) display important information that users need to acknowledge.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/overlays-modal--docs)\n---\n\n\n### **Events:**\n - **shown**\n- **hidden**\n\n### **Slots:**\n - **header** - Typically where you would use the `w-modal-header` component.\n- **content** - The main content of the modal.\n- **footer** - Typically where you would use the `w-modal-footer` component, for things like actions.",
+          "description": "Modals (or dialogs) display important information that users need to acknowledge.\n---\n\n\n### **Events:**\n - **shown**\n- **hidden**\n\n### **Slots:**\n - **header** - Typically where you would use the `w-modal-header` component.\n- **content** - The main content of the modal.\n- **footer** - Typically where you would use the `w-modal-footer` component, for things like actions.",
           "doc-url": "",
           "attributes": [
             {
               "name": "show",
+              "description": "Controls if the modal should show or hide.\n\nYou can also call the `open()` and `close()` methods.",
               "value": { "type": "boolean", "default": "false" }
             },
             { "name": "content-id", "value": { "type": "string" } },
             {
               "name": "ignore-backdrop-clicks",
+              "description": "Ignores clicks to the backdrop when set",
               "value": { "type": "boolean", "default": "false" }
             }
           ],
@@ -1275,12 +1386,17 @@
           ],
           "js": {
             "properties": [
-              { "name": "show", "type": "boolean" },
+              {
+                "name": "show",
+                "description": "Controls if the modal should show or hide.\n\nYou can also call the `open()` and `close()` methods.",
+                "type": "boolean"
+              },
               { "name": "contentId", "type": "string" },
-              { "name": "ignoreBackdropClicks", "type": "boolean" },
-              { "name": "dialogEl", "type": "HTMLDialogElement" },
-              { "name": "dialogInnerEl", "type": "HTMLElement" },
-              { "name": "contentEl", "type": "HTMLElement" }
+              {
+                "name": "ignoreBackdropClicks",
+                "description": "Ignores clicks to the backdrop when set",
+                "type": "boolean"
+              }
             ],
             "events": [
               { "name": "shown", "type": "CustomEvent" },
@@ -1290,7 +1406,7 @@
         },
         {
           "name": "w-modal-footer",
-          "description": "The footer section of a modal, typically where you place actions.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/overlays-modal--docs)\n---\n",
+          "description": "The footer section of a modal, typically where you place actions.\n---\n",
           "doc-url": "",
           "attributes": [],
           "events": [],
@@ -1298,16 +1414,22 @@
         },
         {
           "name": "w-modal-header",
-          "description": "The header section of a modal, typically where you place the title and a close button.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/overlays-modal--docs)\n---\n\n\n### **Events:**\n - **backClicked**\n\n### **Slots:**\n - **top** - Customize the title bar, for example to have a header image that reaches the modal's edges. See the With Image story for an example.",
+          "description": "The header section of a modal, typically where you place the title and a close button.\n---\n\n\n### **Events:**\n - **backClicked**\n\n### **Slots:**\n - **top** - Customize the title bar, for example to have a header image that reaches the modal's edges. See the With Image story for an example.",
           "doc-url": "",
           "attributes": [
-            { "name": "title", "value": { "type": "string" } },
+            {
+              "name": "title",
+              "description": "A short but descriptive title for the modal",
+              "value": { "type": "string" }
+            },
             {
               "name": "back",
+              "description": "Whether the modal header should have a back button",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "no-close",
+              "description": "Lets you hide the close button in the header",
               "value": { "type": "boolean", "default": "false" }
             }
           ],
@@ -1320,31 +1442,39 @@
           "events": [{ "name": "backClicked", "type": "CustomEvent" }],
           "js": {
             "properties": [
-              { "name": "title", "type": "string" },
-              { "name": "back", "type": "boolean" },
-              { "name": "noClose", "type": "boolean" },
-              { "name": "titleEl", "type": "HTMLElement" },
-              { "name": "titleClasses" },
-              { "name": "backButton" },
-              { "name": "closeButton" }
+              {
+                "name": "title",
+                "description": "A short but descriptive title for the modal",
+                "type": "string"
+              },
+              {
+                "name": "back",
+                "description": "Whether the modal header should have a back button",
+                "type": "boolean"
+              },
+              {
+                "name": "noClose",
+                "description": "Lets you hide the close button in the header",
+                "type": "boolean"
+              }
             ],
             "events": [{ "name": "backClicked", "type": "CustomEvent" }]
           }
         },
         {
           "name": "w-page-indicator",
-          "description": "A page indicator component that displays a series of dots representing pages.\nOne dot is highlighted to indicate the currently selected page.\n---\n",
+          "description": "A page indicator component that displays a series of dots representing pages.\n\nOne dot is highlighted to indicate the currently selected page.\n---\n",
           "doc-url": "",
           "attributes": [
             {
               "name": "selected-page",
-              "description": "Currently selected page (1-based index, clamped to valid range)",
-              "value": { "type": "number" }
+              "description": "Currently selected page (1-based index)",
+              "value": { "type": "number", "default": "1" }
             },
             {
               "name": "page-count",
-              "description": "Total number of pages (minimum 1)",
-              "value": { "type": "number" }
+              "description": "Total number of pages",
+              "value": { "type": "number", "default": "1" }
             }
           ],
           "events": [],
@@ -1352,12 +1482,12 @@
             "properties": [
               {
                 "name": "selectedPage",
-                "description": "Currently selected page (1-based index, clamped to valid range)",
+                "description": "Currently selected page (1-based index)",
                 "type": "number"
               },
               {
                 "name": "pageCount",
-                "description": "Total number of pages (minimum 1)",
+                "description": "Total number of pages",
                 "type": "number"
               }
             ],
@@ -1366,79 +1496,151 @@
         },
         {
           "name": "w-pagination",
-          "description": "Pagination allows users to navigate through multiple pages of content by providing navigation controls with page numbers and directional arrows.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/navigation-pagination--docs)\n---\n\n\n### **Events:**\n - **page-click** - Triggered when a link button in the pagination is clicked. Contains the page number in `string` form.",
+          "description": "Pagination allows users to navigate through multiple pages of content by providing navigation controls with page numbers and directional arrows.\n---\n\n\n### **Events:**\n - **page-click** - Triggered when a link in the pagination is clicked. Contains the page number in `string` form.",
           "doc-url": "",
           "attributes": [
-            { "name": "base-url", "value": { "type": "string" } },
-            { "name": "pages", "value": { "type": "number" } },
-            { "name": "current-page", "value": { "type": "number" } },
-            { "name": "visible-pages", "value": { "type": "number" } }
+            {
+              "name": "base-url",
+              "description": "The base URL used to construct page links, for example `/search?page=`.\n\nThe page number is appended to this URL.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "pages",
+              "description": "The total number of pages.",
+              "value": { "type": "number" }
+            },
+            {
+              "name": "current-page",
+              "description": "The currently active page number.",
+              "value": { "type": "number", "default": "1" }
+            },
+            {
+              "name": "visible-pages",
+              "description": "The maximum number of page numbers visible.",
+              "value": { "type": "number", "default": "7" }
+            }
           ],
           "events": [
             {
               "name": "page-click",
               "type": "CustomEvent",
-              "description": "Triggered when a link button in the pagination is clicked. Contains the page number in `string` form."
+              "description": "Triggered when a link in the pagination is clicked. Contains the page number in `string` form."
             }
           ],
           "js": {
             "properties": [
-              { "name": "baseUrl", "type": "string" },
-              { "name": "pages", "type": "number" },
-              { "name": "currentPageNumber", "type": "number" },
-              { "name": "visiblePages", "type": "number" }
+              {
+                "name": "baseUrl",
+                "description": "The base URL used to construct page links, for example `/search?page=`.\n\nThe page number is appended to this URL.",
+                "type": "string"
+              },
+              {
+                "name": "pages",
+                "description": "The total number of pages.",
+                "type": "number"
+              },
+              {
+                "name": "currentPageNumber",
+                "description": "The currently active page number.",
+                "type": "number"
+              },
+              {
+                "name": "visiblePages",
+                "description": "The maximum number of page numbers visible.",
+                "type": "number"
+              }
             ],
             "events": [
               {
                 "name": "page-click",
                 "type": "CustomEvent",
-                "description": "Triggered when a link button in the pagination is clicked. Contains the page number in `string` form."
+                "description": "Triggered when a link in the pagination is clicked. Contains the page number in `string` form."
               }
             ]
           }
         },
         {
           "name": "w-pill",
-          "description": "Pill is a type of button that is often used as a filter, but can also be used as a rounded button for overlays, etc.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/buttons-pill--docs)\n---\n\n\n### **Events:**\n - **w-pill-click**\n- **w-pill-close**",
+          "description": "Pill is a type of button that is often used as a filter, but can also be used as a rounded button for overlays, etc.\n---\n\n\n### **Events:**\n - **w-pill-click** - Fires when the pill itself is clicked.\n- **w-pill-close** - Fires when the pill's close button is clicked.",
           "doc-url": "",
           "attributes": [
             {
               "name": "can-close",
+              "description": "Whether the pill should be removable via a close button.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "suggestion",
+              "description": "Whether the pill should be rendered as a suggestion.",
               "value": { "type": "boolean", "default": "false" }
             },
             { "name": "open-sr-label", "value": { "type": "string" } },
-            { "name": "open-aria-label", "value": { "type": "string" } },
+            {
+              "name": "open-aria-label",
+              "description": "Label read by screen readers when targeting the pill.",
+              "value": { "type": "string" }
+            },
             { "name": "close-sr-label", "value": { "type": "string" } },
-            { "name": "close-aria-label", "value": { "type": "string" } }
+            {
+              "name": "close-aria-label",
+              "description": "Label read by screen readers when targeting the close button.",
+              "value": { "type": "string" }
+            }
           ],
           "events": [
-            { "name": "w-pill-click", "type": "CustomEvent" },
-            { "name": "w-pill-close", "type": "CustomEvent" }
+            {
+              "name": "w-pill-click",
+              "type": "CustomEvent",
+              "description": "Fires when the pill itself is clicked."
+            },
+            {
+              "name": "w-pill-close",
+              "type": "CustomEvent",
+              "description": "Fires when the pill's close button is clicked."
+            }
           ],
           "js": {
             "properties": [
-              { "name": "canClose", "type": "boolean" },
-              { "name": "suggestion", "type": "boolean" },
+              {
+                "name": "canClose",
+                "description": "Whether the pill should be removable via a close button.",
+                "type": "boolean"
+              },
+              {
+                "name": "suggestion",
+                "description": "Whether the pill should be rendered as a suggestion.",
+                "type": "boolean"
+              },
               { "name": "openSrLabel", "type": "string" },
-              { "name": "openAriaLabel", "type": "string" },
+              {
+                "name": "openAriaLabel",
+                "description": "Label read by screen readers when targeting the pill.",
+                "type": "string"
+              },
               { "name": "closeSrLabel", "type": "string" },
-              { "name": "closeAriaLabel", "type": "string" },
-              { "name": "openFilterSrText" },
-              { "name": "removeFilterSrText" }
+              {
+                "name": "closeAriaLabel",
+                "description": "Label read by screen readers when targeting the close button.",
+                "type": "string"
+              }
             ],
             "events": [
-              { "name": "w-pill-click", "type": "CustomEvent" },
-              { "name": "w-pill-close", "type": "CustomEvent" }
+              {
+                "name": "w-pill-click",
+                "type": "CustomEvent",
+                "description": "Fires when the pill itself is clicked."
+              },
+              {
+                "name": "w-pill-close",
+                "type": "CustomEvent",
+                "description": "Fires when the pill's close button is clicked."
+              }
             ]
           }
         },
         {
           "name": "w-radio",
-          "description": "\n---\n\n\n### **Methods:**\n - **checkValidity(): _boolean_** - Checks whether the radio passes constraint validation\n- **reportValidity(): _boolean_** - Checks validity and shows the browser's validation message if invalid",
+          "description": "\n---\n",
           "doc-url": "",
           "attributes": [
             {
@@ -1504,26 +1706,6 @@
                 "name": "invalid",
                 "description": "Draws the radio in an invalid state.",
                 "type": "boolean"
-              },
-              {
-                "name": "tabIndex",
-                "description": "Override tabIndex setter to set _groupTabIndex (for backwards compatibility).\nRadio-group should use _groupTabIndex directly for clarity.",
-                "type": "number"
-              },
-              {
-                "name": "validationMessage",
-                "description": "Returns the validation message if the radio is invalid, otherwise an empty string",
-                "type": "string"
-              },
-              {
-                "name": "validity",
-                "description": "Returns the validity state of the radio",
-                "type": "ValidityState"
-              },
-              {
-                "name": "_standaloneTabIndex",
-                "description": "Internal tabindex for standalone radios (not in a group).\nNon-reflecting to avoid DOM changes during hydration.",
-                "type": "number | undefined"
               }
             ],
             "events": []
@@ -1531,32 +1713,42 @@
         },
         {
           "name": "w-radio-group",
-          "description": "\n---\n\n\n### **Slots:**\n - **label** - Alternative to the `label` attribute should you need custom HTML.\n- **help-text** - Alternative to the `help-text` attribute should you need custom HTML.",
+          "description": "Radios allow users to select a single option from a list of choices.\n\nUse with `w-radio`.\n---\n\n\n### **Slots:**\n - **label** - Alternative to the `label` attribute should you need custom HTML.\n- **help-text** - Alternative to the `help-text` attribute should you need custom HTML.",
           "doc-url": "",
           "attributes": [
-            { "name": "label", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "label",
+              "description": "Label for the radio group.",
+              "value": { "type": "string", "default": "''" }
+            },
             {
               "name": "help-text",
+              "description": "Help text for the radio group.\n\nIf you set `required` and `invalid` the group gets a default error message, but you can override it with this attribute.",
               "value": { "type": "string", "default": "''" }
             },
             {
               "name": "optional",
+              "description": "Whether to show optional text next to the label.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "invalid",
+              "description": "Marks the radio group as invalid.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "name",
+              "description": "The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.",
               "value": { "type": "string | null", "default": "null" }
             },
             {
               "name": "disabled",
+              "description": "Disables the radio group and all child radios.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "required",
+              "description": "Makes selecting a radio in the the group required.",
               "value": { "type": "boolean", "default": "false" }
             }
           ],
@@ -1573,22 +1765,48 @@
           "events": [],
           "js": {
             "properties": [
-              { "name": "hasInteracted", "type": "boolean" },
-              { "name": "label", "type": "string" },
-              { "name": "helpText", "type": "string" },
-              { "name": "optional", "type": "boolean" },
-              { "name": "invalid", "type": "boolean" },
-              { "name": "name", "type": "string | null" },
-              { "name": "disabled", "type": "boolean" },
-              { "name": "required", "type": "boolean" },
-              { "name": "validationTarget" }
+              {
+                "name": "label",
+                "description": "Label for the radio group.",
+                "type": "string"
+              },
+              {
+                "name": "helpText",
+                "description": "Help text for the radio group.\n\nIf you set `required` and `invalid` the group gets a default error message, but you can override it with this attribute.",
+                "type": "string"
+              },
+              {
+                "name": "optional",
+                "description": "Whether to show optional text next to the label.",
+                "type": "boolean"
+              },
+              {
+                "name": "invalid",
+                "description": "Marks the radio group as invalid.",
+                "type": "boolean"
+              },
+              {
+                "name": "name",
+                "description": "The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.",
+                "type": "string | null"
+              },
+              {
+                "name": "disabled",
+                "description": "Disables the radio group and all child radios.",
+                "type": "boolean"
+              },
+              {
+                "name": "required",
+                "description": "Makes selecting a radio in the the group required.",
+                "type": "boolean"
+              }
             ],
             "events": []
           }
         },
         {
           "name": "w-select",
-          "description": "A dropdown component for selecting a single value.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-select--docs)\n---\n\n\n### **Events:**\n - **change**",
+          "description": "A dropdown component for selecting a single value.\n---\n\n\n### **Events:**\n - **change**",
           "doc-url": "",
           "attributes": [
             {
@@ -1603,12 +1821,12 @@
             },
             {
               "name": "help-text",
-              "description": "The content displayed as the help text. Paired with `invalid` to show the text as a validation error.",
+              "description": "The content displayed as the help text.\n\nPaired with `invalid` to show the text as a validation error.",
               "value": { "type": "string" }
             },
             {
               "name": "invalid",
-              "description": "Renders the field in an invalid state. Paired with `help-text` to provide feedback about the error.",
+              "description": "Renders the field in an invalid state.\n\nPaired with `help-text` to provide feedback about the error.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
@@ -1623,12 +1841,12 @@
             },
             {
               "name": "label",
-              "description": "The content to disply as the label",
+              "description": "The content to display as the label.",
               "value": { "type": "string" }
             },
             {
               "name": "optional",
-              "description": "Whether to show optional text",
+              "description": "Whether to show the optional indicator after the label.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
@@ -1646,8 +1864,16 @@
               "description": "Renders the field in a readonly state.",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "name", "value": { "type": "string" } },
-            { "name": "value", "value": { "type": "string" } }
+            {
+              "name": "name",
+              "description": "The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "value",
+              "description": "Lets you set the current value.",
+              "value": { "type": "string" }
+            }
           ],
           "events": [{ "name": "change", "type": "CustomEvent" }],
           "js": {
@@ -1664,12 +1890,12 @@
               },
               {
                 "name": "helpText",
-                "description": "The content displayed as the help text. Paired with `invalid` to show the text as a validation error.",
+                "description": "The content displayed as the help text.\n\nPaired with `invalid` to show the text as a validation error.",
                 "type": "string"
               },
               {
                 "name": "invalid",
-                "description": "Renders the field in an invalid state. Paired with `help-text` to provide feedback about the error.",
+                "description": "Renders the field in an invalid state.\n\nPaired with `help-text` to provide feedback about the error.",
                 "type": "boolean"
               },
               {
@@ -1684,12 +1910,12 @@
               },
               {
                 "name": "label",
-                "description": "The content to disply as the label",
+                "description": "The content to display as the label.",
                 "type": "string"
               },
               {
                 "name": "optional",
-                "description": "Whether to show optional text",
+                "description": "Whether to show the optional indicator after the label.",
                 "type": "boolean"
               },
               {
@@ -1707,8 +1933,16 @@
                 "description": "Renders the field in a readonly state.",
                 "type": "boolean"
               },
-              { "name": "name", "type": "string" },
-              { "name": "value", "type": "string" }
+              {
+                "name": "name",
+                "description": "The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.",
+                "type": "string"
+              },
+              {
+                "name": "value",
+                "description": "Lets you set the current value.",
+                "type": "string"
+              }
             ],
             "events": [{ "name": "change", "type": "CustomEvent" }]
           }