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/5 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 3
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