Skip to content

Open source CapCut alternative.

TypeScript

feat(site): a transition bar hides like anything else on the timeline [rebuild]

David Lef7b88be0ae70
diff --git a/docs/guides/cut/README.md b/docs/guides/cut/README.md
index c1d5ac39..5330fe77 100644
--- a/docs/guides/cut/README.md
+++ b/docs/guides/cut/README.md
@@ -40,7 +40,7 @@ The client probes the engine's health endpoint (dedicated port first, dev server
**A handover is on the picture or on the sound.** A transition is a blend at the cut rather than an overlap: the clips still abut, the layout never moves, and the incoming clip starts exactly at the cut. Most styles blend the picture across the outgoing clip's last seconds. The cross dissolve hands over on the sound instead — the picture cuts while the two clips ramp past each other, half the handover either side of it. Its bar sits across the cut for that reason, where every other bar ends on the boundary it plays. The two windows sit on separate fields, so everything that draws the picture reads a plain cut and only the mix ramps: the preview, the in-tab export, and the ffmpeg graph the engine and the worker build all follow from that one split. A sound handover needs a second clip's sound to cross into, so a bar of it parked on a clip's open head or tail plays nothing.
-**A crossing needs handle, and holds its loudness.** Clips never overlap, so for the length of a cross dissolve each one plays into the other's time out of its handle — the media its trim left behind, the outgoing clip past its out point and the incoming clip before its in point. That is what makes both sides really audible over a cut their pictures hard-join, and it is why the ramps are equal-power (sine and cosine) rather than straight lines: two signals meeting at half level sum to the loudness they each had, so the mix never dips through the join. A clip trimmed to the end of its source has no handle to reach into; its side of the crossing stops at the cut, and the handover reads as a dip instead of a crossing. Every renderer works from the same two numbers on a span — how far the crossing runs, and how far each side reaches — so the preview, the browser fold and the ffmpeg graph land on one sound. It opens at 0.3 seconds, shorter than a picture blend's half second: that covers the jump in room tone at a cut while staying under the length where the ear starts hearing two voices, and it asks less of the trim each clip has left. It is picked where the other work on the sound is picked — the Effects tab's Sound family — while the styles that blend the picture are picked from the Transitions tab.
+**A crossing needs handle, and holds its loudness.** Clips never overlap, so for the length of a cross dissolve each one plays into the other's time out of its handle — the media its trim left behind, the outgoing clip past its out point and the incoming clip before its in point. That is what makes both sides really audible over a cut their pictures hard-join, and it is why the ramps are equal-power (sine and cosine) rather than straight lines: two signals meeting at half level sum to the loudness they each had, so the mix never dips through the join. A clip trimmed to the end of its source has no handle to reach into; its side of the crossing stops at the cut, and the handover reads as a dip instead of a crossing. Every renderer works from the same two numbers on a span — how far the crossing runs, and how far each side reaches — so the preview, the browser fold and the ffmpeg graph land on one sound. It opens at 0.3 seconds, shorter than a picture blend's half second: that covers the jump in room tone at a cut while staying under the length where the ear starts hearing two voices, and it asks less of the trim each clip has left. It is picked where the other work on the sound is picked — the Effects tab's Sound family — while the styles that blend the picture are picked from the Transitions tab. A bar can also be hidden, like anything else on the timeline: it grays out and plays nothing while keeping the cut it sits on, so the joint runs hard and the blend is one click away again.
## The preview
diff --git a/site/src/cut/components/Timeline.tools.ts b/site/src/cut/components/Timeline.tools.ts
index fd8cf9ac..dd163145 100644
--- a/site/src/cut/components/Timeline.tools.ts
+++ b/site/src/cut/components/Timeline.tools.ts
@@ -89,12 +89,16 @@ export const TIMELINE_TOOLS = [
{
name: "set_track_hidden",
description:
- "Hide or show a whole timeline row at once — the track header's eye toggle. Applies to every item on that row: a hidden video track plays black and silent, a hidden soundtrack lane is silent, hidden text (title) lanes and subtitle tracks drop out of the picture. Items stay on the timeline, grayed.",
+ "Hide or show a whole timeline row at once — the row's eye toggle. Applies to every item on that row: a hidden video track plays black and silent, a hidden soundtrack lane is silent, hidden text (title) lanes and subtitle tracks drop out of the picture, and hidden transitions leave their cuts hard. Items stay on the timeline, grayed. The transitions row is the only one of its kind, so omit `track` for it.",
inputSchema: obj({
- kind: { type: "string", enum: ["video", "soundtrack", "text", "subtitles"], description: "Which row kind" },
- track: num("Track/lane index, 0-based"),
+ kind: {
+ type: "string",
+ enum: ["video", "soundtrack", "text", "subtitles", "transitions"],
+ description: "Which row kind",
+ },
+ track: num("Track/lane index, 0-based; omit for transitions"),
hidden: bool("true to hide"),
- }, ["kind", "track", "hidden"]),
+ }, ["kind", "hidden"]),
},
{
name: "set_track_muted",
diff --git a/site/src/cut/components/Timeline.tsx b/site/src/cut/components/Timeline.tsx
index 421fd7fc..f4f3582d 100644
--- a/site/src/cut/components/Timeline.tsx
+++ b/site/src/cut/components/Timeline.tsx
@@ -561,7 +561,8 @@ export function Timeline() {
audioTop: number | null;
textTop: number | null;
subTop: number | null;
- }>({ video: [], audioTop: null, textTop: null, subTop: null });
+ xTop: number | null;
+ }>({ video: [], audioTop: null, textTop: null, subTop: null, xTop: null });
useEffect(() => {
const el = scrollRef.current;
if (!el) return;
@@ -578,16 +579,18 @@ export function Timeline() {
const audioTop = contentY("[data-tl-arows]");
const textTop = contentY("[data-tl-trows]");
const subTop = contentY("[data-tl-srows]");
+ const xTop = contentY("[data-tl-xrows]");
setGutterYs((prev) =>
prev.audioTop === audioTop &&
prev.textTop === textTop &&
prev.subTop === subTop &&
+ prev.xTop === xTop &&
prev.video.length === video.length &&
prev.video.every(
(v, i) => v.track === video[i].track && v.y === video[i].y && v.h === video[i].h
)
? prev
- : { video, audioTop, textTop, subTop }
+ : { video, audioTop, textTop, subTop, xTop }
);
});
// Measured width of the scroll viewport, so the ruler and tracks always draw
@@ -801,7 +804,7 @@ export function Timeline() {
// Right-click on an element bar: a small popover to hide or show it — and,
// when the click landed on a keyframe diamond, to remove that key.
const [barMenu, setBarMenu] = useState<
- { x: number; y: number; id: string; key?: number } | null
+ { x: number; y: number; id: string; key?: number; transition?: boolean } | null
>(null);
useEffect(() => {
if (!barMenu) return;
@@ -2447,6 +2450,7 @@ export function Timeline() {
// A parked bar reads muted: it is on the row but playing
// nothing until a boundary lines up with it.
playing ? "bg-[#2B6FD4]" : "bg-muted-foreground/50",
+ x.t.hidden && "opacity-40 grayscale",
selKeys.has(`transition:${x.t.id}`) && SELECTED_SHADOW,
// Mid-drag it rides over the zone it would land on, so
// the marked room stays readable underneath.
@@ -2460,9 +2464,23 @@ export function Timeline() {
}}
data-tl-sel={`transition:${x.t.id}`}
onPointerDown={(e) => moveTransition(e, x)}
+ onContextMenu={(e) => {
+ e.preventDefault();
+ setBarMenu({ x: e.clientX, y: e.clientY, id: x.t.id, transition: true });
+ }}
>
<Icon className="size-2.5 shrink-0" />
<span className="truncate">{x.label}</span>
+ <HideChip
+ hidden={!!x.t.hidden}
+ small
+ className="top-1/2 right-2 -translate-y-1/2"
+ onToggle={() =>
+ useEditor
+ .getState()
+ .updateTransition(x.t.id, { hidden: !x.t.hidden || undefined })
+ }
+ />
{/* Retiming pulls the loose end: an entrance runs forward
from the clip's head, everything else backward from the
boundary it sits on. */}
@@ -2917,6 +2935,18 @@ export function Timeline() {
/>
);
})}
+ {gutterYs.xTop !== null && transitions.length > 0 && (
+ <GutterToggle
+ kind="hide"
+ off={transitions.every((x) => x.t.hidden)}
+ partial={transitions.some((x) => x.t.hidden)}
+ reveal={trackHover}
+ top={gutterYs.xTop + TEXT_H / 2 - 8}
+ onToggle={() =>
+ useEditor.getState().setTransitionsHidden(!transitions.every((x) => x.t.hidden))
+ }
+ />
+ )}
{gutterYs.subTop !== null &&
Array.from({ length: subtitleLaneCount(subtitles) }, (_, lane) => {
const off = laneHidden(subtitles, lane);
@@ -2972,7 +3002,11 @@ export function Timeline() {
)}
{barMenu &&
(() => {
- const o = overlays.find((x) => x.id === barMenu.id);
+ // The same menu over either kind of bar: an element on the title
+ // rows, or a transition on its own row.
+ const o = barMenu.transition
+ ? (transitions.find((x) => x.t.id === barMenu.id)?.t ?? null)
+ : (overlays.find((x) => x.id === barMenu.id) ?? null);
if (!o) return null;
const item =
"flex w-full items-center gap-2 rounded-sm px-2 py-1.5 text-sm hover:bg-accent hover:text-accent-foreground";
@@ -3006,7 +3040,10 @@ export function Timeline() {
<button
className={item}
onClick={() => {
- useEditor.getState().updateOverlay(barMenu.id, { hidden: !o.hidden });
+ const s = useEditor.getState();
+ const hidden = !o.hidden || undefined;
+ if (barMenu.transition) s.updateTransition(barMenu.id, { hidden });
+ else s.updateOverlay(barMenu.id, { hidden: hidden ?? false });
setBarMenu(null);
}}
>
diff --git a/site/src/cut/components/TransitionsPanel.tools.ts b/site/src/cut/components/TransitionsPanel.tools.ts
index d9f0a722..cdf9545b 100644
--- a/site/src/cut/components/TransitionsPanel.tools.ts
+++ b/site/src/cut/components/TransitionsPanel.tools.ts
@@ -7,7 +7,7 @@
* renamed tool breaks the build until every side catches up.
*/
-import { num, obj, str, type AiToolDef } from "@/cut/lib/aiToolDef";
+import { bool, num, obj, str, type AiToolDef } from "@/cut/lib/aiToolDef";
import { ANIM_STYLE_IDS, TRANSITION_STYLE_IDS } from "@/cut/lib/types";
export const TRANSITIONS_TOOLS = [
@@ -33,6 +33,15 @@ export const TRANSITIONS_TOOLS = [
transitionId: str("Transition bar id, from editor_state `transitions`"),
}, ["transitionId"]),
},
+ {
+ name: "set_transition_hidden",
+ description:
+ "Hide or show one transition bar by its own id. A hidden bar stays on the transitions row (grayed) and keeps the cut it sits on, so nothing else claims that boundary, but plays nothing — the cut renders hard in the preview and in every export. Use it to try a cut without its blend; remove_transition is for deleting one outright.",
+ inputSchema: obj({
+ transitionId: str("Transition bar id, from editor_state `transitions`"),
+ hidden: bool("true to hide"),
+ }, ["transitionId", "hidden"]),
+ },
{
name: "set_animation",
description:
diff --git a/site/src/cut/lib/aiContext.ts b/site/src/cut/lib/aiContext.ts
index 0138eff2..fcaa4b4b 100644
--- a/site/src/cut/lib/aiContext.ts
+++ b/site/src/cut/lib/aiContext.ts
@@ -354,6 +354,7 @@ export function buildAiContext(opts?: { fullCues?: boolean; chatId?: string | nu
start: r(t.start),
seconds: r(t.seconds),
style: t.style,
+ ...(t.hidden ? { hidden: true } : {}),
...(plays.length > 0
? { plays: plays.map((p) => ({ at: p.kind, clipId: p.clipId })) }
: { parked: true }),
diff --git a/site/src/cut/lib/aiTools.ts b/site/src/cut/lib/aiTools.ts
index f4b88019..f150e86f 100644
--- a/site/src/cut/lib/aiTools.ts
+++ b/site/src/cut/lib/aiTools.ts
@@ -642,6 +642,15 @@ const toolRuns: Record<BrowserToolName, ToolRun> = {
return { removed: id, ...tracksAfter() };
},
+ set_transition_hidden: (s, input) => {
+ const id = String(input.transitionId ?? "");
+ const bar = s.transitions.find((t) => t.id === id);
+ if (!bar) throw new ToolError(`No transition bar with id ${id}.`);
+ const hidden = Boolean(input.hidden);
+ s.updateTransition(id, { hidden: hidden || undefined });
+ return { id, hidden, style: bar.style, seconds: bar.seconds };
+ },
+
set_animation: (s, input) => {
const clip = requireItem(s.clips, input.clipId, "video clip");
const which = input.which === "in" || input.which === "out" ? input.which : null;
@@ -1352,9 +1361,11 @@ const toolRuns: Record<BrowserToolName, ToolRun> = {
},
set_track_hidden: (s, input) => {
- if (!isNum(input.track) || input.track < 0)
+ // The transitions row is the one row there is only one of, so it names
+ // no track.
+ if (input.kind !== "transitions" && (!isNum(input.track) || input.track < 0))
throw new ToolError("track must be 0 or higher.");
- const track = Math.round(input.track);
+ const track = isNum(input.track) ? Math.round(input.track) : 0;
const hidden = Boolean(input.hidden);
switch (input.kind) {
case "video": {
@@ -1382,8 +1393,17 @@ const toolRuns: Record<BrowserToolName, ToolRun> = {
s.setSubtitleTrackMeta(track, { hidden: hidden ? true : undefined });
return { kind: "subtitles", track, hidden, cues: laneCues(s.subtitles, track).length };
}
+ case "transitions": {
+ // One row holds every bar, so the track index has nothing to pick.
+ const n = s.transitions.length;
+ if (!n) throw new ToolError("There are no transitions on the timeline.");
+ s.setTransitionsHidden(hidden);
+ return { kind: "transitions", hidden, transitions: n };
+ }
default:
- throw new ToolError('`kind` must be "video", "soundtrack", "text", or "subtitles".');
+ throw new ToolError(
+ '`kind` must be "video", "soundtrack", "text", "subtitles", or "transitions".'
+ );
}
},
diff --git a/site/src/cut/lib/store.test.ts b/site/src/cut/lib/store.test.ts
index 2d4835bb..90d74c4c 100644
--- a/site/src/cut/lib/store.test.ts
+++ b/site/src/cut/lib/store.test.ts
@@ -1008,6 +1008,56 @@ describe("bars and clip edges", () => {
expect(parkedTransitions(s().clips, s().transitions)).toEqual([]);
});
+ test("a hidden bar keeps its cut and renders nothing", () => {
+ const av = asset(8);
+ const a = vclip({ track: 0, start: 0, out: 4, assetId: av.id });
+ const b = vclip({ track: 0, start: 4, out: 4, assetId: av.id });
+ useEditor.setState({ assets: [av], clips: [a, b] });
+ s().setClipTransition(a.id, 0.8, "crossfade");
+ const bar = s().transitions[0];
+ s().updateTransition(bar.id, { hidden: true });
+ // The clip fields are what every renderer reads, so hiding has to clear
+ // them: the joint plays as a hard cut.
+ expect(s().clips[0].transition ?? 0).toBe(0);
+ expect(getClipSpans(s().clips, s().assets, 0)[0].transitionOut).toBe(0);
+ // It still owns the boundary, so nothing reports it as debris and no
+ // other bar can claim the same cut.
+ expect(s().transitions).toHaveLength(1);
+ expect(parkedTransitions(s().clips, s().transitions)).toEqual([]);
+ s().updateTransition(bar.id, { hidden: undefined });
+ expect(s().clips[0].transition).toBeCloseTo(0.8);
+ });
+
+ test("the transitions row hides and shows every bar at once", () => {
+ const av = asset(12);
+ const a = vclip({ track: 0, start: 0, out: 4, assetId: av.id });
+ const b = vclip({ track: 0, start: 4, out: 4, assetId: av.id });
+ const c = vclip({ track: 0, start: 8, out: 4, assetId: av.id });
+ useEditor.setState({ assets: [av], clips: [a, b, c] });
+ s().setClipTransition(a.id, 0.8, "crossfade");
+ s().setClipTransition(b.id, 0.8, "audiocross");
+ s().setTransitionsHidden(true);
+ expect(s().transitions.every((t) => t.hidden)).toBe(true);
+ const hidden = getClipSpans(s().clips, s().assets, 0);
+ expect(hidden[0].transitionOut).toBe(0);
+ expect(hidden[1].soundOut).toBe(0);
+ s().setTransitionsHidden(false);
+ const shown = getClipSpans(s().clips, s().assets, 0);
+ expect(shown[0].transitionOut).toBeCloseTo(0.8);
+ expect(shown[1].soundOut).toBeCloseTo(0.4);
+ });
+
+ test("a hidden bar survives a save", () => {
+ const av = asset(8);
+ const a = vclip({ track: 0, start: 0, out: 4, assetId: av.id });
+ const b = vclip({ track: 0, start: 4, out: 4, assetId: av.id });
+ useEditor.setState({ assets: [av], clips: [a, b] });
+ s().setClipTransition(a.id, 0.8, "crossfade");
+ s().updateTransition(s().transitions[0].id, { hidden: true });
+ const doc = serializeDoc(useEditor.getState());
+ expect(doc.transitions?.[0].hidden).toBe(true);
+ });
+
test("a cross dissolve reaches into the media each clip was trimmed from", () => {
const av = asset(8);
// Both clips are cut out of the middle of an eight-second source, so each
diff --git a/site/src/cut/lib/store.ts b/site/src/cut/lib/store.ts
index 93ea99ec..f8b8ccbb 100644
--- a/site/src/cut/lib/store.ts
+++ b/site/src/cut/lib/store.ts
@@ -438,6 +438,8 @@ export interface EditorState {
setAudioLaneHidden: (lane: number, hidden: boolean) => void;
/** Hide or show every title on one title lane, in one undo step. */
setTextLaneHidden: (lane: number, hidden: boolean) => void;
+ /** Hide or show every bar on the transitions row at once. */
+ setTransitionsHidden: (hidden: boolean) => void;
/** Reorder the occupied video tracks: the track sitting at z-index `from`
* (0 = the bottom track) lands at `to` and the rest close up around it.
* Tracks renumber to 0..n-1, so whatever lands at 0 becomes the spine. */
@@ -2549,6 +2551,16 @@ export const useEditor = create<EditorState>((baseSet, get, api) => {
get().updateOverlaysTransient(ids.map((id) => ({ id, patch: { hidden } })));
},
+ setTransitionsHidden: (hidden) => {
+ if (!get().transitions.some((t) => !!t.hidden !== hidden)) return;
+ push();
+ set((s) => ({
+ transitions: s.transitions.map((t) =>
+ !!t.hidden === hidden ? t : { ...t, hidden: hidden || undefined }
+ ),
+ }));
+ },
+
moveVideoTrack: (from, to) => {
const s = get();
const map = rowRenumber([...new Set(s.clips.map((c) => c.track))].sort((a, b) => a - b), from, to);
@@ -4782,7 +4794,9 @@ export function parkedTransitions(
): TimelineTransition[] {
if (transitions.length === 0) return [];
const roles = resolveTransitions(clips, transitions);
- return transitions.filter((t) => !(roles.get(t.id) ?? []).length);
+ // A hidden bar plays nothing on purpose; only a bar that lost its boundary
+ // is debris.
+ return transitions.filter((t) => !t.hidden && !(roles.get(t.id) ?? []).length);
}
/**
@@ -4838,6 +4852,10 @@ export function deriveTransitionFields(
const roles = resolveTransitions(clips, transitions);
const byBoundary = new Map<string, TimelineTransition>();
for (const t of transitions) {
+ // A hidden bar still holds its boundary — nothing else may claim it — and
+ // renders nothing, so the clip fields it would have written stay empty and
+ // the cut plays hard everywhere.
+ if (t.hidden) continue;
for (const r of roles.get(t.id) ?? []) byBoundary.set(`${r.kind}:${r.clipId}`, t);
}
let changed = false;
@@ -4884,6 +4902,7 @@ function sanitizeTransitions(raw: TimelineTransition[] | undefined): TimelineTra
start: t.start,
seconds: clampBarSeconds(t.seconds),
style: TRANSITION_STYLE_IDS.includes(t.style) ? t.style : "crossfade",
+ ...(t.hidden ? { hidden: true as const } : {}),
}));
return bars.filter(
(t, i) =>
diff --git a/site/src/cut/lib/types.ts b/site/src/cut/lib/types.ts
index 00d3212d..9ff489b6 100644
--- a/site/src/cut/lib/types.ts
+++ b/site/src/cut/lib/types.ts
@@ -582,6 +582,10 @@ export interface TimelineTransition {
/** Blend length, 0.1..TRANSITION_MAX. */
seconds: number;
style: TransitionStyle;
+ /** Hidden bars stay on the row (grayed) and keep the boundary they line up
+ * with, so nothing else claims it, but play nothing — the cut renders hard
+ * in the preview and in every export. */
+ hidden?: boolean;
}
/** Effective whole-video fade length: the stored seconds, capped at half the
diff --git a/site/src/cut/server/ai/catalog.ts b/site/src/cut/server/ai/catalog.ts
index 8d28b8b3..2058541d 100644
--- a/site/src/cut/server/ai/catalog.ts
+++ b/site/src/cut/server/ai/catalog.ts
@@ -87,7 +87,7 @@ Times are in seconds on the shared timeline. The playhead is currentTime; a skim
- set_transition joins a clip into the next one (0–2s, ${TRANSITION_STYLE_IDS.length} styles); set_animation animates one clip's own entrance/exit — read the transitions-and-fades skill before styling cuts. Splitting or deleting clears the affected transition. A transition is a bar on its own row at an absolute time, so an edit can leave one lining up with nothing: every timeline mutation reports those as \`parkedTransitions\`, and clearing them (remove_transition) is part of finishing the edit. Grading a clip's picture is the color tools (set_color_preset, set_color_grade, set_color_curves, set_color_wheels, set_color_hsl — read the color-grading skill); a stylized post treatment (grain, VHS, halation…) is add_effect, dropped over the stretch of timeline it covers — as is a treatment on the sound (echo, reverb, telephone…).
- split_at cuts the track-0 clip under that time into two clips at the exact frame. With a soundtrack or overlay clip selected it splits that instead.
- The user can multi-select (⌘/⇧-click, or sweep a rubber-band over empty track space) across every kind at once — clips, audio, titles, cues. Deleting or copying acts on the whole selection, and dragging any member moves the set as one: every item shifts by the same time, relative spacing kept, while unselected items slide out of the way and flow back. A selection of one kind on the multi-row tracks (audio, titles) also retracks together on a vertical drag, one row past the end opening a new track. A hover chip on each video clip toggles its own audio.
-- Anything can be hidden instead of deleted: it stays on the timeline (grayed) but drops out of playback and export — a hidden video clip plays black and silent. Per item: set_clip_hidden, or the \`hidden\` field on update_overlay_video/update_overlay/update_audio. Whole rows: set_track_hidden (video/soundtrack/text/subtitles) and set_track_muted (video) — the eye/speaker toggles on the track headers.
+- Anything can be hidden instead of deleted: it stays on the timeline (grayed) but drops out of playback and export — a hidden video clip plays black and silent. Per item: set_clip_hidden, or the \`hidden\` field on update_overlay_video/update_overlay/update_audio. A transition bar hides the same way (set_transition_hidden): it keeps the cut it sits on so nothing else claims that boundary, and the cut renders hard. Whole rows: set_track_hidden (video/soundtrack/text/subtitles/transitions) and set_track_muted (video) — the eye/speaker toggles on the track headers.
- detach_audio lifts a video clip's sound to the soundtrack track (and mutes the clip) so audio can be cut independently of video.
- freeze_frame grabs one frame (default: the playhead — what the user currently sees) as a still clip and inserts it, by default at index 0 as a cover/hook frame ("make this the first frame"). The still is baked at the project's current aspect with the clip's framing applied; if the user later switches aspect they should capture a fresh one. \`with_elements\` bakes the composited picture instead — titles, captions and effects burned in — which is what a cover frame carrying the video's own text needs. The user reaches the same still by right-clicking the preview canvas: Copy frame puts that picture on their clipboard, and ⌘V drops it on the timeline.
- set_framing: per-clip Fit (letterbox) vs Fill (crop to cover the box), plus zoom 1..4 to push further in. Whenever the picture overflows, panX/panY position the crop window; the user can also drag the video directly in the preview, where a grey outline shows the part being cropped away. The controls live in the Inspector under "Framing" when a video clip is selected. Landscape footage usually wants fill + a pan that keeps the subject.
@@ -161,7 +161,7 @@ set_animation styles: fade (audio follows), zoom, pop, slideleft/right/up/down
Bars and the debris they leave: a transition lives on the transitions row as its own object at an absolute time, listed in editor_state \`transitions\` with the boundary it \`plays\`. It plays whatever cut or clip edge its window lines up with; a bar lining up with nothing reads \`parked: true\` and plays nothing — the badge is on the row, the blend is gone. Moving, retiming, or replacing clips is what parks a bar, so every timeline mutation returns \`parkedTransitions\` when its edit left one. Own that debris in the same turn you make it: a bar you parked and know the intent of, reattach with set_transition/set_animation on the edge it belongs to, or clear with remove_transition. When you can't tell what a parked bar was for — it predates your edits, or the user's ask doesn't say where the blend should end up — do not guess and do not leave it silent: name what's there ("there's a 0.5s dip to black at 29.4s that isn't on a cut any more") and ask whether to remove it or move it to a specific joint. The same holds for anything else on the timeline that reads as leftover from your own edits: say what you see and confirm before deleting the user's work.
Picking for a vibe: "smooth" → crossfade; "let the sound carry over a hard cut", "audio crossfade", "cross dissolve", "dissolve just the audio" → audiocross; "punchy/energetic" → crosszoom or a push; "dramatic scene change" → dipblack 0.5–0.8s; "dreamy" → blur (or the dreamy look); "retro" → vhs or vintage look. Between clips 0.4–0.8s reads well on the picture; 1s+ is slow and cuts total duration. The cross dissolve is shorter — 0.3s covers the jump in room tone without letting two voices be heard at once, and it asks less of the trim each clip has left. The editing-taste skill covers when a joint should stay a hard cut and how to keep transition styling consistent across the video.
UI: select a clip → Inspector "Effects" opens the panel (Transition / In / Out / Looks tabs). Preview and export render the same treatment.
-What the user sees on the transitions row: one badge per bar, and nothing else — the row holds no buttons, no placeholders, and no add-affordances. A playing bar is blue; a parked one is the same badge in grey. So a user reporting "greyed out transitions", "grey circles", or "dead/lingering transitions" on that row is describing parked bars, which are real objects saved in their project — never dismiss them as editor chrome or claim they won't export, because the badge is the transition itself. Read \`transitions\` in editor_state and answer from the parked entries there. Grey elsewhere means something different: a clip, element, or track shown grayed is hidden (the \`hidden\` flag), which does drop out of playback and export.`,
+What the user sees on the transitions row: one badge per bar, and nothing else — the row holds no buttons, no placeholders, and no add-affordances. A playing bar is blue; a parked one is the same badge in grey. So a user reporting "greyed out transitions", "grey circles", or "dead/lingering transitions" on that row is describing parked bars, which are real objects saved in their project — never dismiss them as editor chrome or claim they won't export, because the badge is the transition itself. Read \`transitions\` in editor_state and answer from the parked entries there. A bar can also be hidden (set_transition_hidden): it grays out but keeps its cut, so the joint plays as a hard cut and the bar is there to switch back on — that is how to audition a cut without its blend. Grey elsewhere means something different: a clip, element, or track shown grayed is hidden (the \`hidden\` flag), which does drop out of playback and export.`,
"graphics": `# Graphics: titles, shapes & stickers
The title lanes hold three overlay element kinds, all sharing timing (start/end), center position (x/y fractions 0..1), rotation (degrees), opacity, and a lane; \`overlays\` in editor_state lists them with their \`kind\`. All burn into the export exactly as previewed.