@thewhatmatters/wmds 0.4.31 → 0.4.33

package/docs/components.md

@@ -1,6 +1,6 @@
 # @thewhatmatters/wmds — component contracts
 
-Version 0.4.31. Generated from the WMDS repository's AGENTS.md (Storybook-first) by `scripts/generate-package-docs.mjs` — do not edit here.
+Version 0.4.33. Generated from the WMDS repository's AGENTS.md (Storybook-first) by `scripts/generate-package-docs.mjs` — do not edit here.
 
 Storybook paths such as **Components/Button/Button → Pattern — …** name a story; its Show code is in `patterns/` (see `patterns/index.json`). Longer contracts for FooterReveal, HeroTileStack, TextSequence, ScrollHorizontal, RiveHand, and PromptBar are in `component-contracts.md`. ADR numbers refer to decision records in the WMDS repository.
 
@@ -53,6 +53,7 @@ Storybook paths such as **Components/Button/Button → Pattern — …** name a
 - **PromptBar:** wide prompt pill — inline **TextArea** (one line when empty, grows through 3 lines, then scrolls) and an inset **IconButton** `sm` send control. Enter sends; Shift+Enter inserts a newline; send stays disabled until the draft has text. Optional `start` (brand mark — **Avatar** `size="md"`) and `end` (extra inset **IconButton** `sm`) slots. No new Button role. Copy **Components/PromptBar → Pattern — prompt bar**. The site assistant on the marketing pages is **ChatDock**, not a hand-pinned PromptBar. Do not restyle **SiteNav**. Full contract: **docs/component-contracts.md → PromptBar**.
 - **ChatDock:** the site assistant — a **PromptBar** pinned to the bottom of the page grid (`--grid-max: 40rem`, under **SiteNav**) with the brand `mark`; hovering shows `suggestions` that carry a `prompt` as **Button** `secondary` pills above it; focusing, clicking, or typing opens a non-modal chat window around the same composer (shared overlay header with `title` / `subtitle` / close, `greeting`, `messages` (visitor turns on `bg-brand-tint`, replies as plain text), `thinking` row, suggestion rows — **Button** `layout="row"` — until the first message (a row that sends hands focus to the composer as the rows leave), `disclaimer` under the composer). One **PromptBar** serves both states: the window grows up out of the bar and Escape or close folds it back; either reverses the other midway. Below `md` it fills the screen, rising from the bottom edge. Reduced motion crossfades. `followUps` (same items as `suggestions`; `icon` not shown — inline rows lead with **CornerDownRight**, composer pills are text only) show under the latest reply only — hidden while `thinking`, gone the moment the visitor sends; `followUpsPlacement` is `inline` (default, rows in the thread, 44px on phones) or `composer` (pills above the composer). Under each finished reply, a row: **Copy** (`copyText`), thumbs (`onMessageFeedback`, on replies that carry `feedback` — `null` until the visitor votes; **IconButton** `pressed`), and a muted score (`meta: { label, description? }`, e.g. "Match 99%") — each part on its own; shown on hover or focus where the pointer can hover, always on touch; it keeps its place so the thread never moves, and stays empty while the latest reply is still arriving. Never put actions inside `content`. `gate` puts a multi-step form in the conversation — **ChatDock.Gate**, under the latest message where a reply would go, set in as a well (hairline border at the card body radius, `bg-body`, `shadow-inset-well` — embedded, not raised): step title, subtitle, previous · "2 of 4" · next (no close of its own), the step, `pending` ("Sending…") / `error` lines, and a footer (start slot, Cancel, Next). Setting it opens the window and takes focus; the window keeps its header (`gateSubtitle` replaces the subtitle) and its close; the composer stays in place but is off (`labels.gatePlaceholder`); suggestion rows, follow-ups, and reply rows step aside. The window grows to fit the step, up to the viewport less 7rem; past that the conversation scrolls, and each step is brought into view. The window stays non-modal. Its close and Escape fold it and keep the gate with its progress; Cancel leaves the gate and the composer comes back with focus. Phones keep the window inside the area a keyboard leaves visible. Start a project runs as a gate, not a dialog — paste **Pattern — start a project gate** (its `onSubmit` returns a promise; a rejection keeps the answers and offers Try again) and return it from **Pattern — chat dock**'s `renderStartProject`. Never put a form inside `content`. The app owns `messages`, `followUps`, votes, the gate's open state, and `onSend`; suggestions without a `prompt` (for example **Start a project**) only call `onSuggestionSelect`. No full-page chat, no header send/expand arrow, no voice. `placement="inline"` is for previews only. Copy **Components/ChatDock → Pattern — chat dock** (it holds the follow-up state, the votes, and Start a project). See **ADR-0039**. Full contract: **docs/component-contracts.md → ChatDock**.
 - **TextArea:** element-radius multiline — same optional `label`, `description`, `status`, `message`, and `loading` as **Input**; default `resize="vertical"`. See **ADR-0006**.
+- **ErrorSummary:** after a failed submit, at the top of the form: "There's a problem" (`title`), `errors` `{ field, message }[]` (one link per error, same words as the field's message; `field` is the input `id`), takes focus when its errors change (`focusOnShow`), each link focuses its field; `as` `h2` / `h3`. Fields keep their inline messages. Paste **Components/ErrorSummary → Pattern — form with an error summary**.
 - **Field:** label/layout wrapper — `orientation="vertical" | "horizontal"`; never required. Validation stays on **Input** / **TextArea**. See **ADR-0006**.
 - **CopyField:** read-only monospace value inside **PromptBar**'s pill, with **Button** `role="secondary"` `size="sm"` seated at the trailing end the way PromptBar seats send (Lucide **Copy**; the confirmation check is the status glyph). **Input** is `inline` `mono` `readOnly` (`type-code`); a long value truncates and does not run under the button. A click copies `value`. The label becomes "Copied" for `buttonStatusHoldMs` (2s), announced from the button's `aria-live="polite"` region, then returns. Enter and Space activate the button; focusing the value selects it, so Cmd/Ctrl+C copies from the field. If the Clipboard API is missing or blocked, the value is selected, `execCommand('copy')` is tried, and a polite hint reads "Press Cmd/Ctrl+C to copy." The value is never logged. The label and the blocked-clipboard hint inherit color (`type-label` / `type-supporting`, not `text-fg` or `text-muted`); the pill stays `bg-surface` so the key stays dark on white. On navy, wrap the section in `bg-brand text-on-brand` and use **Button** `role="inverse"` plus `role="inverse-outline"`. Do not set `data-theme="dark"` on that section — the dark surface is about 1:1 on `#011272`. `state` (`"copied"` | `"fallback"`) pins a specimen — omit it in the app. `className` is layout only. No new color. Paste **Components/CopyField → Pattern — copy key**, or **Pattern — on a navy field** for the unlock page. See **ADR-0045**, **ADR-0046**.
 - **LogView:** a scrolling log — `lines`, `label`, line numbers, a tabular line count, **Copy** (**Button**), and **Follow** (`aria-pressed`, keeps the scroller on the last line). `loading` is a **Skeleton**. An empty log reads "No log lines". `className` is layout only. Paste **Components/LogView → Pattern — log viewer**. The dark run detail is **Pattern — detail pane**: prev/next **IconButton**, **Badge** tags, **Stat** `detail`, and **LogView**, wrapped in `data-theme="dark"`.

package/docs/exports.json

@@ -1,6 +1,6 @@
 {
   "package": "@thewhatmatters/wmds",
-  "version": "0.4.31",
+  "version": "0.4.33",
   "import": "import { Button } from \"@thewhatmatters/wmds\";",
   "styles": [
     "@thewhatmatters/wmds/styles.css",
@@ -350,6 +350,19 @@
       },
       "patterns": []
     },
+    {
+      "name": "ErrorSummary",
+      "tier": "molecule",
+      "category": "Form controls",
+      "summary": "\"There's a problem\" at the top of a form after a failed submit: one link per error that focuses its field.",
+      "storybook": {
+        "title": "Components/ErrorSummary",
+        "docs": "?path=/docs/components-errorsummary--docs"
+      },
+      "patterns": [
+        "components-errorsummary--contact-form"
+      ]
+    },
     {
       "name": "Field",
       "tier": "molecule",

package/docs/patterns/components-accordion--flush.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — flush
+// @thewhatmatters/wmds@0.4.33 · Pattern — flush
 // Storybook: Components/Accordion → Pattern — flush (?path=/story/components-accordion--flush)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-appshell--portal-dashboard-pattern.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — portal dashboard
+// @thewhatmatters/wmds@0.4.33 · Pattern — portal dashboard
 // Storybook: Components/AppShell → Pattern — portal dashboard (?path=/story/components-appshell--portal-dashboard-pattern)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-avatar--dropdown-row.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — dropdown row
+// @thewhatmatters/wmds@0.4.33 · Pattern — dropdown row
 // Storybook: Components/Avatar → Pattern — dropdown row (?path=/story/components-avatar--dropdown-row)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-badge--outline-tags.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — outline tags
+// @thewhatmatters/wmds@0.4.33 · Pattern — outline tags
 // Storybook: Components/Badge → Pattern — outline tags (?path=/story/components-badge--outline-tags)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-badge--status-pill.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — status pill
+// @thewhatmatters/wmds@0.4.33 · Pattern — status pill
 // Storybook: Components/Badge → Pattern — status pill (?path=/story/components-badge--status-pill)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-badge--with-avatar.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — with avatar
+// @thewhatmatters/wmds@0.4.33 · Pattern — with avatar
 // Storybook: Components/Badge → Pattern — with avatar (?path=/story/components-badge--with-avatar)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-band--page-in-bands.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — page in bands
+// @thewhatmatters/wmds@0.4.33 · Pattern — page in bands
 // Storybook: Components/Band → Pattern — page in bands (?path=/story/components-band--page-in-bands)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-breadcrumb--editorial.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — editorial
+// @thewhatmatters/wmds@0.4.33 · Pattern — editorial
 // Storybook: Components/Breadcrumb → Pattern — editorial (?path=/story/components-breadcrumb--editorial)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-breadcrumb--long-path.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — long path
+// @thewhatmatters/wmds@0.4.33 · Pattern — long path
 // Storybook: Components/Breadcrumb → Pattern — long path (?path=/story/components-breadcrumb--long-path)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-breadcrumb--path.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — path
+// @thewhatmatters/wmds@0.4.33 · Pattern — path
 // Storybook: Components/Breadcrumb → Pattern — path (?path=/story/components-breadcrumb--path)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-breadcrumb--router-links.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — router links
+// @thewhatmatters/wmds@0.4.33 · Pattern — router links
 // Storybook: Components/Breadcrumb → Pattern — router links (?path=/story/components-breadcrumb--router-links)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--copy-button.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — copy button
+// @thewhatmatters/wmds@0.4.33 · Pattern — copy button
 // Storybook: Components/Button/Button → Pattern — copy button (?path=/story/components-button-button--copy-button)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--destructive-action.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — destructive action
+// @thewhatmatters/wmds@0.4.33 · Pattern — destructive action
 // Storybook: Components/Button/Button → Pattern — destructive action (?path=/story/components-button-button--destructive-action)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--external-link.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — external link
+// @thewhatmatters/wmds@0.4.33 · Pattern — external link
 // Storybook: Components/Button/Button → Pattern — external link (?path=/story/components-button-button--external-link)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--ghost-action.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — ghost action
+// @thewhatmatters/wmds@0.4.33 · Pattern — ghost action
 // Storybook: Components/Button/Button → Pattern — ghost action (?path=/story/components-button-button--ghost-action)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--inverse-action.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — inverse action
+// @thewhatmatters/wmds@0.4.33 · Pattern — inverse action
 // Storybook: Components/Button/Button → Pattern — inverse action (?path=/story/components-button-button--inverse-action)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--link-render.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — link
+// @thewhatmatters/wmds@0.4.33 · Pattern — link
 // Storybook: Components/Button/Button → Pattern — link (?path=/story/components-button-button--link-render)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--multi-state-badge.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — submit / async
+// @thewhatmatters/wmds@0.4.33 · Pattern — submit / async
 // Storybook: Components/Button/Button → Pattern — submit / async (?path=/story/components-button-button--multi-state-badge)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--outline-mono.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — outline mono
+// @thewhatmatters/wmds@0.4.33 · Pattern — outline mono
 // Storybook: Components/Button/Button → Pattern — outline mono (?path=/story/components-button-button--outline-mono)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--primary-action.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — primary action
+// @thewhatmatters/wmds@0.4.33 · Pattern — primary action
 // Storybook: Components/Button/Button → Pattern — primary action (?path=/story/components-button-button--primary-action)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--row-hug.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — row (hug)
+// @thewhatmatters/wmds@0.4.33 · Pattern — row (hug)
 // Storybook: Components/Button/Button → Pattern — row (hug) (?path=/story/components-button-button--row-hug)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--row-layout.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — row
+// @thewhatmatters/wmds@0.4.33 · Pattern — row
 // Storybook: Components/Button/Button → Pattern — row (?path=/story/components-button-button--row-layout)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--secondary-action.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — secondary action
+// @thewhatmatters/wmds@0.4.33 · Pattern — secondary action
 // Storybook: Components/Button/Button → Pattern — secondary action (?path=/story/components-button-button--secondary-action)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--suggestion-pills.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — suggestion pills
+// @thewhatmatters/wmds@0.4.33 · Pattern — suggestion pills
 // Storybook: Components/Button/Button → Pattern — suggestion pills (?path=/story/components-button-button--suggestion-pills)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--with-count.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — with count
+// @thewhatmatters/wmds@0.4.33 · Pattern — with count
 // Storybook: Components/Button/Button → Pattern — with count (?path=/story/components-button-button--with-count)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-button--with-icon.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — with icon
+// @thewhatmatters/wmds@0.4.33 · Pattern — with icon
 // Storybook: Components/Button/Button → Pattern — with icon (?path=/story/components-button-button--with-icon)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-button-floatingactionbutton--vertical-actions.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — vertical actions
+// @thewhatmatters/wmds@0.4.33 · Pattern — vertical actions
 // Storybook: Components/Button/FloatingActionButton → Pattern — vertical actions (?path=/story/components-button-floatingactionbutton--vertical-actions)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-calembed--pattern-skip-in-footer.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — skip in footer
+// @thewhatmatters/wmds@0.4.33 · Pattern — skip in footer
 // Storybook: Components/CalEmbed → Pattern — skip in footer (?path=/story/components-calembed--pattern-skip-in-footer)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-card-card--body-slot-occupancy-history.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Example — body slot (occupancy history)
+// @thewhatmatters/wmds@0.4.33 · Example — body slot (occupancy history)
 // Storybook: Components/Card/Card → Example — body slot (occupancy history) (?path=/story/components-card-card--body-slot-occupancy-history)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-card-card--headerless-media.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — headerless media
+// @thewhatmatters/wmds@0.4.33 · Pattern — headerless media
 // Storybook: Components/Card/Card → Pattern — headerless media (?path=/story/components-card-card--headerless-media)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-card-card--outlined-layout.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — outlined layout
+// @thewhatmatters/wmds@0.4.33 · Pattern — outlined layout
 // Storybook: Components/Card/Card → Pattern — outlined layout (?path=/story/components-card-card--outlined-layout)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-card-card--pinned-height.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — pinned height
+// @thewhatmatters/wmds@0.4.33 · Pattern — pinned height
 // Storybook: Components/Card/Card → Pattern — pinned height (?path=/story/components-card-card--pinned-height)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-card-card--terminal-frame.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — terminal frame
+// @thewhatmatters/wmds@0.4.33 · Pattern — terminal frame
 // Storybook: Components/Card/Card → Pattern — terminal frame (?path=/story/components-card-card--terminal-frame)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-card-selectablecard--selectable-cards-pattern.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — selectable cards
+// @thewhatmatters/wmds@0.4.33 · Pattern — selectable cards
 // Storybook: Components/Card/SelectableCard → Pattern — selectable cards (?path=/story/components-card-selectablecard--selectable-cards-pattern)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-carousel--image-carousel.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — image carousel
+// @thewhatmatters/wmds@0.4.33 · Pattern — image carousel
 // Storybook: Components/Carousel → Pattern — image carousel (?path=/story/components-carousel--image-carousel)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chart--audience-activity-heatmap.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — matrix heatmap
+// @thewhatmatters/wmds@0.4.33 · Pattern — matrix heatmap
 // Storybook: Components/Chart → Pattern — matrix heatmap (?path=/story/components-chart--audience-activity-heatmap)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chart--cartesian-no-data-gaps.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — Cartesian no-data gaps
+// @thewhatmatters/wmds@0.4.33 · Pattern — Cartesian no-data gaps
 // Storybook: Components/Chart → Pattern — Cartesian no-data gaps (?path=/story/components-chart--cartesian-no-data-gaps)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chart--occupancy-history-in-card.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — occupancy history in Card
+// @thewhatmatters/wmds@0.4.33 · Pattern — occupancy history in Card
 // Storybook: Components/Chart → Pattern — occupancy history in Card (?path=/story/components-chart--occupancy-history-in-card)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chart--occupancy-in-card.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — occupancy KPI in Card
+// @thewhatmatters/wmds@0.4.33 · Pattern — occupancy KPI in Card
 // Storybook: Components/Chart → Pattern — occupancy KPI in Card (?path=/story/components-chart--occupancy-in-card)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chart--post-reach-distribution.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — distribution strip
+// @thewhatmatters/wmds@0.4.33 · Pattern — distribution strip
 // Storybook: Components/Chart → Pattern — distribution strip (?path=/story/components-chart--post-reach-distribution)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chart--ranked-audience-breakdown.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — ranked audience breakdown
+// @thewhatmatters/wmds@0.4.33 · Pattern — ranked audience breakdown
 // Storybook: Components/Chart → Pattern — ranked audience breakdown (?path=/story/components-chart--ranked-audience-breakdown)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chart--revenue-by-line.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — revenue by line
+// @thewhatmatters/wmds@0.4.33 · Pattern — revenue by line
 // Storybook: Components/Chart → Pattern — revenue by line (?path=/story/components-chart--revenue-by-line)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chart--segmented-ring-pattern.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — segmented ring
+// @thewhatmatters/wmds@0.4.33 · Pattern — segmented ring
 // Storybook: Components/Chart → Pattern — segmented ring (?path=/story/components-chart--segmented-ring-pattern)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chart--unit-grid-composition.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — 100-unit composition
+// @thewhatmatters/wmds@0.4.33 · Pattern — 100-unit composition
 // Storybook: Components/Chart → Pattern — 100-unit composition (?path=/story/components-chart--unit-grid-composition)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chatdock--pattern-chat-dock.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — chat dock
+// @thewhatmatters/wmds@0.4.33 · Pattern — chat dock
 // Storybook: Components/ChatDock → Pattern — chat dock (?path=/story/components-chatdock--pattern-chat-dock)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chatdock--pattern-start-project-gate.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — start a project gate
+// @thewhatmatters/wmds@0.4.33 · Pattern — start a project gate
 // Storybook: Components/ChatDock → Pattern — start a project gate (?path=/story/components-chatdock--pattern-start-project-gate)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-chatqa--pattern-qa-with-reply.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — Q&A with reply
+// @thewhatmatters/wmds@0.4.33 · Pattern — Q&A with reply
 // Storybook: Components/ChatQa → Pattern — Q&A with reply (?path=/story/components-chatqa--pattern-qa-with-reply)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-checkbox-checkbox--default.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — default
+// @thewhatmatters/wmds@0.4.33 · Pattern — default
 // Storybook: Components/Checkbox/Checkbox → Pattern — default (?path=/story/components-checkbox-checkbox--default)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-checkbox-checkbox--with-count.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — with count
+// @thewhatmatters/wmds@0.4.33 · Pattern — with count
 // Storybook: Components/Checkbox/Checkbox → Pattern — with count (?path=/story/components-checkbox-checkbox--with-count)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-checkbox-checkbox--with-description.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — with description
+// @thewhatmatters/wmds@0.4.33 · Pattern — with description
 // Storybook: Components/Checkbox/Checkbox → Pattern — with description (?path=/story/components-checkbox-checkbox--with-description)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-checkbox-checkboxgroup--default.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — default
+// @thewhatmatters/wmds@0.4.33 · Pattern — default
 // Storybook: Components/Checkbox/CheckboxGroup → Pattern — default (?path=/story/components-checkbox-checkboxgroup--default)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-checkbox-checkboxgroup--option-counts.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — option counts
+// @thewhatmatters/wmds@0.4.33 · Pattern — option counts
 // Storybook: Components/Checkbox/CheckboxGroup → Pattern — option counts (?path=/story/components-checkbox-checkboxgroup--option-counts)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-copyfield--clipboard-blocked.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — clipboard blocked
+// @thewhatmatters/wmds@0.4.33 · Pattern — clipboard blocked
 // Storybook: Components/CopyField → Pattern — clipboard blocked (?path=/story/components-copyfield--clipboard-blocked)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-copyfield--copied.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — copied
+// @thewhatmatters/wmds@0.4.33 · Pattern — copied
 // Storybook: Components/CopyField → Pattern — copied (?path=/story/components-copyfield--copied)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-copyfield--copy-key.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — copy key
+// @thewhatmatters/wmds@0.4.33 · Pattern — copy key
 // Storybook: Components/CopyField → Pattern — copy key (?path=/story/components-copyfield--copy-key)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-copyfield--on-navy.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — on a navy field
+// @thewhatmatters/wmds@0.4.33 · Pattern — on a navy field
 // Storybook: Components/CopyField → Pattern — on a navy field (?path=/story/components-copyfield--on-navy)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-descriptionlist--details.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — details
+// @thewhatmatters/wmds@0.4.33 · Pattern — details
 // Storybook: Components/DescriptionList → Pattern — details (?path=/story/components-descriptionlist--details)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-descriptionlist--post-metadata.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — post metadata
+// @thewhatmatters/wmds@0.4.33 · Pattern — post metadata
 // Storybook: Components/DescriptionList → Pattern — post metadata (?path=/story/components-descriptionlist--post-metadata)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-dialog--alert-dialog-destructive.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — alert dialog (destructive)
+// @thewhatmatters/wmds@0.4.33 · Pattern — alert dialog (destructive)
 // Storybook: Components/Dialog → Pattern — alert dialog (destructive) (?path=/story/components-dialog--alert-dialog-destructive)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-dialog--alert-dialog-typed-confirmation.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — alert dialog (typed confirmation delete)
+// @thewhatmatters/wmds@0.4.33 · Pattern — alert dialog (typed confirmation delete)
 // Storybook: Components/Dialog → Pattern — alert dialog (typed confirmation delete) (?path=/story/components-dialog--alert-dialog-typed-confirmation)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-dialog--default-dialog.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — dialog
+// @thewhatmatters/wmds@0.4.33 · Pattern — dialog
 // Storybook: Components/Dialog → Pattern — dialog (?path=/story/components-dialog--default-dialog)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-dialog--form-dialog.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — form dialog
+// @thewhatmatters/wmds@0.4.33 · Pattern — form dialog
 // Storybook: Components/Dialog → Pattern — form dialog (?path=/story/components-dialog--form-dialog)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 
@@ -31,8 +31,8 @@ export function InviteDialog() {
           }
         >
           <div className="flex flex-col gap-4 pb-2">
-            <Input label="Email address" placeholder="name@company.com" />
-            <Input label="Role" placeholder="Editor" />
+            <Input label="Email address" />
+            <Input label="Role" />
           </div>
         </Dialog.Content>
       </Dialog>

package/docs/patterns/components-displaycontrols--page-utilities.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — page display controls
+// @thewhatmatters/wmds@0.4.33 · Pattern — page display controls
 // Storybook: Components/DisplayControls → Pattern — page display controls (?path=/story/components-displaycontrols--page-utilities)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-displaycontrols--theme-switch.tsx

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — theme switch
+// @thewhatmatters/wmds@0.4.33 · Pattern — theme switch
 // Storybook: Components/DisplayControls → Pattern — theme switch (?path=/story/components-displaycontrols--theme-switch)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 

package/docs/patterns/components-errorsummary--contact-form.tsx

@@ -0,0 +1,35 @@
+// @thewhatmatters/wmds@0.4.33 · Pattern — form with an error summary
+// Storybook: Components/ErrorSummary → Pattern — form with an error summary (?path=/story/components-errorsummary--contact-form)
+// Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
+
+"use client";
+
+import { useState, type FormEvent } from "react";
+import { Button, ErrorSummary, Input, type ErrorSummaryItem } from "@thewhatmatters/wmds";
+
+export function ContactFormExample() {
+  const [errors, setErrors] = useState<ErrorSummaryItem[]>([]);
+  const messageFor = (field: string) => errors.find((error) => error.field === field)?.message as string | undefined;
+
+  function submit(event: FormEvent<HTMLFormElement>) {
+    event.preventDefault();
+    const data = new FormData(event.currentTarget);
+    const next: ErrorSummaryItem[] = [];
+    if (String(data.get("name") ?? "").trim() === "") next.push({ field: "contact-name", message: "Enter your name" });
+    const email = String(data.get("email") ?? "").trim();
+    if (email === "") next.push({ field: "contact-email", message: "Enter your email address" });
+    else if (!/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email)) next.push({ field: "contact-email", message: "Enter an email address like name@example.com" });
+    setErrors(next);
+  }
+
+  return (
+    <form noValidate onSubmit={submit} className="flex max-w-md flex-col gap-6">
+      <ErrorSummary errors={errors} />
+      <Input id="contact-name" name="name" label="Name" status={messageFor("contact-name") ? "error" : undefined} message={messageFor("contact-name")} />
+      <Input id="contact-email" name="email" type="email" label="Email" status={messageFor("contact-email") ? "error" : undefined} message={messageFor("contact-email")} />
+      <div>
+        <Button type="submit">Send message</Button>
+      </div>
+    </form>
+  );
+}

package/docs/patterns/components-field--horizontal-input.tsx

@@ -1,9 +1,9 @@
-// @thewhatmatters/wmds@0.4.31 · Pattern — horizontal input
+// @thewhatmatters/wmds@0.4.33 · Pattern — horizontal input
 // Storybook: Components/Field → Pattern — horizontal input (?path=/story/components-field--horizontal-input)
 // Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
 
 import { Field, Input } from "@thewhatmatters/wmds";
 
 <Field label="ZIP code" description="5-digit US ZIP." orientation="horizontal">
-  <Input placeholder="97201" aria-label="ZIP code" />
+  <Input aria-label="ZIP code" />
 </Field>