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

package/dist/custom-elements.json

@@ -5064,17 +5064,8 @@
         {
           "kind": "class",
           "description": "",
-          "name": "WRadio",
+          "name": "WarpRadio",
           "members": [
-            {
-              "kind": "field",
-              "name": "shadowRootOptions",
-              "type": {
-                "text": "object"
-              },
-              "static": true,
-              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
-            },
             {
               "kind": "field",
               "name": "name",
@@ -5140,14 +5131,6 @@
               "attribute": "invalid",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "tabIndex",
-              "type": {
-                "text": "number"
-              },
-              "description": "Override tabIndex setter to set _groupTabIndex (for backwards compatibility).\nRadio-group should use _groupTabIndex directly for clarity."
-            },
             {
               "kind": "field",
               "name": "#defaultChecked",
@@ -5201,62 +5184,6 @@
               "name": "handleKeyDown",
               "privacy": "private"
             },
-            {
-              "kind": "method",
-              "name": "resetFormControl",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "type": {
-                "text": "resetFormControl() => void"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "validationMessage",
-              "type": {
-                "text": "string"
-              },
-              "description": "Returns the validation message if the radio is invalid, otherwise an empty string",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "validity",
-              "type": {
-                "text": "ValidityState"
-              },
-              "description": "Returns the validity state of the radio",
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "checkValidity",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "description": "Checks whether the radio passes constraint validation",
-              "type": {
-                "text": "checkValidity() => boolean"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "reportValidity",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "description": "Checks validity and shows the browser's validation message if invalid",
-              "type": {
-                "text": "reportValidity() => boolean"
-              }
-            },
             {
               "kind": "method",
               "name": "isInGroup",
@@ -5283,7 +5210,7 @@
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "WRadio[]"
+                  "text": "WarpRadio[]"
                 }
               }
             },
@@ -5307,14 +5234,6 @@
               "description": "Computed tabindex for the internal focusable element.\nPriority: group-managed > standalone-managed > default",
               "readonly": true
             },
-            {
-              "kind": "field",
-              "name": "_standaloneTabIndex",
-              "type": {
-                "text": "number | undefined"
-              },
-              "description": "Internal tabindex for standalone radios (not in a group).\nNon-reflecting to avoid DOM changes during hydration."
-            },
             {
               "kind": "method",
               "name": "uncheckOtherRadios",
@@ -5429,13 +5348,31 @@
             "name": "LitElement",
             "package": "lit"
           },
+          "parent": {
+            "name": "w-radio-group",
+            "description": ""
+          },
           "tagName": "w-radio",
           "customElement": true,
           "modulePath": "packages/radio/radio.ts",
           "definitionPath": "packages/radio/radio.ts"
+        },
+        {
+          "kind": "variable",
+          "name": "WRadio",
+          "default": "WarpRadio",
+          "deprecated": "Exported for backwards compatibility only, use `WarpRadio`"
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "WarpRadio",
+          "declaration": {
+            "name": "WarpRadio",
+            "module": "packages/radio/radio.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "WRadio",
@@ -5448,7 +5385,7 @@
           "kind": "custom-element-definition",
           "name": "w-radio",
           "declaration": {
-            "name": "WRadio",
+            "name": "WarpRadio",
             "module": "packages/radio/radio.ts"
           }
         }
@@ -5460,8 +5397,8 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
-          "name": "WRadioGroup",
+          "description": "Radios allow users to select a single option from a list of choices.\n\nUse with `w-radio`.",
+          "name": "WarpRadioGroup",
           "slots": [
             {
               "description": "Alternative to the `label` attribute should you need custom HTML.",
@@ -5473,14 +5410,6 @@
             }
           ],
           "members": [
-            {
-              "kind": "field",
-              "name": "hasInteracted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false"
-            },
             {
               "kind": "field",
               "name": "hasWarnedMissingName",
@@ -5506,6 +5435,7 @@
                 "text": "string"
               },
               "default": "''",
+              "description": "Label for the radio group.",
               "attribute": "label"
             },
             {
@@ -5515,6 +5445,7 @@
                 "text": "string"
               },
               "default": "''",
+              "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.",
               "attribute": "help-text"
             },
             {
@@ -5524,6 +5455,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether to show optional text next to the label.",
               "attribute": "optional",
               "reflects": true
             },
@@ -5534,6 +5466,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Marks the radio group as invalid.",
               "attribute": "invalid",
               "reflects": true
             },
@@ -5544,6 +5477,7 @@
                 "text": "string | null"
               },
               "default": "null",
+              "description": "The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.",
               "attribute": "name",
               "reflects": true
             },
@@ -5554,6 +5488,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Disables the radio group and all child radios.",
               "attribute": "disabled",
               "reflects": true
             },
@@ -5564,6 +5499,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Makes selecting a radio in the the group required.",
               "attribute": "required",
               "reflects": true
             },
@@ -5590,14 +5526,14 @@
               "name": "nameManagedRadios",
               "privacy": "private",
               "readonly": true,
-              "default": "new WeakSet<WRadio>()"
+              "default": "new WeakSet<WarpRadio>()"
             },
             {
               "kind": "field",
               "name": "disabledManagedRadios",
               "privacy": "private",
               "readonly": true,
-              "default": "new WeakSet<WRadio>()"
+              "default": "new WeakSet<WarpRadio>()"
             },
             {
               "kind": "field",
@@ -5607,27 +5543,6 @@
               },
               "privacy": "private"
             },
-            {
-              "kind": "field",
-              "name": "shadowRootOptions",
-              "type": {
-                "text": "object"
-              },
-              "static": true,
-              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true }"
-            },
-            {
-              "kind": "field",
-              "name": "validationTarget",
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "resetFormControl",
-              "type": {
-                "text": "resetFormControl() => void"
-              }
-            },
             {
               "kind": "field",
               "name": "handleRadioClick",
@@ -5654,7 +5569,7 @@
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "WRadio[]"
+                  "text": "WarpRadio[]"
                 }
               },
               "parameters": [
@@ -5677,7 +5592,7 @@
                 {
                   "name": "selected",
                   "type": {
-                    "text": "WRadio"
+                    "text": "WarpRadio"
                   }
                 },
                 {
@@ -5724,7 +5639,7 @@
                 {
                   "name": "radio",
                   "type": {
-                    "text": "WRadio"
+                    "text": "WarpRadio"
                   }
                 }
               ]
@@ -5737,7 +5652,7 @@
                 {
                   "name": "radios",
                   "type": {
-                    "text": "WRadio[]"
+                    "text": "WarpRadio[]"
                   }
                 }
               ]
@@ -5760,37 +5675,6 @@
                 }
               ]
             },
-            {
-              "kind": "method",
-              "name": "focus",
-              "privacy": "public",
-              "parameters": [
-                {
-                  "name": "options",
-                  "optional": true,
-                  "type": {
-                    "text": "FocusOptions"
-                  }
-                }
-              ],
-              "type": {
-                "text": "focus(options?: FocusOptions) => void"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "checkValidity",
-              "type": {
-                "text": "checkValidity() => void"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "reportValidity",
-              "type": {
-                "text": "reportValidity() => void"
-              }
-            },
             {
               "kind": "method",
               "name": "hasSlottedContent",
@@ -5827,7 +5711,7 @@
                 {
                   "name": "radios",
                   "type": {
-                    "text": "WRadio[]"
+                    "text": "WarpRadio[]"
                   }
                 }
               ]
@@ -5889,6 +5773,7 @@
                 "text": "string"
               },
               "default": "''",
+              "description": "Label for the radio group.",
               "fieldName": "label"
             },
             {
@@ -5897,6 +5782,7 @@
                 "text": "string"
               },
               "default": "''",
+              "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.",
               "fieldName": "helpText"
             },
             {
@@ -5905,6 +5791,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Whether to show optional text next to the label.",
               "fieldName": "optional"
             },
             {
@@ -5913,6 +5800,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Marks the radio group as invalid.",
               "fieldName": "invalid"
             },
             {
@@ -5921,6 +5809,7 @@
                 "text": "string | null"
               },
               "default": "null",
+              "description": "The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.",
               "fieldName": "name"
             },
             {
@@ -5929,6 +5818,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Disables the radio group and all child radios.",
               "fieldName": "disabled"
             },
             {
@@ -5937,6 +5827,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Makes selecting a radio in the the group required.",
               "fieldName": "required"
             }
           ],
@@ -5954,9 +5845,23 @@
           "customElement": true,
           "modulePath": "packages/radio-group/radio-group.ts",
           "definitionPath": "packages/radio-group/radio-group.ts"
+        },
+        {
+          "kind": "variable",
+          "name": "WRadioGroup",
+          "default": "WarpRadioGroup",
+          "deprecated": "Exported for backwards compatibility only, use `WarpRadioGroup`"
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "WarpRadioGroup",
+          "declaration": {
+            "name": "WarpRadioGroup",
+            "module": "packages/radio-group/radio-group.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "WRadioGroup",
@@ -5969,7 +5874,7 @@
           "kind": "custom-element-definition",
           "name": "w-radio-group",
           "declaration": {
-            "name": "WRadioGroup",
+            "name": "WarpRadioGroup",
             "module": "packages/radio-group/radio-group.ts"
           }
         }
@@ -5981,7 +5886,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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)",
+          "description": "A dropdown component for selecting a single value.",
           "name": "WarpSelect",
           "members": [
             {
@@ -6013,7 +5918,7 @@
               "type": {
                 "text": "string"
               },
-              "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.",
               "attribute": "help-text",
               "reflects": true
             },
@@ -6024,7 +5929,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "attribute": "invalid",
               "reflects": true
             },
@@ -6057,7 +5962,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "The content to disply as the label",
+              "description": "The content to display as the label.",
               "attribute": "label",
               "reflects": true
             },
@@ -6068,7 +5973,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether to show optional text",
+              "description": "Whether to show the optional indicator after the label.",
               "attribute": "optional",
               "reflects": true
             },
@@ -6112,6 +6017,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.",
               "attribute": "name",
               "reflects": true
             },
@@ -6121,6 +6027,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Lets you set the current value.",
               "attribute": "value",
               "reflects": true
             },
@@ -6146,18 +6053,6 @@
                 "text": "MutationObserver | undefined"
               }
             },
-            {
-              "kind": "method",
-              "name": "resetFormControl",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "type": {
-                "text": "resetFormControl() => void"
-              }
-            },
             {
               "kind": "method",
               "name": "#getOptionNodes",
@@ -6214,42 +6109,6 @@
                 }
               ]
             },
-            {
-              "kind": "method",
-              "name": "formStateRestoreCallback",
-              "parameters": [
-                {
-                  "name": "state",
-                  "type": {
-                    "text": "string | File | FormData | null"
-                  }
-                },
-                {
-                  "name": "_reason",
-                  "type": {
-                    "text": "'autocomplete' | 'restore'"
-                  }
-                }
-              ],
-              "type": {
-                "text": "formStateRestoreCallback(state: string | File | FormData | null, _reason: 'autocomplete' | 'restore') => void"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "handleKeyDown",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                }
-              ],
-              "type": {
-                "text": "handleKeyDown(event: KeyboardEvent) => void"
-              }
-            },
             {
               "kind": "field",
               "name": "#classes",
@@ -6279,21 +6138,6 @@
               "name": "#helpId",
               "privacy": "private",
               "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "onChange",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "type": {
-                "text": "onChange(event: Event) => void"
-              }
             }
           ],
           "events": [
@@ -6329,7 +6173,7 @@
               "type": {
                 "text": "string"
               },
-              "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.",
               "fieldName": "helpText"
             },
             {
@@ -6338,7 +6182,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "fieldName": "invalid"
             },
             {
@@ -6365,7 +6209,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "The content to disply as the label",
+              "description": "The content to display as the label.",
               "fieldName": "label"
             },
             {
@@ -6374,7 +6218,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether to show optional text",
+              "description": "Whether to show the optional indicator after the label.",
               "fieldName": "optional"
             },
             {
@@ -6410,6 +6254,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.",
               "fieldName": "name"
             },
             {
@@ -6417,6 +6262,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Lets you set the current value.",
               "fieldName": "value"
             }
           ],

package/dist/docs/radio/accessibility.md

@@ -0,0 +1 @@
+## Accessibility