DeckMatrix

Props

interface Props {
  deckSlug: string;                  // required
  focusVariant?: string | null;      // highlights a column (passes from ?variant= query on /toc/[deckSlug]/)
  title?: string | null;             // h1 above the matrix; pass null to omit
  lede?: string | null;              // descriptor below the h1; pass null to omit
  showNav?: boolean;                 // mount DididecksNav variant-chooser pills above (default false)
}

Cell rendering

Each cell of the matrix is a (variant × slot) pair. Layout:

Left half: Scroll-UI rating glyph (★ perfect / P passable / C non-urgent-could-be-better / U needs-rework / — pending)
Right half: Play-UI rating glyph (same enum)
Far right of row: ≠ symbol when scroll status ≠ play status (drift indicator)
Click-target on each half navigates to that surface for that slot

Column-header rollups

Each variant column header shows a shippability rollup: a count of ★ cells / P cells / C cells / U cells / — cells across the column. Lets a reviewer see “is this variant ready” without scanning rows.

Sibling lightweight component (removed)

A sibling SlideStatusMatrix component briefly existed as a lighter-weight build-status alternative (file-existence glyphs only, no audit data). Deleted 2026-06-06 (commit c5a275b) after a zero-importer audit confirmed neither chroma nor humain reached for it — DeckMatrix covers every landing use case the team has. See Lift-Chroma-Decks-Generic-Code-into-Shared-Shell Phase 5 status.

Status

✅ Shipped — production-used on chroma’s landing + humain’s landing + /toc/[deck]/ route

[[../routes/toc-deck]] — the route wrapper
[[DididecksNav]] — variant-chooser pills (composed when showNav=true)
[[DeckStatsPanel]] — the 4-tile sibling that mounts above the matrix on landing pages
[[../../models/Slide-Audit-Registry-Data-Model]] — the data source
[[../../plans/Redesign-TOC-as-Deck-Level-Dual-Surface-Review-Matrix]]