WORK-371
ID:WORK-371Status:ready

Structured overlay/scrim facets + raw-string overlay deprecation path

Split the conflated overlay string into a structured flat-wash overlay and a structured scrim legibility facet, with a deprecation path for the raw-string passthrough.

Priority:mediumComplexity:complexMilestone:v0.20.0Source:SPEC-088
claude/scrim-tone-foreground-tint View source

Criteria completion

Criteria completion: 0 of 4 (0%) checked; tracking started on Jun 9, no incremental history yet0%25%50%75%100%Jun 9Jun 15

Tracking started Jun 9 — check back for trends.

Relationships

Implements 1
Branches 3
claude/scrim-tone-foreground-tint current ready
claude/spec-088-bg-gradients-scrim donemain doneclaude/mcp-server-verify-4lnxej ready
History 2
  1. d2c3251
    Created (ready)by bjornolofandersson
  2. 1da59d6
    Content editedby Claude
    plan: add v0.20.0 milestone and break down SPEC-086..091 into work items

Acceptance Criteria

  • overlay is constrained to none|dark|light (+ optional token reference / opacity).
  • A structured scrim facet provides legibility behind overlaid text via scrim-type (gradient default | frost), scrim-strength, scrim-blur, scrim-tone (dark|light, explicit), targeting the bg overlay or the media well (SPEC-087 routing).
  • scrim-tone sets the overlaid content's foreground polarity (text/muted tokens), not just the wash — a dark scrim yields light text — so text colour follows the scrim, not the base surface.
  • The unvalidated raw-string overlay passthrough is deprecated with a build warning for one minor then removed, gated on scrim shipping.

Approach

overlay passthrough in engine.ts. Cover-mode scrim consumer is SPEC-089. SPEC-088 §3.

References

  • SPEC-088