@ugfoundation/swaralipi-js 0.13.1 → 0.14.1

package/dist/player/index.d.cts

@@ -1,8 +1,8 @@
 import { S as Swaralipi, T as Taal, O as Octave, a as SvaraLetter, N as Note } from '../schema-DZag9qkF.cjs';
 import { a as LaySpeeds, T as TaalId } from '../lay-CXhC-HRO.cjs';
 export { b as LAYS, c as LAY_SPEEDS, L as Lay, p as printedLay, r as resolveLaySpeeds, d as rowLay } from '../lay-CXhC-HRO.cjs';
-import { I as InstrumentId, a as InstrumentDef, S as Schedule, D as DrumVoice, T as TempoSegment } from '../schedule-V-fgepvP.cjs';
-export { A as ARC_RAW_RE, b as DEFAULT_SOUNDS_BASE, c as DRUM_KIT_BASE, G as GRACE_STEP, d as GlideLeg, e as INSTRUMENTS, L as Line, M as MEEND_HOLD, P as PlayEvent, f as SALAMANDER_BASE, g as SAMPLED_TAALS, h as ScheduleOptions, i as TABLA_BPMS, j as TABLA_VARIATIONS, k as TONEJS_INSTRUMENTS_BASE, l as ToneModule, m as buildSchedule, n as createBuffers, o as drumPattern, p as eventAt, q as glideTargets, r as graceTouches, s as instrumentSampleUrl, t as isArcRaw, u as meendContinuations, v as nearestSampleKey, w as nearestTablaBpm, x as normalizeBase, y as probeUrl, z as quantizeLoopEnd, B as santoorUrls, C as scheduleLines, E as subsetUrls, F as tablaBpms, H as tablaUrl, J as triggerGlide } from '../schedule-V-fgepvP.cjs';
+import { I as InstrumentId, a as InstrumentDef, E as Excerpt, S as Schedule, D as DrumVoice, T as TempoSegment } from '../instruments-DTIuTlda.cjs';
+export { A as ARC_RAW_RE, b as DEFAULT_SOUNDS_BASE, c as DRUM_KIT_BASE, G as GRACE_STEP, d as GlideLeg, e as INSTRUMENTS, L as Line, f as LyricMap, M as MEEND_HOLD, P as PlayEvent, g as SALAMANDER_BASE, h as SAMPLED_TAALS, i as ScheduleOptions, j as TABLA_BPMS, k as TABLA_VARIATIONS, l as TONEJS_INSTRUMENTS_BASE, m as ToneModule, n as alignLyrics, o as buildSchedule, p as createBuffers, q as drumPattern, r as eventAt, s as glideTargets, t as graceTouches, u as instrumentSampleUrl, v as isArcRaw, w as lyricCues, x as meendContinuations, y as nearestSampleKey, z as nearestTablaBpm, B as normalizeBase, C as probeUrl, F as quantizeLoopEnd, H as santoorUrls, J as scheduleLines, K as subsetUrls, N as tablaBpms, O as tablaUrl, Q as triggerGlide } from '../instruments-DTIuTlda.cjs';
 import 'zod';
 import 'tone';
 
@@ -140,8 +140,12 @@ declare class SwaralipiPlayer {
     get loop(): LineRange | null;
     /** Whether each repeat is followed by a silent pass for the learner. */
     get echo(): boolean;
-    /** Set the document to play. Stops any current playback. */
-    load(doc: Swaralipi): void;
+    /** 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: Swaralipi, { excerpt }?: {
+        excerpt?: Excerpt;
+    }): void;
     /**
      * Taal mode: loop one avartan of a taal's theka (rhythm only, no melody) —
      * for a standalone theka player. `play()` loops indefinitely (tabla loop /
@@ -235,6 +239,10 @@ declare class SwaralipiPlayer {
 
 type AudioFormat = 'wav' | 'mp3';
 interface AudioExportOptions {
+    /** Play only the notes singing these stretches of the text (see alignLyrics). */
+    excerpt?: Excerpt;
+    /** The song's words: when given, the result carries their `cues` (an LRC's timing). */
+    lyrics?: string;
     /** Samples host (santoor/tabla/tanpura/metronome). Default the project CDN. */
     soundsBaseUrl?: string;
     /** Self-host the grand piano (see the player's `pianoBaseUrl`). */
@@ -289,6 +297,15 @@ interface AudioExportResult {
     mimeType: string;
     /** Rendered length in seconds. */
     durationSec: number;
+    /** Each sung line and its words, in seconds on this file's timeline (given `lyrics`). */
+    cues?: LyricCue[];
+}
+interface LyricCue {
+    sec: number;
+    words: {
+        sec: number;
+        text: string;
+    }[];
 }
 /**
  * Render a swaralipi doc to an audio Blob in the browser. Runs in an
@@ -304,11 +321,17 @@ declare function exportAudio(doc: Swaralipi, options?: AudioExportOptions): Prom
  */
 declare function encodeWav(channels: Float32Array[], sampleRate: number): Uint8Array;
 /**
- * Encode planar float channels to MP3 via lamejs. lamejs is **dynamically
- * imported** and an *optional* peer dependency (LGPL-3.0) — WAV needs no
- * dependency, so only reach for this when a compressed file is wanted. Samples
- * are fed in 1152-frame blocks (a multiple of 576, lamejs' preferred size).
+ * A streaming MP3 encoder: feed 16-bit PCM in any number of pieces, get one MP3 — one encoder
+ * delay, so a track joined from several renders keeps its timing. lamejs is **dynamically
+ * imported** and an *optional* peer dependency (LGPL-3.0). Samples go in 1152-frame blocks (a
+ * multiple of 576, lamejs' preferred size).
  */
+declare function mp3Stream(sampleRate?: number, kbps?: number, channels?: 1 | 2): Promise<{
+    push(left: Int16Array, right?: Int16Array): void;
+    end(): Uint8Array[];
+}>;
+/** Encode planar float channels to MP3 via lamejs (see mp3Stream). WAV needs no dependency, so
+ * only reach for this when a compressed file is wanted. */
 declare function encodeMp3(channels: Float32Array[], sampleRate: number, kbps?: number): Promise<Uint8Array>;
 
 /**
@@ -329,6 +352,8 @@ declare function encodeMp3(channels: Float32Array[], sampleRate: number, kbps?:
  */
 
 interface MidiExportOptions {
+    /** Play only the notes singing these stretches of the text (see alignLyrics). */
+    excerpt?: Excerpt;
     /** Tonic (Sa). Accepts `C`, `C#`, `cs`… Default: doc tonic, else `C`. */
     tonic?: string;
     /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */
@@ -353,13 +378,6 @@ interface MidiExportResult {
     filename: string;
     mimeType: string;
 }
-/**
- * Encode a schedule to a Standard MIDI File. Melody rides channel 0; when
- * `drums` is given, its per-matra voices ride a second GM channel-10 track
- * (the file becomes format 1). `drums` is one pattern for the whole song, or a
- * function picking each লয় / তাল segment's own (তালফেরতা; `undefined` = rest).
- * Pure — no Tone, no browser — directly testable.
- */
 declare function encodeMidi(schedule: Schedule, opts: {
     bpm: number;
     name?: string;
@@ -370,6 +388,12 @@ declare function encodeMidi(schedule: Schedule, opts: {
  * beyond `Blob` (present in Node 20+ too), so it works client-side or server-side.
  */
 declare function exportMidi(doc: Swaralipi, options?: MidiExportOptions): MidiExportResult;
+/** Several songs on one timeline (a whole dance-drama), back to back with two beats' rest:
+ * each song opens with its own tempo and a marker naming it; drums share one channel-10 track. */
+declare function exportMidiSet(items: {
+    doc: Swaralipi;
+    options?: MidiExportOptions;
+}[], name: string): MidiExportResult;
 
 /** Octave register offset in octaves, relative to madhyam (middle). */
 declare const OCTAVE_OFFSET: Record<Octave, number>;
@@ -417,4 +441,4 @@ declare function sampleFileName(midi: number): string;
  */
 declare function sCurve(x: number, steepness?: number): number;
 
-export { type AudioExportOptions, type AudioExportResult, type AudioFormat, type BindSheetOptions, DrumVoice, InstrumentDef, InstrumentId, LaySpeeds, type LineRange, type MidiExportOptions, type MidiExportResult, OCTAVE_OFFSET, type PlayerOptions, type PlayerState, type PracticeState, type RhythmMode, SHUDDHA, Schedule, SwaralipiPlayer, TempoSegment, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi, midiToSampleName, parseTonic, sCurve, sampleFileName, svaraSemitone, svaraToMidi };
+export { type AudioExportOptions, type AudioExportResult, type AudioFormat, type BindSheetOptions, DrumVoice, Excerpt, InstrumentDef, InstrumentId, LaySpeeds, type LineRange, type LyricCue, type MidiExportOptions, type MidiExportResult, OCTAVE_OFFSET, type PlayerOptions, type PlayerState, type PracticeState, type RhythmMode, SHUDDHA, Schedule, SwaralipiPlayer, TempoSegment, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi, exportMidiSet, midiToSampleName, mp3Stream, parseTonic, sCurve, sampleFileName, svaraSemitone, svaraToMidi };

package/dist/player/index.d.ts

@@ -1,8 +1,8 @@
 import { S as Swaralipi, T as Taal, O as Octave, a as SvaraLetter, N as Note } from '../schema-DZag9qkF.js';
 import { a as LaySpeeds, T as TaalId } from '../lay-CWlEhImP.js';
 export { b as LAYS, c as LAY_SPEEDS, L as Lay, p as printedLay, r as resolveLaySpeeds, d as rowLay } from '../lay-CWlEhImP.js';
-import { I as InstrumentId, a as InstrumentDef, S as Schedule, D as DrumVoice, T as TempoSegment } from '../schedule-ClyON98C.js';
-export { A as ARC_RAW_RE, b as DEFAULT_SOUNDS_BASE, c as DRUM_KIT_BASE, G as GRACE_STEP, d as GlideLeg, e as INSTRUMENTS, L as Line, M as MEEND_HOLD, P as PlayEvent, f as SALAMANDER_BASE, g as SAMPLED_TAALS, h as ScheduleOptions, i as TABLA_BPMS, j as TABLA_VARIATIONS, k as TONEJS_INSTRUMENTS_BASE, l as ToneModule, m as buildSchedule, n as createBuffers, o as drumPattern, p as eventAt, q as glideTargets, r as graceTouches, s as instrumentSampleUrl, t as isArcRaw, u as meendContinuations, v as nearestSampleKey, w as nearestTablaBpm, x as normalizeBase, y as probeUrl, z as quantizeLoopEnd, B as santoorUrls, C as scheduleLines, E as subsetUrls, F as tablaBpms, H as tablaUrl, J as triggerGlide } from '../schedule-ClyON98C.js';
+import { I as InstrumentId, a as InstrumentDef, E as Excerpt, S as Schedule, D as DrumVoice, T as TempoSegment } from '../instruments-NcUb0ozc.js';
+export { A as ARC_RAW_RE, b as DEFAULT_SOUNDS_BASE, c as DRUM_KIT_BASE, G as GRACE_STEP, d as GlideLeg, e as INSTRUMENTS, L as Line, f as LyricMap, M as MEEND_HOLD, P as PlayEvent, g as SALAMANDER_BASE, h as SAMPLED_TAALS, i as ScheduleOptions, j as TABLA_BPMS, k as TABLA_VARIATIONS, l as TONEJS_INSTRUMENTS_BASE, m as ToneModule, n as alignLyrics, o as buildSchedule, p as createBuffers, q as drumPattern, r as eventAt, s as glideTargets, t as graceTouches, u as instrumentSampleUrl, v as isArcRaw, w as lyricCues, x as meendContinuations, y as nearestSampleKey, z as nearestTablaBpm, B as normalizeBase, C as probeUrl, F as quantizeLoopEnd, H as santoorUrls, J as scheduleLines, K as subsetUrls, N as tablaBpms, O as tablaUrl, Q as triggerGlide } from '../instruments-NcUb0ozc.js';
 import 'zod';
 import 'tone';
 
@@ -140,8 +140,12 @@ declare class SwaralipiPlayer {
     get loop(): LineRange | null;
     /** Whether each repeat is followed by a silent pass for the learner. */
     get echo(): boolean;
-    /** Set the document to play. Stops any current playback. */
-    load(doc: Swaralipi): void;
+    /** 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: Swaralipi, { excerpt }?: {
+        excerpt?: Excerpt;
+    }): void;
     /**
      * Taal mode: loop one avartan of a taal's theka (rhythm only, no melody) —
      * for a standalone theka player. `play()` loops indefinitely (tabla loop /
@@ -235,6 +239,10 @@ declare class SwaralipiPlayer {
 
 type AudioFormat = 'wav' | 'mp3';
 interface AudioExportOptions {
+    /** Play only the notes singing these stretches of the text (see alignLyrics). */
+    excerpt?: Excerpt;
+    /** The song's words: when given, the result carries their `cues` (an LRC's timing). */
+    lyrics?: string;
     /** Samples host (santoor/tabla/tanpura/metronome). Default the project CDN. */
     soundsBaseUrl?: string;
     /** Self-host the grand piano (see the player's `pianoBaseUrl`). */
@@ -289,6 +297,15 @@ interface AudioExportResult {
     mimeType: string;
     /** Rendered length in seconds. */
     durationSec: number;
+    /** Each sung line and its words, in seconds on this file's timeline (given `lyrics`). */
+    cues?: LyricCue[];
+}
+interface LyricCue {
+    sec: number;
+    words: {
+        sec: number;
+        text: string;
+    }[];
 }
 /**
  * Render a swaralipi doc to an audio Blob in the browser. Runs in an
@@ -304,11 +321,17 @@ declare function exportAudio(doc: Swaralipi, options?: AudioExportOptions): Prom
  */
 declare function encodeWav(channels: Float32Array[], sampleRate: number): Uint8Array;
 /**
- * Encode planar float channels to MP3 via lamejs. lamejs is **dynamically
- * imported** and an *optional* peer dependency (LGPL-3.0) — WAV needs no
- * dependency, so only reach for this when a compressed file is wanted. Samples
- * are fed in 1152-frame blocks (a multiple of 576, lamejs' preferred size).
+ * A streaming MP3 encoder: feed 16-bit PCM in any number of pieces, get one MP3 — one encoder
+ * delay, so a track joined from several renders keeps its timing. lamejs is **dynamically
+ * imported** and an *optional* peer dependency (LGPL-3.0). Samples go in 1152-frame blocks (a
+ * multiple of 576, lamejs' preferred size).
  */
+declare function mp3Stream(sampleRate?: number, kbps?: number, channels?: 1 | 2): Promise<{
+    push(left: Int16Array, right?: Int16Array): void;
+    end(): Uint8Array[];
+}>;
+/** Encode planar float channels to MP3 via lamejs (see mp3Stream). WAV needs no dependency, so
+ * only reach for this when a compressed file is wanted. */
 declare function encodeMp3(channels: Float32Array[], sampleRate: number, kbps?: number): Promise<Uint8Array>;
 
 /**
@@ -329,6 +352,8 @@ declare function encodeMp3(channels: Float32Array[], sampleRate: number, kbps?:
  */
 
 interface MidiExportOptions {
+    /** Play only the notes singing these stretches of the text (see alignLyrics). */
+    excerpt?: Excerpt;
     /** Tonic (Sa). Accepts `C`, `C#`, `cs`… Default: doc tonic, else `C`. */
     tonic?: string;
     /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */
@@ -353,13 +378,6 @@ interface MidiExportResult {
     filename: string;
     mimeType: string;
 }
-/**
- * Encode a schedule to a Standard MIDI File. Melody rides channel 0; when
- * `drums` is given, its per-matra voices ride a second GM channel-10 track
- * (the file becomes format 1). `drums` is one pattern for the whole song, or a
- * function picking each লয় / তাল segment's own (তালফেরতা; `undefined` = rest).
- * Pure — no Tone, no browser — directly testable.
- */
 declare function encodeMidi(schedule: Schedule, opts: {
     bpm: number;
     name?: string;
@@ -370,6 +388,12 @@ declare function encodeMidi(schedule: Schedule, opts: {
  * beyond `Blob` (present in Node 20+ too), so it works client-side or server-side.
  */
 declare function exportMidi(doc: Swaralipi, options?: MidiExportOptions): MidiExportResult;
+/** Several songs on one timeline (a whole dance-drama), back to back with two beats' rest:
+ * each song opens with its own tempo and a marker naming it; drums share one channel-10 track. */
+declare function exportMidiSet(items: {
+    doc: Swaralipi;
+    options?: MidiExportOptions;
+}[], name: string): MidiExportResult;
 
 /** Octave register offset in octaves, relative to madhyam (middle). */
 declare const OCTAVE_OFFSET: Record<Octave, number>;
@@ -417,4 +441,4 @@ declare function sampleFileName(midi: number): string;
  */
 declare function sCurve(x: number, steepness?: number): number;
 
-export { type AudioExportOptions, type AudioExportResult, type AudioFormat, type BindSheetOptions, DrumVoice, InstrumentDef, InstrumentId, LaySpeeds, type LineRange, type MidiExportOptions, type MidiExportResult, OCTAVE_OFFSET, type PlayerOptions, type PlayerState, type PracticeState, type RhythmMode, SHUDDHA, Schedule, SwaralipiPlayer, TempoSegment, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi, midiToSampleName, parseTonic, sCurve, sampleFileName, svaraSemitone, svaraToMidi };
+export { type AudioExportOptions, type AudioExportResult, type AudioFormat, type BindSheetOptions, DrumVoice, Excerpt, InstrumentDef, InstrumentId, LaySpeeds, type LineRange, type LyricCue, type MidiExportOptions, type MidiExportResult, OCTAVE_OFFSET, type PlayerOptions, type PlayerState, type PracticeState, type RhythmMode, SHUDDHA, Schedule, SwaralipiPlayer, TempoSegment, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi, exportMidiSet, midiToSampleName, mp3Stream, parseTonic, sCurve, sampleFileName, svaraSemitone, svaraToMidi };

package/dist/player/index.js

@@ -1,5 +1,5 @@
-import { DEFAULT_SOUNDS_BASE, INSTRUMENTS, SAMPLED_TAALS, buildSchedule, eventAt, lineAt, byRow, lineFor, quantizeLoopEnd, instrumentSampleUrl, probeUrl, scheduleLines, GRACE_STEP, normalizeBase, nearestTablaBpm, tablaBpms, graceTouches, midiToSampleName, glideTargets, triggerGlide, createSampler, createBuffers, tablaShiftSemitones, tablaUrl, TABLA_GRAIN_OVERLAP_SEC, TABLA_GRAIN_SEC, createDrumKit, drumPattern, createMetronome, TANPURA_PCS, createTanpura, parseTonic, MEEND_HOLD, sCurve } from '../chunk-L6YZ3GC6.js';
-export { ARC_RAW_RE, DEFAULT_SOUNDS_BASE, DRUM_KIT_BASE, GRACE_STEP, INSTRUMENTS, MEEND_HOLD, OCTAVE_OFFSET, SALAMANDER_BASE, SAMPLED_TAALS, SHUDDHA, TABLA_BPMS, TABLA_VARIATIONS, TONEJS_INSTRUMENTS_BASE, buildSchedule, createBuffers, drumPattern, eventAt, glideTargets, graceTouches, instrumentSampleUrl, isArcRaw, meendContinuations, midiToSampleName, nearestSampleKey, nearestTablaBpm, normalizeBase, parseTonic, probeUrl, quantizeLoopEnd, sCurve, sampleFileName, santoorUrls, scheduleLines, subsetUrls, svaraSemitone, svaraToMidi, tablaBpms, tablaUrl, triggerGlide } from '../chunk-L6YZ3GC6.js';
+import { DEFAULT_SOUNDS_BASE, INSTRUMENTS, SAMPLED_TAALS, buildSchedule, eventAt, lineAt, byRow, lineFor, quantizeLoopEnd, instrumentSampleUrl, probeUrl, scheduleLines, GRACE_STEP, normalizeBase, nearestTablaBpm, tablaBpms, graceTouches, midiToSampleName, glideTargets, triggerGlide, createSampler, createBuffers, tablaShiftSemitones, tablaUrl, TABLA_GRAIN_OVERLAP_SEC, TABLA_GRAIN_SEC, createDrumKit, drumPattern, createMetronome, TANPURA_PCS, createTanpura, parseTonic, lyricCues, alignLyrics, MEEND_HOLD, sCurve } from '../chunk-GIOGYJMM.js';
+export { ARC_RAW_RE, DEFAULT_SOUNDS_BASE, DRUM_KIT_BASE, GRACE_STEP, INSTRUMENTS, MEEND_HOLD, OCTAVE_OFFSET, SALAMANDER_BASE, SAMPLED_TAALS, SHUDDHA, TABLA_BPMS, TABLA_VARIATIONS, TONEJS_INSTRUMENTS_BASE, alignLyrics, buildSchedule, createBuffers, drumPattern, eventAt, glideTargets, graceTouches, instrumentSampleUrl, isArcRaw, lyricCues, meendContinuations, midiToSampleName, nearestSampleKey, nearestTablaBpm, normalizeBase, parseTonic, probeUrl, quantizeLoopEnd, sCurve, sampleFileName, santoorUrls, scheduleLines, subsetUrls, svaraSemitone, svaraToMidi, tablaBpms, tablaUrl, triggerGlide } from '../chunk-GIOGYJMM.js';
 import '../chunk-BSZ3WQUP.js';
 import { TAALS } from '../chunk-KOHSKHXI.js';
 export { LAYS, LAY_SPEEDS, printedLay, resolveLaySpeeds, rowLay } from '../chunk-KOHSKHXI.js';
@@ -45,6 +45,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;
@@ -87,6 +89,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;
@@ -177,10 +181,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;
@@ -503,7 +510,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);
@@ -615,6 +622,7 @@ var SwaralipiPlayer = class {
     this.#opts.onState?.(state);
   }
   #emitHighlight(path, yourTurn = false) {
+    this.#paint?.(path, yourTurn);
     this.#opts.onHighlight?.(path, yourTurn);
   }
   #emitLoop() {
@@ -772,7 +780,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
@@ -1095,6 +1104,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;
@@ -1123,7 +1164,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);
@@ -1136,7 +1178,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();
@@ -1283,11 +1326,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) {
@@ -1354,22 +1402,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
@@ -1415,6 +1473,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;
@@ -1422,22 +1485,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;
@@ -1447,72 +1510,90 @@ 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" };
+}
 
-export { SwaralipiPlayer, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi };
+export { SwaralipiPlayer, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi, exportMidiSet, mp3Stream };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map