@braccato/core 1.17.1 → 1.19.0

package/dist/engine.js

@@ -2024,7 +2024,7 @@ function prepareUpcomingLineScroll(engine, lines, activeLine, scrollDeltaPx, fro
     }
 }
 // -- Skip Scrolls Decay --------------------------
-function decaySkipScrolls(engine, now) {
+function decaySkipScrolls(engine, now, keepsReserve) {
     let j = 0;
     for (; j < engine.skipScrollsDecayTimes.length; j++) {
         if (engine.skipScrollsDecayTimes[j] > now) {
@@ -2032,10 +2032,7 @@ function decaySkipScrolls(engine, now) {
         }
     }
     engine.skipScrollsDecayTimes = engine.skipScrollsDecayTimes.slice(j);
-    engine.skipScrolls -= j;
-    if (engine.skipScrolls < 1) {
-        engine.skipScrolls = 1;
-    }
+    engine.skipScrolls = Math.max(keepsReserve ? 1 : 0, engine.skipScrolls - j);
 }
 // -- Passive Scroll Engine --------------------------
 /**
@@ -2235,6 +2232,8 @@ export function resolveTickOptions(options) {
         lineOffsetTrim: options.lineOffsetTrim ?? 0,
         passiveScrollEnabled: options.passiveScrollEnabled ?? false,
         playbackRate: resolvePlaybackRate(options.playbackRate),
+        followPausedSeeks: options.followPausedSeeks ?? false,
+        countEveryUserScroll: options.countEveryUserScroll ?? false,
     };
 }
 // A rate of zero or less would freeze every animation that follows the song, which is a second
@@ -2547,7 +2546,7 @@ export function tickView(engine, currentTime, options) {
         currentTime < playbackClock.lastTime - CLOCK_RESYNC_THRESHOLD_S;
     // A clock that was already paused only moves when the host seeks it, however small the step, as a
     // scrub does. The tick that pauses lands a moment past the last playing one and is not a seek.
-    const pausedSeek = !isPlaying && !playbackClock.lastPlayState && currentTime !== playbackClock.lastTime;
+    const pausedSeek = options.followPausedSeeks && !isPlaying && !playbackClock.lastPlayState && currentTime !== playbackClock.lastTime;
     if (timeJumped)
         dropPendingLineScroll(engine);
     playbackClock.lastTime = currentTime;
@@ -2884,9 +2883,12 @@ export function tickView(engine, currentTime, options) {
                 }
                 scrollTop = scrollPos;
                 engine.scrollPos = scrollTop;
+                const scrollTopBeforeWrite = tabRenderer.scrollTop;
                 tabRenderer.scrollTop = scrollTop;
-                engine.skipScrolls += 1;
-                engine.skipScrollsDecayTimes.push(Date.now() + 2000);
+                if (tabRenderer.scrollTop !== scrollTopBeforeWrite) {
+                    engine.skipScrolls += 1;
+                    engine.skipScrollsDecayTimes.push(Date.now() + 2000);
+                }
             }
         }
         if (engine.wasUserScrolling && engine.scrollResumeTime < Date.now()) {
@@ -2894,7 +2896,7 @@ export function tickView(engine, currentTime, options) {
             lyricsElement.classList.remove(USER_SCROLLING_CLASS);
             engine.wasUserScrolling = false;
         }
-        decaySkipScrolls(engine, now);
+        decaySkipScrolls(engine, now, !options.countEveryUserScroll);
     }
     catch (err) {
         if (!err.message?.includes("undefined")) {

package/dist/types.d.ts

@@ -36,6 +36,18 @@ export interface TickOptions {
      * interface's own gestures and keep the timing the theme asked for at every rate.
      */
     playbackRate?: number;
+    /**
+     * Whether a paused clock that moves by less than the jump threshold resets the highlight to the
+     * new time, as an editor scrubbing a paused song needs. Defaults to false.
+     */
+    followPausedSeeks?: boolean;
+    /**
+     * Whether every user scroll the host reports can pause autoscroll of synced lyrics. By default
+     * the view always holds one scroll back, for the one a refocused window fires, and a host that
+     * ticks every frame spends that reserve on each scroll the reader makes. Unsynced lyrics drifting
+     * on their own are not covered. Defaults to false.
+     */
+    countEveryUserScroll?: boolean;
 }
 /**
  * A tick with nothing left out. The engine reads every field unconditionally, so the defaults are

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@braccato/core",
-  "version": "1.17.1",
+  "version": "1.19.0",
   "description": "Synchronized lyrics renderer with word-by-word animations",
   "type": "module",
   "license": "MIT",