@warp-ds/elements 2.9.1-next.3 → 2.9.1-next.4

package/dist/docs/slider-thumb/api.md

@@ -1,92 +1,63 @@
-## API Documentation
+### `<w-slider-thumb>` API
 
-### Properties
+#### Properties
 
 | Name | Type | Default | Summary |
 |-|-|-|-|
-| ariaDescription | `string` | `-` | - |
-| ariaDescriptionText | `unknown` | `-` | - |
-| ariaLabel | `string` | `-` | - |
-| boundaryValue | `string` | `-` | - |
-| name | `string` | `-` | - |
-| placeholder | `string` | `-` | - |
-| shadowRootOptions | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
-| textFieldDisplayValue | `unknown` | `-` | Value to display in the textfield (shows boundary when focused on empty value) |
-| tooltipDisplayValue | `string \| number` | `-` | Value to display in the tooltip |
-| value | `string` | `-` | - |
+| aria-description | `string` | `-` | Contextual information for assistive technology, should it be needed |
+| aria-label | `string` | ``label` from `w-slider`` | Label for the range input. |
+| name | `string` | `-` | The name of this input field in the form. The canonical source of the value is the text field. |
+| placeholder | `string` | `-` | Placeholder in empty text fields |
+| value | `string` | `-` | The initial value, if any |
 
-### Property Details
-
-#### ariaDescription
+#### Property Details
 
+##### aria-description
 
+Contextual information for assistive technology, should it be needed
 
 - Type: `string`
 - Default: `-`
 
-#### ariaDescriptionText
-
-
-
-- Type: `unknown`
-- Default: `-`
-
-#### ariaLabel
-
+##### aria-label
 
+Label for the range input.
 
 - Type: `string`
-- Default: `-`
-
-#### boundaryValue
+- Default: ``label` from `w-slider``
 
+##### name
 
+The name of this input field in the form. The canonical source of the value is the text field.
 
 - Type: `string`
 - Default: `-`
 
-#### name
-
+##### placeholder
 
+Placeholder in empty text fields
 
 - Type: `string`
 - Default: `-`
 
-#### placeholder
-
+##### value
 
+The initial value, if any
 
 - Type: `string`
 - Default: `-`
 
-#### shadowRootOptions
-
+#### Events
 
+##### slidervalidity
 
-- Type: `object`
-- Default: `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }`
+Internal event used by (and stopped by) `w-slider`.
 
-#### textFieldDisplayValue
+- Type: `CustomEvent`
+##### thumbreset
 
-Value to display in the textfield (shows boundary when focused on empty value)
+Internal event used by (and stopped by) `w-slider`.
 
-- Type: `unknown`
-- Default: `-`
-
-#### tooltipDisplayValue
-
-Value to display in the tooltip
-
-- Type: `string \| number`
-- Default: `-`
-
-#### value
-
-
-
-- Type: `string`
-- Default: `-`
+- Type: `CustomEvent`
 
-### Types
 
-No types documented.

package/dist/docs/slider-thumb/slider-thumb.md

@@ -4,103 +4,72 @@
 
 Component to place inside a `<w-slider>`.
 
-[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-slider-and-range-slider--docs)
-
 ## Usage
 
 ## Accessibility
 
 ## Examples
 
-## API Documentation
+### `<w-slider-thumb>` API
 
-### Properties
+#### Properties
 
 | Name | Type | Default | Summary |
 |-|-|-|-|
-| ariaDescription | `string` | `-` | - |
-| ariaDescriptionText | `unknown` | `-` | - |
-| ariaLabel | `string` | `-` | - |
-| boundaryValue | `string` | `-` | - |
-| name | `string` | `-` | - |
-| placeholder | `string` | `-` | - |
-| shadowRootOptions | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
-| textFieldDisplayValue | `unknown` | `-` | Value to display in the textfield (shows boundary when focused on empty value) |
-| tooltipDisplayValue | `string \| number` | `-` | Value to display in the tooltip |
-| value | `string` | `-` | - |
-
-### Property Details
+| aria-description | `string` | `-` | Contextual information for assistive technology, should it be needed |
+| aria-label | `string` | ``label` from `w-slider`` | Label for the range input. |
+| name | `string` | `-` | The name of this input field in the form. The canonical source of the value is the text field. |
+| placeholder | `string` | `-` | Placeholder in empty text fields |
+| value | `string` | `-` | The initial value, if any |
 
-#### ariaDescription
+#### Property Details
 
+##### aria-description
 
+Contextual information for assistive technology, should it be needed
 
 - Type: `string`
 - Default: `-`
 
-#### ariaDescriptionText
-
-
-
-- Type: `unknown`
-- Default: `-`
-
-#### ariaLabel
-
+##### aria-label
 
+Label for the range input.
 
 - Type: `string`
-- Default: `-`
-
-#### boundaryValue
+- Default: ``label` from `w-slider``
 
+##### name
 
+The name of this input field in the form. The canonical source of the value is the text field.
 
 - Type: `string`
 - Default: `-`
 
-#### name
-
+##### placeholder
 
+Placeholder in empty text fields
 
 - Type: `string`
 - Default: `-`
 
-#### placeholder
-
+##### value
 
+The initial value, if any
 
 - Type: `string`
 - Default: `-`
 
-#### shadowRootOptions
+#### Events
 
+##### slidervalidity
 
+Internal event used by (and stopped by) `w-slider`.
 
-- Type: `object`
-- Default: `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }`
+- Type: `CustomEvent`
+##### thumbreset
 
-#### textFieldDisplayValue
+Internal event used by (and stopped by) `w-slider`.
 
-Value to display in the textfield (shows boundary when focused on empty value)
-
-- Type: `unknown`
-- Default: `-`
-
-#### tooltipDisplayValue
-
-Value to display in the tooltip
-
-- Type: `string \| number`
-- Default: `-`
-
-#### value
-
-
-
-- Type: `string`
-- Default: `-`
+- Type: `CustomEvent`
 
-### Types
 
-No types documented.

package/dist/docs/step/api.md

@@ -1,4 +1,6 @@
-## API Documentation
+## `<w-step>` API
+
+Unless otherwise noted all properties are HTML attributes (as opposed to JavaScript object properties).
 
 ### Properties
 
@@ -23,6 +25,3 @@
 - Type: `boolean`
 - Default: `false`
 
-### Types
-
-No types documented.

package/dist/docs/step/step.md

@@ -10,7 +10,9 @@ Individual step component that shows a single step in a process
 
 ## Examples
 
-## API Documentation
+## `<w-step>` API
+
+Unless otherwise noted all properties are HTML attributes (as opposed to JavaScript object properties).
 
 ### Properties
 
@@ -35,6 +37,3 @@ Individual step component that shows a single step in a process
 - Type: `boolean`
 - Default: `false`
 
-### Types
-
-No types documented.

package/dist/docs/step-indicator/api.md

@@ -1,4 +1,6 @@
-## API Documentation
+## `<w-step-indicator>` API
+
+Unless otherwise noted all properties are HTML attributes (as opposed to JavaScript object properties).
 
 ### Properties
 
@@ -23,6 +25,3 @@
 - Type: `boolean`
 - Default: `false`
 
-### Types
-
-No types documented.

package/dist/docs/step-indicator/step-indicator.md

@@ -12,7 +12,9 @@ Steps are used to show progress through a process or to guide users through a mu
 
 ## Examples
 
-## API Documentation
+## `<w-step-indicator>` API
+
+Unless otherwise noted all properties are HTML attributes (as opposed to JavaScript object properties).
 
 ### Properties
 
@@ -37,6 +39,3 @@ Steps are used to show progress through a process or to guide users through a mu
 - Type: `boolean`
 - Default: `false`
 
-### Types
-
-No types documented.

package/dist/docs/switch/api.md

@@ -1,4 +1,6 @@
-## API Documentation
+## `<w-switch>` API
+
+Unless otherwise noted all properties are HTML attributes (as opposed to JavaScript object properties).
 
 ### Properties
 
@@ -7,7 +9,7 @@
 | checked | `boolean` | `false` | - |
 | disabled | `boolean` | `false` | - |
 | name | `string` | `-` | - |
-| shadowRootOptions | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
+| shadowRootOptions (JS only) | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
 | value | `string` | `-` | - |
 
 ### Property Details
@@ -33,7 +35,7 @@
 - Type: `string`
 - Default: `-`
 
-#### shadowRootOptions
+#### shadowRootOptions (JS only)
 
 
 
@@ -47,6 +49,12 @@
 - Type: `string`
 - Default: `-`
 
-### Types
+### Events
+
+#### change
+
+
+
+- Type: `CustomEvent`
+
 
-No types documented.

package/dist/docs/switch/switch.md

@@ -10,7 +10,9 @@
 
 ## Examples
 
-## API Documentation
+## `<w-switch>` API
+
+Unless otherwise noted all properties are HTML attributes (as opposed to JavaScript object properties).
 
 ### Properties
 
@@ -19,7 +21,7 @@
 | checked | `boolean` | `false` | - |
 | disabled | `boolean` | `false` | - |
 | name | `string` | `-` | - |
-| shadowRootOptions | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
+| shadowRootOptions (JS only) | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
 | value | `string` | `-` | - |
 
 ### Property Details
@@ -45,7 +47,7 @@
 - Type: `string`
 - Default: `-`
 
-#### shadowRootOptions
+#### shadowRootOptions (JS only)
 
 
 
@@ -59,6 +61,12 @@
 - Type: `string`
 - Default: `-`
 
-### Types
+### Events
+
+#### change
+
+
+
+- Type: `CustomEvent`
+
 
-No types documented.

package/dist/docs/tab/api.md

@@ -1,78 +1,25 @@
-## API Documentation
+### `<w-tab>` API
 
-### Properties
+#### Properties
 
 | Name | Type | Default | Summary |
 |-|-|-|-|
-| _computedAriaSelected | `'true' \| 'false' \| undefined` | `-` | Computed aria-selected: prefers parent-managed, falls back to own property |
-| active | `boolean` | `false` | **Deprecated**: Use `aria-selected="true"` instead |
-| ariaSelected | `'true' \| 'false'` | `-` | - |
-| for | `string` | `-` | - |
-| id | `string` | `-` | - |
-| over | `boolean` | `false` | - |
-| shadowRootOptions | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
-| tabIndex | `number` | `-` | Override tabIndex setter to set _parentTabIndex (for backwards compatibility). |
+| for | `string` | `-` | The `id` of the `<w-tab-panel>` this tab controls. |
+| over | `boolean` | `false` | Whether to show the `icon` slot over the tab title instead of inline. |
 
-### Property Details
-
-#### _computedAriaSelected
-
-Computed aria-selected: prefers parent-managed, falls back to own property
-
-- Type: `'true' \| 'false' \| undefined`
-- Default: `-`
-
-#### active
-
-**Deprecated**: Use `aria-selected="true"` instead
-
-
-
-- Type: `boolean`
-- Default: `false`
-
-#### ariaSelected
-
-
-
-- Type: `'true' \| 'false'`
-- Default: `-`
-
-#### for
+#### Property Details
 
+##### for
 
+The `id` of the `<w-tab-panel>` this tab controls.
 
 - Type: `string`
 - Default: `-`
 
-#### id
-
-
-
-- Type: `string`
-- Default: `-`
-
-#### over
-
+##### over
 
+Whether to show the `icon` slot over the tab title instead of inline.
 
 - Type: `boolean`
 - Default: `false`
 
-#### shadowRootOptions
-
-
-
-- Type: `object`
-- Default: `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }`
-
-#### tabIndex
-
-Override tabIndex setter to set _parentTabIndex (for backwards compatibility).
-
-- Type: `number`
-- Default: `-`
-
-### Types
-
-No types documented.

package/dist/docs/tab/tab.md

@@ -4,89 +4,28 @@
 
 Individual tab component used within w-tabs container.
 
-[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/tabs--docs)
+### `<w-tab>` API
 
-## Usage
-
-## Accessibility
-
-## Examples
-
-## API Documentation
-
-### Properties
+#### Properties
 
 | Name | Type | Default | Summary |
 |-|-|-|-|
-| _computedAriaSelected | `'true' \| 'false' \| undefined` | `-` | Computed aria-selected: prefers parent-managed, falls back to own property |
-| active | `boolean` | `false` | **Deprecated**: Use `aria-selected="true"` instead |
-| ariaSelected | `'true' \| 'false'` | `-` | - |
-| for | `string` | `-` | - |
-| id | `string` | `-` | - |
-| over | `boolean` | `false` | - |
-| shadowRootOptions | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
-| tabIndex | `number` | `-` | Override tabIndex setter to set _parentTabIndex (for backwards compatibility). |
-
-### Property Details
-
-#### _computedAriaSelected
-
-Computed aria-selected: prefers parent-managed, falls back to own property
-
-- Type: `'true' \| 'false' \| undefined`
-- Default: `-`
-
-#### active
+| for | `string` | `-` | The `id` of the `<w-tab-panel>` this tab controls. |
+| over | `boolean` | `false` | Whether to show the `icon` slot over the tab title instead of inline. |
 
-**Deprecated**: Use `aria-selected="true"` instead
-
-
-
-- Type: `boolean`
-- Default: `false`
-
-#### ariaSelected
-
-
-
-- Type: `'true' \| 'false'`
-- Default: `-`
-
-#### for
+#### Property Details
 
+##### for
 
+The `id` of the `<w-tab-panel>` this tab controls.
 
 - Type: `string`
 - Default: `-`
 
-#### id
-
-
-
-- Type: `string`
-- Default: `-`
-
-#### over
-
+##### over
 
+Whether to show the `icon` slot over the tab title instead of inline.
 
 - Type: `boolean`
 - Default: `false`
 
-#### shadowRootOptions
-
-
-
-- Type: `object`
-- Default: `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }`
-
-#### tabIndex
-
-Override tabIndex setter to set _parentTabIndex (for backwards compatibility).
-
-- Type: `number`
-- Default: `-`
-
-### Types
-
-No types documented.

package/dist/docs/tab-panel/api.md

@@ -1,21 +1,17 @@
-## API Documentation
+### `<w-tab-panel>` API
 
-### Properties
+#### Properties
 
 | Name | Type | Default | Summary |
 |-|-|-|-|
-| active | `boolean` | `-` | Whether this panel is active (visible). |
+| id | `string` | `-` | Required so `<w-tab>` has something to target. |
 
-### Property Details
+#### Property Details
 
-#### active
+##### id
 
-Whether this panel is active (visible).
-Set by parent w-tabs via the _parentActive property.
+Required so `<w-tab>` has something to target.
 
-- Type: `boolean`
+- Type: `string`
 - Default: `-`
 
-### Types
-
-No types documented.

package/dist/docs/tab-panel/tab-panel.md

@@ -5,32 +5,20 @@
 Tab panel component that holds content for individual tabs.
 Each tab panel should have a name that matches a corresponding tab.
 
-[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/tabs--docs)
+### `<w-tab-panel>` API
 
-## Usage
-
-## Accessibility
-
-## Examples
-
-## API Documentation
-
-### Properties
+#### Properties
 
 | Name | Type | Default | Summary |
 |-|-|-|-|
-| active | `boolean` | `-` | Whether this panel is active (visible). |
+| id | `string` | `-` | Required so `<w-tab>` has something to target. |
 
-### Property Details
+#### Property Details
 
-#### active
+##### id
 
-Whether this panel is active (visible).
-Set by parent w-tabs via the _parentActive property.
+Required so `<w-tab>` has something to target.
 
-- Type: `boolean`
+- Type: `string`
 - Default: `-`
 
-### Types
-
-No types documented.

package/dist/docs/tabs/accessibility.md

@@ -1 +1,12 @@
 ## Accessibility
+
+The tabs component follows the WAI-ARIA Tabs pattern:
+
+- The tab list gets `role="tablist"`
+- Each tab button gets `role="tab"` with `aria-selected` reflecting its active state
+- Each tab button gets `aria-controls` pointing to its associated panel
+- Each panel gets `role="tabpanel"` with `aria-labelledby` pointing to its associated tab
+- Keyboard navigation is supported:
+  - `ArrowLeft`/`ArrowRight`: Navigate between tabs
+  - `Home`: Move to first tab
+  - `End`: Move to last tab