@ugfoundation/swaralipi-js 0.13.1 → 0.14.1

package/dist/player/index.cjs

@@ -145,6 +145,170 @@ function rowLay(row) {
   return row.lay ?? printedLay(row.notes);
 }
 
+// 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;
+var RUN = 3;
+var STRAY = 8;
+var EPS = 1e-6;
+var [DIAG, UP, LEFT, JUMPED] = [1, 2, 3, 4];
+var letters = (s) => s.normalize("NFD").replace(/ৎ/g, "\u09A4").replace(/[^\p{L}\p{M}]|[়্]/gu, "").toLowerCase();
+function alignLyrics(doc, text) {
+  const sung = [];
+  doc.parts.forEach(
+    (part, p) => part.rows.forEach(
+      (row, r) => row.notes.forEach((note, i) => {
+        for (const letter of letters(note.lyric ?? "")) sung.push({ letter, path: `${p}.${r}.${i}` });
+      })
+    )
+  );
+  const said = [];
+  const starts = [];
+  let at = 0;
+  let gap = true;
+  for (const ch of text) {
+    const ls = letters(ch);
+    if (ls === "") {
+      gap ||= /[\s\p{P}]/u.test(ch);
+      if (/[\p{M}\p{Cf}]/u.test(ch) && said.at(-1)?.to === at) said.at(-1).to += ch.length;
+    } else {
+      if (gap) starts.push(said.length);
+      gap = false;
+    }
+    for (const letter of ls) said.push({ letter, from: at, to: at + ch.length });
+    at += ch.length;
+  }
+  const n = sung.length;
+  const m = said.length;
+  const w = m + 1;
+  const from = new Uint8Array((n + 1) * w);
+  const best = new Int32Array(n + 1);
+  let prev = new Int32Array(w).fill(-1073741824);
+  prev[0] = 0;
+  let cur = new Int32Array(w);
+  const settle = (i, row) => {
+    for (let j2 = 1; j2 < w; j2++) if (row[j2] > row[best[i]]) best[i] = j2;
+    for (const s of starts) {
+      if (row[best[i]] - JUMP > row[s]) {
+        row[s] = row[best[i]] - JUMP;
+        from[i * w + s] = JUMPED;
+      }
+    }
+    for (let j2 = 1; j2 < w; j2++) {
+      if (row[j2 - 1] - GAP > row[j2]) {
+        row[j2] = row[j2 - 1] - GAP;
+        from[i * w + j2] = LEFT;
+      }
+    }
+  };
+  settle(0, prev);
+  for (let i = 1; i <= n; i++) {
+    cur[0] = prev[0] - GAP;
+    from[i * w] = UP;
+    for (let j2 = 1; j2 < w; j2++) {
+      const diag = prev[j2 - 1] + (sung[i - 1].letter === said[j2 - 1].letter ? MATCH : -GAP);
+      const up = prev[j2] - GAP;
+      cur[j2] = Math.max(diag, up);
+      from[i * w + j2] = diag >= up ? DIAG : UP;
+    }
+    best[i] = 0;
+    settle(i, cur);
+    [prev, cur] = [cur, prev];
+  }
+  const pairs = [];
+  let j = 0;
+  for (let k = 1; k < w; k++) if (prev[k] > prev[j]) j = k;
+  for (let i = n; i > 0; ) {
+    const step = from[i * w + j];
+    if (step === JUMPED) j = best[i];
+    else if (step === LEFT) j--;
+    else if (step === UP) i--;
+    else {
+      if (sung[i - 1].letter === said[j - 1].letter) pairs.push([i - 1, j - 1]);
+      i--;
+      j--;
+    }
+  }
+  pairs.reverse();
+  const wordStart = new Set(starts);
+  const follows = (k) => pairs[k][0] === pairs[k - 1][0] + 1 && (pairs[k][1] === pairs[k - 1][1] + 1 || wordStart.has(pairs[k][1]));
+  const out = /* @__PURE__ */ new Map();
+  const last = /* @__PURE__ */ new Map();
+  for (let a = 0, b = 1; a < pairs.length; a = b++) {
+    while (b < pairs.length && follows(b)) b++;
+    if (b - a < RUN) continue;
+    for (const [s, t] of pairs.slice(a, b)) {
+      const { path } = sung[s];
+      const { from: lo, to: hi } = said[t];
+      const span = out.get(path);
+      if (span === void 0) out.set(path, [lo, hi]);
+      else if (t === last.get(path) + 1) span[1] = hi;
+      else continue;
+      last.set(path, t);
+    }
+  }
+  return out;
+}
+var mod = (a, n) => (a % n + n) % n;
+var sings = (v) => v.note.svara !== void 0 || v.note.sustain === true;
+function excerptVisits(order, at, { lyrics, ranges }, cycle) {
+  const pos = order.map((v) => lyrics.get(`${v.p}.${v.r}.${v.i}`)?.[0]);
+  for (let a = 0; a < order.length; a++) {
+    if (pos[a] !== void 0 || letters(order[a].note.lyric ?? "") === "") continue;
+    let b = a;
+    let stray = 0;
+    while (b < order.length && pos[b] === void 0) stray += letters(order[b++].note.lyric ?? "").length;
+    if (stray >= STRAY) pos.fill(-1, a, b);
+    a = b;
+  }
+  const visits = [];
+  let first;
+  let end = 0;
+  for (const [lo, hi] of ranges) {
+    const inside = (k) => pos[k] === void 0 ? void 0 : pos[k] >= lo && pos[k] < hi;
+    const a = order.findIndex((_, k) => inside(k) === true);
+    if (a < 0) continue;
+    let b = a + 1;
+    while (b < order.length && inside(b) !== false) b++;
+    while (b - 1 > a && !sings(order[b - 1])) b--;
+    const n = cycle(order[a]);
+    if (first === void 0) first = a;
+    else if (n !== void 0) {
+      const gap = mod(at[a] - at[end], n);
+      if (gap > EPS) visits.push({ ...order[end - 1], note: { rest: true, durationMatra: gap } });
+    }
+    visits.push(...order.slice(a, b));
+    end = b;
+  }
+  return { visits, matra: first === void 0 ? 0 : at[first] };
+}
+
 // src/convert/codec.ts
 var LETTERS = {
   s: { letter: "s" },
@@ -310,7 +474,7 @@ function decodeCell(text) {
 var UNDECODED_CELL = /[srgmpqnvtduka]/i;
 var isSilent = (n) => n.svara === void 0 && n.rest !== true && n.sustain !== true && !(n.raw !== void 0 && UNDECODED_CELL.test(n.raw));
 var STOP_MARK = /^\|+$/;
-var EPS = 1e-6;
+var EPS2 = 1e-6;
 var edges = (n, kind, edge) => n.brackets?.filter((b) => b.kind === kind && b.edge === edge).length ?? 0;
 var sounds = (n) => n.svara !== void 0 || n.rest === true || n.sustain === true;
 var matra = (notes) => notes.reduce((sum, n) => sum + (n.durationMatra ?? 1), 0);
@@ -339,10 +503,10 @@ function playOrder(doc) {
         owed = 0;
         continue;
       }
-      if (owed > EPS && t.timed) owed -= matra([t.note]);
+      if (owed > EPS2 && t.timed) owed -= matra([t.note]);
       else {
         const sub = useChanged || again ? changed.get(k) : void 0;
-        const fits = sub !== void 0 && matra(sub) >= matra([t.note]) - EPS;
+        const fits = sub !== void 0 && matra(sub) >= matra([t.note]) - EPS2;
         for (const note of fits ? sub : [t.note]) out.push({ p: t.p, r: t.r, i: t.i, note });
         if (t.timed) last = k;
         owed = fits ? matra(sub) - matra([t.note]) : 0;
@@ -535,8 +699,6 @@ function buildSchedule(doc, opts = {}) {
   const events = [];
   let cursor = 0;
   let lastPitched = -1;
-  let samMatra;
-  let matra2 = 0;
   const speeds = resolveLaySpeeds(doc.meta.laySpeeds, opts.laySpeeds);
   const withLay = opts.lay !== false;
   const tempo = [{ beat: 0, endBeat: 0, scale: 1, lay: "drut", taal: doc.meta.taal }];
@@ -555,7 +717,15 @@ function buildSchedule(doc, opts = {}) {
       rows.set(`${p}.${r}`, { scale, lay: layNow, taal, glides: meendContinuations(row.notes) });
     })
   );
-  const visits = opts.repeats === true ? playOrder(doc) : doc.parts.flatMap((part, p) => part.rows.flatMap((row, r) => row.notes.map((note, i) => ({ p, r, i, note }))));
+  const order = opts.repeats === true ? playOrder(doc) : doc.parts.flatMap((part, p) => part.rows.flatMap((row, r) => row.notes.map((note, i) => ({ p, r, i, note }))));
+  const at = [0];
+  let samMatra;
+  for (const { note } of order) {
+    const m = at[at.length - 1];
+    if (samMatra === void 0 && note.above?.some((a) => a.raw !== void 0 && SAM_TICK.test(a.raw))) samMatra = m;
+    at.push(note.bar === void 0 && !isSilent(note) ? m + (note.durationMatra ?? 1) : m);
+  }
+  const { visits, matra: matra2 } = opts.excerpt ? excerptVisits(order, at, opts.excerpt, (v) => rows.get(`${v.p}.${v.r}`).taal?.numBeats) : { visits: order, matra: 0 };
   let rowNow = "";
   for (const { p, r, i, note } of visits) {
     const row = rows.get(`${p}.${r}`);
@@ -571,14 +741,6 @@ function buildSchedule(doc, opts = {}) {
         }
       }
     }
-    if (samMatra === void 0 && note.above !== void 0) {
-      for (const a of note.above) {
-        if (a.raw !== void 0 && SAM_TICK.test(a.raw)) {
-          samMatra = matra2;
-          break;
-        }
-      }
-    }
     if (note.bar !== void 0 || isSilent(note)) continue;
     const path = `${p}.${r}.${i}`;
     const written = note.durationMatra ?? 1;
@@ -604,10 +766,9 @@ function buildSchedule(doc, opts = {}) {
       events.push({ beat: cursor, durationBeats: dur, midi: null, kan, resh, path, kind: "rest" });
     }
     cursor += dur;
-    matra2 += written;
   }
   const numBeats = tempo[0].taal?.numBeats;
-  const pickupMatra = samMatra !== void 0 && numBeats !== void 0 && numBeats > 0 ? (numBeats - samMatra % numBeats) % numBeats : 0;
+  const pickupMatra = numBeats !== void 0 && numBeats > 0 ? ((matra2 - (samMatra ?? 0)) % numBeats + numBeats) % numBeats : 0;
   tempo[tempo.length - 1].endBeat = cursor;
   return { events, totalBeats: cursor, pickupBeats: pickupMatra / tempo[0].scale, tempo };
 }
@@ -946,6 +1107,8 @@ var SwaralipiPlayer = class {
   /** Per-song setBpm tweak: beats meta.bpm but is cleared by the next load(). */
   #bpmTweak;
   #doc;
+  /** Play only these stretches of the song's text (see `load`). */
+  #excerpt;
   /** Taal mode (`loadTaal`): loops one avartan of this taal's theka with no
    * melody. Mutually exclusive with `#doc`. */
   #taal;
@@ -988,6 +1151,8 @@ var SwaralipiPlayer = class {
   /** Listeners on the bound sheet, removed on rebind. */
   #unbind;
   #sheet;
+  /** The bound sheet's highlight — beside, never instead of, the consumer's `onHighlight`. */
+  #paint;
   /** Preview cap, counted in listening time so a seek or a loop can't dodge it. */
   #listened = 0;
   #listenedSince = 0;
@@ -1078,10 +1243,13 @@ var SwaralipiPlayer = class {
   /* ----------------------------------------------------------------- */
   /* Loading + transport control                                        */
   /* ----------------------------------------------------------------- */
-  /** Set the document to play. Stops any current playback. */
-  load(doc) {
+  /** Set the document to play. Stops any current playback. With `excerpt`,
+   * only the notes singing those stretches of the song's text play, in order
+   * (see `alignLyrics`); the length, seeks and repeats all keep to them. */
+  load(doc, { excerpt } = {}) {
     this.#halt();
     this.#doc = doc;
+    this.#excerpt = excerpt;
     this.#taal = void 0;
     this.#taalOverride = void 0;
     this.#bpmTweak = void 0;
@@ -1404,7 +1572,7 @@ var SwaralipiPlayer = class {
    */
   bindSheet(target, opts = {}) {
     const block = opts.autoScroll === true ? "center" : opts.autoScroll || void 0;
-    this.#opts.onHighlight = (path, yourTurn) => {
+    this.#paint = (path, yourTurn) => {
       target.clearHighlights();
       if (path === null) return;
       const el2 = target.highlight(path, yourTurn);
@@ -1516,6 +1684,7 @@ var SwaralipiPlayer = class {
     this.#opts.onState?.(state);
   }
   #emitHighlight(path, yourTurn = false) {
+    this.#paint?.(path, yourTurn);
     this.#opts.onHighlight?.(path, yourTurn);
   }
   #emitLoop() {
@@ -1673,7 +1842,8 @@ var SwaralipiPlayer = class {
       tonic: this.#opts.tonic,
       baseOctave: this.#opts.baseOctave,
       laySpeeds: this.#opts.laySpeeds,
-      repeats: this.#opts.repeats
+      repeats: this.#opts.repeats,
+      excerpt: this.#excerpt
     };
   }
   /** Effective tempo: snapped to the taal's available tabla tempos while a
@@ -1996,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;
@@ -2024,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);
@@ -2037,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();
@@ -2184,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) {
@@ -2245,8 +2454,8 @@ function concatBytes(chunks) {
 }
 async function loadLame() {
   try {
-    const mod = await import('@breezystack/lamejs');
-    const Mp3Encoder = mod.Mp3Encoder ?? mod.default?.Mp3Encoder;
+    const mod2 = await import('@breezystack/lamejs');
+    const Mp3Encoder = mod2.Mp3Encoder ?? mod2.default?.Mp3Encoder;
     if (!Mp3Encoder) throw new Error("no Mp3Encoder export");
     return Mp3Encoder;
   } catch {
@@ -2255,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
@@ -2316,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;
@@ -2323,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;
@@ -2348,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;
@@ -2430,6 +2672,7 @@ exports.SwaralipiPlayer = SwaralipiPlayer;
 exports.TABLA_BPMS = TABLA_BPMS;
 exports.TABLA_VARIATIONS = TABLA_VARIATIONS;
 exports.TONEJS_INSTRUMENTS_BASE = TONEJS_INSTRUMENTS_BASE;
+exports.alignLyrics = alignLyrics;
 exports.buildSchedule = buildSchedule;
 exports.createBuffers = createBuffers;
 exports.drumPattern = drumPattern;
@@ -2439,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;