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

package/dist/index.d.ts

@@ -468,39 +468,56 @@ export type WarpButtonSolidJsProps = {
 };
 
 export type WarpAttentionProps = {
-  /**  */
+  /** Controls whether the attention panel is visible.
+Set to `true` to show the attention content and `false` to hide it. */
   show?: WarpAttention["show"];
-  /**  */
+  /** Preferred placement relative to the trigger element.
+Sets the initial direction for positioning, for example `top`, `right`, `bottom`, or `left` variants. */
   placement?: WarpAttention["placement"];
-  /**  */
+  /** Renders the component with tooltip styling and behavior.
+Use for compact, non-modal contextual hints anchored to another element. */
   tooltip?: WarpAttention["tooltip"];
-  /**  */
+  /** Renders the component as an inline callout.
+Callout mode is used for always-in-flow informational content instead of floating overlay behavior. */
   callout?: WarpAttention["callout"];
-  /**  */
+  /** Enables native popover behavior for the attention element.
+When enabled, the component uses popover semantics and styling suitable for floating surface UI. */
   popover?: WarpAttention["popover"];
-  /**  */
+  /** Renders the component with highlight styling.
+Use highlight mode to visually emphasize important contextual information. */
   highlight?: WarpAttention["highlight"];
-  /**  */
+  /** Shows a close button inside the attention component.
+Adds an internal dismiss action that lets users close the attention panel. */
   "can-close"?: WarpAttention["canClose"];
-  /**  */
+  /** Shows a close button inside the attention component.
+Adds an internal dismiss action that lets users close the attention panel. */
   canClose?: WarpAttention["canClose"];
-  /**  */
+  /** Hides the directional arrow of the attention component.
+Disable the arrow when the visual connection to the trigger should not be shown. */
   "no-arrow"?: WarpAttention["noArrow"];
-  /**  */
+  /** Hides the directional arrow of the attention component.
+Disable the arrow when the visual connection to the trigger should not be shown. */
   noArrow?: WarpAttention["noArrow"];
-  /**  */
+  /** Distance offset between trigger and attention panel.
+Defines the main-axis spacing in pixels from the anchor element. */
   distance?: WarpAttention["distance"];
-  /**  */
+  /** Cross-axis offset for fine-grained positioning.
+Moves the panel along the cross axis in pixels to adjust alignment with the trigger. */
   skidding?: WarpAttention["skidding"];
-  /**  */
+  /** Enables automatic flipping when placement has no space.
+Allows the component to choose an alternative side if the preferred placement would overflow. */
   flip?: WarpAttention["flip"];
-  /**  */
+  /** Allows overflow checks on the cross axis when flipping.
+Use with `flip` to improve collision handling when space is constrained horizontally or vertically. */
   "cross-axis"?: WarpAttention["crossAxis"];
-  /**  */
+  /** Allows overflow checks on the cross axis when flipping.
+Use with `flip` to improve collision handling when space is constrained horizontally or vertically. */
   crossAxis?: WarpAttention["crossAxis"];
-  /**  */
+  /** Ordered list of fallback placements.
+Provides explicit alternative placements to try when `flip` is enabled and the preferred placement does not fit. */
   "fallback-placements"?: WarpAttention["fallbackPlacements"];
-  /**  */
+  /** Ordered list of fallback placements.
+Provides explicit alternative placements to try when `flip` is enabled and the preferred placement does not fit. */
   fallbackPlacements?: WarpAttention["fallbackPlacements"];
   /**  */
   _initialPlacement?: WarpAttention["_initialPlacement"];
@@ -509,39 +526,56 @@ export type WarpAttentionProps = {
 };
 
 export type WarpAttentionSolidJsProps = {
-  /**  */
+  /** Controls whether the attention panel is visible.
+Set to `true` to show the attention content and `false` to hide it. */
   "prop:show"?: WarpAttention["show"];
-  /**  */
+  /** Preferred placement relative to the trigger element.
+Sets the initial direction for positioning, for example `top`, `right`, `bottom`, or `left` variants. */
   "prop:placement"?: WarpAttention["placement"];
-  /**  */
+  /** Renders the component with tooltip styling and behavior.
+Use for compact, non-modal contextual hints anchored to another element. */
   "prop:tooltip"?: WarpAttention["tooltip"];
-  /**  */
+  /** Renders the component as an inline callout.
+Callout mode is used for always-in-flow informational content instead of floating overlay behavior. */
   "prop:callout"?: WarpAttention["callout"];
-  /**  */
+  /** Enables native popover behavior for the attention element.
+When enabled, the component uses popover semantics and styling suitable for floating surface UI. */
   "prop:popover"?: WarpAttention["popover"];
-  /**  */
+  /** Renders the component with highlight styling.
+Use highlight mode to visually emphasize important contextual information. */
   "prop:highlight"?: WarpAttention["highlight"];
-  /**  */
+  /** Shows a close button inside the attention component.
+Adds an internal dismiss action that lets users close the attention panel. */
   "bool:can-close"?: WarpAttention["canClose"];
-  /**  */
+  /** Shows a close button inside the attention component.
+Adds an internal dismiss action that lets users close the attention panel. */
   "prop:canClose"?: WarpAttention["canClose"];
-  /**  */
+  /** Hides the directional arrow of the attention component.
+Disable the arrow when the visual connection to the trigger should not be shown. */
   "bool:no-arrow"?: WarpAttention["noArrow"];
-  /**  */
+  /** Hides the directional arrow of the attention component.
+Disable the arrow when the visual connection to the trigger should not be shown. */
   "prop:noArrow"?: WarpAttention["noArrow"];
-  /**  */
+  /** Distance offset between trigger and attention panel.
+Defines the main-axis spacing in pixels from the anchor element. */
   "prop:distance"?: WarpAttention["distance"];
-  /**  */
+  /** Cross-axis offset for fine-grained positioning.
+Moves the panel along the cross axis in pixels to adjust alignment with the trigger. */
   "prop:skidding"?: WarpAttention["skidding"];
-  /**  */
+  /** Enables automatic flipping when placement has no space.
+Allows the component to choose an alternative side if the preferred placement would overflow. */
   "prop:flip"?: WarpAttention["flip"];
-  /**  */
+  /** Allows overflow checks on the cross axis when flipping.
+Use with `flip` to improve collision handling when space is constrained horizontally or vertically. */
   "bool:cross-axis"?: WarpAttention["crossAxis"];
-  /**  */
+  /** Allows overflow checks on the cross axis when flipping.
+Use with `flip` to improve collision handling when space is constrained horizontally or vertically. */
   "prop:crossAxis"?: WarpAttention["crossAxis"];
-  /**  */
+  /** Ordered list of fallback placements.
+Provides explicit alternative placements to try when `flip` is enabled and the preferred placement does not fit. */
   "attr:fallback-placements"?: WarpAttention["fallbackPlacements"];
-  /**  */
+  /** Ordered list of fallback placements.
+Provides explicit alternative placements to try when `flip` is enabled and the preferred placement does not fit. */
   "prop:fallbackPlacements"?: WarpAttention["fallbackPlacements"];
   /**  */
   "prop:_initialPlacement"?: WarpAttention["_initialPlacement"];
@@ -1770,85 +1804,97 @@ export type WarpTabsSolidJsProps = {
 };
 
 export type WarpTextareaProps = {
-  /**  */
+  /** Keep in mind that using disabled in its current form is an anti-pattern.
+
+There will always be users who don't understand why an element is disabled, or users who can't even see that it is disabled because of poor lighting conditions or other reasons.
+
+Please consider more informative alternatives before choosing to use disabled on an element. */
   disabled?: WarpTextarea["disabled"];
-  /**  */
+  /** Mark the form field as invalid.
+
+Make sure to also set a `help-text` to help users fix the validation problem. */
   invalid?: WarpTextarea["invalid"];
-  /**  */
+  /** Either a `label` or an `aria-label` must be provided. */
   label?: WarpTextarea["label"];
-  /**  */
+  /** Use in combination with `invalid` to show as a validation error message,
+or on its own to show a help text. */
   "help-text"?: WarpTextarea["helpText"];
-  /**  */
+  /** Use in combination with `invalid` to show as a validation error message,
+or on its own to show a help text. */
   helpText?: WarpTextarea["helpText"];
-  /**  */
+  /** Sets the maximum number of text rows before the content starts scrolling. */
   "maximum-rows"?: WarpTextarea["maxRows"];
-  /**  */
+  /** Sets the maximum number of text rows before the content starts scrolling. */
   maxRows?: WarpTextarea["maxRows"];
-  /**  */
+  /** Sets the minimum number of text rows the textarea should display */
   "minimum-rows"?: WarpTextarea["minRows"];
-  /**  */
+  /** Sets the minimum number of text rows the textarea should display */
   minRows?: WarpTextarea["minRows"];
-  /**  */
+  /** The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the input field when submitting the form */
   name?: WarpTextarea["name"];
-  /**  */
+  /** Set a text that is shown in the textarea when it doesn't have a value.
+
+Placeholder text should not be used as a substitute for labeling the element with a visible label. */
   placeholder?: WarpTextarea["placeholder"];
-  /** @deprecated Use the native readonly attribute instead. Here for API consistency with `w-textfield`.  */
+  /** @deprecated Use the native `readonly` attribute instead  */
   "read-only"?: WarpTextarea["readOnly"];
-  /** @deprecated Use the native readonly attribute instead. Here for API consistency with `w-textfield`.  */
+  /** @deprecated Use the native `readonly` attribute instead  */
   readOnly?: WarpTextarea["readOnly"];
-  /**  */
+  /** Whether the input can be selected but not changed by the user */
   readonly?: WarpTextarea["readonly"];
-  /**  */
+  /** Whether user input is required on the input before form submission */
   required?: WarpTextarea["required"];
-  /**  */
+  /** Lets you set the current value */
   value?: WarpTextarea["value"];
-  /**  */
+  /** Show an icon behind the label indicating the field is optional */
   optional?: WarpTextarea["optional"];
-  /**  */
-  minHeight?: WarpTextarea["minHeight"];
-  /**  */
-  maxHeight?: WarpTextarea["maxHeight"];
 };
 
 export type WarpTextareaSolidJsProps = {
-  /**  */
+  /** Keep in mind that using disabled in its current form is an anti-pattern.
+
+There will always be users who don't understand why an element is disabled, or users who can't even see that it is disabled because of poor lighting conditions or other reasons.
+
+Please consider more informative alternatives before choosing to use disabled on an element. */
   "prop:disabled"?: WarpTextarea["disabled"];
-  /**  */
+  /** Mark the form field as invalid.
+
+Make sure to also set a `help-text` to help users fix the validation problem. */
   "prop:invalid"?: WarpTextarea["invalid"];
-  /**  */
+  /** Either a `label` or an `aria-label` must be provided. */
   "prop:label"?: WarpTextarea["label"];
-  /**  */
+  /** Use in combination with `invalid` to show as a validation error message,
+or on its own to show a help text. */
   "attr:help-text"?: WarpTextarea["helpText"];
-  /**  */
+  /** Use in combination with `invalid` to show as a validation error message,
+or on its own to show a help text. */
   "prop:helpText"?: WarpTextarea["helpText"];
-  /**  */
+  /** Sets the maximum number of text rows before the content starts scrolling. */
   "attr:maximum-rows"?: WarpTextarea["maxRows"];
-  /**  */
+  /** Sets the maximum number of text rows before the content starts scrolling. */
   "prop:maxRows"?: WarpTextarea["maxRows"];
-  /**  */
+  /** Sets the minimum number of text rows the textarea should display */
   "attr:minimum-rows"?: WarpTextarea["minRows"];
-  /**  */
+  /** Sets the minimum number of text rows the textarea should display */
   "prop:minRows"?: WarpTextarea["minRows"];
-  /**  */
+  /** The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the input field when submitting the form */
   "prop:name"?: WarpTextarea["name"];
-  /**  */
+  /** Set a text that is shown in the textarea when it doesn't have a value.
+
+Placeholder text should not be used as a substitute for labeling the element with a visible label. */
   "prop:placeholder"?: WarpTextarea["placeholder"];
-  /** @deprecated Use the native readonly attribute instead. Here for API consistency with `w-textfield`.  */
+  /** @deprecated Use the native `readonly` attribute instead  */
   "bool:read-only"?: WarpTextarea["readOnly"];
-  /** @deprecated Use the native readonly attribute instead. Here for API consistency with `w-textfield`.  */
+  /** @deprecated Use the native `readonly` attribute instead  */
   "prop:readOnly"?: WarpTextarea["readOnly"];
-  /**  */
+  /** Whether the input can be selected but not changed by the user */
   "prop:readonly"?: WarpTextarea["readonly"];
-  /**  */
+  /** Whether user input is required on the input before form submission */
   "prop:required"?: WarpTextarea["required"];
-  /**  */
+  /** Lets you set the current value */
   "prop:value"?: WarpTextarea["value"];
-  /**  */
+  /** Show an icon behind the label indicating the field is optional */
   "prop:optional"?: WarpTextarea["optional"];
-  /**  */
-  "prop:minHeight"?: WarpTextarea["minHeight"];
-  /**  */
-  "prop:maxHeight"?: WarpTextarea["maxHeight"];
 
   /** Set the innerHTML of the element */
   innerHTML?: string;
@@ -2025,25 +2071,42 @@ export type CustomElements = {
   "w-button": Partial<WarpButtonProps & BaseProps<WarpButton> & BaseEvents>;
 
   /**
+   * Attention is a versatile component for displaying contextual information and messages. It can be used for a wide range of purposes, such as tooltips, callouts, popovers, and highlights.
+   *
+   * The component is designed to be anchored to a trigger element, providing contextual information related to that element. It supports various placements and styling options to accommodate different use cases and design needs.
    *
+   * Note: attention will soon be split into multiple components (tooltip, callout, popover, highlight) at which time this component will be deprecated. For now, use the `tooltip`, `callout`, `popover`, and `highlight` boolean properties to achieve the desired style and behavior.
    *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `show`: undefined
-   * - `placement`: undefined
-   * - `tooltip`: undefined
-   * - `callout`: undefined
-   * - `popover`: undefined
-   * - `highlight`: undefined
-   * - `can-close`/`canClose`: undefined
-   * - `no-arrow`/`noArrow`: undefined
-   * - `distance`: undefined
-   * - `skidding`: undefined
-   * - `flip`: undefined
-   * - `cross-axis`/`crossAxis`: undefined
-   * - `fallback-placements`/`fallbackPlacements`: undefined
+   * - `show`: Controls whether the attention panel is visible.
+   * Set to `true` to show the attention content and `false` to hide it.
+   * - `placement`: Preferred placement relative to the trigger element.
+   * Sets the initial direction for positioning, for example `top`, `right`, `bottom`, or `left` variants.
+   * - `tooltip`: Renders the component with tooltip styling and behavior.
+   * Use for compact, non-modal contextual hints anchored to another element.
+   * - `callout`: Renders the component as an inline callout.
+   * Callout mode is used for always-in-flow informational content instead of floating overlay behavior.
+   * - `popover`: Enables native popover behavior for the attention element.
+   * When enabled, the component uses popover semantics and styling suitable for floating surface UI.
+   * - `highlight`: Renders the component with highlight styling.
+   * Use highlight mode to visually emphasize important contextual information.
+   * - `can-close`/`canClose`: Shows a close button inside the attention component.
+   * Adds an internal dismiss action that lets users close the attention panel.
+   * - `no-arrow`/`noArrow`: Hides the directional arrow of the attention component.
+   * Disable the arrow when the visual connection to the trigger should not be shown.
+   * - `distance`: Distance offset between trigger and attention panel.
+   * Defines the main-axis spacing in pixels from the anchor element.
+   * - `skidding`: Cross-axis offset for fine-grained positioning.
+   * Moves the panel along the cross axis in pixels to adjust alignment with the trigger.
+   * - `flip`: Enables automatic flipping when placement has no space.
+   * Allows the component to choose an alternative side if the preferred placement would overflow.
+   * - `cross-axis`/`crossAxis`: Allows overflow checks on the cross axis when flipping.
+   * Use with `flip` to improve collision handling when space is constrained horizontally or vertically.
+   * - `fallback-placements`/`fallbackPlacements`: Ordered list of fallback placements.
+   * Provides explicit alternative placements to try when `flip` is enabled and the preferred placement does not fit.
    * - `_initialPlacement`: undefined (property only)
    * - `_actualDirection`: undefined (property only)
    *
@@ -2804,29 +2867,40 @@ export type CustomElements = {
   "w-tabs": Partial<WarpTabsProps & BaseProps<WarpTabs> & BaseEvents>;
 
   /**
-   * A single line text input element.
+   * A multi-line text input with built-in form validation, auto-resizing, and styling support.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-textfield--docs)
+   * The component automatically handles:
+   *  - Form integration
+   *  - Auto-resizing based on content and row constraints
+   *  - Built-in validation with customizable error messages
+   *  - Accessibility attributes and labeling
    *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `disabled`: undefined
-   * - `invalid`: undefined
-   * - `label`: undefined
-   * - `help-text`/`helpText`: undefined
-   * - `maximum-rows`/`maxRows`: undefined
-   * - `minimum-rows`/`minRows`: undefined
-   * - `name`: undefined
-   * - `placeholder`: undefined
+   * - `disabled`: Keep in mind that using disabled in its current form is an anti-pattern.
+   *
+   * There will always be users who don't understand why an element is disabled, or users who can't even see that it is disabled because of poor lighting conditions or other reasons.
+   *
+   * Please consider more informative alternatives before choosing to use disabled on an element.
+   * - `invalid`: Mark the form field as invalid.
+   *
+   * Make sure to also set a `help-text` to help users fix the validation problem.
+   * - `label`: Either a `label` or an `aria-label` must be provided.
+   * - `help-text`/`helpText`: Use in combination with `invalid` to show as a validation error message,
+   * or on its own to show a help text.
+   * - `maximum-rows`/`maxRows`: Sets the maximum number of text rows before the content starts scrolling.
+   * - `minimum-rows`/`minRows`: Sets the minimum number of text rows the textarea should display
+   * - `name`: The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the input field when submitting the form
+   * - `placeholder`: Set a text that is shown in the textarea when it doesn't have a value.
+   *
+   * Placeholder text should not be used as a substitute for labeling the element with a visible label.
    * - `read-only`/`readOnly`: undefined
-   * - `readonly`: undefined
-   * - `required`: undefined
-   * - `value`: undefined
-   * - `optional`: undefined
-   * - `minHeight`: undefined (property only)
-   * - `maxHeight`: undefined (property only)
+   * - `readonly`: Whether the input can be selected but not changed by the user
+   * - `required`: Whether user input is required on the input before form submission
+   * - `value`: Lets you set the current value
+   * - `optional`: Show an icon behind the label indicating the field is optional
    * - `validationMessage`: Returns the validation message if the textarea is invalid, otherwise an empty string (property only) (readonly)
    * - `validity`: Returns the validity state of the textarea (property only) (readonly)
    *
@@ -3030,25 +3104,42 @@ export type CustomElementsSolidJs = {
   >;
 
   /**
+   * Attention is a versatile component for displaying contextual information and messages. It can be used for a wide range of purposes, such as tooltips, callouts, popovers, and highlights.
    *
+   * The component is designed to be anchored to a trigger element, providing contextual information related to that element. It supports various placements and styling options to accommodate different use cases and design needs.
+   *
+   * Note: attention will soon be split into multiple components (tooltip, callout, popover, highlight) at which time this component will be deprecated. For now, use the `tooltip`, `callout`, `popover`, and `highlight` boolean properties to achieve the desired style and behavior.
    *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `show`: undefined
-   * - `placement`: undefined
-   * - `tooltip`: undefined
-   * - `callout`: undefined
-   * - `popover`: undefined
-   * - `highlight`: undefined
-   * - `can-close`/`canClose`: undefined
-   * - `no-arrow`/`noArrow`: undefined
-   * - `distance`: undefined
-   * - `skidding`: undefined
-   * - `flip`: undefined
-   * - `cross-axis`/`crossAxis`: undefined
-   * - `fallback-placements`/`fallbackPlacements`: undefined
+   * - `show`: Controls whether the attention panel is visible.
+   * Set to `true` to show the attention content and `false` to hide it.
+   * - `placement`: Preferred placement relative to the trigger element.
+   * Sets the initial direction for positioning, for example `top`, `right`, `bottom`, or `left` variants.
+   * - `tooltip`: Renders the component with tooltip styling and behavior.
+   * Use for compact, non-modal contextual hints anchored to another element.
+   * - `callout`: Renders the component as an inline callout.
+   * Callout mode is used for always-in-flow informational content instead of floating overlay behavior.
+   * - `popover`: Enables native popover behavior for the attention element.
+   * When enabled, the component uses popover semantics and styling suitable for floating surface UI.
+   * - `highlight`: Renders the component with highlight styling.
+   * Use highlight mode to visually emphasize important contextual information.
+   * - `can-close`/`canClose`: Shows a close button inside the attention component.
+   * Adds an internal dismiss action that lets users close the attention panel.
+   * - `no-arrow`/`noArrow`: Hides the directional arrow of the attention component.
+   * Disable the arrow when the visual connection to the trigger should not be shown.
+   * - `distance`: Distance offset between trigger and attention panel.
+   * Defines the main-axis spacing in pixels from the anchor element.
+   * - `skidding`: Cross-axis offset for fine-grained positioning.
+   * Moves the panel along the cross axis in pixels to adjust alignment with the trigger.
+   * - `flip`: Enables automatic flipping when placement has no space.
+   * Allows the component to choose an alternative side if the preferred placement would overflow.
+   * - `cross-axis`/`crossAxis`: Allows overflow checks on the cross axis when flipping.
+   * Use with `flip` to improve collision handling when space is constrained horizontally or vertically.
+   * - `fallback-placements`/`fallbackPlacements`: Ordered list of fallback placements.
+   * Provides explicit alternative placements to try when `flip` is enabled and the preferred placement does not fit.
    * - `_initialPlacement`: undefined (property only)
    * - `_actualDirection`: undefined (property only)
    *
@@ -3886,29 +3977,40 @@ export type CustomElementsSolidJs = {
   >;
 
   /**
-   * A single line text input element.
+   * A multi-line text input with built-in form validation, auto-resizing, and styling support.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-textfield--docs)
+   * The component automatically handles:
+   *  - Form integration
+   *  - Auto-resizing based on content and row constraints
+   *  - Built-in validation with customizable error messages
+   *  - Accessibility attributes and labeling
    *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `disabled`: undefined
-   * - `invalid`: undefined
-   * - `label`: undefined
-   * - `help-text`/`helpText`: undefined
-   * - `maximum-rows`/`maxRows`: undefined
-   * - `minimum-rows`/`minRows`: undefined
-   * - `name`: undefined
-   * - `placeholder`: undefined
+   * - `disabled`: Keep in mind that using disabled in its current form is an anti-pattern.
+   *
+   * There will always be users who don't understand why an element is disabled, or users who can't even see that it is disabled because of poor lighting conditions or other reasons.
+   *
+   * Please consider more informative alternatives before choosing to use disabled on an element.
+   * - `invalid`: Mark the form field as invalid.
+   *
+   * Make sure to also set a `help-text` to help users fix the validation problem.
+   * - `label`: Either a `label` or an `aria-label` must be provided.
+   * - `help-text`/`helpText`: Use in combination with `invalid` to show as a validation error message,
+   * or on its own to show a help text.
+   * - `maximum-rows`/`maxRows`: Sets the maximum number of text rows before the content starts scrolling.
+   * - `minimum-rows`/`minRows`: Sets the minimum number of text rows the textarea should display
+   * - `name`: The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the input field when submitting the form
+   * - `placeholder`: Set a text that is shown in the textarea when it doesn't have a value.
+   *
+   * Placeholder text should not be used as a substitute for labeling the element with a visible label.
    * - `read-only`/`readOnly`: undefined
-   * - `readonly`: undefined
-   * - `required`: undefined
-   * - `value`: undefined
-   * - `optional`: undefined
-   * - `minHeight`: undefined (property only)
-   * - `maxHeight`: undefined (property only)
+   * - `readonly`: Whether the input can be selected but not changed by the user
+   * - `required`: Whether user input is required on the input before form submission
+   * - `value`: Lets you set the current value
+   * - `optional`: Show an icon behind the label indicating the field is optional
    * - `validationMessage`: Returns the validation message if the textarea is invalid, otherwise an empty string (property only) (readonly)
    * - `validity`: Returns the validity state of the textarea (property only) (readonly)
    *