@utilitywarehouse/hearth-react 0.31.9 → 0.32.1

package/public/llms/components/skeleton.md

@@ -67,8 +67,10 @@ is active, giving users context about what is being loaded.
 
 ## SkeletonBodyText
 
-Use `SkeletonBodyText` when you need a placeholder for body text content. It
-supports multiple lines and the same size props as `BodyText`.
+Use SkeletonBodyText as a loading placeholder for BodyText content, inside
+a Skeleton wrapper. It supports multiple lines via the `lines` prop and the
+same size props as BodyText. For placeholder headings, use SkeletonHeading;
+for arbitrary shapes like images or avatars, use SkeletonBox instead.
 
 ```tsx
 <Skeleton loadingTitle="sizes story">
@@ -82,8 +84,9 @@ supports multiple lines and the same size props as `BodyText`.
 
 ## SkeletonHeading
 
-Use `SkeletonHeading` when you need a placeholder for `Heading` content. It
-supports the same size props as `Heading`.
+Use SkeletonHeading as a loading placeholder for Heading content, inside a
+Skeleton wrapper. It supports the same size props as Heading. For body text
+placeholders, use SkeletonBodyText; for arbitrary shapes, use SkeletonBox.
 
 ```tsx
 <Skeleton loadingTitle="sizes story">
@@ -97,7 +100,9 @@ supports the same size props as `Heading`.
 
 ## SkeletonBox
 
-Use `SkeletonBox` when you need explicit control over shape and dimensions.
+Use SkeletonBox as a loading placeholder for shapes such as images, avatars,
+or other rectangular or circular content, inside a Skeleton wrapper. For
+text placeholders, use SkeletonHeading or SkeletonBodyText instead.
 
 ```tsx
 <Skeleton loadingTitle="blocks story">
@@ -129,53 +134,53 @@ Use `SkeletonBox` when you need explicit control over shape and dimensions.
 - Size
 - ZIndex
 
-| Prop                          | Type                                                                                                                                                                                                       | Default | Description |
-| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ----------- |
-| `display`                     | `Responsive<"none" \| "inline" \| "inline-block" \| "block">`                                                                                                                                              | —       |             |
-| `loadingTitle`                | `string`                                                                                                                                                                                                   | —       |             |
-| `alignSelf`                   | `Responsive<"center" \| "start" \| "end" \| "stretch">`                                                                                                                                                    | —       |             |
-| `borderRadius`                | `Responsive<"none" \| "inherit" \| "xs" \| "sm" \| "md" \| "lg" \| "xl" \| "full">`                                                                                                                        | —       |             |
-| `borderRadiusTopLeftNone`     | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusTopRightNone`    | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusBottomLeftNone`  | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusBottomRightNone` | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusTopNone`         | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusRightNone`       | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusBottomNone`      | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusLeftNone`        | `boolean`                                                                                                                                                                                                  | —       |             |
-| `flex`                        | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `flexBasis`                   | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `flexShrink`                  | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `flexGrow`                    | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridColumnSpan`              | `Responsive<Union<string, "1" \| "2" \| "3" \| "4" \| "5" \| "6" \| "7" \| "8" \| "9" \| "10" \| "11" \| "12">>`                                                                                           | —       |             |
-| `gridArea`                    | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridColumn`                  | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridColumnStart`             | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridColumnEnd`               | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridRow`                     | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridRowStart`                | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridRowEnd`                  | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `margin`                      | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginTop`                   | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginRight`                 | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginBottom`                | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginLeft`                  | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginX`                     | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginY`                     | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `order`                       | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `position`                    | `Responsive<"fixed" \| "static" \| "relative" \| "absolute" \| "sticky">`                                                                                                                                  | —       |             |
-| `inset`                       | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —       |             |
-| `top`                         | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —       |             |
-| `right`                       | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —       |             |
-| `bottom`                      | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —       |             |
-| `left`                        | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —       |             |
-| `width`                       | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `maxWidth`                    | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `minWidth`                    | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `height`                      | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `maxHeight`                   | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `minHeight`                   | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `zIndex`                      | `Responsive<string>`                                                                                                                                                                                       | —       |             |
+| Prop                          | Type                                                                                                                                                                                                       | Default    | Description                                                                                                                                               |
+| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `display`                     | `Responsive<"none" \| "inline" \| "inline-block" \| "block">`                                                                                                                                              | —          | Sets the CSS `display` property. Can be set responsively.                                                                                                 |
+| `loadingTitle`                | `string`                                                                                                                                                                                                   | —          |                                                                                                                                                           |
+| `alignSelf`                   | `Responsive<"center" \| "start" \| "end" \| "stretch">`                                                                                                                                                    | —          | Override the container's `align-items` value for this individual flex or grid item, aligning it along the cross axis. Supports responsive values.         |
+| `borderRadius`                | `Responsive<"none" \| "inherit" \| "xs" \| "sm" \| "md" \| "lg" \| "xl" \| "full">`                                                                                                                        | —          | Sets the responsive `border-radius` CSS property on all corners of the element.                                                                           |
+| `borderRadiusTopLeftNone`     | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the top-left corner.                                                                                                       |
+| `borderRadiusTopRightNone`    | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the top-right corner.                                                                                                      |
+| `borderRadiusBottomLeftNone`  | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the bottom-left corner.                                                                                                    |
+| `borderRadiusBottomRightNone` | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the bottom-right corner.                                                                                                   |
+| `borderRadiusTopNone`         | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the top-left and top-right corners.                                                                                        |
+| `borderRadiusRightNone`       | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the top-right and bottom-right corners.                                                                                    |
+| `borderRadiusBottomNone`      | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the bottom-left and bottom-right corners.                                                                                  |
+| `borderRadiusLeftNone`        | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the top-left and bottom-left corners.                                                                                      |
+| `flex`                        | `Responsive<string>`                                                                                                                                                                                       | —          | Shorthand for `flex-grow`, `flex-shrink` and `flex-basis`, controlling how a flex item grows or shrinks to fit the space available in its flex container. |
+| `flexBasis`                   | `Responsive<string>`                                                                                                                                                                                       | —          | Set the initial main-size of a flex item before remaining space is distributed along the main axis.                                                       |
+| `flexShrink`                  | `Responsive<string>`                                                                                                                                                                                       | `1`        | Set how much a flex item shrinks relative to the rest of the flex items when there isn't enough space in the container.                                   |
+| `flexGrow`                    | `Responsive<string>`                                                                                                                                                                                       | `0`        | Set how much a flex item grows relative to the rest of the flex items when there is extra space in the container.                                         |
+| `gridColumnSpan`              | `Responsive<Union<string, "1" \| "2" \| "3" \| "4" \| "5" \| "6" \| "7" \| "8" \| "9" \| "10" \| "11" \| "12">>`                                                                                           | —          | Set the number of grid columns this item spans. Supports responsive values.                                                                               |
+| `gridArea`                    | `Responsive<string>`                                                                                                                                                                                       | —          | Shorthand for `grid-row-start`, `grid-column-start`, `grid-row-end` and `grid-column-end`, placing an item within a named grid area or by line numbers.   |
+| `gridColumn`                  | `Responsive<string>`                                                                                                                                                                                       | —          | Shorthand for `grid-column-start` and `grid-column-end`, setting an item's size and location within the grid column.                                      |
+| `gridColumnStart`             | `Responsive<string>`                                                                                                                                                                                       | —          | Set an item's starting line within the grid column.                                                                                                       |
+| `gridColumnEnd`               | `Responsive<string>`                                                                                                                                                                                       | —          | Set an item's ending line within the grid column.                                                                                                         |
+| `gridRow`                     | `Responsive<string>`                                                                                                                                                                                       | —          | Shorthand for `grid-row-start` and `grid-row-end`, setting an item's size and location within the grid row.                                               |
+| `gridRowStart`                | `Responsive<string>`                                                                                                                                                                                       | —          | Set an item's starting line within the grid row.                                                                                                          |
+| `gridRowEnd`                  | `Responsive<string>`                                                                                                                                                                                       | —          | Set an item's ending line within the grid row.                                                                                                            |
+| `margin`                      | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin` CSS property on all sides of the element.                                                                                    |
+| `marginTop`                   | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-top` CSS property.                                                                                                            |
+| `marginRight`                 | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-right` CSS property.                                                                                                          |
+| `marginBottom`                | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-bottom` CSS property.                                                                                                         |
+| `marginLeft`                  | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-left` CSS property.                                                                                                           |
+| `marginX`                     | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-left` and `margin-right` CSS properties.                                                                                      |
+| `marginY`                     | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-top` and `margin-bottom` CSS properties.                                                                                      |
+| `order`                       | `Responsive<string>`                                                                                                                                                                                       | —          | Set the order in which the component appears among its flex or grid siblings.                                                                             |
+| `position`                    | `Responsive<"fixed" \| "static" \| "relative" \| "absolute" \| "sticky">`                                                                                                                                  | `'static'` | Set how the component is positioned in the document.                                                                                                      |
+| `inset`                       | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —          | Set the distance of all four edges (top, right, bottom, left) of a positioned component from its containing block.                                        |
+| `top`                         | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —          | Set the distance of the top edge of a positioned component from its containing block.                                                                     |
+| `right`                       | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —          | Set the distance of the right edge of a positioned component from its containing block.                                                                   |
+| `bottom`                      | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —          | Set the distance of the bottom edge of a positioned component from its containing block.                                                                  |
+| `left`                        | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —          | Set the distance of the left edge of a positioned component from its containing block.                                                                    |
+| `width`                       | `Responsive<string>`                                                                                                                                                                                       | —          | Set the width of the component.                                                                                                                           |
+| `maxWidth`                    | `Responsive<string>`                                                                                                                                                                                       | —          | Set the maximum width the component can grow to.                                                                                                          |
+| `minWidth`                    | `Responsive<string>`                                                                                                                                                                                       | —          | Set the minimum width the component can shrink to.                                                                                                        |
+| `height`                      | `Responsive<string>`                                                                                                                                                                                       | —          | Set the height of the component.                                                                                                                          |
+| `maxHeight`                   | `Responsive<string>`                                                                                                                                                                                       | —          | Set the maximum height the component can grow to.                                                                                                         |
+| `minHeight`                   | `Responsive<string>`                                                                                                                                                                                       | —          | Set the minimum height the component can shrink to.                                                                                                       |
+| `zIndex`                      | `Responsive<string>`                                                                                                                                                                                       | —          | Set the stack order of a positioned component relative to its siblings.                                                                                   |
 
 ### SkeletonBox API
 
@@ -191,52 +196,52 @@ This component is based on `div` and supports the following common props:
 - Size
 - ZIndex
 
-| Prop                          | Type                                                                                                                                                                                                       | Default | Description |
-| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ----------- |
-| `display`                     | `Responsive<"none" \| "inline" \| "inline-block" \| "block">`                                                                                                                                              | —       |             |
-| `alignSelf`                   | `Responsive<"center" \| "start" \| "end" \| "stretch">`                                                                                                                                                    | —       |             |
-| `borderRadius`                | `Responsive<"none" \| "inherit" \| "xs" \| "sm" \| "md" \| "lg" \| "xl" \| "full">`                                                                                                                        | —       |             |
-| `borderRadiusTopLeftNone`     | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusTopRightNone`    | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusBottomLeftNone`  | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusBottomRightNone` | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusTopNone`         | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusRightNone`       | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusBottomNone`      | `boolean`                                                                                                                                                                                                  | —       |             |
-| `borderRadiusLeftNone`        | `boolean`                                                                                                                                                                                                  | —       |             |
-| `flex`                        | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `flexBasis`                   | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `flexShrink`                  | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `flexGrow`                    | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridColumnSpan`              | `Responsive<Union<string, "1" \| "2" \| "3" \| "4" \| "5" \| "6" \| "7" \| "8" \| "9" \| "10" \| "11" \| "12">>`                                                                                           | —       |             |
-| `gridArea`                    | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridColumn`                  | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridColumnStart`             | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridColumnEnd`               | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridRow`                     | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridRowStart`                | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `gridRowEnd`                  | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `margin`                      | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginTop`                   | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginRight`                 | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginBottom`                | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginLeft`                  | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginX`                     | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `marginY`                     | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —       |             |
-| `order`                       | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `position`                    | `Responsive<"fixed" \| "static" \| "relative" \| "absolute" \| "sticky">`                                                                                                                                  | —       |             |
-| `inset`                       | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —       |             |
-| `top`                         | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —       |             |
-| `right`                       | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —       |             |
-| `bottom`                      | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —       |             |
-| `left`                        | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —       |             |
-| `width`                       | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `maxWidth`                    | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `minWidth`                    | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `height`                      | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `maxHeight`                   | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `minHeight`                   | `Responsive<string>`                                                                                                                                                                                       | —       |             |
-| `zIndex`                      | `Responsive<string>`                                                                                                                                                                                       | —       |             |
+| Prop                          | Type                                                                                                                                                                                                       | Default    | Description                                                                                                                                               |
+| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `display`                     | `Responsive<"none" \| "inline" \| "inline-block" \| "block">`                                                                                                                                              | —          | Sets the CSS `display` property. Can be set responsively.                                                                                                 |
+| `alignSelf`                   | `Responsive<"center" \| "start" \| "end" \| "stretch">`                                                                                                                                                    | —          | Override the container's `align-items` value for this individual flex or grid item, aligning it along the cross axis. Supports responsive values.         |
+| `borderRadius`                | `Responsive<"none" \| "inherit" \| "xs" \| "sm" \| "md" \| "lg" \| "xl" \| "full">`                                                                                                                        | —          | Sets the responsive `border-radius` CSS property on all corners of the element.                                                                           |
+| `borderRadiusTopLeftNone`     | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the top-left corner.                                                                                                       |
+| `borderRadiusTopRightNone`    | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the top-right corner.                                                                                                      |
+| `borderRadiusBottomLeftNone`  | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the bottom-left corner.                                                                                                    |
+| `borderRadiusBottomRightNone` | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the bottom-right corner.                                                                                                   |
+| `borderRadiusTopNone`         | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the top-left and top-right corners.                                                                                        |
+| `borderRadiusRightNone`       | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the top-right and bottom-right corners.                                                                                    |
+| `borderRadiusBottomNone`      | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the bottom-left and bottom-right corners.                                                                                  |
+| `borderRadiusLeftNone`        | `boolean`                                                                                                                                                                                                  | —          | Removes the border radius from the top-left and bottom-left corners.                                                                                      |
+| `flex`                        | `Responsive<string>`                                                                                                                                                                                       | —          | Shorthand for `flex-grow`, `flex-shrink` and `flex-basis`, controlling how a flex item grows or shrinks to fit the space available in its flex container. |
+| `flexBasis`                   | `Responsive<string>`                                                                                                                                                                                       | —          | Set the initial main-size of a flex item before remaining space is distributed along the main axis.                                                       |
+| `flexShrink`                  | `Responsive<string>`                                                                                                                                                                                       | `1`        | Set how much a flex item shrinks relative to the rest of the flex items when there isn't enough space in the container.                                   |
+| `flexGrow`                    | `Responsive<string>`                                                                                                                                                                                       | `0`        | Set how much a flex item grows relative to the rest of the flex items when there is extra space in the container.                                         |
+| `gridColumnSpan`              | `Responsive<Union<string, "1" \| "2" \| "3" \| "4" \| "5" \| "6" \| "7" \| "8" \| "9" \| "10" \| "11" \| "12">>`                                                                                           | —          | Set the number of grid columns this item spans. Supports responsive values.                                                                               |
+| `gridArea`                    | `Responsive<string>`                                                                                                                                                                                       | —          | Shorthand for `grid-row-start`, `grid-column-start`, `grid-row-end` and `grid-column-end`, placing an item within a named grid area or by line numbers.   |
+| `gridColumn`                  | `Responsive<string>`                                                                                                                                                                                       | —          | Shorthand for `grid-column-start` and `grid-column-end`, setting an item's size and location within the grid column.                                      |
+| `gridColumnStart`             | `Responsive<string>`                                                                                                                                                                                       | —          | Set an item's starting line within the grid column.                                                                                                       |
+| `gridColumnEnd`               | `Responsive<string>`                                                                                                                                                                                       | —          | Set an item's ending line within the grid column.                                                                                                         |
+| `gridRow`                     | `Responsive<string>`                                                                                                                                                                                       | —          | Shorthand for `grid-row-start` and `grid-row-end`, setting an item's size and location within the grid row.                                               |
+| `gridRowStart`                | `Responsive<string>`                                                                                                                                                                                       | —          | Set an item's starting line within the grid row.                                                                                                          |
+| `gridRowEnd`                  | `Responsive<string>`                                                                                                                                                                                       | —          | Set an item's ending line within the grid row.                                                                                                            |
+| `margin`                      | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin` CSS property on all sides of the element.                                                                                    |
+| `marginTop`                   | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-top` CSS property.                                                                                                            |
+| `marginRight`                 | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-right` CSS property.                                                                                                          |
+| `marginBottom`                | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-bottom` CSS property.                                                                                                         |
+| `marginLeft`                  | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-left` CSS property.                                                                                                           |
+| `marginX`                     | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-left` and `margin-right` CSS properties.                                                                                      |
+| `marginY`                     | `Responsive<`var(--h-${string})` \| "auto" \| "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">` | —          | Sets the responsive `margin-top` and `margin-bottom` CSS properties.                                                                                      |
+| `order`                       | `Responsive<string>`                                                                                                                                                                                       | —          | Set the order in which the component appears among its flex or grid siblings.                                                                             |
+| `position`                    | `Responsive<"fixed" \| "static" \| "relative" \| "absolute" \| "sticky">`                                                                                                                                  | `'static'` | Set how the component is positioned in the document.                                                                                                      |
+| `inset`                       | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —          | Set the distance of all four edges (top, right, bottom, left) of a positioned component from its containing block.                                        |
+| `top`                         | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —          | Set the distance of the top edge of a positioned component from its containing block.                                                                     |
+| `right`                       | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —          | Set the distance of the right edge of a positioned component from its containing block.                                                                   |
+| `bottom`                      | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —          | Set the distance of the bottom edge of a positioned component from its containing block.                                                                  |
+| `left`                        | `Responsive<Union<string, "0" \| "25" \| "50" \| "75" \| "100" \| "150" \| "175" \| "200" \| "250" \| "300" \| "350" \| "400" \| "500" \| "600" \| "700" \| "800" \| "900" \| "1000">>`                    | —          | Set the distance of the left edge of a positioned component from its containing block.                                                                    |
+| `width`                       | `Responsive<string>`                                                                                                                                                                                       | —          | Set the width of the component.                                                                                                                           |
+| `maxWidth`                    | `Responsive<string>`                                                                                                                                                                                       | —          | Set the maximum width the component can grow to.                                                                                                          |
+| `minWidth`                    | `Responsive<string>`                                                                                                                                                                                       | —          | Set the minimum width the component can shrink to.                                                                                                        |
+| `height`                      | `Responsive<string>`                                                                                                                                                                                       | —          | Set the height of the component.                                                                                                                          |
+| `maxHeight`                   | `Responsive<string>`                                                                                                                                                                                       | —          | Set the maximum height the component can grow to.                                                                                                         |
+| `minHeight`                   | `Responsive<string>`                                                                                                                                                                                       | —          | Set the minimum height the component can shrink to.                                                                                                       |
+| `zIndex`                      | `Responsive<string>`                                                                                                                                                                                       | —          | Set the stack order of a positioned component relative to its siblings.                                                                                   |
 
 ### SkeletonBodyText API
 

package/public/llms/components/spinner.md

@@ -1,6 +1,9 @@
 # Spinner
 
-Using a Spinner is a common method for indicating that an asynchronous process is ongoing.
+Use Spinner to indicate that an asynchronous process is ongoing, such as
+data loading or a form submission in progress. Set `currentColor` when the
+Spinner is nested inside another component and should inherit its parent's
+colour scheme instead of a fixed `color` value.
 
 ```tsx
 <Flex gap="600">

package/public/llms/components/strong.md

@@ -1,10 +1,11 @@
 # Strong
 
-The `Strong` component is based on the HTML `strong` element and is used to indicate text that is of
-strong importance, seriousness, or urgency. `Strong` should be wrapped in a `BodyText` component,
-and will inherit its styles from its parent. You can also use this component within the `Heading`
-component, however as `Heading` has only one font-weight there will be no visual distinction, and
-so this is discouraged.
+Use Strong to mark up text of strong importance, seriousness, or urgency
+within a larger body of text. It renders a `strong` element by default,
+and should be wrapped in a BodyText component so it inherits its styles.
+It can also be used within Heading, though this is discouraged since
+Heading has only one font-weight and so there's no visual distinction.
+For stress emphasis rather than strong importance, use Em instead.
 
 ```tsx
 <Flex direction="column" gap="100">

package/public/llms/components/switch.md

@@ -1,8 +1,10 @@
 # Switch
 
-`Switch` is used to indicate switching between two opposing options. Switches
-allow users to turn an individual option on or off. They are usually used to
-activate or deactivate a specific setting.
+Use Switch to let users toggle a single setting on or off immediately,
+such as activating or deactivating a feature. For choosing between more
+than two related options, use ToggleGroup or SegmentedControl instead.
+Always provide a `label`, or otherwise label the component for screen
+reader users if the visible `label` prop isn't used.
 
 ```tsx
 <Switch size="sm" label="Switch label" />
@@ -88,12 +90,12 @@ This component is based on the `button` element, and supports the following comm
 
 - Margin
 
-| Prop              | Type                           | Default | Description                                       |
-| ----------------- | ------------------------------ | ------- | ------------------------------------------------- |
-| `label`           | `string`                       | —       | The label for the Switch, describing its purpose. |
-| `defaultChecked`  | `boolean`                      | —       |                                                   |
-| `asChild`         | `boolean`                      | —       |                                                   |
-| `checked`         | `boolean`                      | —       |                                                   |
-| `size`            | `Responsive<"sm" \| "md">`     | —       |                                                   |
-| `required`        | `boolean`                      | —       |                                                   |
-| `onCheckedChange` | `((checked: boolean) => void)` | —       |                                                   |
+| Prop              | Type                           | Default | Description                                                                                                                               |
+| ----------------- | ------------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `label`           | `string`                       | —       | The label for the Switch, describing its purpose.                                                                                         |
+| `defaultChecked`  | `boolean`                      | —       |                                                                                                                                           |
+| `asChild`         | `boolean`                      | `false` | Merges the component's props onto its immediate child instead of rendering its own DOM element, so the child determines the rendered tag. |
+| `checked`         | `boolean`                      | —       |                                                                                                                                           |
+| `size`            | `Responsive<"sm" \| "md">`     | `md`    | Sets the Switch size.                                                                                                                     |
+| `required`        | `boolean`                      | —       |                                                                                                                                           |
+| `onCheckedChange` | `((checked: boolean) => void)` | —       |                                                                                                                                           |

package/public/llms/components/table.md

@@ -1,6 +1,10 @@
 # Table
 
-Use a `Table` to arrange data in rows and columns. They are used to communicate relationships between content and to display references, comparisons, and choices.
+Use Table to arrange data in rows and columns, to communicate relationships
+between content and to display references, comparisons, and choices. Compose
+it with TableHeader, TableBody, TableRow, TableHeaderCell, and TableCell.
+Pass `variant` to wrap the table in a Card container; omit it for a minimal,
+unwrapped table.
 
 - [Usage](#usage)
 - [Variants](#variants)
@@ -187,7 +191,7 @@ This component is based on the `table` element and supports the following common
 | Prop         | Type                                                                       | Default | Description                                                                                         |
 | ------------ | -------------------------------------------------------------------------- | ------- | --------------------------------------------------------------------------------------------------- |
 | `variant`    | `"emphasis" \| "subtle"`                                                   | —       | Sets the visual variant of the table. When undefined, the table is rendered without a Card wrapper. |
-| `pagination` | `ReactElement<TablePaginationProps, string \| JSXElementConstructor<any>>` | —       |                                                                                                     |
+| `pagination` | `ReactElement<TablePaginationProps, string \| JSXElementConstructor<any>>` | —       | Pagination controls rendered below the table, typically a `TablePagination` element.                |
 
 ### TableHeader API
 
@@ -199,10 +203,10 @@ This component is based on the `th` element and supports the following common pr
 
 - Text Align
 
-| Prop        | Type                                        | Default | Description |
-| ----------- | ------------------------------------------- | ------- | ----------- |
-| `row`       | `boolean`                                   | —       |             |
-| `textAlign` | `Responsive<"center" \| "left" \| "right">` | —       |             |
+| Prop        | Type                                        | Default | Description                                                                             |
+| ----------- | ------------------------------------------- | ------- | --------------------------------------------------------------------------------------- |
+| `row`       | `boolean`                                   | —       | Sets `scope="row"` on the cell, marking it as a row header rather than a column header. |
+| `textAlign` | `Responsive<"center" \| "left" \| "right">` | —       | Set the horizontal alignment of text within the component.                              |
 
 ### TableBody API
 

package/public/llms/components/tabs.md

@@ -1,6 +1,8 @@
 # Tabs
 
-Use Tabs to organize and navigate between content sections within the same context without leaving the page.
+Use Tabs to organize and navigate between content sections within the same
+page context, without leaving the page. Must be used together with
+TabsList, Tab, and TabContent.
 
 - [Usage](#usage)
 - [Examples](#examples)
@@ -291,14 +293,14 @@ The `activationMode` prop controls how keyboard focus activates a tab:
 
 ### Performance considerations
 
-The default `automatic` mode provides the best user experience for most cases.
-However, **use `manual` mode when tab panels contain heavily loaded content**
-that might cause lag during automatic activation. This prevents automatic panel
-switching as users navigate with arrow keys, avoiding performance issues.
+The default `automatic` mode works well for most cases. Use `manual` mode when
+tab panels contain heavy content that could cause lag during automatic
+activation, since it stops the panel switching automatically as users navigate
+with arrow keys.
 
-**Prefetching panel data is the preferred solution** over relying on manual
-activation mode. Consider preloading content for adjacent tabs to provide a
-smooth experience while maintaining the benefits of automatic activation.
+Prefetching panel data is usually a better fix than switching to manual mode.
+Preloading content for adjacent tabs keeps panels responsive without giving up
+automatic activation.
 
 ## Accessibility
 
@@ -310,11 +312,11 @@ smooth experience while maintaining the benefits of automatic activation.
 
 ### Tabs
 
-| Prop             | Type                                                               | Default | Description                                                |
-| ---------------- | ------------------------------------------------------------------ | ------- | ---------------------------------------------------------- |
-| `defaultValue`   | `string`                                                           | —       | The value of the tab to select by default, if uncontrolled |
-| `value`          | `string`                                                           | —       | The value for the selected tab, if controlled              |
-| `onValueChange`  | `((value: string) => void)`                                        | —       | A function called when a new tab is selected               |
-| `activationMode` | `"manual" \| "automatic"`                                          | —       | Activation mode for tabs                                   |
-| `size`           | `Responsive<"md" \| "lg">`                                         | —       | Size variant                                               |
-| `spacing`        | `"none" \| "md" \| "lg" \| "2xs" \| "xs" \| "sm" \| "xl" \| "2xl"` | —       |                                                            |
+| Prop             | Type                                                               | Default | Description                                                 |
+| ---------------- | ------------------------------------------------------------------ | ------- | ----------------------------------------------------------- |
+| `defaultValue`   | `string`                                                           | —       | The value of the tab to select by default, if uncontrolled  |
+| `value`          | `string`                                                           | —       | The value for the selected tab, if controlled               |
+| `onValueChange`  | `((value: string) => void)`                                        | —       | A function called when a new tab is selected                |
+| `activationMode` | `"manual" \| "automatic"`                                          | —       | Activation mode for tabs                                    |
+| `size`           | `Responsive<"md" \| "lg">`                                         | —       | Size variant                                                |
+| `spacing`        | `"none" \| "md" \| "lg" \| "2xs" \| "xs" \| "sm" \| "xl" \| "2xl"` | `xl`    | Sets the space between the `TabsList` and the `TabContent`. |

package/public/llms/components/text-area.md

@@ -1,6 +1,8 @@
 # TextArea
 
-`TextArea` is a multi-line text input field that allows users to enter longer text content.
+Use TextArea for a multi-line text input, such as a comment, message, or
+description field. For single-line input, use TextInput instead. A `label`
+is required and should clearly describe the purpose of the field.
 
 ```tsx
 <TextArea {...args} />
@@ -118,17 +120,17 @@ This component is based on the `textarea` element, and supports the following co
 
 - Margin
 
-| Prop               | Type                                             | Default  | Description                                                                    |
-| ------------------ | ------------------------------------------------ | -------- | ------------------------------------------------------------------------------ |
-| `label`            | `string`                                         | —        | The label for the form field, describing its purpose.                          |
-| `value`            | `string`                                         | —        | The controlled value of the TextArea. Must be used with an `onChange` handler. |
-| `labelId`          | `string`                                         | —        |                                                                                |
-| `helperTextId`     | `string`                                         | —        |                                                                                |
-| `validationTextId` | `string`                                         | —        |                                                                                |
-| `labelVariant`     | `"body" \| "heading"`                            | —        | Change the label variant                                                       |
-| `helperText`       | `string`                                         | —        | Optional helper text to provide additional context or instructions.            |
-| `validationText`   | `string`                                         | —        | Text to display when the `validationStatus` is set.                            |
-| `validationStatus` | `"valid" \| "invalid"`                           | —        | Indicates the validation status.                                               |
-| `resize`           | `"none" \| "both" \| "horizontal" \| "vertical"` | `"both"` | Controls the resize behavior of the TextArea.                                  |
-| `minHeight`        | `Responsive<string>`                             | —        | Sets the minimum height of the TextArea.                                       |
-| `maxHeight`        | `Responsive<string>`                             | —        | Sets the maximum height of the TextArea.                                       |
+| Prop               | Type                                             | Default  | Description                                                                                        |
+| ------------------ | ------------------------------------------------ | -------- | -------------------------------------------------------------------------------------------------- |
+| `label`            | `string`                                         | —        | The label for the form field, describing its purpose.                                              |
+| `value`            | `string`                                         | —        | The controlled value of the TextArea. Must be used with an `onChange` handler.                     |
+| `labelId`          | `string`                                         | —        | The `id` of the element rendering the field's label, for `aria-labelledby` association.            |
+| `helperTextId`     | `string`                                         | —        | The `id` of the element rendering the field's helper text, for `aria-describedby` association.     |
+| `validationTextId` | `string`                                         | —        | The `id` of the element rendering the field's validation text, for `aria-describedby` association. |
+| `labelVariant`     | `"body" \| "heading"`                            | —        | Change the label variant                                                                           |
+| `helperText`       | `string`                                         | —        | Optional helper text to provide additional context or instructions.                                |
+| `validationText`   | `string`                                         | —        | Text to display when the `validationStatus` is set.                                                |
+| `validationStatus` | `"valid" \| "invalid"`                           | —        | Indicates the validation status.                                                                   |
+| `resize`           | `"none" \| "both" \| "horizontal" \| "vertical"` | `"both"` | Controls the resize behavior of the TextArea.                                                      |
+| `minHeight`        | `Responsive<string>`                             | —        | Sets the minimum height of the TextArea.                                                           |
+| `maxHeight`        | `Responsive<string>`                             | —        | Sets the maximum height of the TextArea.                                                           |