reframe-video 0.6.12 → 0.6.14

package/dist/bin.js

@@ -10,13 +10,14 @@ var __export = (target, all) => {
 };
 
 // ../core/src/ir.ts
-var DEFAULT_TO_DURATION, DEFAULT_TWEEN_DURATION, DEFAULT_MOTIONPATH_DURATION;
+var DEFAULT_TO_DURATION, DEFAULT_TWEEN_DURATION, DEFAULT_MOTIONPATH_DURATION, DEFAULT_STILL_DURATION;
 var init_ir = __esm({
   "../core/src/ir.ts"() {
     "use strict";
     DEFAULT_TO_DURATION = 0.5;
     DEFAULT_TWEEN_DURATION = 0.5;
     DEFAULT_MOTIONPATH_DURATION = 1;
+    DEFAULT_STILL_DURATION = 1;
   }
 });
 
@@ -319,14 +320,14 @@ function compileScene(ir) {
       }
     }
   };
-  const inferredEnd = ir.timeline ? walk(ir.timeline, 0) : 0;
+  const inferredEnd = (ir.timeline ? walk(ir.timeline, 0) : 0) || 0;
   for (const list of segments.values()) list.sort((a, b) => a.t0 - b.t0);
   for (const list of motionPaths.values()) list.sort((a, b) => a.t0 - b.t0);
   const hasCamera = !cameraIsNode && (ir.camera !== void 0 || motionPaths.has("camera") || [...segments.keys()].some((k) => k.startsWith("camera.")));
   const hasPerspective = !cameraIsNode && (ir.camera?.perspective !== void 0 || segments.has("camera.perspective"));
   return {
     ir,
-    duration: ir.duration ?? inferredEnd,
+    duration: ir.duration ?? (inferredEnd > 0 ? inferredEnd : DEFAULT_STILL_DURATION),
     segments,
     motionPaths,
     initialValues,
@@ -2706,6 +2707,7 @@ var ROOT2 = PACKAGED ? resolve6(HERE2, "..") : resolve6(HERE2, "..", "..", "..")
 var USER_CWD = process.env.INIT_CWD ?? process.cwd();
 var RENDER_CLI = PACKAGED ? join9(ROOT2, "dist", "cli.js") : join9(ROOT2, "packages", "render-cli", "src", "cli.ts");
 var LABELS = PACKAGED ? join9(ROOT2, "dist", "labels.js") : join9(ROOT2, "packages", "render-cli", "src", "labels.ts");
+var DIFF = PACKAGED ? join9(ROOT2, "dist", "diff.js") : join9(ROOT2, "packages", "render-cli", "src", "diff.ts");
 var PLAYER = PACKAGED ? join9(ROOT2, "dist", "player.js") : join9(ROOT2, "packages", "render-cli", "src", "player.ts");
 var ANALYZE = PACKAGED ? join9(ROOT2, "dist", "analyze.js") : join9(ROOT2, "benchmark", "harness", "motion", "analyze.ts");
 var TRACE = PACKAGED ? join9(ROOT2, "dist", "trace-cli.js") : join9(ROOT2, "benchmark", "harness", "motion", "trace-cli.ts");
@@ -2725,7 +2727,8 @@ usage:
   ${CMD} labels <scene.ts|.json>  print the event clock (label \u2192 exact seconds; for sound design / timing)
   ${CMD} motion <mp4|framesDir>  motion-profile a rendered clip
   ${CMD} trace <ref.mp4> [--apply scene.ts]  extract a video's motion structure \u2192 MotionSketch / timeline
-  ${CMD} guide [--regen]         print the scene-authoring guide (for you or your AI)
+  ${CMD} diff <ref-image> [<scene.ts>] [--t S] [--mode side|blend|diff|grid]  compare/measure a render against a reference image
+  ${CMD} guide [--regen|--directing]  print a guide (--regen: stable-address contract; --directing: high-end workflow)
   ${CMD} demo                    run the edit-survival demo (3 mp4s into out/)
 `;
 var userPath = (p) => isAbsolute5(p) ? p : resolve6(USER_CWD, p);
@@ -2841,10 +2844,16 @@ ${USAGE}`);
       }
       preflightFfmpeg();
       const outBase = PACKAGED ? join9(USER_CWD, "out") : join9(ROOT2, "out");
+      const stem = `${basename(input).replace(/\.[^.]+$/, "")}.mp4`;
       let outArgs = args;
-      if (!args.includes("-o")) {
+      const oIdx = args.indexOf("-o");
+      if (oIdx === -1) {
         await mkdir4(outBase, { recursive: true });
-        outArgs = [...args, "-o", join9(outBase, `${basename(input).replace(/\.[^.]+$/, "")}.mp4`)];
+        outArgs = [...args, "-o", join9(outBase, stem)];
+      } else if (args[oIdx + 1] && !args[oIdx + 1].startsWith("-") && !/\.\w{2,4}$/.test(args[oIdx + 1])) {
+        const dir = userPath(args[oIdx + 1]);
+        await mkdir4(dir, { recursive: true });
+        outArgs = args.map((a, i) => i === oIdx + 1 ? join9(dir, stem) : a);
       }
       outArgs = outArgs.map(
         (a, i) => outArgs[i - 1] === "--overlay" || outArgs[i - 1] === "-o" ? userPath(a) : a
@@ -3024,8 +3033,30 @@ ${results.length - failed} rendered (${orphaned} with orphans), ${failed} failed
         await (PACKAGED ? run2(process.execPath, [TRACE, userPath(input), ...args]) : run2("npx", ["tsx", TRACE, userPath(input), ...args]))
       );
     }
+    case "diff": {
+      const input = rest[0];
+      if (!input || input.startsWith("-")) {
+        fail(`usage: ${CMD} diff <ref-image> [<scene.ts>] [--t <sec>] [--mode side|blend|diff|grid] [-o out.png]`);
+      }
+      let seenScene = false;
+      const args = rest.map((a, i) => {
+        if (i === 0) return userPath(a);
+        if (rest[i - 1] === "-o") return userPath(a);
+        if (!a.startsWith("-") && rest[i - 1] !== "--t" && rest[i - 1] !== "--mode" && !seenScene) {
+          seenScene = true;
+          return userPath(a);
+        }
+        return a;
+      });
+      process.exit(
+        await (PACKAGED ? run2(process.execPath, [DIFF, ...args]) : run2("npx", ["tsx", DIFF, ...args]))
+      );
+    }
     case "guide": {
-      const file = rest.includes("--regen") ? PACKAGED ? join9(ROOT2, "guides", "regen-contract.md") : join9(ROOT2, "docs", "regen-contract.md") : PACKAGED ? join9(ROOT2, "guides", "edsl-guide.md") : join9(ROOT2, "benchmark", "guides", "edsl-guide.md");
+      const which = rest.includes("--regen") ? "regen" : rest.includes("--directing") ? "directing" : "edsl";
+      const repoFile = { regen: join9(ROOT2, "docs", "regen-contract.md"), directing: join9(ROOT2, "benchmark", "guides", "directing-guide.md"), edsl: join9(ROOT2, "benchmark", "guides", "edsl-guide.md") };
+      const pkgFile = { regen: join9(ROOT2, "guides", "regen-contract.md"), directing: join9(ROOT2, "guides", "directing-guide.md"), edsl: join9(ROOT2, "guides", "edsl-guide.md") };
+      const file = (PACKAGED ? pkgFile : repoFile)[which];
       const { readFile: readFile7 } = await import("node:fs/promises");
       process.stdout.write(await readFile7(file, "utf8"));
       return;

package/dist/browserEntry.js

@@ -4,6 +4,7 @@
   var DEFAULT_TO_DURATION = 0.5;
   var DEFAULT_TWEEN_DURATION = 0.5;
   var DEFAULT_MOTIONPATH_DURATION = 1;
+  var DEFAULT_STILL_DURATION = 1;
 
   // ../core/src/path.ts
   function pathBBox(d) {
@@ -316,14 +317,14 @@
         }
       }
     };
-    const inferredEnd = ir.timeline ? walk(ir.timeline, 0) : 0;
+    const inferredEnd = (ir.timeline ? walk(ir.timeline, 0) : 0) || 0;
     for (const list of segments.values()) list.sort((a, b) => a.t0 - b.t0);
     for (const list of motionPaths.values()) list.sort((a, b) => a.t0 - b.t0);
     const hasCamera = !cameraIsNode && (ir.camera !== void 0 || motionPaths.has("camera") || [...segments.keys()].some((k) => k.startsWith("camera.")));
     const hasPerspective = !cameraIsNode && (ir.camera?.perspective !== void 0 || segments.has("camera.perspective"));
     return {
       ir,
-      duration: ir.duration ?? inferredEnd,
+      duration: ir.duration ?? (inferredEnd > 0 ? inferredEnd : DEFAULT_STILL_DURATION),
       segments,
       motionPaths,
       initialValues,

package/dist/cli.js

@@ -10,6 +10,7 @@ var DEFAULT_CROSSFADE = 0.5;
 var DEFAULT_TO_DURATION = 0.5;
 var DEFAULT_TWEEN_DURATION = 0.5;
 var DEFAULT_MOTIONPATH_DURATION = 1;
+var DEFAULT_STILL_DURATION = 1;
 
 // ../core/src/path.ts
 function locate(segCount, u) {
@@ -306,14 +307,14 @@ function compileScene(ir) {
       }
     }
   };
-  const inferredEnd = ir.timeline ? walk(ir.timeline, 0) : 0;
+  const inferredEnd = (ir.timeline ? walk(ir.timeline, 0) : 0) || 0;
   for (const list of segments.values()) list.sort((a, b) => a.t0 - b.t0);
   for (const list of motionPaths.values()) list.sort((a, b) => a.t0 - b.t0);
   const hasCamera = !cameraIsNode && (ir.camera !== void 0 || motionPaths.has("camera") || [...segments.keys()].some((k) => k.startsWith("camera.")));
   const hasPerspective = !cameraIsNode && (ir.camera?.perspective !== void 0 || segments.has("camera.perspective"));
   return {
     ir,
-    duration: ir.duration ?? inferredEnd,
+    duration: ir.duration ?? (inferredEnd > 0 ? inferredEnd : DEFAULT_STILL_DURATION),
     segments,
     motionPaths,
     initialValues,