@vosjs/studio-core 0.25.0 → 0.26.0

package/dist/index.js

@@ -1260,362 +1260,226 @@ function outputEnd(doc, footageEnd) {
   return Math.max(footageEnd, lastLayerEnd(doc));
 }
 
-// src/docVersion.ts
-var DOC_SCHEMA_VERSION = 4;
-function migrateHostedDoc(raw) {
-  const version = typeof raw.docSchemaVersion === "number" ? raw.docSchemaVersion : 0;
-  if (version >= DOC_SCHEMA_VERSION) return raw;
-  let doc = raw;
-  if (version < 4 && doc.source && typeof doc.source === "object") {
-    doc = migrateMotion(doc);
-  }
-  return { ...doc, docSchemaVersion: DOC_SCHEMA_VERSION };
-}
-
-// src/doc/studioDoc.ts
-var anchorKindOf = (doc) => "source" in doc ? "recording" : "program";
-var isRecordingDoc = (doc) => "source" in doc;
-var isProgramDoc = (doc) => !("source" in doc);
-function programDuration(doc) {
-  const own = doc.program.duration;
-  if (typeof own === "number" && own > 0) return own;
-  const cfg = doc.program.config.duration;
-  return typeof cfg === "number" && cfg > 0 ? cfg : 0;
-}
-function anchorSourceDuration(doc) {
-  return isRecordingDoc(doc) ? doc.source.meta.durationMs / 1e3 : programDuration(doc);
-}
-
-// src/planner/smoothing.ts
-var SNAP_BEFORE = 0.12;
-var SNAP_AFTER = 0.18;
-var SNAP_GAIN = 0.5;
-function sampleAt(points, t) {
-  if (points.length === 0) return { x: 0, y: 0 };
-  if (t <= points[0].t) return { x: points[0].x, y: points[0].y };
-  const last = points[points.length - 1];
-  if (t >= last.t) return { x: last.x, y: last.y };
-  for (let i = 1; i < points.length; i++) {
-    if (points[i].t >= t) {
-      const a = points[i - 1];
-      const b = points[i];
-      const f = (t - a.t) / (b.t - a.t || 1);
-      return { x: a.x + (b.x - a.x) * f, y: a.y + (b.y - a.y) * f };
-    }
-  }
-  return { x: last.x, y: last.y };
-}
-function smoothCursor(track, options = {}) {
-  const factor = clamp2(options.factor ?? 0.15, 0.01, 1);
-  const fps = options.fps ?? 60;
-  const raw = track.filter((e) => e.type === "move" || e.type === "down" || e.type === "up").map((e) => ({ t: e.t / 1e3, x: e.x, y: e.y }));
-  if (raw.length === 0) return [];
-  const clicks = options.clickSnap ? track.filter((e) => e.type === "down").map((e) => ({ t: e.t / 1e3, x: e.x, y: e.y })) : [];
-  const start = raw[0].t;
-  const end = raw[raw.length - 1].t;
-  const step = 1 / fps;
-  const out = [];
-  let cx = raw[0].x;
-  let cy = raw[0].y;
-  let ci = 0;
-  for (let t = start; t <= end + 1e-9; t += step) {
-    const target = sampleAt(raw, t);
-    cx += (target.x - cx) * factor;
-    cy += (target.y - cy) * factor;
-    if (clicks.length) {
-      while (ci < clicks.length - 1 && t > clicks[ci].t + SNAP_AFTER) ci++;
-      const ck = clicks[ci];
-      const u = clamp2(
-        (t - (ck.t - SNAP_BEFORE)) / SNAP_BEFORE,
-        0,
-        t <= ck.t + SNAP_AFTER ? 1 : 0
-      );
-      const w = u * u * (3 - 2 * u) * SNAP_GAIN;
-      if (w > 0) {
-        cx += (ck.x - cx) * w;
-        cy += (ck.y - cy) * w;
-      }
-    }
-    out.push({ t, x: cx, y: cy });
-  }
-  return out;
-}
-function clamp2(v, lo, hi) {
-  return Math.max(lo, Math.min(hi, v));
-}
-
 // src/zoomStyle.ts
-var ZOOM_STYLES = {
-  // Cursorful strategy — one steady zoom per activity session, travel by pans.
-  // The camera's timing was measured against a Cursorful take of the same
-  // steps: a zoom-in of ~0.55 s on a heavy ease-out (most of the move in
-  // the first quarter second, a long settle), a zoom-out of ~0.45 s, and
-  // holds of four to five seconds per beat. The old 1.1 s ramp started
-  // 0.75 s BEFORE the click and landed 0.35 s after it, so the frame was
-  // moving more of the time than it was resting.
-  glide: {
-    autoZoom: true,
-    clusterGap: 3,
-    minClusterClicks: 1,
-    targetFill: 0.42,
-    minLevel: 1.3,
-    maxLevel: 1.8,
-    dragLevel: 1.5,
-    lead: 0.35,
-    hold: 1.2,
-    followByDefault: true,
-    typingZoom: true,
-    typingGap: 2.5,
-    typingHold: 1.1,
-    typingMinLevel: 1.4,
+var RETIRED_ZOOM_STYLES = {
+  keynote: { style: "glide", tilt: "medium" },
+  drift: { style: "cinema", tilt: "subtle" }
+};
+function liveZoomStyleName(name) {
+  if (!name) return null;
+  if (name in ZOOM_STYLES) return name;
+  return RETIRED_ZOOM_STYLES[name]?.style ?? null;
+}
+var PUMP_REST = 1;
+function pumpFreeChainGap(p) {
+  return p.rampOut + (p.rampIn - p.rampInOverlap) + PUMP_REST;
+}
+var glide = {
+  autoZoom: true,
+  clusterGap: 3,
+  minClusterClicks: 1,
+  targetFill: 0.42,
+  minLevel: 1.3,
+  maxLevel: 1.8,
+  dragLevel: 1.5,
+  lead: 0.35,
+  hold: 1.2,
+  followByDefault: true,
+  typingZoom: true,
+  typingGap: 2.5,
+  typingHold: 1.1,
+  typingMinLevel: 1.4,
+  rampIn: 0.6,
+  rampInOverlap: 0.2,
+  rampOut: 0.5,
+  chainGap: 3,
+  pan: 0.55,
+  // The reference's corner trace at 60 fps: a quarter of the move by a
+  // fifth of the time, two thirds by half, nine tenths by three
+  // quarters, over ~0.6 s. Fitted against those three points,
+  // (0.36, 0, 0.4, 1) is the closest cubic (15 / 64 / 93 %; half the
+  // move at ~245 ms and 90 % at ~425 ms at 0.6 s): a gentle start and a
+  // long settle. CSS ease (0.25, 0.1, 0.25, 1) reached the midpoint
+  // 70 ms earlier and read a touch fast; (0.16, 1, 0.3, 1) put half the
+  // move in the first sixty milliseconds and read as a twitch.
+  ease: "css-bezier(0.36, 0, 0.4, 1)",
+  panEase: "css-bezier(0.36, 0, 0.4, 1)",
+  followSafeRatio: 0.45,
+  followRecenter: 0.55,
+  followLookahead: 0.4,
+  tilt: {
+    intensity: "off",
     rampIn: 0.6,
-    rampInOverlap: 0.2,
     rampOut: 0.5,
     chainGap: 3,
-    pan: 0.55,
-    // The reference's corner trace at 60 fps: a quarter of the move by a
-    // fifth of the time, two thirds by half, nine tenths by three
-    // quarters, over ~0.6 s. Fitted against those three points,
-    // (0.36, 0, 0.4, 1) is the closest cubic (15 / 64 / 93 %; half the
-    // move at ~245 ms and 90 % at ~425 ms at 0.6 s): a gentle start and a
-    // long settle. CSS ease (0.25, 0.1, 0.25, 1) reached the midpoint
-    // 70 ms earlier and read a touch fast; (0.16, 1, 0.3, 1) put half the
-    // move in the first sixty milliseconds and read as a twitch.
-    ease: "css-bezier(0.36, 0, 0.4, 1)",
-    panEase: "css-bezier(0.36, 0, 0.4, 1)",
-    followSafeRatio: 0.45,
-    followRecenter: 0.55,
-    followLookahead: 0.4,
-    tilt: { intensity: "off" }
-  },
-  // Screen Studio "Focused" / Recordly — block zooms, spring-settled, readable.
+    pan: 0.55
+  }
+};
+var ZOOM_STYLES = {
+  glide,
+  // Screen Studio "Focused" / Recordly — a block per click, framed and
+  // released, no travel. The spring-settled family ease (near-linear onset,
+  // long settle) at the default's tempo: 0.8 s in, 0.65 s out, and a beat
+  // of 1.5 s after the click so the block is read before it goes. At its
+  // 2026-07 timing (1.4 s in, 1.0 s out around a 1.35 s span) a lone click
+  // spent 74% of its beat moving and every dwell or sped-up click was
+  // shorter than the ramp, which the lowering compressed into a cut.
   focus: {
     autoZoom: true,
-    clusterGap: 1.2,
+    clusterGap: 1.5,
     minClusterClicks: 1,
     targetFill: 0.5,
-    minLevel: 1.5,
-    maxLevel: 2.2,
-    dragLevel: 1.7,
+    minLevel: 1.4,
+    maxLevel: 2,
+    dragLevel: 1.6,
     lead: 0.35,
-    hold: 1,
+    hold: 1.5,
     followByDefault: false,
     typingZoom: true,
     typingGap: 2,
-    typingHold: 1.2,
-    typingMinLevel: 1.6,
-    rampIn: 1.4,
-    rampInOverlap: 0.5,
-    rampOut: 1,
-    chainGap: 1.35,
-    pan: 1,
+    typingHold: 1.3,
+    typingMinLevel: 1.5,
+    rampIn: 0.8,
+    rampInOverlap: 0.25,
+    rampOut: 0.65,
+    chainGap: 2.4,
+    pan: 0.7,
     ease: "css-bezier(0.28, 0.03, 0.09, 1)",
     panEase: "css-bezier(0.26, 0.08, 0.2, 1)",
     followSafeRatio: 0.5,
-    followRecenter: 0.6,
+    followRecenter: 0.55,
     followLookahead: 0,
-    tilt: { intensity: "off" }
+    tilt: {
+      intensity: "off",
+      rampIn: 0.8,
+      rampOut: 0.65,
+      chainGap: 2.4,
+      pan: 0.7
+    }
   },
-  // Screen Studio "Smooth" — slower, more fluid; creative content over reading.
+  // Screen Studio "Smooth" — the long-HOLD style: 1.2 s in, 1.0 s out,
+  // two-second holds, chains across 3.5 s so a slow clip travels rather
+  // than pumps, and the default's level range, because a watched clip
+  // wants the frame, not the magnifier. Its ramps still exceed a dwell or
+  // a sped-up click; the lowering fits them to the room.
   cinema: {
     autoZoom: true,
-    clusterGap: 1.8,
+    clusterGap: 2.4,
     minClusterClicks: 1,
-    targetFill: 0.45,
-    minLevel: 1.35,
-    maxLevel: 2,
+    targetFill: 0.42,
+    minLevel: 1.3,
+    maxLevel: 1.8,
     dragLevel: 1.5,
     lead: 0.6,
-    hold: 1.4,
+    hold: 2,
     followByDefault: true,
     typingZoom: true,
     typingGap: 3,
-    typingHold: 1.6,
-    typingMinLevel: 1.45,
-    rampIn: 1.8,
-    rampInOverlap: 0.55,
-    rampOut: 1.5,
-    chainGap: 2.2,
-    pan: 1.4,
+    typingHold: 1.8,
+    typingMinLevel: 1.4,
+    rampIn: 1.2,
+    rampInOverlap: 0.4,
+    rampOut: 1,
+    chainGap: 3.5,
+    pan: 1.1,
     ease: "css-bezier(0.33, 0, 0.15, 1)",
     panEase: "css-bezier(0.33, 0, 0.22, 1)",
     followSafeRatio: 0.6,
-    followRecenter: 1,
+    followRecenter: 0.9,
     followLookahead: 0.5,
-    tilt: { intensity: "off" }
+    tilt: {
+      intensity: "off",
+      rampIn: 1.2,
+      rampOut: 1,
+      chainGap: 3.5,
+      pan: 1.1
+    }
   },
-  // The studio's original pace with the instant-velocity onset defect fixed.
+  // The studio's original pace with the instant-velocity onset defect fixed:
+  // 0.4 s cycles on the onset-capped ease, the 2.5× ceiling of the 2026-07
+  // comparison's defect two brought to 2.2, a chain gap past its pump band.
   snappy: {
     autoZoom: true,
     clusterGap: 1.2,
     minClusterClicks: 1,
     targetFill: 0.5,
     minLevel: 1.4,
-    maxLevel: 2.5,
-    dragLevel: 1.7,
+    maxLevel: 2.2,
+    dragLevel: 1.6,
     lead: 0.25,
-    hold: 1,
+    hold: 1.2,
     followByDefault: false,
     typingZoom: true,
     typingGap: 1.6,
-    typingHold: 0.8,
+    typingHold: 0.9,
     typingMinLevel: 1.5,
-    rampIn: 0.7,
-    rampInOverlap: 0.3,
-    rampOut: 0.75,
-    chainGap: 1.5,
-    pan: 0.8,
+    rampIn: 0.4,
+    rampInOverlap: 0.15,
+    rampOut: 0.4,
+    chainGap: 2,
+    pan: 0.5,
     ease: "css-bezier(0.3, 0.55, 0.2, 1)",
     panEase: "css-bezier(0.25, 0.1, 0.25, 1)",
     followSafeRatio: 0.5,
-    followRecenter: 0.5,
+    followRecenter: 0.45,
     followLookahead: 0,
-    tilt: { intensity: "off" }
+    tilt: {
+      intensity: "off",
+      rampIn: 0.4,
+      rampOut: 0.4,
+      chainGap: 2,
+      pan: 0.5
+    }
   },
-  // Screen Studio's "instant zoom" — a cut-in (2–4 frames), tutorial tempo.
+  // Screen Studio's "instant zoom" — a cut-in (eight frames at 60 fps),
+  // tutorial tempo. Untouched in motion (the one style that never pumped
+  // and never left a ramp unsettled); the ceiling comes down with the
+  // others and the hold gains the beat a cut-in needs to be read.
   cut: {
     autoZoom: true,
     clusterGap: 1.2,
     minClusterClicks: 1,
     targetFill: 0.5,
-    minLevel: 1.5,
-    maxLevel: 2.2,
-    dragLevel: 1.7,
+    minLevel: 1.4,
+    maxLevel: 2,
+    dragLevel: 1.6,
     lead: 0.2,
-    hold: 1,
+    hold: 1.2,
     followByDefault: false,
     typingZoom: true,
     typingGap: 1.2,
     typingHold: 0.6,
-    typingMinLevel: 1.6,
+    typingMinLevel: 1.5,
     rampIn: 0.14,
     rampInOverlap: 0.07,
     rampOut: 0.14,
-    chainGap: 1.2,
+    chainGap: 1.3,
     pan: 0.35,
     ease: "css-bezier(0.2, 0, 0.4, 1)",
     panEase: "css-bezier(0.2, 0, 0.4, 1)",
     followSafeRatio: 0.5,
     followRecenter: 0.35,
     followLookahead: 0,
-    tilt: { intensity: "off" }
-  },
-  // Auto-zoom off (every competitor ships this switch). Camera params still
-  // apply to MANUAL spans — they get the default (glide) motion.
-  none: {
-    autoZoom: false,
-    clusterGap: 3,
-    minClusterClicks: 2,
-    targetFill: 0.42,
-    minLevel: 1.3,
-    maxLevel: 1.8,
-    dragLevel: 1.5,
-    lead: 0.5,
-    hold: 0.6,
-    followByDefault: false,
-    typingZoom: true,
-    typingGap: 2.5,
-    typingHold: 1.1,
-    typingMinLevel: 1.4,
-    rampIn: 1.1,
-    rampInOverlap: 0.35,
-    rampOut: 1,
-    chainGap: 2.5,
-    pan: 1,
-    ease: "css-bezier(0.26, 0, 0.16, 1)",
-    panEase: "css-bezier(0.3, 0, 0.2, 1)",
-    followSafeRatio: 0.45,
-    followRecenter: 0.8,
-    followLookahead: 0,
-    tilt: { intensity: "off" }
-  },
-  // ── tilt-forward styles — the camera moves in DEPTH too.
-  // Research note (2026-08-03): no competitor ships a document-wide personality
-  // driving BOTH auto-zoom dynamics and focus-following tilt from one name —
-  // FocuSee's Subtle/Default/Strong 3D Motion is a separate layered effect,
-  // TiltIt/ScreenDrift sell per-clip templates. These two own that space.
-  //
-  // "keynote": the launch-film sentence (the Apple register: rehearsed,
-  // restrained, one move per beat) — glide's session-merged, modest zooms plus
-  // a MEDIUM lean toward each zoom's focus, tilt ramps MATCHED to the zoom
-  // ramps so lean and zoom read as one camera move; chained so back-to-back
-  // beats swing pose-to-pose. Never oscillation, ±5..18° band.
-  keynote: {
-    autoZoom: true,
-    clusterGap: 3,
-    minClusterClicks: 1,
-    targetFill: 0.42,
-    minLevel: 1.3,
-    maxLevel: 1.8,
-    dragLevel: 1.5,
-    lead: 0.5,
-    hold: 0.7,
-    followByDefault: true,
-    typingZoom: true,
-    typingGap: 2.5,
-    typingHold: 1.2,
-    typingMinLevel: 1.4,
-    rampIn: 1.2,
-    rampInOverlap: 0.35,
-    rampOut: 1.1,
-    chainGap: 2.5,
-    pan: 1.1,
-    ease: "css-bezier(0.26, 0, 0.16, 1)",
-    panEase: "css-bezier(0.3, 0, 0.2, 1)",
-    followSafeRatio: 0.45,
-    followRecenter: 0.8,
-    followLookahead: 0.4,
-    // Lean lands WITH the zoom (matched ramps read as one camera move).
     tilt: {
-      intensity: "medium",
-      rampIn: 1.2,
-      rampOut: 1.1,
-      chainGap: 2.5,
-      pan: 1.1
+      intensity: "off",
+      rampIn: 0.3,
+      rampOut: 0.3,
+      chainGap: 1.3,
+      pan: 0.35
     }
   },
-  // "drift": calm ambient depth — cinema's slow, fluid blocks with a SUBTLE
-  // lean that eases in over ~1.6s and lingers (long chain gap keeps the card
-  // from flattening between nearby beats). For watched-not-read content:
-  // launch films, portfolio clips, hero loops.
-  drift: {
-    autoZoom: true,
-    clusterGap: 1.8,
-    minClusterClicks: 1,
-    targetFill: 0.45,
-    minLevel: 1.35,
-    maxLevel: 2,
-    dragLevel: 1.5,
-    lead: 0.6,
-    hold: 1.4,
-    followByDefault: true,
-    typingZoom: true,
-    typingGap: 3,
-    typingHold: 1.6,
-    typingMinLevel: 1.45,
-    rampIn: 1.8,
-    rampInOverlap: 0.55,
-    rampOut: 1.5,
-    chainGap: 2.2,
-    pan: 1.4,
-    ease: "css-bezier(0.33, 0, 0.15, 1)",
-    panEase: "css-bezier(0.33, 0, 0.22, 1)",
-    followSafeRatio: 0.6,
-    followRecenter: 1,
-    followLookahead: 0.5,
-    tilt: {
-      intensity: "subtle",
-      rampIn: 1.6,
-      rampOut: 1.4,
-      chainGap: 3,
-      pan: 1.4
-    }
-  }
+  // Auto-zoom off (every competitor ships this switch). Camera params still
+  // apply to MANUAL spans — they move the way the default camera moves
+  // TODAY (spelled as a spread, never a copy that fossilises).
+  none: { ...glide, autoZoom: false }
 };
 var DEFAULT_ZOOM_STYLE = "glide";
 function resolveZoomStyle(name, overrides) {
-  const params = name ? ZOOM_STYLES[name] : void 0;
-  return { ...params ?? ZOOM_STYLES[DEFAULT_ZOOM_STYLE], ...overrides };
+  const live = liveZoomStyleName(name) ?? DEFAULT_ZOOM_STYLE;
+  const params = { ...ZOOM_STYLES[live], ...overrides };
+  const floor = pumpFreeChainGap(params);
+  if (params.chainGap < floor) params.chainGap = floor;
+  return params;
 }
 var ZOOM_STYLE_OPTIONS = [
   {
@@ -1623,22 +1487,16 @@ var ZOOM_STYLE_OPTIONS = [
     label: "Glide",
     hint: "One steady zoom that travels between clicks"
   },
-  {
-    name: "keynote",
-    label: "Keynote",
-    hint: "Gliding zooms that lean toward each focus"
-  },
-  {
-    name: "drift",
-    label: "Drift",
-    hint: "Slow, fluid moves with a subtle ambient lean"
-  },
   {
     name: "focus",
     label: "Focus",
-    hint: "A zoom per click cluster, settles fast"
+    hint: "A zoom per click, framed and released"
+  },
+  {
+    name: "cinema",
+    label: "Cinema",
+    hint: "Slow moves and long holds, for content that is watched"
   },
-  { name: "cinema", label: "Cinema", hint: "Slow, fluid camera moves" },
   { name: "snappy", label: "Snappy", hint: "Quick, energetic zoom cycles" },
   { name: "cut", label: "Cut", hint: "Instant zooms, no glide" },
   {
@@ -1648,6 +1506,102 @@ var ZOOM_STYLE_OPTIONS = [
   }
 ];
 
+// src/docVersion.ts
+var DOC_SCHEMA_VERSION = 5;
+function migrateHostedDoc(raw) {
+  const version = typeof raw.docSchemaVersion === "number" ? raw.docSchemaVersion : 0;
+  if (version >= DOC_SCHEMA_VERSION) return raw;
+  let doc = raw;
+  if (version < 4 && doc.source && typeof doc.source === "object") {
+    doc = migrateMotion(doc);
+  }
+  if (version < 5) doc = migrateZoomStyle(doc);
+  return { ...doc, docSchemaVersion: DOC_SCHEMA_VERSION };
+}
+function migrateZoomStyle(doc) {
+  const name = doc.zoomStyle;
+  if (typeof name !== "string") return doc;
+  const retired = RETIRED_ZOOM_STYLES[name];
+  if (!retired) return doc;
+  return {
+    ...doc,
+    zoomStyle: retired.style,
+    tiltStyle: doc.tiltStyle ?? retired.tilt
+  };
+}
+
+// src/doc/studioDoc.ts
+var anchorKindOf = (doc) => "source" in doc ? "recording" : "program";
+var isRecordingDoc = (doc) => "source" in doc;
+var isProgramDoc = (doc) => !("source" in doc);
+function programDuration(doc) {
+  const own = doc.program.duration;
+  if (typeof own === "number" && own > 0) return own;
+  const cfg = doc.program.config.duration;
+  return typeof cfg === "number" && cfg > 0 ? cfg : 0;
+}
+function anchorSourceDuration(doc) {
+  return isRecordingDoc(doc) ? doc.source.meta.durationMs / 1e3 : programDuration(doc);
+}
+
+// src/planner/smoothing.ts
+var SNAP_BEFORE = 0.12;
+var SNAP_AFTER = 0.18;
+var SNAP_GAIN = 0.5;
+function sampleAt(points, t) {
+  if (points.length === 0) return { x: 0, y: 0 };
+  if (t <= points[0].t) return { x: points[0].x, y: points[0].y };
+  const last = points[points.length - 1];
+  if (t >= last.t) return { x: last.x, y: last.y };
+  for (let i = 1; i < points.length; i++) {
+    if (points[i].t >= t) {
+      const a = points[i - 1];
+      const b = points[i];
+      const f = (t - a.t) / (b.t - a.t || 1);
+      return { x: a.x + (b.x - a.x) * f, y: a.y + (b.y - a.y) * f };
+    }
+  }
+  return { x: last.x, y: last.y };
+}
+function smoothCursor(track, options = {}) {
+  const factor = clamp2(options.factor ?? 0.15, 0.01, 1);
+  const fps = options.fps ?? 60;
+  const raw = track.filter((e) => e.type === "move" || e.type === "down" || e.type === "up").map((e) => ({ t: e.t / 1e3, x: e.x, y: e.y }));
+  if (raw.length === 0) return [];
+  const clicks = options.clickSnap ? track.filter((e) => e.type === "down").map((e) => ({ t: e.t / 1e3, x: e.x, y: e.y })) : [];
+  const start = raw[0].t;
+  const end = raw[raw.length - 1].t;
+  const step = 1 / fps;
+  const out = [];
+  let cx = raw[0].x;
+  let cy = raw[0].y;
+  let ci = 0;
+  for (let t = start; t <= end + 1e-9; t += step) {
+    const target = sampleAt(raw, t);
+    cx += (target.x - cx) * factor;
+    cy += (target.y - cy) * factor;
+    if (clicks.length) {
+      while (ci < clicks.length - 1 && t > clicks[ci].t + SNAP_AFTER) ci++;
+      const ck = clicks[ci];
+      const u = clamp2(
+        (t - (ck.t - SNAP_BEFORE)) / SNAP_BEFORE,
+        0,
+        t <= ck.t + SNAP_AFTER ? 1 : 0
+      );
+      const w = u * u * (3 - 2 * u) * SNAP_GAIN;
+      if (w > 0) {
+        cx += (ck.x - cx) * w;
+        cy += (ck.y - cy) * w;
+      }
+    }
+    out.push({ t, x: cx, y: cy });
+  }
+  return out;
+}
+function clamp2(v, lo, hi) {
+  return Math.max(lo, Math.min(hi, v));
+}
+
 // src/planner/autoZoom.ts
 var DWELL_MOVE_FRAC = 0.02;
 var DWELL_MIN = 0.45;
@@ -1924,7 +1878,8 @@ function dwellSpans(track, width, height, maxLevel, reserved) {
     if (!breaks) continue;
     const endT = i < moves.length ? moves[i].t : trackEnd;
     const dur = endT - moves[start].t;
-    if (dur >= DWELL_MIN && dur <= DWELL_MAX) {
+    const opening = start === 0;
+    if (!opening && dur >= DWELL_MIN && dur <= DWELL_MAX) {
       const run = moves.slice(start, i);
       candidates.push({
         center: (moves[start].t + endT) / 2,
@@ -5269,6 +5224,13 @@ function spanOutputExtent(segments, sIn, sOut, media) {
 function spanEase(ease, fallback) {
   return ease && ease in EASINGS ? ease : fallback;
 }
+var RAMP_FLOOR = 0.14;
+function rampLanding(start, startWanted, duration, spanEnd) {
+  if (Math.abs(start - startWanted) < 1e-9) return start + duration;
+  const landWanted = startWanted + duration;
+  const landFull = Math.min(start + duration, spanEnd);
+  return Math.max(start + RAMP_FLOOR, landWanted, landFull);
+}
 function trackEmitter() {
   const keyframes = [];
   const push2 = (t, value, ease) => {
@@ -5297,17 +5259,19 @@ function zoomTrackFromDoc(zoom, segments, style = ZOOM_STYLES[DEFAULT_ZOOM_STYLE
     let cur = entry;
     const m = transitionMult(z.transition);
     if (!chained) {
-      const start = push2(
-        tIn - (style.rampIn - style.rampInOverlap) * m,
-        [1, z.cx, z.cy, 0],
-        "none"
+      const startWanted = tIn - (style.rampIn - style.rampInOverlap) * m;
+      const start = push2(startWanted, [1, z.cx, z.cy, 0], "none");
+      push2(
+        rampLanding(start, startWanted, style.rampIn * m, tOut),
+        entry,
+        spanEase(z.ease, style.ease)
       );
-      push2(start + style.rampIn * m, entry, spanEase(z.ease, style.ease));
     }
     let inPath = false;
     for (const e of z.followEvents ?? []) {
       const eOut = sourceToTimeline(segments, e.t);
       if (eOut === null || eOut <= tIn || eOut >= tOut) continue;
+      if (eOut - tIn < RAMP_FLOOR || tOut - eOut < RAMP_FLOOR) continue;
       const next2 = [cur[0], e.cx, e.cy, 1];
       if (e.path) {
         if (!inPath) {
@@ -5330,9 +5294,12 @@ function zoomTrackFromDoc(zoom, segments, style = ZOOM_STYLES[DEFAULT_ZOOM_STYLE
       const mNext = transitionMult(next.z.transition);
       const nextValue = [clampZoomLevel(next.z.level), next.z.cx, next.z.cy, 1];
       push2(
-        Math.min(
-          tOut + style.pan * mNext,
-          next.tIn + style.rampInOverlap * mNext
+        Math.max(
+          tOut + RAMP_FLOOR,
+          Math.min(
+            tOut + style.pan * mNext,
+            next.tIn + style.rampInOverlap * mNext
+          )
         ),
         nextValue,
         panEase
@@ -5370,15 +5337,23 @@ function tiltTrackFromDoc(tilt, segments, motion = {}) {
     const pose = [clampTiltDeg(z.rx), clampTiltDeg(z.ry)];
     const m = transitionMult(z.transition);
     if (!chained) {
-      const start = push2(tIn - rampInDur * m, rest, "none");
-      push2(start + rampInDur * m, pose, spanEase(z.ease, TILT_EASE));
+      const startWanted = tIn - rampInDur * m;
+      const start = push2(startWanted, rest, "none");
+      push2(
+        rampLanding(start, startWanted, rampInDur * m, tOut),
+        pose,
+        spanEase(z.ease, TILT_EASE)
+      );
     }
     push2(tOut, pose, "none");
     const next = mapped.at(i + 1);
     if (next && next.tIn - tOut <= chainGap) {
       const nextPose = [clampTiltDeg(next.z.rx), clampTiltDeg(next.z.ry)];
       push2(
-        Math.min(tOut + panDur * transitionMult(next.z.transition), next.tIn),
+        Math.max(
+          tOut + RAMP_FLOOR,
+          Math.min(tOut + panDur * transitionMult(next.z.transition), next.tIn)
+        ),
         nextPose,
         panEase
       );
@@ -10982,8 +10957,10 @@ export {
   PLAYBACK_ACTIVITY,
   PRIMARY_MEDIA,
   PROGRAM_RETIME,
+  PUMP_REST,
   REJECT_OVERLAP,
   REST_TILT_ID,
+  RETIRED_ZOOM_STYLES,
   SCENE_MOTION,
   SCENE_QUIET,
   SEGMENT_ENTER_KINDS,
@@ -11148,6 +11125,7 @@ export {
   layerMedia,
   layoutOf,
   levelForFocusFraction,
+  liveZoomStyleName,
   lookFromBrand,
   lookKindForGround,
   lowerProgramDoc,
@@ -11163,6 +11141,7 @@ export {
   micLane,
   migrateHostedDoc,
   migrateMotion,
+  migrateZoomStyle,
   momentsFromDoc,
   motionTrack,
   musicBedClip,
@@ -11206,6 +11185,7 @@ export {
   platformBarKind,
   programDuration,
   projectFromArtifact,
+  pumpFreeChainGap,
   ratedSegments,
   recommendedExportResolution,
   refillAudioBeds,