@vosjs/studio-core 0.30.1 → 0.30.3

package/dist/index.d.ts

@@ -301,9 +301,28 @@ interface RecordingMeta {
     dpr: number;
     /** page/browser zoom at capture. */
     zoom: number;
-    /** wall-clock origin (Date.now at first frame). */
+    /**
+     * Wall-clock origin (Date.now) of the take's timeline: the instant the
+     * recorder's `start()` was CALLED, which is where the file's first frame
+     * sits. Never the recorder's `start` EVENT — Chrome fires that from the
+     * muxer's first write, seconds late under load, and a t0 stamped there runs
+     * every cursor event ahead of the footage by that lag.
+     */
     t0: number;
+    /**
+     * The take's length in ACTIVE ms — the file's timeline, which a pause does
+     * not advance (MediaRecorder removes paused time from the file). Cursor
+     * event times live on the same timeline.
+     */
     durationMs: number;
+    /** Total ms the take was paused (removed from the file and from every `t`). Absent = none. */
+    pausedMs?: number;
+    /**
+     * Diagnostic: how long after the `start()` call the recorder's `start`
+     * event fired. A large value is the load the recorder was under; it is
+     * never used for alignment.
+     */
+    startEventDelayMs?: number;
     /** captured pixel dimensions. */
     width: number;
     height: number;
@@ -322,10 +341,11 @@ interface RecordingMeta {
      */
     hasMic?: boolean;
     /**
-     * Recorder start skew: wall-clock ms between the main recorder's start and
-     * the mic/cam sidecar recorders' starts (positive = sidecar started later).
-     * Lets the consume path trim/pad a sidecar head instead of assuming t0
-     * equality. Absent on takes without the matching sidecar.
+     * Recorder start skew: wall-clock ms between the main recorder's `start()`
+     * call and the mic/cam sidecar recorders' `start()` calls (positive =
+     * sidecar started later), each the zero of its own file. Lets the consume
+     * path trim/pad a sidecar head instead of assuming t0 equality. Absent on
+     * takes without the matching sidecar.
      */
     micT0DeltaMs?: number;
     camT0DeltaMs?: number;
@@ -2404,6 +2424,12 @@ interface PlanOptions {
     dragLevel?: number;
     /** emit spans with focusMode 'auto' (cursor-follow camera). */
     followByDefault?: boolean;
+    /**
+     * the footage's length in seconds: no span runs past it. The cursor
+     * track ends at the last event, before the footage does, so the track
+     * alone cannot say where the footage ends.
+     */
+    duration?: number;
     /** typing sessions plan spans. */
     typingZoom?: boolean;
     /** max silence between `key` pings before the typing session ends. */

package/dist/index.js

@@ -1749,8 +1749,10 @@ function planAutoZoom(track, options) {
     typingZoom = style.typingZoom,
     typingGap = style.typingGap,
     typingHold = style.typingHold,
-    typingMinLevel = style.typingMinLevel
+    typingMinLevel = style.typingMinLevel,
+    duration
   } = options;
+  const within = (spans2) => duration === void 0 ? spans2 : spans2.map((z) => ({ ...z, out: Math.min(z.out, round(duration)) })).filter((z) => z.out - z.in >= 0.3);
   const grouped = groupTrack(track, {
     width,
     height,
@@ -1870,12 +1872,14 @@ function planAutoZoom(track, options) {
     // the FIELD is the anchor, and a follow would be a no-op at best.
     source: "auto"
   }));
-  const spans = [...zSpans, ...kSpans, ...dragSpans].sort((a, b) => a.in - b.in);
+  const spans = within([...zSpans, ...kSpans, ...dragSpans]).sort(
+    (a, b) => a.in - b.in
+  );
   const dwells = dwellSpans(track, width, height, maxLevel, [
     ...spans,
     ...dragReserved
   ]);
-  return [...spans, ...dwells].sort((a, b) => a.in - b.in);
+  return within([...spans, ...dwells]).sort((a, b) => a.in - b.in);
 }
 function typingSessions(track, width, height, typingGap) {
   const pings = track.filter((e) => e.type === "key").map((e) => ({ t: e.t / 1e3, rect: e.rect, x: e.x, y: e.y }));