@braccato/core 1.18.0 → 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 --------------------------
 /**
@@ -2236,6 +2233,7 @@ export function resolveTickOptions(options) {
         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
@@ -2885,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()) {
@@ -2895,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

@@ -41,6 +41,13 @@ export interface TickOptions {
      * 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.18.0",
+  "version": "1.19.0",
   "description": "Synchronized lyrics renderer with word-by-word animations",
   "type": "module",
   "license": "MIT",