@terreno/mcp 57.15.0 → 57.16.1

package/dist/docs/versioned/57.15.0/reference/components/areachart.mdx

@@ -0,0 +1,40 @@
+---
+title: "AreaChart"
+description: "Single-series area chart drawn with owned SVG. Press or hover a point for `{label}: {value}`."
+sidebar_label: "AreaChart"
+slug: /reference/components/areachart
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# AreaChart
+
+Single-series area chart drawn with owned SVG. Press or hover a point for `\{label\}: \{value\}`.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component  
+**Props interface:** `AreaChartProps`  
+**Story source:** [`demo/stories/AreaChart.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/AreaChart.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="AreaChart" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `data` | `array` | Yes | Single series of labeled numeric points. |
+| `accessibilityLabel` | `string` |  | Summary announced for the whole chart. |
+| `comparisonData` | `array` |  | Optional previous-period values drawn as a dotted overlay. |
+| `emptyText` | `string` |  | Copy shown when  |
+| `formatValue` | `reflection` |  | Formats the numeric value in tooltips. |
+| `height` | `number` |  | Plot height in pixels. |
+| `legendLabel` | `string` |  | Series name shown under the plot. |
+| `loading` | `boolean` |  | When true, shows a spinner instead of the plot. |
+| `onPeriodPress` | `reflection` |  | Makes  |
+| `periodLabel` | `string` |  | Relative or absolute reporting period shown with  |
+| `series` | `array` |  | Named series. When non-empty, these replace the single  |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |
+| `title` | `string` |  | Optional chart-card title shortcut. |
+| `xTickPolicy` | `union` |  | X-label collision policy.  |

package/dist/docs/versioned/57.15.0/reference/components/askcard.mdx

@@ -0,0 +1,26 @@
+---
+title: "AskCard"
+description: "A question an AI agent asks in the chat transcript. Pending asks show controls; answered asks collapse to a one-line summary. GPTChat renders it for messages with `ask`."
+sidebar_label: "AskCard"
+slug: /reference/components/askcard
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# AskCard
+
+A question an AI agent asks in the chat transcript. Pending asks show controls; answered asks collapse to a one-line summary. GPTChat renders it for messages with `ask`.
+
+**Package:** `@terreno/ui`  
+**Categories:** Pattern  
+**Props interface:** `AskCardProps`  
+**Story source:** [`demo/stories/AskCard.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/AskCard.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="AskCard" />
+
+## Props
+
+_No documented props were extracted from TypeDoc._
+

package/dist/docs/versioned/57.15.0/reference/components/attachmentpreview.mdx

@@ -0,0 +1,26 @@
+---
+title: "AttachmentPreview"
+description: "Thumbnails for attached files with remove."
+sidebar_label: "AttachmentPreview"
+slug: /reference/components/attachmentpreview
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# AttachmentPreview
+
+Thumbnails for attached files with remove.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component  
+**Props interface:** `AttachmentPreviewProps`  
+**Story source:** [`demo/stories/AttachmentPreview.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/AttachmentPreview.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="AttachmentPreview" />
+
+## Props
+
+_No documented props were extracted from TypeDoc._
+

package/dist/docs/versioned/57.15.0/reference/components/badge.mdx

@@ -0,0 +1,39 @@
+---
+title: "Badge"
+description: "Badge is a label that indicates status or importance. Badges should provide quick recognition.\\n"
+sidebar_label: "Badge"
+slug: /reference/components/badge
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# Badge
+
+Badge is a label that indicates status or importance. Badges should provide quick recognition.\n
+
+**Package:** `@terreno/ui`  
+**Categories:** Component  
+**Props interface:** `BadgeProps`  
+**Story source:** [`demo/stories/Badge.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/Badge.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="Badge" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `color` | `union` |  | For the "status" variant, whether the dot uses the bold (saturated) or subtle (light) tone. |
+| `customBackgroundColor` | `string` |  | When status is "custom", determines the badge's background color. |
+| `customBorderColor` | `string` |  | When status is "custom", determines the badge's border color. |
+| `customIconColor` | `keyof TextTheme` |  | When status is "custom", determines the badge's icon color |
+| `customIconName` | `IconName` |  | When status is "custom", determines the badge's icon |
+| `customTextColor` | `string` |  | When status is "custom", determines the badge's text color. |
+| `iconName` | `IconName` |  | The name of the icon to display in the badge. |
+| `maxValue` | `number` |  | The maximum value to display. Used for "numberOnly" variant to display "$\{maxValue\}+" when value is greater than max. |
+| `secondary` | `boolean` |  | If true, the badge will have a secondary style. |
+| `status` | `union` |  | The status of the badge. Determines its color and appearance. |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |
+| `value` | `union` |  | The text or number to display inside the badge. |
+| `variant` | `union` |  | The variant of the badge. "status" renders a small colored dot (no text) used to indicate an active/modified state. |

package/dist/docs/versioned/57.15.0/reference/components/barchart.mdx

@@ -0,0 +1,40 @@
+---
+title: "BarChart"
+description: "Single-series bar chart drawn with owned SVG. Press or hover a bar for `{label}: {value}`. Zero and negative values stay pressable and grow from the zero baseline."
+sidebar_label: "BarChart"
+slug: /reference/components/barchart
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# BarChart
+
+Single-series bar chart drawn with owned SVG. Press or hover a bar for `\{label\}: \{value\}`. Zero and negative values stay pressable and grow from the zero baseline.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component  
+**Props interface:** `BarChartProps`  
+**Story source:** [`demo/stories/BarChart.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/BarChart.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="BarChart" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `data` | `array` | Yes | Single series of labeled numeric points. |
+| `accessibilityLabel` | `string` |  | Summary announced for the whole chart. |
+| `comparisonData` | `array` |  | Optional previous-period values drawn as a dotted overlay. |
+| `emptyText` | `string` |  | Copy shown when  |
+| `formatValue` | `reflection` |  | Formats the numeric value in tooltips. |
+| `height` | `number` |  | Plot height in pixels. |
+| `legendLabel` | `string` |  | Series name shown under the plot. |
+| `loading` | `boolean` |  | When true, shows a spinner instead of the plot. |
+| `onPeriodPress` | `reflection` |  | Makes  |
+| `periodLabel` | `string` |  | Relative or absolute reporting period shown with  |
+| `series` | `array` |  | Named series. When non-empty, these replace the single  |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |
+| `title` | `string` |  | Optional chart-card title shortcut. |
+| `xTickPolicy` | `union` |  | X-label collision policy.  |

package/dist/docs/versioned/57.15.0/reference/components/blocksplayground.mdx

@@ -0,0 +1,37 @@
+---
+title: "BlocksPlayground"
+description: "Paste a whole-reply YAML document and see it render. Presets cover every block type and action kind: All blocks shows one of each, Block type loads one type, Invalid shows the error banner, and Sunday roast is the golden roast reply. Stepper and checklist callbacks run on the device with the same helpers as the server host actions; other actions show a toast."
+sidebar_label: "BlocksPlayground"
+slug: /reference/components/blocksplayground
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# BlocksPlayground
+
+Paste a whole-reply YAML document and see it render. Presets cover every block type and action kind: All blocks shows one of each, Block type loads one type, Invalid shows the error banner, and Sunday roast is the golden roast reply. Stepper and checklist callbacks run on the device with the same helpers as the server host actions; other actions show a toast.
+
+**Package:** `@terreno/ui`  
+**Categories:** Pattern  
+**Props interface:** `BlocksViewProps`  
+**Story source:** [`demo/stories/BlocksPlayground.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/BlocksPlayground.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="BlocksPlayground" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `document` | `union` | Yes | A whole-reply YAML or JSON string, or a document that already parsed. |
+| `allowHtml` | `boolean` |  | When true, an  |
+| `hostActions` | `typeOperator` |  | Names the host will run. A callback outside this list is disabled. Omit to leave callbacks enabled. |
+| `imageHosts` | `typeOperator` |  | Hostnames allowed on https image sources. Empty rejects every https image. |
+| `onAction` | `reflection` |  | Called for reply, open, select, and callback. Select also updates the target chart locally. A copy button writes the clipboard itself and never calls this. |
+| `overrides` | `Record` |  | Block ids replaced in place. The key is the original block id. |
+| `pendingElementIds` | `typeOperator` |  | Element ids whose buttons show a loading state. |
+| `resolveDataset` | `reflection` |  | Loads a  |
+| `resolveImage` | `reflection` |  | Turns a  |
+| `streaming` | `boolean` |  | While a reply is still streaming,  |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |

package/dist/docs/versioned/57.15.0/reference/components/blocksview.mdx

@@ -0,0 +1,37 @@
+---
+title: "BlocksView"
+description: "Renders a whole-reply YAML document of Terreno components. An invalid document shows an error banner and keeps the raw text collapsed."
+sidebar_label: "BlocksView"
+slug: /reference/components/blocksview
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# BlocksView
+
+Renders a whole-reply YAML document of Terreno components. An invalid document shows an error banner and keeps the raw text collapsed.
+
+**Package:** `@terreno/ui`  
+**Categories:** Pattern  
+**Props interface:** `BlocksViewProps`  
+**Story source:** [`demo/stories/BlocksView.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/BlocksView.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="BlocksView" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `document` | `union` | Yes | A whole-reply YAML or JSON string, or a document that already parsed. |
+| `allowHtml` | `boolean` |  | When true, an  |
+| `hostActions` | `typeOperator` |  | Names the host will run. A callback outside this list is disabled. Omit to leave callbacks enabled. |
+| `imageHosts` | `typeOperator` |  | Hostnames allowed on https image sources. Empty rejects every https image. |
+| `onAction` | `reflection` |  | Called for reply, open, select, and callback. Select also updates the target chart locally. A copy button writes the clipboard itself and never calls this. |
+| `overrides` | `Record` |  | Block ids replaced in place. The key is the original block id. |
+| `pendingElementIds` | `typeOperator` |  | Element ids whose buttons show a loading state. |
+| `resolveDataset` | `reflection` |  | Loads a  |
+| `resolveImage` | `reflection` |  | Turns a  |
+| `streaming` | `boolean` |  | While a reply is still streaming,  |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |

package/dist/docs/versioned/57.15.0/reference/components/body.mdx

@@ -0,0 +1,32 @@
+---
+title: "Body"
+description: "Page body primitive with optional scroll and loading spinner."
+sidebar_label: "Body"
+slug: /reference/components/body
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# Body
+
+Page body primitive with optional scroll and loading spinner.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component  
+**Props interface:** `BodyProps`  
+**Story source:** [`demo/stories/Body.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/Body.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="Body" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `avoidKeyboard` | `boolean` |  |  |
+| `children` | `ReactNode` |  |  |
+| `height` | `union` |  |  |
+| `loading` | `boolean` |  |  |
+| `padding` | `UnsignedUpTo12` |  |  |
+| `scroll` | `boolean` |  |  |

package/dist/docs/versioned/57.15.0/reference/components/boolean-field.mdx

@@ -0,0 +1,36 @@
+---
+title: "Boolean field"
+description: "Use the Boolean field for single cell options that can be turned on and off only. Also called 'toggle fields' and 'switch fields'."
+sidebar_label: "Boolean field"
+slug: /reference/components/boolean-field
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# Boolean field
+
+Use the Boolean field for single cell options that can be turned on and off only. Also called 'toggle fields' and 'switch fields'.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component, Form  
+**Props interface:** `BooleanFieldProps`  
+**Story source:** [`demo/stories/Booleanfield.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/Booleanfield.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="Boolean field" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `onChange` | `reflection` | Yes |  |
+| `value` | `boolean` | Yes |  |
+| `disabled` | `boolean` |  |  |
+| `disabledHelperText` | `string` |  |  |
+| `errorText` | `string` |  |  |
+| `helperText` | `string` |  |  |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |
+| `testIDs` | `FieldTestIDs` |  |  |
+| `title` | `string` |  |  |
+| `variant` | `union` |  |  |

package/dist/docs/versioned/57.15.0/reference/components/button.mdx

@@ -0,0 +1,47 @@
+---
+title: "Button"
+description: "Buttons allow users to perform actions within a surface. They can be used alone for immediate action. Also known as CTA (call to action)."
+sidebar_label: "Button"
+slug: /reference/components/button
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# Button
+
+Buttons allow users to perform actions within a surface. They can be used alone for immediate action. Also known as CTA (call to action).
+
+**Package:** `@terreno/ui`  
+**Categories:** Component  
+**Props interface:** `ButtonProps`  
+**Story source:** [`demo/stories/Button.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/Button.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="Button" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `onClick` | `reflection` | Yes | The function to call when the button is clicked. |
+| `text` | `string` | Yes | The text content of the button. |
+| `accessibilityLabel` | `string` |  | Accessible name. Defaults to  |
+| `confirmationText` | `string` |  | The text content of the confirmation modal. |
+| `disabled` | `boolean` |  | If true, the button will be disabled. |
+| `fullWidth` | `boolean` |  | If true, the button will take the full width of its container. |
+| `iconName` | `IconName` |  | The name of the icon to display in the button. |
+| `iconPosition` | `union` |  | The position of the icon within the button. |
+| `loading` | `boolean` |  | If true, a loading spinner will be shown in the button. |
+| `modalSubTitle` | `string` |  | The subtitle of the confirmation modal. |
+| `modalTitle` | `string` |  | The title of the confirmation modal. |
+| `pressAnimation` | `ButtonPressAnimation` |  | The press animation to use when the button is touched. |
+| `size` | `union` |  | The size of the button. |
+| `state` | `union` |  | Controls the button's interaction state. Use Default for standard button appearance and Active to indicate a selected or currently engaged state. |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |
+| `tooltipIdealPosition` | `TooltipPosition` |  | The position of the tooltip. |
+| `tooltipIncludeArrow` | `boolean` |  | Include an arrow in the tooltip. Pointing to the button. |
+| `tooltipText` | `string` |  | The text content of the tooltip. |
+| `variant` | `union` |  | The type of the button, which determines its style. |
+| `withConfirmation` | `boolean` |  | If true, a confirmation modal will be shown before the onClick action. |
+| `wrapText` | `boolean` |  | If true, the button is never wider than its container, and a label that does not fit wraps onto centered lines while the button grows taller. A small button grows from its 28px height. If false, the label stays on one line. |

package/dist/docs/versioned/57.15.0/reference/components/card.mdx

@@ -0,0 +1,26 @@
+---
+title: "Card"
+description: "A card serves as a surface for information. It helps organize and highlight information while providing visual hierarchy."
+sidebar_label: "Card"
+slug: /reference/components/card
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# Card
+
+A card serves as a surface for information. It helps organize and highlight information while providing visual hierarchy. Card renders the container and display surfaces; see EditableCard for a card that summarizes saved information the user can edit.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component  
+**Props interface:** `CardProps`  
+**Story source:** [`demo/stories/Card.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/Card.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="Card" />
+
+## Props
+
+_No documented props were extracted from TypeDoc._
+

package/dist/docs/versioned/57.15.0/reference/components/chartcard.mdx

@@ -0,0 +1,32 @@
+---
+title: "ChartCard"
+description: "Card chrome for a chart or table: title, optional filter summary, and optional period badge action."
+sidebar_label: "ChartCard"
+slug: /reference/components/chartcard
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# ChartCard
+
+Card chrome for a chart or table: title, optional filter summary, and optional period badge action.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component  
+**Props interface:** `ChartCardProps`  
+**Story source:** [`demo/stories/ChartCard.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/ChartCard.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="ChartCard" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | Yes |  |
+| `title` | `string` | Yes | Card heading. |
+| `filterSummary` | `string` |  | Optional context shown below the title row. |
+| `onPeriodPress` | `reflection` |  | Makes the period badge pressable when provided. |
+| `periodLabel` | `string` |  | Date range or relative period shown in the header. |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |

package/dist/docs/versioned/57.15.0/reference/components/checkbox.mdx

@@ -0,0 +1,30 @@
+---
+title: "CheckBox"
+description: "CheckBox is used for multiple choice selection."
+sidebar_label: "CheckBox"
+slug: /reference/components/checkbox
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# CheckBox
+
+CheckBox is used for multiple choice selection. They are independent of each other in a list, and therefore, different from RadioButton, one selection does not affect other checkboxes in the same list.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component, Form  
+**Props interface:** `CheckBoxProps`  
+**Story source:** [`demo/stories/CheckBox.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/CheckBox.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="CheckBox" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `selected` | `boolean` | Yes | If true, the checkbox is selected. |
+| `bgColor` | `union` |  | The background color of the checkbox. |
+| `size` | `union` |  | The size of the checkbox. |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |

package/dist/docs/versioned/57.15.0/reference/components/conflictsheet.mdx

@@ -0,0 +1,26 @@
+---
+title: "ConflictSheet"
+description: "Modal for choosing local vs server versions of a sync conflict."
+sidebar_label: "ConflictSheet"
+slug: /reference/components/conflictsheet
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# ConflictSheet
+
+Modal for choosing local vs server versions of a sync conflict.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component  
+**Props interface:** `ConflictSheetProps`  
+**Story source:** [`demo/stories/ConflictSheet.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/ConflictSheet.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="ConflictSheet" />
+
+## Props
+
+_No documented props were extracted from TypeDoc._
+

package/dist/docs/versioned/57.15.0/reference/components/consentformscreen.mdx

@@ -0,0 +1,26 @@
+---
+title: "ConsentFormScreen"
+description: "The consent form screen renders consent content, required acknowledgements, signatures, and actions."
+sidebar_label: "ConsentFormScreen"
+slug: /reference/components/consentformscreen
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# ConsentFormScreen
+
+The consent form screen renders consent content, required acknowledgements, signatures, and actions.
+
+**Package:** `@terreno/ui`  
+**Categories:** Pattern, Form  
+**Props interface:** `ConsentFormScreenProps`  
+**Story source:** [`demo/stories/ConsentFormScreen.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/ConsentFormScreen.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="ConsentFormScreen" />
+
+## Props
+
+_No documented props were extracted from TypeDoc._
+

package/dist/docs/versioned/57.15.0/reference/components/custom-select-field.mdx

@@ -0,0 +1,37 @@
+---
+title: "Custom Select Field"
+description: "Displays a list of options using the browser’s native select and includes a custom option that renders a text field when selected and allows user to input value not included in predefined options."
+sidebar_label: "Custom Select Field"
+slug: /reference/components/custom-select-field
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# Custom Select Field
+
+Displays a list of options using the browser’s native select and includes a custom option that renders a text field when selected and allows user to input value not included in predefined options.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component, Form  
+**Props interface:** `CustomSelectFieldProps`  
+**Story source:** [`demo/stories/CustomSelectField.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/CustomSelectField.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="Custom Select Field" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `onChange` | `reflection` | Yes | The function to call when the custom select field value changes. |
+| `options` | `array` | Yes | The options available for selection in the select field. Each option should have a label and a value. |
+| `value` | `union` | Yes | The current value of the custom select field. |
+| `disabled` | `boolean` |  | If true, the select field will be disabled. |
+| `disableSearch` | `boolean` |  | When true, hides the type-to-filter search UI. Search is enabled by default. |
+| `errorText` | `string` |  | The error text to display if there is an error. |
+| `helperText` | `string` |  | The helper text to display below the select field. |
+| `placeholder` | `string` |  | The placeholder text to display when no option is selected. |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |
+| `testIDs` | `FieldTestIDs` |  |  |
+| `title` | `string` |  | The title of the custom select field. |

package/dist/docs/versioned/57.15.0/reference/components/dashboardgrid.mdx

@@ -0,0 +1,30 @@
+---
+title: "DashboardGrid"
+description: "Responsive wrapping grid for dashboard tiles. Callers supply Card children; default columns are `{sm: 1, md: 2, lg: 3}`."
+sidebar_label: "DashboardGrid"
+slug: /reference/components/dashboardgrid
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# DashboardGrid
+
+Responsive wrapping grid for dashboard tiles. Callers supply Card children; default columns are `\{sm: 1, md: 2, lg: 3\}`.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component  
+**Props interface:** `DashboardGridProps`  
+**Story source:** [`demo/stories/DashboardGrid.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/DashboardGrid.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="DashboardGrid" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` |  |  |
+| `columns` | `reflection` |  | Column counts by breakpoint. Defaults to  |
+| `gap` | `UnsignedUpTo12` |  |  |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |

package/dist/docs/versioned/57.15.0/reference/components/dashboardgriditem.mdx

@@ -0,0 +1,29 @@
+---
+title: "DashboardGridItem"
+description: "Optional child of DashboardGrid that occupies more than one column. Span is per breakpoint and plain children stay one column."
+sidebar_label: "DashboardGridItem"
+slug: /reference/components/dashboardgriditem
+---
+
+import ComponentDemo from '@site/src/components/ComponentDemo';
+
+# DashboardGridItem
+
+Optional child of DashboardGrid that occupies more than one column. Span is per breakpoint and plain children stay one column.
+
+**Package:** `@terreno/ui`  
+**Categories:** Component  
+**Props interface:** `DashboardGridItemProps`  
+**Story source:** [`demo/stories/DashboardGridItem.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/DashboardGridItem.stories.tsx)
+
+## Live demo
+
+<ComponentDemo name="DashboardGridItem" />
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` |  |  |
+| `span` | `reflection` |  | Number of grid columns occupied at each breakpoint. Defaults to one. |
+| `testID` | `string` |  | Root test id for the primary interactive element or container. |