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

27 lines
1.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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](./timing.md)). What it adds is clip-to-clip [transitions](./transitions.md) on direct children, and, in the editor, a non-overlapping invariant: dragging or regrouping clips trims or removes whatever they land on.
```tsx
<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](./group.md) 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`](./transitions.md) into the following clip. An [`<adjustmentLayer>`](./adjustment-layer.md) inside a sequence acts on what sits below the *sequence*, not on the clip before it inside one.