WORK-431
ID:WORK-431Status:ready

reveal/stagger engine facet

The gate for SPEC-105 (§1–§3): a shared, closed reveal modifier plus an orthogonal stagger modifier on section-level runes, emitting the generic data-* hooks and the per-child index the motion CSS and behaviour read. Pure intent → attributes; no look here.

Priority:highComplexity:moderateMilestone:v0.24.0Source:SPEC-105
main View source

Criteria completion

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

Tracking started Jun 15 — check back for trends.

Relationships

Implements 1
Related 5
Branches 4
main current ready
main readyclaude/milestone-v0.24.0-split readyclaude/v023-bg-motion-breakdown readyclaude/defer-work-417 ready

Scope

  • Closed vocabulary — reveal accepts none | fade | slide | scale | blur (matches set; default none; unknown = build error). A cross-rune facet like media-position/tint, configured once on section-level runes (hero, feature, bento, cta, card, steps, pricing, testimonial, playlist, …) — not per rune.
  • Emission — data-reveal="<value>" on the rune root; data-stagger when set; --rf-reveal-index (0,1,2,…) on each enumerated child (reuse the existing numbered-sequence child enumeration). Stagger is a silent no-op on single-child runes.
  • Index marker contract — children carry the index as the global stagger hook (WORK-432 targets [style*="--rf-reveal-index"], not > *), so "which children cascade" is decided here in config, never in CSS.
  • Intent only: no keyframes, durations, or transforms in this item (those are WORK-432).

Acceptance Criteria

  • A closed reveal modifier (none|fade|slide|scale|blur, default none, unknown = build error) is available on section-level runes as a shared engine facet; it emits data-reveal on the root and --rf-reveal-index on enumerated children.
  • stagger is an orthogonal modifier composing with any character; it emits data-stagger, is a silent no-op on single-child runes, and stamps the per-child index marker that drives the cascade.
  • The "which children cascade" decision lives in rune config (child enumeration), not CSS; unit tests cover value emission, the matches validation, the index marker, and the single-child no-op.

Dependencies

  • None — the SPEC-105 gate. WORK-432 and WORK-433 consume these attributes.

References

  • SPEC-105 §1–§3 · packages/transform/src/engine.ts · packages/runes/src/config.ts · named-set discipline SPEC-088.