@warp-ds/elements 2.10.0-next.9 → 2.10.0

package/dist/docs/button/api.md

@@ -7,23 +7,24 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 | Name | Type | Default | Summary |
 |-|-|-|-|
 | autofocus | `boolean` | `false` | Focuses the button when it is first rendered. |
-| button-class | `string` | `-` | Deprecated class applied to the internal control. **Deprecated**: This class is applied inside the shadow DOM and is unlikely to have the desired effect. Use attributes or CSS variables to customize the appearance of the button. |
-| command | `string` | `-` | The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands. |
-| commandfor | `string` | `-` | The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands. |
+| button-class | `string \| undefined` | `-` | Deprecated class applied to the internal control. **Deprecated**: This class is applied inside the shadow DOM and is unlikely to have the desired effect. Use attributes or CSS variables to customize the appearance of the button. |
+| command | `string \| undefined` | `-` | The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands. |
+| commandfor | `string \| undefined` | `-` | The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands. |
 | disabled | `boolean` | `false` | Visually disables the button. |
 | full-width | `boolean` | `false` | Makes the button fill its parent width. |
-| href | `string` | `-` | URL for rendering the button as a link. |
+| href | `string \| undefined` | `-` | URL for rendering the button as a link. |
 | icon-only | `boolean` | `false` | Marks the button as icon-only. |
 | loading | `boolean` | `false` | Shows the loading state. |
-| name | `string` | `-` | Form control name. |
+| name | `string \| undefined` | `-` | Form control name. |
 | quiet | `boolean` | `false` | Deprecated quiet visual treatment flag. **Deprecated**: Use `variant="quiet"` instead |
-| rel | `string` | `-` | Link relationship. |
+| rel | `string \| undefined` | `-` | Link relationship. |
+| resetFormControl (JS only) | `resetFormControl() => void` | `-` | - |
 | shadowRootOptions (JS only) | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | Shadow root configuration. |
 | small | `boolean` | `false` | Renders the compact button size. |
-| target | `string` | `-` | Link browsing context. |
-| type | [`ButtonType`](#buttontype) | `-` | Native button type. |
-| value | `string` | `-` | Form control value. |
-| variant | [`ButtonVariant`](#buttonvariant) | `-` | Visual style of the button. |
+| target | `string \| undefined` | `-` | Link browsing context. |
+| type | [`ButtonType \| undefined`](#buttontype-undefined) | `-` | Native button type. |
+| value | `string \| undefined` | `-` | Form control value. |
+| variant | [`ButtonVariant \| undefined`](#buttonvariant-undefined) | `-` | Visual style of the button. |
 
 ### Property Details
 
@@ -42,21 +43,21 @@ Applies only when the component renders a native button. Link buttons with `href
 Deprecated class applied to the internal control
 This 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`
+- Type: `string | undefined`
 - Default: `-`
 
 #### command
 
 The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### commandfor
 
 The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### disabled
@@ -80,7 +81,7 @@ Useful in narrow layouts where the button should span the available inline space
 URL for rendering the button as a link.
 When set, the component renders `w-link` instead of a native `button`.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### icon-only
@@ -104,7 +105,7 @@ Use after the user has triggered an action and the action is in progress.
 Form control name.
 Used when the button participates in form handling.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### quiet
@@ -122,7 +123,14 @@ Use `variant="quiet"` instead.
 Link relationship.
 Passed to the rendered link when `href` is set. If `target="_blank"` is set and `rel` is omitted, `noopener` is used.
 
-- Type: `string`
+- Type: `string | undefined`
+- Default: `-`
+
+#### resetFormControl (JS only)
+
+
+
+- Type: `resetFormControl() => void`
 - Default: `-`
 
 #### shadowRootOptions (JS only)
@@ -146,7 +154,7 @@ Use this in dense layouts where the default button size is too large.
 Link browsing context.
 Passed to the rendered link when `href` is set.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### type
@@ -154,7 +162,7 @@ Passed to the rendered link when `href` is set.
 Native button type.
 Controls whether the internal button behaves as a regular button, submits a form, or resets a form. Defaults to `button`.
 
-- Type: [`ButtonType`](#buttontype)
+- Type: [`ButtonType | undefined`](#buttontype-undefined)
 - Default: `-`
 
 #### value
@@ -162,7 +170,7 @@ Controls whether the internal button behaves as a regular button, submits a form
 Form control value.
 Used with `name` when the button participates in form handling. Resets to its initial value when the form is reset.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### variant
@@ -170,16 +178,16 @@ Used with `name` when the button participates in form handling. Resets to its in
 Visual style of the button.
 Defaults to `secondary`. Use the variant that matches the action priority, risk, and placement.
 
-- Type: [`ButtonVariant`](#buttonvariant)
+- Type: [`ButtonVariant | undefined`](#buttonvariant-undefined)
 - Default: `-`
 
 ### Types
 
-#### ButtonType
+#### ButtonType | undefined
 
-`'button' | 'submit' | 'reset'`
+`'button' | 'submit' | 'reset' | undefined`
 
-#### ButtonVariant
+#### ButtonVariant | undefined
 
-`'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'quiet' | 'utilityQuiet' | 'overlay' | 'overlayInverted' | 'overlayQuiet' | 'overlayInvertedQuiet' | 'pill' | 'link'`
+`'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'quiet' | 'utilityQuiet' | 'overlay' | 'overlayInverted' | 'overlayQuiet' | 'overlayInvertedQuiet' | 'pill' | 'link' | undefined`
 

package/dist/docs/button/button.md

@@ -350,23 +350,24 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 | Name | Type | Default | Summary |
 |-|-|-|-|
 | autofocus | `boolean` | `false` | Focuses the button when it is first rendered. |
-| button-class | `string` | `-` | Deprecated class applied to the internal control. **Deprecated**: This class is applied inside the shadow DOM and is unlikely to have the desired effect. Use attributes or CSS variables to customize the appearance of the button. |
-| command | `string` | `-` | The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands. |
-| commandfor | `string` | `-` | The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands. |
+| button-class | `string \| undefined` | `-` | Deprecated class applied to the internal control. **Deprecated**: This class is applied inside the shadow DOM and is unlikely to have the desired effect. Use attributes or CSS variables to customize the appearance of the button. |
+| command | `string \| undefined` | `-` | The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands. |
+| commandfor | `string \| undefined` | `-` | The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands. |
 | disabled | `boolean` | `false` | Visually disables the button. |
 | full-width | `boolean` | `false` | Makes the button fill its parent width. |
-| href | `string` | `-` | URL for rendering the button as a link. |
+| href | `string \| undefined` | `-` | URL for rendering the button as a link. |
 | icon-only | `boolean` | `false` | Marks the button as icon-only. |
 | loading | `boolean` | `false` | Shows the loading state. |
-| name | `string` | `-` | Form control name. |
+| name | `string \| undefined` | `-` | Form control name. |
 | quiet | `boolean` | `false` | Deprecated quiet visual treatment flag. **Deprecated**: Use `variant="quiet"` instead |
-| rel | `string` | `-` | Link relationship. |
+| rel | `string \| undefined` | `-` | Link relationship. |
+| resetFormControl (JS only) | `resetFormControl() => void` | `-` | - |
 | shadowRootOptions (JS only) | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | Shadow root configuration. |
 | small | `boolean` | `false` | Renders the compact button size. |
-| target | `string` | `-` | Link browsing context. |
-| type | [`ButtonType`](#buttontype) | `-` | Native button type. |
-| value | `string` | `-` | Form control value. |
-| variant | [`ButtonVariant`](#buttonvariant) | `-` | Visual style of the button. |
+| target | `string \| undefined` | `-` | Link browsing context. |
+| type | [`ButtonType \| undefined`](#buttontype-undefined) | `-` | Native button type. |
+| value | `string \| undefined` | `-` | Form control value. |
+| variant | [`ButtonVariant \| undefined`](#buttonvariant-undefined) | `-` | Visual style of the button. |
 
 ### Property Details
 
@@ -385,21 +386,21 @@ Applies only when the component renders a native button. Link buttons with `href
 Deprecated class applied to the internal control
 This 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`
+- Type: `string | undefined`
 - Default: `-`
 
 #### command
 
 The [command HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### commandfor
 
 The [commandfor HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#html_attributes) for Invoker Commands.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### disabled
@@ -423,7 +424,7 @@ Useful in narrow layouts where the button should span the available inline space
 URL for rendering the button as a link.
 When set, the component renders `w-link` instead of a native `button`.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### icon-only
@@ -447,7 +448,7 @@ Use after the user has triggered an action and the action is in progress.
 Form control name.
 Used when the button participates in form handling.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### quiet
@@ -465,7 +466,14 @@ Use `variant="quiet"` instead.
 Link relationship.
 Passed to the rendered link when `href` is set. If `target="_blank"` is set and `rel` is omitted, `noopener` is used.
 
-- Type: `string`
+- Type: `string | undefined`
+- Default: `-`
+
+#### resetFormControl (JS only)
+
+
+
+- Type: `resetFormControl() => void`
 - Default: `-`
 
 #### shadowRootOptions (JS only)
@@ -489,7 +497,7 @@ Use this in dense layouts where the default button size is too large.
 Link browsing context.
 Passed to the rendered link when `href` is set.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### type
@@ -497,7 +505,7 @@ Passed to the rendered link when `href` is set.
 Native button type.
 Controls whether the internal button behaves as a regular button, submits a form, or resets a form. Defaults to `button`.
 
-- Type: [`ButtonType`](#buttontype)
+- Type: [`ButtonType | undefined`](#buttontype-undefined)
 - Default: `-`
 
 #### value
@@ -505,7 +513,7 @@ Controls whether the internal button behaves as a regular button, submits a form
 Form control value.
 Used with `name` when the button participates in form handling. Resets to its initial value when the form is reset.
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `-`
 
 #### variant
@@ -513,16 +521,16 @@ Used with `name` when the button participates in form handling. Resets to its in
 Visual style of the button.
 Defaults to `secondary`. Use the variant that matches the action priority, risk, and placement.
 
-- Type: [`ButtonVariant`](#buttonvariant)
+- Type: [`ButtonVariant | undefined`](#buttonvariant-undefined)
 - Default: `-`
 
 ### Types
 
-#### ButtonType
+#### ButtonType | undefined
 
-`'button' | 'submit' | 'reset'`
+`'button' | 'submit' | 'reset' | undefined`
 
-#### ButtonVariant
+#### ButtonVariant | undefined
 
-`'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'quiet' | 'utilityQuiet' | 'overlay' | 'overlayInverted' | 'overlayQuiet' | 'overlayInvertedQuiet' | 'pill' | 'link'`
+`'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'quiet' | 'utilityQuiet' | 'overlay' | 'overlayInverted' | 'overlayQuiet' | 'overlayInvertedQuiet' | 'pill' | 'link' | undefined`
 

package/dist/docs/card/api.md

@@ -9,6 +9,7 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 | buttonText (JS only) | `unknown` | `-` | - |
 | clickable | `boolean` | `false` | Whether the whole card is interactive. |
 | flat | `boolean` | `false` | Whether the card uses the flat visual treatment. |
+| keypressed (JS only) | `keypressed(e: KeyboardEvent) => void` | `-` | - |
 | selected | `boolean` | `false` | Whether the card is visually selected. |
 
 ### Property Details
@@ -38,6 +39,13 @@ Flat cards use a bordered surface instead of the default elevated surface. Use t
 - Type: `boolean`
 - Default: `false`
 
+#### keypressed (JS only)
+
+
+
+- Type: `keypressed(e: KeyboardEvent) => void`
+- Default: `-`
+
 #### selected
 
 Whether the card is visually selected.

package/dist/docs/card/card.md

@@ -248,6 +248,7 @@ Unless otherwise noted all properties are HTML attributes (as opposed to JavaScr
 | buttonText (JS only) | `unknown` | `-` | - |
 | clickable | `boolean` | `false` | Whether the whole card is interactive. |
 | flat | `boolean` | `false` | Whether the card uses the flat visual treatment. |
+| keypressed (JS only) | `keypressed(e: KeyboardEvent) => void` | `-` | - |
 | selected | `boolean` | `false` | Whether the card is visually selected. |
 
 ### Property Details
@@ -277,6 +278,13 @@ Flat cards use a bordered surface instead of the default elevated surface. Use t
 - Type: `boolean`
 - Default: `false`
 
+#### keypressed (JS only)
+
+
+
+- Type: `keypressed(e: KeyboardEvent) => void`
+- Default: `-`
+
 #### selected
 
 Whether the card is visually selected.

package/dist/docs/checkbox/api.md

@@ -5,14 +5,20 @@
 | Name | Type | Default | Summary |
 |-|-|-|-|
 | _computedInvalid (JS only) | `boolean` | `-` | Computed invalid state: combines own invalid with group invalid |
+| blur (JS only) | `blur() => void` | `-` | - |
+| checkValidity (JS only) | `checkValidity() => boolean` | `-` | Checks whether the checkbox passes constraint validation |
 | checked | `boolean` | `false` | Whether the checkbox is checked. |
+| click (JS only) | `click() => void` | `-` | - |
 | disabled | `boolean` | `false` | Whether the checkbox is disabled. |
+| focus (JS only) | `focus(options?: FocusOptions) => void` | `-` | - |
 | indeterminate | `boolean` | `false` | Whether the checkbox is visually indeterminate. |
-| input (JS only) | `HTMLInputElement \| null` | `-` | - |
+| input (JS only) | `HTMLInputElement` | `-` | - |
 | invalid | `boolean` | `false` | Whether the checkbox is visually invalid. |
 | name | `string \| undefined` | `-` | The name of the checkbox. |
+| reportValidity (JS only) | `reportValidity() => boolean` | `-` | Checks validity and shows the browser's validation message if invalid |
 | required | `boolean` | `false` | Whether the checkbox must be checked before form submission. |
-| shadowRootOptions (JS only) | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true }` | - |
+| resetFormControl (JS only) | `resetFormControl() => void` | `-` | - |
+| shadowRootOptions (JS only) | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
 | validationMessage (JS only) | `string` | `-` | Returns the validation message if the checkbox is invalid, otherwise an empty string |
 | validity (JS only) | `ValidityState` | `-` | Returns the validity state of the checkbox |
 | value | `string \| null` | `null` | The value submitted when the checkbox is checked. |
@@ -26,6 +32,20 @@ Computed invalid state: combines own invalid with group invalid
 - Type: `boolean`
 - Default: `-`
 
+##### blur (JS only)
+
+
+
+- Type: `blur() => void`
+- Default: `-`
+
+##### checkValidity (JS only)
+
+Checks whether the checkbox passes constraint validation
+
+- Type: `checkValidity() => boolean`
+- Default: `-`
+
 ##### checked
 
 Whether the checkbox is checked.
@@ -35,6 +55,13 @@ Checked checkboxes submit their value with form data. The property is reflected
 - Type: `boolean`
 - Default: `false`
 
+##### click (JS only)
+
+
+
+- Type: `click() => void`
+- Default: `-`
+
 ##### disabled
 
 Whether the checkbox is disabled.
@@ -44,6 +71,13 @@ Disabled checkboxes cannot be focused, changed, or submitted with form data.
 - Type: `boolean`
 - Default: `false`
 
+##### focus (JS only)
+
+
+
+- Type: `focus(options?: FocusOptions) => void`
+- Default: `-`
+
 ##### indeterminate
 
 Whether the checkbox is visually indeterminate.
@@ -57,7 +91,7 @@ Use this for parent options that represent a mixed set of child selections. Clic
 
 
 
-- Type: `HTMLInputElement | null`
+- Type: `HTMLInputElement`
 - Default: `-`
 
 ##### invalid
@@ -78,6 +112,13 @@ When the checkbox is checked and belongs to a form, this name is submitted with
 - Type: `string | undefined`
 - Default: `-`
 
+##### reportValidity (JS only)
+
+Checks validity and shows the browser's validation message if invalid
+
+- Type: `reportValidity() => boolean`
+- Default: `-`
+
 ##### required
 
 Whether the checkbox must be checked before form submission.
@@ -87,12 +128,19 @@ A required checkbox is invalid until it is checked. For requiring at least one o
 - Type: `boolean`
 - Default: `false`
 
+##### resetFormControl (JS only)
+
+
+
+- Type: `resetFormControl() => void`
+- Default: `-`
+
 ##### shadowRootOptions (JS only)
 
 
 
 - Type: `object`
-- Default: `{ ...LitElement.shadowRootOptions, delegatesFocus: true }`
+- Default: `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }`
 
 ##### validationMessage (JS only)