@warp-ds/elements 2.9.0-next.4 → 2.9.0-next.6

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

@@ -4,9 +4,7 @@
 
 | Name | Type | Default | Summary |
 |-|-|-|-|
-| active | `boolean` | `-` | - |
-| _parentActive | `unknown` | `-` | - |
-| _parentAriaLabelledBy | `unknown` | `-` | - |
+| active | `boolean` | `-` | Whether this panel is active (visible). |
 
 ### Property Details
 
@@ -18,20 +16,6 @@ Set by parent w-tabs via the _parentActive property.
 - Type: `boolean`
 - Default: `-`
 
-#### _parentActive
-
-
-
-- Type: `unknown`
-- Default: `-`
-
-#### _parentAriaLabelledBy
-
-
-
-- Type: `unknown`
-- Default: `-`
-
 ### Types
 
 No types documented.

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

@@ -19,9 +19,7 @@ Each tab panel should have a name that matches a corresponding tab.
 
 | Name | Type | Default | Summary |
 |-|-|-|-|
-| active | `boolean` | `-` | - |
-| _parentActive | `unknown` | `-` | - |
-| _parentAriaLabelledBy | `unknown` | `-` | - |
+| active | `boolean` | `-` | Whether this panel is active (visible). |
 
 ### Property Details
 
@@ -33,20 +31,6 @@ Set by parent w-tabs via the _parentActive property.
 - Type: `boolean`
 - Default: `-`
 
-#### _parentActive
-
-
-
-- Type: `unknown`
-- Default: `-`
-
-#### _parentAriaLabelledBy
-
-
-
-- Type: `unknown`
-- Default: `-`
-
 ### Types
 
 No types documented.

package/dist/docs/tabs/api.md

@@ -5,8 +5,8 @@
 | Name | Type | Default | Summary |
 |-|-|-|-|
 | active | `string` | `-` | - |
-| tabs | `unknown` | `-` | - |
 | activeTab | `unknown` | `-` | - |
+| tabs | `unknown` | `-` | - |
 
 ### Property Details
 
@@ -17,14 +17,14 @@
 - Type: `string`
 - Default: `-`
 
-#### tabs
+#### activeTab
 
 
 
 - Type: `unknown`
 - Default: `-`
 
-#### activeTab
+#### tabs
 
 
 

package/dist/docs/tabs/tabs.md

@@ -19,8 +19,8 @@ Tabs are used to organize content by grouping similar information on the same pa
 | Name | Type | Default | Summary |
 |-|-|-|-|
 | active | `string` | `-` | - |
-| tabs | `unknown` | `-` | - |
 | activeTab | `unknown` | `-` | - |
+| tabs | `unknown` | `-` | - |
 
 ### Property Details
 
@@ -31,14 +31,14 @@ Tabs are used to organize content by grouping similar information on the same pa
 - Type: `string`
 - Default: `-`
 
-#### tabs
+#### activeTab
 
 
 
 - Type: `unknown`
 - Default: `-`
 
-#### activeTab
+#### tabs
 
 
 

package/dist/docs/textarea/api.md

@@ -4,40 +4,40 @@
 
 | Name | Type | Default | Summary |
 |-|-|-|-|
-| shadowRootOptions | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
 | disabled | `boolean` | `false` | - |
+| helpText | `string` | `-` | - |
 | invalid | `boolean` | `false` | - |
 | label | `string` | `-` | - |
-| helpText | `string` | `-` | - |
+| maxHeight | `unknown` | `-` | - |
 | maxRows | `number` | `-` | - |
+| minHeight | `unknown` | `-` | - |
 | minRows | `number` | `-` | - |
 | name | `string` | `-` | - |
+| optional | `boolean` | `false` | - |
 | placeholder | `string` | `-` | - |
-| readOnly | `boolean` | `false` | - |
+| readOnly | `boolean` | `false` | **Deprecated**: Use the native readonly attribute instead. Here for API consistency with `w-textfield`. |
 | readonly | `boolean` | `false` | - |
 | required | `boolean` | `false` | - |
+| shadowRootOptions | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
+| validationMessage | `string` | `-` | Returns the validation message if the textarea is invalid, otherwise an empty string |
+| validity | `ValidityState` | `-` | Returns the validity state of the textarea |
 | value | `string` | `-` | - |
-| optional | `boolean` | `false` | - |
-| minHeight | `unknown` | `-` | - |
-| maxHeight | `unknown` | `-` | - |
-| validationMessage | `string` | `-` | - |
-| validity | `ValidityState` | `-` | - |
 
 ### Property Details
 
-#### shadowRootOptions
+#### disabled
 
 
 
-- Type: `object`
-- Default: `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }`
+- Type: `boolean`
+- Default: `false`
 
-#### disabled
+#### helpText
 
 
 
-- Type: `boolean`
-- Default: `false`
+- Type: `string`
+- Default: `-`
 
 #### invalid
 
@@ -53,11 +53,11 @@
 - Type: `string`
 - Default: `-`
 
-#### helpText
+#### maxHeight
 
 
 
-- Type: `string`
+- Type: `unknown`
 - Default: `-`
 
 #### maxRows
@@ -67,75 +67,70 @@
 - Type: `number`
 - Default: `-`
 
-#### minRows
+#### minHeight
 
 
 
-- Type: `number`
+- Type: `unknown`
 - Default: `-`
 
-#### name
+#### minRows
 
 
 
-- Type: `string`
+- Type: `number`
 - Default: `-`
 
-#### placeholder
+#### name
 
 
 
 - Type: `string`
 - Default: `-`
 
-#### readOnly
+#### optional
 
 
 
 - Type: `boolean`
 - Default: `false`
 
-#### readonly
+#### placeholder
 
 
 
-- Type: `boolean`
-- Default: `false`
+- Type: `string`
+- Default: `-`
 
-#### required
+#### readOnly
+
+**Deprecated**: Use the native readonly attribute instead. Here for API consistency with `w-textfield`.
 
 
 
 - Type: `boolean`
 - Default: `false`
 
-#### value
-
-
-
-- Type: `string`
-- Default: `-`
-
-#### optional
+#### readonly
 
 
 
 - Type: `boolean`
 - Default: `false`
 
-#### minHeight
+#### required
 
 
 
-- Type: `unknown`
-- Default: `-`
+- Type: `boolean`
+- Default: `false`
 
-#### maxHeight
+#### shadowRootOptions
 
 
 
-- Type: `unknown`
-- Default: `-`
+- Type: `object`
+- Default: `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }`
 
 #### validationMessage
 
@@ -151,6 +146,13 @@ Returns the validity state of the textarea
 - Type: `ValidityState`
 - Default: `-`
 
+#### value
+
+
+
+- Type: `string`
+- Default: `-`
+
 ### Types
 
 No types documented.

package/dist/docs/textarea/textarea.md

@@ -18,40 +18,40 @@ A single line text input element.
 
 | Name | Type | Default | Summary |
 |-|-|-|-|
-| shadowRootOptions | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
 | disabled | `boolean` | `false` | - |
+| helpText | `string` | `-` | - |
 | invalid | `boolean` | `false` | - |
 | label | `string` | `-` | - |
-| helpText | `string` | `-` | - |
+| maxHeight | `unknown` | `-` | - |
 | maxRows | `number` | `-` | - |
+| minHeight | `unknown` | `-` | - |
 | minRows | `number` | `-` | - |
 | name | `string` | `-` | - |
+| optional | `boolean` | `false` | - |
 | placeholder | `string` | `-` | - |
-| readOnly | `boolean` | `false` | - |
+| readOnly | `boolean` | `false` | **Deprecated**: Use the native readonly attribute instead. Here for API consistency with `w-textfield`. |
 | readonly | `boolean` | `false` | - |
 | required | `boolean` | `false` | - |
+| shadowRootOptions | `object` | `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }` | - |
+| validationMessage | `string` | `-` | Returns the validation message if the textarea is invalid, otherwise an empty string |
+| validity | `ValidityState` | `-` | Returns the validity state of the textarea |
 | value | `string` | `-` | - |
-| optional | `boolean` | `false` | - |
-| minHeight | `unknown` | `-` | - |
-| maxHeight | `unknown` | `-` | - |
-| validationMessage | `string` | `-` | - |
-| validity | `ValidityState` | `-` | - |
 
 ### Property Details
 
-#### shadowRootOptions
+#### disabled
 
 
 
-- Type: `object`
-- Default: `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }`
+- Type: `boolean`
+- Default: `false`
 
-#### disabled
+#### helpText
 
 
 
-- Type: `boolean`
-- Default: `false`
+- Type: `string`
+- Default: `-`
 
 #### invalid
 
@@ -67,11 +67,11 @@ A single line text input element.
 - Type: `string`
 - Default: `-`
 
-#### helpText
+#### maxHeight
 
 
 
-- Type: `string`
+- Type: `unknown`
 - Default: `-`
 
 #### maxRows
@@ -81,75 +81,70 @@ A single line text input element.
 - Type: `number`
 - Default: `-`
 
-#### minRows
+#### minHeight
 
 
 
-- Type: `number`
+- Type: `unknown`
 - Default: `-`
 
-#### name
+#### minRows
 
 
 
-- Type: `string`
+- Type: `number`
 - Default: `-`
 
-#### placeholder
+#### name
 
 
 
 - Type: `string`
 - Default: `-`
 
-#### readOnly
+#### optional
 
 
 
 - Type: `boolean`
 - Default: `false`
 
-#### readonly
+#### placeholder
 
 
 
-- Type: `boolean`
-- Default: `false`
+- Type: `string`
+- Default: `-`
 
-#### required
+#### readOnly
+
+**Deprecated**: Use the native readonly attribute instead. Here for API consistency with `w-textfield`.
 
 
 
 - Type: `boolean`
 - Default: `false`
 
-#### value
-
-
-
-- Type: `string`
-- Default: `-`
-
-#### optional
+#### readonly
 
 
 
 - Type: `boolean`
 - Default: `false`
 
-#### minHeight
+#### required
 
 
 
-- Type: `unknown`
-- Default: `-`
+- Type: `boolean`
+- Default: `false`
 
-#### maxHeight
+#### shadowRootOptions
 
 
 
-- Type: `unknown`
-- Default: `-`
+- Type: `object`
+- Default: `{ ...LitElement.shadowRootOptions, delegatesFocus: true, }`
 
 #### validationMessage
 
@@ -165,6 +160,13 @@ Returns the validity state of the textarea
 - Type: `ValidityState`
 - Default: `-`
 
+#### value
+
+
+
+- Type: `string`
+- Default: `-`
+
 ### Types
 
 No types documented.

package/dist/docs/textfield/accessibility.md

@@ -1 +1,16 @@
 ## Accessibility
+
+If a visible label isn't specified, an `aria-label` must be provided to the text field for accessibility. If the field is labeled by a separate element, an `aria-labelledby` property must be provided using the `id` of the labeling element instead.
+
+- Always provide a visible label (do not rely on `placeholder` alone).
+- Do not rely on color alone for interaction feedback (e.g. error states).
+- Interaction patterns should follow platform-native expectations (e.g. tap zones, keyboard navigation, etc) and must not block accessibility tools.
+
+### When used with an affix
+
+When `search` or `clear` set on the [affix](#with-affix) component it renders a button and a default `aria-label`. If the `aria-label` incorrect for your context, you may provide your own describing the action.
+
+```html
+<w-affix search aria-label="Ad Search"></w-affix>
+<w-affix clear aria-label="Clear text input"></w-affix>
+```