@flood-md/agent 0.2.10 → 0.2.12

package/DESIGN.md

@@ -1,4 +1,4 @@
-# Flood design system · 0.2.10
+# 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
@@ -247,9 +247,9 @@ footer-only card has no redundant separator. Elevation is default or raised.
 No data access, selection or interactive-card behavior is implied.
 
 ```tsx
-<Card title="Project details" description="Keep your team in sync."
+<Card title="Project details"
   footer={<Button variant="subtle">Open project</Button>}>
-  <Text as="p" size="compact">A calm place for the next idea.</Text>
+  <Text as="p" size="compact">Homepage and checkout</Text>
 </Card>
 ```
 
@@ -418,8 +418,11 @@ an enclosing Fieldset for exclusive choices; derive aggregate checkbox state
 in the host. Read-only choice cards preserve submission and block editing; apply
 readOnly to an entire radio group consistently.
 
-DataTable pages and sorts one complete client-side collection. It is not a
-server query engine or a virtualized grid. Rich cells require explicit sortValues
+DataTable defaults to paging/sorting a complete client collection. Opt-in
+paginationMode="server" renders one supplied page with controlled page/sort and
+totalRows. It does not fetch, cancel requests or virtualize. Declare page/dataset
+selection scope and validate IDs in the host; never select an entire remote query
+by interpreting a select-page checkbox as that operation. Rich cells require explicit sortValues
 when they are sortable. Select all affects the current page only and preserves
 other pages; permission-restricted rows use selectionDisabled. Native links and
 actions in cells remain independent. Compose search and filters at the host

package/README.md

@@ -1,7 +1,7 @@
 # @flood-md/agent
 
 Version-matched guidance for Flood React/Next.js projects. Read the installed
-contract before composing screens. The 0.2.10 reference bundle includes spacing
+contract before composing screens. The 0.2.11 reference bundle includes spacing
 guidance, routing and observable rules. These files grant
 no authority to modify external services.
 

package/SKILL.md

@@ -23,6 +23,16 @@ invented as a package API. No external component library or parallel token syste
 
 ## Read only the relevant reference
 
+Before composing a screen, write a short task trace in the development notes:
+what the user arrives with, the next meaningful action, what changes when it
+succeeds, and how the user recovers if it fails. Name which inputs, filters,
+selection and focus should survive each transition. Use the trace to select
+the relevant workflows and exercise the rendered screen before delivery.
+
+For a reusable component or visual API change, the composition skill routes to
+[component families](references/component-families.md). Flood's own authors use
+that same contract; it is not limited to downstream screen generation.
+
 For a new screen, read the composition and interface-content workflows below
 before the first JSX. Discover owners in the installed catalog before choosing
 familiar low-level controls. Keep a short role → selected component → consulted
@@ -52,6 +62,7 @@ message lifetime belongs to the operation/record, not merely the page's Alert.
 | New screen, layout or form | [Composition](references/composition.md) | Existing primitives, correct host width and form ownership |
 | Task/group/field hierarchy, flat forms or inconsistent row tracks | [Hierarchy skill](references/flood-hierarchy/SKILL.md) | Distinct roles, shared control edges and deliberate vertical rhythm |
 | Spacing, density, nested geometry or shifting previews | [Spacing skill](references/flood-spacing/SKILL.md) | Measured visual relationships and nonoverlapping interactive areas |
+| Animation, transitions or reduced motion | [Motion skill](references/flood-motion/SKILL.md) | Motion roles, immediate semantics and reduced-motion behavior |
 | Existing dark surfaces, type, control and icon sizing | [Foundations skill](references/flood-foundations/SKILL.md) | Correct semantic roles and coherent consumers |
 | Keyboard, names, focus, perception or reflow | [Accessibility skill](references/flood-accessibility/SKILL.md) | Real interaction and associations preserved |
 | Field ownership, validation, submission and reset | [Forms skill](references/flood-forms/SKILL.md) | Actual form values and accepted/refused transitions |