Refrakt Plan Hub

Add a build-time soft warning for raw CSS that a structured facet now covers, and document gradients/escape-hatch/overlay in the bg reference.

Relationships

main current done

Jun 9, 03:07 PM1731c3d
- ☑ A build-time soft warning flags a raw gradient/background in `style` or `overlay` that a structured facet covers, pointing to the facet.
- ☑ The `bg` reference docs document gradients (facets + presets), the escape hatch (contract + config home), and the `overlay` change, cross-linked with SPEC-087/086.
by bjornolofandersson
Jun 9, 03:04 PM3952770
Content editedby Claude
plan: mark Batch 4 (SPEC-088 bg gradients & scrim) done + changeset
Jun 9, 08:44 AM9c0545a
Created (ready)by bjornolofandersson
Jun 9, 08:34 AM1da59d6
Content editedby Claude
plan: add v0.20.0 milestone and break down SPEC-086..091 into work items

A build-time soft warning flags a raw gradient/background in style or overlay that a structured facet covers, pointing to the facet.
The bg reference docs document gradients (facets + presets), the escape hatch (contract + config home), and the overlay change, cross-linked with SPEC-087/086.

site/content/runes/bg.md. SPEC-088 §2–§3.

Completed: 2026-06-09

Branch: claude/spec-088-bg-gradients-scrim

validate.ts soft-lint: a build-time warning when a background preset's style escape hatch contains a raw gradient the structured gradient field now covers (raw overlay warns at runtime via warnRawOverlay).
bg.md reference rewritten: gradient facets + token-name stops + presets, the overlay vocabulary + deprecation, the structured scrim (incl. foreground polarity), and the escape-hatch contract + config homes; cross-linked to the surface model.