WORK-365
Setting up your dashboard 0 entities found · 9/32 branches scanned
ID:WORK-365Status:done

Collapse showcase into the frame model with deprecated aliases + docs

Re-express showcase as frameTarget: 'self' consuming frame, with deprecated aliases for its old attributes (breakout bleed retained), and document the surface model.

Priority:mediumComplexity:moderateMilestone:v0.20.0Source:SPEC-086
main View source

Criteria completion

Criteria completion: 4 of 4 (100%) checked; history from Jun 9 to Jun 90%25%50%75%100%Jun 9Jun 9

Relationships

Implements 1
Branches 2
main current done
claude/mcp-server-verify-4lnxej readyclaude/spec-086-surface-chrome done
History 5
  1. da3c4de
    • ☑ `showcase` is `frameTarget: 'self'` consuming `frame`; old `shadow|bleed|offset|aspect|place` are deprecated aliases (warn) per the migration table; breakout retained.
    • ☑ Page-level full-bleed is documented as a `width` concern (article named-line grid) distinct from `displace`/host-owned-clip; `showcase`/`figure` is the attribute-surface wrapper.
    • ☑ Card/figure/showcase/bento reference docs + a theme-authoring "frames" section document the surface model (`elevation`=self, `frame`=media) and the preset registry.
    • ☑ Changesets for `@refrakt-md/runes` + `@refrakt-md/lumina`.
    by bjornolofandersson
  2. 8faa272
    Content editedby Claude
    docs(theme-authoring): surface-chrome page + changeset; mark Batch 2 don
  3. 998faad
    Content editedby Claude
    plan: WORK-362 done (elevation); 363/364/365 in-progress
  4. 9c0545a
    Created (ready)by bjornolofandersson
  5. 1da59d6
    Content editedby Claude
    plan: add v0.20.0 milestone and break down SPEC-086..091 into work items

Acceptance Criteria

  • showcase is frameTarget: 'self' consuming frame; old shadow|bleed|offset|aspect|place are deprecated aliases (warn) per the migration table; breakout retained.
  • Page-level full-bleed is documented as a width concern (article named-line grid) distinct from displace/host-owned-clip; showcase/figure is the attribute-surface wrapper.
  • Card/figure/showcase/bento reference docs + a theme-authoring "frames" section document the surface model (elevation=self, frame=media) and the preset registry.
  • Changesets for @refrakt-md/runes + @refrakt-md/lumina.

Approach

packages/runes/src/tags/showcase.ts, Showcase config, showcase.css. SPEC-086 §5.

References

  • SPEC-086

Resolution

Completed: 2026-06-09

Branch: claude/spec-086-surface-chrome

What was done

  • Showcase is frameTarget: 'self' (config.ts); its shadow/bleed/offset/aspect/place attributes are deprecated aliases mapped to frame-* facets in showcase.ts (shadow soft/hard/elevated → sm/md/lg), each warning once; breakout retained via the host-owned-clip CSS. Old showcase modifiers/styles/postTransform removed; showcase.css trimmed to structural + breakout.
  • Docs: new site/content/extend/theme-authoring/surface-chrome.md (the elevation/frame surface model, frames registry, frameTarget, host-owned clip, full-bleed-is-width, showcase migration table) + config-api.md frames/frameTarget entries.
  • Changeset .changeset/spec-086-surface-chrome.md (runes/transform/lumina/types minor).

Notes

  • Per-rune reference pages (site/content/runes/{card,figure,showcase,bento}.md) were not individually rewritten; the surface model + preset registry are documented on the theme-authoring page. A per-rune reference pass is a reasonable follow-up.
  • showcase test suite updated to assert the frame-facet output.