@pixerate/editor 0.90.0 → 0.91.0

package/dist/video-editor/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7;
 
 var _chunkWAJQKWQUcjs = require('../chunk-WAJQKWQU.cjs');
 
@@ -852,12 +852,33 @@ function parseVideoAsset(v, path = "asset") {
     height: num(v.height, `${path}.height`, { optional: true, positive: true }),
     hasAudio: bool(v.hasAudio, `${path}.hasAudio`),
     poster: str(v.poster, `${path}.poster`, true),
-    transcript: parseVideoTranscriptWords(v.transcript, `${path}.transcript`)
+    transcript: parseVideoTranscriptWords(v.transcript, `${path}.transcript`),
+    proxies: parseVideoAssetProxies(v.proxies, `${path}.proxies`)
   });
+  if (kind !== "video" && asset.proxies) fail(`${path}.proxies`, "are only for video assets");
   if (kind === "image" && asset.transcript) fail(`${path}.transcript`, "is only for video and audio assets");
   if (kind === "image" && asset.duration !== void 0) fail(`${path}.duration`, "is only for video and audio assets");
   return asset;
 }
+function parseVideoAssetProxies(v, path) {
+  if (v === void 0) return void 0;
+  if (!Array.isArray(v)) return fail(path, "must be a list of { scale, src }");
+  const out = v.map((p, i) => {
+    const at = `${path}[${i}]`;
+    if (!isObject(p)) return fail(at, "must be an object { scale, src }");
+    const unknown = Object.keys(p).find((k) => !["scale", "src", "width", "height"].includes(k));
+    if (unknown) fail(`${at}.${unknown}`, "is not a proxy setting; use scale, src, width, height");
+    const scale = num(p.scale, `${at}.scale`, { positive: true });
+    if (scale >= 1) fail(`${at}.scale`, "must be less than 1 (0.5 is half size)");
+    return compact({ scale, src: str(p.src, `${at}.src`), width: num(p.width, `${at}.width`, { optional: true, positive: true }), height: num(p.height, `${at}.height`, { optional: true, positive: true }) });
+  });
+  const scales = /* @__PURE__ */ new Set();
+  for (const [i, p] of out.entries()) {
+    if (scales.has(p.scale)) fail(`${path}[${i}].scale`, `repeats ${p.scale}; give each proxy its own scale`);
+    scales.add(p.scale);
+  }
+  return out.length ? out : void 0;
+}
 function parseVideoClip(v, path = "clip") {
   if (!isObject(v)) return fail(path, "must be an object");
   const type = oneOf(_nullishCoalesce(v.type, () => ( "media")), VIDEO_CLIP_TYPES, `${path}.type`, false);
@@ -3219,7 +3240,7 @@ var color = (c) => {
   const h = hex[1].length === 3 ? [...hex[1]].map((x) => x + x).join("") : hex[1];
   return `0x${h.slice(0, 6)}${h.length === 8 ? `@${(parseInt(h.slice(6), 16) / 255).toFixed(3)}` : ""}`;
 };
-var shellQuote = (s) => /^[\w@%+=:,./-]+$/.test(s) ? s : `'${s.replace(/'/g, `'\\''`)}'`;
+var videoShellQuote = (s) => /^[\w@%+=:,./-]+$/.test(s) ? s : `'${s.replace(/'/g, `'\\''`)}'`;
 function atempo(speed) {
   const out = [];
   let s = speed;
@@ -3515,7 +3536,7 @@ function buildFfmpeg(project, options, measure) {
   const filterComplex = graph.join(";");
   if (measure) {
     const args2 = ["-hide_banner", "-nostats", ...inputs.flat(), "-filter_complex", filterComplex, "-map", "[aout]", "-f", "null", "-"];
-    return { args: args2, command: ["ffmpeg", ...args2].map(shellQuote).join(" "), filterComplex, duration: D, notes };
+    return { args: args2, command: ["ffmpeg", ...args2].map(videoShellQuote).join(" "), filterComplex, duration: D, notes };
   }
   const args = [
     "-y",
@@ -3536,20 +3557,349 @@ function buildFfmpeg(project, options, measure) {
     sec(D),
     _nullishCoalesce(options.output, () => ( "output.mp4"))
   ];
-  return { args, command: ["ffmpeg", ...args].map(shellQuote).join(" "), filterComplex, duration: D, notes };
+  return { args, command: ["ffmpeg", ...args].map(videoShellQuote).join(" "), filterComplex, duration: D, notes };
+}
+
+// src/video-editor/proxy.ts
+var VIDEO_PROXY_SCALES = [0.5, 0.25];
+function videoAssetProxy(asset, scale) {
+  if (!_optionalChain([asset, 'optionalAccess', _88 => _88.proxies, 'optionalAccess', _89 => _89.length]) || !(scale > 0) || scale >= 1) return null;
+  let best = null;
+  for (const p of asset.proxies) if (p.scale >= scale - 1e-9 && p.scale < 1 && (!best || p.scale < best.scale)) best = p;
+  return best;
+}
+var videoPreviewSrc = (asset, scale, fallback = _nullishCoalesce(_optionalChain([asset, 'optionalAccess', _90 => _90.src]), () => ( ""))) => _nullishCoalesce(_optionalChain([videoAssetProxy, 'call', _91 => _91(asset, scale), 'optionalAccess', _92 => _92.src]), () => ( fallback));
+function resolveVideoPreviewScale(scale, shown) {
+  if (scale === void 0 || scale === "auto") return Math.min(1, Math.max(0, shown));
+  if (scale === "full") return 1;
+  return Math.min(1, Math.max(0, scale));
+}
+function videoProxyName(src, scale = 0.5) {
+  const clean = src.replace(/[?#].*$/, "");
+  const base = clean.replace(/\.[^./\\]+$/, "");
+  return `${base}.proxy-${Math.round(scale * 100)}.mp4`;
+}
+function videoProxyFfmpeg(asset, options = {}) {
+  if (asset.kind !== "video") throw new Error(`Asset "${asset.id}" is ${asset.kind === "image" ? "an image" : "audio"}; only video assets have proxies.`);
+  const scale = _nullishCoalesce(options.scale, () => ( 0.5));
+  if (!(scale > 0 && scale < 1)) throw new Error(`A proxy's scale must be between 0 and 1 (not including either), not ${scale}; 0.5 is half size.`);
+  const gop = Math.max(1, Math.round(_nullishCoalesce(options.gop, () => ( 12))));
+  const output = _nullishCoalesce(options.output, () => ( videoProxyName(asset.src, scale)));
+  const src = options.resolve ? options.resolve(asset) : asset.src;
+  const size = `scale=trunc(iw*${scale}/2)*2:trunc(ih*${scale}/2)*2`;
+  const args = [
+    "-y",
+    "-i",
+    src,
+    "-vf",
+    size,
+    "-c:v",
+    "libx264",
+    "-preset",
+    "veryfast",
+    "-tune",
+    "fastdecode",
+    "-crf",
+    String(_nullishCoalesce(options.crf, () => ( 28))),
+    "-g",
+    String(gop),
+    "-keyint_min",
+    String(gop),
+    "-sc_threshold",
+    "0",
+    "-bf",
+    "0",
+    "-pix_fmt",
+    "yuv420p",
+    ...asset.hasAudio === false ? ["-an"] : ["-c:a", "aac", "-b:a", "128k"],
+    "-movflags",
+    "+faststart",
+    output
+  ];
+  const proxy = { scale, src: output, ...asset.width && asset.height ? { width: Math.trunc(asset.width * scale / 2) * 2, height: Math.trunc(asset.height * scale / 2) * 2 } : {} };
+  return { asset: asset.id, args, command: ["ffmpeg", ...args].map(videoShellQuote).join(" "), proxy };
+}
+function videoProxyPlan(project, options = {}) {
+  const scale = _nullishCoalesce(options.scale, () => ( 0.5));
+  const wanted = options.assets ? new Set(options.assets) : null;
+  if (options.assets) for (const id of options.assets) {
+    const a = project.assets.find((x) => x.id === id);
+    if (!a) throw new Error(`There is no asset "${id}"; the assets are ${project.assets.map((x) => `"${x.id}"`).join(", ") || "none"}.`);
+    if (a.kind !== "video") throw new Error(`Asset "${id}" is ${a.kind === "image" ? "an image" : "audio"}; only video assets have proxies.`);
+  }
+  return project.assets.filter((a) => a.kind === "video" && (!wanted || wanted.has(a.id)) && !_optionalChain([a, 'access', _93 => _93.proxies, 'optionalAccess', _94 => _94.some, 'call', _95 => _95((p) => Math.abs(p.scale - scale) < 1e-9)])).map((a) => videoProxyFfmpeg(a, { ...options, scale }));
+}
+var VIDEO_PREVIEW_SCALE_OPTIONS = [
+  { value: "auto", label: "Auto", scale: "auto" },
+  { value: "full", label: "Full", scale: "full" },
+  ...VIDEO_PROXY_SCALES.map((s) => ({ value: String(s), label: s === 0.5 ? "\xBD" : s === 0.25 ? "\xBC" : `${s * 100}%`, scale: s }))
+];
+var parseVideoPreviewScale = (value) => value === "full" ? "full" : Number(value) > 0 && Number(value) <= 1 ? Number(value) : "auto";
+var videoProjectHasProxies = (project) => project.assets.some((a) => !!_optionalChain([a, 'access', _96 => _96.proxies, 'optionalAccess', _97 => _97.length]));
+
+// src/video-editor/frame-cache.ts
+var videoSourceFrame = (sourceTime, fps) => Math.max(0, Math.floor(sourceTime * fps / 1e3 + 1e-6));
+var videoSourceFrameTime = (frame, fps) => (frame + 0.5) * 1e3 / fps;
+var videoFrameCacheKey = (src, frame) => `${frame}@${src}`;
+function videoFrameRequestsAt(project, time, srcFor = (l) => l.src) {
+  const out = [];
+  for (const layer of videoFrameAt(project, time).layers) {
+    if (layer.type !== "media" || layer.assetKind !== "video") continue;
+    const src = srcFor(layer);
+    if (!src) continue;
+    const frame = videoSourceFrame(_nullishCoalesce(layer.sourceTime, () => ( 0)), project.fps);
+    out.push({ key: videoFrameCacheKey(src, frame), src, frame, sourceTime: videoSourceFrameTime(frame, project.fps), time });
+  }
+  return out;
+}
+function planVideoPrefetch(project, time, options = {}) {
+  const window2 = _nullishCoalesce(options.window, () => ( 2e3));
+  const dir = _nullishCoalesce(options.direction, () => ( 1));
+  const step = 1e3 / project.fps;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (let i = 0; i * step <= window2 + 1e-6; i++) {
+    const t = time + dir * i * step;
+    if (t < 0) break;
+    for (const r of videoFrameRequestsAt(project, t, options.srcFor)) {
+      if (seen.has(r.key)) continue;
+      seen.add(r.key);
+      out.push(r);
+    }
+  }
+  return out;
+}
+function videoCacheEvictions(entries, options) {
+  let total = entries.reduce((n2, e) => n2 + e.bytes, 0);
+  if (total <= options.maxBytes) return [];
+  const dir = _nullishCoalesce(options.direction, () => ( 1));
+  const behind = _nullishCoalesce(options.behind, () => ( 2));
+  const cost = (e) => {
+    const d = (e.time - options.playhead) * dir;
+    return d >= 0 ? d : -d * behind;
+  };
+  const out = [];
+  for (const e of entries.filter((x) => !_optionalChain([options, 'access', _98 => _98.protect, 'optionalAccess', _99 => _99.has, 'call', _100 => _100(x.key)])).sort((a, b) => cost(b) - cost(a))) {
+    if (total <= options.maxBytes) break;
+    out.push(e.key);
+    total -= e.bytes;
+  }
+  return out;
+}
+var defaultCapture = async (source) => {
+  if (typeof createImageBitmap !== "function") return null;
+  const image = await createImageBitmap(source);
+  return { image, width: image.width, height: image.height };
+};
+var VideoFrameCache = (_class5 = class {
+  constructor(options = {}) {;_class5.prototype.__init13.call(this);_class5.prototype.__init14.call(this);_class5.prototype.__init15.call(this);_class5.prototype.__init16.call(this);_class5.prototype.__init17.call(this);_class5.prototype.__init18.call(this);_class5.prototype.__init19.call(this);_class5.prototype.__init20.call(this);_class5.prototype.__init21.call(this);_class5.prototype.__init22.call(this);_class5.prototype.__init23.call(this);_class5.prototype.__init24.call(this);
+    this.options = options;
+    this.maxBytes = _nullishCoalesce(options.maxBytes, () => ( 512 * 1024 * 1024));
+    this.prefetch = _nullishCoalesce(options.prefetch, () => ( 2e3));
+    this.decode = options.decode !== void 0 ? options.decode : typeof document !== "undefined" ? createVideoElementDecoder() : null;
+  }
+  
+  __init13() {this.entries = /* @__PURE__ */ new Map()}
+  __init14() {this.inFlight = /* @__PURE__ */ new Set()}
+  __init15() {this.queue = []}
+  __init16() {this.protect = /* @__PURE__ */ new Set()}
+  __init17() {this.listeners = /* @__PURE__ */ new Set()}
+  __init18() {this.playhead = 0}
+  __init19() {this.direction = 1}
+  __init20() {this.hits = 0}
+  __init21() {this.misses = 0}
+  __init22() {this.bytes = 0}
+  __init23() {this.generation = 0}
+  __init24() {this.destroyed = false}
+  
+  
+  
+  
+  /** The cached frame of `src` showing at a source time (ms), on the project's `fps` grid. Counts a hit or a miss. */
+  get(src, sourceTime, fps) {
+    const entry = this.entries.get(videoFrameCacheKey(src, videoSourceFrame(sourceTime, fps)));
+    if (entry) this.hits++;
+    else this.misses++;
+    return _optionalChain([entry, 'optionalAccess', _101 => _101.frame, 'access', _102 => _102.image]);
+  }
+  /** Whether a frame is cached, without counting it. */
+  has(src, sourceTime, fps) {
+    return this.entries.has(videoFrameCacheKey(src, videoSourceFrame(sourceTime, fps)));
+  }
+  /** Keeps a decoded frame (replacing any with the same key), then evicts to the budget. */
+  put(request, frame) {
+    if (this.destroyed) return void _optionalChain([frame, 'access', _103 => _103.image, 'access', _104 => _104.close, 'optionalCall', _105 => _105()]);
+    const old = this.entries.get(request.key);
+    if (old) this.drop(old);
+    const bytes = Math.max(1, frame.width * frame.height * 4);
+    this.entries.set(request.key, { key: request.key, time: request.time, bytes, frame });
+    this.bytes += bytes;
+    this.evict();
+    this.emit();
+  }
+  /** Keeps what a ready media element shows now as the frame of `src` at `sourceTime` (async; does nothing if it is cached). */
+  capture(src, sourceTime, fps, time, source) {
+    const frame = videoSourceFrame(sourceTime, fps);
+    const key = videoFrameCacheKey(src, frame);
+    if (this.entries.has(key) || this.inFlight.has(key)) return;
+    this.inFlight.add(key);
+    void (_nullishCoalesce(this.options.capture, () => ( defaultCapture)))(source).then((f) => {
+      if (f) this.put({ key, time }, f);
+    }).catch(() => {
+    }).finally(() => this.inFlight.delete(key));
+  }
+  /**
+   * Follows the playhead: protects the prefetch window, evicts to the budget, and queues the
+   * window's missing frames for decoding (nearest first). `srcFor` gives the file a layer plays.
+   */
+  update(project, time, options = {}) {
+    if (this.destroyed) return;
+    this.direction = _nullishCoalesce(options.direction, () => ( (time < this.playhead && !options.playing ? -1 : 1)));
+    this.playhead = time;
+    this.srcFor = options.srcFor;
+    const plan = this.prefetch > 0 ? planVideoPrefetch(project, time, { window: this.prefetch, direction: this.direction, srcFor: options.srcFor }) : videoFrameRequestsAt(project, time, options.srcFor);
+    this.protect = new Set(plan.map((r) => r.key));
+    for (const r of plan) {
+      const e = this.entries.get(r.key);
+      if (e) e.time = r.time;
+    }
+    this.evict();
+    this.generation++;
+    this.queue = this.decode ? plan.filter((r) => !this.entries.has(r.key) && !this.inFlight.has(r.key)) : [];
+    this.pump();
+  }
+  /**
+   * The stretches of the timeline whose video frames are all cached, between `from` and `to` (ms),
+   * for the files the preview last played (its `srcFor`, e.g. proxies) unless `srcFor` is given.
+   * `step` (ms, at least a frame) samples more coarsely.
+   */
+  cachedRanges(project, options = {}) {
+    const step = Math.max(1e3 / project.fps, _nullishCoalesce(options.step, () => ( 0)));
+    const from = Math.max(0, _nullishCoalesce(options.from, () => ( 0)));
+    const to = _nullishCoalesce(options.to, () => ( Math.max(...project.tracks.flatMap((t) => t.clips.map((c) => c.start + c.duration)), 0)));
+    const out = [];
+    for (let t = from; t < to - 1e-6; t += step) {
+      const requests = videoFrameRequestsAt(project, t, _nullishCoalesce(options.srcFor, () => ( this.srcFor)));
+      const cached = requests.length > 0 && requests.every((r) => this.entries.has(r.key));
+      const last = out[out.length - 1];
+      if (!cached) continue;
+      const end = Math.min(to, t + step);
+      if (last && Math.abs(last.end - t) < 1e-6) last.end = end;
+      else out.push({ start: t, end });
+    }
+    return out.map((r) => ({ start: Math.round(r.start * 10) / 10, end: Math.round(r.end * 10) / 10 }));
+  }
+  stats() {
+    return { frames: this.entries.size, bytes: this.bytes, maxBytes: this.maxBytes, hits: this.hits, misses: this.misses, pending: this.inFlight.size + this.queue.length, prefetch: this.prefetch };
+  }
+  /** Called when frames arrive or leave. */
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  /** Drops every frame (closing them) and the queue. */
+  clear() {
+    for (const e of [...this.entries.values()]) this.drop(e);
+    this.queue = [];
+    this.generation++;
+    this.emit();
+  }
+  /** Clears and stops decoding for good. */
+  destroy() {
+    this.clear();
+    this.destroyed = true;
+    this.listeners.clear();
+  }
+  pump() {
+    const limit = Math.max(1, _nullishCoalesce(this.options.concurrency, () => ( 2)));
+    while (this.decode && this.inFlight.size < limit && this.queue.length) {
+      const r = this.queue.shift();
+      if (this.entries.has(r.key) || this.inFlight.has(r.key)) continue;
+      if (this.bytes >= this.maxBytes && [...this.entries.keys()].every((k) => this.protect.has(k))) {
+        this.queue = [];
+        break;
+      }
+      const generation = this.generation;
+      this.inFlight.add(r.key);
+      this.decode(r.src, r.sourceTime).then(
+        (frame) => {
+          this.inFlight.delete(r.key);
+          if (generation === this.generation || this.bytes + frame.width * frame.height * 4 <= this.maxBytes) this.put(r, frame);
+          else _optionalChain([frame, 'access', _106 => _106.image, 'access', _107 => _107.close, 'optionalCall', _108 => _108()]);
+        },
+        () => this.inFlight.delete(r.key)
+      ).finally(() => this.pump());
+    }
+  }
+  evict() {
+    const drop = videoCacheEvictions([...this.entries.values()], { playhead: this.playhead, maxBytes: this.maxBytes, direction: this.direction, behind: this.options.behind, protect: this.protect });
+    for (const key of drop) this.drop(this.entries.get(key));
+  }
+  drop(e) {
+    this.entries.delete(e.key);
+    this.bytes -= e.bytes;
+    _optionalChain([e, 'access', _109 => _109.frame, 'access', _110 => _110.image, 'access', _111 => _111.close, 'optionalCall', _112 => _112()]);
+  }
+  emit() {
+    for (const l of [...this.listeners]) l();
+  }
+}, _class5);
+function createVideoElementDecoder(options = {}) {
+  const videos = /* @__PURE__ */ new Map();
+  const make = _nullishCoalesce(options.createVideo, () => ( (() => {
+    const el = document.createElement("video");
+    el.muted = true;
+    el.preload = "auto";
+    el.crossOrigin = "anonymous";
+    el.playsInline = true;
+    return el;
+  })));
+  const timeout = _nullishCoalesce(options.timeout, () => ( 5e3));
+  const once = (el, type) => new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error(`The video did not ${type} within ${timeout} ms.`)), timeout);
+    el.addEventListener(type, () => (clearTimeout(timer), resolve()), { once: true });
+    el.addEventListener("error", () => (clearTimeout(timer), reject(new Error("The video could not be loaded."))), { once: true });
+  });
+  return (src, sourceTime) => {
+    let v = videos.get(src);
+    if (!v) {
+      const el2 = make();
+      el2.src = src;
+      v = { el: el2, chain: el2.readyState >= 1 ? Promise.resolve() : once(el2, "loadedmetadata") };
+      videos.set(src, v);
+    }
+    const { el } = v;
+    const next = v.chain.then(async () => {
+      const presented = "requestVideoFrameCallback" in el ? new Promise((r) => el.requestVideoFrameCallback(() => r())) : null;
+      const seeked = once(el, "seeked");
+      el.currentTime = sourceTime / 1e3;
+      await seeked;
+      if (presented) await Promise.race([presented, new Promise((r) => setTimeout(r, 100))]);
+      const image = await createImageBitmap(el);
+      return { image, width: image.width, height: image.height };
+    });
+    v.chain = next.catch(() => {
+    });
+    return next;
+  };
 }
 
 // src/video-editor/preview.ts
-var VideoPreviewEngine = (_class5 = class {
-  constructor(source, canvas2, options = {}) {;_class5.prototype.__init13.call(this);_class5.prototype.__init14.call(this);_class5.prototype.__init15.call(this);_class5.prototype.__init16.call(this);_class5.prototype.__init17.call(this);_class5.prototype.__init18.call(this);_class5.prototype.__init19.call(this);_class5.prototype.__init20.call(this);_class5.prototype.__init21.call(this);_class5.prototype.__init22.call(this);_class5.prototype.__init23.call(this);_class5.prototype.__init24.call(this);
+var VideoPreviewEngine = (_class6 = class {
+  constructor(source, canvas2, options = {}) {;_class6.prototype.__init25.call(this);_class6.prototype.__init26.call(this);_class6.prototype.__init27.call(this);_class6.prototype.__init28.call(this);_class6.prototype.__init29.call(this);_class6.prototype.__init30.call(this);_class6.prototype.__init31.call(this);_class6.prototype.__init32.call(this);_class6.prototype.__init33.call(this);_class6.prototype.__init34.call(this);_class6.prototype.__init35.call(this);_class6.prototype.__init36.call(this);_class6.prototype.__init37.call(this);_class6.prototype.__init38.call(this);_class6.prototype.__init39.call(this);
     this.source = source;
     this.options = options;
     this.canvas = canvas2;
-    this.ctx = options.context !== void 0 ? options.context : _nullishCoalesce(_optionalChain([canvas2, 'access', _91 => _91.getContext, 'optionalCall', _92 => _92("2d")]), () => ( null));
+    this.ctx = options.context !== void 0 ? options.context : _nullishCoalesce(_optionalChain([canvas2, 'access', _117 => _117.getContext, 'optionalCall', _118 => _118("2d")]), () => ( null));
     this.unsubscribe = source.subscribe(() => this.update());
     this.lutCache = options.luts !== void 0 ? options.luts : _nullishCoalesce(source.luts, () => ( null));
     this.unsubscribeLuts = this.lutCache ? this.lutCache.subscribe(() => this.redraw()) : () => {
     };
+    this.frameCache = options.frameCache !== void 0 ? options.frameCache : _nullishCoalesce(source.frameCache, () => ( null));
+    this.unsubscribeFrames = this.frameCache ? this.frameCache.subscribe(() => this.redraw()) : () => {
+    };
     const pixels = options.pixels !== void 0 ? options.pixels : source.previewPixels;
     this.detachPixels = pixels ? pixels.attach(() => this.readPixels()) : () => {
     };
@@ -3560,24 +3910,29 @@ var VideoPreviewEngine = (_class5 = class {
   
   
   
-  __init13() {this.media = /* @__PURE__ */ new Map()}
-  __init14() {this.images = /* @__PURE__ */ new Map()}
+  __init25() {this.media = /* @__PURE__ */ new Map()}
+  __init26() {this.images = /* @__PURE__ */ new Map()}
+  
+  __init27() {this.scheduled = false}
+  __init28() {this.destroyed = false}
+  __init29() {this.filterHost = null}
+  __init30() {this.filters = /* @__PURE__ */ new Set()}
+  
   
-  __init15() {this.scheduled = false}
-  __init16() {this.destroyed = false}
-  __init17() {this.filterHost = null}
-  __init18() {this.filters = /* @__PURE__ */ new Set()}
+  __init31() {this.drawn = null}
+  __init32() {this.complete = true}
   
   
-  __init19() {this.drawn = null}
-  __init20() {this.complete = true}
   
+  __init33() {this.srcFor = (layer) => layer.src}
+  __init34() {this.playing = false}
+  __init35() {this.fps = 30}
   
   
   /** The canvas's pixels and the frame they show, or `null` when its context cannot be read. */
   readPixels() {
     const ctx = this.ctx;
-    if (!_optionalChain([ctx, 'optionalAccess', _93 => _93.getImageData]) || !this.drawn) return null;
+    if (!_optionalChain([ctx, 'optionalAccess', _119 => _119.getImageData]) || !this.drawn) return null;
     return { ...this.drawn, pixels: ctx.getImageData(0, 0, this.canvas.width, this.canvas.height) };
   }
   createMedia(kind) {
@@ -3615,15 +3970,22 @@ var VideoPreviewEngine = (_class5 = class {
     entry.media.pause();
     entry.media.removeEventListener("seeked", entry.onReady);
     entry.media.removeEventListener("loadeddata", entry.onReady);
-    _optionalChain([entry, 'access', _94 => _94.media, 'access', _95 => _95.removeAttribute, 'optionalCall', _96 => _96("src")]);
-    _optionalChain([entry, 'access', _97 => _97.media, 'access', _98 => _98.load, 'optionalCall', _99 => _99()]);
+    _optionalChain([entry, 'access', _120 => _120.media, 'access', _121 => _121.removeAttribute, 'optionalCall', _122 => _122("src")]);
+    _optionalChain([entry, 'access', _123 => _123.media, 'access', _124 => _124.load, 'optionalCall', _125 => _125()]);
     this.media.delete(entry.clip);
   }
   /** Brings the media elements in step with the editor and draws the frame. */
   update() {
     if (this.destroyed) return;
-    const { project, time, playing } = this.source.getState();
+    const state = this.source.getState();
+    const { project, time, playing } = state;
     const frame = videoFrameAt(project, time);
+    const scale = resolveVideoPreviewScale(_nullishCoalesce(this.options.previewScale, () => ( state.previewScale)), this.resolutionFor(project.width));
+    const assets = new Map(project.assets.map((a) => [a.id, a]));
+    this.srcFor = (layer) => videoPreviewSrc(assets.get(_nullishCoalesce(layer.asset, () => ( ""))), scale, layer.src);
+    this.playing = playing;
+    this.fps = project.fps;
+    _optionalChain([this, 'access', _126 => _126.frameCache, 'optionalAccess', _127 => _127.update, 'call', _128 => _128(project, time, { playing, srcFor: this.srcFor })]);
     const tolerance = (_nullishCoalesce(this.options.tolerance, () => ( 200))) / 1e3;
     const active = /* @__PURE__ */ new Set();
     const sync = (clip, src, kind, sourceTime, speed, gain) => {
@@ -3650,7 +4012,7 @@ var VideoPreviewEngine = (_class5 = class {
     for (const layer of frame.layers) {
       if (layer.type !== "media" || layer.assetKind !== "video" || !layer.src) continue;
       const sound = sounding.get(layer.clip);
-      sync(layer.clip, layer.src, "video", _nullishCoalesce(layer.sourceTime, () => ( 0)), _nullishCoalesce(_optionalChain([sound, 'optionalAccess', _100 => _100.speed]), () => ( 1)), sound ? sound.gain : null);
+      sync(layer.clip, this.srcFor(layer), "video", _nullishCoalesce(layer.sourceTime, () => ( 0)), _nullishCoalesce(_optionalChain([sound, 'optionalAccess', _129 => _129.speed]), () => ( 1)), sound ? sound.gain : null);
       sounding.delete(layer.clip);
     }
     for (const a of sounding.values()) sync(a.clip, a.src, "audio", a.sourceTime, a.speed, a.gain);
@@ -3665,21 +4027,35 @@ var VideoPreviewEngine = (_class5 = class {
       if (!this.destroyed) this.draw(videoFrameAt(this.source.getState().project, this.source.getState().time));
     });
   }
-  __init21() {this.sourceFor = (layer) => {
+  __init36() {this.sourceFor = (layer) => {
     if (layer.assetKind === "image" && layer.src) {
       const img = this.image(layer.src);
       return img.complete ? img : null;
     }
     const entry = this.media.get(layer.clip);
-    if (!entry || entry.media.readyState < 2) return null;
+    const ready = !!entry && entry.media.readyState >= 2;
+    const cache = this.frameCache;
+    const src = _nullishCoalesce(_optionalChain([entry, 'optionalAccess', _130 => _130.src]), () => ( this.srcFor(layer)));
+    const sourceTime = _nullishCoalesce(layer.sourceTime, () => ( 0));
+    if (cache && src && (!this.playing || !ready || entry.media.seeking)) {
+      const hit = cache.get(src, sourceTime, this.fps);
+      if (hit) return hit;
+    }
+    if (!ready) return null;
     if (entry.media.seeking) this.complete = false;
+    else if (cache && !this.playing) cache.capture(entry.src, sourceTime, this.fps, this.source.getState().time, entry.media);
     return entry.media;
   }}
+  /** Canvas pixels per frame pixel: the option, else the displayed width at the device pixel ratio (at most 1). */
+  resolutionFor(frameWidth) {
+    if (this.options.resolution !== void 0) return this.options.resolution;
+    const shown = this.canvas.clientWidth || frameWidth;
+    const dpr = typeof window !== "undefined" ? window.devicePixelRatio || 1 : 1;
+    return Math.min(1, shown * dpr / frameWidth);
+  }
   draw(frame) {
     if (!this.ctx) return;
-    const shown = this.canvas.clientWidth || frame.width;
-    const dpr = typeof window !== "undefined" ? window.devicePixelRatio || 1 : 1;
-    const resolution = _nullishCoalesce(this.options.resolution, () => ( Math.min(1, shown * dpr / frame.width)));
+    const resolution = this.resolutionFor(frame.width);
     const w = Math.max(1, Math.round(frame.width * resolution));
     const h = Math.max(1, Math.round(frame.height * resolution));
     if (this.canvas.width !== w) this.canvas.width = w;
@@ -3692,16 +4068,16 @@ var VideoPreviewEngine = (_class5 = class {
     };
     drawVideoFrame(this.ctx, frame, sourceFor, resolution, { defineSvgFilter: this.defineSvgFilter, lutFor: this.lutFor, scratch: this.scratch });
     this.drawn = { time: frame.time, complete: this.complete };
-    _optionalChain([this, 'access', _101 => _101.options, 'access', _102 => _102.onFrame, 'optionalCall', _103 => _103(frame)]);
-    _optionalChain([this, 'access', _104 => _104.pixelsTarget, 'optionalAccess', _105 => _105.drawn, 'call', _106 => _106(frame.time, this.complete)]);
+    _optionalChain([this, 'access', _131 => _131.options, 'access', _132 => _132.onFrame, 'optionalCall', _133 => _133(frame)]);
+    _optionalChain([this, 'access', _134 => _134.pixelsTarget, 'optionalAccess', _135 => _135.drawn, 'call', _136 => _136(frame.time, this.complete)]);
   }
   /** A grade's LUT once loaded; while it loads (or if it fails) the frame is drawn without it and counts as incomplete. */
-  __init22() {this.lutFor = (src) => {
-    const lut = _optionalChain([this, 'access', _107 => _107.lutCache, 'optionalAccess', _108 => _108.get, 'call', _109 => _109(src)]);
+  __init37() {this.lutFor = (src) => {
+    const lut = _optionalChain([this, 'access', _137 => _137.lutCache, 'optionalAccess', _138 => _138.get, 'call', _139 => _139(src)]);
     if (!lut) this.complete = false;
     return lut;
   }}
-  __init23() {this.scratch = (width, height) => {
+  __init38() {this.scratch = (width, height) => {
     if (this.scratchCanvas === void 0) {
       if (this.options.createScratch) this.scratchCanvas = this.options.createScratch(width, height);
       else if (typeof document !== "undefined") {
@@ -3717,7 +4093,7 @@ var VideoPreviewEngine = (_class5 = class {
     if (c.height !== height) c.height = height;
     return s;
   }}
-  __init24() {this.defineSvgFilter = (id, markup) => {
+  __init39() {this.defineSvgFilter = (id, markup) => {
     if (this.options.defineSvgFilter === null) return;
     if (this.options.defineSvgFilter) return this.options.defineSvgFilter(id, markup);
     if (this.filters.has(id) || typeof document === "undefined") return;
@@ -3738,43 +4114,49 @@ var VideoPreviewEngine = (_class5 = class {
     this.destroyed = true;
     this.detachPixels();
     this.unsubscribeLuts();
-    _optionalChain([this, 'access', _110 => _110.filterHost, 'optionalAccess', _111 => _111.remove, 'call', _112 => _112()]);
+    this.unsubscribeFrames();
+    _optionalChain([this, 'access', _140 => _140.filterHost, 'optionalAccess', _141 => _141.remove, 'call', _142 => _142()]);
     this.filterHost = null;
     this.filters.clear();
     this.unsubscribe();
     for (const entry of [...this.media.values()]) this.release(entry);
     this.images.clear();
   }
-}, _class5);
+}, _class6);
 
 // src/video-editor/controller.ts
-var VideoEditorController = (_class6 = class {
+var VideoEditorController = (_class7 = class {
   
   
   /** Sound levels per asset, loaded on demand for waveforms and agents. */
   
   /** The pixels the preview last drew, for scopes and `get_video_scopes` (a `VideoPreviewEngine` fills it). */
-  __init25() {this.previewPixels = new VideoPreviewPixels()}
+  __init40() {this.previewPixels = new VideoPreviewPixels()}
   /** Grades' LUTs, loaded on demand for the preview, SVG frames and agents. */
   
+  /** The host's frame cache, if it gave one (the preview fills and reads it). */
+  
   
   
-  __init26() {this.selection = []}
+  __init41() {this.selection = []}
   
-  __init27() {this.error = null}
-  __init28() {this.revision = 0}
-  __init29() {this.applying = false}
   
-  __init30() {this.listeners = /* @__PURE__ */ new Set()}
-  __init31() {this.unsubscribers = []}
+  __init42() {this.error = null}
+  __init43() {this.revision = 0}
+  __init44() {this.applying = false}
   
-  constructor(options = {}) {;_class6.prototype.__init25.call(this);_class6.prototype.__init26.call(this);_class6.prototype.__init27.call(this);_class6.prototype.__init28.call(this);_class6.prototype.__init29.call(this);_class6.prototype.__init30.call(this);_class6.prototype.__init31.call(this);_class6.prototype.__init32.call(this);_class6.prototype.__init33.call(this);
+  __init45() {this.listeners = /* @__PURE__ */ new Set()}
+  __init46() {this.unsubscribers = []}
+  
+  constructor(options = {}) {;_class7.prototype.__init40.call(this);_class7.prototype.__init41.call(this);_class7.prototype.__init42.call(this);_class7.prototype.__init43.call(this);_class7.prototype.__init44.call(this);_class7.prototype.__init45.call(this);_class7.prototype.__init46.call(this);_class7.prototype.__init47.call(this);_class7.prototype.__init48.call(this);
     this.history = _nullishCoalesce(options.history, () => ( new (0, _chunkQKLRAA4Tcjs.HistoryManager)()));
     this.audioPeaks = options.audioPeaks instanceof VideoAudioPeaksCache ? options.audioPeaks : new VideoAudioPeaksCache(options.audioPeaks);
     this.luts = options.luts instanceof VideoLutCache ? options.luts : new VideoLutCache(options.luts);
+    this.frameCache = _nullishCoalesce(options.frameCache, () => ( null));
     this.project = options.project ? parseVideoProject(options.project) : createVideoProject();
     this.issues = checkVideoProject(this.project);
     this.readOnly = _nullishCoalesce(options.readOnly, () => ( false));
+    this.previewScale = checkPreviewScale(_nullishCoalesce(options.previewScale, () => ( "auto")));
     this.onChange = options.onChange;
     this.player = new (0, _chunk2FGRTYJNcjs.AnimationPlayer)({ clock: options.clock, duration: () => videoProjectDuration(this.project), loop: "none" });
     this.state = this.computeState();
@@ -3794,8 +4176,8 @@ var VideoEditorController = (_class6 = class {
     this.player.pause();
     this.unsubscribers.splice(0).forEach((u) => u());
   }
-  __init32() {this.getState = () => this.state}
-  __init33() {this.subscribe = (listener) => {
+  __init47() {this.getState = () => this.state}
+  __init48() {this.subscribe = (listener) => {
     this.connect();
     this.listeners.add(listener);
     return () => {
@@ -3824,6 +4206,7 @@ var VideoEditorController = (_class6 = class {
       canRedo: h.canRedo,
       undoLabel: h.undoName,
       redoLabel: h.redoName,
+      previewScale: this.previewScale,
       revision: this.revision
     };
   }
@@ -3851,7 +4234,7 @@ var VideoEditorController = (_class6 = class {
       this.applying = false;
     }
     this.notify();
-    _optionalChain([this, 'access', _113 => _113.onChange, 'optionalCall', _114 => _114(project)]);
+    _optionalChain([this, 'access', _143 => _143.onChange, 'optionalCall', _144 => _144(project)]);
   }
   commit(label, next) {
     const before = this.project;
@@ -3913,9 +4296,20 @@ var VideoEditorController = (_class6 = class {
     this.readOnly = readOnly;
     this.notify();
   }
+  /**
+   * Sets how large a picture the preview plays: `full` (the originals), a fraction such as 0.5
+   * (the smallest proxy at least that large, else the original) or `auto` (as large as the canvas
+   * shows). A view setting, not part of the project: no undo step.
+   */
+  setPreviewScale(scale) {
+    const next = checkPreviewScale(scale);
+    if (next === this.previewScale) return;
+    this.previewScale = next;
+    this.notify();
+  }
   /** Selects clips (unknown ids are dropped). `add` toggles them into the current selection. */
   select(clips, options = {}) {
-    const known = _nullishCoalesce(_optionalChain([clips, 'optionalAccess', _115 => _115.filter, 'call', _116 => _116((id) => findVideoClip(this.project, id))]), () => ( []));
+    const known = _nullishCoalesce(_optionalChain([clips, 'optionalAccess', _145 => _145.filter, 'call', _146 => _146((id) => findVideoClip(this.project, id))]), () => ( []));
     let next;
     if (options.add) {
       next = [...this.selection];
@@ -3996,7 +4390,12 @@ var VideoEditorController = (_class6 = class {
   toEdl(options = {}) {
     return toVideoEdl(this.project, options);
   }
-}, _class6);
+}, _class7);
+function checkPreviewScale(scale) {
+  if (scale === "auto" || scale === "full") return scale;
+  if (typeof scale !== "number" || !(scale > 0 && scale <= 1)) throw new Error(`A preview scale is "auto", "full" or a fraction above 0 up to 1 (0.5 is half size), not ${JSON.stringify(scale)}.`);
+  return scale === 1 ? "full" : scale;
+}
 
 // src/video-editor/ui.ts
 var STEPS = [40, 100, 200, 500, 1e3, 2e3, 5e3, 1e4, 15e3, 3e4, 6e4, 12e4, 3e5, 6e5];
@@ -4066,7 +4465,7 @@ function videoClipLabel(clip, asset) {
   if (clip.name) return clip.name;
   if (clip.type === "text") return clip.text.split("\n")[0];
   if (clip.type === "color") return clip.color;
-  const base = _nullishCoalesce(_nullishCoalesce(_optionalChain([asset, 'optionalAccess', _117 => _117.name]), () => ( _optionalChain([asset, 'optionalAccess', _118 => _118.src, 'access', _119 => _119.replace, 'call', _120 => _120(/^.*[\\/]/, "")]))), () => ( clip.asset));
+  const base = _nullishCoalesce(_nullishCoalesce(_optionalChain([asset, 'optionalAccess', _147 => _147.name]), () => ( _optionalChain([asset, 'optionalAccess', _148 => _148.src, 'access', _149 => _149.replace, 'call', _150 => _150(/^.*[\\/]/, "")]))), () => ( clip.asset));
   const speed = videoClipSpeed(clip);
   return speed !== 1 ? `${base} (${Math.round(speed * 100)}%)` : base;
 }
@@ -4110,7 +4509,7 @@ function videoAssetDropEdit(project, assetId, options = {}) {
   const asset = videoAssetMap(project).get(assetId);
   if (!asset) return null;
   const kind = asset.kind === "audio" ? "audio" : "video";
-  const track = _nullishCoalesce(options.track, () => ( _optionalChain([project, 'access', _121 => _121.tracks, 'access', _122 => _122.find, 'call', _123 => _123((t) => t.kind === kind && !t.locked), 'optionalAccess', _124 => _124.id])));
+  const track = _nullishCoalesce(options.track, () => ( _optionalChain([project, 'access', _151 => _151.tracks, 'access', _152 => _152.find, 'call', _153 => _153((t) => t.kind === kind && !t.locked), 'optionalAccess', _154 => _154.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 } : {} };
 }
@@ -4159,14 +4558,14 @@ var KEY_LABELS = {
   scale: { label: "Scale", step: 0.05 },
   rotation: { label: "Rotation", step: 1 }
 };
-var animatableOf = (clip, property) => VIDEO_TRANSFORM_PROPERTIES.includes(property) ? _optionalChain([clip, 'access', _125 => _125.transform, 'optionalAccess', _126 => _126[property]]) : property === "volume" ? clip.type === "media" ? clip.volume : void 0 : clip.opacity;
+var animatableOf = (clip, property) => VIDEO_TRANSFORM_PROPERTIES.includes(property) ? _optionalChain([clip, 'access', _155 => _155.transform, 'optionalAccess', _156 => _156[property]]) : property === "volume" ? clip.type === "media" ? 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 = findVideoClip(project, clipId);
   if (!at) return [];
   const { clip } = at;
   const asset = clip.type === "media" ? videoAssetMap(project).get(clip.asset) : void 0;
-  const visual = !(_optionalChain([asset, 'optionalAccess', _127 => _127.kind]) === "audio" || at.track.kind === "audio");
+  const visual = !(_optionalChain([asset, 'optionalAccess', _157 => _157.kind]) === "audio" || at.track.kind === "audio");
   const audible = clip.type === "media" && videoAssetHasSound(asset);
   const properties = [...visual ? ["opacity"] : [], ...audible ? ["volume"] : [], ...visual ? VIDEO_TRANSFORM_PROPERTIES : []];
   const clipTime = playheadInClip(clip, time);
@@ -4447,14 +4846,14 @@ function createVideoEditorToolProvider(controller, options = {}) {
     return null;
   };
   const placed = (o) => ({
-    ..._optionalChain([o, 'access', _128 => _128.created, 'optionalAccess', _129 => _129.length]) ? { created: o.created } : {},
-    ..._optionalChain([o, 'access', _130 => _130.trimmed, 'optionalAccess', _131 => _131.length]) ? { trimmed: o.trimmed } : {},
-    ..._optionalChain([o, 'access', _132 => _132.removed, 'optionalAccess', _133 => _133.length]) ? { removed: o.removed } : {},
+    ..._optionalChain([o, 'access', _158 => _158.created, 'optionalAccess', _159 => _159.length]) ? { created: o.created } : {},
+    ..._optionalChain([o, 'access', _160 => _160.trimmed, 'optionalAccess', _161 => _161.length]) ? { trimmed: o.trimmed } : {},
+    ..._optionalChain([o, 'access', _162 => _162.removed, 'optionalAccess', _163 => _163.length]) ? { removed: o.removed } : {},
     ...o.rippled ? { rippled: o.rippled } : {}
   });
   const keysOut = (p, clip, property) => {
     const c = clipOut(p, clip);
-    const value = VIDEO_TRANSFORM_PROPERTIES.includes(property) ? _optionalChain([c, 'optionalAccess', _134 => _134.transform, 'optionalAccess', _135 => _135[property]]) : _optionalChain([c, 'optionalAccess', _136 => _136[property]]);
+    const value = VIDEO_TRANSFORM_PROPERTIES.includes(property) ? _optionalChain([c, 'optionalAccess', _164 => _164.transform, 'optionalAccess', _165 => _165[property]]) : _optionalChain([c, 'optionalAccess', _166 => _166[property]]);
     return typeof value === "object" ? { keys: value.keys } : { keys: [], value: _nullishCoalesce(value, () => ( null)) };
   };
   const getProject = {
@@ -4466,7 +4865,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
     handler: () => {
       const state = controller.getState();
       const reason = readOnlyReason();
-      return { ...describeVideoProject(state.project), playhead: state.time, selection: state.selection, issues: issueSummary(state.issues), editable: !reason, ...reason ? { readOnlyReason: reason } : {} };
+      return { ...describeVideoProject(state.project), playhead: state.time, previewScale: state.previewScale, selection: state.selection, issues: issueSummary(state.issues), editable: !reason, ...reason ? { readOnlyReason: reason } : {} };
     }
   };
   const getFrame = {
@@ -4515,7 +4914,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', _137 => _137.grade, 'optionalAccess', _138 => _138.lut, 'optionalAccess', _139 => _139.src])).filter((x) => !!x)))];
+      const lutSrcs = [...new Set(p.tracks.flatMap((t) => t.clips.map((c) => _optionalChain([c, 'access', _167 => _167.grade, 'optionalAccess', _168 => _168.lut, 'optionalAccess', _169 => _169.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 ? videoContactSheetSvg(p, times, svgOptions) : videoProjectSvg(p, _nullishCoalesce(time, () => ( controller.getState().time)), svgOptions);
@@ -4634,7 +5033,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
     name: "update_video_asset",
     title: "Change media details",
     description: "Changes an asset's src, name, duration, size, sound or poster (e.g. relinking moved media). Clips that now run past its end are refused. Returns the asset.",
-    inputSchema: object({ asset: ASSET_ID, set: object(ASSET_FIELDS, [], "Fields to replace."), remove: { type: "array", items: { type: "string", enum: ["name", "duration", "width", "height", "hasAudio", "poster", "transcript"] }, description: "Fields to clear (transcript removes its words)." } }, ["asset"]),
+    inputSchema: object({ asset: ASSET_ID, set: object(ASSET_FIELDS, [], "Fields to replace."), remove: { type: "array", items: { type: "string", enum: ["name", "duration", "width", "height", "hasAudio", "poster", "transcript", "proxies"] }, description: "Fields to clear (transcript removes its words, proxies its proxies)." } }, ["asset"]),
     annotations: { title: "Change media details", ...WRITE_IDEMPOTENT },
     handler: ({ asset, set, remove }) => apply({ op: "update_asset", asset, set, remove }, "Change media", (r) => ({ asset: videoAssetOut(r.project.assets.find((a) => a.id === asset)) }))
   };
@@ -4756,7 +5155,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
       const at = findVideoClip(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', _140 => _140.assets, 'access', _141 => _141.find, 'call', _142 => _142((a) => a.id === clip.asset), 'optionalAccess', _143 => _143.kind]) === "audio")
+      if (at.track.kind !== "video" || clip.type === "media" && _optionalChain([p, 'access', _170 => _170.assets, 'access', _171 => _171.find, 'call', _172 => _172((a) => a.id === clip.asset), 'optionalAccess', _173 => _173.kind]) === "audio")
         throw new Error(`Clip "${id}" is sound only; grades change pictures. Pass clips on video tracks.`);
     }
   };
@@ -4779,7 +5178,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
         const grade = videoGradeLook(findVideoClip(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([findVideoClip, 'call', _144 => _144(r.project, id), 'optionalAccess', _145 => _145.clip, 'access', _146 => _146.grade]), () => ( null)) })) }));
+      return apply(edits, `Apply ${preset} look`, (r) => ({ clips: clips.map((id) => ({ id, grade: _nullishCoalesce(_optionalChain([findVideoClip, 'call', _174 => _174(r.project, id), 'optionalAccess', _175 => _175.clip, 'access', _176 => _176.grade]), () => ( null)) })) }));
     }
   };
   const copyGrade = {
@@ -4815,7 +5214,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([findVideoClip, 'call', _147 => _147(r.project, id), 'optionalAccess', _148 => _148.clip, 'access', _149 => _149.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([findVideoClip, 'call', _177 => _177(r.project, id), 'optionalAccess', _178 => _178.clip, 'access', _179 => _179.grade]), () => ( null)) })) }));
     }
   };
   const removeLut = {
@@ -4827,9 +5226,82 @@ function createVideoEditorToolProvider(controller, options = {}) {
     handler: ({ clips }) => {
       gradeTargets(clips);
       const p = project();
-      const withLut = clips.filter((id) => _optionalChain([findVideoClip, 'call', _150 => _150(p, id), 'access', _151 => _151.clip, 'access', _152 => _152.grade, 'optionalAccess', _153 => _153.lut]));
+      const withLut = clips.filter((id) => _optionalChain([findVideoClip, 'call', _180 => _180(p, id), 'access', _181 => _181.clip, 'access', _182 => _182.grade, 'optionalAccess', _183 => _183.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([findVideoClip, 'call', _154 => _154(r.project, id), 'optionalAccess', _155 => _155.clip, 'access', _156 => _156.grade]), () => ( null)) })) }));
+      return apply(videoLutEdits(p, withLut, null), "Remove LUT", (r) => ({ clips: clips.map((id) => ({ id, grade: _nullishCoalesce(_optionalChain([findVideoClip, 'call', _184 => _184(r.project, id), 'optionalAccess', _185 => _185.clip, 'access', _186 => _186.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." };
+  const planProxies = {
+    name: "plan_video_proxies",
+    title: "Plan proxy files",
+    description: 'Returns the ffmpeg commands that make smaller proxy copies of video assets for smooth preview playback, without changing anything: one per video asset (or each of "assets") that has no proxy at that scale yet, each with { asset, args, command, proxy }. Proxies are scaled, H.264 with a keyframe every few frames so scrubbing is quick, and keep the sound. After the host runs a command, attach its "proxy" with set_video_proxies. The export always uses the originals.',
+    inputSchema: object({
+      scale: PROXY_SCALE,
+      assets: { type: "array", items: ASSET_ID, minItems: 1, uniqueItems: true, description: "Only these video assets (default: every video asset without a proxy at this scale)." },
+      gop: { type: "integer", minimum: 1, maximum: 300, description: "Frames between keyframes (default 12): fewer makes seeking cheaper and files larger." },
+      crf: { type: "integer", minimum: 0, maximum: 51, description: "x264 quality, lower is better (default 28: proxies are for editing)." }
+    }),
+    annotations: { title: "Plan proxy files", ...READ },
+    handler: ({ scale, assets, gop, crf }) => {
+      const commands = videoProxyPlan(project(), { scale, assets, gop, crf });
+      return { scale: _nullishCoalesce(scale, () => ( 0.5)), commands, ...commands.length ? {} : { note: "Every video asset already has a proxy at this scale." } };
+    }
+  };
+  const setProxies = {
+    name: "set_video_proxies",
+    title: "Attach proxies",
+    description: "Sets a video asset's proxies, the smaller copies the preview plays instead of the original (one undo step); an empty list removes them. Each proxy must match the original's length and timing (plan_video_proxies makes such files). The export, EDL and source times always use the original. Returns the asset.",
+    inputSchema: object(
+      {
+        asset: { ...ASSET_ID, description: "A video asset id from get_video_project." },
+        proxies: {
+          type: "array",
+          maxItems: 8,
+          description: "Its proxies, one per scale (empty removes them all).",
+          items: object({ scale: PROXY_SCALE, src: { type: "string", minLength: 1, description: "Where the preview loads the proxy from (URL or path)." }, width: { type: "number", exclusiveMinimum: 0, description: "Its width in pixels." }, height: { type: "number", exclusiveMinimum: 0, description: "Its height in pixels." } }, ["scale", "src"], "One proxy.")
+        }
+      },
+      ["asset", "proxies"]
+    ),
+    annotations: { title: "Attach proxies", ...WRITE_IDEMPOTENT },
+    handler: ({ asset, proxies }) => {
+      const a = project().assets.find((x) => x.id === asset);
+      if (!a) throw new Error(`There is no asset "${asset}"; the assets are ${project().assets.map((x) => `"${x.id}"`).join(", ") || "none"}.`);
+      if (a.kind !== "video") throw new Error(`Asset "${asset}" is ${a.kind === "image" ? "an image" : "audio"}; only video assets have proxies.`);
+      const edit = proxies.length ? { op: "update_asset", asset, set: { proxies } } : { op: "update_asset", asset, remove: ["proxies"] };
+      return apply(edit, proxies.length ? "Attach proxies" : "Remove proxies", (r) => ({ asset: videoAssetOut(r.project.assets.find((x) => x.id === asset)) }));
+    }
+  };
+  const setPreviewScale = {
+    name: "set_video_preview_scale",
+    title: "Set the preview size",
+    description: 'Sets how large a picture the preview plays, without changing the project (no undo step): "full" plays the originals, a fraction (0.5, 0.25) plays the smallest proxy at least that large (or the original where there is none), "auto" (the default) picks by the size the preview is shown at. Use a proxy scale when playback stutters on large footage. Returns the setting and, for each video asset, what the preview plays at a fixed scale.',
+    inputSchema: object(
+      { scale: { anyOf: [{ type: "string", enum: ["auto", "full"] }, { type: "number", exclusiveMinimum: 0, maximum: 1 }], description: '"auto", "full", or a fraction above 0 up to 1 (0.5 is half size).' } },
+      ["scale"]
+    ),
+    annotations: { title: "Set the preview size", ...WRITE_IDEMPOTENT },
+    handler: ({ scale }) => {
+      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', _187 => _187(a, fixed), 'optionalAccess', _188 => _188.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." } };
+    }
+  };
+  const previewCache = {
+    name: "get_video_preview_cache",
+    title: "Read the preview's frame cache",
+    description: `Reports the preview's cache of decoded frames, without changing anything: whether the host has one, how many frames and bytes it holds against its budget, hits and misses, frames still decoding, how far ahead it prefetches (ms), and the stretches of the timeline between "from" and "to" whose frames are all cached (these play and scrub without waiting). Use it to tell whether stuttering is the cache filling, and before asking the person to review a passage. With no cache, says so.`,
+    inputSchema: object({ from: MS("Start of the stretch to report cached ranges for (default 0)"), to: MS("End of it (default: the end of the project)") }),
+    annotations: { title: "Read the preview's frame cache", ...READ },
+    handler: ({ from, to }) => {
+      const cache = controller.frameCache;
+      if (!cache) return { enabled: false, reason: "The host has not given this editor a frame cache (VideoEditorController frameCache), so the preview decodes each frame as it plays." };
+      if (from !== void 0 && to !== void 0 && !(to > from)) throw new Error(`"to" (${to} ms) must be after "from" (${from} ms).`);
+      const ranges = cache.cachedRanges(project(), { from, to });
+      return { enabled: true, ...cache.stats(), cachedRanges: ranges };
     }
   };
   const TRANSCRIPT_TRACK = { ...TRACK_ID, description: "Track whose words to read (default: the first audio track with a transcribed clip, else the first video track with one)." };
@@ -4883,7 +5355,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', _157 => _157[0], 'optionalAccess', _158 => _158.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', _189 => _189[0], 'optionalAccess', _190 => _190.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 = {
@@ -4945,7 +5417,7 @@ function createVideoEditorToolProvider(controller, options = {}) {
     if (!at) throw new Error(`There is no clip "${id}"; get_video_project lists the clips.`);
     const { clip } = at;
     if (clip.type !== "media") throw new Error(`Clip "${id}" is a ${clip.type === "text" ? "title" : "colour"}, so it has no source to change the speed of; use a video or audio clip.`);
-    if (_optionalChain([project, 'call', _159 => _159(), 'access', _160 => _160.assets, 'access', _161 => _161.find, 'call', _162 => _162((a) => a.id === clip.asset), 'optionalAccess', _163 => _163.kind]) === "image") throw new Error(`Clip "${id}" is a still, so it has no motion to change the speed of.`);
+    if (_optionalChain([project, 'call', _191 => _191(), 'access', _192 => _192.assets, 'access', _193 => _193.find, 'call', _194 => _194((a) => a.id === clip.asset), 'optionalAccess', _195 => _195.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) => {
@@ -5273,8 +5745,8 @@ function createVideoEditorToolProvider(controller, options = {}) {
       return { time: t, timecode: formatVideoTimecode(t, p.fps), width: pixels.width, height: pixels.height, ...summarizeVideoScopes(pixels, { bins, columns }) };
     }
   };
-  const reads = [getProject, getFrame, getTranscript, findText, findFillers, findPauses, findGaps, checkProject, renderFrame, getScopes, exportFfmpeg, exportLoudnessMeasure, exportEdl, audioLevels, findSilences, seek];
-  const writes = [setSettings, addAsset, updateAsset, removeAsset, 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];
+  const reads = [getProject, 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 {
     id: _nullishCoalesce(options.id, () => ( "video")),
     namespace: options.namespace,
@@ -5494,5 +5966,25 @@ function createVideoEditorToolProvider(controller, options = {}) {
 
 
 
-exports.VIDEO_BLEND_MODES = VIDEO_BLEND_MODES; exports.VIDEO_BLEND_MODE_LABELS = VIDEO_BLEND_MODE_LABELS; exports.VIDEO_CLIP_ANIMATION_DURATION = VIDEO_CLIP_ANIMATION_DURATION; exports.VIDEO_CLIP_ANIMATION_EFFECTS = VIDEO_CLIP_ANIMATION_EFFECTS; exports.VIDEO_CLIP_ANIMATION_LABELS = VIDEO_CLIP_ANIMATION_LABELS; exports.VIDEO_CLIP_TYPES = 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 = VIDEO_EASE_NAMES; exports.VIDEO_EDIT_OPS = VIDEO_EDIT_OPS; exports.VIDEO_FADE_CURVES = VIDEO_FADE_CURVES; exports.VIDEO_FADE_CURVE_LABELS = VIDEO_FADE_CURVE_LABELS; exports.VIDEO_FITS = VIDEO_FITS; exports.VIDEO_GRADE_CONTROLS = VIDEO_GRADE_CONTROLS; exports.VIDEO_GRADE_PRESETS = VIDEO_GRADE_PRESETS; exports.VIDEO_GRADE_PRESET_NAMES = VIDEO_GRADE_PRESET_NAMES; exports.VIDEO_ISSUE_CODES = VIDEO_ISSUE_CODES; exports.VIDEO_KEYFRAME_LIMITS = VIDEO_KEYFRAME_LIMITS; exports.VIDEO_KEYFRAME_PROPERTIES = VIDEO_KEYFRAME_PROPERTIES; exports.VIDEO_LUT_MAX_SIZE = VIDEO_LUT_MAX_SIZE; exports.VIDEO_PEAK_BLOCK = VIDEO_PEAK_BLOCK; exports.VIDEO_PLACEMENT_MODES = VIDEO_PLACEMENT_MODES; exports.VIDEO_SCOPE_KINDS = VIDEO_SCOPE_KINDS; exports.VIDEO_TIME_EPSILON = VIDEO_TIME_EPSILON; exports.VIDEO_TRANSFORM_PROPERTIES = VIDEO_TRANSFORM_PROPERTIES; exports.VIDEO_TRANSITION_LABELS = VIDEO_TRANSITION_LABELS; exports.VIDEO_TRANSITION_TYPES = VIDEO_TRANSITION_TYPES; exports.VIDEO_VECTORSCOPE_TARGETS = VIDEO_VECTORSCOPE_TARGETS; exports.VIDEO_WIPE_DIRECTIONS = VIDEO_WIPE_DIRECTIONS; exports.VideoAudioPeaksCache = VideoAudioPeaksCache; exports.VideoEditorController = VideoEditorController; exports.VideoLutCache = VideoLutCache; exports.VideoPreviewEngine = VideoPreviewEngine; exports.VideoPreviewPixels = VideoPreviewPixels; exports.allVideoClipIds = allVideoClipIds; exports.applyVideoEdits = applyVideoEdits; exports.applyVideoGrade = applyVideoGrade; exports.applyVideoLut = applyVideoLut; exports.applyVideoLutToPixels = applyVideoLutToPixels; exports.buildVideoAudioPeaks = buildVideoAudioPeaks; exports.checkVideoProject = checkVideoProject; exports.checkVideoTimeRemap = checkVideoTimeRemap; exports.createVideoEditorToolProvider = createVideoEditorToolProvider; exports.createVideoProject = createVideoProject; exports.decodeVideoAudioPeaks = decodeVideoAudioPeaks; exports.describeVideoProject = describeVideoProject; exports.drawVideoFrame = drawVideoFrame; exports.ffmpegFilterValue = ffmpegFilterValue; exports.findVideoAudioSilences = findVideoAudioSilences; exports.findVideoClip = findVideoClip; exports.findVideoFillers = findVideoFillers; exports.findVideoGaps = findVideoGaps; exports.findVideoTranscriptPauses = findVideoTranscriptPauses; exports.findVideoTranscriptText = findVideoTranscriptText; exports.formatVideoSeconds = formatVideoSeconds; exports.formatVideoTimecode = formatVideoTimecode; exports.formatVideoTimecodeFrames = formatVideoTimecodeFrames; exports.isVideoDropFrameRate = isVideoDropFrameRate; exports.isVideoKeyframes = isVideoKeyframes; exports.mergeVideoRanges = mergeVideoRanges; exports.nextFreeVideoSlot = nextFreeVideoSlot; exports.normalizeVideoGrade = normalizeVideoGrade; exports.normalizeVideoGradeLut = normalizeVideoGradeLut; exports.normalizeVideoWord = normalizeVideoWord; exports.parseVideoAnimatable = parseVideoAnimatable; exports.parseVideoAsset = parseVideoAsset; exports.parseVideoClip = parseVideoClip; exports.parseVideoClipAnimation = parseVideoClipAnimation; exports.parseVideoCubeLut = parseVideoCubeLut; exports.parseVideoGrade = parseVideoGrade; exports.parseVideoGradeLut = parseVideoGradeLut; exports.parseVideoKeyframes = parseVideoKeyframes; exports.parseVideoLoudnessMeasurement = parseVideoLoudnessMeasurement; exports.parseVideoMarker = parseVideoMarker; exports.parseVideoProject = parseVideoProject; exports.parseVideoTimeRemap = parseVideoTimeRemap; exports.parseVideoTrack = parseVideoTrack; exports.parseVideoTranscript = parseVideoTranscript; exports.parseVideoTranscriptWords = parseVideoTranscriptWords; exports.parseVideoTransform = parseVideoTransform; exports.parseVideoTransition = parseVideoTransition; exports.placeVideoRect = placeVideoRect; exports.planVideoClipDrag = planVideoClipDrag; exports.probeVideoMedia = probeVideoMedia; exports.readVideoScopesPanel = readVideoScopesPanel; exports.removeVideoKey = removeVideoKey; exports.retimeVideoAnimatable = retimeVideoAnimatable; exports.setVideoKey = setVideoKey; exports.snapToVideoFrame = snapToVideoFrame; exports.snapVideoTime = snapVideoTime; exports.sortVideoKeys = sortVideoKeys; exports.sortedVideoClips = sortedVideoClips; exports.splitVideoAnimatable = splitVideoAnimatable; exports.summarizeVideoScopes = summarizeVideoScopes; exports.toVideoEdl = toVideoEdl; exports.toVideoFfmpeg = toVideoFfmpeg; exports.toVideoLoudnessMeasure = toVideoLoudnessMeasure; exports.videoAssetDropEdit = videoAssetDropEdit; exports.videoAssetHasSound = videoAssetHasSound; exports.videoAssetKindOf = videoAssetKindOf; exports.videoAssetMap = videoAssetMap; exports.videoAudioLevels = videoAudioLevels; exports.videoAudioPeakRange = videoAudioPeakRange; exports.videoAudioPeakSpans = videoAudioPeakSpans; exports.videoAudioPeaksDuration = videoAudioPeaksDuration; exports.videoChroma = videoChroma; exports.videoClipAfter = videoClipAfter; exports.videoClipAnimated = videoClipAnimated; exports.videoClipAnimationProperties = videoClipAnimationProperties; exports.videoClipAnimationSpans = videoClipAnimationSpans; exports.videoClipBefore = videoClipBefore; exports.videoClipEnd = videoClipEnd; exports.videoClipHandles = videoClipHandles; exports.videoClipKeyframes = videoClipKeyframes; exports.videoClipLabel = videoClipLabel; exports.videoClipOverhang = videoClipOverhang; exports.videoClipShowsWaveform = videoClipShowsWaveform; exports.videoClipSoundGain = videoClipSoundGain; exports.videoClipSourceRange = videoClipSourceRange; exports.videoClipSourceTime = videoClipSourceTime; exports.videoClipSpeed = videoClipSpeed; exports.videoClipSpeedAt = videoClipSpeedAt; exports.videoClipTint = videoClipTint; exports.videoClipWaveform = videoClipWaveform; exports.videoClipWaveformPath = videoClipWaveformPath; exports.videoClipsAt = videoClipsAt; exports.videoContactSheetSvg = videoContactSheetSvg; exports.videoDragLabel = videoDragLabel; exports.videoDropTracks = videoDropTracks; exports.videoEaseBezier = videoEaseBezier; exports.videoEaseProgress = videoEaseProgress; exports.videoExposureNotes = videoExposureNotes; exports.videoExposureStats = videoExposureStats; exports.videoFadeCurveGain = videoFadeCurveGain; exports.videoFrameAt = videoFrameAt; exports.videoFrameDuration = videoFrameDuration; exports.videoFrameToSvg = videoFrameToSvg; exports.videoFrames = videoFrames; exports.videoFreezeFrameEdit = videoFreezeFrameEdit; exports.videoGradeCssFilter = videoGradeCssFilter; exports.videoGradeFfmpegFilters = videoGradeFfmpegFilters; exports.videoGradeGainsFilterId = videoGradeGainsFilterId; exports.videoGradeLook = videoGradeLook; exports.videoGradePreset = videoGradePreset; exports.videoGradeStepMatrix = videoGradeStepMatrix; exports.videoGradeStepSvgValues = videoGradeStepSvgValues; exports.videoGradeSteps = videoGradeSteps; exports.videoGradeSvgDefs = videoGradeSvgDefs; exports.videoGradeSvgFilter = videoGradeSvgFilter; exports.videoHistogram = videoHistogram; exports.videoHistogramImage = videoHistogramImage; exports.videoHourFrames = videoHourFrames; exports.videoIrisRadius = videoIrisRadius; exports.videoIssueKey = videoIssueKey; exports.videoKeyframeBreakpoints = videoKeyframeBreakpoints; exports.videoKeyframeFfmpegExpr = videoKeyframeFfmpegExpr; exports.videoKeyframeRows = videoKeyframeRows; exports.videoKeyframeToggleEdit = videoKeyframeToggleEdit; exports.videoKeyframeValueEdit = videoKeyframeValueEdit; exports.videoKeysOf = videoKeysOf; exports.videoLuma = videoLuma; exports.videoLumaWaveform = videoLumaWaveform; exports.videoLutEdits = videoLutEdits; exports.videoLutFromFunction = videoLutFromFunction; exports.videoLutSvgApproximation = videoLutSvgApproximation; exports.videoLutSvgPrimitives = videoLutSvgPrimitives; exports.videoLutToCube = videoLutToCube; exports.videoOverlap = videoOverlap; exports.videoPeakDb = videoPeakDb; exports.videoProjectDuration = videoProjectDuration; exports.videoProjectSvg = videoProjectSvg; exports.videoRemoveRangesEdits = videoRemoveRangesEdits; exports.videoRulerTicks = videoRulerTicks; exports.videoScopeImage = videoScopeImage; exports.videoSlowMotionRamp = videoSlowMotionRamp; exports.videoSnapPoints = videoSnapPoints; exports.videoSpeedRampEdit = videoSpeedRampEdit; exports.videoSpeedRampKeys = videoSpeedRampKeys; exports.videoTextStyle = videoTextStyle; exports.videoTimeRemapBreakpoints = videoTimeRemapBreakpoints; exports.videoTimeRemapSpan = videoTimeRemapSpan; exports.videoTimecodeFrames = videoTimecodeFrames; exports.videoTimelineTranscript = videoTimelineTranscript; exports.videoTitleFrame = videoTitleFrame; exports.videoTrackSyncLocked = videoTrackSyncLocked; exports.videoTranscriptEdit = videoTranscriptEdit; exports.videoTranscriptTrack = videoTranscriptTrack; exports.videoTransformAt = videoTransformAt; exports.videoTransitionAudioCurve = videoTransitionAudioCurve; exports.videoTransitionEase = videoTransitionEase; exports.videoTransitionHasDirection = videoTransitionHasDirection; exports.videoValueAt = videoValueAt; exports.videoVectorscope = videoVectorscope; exports.videoVectorscopeAngle = videoVectorscopeAngle; exports.videoVectorscopeImage = videoVectorscopeImage; exports.videoVectorscopePoint = videoVectorscopePoint; exports.videoWaveformImage = videoWaveformImage; exports.videoWaveformPath = videoWaveformPath; exports.videoWipeRect = videoWipeRect; exports.videoWordAt = videoWordAt; exports.videoWordsRange = videoWordsRange;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.VIDEO_BLEND_MODES = VIDEO_BLEND_MODES; exports.VIDEO_BLEND_MODE_LABELS = VIDEO_BLEND_MODE_LABELS; exports.VIDEO_CLIP_ANIMATION_DURATION = VIDEO_CLIP_ANIMATION_DURATION; exports.VIDEO_CLIP_ANIMATION_EFFECTS = VIDEO_CLIP_ANIMATION_EFFECTS; exports.VIDEO_CLIP_ANIMATION_LABELS = VIDEO_CLIP_ANIMATION_LABELS; exports.VIDEO_CLIP_TYPES = 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 = VIDEO_EASE_NAMES; exports.VIDEO_EDIT_OPS = VIDEO_EDIT_OPS; exports.VIDEO_FADE_CURVES = VIDEO_FADE_CURVES; exports.VIDEO_FADE_CURVE_LABELS = VIDEO_FADE_CURVE_LABELS; exports.VIDEO_FITS = VIDEO_FITS; exports.VIDEO_GRADE_CONTROLS = VIDEO_GRADE_CONTROLS; exports.VIDEO_GRADE_PRESETS = VIDEO_GRADE_PRESETS; exports.VIDEO_GRADE_PRESET_NAMES = VIDEO_GRADE_PRESET_NAMES; exports.VIDEO_ISSUE_CODES = VIDEO_ISSUE_CODES; exports.VIDEO_KEYFRAME_LIMITS = VIDEO_KEYFRAME_LIMITS; exports.VIDEO_KEYFRAME_PROPERTIES = VIDEO_KEYFRAME_PROPERTIES; exports.VIDEO_LUT_MAX_SIZE = VIDEO_LUT_MAX_SIZE; exports.VIDEO_PEAK_BLOCK = VIDEO_PEAK_BLOCK; exports.VIDEO_PLACEMENT_MODES = 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 = VIDEO_TIME_EPSILON; exports.VIDEO_TRANSFORM_PROPERTIES = VIDEO_TRANSFORM_PROPERTIES; exports.VIDEO_TRANSITION_LABELS = VIDEO_TRANSITION_LABELS; exports.VIDEO_TRANSITION_TYPES = VIDEO_TRANSITION_TYPES; exports.VIDEO_VECTORSCOPE_TARGETS = VIDEO_VECTORSCOPE_TARGETS; exports.VIDEO_WIPE_DIRECTIONS = VIDEO_WIPE_DIRECTIONS; exports.VideoAudioPeaksCache = VideoAudioPeaksCache; exports.VideoEditorController = VideoEditorController; exports.VideoFrameCache = VideoFrameCache; exports.VideoLutCache = VideoLutCache; exports.VideoPreviewEngine = VideoPreviewEngine; exports.VideoPreviewPixels = VideoPreviewPixels; exports.allVideoClipIds = allVideoClipIds; exports.applyVideoEdits = applyVideoEdits; exports.applyVideoGrade = applyVideoGrade; exports.applyVideoLut = applyVideoLut; exports.applyVideoLutToPixels = applyVideoLutToPixels; exports.buildVideoAudioPeaks = buildVideoAudioPeaks; exports.checkVideoProject = checkVideoProject; exports.checkVideoTimeRemap = checkVideoTimeRemap; exports.createVideoEditorToolProvider = createVideoEditorToolProvider; exports.createVideoElementDecoder = createVideoElementDecoder; exports.createVideoProject = createVideoProject; exports.decodeVideoAudioPeaks = decodeVideoAudioPeaks; exports.describeVideoProject = describeVideoProject; exports.drawVideoFrame = drawVideoFrame; exports.ffmpegFilterValue = ffmpegFilterValue; exports.findVideoAudioSilences = findVideoAudioSilences; exports.findVideoClip = findVideoClip; exports.findVideoFillers = findVideoFillers; exports.findVideoGaps = findVideoGaps; exports.findVideoTranscriptPauses = findVideoTranscriptPauses; exports.findVideoTranscriptText = findVideoTranscriptText; exports.formatVideoSeconds = formatVideoSeconds; exports.formatVideoTimecode = formatVideoTimecode; exports.formatVideoTimecodeFrames = formatVideoTimecodeFrames; exports.isVideoDropFrameRate = isVideoDropFrameRate; exports.isVideoKeyframes = isVideoKeyframes; exports.mergeVideoRanges = mergeVideoRanges; exports.nextFreeVideoSlot = nextFreeVideoSlot; exports.normalizeVideoGrade = normalizeVideoGrade; exports.normalizeVideoGradeLut = normalizeVideoGradeLut; exports.normalizeVideoWord = normalizeVideoWord; exports.parseVideoAnimatable = parseVideoAnimatable; exports.parseVideoAsset = parseVideoAsset; exports.parseVideoAssetProxies = parseVideoAssetProxies; exports.parseVideoClip = parseVideoClip; exports.parseVideoClipAnimation = parseVideoClipAnimation; exports.parseVideoCubeLut = parseVideoCubeLut; exports.parseVideoGrade = parseVideoGrade; exports.parseVideoGradeLut = parseVideoGradeLut; exports.parseVideoKeyframes = parseVideoKeyframes; exports.parseVideoLoudnessMeasurement = parseVideoLoudnessMeasurement; exports.parseVideoMarker = parseVideoMarker; exports.parseVideoPreviewScale = parseVideoPreviewScale; exports.parseVideoProject = parseVideoProject; exports.parseVideoTimeRemap = parseVideoTimeRemap; exports.parseVideoTrack = parseVideoTrack; exports.parseVideoTranscript = parseVideoTranscript; exports.parseVideoTranscriptWords = parseVideoTranscriptWords; exports.parseVideoTransform = parseVideoTransform; exports.parseVideoTransition = parseVideoTransition; exports.placeVideoRect = placeVideoRect; exports.planVideoClipDrag = planVideoClipDrag; exports.planVideoPrefetch = planVideoPrefetch; exports.probeVideoMedia = probeVideoMedia; exports.readVideoScopesPanel = readVideoScopesPanel; exports.removeVideoKey = removeVideoKey; exports.resolveVideoPreviewScale = resolveVideoPreviewScale; exports.retimeVideoAnimatable = retimeVideoAnimatable; exports.setVideoKey = setVideoKey; exports.snapToVideoFrame = snapToVideoFrame; exports.snapVideoTime = snapVideoTime; exports.sortVideoKeys = sortVideoKeys; exports.sortedVideoClips = sortedVideoClips; exports.splitVideoAnimatable = splitVideoAnimatable; exports.summarizeVideoScopes = summarizeVideoScopes; exports.toVideoEdl = toVideoEdl; exports.toVideoFfmpeg = toVideoFfmpeg; exports.toVideoLoudnessMeasure = toVideoLoudnessMeasure; exports.videoAssetDropEdit = videoAssetDropEdit; exports.videoAssetHasSound = videoAssetHasSound; exports.videoAssetKindOf = videoAssetKindOf; exports.videoAssetMap = videoAssetMap; exports.videoAssetProxy = videoAssetProxy; exports.videoAudioLevels = videoAudioLevels; exports.videoAudioPeakRange = videoAudioPeakRange; exports.videoAudioPeakSpans = videoAudioPeakSpans; exports.videoAudioPeaksDuration = videoAudioPeaksDuration; exports.videoCacheEvictions = videoCacheEvictions; exports.videoChroma = videoChroma; exports.videoClipAfter = videoClipAfter; exports.videoClipAnimated = videoClipAnimated; exports.videoClipAnimationProperties = videoClipAnimationProperties; exports.videoClipAnimationSpans = videoClipAnimationSpans; exports.videoClipBefore = videoClipBefore; exports.videoClipEnd = videoClipEnd; exports.videoClipHandles = videoClipHandles; exports.videoClipKeyframes = videoClipKeyframes; exports.videoClipLabel = videoClipLabel; exports.videoClipOverhang = videoClipOverhang; exports.videoClipShowsWaveform = videoClipShowsWaveform; exports.videoClipSoundGain = videoClipSoundGain; exports.videoClipSourceRange = videoClipSourceRange; exports.videoClipSourceTime = videoClipSourceTime; exports.videoClipSpeed = videoClipSpeed; exports.videoClipSpeedAt = videoClipSpeedAt; exports.videoClipTint = videoClipTint; exports.videoClipWaveform = videoClipWaveform; exports.videoClipWaveformPath = videoClipWaveformPath; exports.videoClipsAt = videoClipsAt; exports.videoContactSheetSvg = videoContactSheetSvg; exports.videoDragLabel = videoDragLabel; exports.videoDropTracks = videoDropTracks; exports.videoEaseBezier = videoEaseBezier; exports.videoEaseProgress = videoEaseProgress; exports.videoExposureNotes = videoExposureNotes; exports.videoExposureStats = videoExposureStats; exports.videoFadeCurveGain = videoFadeCurveGain; exports.videoFrameAt = videoFrameAt; exports.videoFrameCacheKey = videoFrameCacheKey; exports.videoFrameDuration = videoFrameDuration; exports.videoFrameRequestsAt = videoFrameRequestsAt; exports.videoFrameToSvg = videoFrameToSvg; exports.videoFrames = videoFrames; exports.videoFreezeFrameEdit = videoFreezeFrameEdit; exports.videoGradeCssFilter = videoGradeCssFilter; exports.videoGradeFfmpegFilters = videoGradeFfmpegFilters; exports.videoGradeGainsFilterId = videoGradeGainsFilterId; exports.videoGradeLook = videoGradeLook; exports.videoGradePreset = videoGradePreset; exports.videoGradeStepMatrix = videoGradeStepMatrix; exports.videoGradeStepSvgValues = videoGradeStepSvgValues; exports.videoGradeSteps = videoGradeSteps; exports.videoGradeSvgDefs = videoGradeSvgDefs; exports.videoGradeSvgFilter = videoGradeSvgFilter; exports.videoHistogram = videoHistogram; exports.videoHistogramImage = videoHistogramImage; exports.videoHourFrames = videoHourFrames; exports.videoIrisRadius = videoIrisRadius; exports.videoIssueKey = videoIssueKey; exports.videoKeyframeBreakpoints = videoKeyframeBreakpoints; exports.videoKeyframeFfmpegExpr = videoKeyframeFfmpegExpr; exports.videoKeyframeRows = videoKeyframeRows; exports.videoKeyframeToggleEdit = videoKeyframeToggleEdit; exports.videoKeyframeValueEdit = videoKeyframeValueEdit; exports.videoKeysOf = videoKeysOf; exports.videoLuma = videoLuma; exports.videoLumaWaveform = videoLumaWaveform; exports.videoLutEdits = videoLutEdits; exports.videoLutFromFunction = videoLutFromFunction; exports.videoLutSvgApproximation = videoLutSvgApproximation; exports.videoLutSvgPrimitives = videoLutSvgPrimitives; exports.videoLutToCube = videoLutToCube; exports.videoOverlap = videoOverlap; exports.videoPeakDb = videoPeakDb; exports.videoPreviewSrc = videoPreviewSrc; exports.videoProjectDuration = videoProjectDuration; exports.videoProjectHasProxies = videoProjectHasProxies; exports.videoProjectSvg = videoProjectSvg; exports.videoProxyFfmpeg = videoProxyFfmpeg; exports.videoProxyName = videoProxyName; exports.videoProxyPlan = videoProxyPlan; exports.videoRemoveRangesEdits = videoRemoveRangesEdits; exports.videoRulerTicks = videoRulerTicks; exports.videoScopeImage = videoScopeImage; exports.videoShellQuote = videoShellQuote; exports.videoSlowMotionRamp = videoSlowMotionRamp; exports.videoSnapPoints = videoSnapPoints; exports.videoSourceFrame = videoSourceFrame; exports.videoSourceFrameTime = videoSourceFrameTime; exports.videoSpeedRampEdit = videoSpeedRampEdit; exports.videoSpeedRampKeys = videoSpeedRampKeys; exports.videoTextStyle = videoTextStyle; exports.videoTimeRemapBreakpoints = videoTimeRemapBreakpoints; exports.videoTimeRemapSpan = videoTimeRemapSpan; exports.videoTimecodeFrames = videoTimecodeFrames; exports.videoTimelineTranscript = videoTimelineTranscript; exports.videoTitleFrame = videoTitleFrame; exports.videoTrackSyncLocked = videoTrackSyncLocked; exports.videoTranscriptEdit = videoTranscriptEdit; exports.videoTranscriptTrack = videoTranscriptTrack; exports.videoTransformAt = videoTransformAt; exports.videoTransitionAudioCurve = videoTransitionAudioCurve; exports.videoTransitionEase = videoTransitionEase; exports.videoTransitionHasDirection = videoTransitionHasDirection; exports.videoValueAt = videoValueAt; exports.videoVectorscope = videoVectorscope; exports.videoVectorscopeAngle = videoVectorscopeAngle; exports.videoVectorscopeImage = videoVectorscopeImage; exports.videoVectorscopePoint = videoVectorscopePoint; exports.videoWaveformImage = videoWaveformImage; exports.videoWaveformPath = videoWaveformPath; exports.videoWipeRect = videoWipeRect; exports.videoWordAt = videoWordAt; exports.videoWordsRange = videoWordsRange;
 //# sourceMappingURL=index.cjs.map