@cordwainer/cw-elements 1.3.0-alpha.2 → 1.3.0-alpha.3

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@cordwainer/cw-elements",
-  "version": "1.3.0-alpha.2",
+  "version": "1.3.0-alpha.3",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -1069,76 +1069,44 @@
           "js": { "properties": [], "events": [] }
         },
         {
-          "name": "cw-color-picker",
-          "description": "Color pickers allow the user to select a color.\n---\n\n\n### **Events:**\n - **cw-blur** - Emitted when the color picker loses focus.\n- **cw-change** - Emitted when the color picker's value changes.\n- **cw-focus** - Emitted when the color picker receives focus.\n- **cw-input** - Emitted when the color picker receives input.\n- **cw-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the color picker.\n- **blur()** - Removes focus from the color picker.\n- **getFormattedValue(format: _'hex' | 'hexa' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'hsv' | 'hsva'_)** - Returns the current value as a string in the specified format.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The color picker's form label. Alternatively, you can use the `label` attribute.\n\n### **CSS Properties:**\n - **--grid-width** - The width of the color grid. _(default: undefined)_\n- **--grid-height** - The height of the color grid. _(default: undefined)_\n- **--grid-handle-size** - The size of the color grid's handle. _(default: undefined)_\n- **--slider-height** - The height of the hue and alpha sliders. _(default: undefined)_\n- **--slider-handle-size** - The diameter of the slider's handle. _(default: undefined)_\n- **--swatch-size** - The size of each predefined color swatch. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **trigger** - The color picker's dropdown trigger.\n- **swatches** - The container that holds the swatches.\n- **swatch** - Each individual swatch.\n- **grid** - The color grid.\n- **grid-handle** - The color grid's handle.\n- **slider** - Hue and opacity sliders.\n- **slider-handle** - Hue and opacity slider handles.\n- **hue-slider** - The hue slider.\n- **hue-slider-handle** - The hue slider's handle.\n- **opacity-slider** - The opacity slider.\n- **opacity-slider-handle** - The opacity slider's handle.\n- **preview** - The preview color.\n- **input** - The text input.\n- **eye-dropper-button** - The eye dropper button.\n- **eye-dropper-button__base** - The eye dropper button's exported `button` part.\n- **eye-dropper-button__prefix** - The eye dropper button's exported `prefix` part.\n- **eye-dropper-button__label** - The eye dropper button's exported `label` part.\n- **eye-dropper-button__suffix** - The eye dropper button's exported `suffix` part.\n- **eye-dropper-button__caret** - The eye dropper button's exported `caret` part.\n- **format-button** - The format button.\n- **format-button__base** - The format button's exported `button` part.\n- **format-button__prefix** - The format button's exported `prefix` part.\n- **format-button__label** - The format button's exported `label` part.\n- **format-button__suffix** - The format button's exported `suffix` part.\n- **format-button__caret** - The format button's exported `caret` part.",
+          "name": "cw-checkbox",
+          "description": "Checkboxes allow the user to toggle an option on or off.\n---\n\n\n### **Events:**\n - **cw-blur** - Emitted when the checkbox loses focus.\n- **cw-change** - Emitted when the checked state changes.\n- **cw-focus** - Emitted when the checkbox gains focus.\n- **cw-input** - Emitted when the checkbox receives input.\n- **cw-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the checkbox.\n- **focus(options: _FocusOptions_)** - Sets focus on the checkbox.\n- **blur()** - Removes focus from the checkbox.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. The value provided will be shown to the user when the form is submitted. To clear\nthe custom validation message, call this method with an empty string.\n\n### **Slots:**\n - _default_ - The checkbox's label.\n- **help-text** - Text that describes how to use the checkbox. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The square container that wraps the checkbox's checked state.\n- **control--checked** - Matches the control part when the checkbox is checked.\n- **control--indeterminate** - Matches the control part when the checkbox is indeterminate.\n- **checked-icon** - The checked icon, an `<cw-icon>` element.\n- **indeterminate-icon** - The indeterminate icon, an `<cw-icon>` element.\n- **label** - The container that wraps the checkbox's label.\n- **form-control-help-text** - The help text's wrapper.",
           "doc-url": "",
           "attributes": [
+            { "name": "title", "value": { "type": "string", "default": "''" } },
             {
-              "name": "value",
-              "description": "The current value of the color picker. The value's format will vary based the `format` attribute. To get the value\nin a specific format, use the `getFormattedValue()` method. The value is submitted as a name/value pair with form\ndata.",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "label",
-              "description": "The color picker's label. This will not be displayed, but it will be announced by assistive devices. If you need to\ndisplay HTML, you can use the `label` slot` instead.",
+              "name": "name",
+              "description": "The name of the checkbox, submitted as a name/value pair with form data.",
               "value": { "type": "string", "default": "''" }
             },
             {
-              "name": "format",
-              "description": "The format to use. If opacity is enabled, these will translate to HEXA, RGBA, HSLA, and HSVA respectively. The color\npicker will accept user input in any format (including CSS color names) and convert it to the desired format.",
-              "value": {
-                "type": "'hex' | 'rgb' | 'hsl' | 'hsv'",
-                "default": "'hex'"
-              }
-            },
-            {
-              "name": "inline",
-              "description": "Renders the color picker inline rather than in a dropdown.",
-              "value": { "type": "boolean", "default": "false" }
+              "name": "value",
+              "description": "The current value of the checkbox, submitted as a name/value pair with form data.",
+              "value": { "type": "string" }
             },
             {
               "name": "size",
-              "description": "Determines the size of the color picker's trigger. This has no effect on inline color pickers.",
+              "description": "The checkbox's size.",
               "value": {
                 "type": "'small' | 'medium' | 'large'",
                 "default": "'medium'"
               }
             },
-            {
-              "name": "no-format-toggle",
-              "description": "Removes the button that lets users toggle between format.",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "name",
-              "description": "The name of the form control, submitted as a name/value pair with form data.",
-              "value": { "type": "string", "default": "''" }
-            },
             {
               "name": "disabled",
-              "description": "Disables the color picker.",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "hoist",
-              "description": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
+              "description": "Disables the checkbox.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
-              "name": "opacity",
-              "description": "Shows the opacity slider. Enabling this will cause the formatted value to be HEXA, RGBA, or HSLA.",
+              "name": "checked",
+              "description": "Draws the checkbox in a checked state.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
-              "name": "uppercase",
-              "description": "By default, values are lowercase. With this attribute, values will be uppercase instead.",
+              "name": "indeterminate",
+              "description": "Draws the checkbox in an indeterminate state. This is usually applied to checkboxes that represents a \"select\nall/none\" behavior when associated checkboxes have a mix of checked and unchecked states.",
               "value": { "type": "boolean", "default": "false" }
             },
-            {
-              "name": "swatches",
-              "description": "One or more predefined color swatches to display as presets in the color picker. Can include any format the color\npicker can parse, including HEX(A), RGB(A), HSL(A), HSV(A), and CSS color names. Each color must be separated by a\nsemicolon (`;`). Alternatively, you can pass an array of color values to this property using JavaScript.",
-              "value": { "type": "string | string[]", "default": "''" }
-            },
             {
               "name": "form",
               "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
@@ -1146,32 +1114,38 @@
             },
             {
               "name": "required",
-              "description": "Makes the color picker a required field.",
+              "description": "Makes the checkbox a required field.",
               "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "help-text",
+              "description": "The checkbox's help text. If you need to display HTML, use the `help-text` slot instead.",
+              "value": { "type": "string", "default": "''" }
             }
           ],
           "slots": [
+            { "name": "", "description": "The checkbox's label." },
             {
-              "name": "label",
-              "description": "The color picker's form label. Alternatively, you can use the `label` attribute."
+              "name": "help-text",
+              "description": "Text that describes how to use the checkbox. Alternatively, you can use the `help-text` attribute."
             }
           ],
           "events": [
             {
               "name": "cw-blur",
-              "description": "Emitted when the color picker loses focus."
+              "description": "Emitted when the checkbox loses focus."
             },
             {
               "name": "cw-change",
-              "description": "Emitted when the color picker's value changes."
+              "description": "Emitted when the checked state changes."
             },
             {
               "name": "cw-focus",
-              "description": "Emitted when the color picker receives focus."
+              "description": "Emitted when the checkbox gains focus."
             },
             {
               "name": "cw-input",
-              "description": "Emitted when the color picker receives input."
+              "description": "Emitted when the checkbox receives input."
             },
             {
               "name": "cw-invalid",
@@ -1180,76 +1154,43 @@
           ],
           "js": {
             "properties": [
-              { "name": "base", "type": "HTMLElement" },
-              { "name": "input", "type": "CwInput" },
-              { "name": "dropdown", "type": "CwDropdown" },
-              { "name": "previewButton", "type": "HTMLButtonElement" },
-              { "name": "trigger", "type": "HTMLButtonElement" },
-              {
-                "name": "value",
-                "description": "The current value of the color picker. The value's format will vary based the `format` attribute. To get the value\nin a specific format, use the `getFormattedValue()` method. The value is submitted as a name/value pair with form\ndata.",
-                "type": "string"
-              },
+              { "name": "input", "type": "HTMLInputElement" },
+              { "name": "title", "type": "string" },
               {
-                "name": "defaultValue",
-                "description": "The default value of the form control. Primarily used for resetting the form control.",
+                "name": "name",
+                "description": "The name of the checkbox, submitted as a name/value pair with form data.",
                 "type": "string"
               },
               {
-                "name": "label",
-                "description": "The color picker's label. This will not be displayed, but it will be announced by assistive devices. If you need to\ndisplay HTML, you can use the `label` slot` instead.",
+                "name": "value",
+                "description": "The current value of the checkbox, submitted as a name/value pair with form data.",
                 "type": "string"
               },
-              {
-                "name": "format",
-                "description": "The format to use. If opacity is enabled, these will translate to HEXA, RGBA, HSLA, and HSVA respectively. The color\npicker will accept user input in any format (including CSS color names) and convert it to the desired format.",
-                "type": "'hex' | 'rgb' | 'hsl' | 'hsv'"
-              },
-              {
-                "name": "inline",
-                "description": "Renders the color picker inline rather than in a dropdown.",
-                "type": "boolean"
-              },
               {
                 "name": "size",
-                "description": "Determines the size of the color picker's trigger. This has no effect on inline color pickers.",
+                "description": "The checkbox's size.",
                 "type": "'small' | 'medium' | 'large'"
               },
-              {
-                "name": "noFormatToggle",
-                "description": "Removes the button that lets users toggle between format.",
-                "type": "boolean"
-              },
-              {
-                "name": "name",
-                "description": "The name of the form control, submitted as a name/value pair with form data.",
-                "type": "string"
-              },
               {
                 "name": "disabled",
-                "description": "Disables the color picker.",
+                "description": "Disables the checkbox.",
                 "type": "boolean"
               },
               {
-                "name": "hoist",
-                "description": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
+                "name": "checked",
+                "description": "Draws the checkbox in a checked state.",
                 "type": "boolean"
               },
               {
-                "name": "opacity",
-                "description": "Shows the opacity slider. Enabling this will cause the formatted value to be HEXA, RGBA, or HSLA.",
+                "name": "indeterminate",
+                "description": "Draws the checkbox in an indeterminate state. This is usually applied to checkboxes that represents a \"select\nall/none\" behavior when associated checkboxes have a mix of checked and unchecked states.",
                 "type": "boolean"
               },
               {
-                "name": "uppercase",
-                "description": "By default, values are lowercase. With this attribute, values will be uppercase instead.",
+                "name": "defaultChecked",
+                "description": "The default value of the form control. Primarily used for resetting the form control.",
                 "type": "boolean"
               },
-              {
-                "name": "swatches",
-                "description": "One or more predefined color swatches to display as presets in the color picker. Can include any format the color\npicker can parse, including HEX(A), RGB(A), HSL(A), HSV(A), and CSS color names. Each color must be separated by a\nsemicolon (`;`). Alternatively, you can pass an array of color values to this property using JavaScript.",
-                "type": "string | string[]"
-              },
               {
                 "name": "form",
                 "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
@@ -1257,9 +1198,14 @@
               },
               {
                 "name": "required",
-                "description": "Makes the color picker a required field.",
+                "description": "Makes the checkbox a required field.",
                 "type": "boolean"
               },
+              {
+                "name": "helpText",
+                "description": "The checkbox's help text. If you need to display HTML, use the `help-text` slot instead.",
+                "type": "string"
+              },
               {
                 "name": "validity",
                 "description": "Gets the validity state object"
@@ -1272,19 +1218,19 @@
             "events": [
               {
                 "name": "cw-blur",
-                "description": "Emitted when the color picker loses focus."
+                "description": "Emitted when the checkbox loses focus."
               },
               {
                 "name": "cw-change",
-                "description": "Emitted when the color picker's value changes."
+                "description": "Emitted when the checked state changes."
               },
               {
                 "name": "cw-focus",
-                "description": "Emitted when the color picker receives focus."
+                "description": "Emitted when the checkbox gains focus."
               },
               {
                 "name": "cw-input",
-                "description": "Emitted when the color picker receives input."
+                "description": "Emitted when the checkbox receives input."
               },
               {
                 "name": "cw-invalid",
@@ -1294,44 +1240,76 @@
           }
         },
         {
-          "name": "cw-checkbox",
-          "description": "Checkboxes allow the user to toggle an option on or off.\n---\n\n\n### **Events:**\n - **cw-blur** - Emitted when the checkbox loses focus.\n- **cw-change** - Emitted when the checked state changes.\n- **cw-focus** - Emitted when the checkbox gains focus.\n- **cw-input** - Emitted when the checkbox receives input.\n- **cw-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the checkbox.\n- **focus(options: _FocusOptions_)** - Sets focus on the checkbox.\n- **blur()** - Removes focus from the checkbox.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. The value provided will be shown to the user when the form is submitted. To clear\nthe custom validation message, call this method with an empty string.\n\n### **Slots:**\n - _default_ - The checkbox's label.\n- **help-text** - Text that describes how to use the checkbox. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The square container that wraps the checkbox's checked state.\n- **control--checked** - Matches the control part when the checkbox is checked.\n- **control--indeterminate** - Matches the control part when the checkbox is indeterminate.\n- **checked-icon** - The checked icon, an `<cw-icon>` element.\n- **indeterminate-icon** - The indeterminate icon, an `<cw-icon>` element.\n- **label** - The container that wraps the checkbox's label.\n- **form-control-help-text** - The help text's wrapper.",
+          "name": "cw-color-picker",
+          "description": "Color pickers allow the user to select a color.\n---\n\n\n### **Events:**\n - **cw-blur** - Emitted when the color picker loses focus.\n- **cw-change** - Emitted when the color picker's value changes.\n- **cw-focus** - Emitted when the color picker receives focus.\n- **cw-input** - Emitted when the color picker receives input.\n- **cw-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the color picker.\n- **blur()** - Removes focus from the color picker.\n- **getFormattedValue(format: _'hex' | 'hexa' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'hsv' | 'hsva'_)** - Returns the current value as a string in the specified format.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The color picker's form label. Alternatively, you can use the `label` attribute.\n\n### **CSS Properties:**\n - **--grid-width** - The width of the color grid. _(default: undefined)_\n- **--grid-height** - The height of the color grid. _(default: undefined)_\n- **--grid-handle-size** - The size of the color grid's handle. _(default: undefined)_\n- **--slider-height** - The height of the hue and alpha sliders. _(default: undefined)_\n- **--slider-handle-size** - The diameter of the slider's handle. _(default: undefined)_\n- **--swatch-size** - The size of each predefined color swatch. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **trigger** - The color picker's dropdown trigger.\n- **swatches** - The container that holds the swatches.\n- **swatch** - Each individual swatch.\n- **grid** - The color grid.\n- **grid-handle** - The color grid's handle.\n- **slider** - Hue and opacity sliders.\n- **slider-handle** - Hue and opacity slider handles.\n- **hue-slider** - The hue slider.\n- **hue-slider-handle** - The hue slider's handle.\n- **opacity-slider** - The opacity slider.\n- **opacity-slider-handle** - The opacity slider's handle.\n- **preview** - The preview color.\n- **input** - The text input.\n- **eye-dropper-button** - The eye dropper button.\n- **eye-dropper-button__base** - The eye dropper button's exported `button` part.\n- **eye-dropper-button__prefix** - The eye dropper button's exported `prefix` part.\n- **eye-dropper-button__label** - The eye dropper button's exported `label` part.\n- **eye-dropper-button__suffix** - The eye dropper button's exported `suffix` part.\n- **eye-dropper-button__caret** - The eye dropper button's exported `caret` part.\n- **format-button** - The format button.\n- **format-button__base** - The format button's exported `button` part.\n- **format-button__prefix** - The format button's exported `prefix` part.\n- **format-button__label** - The format button's exported `label` part.\n- **format-button__suffix** - The format button's exported `suffix` part.\n- **format-button__caret** - The format button's exported `caret` part.",
           "doc-url": "",
           "attributes": [
-            { "name": "title", "value": { "type": "string", "default": "''" } },
             {
-              "name": "name",
-              "description": "The name of the checkbox, submitted as a name/value pair with form data.",
+              "name": "value",
+              "description": "The current value of the color picker. The value's format will vary based the `format` attribute. To get the value\nin a specific format, use the `getFormattedValue()` method. The value is submitted as a name/value pair with form\ndata.",
               "value": { "type": "string", "default": "''" }
             },
             {
-              "name": "value",
-              "description": "The current value of the checkbox, submitted as a name/value pair with form data.",
-              "value": { "type": "string" }
+              "name": "label",
+              "description": "The color picker's label. This will not be displayed, but it will be announced by assistive devices. If you need to\ndisplay HTML, you can use the `label` slot` instead.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "format",
+              "description": "The format to use. If opacity is enabled, these will translate to HEXA, RGBA, HSLA, and HSVA respectively. The color\npicker will accept user input in any format (including CSS color names) and convert it to the desired format.",
+              "value": {
+                "type": "'hex' | 'rgb' | 'hsl' | 'hsv'",
+                "default": "'hex'"
+              }
+            },
+            {
+              "name": "inline",
+              "description": "Renders the color picker inline rather than in a dropdown.",
+              "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "size",
-              "description": "The checkbox's size.",
+              "description": "Determines the size of the color picker's trigger. This has no effect on inline color pickers.",
               "value": {
                 "type": "'small' | 'medium' | 'large'",
                 "default": "'medium'"
               }
             },
+            {
+              "name": "no-format-toggle",
+              "description": "Removes the button that lets users toggle between format.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "name",
+              "description": "The name of the form control, submitted as a name/value pair with form data.",
+              "value": { "type": "string", "default": "''" }
+            },
             {
               "name": "disabled",
-              "description": "Disables the checkbox.",
+              "description": "Disables the color picker.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
-              "name": "checked",
-              "description": "Draws the checkbox in a checked state.",
+              "name": "hoist",
+              "description": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
-              "name": "indeterminate",
-              "description": "Draws the checkbox in an indeterminate state. This is usually applied to checkboxes that represents a \"select\nall/none\" behavior when associated checkboxes have a mix of checked and unchecked states.",
+              "name": "opacity",
+              "description": "Shows the opacity slider. Enabling this will cause the formatted value to be HEXA, RGBA, or HSLA.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "uppercase",
+              "description": "By default, values are lowercase. With this attribute, values will be uppercase instead.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "swatches",
+              "description": "One or more predefined color swatches to display as presets in the color picker. Can include any format the color\npicker can parse, including HEX(A), RGB(A), HSL(A), HSV(A), and CSS color names. Each color must be separated by a\nsemicolon (`;`). Alternatively, you can pass an array of color values to this property using JavaScript.",
+              "value": { "type": "string | string[]", "default": "''" }
+            },
             {
               "name": "form",
               "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
@@ -1339,38 +1317,32 @@
             },
             {
               "name": "required",
-              "description": "Makes the checkbox a required field.",
+              "description": "Makes the color picker a required field.",
               "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "help-text",
-              "description": "The checkbox's help text. If you need to display HTML, use the `help-text` slot instead.",
-              "value": { "type": "string", "default": "''" }
             }
           ],
           "slots": [
-            { "name": "", "description": "The checkbox's label." },
             {
-              "name": "help-text",
-              "description": "Text that describes how to use the checkbox. Alternatively, you can use the `help-text` attribute."
+              "name": "label",
+              "description": "The color picker's form label. Alternatively, you can use the `label` attribute."
             }
           ],
           "events": [
             {
               "name": "cw-blur",
-              "description": "Emitted when the checkbox loses focus."
+              "description": "Emitted when the color picker loses focus."
             },
             {
               "name": "cw-change",
-              "description": "Emitted when the checked state changes."
+              "description": "Emitted when the color picker's value changes."
             },
             {
               "name": "cw-focus",
-              "description": "Emitted when the checkbox gains focus."
+              "description": "Emitted when the color picker receives focus."
             },
             {
               "name": "cw-input",
-              "description": "Emitted when the checkbox receives input."
+              "description": "Emitted when the color picker receives input."
             },
             {
               "name": "cw-invalid",
@@ -1379,43 +1351,76 @@
           ],
           "js": {
             "properties": [
-              { "name": "input", "type": "HTMLInputElement" },
-              { "name": "title", "type": "string" },
+              { "name": "base", "type": "HTMLElement" },
+              { "name": "input", "type": "CwInput" },
+              { "name": "dropdown", "type": "CwDropdown" },
+              { "name": "previewButton", "type": "HTMLButtonElement" },
+              { "name": "trigger", "type": "HTMLButtonElement" },
               {
-                "name": "name",
-                "description": "The name of the checkbox, submitted as a name/value pair with form data.",
+                "name": "value",
+                "description": "The current value of the color picker. The value's format will vary based the `format` attribute. To get the value\nin a specific format, use the `getFormattedValue()` method. The value is submitted as a name/value pair with form\ndata.",
                 "type": "string"
               },
               {
-                "name": "value",
-                "description": "The current value of the checkbox, submitted as a name/value pair with form data.",
+                "name": "defaultValue",
+                "description": "The default value of the form control. Primarily used for resetting the form control.",
+                "type": "string"
+              },
+              {
+                "name": "label",
+                "description": "The color picker's label. This will not be displayed, but it will be announced by assistive devices. If you need to\ndisplay HTML, you can use the `label` slot` instead.",
                 "type": "string"
               },
+              {
+                "name": "format",
+                "description": "The format to use. If opacity is enabled, these will translate to HEXA, RGBA, HSLA, and HSVA respectively. The color\npicker will accept user input in any format (including CSS color names) and convert it to the desired format.",
+                "type": "'hex' | 'rgb' | 'hsl' | 'hsv'"
+              },
+              {
+                "name": "inline",
+                "description": "Renders the color picker inline rather than in a dropdown.",
+                "type": "boolean"
+              },
               {
                 "name": "size",
-                "description": "The checkbox's size.",
+                "description": "Determines the size of the color picker's trigger. This has no effect on inline color pickers.",
                 "type": "'small' | 'medium' | 'large'"
               },
+              {
+                "name": "noFormatToggle",
+                "description": "Removes the button that lets users toggle between format.",
+                "type": "boolean"
+              },
+              {
+                "name": "name",
+                "description": "The name of the form control, submitted as a name/value pair with form data.",
+                "type": "string"
+              },
               {
                 "name": "disabled",
-                "description": "Disables the checkbox.",
+                "description": "Disables the color picker.",
                 "type": "boolean"
               },
               {
-                "name": "checked",
-                "description": "Draws the checkbox in a checked state.",
+                "name": "hoist",
+                "description": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
                 "type": "boolean"
               },
               {
-                "name": "indeterminate",
-                "description": "Draws the checkbox in an indeterminate state. This is usually applied to checkboxes that represents a \"select\nall/none\" behavior when associated checkboxes have a mix of checked and unchecked states.",
+                "name": "opacity",
+                "description": "Shows the opacity slider. Enabling this will cause the formatted value to be HEXA, RGBA, or HSLA.",
                 "type": "boolean"
               },
               {
-                "name": "defaultChecked",
-                "description": "The default value of the form control. Primarily used for resetting the form control.",
+                "name": "uppercase",
+                "description": "By default, values are lowercase. With this attribute, values will be uppercase instead.",
                 "type": "boolean"
               },
+              {
+                "name": "swatches",
+                "description": "One or more predefined color swatches to display as presets in the color picker. Can include any format the color\npicker can parse, including HEX(A), RGB(A), HSL(A), HSV(A), and CSS color names. Each color must be separated by a\nsemicolon (`;`). Alternatively, you can pass an array of color values to this property using JavaScript.",
+                "type": "string | string[]"
+              },
               {
                 "name": "form",
                 "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
@@ -1423,14 +1428,9 @@
               },
               {
                 "name": "required",
-                "description": "Makes the checkbox a required field.",
+                "description": "Makes the color picker a required field.",
                 "type": "boolean"
               },
-              {
-                "name": "helpText",
-                "description": "The checkbox's help text. If you need to display HTML, use the `help-text` slot instead.",
-                "type": "string"
-              },
               {
                 "name": "validity",
                 "description": "Gets the validity state object"
@@ -1443,19 +1443,19 @@
             "events": [
               {
                 "name": "cw-blur",
-                "description": "Emitted when the checkbox loses focus."
+                "description": "Emitted when the color picker loses focus."
               },
               {
                 "name": "cw-change",
-                "description": "Emitted when the checked state changes."
+                "description": "Emitted when the color picker's value changes."
               },
               {
                 "name": "cw-focus",
-                "description": "Emitted when the checkbox gains focus."
+                "description": "Emitted when the color picker receives focus."
               },
               {
                 "name": "cw-input",
-                "description": "Emitted when the checkbox receives input."
+                "description": "Emitted when the color picker receives input."
               },
               {
                 "name": "cw-invalid",
@@ -3372,6 +3372,111 @@
             "events": []
           }
         },
+        {
+          "name": "cw-header",
+          "description": "Page header region composing branding, primary navigation, icon-triggered action panels, and secondary\nnavigation into one piece of chrome.\n---\n\n\n### **Events:**\n - **cw-panel-show** - Emitted when an action panel opens.\n- **cw-panel-after-show** - Emitted after an action panel opens and all animations are complete.\n- **cw-panel-hide** - Emitted when an action panel closes.\n- **cw-panel-after-hide** - Emitted after an action panel closes and all animations are complete.\n\n### **Methods:**\n - **showPanel(name: _HeaderAction['name']_)** - Opens the named action panel. No-op if that slot has no content.\n- **hidePanel()** - Closes the currently open action panel, if any.\n\n### **Slots:**\n - **logo** - A `<cw-logo>`.\n- **primary-navigation** - A `<cw-primary-navigation>`.\n- **utility** - Content for the utility action panel, opened via a gear icon trigger.\n- **search** - Content for the search action panel, opened via a search icon trigger.\n- **notification** - Content for the notification action panel, opened via a bell icon trigger.\n- **user** - Content for the user/account action panel, opened via a person icon trigger.\n- **cart** - Content for the cart action panel, opened via a cart icon trigger.\n- **secondary-navigation** - A `<cw-secondary-navigation>`, rendered on its own row below everything else.\n\n### **CSS Properties:**\n - **--panel-width** - The width of an open action panel above `mobile-breakpoint`. Below it, panels are always full width. Defaults to `50%`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, a `<header>` landmark element.\n- **logo** - The container that wraps the slotted logo.\n- **primary-navigation** - The container that wraps the slotted primary navigation.\n- **actions** - The container that wraps the action triggers.\n- **trigger** - Each action trigger, a `<cw-icon-button>`.\n- **trigger--utility** - The utility action trigger.\n- **trigger--search** - The search action trigger.\n- **trigger--notification** - The notification action trigger.\n- **trigger--user** - The user action trigger.\n- **trigger--cart** - The cart action trigger.\n- **trigger__base** - A trigger's exported `base` part.\n- **indicator** - The line that highlights the currently open action trigger.\n- **panel** - The panel shown below the header when an action trigger is open.\n- **secondary-navigation** - The container that wraps the slotted secondary navigation.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "mobile-breakpoint",
+              "description": "The viewport width, in pixels, below which the header switches to its stacked mobile layout.",
+              "value": { "type": "number", "default": "768" }
+            }
+          ],
+          "slots": [
+            { "name": "logo", "description": "A `<cw-logo>`." },
+            {
+              "name": "primary-navigation",
+              "description": "A `<cw-primary-navigation>`."
+            },
+            {
+              "name": "utility",
+              "description": "Content for the utility action panel, opened via a gear icon trigger."
+            },
+            {
+              "name": "search",
+              "description": "Content for the search action panel, opened via a search icon trigger."
+            },
+            {
+              "name": "notification",
+              "description": "Content for the notification action panel, opened via a bell icon trigger."
+            },
+            {
+              "name": "user",
+              "description": "Content for the user/account action panel, opened via a person icon trigger."
+            },
+            {
+              "name": "cart",
+              "description": "Content for the cart action panel, opened via a cart icon trigger."
+            },
+            {
+              "name": "secondary-navigation",
+              "description": "A `<cw-secondary-navigation>`, rendered on its own row below everything else."
+            }
+          ],
+          "events": [
+            {
+              "name": "cw-panel-show",
+              "type": "{ name: String }",
+              "description": "Emitted when an action panel opens."
+            },
+            {
+              "name": "cw-panel-after-show",
+              "type": "{ name: String }",
+              "description": "Emitted after an action panel opens and all animations are complete."
+            },
+            {
+              "name": "cw-panel-hide",
+              "type": "{ name: String }",
+              "description": "Emitted when an action panel closes."
+            },
+            {
+              "name": "cw-panel-after-hide",
+              "type": "{ name: String }",
+              "description": "Emitted after an action panel closes and all animations are complete."
+            }
+          ],
+          "js": {
+            "properties": [
+              { "name": "panel", "type": "HTMLElement" },
+              { "name": "actionsRow", "type": "HTMLElement" },
+              { "name": "indicator", "type": "HTMLElement" },
+              { "name": "triggers", "type": "NodeListOf<CwIconButton>" },
+              {
+                "name": "activePanel",
+                "description": "The name of the currently open action panel, or `null` if none is open. Not reflected as an attribute — `null`\nis a legitimate, frequently-reached value here (no panel open), which doesn't play well with `CwElement`'s\nreflected-attribute \"morph fix\" (`src/internal/cw-element.ts`), designed around properties whose first non-null\nvalue is a permanent default rather than a value that legitimately toggles back to `null` at runtime.",
+                "type": "HeaderAction['name'] | null"
+              },
+              {
+                "name": "mobileBreakpoint",
+                "description": "The viewport width, in pixels, below which the header switches to its stacked mobile layout.",
+                "type": "number"
+              }
+            ],
+            "events": [
+              {
+                "name": "cw-panel-show",
+                "type": "{ name: String }",
+                "description": "Emitted when an action panel opens."
+              },
+              {
+                "name": "cw-panel-after-show",
+                "type": "{ name: String }",
+                "description": "Emitted after an action panel opens and all animations are complete."
+              },
+              {
+                "name": "cw-panel-hide",
+                "type": "{ name: String }",
+                "description": "Emitted when an action panel closes."
+              },
+              {
+                "name": "cw-panel-after-hide",
+                "type": "{ name: String }",
+                "description": "Emitted after an action panel closes and all animations are complete."
+              }
+            ]
+          }
+        },
         {
           "name": "cw-icon",
           "description": "Icons are symbols that can be used to represent various options within an application.\n---\n\n\n### **Events:**\n - **cw-load** - Emitted when the icon has loaded. When using `spriteSheet: true` this will not emit.\n- **cw-error** - Emitted when the icon fails to load due to an error. When using `spriteSheet: true` this will not emit.\n\n### **CSS Parts:**\n - **svg** - The internal SVG element.\n- **use** - The <use> element generated when using `spriteSheet: true`",