flomotion 0.2.0 → 0.4.0

package/dist/chunks/{chunk-AVP5XX4G.mjs → chunk-PEC2UVQY.mjs}

@@ -1,19 +1,19 @@
 import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
 import {
-  CodeCutError,
+  FlomotionError,
   __export,
   cloneNode,
   findById,
   flattenChildren,
   isNode,
   walk
-} from "./chunk-IUSYVGP6.mjs";
+} from "./chunk-TTHAZGRG.mjs";
 
 // packages/core/src/config.ts
-var CODECUT_NAME = "CodeCut";
-var CODECUT_SCOPE = "@codecut";
-var CODECUT_DIR = ".codecut";
-var ID_PREFIX = "cc_";
+var FLOMOTION_NAME = "flomotion";
+var FLOMOTION_SCOPE = "@flomotion";
+var FLOMOTION_DIR = ".flomotion";
+var ID_PREFIX = "fm_";
 
 // packages/core/src/values/time.ts
 var round6 = (n) => Math.round(n * 1e6) / 1e6;
@@ -45,7 +45,7 @@ function parseTimeLiteral(input2, fps) {
   throw bad(input2);
 }
 function bad(input2) {
-  return new CodeCutError("invalid_time", `Invalid time: ${JSON.stringify(input2)}`, {
+  return new FlomotionError("invalid_time", `Invalid time: ${JSON.stringify(input2)}`, {
     fix: 'Use seconds (1.5), "1.5s", "36f" or "00:00:01:12".'
   });
 }
@@ -89,7 +89,7 @@ function parseLength(input2) {
   if (typeof input2 === "number") return { unit: "px", value: input2 };
   const m = input2.trim().match(/^(-?\d+(?:\.\d+)?|-?\.\d+)\s*(px|%|vw|vh)?$/);
   if (!m) {
-    throw new CodeCutError("invalid_value", `Invalid length: ${JSON.stringify(input2)}`, {
+    throw new FlomotionError("invalid_value", `Invalid length: ${JSON.stringify(input2)}`, {
       fix: 'Use pixels (120), "50%", "10vw" or "10vh".'
     });
   }
@@ -114,7 +114,7 @@ function parseAngle(input2) {
   if (typeof input2 === "number") return input2;
   const m = input2.trim().match(/^(-?\d+(?:\.\d+)?|-?\.\d+)\s*(deg|turn|rad|grad)?$/);
   if (!m) {
-    throw new CodeCutError("invalid_value", `Invalid angle: ${JSON.stringify(input2)}`, {
+    throw new FlomotionError("invalid_value", `Invalid angle: ${JSON.stringify(input2)}`, {
       fix: 'Use degrees (45) or "0.25turn".'
     });
   }
@@ -136,7 +136,7 @@ var clamp = (n, lo, hi) => Math.min(hi, Math.max(lo, n));
 function parseColor(input2) {
   const s = input2.trim().toLowerCase();
   if (s.startsWith("$")) {
-    throw new CodeCutError("invalid_value", `Unresolved color token ${input2}`, {
+    throw new FlomotionError("invalid_value", `Unresolved color token ${input2}`, {
       fix: "Define the token in the Theme/Look or resolve the project first."
     });
   }
@@ -188,7 +188,7 @@ var NAMED = {
   grey: "#808080"
 };
 function badColor(input2) {
-  return new CodeCutError("invalid_value", `Invalid color: ${JSON.stringify(input2)}`, {
+  return new FlomotionError("invalid_value", `Invalid color: ${JSON.stringify(input2)}`, {
     fix: 'Use "#rrggbb", "rgb(...)", "oklch(L C H)" or a "$token".'
   });
 }
@@ -333,7 +333,7 @@ function parseEase(spec) {
 }
 var evalEase = (spec, p) => parseEase(spec)(clamp01(p));
 function badEase(spec) {
-  throw new CodeCutError("invalid_value", `Unknown ease: ${JSON.stringify(spec)}`, {
+  throw new FlomotionError("invalid_value", `Unknown ease: ${JSON.stringify(spec)}`, {
     fix: 'Use e.g. "expo.out", "back.out(1.7)", "bezier(.2,.8,.2,1)" or "spring(180,18)".'
   });
 }
@@ -539,7 +539,7 @@ function normalizeTrack(raw, opts) {
   keys.sort((a, b) => a.t - b.t);
   for (let i = 1; i < keys.length; i++) {
     if (keys[i].t === keys[i - 1].t) {
-      throw new CodeCutError(
+      throw new FlomotionError(
         "duplicate_keyframe",
         `Two keyframes share time ${keys[i].t}s on one property`,
         { fix: "Give each keyframe on a property a unique time (move one by at least one frame)." }
@@ -653,7 +653,7 @@ function numSlopes(track, comp, mode) {
 }
 function evalNumber(track, tIn) {
   const ks = track.keys;
-  if (ks.length === 0) throw new CodeCutError("invalid_value", "Keyframe track has no keys");
+  if (ks.length === 0) throw new FlomotionError("invalid_value", "Keyframe track has no keys");
   const t = loopTime(track, tIn);
   if (t <= ks[0].t || ks.length === 1) return ks[0].v;
   const last = ks[ks.length - 1];
@@ -673,7 +673,7 @@ function evalNumber(track, tIn) {
 }
 function evalVec(track, tIn) {
   const ks = track.keys;
-  if (ks.length === 0) throw new CodeCutError("invalid_value", "Keyframe track has no keys");
+  if (ks.length === 0) throw new FlomotionError("invalid_value", "Keyframe track has no keys");
   const t = loopTime(track, tIn);
   if (t <= ks[0].t || ks.length === 1) return [...ks[0].v];
   const last = ks[ks.length - 1];
@@ -752,7 +752,7 @@ function makeCtx(base, t, value) {
     value,
     prop: (ref2) => {
       if (!base.prop) {
-        throw new CodeCutError(
+        throw new FlomotionError(
           "unresolved_ref",
           `ctx.prop(${JSON.stringify(ref2)}) is not available here`
         );
@@ -762,12 +762,12 @@ function makeCtx(base, t, value) {
     noise: (seed = 1, freq = 1) => noise1D(t * freq, seed),
     beat: (n) => {
       if (!base.beat)
-        throw new CodeCutError("unresolved_ref", "ctx.beat needs a tempo or beat map");
+        throw new FlomotionError("unresolved_ref", "ctx.beat needs a tempo or beat map");
       return base.beat(n);
     },
     word: (voiceId, i) => {
       if (!base.word)
-        throw new CodeCutError("unresolved_ref", "ctx.word needs a Voiceover with timings");
+        throw new FlomotionError("unresolved_ref", "ctx.word needs a Voiceover with timings");
       return base.word(voiceId, i);
     },
     lerp,
@@ -20973,7 +20973,7 @@ function group(fields, o = {}) {
 function parseControlValue(c, v, name = "value") {
   const r = c.prop.safeParse(v);
   if (!r.success) {
-    throw new CodeCutError(
+    throw new FlomotionError(
       "schema_violation",
       `${name}: ${r.error.issues.map((i) => i.message).join("; ")}`
     );
@@ -21022,7 +21022,7 @@ var BLEND_MODES = [
   "add"
 ];
 var timingControls = () => ({
-  id: text({ label: "Id", description: "Stable unique id. Written back as cc_\u2026 when missing." }),
+  id: text({ label: "Id", description: "Stable unique id. Written back as fm_\u2026 when missing." }),
   label: text({ label: "Label" }),
   start: time3({
     label: "Start",
@@ -21144,10 +21144,10 @@ function zodShape(controls, form) {
 }
 function makeDef(kind, name, base) {
   if (!/^[A-Z][A-Za-z0-9]*$/.test(name)) {
-    throw new CodeCutError("schema_violation", `Component name "${name}" must be PascalCase`);
+    throw new FlomotionError("schema_violation", `Component name "${name}" must be PascalCase`);
   }
   if (!base.own || typeof base.own !== "object") {
-    throw new CodeCutError(
+    throw new FlomotionError(
       "schema_violation",
       `${name}: components without a schema are rejected`,
       {
@@ -21159,7 +21159,7 @@ function makeDef(kind, name, base) {
   if (!controls.id)
     controls.id = text({
       label: "Id",
-      description: "Stable unique id. Written back as cc_\u2026 when missing."
+      description: "Stable unique id. Written back as fm_\u2026 when missing."
     });
   const def = {
     kind,
@@ -21233,7 +21233,7 @@ function defineEffect(name, spec) {
   });
   return makeTag(def);
 }
-var Fragment = /* @__PURE__ */ Symbol.for("codecut.fragment");
+var Fragment = /* @__PURE__ */ Symbol.for("flomotion.fragment");
 function lev(a, b) {
   const d = Array.from({ length: a.length + 1 }, (_, i) => [
     i,
@@ -21321,7 +21321,7 @@ function assertProps(def, props, id) {
   const issues = validateProps(def, props);
   if (issues.length) {
     const head = issues[0];
-    throw new CodeCutError("schema_violation", `${id ? `#${id} ` : ""}${head.message}`, {
+    throw new FlomotionError("schema_violation", `${id ? `#${id} ` : ""}${head.message}`, {
       fix: head.fix,
       details: issues
     });
@@ -21380,7 +21380,7 @@ function mcpToolSchemas(reg) {
         type: { type: "string", enum: comps.map((d) => d.name) },
         props: {
           type: "object",
-          description: "Validated against the component schema (see codecut://schema/{component})."
+          description: "Validated against the component schema (see flomotion://schema/{component})."
         },
         at: { type: "integer", description: "Child index to insert at (default: append)." }
       },
@@ -21613,7 +21613,7 @@ var transition = () => group(
   }
 );
 var ident = () => ({
-  id: text({ label: "Id", description: "Stable unique id. Written back as cc_\u2026 when missing." })
+  id: text({ label: "Id", description: "Stable unique id. Written back as fm_\u2026 when missing." })
 });
 var Composition = defineComponent("Composition", {
   category: "structure",
@@ -21833,7 +21833,7 @@ var err = (env, i) => env.issues.push(i);
 function resolveProject(source, opts = {}) {
   const reg = opts.registry ?? registry2;
   if (source.name !== "Composition") {
-    throw new CodeCutError(
+    throw new FlomotionError(
       "schema_violation",
       `Project root must be <Composition>, got <${source.name}>`,
       {
@@ -21885,7 +21885,7 @@ function resolveProject(source, opts = {}) {
 function build3(env, node2, parent, depth, generatedIds) {
   const def = env.reg.get(node2.name);
   if (!def) {
-    throw new CodeCutError("unknown_component", `Unknown component <${node2.name}>`, {
+    throw new FlomotionError("unknown_component", `Unknown component <${node2.name}>`, {
       fix: `Known: ${env.reg.names().slice(0, 40).join(", ")}\u2026`
     });
   }
@@ -22150,7 +22150,7 @@ var timed = /* @__PURE__ */ new WeakSet();
 function timeNode(env, n, visiting) {
   if (timed.has(n)) return;
   if (visiting.has(n.id)) {
-    throw new CodeCutError("unresolved_ref", `Timing reference cycle through #${n.id}`, {
+    throw new FlomotionError("unresolved_ref", `Timing reference cycle through #${n.id}`, {
       fix: "Break the cycle: a start/end cannot depend on itself."
     });
   }
@@ -22314,7 +22314,7 @@ function resolveProps(env, n) {
       const words = env.opts.words?.(voice);
       const w = words?.[i];
       if (!w)
-        throw new CodeCutError(
+        throw new FlomotionError(
           "unresolved_ref",
           `ctx.word(${JSON.stringify(voice)}, ${i}) has no timing`,
           { fix: "Run transcribe for this voice first." }
@@ -22474,7 +22474,7 @@ function resolveKeyTime(env, n, t) {
     case "marker": {
       const m = env.markers.find((x) => x.id === spec.name || x.label === spec.name);
       if (!m)
-        throw new CodeCutError("unresolved_ref", `Unknown marker "${spec.name}"`, {
+        throw new FlomotionError("unresolved_ref", `Unknown marker "${spec.name}"`, {
           fix: "Add a <Marker label=\u2026/>."
         });
       return m.at + spec.offset - n.parentStart;
@@ -22482,7 +22482,7 @@ function resolveKeyTime(env, n, t) {
     case "ref": {
       const target = env.byId.get(spec.id);
       if (!target)
-        throw new CodeCutError("unresolved_ref", `Unknown element #${spec.id}`, {
+        throw new FlomotionError("unresolved_ref", `Unknown element #${spec.id}`, {
           fix: "Check the id."
         });
       const v = spec.edge === "start" ? target.start : spec.edge === "end" ? target.end : target.duration;
@@ -22520,11 +22520,11 @@ function normFill(v, tok) {
 function readRef(env, ref2, t) {
   const m = ref2.match(/^#([\w-]+)\.([\w.]+)$/);
   if (!m)
-    throw new CodeCutError("unresolved_ref", `Bad ref ${JSON.stringify(ref2)}`, {
+    throw new FlomotionError("unresolved_ref", `Bad ref ${JSON.stringify(ref2)}`, {
       fix: 'Use "#id.prop".'
     });
   const node2 = env.byId.get(m[1]);
-  if (!node2) throw new CodeCutError("unresolved_ref", `Unknown element #${m[1]}`);
+  if (!node2) throw new FlomotionError("unresolved_ref", `Unknown element #${m[1]}`);
   const v = node2.props[m[2]];
   if (v && typeof v === "object" && "kind" in v) return evalSignal(v, t);
   return v;
@@ -22709,7 +22709,7 @@ function transitionPlan(scene, prev, spec, comp) {
   const overlay = (suffix, color2, opacityAt) => {
     const id = `${scene.id}-${suffix}`;
     plan.overlays.push({
-      html: `<div id="${id}" class="cc-tx" style="position:absolute;inset:0;background:${color2};opacity:0;z-index:9000;pointer-events:none"></div>`,
+      html: `<div id="${id}" class="fm-tx" style="position:absolute;inset:0;background:${color2};opacity:0;z-index:9000;pointer-events:none"></div>`,
       channels: [{ target: `#${id}`, prop: "opacity", signal: num4(opacityAt), span }]
     });
   };
@@ -23085,7 +23085,7 @@ function buildIR(project, opts = {}) {
     else html += kids;
     layer.html = html;
     if (n === rootNode) {
-      return `<div id="${n.id}-xf" class="cc-xf" style="position:absolute;inset:0">${layer.html}${layer.overlays.join("")}</div>`;
+      return `<div id="${n.id}-xf" class="fm-xf" style="position:absolute;inset:0">${layer.html}${layer.overlays.join("")}</div>`;
     }
     return hostHtml(layer, n);
   };
@@ -23306,21 +23306,21 @@ function hostHtml(layer, node2) {
   const host = styleAttr(
     layer.inFlow ? { position: "relative", "z-index": String(z2), ...layer.hostStyle } : { position: "absolute", inset: "0", "z-index": String(z2), ...layer.hostStyle }
   );
-  const attrs = `id="${node2.id}" class="clip cc-l cc-${node2.name.toLowerCase()}" data-start="${layer.start}" data-duration="${Math.round(dur * 1e6) / 1e6}"${layer.trackIndex !== void 0 ? ` data-track-index="${layer.trackIndex}"` : ""} data-cc="${node2.name}"`;
+  const attrs = `id="${node2.id}" class="clip fm-l fm-${node2.name.toLowerCase()}" data-start="${layer.start}" data-duration="${Math.round(dur * 1e6) / 1e6}"${layer.trackIndex !== void 0 ? ` data-track-index="${layer.trackIndex}"` : ""} data-cc="${node2.name}"`;
   if (!layer.visual) {
     return `<div ${attrs} style="${host}">${layer.html}${layer.overlays.join("")}</div>`;
   }
   const xfBase = layer.inFlow ? { position: "relative" } : layer.xfStyle["left"] || layer.xfStyle["top"] || layer.xfStyle["width"] ? { position: "absolute" } : { position: "absolute", inset: "0" };
   const xf = styleAttr({ ...xfBase, ...layer.xfStyle });
-  return `<div ${attrs} style="${host}"><div id="${node2.id}-xf" class="cc-xf" style="${xf}">${layer.html}${layer.overlays.join("")}</div></div>`;
+  return `<div ${attrs} style="${host}"><div id="${node2.id}-xf" class="fm-xf" style="${xf}">${layer.html}${layer.overlays.join("")}</div></div>`;
 }
 
 // packages/core/src/compile/html.ts
 var BASE_CSS = `*{margin:0;padding:0;box-sizing:border-box}
 html,body{margin:0;overflow:hidden}
-.cc-l{pointer-events:none}
-.cc-xf{will-change:auto}
-.cc-xf>*{max-width:none}`;
+.fm-l{pointer-events:none}
+.fm-xf{will-change:auto}
+.fm-xf>*{max-width:none}`;
 function fontFaceCss(fonts) {
   const rules = [];
   for (const f of fonts) {
@@ -23353,7 +23353,7 @@ function walkAll(layer, fn) {
   layer.children.forEach((c) => walkAll(c, fn));
 }
 var RUNTIME = `(function(){
-  var G=window.gsap, S=window.__ccStatic||[], B=window.__ccBaked||[], D=window.__ccDur||1, els={};
+  var G=window.gsap, S=window.__fmStatic||[], B=window.__fmBaked||[], D=window.__fmDur||1, els={};
   function el(sel){return els[sel]||(els[sel]=document.querySelector(sel));}
   function put(target,props){var e=el(target); if(!e)return; if(props.__text!==undefined){e.textContent=props.__text; delete props.__text;} var at=props.__attr; if(at){for(var k in at)e.setAttribute(k,at[k]); delete props.__attr;} if(Object.keys(props).length)G.set(e,props);}
   function groupBy(list){var m={};list.forEach(function(c){(m[c[0]]=m[c[0]]||[]).push(c);});return m;}
@@ -23381,9 +23381,9 @@ var RUNTIME = `(function(){
   var tl=G.timeline({paused:true});
   tl.to(proxy,{t:D,duration:D,ease:"none",onUpdate:function(){renderAt(proxy.t);}},0);
   renderAt(0);
-  window.__ccRenderAt=renderAt;
+  window.__fmRenderAt=renderAt;
   window.__timelines=window.__timelines||{};
-  window.__timelines[window.__ccId]=tl;
+  window.__timelines[window.__fmId]=tl;
   tl.seek(0);
 })();`;
 function compileProject(project, opts = {}) {
@@ -23415,10 +23415,10 @@ function compileProject(project, opts = {}) {
   const bakedRows = acc.baked.map((b) => [b.target, b.prop, b.t0, b.hz, b.samples, b.unit ?? ""]);
   const gsap = opts.gsapPath ?? "vendor/gsap.min.js";
   const res = comp.width >= comp.height ? comp.width === comp.height ? "square" : "landscape" : "portrait";
-  const mix = opts.mix ? `<audio id="cc-mix" src="${opts.mix.src}" data-start="0" data-duration="${numFmt(opts.mix.duration ?? comp.duration)}" data-volume="1"></audio>` : "";
+  const mix = opts.mix ? `<audio id="fm-mix" src="${opts.mix.src}" data-start="0" data-duration="${numFmt(opts.mix.duration ?? comp.duration)}" data-volume="1"></audio>` : "";
   const defs = acc.defs.length ? `<svg width="0" height="0" style="position:absolute" aria-hidden="true"><defs>${acc.defs.join("")}</defs></svg>` : "";
   const html = `<!doctype html>
-<html lang="en" data-resolution="${res}" data-generator="${CODECUT_NAME}">
+<html lang="en" data-resolution="${res}" data-generator="${FLOMOTION_NAME}">
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=${comp.width}, height=${comp.height}">
@@ -23437,10 +23437,10 @@ ${root.html}
 ${mix}
 </div>
 <script>
-window.__ccId=${JSON.stringify(comp.id)};
-window.__ccDur=${numFmt(comp.duration)};
-window.__ccStatic=${JSON.stringify(staticRows)};
-window.__ccBaked=${JSON.stringify(bakedRows)};
+window.__fmId=${JSON.stringify(comp.id)};
+window.__fmDur=${numFmt(comp.duration)};
+window.__fmStatic=${JSON.stringify(staticRows)};
+window.__fmBaked=${JSON.stringify(bakedRows)};
 </script>
 <script>
 ${RUNTIME}
@@ -23608,7 +23608,7 @@ function lintProject(project, ctx = {}) {
           rule: "font-no-ledger",
           message: `Font "${f.id}" (${f.family}) has no ledger entry`,
           id: f.id,
-          fix: "Run `codecut fonts sync`."
+          fix: "Run `flomotion fonts sync`."
         });
       else {
         const lic = ctx.ledger.entries.find(
@@ -23630,7 +23630,7 @@ function lintProject(project, ctx = {}) {
         rule: "font-network-url",
         message: `Font "${f.id}" is loaded from a URL at render time`,
         id: f.id,
-        fix: "Run `codecut fonts sync` so the file is local."
+        fix: "Run `flomotion fonts sync` so the file is local."
       });
   }
   for (const m of ctx.fontLockProblems?.(declIds) ?? [])
@@ -23638,7 +23638,7 @@ function lintProject(project, ctx = {}) {
       severity: "error",
       rule: "font-lock",
       message: m,
-      fix: "Run `codecut fonts sync`."
+      fix: "Run `flomotion fonts sync`."
     });
   const minSize = Math.min(comp.width, comp.height) * cfg.minTextSize;
   const safePreset = cfg.safe ?? (comp.height > comp.width ? "reels" : "none");
@@ -23720,8 +23720,8 @@ function lintProject(project, ctx = {}) {
           });
         else if (ctx.ledger) {
           const e = ctx.ledger.entries.find((x) => `${x.source}:${x.id}` === src);
-          const family = /^CC0/i.test(e?.license ?? "") ? "CC0" : /^CC-BY(-\d|$)/i.test(e?.license ?? "") ? "CC-BY" : e?.license;
-          if (e && !cfg.soundLicenses.includes(family))
+          const family = /^CC0/i.test(e?.license ?? "") ? "CC0" : /^CC-BY(-\d|$)/i.test(e?.license ?? "") ? "CC-BY" : e?.source === "local" || e?.source === "own" || /^(user-supplied|owned|licensed|used with permission)/i.test(e?.license ?? "") ? "own" : e?.license;
+          if (e && family !== "own" && !cfg.soundLicenses.includes(family))
             out.push({
               severity: "error",
               rule: "license-blocked",
@@ -23742,17 +23742,42 @@ function lintProject(project, ctx = {}) {
       });
     }
   }
-  for (const n of nodes.filter((x) => ["Image", "Video", "Clip"].includes(x.name))) {
+  const MANAGED = /^(\.\/)?assets\/(third-party|captures|brand|imported)\//;
+  for (const n of nodes.filter((x) => ["Image", "Svg", "Video", "Clip"].includes(x.name))) {
     const src = String(n.raw.src ?? "");
-    if (src && ctx.fileExists && !ctx.fileExists(src))
+    if (!src || /^data:|^</.test(src.trim())) continue;
+    if (ctx.fileExists && !ctx.fileExists(src)) {
       out.push({
         severity: "error",
         rule: "asset-missing",
         message: `#${n.id}: file ${src} does not exist`,
         id: n.id,
         prop: "src",
-        fix: "Add the file to the project."
+        fix: "Add the file to the project, or fetch it with asset_get / asset_capture / asset_import."
       });
+      continue;
+    }
+    if (ctx.ledger && MANAGED.test(src)) {
+      const rel = src.replace(/^\.\//, "");
+      const e = ctx.ledger.entries.find((x) => x.file === rel);
+      if (!e)
+        out.push({
+          severity: "error",
+          rule: "asset-no-ledger",
+          message: `#${n.id}: ${src} has no ledger entry`,
+          id: n.id,
+          prop: "src",
+          fix: "Fetch it with asset_get, asset_capture or asset_import so its licence is recorded."
+        });
+      else if (!e.commercialOk)
+        out.push({
+          severity: "error",
+          rule: "license-blocked",
+          message: `#${n.id}: ${src} (${e.license}) is not cleared for commercial use`,
+          id: n.id,
+          fix: "Pick an asset with a licence that allows it, or get permission and re-import it."
+        });
+    }
   }
   return unique(out);
 }
@@ -23888,7 +23913,7 @@ __export(edit_exports, {
 function elementOrThrow(root, id) {
   const hit = findById(root, id);
   if (!hit)
-    throw new CodeCutError("unknown_element", `No element with id "${id}"`, {
+    throw new FlomotionError("unknown_element", `No element with id "${id}"`, {
       fix: "Use project_read to list ids."
     });
   return hit;
@@ -23925,7 +23950,7 @@ function applyPatches(root, patches) {
       }
       case "remove": {
         const { node: node2, parent, index } = elementOrThrow(project, p.id);
-        if (!parent) throw new CodeCutError("invalid_edit", "Cannot remove the root element");
+        if (!parent) throw new FlomotionError("invalid_edit", "Cannot remove the root element");
         parent.children.splice(index, 1);
         inverse.unshift({
           op: "insert",
@@ -23967,14 +23992,14 @@ var fmt = (t) => `${Math.round(t * 1e6) / 1e6}s`;
 var snap = (root, t) => snapToFrame(t, fpsOf(root));
 function lit(root, v, what, id) {
   if (v === void 0)
-    throw new CodeCutError("invalid_edit", `#${id} has no explicit ${what}`, {
+    throw new FlomotionError("invalid_edit", `#${id} has no explicit ${what}`, {
       fix: `Give #${id} a literal ${what} (e.g. ${what}="2s") before editing its timing.`
     });
   try {
     if (typeof v === "string" && /^[@#]/.test(v)) throw new Error("reference");
     return parseTimeLiteral(v, fpsOf(root));
   } catch {
-    throw new CodeCutError(
+    throw new FlomotionError(
       "opaque_expression",
       `#${id}.${what} is ${JSON.stringify(v)}, which is not a literal time`,
       { fix: "Replace the reference/expression with a literal time first." }
@@ -23988,7 +24013,7 @@ function timingOf(root, node2) {
   if (node2.props.duration !== void 0) duration3 = lit(root, node2.props.duration, "duration", id);
   else if (node2.props.end !== void 0) duration3 = lit(root, node2.props.end, "end", id) - start;
   else
-    throw new CodeCutError("invalid_edit", `#${id} has no explicit duration`, {
+    throw new FlomotionError("invalid_edit", `#${id} has no explicit duration`, {
       fix: `Give #${id} a duration (e.g. duration="2s") before editing its timing.`
     });
   return { node: node2, id, start, duration: duration3, end: start + duration3 };
@@ -24002,7 +24027,7 @@ function itemsOf(root, container) {
 function trackOf(root, id) {
   const { node: node2 } = elementOrThrow(root, id);
   if (node2.name !== "Track" && node2.name !== "Scene" && node2.name !== "Composition" && node2.name !== "Group") {
-    throw new CodeCutError("invalid_edit", `#${id} is a ${node2.name}, not a Track`, {
+    throw new FlomotionError("invalid_edit", `#${id} is a ${node2.name}, not a Track`, {
       fix: "Pass the id of a Track."
     });
   }
@@ -24010,14 +24035,14 @@ function trackOf(root, id) {
 }
 function assertWritable(track) {
   if (track.name === "Track" && track.props.locked === true) {
-    throw new CodeCutError("track_locked", `Track #${track.props.id} is locked`, {
+    throw new FlomotionError("track_locked", `Track #${track.props.id} is locked`, {
       fix: `Unlock it first with edit lockTrack {track:"${track.props.id}", value:false}.`
     });
   }
 }
 function parentTrackOf(root, id) {
   const { parent } = elementOrThrow(root, id);
-  if (!parent) throw new CodeCutError("invalid_edit", "The root has no track");
+  if (!parent) throw new FlomotionError("invalid_edit", "The root has no track");
   return parent;
 }
 function overlapCheck(items, ignore, start, end, allow) {
@@ -24025,7 +24050,7 @@ function overlapCheck(items, ignore, start, end, allow) {
   for (const o of items) {
     if (ignore.includes(o.id)) continue;
     if (start < o.end - 1e-9 && end > o.start + 1e-9) {
-      throw new CodeCutError(
+      throw new FlomotionError(
         "overlap_rejected",
         `[${fmt(start)}, ${fmt(end)}) overlaps #${o.id} [${fmt(o.start)}, ${fmt(o.end)})`,
         { fix: "Move it, trim the neighbour, or pass overlap:true." }
@@ -24131,7 +24156,7 @@ function overwrite(root, a) {
 }
 function replace(root, a) {
   const { node: old, parent, index } = elementOrThrow(root, a.id);
-  if (!parent) throw new CodeCutError("invalid_edit", "Cannot replace the root");
+  if (!parent) throw new FlomotionError("invalid_edit", "Cannot replace the root");
   assertWritable(parent);
   const node2 = cloneNode(a.node);
   const keep = {};
@@ -24170,7 +24195,7 @@ function extract(root, a) {
   assertWritable(track);
   const from = snap(root, lit(root, a.from, "from", a.track));
   const to = snap(root, lit(root, a.to, "to", a.track));
-  if (to <= from) throw new CodeCutError("invalid_edit", "extract needs to > from");
+  if (to <= from) throw new FlomotionError("invalid_edit", "extract needs to > from");
   const span = to - from;
   const fps = fpsOf(root);
   const patches = [];
@@ -24216,7 +24241,7 @@ function split(root, a) {
   const it = timingOf(root, elementOrThrow(root, a.id).node);
   const at = snap(root, lit(root, a.at, "at", a.id));
   if (at <= it.start + 1e-9 || at >= it.end - 1e-9)
-    throw new CodeCutError(
+    throw new FlomotionError(
       "invalid_edit",
       `split time ${fmt(at)} is outside #${a.id} (${fmt(it.start)} to ${fmt(it.end)})`
     );
@@ -24232,7 +24257,7 @@ function trim(root, a) {
   const fps = fpsOf(root);
   const start = a.start === void 0 ? it.start : snap(root, lit(root, a.start, "start", a.id));
   const end = a.end === void 0 ? it.end : snap(root, lit(root, a.end, "end", a.id));
-  if (end <= start) throw new CodeCutError("invalid_edit", "trim would make the clip empty");
+  if (end <= start) throw new FlomotionError("invalid_edit", "trim would make the clip empty");
   overlapCheck(itemsOf(root, parent), [a.id], start, end, a.overlap);
   const patches = [setTime(a.id, "start", start), setTime(a.id, "duration", end - start)];
   if (it.node.props.end !== void 0) patches.push(dropProp(a.id, "end"));
@@ -24252,12 +24277,12 @@ function roll(root, a) {
   const A = timingOf(root, elementOrThrow(root, a.a).node);
   const B = timingOf(root, elementOrThrow(root, a.b).node);
   if (Math.abs(A.end - B.start) > 1e-6)
-    throw new CodeCutError("invalid_edit", `#${a.a} and #${a.b} are not adjacent`, {
+    throw new FlomotionError("invalid_edit", `#${a.a} and #${a.b} are not adjacent`, {
       fix: "Roll needs clips that touch."
     });
   const d = snap(root, lit(root, a.delta, "delta", a.a));
   if (A.duration + d <= 0 || B.duration - d <= 0)
-    throw new CodeCutError("invalid_edit", "roll would collapse a clip");
+    throw new FlomotionError("invalid_edit", "roll would collapse a clip");
   const fps = fpsOf(root);
   const patches = [
     setTime(a.a, "duration", A.duration + d),
@@ -24286,7 +24311,8 @@ function slide(root, a) {
   assertWritable(parent);
   const items = itemsOf(root, parent);
   const i = items.findIndex((x) => x.id === a.id);
-  if (i < 0) throw new CodeCutError("unknown_element", `#${a.id} is not a timed item of its track`);
+  if (i < 0)
+    throw new FlomotionError("unknown_element", `#${a.id} is not a timed item of its track`);
   const it = items[i];
   const d = snap(root, lit(root, a.delta, "delta", a.id));
   const prev = items[i - 1];
@@ -24295,12 +24321,12 @@ function slide(root, a) {
   const patches = [setTime(a.id, "start", it.start + d)];
   if (prev && Math.abs(prev.end - it.start) < 1e-6) {
     if (prev.duration + d <= 0)
-      throw new CodeCutError("invalid_edit", "slide would collapse the previous clip");
+      throw new FlomotionError("invalid_edit", "slide would collapse the previous clip");
     patches.push(setTime(prev.id, "duration", prev.duration + d));
   }
   if (next && Math.abs(it.end - next.start) < 1e-6) {
     if (next.duration - d <= 0)
-      throw new CodeCutError("invalid_edit", "slide would collapse the next clip");
+      throw new FlomotionError("invalid_edit", "slide would collapse the next clip");
     patches.push(
       setTime(next.id, "start", next.start + d),
       setTime(next.id, "duration", next.duration - d)
@@ -24314,7 +24340,7 @@ function slide(root, a) {
 }
 function move(root, a) {
   const { node: node2, parent, index } = elementOrThrow(root, a.id);
-  if (!parent) throw new CodeCutError("invalid_edit", "Cannot move the root");
+  if (!parent) throw new FlomotionError("invalid_edit", "Cannot move the root");
   assertWritable(parent);
   const it = timingOf(root, node2);
   const to = snap(root, lit(root, a.to, "to", a.id));
@@ -24356,11 +24382,11 @@ function unlink(root, a) {
 }
 function wrap(root, ids, name, id) {
   if (!ids.length)
-    throw new CodeCutError("invalid_edit", `${name.toLowerCase()} needs at least one id`);
+    throw new FlomotionError("invalid_edit", `${name.toLowerCase()} needs at least one id`);
   const els = ids.map((i) => elementOrThrow(root, i));
   const parent = els[0].parent;
   if (els.some((e) => e.parent !== parent))
-    throw new CodeCutError("invalid_edit", "All elements must share one parent");
+    throw new FlomotionError("invalid_edit", "All elements must share one parent");
   assertWritable(parent);
   const times = els.map((e) => timingOf(root, e.node));
   const start = Math.min(...times.map((t) => t.start));
@@ -24393,10 +24419,10 @@ var groupItems = (root, a) => wrap(root, a.ids, "Group", a.id);
 var nest = (root, a) => wrap(root, a.ids, "Precomp", a.id);
 function ungroup(root, a) {
   const { node: node2, parent, index } = elementOrThrow(root, a.id);
-  if (!parent) throw new CodeCutError("invalid_edit", "Cannot ungroup the root");
+  if (!parent) throw new FlomotionError("invalid_edit", "Cannot ungroup the root");
   assertWritable(parent);
   if (node2.name !== "Group" && node2.name !== "Precomp")
-    throw new CodeCutError("invalid_edit", `#${a.id} is a ${node2.name}, not a Group`);
+    throw new FlomotionError("invalid_edit", `#${a.id} is a ${node2.name}, not a Group`);
   const gs = timingOf(root, node2).start;
   const patches = [{ op: "remove", id: a.id }];
   node2.children.filter(isNode).forEach((c, k) => {
@@ -24411,7 +24437,7 @@ function ungroup(root, a) {
 }
 function setSpeed(root, a) {
   assertWritable(parentTrackOf(root, a.id));
-  if (!(a.speed > 0)) throw new CodeCutError("invalid_edit", "speed must be > 0");
+  if (!(a.speed > 0)) throw new FlomotionError("invalid_edit", "speed must be > 0");
   const it = timingOf(root, elementOrThrow(root, a.id).node);
   const old = speedOf(it.node);
   const dur = snap(root, it.duration * old / a.speed);
@@ -24423,7 +24449,7 @@ function setSpeed(root, a) {
 }
 function snapOp(root, a) {
   const { node: node2, parent } = elementOrThrow(root, a.id);
-  if (!parent) throw new CodeCutError("invalid_edit", "Cannot snap the root");
+  if (!parent) throw new FlomotionError("invalid_edit", "Cannot snap the root");
   assertWritable(parent);
   const it = timingOf(root, node2);
   const fps = fpsOf(root);
@@ -24490,7 +24516,7 @@ function addMarker(root, a) {
 }
 function removeMarker(root, a) {
   const { node: node2 } = elementOrThrow(root, a.id);
-  if (node2.name !== "Marker") throw new CodeCutError("invalid_edit", `#${a.id} is not a Marker`);
+  if (node2.name !== "Marker") throw new FlomotionError("invalid_edit", `#${a.id} is not a Marker`);
   return makeResult(root, [{ op: "remove", id: a.id }], `remove marker #${a.id}`);
 }
 var EDIT_OPS = {
@@ -24522,7 +24548,7 @@ var EDIT_OPS = {
 function runEdit(root, op, args) {
   const fn = EDIT_OPS[op];
   if (!fn)
-    throw new CodeCutError("invalid_edit", `Unknown edit op "${op}"`, {
+    throw new FlomotionError("invalid_edit", `Unknown edit op "${op}"`, {
       fix: `Ops: ${Object.keys(EDIT_OPS).join(", ")}`
     });
   return fn(root, args);
@@ -24535,7 +24561,7 @@ var num2 = (t, id) => {
   if (typeof t === "number") return t;
   const m = /^(-?\d+(?:\.\d+)?)s?$/.exec(t.trim());
   if (!m)
-    throw new CodeCutError(
+    throw new FlomotionError(
       "opaque_expression",
       `Keyframe time ${JSON.stringify(t)} on #${id} is a reference; structured keyframe edits need literal times`,
       { fix: "Replace it with a literal time first." }
@@ -24547,20 +24573,20 @@ function read(root, id, prop, create = false) {
   const raw = node2.props[prop];
   if (raw === void 0) {
     if (!create)
-      throw new CodeCutError("invalid_edit", `#${id}.${prop} has no keyframes`, {
+      throw new FlomotionError("invalid_edit", `#${id}.${prop} has no keyframes`, {
         fix: "Use keyAdd to create the first key."
       });
     return { set: { keys: [], opts: {} }, node: node2, raw };
   }
   if (typeof raw === "function")
-    throw new CodeCutError(
+    throw new FlomotionError(
       "opaque_expression",
       `#${id}.${prop} is an expression; it cannot be edited as keyframes`,
       { fix: "Replace the expression with keyframes first." }
     );
   if (!isKeyframes(raw)) {
     if (!create)
-      throw new CodeCutError("invalid_edit", `#${id}.${prop} is a static value, not keyframes`, {
+      throw new FlomotionError("invalid_edit", `#${id}.${prop} is a static value, not keyframes`, {
         fix: "Use keyAdd to turn it into keyframes."
       });
     return { set: { keys: [], opts: {} }, node: node2, raw };
@@ -24584,7 +24610,7 @@ function write(root, id, prop, set2, desc, data) {
   const keys = [...set2.keys].sort((a, b) => a.t - b.t);
   for (let i = 1; i < keys.length; i++) {
     if (keys[i].t === keys[i - 1].t)
-      throw new CodeCutError(
+      throw new FlomotionError(
         "duplicate_keyframe",
         `Two keyframes share time ${keys[i].t}s on #${id}.${prop}`,
         { fix: "Give each key a unique time (at least one frame apart)." }
@@ -24610,9 +24636,13 @@ function keyAdd(root, a) {
     if (t > 0) set2.keys.push({ t: 0, v: node2.props[a.prop] });
   }
   if (set2.keys.some((k) => same(k.t, t)))
-    throw new CodeCutError("duplicate_keyframe", `#${a.id}.${a.prop} already has a key at ${t}s`, {
-      fix: "Use keySet to change it."
-    });
+    throw new FlomotionError(
+      "duplicate_keyframe",
+      `#${a.id}.${a.prop} already has a key at ${t}s`,
+      {
+        fix: "Use keySet to change it."
+      }
+    );
   set2.keys.push({ t, v: a.value, ...a.ease ? { ease: a.ease } : {} });
   return write(root, a.id, a.prop, set2, `add key ${a.prop} @ ${t}s on #${a.id}`);
 }
@@ -24621,7 +24651,7 @@ function keySet(root, a) {
   const t = snap2(root, num2(a.t, a.id));
   const k = set2.keys.find((x) => same(x.t, t));
   if (!k)
-    throw new CodeCutError("invalid_edit", `#${a.id}.${a.prop} has no key at ${t}s`, {
+    throw new FlomotionError("invalid_edit", `#${a.id}.${a.prop} has no key at ${t}s`, {
       fix: "Use keyAdd to create one."
     });
   if (a.value !== void 0) k.v = a.value;
@@ -24635,9 +24665,9 @@ function keyMove(root, a) {
   const f = snap2(root, num2(a.from, a.id));
   const t = snap2(root, num2(a.to, a.id));
   const k = set2.keys.find((x) => same(x.t, f));
-  if (!k) throw new CodeCutError("invalid_edit", `#${a.id}.${a.prop} has no key at ${f}s`);
+  if (!k) throw new FlomotionError("invalid_edit", `#${a.id}.${a.prop} has no key at ${f}s`);
   if (set2.keys.some((x) => x !== k && same(x.t, t)))
-    throw new CodeCutError("duplicate_keyframe", `#${a.id}.${a.prop} already has a key at ${t}s`);
+    throw new FlomotionError("duplicate_keyframe", `#${a.id}.${a.prop} already has a key at ${t}s`);
   k.t = t;
   return write(root, a.id, a.prop, set2, `move key ${a.prop} ${f}s \u2192 ${t}s on #${a.id}`);
 }
@@ -24647,7 +24677,7 @@ function keyDelete(root, a) {
   const before = set2.keys.length;
   set2.keys = set2.keys.filter((x) => !same(x.t, t));
   if (set2.keys.length === before)
-    throw new CodeCutError("invalid_edit", `#${a.id}.${a.prop} has no key at ${t}s`);
+    throw new FlomotionError("invalid_edit", `#${a.id}.${a.prop} has no key at ${t}s`);
   if (set2.keys.length === 0)
     return makeResult(
       root,
@@ -24664,13 +24694,13 @@ function keyCopy(root, a) {
 }
 function keyPaste(root, a) {
   const { set: set2 } = read(root, a.id, a.prop, true);
-  if (!a.keys.length) throw new CodeCutError("invalid_edit", "nothing to paste");
+  if (!a.keys.length) throw new FlomotionError("invalid_edit", "nothing to paste");
   const base = Math.min(...a.keys.map((k) => num2(k.t, a.id)));
   const at = snap2(root, num2(a.at, a.id));
   for (const k of a.keys) {
     const t = snap2(root, at + num2(k.t, a.id) - base);
     if (set2.keys.some((x) => same(x.t, t)))
-      throw new CodeCutError(
+      throw new FlomotionError(
         "duplicate_keyframe",
         `paste would put two keys at ${t}s on #${a.id}.${a.prop}`
       );
@@ -24685,7 +24715,7 @@ function keyPaste(root, a) {
   );
 }
 function keyScale(root, a) {
-  if (!(a.factor > 0)) throw new CodeCutError("invalid_edit", "factor must be > 0");
+  if (!(a.factor > 0)) throw new FlomotionError("invalid_edit", "factor must be > 0");
   const { set: set2 } = read(root, a.id, a.prop);
   const origin = a.origin === void 0 ? set2.keys[0].t : num2(a.origin, a.id);
   for (const k of set2.keys) k.t = snap2(root, origin + (k.t - origin) * a.factor);
@@ -24788,7 +24818,7 @@ function keySimplify(root, a) {
   const tol = a.tolerance ?? 0.01;
   const vecs = set2.keys.map((k) => Array.isArray(k.v) ? k.v : [k.v]);
   if (vecs.some((v) => v.some((x) => typeof x !== "number")))
-    throw new CodeCutError("invalid_edit", "keySimplify works on numeric or vector keys");
+    throw new FlomotionError("invalid_edit", "keySimplify works on numeric or vector keys");
   const t = set2.keys.map((k) => k.t);
   const keep = /* @__PURE__ */ new Set([0, set2.keys.length - 1]);
   const rec = (i, j) => {
@@ -24825,7 +24855,7 @@ var AXES = ["x", "y", "z"];
 function keySeparate(root, a) {
   const { set: set2 } = read(root, a.id, a.prop);
   const dim = Array.isArray(set2.keys[0].v) ? set2.keys[0].v.length : 0;
-  if (!dim) throw new CodeCutError("invalid_edit", `#${a.id}.${a.prop} is not a vector property`);
+  if (!dim) throw new FlomotionError("invalid_edit", `#${a.id}.${a.prop} is not a vector property`);
   const value = {};
   for (let c = 0; c < dim; c++) {
     value[AXES[c]] = set2.keys.map(
@@ -24842,7 +24872,7 @@ function keyCombine(root, a) {
   const { node: node2 } = elementOrThrow(root, a.id);
   const raw = node2.props[a.prop];
   if (!raw || Array.isArray(raw) || typeof raw !== "object")
-    throw new CodeCutError("invalid_edit", `#${a.id}.${a.prop} is not per-axis`);
+    throw new FlomotionError("invalid_edit", `#${a.id}.${a.prop} is not per-axis`);
   const axes = AXES.filter((x) => raw[x]);
   const lists = axes.map(
     (x) => raw[x].map(
@@ -24886,16 +24916,16 @@ var KEY_OPS = {
 function runKeyOp(root, op, args) {
   const fn = KEY_OPS[op];
   if (!fn)
-    throw new CodeCutError("invalid_edit", `Unknown keyframe op "${op}"`, {
+    throw new FlomotionError("invalid_edit", `Unknown keyframe op "${op}"`, {
       fix: `Ops: ${Object.keys(KEY_OPS).join(", ")}`
     });
   return fn(root, args);
 }
 
 export {
-  CODECUT_NAME,
-  CODECUT_SCOPE,
-  CODECUT_DIR,
+  FLOMOTION_NAME,
+  FLOMOTION_SCOPE,
+  FLOMOTION_DIR,
   ID_PREFIX,
   snapToFrame,
   secondsToFrames,