Optionalproject: {ReadonlyeditorReadonlylabelsReadonlylevelsSound levels while playing (meters).
ReadonlymediaBytes of every asset, for the engine and analyzer (Files/Blobs: no copies in memory).
ReadonlyoptionsReadonlyplayheadReadonlyproxiesLighter copies in use for previews, by asset id (device-local, not in the project).
ReadonlyuiThe project as the editor shows it: inside the open combined clip, if one is open.
Adds an already-imported asset to the timeline (media panel).
Adds a caption to type at the playhead (2 s, or up to the next one).
Adds a sound from the host's library at the playhead (on a sound lane) and selects it. The file is stored in the project like an import; its licence line goes on the asset.
Optionalsignal: AbortSignalAdds a marker at the playhead (key M) — or removes the one that's there.
Adds a finished camera recording (already streamed into storage as assetId): probed like an
import, then placed in the main video at the playhead or as a layer over it. Returns false
(after saying why) when the file can't be used.
Adds a blurred or pixelated box / oval at the playhead, selected (it can be dragged at once).
Adds a template at the playhead (one group) and selects it.
Lines up the selection: one element against the frame, several against each other.
"Allow": asks the browser again for every kept file waiting for the person's OK. Call it straight from a tap (browsers only ask inside one). Files still refused move on to "Find".
Sets (or clears) a clip's filter; keeps the intensity the user chose.
Gives every video and photo (main track and layers) the look of from: its filter at its
strength, and its LUT look. Locked ones are left alone. Returns how many changed.
Sets (or clears) the transition into a main-track clip.
The same transition between every pair of main-track clips.
Why the selection can't move in the stack (null = it can).
Sends instruction to the host's assistant with a description of the project, then applies
the edits it answers with as one undo step — all of them or, if one is invalid, none (the
reason shows in the conversation). Returns the turn.
Hands the preview canvas to a new engine worker. Returns a disposer.
Auto captions: the video's speech (music lowered under voice is left out, so the words come
through) goes to the transcriber piece by piece; the words become captions that replace any
there were — only those in options.range when it's given (a part heard again). One undo
step. Progress is in ui.captionJob; cancelCaptions() stops it.
Stops a request to the assistant.
Stops a running splitAtScenes.
Stops a running speak.
The captions as subtitle cues (for .srt / .vtt).
Whether background removal can run here (null: the host gave no remover).
Whether auto captions can run, and what they'd take, for language.
Back out of the open combined clip (all: back to the timeline itself).
Why the selection can't be combined (null = it can).
Combines the selection into one clip and selects it.
Copies the selection (and the media it uses) for paste.
Copies the selection, then deletes it.
Deletes a saved video other than the open one, and media only it used.
Hides the media banner (the files stay missing; their clips show without a picture).
Downloads the captions as a subtitle file.
Why "Lower under voice" can't act on the selection now (null: it can).
Makes a copy of this video and opens it: the same media files (nothing is copied but the project), a new name, its own history. The original stays as it was saved.
Exports only the sound (the same mix as the video export).
Renders the project to a video file (the engine pauses preview meanwhile).
Copies a video's sound to an audio lane and mutes the video, so it can be edited alone.
Mirrors an item (to has the new flip) with a short ease on the video: it eases a little
smaller, flips at the midpoint, and eases back (the transform has no in-between for a
mirror). Previews only, then one edit; reduced motion: at once.
Why the selection can't be grouped (null = it can).
Whether paste has something to paste.
Whether anything in the project can be heard for ducked items to lower under: a sounding
item (not exceptId, not itself ducked, not muted) whose media has sound.
Hears one caption's part of the video again (half a second either side), the way the last auto captions were made, and replaces the captions there.
Imports files: probe (in a worker), store, register, and add to the timeline — videos and photos after the clip under the playhead, audio on a lane at the playhead. Each file fails on its own with a clear message.
OptionaladdToTimeline?: booleanOptionalasSticker?: booleanOptionalat?: numberSounds go here instead of the playhead (a voiceover: where its recording started).
OptionalatStart?: booleanVideos and photos go before the first clip (in the order given), not at the playhead.
Optionalcredit?: stringLicence / attribution line kept on the asset (library sounds).
Optionalname?: stringDisplay name instead of the file name (library sounds: their title).
OptionalselectSound?: booleanSelect the added sound clip (library sounds: its settings show next).
Optionalspeed?: numberAdded sounds play at this speed with their pitch kept (text to speech from a service that can't change its pace). Default 1.
Imports a .cube LUT: checked in the engine worker (clear message when it can't be used),
stored like media (never inlined in the project), added as a lut asset (to the LUT looks
list) and applied to itemId when that is an unlocked picture; the toast says which.
Reads an .srt / .vtt file into captions (replacing any).
Whether item plays a combined clip.
Whether an item can't be changed: locked itself, or on a locked row.
History panel: undoes or redoes until position steps are applied (0 = as opened).
The videos saved on this device, newest first (empty when the editor doesn't save here).
The "check this" mark goes: a person read the caption and it's right.
The nearest marker after (1) or before (−1) the playhead, or null.
Layers panel drag: puts an element at toIndex in the on-screen stack (0 = front), one step
at a time so lanes stay tidy. One undo step.
Starts a new, empty video (the current one is saved first and stays in the list).
Selects and plays to the next caption marked to check (after the selected one).
Tells the listeners (a host's listener throwing never breaks the editor).
Listens to what happens in the editor (edits, selection, playback, …); returns an unsubscribe.
Called (at most once a frame) with each preview shown, and with null when it ends. For views
that follow the picture while a slider or drag is in progress; returns an unsubscribe.
A preview is on screen: the engine has drawn a frame with it (the stage moves its own selection frame then on touch, so frame and picture move together).
The ratio button: video settings live in the inspector (desktop) or the dock (phone/tablet).
Opens a combined clip to edit its inside (the selected one, or itemId): the timeline shows
what's in it, the playhead at the same moment of it. Edits change every place that plays it.
OptionalitemId: stringOpens the context menu for the selection at a point in the editor root (px).
Opens another saved video (the current one is saved first).
Pastes what was copied at the playhead, and selects it.
Opens the file picker; start: what's picked goes before the first clip.
Picks the key colour of the item being picked for, at canvas point x, y (fractions): the
picture's own colour there (without its green screen), from the engine.
Plays from…to once and pauses (a preview after picking a transition or an animation).
Any user play/pause/seek in between cancels the auto-stop.
Shows a not-yet-committed version of the project in the preview (stage drags, sliders before release). Nothing is written to the store or the undo history. Coalesced per frame.
Shows the frame at time in the preview without moving the playhead (trimming shows the new
edge); null returns the preview to the playhead. Coalesced per frame.
"Find": the person picked a missing file again. It must be the same kind of media (a video for a video…); it's stored like an import and the asset points at it — one undo step, items keep their times. Returns false (with a message) when the file doesn't fit.
Shows the photo's own background again.
Runs an edit; refused edits show their reason instead of throwing.
Optionaloptions: { coalesceKey?: string }Saves the frame under the playhead as a picture at the project's size.
Moves the playhead. Engine seeks are coalesced to one per animation frame (latest wins).
Selects an item (closing any open tool, since tools belong to the selection). keepPanel
keeps the open panel/tool — used when a panel selects the clip it is about to act on.
Picking a group member selects the whole group (only picks just that member); add
toggles the item (and its group) in a multi-selection (Shift-click, Layers "Select several").
⌘A: every element on screen at the playhead (not the main video, not hidden ones).
The group the selection is (null when it isn't exactly one group).
Everything selected (one item, a group, or a multi-selection).
Puts the selected combined clip's pieces back on the timeline.
Opens / closes the camera recorder (it covers the editor while open).
Restyles every caption (one undo step per change; a slider drag is one).
OptionalcoalesceKey: stringThe part to export starts at the playhead (key I). Its end stays where it was, or is the end of the video when there was none (or it came before the new start).
The part to export ends at the playhead (key O); its start stays, or is the video's start.
Sets (or clears, null) the part to export as one undoable edit.
Registers the shell's file picker; returns an unregister function.
One row of the Layers panel: lock / hide / rename a single item.
The editor's root element (preview mode's fullscreen target).
The timeline registers how to zoom around the playhead.
Speaks text with the host's voice service and adds it as a sound clip at at (default:
the playhead). Progress: ui.speechBusy. Returns false when it failed or was stopped.
Splits the selection (or the main clip under the playhead) at the playhead.
Finds where the scenes change in a video clip (in the analyzer worker, frame by frame) and
splits the clip there — one undo step. Progress is in ui.sceneJob. Returns the number of
parts (1 = no scene changes), or null when stopped or the video couldn't be read.
Storage, analyzer, autosave, and media for the opening project.
Green screen "pick from video": the next tap on the stage picks itemId's key colour
(null stops picking).
Steps by whole frames (arrow keys).
Whether a sticker image has a background to remove: not when it's animated (a cut-out is one
still picture — the animation would stop) or already see-through at its edges (library
stickers, cut-out logos). null while not known yet: the check runs once per asset, off the
main thread's way (header bytes, a 48 px decode), and bumps stickerChecks when done.
Stops everything start() and attachCanvas() began (autosave, analyzer, engine). The controller can be started again — React strict mode unmounts and remounts once in development.
"Use it here": takes the project over from the other tab, reloads what that tab saved, and saves from this tab from now on.
Where the files from the last pickFiles go (read once by the picker's change handler).
What each action would act on now (shared with the buttons, see targets.ts).
Turns "Lower under voice" on (default amount) or off for the selected music, sounds, clips.
Hides or shows the selection (all hidden → show all).
Locks or unlocks the selection (all locked → unlock all).
Opens or closes Layers or History (top bar): the left panel on desktop / tablet, the sheet on phones.
Lane header toggle: mutes the main track and audio lanes, hides visual lanes.
Lane header: locks or unlocks a whole row.
Undoes an assistant turn's changes — only while they're still the latest step (otherwise undo would take back something else). Returns whether it did.
project as the editor shows it (DECISIONS #155): with a combined clip open, a project whose
tracks are its inside, drawn at its size (no markers or export range — those are the whole
video's). Cached per project object, so selectors stay stable.
Resolves once an asset's file is attached (the analyzer and engine have it): at once if it
is, else when it arrives. A project opens before its media is read back from storage, so
thumbnails wait for this instead of asking too early. Resolves (no wait) if signal aborts.
Optionalsignal: AbortSignalStaticparseValidates a host-provided project (JSON or object).
While set (a call through
fanOutController), edits also reach these selected items.