@real-music-packages/web-core 0.16.0 → 0.17.0

package/dist/scene/index.d.ts

@@ -717,8 +717,22 @@ declare function measureCount(rn: RenderedNotation): number;
 declare function followBoxAt(rn: RenderedNotation, posMeasures: number): Box | null;
 /**
  * The continuous follow-window START measure for an audio-clock progress 0..1.
- * (RSR +page.svelte:738-744 — hold the current pair, ease-scroll over the last
- * third of each bar.) Returns the windowStart fed to followBoxAt.
+ *
+ * INVARIANT: the bar the playhead is in (`curBar`) is ALWAYS fully inside the
+ * FOLLOW_BARS-wide window. We anchor `curBar` as the BOTTOM (last) visible bar —
+ * with the preceding FOLLOW_BARS-1 bars above it for context — so the window
+ * holds steady while the playhead works through the visible bars and only scrolls
+ * once the playhead reaches the bottom bar. Concretely the resting window start is
+ * `curBar - (FOLLOW_BARS - 1)`; over the tail of each bar we ease that forward by
+ * one bar so the NEXT bar slides into the bottom slot just as the playhead crosses
+ * into it. Because the eased start stays within `[curBar-(FOLLOW_BARS-1),
+ * curBar-(FOLLOW_BARS-2)]`, `curBar` never leaves `[start, start+FOLLOW_BARS)` —
+ * the current measure (and its playhead) can never ride off the top.
+ *
+ * The scroll is cubic-eased (smooth, no hard jump) over the last portion of each
+ * bar; result is clamped to [0, nBars-FOLLOW_BARS]. (Replaces RSR's original
+ * +page.svelte:738-744 logic, which advanced the window to the NEXT bar over the
+ * last third of EVERY bar and so pushed the still-current bar off the top.)
  */
 declare function followWindowStart(nBars: number, camProgress01: number): number;
 /** The dest rect a notation frame is drawn into, on screen. */

package/dist/scene/index.js

@@ -382,8 +382,9 @@ function followWindowStart(nBars, camProgress01) {
   const curBar = Math.floor(posBars);
   const frac = posBars - curBar;
   const scrollFrac = cubicEaseInOut(Math.min(1, Math.max(0, (frac - 0.66) / 0.34)));
+  const restStart = curBar - (FOLLOW_BARS - 1);
   const maxStart = Math.max(0, nBars - FOLLOW_BARS);
-  return Math.max(0, Math.min(maxStart, curBar + scrollFrac));
+  return Math.max(0, Math.min(maxStart, restStart + scrollFrac));
 }
 function notationLayout(rn, W, H, boxTop, boxH, opts = {}) {
   const { zoom01 = 1, focusBox = null } = opts;