@thewhatmatters/wmds 0.4.27 → 0.4.29

package/dist/typography.css

@@ -89,6 +89,22 @@
   --text-display-3-weight: var(--font-weight-semibold);
   --text-display-3-leading: 1.24;
 
+  /**
+   * Hero — the one oversized moment on a marketing page (a poster headline). Fluid to 16vw:
+   * 62px at 390, 230px at 1440. A brand kit may set `--text-display-hero-size` for its face
+   * (a condensed face carries more vw). Tight leading; long words break instead of overflowing.
+   */
+  --text-display-hero-size: clamp(3.5rem, 16vw, 16rem);
+  --text-display-hero-weight: var(--font-weight-bold);
+  --text-display-hero-leading: 0.92;
+  --text-display-hero-tracking: -0.04em;
+
+  /** XL — big statement rows under a hero (section titles, price rows): 44px → 136px. */
+  --text-display-xl-size: clamp(2.75rem, 9vw, 8.5rem);
+  --text-display-xl-weight: var(--font-weight-bold);
+  --text-display-xl-leading: 0.9;
+  --text-display-xl-tracking: -0.03em;
+
   /* Body & UI */
   --text-large-size: var(--font-size-lg);
   --text-large-weight: var(--font-weight-semibold);
@@ -143,27 +159,58 @@
   --text-control-leading: 1;
 }
 
-/* Semantic type utilities — size + weight + leading from tokens; color via text-fg / text-muted. */
+/*
+ * Semantic type utilities — size + weight + leading from tokens; color via text-fg / text-muted.
+ * Display steps read the brand-kit knobs (fonts.css) with the step's own value as the fallback.
+ * With no fallback (display-2/3 tracking, case), an unset knob leaves the inherited value alone.
+ */
+@utility type-display-hero {
+  font-family: var(--font-display, var(--font-family-heading));
+  font-size: var(--text-display-hero-size);
+  font-weight: var(--font-display-weight, var(--text-display-hero-weight));
+  line-height: var(--text-display-hero-leading);
+  letter-spacing: var(--font-display-tracking, var(--text-display-hero-tracking));
+  text-transform: var(--font-display-case);
+  overflow-wrap: break-word;
+  text-wrap: balance;
+}
+
+@utility type-display-xl {
+  font-family: var(--font-display, var(--font-family-heading));
+  font-size: var(--text-display-xl-size);
+  font-weight: var(--font-display-weight, var(--text-display-xl-weight));
+  line-height: var(--text-display-xl-leading);
+  letter-spacing: var(--font-display-tracking, var(--text-display-xl-tracking));
+  text-transform: var(--font-display-case);
+  overflow-wrap: break-word;
+  text-wrap: balance;
+}
+
 @utility type-display-1 {
-  font-family: var(--font-family-heading);
+  font-family: var(--font-display, var(--font-family-heading));
   font-size: var(--text-display-1-size);
-  font-weight: var(--text-display-1-weight);
+  font-weight: var(--font-display-weight, var(--text-display-1-weight));
   line-height: var(--text-display-1-leading);
-  letter-spacing: var(--text-display-1-tracking);
+  letter-spacing: var(--font-display-tracking, var(--text-display-1-tracking));
+  text-transform: var(--font-display-case);
 }
 
 @utility type-display-2 {
-  font-family: var(--font-family-heading);
+  font-family: var(--font-display, var(--font-family-heading));
   font-size: var(--text-display-2-size);
-  font-weight: var(--text-display-2-weight);
+  font-weight: var(--font-display-weight, var(--text-display-2-weight));
   line-height: var(--text-display-2-leading);
+  letter-spacing: var(--font-display-tracking);
+  text-transform: var(--font-display-case);
 }
 
 @utility type-display-3 {
-  font-family: var(--font-family-heading);
+  font-family: var(--font-display, var(--font-family-heading));
   font-size: var(--text-display-3-size);
-  font-weight: var(--text-display-3-weight);
+  font-weight: var(--font-display-weight, var(--text-display-3-weight));
   line-height: var(--text-display-3-leading);
+  letter-spacing: var(--font-display-tracking);
+  text-transform: var(--font-display-case);
 }
 
 @utility type-heading-1 {

package/docs/components.md

@@ -1,13 +1,13 @@
 # @thewhatmatters/wmds — component contracts
 
-Version 0.4.27. Generated from the WMDS repository's AGENTS.md (Storybook-first) by `scripts/generate-package-docs.mjs` — do not edit here.
+Version 0.4.29. 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.
 
 - **Theme** lives in `src/theme/` — `colors.css` (semantic roles) + `theme.css` (Tailwind `@theme` bridge). Storybook is the source of truth, not Paper.
 - **Dark mode:** `[data-theme="dark"]` on `<html>` or any ancestor — same token names, swapped values in `colors.css`.
 - **Consuming apps:** use exported components and typed props; `className` for layout only — not re-theming. Page layout utilities (`gap`, `grid`, `max-w`) are fine between components.
-- **Theme tokens:** Semantic roles in **`src/theme/colors.css`**; typography in **`src/theme/typography.css`** (`type-*` utilities, geometric scale; **display-1/2/3** are fluid via `clamp` — display-1 hits **5rem** on desktop and scales down to **2.5rem** on mobile); motion in **`src/theme/motion.css`**; page spine in **`src/theme/grid.css`** (`--grid-*`, `grid-page` / `band`, `--leading-base`). **`--spacing` stays 4px** — do not re-scale; baseline is 8px. See **ADR-0007**, **ADR-0008**, **ADR-0009**, **ADR-0010**, **DESIGN.md → Grid**. Use **`typographyClass()`** — not raw `text-sm` in document copy. **`type-eyebrow`** (`typographyClass("eyebrow")`) is the small uppercase mono caption for editorial labels — **SectionCaption**, **IndexList** captions, **DescriptionList** `variant="mono"` names; write the text in sentence case — the "/" marker comes from the component, `aria-hidden`. Not for app UI section labels (`overline`) or secondary text (`caption`). **`type-caption`** (`typographyClass("caption-tight")`, 12px on a 16px line) is a single line directly under a label — **LinkTile**'s meta line only, for now; never wrapped text, which stays on `caption` (`type-supporting`, 12px on 20px). **`type-reading`** (`typographyClass("reading")`, 17px at a 28px line) is long-form article text — **Prose** sets it; UI copy stays on `type-body`. A dotted hairline is **DescriptionList** `rule="dotted"`. See **ADR-0040**, **ADR-0041**.
+- **Theme tokens:** Semantic roles in **`src/theme/colors.css`**; typography in **`src/theme/typography.css`** (`type-*` utilities, geometric scale; **display-1/2/3** are fluid via `clamp` — display-1 hits **5rem** on desktop and scales down to **2.5rem** on mobile; above them **`type-display-hero`** (the one oversized moment, to 16vw) and **`type-display-xl`** (statement rows); every display step reads the brand-kit knobs `--font-display*`, CONSUMING.md → Brand kit); motion in **`src/theme/motion.css`**; page spine in **`src/theme/grid.css`** (`--grid-*`, `grid-page` / `band`, `--leading-base`). **`--spacing` stays 4px** — do not re-scale; baseline is 8px. See **ADR-0007**, **ADR-0008**, **ADR-0009**, **ADR-0010**, **DESIGN.md → Grid**. Use **`typographyClass()`** — not raw `text-sm` in document copy. **`type-eyebrow`** (`typographyClass("eyebrow")`) is the small uppercase mono caption for editorial labels — **SectionCaption**, **IndexList** captions, **DescriptionList** `variant="mono"` names; write the text in sentence case — the "/" marker comes from the component, `aria-hidden`. Not for app UI section labels (`overline`) or secondary text (`caption`). **`type-caption`** (`typographyClass("caption-tight")`, 12px on a 16px line) is a single line directly under a label — **LinkTile**'s meta line only, for now; never wrapped text, which stays on `caption` (`type-supporting`, 12px on 20px). **`type-reading`** (`typographyClass("reading")`, 17px at a 28px line) is long-form article text — **Prose** sets it; UI copy stays on `type-body`. A dotted hairline is **DescriptionList** `rule="dotted"`. See **ADR-0040**, **ADR-0041**.
 - **Page layout:** Every Storybook **Guides** page and consuming product page starts on **`grid-page`**; use **`band`** + responsive column spans for content alignment. Constrain a specific experience by overriding **`--grid-max`** on that wrapper (for example, `960px`) rather than replacing the grid with an arbitrary centered container.
 - **Scroll fade:** use **`scroll-fade-y`** / **`scroll-fade-x`** on the element that owns overflow to hint at clipped list or rail content. The mask is scroll-aware, disappears when no overflow exists in supporting browsers, and follows inline direction for RTL. Keep the surface fill/border on a wrapper; customize with `--scroll-fade-size` only when the default 12% / 40px cap does not fit. Copy **Foundations → Scroll fade → Pattern — …**.
 - **Motion:** Duration tiers in **`src/theme/motion.css`** — **fast** (hover/focus), **medium** (panels/layout), **slow** (rare). Single **`--ease-standard`**. CSS via `motionTransition()`; Motion via `motionTransitionProp()`. Choreography tokens `--motion-stagger`, `--motion-beat`, `--motion-blur-reveal` through `motionStaggerSeconds()`, `motionBeatSeconds(n)`, `motionBlurReveal(reduce)`, and `readMotionDurationSeconds(tier)` — Show code never hard-codes a blur, stagger, or duration. See **ADR-0008**. Storybook wraps `<MotionConfig reducedMotion="user">`.
@@ -41,6 +41,8 @@ Storybook paths such as **Components/Button/Button → Pattern — …** name a
 - **Accordion:** generic expand/collapse — **leading**, **label**, **trailing**, built-in chevron, `motion-collapse` panel. Variants: `list`, `capsule`, `plain`; **`flush`** (plain only) drops the inset so labels line up with surrounding text — filter side panels. A closed panel turns `visibility: hidden` once it folds, so Tab skips its controls. **TaskRows** is the task-status pattern on top.
 - **DescriptionList:** a list of facts — `dl` > **DescriptionList.Item** (`div` > `dt` `name` + `dd` value). `layout` `inline` (value beside the name, 2 : 3 tracks, default) or `stacked` (value under it — tags, actions), per list or per item. `rule` `solid` (default) / `dotted` (quieter — beside caption rules) / `none`. `variant` `sans` (caption name, body value) or `mono` (eyebrow name, mono caps value, tabular figures — post metadata). Values take text, `<time>`, **Badge** tags, or **Button** actions; several wrap in a row. Not form fields (**Field**), metrics (**Stat**), or status rows (**TaskRows**). Paste **Components/DescriptionList → Pattern — post metadata** or **Pattern — details**. See **ADR-0041**.
 - **SectionCaption:** the small uppercase mono caption over a page column ("/ Metadata", "/ Article", "/ Filters") — `type-eyebrow` on a `border-border-emphasized` rule; the "/" `marker` is `aria-hidden`. `as` `h2` (default — pair `id` with the region's `aria-labelledby`) or `p` (labels a column that has its own heading); `end` holds a **Button** `size="xs"` (Clear all) without growing the row; `rule` / `marker` can be turned off. Write `children` in sentence case. Copy **Components/SectionCaption → Pattern — column caption**. See **ADR-0041**.
+- **Band:** a full-bleed page section in a brand-kit tone. `tone` `default` / `inverse` (the brand surface, `--color-brand-surface`; also `data-theme="dark"`) / `field` (the saturated section colour, `--color-field`) sets `data-tone`, which remaps the surface, text, border and fill roles so every component inside re-skins; never re-colour what's inside with `className`. It holds its own `grid-page` on the shared `--grid-*` tokens: standing alone it's a full-width section; inside a `grid-page` it spans every column, paints to the viewport edges (border-image outset, no scrollbar) and its page becomes a subgrid, so its columns stay the page's. `spacing` `md` (48px, default) / `lg` (96px) / `none`; `as` `section` (default) / `div` / `header` / `footer` / `aside`. Status colours aren't remapped on `field`. Paste **Components/Band → Pattern — page in bands**; the brand kit and its contrast check are **Foundations/Brand kit → Theme a client**.
+- **InlinePill:** a key word inside running text (a display headline, a lead line) in a soft pill that scales with the text (em-sized), with an optional decorative `media` picture on its left. Pop the pictures in with `useInlinePillsPopIn()` spread on the heading. Not a control: use `Chip` for filters and tokens, `Badge` for status. Keep 2–3 pills of one or two words per sentence.
 - **Prose:** long-form content set from plain HTML elements (rendered markdown) — headings, paragraphs, lists, quotes, inline code, code blocks, rules, images, figures, and tables, with the spacing between them. `size` `lg` (default — `type-reading`, headings a step up) or `md` (`type-body`, denser notes); `measure` `reading` (40rem, default) or `none`; `as` `div` / `article` / `section`. Wide tables scroll in their own box. Map markdown `#` to `h2` under a page `h1`, and links to **TextLink** (`external` for other sites). Never add classes to the elements inside. Paste **Components/Prose → Pattern — article body**; the full page is **Guides/Post page → Pattern — post page** (`metadataSide` `start` / `end` and `metadataColumns` 4 / 3 place the panel from `lg`; `metadataStack` `after` (default) / `before` places it below `lg`, where it stacks, and in the markup — `after` adds a date and reading-time line under the title below `lg`; pair `end` with `after` or `start` with `before` so tab order matches the layout at every width — never edit its classes). See **ADR-0041**.
 - **IndexList:** editorial index for list pages (blog, case studies) — **IndexList.Item** rows with `meta` (a `<time>`), a linked `title` (`href`, or `render={<Link href />}` for the app's router; a quiet **TextLink** in an `h2` by default — `titleAs`), and an optional `preview` an **IconButton** disclosure expands under the title. Optional `captions={{ meta, title }}` in sentence case (`type-eyebrow`, the "/" marker and the **SectionCaption** rule, `aria-hidden`) share the rows' tracks. Two tracks (7.5rem meta, title) once the list is 32rem wide (container query); one column below, captions hidden. `size` `lg` (type-display-3, default) / `md` / `sm`. `empty` replaces the rows when there are none. `className` is layout only. Not tabular data — **Table**. Paste **Components/IndexList → Pattern — post index**; with filters, **Guides/Filter panel → Pattern — filtered index** (a post's `facets` take one option or several per group; `defaultSelection` opens the page filtered, `selection` + `onSelectionChange` hold it in the URL). See **ADR-0040**.
 - **LinkTile:** a resource tile that is one link — `title`, `href` (or `render={<Link href />}` for a router link), `media` (an `<img>` or `next/image` with its `width` and `height`; one image, not a video), `meta` (one line, for example the domain), optional `tag` (a **Badge**, over the image's top-start corner) and `source` (**Avatar** `size="xsm"` or a 20px favicon, before the title). The whole tile is the anchor: one hit area, one focus ring; never put a link or a button inside it. `external` opens a new tab with a safe `rel`, the trailing mark **TextLink** uses, and spoken "(opens in a new tab)" — never hand-write `target`. Screen readers hear the title, the meta, the tag, then the new-tab hint; the image's `alt` is not in the link's name. The image keeps its own ratio by default, so tiles vary in height and hold their space before the image loads; `ratio` (width / height, `4 / 3`) fixes the frame and crops the image. A hairline inside the frame keeps an edge on a light image in light mode and a dark image in dark mode; hover and focus darken it and underline the title. The caption is 12px under the image; the title (two lines at most) and the meta line (`type-caption`, 16px) have no gap between them. `loading` is a **Skeleton** placeholder of the same height, not a link. `className` is layout only. Not a **Card** (a surface with slots that can hold several controls). Paste **Components/LinkTile → Pattern — resource tile** or **Pattern — router link**. See **ADR-0044**.

package/docs/exports.json

@@ -1,6 +1,6 @@
 {
   "package": "@thewhatmatters/wmds",
-  "version": "0.4.27",
+  "version": "0.4.29",
   "import": "import { Button } from \"@thewhatmatters/wmds\";",
   "styles": [
     "@thewhatmatters/wmds/styles.css",
@@ -81,6 +81,19 @@
         "components-badge--with-avatar"
       ]
     },
+    {
+      "name": "Band",
+      "tier": "atom",
+      "category": "Layout",
+      "summary": "Full-bleed page section in a brand tone (inverse, field) on the page's own columns.",
+      "storybook": {
+        "title": "Components/Band",
+        "docs": "?path=/docs/components-band--docs"
+      },
+      "patterns": [
+        "components-band--page-in-bands"
+      ]
+    },
     {
       "name": "Breadcrumb",
       "tier": "molecule",
@@ -307,6 +320,7 @@
       },
       "patterns": [
         "components-dialog--alert-dialog-destructive",
+        "components-dialog--alert-dialog-typed-confirmation",
         "components-dialog--default-dialog",
         "components-dialog--form-dialog"
       ]
@@ -447,6 +461,17 @@
         "components-indexlist--post-index"
       ]
     },
+    {
+      "name": "InlinePill",
+      "tier": "atom",
+      "category": "Content",
+      "summary": "A key word inside running text in a soft pill that scales with the text, with an optional picture that can pop in on scroll.",
+      "storybook": {
+        "title": "Components/InlinePill",
+        "docs": "?path=/docs/components-inlinepill--docs"
+      },
+      "patterns": []
+    },
     {
       "name": "Input",
       "tier": "atom",
@@ -990,12 +1015,41 @@
     "cn",
     "buttonSizeForCluster",
     "iconButtonSizeForCluster",
+    "clusterComponentSizeMap",
+    "clusterTiers",
     "motionTransition",
     "motionTransitionProp",
     "focusRingTransitionClasses",
     "pressScaleClass",
+    "motionBeatSeconds",
+    "motionBlurReveal",
+    "motionStaggerSeconds",
+    "readMotionDurationSeconds",
+    "chartBucketPeriodData",
+    "chartCategoricalCount",
+    "chartCategoricalPalette",
+    "chartFormatAxisValue",
+    "chartFormatTooltipLabel",
+    "chartFormatTooltipValue",
+    "chartNormalizePeriodData",
+    "chartPeriodKindFromValue",
+    "chartSeriesColor",
+    "chartSeriesConfigFromKeys",
+    "chartSeriesConfigFromTone",
+    "chartTooltipIndicators",
+    "chartTooltipItemsFromConfig",
+    "resolveChartPeriodDayCount",
+    "resolvePeriodSegmentPreset",
+    "resolvePeriodSegments",
+    "backgroundPatterns",
+    "backgroundPatternDiagonalLinesClasses",
+    "backgroundPatternDotGridClasses",
     "GridOverlay",
     "GRID_ON_CLASS",
+    "gridOverlayKeyShouldToggle",
+    "isEditableGridOverlayTarget",
+    "readGridColumnCount",
+    "setDocumentGridOn",
     "useSheetParam",
     "readSheetParam",
     "withSheetParam"

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

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.27 · Pattern — flush
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — portal dashboard
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — dropdown row
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — outline tags
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — status pill
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — with avatar
+// @thewhatmatters/wmds@0.4.29 · 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

@@ -0,0 +1,39 @@
+// @thewhatmatters/wmds@0.4.29 · 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.
+
+import { Band, Button } from "@thewhatmatters/wmds";
+
+export function PageInBandsExample() {
+  return (
+    <main className="grid-page !py-0">
+      <Band tone="inverse" spacing="lg" aria-labelledby="hero-title">
+        <div className="col-span-full flex flex-col gap-6 lg:col-span-10">
+          <h1 id="hero-title" className="type-display-hero text-fg">
+            Smoke and chili
+          </h1>
+          <p className="type-reading text-muted">Wood-fired tacos on East Cesar Chavez, open late.</p>
+          <div className="flex flex-wrap gap-2">
+            <Button role="primary">Book a table</Button>
+            <Button role="secondary">See the menu</Button>
+          </div>
+        </div>
+      </Band>
+      <Band aria-labelledby="menu-title">
+        <h2 id="menu-title" className="type-display-xl col-span-full text-fg">
+          The menu
+        </h2>
+        <p className="type-reading col-span-full text-muted md:col-span-4">Six tacos, two salsas, one mezcal list.</p>
+      </Band>
+      <Band tone="field" aria-labelledby="catering-title">
+        <h2 id="catering-title" className="type-display-1 col-span-full text-fg md:col-span-6">
+          Catering for forty
+        </h2>
+        <div className="col-span-full flex flex-col items-start gap-4 md:col-span-2">
+          <p className="type-body text-fg">From $1,500, staff included.</p>
+          <Button role="outline">Ask for a date</Button>
+        </div>
+      </Band>
+    </main>
+  );
+}

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

@@ -1,4 +1,4 @@
-// @thewhatmatters/wmds@0.4.27 · Pattern — editorial
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — long path
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — path
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — router links
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — copy button
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — destructive action
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — external link
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — ghost action
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — inverse action
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — link
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — submit / async
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — outline mono
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — primary action
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — row (hug)
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — row
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — secondary action
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — suggestion pills
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — with count
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — with icon
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — vertical actions
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — skip in footer
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Example — body slot (occupancy history)
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — headerless media
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — outlined layout
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — pinned height
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — terminal frame
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — selectable cards
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — image carousel
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — matrix heatmap
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — Cartesian no-data gaps
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — occupancy history in Card
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — occupancy KPI in Card
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — distribution strip
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — ranked audience breakdown
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — revenue by line
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — segmented ring
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — 100-unit composition
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — chat dock
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — start a project gate
+// @thewhatmatters/wmds@0.4.29 · 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.27 · Pattern — Q&A with reply
+// @thewhatmatters/wmds@0.4.29 · 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.