editor/docs/reference/jsx/sequences.md
konstantin-paulus 7372c40429 Update documentation references and refactor knowledge handling
- Changed references from `knowledge` to `docs` in README and various files to reflect the new documentation structure.
- Updated `.gitignore` to exclude the `docs` directory instead of `knowledge`.
- Refactored `forge.config.ts` and `main.ts` to utilize the new `docs` directory for staging resources.
- Introduced `stage-docs.mjs` script to manage the staging of documentation files.
- Added new documentation files under `docs/`, including `INSTRUCTIONS.md`, brand guidelines, and design specifications.
- Removed outdated `knowledge` related tests and files to streamline the codebase.
2026-09-11 20:33:57 +02:00

1.8 KiB
Raw Permalink Blame History

Sequences

<sequence> is a track-like container for back-to-back clips. It carries no transform and no timing of its own, and does not position its children at mount — give each child an explicit start (see timing.md). What it adds is clip-to-clip transitions on direct children, and, in the editor, a non-overlapping invariant: dragging or regrouping clips trims or removes whatever they land on.

<sequence name="A-roll">
  {/* timeline 0–12 */}
  <video src="b-roll/intro.mp4" width={1920} height={1080} start={0} end={12} />
  {/* timeline 12–2:30, source from 5 s */}
  <video src="b-roll/main.mp4" width={1920} height={1080} start={12} end="02:30" sourceIn={5} />
  {/* from 2:30, plays to its natural end */}
  <video src="b-roll/outro.mp4" width={1920} height={1080} start="02:30" />
</sequence>

The next clip's start must match the previous clip's on-timeline end — its end, or from the source side start + (sourceOut - sourceIn). Here main ends at 02:30, so outro starts there. Giving main an end places the next cut at a round timeline mark without computing source lengths.

Props

Prop Type Meaning
id, name string Address and label.

Purely structural; nothing else. A sequence is a group with its spatial identity taken away — x, y, rotation and scale on one are ignored, and its children are positioned against whatever contains the sequence. Like a group it spans its children in time, so it needs no timing of its own.

Direct children of a sequence may declare a transition into the following clip. An <adjustmentLayer> inside a sequence acts on what sits below the sequence, not on the clip before it inside one.