dididecks-ai/sitemap
- Path
- sitemap/index.md
Sitemap
- Sitemap — Living Map of the DidiDecks Universal-Frontend-over-Client-Decks Architecture - One mini-spec per
@dididecks/shellartifact — the universal layer; per-client overrides live in each client-site’s owncontext-v/.
Components
- DeckChrome — themable floating navigation capsule for Play-UI (and eventually Scroll-UI variant cycling) - Floating bottom-right nav capsule replacing v0.1’s dark PlayChrome bar; styling comes only from
--ddd-chrome-*custom properties. - DeckFrame–Play-UI — Play-UI chrome wrapper around SlideCanvas, plus the keyboard contract - Play-UI’s outer frame at
/play/[deck]/[variant]/[slot]/—<SlideCanvas>plus the floating DeckChrome and document keyboard listener. - DeckMatrix — the rich audit-rated dual-surface matrix; the deck-level review surface, embeddable on any landing - The embeddable variants × slots matrix: each cell pairs a Scroll-UI and Play-UI rating, with
≠flagging where the two surfaces disagree. - DeckOverlay–Play-UI — the floating overlay layer for Play-mode decks - Single mount point on the play-slot route composing DeckChrome and SlideRankPill; its
<section data-slot>wrap is the play-mode adapter. - DeckOverlay–Scroll-UI — the floating overlay layer for Scroll-mode decks - Layout-neutral (
display: contents) mount for the affordances riding over a scroll deck — each a named slot consumers can rearrange. - DeckStatsPanel — the 4-tile quick-stats row above the matrix on landing pages (Variants · Slide Files · People · Companies) - Four-tile stats row above
DeckMatrix— Variants, Slide Files, People, Companies — counted from the same globs/data-assets/*uses. - DecomposeFirstPlaceholder — empty-slot fallback rendered when a per-slide file doesn’t exist yet - Empty-slot fallback on the play route — an invitation to begin the rank → decompose → recreate loop, deliberately not an error state.
- DididecksNav — shell-injected global header linking Scroll · TOC · Play · Changelog - Shell-injected global header auto-mounted on
/toc/*and/play/*, with links derived from the consumer’s own deck registry. - ModeToggle — three-mode color-toggle (light → dark → vibrant) with per-client localStorage namespace - Fixed top-right button cycling light → dark → vibrant, persisted under a per-client
{client}:modekey so co-hosted decks don’t collide. - PageAsDeckWrapper — Scroll-UI navigation primitive: scroll-snap + keyboard + section counter + reveal-on-intersect - Wraps
<section data-slot data-variant>children in a scroll-snap deck: keyboard contract, section counter, and#s-Nhash nav. - PlayChrome — DEPRECATED thin shim around DeckChrome - Deprecated as of v0.2 — a thin shim around
<DeckChrome>kept so external imports keep working. Removed in v0.3. - ScrollDeckPage — THE single shell overlay for a scroll-deck variant page; one-import wiring - Collapses the three shell imports a variant page used to need — pagination, rating pill, mode toggle — into one component and mount site.
- SlideCanvas — pure-CSS 16:9 wrapper that scales a 1920×1080 stage to fit any canvas - Pure-CSS 16:9 stage — container queries scale a 1920×1080 design size to any canvas, so the Play-UI scaling pipeline needs no JS.
- SlideRankPill — floating five-button classifier for the active slot (rename pending → SlideClassifierPill) - Bottom-right floating pill exposing the five-state classifier for the active slot, found via IntersectionObserver over
section[data-slot]. - SlideShell — shared per-slide chrome (padding, min-height, snap-align, optional consumer-provided mark) - Outer
<section>with shared per-slide layout plus a<slot name="mark">— consumers plug their own mark, the shell stays brand-agnostic.
Lib
- lib/deck-overview — registry + filesystem walker; loadDeckOverview(deckSlug) returns DeckOverview with variants/slots/per-slide-file flags -
loadDeckOverview(deckSlug)reads registry paths offglobalThis.__dididecksShellOptions, so the shell never needs the consumer’s imports.
Routes
- /api/slide-decompose — non-destructive stub generator for the Phase 1 → Phase 2 transition - Dev-only route that writes an empty per-slide stub and refuses to overwrite — 409 if the file exists. Static Vercel builds never carry it.
- /api/slide-rank — read + write per-slide classifier state into the consumer’s audits file - Dev-only GET/POST over
data/audits/slides.json—'pending'is never persisted; posting it deletes the entry. 404s in production builds. - /data-assets/companies — reviewer audit of portfolio-company metadata + brand assets across every engagement layout - Reviewer audit over
data/**/portfolio/*.md— companies are told from people by the absence ofrole_class. SSR’d behind auth. - /data-assets/people — reviewer audit of team / advisor / portco-ceo metadata + headshots across every engagement layout - Reviewer audit over
data/**/{team,portfolio}/*.md— people are told from companies by the presence ofrole_class. SSR’d behind auth. - /data-assets/slides — reviewer audit of the slide tier, one row per slot, adapted-vs-stub per variant - The third data-assets audit and the only one never promoted to the shell — adapted-vs-stub per variant, living only in calmstorm-decks.
- /dev/icons — recurring design-review workbench - A kept design-review workbench — one
/dev/*page rendering every candidate for a visual-primitive decision side by side, in real context. - /play/[deckSlug]/[variantSlug]/ — variant-index redirect to slot 01 - Enumerates every (deck, variant) and 302s to slot 01 — unconditionally today, so slot-less variants like chroma’s proto land on a 404.
- /play/[deckSlug]/[variantSlug]/print/ — one-shot PDF export surface; renders the whole variant stacked for the browser print dialog - Stacks every slot as SlideCanvas instances with
page-break-after: always; no@pageoverride, so the browser picks paper size. - /play/[deckSlug]/[variantSlug]/[slot]/ — single-slot Play-UI renderer with keyboard nav - Static per-slot route: dynamic-imports
slides/{variant}/{slot}-{slug}.astrointo SlideCanvas, falling back to DecomposeFirstPlaceholder. - /toc/[deckSlug]/ — deck-level dual-surface review matrix (one row per slot × one column per variant) - The deck-level review matrix: variants × slots with dual-surface ratings per cell, distinct from the per-variant
/toc/[deck]/[variant]/. - /toc/[deckSlug]/[variantSlug]/ — bird’s-eye-view audit dashboard with rank pills + scaffold buttons - Per-variant TOC — one row per slot with five rank pills and a scaffold button POSTing to
/api/slide-decompose. Read-write in dev only.
Runtime
- runtime/mode-switcher — TS factory createModeSwitcher({client, defaultMode, respectSystemPreference}); per-client localStorage namespace - Three-mode state machine factory, namespaced to
{client}:modein localStorage and installed as awindow.modeSwitchersingleton.