ID:SPEC-094Status:accepted
Theme system foundations for multi-theme development
Name:v0.23.0Status:planning
v0.23.0 — Surface axes & the skeleton/skin extraction
The second slice of the SPEC-094 theme-platform epic. Where v0.22.0 tokenized type and built the gallery safety net, v0.23.0 attacks the differentiation surface: it extracts skeleton from skin and replaces the last cross-rune rune-name lists with engine-emitted, theme-overridable config.
Its centerpiece is SPEC-107 — the surface-axis decomposition. It amends SPEC-094 §8: the single surface enum (card/banner/inline/inset) splits into three orthogonal, theme-defaulted axes — an ordered elevation depth ladder (sunken/flush/flat/raised/floating, folding in today's shadow-only elevation), width carrying the bleed, and a page-section-family prominence scale (quiet/normal/prominent/display). The motivating outcome: the same recipe reads as a bordered card in prose and a full-bleed, large-title hero at the top of a page.
Progress 0/12 work items
Relationships
Related 8
ID:SPEC-107Status:accepted
Elevation, prominence & the surface-axis decomposition
ID:WORK-423Status:ready
elevation depth-ladder axis
Priority:highComplexity:complexMilestone:v0.23.0
ID:WORK-424Status:ready
prominence axis (page-section family)
Priority:highComplexity:moderateMilestone:v0.23.0
ID:WORK-425Status:ready
Lumina: map the axes + retire the static surface groups
Priority:highComplexity:complexMilestone:v0.23.0
ID:WORK-426Status:pending
Migration + docs for the surface axes
Priority:mediumComplexity:moderateMilestone:v0.23.0
ID:WORK-427Status:pending
Demonstrate the axes: full-bleed hero recipe / playlist
Priority:mediumComplexity:simpleMilestone:v0.23.0
ID:WORK-410Status:pending
Skeleton/skin split — spike
Priority:highComplexity:moderateMilestone:v0.22.0
Work Items
Draft 2
WORK-426 main
Migration + docs for the surface axes Land the breaking elevation rename safely and bring the site + docs onto the new vocabulary (SPEC-107 §5).
0/3 criteria
WORK-427 main
Demonstrate the axes: full-bleed hero recipe / playlist Close the loop on the use case that motivated SPEC-107: the same content rune reading as a contained card and as a full-width hero, by composing the axes — no rune fork.
0/2 criteria
Ready 10
WORK-423 main
elevation depth-ladder axis Turn elevation into the universal chrome/depth axis from SPEC-107: an ordered semantic ladder emitted as data-elevation, superseding both §8's surface enum and today's shadow-only none/sm/md/lg scale. The foundation the rest of the milestone builds on.
0/5 criteria
WORK-424 main
prominence axis (page-section family) Add the header-emphasis axis from SPEC-107: prominence scales a rune's page-section header (eyebrow / title / blurb / rhythm), selecting its typographic register. Unlike elevation it is not universal — it is available only to runes that carry the page-section header model.
0/3 criteria
WORK-425 main
Lumina: map the axes + retire the static surface groups Paint the SPEC-107 axes in Lumina and retire the rune-name lists in surfaces.css — the last cross-rune file that enumerates runes (SPEC-094 §8).
0/3 criteria
WORK-428 claude/v023-bg-motion-breakdown
bg guest body + engine relocation + bare-surface guardrail The gate for SPEC-104: teach bg to host a live sandbox as a bare, presentational, full-bleed backdrop. Covers §1–§4 — the constrained body, the engine relocation that mirrors bg-video, the bare-surface guardrail, and boot-frame layering. Everything downstream (the preset, the showcase) builds on the data-bg-guest contract this establishes.
0/5 criteria
WORK-429 claude/v023-bg-motion-breakdown
sandbox bg preset (transform-resolved) SPEC-104 §5: make a reusable sandbox backdrop applicable by name (bg="midnight-waves") like any other preset, by adding a sandbox descriptor to BgPresetDefinition — resolved at transform time (not the identity engine, which has no file access), expanding into the WORK-428 data-bg-guest body.
0/4 criteria
WORK-430 claude/v023-bg-motion-breakdown
bg sandbox guest — docs + showcase SPEC-104 §6 + docs: document the bg guest body, the bare-surface guardrail, the sandbox preset (with the refrakt.config.json example), and the boot-frame layering; ship the music-blog backdrop pattern as a working showcase exercising the layout-cascade + SPEC-006 audio-bridge composition.
0/4 criteria
WORK-431 claude/v023-bg-motion-breakdown
reveal/stagger engine facet The gate for SPEC-105 (§1–§3): a shared, closed reveal modifier plus an orthogonal stagger modifier on section-level runes, emitting the generic data-* hooks and the per-child index the motion CSS and behaviour read. Pure intent → attributes; no look here.
0/3 criteria
WORK-432 claude/v023-bg-motion-breakdown
Motion dimension CSS + tokens SPEC-105 §4: a single dimensions/motion.css + motion tokens that render each reveal character — covering all section runes from one stylesheet, with the transform-composition and global-hook rules that keep it from becoming per-rune work.
0/4 criteria
WORK-433 claude/v023-bg-motion-breakdown
reveal IntersectionObserver behaviour + enhancement gating SPEC-105 §5–§6: the timing trigger and the no-JS/SSR safety. A tiny IntersectionObserver behaviour flips data-in-view; enhancement gating guarantees the static page is always complete. JS = when, CSS = how.
0/3 criteria
WORK-434 claude/v023-bg-motion-breakdown
Motion dimension — docs + showcase SPEC-105 §7 + docs: a theme-authoring motion dimension page and an author-facing reveal/stagger reference, plus a feature-stagger demonstration.
0/3 criteria