@real-music-packages/web-core 0.21.0 → 0.22.0

package/dist/scene/index.d.ts

@@ -678,12 +678,11 @@ declare const notationFactory: LayerFactory<NotationProps>;
 
 interface ScrollCursorProps {
     /**
-     * Cursor pacing mode. Default `'audio'` (foolproof): the cursor is driven
-     * note-by-note off the audio clock against each note's `onsetMs`, so it lands
-     * on every note as it sounds and can never race/desync the full score width —
-     * correct by construction regardless of timeline. `'linear'` is the legacy
-     * measure-linear sweep paced over `musicMs` (RSR's original behaviour) — kept
-     * for back-compat; prefer leaving this unset.
+     * DEPRECATED / back-compat only. The cursor is ALWAYS audio-onset locked now —
+     * driven note-by-note off the audio clock against each note's `onsetMs` (see
+     * `ctx.score`). Both `'audio'` and `'linear'` resolve to that single onset path;
+     * `'linear'` no longer re-enables the legacy measure-linear sweep (removed —
+     * that was the drift footgun). Prefer leaving this unset.
      */
     mode?: 'audio' | 'linear';
     /**
@@ -704,9 +703,9 @@ interface ScrollCursorProps {
     /** Opening-zoom duration in ms before the music/cursor start (RSR INTRO_MS=900).
      *  During this lead-in the follow window is held at the start. Default 900. */
     openingZoomMs?: number;
-    /** Total music length in ms (RSR musicMs). Required by `'linear'` to pace
-     *  camProgress; in `'audio'` mode it is optional (the onset clock drives pacing)
-     *  and used only as a fallback when the score has no notes. */
+    /** DEPRECATED. Total music length in ms (RSR musicMs). No longer used to
+     *  position the cursor (the onset clock drives all pacing); accepted for
+     *  back-compat and ignored. */
     musicMs?: number;
     /** Cursor stroke colour. Defaults to theme.accent. */
     color?: string;

package/dist/scene/index.js

@@ -818,25 +818,18 @@ var notationFactory = {
 };
 
 // src/scene/layers/scrollCursor.ts
-function followLayoutFor(ctx, camProgress01, scrollMode) {
+function followLayoutFor(ctx, progress012, scrollMode) {
   const eng = getNotationEngraving(ctx);
   if (!eng) return null;
   const nBars = measureCount(eng.rendered);
   if (nBars <= 0) return eng.base;
-  const focusBox = scrollMode === "vstack" ? vstackFollowBox(eng.rendered, camProgress01) : followBoxAt(eng.rendered, followWindowStart(eng.rendered, camProgress01));
+  const focusBox = scrollMode === "vstack" ? vstackFollowBox(eng.rendered, progress012) : followBoxAt(eng.rendered, followWindowStart(eng.rendered, progress012));
   return notationLayout(eng.rendered, ctx.W, ctx.H, eng.bandTop, eng.bandHeight, { focusBox });
 }
 function scrollCursorLayer() {
-  let mode = "audio";
   let scrollMode = "hstack";
-  let musicMs = 0;
   let openingZoomMs = 900;
   let color;
-  function camProgress(tMs) {
-    const phMs = tMs - openingZoomMs;
-    if (phMs < 0 || musicMs <= 0) return 0;
-    return Math.min(1, phMs / musicMs);
-  }
   function onsetsFor(ctx) {
     const notes = ctx.score?.notes;
     return notes && notes.length ? distinctOnsets(notes) : [];
@@ -859,9 +852,7 @@ function scrollCursorLayer() {
     return (lo + segFrac) / (n - 1);
   }
   function followProgress(ctx, tMs) {
-    if (mode === "linear") return camProgress(tMs);
-    const onsets = onsetsFor(ctx);
-    return onsets.length ? notesProgress(onsets, tMs) : camProgress(tMs);
+    return notesProgress(onsetsFor(ctx), tMs);
   }
   function layoutAt(ctx, tMs) {
     const eng = getNotationEngraving(ctx);
@@ -870,9 +861,7 @@ function scrollCursorLayer() {
   return {
     key: "scroll-cursor",
     init(ctx, props) {
-      mode = props.mode ?? "audio";
       scrollMode = props.scrollMode ?? "hstack";
-      musicMs = props.musicMs ?? 0;
       openingZoomMs = props.openingZoomMs ?? 900;
       color = props.color;
       setFollowLayoutProvider(ctx, layoutAt);
@@ -881,16 +870,12 @@ function scrollCursorLayer() {
       const eng = getNotationEngraving(ctx);
       if (!eng) return;
       const layout = layoutAt(ctx, tMs);
+      const onsets = onsetsFor(ctx);
       let line;
-      const onsets = mode === "audio" ? onsetsFor(ctx) : [];
-      if (mode === "audio" && onsets.length) {
-        if (scrollMode === "vstack") {
-          line = vstackAudioPlayheadLine(layout, onsets, tMs, measureCount(eng.rendered));
-        } else {
-          line = audioPlayheadLine(layout, onsets, tMs);
-        }
+      if (scrollMode === "vstack") {
+        line = vstackAudioPlayheadLine(layout, onsets, tMs, measureCount(eng.rendered));
       } else {
-        line = playheadLine(layout, camProgress(tMs));
+        line = audioPlayheadLine(layout, onsets, tMs);
       }
       if (!line) return;
       const c = ctx.ctx2d;
@@ -917,8 +902,6 @@ var scrollCursorFactory = {
       errs.push('scroll-cursor.mode must be "audio" | "linear"');
     if (p.scrollMode != null && p.scrollMode !== "hstack" && p.scrollMode !== "vstack")
       errs.push('scroll-cursor.scrollMode must be "hstack" | "vstack"');
-    if (p.mode === "linear" && (typeof p.musicMs !== "number" || !(p.musicMs > 0)))
-      errs.push('scroll-cursor.musicMs must be a positive number for mode:"linear"');
     if (p.musicMs != null && (typeof p.musicMs !== "number" || !(p.musicMs > 0)))
       errs.push("scroll-cursor.musicMs must be a positive number");
     if (p.followBars != null && (typeof p.followBars !== "number" || p.followBars < 1))