Skip to content

Spec update: docs/layers.feature (captions split out, text stays in graphics, one raea export xml) - #167

Merged
1 commit merged into
shinyobjectz:mainfrom
wackyza:layers-spec-v2
Nov 18, 2026
Merged

1 commit merged into
shinyobjectz:mainfrom
wackyza:layers-spec-v2

Conversation

@wackyza

@wackyza wackyza commented Nov 17, 2026

Copy link
Copy Markdown
Collaborator

A heads-up on what's coming: an update to the layers spec merged in #166, after working through the implementation. Spec only, no code.

What changed

  • Text stays in the graphics layer. Splitting words from the graphics they're built into (kinetic type, words cut from a shape, a word behind a graphic) caused more problems than it solved. A separate text layer could come later as opt-in only (data-raea-role="text"), never guessed.
  • Captions are the only thing split out of graphics. They're marked with data-raea-role="caption", and nothing is guessed.
  • One raea export xml for Premiere and Resolve. An editor gets its own command only if testing shows it reads the XML differently.
  • Leaner:
    • Compositing the layers back together is a test of the method, not something every export runs.
    • An export always renders its own reference.
    • No raea check warning for unmarked captions.
    • No moving covered captions: captions always go on top.
  • What a prototype of the render passes showed:
    • The page keeps only the data-raea- props it names.
    • It draws nothing inside a hidden element, so the captions pass clears the elements that hold a caption instead of hiding them.
    • 3D is drawn by Bevy, which CSS can't hide, so the captions and under layers leave the 3D out of the scene and keep its cameras.

What follows

The implementation is being built and tested end to end on my fork first. It will come as a set of stacked PRs:

  1. Caption marker + RAEA_LAYER passes
  2. layers.json / raea export layers / SRT
  3. CapCut moved onto layers.json
  4. raea export xml

That way each one has been proven working with the others before you merge it.

🤖 Generated with Claude Code

…the only layer split out of it

docs/layers.feature after working through the implementation:
- Text is part of the graphics layer. Pulling words apart from the graphics they're built into (kinetic type, words
  cut from a shape, a word behind a graphic) caused more problems than it solved; a text layer may come later, opt-in
  only (an element marked data-raea-role="text"), never guessed.
- Captions are the only layer split from the graphics: marked data-raea-role="caption", nothing guessed.
- One `raea export xml` for Premiere and Resolve; a command of an editor's own only if testing finds it reads the XML
  differently.
- Leaner: the layers composited back is a test of the method, not run on every export; an export always renders its
  own reference; no `raea check` heuristic for unmarked captions; no moving covered captions (captions go on top).
- What rendering the passes taught: the page keeps only the data-raea- props it names, it draws nothing inside a
  hidden element (so the captions pass clears what holds a caption), and 3D is Bevy's, so a layer without it leaves
  the 3D out of the scene and keeps its cameras.

Spec only; no code.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@shinyobjectz shinyobjectz closed this pull request by merging all changes into shinyobjectz:main in 6e19fb5 Nov 18, 2026
hshalab pushed a commit to hshalab/raea that referenced this pull request Nov 18, 2026
…jectz#171, shinyobjectz#172) on main for 0.1.8

raea export layers and layers.json, CapCut drafts written from layers.json with a captions track, raea export xml
(FCP7 XML for Premiere Pro and DaVinci Resolve), footage that moves, is cut or fades keyed in every export, and the
delivery and words guides teaching them (raea-skills shinyobjectz#99, merged onto raea-skills main).

Conflict: engine/cli/src/cli.rs's help, where main added raea wear and raea setup motion beside Zach's raea export
layers and raea export xml; both kept. The skills pin is raea-skills main with shinyobjectz#99 merged (f37e5e3).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants