reframe-video 0.6.33 → 0.6.39

package/dist/frame.js

@@ -278,11 +278,68 @@ function compileScene(ir) {
         const grouping = { kind: tl.parallel ? "par" : "seq", children: tl.children };
         const natural = durationOf(grouping, 0);
         const k = tl.scale ?? (tl.duration !== void 0 ? tl.duration / Math.max(1e-9, natural) : 1);
-        const beatStart = tl.at ?? start + (tl.gap ?? 0);
+        const at = typeof tl.at === "number" ? tl.at : void 0;
+        const beatStart = at ?? start + (tl.gap ?? 0);
         return beatStart + k * natural;
       }
     }
   };
+  let labelClock;
+  const anyAnchor = (tl) => tl.kind === "beat" && typeof tl.at === "string" || "children" in tl && tl.children.some(anyAnchor);
+  if (ir.timeline && anyAnchor(ir.timeline)) {
+    const clock = /* @__PURE__ */ new Map();
+    const clockWalk = (tl, start) => {
+      let end = start;
+      switch (tl.kind) {
+        case "seq": {
+          let t = start;
+          for (const c of orderBeats(tl.children)) t = clockWalk(c, t);
+          end = t;
+          break;
+        }
+        case "par": {
+          for (const c of tl.children) end = Math.max(end, clockWalk(c, start));
+          break;
+        }
+        case "stagger": {
+          tl.children.forEach((c, i) => {
+            end = Math.max(end, clockWalk(c, start + i * tl.interval));
+          });
+          break;
+        }
+        case "wait":
+          end = start + tl.duration;
+          break;
+        case "tween":
+          end = start + (tl.duration ?? DEFAULT_TWEEN_DURATION);
+          break;
+        case "motionPath":
+          end = start + (tl.duration ?? DEFAULT_MOTIONPATH_DURATION);
+          break;
+        case "to": {
+          const override = ir.states?.[tl.state] ?? {};
+          const si = tl.stagger ?? 0;
+          const targets = nodeOrder.filter((id) => id in override && (tl.filter === void 0 || tl.filter.includes(id)));
+          end = start + (tl.duration ?? DEFAULT_TO_DURATION) + Math.max(0, targets.length - 1) * si;
+          break;
+        }
+        case "beat": {
+          const grouping = { kind: tl.parallel ? "par" : "seq", children: tl.children };
+          const k = tl.scale ?? (tl.duration !== void 0 ? tl.duration / Math.max(1e-9, durationOf(grouping, 0)) : 1);
+          const inner = k === 1 ? grouping : scaleTimeline(grouping, k);
+          const at = typeof tl.at === "number" ? tl.at : void 0;
+          const beatStart = at ?? start + (tl.gap ?? 0);
+          end = clockWalk(inner, beatStart);
+          clock.set(tl.name, { t0: beatStart, t1: end });
+          break;
+        }
+      }
+      if ("label" in tl && tl.label !== void 0) clock.set(tl.label, { t0: start, t1: end });
+      return end;
+    };
+    clockWalk(ir.timeline, 0);
+    labelClock = clock;
+  }
   const walk = (tl, start) => {
     const end = walkInner(tl, start);
     if ("label" in tl && tl.label !== void 0) labelTimes.set(tl.label, { t0: start, t1: end });
@@ -299,7 +356,8 @@ function compileScene(ir) {
         const grouping = { kind: tl.parallel ? "par" : "seq", children: tl.children };
         const k = tl.scale ?? (tl.duration !== void 0 ? tl.duration / Math.max(1e-9, durationOf(grouping, 0)) : 1);
         const inner = k === 1 ? grouping : scaleTimeline(grouping, k);
-        const beatStart = tl.at ?? start + (tl.gap ?? 0);
+        const anchored = typeof tl.at === "string" ? labelClock?.get(tl.at)?.t0 : tl.at;
+        const beatStart = anchored !== void 0 ? anchored + (typeof tl.at === "string" ? tl.gap ?? 0 : 0) : start + (tl.gap ?? 0);
         const end = walk(inner, beatStart);
         beatTimes.set(tl.name, { t0: beatStart, t1: end });
         labelTimes.set(tl.name, { t0: beatStart, t1: end });
@@ -500,6 +558,7 @@ ${problems.map((p) => `  - ${p}`).join("\n")}`);
 function validateScene(ir) {
   const problems = [];
   const nodeById = /* @__PURE__ */ new Map();
+  const startAnchors = [];
   const checkPaint = (where, value) => {
     if (typeof value !== "object" || value === null) return;
     const g = value;
@@ -532,6 +591,7 @@ function validateScene(ir) {
       if (typeof props.shadowBlur === "number" && props.shadowBlur < 0) problems.push(`node "${node.id}": shadowBlur must be >= 0`);
       if (typeof props.blend === "string" && !BLEND_MODES.has(props.blend)) problems.push(`node "${node.id}": unknown blend "${props.blend}" \u2014 use ${[...BLEND_MODES].join(", ")}`);
       if (typeof props.fit === "string" && !IMAGE_FITS.has(props.fit)) problems.push(`node "${node.id}": unknown fit "${props.fit}" \u2014 use ${[...IMAGE_FITS].join(", ")}`);
+      if (node.type === "video" && typeof node.props.start === "string") startAnchors.push({ id: node.id, at: node.props.start });
       if (node.type === "group") {
         const clip = node.props.clip;
         if (clip) {
@@ -592,6 +652,7 @@ function validateScene(ir) {
     );
   }
   const labels = /* @__PURE__ */ new Set();
+  const beatAnchors = [];
   const checkEase = (path2, ease) => {
     if (ease === void 0) return;
     if (typeof ease === "string") {
@@ -683,6 +744,7 @@ function validateScene(ir) {
           );
         }
         labels.add(tl.name);
+        if (typeof tl.at === "string") beatAnchors.push({ name: tl.name, at: tl.at, path: path2 });
         if (tl.duration !== void 0 && tl.duration <= 0) {
           problems.push(`${path2}: beat "${tl.name}" duration must be > 0`);
         }
@@ -701,6 +763,22 @@ function validateScene(ir) {
     }
   };
   if (ir.timeline) checkTimeline(ir.timeline, "timeline");
+  for (const a of beatAnchors) {
+    if (a.at === a.name) {
+      problems.push(`${a.path}: beat "${a.name}" at: "${a.at}" cannot anchor to itself`);
+    } else if (!labels.has(a.at)) {
+      problems.push(
+        `${a.path}: beat "${a.name}" at: "${a.at}" \u2014 unknown timeline label \u2014 known labels: ${[...labels].join(", ") || "(none)"}`
+      );
+    }
+  }
+  for (const a of startAnchors) {
+    if (!labels.has(a.at)) {
+      problems.push(
+        `video "${a.id}" start: "${a.at}" \u2014 unknown timeline label \u2014 known labels: ${[...labels].join(", ") || "(none)"}`
+      );
+    }
+  }
   for (const [i, b] of (ir.behaviors ?? []).entries()) {
     checkProps(`behaviors[${i}]`, b.target, { [b.prop]: 0 });
   }
@@ -891,7 +969,7 @@ ${stderr.slice(-2e3)}`))
   });
 }
 function neededSeconds(node, duration) {
-  const start = node.props.start ?? 0;
+  const start = typeof node.props.start === "string" ? 0 : node.props.start ?? 0;
   const rate = node.props.rate ?? 1;
   const clipStart = node.props.clipStart ?? 0;
   return clipStart + Math.max(0, duration - start) * Math.max(0, rate) + 1 / 30;