@ugfoundation/swaralipi-js 0.7.4 → 0.7.6

package/dist/player/index.cjs

@@ -489,6 +489,7 @@ function createTanpura(Tone, base, stems = TANPURA_PCS) {
 
 // src/player/player.ts
 var STOP_FADE_SEC = 0.5;
+var MEDIA_LEAD_SEC = 0.25;
 function midiRange(schedule) {
   let lo = Infinity;
   let hi = -Infinity;
@@ -502,6 +503,9 @@ function midiRange(schedule) {
   }
   return lo <= hi ? { lo, hi } : void 0;
 }
+function playDurationSec(schedule, spb, rhythm) {
+  return schedule.totalBeats * spb + (rhythm !== "none" ? schedule.pickupBeats * spb : 0) + spb;
+}
 async function loadedOrWarn(Tone) {
   try {
     await Tone.loaded();
@@ -548,6 +552,7 @@ var SwaralipiPlayer = class {
       tanpura: options.tanpura ?? true,
       previewLimitSec: options.previewLimitSec ?? Infinity,
       onHighlight: options.onHighlight,
+      onEvent: options.onEvent,
       onBeat: options.onBeat,
       onState: options.onState,
       onLimit: options.onLimit
@@ -581,6 +586,27 @@ var SwaralipiPlayer = class {
     const id = this.#taalId();
     return this.#opts.rhythm === "tabla" && id !== void 0 && SAMPLED_TAALS.has(id) && !!this.#opts.soundsBaseUrl;
   }
+  /**
+   * Length of one play-through in seconds, for a progress bar (the OS media
+   * session's, typically). Derived from the loaded notation on every read and
+   * never stored, because every input can move: re-engrave the document, drag
+   * the tempo, switch the rhythm off, and this changes with it. `Infinity` in
+   * taal mode (one avartan looping, no end — the value the Media Session spec
+   * reserves for exactly that), 0 with nothing loaded, and clamped by a preview
+   * cap when one is set, since that is when playback will really stop.
+   */
+  get durationSec() {
+    if (this.#taal !== void 0) return Infinity;
+    if (this.#doc === void 0) return 0;
+    const schedule = buildSchedule(this.#doc, { tonic: this.#opts.tonic, baseOctave: this.#opts.baseOctave });
+    const full = playDurationSec(schedule, 60 / this.#effectiveBpm(), this.#opts.rhythm);
+    return Math.min(full, this.#opts.previewLimitSec);
+  }
+  /** Seconds played so far, off the Transport's own clock — so it holds while
+   * paused, and reads 0 before the first play and after stop(). */
+  get positionSec() {
+    return this.#tone?.getTransport().seconds ?? 0;
+  }
   /* ----------------------------------------------------------------- */
   /* Loading + transport control                                        */
   /* ----------------------------------------------------------------- */
@@ -893,6 +919,7 @@ var SwaralipiPlayer = class {
     }
     const draw = Tone.getDraw();
     const shift = this.#opts.rhythm !== "none" ? schedule.pickupBeats * spb : 0;
+    const mediaLead = Math.min(MEDIA_LEAD_SEC, spb);
     schedule.events.forEach((ev, i) => {
       const at = ev.beat * spb + shift;
       if (ev.midi !== null && ev.glide !== true) {
@@ -926,12 +953,14 @@ var SwaralipiPlayer = class {
           transport.scheduleOnce((time) => melody.triggerAttackRelease(name, dur, time), at);
         }
       }
-      transport.scheduleOnce((time) => {
-        draw.schedule(() => this.#emitHighlight(ev.path), time);
-      }, at);
+      if (this.#opts.onEvent !== void 0) {
+        transport.scheduleOnce(() => this.#opts.onEvent?.(ev.path), Math.max(at - mediaLead, 0));
+      }
+      transport.scheduleOnce((time) => draw.schedule(() => this.#emitHighlight(ev.path), time), at);
     });
-    const endAt = schedule.totalBeats * spb + shift + spb;
+    const endAt = playDurationSec(schedule, spb, this.#opts.rhythm);
     transport.scheduleOnce((time) => {
+      this.#opts.onEvent?.(null);
       draw.schedule(() => this.#emitHighlight(null), time);
     }, schedule.totalBeats * spb + shift);
     transport.scheduleOnce(() => this.stop(), endAt);