@ugfoundation/swaralipi-js 0.7.6 → 0.8.0

package/dist/player/index.d.cts

@@ -1,7 +1,8 @@
-import { S as Swaralipi, T as Taal, O as Octave, a as SvaraLetter, N as Note } from '../schema-DqBXPGkL.cjs';
-import { T as TaalId } from '../taals-CjzBuZ35.cjs';
-import { I as InstrumentId, a as InstrumentDef, S as Schedule, D as DrumVoice } from '../schedule-BpBYGXPL.cjs';
-export { A as ARC_RAW_RE, b as DEFAULT_SOUNDS_BASE, c as DRUM_KIT_BASE, G as GlideLeg, d as INSTRUMENTS, M as MEEND_HOLD, P as PlayEvent, e as SALAMANDER_BASE, f as SAMPLED_TAALS, g as ScheduleOptions, T as TABLA_BPMS, h as TABLA_VARIATIONS, i as TONEJS_INSTRUMENTS_BASE, j as ToneModule, k as buildSchedule, l as createBuffers, m as drumPattern, n as glideTargets, o as instrumentSampleUrl, p as isArcRaw, q as meendContinuations, r as nearestSampleKey, s as nearestTablaBpm, t as normalizeBase, u as probeUrl, v as quantizeLoopEnd, w as santoorUrls, x as subsetUrls, y as tablaBpms, z as tablaUrl, B as triggerGlide } from '../schedule-BpBYGXPL.cjs';
+import { S as Swaralipi, T as Taal, O as Octave, a as SvaraLetter, N as Note } from '../schema-DGA_bNVZ.cjs';
+import { a as LaySpeeds, T as TaalId } from '../lay-Csa4CD46.cjs';
+export { b as LAYS, c as LAY_SPEEDS, L as Lay, p as printedLay, r as resolveLaySpeeds, d as rowLay } from '../lay-Csa4CD46.cjs';
+import { I as InstrumentId, a as InstrumentDef, S as Schedule, D as DrumVoice } from '../schedule-B_UaluBi.cjs';
+export { A as ARC_RAW_RE, b as DEFAULT_SOUNDS_BASE, c as DRUM_KIT_BASE, G as GlideLeg, d as INSTRUMENTS, M as MEEND_HOLD, P as PlayEvent, e as SALAMANDER_BASE, f as SAMPLED_TAALS, g as ScheduleOptions, T as TABLA_BPMS, h as TABLA_VARIATIONS, i as TONEJS_INSTRUMENTS_BASE, j as TempoSegment, k as ToneModule, l as buildSchedule, m as createBuffers, n as drumPattern, o as glideTargets, p as instrumentSampleUrl, q as isArcRaw, r as meendContinuations, s as nearestSampleKey, t as nearestTablaBpm, u as normalizeBase, v as probeUrl, w as quantizeLoopEnd, x as santoorUrls, y as subsetUrls, z as tablaBpms, B as tablaUrl, C as triggerGlide } from '../schedule-B_UaluBi.cjs';
 import 'zod';
 import 'tone';
 
@@ -17,8 +18,13 @@ interface PlayerOptions {
     pianoBaseUrl?: string;
     /** Tonic (Sa). Accepts `C`, `C#`, `cs`… Default: doc tonic, else `C`. */
     tonic?: string;
-    /** Tempo in matra/min. Default 90. Snapped to the 15-grid while tabla plays. */
+    /** Tempo in matra/min — the **দ্রুত** (fast) tempo; লয় marks scale down from
+     * it. Default 90. Snapped to the 15-grid while tabla plays. */
     bpm?: number;
+    /** Override the লয় tempo factors, e.g. `{ vilambit: 0.6 }`. Defaults come
+     * from the document's `meta.laySpeeds`, else `LAY_SPEEDS` (drut 1, madhya
+     * 0.75, vilambit 0.5). */
+    laySpeeds?: LaySpeeds;
     /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */
     baseOctave?: number;
     /** Active melody instrument id (a built-in or a `customInstruments` key).
@@ -168,9 +174,12 @@ interface AudioExportOptions {
     customInstruments?: Record<string, InstrumentDef>;
     /** Tonic (Sa). Accepts `C`, `C#`, `cs`… Default: doc tonic, else `C`. */
     tonic?: string;
-    /** Tempo in matra/min. Default: `meta.bpm`, else 90. Snapped to the tabla grid
-     * when a sampled tabla actually plays. */
+    /** Tempo in matra/min — the **দ্রুত** (fast) tempo; লয় marks scale down from
+     * it. Default: `meta.bpm`, else 90. Snapped to the tabla grid when a sampled
+     * tabla actually plays. */
     bpm?: number;
+    /** Override the লয় tempo factors (see LAY_SPEEDS / meta.laySpeeds). */
+    laySpeeds?: LaySpeeds;
     /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */
     baseOctave?: number;
     /** Melody instrument id. Default `piano`. */
@@ -252,8 +261,12 @@ interface MidiExportOptions {
     tonic?: string;
     /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */
     baseOctave?: number;
-    /** Tempo in matra/min written as the file's tempo. Default `meta.bpm`, else 90. */
+    /** Tempo in matra/min written as the file's tempo — the **দ্রুত** tempo;
+     * লয় marks come out as longer note values against it, not as tempo changes.
+     * Default `meta.bpm`, else 90. */
     bpm?: number;
+    /** Override the লয় tempo factors (see LAY_SPEEDS / meta.laySpeeds). */
+    laySpeeds?: LaySpeeds;
     /** Track name meta-event. Default the song title. */
     name?: string;
     /** Also export the taal's drumset pattern as a separate GM channel-10 track. */
@@ -327,4 +340,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, type MidiExportOptions, type MidiExportResult, OCTAVE_OFFSET, type PlayerOptions, type PlayerState, type RhythmMode, SHUDDHA, Schedule, SwaralipiPlayer, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi, midiToSampleName, parseTonic, sCurve, sampleFileName, svaraSemitone, svaraToMidi };
+export { type AudioExportOptions, type AudioExportResult, type AudioFormat, type BindSheetOptions, DrumVoice, InstrumentDef, InstrumentId, LaySpeeds, type MidiExportOptions, type MidiExportResult, OCTAVE_OFFSET, type PlayerOptions, type PlayerState, type RhythmMode, SHUDDHA, Schedule, SwaralipiPlayer, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi, midiToSampleName, parseTonic, sCurve, sampleFileName, svaraSemitone, svaraToMidi };

package/dist/player/index.d.ts

@@ -1,7 +1,8 @@
-import { S as Swaralipi, T as Taal, O as Octave, a as SvaraLetter, N as Note } from '../schema-DqBXPGkL.js';
-import { T as TaalId } from '../taals-CjzBuZ35.js';
-import { I as InstrumentId, a as InstrumentDef, S as Schedule, D as DrumVoice } from '../schedule-Tzk01FKj.js';
-export { A as ARC_RAW_RE, b as DEFAULT_SOUNDS_BASE, c as DRUM_KIT_BASE, G as GlideLeg, d as INSTRUMENTS, M as MEEND_HOLD, P as PlayEvent, e as SALAMANDER_BASE, f as SAMPLED_TAALS, g as ScheduleOptions, T as TABLA_BPMS, h as TABLA_VARIATIONS, i as TONEJS_INSTRUMENTS_BASE, j as ToneModule, k as buildSchedule, l as createBuffers, m as drumPattern, n as glideTargets, o as instrumentSampleUrl, p as isArcRaw, q as meendContinuations, r as nearestSampleKey, s as nearestTablaBpm, t as normalizeBase, u as probeUrl, v as quantizeLoopEnd, w as santoorUrls, x as subsetUrls, y as tablaBpms, z as tablaUrl, B as triggerGlide } from '../schedule-Tzk01FKj.js';
+import { S as Swaralipi, T as Taal, O as Octave, a as SvaraLetter, N as Note } from '../schema-DGA_bNVZ.js';
+import { a as LaySpeeds, T as TaalId } from '../lay-Ct9ky_EE.js';
+export { b as LAYS, c as LAY_SPEEDS, L as Lay, p as printedLay, r as resolveLaySpeeds, d as rowLay } from '../lay-Ct9ky_EE.js';
+import { I as InstrumentId, a as InstrumentDef, S as Schedule, D as DrumVoice } from '../schedule-CdILTNsk.js';
+export { A as ARC_RAW_RE, b as DEFAULT_SOUNDS_BASE, c as DRUM_KIT_BASE, G as GlideLeg, d as INSTRUMENTS, M as MEEND_HOLD, P as PlayEvent, e as SALAMANDER_BASE, f as SAMPLED_TAALS, g as ScheduleOptions, T as TABLA_BPMS, h as TABLA_VARIATIONS, i as TONEJS_INSTRUMENTS_BASE, j as TempoSegment, k as ToneModule, l as buildSchedule, m as createBuffers, n as drumPattern, o as glideTargets, p as instrumentSampleUrl, q as isArcRaw, r as meendContinuations, s as nearestSampleKey, t as nearestTablaBpm, u as normalizeBase, v as probeUrl, w as quantizeLoopEnd, x as santoorUrls, y as subsetUrls, z as tablaBpms, B as tablaUrl, C as triggerGlide } from '../schedule-CdILTNsk.js';
 import 'zod';
 import 'tone';
 
@@ -17,8 +18,13 @@ interface PlayerOptions {
     pianoBaseUrl?: string;
     /** Tonic (Sa). Accepts `C`, `C#`, `cs`… Default: doc tonic, else `C`. */
     tonic?: string;
-    /** Tempo in matra/min. Default 90. Snapped to the 15-grid while tabla plays. */
+    /** Tempo in matra/min — the **দ্রুত** (fast) tempo; লয় marks scale down from
+     * it. Default 90. Snapped to the 15-grid while tabla plays. */
     bpm?: number;
+    /** Override the লয় tempo factors, e.g. `{ vilambit: 0.6 }`. Defaults come
+     * from the document's `meta.laySpeeds`, else `LAY_SPEEDS` (drut 1, madhya
+     * 0.75, vilambit 0.5). */
+    laySpeeds?: LaySpeeds;
     /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */
     baseOctave?: number;
     /** Active melody instrument id (a built-in or a `customInstruments` key).
@@ -168,9 +174,12 @@ interface AudioExportOptions {
     customInstruments?: Record<string, InstrumentDef>;
     /** Tonic (Sa). Accepts `C`, `C#`, `cs`… Default: doc tonic, else `C`. */
     tonic?: string;
-    /** Tempo in matra/min. Default: `meta.bpm`, else 90. Snapped to the tabla grid
-     * when a sampled tabla actually plays. */
+    /** Tempo in matra/min — the **দ্রুত** (fast) tempo; লয় marks scale down from
+     * it. Default: `meta.bpm`, else 90. Snapped to the tabla grid when a sampled
+     * tabla actually plays. */
     bpm?: number;
+    /** Override the লয় tempo factors (see LAY_SPEEDS / meta.laySpeeds). */
+    laySpeeds?: LaySpeeds;
     /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */
     baseOctave?: number;
     /** Melody instrument id. Default `piano`. */
@@ -252,8 +261,12 @@ interface MidiExportOptions {
     tonic?: string;
     /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */
     baseOctave?: number;
-    /** Tempo in matra/min written as the file's tempo. Default `meta.bpm`, else 90. */
+    /** Tempo in matra/min written as the file's tempo — the **দ্রুত** tempo;
+     * লয় marks come out as longer note values against it, not as tempo changes.
+     * Default `meta.bpm`, else 90. */
     bpm?: number;
+    /** Override the লয় tempo factors (see LAY_SPEEDS / meta.laySpeeds). */
+    laySpeeds?: LaySpeeds;
     /** Track name meta-event. Default the song title. */
     name?: string;
     /** Also export the taal's drumset pattern as a separate GM channel-10 track. */
@@ -327,4 +340,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, type MidiExportOptions, type MidiExportResult, OCTAVE_OFFSET, type PlayerOptions, type PlayerState, type RhythmMode, SHUDDHA, Schedule, SwaralipiPlayer, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi, midiToSampleName, parseTonic, sCurve, sampleFileName, svaraSemitone, svaraToMidi };
+export { type AudioExportOptions, type AudioExportResult, type AudioFormat, type BindSheetOptions, DrumVoice, InstrumentDef, InstrumentId, LaySpeeds, type MidiExportOptions, type MidiExportResult, OCTAVE_OFFSET, type PlayerOptions, type PlayerState, type RhythmMode, SHUDDHA, Schedule, SwaralipiPlayer, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi, midiToSampleName, parseTonic, sCurve, sampleFileName, svaraSemitone, svaraToMidi };

package/dist/player/index.js

@@ -1,9 +1,14 @@
-import { DEFAULT_SOUNDS_BASE, INSTRUMENTS, SAMPLED_TAALS, buildSchedule, instrumentSampleUrl, probeUrl, normalizeBase, nearestTablaBpm, tablaBpms, quantizeLoopEnd, midiToSampleName, glideTargets, triggerGlide, createSampler, createBuffers, tablaUrl, tablaShiftSemitones, TABLA_GRAIN_OVERLAP_SEC, TABLA_GRAIN_SEC, createDrumKit, drumPattern, createMetronome, TANPURA_PCS, createTanpura, parseTonic, MEEND_HOLD, sCurve } from '../chunk-2SAZWTTK.js';
-export { ARC_RAW_RE, DEFAULT_SOUNDS_BASE, DRUM_KIT_BASE, INSTRUMENTS, MEEND_HOLD, OCTAVE_OFFSET, SALAMANDER_BASE, SAMPLED_TAALS, SHUDDHA, TABLA_BPMS, TABLA_VARIATIONS, TONEJS_INSTRUMENTS_BASE, buildSchedule, createBuffers, drumPattern, glideTargets, instrumentSampleUrl, isArcRaw, meendContinuations, midiToSampleName, nearestSampleKey, nearestTablaBpm, normalizeBase, parseTonic, probeUrl, quantizeLoopEnd, sCurve, sampleFileName, santoorUrls, subsetUrls, svaraSemitone, svaraToMidi, tablaBpms, tablaUrl, triggerGlide } from '../chunk-2SAZWTTK.js';
-import { TAALS } from '../chunk-UF5OSJRP.js';
+import { DEFAULT_SOUNDS_BASE, INSTRUMENTS, SAMPLED_TAALS, buildSchedule, quantizeLoopEnd, instrumentSampleUrl, probeUrl, normalizeBase, nearestTablaBpm, tablaBpms, midiToSampleName, glideTargets, triggerGlide, createSampler, createBuffers, drumPattern, tablaShiftSemitones, tablaUrl, TABLA_GRAIN_OVERLAP_SEC, TABLA_GRAIN_SEC, createDrumKit, createMetronome, TANPURA_PCS, createTanpura, parseTonic, MEEND_HOLD, sCurve } from '../chunk-4IVUPMRK.js';
+export { ARC_RAW_RE, DEFAULT_SOUNDS_BASE, DRUM_KIT_BASE, INSTRUMENTS, MEEND_HOLD, OCTAVE_OFFSET, SALAMANDER_BASE, SAMPLED_TAALS, SHUDDHA, TABLA_BPMS, TABLA_VARIATIONS, TONEJS_INSTRUMENTS_BASE, buildSchedule, createBuffers, drumPattern, glideTargets, instrumentSampleUrl, isArcRaw, meendContinuations, midiToSampleName, nearestSampleKey, nearestTablaBpm, normalizeBase, parseTonic, probeUrl, quantizeLoopEnd, sCurve, sampleFileName, santoorUrls, subsetUrls, svaraSemitone, svaraToMidi, tablaBpms, tablaUrl, triggerGlide } from '../chunk-4IVUPMRK.js';
+import { TAALS } from '../chunk-4HNT6OAT.js';
+export { LAYS, LAY_SPEEDS, printedLay, resolveLaySpeeds, rowLay } from '../chunk-4HNT6OAT.js';
 
 // src/player/player.ts
 var STOP_FADE_SEC = 0.5;
+var LAY_TAIL_SEC = 0.12;
+var TAAL_MODE_TEMPO = [
+  { beat: 0, endBeat: Infinity, scale: 1, lay: "drut" }
+];
 var MEDIA_LEAD_SEC = 0.25;
 function midiRange(schedule) {
   let lo = Infinity;
@@ -48,8 +53,11 @@ var SwaralipiPlayer = class {
   #tanpura;
   #tanpuraKey = "";
   #metronome;
-  /** The looping tabla — a `GrainPlayer` when the tonic needs it retuned. */
-  #tabla;
+  /** The looping tabla — one loop per লয় segment, each a `GrainPlayer` when
+   * the tonic needs retuning or the segment's tempo needs stretching.
+   * `fileSpb` is the recorded loop's OWN beat length, which is the unit
+   * `quantizeLoopEnd` must snap in (loop points are buffer time). */
+  #tabla = [];
   #drums;
   #scheduleIds = [];
   #fadeTimer;
@@ -60,6 +68,7 @@ var SwaralipiPlayer = class {
       customInstruments: options.customInstruments,
       tonic: options.tonic,
       bpm: options.bpm,
+      laySpeeds: options.laySpeeds,
       baseOctave: options.baseOctave ?? 4,
       instrument: options.instrument ?? "piano",
       instruments: options.instruments ?? Object.keys(INSTRUMENTS),
@@ -113,8 +122,7 @@ var SwaralipiPlayer = class {
   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);
+    const full = playDurationSec(buildSchedule(this.#doc, this.#scheduleOpts()), 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
@@ -218,8 +226,7 @@ var SwaralipiPlayer = class {
       transport.cancel(0);
       transport.position = 0;
     }
-    this.#tabla?.dispose();
-    this.#tabla = void 0;
+    this.#disposeTabla();
     this.#restoreMasterGain();
     this.#scheduleIds = [];
     this.#emitHighlight(null);
@@ -237,6 +244,17 @@ var SwaralipiPlayer = class {
     this.#cancelFadeTimer();
     this.#restoreMasterGain();
   }
+  #disposeTabla() {
+    for (const { loop } of this.#tabla) loop.dispose();
+    this.#tabla = [];
+  }
+  /** Snap each loop to a whole number of ITS OWN beats now the buffer length is
+   * known, so a mistrimmed file phase-locks instead of drifting. */
+  #quantizeTablaLoops() {
+    for (const { loop, fileSpb } of this.#tabla) {
+      if (loop.buffer?.loaded) loop.loopEnd = quantizeLoopEnd(loop.buffer.duration, fileSpb);
+    }
+  }
   #restoreMasterGain() {
     if (this.#master !== void 0 && this.#tone !== void 0) {
       this.#master.gain.cancelScheduledValues(this.#tone.now());
@@ -322,10 +340,10 @@ var SwaralipiPlayer = class {
     this.#glide.clear();
     this.#tanpura?.dispose();
     this.#metronome?.dispose();
-    this.#tabla?.dispose();
+    this.#disposeTabla();
     this.#drums?.dispose();
     this.#master?.dispose();
-    this.#tanpura = this.#metronome = this.#tabla = this.#drums = this.#master = void 0;
+    this.#tanpura = this.#metronome = this.#drums = this.#master = void 0;
   }
   /* ----------------------------------------------------------------- */
   /* Internals                                                          */
@@ -380,6 +398,13 @@ var SwaralipiPlayer = class {
     if (def.local === true && !this.#opts.soundsBaseUrl) return this.#fallbackInstrument();
     return id;
   }
+  #scheduleOpts() {
+    return {
+      tonic: this.#opts.tonic,
+      baseOctave: this.#opts.baseOctave,
+      laySpeeds: this.#opts.laySpeeds
+    };
+  }
   /** Effective tempo: snapped to the taal's available tabla tempos while a
    * tabla actually plays (so it never snaps to a bpm that taal lacks). */
   #effectiveBpm() {
@@ -417,23 +442,18 @@ var SwaralipiPlayer = class {
     const bpm = this.#effectiveBpm();
     transport.bpm.value = bpm;
     const spb = 60 / bpm;
-    const schedule = buildSchedule(this.#doc, {
-      tonic: this.#opts.tonic,
-      baseOctave: this.#opts.baseOctave
-    });
+    const schedule = buildSchedule(this.#doc, this.#scheduleOpts());
     const range = midiRange(schedule);
     const id = this.#effectiveInstrument();
     const def = this.#resolveDef(id) ?? INSTRUMENTS.harmonium;
     const melody = this.#buildMelody(Tone, id, base, range);
     const glide = schedule.events.some((ev) => ev.glide === true) ? this.#buildGlide(Tone, id, base, range) : void 0;
-    this.#buildRhythm(Tone, transport, base, spb);
-    this.#buildTanpura(Tone, transport, base, spb);
+    const shift = this.#opts.rhythm !== "none" ? schedule.pickupBeats * spb : 0;
+    this.#buildRhythm(Tone, transport, base, spb, schedule.tempo, shift);
+    this.#buildTanpura(Tone, transport, base, spb, schedule.tempo, shift);
     await loadedOrWarn(Tone);
-    if (this.#tabla?.buffer?.loaded) {
-      this.#tabla.loopEnd = quantizeLoopEnd(this.#tabla.buffer.duration, spb);
-    }
+    this.#quantizeTablaLoops();
     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;
@@ -496,11 +516,9 @@ var SwaralipiPlayer = class {
     const bpm = this.#effectiveBpm();
     transport.bpm.value = bpm;
     const spb = 60 / bpm;
-    this.#buildRhythm(Tone, transport, base, spb);
+    this.#buildRhythm(Tone, transport, base, spb, TAAL_MODE_TEMPO, 0);
     await loadedOrWarn(Tone);
-    if (this.#tabla?.buffer?.loaded) {
-      this.#tabla.loopEnd = quantizeLoopEnd(this.#tabla.buffer.duration, spb);
-    }
+    this.#quantizeTablaLoops();
     const draw = Tone.getDraw();
     const n = Math.max(1, this.#taal.numBeats);
     let beat = 0;
@@ -542,52 +560,92 @@ var SwaralipiPlayer = class {
     this.#glide.set(id, entry);
     return entry;
   }
-  #buildRhythm(Tone, transport, base, spb) {
-    this.#tabla?.dispose();
-    this.#tabla = void 0;
+  /**
+   * Accompaniment, one লয় segment at a time. A tempo change under the melody
+   * is a real tempo change under the drum: the tabla loop is rebuilt at the
+   * segment's own bpm — its own recorded file when the set has one at that
+   * tempo, else the nearest file time-stretched by `GrainPlayer` (which
+   * stretches *without* transposing, unlike a plain playbackRate) — and the
+   * click / drum / drone patterns re-space their interval. A document with no
+   * লয় marks has exactly one segment, so this is the old single-loop path.
+   */
+  #buildRhythm(Tone, transport, base, spb, segments, shift) {
+    this.#disposeTabla();
     const master = this.#ensureMaster(Tone);
     const taalId = this.#taalId();
     const wantsTabla = this.#opts.rhythm === "tabla" && taalId !== void 0 && SAMPLED_TAALS.has(taalId) && base !== void 0;
-    if (wantsTabla) {
-      const url = tablaUrl(base, taalId, nearestTablaBpm(this.bpm, tablaBpms(taalId)), this.#variation());
-      const shift = tablaShiftSemitones(this.#tonicSemitone());
-      this.#tabla = (shift === 0 ? new Tone.Player({ url, loop: true }) : new Tone.GrainPlayer({
-        url,
-        loop: true,
-        detune: shift * 100,
-        grainSize: TABLA_GRAIN_SEC,
-        overlap: TABLA_GRAIN_OVERLAP_SEC
-      })).connect(master);
-      this.#tabla.sync().start(0);
-      return;
-    }
-    if (this.#opts.rhythm === "drums") {
-      this.#drums ??= createDrumKit(Tone).connect(master);
-      const drums = this.#drums;
-      const taal = this.#taal ?? (taalId !== void 0 ? TAALS[taalId] : this.#doc?.meta.taal) ?? { numBeats: 4, sam: 0 };
-      const pattern = drumPattern(taal);
-      let beat2 = 0;
-      const id2 = transport.scheduleRepeat((time) => {
-        const voice = pattern[beat2 % pattern.length];
-        if (drums.has(voice)) drums.player(voice).start(time);
-        beat2 += 1;
-      }, spb, 0);
-      this.#scheduleIds.push(id2);
-      return;
-    }
-    if (this.#opts.rhythm === "none" || base === void 0) return;
-    this.#metronome ??= createMetronome(Tone, base).connect(master);
-    const metro = this.#metronome;
+    if (!wantsTabla && this.#opts.rhythm !== "drums" && (this.#opts.rhythm === "none" || base === void 0)) return;
+    const taal = this.#taal ?? (taalId !== void 0 ? TAALS[taalId] : this.#doc?.meta.taal) ?? { numBeats: 4, sam: 0 };
+    const pattern = this.#opts.rhythm === "drums" ? drumPattern(taal) : [];
     const cycle = this.#taal?.numBeats ?? this.#doc?.meta.taal?.numBeats ?? 4;
-    let beat = 0;
-    const id = transport.scheduleRepeat((time) => {
-      metro.volume.setValueAtTime(beat % cycle === 0 ? 0 : -8, time);
-      metro.start(time);
-      beat += 1;
-    }, spb, 0);
-    this.#scheduleIds.push(id);
+    segments.forEach((seg, i) => {
+      const from = i === 0 ? 0 : seg.beat * spb + shift;
+      const to = i === segments.length - 1 ? Infinity : seg.endBeat * spb + shift;
+      const beatSec = spb / seg.scale;
+      const span = to === Infinity ? void 0 : to - from;
+      if (wantsTabla) {
+        const bpm = 60 / beatSec;
+        const fileBpm = nearestTablaBpm(bpm, tablaBpms(taalId));
+        const rate = bpm / fileBpm;
+        const semis = tablaShiftSemitones(this.#tonicSemitone());
+        const url = tablaUrl(base, taalId, fileBpm, this.#variation());
+        const loop = (rate === 1 && semis === 0 ? new Tone.Player({ url, loop: true }) : new Tone.GrainPlayer({
+          url,
+          loop: true,
+          playbackRate: rate,
+          detune: semis * 100,
+          grainSize: TABLA_GRAIN_SEC,
+          overlap: TABLA_GRAIN_OVERLAP_SEC
+        })).connect(master);
+        loop.sync().start(from);
+        if (span !== void 0) {
+          this.#scheduleIds.push(
+            transport.scheduleOnce((t) => {
+              loop.volume.setValueAtTime(0, t);
+              loop.volume.linearRampToValueAtTime(-40, t + LAY_TAIL_SEC);
+            }, to)
+          );
+          loop.stop(to + LAY_TAIL_SEC);
+        }
+        this.#tabla.push({ loop, fileSpb: 60 / fileBpm });
+        return;
+      }
+      if (this.#opts.rhythm === "drums") {
+        this.#drums ??= createDrumKit(Tone).connect(master);
+        const drums = this.#drums;
+        let beat2 = 0;
+        this.#scheduleIds.push(
+          transport.scheduleRepeat(
+            (time) => {
+              const voice = pattern[beat2 % pattern.length];
+              if (drums.has(voice)) drums.player(voice).start(time);
+              beat2 += 1;
+            },
+            beatSec,
+            from,
+            span
+          )
+        );
+        return;
+      }
+      this.#metronome ??= createMetronome(Tone, base).connect(master);
+      const metro = this.#metronome;
+      let beat = 0;
+      this.#scheduleIds.push(
+        transport.scheduleRepeat(
+          (time) => {
+            metro.volume.setValueAtTime(beat % cycle === 0 ? 0 : -8, time);
+            metro.start(time);
+            beat += 1;
+          },
+          beatSec,
+          from,
+          span
+        )
+      );
+    });
   }
-  #buildTanpura(Tone, transport, base, spb) {
+  #buildTanpura(Tone, transport, base, spb, segments, shift) {
     if (!this.#opts.tanpura || base === void 0) return;
     const tonicPc = (this.#tonicSemitone() % 12 + 12) % 12;
     const sa = TANPURA_PCS[tonicPc];
@@ -601,13 +659,23 @@ var SwaralipiPlayer = class {
     const players = this.#tanpura;
     players.volume.value = -14;
     const pattern = [pa, sa, sa, sa];
-    let i = 0;
-    const id = transport.scheduleRepeat((time) => {
-      const stem = pattern[i % pattern.length];
-      if (players.has(stem)) players.player(stem).start(time);
-      i += 1;
-    }, spb * 2, 0);
-    this.#scheduleIds.push(id);
+    segments.forEach((seg, k) => {
+      const from = k === 0 ? 0 : seg.beat * spb + shift;
+      const to = k === segments.length - 1 ? Infinity : seg.endBeat * spb + shift;
+      let i = 0;
+      this.#scheduleIds.push(
+        transport.scheduleRepeat(
+          (time) => {
+            const stem = pattern[i % pattern.length];
+            if (players.has(stem)) players.player(stem).start(time);
+            i += 1;
+          },
+          spb * 2 / seg.scale,
+          from,
+          to === Infinity ? void 0 : to - from
+        )
+      );
+    });
   }
   #tonicSemitone() {
     return parseTonic(this.#opts.tonic ?? this.#doc?.meta.tonic);
@@ -615,6 +683,7 @@ var SwaralipiPlayer = class {
 };
 
 // src/player/export.ts
+var LAY_TAIL_SEC2 = 0.12;
 function midiRange2(schedule) {
   let lo = Infinity;
   let hi = -Infinity;
@@ -652,7 +721,11 @@ async function exportAudio(doc, options = {}) {
   const rhythm = options.rhythm ?? "none";
   const withMelody = options.melody ?? true;
   const withTanpura = options.tanpura ?? false;
-  const schedule = buildSchedule(doc, { tonic: options.tonic, baseOctave: options.baseOctave });
+  const schedule = buildSchedule(doc, {
+    tonic: options.tonic,
+    baseOctave: options.baseOctave,
+    laySpeeds: options.laySpeeds
+  });
   const range = midiRange2(schedule);
   const taalId = resolveTaal(doc, options.taal);
   const variation = options.taal === void 0 || options.taal === "auto" ? doc.meta.taal?.variation : void 0;
@@ -705,39 +778,67 @@ async function exportAudio(doc, options = {}) {
           }
         });
       }
-      let tabla;
-      if (rhythm === "drums" && base) {
-        const drums = createDrumKit(Tone).connect(master);
+      const tablas = [];
+      if (rhythm !== "none" && base) {
         const taal = taalId !== void 0 ? TAALS[taalId] : doc.meta.taal ?? { numBeats: 4, sam: 0 };
-        const pattern = drumPattern(taal);
-        let beat = 0;
-        transport.scheduleRepeat((time) => {
-          const voice = pattern[beat % pattern.length];
-          if (drums.has(voice)) drums.player(voice).start(time);
-          beat += 1;
-        }, spb, 0);
-      } else if (rhythm !== "none" && base) {
-        if (usesTabla && taalId) {
-          const url = tablaUrl(base, taalId, bpm, variation);
-          const semis = tablaShiftSemitones(parseTonic(options.tonic ?? doc.meta.tonic));
-          tabla = (semis === 0 ? new Tone.Player({ url, loop: true }) : new Tone.GrainPlayer({
-            url,
-            loop: true,
-            detune: semis * 100,
-            grainSize: TABLA_GRAIN_SEC,
-            overlap: TABLA_GRAIN_OVERLAP_SEC
-          })).connect(master);
-          tabla.sync().start(0);
-        } else {
-          const metro = createMetronome(Tone, base).connect(master);
-          const cycle = taalId !== void 0 ? TAALS[taalId].numBeats : doc.meta.taal?.numBeats ?? 4;
-          let beat = 0;
-          transport.scheduleRepeat((time) => {
-            metro.volume.setValueAtTime(beat % cycle === 0 ? 0 : -8, time);
-            metro.start(time);
-            beat += 1;
-          }, spb, 0);
-        }
+        const pattern = rhythm === "drums" ? drumPattern(taal) : [];
+        const drums = rhythm === "drums" ? createDrumKit(Tone).connect(master) : void 0;
+        const metro = rhythm !== "drums" && !usesTabla ? createMetronome(Tone, base).connect(master) : void 0;
+        const cycle = taalId !== void 0 ? TAALS[taalId].numBeats : doc.meta.taal?.numBeats ?? 4;
+        const semis = tablaShiftSemitones(parseTonic(options.tonic ?? doc.meta.tonic));
+        schedule.tempo.forEach((seg, i) => {
+          const from = i === 0 ? 0 : seg.beat * spb + shift;
+          const to = i === schedule.tempo.length - 1 ? Infinity : seg.endBeat * spb + shift;
+          const beatSec = spb / seg.scale;
+          const span = to === Infinity ? void 0 : to - from;
+          if (usesTabla && taalId) {
+            const segBpm = 60 / beatSec;
+            const fileBpm = nearestTablaBpm(segBpm, tablaBpms(taalId));
+            const rate = segBpm / fileBpm;
+            const url = tablaUrl(base, taalId, fileBpm, variation);
+            const loop = (rate === 1 && semis === 0 ? new Tone.Player({ url, loop: true }) : new Tone.GrainPlayer({
+              url,
+              loop: true,
+              playbackRate: rate,
+              detune: semis * 100,
+              grainSize: TABLA_GRAIN_SEC,
+              overlap: TABLA_GRAIN_OVERLAP_SEC
+            })).connect(master);
+            loop.sync().start(from);
+            if (span !== void 0) {
+              transport.scheduleOnce((t) => {
+                loop.volume.setValueAtTime(0, t);
+                loop.volume.linearRampToValueAtTime(-40, t + LAY_TAIL_SEC2);
+              }, to);
+              loop.stop(to + LAY_TAIL_SEC2);
+            }
+            tablas.push({ loop, fileSpb: 60 / fileBpm });
+          } else if (drums !== void 0) {
+            let beat = 0;
+            transport.scheduleRepeat(
+              (time) => {
+                const voice = pattern[beat % pattern.length];
+                if (drums.has(voice)) drums.player(voice).start(time);
+                beat += 1;
+              },
+              beatSec,
+              from,
+              span
+            );
+          } else if (metro !== void 0) {
+            let beat = 0;
+            transport.scheduleRepeat(
+              (time) => {
+                metro.volume.setValueAtTime(beat % cycle === 0 ? 0 : -8, time);
+                metro.start(time);
+                beat += 1;
+              },
+              beatSec,
+              from,
+              span
+            );
+          }
+        });
       }
       if (withTanpura && base) {
         const tonicPc = (parseTonic(options.tonic ?? doc.meta.tonic) % 12 + 12) % 12;
@@ -746,15 +847,26 @@ async function exportAudio(doc, options = {}) {
         const players = createTanpura(Tone, base, [sa, pa]).connect(master);
         players.volume.value = -14;
         const pattern = [pa, sa, sa, sa];
-        let i = 0;
-        transport.scheduleRepeat((time) => {
-          const stem = pattern[i % pattern.length];
-          if (players.has(stem)) players.player(stem).start(time);
-          i += 1;
-        }, spb * 2, 0);
+        schedule.tempo.forEach((seg, k) => {
+          const from = k === 0 ? 0 : seg.beat * spb + shift;
+          const to = k === schedule.tempo.length - 1 ? Infinity : seg.endBeat * spb + shift;
+          let i = 0;
+          transport.scheduleRepeat(
+            (time) => {
+              const stem = pattern[i % pattern.length];
+              if (players.has(stem)) players.player(stem).start(time);
+              i += 1;
+            },
+            spb * 2 / seg.scale,
+            from,
+            to === Infinity ? void 0 : to - from
+          );
+        });
       }
       await Tone.loaded();
-      if (tabla?.buffer?.loaded) tabla.loopEnd = quantizeLoopEnd(tabla.buffer.duration, spb);
+      for (const { loop, fileSpb } of tablas) {
+        if (loop.buffer?.loaded) loop.loopEnd = quantizeLoopEnd(loop.buffer.duration, fileSpb);
+      }
       if (fadeOutSec > 0) {
         master.gain.setValueAtTime(1, Math.max(durationSec - fadeOutSec, 0));
         master.gain.linearRampToValueAtTime(0, durationSec);
@@ -975,7 +1087,11 @@ function safeName2(title) {
   return (title ?? "").replace(/[\\/:*?"<>|]+/g, "").trim() || "swaralipi";
 }
 function exportMidi(doc, options = {}) {
-  const schedule = buildSchedule(doc, { tonic: options.tonic, baseOctave: options.baseOctave });
+  const schedule = buildSchedule(doc, {
+    tonic: options.tonic,
+    baseOctave: options.baseOctave,
+    laySpeeds: options.laySpeeds
+  });
   const bpm = options.bpm ?? doc.meta.bpm ?? 90;
   const taalId = doc.meta.taal?.id;
   const taal = taalId !== void 0 && taalId in TAALS ? TAALS[taalId] : { numBeats: 4, sam: 0 };