@pixerate/editor 0.160.0 → 0.162.0

package/dist/effects/index.js

@@ -1,3 +1,9 @@
+import {
+  SYSTEM_FONT_CATALOG
+} from "../chunk-CJE5MOIS.js";
+import {
+  createEffectAuthoringSession
+} from "../chunk-ZGOHKS3X.js";
 import {
   EffectRendererPool
 } from "../chunk-EHLOCVWB.js";
@@ -25,13 +31,9 @@ import {
   srgbToLinear
 } from "../chunk-7KWJEYIK.js";
 import "../chunk-V2ZCJRDM.js";
+import "../chunk-RNSANXPT.js";
 import {
-  HistoryManager
-} from "../chunk-RNSANXPT.js";
-import {
-  ANIMATION_EASING_PRESETS,
-  evaluateEasing,
-  isAnimationEasing
+  ANIMATION_EASING_PRESETS
 } from "../chunk-5UJHB3BW.js";
 
 // src/effects/conformance.ts
@@ -213,756 +215,6 @@ async function checkEffectProvider(provider, options = {}) {
   return issues;
 }
 
-// src/effects/authoring-session.ts
-var HEX_RE = /^#([0-9a-f]{6}|[0-9a-f]{8})$/i;
-function valueErrorMessage(errors) {
-  return errors.map((e) => {
-    const [control, ...rest] = e.path.replace(/^\//, "").split("/");
-    return `control "${control}"${rest.length ? ` (item ${rest.join("/")})` : ""}: ${e.message}`;
-  }).join("; ");
-}
-function documentErrors(doc, description) {
-  const errors = [];
-  const controls = Object.keys(description.controls.properties);
-  const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-  if (doc.values !== void 0) {
-    if (!isRecord(doc.values)) errors.push({ path: "/values", message: "must be an object of control values" });
-    else errors.push(...effectValueErrors(description, doc.values).map((e) => ({ ...e, path: `/values${e.path}` })));
-  }
-  if (doc.tracks !== void 0) {
-    if (!isRecord(doc.tracks)) errors.push({ path: "/tracks", message: "must be an object of keyframe lists" });
-    else
-      for (const [control, kfs] of Object.entries(doc.tracks)) {
-        const at = `/tracks/${control}`;
-        if (!controls.includes(control)) errors.push({ path: at, message: `there is no control "${control}"; the controls are ${controls.join(", ")}` });
-        else if (!Array.isArray(kfs)) errors.push({ path: at, message: "must be a list of keyframes" });
-        else
-          kfs.forEach((kf, i) => {
-            if (!isRecord(kf)) return errors.push({ path: `${at}/${i}`, message: "must be a keyframe object" });
-            if (typeof kf.time !== "number" || !Number.isFinite(kf.time) || kf.time < 0) errors.push({ path: `${at}/${i}/time`, message: "must be a finite number of ms >= 0" });
-            errors.push(...effectValueErrors(description, { [control]: kf.value }).map((e) => ({ ...e, path: `${at}/${i}/value` })));
-            if (kf.easing !== void 0 && !isAnimationEasing(kf.easing)) errors.push({ path: `${at}/${i}/easing`, message: "is not a valid easing" });
-          });
-      }
-  }
-  if (doc.presets !== void 0) {
-    if (!Array.isArray(doc.presets)) errors.push({ path: "/presets", message: "must be a list of presets" });
-    else
-      doc.presets.forEach((p, i) => {
-        if (!isRecord(p) || typeof p.name !== "string" || !p.name) return errors.push({ path: `/presets/${i}`, message: "must have a name" });
-        errors.push(...effectValueErrors(description, p.values).map((e) => ({ ...e, path: `/presets/${i}/values${e.path}` })));
-      });
-  }
-  if (doc.duration !== void 0 && (typeof doc.duration !== "number" || !Number.isFinite(doc.duration) || !(doc.duration > 0))) {
-    errors.push({ path: "/duration", message: "must be a finite number of ms > 0" });
-  }
-  if (doc.loop !== void 0 && typeof doc.loop !== "boolean") errors.push({ path: "/loop", message: "must be a boolean" });
-  return errors;
-}
-function parseHex(hex) {
-  if (!HEX_RE.test(hex)) return null;
-  const body = hex.slice(1);
-  const r = parseInt(body.slice(0, 2), 16);
-  const g = parseInt(body.slice(2, 4), 16);
-  const b = parseInt(body.slice(4, 6), 16);
-  const hasAlpha = body.length === 8;
-  const a = hasAlpha ? parseInt(body.slice(6, 8), 16) : 255;
-  return { r, g, b, a, hasAlpha };
-}
-function toHex2(n) {
-  const clamped = Math.round(Math.max(0, Math.min(255, n)));
-  return clamped.toString(16).padStart(2, "0");
-}
-function lerpHex(c1, c2, t) {
-  const p1 = parseHex(c1);
-  const p2 = parseHex(c2);
-  if (!p1 || !p2) return t >= 1 ? c2 : c1;
-  const r = p1.r + (p2.r - p1.r) * t;
-  const g = p1.g + (p2.g - p1.g) * t;
-  const b = p1.b + (p2.b - p1.b) * t;
-  const a = p1.a + (p2.a - p1.a) * t;
-  const withAlpha = p1.hasAlpha || p2.hasAlpha;
-  return `#${toHex2(r)}${toHex2(g)}${toHex2(b)}${withAlpha ? toHex2(a) : ""}`;
-}
-function interpolateValue(v1, v2, progress) {
-  if (typeof v1 === "number" && typeof v2 === "number") {
-    return v1 + (v2 - v1) * progress;
-  }
-  if (Array.isArray(v1) && Array.isArray(v2) && v1.length === v2.length) {
-    return v1.map((num, i) => {
-      const other = v2[i];
-      return typeof num === "number" && typeof other === "number" ? num + (other - num) * progress : num;
-    });
-  }
-  if (typeof v1 === "string" && typeof v2 === "string" && v1.startsWith("#") && v2.startsWith("#")) {
-    return lerpHex(v1, v2, progress);
-  }
-  return progress >= 1 ? v2 : v1;
-}
-function valuesAtTime(time, baseValues, tracks) {
-  const result = { ...baseValues };
-  for (const [control, kfs] of Object.entries(tracks)) {
-    if (!kfs || kfs.length === 0) continue;
-    if (kfs.length === 1) {
-      result[control] = kfs[0].value;
-      continue;
-    }
-    if (time <= kfs[0].time) {
-      result[control] = kfs[0].value;
-      continue;
-    }
-    const last = kfs[kfs.length - 1];
-    if (time >= last.time) {
-      result[control] = last.value;
-      continue;
-    }
-    let idx = 0;
-    while (idx < kfs.length - 1 && kfs[idx + 1].time <= time) {
-      idx++;
-    }
-    const kf1 = kfs[idx];
-    const kf2 = kfs[idx + 1];
-    const span = kf2.time - kf1.time;
-    const rawProgress = span > 0 ? (time - kf1.time) / span : 0;
-    const easing = kf1.easing ?? "linear";
-    const eased = evaluateEasing(easing, rawProgress);
-    result[control] = interpolateValue(kf1.value, kf2.value, eased);
-  }
-  return result;
-}
-var defaultSchedule = (frame) => {
-  if (typeof requestAnimationFrame === "function") {
-    let handle2;
-    let running2 = true;
-    const tick2 = (now) => {
-      if (!running2) return;
-      frame(now);
-      if (running2) handle2 = requestAnimationFrame(tick2);
-    };
-    handle2 = requestAnimationFrame(tick2);
-    return () => {
-      running2 = false;
-      cancelAnimationFrame(handle2);
-    };
-  }
-  let handle;
-  let running = true;
-  const interval = 16;
-  const tick = () => {
-    if (!running) return;
-    frame(Date.now());
-    if (running) handle = setTimeout(tick, interval);
-  };
-  handle = setTimeout(tick, interval);
-  return () => {
-    running = false;
-    clearTimeout(handle);
-  };
-};
-function isDocumentSource(source) {
-  return "document" in source && typeof source.document === "object" && source.document !== null;
-}
-async function createEffectAuthoringSession(source, options) {
-  const { provider, history = new HistoryManager(), mergeWindowMs = 400 } = options;
-  const scheduleFn = options.schedule ?? defaultSchedule;
-  let effectId;
-  let requestedPreset;
-  let initialDoc = null;
-  if (isDocumentSource(source)) {
-    const doc = source.document;
-    if (doc.version !== 1 || !doc.effectId) {
-      throw new EffectUnsupportedError("Invalid effect authoring document: version 1 required");
-    }
-    effectId = doc.effectId;
-    initialDoc = doc;
-  } else if ("effectId" in source && typeof source.effectId === "string") {
-    effectId = source.effectId;
-    requestedPreset = source.preset;
-  } else {
-    throw new EffectUnsupportedError("Invalid effect authoring source");
-  }
-  const description = await provider.describe(effectId);
-  if (initialDoc) {
-    const problems = documentErrors(initialDoc, description);
-    if (problems.length) throw new EffectControlError(effectId, problems);
-  }
-  if (description.kind === "motion") {
-    throw new EffectUnsupportedError("Motion effects cannot be authored as pixel effects", effectId);
-  }
-  let disposed = false;
-  let playing = false;
-  let cancelSchedule = null;
-  let lastScheduleTime = null;
-  let playheadTime = 0;
-  let duration = initialDoc?.duration ?? description.duration ?? 1e3;
-  if (!(duration > 0)) duration = 1e3;
-  let loop = initialDoc?.loop ?? description.loop ?? false;
-  let compiled = null;
-  let savedPresets = initialDoc ? [...initialDoc.presets ?? []] : [];
-  let baseValues = { ...description.defaults };
-  if (initialDoc?.values) {
-    baseValues = { ...baseValues, ...initialDoc.values };
-  } else if (requestedPreset) {
-    const found = description.presets.find((p) => p.name === requestedPreset);
-    if (!found) {
-      const validNames = description.presets.map((p) => `"${p.name}"`).join(", ");
-      throw new EffectUnsupportedError(
-        `Unknown preset "${requestedPreset}" for effect "${effectId}". Valid presets are: ${validNames || "none"}`,
-        effectId
-      );
-    }
-    baseValues = { ...baseValues, ...found.values };
-  }
-  let tracks = {};
-  if (initialDoc?.tracks) {
-    for (const [k, kfs] of Object.entries(initialDoc.tracks)) {
-      tracks[k] = [...kfs].sort((a, b) => a.time - b.time);
-    }
-  }
-  const livePreviews = /* @__PURE__ */ new Set();
-  const listeners = /* @__PURE__ */ new Set();
-  let cachedState = null;
-  function mergePresets() {
-    const result = [];
-    const seen = /* @__PURE__ */ new Set();
-    for (const p of savedPresets) {
-      result.push(p);
-      seen.add(p.name);
-    }
-    for (const p of description.presets) {
-      if (!seen.has(p.name)) {
-        result.push(p);
-        seen.add(p.name);
-      }
-    }
-    return result;
-  }
-  function currentMergedDescription() {
-    return {
-      ...description,
-      presets: mergePresets()
-    };
-  }
-  function buildState() {
-    const desc = currentMergedDescription();
-    const currentValues = valuesAtTime(playheadTime, baseValues, tracks);
-    const historyState = history.getState();
-    return {
-      providerId: provider.id,
-      effectId,
-      name: initialDoc?.name ?? description.name,
-      kind: description.kind,
-      description: desc,
-      source: null,
-      sourceLanguage: null,
-      values: currentValues,
-      tracks: { ...tracks },
-      issues: [],
-      compiled,
-      time: playheadTime,
-      duration,
-      loop,
-      playing,
-      canUndo: historyState.canUndo,
-      canRedo: historyState.canRedo
-    };
-  }
-  function getState() {
-    if (!cachedState) {
-      cachedState = buildState();
-    }
-    return cachedState;
-  }
-  function invalidateState() {
-    cachedState = null;
-    const next = getState();
-    listeners.forEach((l) => l(next));
-  }
-  function validControlNames() {
-    return Object.keys(description.controls.properties);
-  }
-  function checkDisposed() {
-    if (disposed) {
-      return { ok: false, message: "the session is closed" };
-    }
-    return null;
-  }
-  function pauseInternal() {
-    if (!playing) return;
-    playing = false;
-    if (cancelSchedule) {
-      cancelSchedule();
-      cancelSchedule = null;
-    }
-    lastScheduleTime = null;
-    invalidateState();
-  }
-  function seekInternal(t) {
-    const clamped = Math.max(0, Math.min(duration, t));
-    if (clamped !== playheadTime) {
-      playheadTime = clamped;
-      invalidateState();
-    }
-  }
-  const session = {
-    getState,
-    subscribe(listener) {
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
-    },
-    setValue(name, value, opts) {
-      const disp = checkDisposed();
-      if (disp) return disp;
-      const validNames = validControlNames();
-      if (!validNames.includes(name)) {
-        return { ok: false, message: `there is no control "${name}"; the controls are ${validNames.join(", ")}` };
-      }
-      const errors = effectValueErrors(description, { [name]: value });
-      if (errors.length > 0) {
-        return { ok: false, message: valueErrorMessage(errors) };
-      }
-      const isAnimated = (tracks[name]?.length ?? 0) > 0;
-      if (isAnimated) {
-        const oldTracks = { ...tracks };
-        const t = playheadTime;
-        const currentTrack = [...tracks[name] ?? []];
-        const existingIdx = currentTrack.findIndex((kf) => kf.time === t);
-        const prevKf = existingIdx >= 0 ? currentTrack[existingIdx] : void 0;
-        const execute2 = () => {
-          const track = [...tracks[name] ?? []];
-          const idx = track.findIndex((kf) => kf.time === t);
-          if (idx >= 0) {
-            track[idx] = { ...track[idx], value };
-          } else {
-            track.push({ time: t, value });
-            track.sort((a, b) => a.time - b.time);
-          }
-          tracks[name] = track;
-          invalidateState();
-        };
-        const undo2 = () => {
-          tracks = { ...oldTracks };
-          invalidateState();
-        };
-        const cmd2 = {
-          name: `Set ${name}`,
-          tag: name,
-          execute: execute2,
-          undo: undo2
-        };
-        if (opts?.gesture) {
-          history.executeMerged(cmd2, { key: opts.gesture });
-        } else {
-          history.executeMerged(cmd2, { windowMs: mergeWindowMs });
-        }
-        invalidateState();
-        return { ok: true };
-      }
-      const prevVal = baseValues[name];
-      const execute = () => {
-        baseValues[name] = value;
-      };
-      const undo = () => {
-        baseValues[name] = prevVal;
-      };
-      const cmd = {
-        name: `Set ${name}`,
-        tag: name,
-        execute,
-        undo
-      };
-      if (opts?.gesture) {
-        history.executeMerged(cmd, { key: opts.gesture });
-      } else {
-        history.executeMerged(cmd, { windowMs: mergeWindowMs });
-      }
-      invalidateState();
-      return { ok: true };
-    },
-    setValues(values, opts) {
-      const disp = checkDisposed();
-      if (disp) return disp;
-      const validNames = validControlNames();
-      for (const [k, v] of Object.entries(values)) {
-        if (!validNames.includes(k)) {
-          return { ok: false, message: `there is no control "${k}"; the controls are ${validNames.join(", ")}` };
-        }
-        const errors = effectValueErrors(description, { [k]: v });
-        if (errors.length > 0) {
-          return { ok: false, message: valueErrorMessage(errors) };
-        }
-      }
-      const prevBase = { ...baseValues };
-      const prevTracks = { ...tracks };
-      const t = playheadTime;
-      const execute = () => {
-        for (const [k, v] of Object.entries(values)) {
-          const isAnimated = (tracks[k]?.length ?? 0) > 0;
-          if (isAnimated) {
-            const track = [...tracks[k] ?? []];
-            const idx = track.findIndex((kf) => kf.time === t);
-            if (idx >= 0) {
-              track[idx] = { ...track[idx], value: v };
-            } else {
-              track.push({ time: t, value: v });
-              track.sort((a, b) => a.time - b.time);
-            }
-            tracks[k] = track;
-          } else {
-            baseValues[k] = v;
-          }
-        }
-      };
-      const undo = () => {
-        baseValues = { ...prevBase };
-        tracks = { ...prevTracks };
-      };
-      const cmd = {
-        name: "Set values",
-        execute,
-        undo
-      };
-      if (opts?.gesture) {
-        history.executeMerged(cmd, { key: opts.gesture });
-      } else {
-        history.execute(cmd);
-      }
-      invalidateState();
-      return { ok: true };
-    },
-    resetValues(names) {
-      const disp = checkDisposed();
-      if (disp) return disp;
-      const targets = names ? [...names] : validControlNames();
-      const prevBase = { ...baseValues };
-      const prevTracks = { ...tracks };
-      const execute = () => {
-        for (const name of targets) {
-          if (name in description.defaults) {
-            baseValues[name] = description.defaults[name];
-          }
-          delete tracks[name];
-        }
-      };
-      const undo = () => {
-        baseValues = { ...prevBase };
-        tracks = { ...prevTracks };
-      };
-      history.execute({
-        name: "Reset values",
-        execute,
-        undo
-      });
-      invalidateState();
-      return { ok: true };
-    },
-    applyPreset(name) {
-      const disp = checkDisposed();
-      if (disp) return disp;
-      const allPresets = mergePresets();
-      const preset = allPresets.find((p) => p.name === name);
-      if (!preset) {
-        const available = allPresets.map((p) => `"${p.name}"`).join(", ");
-        return { ok: false, message: `unknown preset "${name}"; available presets are: ${available || "none"}` };
-      }
-      const prevBase = { ...baseValues };
-      const prevTracks = { ...tracks };
-      const execute = () => {
-        for (const [k, v] of Object.entries(preset.values)) {
-          baseValues[k] = v;
-          delete tracks[k];
-        }
-      };
-      const undo = () => {
-        baseValues = { ...prevBase };
-        tracks = { ...prevTracks };
-      };
-      history.execute({
-        name: `Apply preset "${name}"`,
-        execute,
-        undo
-      });
-      invalidateState();
-      return { ok: true };
-    },
-    savePreset(name) {
-      const disp = checkDisposed();
-      if (disp) return disp;
-      if (!name || !name.trim()) {
-        return { ok: false, message: "preset name cannot be empty" };
-      }
-      const trimmed = name.trim();
-      const currentValues = valuesAtTime(playheadTime, baseValues, tracks);
-      const prevSaved = [...savedPresets];
-      const execute = () => {
-        const next = savedPresets.filter((p) => p.name !== trimmed);
-        next.push({ name: trimmed, values: { ...currentValues } });
-        savedPresets = next;
-      };
-      const undo = () => {
-        savedPresets = [...prevSaved];
-      };
-      history.execute({
-        name: `Save preset "${trimmed}"`,
-        execute,
-        undo
-      });
-      invalidateState();
-      return { ok: true };
-    },
-    setKeyframe(name, time, value, easing) {
-      const disp = checkDisposed();
-      if (disp) return disp;
-      const validNames = validControlNames();
-      if (!validNames.includes(name)) {
-        return { ok: false, message: `there is no control "${name}"; the controls are ${validNames.join(", ")}` };
-      }
-      if (typeof time !== "number" || !Number.isFinite(time) || time < 0) {
-        return { ok: false, message: "keyframe time must be a finite number >= 0" };
-      }
-      if (easing !== void 0 && !isAnimationEasing(easing)) {
-        return { ok: false, message: `invalid easing: ${String(easing)}` };
-      }
-      const targetValue = value !== void 0 ? value : valuesAtTime(time, baseValues, tracks)[name];
-      const errors = effectValueErrors(description, { [name]: targetValue });
-      if (errors.length > 0) {
-        return { ok: false, message: valueErrorMessage(errors) };
-      }
-      const prevTrack = tracks[name] ? [...tracks[name]] : void 0;
-      const execute = () => {
-        const track = prevTrack ? [...prevTrack] : [];
-        const idx = track.findIndex((kf2) => kf2.time === time);
-        const kf = {
-          time,
-          value: targetValue,
-          ...easing !== void 0 ? { easing } : {}
-        };
-        if (idx >= 0) {
-          track[idx] = kf;
-        } else {
-          track.push(kf);
-          track.sort((a, b) => a.time - b.time);
-        }
-        tracks[name] = track;
-      };
-      const undo = () => {
-        if (prevTrack === void 0) {
-          delete tracks[name];
-        } else {
-          tracks[name] = [...prevTrack];
-        }
-      };
-      history.execute({
-        name: `Set keyframe on ${name}`,
-        execute,
-        undo
-      });
-      invalidateState();
-      return { ok: true };
-    },
-    removeKeyframe(name, time) {
-      const disp = checkDisposed();
-      if (disp) return disp;
-      const validNames = validControlNames();
-      if (!validNames.includes(name)) {
-        return { ok: false, message: `there is no control "${name}"; the controls are ${validNames.join(", ")}` };
-      }
-      const track = tracks[name];
-      if (!track || !track.some((kf) => kf.time === time)) {
-        const times = track?.map((kf) => `${kf.time}`).join(", ");
-        return {
-          ok: false,
-          message: times ? `no keyframe at ${time} ms on control "${name}"; its keyframes are at ${times} ms` : `control "${name}" has no keyframes`
-        };
-      }
-      const prevTrack = [...track];
-      const execute = () => {
-        const next = tracks[name].filter((kf) => kf.time !== time);
-        if (next.length === 0) {
-          delete tracks[name];
-        } else {
-          tracks[name] = next;
-        }
-      };
-      const undo = () => {
-        tracks[name] = [...prevTrack];
-      };
-      history.execute({
-        name: `Remove keyframe on ${name}`,
-        execute,
-        undo
-      });
-      invalidateState();
-      return { ok: true };
-    },
-    clearTrack(name) {
-      const disp = checkDisposed();
-      if (disp) return disp;
-      const validNames = validControlNames();
-      if (!validNames.includes(name)) {
-        return { ok: false, message: `there is no control "${name}"; the controls are ${validNames.join(", ")}` };
-      }
-      const prevTrack = tracks[name] ? [...tracks[name]] : void 0;
-      if (!prevTrack || prevTrack.length === 0) {
-        const animated = Object.keys(tracks).filter((k) => tracks[k]?.length);
-        return {
-          ok: false,
-          message: `control "${name}" is not animated, so there is nothing to clear; ${animated.length ? `the animated controls are ${animated.join(", ")}` : "no control is animated"}`
-        };
-      }
-      const currentValue = valuesAtTime(playheadTime, baseValues, tracks)[name];
-      const prevBase = baseValues[name];
-      const execute = () => {
-        delete tracks[name];
-        baseValues[name] = currentValue;
-      };
-      const undo = () => {
-        tracks[name] = [...prevTrack];
-        baseValues[name] = prevBase;
-      };
-      history.execute({
-        name: `Clear animation on ${name}`,
-        execute,
-        undo
-      });
-      invalidateState();
-      return { ok: true };
-    },
-    setTiming(timing) {
-      const disp = checkDisposed();
-      if (disp) return disp;
-      if (timing.duration !== void 0 && (!(timing.duration > 0) || !Number.isFinite(timing.duration))) {
-        return { ok: false, message: "duration must be a finite number > 0" };
-      }
-      const prevDuration = duration;
-      const prevLoop = loop;
-      const prevTime = playheadTime;
-      const execute = () => {
-        if (timing.duration !== void 0) {
-          duration = timing.duration;
-          if (playheadTime > duration) playheadTime = duration;
-        }
-        if (timing.loop !== void 0) {
-          loop = timing.loop;
-        }
-      };
-      const undo = () => {
-        duration = prevDuration;
-        loop = prevLoop;
-        playheadTime = prevTime;
-      };
-      history.execute({
-        name: "Set timing",
-        execute,
-        undo
-      });
-      invalidateState();
-      return { ok: true };
-    },
-    play() {
-      if (disposed || playing) return;
-      playing = true;
-      lastScheduleTime = null;
-      cancelSchedule = scheduleFn((now) => {
-        if (!playing) return;
-        const delta = lastScheduleTime === null ? 0 : Math.max(0, now - lastScheduleTime);
-        lastScheduleTime = now;
-        let nextTime = playheadTime + delta;
-        if (nextTime >= duration) {
-          if (loop) {
-            nextTime = duration > 0 ? nextTime % duration : 0;
-          } else {
-            nextTime = duration;
-            pauseInternal();
-          }
-        }
-        seekInternal(nextTime);
-      });
-      invalidateState();
-    },
-    pause() {
-      pauseInternal();
-    },
-    seek(time) {
-      if (disposed) return;
-      seekInternal(time);
-    },
-    undo() {
-      if (disposed) return false;
-      const changed = history.undo();
-      if (changed) invalidateState();
-      return changed;
-    },
-    redo() {
-      if (disposed) return false;
-      const changed = history.redo();
-      if (changed) invalidateState();
-      return changed;
-    },
-    async createPreview(opts) {
-      if (disposed) {
-        throw new EffectDisposedError(effectId);
-      }
-      const renderer = await provider.createRenderer(effectId, opts);
-      livePreviews.add(renderer);
-      const preview = {
-        effectId: renderer.effectId,
-        width: renderer.width,
-        height: renderer.height,
-        depth: renderer.depth,
-        render: async (req) => {
-          if (disposed) throw new EffectDisposedError(effectId);
-          const effectiveValues = req.values ?? valuesAtTime(req.time, baseValues, tracks);
-          const pixels = await renderer.render({
-            ...req,
-            values: effectiveValues
-          });
-          if (compiled !== true) {
-            compiled = true;
-            invalidateState();
-          }
-          return pixels;
-        },
-        dispose: () => {
-          livePreviews.delete(renderer);
-          renderer.dispose();
-        }
-      };
-      return preview;
-    },
-    exportDocument() {
-      const currentValues = valuesAtTime(playheadTime, baseValues, tracks);
-      return {
-        version: 1,
-        providerId: provider.id,
-        effectId,
-        name: initialDoc?.name ?? description.name,
-        values: { ...currentValues },
-        tracks: JSON.parse(JSON.stringify(tracks)),
-        presets: JSON.parse(JSON.stringify(savedPresets)),
-        duration,
-        loop
-      };
-    },
-    dispose() {
-      if (disposed) return;
-      disposed = true;
-      pauseInternal();
-      listeners.clear();
-      for (const p of livePreviews) {
-        try {
-          p.dispose();
-        } catch {
-        }
-      }
-      livePreviews.clear();
-    }
-  };
-  return session;
-}
-
 // src/effects/fake.ts
 var HEX = "^#[0-9a-fA-F]{6}$";
 var colour = (description) => ({ type: "string", pattern: HEX, description });
@@ -1334,13 +586,16 @@ var EFFECT_USE_LABELS = {
 };
 var HEX2 = /^#[0-9a-f]{6}([0-9a-f]{2})?$/i;
 var typeOf = (s) => Array.isArray(s.type) ? s.type.find((t) => t !== "null") : s.type;
-function effectControlField(name, schema, fallback) {
+function isEffectFontControl(schema) {
+  return typeOf(schema) === "string" && (schema.format === "font" || schema["x-pixerate-control"] === "font");
+}
+function effectControlField(name, schema, fallback, options = {}) {
   const base = { id: name, ...schema.title ? { label: schema.title } : {}, ...schema.description ? { description: schema.description } : {} };
   const def = schema.default ?? fallback;
   const type = typeOf(schema);
   if (Array.isArray(schema.enum) && schema.enum.length) {
-    const options = schema.enum.filter((v) => typeof v === "string" || typeof v === "number");
-    return { ...base, type: "choice", options, default: typeof def === "string" || typeof def === "number" ? def : options[0], control: options.length <= 4 ? "segmented" : "select" };
+    const options2 = schema.enum.filter((v) => typeof v === "string" || typeof v === "number");
+    return { ...base, type: "choice", options: options2, default: typeof def === "string" || typeof def === "number" ? def : options2[0], control: options2.length <= 4 ? "segmented" : "select" };
   }
   if (type === "number" || type === "integer") {
     const min = schema.minimum ?? schema.exclusiveMinimum;
@@ -1348,6 +603,13 @@ function effectControlField(name, schema, fallback) {
     return { ...base, type: type === "integer" ? "int" : "number", default: typeof def === "number" ? def : min ?? 0, ...min !== void 0 ? { min } : {}, ...max !== void 0 ? { max } : {}, ...schema.multipleOf ? { step: schema.multipleOf } : {} };
   }
   if (type === "boolean") return { ...base, type: "boolean", default: def === true };
+  if (isEffectFontControl(schema)) {
+    const fonts = options.fonts ?? SYSTEM_FONT_CATALOG;
+    const opts = fonts.map((f) => ({ value: f.family, label: f.family, description: f.category }));
+    const current = typeof def === "string" && def ? def : opts[0]?.value ?? "sans-serif";
+    if (!opts.some((o) => o.value.toLowerCase() === current.toLowerCase())) opts.unshift({ value: current, label: current, description: "current" });
+    return { ...base, type: "choice", options: opts, default: opts.find((o) => o.value.toLowerCase() === current.toLowerCase()).value, control: "select" };
+  }
   if (type === "string") {
     if (typeof def === "string" && HEX2.test(def)) return { ...base, type: "color", alpha: def.length === 9, default: def };
     return { ...base, type: "text", default: typeof def === "string" ? def : "", ...schema.maxLength ? { maxLength: schema.maxLength } : {} };
@@ -1358,8 +620,17 @@ function effectControlField(name, schema, fallback) {
   }
   return null;
 }
-function effectParameterFields(description) {
-  return Object.entries(description.controls.properties).map(([name, schema]) => effectControlField(name, schema, description.defaults[name])).filter((f) => !!f);
+function effectParameterFields(description, options = {}) {
+  return Object.entries(description.controls.properties).map(([name, schema]) => effectControlField(name, schema, description.defaults[name], options)).filter((f) => !!f);
+}
+function effectFontFamilies(description, values = {}) {
+  const out = [];
+  for (const [name, schema] of Object.entries(description.controls.properties)) {
+    if (!isEffectFontControl(schema)) continue;
+    const v = values[name] ?? description.defaults[name] ?? schema.default;
+    if (typeof v === "string" && v && !out.includes(v)) out.push(v);
+  }
+  return out;
 }
 var effectFieldValue = (field, value) => value === void 0 || value === null || typeof value === "object" && !Array.isArray(value) ? field.default : value;
 function effectSamplePicture(width, height, variant = 0) {
@@ -1821,6 +1092,7 @@ export {
   createFakeEffectProvider,
   effectControlField,
   effectFieldValue,
+  effectFontFamilies,
   effectParameterFields,
   effectSampleInputs,
   effectSamplePicture,
@@ -1828,6 +1100,7 @@ export {
   encodeEffectFloat,
   groupEffectsByCategory,
   isEffectError,
+  isEffectFontControl,
   isEffectPixels,
   linearToSrgb,
   renderEffectThumbnail,