reframe-video 0.1.1 → 0.1.2

package/dist/analyze.js

@@ -155,6 +155,43 @@ async function* frameStream(source, opts) {
   if (pending.length !== 0) throw new Error(`trailing partial frame (${pending.length} bytes)`);
 }
 
+// ../../benchmark/harness/motion/grid.ts
+var DEFAULT_GRID = { cols: 8, rows: 5 };
+var cellOf = (x, y, w, h, spec) => {
+  const c = Math.min(spec.cols - 1, Math.floor(x * spec.cols / w));
+  const r = Math.min(spec.rows - 1, Math.floor(y * spec.rows / h));
+  return r * spec.cols + c;
+};
+function cellDiff(prev, next, w, h, spec) {
+  const n = spec.cols * spec.rows;
+  const sum = new Array(n).fill(0);
+  const cnt = new Array(n).fill(0);
+  for (let y = 0; y < h; y++) {
+    for (let x = 0; x < w; x++) {
+      const idx = cellOf(x, y, w, h, spec);
+      sum[idx] += Math.abs(next[y * w + x] - prev[y * w + x]);
+      cnt[idx]++;
+    }
+  }
+  return sum.map((s, i) => cnt[i] ? s / cnt[i] : 0);
+}
+function frameOccupancy(frame, w, h, spec) {
+  const n = spec.cols * spec.rows;
+  const sum = new Array(n).fill(0);
+  const cnt = new Array(n).fill(0);
+  for (let y = 0; y < h; y++) {
+    for (let x = 0; x < w; x++) {
+      const here = frame[y * w + x];
+      const gx = x + 1 < w ? Math.abs(frame[y * w + x + 1] - here) : 0;
+      const gy = y + 1 < h ? Math.abs(frame[(y + 1) * w + x] - here) : 0;
+      const idx = cellOf(x, y, w, h, spec);
+      sum[idx] += gx + gy;
+      cnt[idx]++;
+    }
+  }
+  return sum.map((s, i) => cnt[i] ? s / cnt[i] : 0);
+}
+
 // ../../benchmark/harness/motion/analyze.ts
 var ANALYSIS_WIDTH = 480;
 var ANALYSIS_HEIGHT = 270;
@@ -243,6 +280,7 @@ async function analyzeMotion(inputPath, opts = {}) {
     height: ANALYSIS_HEIGHT,
     ...opts.changedThreshold !== void 0 && { changedThreshold: opts.changedThreshold }
   };
+  const gridSpec = opts.grid ? typeof opts.grid === "object" ? opts.grid : DEFAULT_GRID : null;
   const source = await resolveSource(resolve(inputPath));
   const keys = [
     "blockSpeedMean",
@@ -256,13 +294,17 @@ async function analyzeMotion(inputPath, opts = {}) {
     "activeBlocks"
   ];
   const series = Object.fromEntries([...keys.map((k) => [k, []]), ["t", []]]);
+  const gridDiff = [];
+  const gridOcc = [];
   let prev = null;
   let pair = 0;
   for await (const frame of frameStream(source, blockOpts)) {
+    if (gridSpec) gridOcc.push(frameOccupancy(frame, ANALYSIS_WIDTH, ANALYSIS_HEIGHT, gridSpec));
     if (prev) {
       const stats = analyzePair(prev, frame, blockOpts);
       for (const k of keys) series[k].push(stats[k]);
       series.t.push((pair + 0.5) / fps);
+      if (gridSpec) gridDiff.push(cellDiff(prev, frame, ANALYSIS_WIDTH, ANALYSIS_HEIGHT, gridSpec));
       pair++;
     }
     prev = frame;
@@ -310,7 +352,8 @@ async function analyzeMotion(inputPath, opts = {}) {
       saturatedPairs: series.saturatedFraction.map((s, i) => s > 0.3 ? i : -1).filter((i) => i >= 0),
       diffPeriodicityHz: dominantPeriodicity(d, fps)
     },
-    segments
+    segments,
+    ...gridSpec && { grid: { spec: gridSpec, diff: gridDiff, occupancy: gridOcc } }
   };
 }
 async function main() {

package/dist/bin.js

@@ -10,16 +10,100 @@ var __export = (target, all) => {
 };
 
 // ../core/src/ir.ts
-var DEFAULT_TO_DURATION, DEFAULT_TWEEN_DURATION;
+var DEFAULT_TO_DURATION, DEFAULT_TWEEN_DURATION, DEFAULT_MOTIONPATH_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;
+  }
+});
+
+// ../core/src/path.ts
+function locate(segCount, u) {
+  if (segCount <= 0) return { i: 0, t: 0 };
+  const clamped = Math.max(0, Math.min(1, u));
+  const scaled = clamped * segCount;
+  let i = Math.floor(scaled);
+  if (i >= segCount) i = segCount - 1;
+  return { i, t: scaled - i };
+}
+function controls(points, closed, i) {
+  const n = points.length;
+  const at = (k) => {
+    if (closed) return points[(k % n + n) % n];
+    return points[Math.max(0, Math.min(n - 1, k))];
+  };
+  return [at(i - 1), at(i), at(i + 1), at(i + 2)];
+}
+function segCountOf(points, closed) {
+  const n = points.length;
+  if (n < 2) return 0;
+  return closed ? n : n - 1;
+}
+function pathPoint(points, closed, u) {
+  const n = points.length;
+  if (n === 0) return [0, 0];
+  if (n === 1) return [points[0][0], points[0][1]];
+  const segs = segCountOf(points, closed);
+  const { i, t } = locate(segs, u);
+  const [p0, p1, p2, p3] = controls(points, closed, i);
+  const t2 = t * t;
+  const t3 = t2 * t;
+  const f = (a, b, c, d) => 0.5 * (2 * b + (-a + c) * t + (2 * a - 5 * b + 4 * c - d) * t2 + (-a + 3 * b - 3 * c + d) * t3);
+  return [f(p0[0], p1[0], p2[0], p3[0]), f(p0[1], p1[1], p2[1], p3[1])];
+}
+function pathTangentAngle(points, closed, u) {
+  const n = points.length;
+  if (n < 2) return 0;
+  const segs = segCountOf(points, closed);
+  const { i, t } = locate(segs, u);
+  const [p0, p1, p2, p3] = controls(points, closed, i);
+  const t2 = t * t;
+  const d = (a, b, c, e) => 0.5 * (-a + c + 2 * (2 * a - 5 * b + 4 * c - e) * t + 3 * (-a + 3 * b - 3 * c + e) * t2);
+  const dx = d(p0[0], p1[0], p2[0], p3[0]);
+  const dy = d(p0[1], p1[1], p2[1], p3[1]);
+  if (dx === 0 && dy === 0) return 0;
+  return Math.atan2(dy, dx) * 180 / Math.PI;
+}
+var init_path = __esm({
+  "../core/src/path.ts"() {
+    "use strict";
   }
 });
 
 // ../core/src/compile.ts
+function scaleTimeline(tl, k) {
+  switch (tl.kind) {
+    case "seq":
+    case "par":
+      return { ...tl, children: tl.children.map((c) => scaleTimeline(c, k)) };
+    case "stagger":
+      return { ...tl, interval: tl.interval * k, children: tl.children.map((c) => scaleTimeline(c, k)) };
+    case "wait":
+      return { ...tl, duration: tl.duration * k };
+    case "tween":
+      return { ...tl, duration: (tl.duration ?? DEFAULT_TWEEN_DURATION) * k };
+    case "motionPath":
+      return { ...tl, duration: (tl.duration ?? DEFAULT_MOTIONPATH_DURATION) * k };
+    case "to":
+      return {
+        ...tl,
+        duration: (tl.duration ?? DEFAULT_TO_DURATION) * k,
+        ...tl.stagger !== void 0 && { stagger: tl.stagger * k }
+      };
+    case "beat":
+      return {
+        ...tl,
+        children: tl.children.map((c) => scaleTimeline(c, k)),
+        ...tl.gap !== void 0 && { gap: tl.gap * k }
+      };
+  }
+}
+function orderBeats(children) {
+  return children.map((c, i) => ({ c, i, key: c.kind === "beat" && c.order !== void 0 ? c.order : i })).sort((a, b) => a.key - b.key || a.i - b.i).map((x) => x.c);
+}
 function compileScene(ir) {
   const nodeById = /* @__PURE__ */ new Map();
   const nodeOrder = [];
@@ -48,6 +132,7 @@ function compileScene(ir) {
     }
   }
   const segments = /* @__PURE__ */ new Map();
+  const motionPaths = /* @__PURE__ */ new Map();
   const current = new Map(initialValues);
   const pushSegment = (seg) => {
     const k = key(seg.target, seg.prop);
@@ -64,6 +149,50 @@ function compileScene(ir) {
     throw new Error(`cannot animate "${prop}" of "${target}": no base value to start from`);
   };
   const labelTimes = /* @__PURE__ */ new Map();
+  const beatTimes = /* @__PURE__ */ new Map();
+  const durationOf = (tl, start) => {
+    switch (tl.kind) {
+      case "seq": {
+        let t = start;
+        for (const child of orderBeats(tl.children)) t = durationOf(child, t);
+        return t;
+      }
+      case "par": {
+        let end = start;
+        for (const child of tl.children) end = Math.max(end, durationOf(child, start));
+        return end;
+      }
+      case "stagger": {
+        let end = start;
+        tl.children.forEach((child, i) => {
+          end = Math.max(end, durationOf(child, start + i * tl.interval));
+        });
+        return end;
+      }
+      case "wait":
+        return start + tl.duration;
+      case "tween":
+        return start + (tl.duration ?? DEFAULT_TWEEN_DURATION);
+      case "motionPath":
+        return start + (tl.duration ?? DEFAULT_MOTIONPATH_DURATION);
+      case "to": {
+        const override = ir.states?.[tl.state] ?? {};
+        const duration = tl.duration ?? DEFAULT_TO_DURATION;
+        const si = tl.stagger ?? 0;
+        const targets = nodeOrder.filter(
+          (id) => id in override && (tl.filter === void 0 || tl.filter.includes(id))
+        );
+        return start + duration + Math.max(0, targets.length - 1) * si;
+      }
+      case "beat": {
+        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);
+        return beatStart + k * natural;
+      }
+    }
+  };
   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 });
@@ -73,9 +202,19 @@ function compileScene(ir) {
     switch (tl.kind) {
       case "seq": {
         let t = start;
-        for (const child of tl.children) t = walk(child, t);
+        for (const child of orderBeats(tl.children)) t = walk(child, t);
         return t;
       }
+      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 beatStart = tl.at ?? 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 });
+        return end;
+      }
       case "par": {
         let end = start;
         for (const child of tl.children) end = Math.max(end, walk(child, start));
@@ -105,6 +244,23 @@ function compileScene(ir) {
         }
         return start + duration;
       }
+      case "motionPath": {
+        const duration = tl.duration ?? DEFAULT_MOTIONPATH_DURATION;
+        const points = tl.points;
+        const closed = tl.closed ?? false;
+        const autoRotate = tl.autoRotate ?? false;
+        const rotateOffset = tl.rotateOffset ?? 0;
+        let list = motionPaths.get(tl.target);
+        if (!list) motionPaths.set(tl.target, list = []);
+        list.push({ t0: start, t1: start + duration, points, closed, autoRotate, rotateOffset, ...tl.ease !== void 0 && { ease: tl.ease } });
+        if (points.length > 0) {
+          const [ex, ey] = pathPoint(points, closed, 1);
+          current.set(key(tl.target, "x"), ex);
+          current.set(key(tl.target, "y"), ey);
+          if (autoRotate) current.set(key(tl.target, "rotation"), pathTangentAngle(points, closed, 1) + rotateOffset);
+        }
+        return start + duration;
+      }
       case "to": {
         const override = ir.states?.[tl.state] ?? {};
         const duration = tl.duration ?? DEFAULT_TO_DURATION;
@@ -133,14 +289,17 @@ function compileScene(ir) {
   };
   const inferredEnd = ir.timeline ? walk(ir.timeline, 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);
   return {
     ir,
     duration: ir.duration ?? inferredEnd,
     segments,
+    motionPaths,
     initialValues,
     nodeById,
     nodeOrder,
-    labelTimes
+    labelTimes,
+    beatTimes
   };
 }
 var key;
@@ -148,6 +307,7 @@ var init_compile = __esm({
   "../core/src/compile.ts"() {
     "use strict";
     init_ir();
+    init_path();
     key = (target, prop) => `${target}.${prop}`;
   }
 });
@@ -232,9 +392,39 @@ function validateScene(ir) {
           problems.push(`${path}: tween duration must be > 0`);
         }
         break;
+      case "motionPath": {
+        const node = nodeById.get(tl.target);
+        if (!node) {
+          problems.push(
+            `${path}: motionPath targets unknown node "${tl.target}" \u2014 known ids: ${[...nodeById.keys()].join(", ")}`
+          );
+        } else if (node.type === "line") {
+          problems.push(`${path}: motionPath cannot target a line (no x/y) \u2014 "${tl.target}"`);
+        }
+        if (tl.points.length < 1) problems.push(`${path}: motionPath "${tl.target}" needs at least 1 point`);
+        if (tl.duration !== void 0 && tl.duration <= 0) {
+          problems.push(`${path}: motionPath "${tl.target}" duration must be > 0`);
+        }
+        break;
+      }
       case "wait":
         if (tl.duration < 0) problems.push(`${path}: wait duration must be >= 0`);
         break;
+      case "beat":
+        if (labels.has(tl.name)) {
+          problems.push(
+            `${path}: duplicate timeline label "${tl.name}" (beat name) \u2014 labels are overlay addresses and must be unique`
+          );
+        }
+        labels.add(tl.name);
+        if (tl.duration !== void 0 && tl.duration <= 0) {
+          problems.push(`${path}: beat "${tl.name}" duration must be > 0`);
+        }
+        if (tl.scale !== void 0 && tl.scale <= 0) {
+          problems.push(`${path}: beat "${tl.name}" scale must be > 0`);
+        }
+        tl.children.forEach((c, i) => checkTimeline(c, `${path}.beat(${tl.name})[${i}]`));
+        break;
     }
   };
   if (ir.timeline) checkTimeline(ir.timeline, "timeline");
@@ -284,6 +474,7 @@ var init_validate = __esm({
       line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress"],
       text: [...COMMON_PROPS, "content", "contentDecimals", "fontFamily", "fontSize", "fontWeight", "fill", "letterSpacing"],
       image: [...COMMON_PROPS, "src", "width", "height"],
+      path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],
       group: COMMON_PROPS
     };
     SceneValidationError = class extends Error {
@@ -430,13 +621,16 @@ function applyOverlay(ir, overlay, layer, report) {
     const byLabel = /* @__PURE__ */ new Map();
     const walkTimeline = (tl) => {
       if ("label" in tl && tl.label !== void 0) byLabel.set(tl.label, tl);
+      if (tl.kind === "beat") byLabel.set(tl.name, tl);
       if ("children" in tl) tl.children.forEach(walkTimeline);
     };
     if (ir.timeline) walkTimeline(ir.timeline);
     const PATCHABLE = {
       to: ["duration", "ease", "stagger"],
       tween: ["duration", "ease"],
-      wait: ["duration"]
+      wait: ["duration"],
+      motionPath: ["points", "duration", "ease"],
+      beat: ["at", "gap", "scale", "duration", "order"]
     };
     let timingPatched = false;
     for (const [label, patch] of Object.entries(overlay.timeline)) {
@@ -460,7 +654,7 @@ function applyOverlay(ir, overlay, layer, report) {
         }
         step[key2] = value;
         applied(`timeline.${label}.${key2}`, "set");
-        if (key2 === "duration" || key2 === "stagger") timingPatched = true;
+        if (["duration", "stagger", "at", "gap", "scale", "order"].includes(key2)) timingPatched = true;
       }
     }
     if (timingPatched && overlay.scene?.duration === void 0) {
@@ -484,6 +678,16 @@ var init_compose = __esm({
   }
 });
 
+// ../core/src/presets.ts
+var SET;
+var init_presets = __esm({
+  "../core/src/presets.ts"() {
+    "use strict";
+    init_dsl();
+    SET = 1 / 120;
+  }
+});
+
 // ../core/src/audio.ts
 function resolveAudioPlan(compiled) {
   const audio = compiled.ir.audio;
@@ -569,10 +773,23 @@ var init_behaviors = __esm({
 });
 
 // ../core/src/interpolate.ts
-var EASE_TABLE, EASE_NAMES;
+function easeOutBounce(u) {
+  const n1 = 7.5625;
+  const d1 = 2.75;
+  if (u < 1 / d1) return n1 * u * u;
+  if (u < 2 / d1) return n1 * (u -= 1.5 / d1) * u + 0.75;
+  if (u < 2.5 / d1) return n1 * (u -= 2.25 / d1) * u + 0.9375;
+  return n1 * (u -= 2.625 / d1) * u + 0.984375;
+}
+var BACK_C1, BACK_C2, BACK_C3, ELASTIC_C4, ELASTIC_C5, EASE_TABLE, EASE_NAMES;
 var init_interpolate = __esm({
   "../core/src/interpolate.ts"() {
     "use strict";
+    BACK_C1 = 1.70158;
+    BACK_C2 = BACK_C1 * 1.525;
+    BACK_C3 = BACK_C1 + 1;
+    ELASTIC_C4 = 2 * Math.PI / 3;
+    ELASTIC_C5 = 2 * Math.PI / 4.5;
     EASE_TABLE = {
       linear: (u) => u,
       easeInQuad: (u) => u * u,
@@ -586,7 +803,20 @@ var init_interpolate = __esm({
       easeInOutQuart: (u) => u < 0.5 ? 8 * u ** 4 : 1 - (-2 * u + 2) ** 4 / 2,
       easeInExpo: (u) => u === 0 ? 0 : 2 ** (10 * u - 10),
       easeOutExpo: (u) => u === 1 ? 1 : 1 - 2 ** (-10 * u),
-      easeInOutExpo: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? 2 ** (20 * u - 10) / 2 : (2 - 2 ** (-20 * u + 10)) / 2
+      easeInOutExpo: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? 2 ** (20 * u - 10) / 2 : (2 - 2 ** (-20 * u + 10)) / 2,
+      // --- expressive eases (GSAP's signature feel) — standard Penner equations ---
+      // back: overshoots past the target then settles (pop / snap)
+      easeInBack: (u) => BACK_C3 * u ** 3 - BACK_C1 * u * u,
+      easeOutBack: (u) => 1 + BACK_C3 * (u - 1) ** 3 + BACK_C1 * (u - 1) ** 2,
+      easeInOutBack: (u) => u < 0.5 ? (2 * u) ** 2 * ((BACK_C2 + 1) * 2 * u - BACK_C2) / 2 : ((2 * u - 2) ** 2 * ((BACK_C2 + 1) * (2 * u - 2) + BACK_C2) + 2) / 2,
+      // elastic: rings around the target before settling (playful spring)
+      easeInElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : -(2 ** (10 * u - 10)) * Math.sin((u * 10 - 10.75) * ELASTIC_C4),
+      easeOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : 2 ** (-10 * u) * Math.sin((u * 10 - 0.75) * ELASTIC_C4) + 1,
+      easeInOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? -(2 ** (20 * u - 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5)) / 2 : 2 ** (-20 * u + 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5) / 2 + 1,
+      // bounce: drops and bounces to rest (lands without overshoot)
+      easeInBounce: (u) => 1 - easeOutBounce(1 - u),
+      easeOutBounce,
+      easeInOutBounce: (u) => u < 0.5 ? (1 - easeOutBounce(1 - 2 * u)) / 2 : (1 + easeOutBounce(2 * u - 1)) / 2
     };
     EASE_NAMES = Object.keys(EASE_TABLE);
   }
@@ -598,6 +828,7 @@ var init_evaluate = __esm({
     "use strict";
     init_behaviors();
     init_interpolate();
+    init_path();
   }
 });
 
@@ -638,6 +869,14 @@ var init_assets = __esm({
   }
 });
 
+// ../core/src/motion.ts
+var init_motion = __esm({
+  "../core/src/motion.ts"() {
+    "use strict";
+    init_dsl();
+  }
+});
+
 // ../core/src/index.ts
 var init_src = __esm({
   "../core/src/index.ts"() {
@@ -647,11 +886,14 @@ var init_src = __esm({
     init_validate();
     init_compose();
     init_compile();
+    init_path();
+    init_presets();
     init_audio();
     init_evaluate();
     init_interpolate();
     init_behaviors();
     init_assets();
+    init_motion();
   }
 });
 
@@ -1500,6 +1742,7 @@ var ROOT2 = PACKAGED ? resolve4(HERE2, "..") : resolve4(HERE2, "..", "..", "..")
 var USER_CWD = process.env.INIT_CWD ?? process.cwd();
 var RENDER_CLI = PACKAGED ? join6(ROOT2, "dist", "cli.js") : join6(ROOT2, "packages", "render-cli", "src", "cli.ts");
 var ANALYZE = PACKAGED ? join6(ROOT2, "dist", "analyze.js") : join6(ROOT2, "benchmark", "harness", "motion", "analyze.ts");
+var TRACE = PACKAGED ? join6(ROOT2, "dist", "trace-cli.js") : join6(ROOT2, "benchmark", "harness", "motion", "trace-cli.ts");
 var CMD = PACKAGED ? "reframe" : "pnpm reframe";
 var USAGE = `reframe \u2014 declarative motion graphics
 
@@ -1509,6 +1752,7 @@ usage:
   ${CMD} preview                 open the scrub/edit UI (lists scenes in your directory)
   ${CMD} new <scene-name>        scaffold <scene-name>.ts in your directory
   ${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} demo                    run the edit-survival demo (3 mp4s into out/)
 `;
@@ -1731,6 +1975,17 @@ ${results.length - failed} rendered (${orphaned} with orphans), ${failed} failed
         await (PACKAGED ? run(process.execPath, [ANALYZE, userPath(input), ...rest.slice(1)]) : run("npx", ["tsx", ANALYZE, userPath(input), ...rest.slice(1)]))
       );
     }
+    case "trace": {
+      const input = rest[0];
+      if (!input || input.startsWith("-")) fail(`usage: ${CMD} trace <ref.mp4> [--apply scene.ts] [-o out.json]`);
+      preflightFfmpeg();
+      const args = rest.slice(1).map(
+        (a, i) => rest.slice(1)[i - 1] === "--apply" || rest.slice(1)[i - 1] === "-o" ? userPath(a) : a
+      );
+      process.exit(
+        await (PACKAGED ? run(process.execPath, [TRACE, userPath(input), ...args]) : run("npx", ["tsx", TRACE, userPath(input), ...args]))
+      );
+    }
     case "guide": {
       const file = rest.includes("--regen") ? PACKAGED ? join6(ROOT2, "guides", "regen-contract.md") : join6(ROOT2, "docs", "regen-contract.md") : PACKAGED ? join6(ROOT2, "guides", "edsl-guide.md") : join6(ROOT2, "benchmark", "guides", "edsl-guide.md");
       const { readFile: readFile5 } = await import("node:fs/promises");