@pixerate/editor 0.140.4 → 0.142.1

package/dist/video-editor/index.cjs

@@ -3226,6 +3226,55 @@ function checkPreviewScale(scale) {
   return scale === 1 ? "full" : scale;
 }
 
+// src/video-editor/playback.ts
+function videoTimeRef(at) {
+  return { kind: "time", id: [`t=${Math.round(at.time)}`, at.track ? `track=${at.track}` : "", at.clip ? `clip=${at.clip}` : ""].filter(Boolean).join(";") };
+}
+function parseVideoTimeRef(ref) {
+  if (ref.kind !== "time") return null;
+  const parts = Object.fromEntries(ref.id.split(";").map((p) => p.split("=")));
+  const time = Number(parts.t);
+  if (!Number.isFinite(time)) return null;
+  return { time, ...parts.track ? { track: parts.track } : {}, ...parts.clip ? { clip: parts.clip } : {} };
+}
+var num2 = (v) => typeof v === "number" && Number.isFinite(v);
+var str2 = (v) => typeof v === "string" && v.length > 0;
+function clipsOf(args) {
+  const out = [];
+  const add = (v) => str2(v) && !out.includes(v) && out.push(v);
+  add(args.clip);
+  add(args.target);
+  for (const key of ["clips", "ids"]) if (Array.isArray(args[key])) args[key].forEach(add);
+  return out.slice(0, 6);
+}
+function planVideoToolPlayback(tool, args) {
+  const clips = clipsOf(args);
+  const track = str2(args.track) ? args.track : void 0;
+  const newClip = args.clip && typeof args.clip === "object" ? args.clip : null;
+  const time = [args.start, args.at, args.time, args.to, _optionalChain([newClip, 'optionalAccess', _104 => _104.start])].find(num2);
+  const click = (ref) => [{ type: "target", ref }, { type: "press" }, { type: "release" }];
+  if (clips.length === 1 && (time !== void 0 || track) && tool !== "split_video_clip") {
+    const clip = clips[0];
+    const to = videoTimeRef({ time: _nullishCoalesce(time, () => ( 0)), ...track ? { track } : { clip } });
+    return [{ type: "target", ref: { kind: "clip", id: clip } }, { type: "press" }, { type: "target", ref: to }, { type: "release" }];
+  }
+  if (clips.length === 1 && time !== void 0) return click(videoTimeRef({ time, clip: clips[0] }));
+  if (clips.length) return clips.flatMap((id) => click({ kind: "clip", id }));
+  if (track) return click(time !== void 0 ? videoTimeRef({ time, track }) : { kind: "track", id: track });
+  if (time !== void 0) return click(videoTimeRef({ time }));
+  if (str2(args.marker)) return click({ kind: "marker", id: args.marker });
+  return null;
+}
+function withVideoPlayback(provider, surface = "video") {
+  const plan = (tool) => tool.plan || tool.playback !== void 0 ? tool : { ...tool, plan: (args) => planVideoToolPlayback(tool.name, args) };
+  const tools = provider.tools;
+  return {
+    ...provider,
+    playbackSurface: _nullishCoalesce(provider.playbackSurface, () => ( surface)),
+    tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
+  };
+}
+
 // src/video-editor/ui.ts
 var STEPS = [40, 100, 200, 500, 1e3, 2e3, 5e3, 1e4, 15e3, 3e4, 6e4, 12e4, 3e5, 6e5];
 function videoRulerTicks(duration, pxPerSecond, fps) {
@@ -3297,9 +3346,9 @@ function videoClipLabel(clip, asset, sequence) {
   if (clip.name) return clip.name;
   if (clip.type === "text") return clip.text.split("\n")[0];
   if (clip.type === "color") return clip.color;
-  if (clip.type === "sequence") return `Compound: ${_nullishCoalesce(_optionalChain([sequence, 'optionalAccess', _104 => _104.name]), () => ( clip.sequence))}`;
+  if (clip.type === "sequence") return `Compound: ${_nullishCoalesce(_optionalChain([sequence, 'optionalAccess', _105 => _105.name]), () => ( clip.sequence))}`;
   if (clip.type === "effect") return `Effect: ${clip.effect}`;
-  const base = _nullishCoalesce(_nullishCoalesce(_optionalChain([asset, 'optionalAccess', _105 => _105.name]), () => ( _optionalChain([asset, 'optionalAccess', _106 => _106.src, 'access', _107 => _107.replace, 'call', _108 => _108(/^.*[\\/]/, "")]))), () => ( clip.asset));
+  const base = _nullishCoalesce(_nullishCoalesce(_optionalChain([asset, 'optionalAccess', _106 => _106.name]), () => ( _optionalChain([asset, 'optionalAccess', _107 => _107.src, 'access', _108 => _108.replace, 'call', _109 => _109(/^.*[\\/]/, "")]))), () => ( clip.asset));
   const speed = _chunkVKF3PWKRcjs.videoClipSpeed.call(void 0, clip);
   return speed !== 1 ? `${base} (${Math.round(speed * 100)}%)` : base;
 }
@@ -3343,7 +3392,7 @@ function videoAssetDropEdit(project, assetId, options = {}) {
   const asset = _chunkVKF3PWKRcjs.videoAssetMap.call(void 0, project).get(assetId);
   if (!asset) return null;
   const kind = asset.kind === "audio" ? "audio" : "video";
-  const track = _nullishCoalesce(options.track, () => ( _optionalChain([project, 'access', _109 => _109.tracks, 'access', _110 => _110.find, 'call', _111 => _111((t) => t.kind === kind && !t.locked), 'optionalAccess', _112 => _112.id])));
+  const track = _nullishCoalesce(options.track, () => ( _optionalChain([project, 'access', _110 => _110.tracks, 'access', _111 => _111.find, 'call', _112 => _112((t) => t.kind === kind && !t.locked), 'optionalAccess', _113 => _113.id])));
   if (!track) return null;
   return { op: "add_clip", track, clip: { type: "media", asset: asset.id, ...options.start !== void 0 ? { start: options.start } : {} }, ...options.ripple ? { ripple: true } : {}, ...options.mode && options.mode !== "refuse" ? { mode: options.mode } : {} };
 }
@@ -3392,14 +3441,14 @@ var KEY_LABELS = {
   scale: { label: "Scale", step: 0.05 },
   rotation: { label: "Rotation", step: 1 }
 };
-var animatableOf = (clip, property) => _chunkVKF3PWKRcjs.VIDEO_TRANSFORM_PROPERTIES.includes(property) ? _optionalChain([clip, 'access', _113 => _113.transform, 'optionalAccess', _114 => _114[property]]) : property === "volume" ? clip.type === "media" || clip.type === "sequence" ? clip.volume : void 0 : clip.opacity;
+var animatableOf = (clip, property) => _chunkVKF3PWKRcjs.VIDEO_TRANSFORM_PROPERTIES.includes(property) ? _optionalChain([clip, 'access', _114 => _114.transform, 'optionalAccess', _115 => _115[property]]) : property === "volume" ? clip.type === "media" || clip.type === "sequence" ? clip.volume : void 0 : clip.opacity;
 var playheadInClip = (clip, time) => Math.round(Math.min(clip.duration, Math.max(0, time - clip.start)));
 function videoKeyframeRows(project, clipId, time) {
   const at = _chunkVKF3PWKRcjs.findVideoClip.call(void 0, project, clipId);
   if (!at) return [];
   const { clip } = at;
   const asset = clip.type === "media" ? _chunkVKF3PWKRcjs.videoAssetMap.call(void 0, project).get(clip.asset) : void 0;
-  const visual = !(_optionalChain([asset, 'optionalAccess', _115 => _115.kind]) === "audio" || at.track.kind === "audio");
+  const visual = !(_optionalChain([asset, 'optionalAccess', _116 => _116.kind]) === "audio" || at.track.kind === "audio");
   const audible = clip.type === "media" && _chunkVKF3PWKRcjs.videoAssetHasSound.call(void 0, asset) || clip.type === "sequence";
   const properties = [...visual ? ["opacity"] : [], ...audible ? ["volume"] : [], ...visual ? _chunkVKF3PWKRcjs.VIDEO_TRANSFORM_PROPERTIES : []];
   const clipTime = playheadInClip(clip, time);
@@ -3671,7 +3720,7 @@ function describeVideoProject(project) {
     ...project.background ? { background: project.background } : {},
     assets: project.assets.map(videoAssetOut),
     tracks: describeVideoTracks(project.tracks),
-    ..._optionalChain([project, 'access', _116 => _116.sequences, 'optionalAccess', _117 => _117.length]) ? { sequences: project.sequences.map((q) => describeVideoSequence(project, q, false)) } : {},
+    ..._optionalChain([project, 'access', _117 => _117.sequences, 'optionalAccess', _118 => _118.length]) ? { sequences: project.sequences.map((q) => describeVideoSequence(project, q, false)) } : {},
     markers: _nullishCoalesce(project.markers, () => ( []))
   };
 }
@@ -3698,14 +3747,14 @@ function createVideoEditorToolProvider(controller, options = {}) {
     return null;
   };
   const placed = (o) => ({
-    ..._optionalChain([o, 'access', _118 => _118.created, 'optionalAccess', _119 => _119.length]) ? { created: o.created } : {},
-    ..._optionalChain([o, 'access', _120 => _120.trimmed, 'optionalAccess', _121 => _121.length]) ? { trimmed: o.trimmed } : {},
-    ..._optionalChain([o, 'access', _122 => _122.removed, 'optionalAccess', _123 => _123.length]) ? { removed: o.removed } : {},
+    ..._optionalChain([o, 'access', _119 => _119.created, 'optionalAccess', _120 => _120.length]) ? { created: o.created } : {},
+    ..._optionalChain([o, 'access', _121 => _121.trimmed, 'optionalAccess', _122 => _122.length]) ? { trimmed: o.trimmed } : {},
+    ..._optionalChain([o, 'access', _123 => _123.removed, 'optionalAccess', _124 => _124.length]) ? { removed: o.removed } : {},
     ...o.rippled ? { rippled: o.rippled } : {}
   });
   const keysOut = (p, clip, property) => {
     const c = clipOut(p, clip);
-    const value = _chunkVKF3PWKRcjs.VIDEO_TRANSFORM_PROPERTIES.includes(property) ? _optionalChain([c, 'optionalAccess', _124 => _124.transform, 'optionalAccess', _125 => _125[property]]) : _optionalChain([c, 'optionalAccess', _126 => _126[property]]);
+    const value = _chunkVKF3PWKRcjs.VIDEO_TRANSFORM_PROPERTIES.includes(property) ? _optionalChain([c, 'optionalAccess', _125 => _125.transform, 'optionalAccess', _126 => _126[property]]) : _optionalChain([c, 'optionalAccess', _127 => _127[property]]);
     return typeof value === "object" ? { keys: value.keys } : { keys: [], value: _nullishCoalesce(value, () => ( null)) };
   };
   const getProject = {
@@ -3783,7 +3832,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
     annotations: { title: "Render a frame", ...READ },
     handler: async ({ time, times, columns, format = "svg" }) => {
       const p = project();
-      const lutSrcs = [...new Set(p.tracks.flatMap((t) => t.clips.map((c) => _optionalChain([c, 'access', _127 => _127.grade, 'optionalAccess', _128 => _128.lut, 'optionalAccess', _129 => _129.src])).filter((x) => !!x)))];
+      const lutSrcs = [...new Set(p.tracks.flatMap((t) => t.clips.map((c) => _optionalChain([c, 'access', _128 => _128.grade, 'optionalAccess', _129 => _129.lut, 'optionalAccess', _130 => _130.src])).filter((x) => !!x)))];
       const missing = (await Promise.all(lutSrcs.map((src) => controller.luts.load(src).then(() => null, (e) => e.message)))).filter((m) => !!m);
       const svgOptions = { lutFor: (src) => controller.luts.peek(src), ...columns ? { columns } : {} };
       const svg = times ? _chunkVKF3PWKRcjs.videoContactSheetSvg.call(void 0, p, times, svgOptions) : _chunkVKF3PWKRcjs.videoProjectSvg.call(void 0, p, _nullishCoalesce(time, () => ( controller.getState().time)), svgOptions);
@@ -4024,7 +4073,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
       const at = _chunkVKF3PWKRcjs.findVideoClip.call(void 0, p, id);
       if (!at) throw new Error(`There is no clip "${id}"; get_video_project lists the clips.`);
       const { clip } = at;
-      if (at.track.kind !== "video" || clip.type === "media" && _optionalChain([p, 'access', _130 => _130.assets, 'access', _131 => _131.find, 'call', _132 => _132((a) => a.id === clip.asset), 'optionalAccess', _133 => _133.kind]) === "audio")
+      if (at.track.kind !== "video" || clip.type === "media" && _optionalChain([p, 'access', _131 => _131.assets, 'access', _132 => _132.find, 'call', _133 => _133((a) => a.id === clip.asset), 'optionalAccess', _134 => _134.kind]) === "audio")
         throw new Error(`Clip "${id}" is sound only; grades change pictures. Pass clips on video tracks.`);
     }
   };
@@ -4047,7 +4096,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
         const grade = _chunkVKF3PWKRcjs.videoGradeLook.call(void 0, _chunkVKF3PWKRcjs.findVideoClip.call(void 0, project(), clip).clip.grade, preset, _nullishCoalesce(amount, () => ( 1)));
         return grade ? { op: "update_clip", clip, set: { grade } } : { op: "update_clip", clip, remove: ["grade"] };
       });
-      return apply(edits, `Apply ${preset} look`, (r) => ({ clips: clips.map((id) => ({ id, grade: _nullishCoalesce(_optionalChain([_chunkVKF3PWKRcjs.findVideoClip.call(void 0, r.project, id), 'optionalAccess', _134 => _134.clip, 'access', _135 => _135.grade]), () => ( null)) })) }));
+      return apply(edits, `Apply ${preset} look`, (r) => ({ clips: clips.map((id) => ({ id, grade: _nullishCoalesce(_optionalChain([_chunkVKF3PWKRcjs.findVideoClip.call(void 0, r.project, id), 'optionalAccess', _135 => _135.clip, 'access', _136 => _136.grade]), () => ( null)) })) }));
     }
   };
   const copyGrade = {
@@ -4083,7 +4132,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
       const lut = await controller.luts.load(src);
       const label = _nullishCoalesce(name, () => ( lut.title));
       const setting = { src, ...strength !== void 0 && strength !== 1 ? { strength } : {}, ...label ? { name: label } : {} };
-      return apply(videoLutEdits(project(), clips, setting), "Apply LUT", (r) => ({ lut: { src, ...lut.title ? { title: lut.title } : {}, size: lut.size }, clips: clips.map((id) => ({ id, grade: _nullishCoalesce(_optionalChain([_chunkVKF3PWKRcjs.findVideoClip.call(void 0, r.project, id), 'optionalAccess', _136 => _136.clip, 'access', _137 => _137.grade]), () => ( null)) })) }));
+      return apply(videoLutEdits(project(), clips, setting), "Apply LUT", (r) => ({ lut: { src, ...lut.title ? { title: lut.title } : {}, size: lut.size }, clips: clips.map((id) => ({ id, grade: _nullishCoalesce(_optionalChain([_chunkVKF3PWKRcjs.findVideoClip.call(void 0, r.project, id), 'optionalAccess', _137 => _137.clip, 'access', _138 => _138.grade]), () => ( null)) })) }));
     }
   };
   const removeLut = {
@@ -4095,9 +4144,9 @@ function createVideoEditorToolProvider(controller, options = {}) {
     handler: ({ clips }) => {
       gradeTargets(clips);
       const p = project();
-      const withLut = clips.filter((id) => _optionalChain([_chunkVKF3PWKRcjs.findVideoClip.call(void 0, p, id), 'access', _138 => _138.clip, 'access', _139 => _139.grade, 'optionalAccess', _140 => _140.lut]));
+      const withLut = clips.filter((id) => _optionalChain([_chunkVKF3PWKRcjs.findVideoClip.call(void 0, p, id), 'access', _139 => _139.clip, 'access', _140 => _140.grade, 'optionalAccess', _141 => _141.lut]));
       if (!withLut.length) throw new Error(`None of ${clips.map((c) => `"${c}"`).join(", ")} has a LUT; get_video_project shows each clip's grade.`);
-      return apply(videoLutEdits(p, withLut, null), "Remove LUT", (r) => ({ clips: clips.map((id) => ({ id, grade: _nullishCoalesce(_optionalChain([_chunkVKF3PWKRcjs.findVideoClip.call(void 0, r.project, id), 'optionalAccess', _141 => _141.clip, 'access', _142 => _142.grade]), () => ( null)) })) }));
+      return apply(videoLutEdits(p, withLut, null), "Remove LUT", (r) => ({ clips: clips.map((id) => ({ id, grade: _nullishCoalesce(_optionalChain([_chunkVKF3PWKRcjs.findVideoClip.call(void 0, r.project, id), 'optionalAccess', _142 => _142.clip, 'access', _143 => _143.grade]), () => ( null)) })) }));
     }
   };
   const PROXY_SCALE = { type: "number", exclusiveMinimum: 0, exclusiveMaximum: 1, description: "Proxy size as a fraction of the original: 0.5 (half width and height, the default) or 0.25 for very large footage." };
@@ -4155,7 +4204,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
       controller.setPreviewScale(scale);
       const s = controller.getState().previewScale;
       const fixed = s === "full" ? 1 : typeof s === "number" ? s : null;
-      const plays = fixed === null ? void 0 : project().assets.filter((a) => a.kind === "video").map((a) => ({ asset: a.id, src: _nullishCoalesce(_optionalChain([videoAssetProxy, 'call', _143 => _143(a, fixed), 'optionalAccess', _144 => _144.src]), () => ( a.src)), proxy: !!videoAssetProxy(a, fixed) }));
+      const plays = fixed === null ? void 0 : project().assets.filter((a) => a.kind === "video").map((a) => ({ asset: a.id, src: _nullishCoalesce(_optionalChain([videoAssetProxy, 'call', _144 => _144(a, fixed), 'optionalAccess', _145 => _145.src]), () => ( a.src)), proxy: !!videoAssetProxy(a, fixed) }));
       return { previewScale: s, ...plays ? { plays } : { note: "auto picks the smallest proxy at least as large as the preview canvas shows, so it depends on the preview's size." } };
     }
   };
@@ -4224,7 +4273,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
     handler: ({ track, from, to, limit }) => {
       const all = timelineWords(track).filter((w) => w.end > (_nullishCoalesce(from, () => ( 0))) && w.start < (_nullishCoalesce(to, () => ( Infinity))));
       const words = all.slice(0, _nullishCoalesce(limit, () => ( 1e3)));
-      return { track: _nullishCoalesce(_optionalChain([words, 'access', _145 => _145[0], 'optionalAccess', _146 => _146.track]), () => ( videoTranscriptTrack(project(), track))), text: words.map((w) => w.word).join(" "), words: words.map((w) => ({ word: w.word, start: round(w.start), end: round(w.end), clip: w.clip })), more: all.length > words.length };
+      return { track: _nullishCoalesce(_optionalChain([words, 'access', _146 => _146[0], 'optionalAccess', _147 => _147.track]), () => ( videoTranscriptTrack(project(), track))), text: words.map((w) => w.word).join(" "), words: words.map((w) => ({ word: w.word, start: round(w.start), end: round(w.end), clip: w.clip })), more: all.length > words.length };
     }
   };
   const findText = {
@@ -4287,7 +4336,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
     const { clip } = at;
     if (clip.type === "sequence") throw new Error(`Clip "${id}" is a compound clip, which plays its sequence at normal speed; change the speed of the clips inside the sequence instead.`);
     if (clip.type !== "media") throw new Error(`Clip "${id}" is a ${clip.type === "text" ? "title" : clip.type === "effect" ? "effect clip" : "colour"}, so it has no source to change the speed of; use a video or audio clip.`);
-    if (_optionalChain([project, 'call', _147 => _147(), 'access', _148 => _148.assets, 'access', _149 => _149.find, 'call', _150 => _150((a) => a.id === clip.asset), 'optionalAccess', _151 => _151.kind]) === "image") throw new Error(`Clip "${id}" is a still, so it has no motion to change the speed of.`);
+    if (_optionalChain([project, 'call', _148 => _148(), 'access', _149 => _149.assets, 'access', _150 => _150.find, 'call', _151 => _151((a) => a.id === clip.asset), 'optionalAccess', _152 => _152.kind]) === "image") throw new Error(`Clip "${id}" is a still, so it has no motion to change the speed of.`);
     return clip;
   };
   const rampOut = (r, id) => {
@@ -4618,7 +4667,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
   };
   const reads = [getProject, listSequences, getFrame, getTranscript, findText, findFillers, findPauses, findGaps, checkProject, renderFrame, getScopes, previewCache, planProxies, exportFfmpeg, exportLoudnessMeasure, exportEdl, audioLevels, findSilences, seek, setPreviewScale];
   const writes = [setSettings, addAsset, updateAsset, removeAsset, setProxies, addTrack, updateTrack, removeTrack, moveTrack, addClip, moveClip, trimClip, splitClip, deleteClips, updateClip, setTransition, setSpeedRamp, addFreeze, removeRamp, setTranscript, removeRanges, applyGradePreset, copyGrade, setLut, removeLut, setKeyframes, removeKeyframes, slipClip, rollEdit, slideClip, liftRange, extractRange, splitAt, closeGaps, addMarker, removeMarker, editVideo, undo, redo];
-  return {
+  return withVideoPlayback({
     id: _nullishCoalesce(options.id, () => ( "video")),
     namespace: options.namespace,
     title: "Video editor",
@@ -4635,7 +4684,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
         }
       });
     }
-  };
+  });
 }
 
 // src/video-editor/effect-tools.ts
@@ -4643,7 +4692,7 @@ function videoClipAppliedEffects(clip) {
   const out = [];
   const ref = (r) => ({ effect: r.effect, ...r.name ? { name: r.name } : {}, ...r.provider ? { provider: r.provider } : {} });
   if (clip.type === "effect") out.push({ id: "generator", ...ref(clip), role: "effect clip", enabled: true, values: _nullishCoalesce(clip.values, () => ( {})) });
-  if (_optionalChain([clip, 'access', _152 => _152.transition, 'optionalAccess', _153 => _153.type]) === "effect" && clip.transition.effect) out.push({ id: "transition", ...ref(clip.transition.effect), role: "transition", enabled: true, values: { ..._nullishCoalesce(clip.transition.effect.values, () => ( {})) }, duration: clip.transition.duration });
+  if (_optionalChain([clip, 'access', _153 => _153.transition, 'optionalAccess', _154 => _154.type]) === "effect" && clip.transition.effect) out.push({ id: "transition", ...ref(clip.transition.effect), role: "transition", enabled: true, values: { ..._nullishCoalesce(clip.transition.effect.values, () => ( {})) }, duration: clip.transition.duration });
   (_nullishCoalesce(clip.effects, () => ( []))).forEach((e, index) => out.push({ id: e.id, ...ref(e), role: "clip effect", enabled: e.enabled !== false, ...e.opacity !== void 0 ? { opacity: e.opacity } : {}, values: _nullishCoalesce(e.values, () => ( {})), index }));
   return out;
 }
@@ -4680,10 +4729,10 @@ function createVideoEffectsToolProvider(controller, options = {}) {
   const result = (r, target, instance, extra = {}) => {
     if (!r.ok) throw new Error(r.error);
     const effects = videoClipAppliedEffects(clipOf(target));
-    const effect = _nullishCoalesce(effects.find((e) => e.id === (_nullishCoalesce(instance, () => ( _optionalChain([r, 'access', _154 => _154.effect, 'optionalAccess', _155 => _155.id]))))), () => ( (r.effect ? { id: r.effect.id, effect: r.effect.effect, role: "clip effect", enabled: r.effect.enabled !== false, values: _nullishCoalesce(r.effect.values, () => ( {})) } : effects[0])));
+    const effect = _nullishCoalesce(effects.find((e) => e.id === (_nullishCoalesce(instance, () => ( _optionalChain([r, 'access', _155 => _155.effect, 'optionalAccess', _156 => _156.id]))))), () => ( (r.effect ? { id: r.effect.id, effect: r.effect.effect, role: "clip effect", enabled: r.effect.enabled !== false, values: _nullishCoalesce(r.effect.values, () => ( {})) } : effects[0])));
     return { target, effect, effects, ...extra };
   };
-  return _chunkRUZQMYXHcjs.createEffectToolProvider.call(void 0, {
+  return withVideoPlayback(_chunkRUZQMYXHcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "video-effects")),
     namespace: options.namespace,
     title: "Video effects",
@@ -4800,8 +4849,8 @@ function createVideoEffectsToolProvider(controller, options = {}) {
           if (args.effect === "generator") {
             const clip = clipOf(args.clip);
             if (clip.type !== "effect") throw new Error(`Clip "${args.clip}" is not an effect clip; give the id of one of its effects (list_applied_effects).`);
-            const was = _optionalChain([clip, 'access', _156 => _156.values, 'optionalAccess', _157 => _157[args.control]]);
-            const plain = keys === null ? _chunkVKF3PWKRcjs.isVideoKeyframes.call(void 0, was) ? _optionalChain([was, 'access', _158 => _158.keys, 'access', _159 => _159[0], 'optionalAccess', _160 => _160.v]) : was : { keys: [...keys].sort((a, b) => a.t - b.t) };
+            const was = _optionalChain([clip, 'access', _157 => _157.values, 'optionalAccess', _158 => _158[args.control]]);
+            const plain = keys === null ? _chunkVKF3PWKRcjs.isVideoKeyframes.call(void 0, was) ? _optionalChain([was, 'access', _159 => _159.keys, 'access', _160 => _160[0], 'optionalAccess', _161 => _161.v]) : was : { keys: [...keys].sort((a, b) => a.t - b.t) };
             if (plain === void 0) throw new Error(`"${args.control}" has no value to keep; give keys instead.`);
             r = await controller.updateEffectValues(args.clip, "generator", { [args.control]: plain });
           } else r = await controller.setClipEffectKeyframes(args.clip, args.effect, args.control, keys);
@@ -4810,7 +4859,7 @@ function createVideoEffectsToolProvider(controller, options = {}) {
         }
       }
     ]
-  });
+  }));
 }
 
 
@@ -5064,4 +5113,8 @@ function createVideoEffectsToolProvider(controller, options = {}) {
 
 
 
-exports.VIDEO_BLEND_MODES = _chunkVKF3PWKRcjs.VIDEO_BLEND_MODES; exports.VIDEO_BLEND_MODE_LABELS = VIDEO_BLEND_MODE_LABELS; exports.VIDEO_CLIP_ANIMATION_DURATION = _chunkVKF3PWKRcjs.VIDEO_CLIP_ANIMATION_DURATION; exports.VIDEO_CLIP_ANIMATION_EFFECTS = _chunkVKF3PWKRcjs.VIDEO_CLIP_ANIMATION_EFFECTS; exports.VIDEO_CLIP_ANIMATION_LABELS = VIDEO_CLIP_ANIMATION_LABELS; exports.VIDEO_CLIP_TYPES = _chunkVKF3PWKRcjs.VIDEO_CLIP_TYPES; exports.VIDEO_DEFAULT_FILLERS = VIDEO_DEFAULT_FILLERS; exports.VIDEO_DEFAULT_STILL_DURATION = VIDEO_DEFAULT_STILL_DURATION; exports.VIDEO_DEFAULT_TITLE_DURATION = VIDEO_DEFAULT_TITLE_DURATION; exports.VIDEO_EASE_NAMES = _chunkVKF3PWKRcjs.VIDEO_EASE_NAMES; exports.VIDEO_EDIT_OPS = VIDEO_EDIT_OPS; exports.VIDEO_EFFECT_PLACES = _chunkVKF3PWKRcjs.VIDEO_EFFECT_PLACES; exports.VIDEO_FADE_CURVES = _chunkVKF3PWKRcjs.VIDEO_FADE_CURVES; exports.VIDEO_FADE_CURVE_LABELS = VIDEO_FADE_CURVE_LABELS; exports.VIDEO_FITS = _chunkVKF3PWKRcjs.VIDEO_FITS; exports.VIDEO_GRADE_CONTROLS = _chunkVKF3PWKRcjs.VIDEO_GRADE_CONTROLS; exports.VIDEO_GRADE_PRESETS = _chunkVKF3PWKRcjs.VIDEO_GRADE_PRESETS; exports.VIDEO_GRADE_PRESET_NAMES = _chunkVKF3PWKRcjs.VIDEO_GRADE_PRESET_NAMES; exports.VIDEO_ISSUE_CODES = VIDEO_ISSUE_CODES; exports.VIDEO_KEYFRAME_LIMITS = _chunkVKF3PWKRcjs.VIDEO_KEYFRAME_LIMITS; exports.VIDEO_KEYFRAME_PROPERTIES = _chunkVKF3PWKRcjs.VIDEO_KEYFRAME_PROPERTIES; exports.VIDEO_LUT_MAX_SIZE = _chunkVKF3PWKRcjs.VIDEO_LUT_MAX_SIZE; exports.VIDEO_PEAK_BLOCK = VIDEO_PEAK_BLOCK; exports.VIDEO_PLACEMENT_MODES = _chunkVKF3PWKRcjs.VIDEO_PLACEMENT_MODES; exports.VIDEO_PREVIEW_SCALE_OPTIONS = VIDEO_PREVIEW_SCALE_OPTIONS; exports.VIDEO_PROXY_SCALES = VIDEO_PROXY_SCALES; exports.VIDEO_SCOPE_KINDS = VIDEO_SCOPE_KINDS; exports.VIDEO_TIME_EPSILON = _chunkVKF3PWKRcjs.VIDEO_TIME_EPSILON; exports.VIDEO_TRANSFORM_PROPERTIES = _chunkVKF3PWKRcjs.VIDEO_TRANSFORM_PROPERTIES; exports.VIDEO_TRANSITION_LABELS = VIDEO_TRANSITION_LABELS; exports.VIDEO_TRANSITION_TYPES = _chunkVKF3PWKRcjs.VIDEO_TRANSITION_TYPES; exports.VIDEO_VECTORSCOPE_TARGETS = VIDEO_VECTORSCOPE_TARGETS; exports.VIDEO_WIPE_DIRECTIONS = _chunkVKF3PWKRcjs.VIDEO_WIPE_DIRECTIONS; exports.VideoAudioPeaksCache = VideoAudioPeaksCache; exports.VideoEditorController = VideoEditorController; exports.VideoEffectsEngine = _chunkVKF3PWKRcjs.VideoEffectsEngine; exports.VideoFrameCache = VideoFrameCache; exports.VideoLutCache = _chunkVKF3PWKRcjs.VideoLutCache; exports.VideoPreviewEngine = VideoPreviewEngine; exports.VideoPreviewPixels = VideoPreviewPixels; exports.allVideoClipIds = _chunkVKF3PWKRcjs.allVideoClipIds; exports.allVideoTracks = _chunkVKF3PWKRcjs.allVideoTracks; exports.applyVideoEdits = applyVideoEdits; exports.applyVideoGrade = _chunkVKF3PWKRcjs.applyVideoGrade; exports.applyVideoLut = _chunkVKF3PWKRcjs.applyVideoLut; exports.applyVideoLutToPixels = _chunkVKF3PWKRcjs.applyVideoLutToPixels; exports.buildVideoAudioPeaks = buildVideoAudioPeaks; exports.checkVideoEffectPlace = _chunkVKF3PWKRcjs.checkVideoEffectPlace; exports.checkVideoEffectValues = _chunkVKF3PWKRcjs.checkVideoEffectValues; exports.checkVideoProject = checkVideoProject; exports.checkVideoTimeRemap = _chunkVKF3PWKRcjs.checkVideoTimeRemap; exports.createVideoEditorToolProvider = createVideoEditorToolProvider; exports.createVideoEffectsToolProvider = createVideoEffectsToolProvider; exports.createVideoElementDecoder = createVideoElementDecoder; exports.createVideoProject = createVideoProject; exports.decodeVideoAudioPeaks = decodeVideoAudioPeaks; exports.describeVideoProject = describeVideoProject; exports.describeVideoSequence = describeVideoSequence; exports.drawVideoFrame = _chunkVKF3PWKRcjs.drawVideoFrame; exports.ffmpegFilterValue = _chunkVKF3PWKRcjs.ffmpegFilterValue; exports.findVideoAudioSilences = findVideoAudioSilences; exports.findVideoClip = _chunkVKF3PWKRcjs.findVideoClip; exports.findVideoFillers = findVideoFillers; exports.findVideoGaps = _chunkVKF3PWKRcjs.findVideoGaps; exports.findVideoSequenceClip = _chunkVKF3PWKRcjs.findVideoSequenceClip; exports.findVideoSequenceCycle = _chunkVKF3PWKRcjs.findVideoSequenceCycle; exports.findVideoTranscriptPauses = findVideoTranscriptPauses; exports.findVideoTranscriptText = findVideoTranscriptText; exports.formatVideoSeconds = _chunkVKF3PWKRcjs.formatVideoSeconds; exports.formatVideoTimecode = _chunkVKF3PWKRcjs.formatVideoTimecode; exports.formatVideoTimecodeFrames = _chunkVKF3PWKRcjs.formatVideoTimecodeFrames; exports.isVideoDropFrameRate = _chunkVKF3PWKRcjs.isVideoDropFrameRate; exports.isVideoKeyframes = _chunkVKF3PWKRcjs.isVideoKeyframes; exports.mergeVideoRanges = mergeVideoRanges; exports.mixEffectPixels = _chunkVKF3PWKRcjs.mixEffectPixels; exports.nextFreeVideoSlot = _chunkVKF3PWKRcjs.nextFreeVideoSlot; exports.normalizeVideoGrade = _chunkVKF3PWKRcjs.normalizeVideoGrade; exports.normalizeVideoGradeLut = _chunkVKF3PWKRcjs.normalizeVideoGradeLut; exports.normalizeVideoWord = normalizeVideoWord; exports.overEffectPixels = _chunkVKF3PWKRcjs.overEffectPixels; exports.parseVideoAnimatable = parseVideoAnimatable; exports.parseVideoAsset = parseVideoAsset; exports.parseVideoAssetProxies = parseVideoAssetProxies; exports.parseVideoClip = parseVideoClip; exports.parseVideoClipAnimation = parseVideoClipAnimation; exports.parseVideoClipEffects = parseVideoClipEffects; exports.parseVideoCubeLut = _chunkVKF3PWKRcjs.parseVideoCubeLut; exports.parseVideoEffectRef = parseVideoEffectRef; exports.parseVideoEffectValues = parseVideoEffectValues; exports.parseVideoGrade = parseVideoGrade; exports.parseVideoGradeLut = parseVideoGradeLut; exports.parseVideoKeyframes = parseVideoKeyframes; exports.parseVideoLoudnessMeasurement = _chunkVKF3PWKRcjs.parseVideoLoudnessMeasurement; exports.parseVideoMarker = parseVideoMarker; exports.parseVideoPreviewScale = parseVideoPreviewScale; exports.parseVideoProject = parseVideoProject; exports.parseVideoSequence = parseVideoSequence; exports.parseVideoTimeRemap = parseVideoTimeRemap; exports.parseVideoTrack = parseVideoTrack; exports.parseVideoTranscript = parseVideoTranscript; exports.parseVideoTranscriptWords = parseVideoTranscriptWords; exports.parseVideoTransform = parseVideoTransform; exports.parseVideoTransition = parseVideoTransition; exports.placeVideoRect = _chunkVKF3PWKRcjs.placeVideoRect; exports.planVideoClipDrag = planVideoClipDrag; exports.planVideoPrefetch = planVideoPrefetch; exports.probeVideoMedia = probeVideoMedia; exports.readVideoScopesPanel = readVideoScopesPanel; exports.removeVideoKey = _chunkVKF3PWKRcjs.removeVideoKey; exports.renderVideoFrameExact = _chunkVKF3PWKRcjs.renderVideoFrameExact; exports.resolveVideoPreviewScale = resolveVideoPreviewScale; exports.retimeVideoAnimatable = _chunkVKF3PWKRcjs.retimeVideoAnimatable; exports.setVideoKey = _chunkVKF3PWKRcjs.setVideoKey; exports.snapToVideoFrame = _chunkVKF3PWKRcjs.snapToVideoFrame; exports.snapVideoTime = _chunkVKF3PWKRcjs.snapVideoTime; exports.sortVideoKeys = _chunkVKF3PWKRcjs.sortVideoKeys; exports.sortedVideoClips = _chunkVKF3PWKRcjs.sortedVideoClips; exports.splitVideoAnimatable = _chunkVKF3PWKRcjs.splitVideoAnimatable; exports.summarizeVideoScopes = summarizeVideoScopes; exports.toVideoEdl = _chunkVKF3PWKRcjs.toVideoEdl; exports.toVideoFfmpeg = _chunkVKF3PWKRcjs.toVideoFfmpeg; exports.toVideoLoudnessMeasure = _chunkVKF3PWKRcjs.toVideoLoudnessMeasure; exports.videoAssetDropEdit = videoAssetDropEdit; exports.videoAssetHasSound = _chunkVKF3PWKRcjs.videoAssetHasSound; exports.videoAssetKindOf = videoAssetKindOf; exports.videoAssetMap = _chunkVKF3PWKRcjs.videoAssetMap; exports.videoAssetProxy = videoAssetProxy; exports.videoAudioLevels = videoAudioLevels; exports.videoAudioPeakRange = videoAudioPeakRange; exports.videoAudioPeakSpans = videoAudioPeakSpans; exports.videoAudioPeaksDuration = videoAudioPeaksDuration; exports.videoCacheEvictions = videoCacheEvictions; exports.videoChroma = videoChroma; exports.videoClipAfter = _chunkVKF3PWKRcjs.videoClipAfter; exports.videoClipAnimated = _chunkVKF3PWKRcjs.videoClipAnimated; exports.videoClipAnimationProperties = _chunkVKF3PWKRcjs.videoClipAnimationProperties; exports.videoClipAnimationSpans = _chunkVKF3PWKRcjs.videoClipAnimationSpans; exports.videoClipAppliedEffects = videoClipAppliedEffects; exports.videoClipBefore = _chunkVKF3PWKRcjs.videoClipBefore; exports.videoClipEffectUses = _chunkVKF3PWKRcjs.videoClipEffectUses; exports.videoClipEnd = _chunkVKF3PWKRcjs.videoClipEnd; exports.videoClipHandles = _chunkVKF3PWKRcjs.videoClipHandles; exports.videoClipKeyframes = videoClipKeyframes; exports.videoClipLabel = videoClipLabel; exports.videoClipOverhang = _chunkVKF3PWKRcjs.videoClipOverhang; exports.videoClipShowsWaveform = videoClipShowsWaveform; exports.videoClipSoundGain = _chunkVKF3PWKRcjs.videoClipSoundGain; exports.videoClipSourceRange = _chunkVKF3PWKRcjs.videoClipSourceRange; exports.videoClipSourceTime = _chunkVKF3PWKRcjs.videoClipSourceTime; exports.videoClipSpeed = _chunkVKF3PWKRcjs.videoClipSpeed; exports.videoClipSpeedAt = _chunkVKF3PWKRcjs.videoClipSpeedAt; exports.videoClipTint = videoClipTint; exports.videoClipWaveform = videoClipWaveform; exports.videoClipWaveformPath = videoClipWaveformPath; exports.videoClipsAt = _chunkVKF3PWKRcjs.videoClipsAt; exports.videoContactSheetSvg = _chunkVKF3PWKRcjs.videoContactSheetSvg; exports.videoDragLabel = videoDragLabel; exports.videoDropTracks = videoDropTracks; exports.videoEaseBezier = _chunkVKF3PWKRcjs.videoEaseBezier; exports.videoEaseProgress = _chunkVKF3PWKRcjs.videoEaseProgress; exports.videoEffectFrameTime = _chunkVKF3PWKRcjs.videoEffectFrameTime; exports.videoEffectLayerKey = _chunkVKF3PWKRcjs.videoEffectLayerKey; exports.videoEffectValuesAt = _chunkVKF3PWKRcjs.videoEffectValuesAt; exports.videoExposureNotes = videoExposureNotes; exports.videoExposureStats = videoExposureStats; exports.videoFadeCurveGain = _chunkVKF3PWKRcjs.videoFadeCurveGain; exports.videoFfmpegUnsupportedEffects = _chunkVKF3PWKRcjs.videoFfmpegUnsupportedEffects; exports.videoFrameAt = _chunkVKF3PWKRcjs.videoFrameAt; exports.videoFrameCacheKey = videoFrameCacheKey; exports.videoFrameDuration = _chunkVKF3PWKRcjs.videoFrameDuration; exports.videoFrameLeafLayers = _chunkVKF3PWKRcjs.videoFrameLeafLayers; exports.videoFrameRequestsAt = videoFrameRequestsAt; exports.videoFrameToSvg = _chunkVKF3PWKRcjs.videoFrameToSvg; exports.videoFrames = _chunkVKF3PWKRcjs.videoFrames; exports.videoFreezeFrameEdit = _chunkVKF3PWKRcjs.videoFreezeFrameEdit; exports.videoGradeCssFilter = _chunkVKF3PWKRcjs.videoGradeCssFilter; exports.videoGradeFfmpegFilters = _chunkVKF3PWKRcjs.videoGradeFfmpegFilters; exports.videoGradeGainsFilterId = _chunkVKF3PWKRcjs.videoGradeGainsFilterId; exports.videoGradeLook = _chunkVKF3PWKRcjs.videoGradeLook; exports.videoGradePreset = _chunkVKF3PWKRcjs.videoGradePreset; exports.videoGradeStepMatrix = _chunkVKF3PWKRcjs.videoGradeStepMatrix; exports.videoGradeStepSvgValues = _chunkVKF3PWKRcjs.videoGradeStepSvgValues; exports.videoGradeSteps = _chunkVKF3PWKRcjs.videoGradeSteps; exports.videoGradeSvgDefs = _chunkVKF3PWKRcjs.videoGradeSvgDefs; exports.videoGradeSvgFilter = _chunkVKF3PWKRcjs.videoGradeSvgFilter; exports.videoHistogram = videoHistogram; exports.videoHistogramImage = videoHistogramImage; exports.videoHourFrames = _chunkVKF3PWKRcjs.videoHourFrames; exports.videoIrisRadius = _chunkVKF3PWKRcjs.videoIrisRadius; exports.videoIssueKey = videoIssueKey; exports.videoKeyframeBreakpoints = _chunkVKF3PWKRcjs.videoKeyframeBreakpoints; exports.videoKeyframeFfmpegExpr = _chunkVKF3PWKRcjs.videoKeyframeFfmpegExpr; exports.videoKeyframeRows = videoKeyframeRows; exports.videoKeyframeToggleEdit = videoKeyframeToggleEdit; exports.videoKeyframeValueEdit = videoKeyframeValueEdit; exports.videoKeysOf = _chunkVKF3PWKRcjs.videoKeysOf; exports.videoLayersUseEffects = _chunkVKF3PWKRcjs.videoLayersUseEffects; exports.videoLayersWithoutTransitionEffects = _chunkVKF3PWKRcjs.videoLayersWithoutTransitionEffects; exports.videoLuma = videoLuma; exports.videoLumaWaveform = videoLumaWaveform; exports.videoLutEdits = videoLutEdits; exports.videoLutFromFunction = _chunkVKF3PWKRcjs.videoLutFromFunction; exports.videoLutSvgApproximation = _chunkVKF3PWKRcjs.videoLutSvgApproximation; exports.videoLutSvgPrimitives = _chunkVKF3PWKRcjs.videoLutSvgPrimitives; exports.videoLutToCube = _chunkVKF3PWKRcjs.videoLutToCube; exports.videoOverlap = _chunkVKF3PWKRcjs.videoOverlap; exports.videoPeakDb = videoPeakDb; exports.videoPreviewSrc = videoPreviewSrc; exports.videoProjectDuration = _chunkVKF3PWKRcjs.videoProjectDuration; exports.videoProjectEffects = _chunkVKF3PWKRcjs.videoProjectEffects; exports.videoProjectHasProxies = videoProjectHasProxies; exports.videoProjectSvg = _chunkVKF3PWKRcjs.videoProjectSvg; exports.videoProxyFfmpeg = videoProxyFfmpeg; exports.videoProxyName = videoProxyName; exports.videoProxyPlan = videoProxyPlan; exports.videoRemoveRangesEdits = videoRemoveRangesEdits; exports.videoRulerTicks = videoRulerTicks; exports.videoScopeImage = videoScopeImage; exports.videoSequenceChildren = _chunkVKF3PWKRcjs.videoSequenceChildren; exports.videoSequenceDuration = _chunkVKF3PWKRcjs.videoSequenceDuration; exports.videoSequenceMap = _chunkVKF3PWKRcjs.videoSequenceMap; exports.videoShellQuote = _chunkVKF3PWKRcjs.videoShellQuote; exports.videoSlowMotionRamp = _chunkVKF3PWKRcjs.videoSlowMotionRamp; exports.videoSnapPoints = _chunkVKF3PWKRcjs.videoSnapPoints; exports.videoSourceFrame = videoSourceFrame; exports.videoSourceFrameTime = videoSourceFrameTime; exports.videoSpeedRampEdit = _chunkVKF3PWKRcjs.videoSpeedRampEdit; exports.videoSpeedRampKeys = _chunkVKF3PWKRcjs.videoSpeedRampKeys; exports.videoTextStyle = _chunkVKF3PWKRcjs.videoTextStyle; exports.videoTimeRemapBreakpoints = _chunkVKF3PWKRcjs.videoTimeRemapBreakpoints; exports.videoTimeRemapSpan = _chunkVKF3PWKRcjs.videoTimeRemapSpan; exports.videoTimecodeFrames = _chunkVKF3PWKRcjs.videoTimecodeFrames; exports.videoTimelineTranscript = videoTimelineTranscript; exports.videoTitleFrame = _chunkVKF3PWKRcjs.videoTitleFrame; exports.videoTrackSyncLocked = _chunkVKF3PWKRcjs.videoTrackSyncLocked; exports.videoTranscriptEdit = videoTranscriptEdit; exports.videoTranscriptTrack = videoTranscriptTrack; exports.videoTransformAt = _chunkVKF3PWKRcjs.videoTransformAt; exports.videoTransitionAudioCurve = _chunkVKF3PWKRcjs.videoTransitionAudioCurve; exports.videoTransitionEase = _chunkVKF3PWKRcjs.videoTransitionEase; exports.videoTransitionHasDirection = videoTransitionHasDirection; exports.videoValueAt = _chunkVKF3PWKRcjs.videoValueAt; exports.videoVectorscope = videoVectorscope; exports.videoVectorscopeAngle = videoVectorscopeAngle; exports.videoVectorscopeImage = videoVectorscopeImage; exports.videoVectorscopePoint = videoVectorscopePoint; exports.videoWaveformImage = videoWaveformImage; exports.videoWaveformPath = videoWaveformPath; exports.videoWipeRect = _chunkVKF3PWKRcjs.videoWipeRect; exports.videoWordAt = videoWordAt; exports.videoWordsRange = videoWordsRange;
+
+
+
+
+exports.VIDEO_BLEND_MODES = _chunkVKF3PWKRcjs.VIDEO_BLEND_MODES; exports.VIDEO_BLEND_MODE_LABELS = VIDEO_BLEND_MODE_LABELS; exports.VIDEO_CLIP_ANIMATION_DURATION = _chunkVKF3PWKRcjs.VIDEO_CLIP_ANIMATION_DURATION; exports.VIDEO_CLIP_ANIMATION_EFFECTS = _chunkVKF3PWKRcjs.VIDEO_CLIP_ANIMATION_EFFECTS; exports.VIDEO_CLIP_ANIMATION_LABELS = VIDEO_CLIP_ANIMATION_LABELS; exports.VIDEO_CLIP_TYPES = _chunkVKF3PWKRcjs.VIDEO_CLIP_TYPES; exports.VIDEO_DEFAULT_FILLERS = VIDEO_DEFAULT_FILLERS; exports.VIDEO_DEFAULT_STILL_DURATION = VIDEO_DEFAULT_STILL_DURATION; exports.VIDEO_DEFAULT_TITLE_DURATION = VIDEO_DEFAULT_TITLE_DURATION; exports.VIDEO_EASE_NAMES = _chunkVKF3PWKRcjs.VIDEO_EASE_NAMES; exports.VIDEO_EDIT_OPS = VIDEO_EDIT_OPS; exports.VIDEO_EFFECT_PLACES = _chunkVKF3PWKRcjs.VIDEO_EFFECT_PLACES; exports.VIDEO_FADE_CURVES = _chunkVKF3PWKRcjs.VIDEO_FADE_CURVES; exports.VIDEO_FADE_CURVE_LABELS = VIDEO_FADE_CURVE_LABELS; exports.VIDEO_FITS = _chunkVKF3PWKRcjs.VIDEO_FITS; exports.VIDEO_GRADE_CONTROLS = _chunkVKF3PWKRcjs.VIDEO_GRADE_CONTROLS; exports.VIDEO_GRADE_PRESETS = _chunkVKF3PWKRcjs.VIDEO_GRADE_PRESETS; exports.VIDEO_GRADE_PRESET_NAMES = _chunkVKF3PWKRcjs.VIDEO_GRADE_PRESET_NAMES; exports.VIDEO_ISSUE_CODES = VIDEO_ISSUE_CODES; exports.VIDEO_KEYFRAME_LIMITS = _chunkVKF3PWKRcjs.VIDEO_KEYFRAME_LIMITS; exports.VIDEO_KEYFRAME_PROPERTIES = _chunkVKF3PWKRcjs.VIDEO_KEYFRAME_PROPERTIES; exports.VIDEO_LUT_MAX_SIZE = _chunkVKF3PWKRcjs.VIDEO_LUT_MAX_SIZE; exports.VIDEO_PEAK_BLOCK = VIDEO_PEAK_BLOCK; exports.VIDEO_PLACEMENT_MODES = _chunkVKF3PWKRcjs.VIDEO_PLACEMENT_MODES; exports.VIDEO_PREVIEW_SCALE_OPTIONS = VIDEO_PREVIEW_SCALE_OPTIONS; exports.VIDEO_PROXY_SCALES = VIDEO_PROXY_SCALES; exports.VIDEO_SCOPE_KINDS = VIDEO_SCOPE_KINDS; exports.VIDEO_TIME_EPSILON = _chunkVKF3PWKRcjs.VIDEO_TIME_EPSILON; exports.VIDEO_TRANSFORM_PROPERTIES = _chunkVKF3PWKRcjs.VIDEO_TRANSFORM_PROPERTIES; exports.VIDEO_TRANSITION_LABELS = VIDEO_TRANSITION_LABELS; exports.VIDEO_TRANSITION_TYPES = _chunkVKF3PWKRcjs.VIDEO_TRANSITION_TYPES; exports.VIDEO_VECTORSCOPE_TARGETS = VIDEO_VECTORSCOPE_TARGETS; exports.VIDEO_WIPE_DIRECTIONS = _chunkVKF3PWKRcjs.VIDEO_WIPE_DIRECTIONS; exports.VideoAudioPeaksCache = VideoAudioPeaksCache; exports.VideoEditorController = VideoEditorController; exports.VideoEffectsEngine = _chunkVKF3PWKRcjs.VideoEffectsEngine; exports.VideoFrameCache = VideoFrameCache; exports.VideoLutCache = _chunkVKF3PWKRcjs.VideoLutCache; exports.VideoPreviewEngine = VideoPreviewEngine; exports.VideoPreviewPixels = VideoPreviewPixels; exports.allVideoClipIds = _chunkVKF3PWKRcjs.allVideoClipIds; exports.allVideoTracks = _chunkVKF3PWKRcjs.allVideoTracks; exports.applyVideoEdits = applyVideoEdits; exports.applyVideoGrade = _chunkVKF3PWKRcjs.applyVideoGrade; exports.applyVideoLut = _chunkVKF3PWKRcjs.applyVideoLut; exports.applyVideoLutToPixels = _chunkVKF3PWKRcjs.applyVideoLutToPixels; exports.buildVideoAudioPeaks = buildVideoAudioPeaks; exports.checkVideoEffectPlace = _chunkVKF3PWKRcjs.checkVideoEffectPlace; exports.checkVideoEffectValues = _chunkVKF3PWKRcjs.checkVideoEffectValues; exports.checkVideoProject = checkVideoProject; exports.checkVideoTimeRemap = _chunkVKF3PWKRcjs.checkVideoTimeRemap; exports.createVideoEditorToolProvider = createVideoEditorToolProvider; exports.createVideoEffectsToolProvider = createVideoEffectsToolProvider; exports.createVideoElementDecoder = createVideoElementDecoder; exports.createVideoProject = createVideoProject; exports.decodeVideoAudioPeaks = decodeVideoAudioPeaks; exports.describeVideoProject = describeVideoProject; exports.describeVideoSequence = describeVideoSequence; exports.drawVideoFrame = _chunkVKF3PWKRcjs.drawVideoFrame; exports.ffmpegFilterValue = _chunkVKF3PWKRcjs.ffmpegFilterValue; exports.findVideoAudioSilences = findVideoAudioSilences; exports.findVideoClip = _chunkVKF3PWKRcjs.findVideoClip; exports.findVideoFillers = findVideoFillers; exports.findVideoGaps = _chunkVKF3PWKRcjs.findVideoGaps; exports.findVideoSequenceClip = _chunkVKF3PWKRcjs.findVideoSequenceClip; exports.findVideoSequenceCycle = _chunkVKF3PWKRcjs.findVideoSequenceCycle; exports.findVideoTranscriptPauses = findVideoTranscriptPauses; exports.findVideoTranscriptText = findVideoTranscriptText; exports.formatVideoSeconds = _chunkVKF3PWKRcjs.formatVideoSeconds; exports.formatVideoTimecode = _chunkVKF3PWKRcjs.formatVideoTimecode; exports.formatVideoTimecodeFrames = _chunkVKF3PWKRcjs.formatVideoTimecodeFrames; exports.isVideoDropFrameRate = _chunkVKF3PWKRcjs.isVideoDropFrameRate; exports.isVideoKeyframes = _chunkVKF3PWKRcjs.isVideoKeyframes; exports.mergeVideoRanges = mergeVideoRanges; exports.mixEffectPixels = _chunkVKF3PWKRcjs.mixEffectPixels; exports.nextFreeVideoSlot = _chunkVKF3PWKRcjs.nextFreeVideoSlot; exports.normalizeVideoGrade = _chunkVKF3PWKRcjs.normalizeVideoGrade; exports.normalizeVideoGradeLut = _chunkVKF3PWKRcjs.normalizeVideoGradeLut; exports.normalizeVideoWord = normalizeVideoWord; exports.overEffectPixels = _chunkVKF3PWKRcjs.overEffectPixels; exports.parseVideoAnimatable = parseVideoAnimatable; exports.parseVideoAsset = parseVideoAsset; exports.parseVideoAssetProxies = parseVideoAssetProxies; exports.parseVideoClip = parseVideoClip; exports.parseVideoClipAnimation = parseVideoClipAnimation; exports.parseVideoClipEffects = parseVideoClipEffects; exports.parseVideoCubeLut = _chunkVKF3PWKRcjs.parseVideoCubeLut; exports.parseVideoEffectRef = parseVideoEffectRef; exports.parseVideoEffectValues = parseVideoEffectValues; exports.parseVideoGrade = parseVideoGrade; exports.parseVideoGradeLut = parseVideoGradeLut; exports.parseVideoKeyframes = parseVideoKeyframes; exports.parseVideoLoudnessMeasurement = _chunkVKF3PWKRcjs.parseVideoLoudnessMeasurement; exports.parseVideoMarker = parseVideoMarker; exports.parseVideoPreviewScale = parseVideoPreviewScale; exports.parseVideoProject = parseVideoProject; exports.parseVideoSequence = parseVideoSequence; exports.parseVideoTimeRef = parseVideoTimeRef; exports.parseVideoTimeRemap = parseVideoTimeRemap; exports.parseVideoTrack = parseVideoTrack; exports.parseVideoTranscript = parseVideoTranscript; exports.parseVideoTranscriptWords = parseVideoTranscriptWords; exports.parseVideoTransform = parseVideoTransform; exports.parseVideoTransition = parseVideoTransition; exports.placeVideoRect = _chunkVKF3PWKRcjs.placeVideoRect; exports.planVideoClipDrag = planVideoClipDrag; exports.planVideoPrefetch = planVideoPrefetch; exports.planVideoToolPlayback = planVideoToolPlayback; exports.probeVideoMedia = probeVideoMedia; exports.readVideoScopesPanel = readVideoScopesPanel; exports.removeVideoKey = _chunkVKF3PWKRcjs.removeVideoKey; exports.renderVideoFrameExact = _chunkVKF3PWKRcjs.renderVideoFrameExact; exports.resolveVideoPreviewScale = resolveVideoPreviewScale; exports.retimeVideoAnimatable = _chunkVKF3PWKRcjs.retimeVideoAnimatable; exports.setVideoKey = _chunkVKF3PWKRcjs.setVideoKey; exports.snapToVideoFrame = _chunkVKF3PWKRcjs.snapToVideoFrame; exports.snapVideoTime = _chunkVKF3PWKRcjs.snapVideoTime; exports.sortVideoKeys = _chunkVKF3PWKRcjs.sortVideoKeys; exports.sortedVideoClips = _chunkVKF3PWKRcjs.sortedVideoClips; exports.splitVideoAnimatable = _chunkVKF3PWKRcjs.splitVideoAnimatable; exports.summarizeVideoScopes = summarizeVideoScopes; exports.toVideoEdl = _chunkVKF3PWKRcjs.toVideoEdl; exports.toVideoFfmpeg = _chunkVKF3PWKRcjs.toVideoFfmpeg; exports.toVideoLoudnessMeasure = _chunkVKF3PWKRcjs.toVideoLoudnessMeasure; exports.videoAssetDropEdit = videoAssetDropEdit; exports.videoAssetHasSound = _chunkVKF3PWKRcjs.videoAssetHasSound; exports.videoAssetKindOf = videoAssetKindOf; exports.videoAssetMap = _chunkVKF3PWKRcjs.videoAssetMap; exports.videoAssetProxy = videoAssetProxy; exports.videoAudioLevels = videoAudioLevels; exports.videoAudioPeakRange = videoAudioPeakRange; exports.videoAudioPeakSpans = videoAudioPeakSpans; exports.videoAudioPeaksDuration = videoAudioPeaksDuration; exports.videoCacheEvictions = videoCacheEvictions; exports.videoChroma = videoChroma; exports.videoClipAfter = _chunkVKF3PWKRcjs.videoClipAfter; exports.videoClipAnimated = _chunkVKF3PWKRcjs.videoClipAnimated; exports.videoClipAnimationProperties = _chunkVKF3PWKRcjs.videoClipAnimationProperties; exports.videoClipAnimationSpans = _chunkVKF3PWKRcjs.videoClipAnimationSpans; exports.videoClipAppliedEffects = videoClipAppliedEffects; exports.videoClipBefore = _chunkVKF3PWKRcjs.videoClipBefore; exports.videoClipEffectUses = _chunkVKF3PWKRcjs.videoClipEffectUses; exports.videoClipEnd = _chunkVKF3PWKRcjs.videoClipEnd; exports.videoClipHandles = _chunkVKF3PWKRcjs.videoClipHandles; exports.videoClipKeyframes = videoClipKeyframes; exports.videoClipLabel = videoClipLabel; exports.videoClipOverhang = _chunkVKF3PWKRcjs.videoClipOverhang; exports.videoClipShowsWaveform = videoClipShowsWaveform; exports.videoClipSoundGain = _chunkVKF3PWKRcjs.videoClipSoundGain; exports.videoClipSourceRange = _chunkVKF3PWKRcjs.videoClipSourceRange; exports.videoClipSourceTime = _chunkVKF3PWKRcjs.videoClipSourceTime; exports.videoClipSpeed = _chunkVKF3PWKRcjs.videoClipSpeed; exports.videoClipSpeedAt = _chunkVKF3PWKRcjs.videoClipSpeedAt; exports.videoClipTint = videoClipTint; exports.videoClipWaveform = videoClipWaveform; exports.videoClipWaveformPath = videoClipWaveformPath; exports.videoClipsAt = _chunkVKF3PWKRcjs.videoClipsAt; exports.videoContactSheetSvg = _chunkVKF3PWKRcjs.videoContactSheetSvg; exports.videoDragLabel = videoDragLabel; exports.videoDropTracks = videoDropTracks; exports.videoEaseBezier = _chunkVKF3PWKRcjs.videoEaseBezier; exports.videoEaseProgress = _chunkVKF3PWKRcjs.videoEaseProgress; exports.videoEffectFrameTime = _chunkVKF3PWKRcjs.videoEffectFrameTime; exports.videoEffectLayerKey = _chunkVKF3PWKRcjs.videoEffectLayerKey; exports.videoEffectValuesAt = _chunkVKF3PWKRcjs.videoEffectValuesAt; exports.videoExposureNotes = videoExposureNotes; exports.videoExposureStats = videoExposureStats; exports.videoFadeCurveGain = _chunkVKF3PWKRcjs.videoFadeCurveGain; exports.videoFfmpegUnsupportedEffects = _chunkVKF3PWKRcjs.videoFfmpegUnsupportedEffects; exports.videoFrameAt = _chunkVKF3PWKRcjs.videoFrameAt; exports.videoFrameCacheKey = videoFrameCacheKey; exports.videoFrameDuration = _chunkVKF3PWKRcjs.videoFrameDuration; exports.videoFrameLeafLayers = _chunkVKF3PWKRcjs.videoFrameLeafLayers; exports.videoFrameRequestsAt = videoFrameRequestsAt; exports.videoFrameToSvg = _chunkVKF3PWKRcjs.videoFrameToSvg; exports.videoFrames = _chunkVKF3PWKRcjs.videoFrames; exports.videoFreezeFrameEdit = _chunkVKF3PWKRcjs.videoFreezeFrameEdit; exports.videoGradeCssFilter = _chunkVKF3PWKRcjs.videoGradeCssFilter; exports.videoGradeFfmpegFilters = _chunkVKF3PWKRcjs.videoGradeFfmpegFilters; exports.videoGradeGainsFilterId = _chunkVKF3PWKRcjs.videoGradeGainsFilterId; exports.videoGradeLook = _chunkVKF3PWKRcjs.videoGradeLook; exports.videoGradePreset = _chunkVKF3PWKRcjs.videoGradePreset; exports.videoGradeStepMatrix = _chunkVKF3PWKRcjs.videoGradeStepMatrix; exports.videoGradeStepSvgValues = _chunkVKF3PWKRcjs.videoGradeStepSvgValues; exports.videoGradeSteps = _chunkVKF3PWKRcjs.videoGradeSteps; exports.videoGradeSvgDefs = _chunkVKF3PWKRcjs.videoGradeSvgDefs; exports.videoGradeSvgFilter = _chunkVKF3PWKRcjs.videoGradeSvgFilter; exports.videoHistogram = videoHistogram; exports.videoHistogramImage = videoHistogramImage; exports.videoHourFrames = _chunkVKF3PWKRcjs.videoHourFrames; exports.videoIrisRadius = _chunkVKF3PWKRcjs.videoIrisRadius; exports.videoIssueKey = videoIssueKey; exports.videoKeyframeBreakpoints = _chunkVKF3PWKRcjs.videoKeyframeBreakpoints; exports.videoKeyframeFfmpegExpr = _chunkVKF3PWKRcjs.videoKeyframeFfmpegExpr; exports.videoKeyframeRows = videoKeyframeRows; exports.videoKeyframeToggleEdit = videoKeyframeToggleEdit; exports.videoKeyframeValueEdit = videoKeyframeValueEdit; exports.videoKeysOf = _chunkVKF3PWKRcjs.videoKeysOf; exports.videoLayersUseEffects = _chunkVKF3PWKRcjs.videoLayersUseEffects; exports.videoLayersWithoutTransitionEffects = _chunkVKF3PWKRcjs.videoLayersWithoutTransitionEffects; exports.videoLuma = videoLuma; exports.videoLumaWaveform = videoLumaWaveform; exports.videoLutEdits = videoLutEdits; exports.videoLutFromFunction = _chunkVKF3PWKRcjs.videoLutFromFunction; exports.videoLutSvgApproximation = _chunkVKF3PWKRcjs.videoLutSvgApproximation; exports.videoLutSvgPrimitives = _chunkVKF3PWKRcjs.videoLutSvgPrimitives; exports.videoLutToCube = _chunkVKF3PWKRcjs.videoLutToCube; exports.videoOverlap = _chunkVKF3PWKRcjs.videoOverlap; exports.videoPeakDb = videoPeakDb; exports.videoPreviewSrc = videoPreviewSrc; exports.videoProjectDuration = _chunkVKF3PWKRcjs.videoProjectDuration; exports.videoProjectEffects = _chunkVKF3PWKRcjs.videoProjectEffects; exports.videoProjectHasProxies = videoProjectHasProxies; exports.videoProjectSvg = _chunkVKF3PWKRcjs.videoProjectSvg; exports.videoProxyFfmpeg = videoProxyFfmpeg; exports.videoProxyName = videoProxyName; exports.videoProxyPlan = videoProxyPlan; exports.videoRemoveRangesEdits = videoRemoveRangesEdits; exports.videoRulerTicks = videoRulerTicks; exports.videoScopeImage = videoScopeImage; exports.videoSequenceChildren = _chunkVKF3PWKRcjs.videoSequenceChildren; exports.videoSequenceDuration = _chunkVKF3PWKRcjs.videoSequenceDuration; exports.videoSequenceMap = _chunkVKF3PWKRcjs.videoSequenceMap; exports.videoShellQuote = _chunkVKF3PWKRcjs.videoShellQuote; exports.videoSlowMotionRamp = _chunkVKF3PWKRcjs.videoSlowMotionRamp; exports.videoSnapPoints = _chunkVKF3PWKRcjs.videoSnapPoints; exports.videoSourceFrame = videoSourceFrame; exports.videoSourceFrameTime = videoSourceFrameTime; exports.videoSpeedRampEdit = _chunkVKF3PWKRcjs.videoSpeedRampEdit; exports.videoSpeedRampKeys = _chunkVKF3PWKRcjs.videoSpeedRampKeys; exports.videoTextStyle = _chunkVKF3PWKRcjs.videoTextStyle; exports.videoTimeRef = videoTimeRef; exports.videoTimeRemapBreakpoints = _chunkVKF3PWKRcjs.videoTimeRemapBreakpoints; exports.videoTimeRemapSpan = _chunkVKF3PWKRcjs.videoTimeRemapSpan; exports.videoTimecodeFrames = _chunkVKF3PWKRcjs.videoTimecodeFrames; exports.videoTimelineTranscript = videoTimelineTranscript; exports.videoTitleFrame = _chunkVKF3PWKRcjs.videoTitleFrame; exports.videoTrackSyncLocked = _chunkVKF3PWKRcjs.videoTrackSyncLocked; exports.videoTranscriptEdit = videoTranscriptEdit; exports.videoTranscriptTrack = videoTranscriptTrack; exports.videoTransformAt = _chunkVKF3PWKRcjs.videoTransformAt; exports.videoTransitionAudioCurve = _chunkVKF3PWKRcjs.videoTransitionAudioCurve; exports.videoTransitionEase = _chunkVKF3PWKRcjs.videoTransitionEase; exports.videoTransitionHasDirection = videoTransitionHasDirection; exports.videoValueAt = _chunkVKF3PWKRcjs.videoValueAt; exports.videoVectorscope = videoVectorscope; exports.videoVectorscopeAngle = videoVectorscopeAngle; exports.videoVectorscopeImage = videoVectorscopeImage; exports.videoVectorscopePoint = videoVectorscopePoint; exports.videoWaveformImage = videoWaveformImage; exports.videoWaveformPath = videoWaveformPath; exports.videoWipeRect = _chunkVKF3PWKRcjs.videoWipeRect; exports.videoWordAt = videoWordAt; exports.videoWordsRange = videoWordsRange; exports.withVideoPlayback = withVideoPlayback;

package/dist/video-editor/index.d.cts

@@ -32,3 +32,4 @@ export * from './controller.cjs';
 export * from './tools.cjs';
 export * from './effect-tools.cjs';
 export * from './ui.cjs';
+export * from './playback.cjs';

package/dist/video-editor/index.d.ts

@@ -32,3 +32,4 @@ export * from './controller.js';
 export * from './tools.js';
 export * from './effect-tools.js';
 export * from './ui.js';
+export * from './playback.js';

package/dist/video-editor/index.js

@@ -3226,6 +3226,55 @@ function checkPreviewScale(scale) {
   return scale === 1 ? "full" : scale;
 }
 
+// src/video-editor/playback.ts
+function videoTimeRef(at) {
+  return { kind: "time", id: [`t=${Math.round(at.time)}`, at.track ? `track=${at.track}` : "", at.clip ? `clip=${at.clip}` : ""].filter(Boolean).join(";") };
+}
+function parseVideoTimeRef(ref) {
+  if (ref.kind !== "time") return null;
+  const parts = Object.fromEntries(ref.id.split(";").map((p) => p.split("=")));
+  const time = Number(parts.t);
+  if (!Number.isFinite(time)) return null;
+  return { time, ...parts.track ? { track: parts.track } : {}, ...parts.clip ? { clip: parts.clip } : {} };
+}
+var num2 = (v) => typeof v === "number" && Number.isFinite(v);
+var str2 = (v) => typeof v === "string" && v.length > 0;
+function clipsOf(args) {
+  const out = [];
+  const add = (v) => str2(v) && !out.includes(v) && out.push(v);
+  add(args.clip);
+  add(args.target);
+  for (const key of ["clips", "ids"]) if (Array.isArray(args[key])) args[key].forEach(add);
+  return out.slice(0, 6);
+}
+function planVideoToolPlayback(tool, args) {
+  const clips = clipsOf(args);
+  const track = str2(args.track) ? args.track : void 0;
+  const newClip = args.clip && typeof args.clip === "object" ? args.clip : null;
+  const time = [args.start, args.at, args.time, args.to, newClip?.start].find(num2);
+  const click = (ref) => [{ type: "target", ref }, { type: "press" }, { type: "release" }];
+  if (clips.length === 1 && (time !== void 0 || track) && tool !== "split_video_clip") {
+    const clip = clips[0];
+    const to = videoTimeRef({ time: time ?? 0, ...track ? { track } : { clip } });
+    return [{ type: "target", ref: { kind: "clip", id: clip } }, { type: "press" }, { type: "target", ref: to }, { type: "release" }];
+  }
+  if (clips.length === 1 && time !== void 0) return click(videoTimeRef({ time, clip: clips[0] }));
+  if (clips.length) return clips.flatMap((id) => click({ kind: "clip", id }));
+  if (track) return click(time !== void 0 ? videoTimeRef({ time, track }) : { kind: "track", id: track });
+  if (time !== void 0) return click(videoTimeRef({ time }));
+  if (str2(args.marker)) return click({ kind: "marker", id: args.marker });
+  return null;
+}
+function withVideoPlayback(provider, surface = "video") {
+  const plan = (tool) => tool.plan || tool.playback !== void 0 ? tool : { ...tool, plan: (args) => planVideoToolPlayback(tool.name, args) };
+  const tools = provider.tools;
+  return {
+    ...provider,
+    playbackSurface: provider.playbackSurface ?? surface,
+    tools: typeof tools === "function" ? () => tools().map(plan) : tools.map(plan)
+  };
+}
+
 // src/video-editor/ui.ts
 var STEPS = [40, 100, 200, 500, 1e3, 2e3, 5e3, 1e4, 15e3, 3e4, 6e4, 12e4, 3e5, 6e5];
 function videoRulerTicks(duration, pxPerSecond, fps) {
@@ -4618,7 +4667,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
   };
   const reads = [getProject, listSequences, getFrame, getTranscript, findText, findFillers, findPauses, findGaps, checkProject, renderFrame, getScopes, previewCache, planProxies, exportFfmpeg, exportLoudnessMeasure, exportEdl, audioLevels, findSilences, seek, setPreviewScale];
   const writes = [setSettings, addAsset, updateAsset, removeAsset, setProxies, addTrack, updateTrack, removeTrack, moveTrack, addClip, moveClip, trimClip, splitClip, deleteClips, updateClip, setTransition, setSpeedRamp, addFreeze, removeRamp, setTranscript, removeRanges, applyGradePreset, copyGrade, setLut, removeLut, setKeyframes, removeKeyframes, slipClip, rollEdit, slideClip, liftRange, extractRange, splitAt, closeGaps, addMarker, removeMarker, editVideo, undo, redo];
-  return {
+  return withVideoPlayback({
     id: options.id ?? "video",
     namespace: options.namespace,
     title: "Video editor",
@@ -4635,7 +4684,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
         }
       });
     }
-  };
+  });
 }
 
 // src/video-editor/effect-tools.ts
@@ -4683,7 +4732,7 @@ function createVideoEffectsToolProvider(controller, options = {}) {
     const effect = effects.find((e) => e.id === (instance ?? r.effect?.id)) ?? (r.effect ? { id: r.effect.id, effect: r.effect.effect, role: "clip effect", enabled: r.effect.enabled !== false, values: r.effect.values ?? {} } : effects[0]);
     return { target, effect, effects, ...extra };
   };
-  return createEffectToolProvider({
+  return withVideoPlayback(createEffectToolProvider({
     id: options.id ?? "video-effects",
     namespace: options.namespace,
     title: "Video effects",
@@ -4810,7 +4859,7 @@ function createVideoEffectsToolProvider(controller, options = {}) {
         }
       }
     ]
-  });
+  }));
 }
 export {
   VIDEO_BLEND_MODES,
@@ -4910,6 +4959,7 @@ export {
   parseVideoPreviewScale,
   parseVideoProject,
   parseVideoSequence,
+  parseVideoTimeRef,
   parseVideoTimeRemap,
   parseVideoTrack,
   parseVideoTranscript,
@@ -4919,6 +4969,7 @@ export {
   placeVideoRect,
   planVideoClipDrag,
   planVideoPrefetch,
+  planVideoToolPlayback,
   probeVideoMedia,
   readVideoScopesPanel,
   removeVideoKey,
@@ -5042,6 +5093,7 @@ export {
   videoSpeedRampEdit,
   videoSpeedRampKeys,
   videoTextStyle,
+  videoTimeRef,
   videoTimeRemapBreakpoints,
   videoTimeRemapSpan,
   videoTimecodeFrames,
@@ -5063,5 +5115,6 @@ export {
   videoWaveformPath,
   videoWipeRect,
   videoWordAt,
-  videoWordsRange
+  videoWordsRange,
+  withVideoPlayback
 };

package/dist/video-editor/playback.d.cts

@@ -0,0 +1,20 @@
+import type { AgentToolProvider } from '../tools/registry.cjs';
+import type { PlaybackRef, PlaybackStep } from '../tools/playback.cjs';
+/** A point on the timeline: `time` (ms), on `track` or on the row of `clip` (else the ruler). */
+export interface VideoPlaybackTime {
+    time: number;
+    track?: string;
+    clip?: string;
+}
+/** A timeline point as a playback ref: `{ kind: 'time', id: 't=1200;track=v1' }`. */
+export declare function videoTimeRef(at: VideoPlaybackTime): PlaybackRef;
+/** Reads a `time` ref back (null for any other ref). */
+export declare function parseVideoTimeRef(ref: PlaybackRef): VideoPlaybackTime | null;
+/** The cursor steps for one video tool call (by bare name), or null to fall back to the ids it names. */
+export declare function planVideoToolPlayback(tool: string, args: Record<string, any>): PlaybackStep[] | null;
+/**
+ * Gives a video tool provider agent playback: each write tool plans its steps with
+ * `planVideoToolPlayback` and every call plays on `surface` (default `video`, where `VideoTimeline`
+ * attaches itself). `seek_video` (a read in name only) and `edit_video` (a batch) play too.
+ */
+export declare function withVideoPlayback(provider: AgentToolProvider, surface?: string): AgentToolProvider;

package/dist/video-editor/playback.d.ts

@@ -0,0 +1,20 @@
+import type { AgentToolProvider } from '../tools/registry.js';
+import type { PlaybackRef, PlaybackStep } from '../tools/playback.js';
+/** A point on the timeline: `time` (ms), on `track` or on the row of `clip` (else the ruler). */
+export interface VideoPlaybackTime {
+    time: number;
+    track?: string;
+    clip?: string;
+}
+/** A timeline point as a playback ref: `{ kind: 'time', id: 't=1200;track=v1' }`. */
+export declare function videoTimeRef(at: VideoPlaybackTime): PlaybackRef;
+/** Reads a `time` ref back (null for any other ref). */
+export declare function parseVideoTimeRef(ref: PlaybackRef): VideoPlaybackTime | null;
+/** The cursor steps for one video tool call (by bare name), or null to fall back to the ids it names. */
+export declare function planVideoToolPlayback(tool: string, args: Record<string, any>): PlaybackStep[] | null;
+/**
+ * Gives a video tool provider agent playback: each write tool plans its steps with
+ * `planVideoToolPlayback` and every call plays on `surface` (default `video`, where `VideoTimeline`
+ * attaches itself). `seek_video` (a read in name only) and `edit_video` (a batch) play too.
+ */
+export declare function withVideoPlayback(provider: AgentToolProvider, surface?: string): AgentToolProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.140.4",
+  "version": "0.142.1",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",

package/skills/pixerate-agent-tools/SKILL.md

@@ -61,6 +61,19 @@ editor's, or (in discovery mode) only `list_toolsets`, `search_tools`, `enable_t
 6. **Undo your own mistakes** with the domain's `undo_*` tool or the `history.undo` command, not
    by hand-reverting with more edits.
 
+## Playback
+
+The host may act your calls out on screen (agent playback): your cursor glides to what a call
+names, presses, drags or types, and the change lands as one undo step. Results are the same with
+or without it, and calls simply take a little longer while it plays.
+
+- Do not add waits or poll for the animation; each call returns once its change is applied.
+- Name your targets with the ids read tools return (`ids`, `nodeId`, `layerId`, a range). They are
+  also what the cursor heads for, so the user can follow along.
+- A batch (`run_commands`) plays its steps' moves first, then applies once as one undo step.
+- If you connect over MCP, your client's name labels your cursor; several agents get separate
+  cursors.
+
 ## Errors
 
 A failed call comes back as an `isError` result whose text says what was wrong and how to fix

package/skills/pixerate-animation-editor/SKILL.md

@@ -147,6 +147,7 @@ refuse.
 
 ## Pitfalls
 
+- With agent playback on, the cursor clicks the shot a call names in the timeline and visits the stage elements its commands target. Results are unchanged.
 - **Effect commands are ordinary commands.** You can retime or edit them with `edit_animation` like
   any command, but `update_effect` replaces all of an effect's commands. Change values through the
   effect, and timing through the commands.

package/skills/pixerate-canvas/SKILL.md

@@ -271,6 +271,9 @@ effects provider (for example Flair); without one the read tools say so and the
   `get_editor_state` again, not guess.
 - `canvas_add_node` with `nearNodeId` also adds an edge from that node. Pass an explicit
   `position` (and no `nearNodeId`) for a free-standing design element.
+- With agent playback on, the cursor clicks where `canvas_add_node` will place the node, drags
+  `canvas_connect` from source to target, and rings the nodes a layout or arrange command moved.
+  Nothing about the calls changes: still read ids with `get_editor_state` and pass them back.
 - `canvas_update_node` changes `data` only. Move nodes with layout, align or distribute commands,
   or by the host's own means; do not expect `position` inside `data` to move anything.
 - Align needs at least two nodes and distribute at least three; locked nodes never move. Shape

package/skills/pixerate-chart/SKILL.md

@@ -168,6 +168,7 @@ several charts may register them with another prefix.
 
 ## Pitfalls
 
+- With agent playback on, value changes and selections are dragged by the chart's director, and other changes are clicked on the inspector option, data grid or toolbar they belong to. Results are unchanged.
 - Series values are positional: one value per category, in category order. After
   `add_chart_category` or `remove_chart_category`, every series shifts with it.
 - `set_chart_data` with only `series` keeps the categories; with only `categories` it keeps

package/skills/pixerate-image-editor/SKILL.md

@@ -415,8 +415,8 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 
 ## Pitfalls
 
-- Effects need a shape: on an empty layer they draw nothing. They cannot go on adjustment
-  layers. A clipped layer's effects stay inside the layer it is clipped to.
+- Agent playback (if on) opens each write's panel, then traces `points`, drags boxes or visits the layers and sliders named; results are unchanged.
+- Effects need a shape: on an empty layer they draw nothing. They cannot go on adjustment layers. A clipped layer's effects stay inside the layer it is clipped to.
 - `bevel-emboss` has no `blend` / `opacity`: it uses `highlightBlend`, `highlightOpacity`,
   `shadowBlend` and `shadowOpacity`. Inner shadows and inner glows use `choke`, not `spread`.
 - Glows paint a colour or a gradient, never a pattern; strokes take all three. Pattern effects

package/skills/pixerate-paint-editor/SKILL.md

@@ -417,6 +417,7 @@ for the controls and presets.
 
 ## Pitfalls
 
+- With agent playback on, strokes, fills and replays are painted live by the director, and other writes open their panel (Colour, Wet, Paper, Layers, Effects) and point at the control. Results are unchanged.
 - **Stroke-by-stroke drawing is slow and expensive.** Do not draw a detailed picture point by
   point. Block in with fills and big strokes, then replay and vary a few good strokes.
 - **A hidden or locked layer refuses paint**: show it (`update_layer visible true`) or unlock it.

package/skills/pixerate-parameters/SKILL.md

@@ -69,6 +69,7 @@ with `list_commands` (query "Parameters").
 
 ## Pitfalls
 
+- With agent playback on, `parameters.set` visits each control it changes and types the value. Set related values in one call; results are unchanged.
 - `parameters.set` takes a `values` object, not top-level ids: `{ "values": { "speed": 2 } }`.
 - One out-of-range value fails the whole call (nothing changes). Read the message, fix that
   value, and resend the full set.

package/skills/pixerate-spreadsheet/SKILL.md

@@ -126,6 +126,7 @@ nothing to do they fail with the reason.
 
 ## Pitfalls
 
+- With agent playback on, `set_cell` is clicked and typed, `set_range` is dragged across the block it fills, and row and column edits mark their rows or columns. Results are unchanged; keep writing whole blocks with `set_range`.
 - **Raw versus computed.** `values` holds results, `raw` holds what to edit. When copying or
   moving a formula, copy from `raw`; `set_range` writes references as given (it does not
   offset relative references the way paste or fill-down does), so write each row's formula