- 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.
27 lines
1.8 KiB
Markdown
27 lines
1.8 KiB
Markdown
# 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.
|