Skip to content

Commit 2094866

Browse files
committed
Update roadmap with delivered phase status
Mark Phase 3 P2 and Phase 4d as delivered, note the shipped `spectre-ui` and token versions, and update the execution order to reflect completed semantic primitive and layout recipe work.
1 parent d185591 commit 2094866

2 files changed

Lines changed: 27 additions & 28 deletions

File tree

ROADMAP.md

Lines changed: 24 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -80,17 +80,18 @@ improvements without expanding package ownership beyond Layer 2.
8080

8181
---
8282

83-
### P2: Semantic UI Primitives — Active
83+
### P2: Semantic UI Primitives — Delivered
8484

85-
All three token groups exist in `@phcdevworks/spectre-tokens@2.8.0`. This
86-
work is unblocked and is the current priority.
85+
All three token groups exist in `@phcdevworks/spectre-tokens@3.2.0` and were
86+
delivered in `@phcdevworks/spectre-ui@2.6.0`.
8787

88-
Deliverables:
88+
Delivered:
8989

90-
- Add link styling: `link.default`, `link.hover`, `link.active`, `link.visited`.
91-
- Add interactive surface state styling: `surface.hover`, `surface.selected`,
90+
- Link styling: `link.default`, `link.hover`, `link.active`, `link.visited`
91+
via `.sp-link`.
92+
- Interactive surface state styling: `surface.hover`, `surface.selected`,
9293
`surface.active`.
93-
- Add divider styling: `surface.divider`.
94+
- Divider styling: `surface.divider` via `.sp-divider`.
9495

9596
Per-primitive standard: token-backed CSS in the narrowest relevant entry point;
9697
recipe or utility exposure only when the public class contract is stable;
@@ -138,15 +139,13 @@ auditable recipe families rather than large framework components.
138139
the scoped breakdown. **Token audit confirmed a real gap, now resolved
139140
upstream**: unlike every recipe added since Phase 4b (Container/Stack/
140141
Section/Grid all consumed tokens that already existed), there was no
141-
width/sizing scale in `spectre-tokens` at all. `spectre-tokens` has since
142-
implemented `layout.sidebar.width` (`16rem`) and
143-
`layout.container.maxWidthProse` (`65ch`) in source, but has not yet
144-
published — confirm the new version is live on npm before starting this
145-
phase's recipe work. Sidebar's mobile behavior is decided:
146-
a slide-out drawer below `breakpoints.md`, with this package owning the
147-
off-canvas CSS contract (position, transition, backdrop, data-attribute
148-
selector) and the adapter (`spectre-ui-astro`) owning the toggle
149-
interaction — first recipe with an interactive-state contract.
142+
width/sizing scale in `spectre-tokens` at all. The token gap was resolved,
143+
and this work shipped by `spectre-ui@2.5.0`: Stack `basis`,
144+
Container `maxWidth`, Sidebar, and Footer recipes are delivered. Sidebar's
145+
mobile behavior is a slide-out drawer below `breakpoints.md`, with this
146+
package owning the off-canvas CSS contract (position, transition, backdrop,
147+
data-attribute selector) and the adapter (`spectre-ui-astro`) owning toggle
148+
interaction.
150149

151150
### Standard deliverables per family
152151

@@ -238,18 +237,18 @@ migration window.
238237
2. **Phase 2** — done.
239238
3. **Phase 3 P0** — complete the v1.7.0 release handoff.
240239
4. **Phase 3 P1** — watch for the next published token release; run a sync pass.
241-
5. **Phase 3 P2** — add semantic primitives once their tokens publish: Link,
242-
interactive surface states, Divider.
243-
6. **Phase 4** — add component recipe families in this order when their tokens
244-
exist: Nav, Toast, Tooltip, Dropdown, Modal.
240+
5. **Phase 3 P2** — done. Link, interactive surface states, and Divider
241+
shipped in `spectre-ui@2.6.0`.
242+
6. **Phase 4** — done. Nav, Toast, Tooltip, Dropdown, Modal delivered.
245243
7. **Phase 4b** — done. Container, Stack, Section delivered.
246244
8. **Phase 4c (v1)** — done. Grid recipe delivered.
247245
9. **Phase 4c (v2)** — deferred until a real downstream need surfaces:
248246
column span, offsets, custom track sizing, per-breakpoint override.
249-
10. **Phase 4d** — not started, real downstream need confirmed. Add Stack
250-
width/basis option, Container `maxWidth` option, and new Sidebar/Footer
251-
layout-pattern recipes (modeled on the existing `SpNav` top-bar pattern).
252-
11. **Phase 5 P0** — add downstream regression coverage as adapter usage
247+
10. **Phase 4d** — done. Stack `basis`, Container `maxWidth`, Sidebar, and
248+
Footer layout-pattern recipes delivered.
249+
11. **Phase 4e** — done. Checkbox, Radio, Select, Textarea, Fieldset, and
250+
Label recipes shipped in `spectre-ui@2.6.0`.
251+
12. **Phase 5 P0** — add downstream regression coverage as adapter usage
253252
reveals gaps (continuous).
254-
12. **Phase 5 P1** — define deprecation mechanics before any public class,
253+
13. **Phase 5 P1** — define deprecation mechanics before any public class,
255254
recipe option, or variant is retired.

TODO.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -455,7 +455,7 @@ Confirmed token shape once published:
455455

456456
---
457457

458-
## Phase 4e — Form-Field Recipe Expansion (Unblocked — tokens published in 3.2.0)
458+
## Phase 4e — Form-Field Recipe Expansion (done, v2.6.0)
459459

460460
Cross-repo audit (`spectre-components` vs. `spectre-ui-astro`) found
461461
`sp-checkbox`, `sp-fieldset`, `sp-label`, `sp-radio`, `sp-select`, and
@@ -466,8 +466,8 @@ backing recipe here, unlike every other component family. Was gated on
466466
`component.fieldset`, `component.label`) publishing. Confirmed published in
467467
`@phcdevworks/spectre-tokens@3.2.0` (`--sp-checkbox-*`, `--sp-radio-*`,
468468
`--sp-select-*` etc. present in installed `node_modules` dist CSS, checked
469-
2026-06-28); `package.json` here already declares `^3.2.0`. Start this work
470-
next, alongside Phase 3 P2 above.
469+
2026-06-28); `package.json` here already declares `^3.2.0`. Delivered in
470+
`@phcdevworks/spectre-ui@2.6.0` alongside Phase 3 P2.
471471

472472
### P0: Add Recipes Now That Upstream Tokens Are Published
473473

0 commit comments

Comments
 (0)