V0.23.0
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.

Not enough history yet — burndown needs at least one completed day of activity.

Progress 7/7 work items

Relationships

Related 13
History 7
  1. 860a8b6
    Content editedby bjornolofandersson
  2. 361be4c
    Created (planning)by bjornolofandersson
  3. b2894b9
    Content editedby Claude
    plan: renumber skeleton/skin work items 428-431 → 435-438 (ID collision)
  4. a89abde
    Content editedby Claude
    Merge remote-tracking branch 'origin/main' into claude/defer-work-417
  5. 8ac5fb6
    Content editedby Claude
    plan: draft v0.23.0 skeleton/skin extraction work items (WORK-428..431)
  6. eebbc86
    Content editedby Claude
    plan: break down SPEC-104 (bg sandbox guests) + SPEC-105 (motion) for v0
  7. d3617c0
    Content editedby Claude
    plan: SPEC-107 surface-axis decomposition + v0.23.0 work items

Work Items

Done 7
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.
high complex
5/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.
high moderate
3/3 criteria
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).
medium moderate
3/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.
medium simple
2/2 criteria
WORK-435 main
Spacing token contract + Lumina refactor
The prerequisite the WORK-410 spike surfaced: a clean skeleton/skin split needs spacing to be tokenized, exactly as the type split needed WORK-404/WORK-405. Skeleton references spacing tokens by name; skin owns their values — but today Lumina hardcodes magnitudes (0.5rem, 0.375rem, 0.8125em, …), so the skin layer can't retune them without restating structure. The gate for the re-bucketing.
high complex
3/3 criteria
WORK-436 main
@refrakt-md/skeleton package + @layer infrastructure
Stand up the packaging + cascade-layer infrastructure the WORK-410 spike settled, so skeleton and skin can ship and version separately. The structural home the re-bucketing fills.
high moderate
3/3 criteria
WORK-437 main
Icon-from-config: lift embedded data-URI glyphs out of CSS
The "content, not CSS" finding from the WORK-410 spike (SPEC-094 §8's icon-from-config): rune CSS embeds glyph shapes as data:image/svg+xml mask-images. Move them to the theme icon registry so a theme swaps glyph sets without touching CSS.
medium simple
2/2 criteria