@hegemonart/get-design-done 1.15.0 → 1.18.0

package/agents/design-executor.md

@@ -5,7 +5,8 @@ tools: Read, Write, Edit, Bash, Grep, Glob
 color: yellow
 default-tier: sonnet
 tier-rationale: "Follows an Opus-authored plan; executes rather than plans"
-size_budget: XL
+size_budget: XXL
+size_budget_rationale: "Phase 17 added Benchmark Spec Pre-Flight section for type:components (+17 lines)"
 parallel-safe: conditional-on-touches
 typical-duration-seconds: 60
 reads-only: false
@@ -128,7 +129,7 @@ For `audit` tasks: grep the codebase using patterns from `reference/anti-pattern
 
 ### Type: typography
 
-Read `reference/typography.md` before starting.
+Read `reference/typography.md` before starting. If `reference/variable-fonts-loading.md` is present, also read it — apply variable font axis guidance, font-display trade-offs, fallback metric overrides (size-adjust, ascent-override), and FOIT/FOUT rules to any web font or @font-face decisions in this task.
 
 1. **Identify current state**: grep all font-size values in the codebase. List every unique value.
 2. **Design the target scale**: from the `<decisions>` in DESIGN-CONTEXT.md, pick the modular ratio (default: 1.25, base 16px). Compute: 12/14/16/20/24/30/36/48px (or `text-xs` through `text-5xl` in Tailwind).
@@ -177,7 +178,7 @@ before committing final values.
 
 ### Type: layout
 
-Read `reference/layout.md` (if present) and relevant DESIGN-CONTEXT.md decisions before starting.
+Read `reference/layout.md` (if present) and relevant DESIGN-CONTEXT.md decisions before starting. If `reference/css-grid-layout.md` is present, also read it — apply modern Grid patterns (subgrid, container queries with `@container`, fluid `clamp()` typography, logical properties, safe-area insets, anchor positioning). If `reference/image-optimization.md` is present, apply it to any image-related layout decisions (format choice, srcset/sizes, lazy-loading, CDN transforms, image budget enforcement).
 
 1. **Inventory layout structure**: identify all grid, flex, and positioning patterns in scope files.
 2. **Check spacing consistency**: grep for magic spacing values (px or rem) not from a spacing scale. Map to nearest scale step.
@@ -220,7 +221,7 @@ Work through the accessibility checklist:
 
 ### Type: motion
 
-Read `reference/motion.md` and `reference/framer-motion-patterns.md` before starting.
+Read `reference/motion.md` and `reference/framer-motion-patterns.md` before starting. If `reference/motion-advanced.md` is present, also read it — apply advanced patterns (gesture/drag mechanics, clip-path animations, blur-to-mask crossfades, CSS transitions vs keyframes for interruptible UI, WAAPI, Framer Motion hardware-accel gotcha, motion cohesion rules, next-day review process). If `reference/motion-easings.md` is present, use canonical `--ease-*` tokens rather than raw cubic-bezier strings. If `reference/motion-spring.md` is present, use named presets (gentle/wobbly/stiff/slow) for spring configurations.
 
 `reference/framer-motion-patterns.md` contains Framer Motion-specific implementation patterns that complement the framework-agnostic rules in `reference/motion.md`. When the codebase uses Framer Motion (detectable by `framer-motion` imports), apply the patterns from that file: spring/tween configuration, `AnimatePresence` with `initial={false}`, layout animations, variants with `staggerChildren`, gesture props (`whileHover`, `whileTap` at scale 0.96), `useReducedMotion` or `MotionConfig reducedMotion="user"` for a11y, and the hard constraint that `bounce: 0` for all micro-interactions.
 
@@ -288,6 +289,23 @@ Read `reference/anti-patterns.md`, `reference/design-system-guidance.md`, and DE
 
 Read all relevant reference files for this component's concerns (typography, color, accessibility, motion) before starting.
 
+#### Benchmark Spec Pre-Flight
+
+Before executing the task, check for a benchmark spec:
+
+```bash
+# Extract component name from task description (PascalCase → kebab-case)
+ls reference/components/<name>.md 2>/dev/null
+```
+
+If `reference/components/<name>.md` exists:
+1. Read the spec's **Anatomy**, **States**, **Variants**, and **Keyboard & Accessibility** sections
+2. Use these as the authoritative contract for the implementation — do not re-discover naming conventions, ARIA roles, or keyboard patterns that the spec already defines
+3. In the task output file (`task-NN.md`), add a line: `Spec pre-flight: reference/components/<name>.md — [N] states, [M] variants, WAI-ARIA contract applied`
+4. Flag any deviation between the task instructions and the spec in the `## Deviations` section
+
+If no spec exists, skip silently and proceed normally (graceful degradation).
+
 1. **Read the component spec from the task's Action field**: understand what the component does, its states, its variants.
 2. **Apply ALL relevant reference guidelines simultaneously**: typography scale, color token usage, accessibility requirements (ARIA, focus management, keyboard nav), motion constraints.
 3. **Build the component structure**: markup, styles, and behavior per the spec.

package/agents/design-pattern-mapper.md

@@ -6,6 +6,7 @@ color: green
 model: inherit
 default-tier: sonnet
 tier-rationale: "Catalogs design patterns present in codebase; open-ended classification"
+size_budget: XL
 parallel-safe: always
 typical-duration-seconds: 45
 reads-only: false
@@ -117,6 +118,66 @@ Identify: CSS Modules, styled-components, Tailwind utility classes, or inline st
 
 ---
 
+## Component Convergence Detection
+
+After pattern extraction, scan for component implementations against the benchmark corpus.
+
+### Step 1: Enumerate available specs
+
+```bash
+ls reference/components/*.md 2>/dev/null | grep -v TEMPLATE | grep -v README
+```
+
+If `reference/components/` does not exist or is empty, skip this entire section.
+
+### Step 2: Detect implementations per spec
+
+For each spec file, run its **Grep Signatures** section patterns against the source root:
+
+```bash
+# Example for button.md — adapt per spec's actual grep signatures
+grep -rn "role=\"button\"\|<button\b" src/ --include="*.tsx" --include="*.jsx" -l 2>/dev/null | wc -l
+```
+
+A component is "detected" if ≥1 signature pattern returns results.
+
+### Step 3: Compute convergence score per detected component
+
+For detected components, check coverage against the spec's **States** and **Variants** tables:
+- Count spec states: how many are implemented (aria attributes, CSS classes, data attributes)
+- Count spec variants: how many variant prop values exist in the codebase
+- Convergence % = (implemented items / total spec items) × 100, rounded to 10%
+
+### Step 4: Write `.design/map/component-convergence.md`
+
+```markdown
+---
+generated: [ISO timestamp]
+total_specs: [N]
+detected: [M]
+---
+
+# Component Convergence
+
+## Matched Components
+
+| Component | Spec | Convergence | Key Gaps |
+|-----------|------|-------------|----------|
+| Button | reference/components/button.md | 90% | Missing loading aria-busy |
+| Toast | reference/components/toast.md | 60% | Missing role="alert" on error variant |
+
+## Absent Components (spec exists, no codebase match)
+
+- `reference/components/command-palette.md` — no implementation detected
+- `reference/components/tree.md` — no implementation detected
+
+## Summary
+
+**N/M specs detected** in codebase · Average convergence: X%
+```
+
+---
+
 ## DESIGN-PATTERNS.md Output Format
 
 Write to `.design/DESIGN-PATTERNS.md`. Use exactly this structure:

package/agents/motion-mapper.md

@@ -25,6 +25,10 @@ You inventory motion and animation patterns. Zero session memory. You do not mod
 
 - `.design/STATE.md`
 - `reference/motion.md` (if present)
+- `reference/motion-advanced.md` (if present) — advanced patterns: spring physics, scroll-driven, FLIP, View Transitions API, gesture/drag mechanics, clip-path patterns, blur crossfades, Framer Motion hardware-accel gotcha
+- `reference/motion-easings.md` (if present) — 12 canonical easing presets; classify each detected easing against this catalog
+- `reference/motion-transition-taxonomy.md` (if present) — 8 transition families; classify page/route transitions against this taxonomy
+- `reference/motion-spring.md` (if present) — spring presets; classify spring configs against gentle/wobbly/stiff/slow
 - Any files supplied by the orchestrator
 
 ## Scan Strategy
@@ -61,8 +65,37 @@ From the collected values, bucket by:
 - Normal: 200–400ms
 - Slow: >400ms
 
+## Advanced Scan Patterns (Phase 18+)
+
+When `reference/motion-advanced.md` is present, additionally scan for:
+
+```bash
+# Gesture / drag patterns
+grep -rEn "setPointerCapture|onPointerDown.*drag|dragConstraints|useDragControls" src/ | head -40
+grep -rEn "velocity|flick|swipe.*dismiss|drag.*dismiss" src/ | head -40
+
+# Clip-path animations
+grep -rEn "clip-path|clipPath|inset\(" src/ | head -40
+
+# FLIP / View Transitions
+grep -rEn "layoutId|startViewTransition|view-transition-name" src/ | head -30
+
+# Scroll-driven
+grep -rEn "animation-timeline|ScrollTimeline|useScroll\b" src/ | head -30
+
+# WAAPI
+grep -rEn "\.animate\(\[|WebAnimation|getAnimations" src/ | head -20
+```
+
+Classify gesture patterns against `reference/motion-advanced.md` (velocity formula, pointer capture, multi-touch protection).
+Classify easing values against the 12 canonical presets in `reference/motion-easings.md`; output `"custom"` with justification for anything that doesn't match.
+Classify page/route transitions against the 8 families in `reference/motion-transition-taxonomy.md`.
+Classify spring configs against the 4 presets in `reference/motion-spring.md`.
+
 ## Output Format — `.design/map/motion.md`
 
+**The output MUST begin with a structured JSON block** enclosed in ` ```json ``` ` fences, followed by the prose sections. The JSON block must conform to `reference/output-contracts/motion-map.schema.json`. Malformed or missing blocks are validation failures.
+
 ```markdown
 ---
 generated: [ISO 8601]
@@ -70,22 +103,54 @@ generated: [ISO 8601]
 
 # Motion Map
 
+```json
+{
+  "schema_version": "1.0.0",
+  "generated_at": "[ISO 8601]",
+  "summary": {
+    "total_animations": 0,
+    "custom_easings": 0,
+    "reduced_motion_compliant": false,
+    "libraries": []
+  },
+  "animations": [
+    {
+      "id": "example-toast-enter",
+      "location": { "file": "src/components/Toast.tsx", "line": 12 },
+      "description": "Toast enter animation — opacity + translateY",
+      "easing": "cubic-out",
+      "duration_class": "quick",
+      "duration_ms": 180,
+      "trigger": "state-change",
+      "library": "framer-motion",
+      "reduced_motion_handled": true
+    }
+  ]
+}
+```
+
 ## CSS transitions
-| File | Property | Duration | Easing |
-|------|----------|----------|--------|
+| File | Property | Duration | Easing | Canonical Easing |
+|------|----------|----------|--------|-----------------|
 
 ## Library usage
 | Library | Files | Notes |
 |---------|-------|-------|
 
 ## Duration distribution
-- Fast (<200ms): [N]
-- Normal (200–400ms): [N]
-- Slow (>400ms): [N]
-
-## Easing functions
-| Easing | Count |
-|--------|-------|
+- Instant (<100ms): [N]
+- Quick (100–200ms): [N]
+- Standard (200–400ms): [N]
+- Slow (400–800ms): [N]
+- Narrative (>800ms): [N]
+
+## Easing classification
+| Detected Easing | Canonical Name | Count | Notes |
+|----------------|---------------|-------|-------|
+
+## Advanced patterns detected
+| Pattern | Files | Notes |
+|---------|-------|-------|
 
 ## Reduced-motion compliance
 - `prefers-reduced-motion` queries present: [N]

package/agents/token-mapper.md

@@ -119,6 +119,14 @@ After the standard token inventory, scan and report:
    - Check if they have `font-variant-numeric: tabular-nums` or Tailwind `tabular-nums` class
    - Report missing instances
 
+5. **Easing token consolidation** (when `reference/motion-easings.md` is present)
+   - Grep: `cubic-bezier\(` in CSS/SCSS/styled-components/Tailwind config
+   - Grep: `ease:` or `easing:` in Framer Motion / GSAP configs
+   - For each raw easing value found, check if a canonical `--ease-*` token from `reference/motion-easings.md` would serve the same purpose
+   - Report raw values that map to a canonical preset (recommend the `--ease-*` token)
+   - Report raw values with no canonical match as informational (may warrant a custom token)
+   - Do NOT flag values that are already using `--ease-*` tokens
+
 ### Output format:
 ```
 ## Micro-polish token findings

package/connections/design-corpora.md

@@ -0,0 +1,158 @@
+# Design Corpora — Component Benchmark Sources
+
+This file is the canonical source list for `agents/component-benchmark-harvester.md`.
+It catalogs the 18 design systems used when harvesting per-component benchmarks,
+with licensing notes and a documented fallback chain.
+
+## Fallback Chain
+
+When a primary URL is unreachable, try in order:
+
+1. **Canonical URL** — documented per-system below
+2. **archive.org snapshot** — `https://web.archive.org/web/*/` + canonical URL
+3. **Refero MCP search** — `mcp__refero__search` with component name + system name
+4. **Pinterest MCP visual search** — `mcp__pinterest__search` with component name + system name
+
+Document which tier was used in the raw harvest file under `Source tier:`.
+
+---
+
+## Design Systems Catalog
+
+### 1. Material Design 3 (Google)
+- **Canonical**: https://m3.material.io/components
+- **License**: Apache 2.0 (docs: Creative Commons BY 4.0)
+- **Coverage**: Full component set with anatomy, variants, accessibility, theming tokens
+- **Notes**: Use `/components/<slug>` path. Best for density, motion, and adaptive layout guidance.
+
+### 2. Apple HIG
+- **Canonical**: https://developer.apple.com/design/human-interface-guidelines/
+- **License**: © Apple Inc. — educational fair use for benchmarking
+- **Coverage**: iOS, macOS, visionOS, watchOS; focus on a11y, gestures, platform norms
+- **Notes**: Crawl per-platform variant pages. Best for accessibility contracts and iOS-native patterns.
+
+### 3. Radix UI Primitives + WAI-ARIA APG
+- **Canonical (Radix)**: https://www.radix-ui.com/primitives/docs/components/
+- **Canonical (WAI-ARIA APG)**: https://www.w3.org/WAI/ARIA/apg/patterns/
+- **License**: MIT (Radix); W3C (WAI-ARIA APG — freely usable)
+- **Coverage**: Unstyled primitives + full ARIA keyboard contracts
+- **Notes**: WAI-ARIA APG keyboard contracts should be quoted verbatim. Radix wraps them with implementation detail.
+
+### 4. shadcn/ui
+- **Canonical**: https://ui.shadcn.com/docs/components/
+- **License**: MIT
+- **Coverage**: Radix-based, Tailwind-styled components; real-world usage patterns
+- **Notes**: Best for "what real teams ship" convergence signal alongside spec systems.
+
+### 5. Polaris (Shopify)
+- **Canonical**: https://polaris.shopify.com/components/
+- **License**: Creative Commons BY-NC-SA 4.0 (docs)
+- **Coverage**: E-commerce-optimised components; excellent do/don't examples
+- **Notes**: Polaris has unusually detailed do/don't guidance — mine it for anti-pattern blocks.
+
+### 6. Carbon Design System (IBM)
+- **Canonical**: https://carbondesignsystem.com/components/
+- **License**: Apache 2.0
+- **Coverage**: Enterprise UI; data-heavy components; full accessibility matrix
+- **Notes**: Best for data-dense table/form contexts and enterprise accessibility contracts.
+
+### 7. Fluent 2 (Microsoft)
+- **Canonical**: https://fluent2.microsoft.design/components/web/
+- **License**: MIT
+- **Coverage**: Windows / Microsoft 365 design language; dense information hierarchy
+- **Notes**: Good for focus-management patterns in complex workflows.
+
+### 8. Primer (GitHub)
+- **Canonical**: https://primer.style/components/
+- **License**: MIT
+- **Coverage**: Developer tools UI; markdown + code contexts; icon integration
+- **Notes**: Best for developer-tool and productivity-app component norms.
+
+### 9. Atlassian Design System
+- **Canonical**: https://atlassian.design/components/
+- **License**: Atlassian Design System License (educational fair use)
+- **Coverage**: Collaboration software; complex overlays; strong focus management
+- **Notes**: Excellent focus-trap and dialog accessibility guidance.
+
+### 10. Ant Design
+- **Canonical**: https://ant.design/components/
+- **License**: MIT
+- **Coverage**: Large enterprise component set; Asian market conventions
+- **Notes**: High component density; useful for form and data-table convergence.
+
+### 11. Mantine
+- **Canonical**: https://mantine.dev/
+- **License**: MIT
+- **Coverage**: Full-featured React library; excellent composability patterns
+- **Notes**: Good for controlled vs uncontrolled patterns and React-idiomatic API design.
+
+### 12. Chakra UI
+- **Canonical**: https://chakra-ui.com/docs/components/
+- **License**: MIT
+- **Coverage**: Accessible by default; strong theming; popular in SaaS
+- **Notes**: Good accessibility defaults baseline; useful for theming-token convergence.
+
+### 13. Base Web (Uber)
+- **Canonical**: https://baseweb.design/components/
+- **License**: MIT
+- **Coverage**: High-density, internationalization-aware components
+- **Notes**: Good for RTL, i18n, and high-density layout patterns.
+
+### 14. Nord Design System (Trivago)
+- **Canonical**: https://nordhealth.design/components/
+- **License**: MIT
+- **Coverage**: Healthcare / hospitality UI; strong accessibility focus
+- **Notes**: Smaller corpus; useful for healthcare context accessibility norms.
+
+### 15. Spectrum (Adobe)
+- **Canonical**: https://spectrum.adobe.com/page/component-list/
+- **License**: Apache 2.0
+- **Coverage**: Creative tools UI; multi-surface (web, mobile, desktop)
+- **Notes**: Best for creative-tool contexts and platform-adaptive component behavior.
+
+### 16. Lightning Design System (Salesforce)
+- **Canonical**: https://www.lightningdesignsystem.com/components/
+- **License**: BSD 3-Clause (Salesforce SLDS license)
+- **Coverage**: CRM / enterprise SaaS; dense forms; complex data grids
+- **Notes**: Good for enterprise form validation patterns and data-heavy contexts.
+
+### 17. Evergreen (Segment)
+- **Canonical**: https://evergreen.segment.com/components/
+- **License**: MIT
+- **Coverage**: Analytics / data SaaS; compact components
+- **Notes**: Small system; useful as a convergence signal for SaaS-optimised defaults.
+
+### 18. Gestalt (Pinterest)
+- **Canonical**: https://gestalt.pinterest.systems/
+- **License**: Apache 2.0
+- **Coverage**: Visual-content feed; strong image + card patterns
+- **Notes**: Best for card / masonry / visual-content component norms.
+
+---
+
+## Supplemental Source
+
+### Phase 15 Impeccable Salvage
+- **Path**: `.planning/research/impeccable-salvage/`
+- **License**: MIT (internal port)
+- **Notes**: Harvested design-knowledge prose from the pre-Phase-15 impeccable plugin.
+  The harvester should consume this directory for any component-relevant excerpts before
+  reaching out to external URLs.
+
+---
+
+## Attribution Convention
+
+Every excerpt written to `.planning/benchmarks/raw/<component>.md` must carry a
+source-attribution line in the format:
+
+```
+> Source: [System Name](<canonical-url>) — [license] — accessed <date>
+```
+
+For WAI-ARIA APG keyboard contracts quoted verbatim, use:
+
+```
+> Source: WAI-ARIA Authoring Practices Guide (<url>) — W3C — accessed <date>
+> Quoted verbatim per W3C document license.
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hegemonart/get-design-done",
-  "version": "1.15.0",
+  "version": "1.18.0",
   "description": "A Claude Code plugin for systematic design improvement",
   "author": "Hegemon",
   "homepage": "https://github.com/hegemonart/get-design-done",
@@ -66,10 +66,20 @@
     "palette-catalog",
     "style-vocabulary",
     "industry-palettes",
-    "ui-style-vocabulary"
+    "ui-style-vocabulary",
+    "variable-fonts",
+    "container-queries",
+    "view-transitions",
+    "motion-vocabulary",
+    "motion-easings",
+    "transition-taxonomy",
+    "gesture-mechanics",
+    "clip-path-animation",
+    "component-specs",
+    "design-system-benchmarks"
   ],
   "skills": [
     "SKILL.md"
   ],
   "hooks": "hooks/hooks.json"
-}
+}

package/reference/components/README.md

@@ -0,0 +1,94 @@
+# Component Benchmark Corpus
+
+Per-component design specifications harvested from 18 major design systems.
+Each spec is ≤350 lines, greppable, diff-friendly, and agent-consumable.
+
+**Spec shape**: `TEMPLATE.md` — Purpose · Anatomy · Variants · States · Sizing ·
+Typography · Keyboard/a11y · Motion · Do/Don't · Anti-patterns · Citations · Grep signatures
+
+**Harvest source list**: `connections/design-corpora.md` (18 systems)
+**Tooling**: `agents/component-benchmark-harvester.md` → `agents/component-benchmark-synthesizer.md`
+**CLI**: `/gdd:benchmark <component>` — see `skills/benchmark/SKILL.md`
+
+---
+
+## Wave 1 — Inputs (foundational)
+
+| Component | Spec | Purpose |
+|-----------|------|---------|
+| Button | [button.md](button.md) | Triggers actions; primary, secondary, ghost, destructive variants |
+| Input | [input.md](input.md) | Single-line text entry with label, error, helper text |
+| Select / Combobox | [select-combobox.md](select-combobox.md) | Choose one option from a list; keyboard-navigable dropdown |
+| Checkbox | [checkbox.md](checkbox.md) | Binary or indeterminate choice; groupable with fieldset |
+| Radio | [radio.md](radio.md) | Mutually exclusive choice within a group |
+| Switch | [switch.md](switch.md) | Binary toggle with immediate effect (vs. checkbox form submission) |
+| Link | [link.md](link.md) | Navigation anchor; inline or standalone; external-link pattern |
+| Label | [label.md](label.md) | Accessible association between caption and form control |
+
+---
+
+## Wave 2 — Containers
+
+| Component | Spec | Purpose |
+|-----------|------|---------|
+| Card | [card.md](card.md) | Contained content surface; clickable or static |
+| Modal / Dialog | [modal-dialog.md](modal-dialog.md) | Blocking overlay with focus trap and backdrop |
+| Drawer / Sheet | [drawer.md](drawer.md) | Side or bottom sliding panel |
+| Popover | [popover.md](popover.md) | Anchored overlay; dismisses on outside-click or Escape |
+| Tooltip | [tooltip.md](tooltip.md) | Hover/focus-triggered label; no interactive content |
+| Accordion | [accordion.md](accordion.md) | Collapsible content sections; single or multi-open |
+| Tabs | [tabs.md](tabs.md) | Horizontal/vertical tab navigation with keyboard support |
+
+---
+
+## Wave 3 — Feedback
+
+| Component | Spec | Purpose |
+|-----------|------|---------|
+| Toast / Snackbar | [toast.md](toast.md) | Ephemeral status notification; auto-dismisses 4–8s |
+| Alert / Banner | [alert.md](alert.md) | Persistent inline status message; four severity variants |
+| Progress | [progress.md](progress.md) | Linear and circular completion indicator; determinate + indeterminate |
+| Skeleton | [skeleton.md](skeleton.md) | Loading placeholder matching content shape |
+| Badge | [badge.md](badge.md) | Numeric or status indicator overlaid on another element |
+| Chip / Tag | [chip.md](chip.md) | Compact toggleable/removable label; filter, input, suggestion, display |
+
+---
+
+## Wave 4 — Navigation & Data *(v1.17.0 · plan 17-02)*
+
+| Component | Spec | Purpose |
+|-----------|------|---------|
+| Menu | [menu.md](menu.md) | Dropdown and context menu; action list with ARIA menu roles |
+| Navbar | [navbar.md](navbar.md) | Top navigation bar; primary nav + skip link + mobile hamburger |
+| Sidebar | [sidebar.md](sidebar.md) | Collapsible side navigation panel; icon+label / icon-only states |
+| Breadcrumbs | [breadcrumbs.md](breadcrumbs.md) | Hierarchical location trail; aria-current + hidden separators |
+| Pagination | [pagination.md](pagination.md) | Page-set navigation; previous/next + page buttons + per-page |
+| Table | [table.md](table.md) | Data table with sorting, selection, sticky header, virtualisation |
+| List | [list.md](list.md) | Display list (`<ul>/<ol>`) and interactive listbox (`role="listbox"`) |
+| Tree | [tree.md](tree.md) | Hierarchical tree view; expand/collapse with full ARIA tree roles |
+| Command Palette | [command-palette.md](command-palette.md) | Global Cmd/Ctrl+K launcher; dialog + combobox + listbox pattern |
+
+---
+
+## Wave 5 — Data & Advanced
+
+| Component | Spec | Purpose |
+|-----------|------|---------|
+| Date Picker | [date-picker.md](date-picker.md) | Calendar-based date/range selection; input + popover variants |
+| Slider | [slider.md](slider.md) | Single-value and range thumb on a track; full keyboard contract |
+| File Upload | [file-upload.md](file-upload.md) | Drag-drop zone + accessible file input; per-file progress list |
+| Rich-Text Editor | [rich-text-editor.md](rich-text-editor.md) | WYSIWYG authoring with contenteditable + toolbar + mentions |
+| Stepper / Wizard | [stepper.md](stepper.md) | Sequential multi-step flow; role="list" (not tablist) |
+
+---
+
+## Coverage Summary
+
+| Wave | Specs | Status |
+|------|-------|--------|
+| Wave 1 — Inputs | 8 | v1.16.0 |
+| Wave 2 — Containers | 7 | v1.16.0 |
+| Wave 3 — Feedback | 6 | v1.17.0 |
+| Wave 4 — Navigation & Data | 9 | v1.17.0 |
+| Wave 5 — Data & Advanced | 5 | v1.17.0 |
+| **Total** | **35** | — |