@ugfoundation/swaralipi-js 0.14.0 → 0.14.2

package/dist/player/index.cjs

@@ -13,7 +13,7 @@ var TAALS = {
   shashthi: { id: "shashthi", numBeats: 6, bhaags: [2, 4], sam: 0 },
   // ষষ্ঠী
   teora: { id: "teora", numBeats: 7, bhaags: [3, 2, 2], sam: 0 },
-  // টেওরা
+  // তেওরা
   teentaal: { id: "teentaal", numBeats: 16, bhaags: [4, 4, 4, 4], sam: 0, khaali: [8] },
   aratheka: { id: "aratheka", numBeats: 16, bhaags: [4, 4, 4, 4], sam: 0, khaali: [8] },
   // আড়াঠেকা
@@ -146,6 +146,31 @@ function rowLay(row) {
 }
 
 // src/player/lyrics.ts
+function lyricCues(events, map, text) {
+  const tokens = [...text.matchAll(/\S+/g)].map((m) => ({
+    text: m[0],
+    start: m.index,
+    end: m.index + m[0].length,
+    line: text.slice(0, m.index).split("\n").length - 1
+  }));
+  const cues = [];
+  for (const ev of events) {
+    const span = map.get(ev.path);
+    const index = span ? tokens.findIndex((t) => t.start <= span[0] && span[0] < t.end) : -1;
+    if (index < 0) continue;
+    const token = tokens[index];
+    let cue = cues.at(-1);
+    if (!cue || cue.line !== token.line || index < cue.last) {
+      cue = { beat: ev.beat, line: token.line, last: -1, words: [] };
+      cues.push(cue);
+    }
+    if (index !== cue.last) {
+      cue.words.push({ beat: ev.beat, text: token.text });
+      cue.last = index;
+    }
+  }
+  return cues.map(({ beat, words }) => ({ beat, words }));
+}
 var MATCH = 2;
 var GAP = 1;
 var JUMP = 4;
@@ -2141,6 +2166,38 @@ function midiRange2(schedule) {
   }
   return lo <= hi ? { lo, hi } : void 0;
 }
+var AHEAD_SEC = 2;
+async function renderOffline(Tone, build, durationSec, channels, sampleRate) {
+  const chunked = "suspend" in OfflineAudioContext.prototype && "positionX" in AudioListener.prototype;
+  const context = chunked ? new Tone.OfflineContext(new OfflineAudioContext(channels, Math.ceil(durationSec * sampleRate), sampleRate)) : new Tone.OfflineContext(channels, durationSec, sampleRate);
+  const raw = context.rawContext;
+  const original = Tone.getContext();
+  Tone.setContext(context);
+  try {
+    await build(context);
+  } finally {
+    Tone.setContext(original);
+  }
+  const clock = context;
+  const run = (until) => {
+    while (clock._currentTime <= Math.min(until, durationSec)) {
+      clock.emit("tick");
+      clock._currentTime += 128 / sampleRate;
+    }
+  };
+  if (chunked) {
+    run(2 * AHEAD_SEC);
+    for (let t = AHEAD_SEC; t < durationSec; t += AHEAD_SEC) {
+      void raw.suspend(t).then(() => {
+        run(t + 2 * AHEAD_SEC);
+        void raw.resume();
+      });
+    }
+  } else {
+    run(Infinity);
+  }
+  return raw.startRendering();
+}
 function pickDef(id, o) {
   const def = o.customInstruments?.[id] ?? INSTRUMENTS[id];
   if (def === void 0) return INSTRUMENTS.harmonium;
@@ -2169,7 +2226,8 @@ async function exportAudio(doc, options = {}) {
     tonic: options.tonic,
     baseOctave: options.baseOctave,
     laySpeeds: options.laySpeeds,
-    repeats: options.repeats ?? true
+    repeats: options.repeats ?? true,
+    excerpt: options.excerpt
   });
   const range = midiRange2(schedule);
   const taalId = resolveTaal(doc, options.taal);
@@ -2182,7 +2240,8 @@ async function exportAudio(doc, options = {}) {
   const def = pickDef(id, options);
   const shift = rhythm !== "none" ? schedule.pickupBeats * spb : 0;
   const durationSec = Math.max(schedule.totalBeats * spb + shift + (def.release ?? 1) + fadeOutSec + 0.5, 0.5);
-  const rendered = await Tone.Offline(
+  const rendered = await renderOffline(
+    Tone,
     async ({ transport }) => {
       transport.bpm.value = bpm;
       const master = new Tone.Gain(1).toDestination();
@@ -2329,11 +2388,16 @@ async function exportAudio(doc, options = {}) {
   for (let c = 0; c < rendered.numberOfChannels; c++) chans.push(rendered.getChannelData(c));
   const bytes = format === "mp3" ? await encodeMp3(chans, rendered.sampleRate, options.mp3Kbps) : encodeWav(chans, rendered.sampleRate);
   const mimeType = format === "mp3" ? "audio/mpeg" : "audio/wav";
+  const cues = options.lyrics === void 0 ? void 0 : lyricCues(schedule.events, alignLyrics(doc, options.lyrics), options.lyrics).map((cue) => ({
+    sec: cue.beat * spb + shift,
+    words: cue.words.map((word) => ({ sec: word.beat * spb + shift, text: word.text }))
+  }));
   return {
     blob: new Blob([bytes], { type: mimeType }),
     filename: `${safeName(doc.meta.title)}.${format}`,
     mimeType,
-    durationSec: rendered.duration
+    durationSec: rendered.duration,
+    ...cues === void 0 ? {} : { cues }
   };
 }
 function toInt16(f) {
@@ -2400,22 +2464,32 @@ async function loadLame() {
     );
   }
 }
-async function encodeMp3(channels, sampleRate, kbps = 192) {
+async function mp3Stream(sampleRate = 44100, kbps = 192, channels = 1) {
   const Mp3Encoder = await loadLame();
-  const numCh = Math.min(channels.length, 2);
-  const enc = new Mp3Encoder(numCh, sampleRate, kbps);
-  const left = floatToInt16(channels[0] ?? new Float32Array());
-  const right = numCh > 1 ? floatToInt16(channels[1]) : void 0;
-  const block = 1152;
+  const enc = new Mp3Encoder(channels, sampleRate, kbps);
   const out = [];
-  for (let i = 0; i < left.length; i += block) {
-    const l = left.subarray(i, i + block);
-    const chunk = right ? enc.encodeBuffer(l, right.subarray(i, i + block)) : enc.encodeBuffer(l);
+  const keep = (chunk) => {
     if (chunk.length > 0) out.push(new Uint8Array(chunk));
-  }
-  const tail = enc.flush();
-  if (tail.length > 0) out.push(new Uint8Array(tail));
-  return concatBytes(out);
+  };
+  const block = 1152;
+  return {
+    push(left, right) {
+      for (let i = 0; i < left.length; i += block) {
+        const l = left.subarray(i, i + block);
+        keep(right ? enc.encodeBuffer(l, right.subarray(i, i + block)) : enc.encodeBuffer(l));
+      }
+    },
+    end() {
+      keep(enc.flush());
+      return out;
+    }
+  };
+}
+async function encodeMp3(channels, sampleRate, kbps = 192) {
+  const numCh = Math.min(channels.length, 2);
+  const mp3 = await mp3Stream(sampleRate, kbps, numCh);
+  mp3.push(floatToInt16(channels[0] ?? new Float32Array()), numCh > 1 ? floatToInt16(channels[1]) : void 0);
+  return concatBytes(mp3.end());
 }
 
 // src/player/midi.ts
@@ -2461,6 +2535,11 @@ function trackChunk(raw, head) {
   const track = [...head];
   let last = 0;
   for (const e of raw) {
+    if (e.meta) {
+      track.push(...vlq(e.tick - last), ...e.meta);
+      last = e.tick;
+      continue;
+    }
     const status = e.status !== void 0 ? e.status | e.ch & 15 : (e.on ? 144 : 128) | e.ch & 15;
     track.push(...vlq(e.tick - last), status, e.note & 127, e.vel & 127);
     last = e.tick;
@@ -2468,22 +2547,22 @@ function trackChunk(raw, head) {
   track.push(...vlq(0), 255, 47, 0);
   return [77, 84, 114, 107, ...u32be(track.length), ...track];
 }
-function encodeMidi(schedule, opts) {
+function melodyEvents(schedule, offset = 0) {
   const melody = [];
   const hasGlide = schedule.events.some((ev) => ev.glide === true);
   if (hasGlide) melody.push(...bendRangeSetup());
   schedule.events.forEach((ev, i) => {
     if (ev.glide === true) return;
     for (const g of graceTouches(ev)) {
-      const on = Math.max(Math.round(g.beat * PPQ), 0);
+      const on = Math.max(Math.round(g.beat * PPQ) + offset, 0);
       melody.push({ tick: on, on: true, note: g.midi, vel: 70, ch: 0 });
-      melody.push({ tick: Math.max(on + 1, Math.round((g.beat + GRACE_STEP) * PPQ)), on: false, note: g.midi, vel: 0, ch: 0 });
+      melody.push({ tick: Math.max(on + 1, Math.round((g.beat + GRACE_STEP) * PPQ) + offset), on: false, note: g.midi, vel: 0, ch: 0 });
     }
     if (ev.midi === null) return;
-    const start = Math.round(ev.beat * PPQ);
+    const start = Math.round(ev.beat * PPQ) + offset;
     const targets = glideTargets(schedule.events, i);
     const last = targets[targets.length - 1] ?? ev;
-    const end = Math.max(Math.round((last.beat + last.durationBeats) * PPQ), start + 1);
+    const end = Math.max(Math.round((last.beat + last.durationBeats) * PPQ) + offset, start + 1);
     melody.push({ tick: start, on: true, note: ev.midi, vel: 100, ch: 0 });
     melody.push({ tick: end, on: false, note: ev.midi, vel: 0, ch: 0 });
     let from = ev;
@@ -2493,71 +2572,89 @@ function encodeMidi(schedule, opts) {
         const u = n / BEND_STEPS;
         const beat = glideStart + (to.beat - glideStart) * u;
         const semis = from.midi - ev.midi + (to.midi - from.midi) * sCurve(u);
-        melody.push(bendEvent(Math.round(beat * PPQ), semis));
+        melody.push(bendEvent(Math.round(beat * PPQ) + offset, semis));
       }
       from = to;
     }
     if (targets.length > 0) melody.push(bendEvent(end, 0));
   });
+  return melody;
+}
+function drumEvents(schedule, drums, offset = 0) {
+  const drum = [];
+  for (const seg of schedule.tempo) {
+    const pattern = typeof drums === "function" ? drums(seg) : drums;
+    if (!pattern?.length) continue;
+    const end = seg === schedule.tempo[schedule.tempo.length - 1] ? Math.ceil(schedule.totalBeats) : seg.endBeat;
+    for (let k = 0; seg.beat + k / seg.scale < end - 1e-6; k++) {
+      const note = DRUM_NOTE[pattern[k % pattern.length]];
+      const t = Math.round((seg.beat + k / seg.scale) * PPQ) + offset;
+      drum.push({ tick: t, on: true, note, vel: 100, ch: 9 });
+      drum.push({ tick: t + Math.round(PPQ / 4), on: false, note, vel: 0, ch: 9 });
+    }
+  }
+  return drum;
+}
+function midiFile(chunks) {
+  const format = chunks.length > 1 ? 1 : 0;
+  const header = [77, 84, 104, 100, ...u32be(6), 0, format, chunks.length >> 8 & 255, chunks.length & 255, PPQ >> 8 & 255, PPQ & 255];
+  return new Uint8Array([...header, ...chunks.flat()]);
+}
+function meta(type, data) {
+  return [255, type, ...vlq(data.length), ...data];
+}
+function encodeMidi(schedule, opts) {
   const usPerBeat = Math.round(6e7 / opts.bpm);
   const head = [];
   if (opts.name) head.push(...vlq(0), 255, 3, ...vlq(utf8(opts.name).length), ...utf8(opts.name));
   head.push(...vlq(0), 255, 81, 3, usPerBeat >> 16 & 255, usPerBeat >> 8 & 255, usPerBeat & 255);
-  const chunks = [trackChunk(melody, head)];
+  const chunks = [trackChunk(melodyEvents(schedule), head)];
   if (typeof opts.drums === "function" || opts.drums && opts.drums.length > 0) {
-    const drum = [];
-    for (const seg of schedule.tempo) {
-      const pattern = typeof opts.drums === "function" ? opts.drums(seg) : opts.drums;
-      if (!pattern?.length) continue;
-      const end = seg === schedule.tempo[schedule.tempo.length - 1] ? Math.ceil(schedule.totalBeats) : seg.endBeat;
-      for (let k = 0; seg.beat + k / seg.scale < end - 1e-6; k++) {
-        const note = DRUM_NOTE[pattern[k % pattern.length]];
-        const t = Math.round((seg.beat + k / seg.scale) * PPQ);
-        drum.push({ tick: t, on: true, note, vel: 100, ch: 9 });
-        drum.push({ tick: t + Math.round(PPQ / 4), on: false, note, vel: 0, ch: 9 });
-      }
-    }
+    const drum = drumEvents(schedule, opts.drums);
     chunks.push(trackChunk(drum, [...vlq(0), 255, 3, ...vlq(5), 68, 114, 117, 109, 115]));
   }
-  const format = chunks.length > 1 ? 1 : 0;
-  const header = [
-    77,
-    84,
-    104,
-    100,
-    ...u32be(6),
-    0,
-    format,
-    chunks.length >> 8 & 255,
-    chunks.length & 255,
-    PPQ >> 8 & 255,
-    PPQ & 255
-  ];
-  return new Uint8Array([...header, ...chunks.flat()]);
+  return midiFile(chunks);
+}
+function exportSchedule(doc, o) {
+  return buildSchedule(doc, { tonic: o.tonic, baseOctave: o.baseOctave, laySpeeds: o.laySpeeds, repeats: o.repeats ?? true, excerpt: o.excerpt });
+}
+function taalDrums(seg) {
+  if (seg.taal === null) return void 0;
+  const id = seg.taal?.id;
+  return drumPattern(id !== void 0 && id in TAALS ? TAALS[id] : { numBeats: 4, sam: 0 });
 }
 function safeName2(title) {
   return (title ?? "").replace(/[\\/:*?"<>|]+/g, "").trim() || "swaralipi";
 }
 function exportMidi(doc, options = {}) {
-  const schedule = buildSchedule(doc, {
-    tonic: options.tonic,
-    baseOctave: options.baseOctave,
-    laySpeeds: options.laySpeeds,
-    repeats: options.repeats ?? true
-  });
+  const schedule = exportSchedule(doc, options);
   const bpm = options.bpm ?? doc.meta.bpm ?? 90;
-  const drums = options.drums ? (seg) => {
-    const id = seg.taal?.id;
-    if (seg.taal === null) return void 0;
-    return drumPattern(id !== void 0 && id in TAALS ? TAALS[id] : { numBeats: 4, sam: 0 });
-  } : void 0;
-  const bytes = encodeMidi(schedule, { bpm, name: options.name ?? doc.meta.title, drums });
+  const bytes = encodeMidi(schedule, { bpm, name: options.name ?? doc.meta.title, drums: options.drums ? taalDrums : void 0 });
   return {
     blob: new Blob([bytes], { type: "audio/midi" }),
     filename: `${safeName2(doc.meta.title)}.mid`,
     mimeType: "audio/midi"
   };
 }
+function exportMidiSet(items, name) {
+  const melody = [];
+  const drum = [];
+  let beat = 0;
+  for (const { doc, options = {} } of items) {
+    const schedule = exportSchedule(doc, options);
+    const tick = beat * PPQ;
+    const usPerBeat = Math.round(6e7 / (options.bpm ?? doc.meta.bpm ?? 90));
+    const at = (bytes2) => ({ tick, on: false, note: 0, vel: 0, ch: 0, meta: bytes2 });
+    melody.push(at(meta(81, [usPerBeat >> 16 & 255, usPerBeat >> 8 & 255, usPerBeat & 255])));
+    melody.push(at(meta(6, utf8(options.name ?? doc.meta.title ?? ""))), ...melodyEvents(schedule, tick));
+    if (options.drums) drum.push(...drumEvents(schedule, taalDrums, tick));
+    beat += Math.ceil(schedule.totalBeats) + 2;
+  }
+  const chunks = [trackChunk(melody, [...vlq(0), ...meta(3, utf8(name))])];
+  if (drum.length > 0) chunks.push(trackChunk(drum, [...vlq(0), ...meta(3, utf8("Drums"))]));
+  const bytes = midiFile(chunks);
+  return { blob: new Blob([bytes], { type: "audio/midi" }), filename: `${safeName2(name)}.mid`, mimeType: "audio/midi" };
+}
 
 exports.ARC_RAW_RE = ARC_RAW_RE;
 exports.DEFAULT_SOUNDS_BASE = DEFAULT_SOUNDS_BASE;
@@ -2585,12 +2682,15 @@ exports.encodeWav = encodeWav;
 exports.eventAt = eventAt;
 exports.exportAudio = exportAudio;
 exports.exportMidi = exportMidi;
+exports.exportMidiSet = exportMidiSet;
 exports.glideTargets = glideTargets;
 exports.graceTouches = graceTouches;
 exports.instrumentSampleUrl = instrumentSampleUrl;
 exports.isArcRaw = isArcRaw;
+exports.lyricCues = lyricCues;
 exports.meendContinuations = meendContinuations;
 exports.midiToSampleName = midiToSampleName;
+exports.mp3Stream = mp3Stream;
 exports.nearestSampleKey = nearestSampleKey;
 exports.nearestTablaBpm = nearestTablaBpm;
 exports.normalizeBase = normalizeBase;