@flood-md/agent 0.2.11 → 0.2.12

package/DESIGN.md

@@ -1,4 +1,4 @@
-# Flood design system · 0.2.11
+# Flood design system · 0.2.12
 
 ListBox owns native required validation for accepted selection. Use its
 description/message/status props rather than duplicating feedback markup. Visual

package/dist/catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "0.2.11",
+  "version": "0.2.12",
   "groups": [
     {
       "id": "foundations",
@@ -198,8 +198,8 @@
       ],
       "status": "available",
       "file": "dist/materials/component-app-shell.md",
-      "bytes": 1829,
-      "sha256": "f4f0a237e29bc9f217e95b65ead941a2ce3b3bf1d50d5e66ef732d9c0968f2c4",
+      "bytes": 2066,
+      "sha256": "436e8792d15ebe8e59445a2c19fd2b826c6291c1b6a40689d6fde8d00eb46ea5",
       "links": [
         "component:app-top-bar",
         "component:flood-root",
@@ -746,8 +746,8 @@
       ],
       "status": "available",
       "file": "dist/materials/component-collection-toolbar.md",
-      "bytes": 4070,
-      "sha256": "346f9dcfa377f46b1e6bf16c568128ff968e0be78087db49e51ed2a15c78aa44",
+      "bytes": 4089,
+      "sha256": "c9c74bb4ce0d5390e92b7985b5c82f84cb7fc88f20d61ede65197e4375971d4c",
       "links": [
         "component:flood-root",
         "workflow:accessibility",
@@ -1059,14 +1059,14 @@
       "id": "component:data-table",
       "kind": "component",
       "name": "DataTable",
-      "description": "A native data table with local sorting, page-scoped selection and pagination.",
+      "description": "A native data table with sorting, selection, pagination, column layout and expandable records.",
       "groups": [
         "data-feedback"
       ],
       "status": "available",
       "file": "dist/materials/component-data-table.md",
-      "bytes": 3704,
-      "sha256": "168c77e6ff17ea57d596b3653b6ebaa9dbc4e90dee9a7ccd61bd525744f5e695",
+      "bytes": 5366,
+      "sha256": "e2156e0a9c054b92ecbd49b5be1aea735eaf5d847bd89b179ee4da20d694794c",
       "links": [
         "component:flood-root",
         "workflow:accessibility",
@@ -1386,8 +1386,8 @@
       ],
       "status": "available",
       "file": "dist/materials/component-editable.md",
-      "bytes": 2193,
-      "sha256": "597fe441be8199c7c812c797be2a77b3baa314afb34970eeacb04624fe3d25cc",
+      "bytes": 2456,
+      "sha256": "139a730b16527729c3d40f03b41a79c4c3058efaa5cadcc30bb0206c2f63f99b",
       "links": [
         "component:flood-root",
         "workflow:accessibility",
@@ -1761,8 +1761,8 @@
       ],
       "status": "available",
       "file": "dist/materials/component-heading.md",
-      "bytes": 1063,
-      "sha256": "0d5b400db7ed3b545302aa2bac30910a095859fe4abd13c5b388250ab544f647",
+      "bytes": 1074,
+      "sha256": "51217479eacecdc2fe0aa5585577018bd0b480adc9a030a0d15d32b07c5811d7",
       "links": [
         "component:flood-root",
         "component:stack",
@@ -2805,8 +2805,8 @@
       ],
       "status": "available",
       "file": "dist/materials/component-section.md",
-      "bytes": 1729,
-      "sha256": "5aa30e3f5314a6a27e7bd389b946513a3016293f96d094899b6b7f684b54f1de",
+      "bytes": 1706,
+      "sha256": "61d76e4edbdcf24400ced3c6b75ada1174f396ec48afa81b8ccf33a7034f4dcd",
       "links": [
         "component:flood-root",
         "component:text",
@@ -2879,6 +2879,35 @@
       ],
       "requires": []
     },
+    {
+      "id": "component:sheet",
+      "kind": "component",
+      "name": "Sheet",
+      "description": "A bottom-aligned modal for short tasks, navigation and touch-friendly choices.",
+      "groups": [
+        "interaction"
+      ],
+      "status": "available",
+      "file": "dist/materials/component-sheet.md",
+      "bytes": 1966,
+      "sha256": "a862eaf138ceff617d01bcec1ee4bdc1509ae421bd58200d8a8959849655662d",
+      "links": [
+        "component:button",
+        "component:field",
+        "component:flood-root",
+        "component:input",
+        "workflow:accessibility",
+        "workflow:composition",
+        "workflow:foundations",
+        "workflow:hierarchy",
+        "workflow:interface-content",
+        "workflow:motion",
+        "workflow:overlays",
+        "workflow:spacing",
+        "workflow:verification"
+      ],
+      "requires": []
+    },
     {
       "id": "component:sidebar",
       "kind": "component",
@@ -2982,6 +3011,31 @@
       ],
       "requires": []
     },
+    {
+      "id": "component:sparkline",
+      "kind": "component",
+      "name": "Sparkline",
+      "description": "A compact line or area chart for trends in a table cell, list or metric.",
+      "groups": [
+        "data-feedback"
+      ],
+      "status": "available",
+      "file": "dist/materials/component-sparkline.md",
+      "bytes": 1583,
+      "sha256": "e763920bd0249f9538f6488d1e50b0bf99f562fd5b9c63afeaa5e879eb6287dd",
+      "links": [
+        "component:flood-root",
+        "workflow:accessibility",
+        "workflow:composition",
+        "workflow:data-display",
+        "workflow:foundations",
+        "workflow:interface-content",
+        "workflow:motion",
+        "workflow:spacing",
+        "workflow:verification"
+      ],
+      "requires": []
+    },
     {
       "id": "component:spinner",
       "kind": "component",
@@ -3173,8 +3227,8 @@
       ],
       "status": "available",
       "file": "dist/materials/component-table.md",
-      "bytes": 1966,
-      "sha256": "0ab770f72d7b8b355a97e1e4e5b887cc9a4160ab39d2d82b1b792decf0009e8d",
+      "bytes": 2073,
+      "sha256": "4c4e1f868d97181377372a6d66c2219d1629ef08f88def6f6fcaad9fb48f600b",
       "links": [
         "component:flood-root",
         "workflow:accessibility",
@@ -3481,8 +3535,8 @@
       ],
       "status": "available",
       "file": "dist/materials/component-toolbar.md",
-      "bytes": 1965,
-      "sha256": "da9796228143a59f6a0c3dd197aa273104ea2797444e533bcfde484dfadb21a8",
+      "bytes": 2144,
+      "sha256": "f68ac9be4923723ec625f27137a2980ae56e5f823ffbc1e3e588d42b7a7ffa7c",
       "links": [
         "component:button",
         "component:flood-root",
@@ -3673,7 +3727,7 @@
       "status": "available",
       "file": "dist/materials/guide-agent-knowledge.md",
       "bytes": 5231,
-      "sha256": "132be327ad1a3f3e7c39a956f61ec4d270181050781cb34b8768467376a1feaf",
+      "sha256": "2078cd00202a091236d0f1eabd50bd050ff071799228f0295b8ada803f0219ad",
       "links": [],
       "requires": []
     },
@@ -3704,7 +3758,7 @@
       "status": "available",
       "file": "DESIGN.md",
       "bytes": 28249,
-      "sha256": "66bb49be55fd6995930a8eee0f7018ebc59fb6034e481eac8be931ada27b12a2",
+      "sha256": "885af67a21fa8607f4db97c2c0d5b3ed1628cbc6009f89df158b39da7fdbb245",
       "links": [
         "component:button",
         "component:field",
@@ -3779,7 +3833,7 @@
       "status": "available",
       "file": "dist/materials/guide-foundations.md",
       "bytes": 15084,
-      "sha256": "6cafde8aa6c7bd96435691cfa00d213026c04ab61555c26fbc2782636a98ff5f",
+      "sha256": "27896d8d3459ab235adbdd43805ead352887b8c159c425441bbcacd813446616",
       "links": [],
       "requires": []
     },
@@ -3794,7 +3848,7 @@
       "status": "available",
       "file": "dist/materials/guide-installation.md",
       "bytes": 3356,
-      "sha256": "82b1d209dd0d9ac8938f5a7df43e1d9ff177f3a4724cff4a50d44018d88c89d5",
+      "sha256": "0fe3d391efa460494fd8ce34f1b8953cdb30efda386d747aa9d8ce71d4e4c100",
       "links": [
         "component:button",
         "component:flood-root",
@@ -3868,8 +3922,8 @@
       ],
       "status": "available",
       "file": "dist/materials/guide-motion.md",
-      "bytes": 6769,
-      "sha256": "860fc1caf3b94116e6f31b8219db0eeff001806be6fff675d80ce8940cce7e61",
+      "bytes": 7078,
+      "sha256": "d2dd48d3225dca550ba2408f221faefc310a6a0dfee6e035075391f60cfb91e0",
       "links": [],
       "requires": []
     },
@@ -3950,8 +4004,8 @@
       ],
       "status": "available",
       "file": "dist/materials/recipe-collection-views.md",
-      "bytes": 44787,
-      "sha256": "b47b2bd5bd6ff91d28a671ef8381b2423a152e16ae29f3c634c9675ef5618550",
+      "bytes": 46259,
+      "sha256": "29e18eea0073391c890dedb2c5710f9dba07e3c325a189e37e0a6f7388cdaaca",
       "links": [
         "component:alert",
         "component:alert-dialog",
@@ -3975,8 +4029,10 @@
         "component:select",
         "component:stack",
         "component:status-indicator",
+        "component:surface",
         "component:tabs",
         "component:tag",
+        "component:toast-region",
         "component:visually-hidden"
       ],
       "requires": [
@@ -4136,8 +4192,8 @@
       ],
       "status": "available",
       "file": "dist/materials/recipe-record-management.md",
-      "bytes": 14092,
-      "sha256": "1ae165bfc9389fc3349dcd2d3168f0f3688e2487d417854a5c509e24013b78e8",
+      "bytes": 14645,
+      "sha256": "231825c073a619d4b9e8c95618bd6c7d8e01e285bfb0355f3030d9d32a663b3a",
       "links": [
         "component:alert",
         "component:button",
@@ -4392,8 +4448,8 @@
       ],
       "status": "available",
       "file": "references/component-families.md",
-      "bytes": 9305,
-      "sha256": "7fb761c31a7b8ddae922396c0156e3369b04a4a464bf4ac952c5938257fba10e",
+      "bytes": 9535,
+      "sha256": "030673fa301a7ca0a9075cc31cb9eeee37ebea3052df4e755f96d59079b1116e",
       "links": [],
       "requires": [
         "workflow:composition",
@@ -4412,8 +4468,8 @@
       ],
       "status": "available",
       "file": "references/composition.md",
-      "bytes": 20787,
-      "sha256": "7b6c35335a2a87216690010bb01c821a7469708cf9f2b0b2f8263faa956cf730",
+      "bytes": 21577,
+      "sha256": "073ac0ade4d7351dca2afb276417a03130f4324663cff6960375afe0c4bb66aa",
       "links": [
         "reference:spacing",
         "reference:verification",
@@ -4531,8 +4587,8 @@
       ],
       "status": "available",
       "file": "rules.json",
-      "bytes": 29571,
-      "sha256": "836a2e29497715c34d81a32f5a8291c70b225ff6ea055029f8f0fcafaa06c591",
+      "bytes": 30084,
+      "sha256": "e3d494e6c092ceafd3b1aee4803a0f964887d5b35ac9880bc0254a99e1326564",
       "links": [],
       "requires": [],
       "installedTarget": "flood/rules.json"
@@ -8474,8 +8530,8 @@
       ],
       "status": "available",
       "file": "references/flood-data-display/SKILL.md",
-      "bytes": 12222,
-      "sha256": "a7f71686b7c4389ba8065f59f3c83fde4f5b2a5502699d36d7156f903b42b784",
+      "bytes": 14375,
+      "sha256": "203caa82726e1823a8a7b25cb70d4b10aef31b299e67d19f46f22eaf7a9dd1ab",
       "links": [
         "workflow:composition",
         "workflow:records"
@@ -8495,8 +8551,8 @@
       ],
       "status": "available",
       "file": "references/flood-feedback/SKILL.md",
-      "bytes": 4978,
-      "sha256": "875a1475d1f418aa511052cdedffb5fd2bcd05ef5ab83f522b202e9643908145",
+      "bytes": 5728,
+      "sha256": "1eb153c0a84ef1ebea0361e5d40227ec6273ee8b54ffdbb2c8fa46efd330bf16",
       "links": [
         "reference:accessibility",
         "workflow:records"
@@ -8556,8 +8612,8 @@
       ],
       "status": "available",
       "file": "references/flood-hierarchy/SKILL.md",
-      "bytes": 6113,
-      "sha256": "c86d1d287b6ed9a819020885c2693d466e53c7ade156c18c54c07f3f15e39f9a",
+      "bytes": 6417,
+      "sha256": "a2c271533b6a1890b14d470191800514214cf03ca2eefe67f91b9dfed6225ddc",
       "links": [
         "reference:spacing",
         "workflow:records"
@@ -8578,8 +8634,8 @@
       ],
       "status": "available",
       "file": "references/flood-interface-content/SKILL.md",
-      "bytes": 9710,
-      "sha256": "da8ed5e8e87e1d68b6f489a6bdaab496ac2c1d9f6d6b14c1ac539088acb14414",
+      "bytes": 10160,
+      "sha256": "bf8ea4bc6d33c546916f7d0d08be238c1dbc9d6feebc7d4ed5d128c8f6055b71",
       "links": [
         "reference:interface-content-examples",
         "workflow:records"
@@ -8598,8 +8654,8 @@
       ],
       "status": "available",
       "file": "references/flood-motion/SKILL.md",
-      "bytes": 3116,
-      "sha256": "08903398f54e877c5e8d0f83e2e57c854f48c757f451b6f8f13c912b3b94e8b1",
+      "bytes": 3333,
+      "sha256": "ae13d4d4324b6951d9c32843561138c895534a2f0de15b4c9960ada8d32e1456",
       "links": [],
       "requires": [],
       "installedTarget": ".agents/skills/flood-ui/references/flood-motion/SKILL.md"
@@ -8632,8 +8688,8 @@
       ],
       "status": "available",
       "file": "references/flood-overlays/SKILL.md",
-      "bytes": 5105,
-      "sha256": "e1616524155019a6334fd32112ebec1af33104ff80a5f4e14b8322749d2e0f1a",
+      "bytes": 5485,
+      "sha256": "edbf696378b7ffb321bc0bfc590bb206c3f1b3b8e01585686360411a87feb6b2",
       "links": [
         "reference:accessibility",
         "workflow:hierarchy"
@@ -8654,8 +8710,8 @@
       ],
       "status": "available",
       "file": "references/flood-records/SKILL.md",
-      "bytes": 8961,
-      "sha256": "efa9c64d084224195444a88e982429c232a7286c5f44597013d7b939e1aa79ad",
+      "bytes": 10423,
+      "sha256": "2bcd77da6b49540f280aba9913bd3b59e41ba0764b3dc3967f4289a140f63a30",
       "links": [
         "reference:record-decisions",
         "workflow:hierarchy",
@@ -8679,8 +8735,8 @@
       ],
       "status": "available",
       "file": "references/flood-spacing/SKILL.md",
-      "bytes": 5920,
-      "sha256": "84da37f01b968a66ed28567b46a7631a6d2d6772460a407946a8778d59e78b10",
+      "bytes": 6418,
+      "sha256": "1f30cc0c8a0016ea831579fae228c02dd6e2e3eb696a8f0ed8f9dfad7f4e8e4b",
       "links": [
         "reference:spacing",
         "workflow:hierarchy"

package/dist/materials/component-app-shell.md

@@ -24,6 +24,7 @@ export function Example() {
 ## Design notes
 
 - Content scrolling keeps navigation, top bar and footer outside the work scrollport. Use scroll="page" for a document that scrolls as a whole.
+- Content mode uses Flood ScrollArea. Set scrollContentInset="none" when existing workspace padding clears the overlay rails and the content width needs to stay fixed.
 - Supply Sidebar for docked navigation. Set navigationDrawer with a shell-width threshold and Drawer content to swap automatically. Share accepted route and branch state between the two presentations.
 - Use mainAs="section" only when embedding a shell inside an existing main landmark.
 
@@ -43,5 +44,6 @@ export function Example() {
 | `mainRef` | `Ref<HTMLElement>` | `—` |
 | `scrollLabel` | `string` | `—` |
 | `scrollOrientation` | `ScrollAreaProps["orientation"]` | `—` |
+| `scrollContentInset` | `ScrollAreaProps["contentInset"]` | `—` |
 | `skipLabel` | `string` | `—` |
 | `Native HTML props` | `HTMLAttributes<HTMLDivElement>` | `Forwarded` |

package/dist/materials/component-collection-toolbar.md

@@ -30,7 +30,7 @@ export function Example() {
 - filterContent supplies the existing filter editor, including FilterGroup or a project-specific form. The host retains draft validation, Apply/Cancel, query evaluation, persistence and saved views. filtersOpen/onFiltersOpenChange optionally control the existing Popover; filterPanelRef and filterPanelClassName support real panel focus and sizing.
 - Clear keeps its space immediately before the right-anchored Filters trigger while inactive. Removing a summary or clearing returns focus to Filters, or Search when no panel exists. Filter disclosure is omitted when no filterContent is supplied.
 - quickFilters is an optional slot for at most two task-important properties; larger property sets belong inside filterContent. The host owns the threshold and slot behavior. Supply canClear when active state is not represented by searchValue/appliedFilters, such as controls in that slot.
-- Search, accepted summaries and commands share a responsive row; long summaries can wrap without clipping and the filter action remains at the logical end. Saved-view selectors and save/rename actions stay outside this query row.
+- Search, accepted summaries and commands share a responsive row. The actions slot places table commands, such as Columns, next to Filters. Saved-view selectors and save/rename actions stay outside this query row.
 - controlSize defaults to sm; action/field sizes and chip typography follow the shared family. disabled applies to the complete fieldset, including native quick-filter controls and panel descendants. Labels and summaries remain host-localizable.
 
 ## API reference
@@ -54,6 +54,7 @@ export function Example() {
 | `appliedFiltersLabel` | `string` | `—` |
 | `summaryPrefix` | `ReactNode` | `—` |
 | `quickFilters` | `ReactNode` | `—` |
+| `actions` | `ReactNode` | `—` |
 | `filterContent` | `ReactNode` | `—` |
 | `filtersLabel` | `string` | `—` |
 | `filterTitle` | `string` | `—` |

package/dist/materials/component-data-table.md

@@ -1,6 +1,6 @@
 # DataTable
 
-A native data table with local sorting, page-scoped selection and pagination.
+A native data table with sorting, selection, pagination, column layout and expandable records.
 
 Connect Flood once using [the installation guide](https://flood.md/docs/installation). Then import the components you use; no per-component add command is needed.
 
@@ -25,10 +25,15 @@ export function Example() {
 
 ## Design notes
 
-- Supply the complete client collection; remote/server pagination and virtualization are not part of this API.
+- Supply the complete collection in client mode. Server mode accepts one page with controlled page and totalRows, and controlled sort when enabled.
+- Offer Columns when users need different subsets of fields. Pass its toolbar control into CollectionToolbar.actions alongside search and filters. Reset restores initial visibility and widths.
+- Opt in to resizable columns and logical start/end pinning for wider tables. Persist width and visibility preferences by column ID.
+- Keep headers short and use the optional column unit badge for values such as USD or kg. A constrained header remains on one line with its full accessible name.
+- Use expandedContent for short related details and a captioned Flood Table for nested line items. Use Sparkline for compact trend cells with a shared domain when comparing magnitudes.
 - Select all affects selectable rows on the current page and preserves selection on other pages.
 - Use sortValues for rich React cells; missing values sort last in both directions.
 - Use showResults={false} to omit a redundant result range. Selection feedback and pagination remain, and the footer disappears when it has no other content.
+- Use showSelection={false} when a floating BulkActionBar displays the selected count. The table retains its accessible selection status.
 - Set column.numeric for comparable amounts and quantities. Header and cells align to the logical end with tabular figures, while explicit align takes precedence. Keep numeric identifiers as text and provide raw sortValues for localized amounts.
 - For in-place record details, supply row.primaryAction with the identity column, title, optional description and native button props. Pointer activation extends across the row, while keyboard focus lands on the title button. Secondary controls retain their own behavior.
 - Use toolbar for the heading and filters that share the table surface. Set inset to roomy for a shared outer inset on toolbar, table cells and footer.
@@ -38,16 +43,28 @@ export function Example() {
 
 | Prop | Values | Default |
 | --- | --- | --- |
-| `toolbar` | `ReactNode` | `—` |
+| `toolbar` | `ReactNode \| (controls: { columns: ReactNode }) => ReactNode` | `—` |
 | `inset` | `"standard" \| "roomy"` | `—` |
 | `emptyContent` | `ReactNode` | `—` |
 | `caption` | `string` | `Required` |
 | `hideCaption` | `boolean` | `—` |
 | `columns` | `readonly DataTableColumn[]` | `Required` |
+| `showColumnVisibility` | `boolean` | `—` |
+| `hiddenColumnIds` | `readonly string[]` | `—` |
+| `defaultHiddenColumnIds` | `readonly string[]` | `—` |
+| `onHiddenColumnIdsChange` | `(ids: string[]) => void` | `—` |
+| `columnWidths` | `Readonly<Record<string, number>>` | `—` |
+| `defaultColumnWidths` | `Readonly<Record<string, number>>` | `—` |
+| `onColumnWidthsChange` | `(widths: Record<string, number>) => void` | `—` |
 | `rows` | `readonly DataTableRow[]` | `Required` |
+| `expandedIds` | `readonly string[]` | `—` |
+| `defaultExpandedIds` | `readonly string[]` | `—` |
+| `onExpandedChange` | `(ids: string[]) => void` | `—` |
 | `density` | `"compact" \| "comfortable"` | `—` |
 | `striped` | `boolean` | `—` |
 | `minWidth` | `CSSProperties["minWidth"]` | `—` |
+| `maxViewportHeight` | `CSSProperties["maxBlockSize"]` | `—` |
+| `stickyHeader` | `boolean` | `—` |
 | `sort` | `DataTableSort \| null` | `—` |
 | `defaultSort` | `DataTableSort \| null` | `—` |
 | `onSortChange` | `(sort: DataTableSort \| null) => void` | `—` |
@@ -61,6 +78,7 @@ export function Example() {
 | `pageSize` | `number` | `—` |
 | `onPageChange` | `(page: number) => void` | `—` |
 | `showResults` | `boolean` | `—` |
+| `showSelection` | `boolean` | `—` |
 | `paginationMode` | `"client" \| "server"` | `—` |
 | `totalRows` | `number` | `—` |
 | `selectionScope` | `"page" \| "dataset"` | `—` |

package/dist/materials/component-editable.md

@@ -42,6 +42,10 @@ export function Example() {
 | `onEditingChange` | `(editing: boolean) => void` | `—` |
 | `onCommit` | `(value: string) => void` | `—` |
 | `onCancel` | `() => void` | `—` |
+| `validate` | `(value: string) => string \| undefined` | `—` |
+| `inputMode` | `InputHTMLAttributes<HTMLInputElement>["inputMode"]` | `—` |
+| `previewVariant` | `"subtle" \| "ghost"` | `—` |
+| `editorOverlayWidth` | `CSSProperties["inlineSize"]` | `—` |
 | `blurAction` | `"commit" \| "cancel" \| "none"` | `"commit"` |
 | `readOnly` | `boolean` | `—` |
 | `disabled` | `boolean` | `—` |

package/dist/materials/component-heading.md

@@ -34,5 +34,5 @@ export function Example() {
 | Prop | Values | Default |
 | --- | --- | --- |
 | `level` | `1 \| 2 \| 3 \| 4 \| 5 \| 6` | `2` |
-| `size` | `"display" \| "large" \| "page" \| "section"` | `"page"` |
+| `size` | `"display" \| "large" \| "page" \| "section" \| "group"` | `"page"` |
 | `Native HTML props` | `HTMLAttributes<HTMLHeadingElement>` | `Forwarded` |

package/dist/materials/component-section.md

@@ -38,5 +38,5 @@ export function Example() {
 | `description` | `ReactNode` | `—` |
 | `actions` | `ReactNode` | `—` |
 | `headingLevel` | `2 \| 3 \| 4 \| 5 \| 6` | `2` |
-| `headingSize` | `"display" \| "large" \| "page" \| "section"` | `"section"` |
+| `headingSize` | `HeadingProps["size"]` | `"section"` |
 | `Native HTML props` | `Omit<HTMLAttributes<HTMLElement>, "title">` | `Forwarded` |

package/dist/materials/component-sheet.md

@@ -0,0 +1,49 @@
+# Sheet
+
+A bottom-aligned modal for short tasks, navigation and touch-friendly choices.
+
+Connect Flood once using [the installation guide](https://flood.md/docs/installation). Then import the components you use; no per-component add command is needed.
+
+## Example
+
+```tsx
+"use client";
+
+import { FloodRoot, Sheet, Button, Field, Input } from "@flood-md/react";
+import "@flood-md/react/styles.css";
+
+export function Example() {
+  return (
+    <FloodRoot>
+      <Sheet title="Project settings" trigger={props => <Button {...props}>Open settings</Button>}>
+        <Field label="Project name">{control => <Input {...control} defaultValue="Flood" />}</Field>
+      </Sheet>
+    </FloodRoot>
+  );
+}
+```
+
+## Design notes
+
+- Sheet shares Drawer's modal semantics, dismissal, focus restoration, scrollable body and optional footer. Its scrollbar fits in the panel padding. Placement is always bottom.
+- The panel grows with content up to its size limit. Keep actions that must remain visible in the footer and use ListBox for selectable options.
+- Use a sheet for touch navigation or short choices that benefit from a wider target. Anchored popovers and selects remain useful on desktop. Available in 0.2.12.
+
+## API reference
+
+| Prop | Values | Default |
+| --- | --- | --- |
+| `title` | `string` | `Required` |
+| `description` | `string` | `—` |
+| `trigger` | `(props: OverlayTriggerProps) => ReactNode` | `Required` |
+| `children` | `ReactNode` | `—` |
+| `open` | `boolean` | `—` |
+| `defaultOpen` | `boolean` | `—` |
+| `onOpenChange` | `(open: boolean) => void` | `—` |
+| `disabled` | `boolean` | `—` |
+| `closeLabel` | `string` | `—` |
+| `closeOnOutsideClick` | `boolean` | `—` |
+| `initialFocusRef` | `RefObject<HTMLElement \| null>` | `—` |
+| `size` | `"sm" \| "md" \| "lg"` | `"md"` |
+| `footer` | `ReactNode` | `—` |
+| `Native HTML props` | `Omit<Omit<HTMLAttributes<HTMLDialogElement>, "children" \| "title" \| "role">, "side">` | `Forwarded` |

package/dist/materials/component-sparkline.md

@@ -0,0 +1,41 @@
+# Sparkline
+
+A compact line or area chart for trends in a table cell, list or metric.
+
+Connect Flood once using [the installation guide](https://flood.md/docs/installation). Then import the components you use; no per-component add command is needed.
+
+## Example
+
+```tsx
+"use client";
+
+import { FloodRoot, Sparkline } from "@flood-md/react";
+import "@flood-md/react/styles.css";
+
+export function Example() {
+  return (
+    <FloodRoot>
+      <Sparkline label="Revenue rose from $8,000 to $12,000" values={[8000, 8200, null, 9500, 11000, 12000]} domain={[0, 15000]} />
+    </FloodRoot>
+  );
+}
+```
+
+## Design notes
+
+- Give the graphic a label that communicates the metric and the trend. Set showLabel to make that label visible.
+- Use a shared domain for comparing magnitudes across rows. Null and nonfinite samples leave gaps in both the stroke and area.
+- The default area uses an accent stroke with a gradient below it. Choose variant line for stroke only and use semantic tones only when the data has a known interpretation.
+
+## API reference
+
+| Prop | Values | Default |
+| --- | --- | --- |
+| `values` | `readonly (number \| null)[]` | `Required` |
+| `label` | `string` | `Required` |
+| `showLabel` | `boolean` | `false` |
+| `domain` | `readonly [number, number]` | `—` |
+| `size` | `"sm" \| "md"` | `"md"` |
+| `tone` | `"neutral" \| "accent" \| "success" \| "warning" \| "error"` | `"accent"` |
+| `variant` | `"line" \| "area"` | `"area"` |
+| `Native HTML props` | `Omit<HTMLAttributes<HTMLDivElement>, "children" \| "role" \| "aria-label" \| "aria-labelledby">` | `Forwarded` |

package/dist/materials/component-table.md

@@ -42,5 +42,7 @@ export function Example() {
 | `density` | `"compact" \| "comfortable"` | `"comfortable"` |
 | `striped` | `boolean` | `false` |
 | `scrollLabel` | `string` | `—` |
+| `maxViewportHeight` | `CSSProperties["maxBlockSize"]` | `—` |
+| `stickyHeader` | `boolean` | `false` |
 | `cellVerticalAlign` | `"top" \| "middle" \| "bottom"` | `"middle"` |
 | `Native HTML props` | `Omit<TableHTMLAttributes<HTMLTableElement>, "children">` | `Forwarded` |

package/dist/materials/component-toolbar.md

@@ -30,6 +30,7 @@ export function Example() {
 - Use Button, IconButton, Toggle, native buttons/links and Menu triggers. Keep inputs, Select, Tabs and ToggleGroup outside this action-only toolbar.
 - Arrows move focus without activation; Home/End jump to the ends. Disabled and hidden actions are skipped. One Tab entry is established after hydration; before JavaScript native child tab order remains.
 - Horizontal arrows follow writing direction. Vertical arrows move between actions; open a vertical toolbar Menu with Enter/Space. Horizontal menus retain ArrowUp/Down opening.
+- A vertical pill centers its controls on one axis. Use consistently sized icon-only actions with accessible names. Use the rounded shape for a vertical group of labeled actions.
 - loop defaults to true. Native div props/ref target the toolbar; preserve a meaningful label. Available in 0.2.4.
 - shape defaults to rounded; pill uses the action radius and a horizontal single scrollable rail.
 - variant="plain" removes the material and outer inset for grouping peer controls; contained remains the default. Keyboard ownership is unchanged.

package/dist/materials/guide-agent-knowledge.md

@@ -7,11 +7,11 @@ The same package sources build the website, CLI results and agent instructions.
 ## Discover, then read
 
 ```sh
-npx @flood-md/cli@0.2.11 info --json
-npx @flood-md/cli@0.2.11 catalog --kind workflow --group foundations
-npx @flood-md/cli@0.2.11 catalog --kind component --search table
-npx @flood-md/cli@0.2.11 read recipe:table-bulk-actions
-npx @flood-md/cli@0.2.11 read component:data-table
+npx @flood-md/cli@0.2.12 info --json
+npx @flood-md/cli@0.2.12 catalog --kind workflow --group foundations
+npx @flood-md/cli@0.2.12 catalog --kind component --search table
+npx @flood-md/cli@0.2.12 read recipe:table-bulk-actions
+npx @flood-md/cli@0.2.12 read component:data-table
 ```
 
 These commands return JSON and do not install dependencies, edit files, execute

package/dist/materials/guide-foundations.md

@@ -1,6 +1,6 @@
-# Foundations tokens · 0.2.11 candidate
+# Foundations tokens · 0.2.12 candidate
 
-This guide describes the **0.2.11 candidate** foundation exports. Keep Flood packages at
+This guide describes the **0.2.12 candidate** foundation exports. Keep Flood packages at
 matching exact versions. Existing 0.1.1 installs use their earlier token contract.
 
 Foundations separates fixed reference values (`ref`) from semantic roles (`sys`).