@ugfoundation/swaralipi-js 0.1.0 → 0.1.2

package/dist/player/index.cjs

@@ -8,6 +8,8 @@ var TAALS = {
   jhaptaal: { id: "jhaptaal", numBeats: 10, bhaags: [2, 3, 2, 3], sam: 0, khaali: [5] },
   ektaal: { id: "ektaal", numBeats: 12, bhaags: [2, 2, 2, 2, 2, 2], sam: 0, khaali: [2, 6] },
   adachautaal: { id: "adachautaal", numBeats: 14, sam: 0 },
+  shashthi: { id: "shashthi", numBeats: 6, bhaags: [2, 4], sam: 0 },
+  // ষষ্ঠী
   teentaal: { id: "teentaal", numBeats: 16, bhaags: [4, 4, 4, 4], sam: 0, khaali: [8] }
 };
 
@@ -214,6 +216,18 @@ var SAMPLED_TAALS = new Set(
   Object.keys(TAALS)
 );
 var TABLA_BPMS = Array.from({ length: 17 }, (_, i) => 60 + i * 15);
+var TABLA_VARIATIONS = {
+  // ষষ্ঠী loops live under `tabla/shashthi-pro/`; full bpm grid recorded except 225.
+  shashthi: { variations: ["pro"], skipBpms: [225] }
+};
+function tablaBpms(taalId) {
+  const skip = TABLA_VARIATIONS[taalId]?.skipBpms;
+  return skip && skip.length ? TABLA_BPMS.filter((b) => !skip.includes(b)) : TABLA_BPMS;
+}
+function tablaSeg(taalId, variation) {
+  const v = variation ?? TABLA_VARIATIONS[taalId]?.variations[0];
+  return v ? `${taalId}-${v}` : taalId;
+}
 function normalizeBase(url) {
   return url.endsWith("/") ? url : `${url}/`;
 }
@@ -283,11 +297,18 @@ async function probeUrl(url, timeoutMs = 6e3) {
     if (timer !== void 0) clearTimeout(timer);
   }
 }
-function nearestTablaBpm(bpm) {
-  return TABLA_BPMS.reduce((best, b) => Math.abs(b - bpm) < Math.abs(best - bpm) ? b : best, TABLA_BPMS[0]);
+function quantizeLoopEnd(durationSec, spb) {
+  if (spb <= 0) return durationSec;
+  const beats = Math.round(durationSec / spb);
+  if (beats < 1) return durationSec;
+  return Math.min(beats * spb, durationSec);
+}
+function nearestTablaBpm(bpm, bpms = TABLA_BPMS) {
+  return bpms.reduce((best, b) => Math.abs(b - bpm) < Math.abs(best - bpm) ? b : best, bpms[0]);
 }
-function tablaUrl(base, taalId, bpm) {
-  return `${normalizeBase(base)}tabla/${taalId}/${taalId}${bpm}bpm.mp3`;
+function tablaUrl(base, taalId, bpm, variation) {
+  const seg = tablaSeg(taalId, variation);
+  return `${normalizeBase(base)}tabla/${seg}/${seg}${bpm}bpm.mp3`;
 }
 function metronomeUrl(base) {
   return `${normalizeBase(base)}metronome/metro2.mp3`;
@@ -583,6 +604,11 @@ var SwaralipiPlayer = class {
   #emitHighlight(path) {
     this.#opts.onHighlight?.(path);
   }
+  /** The tabla variation to play: the doc's own (in auto mode), else none — an
+   * explicit setTaal override plays the taal's default variation. */
+  #variation() {
+    return this.#taalAuto ? this.#doc?.meta.taal?.variation : void 0;
+  }
   /** Resolve the active taal: an explicit override, else the doc's. */
   #taalId() {
     if (!this.#taalAuto && this.#taalOverride !== void 0) return this.#taalOverride;
@@ -618,9 +644,11 @@ var SwaralipiPlayer = class {
     if (def.local === true && !this.#opts.soundsBaseUrl) return this.#fallbackInstrument();
     return id;
   }
-  /** Effective tempo: snapped to the tabla grid while a tabla actually plays. */
+  /** 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() {
-    return this.usesTabla ? nearestTablaBpm(this.bpm) : this.bpm;
+    const id = this.#taalId();
+    return this.usesTabla && id ? nearestTablaBpm(this.bpm, tablaBpms(id)) : this.bpm;
   }
   async #ensureTone() {
     this.#tone ??= await import('tone');
@@ -661,6 +689,9 @@ var SwaralipiPlayer = class {
     this.#buildRhythm(Tone, transport, base, spb);
     this.#buildTanpura(Tone, transport, base, spb);
     await Tone.loaded();
+    if (this.#tabla?.buffer?.loaded) {
+      this.#tabla.loopEnd = quantizeLoopEnd(this.#tabla.buffer.duration, spb);
+    }
     const draw = Tone.getDraw();
     for (const ev of schedule.events) {
       const at = ev.beat * spb;
@@ -705,7 +736,7 @@ var SwaralipiPlayer = class {
     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));
+      const url = tablaUrl(base, taalId, nearestTablaBpm(this.bpm, tablaBpms(taalId)), this.#variation());
       this.#tabla = new Tone.Player({ url, loop: true }).connect(master);
       this.#tabla.sync().start(0);
       return;
@@ -757,6 +788,7 @@ exports.SAMPLED_TAALS = SAMPLED_TAALS;
 exports.SHUDDHA = SHUDDHA;
 exports.SwaralipiPlayer = SwaralipiPlayer;
 exports.TABLA_BPMS = TABLA_BPMS;
+exports.TABLA_VARIATIONS = TABLA_VARIATIONS;
 exports.TONEJS_INSTRUMENTS_BASE = TONEJS_INSTRUMENTS_BASE;
 exports.buildSchedule = buildSchedule;
 exports.instrumentSampleUrl = instrumentSampleUrl;
@@ -765,11 +797,13 @@ exports.nearestTablaBpm = nearestTablaBpm;
 exports.normalizeBase = normalizeBase;
 exports.parseTonic = parseTonic;
 exports.probeUrl = probeUrl;
+exports.quantizeLoopEnd = quantizeLoopEnd;
 exports.sampleFileName = sampleFileName;
 exports.santoorUrls = santoorUrls;
 exports.subsetUrls = subsetUrls;
 exports.svaraSemitone = svaraSemitone;
 exports.svaraToMidi = svaraToMidi;
+exports.tablaBpms = tablaBpms;
 exports.tablaUrl = tablaUrl;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/player/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/spec/taals.ts","../../src/player/pitch.ts","../../src/player/schedule.ts","../../src/player/instruments.ts","../../src/player/player.ts"],"names":[],"mappings":";;;AAUO,IAAM,KAAA,GAAQ;AAAA,EACnB,OAAO,EAAE,EAAA,EAAI,OAAA,EAAS,QAAA,EAAU,GAAG,MAAA,EAAQ,CAAC,CAAA,EAAG,CAAC,GAAG,GAAA,EAAK,CAAA,EAAG,MAAA,EAAQ,CAAC,CAAC,CAAA,EAAE;AAAA,EACvE,QAAQ,EAAE,EAAA,EAAI,QAAA,EAAU,QAAA,EAAU,GAAG,MAAA,EAAQ,CAAC,CAAA,EAAG,CAAC,GAAG,GAAA,EAAK,CAAA,EAAG,MAAA,EAAQ,CAAC,CAAC,CAAA,EAAE;AAAA,EACzE,OAAO,EAAE,EAAA,EAAI,OAAA,EAAS,QAAA,EAAU,GAAG,MAAA,EAAQ,CAAC,CAAA,EAAG,CAAA,EAAG,CAAC,CAAA,EAAG,GAAA,EAAK,GAAG,MAAA,EAAQ,CAAC,CAAC,CAAA,EAAE;AAAA,EAC1E,UAAU,EAAE,EAAA,EAAI,YAAY,QAAA,EAAU,EAAA,EAAI,QAAQ,CAAC,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAC,CAAA,EAAG,GAAA,EAAK,GAAG,MAAA,EAAQ,CAAC,CAAC,CAAA,EAAE;AAAA,EACpF,MAAA,EAAQ,EAAE,EAAA,EAAI,QAAA,EAAU,UAAU,EAAA,EAAI,MAAA,EAAQ,CAAC,CAAA,EAAG,CAAA,EAAG,GAAG,CAAA,EAAG,CAAA,EAAG,CAAC,CAAA,EAAG,GAAA,EAAK,GAAG,MAAA,EAAQ,CAAC,CAAA,EAAG,CAAC,CAAA,EAAE;AAAA,EACzF,aAAa,EAAE,EAAA,EAAI,eAAe,QAAA,EAAU,EAAA,EAAI,KAAK,CAAA,EAAE;AAAA,EACvD,UAAU,EAAE,EAAA,EAAI,YAAY,QAAA,EAAU,EAAA,EAAI,QAAQ,CAAC,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAC,CAAA,EAAG,GAAA,EAAK,GAAG,MAAA,EAAQ,CAAC,CAAC,CAAA;AACpF,CAAA;;;ACPO,IAAM,aAAA,GAAwC;AAAA,EACnD,YAAA,EAAc,EAAA;AAAA,EACd,MAAA,EAAQ,EAAA;AAAA,EACR,OAAA,EAAS,CAAA;AAAA,EACT,IAAA,EAAM,CAAA;AAAA,EACN,UAAA,EAAY;AACd;AAOO,IAAM,OAAA,GAAuC;AAAA,EAClD,CAAA,EAAG,CAAA;AAAA,EACH,CAAA,EAAG,CAAA;AAAA,EACH,CAAA,EAAG,CAAA;AAAA,EACH,CAAA,EAAG,CAAA;AAAA,EACH,CAAA,EAAG,CAAA;AAAA,EACH,CAAA,EAAG,CAAA;AAAA,EACH,CAAA,EAAG;AACL;AAGA,IAAM,WAAA,GAAc,CAAC,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,MAAM,GAAG,CAAA;AAGpF,IAAM,WAAA,GAAsC;AAAA,EAC1C,CAAA,EAAG,CAAA;AAAA,EACH,IAAA,EAAM,CAAA;AAAA,EACN,EAAA,EAAI,CAAA;AAAA,EACJ,CAAA,EAAG,CAAA;AAAA,EACH,IAAA,EAAM,CAAA;AAAA,EACN,EAAA,EAAI,CAAA;AAAA,EACJ,CAAA,EAAG,CAAA;AAAA,EACH,IAAA,EAAM,CAAA;AAAA,EACN,EAAA,EAAI,CAAA;AAAA,EACJ,CAAA,EAAG,CAAA;AAAA,EACH,IAAA,EAAM,CAAA;AAAA,EACN,EAAA,EAAI,CAAA;AAAA,EACJ,CAAA,EAAG,CAAA;AAAA,EACH,IAAA,EAAM,CAAA;AAAA,EACN,EAAA,EAAI,CAAA;AAAA,EACJ,CAAA,EAAG,CAAA;AAAA,EACH,IAAA,EAAM,EAAA;AAAA,EACN,EAAA,EAAI,EAAA;AAAA,EACJ,CAAA,EAAG,EAAA;AAAA,EACH,IAAA,EAAM,CAAA;AAAA,EACN,EAAA,EAAI;AACN,CAAA;AAOO,SAAS,WAAW,KAAA,EAAmC;AAC5D,EAAA,IAAI,CAAC,OAAO,OAAO,CAAA;AACnB,EAAA,MAAM,GAAA,GAAM,MAAM,IAAA,EAAK,CAAE,aAAY,CAAE,OAAA,CAAQ,MAAM,GAAG,CAAA;AACxD,EAAA,OAAO,WAAA,CAAY,GAAG,CAAA,IAAK,CAAA;AAC7B;AAUO,SAAS,cAAc,IAAA,EAA2B;AACvD,EAAA,IAAI,IAAA,CAAK,KAAA,KAAU,MAAA,EAAW,OAAO,IAAA;AACrC,EAAA,MAAM,GAAG,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA;AACxB,EAAA,IAAI,IAAA,GAAO,QAAQ,MAAM,CAAA;AACzB,EAAA,IAAI,KAAK,KAAA,KAAU,IAAA,IAAQ,IAAA,CAAK,SAAA,KAAc,QAAW,IAAA,IAAQ,CAAA;AACjE,EAAA,IAAI,IAAA,CAAK,KAAA,KAAU,IAAA,EAAM,IAAA,IAAQ,CAAA;AACjC,EAAA,OAAO,IAAA;AACT;AAOO,SAAS,WAAA,CAAY,IAAA,EAAY,OAAA,EAAiB,UAAA,GAAa,CAAA,EAAkB;AACtF,EAAA,MAAM,IAAA,GAAO,cAAc,IAAI,CAAA;AAC/B,EAAA,IAAI,IAAA,KAAS,IAAA,IAAQ,IAAA,CAAK,KAAA,KAAU,QAAW,OAAO,IAAA;AACtD,EAAA,MAAM,CAAC,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA;AACtB,EAAA,OAAA,CAAQ,aAAa,CAAA,GAAI,aAAA,CAAc,MAAM,CAAA,IAAK,KAAK,OAAA,GAAU,IAAA;AACnE;AAGO,SAAS,SAAA,CACd,KAAA,EACA,OAAA,EACA,UAAA,GAAa,CAAA,EACE;AACf,EAAA,IAAI,KAAA,KAAU,QAAW,OAAO,IAAA;AAChC,EAAA,MAAM,CAAC,MAAA,EAAQ,MAAM,CAAA,GAAI,KAAA;AACzB,EAAA,OAAA,CAAQ,UAAA,GAAa,IAAI,aAAA,CAAc,MAAM,KAAK,EAAA,GAAK,OAAA,GAAU,QAAQ,MAAM,CAAA;AACjF;AAGO,SAAS,iBAAiB,IAAA,EAAsB;AACrD,EAAA,MAAM,EAAA,GAAA,CAAO,IAAA,GAAO,EAAA,GAAM,EAAA,IAAM,EAAA;AAChC,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,IAAA,GAAO,EAAE,CAAA,GAAI,CAAA;AACvC,EAAA,OAAO,CAAA,EAAG,WAAA,CAAY,EAAE,CAAC,GAAG,MAAM,CAAA,CAAA;AACpC;AAGO,SAAS,eAAe,IAAA,EAAsB;AACnD,EAAA,OAAO,iBAAiB,IAAI,CAAA,CAAE,aAAY,CAAE,OAAA,CAAQ,KAAK,GAAG,CAAA;AAC9D;;;AC7EA,IAAM,QAAA,GAAW,CAAC,CAAA,KAChB,CAAA,CAAE,KAAA,KAAU,UAAa,CAAA,CAAE,IAAA,KAAS,IAAA,IAAQ,CAAA,CAAE,OAAA,KAAY,IAAA;AAcrD,SAAS,aAAA,CAAc,GAAA,EAAgB,IAAA,GAAwB,EAAC,EAAa;AAClF,EAAA,MAAM,UAAU,UAAA,CAAW,IAAA,CAAK,KAAA,IAAS,GAAA,CAAI,KAAK,KAAK,CAAA;AACvD,EAAA,MAAM,UAAA,GAAa,KAAK,UAAA,IAAc,CAAA;AACtC,EAAA,MAAM,SAAsB,EAAC;AAC7B,EAAA,IAAI,MAAA,GAAS,CAAA;AAEb,EAAA,IAAI,WAAA,GAAc,EAAA;AAElB,EAAA,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,CAAC,IAAA,EAAM,CAAA,KAAM;AAC7B,IAAA,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,CAAC,GAAA,EAAK,CAAA,KAAM;AAC5B,MAAA,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,CAAC,IAAA,EAAM,CAAA,KAAM;AAC7B,QAAA,IAAI,IAAA,CAAK,GAAA,KAAQ,MAAA,IAAa,QAAA,CAAS,IAAI,CAAA,EAAG;AAC9C,QAAA,MAAM,OAAO,CAAA,EAAG,CAAC,CAAA,CAAA,EAAI,CAAC,IAAI,CAAC,CAAA,CAAA;AAC3B,QAAA,MAAM,GAAA,GAAM,KAAK,aAAA,IAAiB,CAAA;AAElC,QAAA,IAAI,IAAA,CAAK,UAAU,MAAA,EAAW;AAE5B,UAAA,MAAA,CAAO,IAAA,CAAK;AAAA,YACV,IAAA,EAAM,MAAA;AAAA,YACN,aAAA,EAAe,GAAA;AAAA,YACf,IAAA,EAAM,WAAA,CAAY,IAAA,EAAM,OAAA,EAAS,UAAU,CAAA;AAAA,YAC3C,GAAA,EAAK,SAAA,CAAU,IAAA,CAAK,GAAA,EAAK,SAAS,UAAU,CAAA;AAAA,YAC5C,IAAA;AAAA,YACA,IAAA,EAAM,IAAA,CAAK,OAAA,KAAY,IAAA,GAAO,SAAA,GAAY;AAAA,WAC3C,CAAA;AACD,UAAA,WAAA,GAAc,OAAO,MAAA,GAAS,CAAA;AAAA,QAChC,CAAA,MAAA,IAAW,IAAA,CAAK,OAAA,KAAY,IAAA,EAAM;AAEhC,UAAA,IAAI,WAAA,IAAe,CAAA,EAAG,MAAA,CAAO,WAAW,EAAG,aAAA,IAAiB,GAAA;AAC5D,UAAA,MAAA,CAAO,IAAA,CAAK,EAAE,IAAA,EAAM,MAAA,EAAQ,aAAA,EAAe,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,WAAW,CAAA;AAAA,QAChG,CAAA,MAAO;AAEL,UAAA,MAAA,CAAO,IAAA,CAAK,EAAE,IAAA,EAAM,MAAA,EAAQ,aAAA,EAAe,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,QAAQ,CAAA;AAAA,QAC7F;AACA,QAAA,MAAA,IAAU,GAAA;AAAA,MACZ,CAAC,CAAA;AAAA,IACH,CAAC,CAAA;AAAA,EACH,CAAC,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,UAAA,EAAY,MAAA,EAAO;AACtC;;;AC/CO,IAAM,mBAAA,GAAsB;AAE5B,IAAM,eAAA,GAAkB;AAExB,IAAM,uBAAA,GAA0B;AAGvC,SAAS,OAAO,IAAA,EAAiD;AAC/D,EAAA,MAAM,IAA4B,EAAC;AACnC,EAAA,KAAA,MAAW,CAAA,IAAK,IAAA,EAAM,CAAA,CAAE,CAAC,CAAA,GAAI,GAAG,CAAA,CAAE,OAAA,CAAQ,GAAA,EAAK,GAAG,CAAC,CAAA,IAAA,CAAA;AACnD,EAAA,OAAO,CAAA;AACT;AAEA,IAAM,UAAA,GAAa;AAAA,EACjB,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,KAAA;AAAA,EACvE,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,KAAA;AAAA,EACvE,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM;AAClC,CAAA;AAEA,IAAM,cAAA,GAAiB;AAAA,EACrB,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,KAAA;AAAA,EAChE,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,KAAA;AAAA,EAChE,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,KAAA;AAAA,EAChE,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO;AACf,CAAA;AACA,IAAM,WAAA,GAAc,CAAC,IAAA,EAAM,IAAA,EAAM,MAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,MAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,MAAM,IAAI,CAAA;AACvG,IAAM,UAAA,GAAa,CAAC,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAI,CAAA;AAKvE,IAAM,WAAA,GAA6C;AAAA,EACxD,KAAA,EAAO,EAAE,KAAA,EAAO,aAAA,EAAe,IAAA,EAAM,MAAA,CAAO,UAAU,CAAA,EAAG,OAAA,EAAS,eAAA,EAAiB,OAAA,EAAS,CAAA,EAAE;AAAA,EAC9F,OAAA,EAAS,EAAE,KAAA,EAAO,SAAA,EAAW,IAAA,EAAM,WAAA,EAAY,EAAG,OAAA,EAAS,UAAA,EAAY,KAAA,EAAO,IAAA,EAAM,OAAA,EAAS,GAAA,EAAI;AAAA,EACjG,SAAA,EAAW,EAAE,KAAA,EAAO,WAAA,EAAa,IAAA,EAAM,MAAA,CAAO,cAAc,CAAA,EAAG,OAAA,EAAS,CAAA,EAAG,uBAAuB,CAAA,UAAA,CAAA,EAAc,SAAS,GAAA,EAAI;AAAA,EAC7H,MAAA,EAAQ,EAAE,KAAA,EAAO,QAAA,EAAU,IAAA,EAAM,MAAA,CAAO,WAAW,CAAA,EAAG,OAAA,EAAS,CAAA,EAAG,uBAAuB,CAAA,OAAA,CAAA,EAAW,SAAS,CAAA,EAAE;AAAA,EAC/G,KAAA,EAAO,EAAE,KAAA,EAAO,OAAA,EAAS,IAAA,EAAM,MAAA,CAAO,UAAU,CAAA,EAAG,OAAA,EAAS,CAAA,EAAG,uBAAuB,CAAA,MAAA,CAAA,EAAU,SAAS,CAAA;AAC3G;AAGO,IAAM,gBAAqC,IAAI,GAAA;AAAA,EACpD,MAAA,CAAO,KAAK,KAAK;AACnB;AAGO,IAAM,UAAA,GAAgC,KAAA,CAAM,IAAA,CAAK,EAAE,MAAA,EAAQ,EAAA,EAAG,EAAG,CAAC,CAAA,EAAG,CAAA,KAAM,EAAA,GAAK,CAAA,GAAI,EAAE;AAGtF,SAAS,cAAc,GAAA,EAAqB;AACjD,EAAA,OAAO,IAAI,QAAA,CAAS,GAAG,CAAA,GAAI,GAAA,GAAM,GAAG,GAAG,CAAA,CAAA,CAAA;AACzC;AAGO,SAAS,WAAA,GAAsC;AACpD,EAAA,MAAM,OAA+B,EAAC;AACtC,EAAA,MAAM,GAAA,GAAM,CAAC,IAAA,KAAiB;AAC5B,IAAA,MAAM,IAAA,GAAO,eAAe,IAAI,CAAA;AAChC,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,EAAK,GAAG,CAAA,CAAE,OAAA,CAAQ,MAAA,EAAQ,CAAC,CAAA,KAAM,CAAA,CAAE,WAAA,EAAa,CAAA;AAC1E,IAAA,IAAA,CAAK,IAAI,CAAA,GAAI,CAAA,EAAG,IAAI,CAAA,IAAA,CAAA;AAAA,EACtB,CAAA;AACA,EAAA,KAAA,IAAS,OAAO,EAAA,EAAI,IAAA,IAAQ,EAAA,EAAI,IAAA,EAAA,MAAY,IAAI,CAAA;AAChD,EAAA,GAAA,CAAI,EAAE,CAAA;AACN,EAAA,OAAO,IAAA;AACT;AAEA,IAAM,OAAA,GAAkC,EAAE,CAAA,EAAG,CAAA,EAAG,GAAG,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,GAAG,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,GAAG,EAAA,EAAG;AAG7E,SAAS,WAAW,IAAA,EAAsB;AAC/C,EAAA,MAAM,CAAA,GAAI,2BAAA,CAA4B,IAAA,CAAK,IAAA,CAAK,MAAM,CAAA;AACtD,EAAA,IAAI,CAAC,GAAG,OAAO,GAAA;AACf,EAAA,MAAM,OAAO,OAAA,CAAQ,CAAA,CAAE,CAAC,CAAA,CAAG,aAAa,CAAA;AACxC,EAAA,MAAM,GAAA,GAAM,CAAA,CAAE,CAAC,CAAA,KAAM,GAAA,GAAM,KAAK,CAAA,CAAE,CAAC,CAAA,KAAM,EAAA,GAAK,CAAA,GAAI,CAAA;AAClD,EAAA,OAAA,CAAQ,OAAO,CAAA,CAAE,CAAC,CAAC,CAAA,GAAI,CAAA,IAAK,KAAK,IAAA,GAAO,GAAA;AAC1C;AAUO,SAAS,UAAA,CACd,IAAA,EACA,EAAA,EACA,EAAA,EACwB;AACxB,EAAA,MAAM,UAAU,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAA,CAChC,IAAI,CAAC,CAAC,CAAA,EAAG,CAAC,OAAO,EAAE,CAAA,EAAG,CAAA,EAAG,IAAA,EAAM,WAAW,CAAC,CAAA,EAAE,CAAE,CAAA,CAC/C,OAAO,CAAC,CAAA,KAAM,MAAA,CAAO,QAAA,CAAS,EAAE,IAAI,CAAC,CAAA,CACrC,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,IAAA,GAAO,EAAE,IAAI,CAAA;AACjC,EAAA,IAAI,QAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,EAAE,GAAG,IAAA,EAAK;AAE3C,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,KAAA,MAAW,CAAA,IAAK,OAAA,EAAS,IAAI,CAAA,CAAE,IAAA,IAAQ,EAAA,IAAM,CAAA,CAAE,IAAA,IAAQ,EAAA,EAAI,IAAA,CAAK,GAAA,CAAI,CAAA,CAAE,CAAC,CAAA;AAEvE,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI,IAAA;AACJ,EAAA,KAAA,MAAW,KAAK,OAAA,EAAS,IAAI,EAAE,IAAA,IAAQ,EAAA,UAAY,CAAA,CAAE,CAAA;AACrD,EAAA,KAAA,MAAW,CAAA,IAAK,OAAA,EAAS,IAAI,CAAA,CAAE,QAAQ,EAAA,EAAI;AAAE,IAAA,IAAA,GAAO,CAAA,CAAE,CAAA;AAAG,IAAA;AAAA,EAAO;AAChE,EAAA,IAAI,KAAA,EAAO,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA;AACzB,EAAA,IAAI,IAAA,EAAM,IAAA,CAAK,GAAA,CAAI,IAAI,CAAA;AACvB,EAAA,IAAI,IAAA,CAAK,SAAS,CAAA,EAAG;AAEnB,IAAA,MAAM,GAAA,GAAA,CAAO,KAAK,EAAA,IAAM,CAAA;AACxB,IAAA,MAAM,UAAU,OAAA,CAAQ,MAAA,CAAO,CAAC,CAAA,EAAG,CAAA,KAAO,KAAK,GAAA,CAAI,CAAA,CAAE,OAAO,GAAG,CAAA,GAAI,KAAK,GAAA,CAAI,CAAA,CAAE,OAAO,GAAG,CAAA,GAAI,IAAI,CAAE,CAAA;AAClG,IAAA,IAAA,CAAK,GAAA,CAAI,QAAQ,CAAC,CAAA;AAAA,EACpB;AAEA,EAAA,MAAM,MAA8B,EAAC;AACrC,EAAA,KAAA,MAAW,CAAA,IAAK,OAAA,EAAS,IAAI,IAAA,CAAK,GAAA,CAAI,CAAA,CAAE,CAAC,CAAA,EAAG,GAAA,CAAI,CAAA,CAAE,CAAC,CAAA,GAAI,CAAA,CAAE,CAAA;AACzD,EAAA,OAAO,GAAA;AACT;AAKO,SAAS,mBAAA,CAAoB,KAAoB,aAAA,EAA4C;AAClG,EAAA,IAAI,GAAA,CAAI,KAAA,IAAS,aAAA,KAAkB,MAAA,EAAW,OAAO,MAAA;AACrD,EAAA,MAAM,IAAA,GAAO,GAAA,CAAI,KAAA,GAAQ,CAAA,EAAG,aAAA,CAAc,aAAA,IAAiB,EAAE,CAAC,CAAA,EAAG,GAAA,CAAI,OAAO,CAAA,CAAA,GAAK,GAAA,CAAI,OAAA;AACrF,EAAA,MAAM,OAAO,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,IAAI,EAAE,CAAC,CAAA;AACtC,EAAA,OAAO,IAAA,KAAS,SAAY,MAAA,GAAY,CAAA,EAAG,cAAc,IAAI,CAAC,GAAG,IAAI,CAAA,CAAA;AACvE;AASA,eAAsB,QAAA,CAAS,GAAA,EAAa,SAAA,GAAY,GAAA,EAAwB;AAC9E,EAAA,IAAI,OAAO,KAAA,KAAU,WAAA,EAAa,OAAO,KAAA;AACzC,EAAA,MAAM,OAAO,OAAO,eAAA,KAAoB,WAAA,GAAc,IAAI,iBAAgB,GAAI,MAAA;AAC9E,EAAA,MAAM,KAAA,GAAQ,OAAO,UAAA,CAAW,MAAM,KAAK,KAAA,EAAM,EAAG,SAAS,CAAA,GAAI,MAAA;AACjE,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,MAC3B,MAAA,EAAQ,KAAA;AAAA,MACR,OAAA,EAAS,EAAE,KAAA,EAAO,WAAA,EAAY;AAAA,MAC9B,KAAA,EAAO,UAAA;AAAA,MACP,QAAQ,IAAA,EAAM;AAAA,KACf,CAAA;AACD,IAAA,OAAO,GAAA,CAAI,EAAA;AAAA,EACb,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT,CAAA,SAAE;AACA,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,YAAA,CAAa,KAAK,CAAA;AAAA,EAC7C;AACF;AAGO,SAAS,gBAAgB,GAAA,EAAqB;AACnD,EAAA,OAAO,WAAW,MAAA,CAAO,CAAC,MAAM,CAAA,KAAO,IAAA,CAAK,IAAI,CAAA,GAAI,GAAG,IAAI,IAAA,CAAK,GAAA,CAAI,OAAO,GAAG,CAAA,GAAI,IAAI,IAAA,EAAO,UAAA,CAAW,CAAC,CAAE,CAAA;AAC7G;AAGO,SAAS,QAAA,CAAS,IAAA,EAAc,MAAA,EAAgB,GAAA,EAAqB;AAC1E,EAAA,OAAO,CAAA,EAAG,cAAc,IAAI,CAAC,SAAS,MAAM,CAAA,CAAA,EAAI,MAAM,CAAA,EAAG,GAAG,CAAA,OAAA,CAAA;AAC9D;AAGO,SAAS,aAAa,IAAA,EAAsB;AACjD,EAAA,OAAO,CAAA,EAAG,aAAA,CAAc,IAAI,CAAC,CAAA,oBAAA,CAAA;AAC/B;AAGO,SAAS,eAAA,CAAgB,MAAkB,IAAA,EAAc;AAC9D,EAAA,OAAO,IAAI,IAAA,CAAK,MAAA,CAAO,YAAA,CAAa,IAAI,CAAC,CAAA;AAC3C;AAGO,IAAM,WAAA,GAAc,CAAC,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,MAAM,GAAG,CAAA;AAOpF,SAAS,aAAA,CACd,IAAA,EACA,GAAA,EACA,aAAA,EACA,KAAA,EACA;AACA,EAAA,MAAM,IAAA,GAAO,GAAA,CAAI,KAAA,GAAQ,CAAA,EAAG,aAAA,CAAc,aAAA,IAAiB,EAAE,CAAC,CAAA,EAAG,GAAA,CAAI,OAAO,CAAA,CAAA,GAAK,GAAA,CAAI,OAAA;AACrF,EAAA,MAAM,IAAA,GAAO,KAAA,GAAQ,UAAA,CAAW,GAAA,CAAI,IAAA,EAAM,MAAM,EAAA,EAAI,KAAA,CAAM,EAAE,CAAA,GAAI,GAAA,CAAI,IAAA;AACpE,EAAA,OAAO,IAAI,IAAA,CAAK,OAAA,CAAQ,EAAE,IAAA,EAAM,OAAA,EAAS,aAAA,CAAc,IAAI,CAAA,EAAG,OAAA,EAAS,GAAA,CAAI,OAAA,IAAW,GAAG,CAAA;AAC3F;AAIO,SAAS,aAAA,CAAc,IAAA,EAAkB,IAAA,EAAc,KAAA,GAA2B,WAAA,EAAa;AACpG,EAAA,MAAM,OAA+B,EAAC;AACtC,EAAA,KAAA,MAAW,KAAK,KAAA,EAAO,IAAA,CAAK,CAAC,CAAA,GAAI,GAAG,CAAC,CAAA,IAAA,CAAA;AACrC,EAAA,OAAO,IAAI,IAAA,CAAK,OAAA,CAAQ,EAAE,IAAA,EAAM,OAAA,EAAS,CAAA,EAAG,aAAA,CAAc,IAAI,CAAC,CAAA,QAAA,CAAA,EAAY,CAAA;AAC7E;;;ACjNA,IAAM,aAAA,GAAgB,GAAA;AAyDtB,SAAS,UAAU,QAAA,EAA4D;AAC7E,EAAA,IAAI,EAAA,GAAK,QAAA;AACT,EAAA,IAAI,EAAA,GAAK,CAAA,QAAA;AACT,EAAA,KAAA,MAAW,EAAA,IAAM,SAAS,MAAA,EAAQ;AAChC,IAAA,KAAA,MAAW,KAAK,CAAC,EAAA,CAAG,IAAA,EAAM,EAAA,CAAG,GAAG,CAAA,EAAG;AACjC,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,IAAI,CAAA,GAAI,IAAI,EAAA,GAAK,CAAA;AACjB,QAAA,IAAI,CAAA,GAAI,IAAI,EAAA,GAAK,CAAA;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACA,EAAA,OAAO,EAAA,IAAM,EAAA,GAAK,EAAE,EAAA,EAAI,IAAG,GAAI,MAAA;AACjC;AAkBO,IAAM,kBAAN,MAAsB;AAAA,EAC3B,KAAA;AAAA;AAAA,EAwBA,SAAA;AAAA,EACA,IAAA;AAAA,EACA,MAAA,GAAsB,MAAA;AAAA,EAEtB,KAAA;AAAA;AAAA,EAEA,OAAA;AAAA;AAAA;AAAA,EAGA,SAAA,uBAAgB,GAAA,EAA0D;AAAA,EAC1E,QAAA;AAAA,EACA,WAAA,GAAc,EAAA;AAAA,EACd,UAAA;AAAA,EACA,MAAA;AAAA,EACA,eAAyB,EAAC;AAAA,EAC1B,UAAA;AAAA,EAEA,WAAA,CAAY,OAAA,GAAyB,EAAC,EAAG;AACvC,IAAA,IAAA,CAAK,KAAA,GAAQ;AAAA,MACX,aAAA,EAAe,QAAQ,aAAA,IAAiB,mBAAA;AAAA,MACxC,cAAc,OAAA,CAAQ,YAAA;AAAA,MACtB,mBAAmB,OAAA,CAAQ,iBAAA;AAAA,MAC3B,OAAO,OAAA,CAAQ,KAAA;AAAA,MACf,KAAK,OAAA,CAAQ,GAAA;AAAA,MACb,UAAA,EAAY,QAAQ,UAAA,IAAc,CAAA;AAAA,MAClC,UAAA,EAAY,QAAQ,UAAA,IAAc,OAAA;AAAA,MAClC,WAAA,EAAa,OAAA,CAAQ,WAAA,IAAe,MAAA,CAAO,KAAK,WAAW,CAAA;AAAA,MAC3D,MAAA,EAAQ,QAAQ,MAAA,IAAU,OAAA;AAAA,MAC1B,OAAA,EAAS,QAAQ,OAAA,IAAW,IAAA;AAAA,MAC5B,eAAA,EAAiB,QAAQ,eAAA,IAAmB,QAAA;AAAA,MAC5C,aAAa,OAAA,CAAQ,WAAA;AAAA,MACrB,SAAS,OAAA,CAAQ,OAAA;AAAA,MACjB,SAAS,OAAA,CAAQ;AAAA,KACnB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,KAAA,GAAqB;AACvB,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA,EACA,IAAI,GAAA,GAAc;AAChB,IAAA,OAAO,IAAA,CAAK,aAAa,IAAA,CAAK,KAAA,CAAM,OAAO,IAAA,CAAK,IAAA,EAAM,KAAK,GAAA,IAAO,EAAA;AAAA,EACpE;AAAA;AAAA,EAEA,IAAI,eAAA,GAA0B;AAC5B,IAAA,OAAO,KAAK,KAAA,CAAM,eAAA;AAAA,EACpB;AAAA,EACA,IAAI,UAAA,GAA2B;AAC7B,IAAA,OAAO,KAAK,oBAAA,EAAqB;AAAA,EACnC;AAAA,EACA,IAAI,WAAA,GAA8B;AAChC,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,KAAA,CAAM,WAAW,CAAA;AAAA,EACnC;AAAA;AAAA,EAEA,IAAI,MAAA,GAA6B;AAC/B,IAAA,OAAO,KAAK,OAAA,EAAQ;AAAA,EACtB;AAAA;AAAA,EAEA,IAAI,SAAA,GAAqB;AACvB,IAAA,MAAM,EAAA,GAAK,KAAK,OAAA,EAAQ;AACxB,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,MAAA,KAAW,OAAA,IAAW,EAAA,KAAO,MAAA,IAAa,aAAA,CAAc,GAAA,CAAI,EAAE,CAAA,IAAK,CAAC,CAAC,KAAK,KAAA,CAAM,aAAA;AAAA,EACpG;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KAAK,GAAA,EAAsB;AACzB,IAAA,IAAA,CAAK,KAAA,EAAM;AACX,IAAA,IAAA,CAAK,IAAA,GAAO,GAAA;AACZ,IAAA,IAAA,CAAK,aAAA,GAAgB,MAAA;AACrB,IAAA,IAAA,CAAK,SAAA,GAAY,MAAA;AACjB,IAAA,IAAA,CAAK,UAAU,OAAO,CAAA;AAAA,EACxB;AAAA;AAAA;AAAA,EAIA,MAAM,IAAA,GAAsB;AAC1B,IAAA,IAAI,IAAA,CAAK,IAAA,KAAS,MAAA,IAAa,IAAA,CAAK,WAAW,SAAA,EAAW;AAC1D,IAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,WAAA,EAAY;AACpC,IAAA,MAAM,KAAK,KAAA,EAAM;AAEjB,IAAA,IAAI,IAAA,CAAK,WAAW,QAAA,EAAU;AAC5B,MAAA,IAAA,CAAK,YAAA,GAAe,KAAA,EAAM;AAC1B,MAAA,IAAA,CAAK,UAAU,SAAS,CAAA;AACxB,MAAA;AAAA,IACF;AAIA,IAAA,IAAA,CAAK,WAAA,EAAY;AACjB,IAAA,IAAA,CAAK,YAAA,GAAe,IAAA,EAAK;AACzB,IAAA,IAAA,CAAK,UAAU,SAAS,CAAA;AACxB,IAAA,MAAM,IAAA,CAAK,SAAS,IAAI,CAAA;AACxB,IAAA,IAAA,CAAK,YAAA,GAAe,KAAA,EAAM;AAC1B,IAAA,IAAA,CAAK,UAAU,SAAS,CAAA;AAGxB,IAAA,MAAM,KAAA,GAAQ,KAAK,KAAA,CAAM,eAAA;AACzB,IAAA,IAAI,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,EAAG;AAC1B,MAAA,IAAA,CAAK,YAAA,EAAa,CAAE,YAAA,CAAa,MAAM;AAErC,QAAA,IAAA,CAAK,OAAA,EAAQ,CAAE,QAAA,CAAS,MAAM;AAC5B,UAAA,IAAI,IAAA,CAAK,WAAW,SAAA,EAAW;AAC7B,YAAA,IAAA,CAAK,IAAA,EAAK;AACV,YAAA,IAAA,CAAK,MAAM,OAAA,IAAU;AAAA,UACvB;AAAA,QACF,CAAA,EAAG,IAAA,CAAK,KAAA,CAAO,GAAA,EAAK,CAAA;AAAA,MACtB,GAAG,KAAK,CAAA;AAAA,IACV;AAAA,EACF;AAAA;AAAA,EAGA,KAAA,GAAc;AACZ,IAAA,IAAI,IAAA,CAAK,KAAA,KAAU,MAAA,IAAa,IAAA,CAAK,WAAW,SAAA,EAAW;AAC3D,IAAA,IAAA,CAAK,KAAA,CAAM,YAAA,EAAa,CAAE,KAAA,EAAM;AAChC,IAAA,IAAA,CAAK,UAAU,QAAQ,CAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAA,GAAa;AACX,IAAA,IAAI,IAAA,CAAK,KAAA,KAAU,MAAA,IAAa,IAAA,CAAK,WAAW,MAAA,EAAQ;AACtD,MAAA,IAAA,CAAK,KAAA,EAAM;AACX,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,IAAA,CAAK,WAAW,SAAA,IAAa,IAAA,CAAK,WAAW,QAAA,KAAa,IAAA,CAAK,YAAY,MAAA,EAAW;AACzF,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,GAAA,EAAI;AAC3B,MAAA,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,qBAAA,CAAsB,GAAG,CAAA;AAC3C,MAAA,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,MAAA,CAAO,CAAA,EAAG,eAAe,GAAG,CAAA;AAC9C,MAAA,IAAA,CAAK,eAAe,IAAI,CAAA;AACxB,MAAA,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,IAAA,GAAO,OAAA,GAAU,MAAM,CAAA;AAC3C,MAAA,IAAA,CAAK,gBAAA,EAAiB;AACtB,MAAA,IAAA,CAAK,UAAA,GAAa,WAAW,MAAM,IAAA,CAAK,OAAM,EAAG,aAAA,GAAgB,MAAO,EAAE,CAAA;AAC1E,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,KAAA,EAAM;AAAA,EACb;AAAA;AAAA;AAAA,EAIA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,gBAAA,EAAiB;AACtB,IAAA,IAAI,IAAA,CAAK,UAAU,MAAA,EAAW;AAC5B,MAAA,MAAM,SAAA,GAAY,IAAA,CAAK,KAAA,CAAM,YAAA,EAAa;AAC1C,MAAA,SAAA,CAAU,IAAA,EAAK;AACf,MAAA,SAAA,CAAU,OAAO,CAAC,CAAA;AAClB,MAAA,SAAA,CAAU,QAAA,GAAW,CAAA;AAAA,IACvB;AAGA,IAAA,IAAA,CAAK,QAAQ,OAAA,EAAQ;AACrB,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,kBAAA,EAAmB;AACxB,IAAA,IAAA,CAAK,eAAe,EAAC;AACrB,IAAA,IAAA,CAAK,eAAe,IAAI,CAAA;AACxB,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAQ,IAAA,CAAK,UAAU,IAAA,CAAK,IAAA,GAAO,UAAU,MAAM,CAAA;AAAA,EACzE;AAAA,EAEA,gBAAA,GAAyB;AACvB,IAAA,IAAI,IAAA,CAAK,eAAe,MAAA,EAAW;AACjC,MAAA,YAAA,CAAa,KAAK,UAAU,CAAA;AAC5B,MAAA,IAAA,CAAK,UAAA,GAAa,MAAA;AAAA,IACpB;AAAA,EACF;AAAA;AAAA;AAAA,EAIA,WAAA,GAAoB;AAClB,IAAA,IAAA,CAAK,gBAAA,EAAiB;AACtB,IAAA,IAAA,CAAK,kBAAA,EAAmB;AAAA,EAC1B;AAAA,EAEA,kBAAA,GAA2B;AACzB,IAAA,IAAI,IAAA,CAAK,OAAA,KAAY,MAAA,IAAa,IAAA,CAAK,UAAU,MAAA,EAAW;AAC1D,MAAA,IAAA,CAAK,QAAQ,IAAA,CAAK,qBAAA,CAAsB,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AACxD,MAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,KAAA,GAAQ,CAAA;AAAA,IAC5B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMA,SAAS,KAAA,EAAqB;AAC5B,IAAA,IAAA,CAAK,MAAM,KAAA,GAAQ,KAAA;AACnB,IAAA,IAAA,CAAK,QAAA,EAAS;AAAA,EAChB;AAAA,EACA,OAAO,GAAA,EAAmB;AACxB,IAAA,IAAA,CAAK,SAAA,GAAY,GAAA;AACjB,IAAA,IAAA,CAAK,QAAA,EAAS;AAAA,EAChB;AAAA;AAAA,EAEA,gBAAgB,GAAA,EAAmB;AACjC,IAAA,IAAA,CAAK,MAAM,eAAA,GAAkB,GAAA;AAAA,EAC/B;AAAA,EACA,cAAc,UAAA,EAAgC;AAC5C,IAAA,IAAA,CAAK,MAAM,UAAA,GAAa,UAAA;AACxB,IAAA,IAAA,CAAK,QAAA,EAAS;AAAA,EAChB;AAAA,EACA,UAAU,MAAA,EAA0B;AAClC,IAAA,IAAA,CAAK,MAAM,MAAA,GAAS,MAAA;AACpB,IAAA,IAAA,CAAK,QAAA,EAAS;AAAA,EAChB;AAAA,EACA,WAAW,EAAA,EAAmB;AAC5B,IAAA,IAAA,CAAK,MAAM,OAAA,GAAU,EAAA;AACrB,IAAA,IAAA,CAAK,QAAA,EAAS;AAAA,EAChB;AAAA;AAAA,EAEA,QAAQ,EAAA,EAAyB;AAC/B,IAAA,IAAA,CAAK,gBAAgB,EAAA,IAAM,MAAA;AAC3B,IAAA,IAAA,CAAK,YAAY,EAAA,KAAO,IAAA;AACxB,IAAA,IAAA,CAAK,QAAA,EAAS;AAAA,EAChB;AAAA;AAAA;AAAA,EAIA,SAAA,CAAU,MAAA,EAAyB,IAAA,GAAyB,EAAC,EAAS;AAGpE,IAAA,MAAM,QACJ,IAAA,CAAK,UAAA,KAAe,IAAA,GAAO,QAAA,GAAW,KAAK,UAAA,IAAc,MAAA;AAC3D,IAAA,IAAA,CAAK,KAAA,CAAM,WAAA,GAAc,CAAC,IAAA,KAAS;AACjC,MAAA,MAAA,CAAO,eAAA,EAAgB;AACvB,MAAA,IAAI,SAAS,IAAA,EAAM;AACnB,MAAA,MAAM,EAAA,GAAK,MAAA,CAAO,SAAA,CAAU,IAAI,CAAA;AAChC,MAAA,IAAI,KAAA,KAAU,MAAA,IAAa,EAAA,KAAO,IAAA,EAAM;AACtC,QAAA,EAAA,CAAG,eAAe,EAAE,KAAA,EAAO,QAAQ,SAAA,EAAW,QAAA,EAAU,UAAU,CAAA;AAAA,MACpE;AAAA,IACF,CAAA;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,eAAA,CAAgB,EAAA,EAAY,SAAA,EAAsC;AACtE,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,WAAA,CAAY,EAAE,CAAA;AAC/B,IAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,KAAA;AAC9B,IAAA,MAAM,GAAA,GAAM,mBAAA,CAAoB,GAAA,EAAK,IAAA,CAAK,MAAM,aAAa,CAAA;AAC7D,IAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,KAAA;AAC9B,IAAA,OAAO,QAAA,CAAS,KAAK,SAAS,CAAA;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,gBAAA,CACJ,GAAA,GAAgB,IAAA,CAAK,KAAA,CAAM,aAC3B,SAAA,EACkC;AAClC,IAAA,MAAM,OAAA,GAAU,MAAM,OAAA,CAAQ,GAAA;AAAA,MAC5B,GAAA,CAAI,GAAA,CAAI,OAAO,EAAA,KAAO,CAAC,EAAA,EAAI,MAAM,IAAA,CAAK,eAAA,CAAgB,EAAA,EAAI,SAAS,CAAC,CAAU;AAAA,KAChF;AACA,IAAA,OAAO,MAAA,CAAO,YAAY,OAAO,CAAA;AAAA,EACnC;AAAA;AAAA,EAGA,OAAA,GAAgB;AACd,IAAA,IAAA,CAAK,KAAA,EAAM;AACX,IAAA,KAAA,MAAW,EAAE,SAAQ,IAAK,IAAA,CAAK,UAAU,MAAA,EAAO,UAAW,OAAA,EAAQ;AACnE,IAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AACrB,IAAA,IAAA,CAAK,UAAU,OAAA,EAAQ;AACvB,IAAA,IAAA,CAAK,YAAY,OAAA,EAAQ;AACzB,IAAA,IAAA,CAAK,QAAQ,OAAA,EAAQ;AACrB,IAAA,IAAA,CAAK,SAAS,OAAA,EAAQ;AACtB,IAAA,IAAA,CAAK,WAAW,IAAA,CAAK,UAAA,GAAa,IAAA,CAAK,MAAA,GAAS,KAAK,OAAA,GAAU,MAAA;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA,EAMA,aAAA;AAAA,EACA,SAAA,GAAY,IAAA;AAAA,EAEZ,UAAU,KAAA,EAA0B;AAClC,IAAA,IAAA,CAAK,MAAA,GAAS,KAAA;AACd,IAAA,IAAA,CAAK,KAAA,CAAM,UAAU,KAAK,CAAA;AAAA,EAC5B;AAAA,EAEA,eAAe,IAAA,EAA2B;AACxC,IAAA,IAAA,CAAK,KAAA,CAAM,cAAc,IAAI,CAAA;AAAA,EAC/B;AAAA;AAAA,EAGA,OAAA,GAA8B;AAC5B,IAAA,IAAI,CAAC,IAAA,CAAK,SAAA,IAAa,KAAK,aAAA,KAAkB,MAAA,SAAkB,IAAA,CAAK,aAAA;AACrE,IAAA,MAAM,EAAA,GAAK,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,EAAA;AACjC,IAAA,OAAO,EAAA,KAAO,MAAA,IAAa,EAAA,IAAM,KAAA,GAAS,EAAA,GAAgB,MAAA;AAAA,EAC5D;AAAA;AAAA;AAAA,EAIA,YAAY,EAAA,EAAuC;AACjD,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,iBAAA,GAAoB,EAAE,CAAA;AAChD,IAAA,IAAI,QAAQ,OAAO,MAAA;AACnB,IAAA,MAAM,GAAA,GAAM,YAAY,EAAE,CAAA;AAC1B,IAAA,IAAI,GAAA,IAAO,EAAA,KAAO,OAAA,IAAW,IAAA,CAAK,MAAM,YAAA,EAAc;AACpD,MAAA,OAAO,EAAE,GAAG,GAAA,EAAK,OAAA,EAAS,cAAc,IAAA,CAAK,KAAA,CAAM,YAAY,CAAA,EAAE;AAAA,IACnE;AACA,IAAA,OAAO,GAAA;AAAA,EACT;AAAA;AAAA;AAAA,EAIA,mBAAA,GAA8B;AAC5B,IAAA,MAAM,UAAU,IAAA,CAAK,KAAA,CAAM,WAAA,CAAY,IAAA,CAAK,CAAC,EAAA,KAAO;AAClD,MAAA,MAAM,CAAA,GAAI,IAAA,CAAK,WAAA,CAAY,EAAE,CAAA;AAC7B,MAAA,OAAO,CAAA,KAAM,MAAA,IAAa,CAAA,CAAE,KAAA,KAAU,IAAA;AAAA,IACxC,CAAC,CAAA;AACD,IAAA,OAAO,OAAA,IAAW,WAAA;AAAA,EACpB;AAAA;AAAA;AAAA,EAIA,oBAAA,GAA+B;AAC7B,IAAA,MAAM,EAAA,GAAK,KAAK,KAAA,CAAM,UAAA;AACtB,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,WAAA,CAAY,EAAE,CAAA;AAC/B,IAAA,IAAI,GAAA,KAAQ,MAAA,EAAW,OAAO,IAAA,CAAK,mBAAA,EAAoB;AACvD,IAAA,IAAI,GAAA,CAAI,UAAU,IAAA,IAAQ,CAAC,KAAK,KAAA,CAAM,aAAA,EAAe,OAAO,IAAA,CAAK,mBAAA,EAAoB;AACrF,IAAA,OAAO,EAAA;AAAA,EACT;AAAA;AAAA,EAGA,aAAA,GAAwB;AACtB,IAAA,OAAO,KAAK,SAAA,GAAY,eAAA,CAAgB,IAAA,CAAK,GAAG,IAAI,IAAA,CAAK,GAAA;AAAA,EAC3D;AAAA,EAEA,MAAM,WAAA,GAAmC;AACvC,IAAA,IAAA,CAAK,KAAA,KAAU,MAAM,OAAO,MAAM,CAAA;AAClC,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,EACd;AAAA;AAAA;AAAA,EAIA,QAAA,GAAiB;AACf,IAAA,IAAI,IAAA,CAAK,WAAW,SAAA,EAAW;AAC/B,IAAA,IAAA,CAAK,KAAA,EAAM;AACX,IAAA,KAAK,KAAK,IAAA,EAAK;AAAA,EACjB;AAAA;AAAA,EAGA,cAAc,IAAA,EAAwB;AACpC,IAAA,IAAA,CAAK,YAAY,IAAI,IAAA,CAAK,IAAA,CAAK,CAAC,EAAE,aAAA,EAAc;AAChD,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA;AAAA;AAAA,EAIA,MAAM,SAAS,IAAA,EAAiC;AAC9C,IAAA,IAAI,IAAA,CAAK,SAAS,MAAA,EAAW;AAC7B,IAAA,MAAM,IAAA,GAAO,KAAK,KAAA,CAAM,aAAA;AACxB,IAAA,MAAM,SAAA,GAAY,KAAK,YAAA,EAAa;AACpC,IAAA,SAAA,CAAU,OAAO,CAAC,CAAA;AAClB,IAAA,SAAA,CAAU,QAAA,GAAW,CAAA;AACrB,IAAA,IAAA,CAAK,eAAe,EAAC;AAGrB,IAAA,IAAA,CAAK,cAAc,IAAI,CAAA;AACvB,IAAA,IAAA,CAAK,kBAAA,EAAmB;AAExB,IAAA,MAAM,GAAA,GAAM,KAAK,aAAA,EAAc;AAC/B,IAAA,SAAA,CAAU,IAAI,KAAA,GAAQ,GAAA;AACtB,IAAA,MAAM,MAAM,EAAA,GAAK,GAAA;AAIjB,IAAA,MAAM,QAAA,GAAqB,aAAA,CAAc,IAAA,CAAK,IAAA,EAAM;AAAA,MAClD,KAAA,EAAO,KAAK,KAAA,CAAM,KAAA;AAAA,MAClB,UAAA,EAAY,KAAK,KAAA,CAAM;AAAA,KACxB,CAAA;AACD,IAAA,MAAM,KAAA,GAAQ,UAAU,QAAQ,CAAA;AAGhC,IAAA,MAAM,MAAA,GAAS,KAAK,YAAA,CAAa,IAAA,EAAM,KAAK,oBAAA,EAAqB,EAAG,MAAM,KAAK,CAAA;AAG/E,IAAA,IAAA,CAAK,YAAA,CAAa,IAAA,EAAM,SAAA,EAAW,IAAA,EAAM,GAAG,CAAA;AAG5C,IAAA,IAAA,CAAK,aAAA,CAAc,IAAA,EAAM,SAAA,EAAW,IAAA,EAAM,GAAG,CAAA;AAG7C,IAAA,MAAM,KAAK,MAAA,EAAO;AAGlB,IAAA,MAAM,IAAA,GAAO,KAAK,OAAA,EAAQ;AAE1B,IAAA,KAAA,MAAW,EAAA,IAAM,SAAS,MAAA,EAAQ;AAChC,MAAA,MAAM,EAAA,GAAK,GAAG,IAAA,GAAO,GAAA;AACrB,MAAA,IAAI,EAAA,CAAG,SAAS,IAAA,EAAM;AACpB,QAAA,MAAM,IAAA,GAAO,gBAAA,CAAiB,EAAA,CAAG,IAAI,CAAA;AACrC,QAAA,MAAM,MAAM,IAAA,CAAK,GAAA,CAAI,EAAA,CAAG,aAAA,GAAgB,KAAK,IAAI,CAAA;AACjD,QAAA,IAAI,EAAA,CAAG,QAAQ,IAAA,EAAM;AACnB,UAAA,MAAM,OAAA,GAAU,gBAAA,CAAiB,EAAA,CAAG,GAAG,CAAA;AACvC,UAAA,SAAA,CAAU,aAAa,CAAC,IAAA,KAAS,MAAA,CAAO,oBAAA,CAAqB,SAAS,GAAA,GAAM,GAAA,EAAK,IAAI,CAAA,EAAG,KAAK,GAAA,CAAI,EAAA,GAAK,GAAA,GAAM,IAAA,EAAM,CAAC,CAAC,CAAA;AAAA,QACtH;AACA,QAAA,SAAA,CAAU,YAAA,CAAa,CAAC,IAAA,KAAS,MAAA,CAAO,qBAAqB,IAAA,EAAM,GAAA,EAAK,IAAI,CAAA,EAAG,EAAE,CAAA;AAAA,MACnF;AACA,MAAA,SAAA,CAAU,YAAA,CAAa,CAAC,IAAA,KAAS;AAC/B,QAAA,IAAA,CAAK,SAAS,MAAM,IAAA,CAAK,eAAe,EAAA,CAAG,IAAI,GAAG,IAAI,CAAA;AAAA,MACxD,GAAG,EAAE,CAAA;AAAA,IACP;AAGA,IAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,UAAA,GAAa,GAAA,GAAM,GAAA;AAC1C,IAAA,SAAA,CAAU,YAAA,CAAa,CAAC,IAAA,KAAS;AAC/B,MAAA,IAAA,CAAK,SAAS,MAAM,IAAA,CAAK,cAAA,CAAe,IAAI,GAAG,IAAI,CAAA;AAAA,IACrD,CAAA,EAAG,QAAA,CAAS,UAAA,GAAa,GAAG,CAAA;AAC5B,IAAA,SAAA,CAAU,YAAA,CAAa,MAAM,IAAA,CAAK,IAAA,IAAQ,KAAK,CAAA;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA,EAKA,YAAA,CACE,IAAA,EACA,EAAA,EACA,IAAA,EACA,KAAA,EACa;AACb,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,WAAA,CAAY,EAAE,KAAK,WAAA,CAAY,SAAA;AAChD,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,aAAA,CAAc,IAAI,CAAA;AACtC,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,EAAE,CAAA;AACpC,IAAA,IAAI,MAAA,KAAW,KAAA,KAAU,MAAA,IAAc,MAAA,CAAO,EAAA,IAAM,MAAM,EAAA,IAAM,MAAA,CAAO,EAAA,IAAM,KAAA,CAAM,EAAA,CAAA,EAAM;AACvF,MAAA,OAAO,MAAA,CAAO,OAAA;AAAA,IAChB;AACA,IAAA,MAAA,EAAQ,QAAQ,OAAA,EAAQ;AACxB,IAAA,MAAM,OAAA,GAAU,cAAc,IAAA,EAAM,GAAA,EAAK,MAAM,KAAK,CAAA,CAAE,QAAQ,MAAM,CAAA;AACpE,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,EAAA,EAAI,EAAE,OAAA,EAAS,EAAA,EAAI,KAAA,EAAO,EAAA,IAAM,CAAA,QAAA,EAAW,EAAA,EAAI,KAAA,EAAO,EAAA,IAAM,UAAU,CAAA;AACzF,IAAA,OAAO,OAAA;AAAA,EACT;AAAA,EAEA,YAAA,CAAa,IAAA,EAAkB,SAAA,EAAmD,IAAA,EAA0B,GAAA,EAAmB;AAE7H,IAAA,IAAA,CAAK,QAAQ,OAAA,EAAQ;AACrB,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAEd,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,aAAA,CAAc,IAAI,CAAA;AACtC,IAAA,MAAM,MAAA,GAAS,KAAK,OAAA,EAAQ;AAC5B,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,KAAA,CAAM,MAAA,KAAW,OAAA,IAAW,MAAA,KAAW,MAAA,IAAa,aAAA,CAAc,GAAA,CAAI,MAAM,CAAA,IAAK,IAAA,KAAS,MAAA;AAElH,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,MAAM,MAAM,QAAA,CAAS,IAAA,EAAO,QAAS,eAAA,CAAgB,IAAA,CAAK,GAAG,CAAC,CAAA;AAC9D,MAAA,IAAA,CAAK,MAAA,GAAS,IAAI,IAAA,CAAK,MAAA,CAAO,EAAE,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,CAAA,CAAE,OAAA,CAAQ,MAAM,CAAA;AACjE,MAAA,IAAA,CAAK,MAAA,CAAO,IAAA,EAAK,CAAE,KAAA,CAAM,CAAC,CAAA;AAC1B,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,MAAA,KAAW,MAAA,IAAU,SAAS,MAAA,EAAW;AAGxD,IAAA,IAAA,CAAK,eAAe,eAAA,CAAgB,IAAA,EAAM,IAAI,CAAA,CAAE,QAAQ,MAAM,CAAA;AAC9D,IAAA,MAAM,QAAQ,IAAA,CAAK,UAAA;AACnB,IAAA,MAAM,QAAS,MAAA,KAAW,MAAA,GAAY,KAAA,CAAM,MAAM,EAAE,QAAA,GAAW,CAAA;AAC/D,IAAA,IAAI,IAAA,GAAO,CAAA;AACX,IAAA,MAAM,EAAA,GAAK,SAAA,CAAU,cAAA,CAAe,CAAC,IAAA,KAAS;AAC5C,MAAA,KAAA,CAAM,OAAO,cAAA,CAAe,IAAA,GAAO,UAAU,CAAA,GAAI,CAAA,GAAI,IAAI,IAAI,CAAA;AAC7D,MAAA,KAAA,CAAM,MAAM,IAAI,CAAA;AAChB,MAAA,IAAA,IAAQ,CAAA;AAAA,IACV,CAAA,EAAG,KAAK,CAAC,CAAA;AACT,IAAA,IAAA,CAAK,YAAA,CAAa,KAAK,EAAE,CAAA;AAAA,EAC3B;AAAA,EAEA,aAAA,CAAc,IAAA,EAAkB,SAAA,EAAmD,IAAA,EAA0B,GAAA,EAAmB;AAC9H,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,CAAM,OAAA,IAAW,SAAS,MAAA,EAAW;AAG/C,IAAA,MAAM,OAAA,GAAA,CAAY,IAAA,CAAK,cAAA,EAAe,GAAI,KAAM,EAAA,IAAM,EAAA;AACtD,IAAA,MAAM,EAAA,GAAK,YAAY,OAAO,CAAA;AAC9B,IAAA,MAAM,EAAA,GAAK,WAAA,CAAA,CAAa,OAAA,GAAU,CAAA,IAAK,EAAE,CAAA;AAIzC,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,EAAE,CAAA,CAAA,EAAI,EAAE,CAAA,CAAA;AACvB,IAAA,IAAI,IAAA,CAAK,QAAA,KAAa,MAAA,IAAa,IAAA,CAAK,gBAAgB,GAAA,EAAK;AAC3D,MAAA,IAAA,CAAK,UAAU,OAAA,EAAQ;AACvB,MAAA,IAAA,CAAK,QAAA,GAAW,aAAA,CAAc,IAAA,EAAM,IAAA,EAAM,CAAC,EAAA,EAAI,EAAE,CAAC,CAAA,CAAE,OAAA,CAAQ,IAAA,CAAK,aAAA,CAAc,IAAI,CAAC,CAAA;AACpF,MAAA,IAAA,CAAK,WAAA,GAAc,GAAA;AAAA,IACrB;AACA,IAAA,MAAM,UAAU,IAAA,CAAK,QAAA;AACrB,IAAA,OAAA,CAAQ,OAAO,KAAA,GAAQ,GAAA;AAEvB,IAAA,MAAM,OAAA,GAAU,CAAC,EAAA,EAAI,EAAA,EAAI,IAAI,EAAE,CAAA;AAC/B,IAAA,IAAI,CAAA,GAAI,CAAA;AACR,IAAA,MAAM,EAAA,GAAK,SAAA,CAAU,cAAA,CAAe,CAAC,IAAA,KAAS;AAC5C,MAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,CAAA,GAAI,OAAA,CAAQ,MAAM,CAAA;AACvC,MAAA,IAAI,OAAA,CAAQ,IAAI,IAAI,CAAA,UAAW,MAAA,CAAO,IAAI,CAAA,CAAE,KAAA,CAAM,IAAI,CAAA;AACtD,MAAA,CAAA,IAAK,CAAA;AAAA,IACP,CAAA,EAAG,GAAA,GAAM,CAAA,EAAG,CAAC,CAAA;AACb,IAAA,IAAA,CAAK,YAAA,CAAa,KAAK,EAAE,CAAA;AAAA,EAC3B;AAAA,EAEA,cAAA,GAAyB;AACvB,IAAA,OAAO,WAAW,IAAA,CAAK,KAAA,CAAM,SAAS,IAAA,CAAK,IAAA,EAAM,KAAK,KAAK,CAAA;AAAA,EAC7D;AACF","file":"index.cjs","sourcesContent":["import type { Taal } from './schema.js';\n\n/**\n * Reference definitions for the taals the player will sample (P2.3):\n * adachautaal, dadra, ektaal, jhaptaal, kehrwa, rupak, teentaal.\n *\n * `numBeats` and the `bhaags` given below are standard Hindustani taal theory.\n * `bhaags` is omitted where a single canonical division isn't well-agreed\n * (adachautaal) — we assert only what's uncontested. `sam` is beat 0 for all.\n */\nexport const TAALS = {\n  dadra: { id: 'dadra', numBeats: 6, bhaags: [3, 3], sam: 0, khaali: [3] },\n  kehrwa: { id: 'kehrwa', numBeats: 8, bhaags: [4, 4], sam: 0, khaali: [4] },\n  rupak: { id: 'rupak', numBeats: 7, bhaags: [3, 2, 2], sam: 0, khaali: [0] },\n  jhaptaal: { id: 'jhaptaal', numBeats: 10, bhaags: [2, 3, 2, 3], sam: 0, khaali: [5] },\n  ektaal: { id: 'ektaal', numBeats: 12, bhaags: [2, 2, 2, 2, 2, 2], sam: 0, khaali: [2, 6] },\n  adachautaal: { id: 'adachautaal', numBeats: 14, sam: 0 },\n  teentaal: { id: 'teentaal', numBeats: 16, bhaags: [4, 4, 4, 4], sam: 0, khaali: [8] },\n} as const satisfies Record<string, Taal>;\n\nexport type TaalId = keyof typeof TAALS;\n","/**\n * Pure svara → pitch math for the player. No Tone, no audio — unit-testable\n * in plain Node and shared by the scheduler.\n *\n * The model: a tonic (Sa) pitch-class + a per-note scale degree + octave\n * register + komal/tivra/microtone accidentals → an absolute MIDI number,\n * which the Tone.Sampler pitch-shifts from the nearest santoor sample.\n */\nimport type { Note, Octave, SvaraLetter } from '../spec/index.js';\n\n/** Octave register offset in octaves, relative to madhyam (middle). */\nexport const OCTAVE_OFFSET: Record<Octave, number> = {\n  'ati-mandra': -2,\n  mandra: -1,\n  madhyam: 0,\n  taar: 1,\n  'ati-taar': 2,\n};\n\n/**\n * Shuddha (natural) scale degrees in semitones above Sa — the Bilawal/major\n * thaat that Rabindrasangeet swaralipi notates against. `d` = dha, `n` = ni\n * (standard sargam letter convention).\n */\nexport const SHUDDHA: Record<SvaraLetter, number> = {\n  s: 0,\n  r: 2,\n  g: 4,\n  m: 5,\n  p: 7,\n  d: 9,\n  n: 11,\n};\n\n/** Sharp-spelled pitch-class names, index = semitone 0–11. */\nconst SHARP_NAMES = ['C', 'C#', 'D', 'D#', 'E', 'F', 'F#', 'G', 'G#', 'A', 'A#', 'B'] as const;\n\n/** Pitch-class lookup. Accepts sharps (`C#`, `Cs`, `cs`) and flats (`Db`). */\nconst PITCH_CLASS: Record<string, number> = {\n  c: 0,\n  'c#': 1,\n  db: 1,\n  d: 2,\n  'd#': 3,\n  eb: 3,\n  e: 4,\n  'e#': 5,\n  fb: 4,\n  f: 5,\n  'f#': 6,\n  gb: 6,\n  g: 7,\n  'g#': 8,\n  ab: 8,\n  a: 9,\n  'a#': 10,\n  bb: 10,\n  b: 11,\n  'b#': 0,\n  cb: 11,\n};\n\n/**\n * Parse a tonic string to a pitch-class 0–11. Accepts `C`, `C#`, `Db`, and\n * the player/sample lowercase-`s` sharp form (`cs`, `Cs`); case-insensitive.\n * Unknown input falls back to 0 (C).\n */\nexport function parseTonic(tonic: string | undefined): number {\n  if (!tonic) return 0;\n  const key = tonic.trim().toLowerCase().replace(/s/g, '#');\n  return PITCH_CLASS[key] ?? 0;\n}\n\n/**\n * Semitone of a note relative to Sa (degree + accidentals), ignoring octave.\n * Returns null when the note carries no pitch (rest/sustain-hold/bar).\n *\n * Microtones (অল্পকোমল/অতিকোমল) are approximated to the komal pitch — a\n * documented v1 limitation (the sampler can't bend a sub-komal microtone\n * cleanly per note); matches the viewer's placeholder treatment.\n */\nexport function svaraSemitone(note: Note): number | null {\n  if (note.svara === undefined) return null;\n  const [, letter] = note.svara;\n  let semi = SHUDDHA[letter];\n  if (note.komal === true || note.microtone !== undefined) semi -= 1;\n  if (note.tivra === true) semi += 1;\n  return semi;\n}\n\n/**\n * Absolute MIDI for a note, or null when it has no pitch. madhyam Sa lands on\n * the tonic in octave `baseOctave` (C4 = MIDI 60). Out-of-sample registers\n * are produced by the Sampler pitch-shifting from the nearest recorded note.\n */\nexport function svaraToMidi(note: Note, tonicPc: number, baseOctave = 4): number | null {\n  const semi = svaraSemitone(note);\n  if (semi === null || note.svara === undefined) return null;\n  const [octave] = note.svara;\n  return (baseOctave + 1 + OCTAVE_OFFSET[octave]) * 12 + tonicPc + semi;\n}\n\n/** MIDI of a kan (grace) svara — a bare `Svara` tuple, no accidentals. */\nexport function kanToMidi(\n  svara: Note['kan'],\n  tonicPc: number,\n  baseOctave = 4,\n): number | null {\n  if (svara === undefined) return null;\n  const [octave, letter] = svara;\n  return (baseOctave + 1 + OCTAVE_OFFSET[octave]) * 12 + tonicPc + SHUDDHA[letter];\n}\n\n/** MIDI → Tone note name (`C#4`). */\nexport function midiToSampleName(midi: number): string {\n  const pc = ((midi % 12) + 12) % 12;\n  const octave = Math.floor(midi / 12) - 1;\n  return `${SHARP_NAMES[pc]}${octave}`;\n}\n\n/** MIDI → santoor sample filename stem (`cs4`): lowercase, `#` → `s`. */\nexport function sampleFileName(midi: number): string {\n  return midiToSampleName(midi).toLowerCase().replace('#', 's');\n}\n","/**\n * Pure spec-doc → playback timeline. No Tone, no audio — the player turns\n * this `Schedule` into Transport events, but it is fully unit-testable on its\n * own and mirrors the viewer's spec-driven (not raw-driven) reading.\n *\n * Timing unit is the মাত্রা (matra / beat). One global beat cursor runs across\n * every part and row: NLTR \"systems\" (rows) are wraps of one continuous line,\n * and parts (asthayi → antara …) play back-to-back, so the music never pauses\n * at a row or part boundary.\n *\n * Each audible column carries the same `data-note` path the viewer emits\n * (`part.row.note`, note = absolute index into `row.notes`; see\n * src/viewer/render.ts), so `SwaralipiPlayer` can drive `highlight()` directly.\n */\nimport type { Note, Swaralipi } from '../spec/index.js';\nimport { kanToMidi, parseTonic, svaraToMidi } from './pitch.js';\n\nexport interface PlayEvent {\n  /** Onset in matra from the start of the document. */\n  beat: number;\n  /** Ring length in matra (extended by following আ-কার holds). */\n  durationBeats: number;\n  /** Pitch as MIDI, or null for a rest / আ-কার hold column. */\n  midi: number | null;\n  /** Grace-note MIDI struck just before the main attack, when present. */\n  kan: number | null;\n  /** `part.row.note` highlight path. */\n  path: string;\n  kind: 'note' | 'rest' | 'sustain';\n}\n\nexport interface Schedule {\n  events: PlayEvent[];\n  /** Total length in matra (the cursor's final value). */\n  totalBeats: number;\n}\n\nexport interface ScheduleOptions {\n  /** Tonic; accepts `C`, `C#`, `cs`… (see parseTonic). Default C. */\n  tonic?: string;\n  /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */\n  baseOctave?: number;\n}\n\n/** A column that produces no sound and no time advance (bar, bracket-only,\n * carrier, raw-only). Mirrors the viewer's non-pitched, non-rest classes. */\nconst isSilent = (n: Note): boolean =>\n  n.svara === undefined && n.rest !== true && n.sustain !== true;\n\n/**\n * Walk a document into a flat, time-ordered list of play events.\n *\n *  - svara note → an attack at the cursor; advances by `durationMatra ?? 1`.\n *  - rest → a silent column that still advances the cursor.\n *  - sustain **with** svara (melisma) → a fresh attack (the pitch moves under\n *    a held vowel); advances.\n *  - sustain **without** svara (আ-কার hold) → no attack, but the previous\n *    audible note's ring is extended; still emitted (midi null) so the lyric\n *    column highlights; advances.\n *  - bar / bracket-only / carrier / raw-only → ignored (no event, no advance).\n */\nexport function buildSchedule(doc: Swaralipi, opts: ScheduleOptions = {}): Schedule {\n  const tonicPc = parseTonic(opts.tonic ?? doc.meta.tonic);\n  const baseOctave = opts.baseOctave ?? 4;\n  const events: PlayEvent[] = [];\n  let cursor = 0;\n  /** Index in `events` of the last pitched attack, for hold-extension. */\n  let lastPitched = -1;\n\n  doc.parts.forEach((part, p) => {\n    part.rows.forEach((row, r) => {\n      row.notes.forEach((note, i) => {\n        if (note.bar !== undefined || isSilent(note)) return;\n        const path = `${p}.${r}.${i}`;\n        const dur = note.durationMatra ?? 1;\n\n        if (note.svara !== undefined) {\n          // svara note or melisma — a real attack.\n          events.push({\n            beat: cursor,\n            durationBeats: dur,\n            midi: svaraToMidi(note, tonicPc, baseOctave),\n            kan: kanToMidi(note.kan, tonicPc, baseOctave),\n            path,\n            kind: note.sustain === true ? 'sustain' : 'note',\n          });\n          lastPitched = events.length - 1;\n        } else if (note.sustain === true) {\n          // আ-কার hold — extend the ringing note, emit a silent highlight column.\n          if (lastPitched >= 0) events[lastPitched]!.durationBeats += dur;\n          events.push({ beat: cursor, durationBeats: dur, midi: null, kan: null, path, kind: 'sustain' });\n        } else {\n          // rest.\n          events.push({ beat: cursor, durationBeats: dur, midi: null, kan: null, path, kind: 'rest' });\n        }\n        cursor += dur;\n      });\n    });\n  });\n\n  return { events, totalBeats: cursor };\n}\n","/**\n * Tone.js instrument/asset factories. Tone is **injected** (never imported\n * here) so this module — like the scheduler — stays free of a static `tone`\n * dependency; the player passes the dynamically-imported module in.\n *\n * Melodic instruments are a small registry (INSTRUMENTS) of Tone.Sampler\n * note→file maps + where to fetch them. `piano` (CC-BY Salamander) is the\n * default and CDN-hosted, as are `harmonium`/`violin`/`flute` (CC-BY,\n * tonejs-instruments); `santoor` is local (under the player's `soundsBaseUrl`).\n * Consumers can register more (e.g. a self-hosted sitar) via the player's\n * `customInstruments` option — true sampled sitar/sarod/sarangi/esraj have no\n * free web set, only commercial Kontakt libraries.\n *\n * Asset layout under `soundsBaseUrl`:\n *   santoor/<note>.mp3        c4..c7 + sharps (37 files)\n *   tanpura/<pc>.mp3          12 pitch classes (c, cs, d, …)\n *   tabla/<taal>/<taal><bpm>bpm.mp3   bpm 60..300 step 15\n *   metronome/metro2.mp3\n */\n// Import TAALS from the taals subpath (not the ../spec/index barrel): the\n// barrel re-exports schema.ts, which statically imports zod — pulling that into\n// the player would break its \"loads bare in a browser\" guarantee. taals.ts has\n// only a type-only schema import, so this keeps the player runtime zod-free.\nimport { TAALS, type TaalId } from '../spec/taals.js';\nimport { sampleFileName } from './pitch.js';\n\n/** The dynamically-imported Tone module, typed without importing it. */\nexport type ToneModule = typeof import('tone');\n\n/** A melodic instrument: a Tone.Sampler note→filename map + where to find it. */\nexport interface InstrumentDef {\n  /** Human label for UIs. */\n  label: string;\n  /** Tone.Sampler `urls`: note name (`C#4`) → filename (`Cs4.mp3`). */\n  urls: Record<string, string>;\n  /** Sample directory: an absolute URL, or — when `local` — a path segment\n   * appended to the player's `soundsBaseUrl`. */\n  baseUrl: string;\n  /** `baseUrl` is relative to `soundsBaseUrl` (needs it set). */\n  local?: boolean;\n  /** Sampler release time in seconds. */\n  release?: number;\n}\n\n/** Built-in melody instrument ids (consumers may add their own via the\n * player's `customInstruments`, so the runtime id type stays open). */\nexport type InstrumentId = string;\n\n/**\n * Default host for the project's samples (santoor / tabla / tanpura /\n * metronome) — CC-BY, redistribution-verified and CORS-enabled, so the player\n * works with zero config. Override via the player's `soundsBaseUrl` to\n * self-host. (Melody defaults to the CDN-hosted piano, so it needs no host.)\n */\nexport const DEFAULT_SOUNDS_BASE = 'https://cdn.daserve.in/swaralipijs-instruments/';\n/** CC-BY Salamander Grand Piano (Tone's de-facto piano), CDN-hosted. */\nexport const SALAMANDER_BASE = 'https://tonejs.github.io/audio/salamander/';\n/** CC-BY tonejs-instruments sample CDN (harmonium/violin/flute). */\nexport const TONEJS_INSTRUMENTS_BASE = 'https://nbrosowsky.github.io/tonejs-instruments/samples/';\n\n/** Build a Tone.Sampler `urls` map from bare note keys (`C#4` → `Cs4.mp3`). */\nfunction keyMap(keys: readonly string[]): Record<string, string> {\n  const m: Record<string, string> = {};\n  for (const k of keys) m[k] = `${k.replace('#', 's')}.mp3`;\n  return m;\n}\n\nconst PIANO_KEYS = [\n  'A0', 'C1', 'D#1', 'F#1', 'A1', 'C2', 'D#2', 'F#2', 'A2', 'C3', 'D#3', 'F#3',\n  'A3', 'C4', 'D#4', 'F#4', 'A4', 'C5', 'D#5', 'F#5', 'A5', 'C6', 'D#6', 'F#6',\n  'A6', 'C7', 'D#7', 'F#7', 'A7', 'C8',\n] as const;\n// harmonium — a core Rabindrasangeet accompaniment (C2..C5).\nconst HARMONIUM_KEYS = [\n  'C2', 'C#2', 'D2', 'D#2', 'E2', 'F2', 'F#2', 'G2', 'G#2', 'A2', 'A#2',\n  'C3', 'C#3', 'D3', 'D#3', 'E3', 'F3', 'F#3', 'G3', 'G#3', 'A3', 'A#3',\n  'C4', 'C#4', 'D4', 'D#4', 'E4', 'F4', 'F#4', 'G4', 'G#4', 'A4', 'A#4',\n  'C5', 'C#5', 'D5',\n] as const;\nconst VIOLIN_KEYS = ['A3', 'C4', 'E4', 'G4', 'A4', 'C5', 'E5', 'G5', 'A5', 'C6', 'E6', 'G6', 'A6', 'C7'] as const;\nconst FLUTE_KEYS = ['C4', 'E4', 'A4', 'C5', 'E5', 'A5', 'C6', 'E6', 'A6', 'C7'] as const;\n\n/** Built-in melody instruments. santoor is local; the rest are CDN-hosted\n * (CC-BY) so they need only network — `pianoBaseUrl`/`customInstruments`\n * override for self-hosting. */\nexport const INSTRUMENTS: Record<string, InstrumentDef> = {\n  piano: { label: 'Grand piano', urls: keyMap(PIANO_KEYS), baseUrl: SALAMANDER_BASE, release: 1 },\n  santoor: { label: 'Santoor', urls: santoorUrls(), baseUrl: 'santoor/', local: true, release: 1.2 },\n  harmonium: { label: 'Harmonium', urls: keyMap(HARMONIUM_KEYS), baseUrl: `${TONEJS_INSTRUMENTS_BASE}harmonium/`, release: 1.4 },\n  violin: { label: 'Violin', urls: keyMap(VIOLIN_KEYS), baseUrl: `${TONEJS_INSTRUMENTS_BASE}violin/`, release: 1 },\n  flute: { label: 'Flute', urls: keyMap(FLUTE_KEYS), baseUrl: `${TONEJS_INSTRUMENTS_BASE}flute/`, release: 1 },\n};\n\n/** Taals with recorded tabla loops (everything else → metronome fallback). */\nexport const SAMPLED_TAALS: ReadonlySet<TaalId> = new Set(\n  Object.keys(TAALS) as TaalId[],\n);\n\n/** Available tabla loop tempos (file suffix `…<bpm>bpm.mp3`). */\nexport const TABLA_BPMS: readonly number[] = Array.from({ length: 17 }, (_, i) => 60 + i * 15);\n\n/** Ensure exactly one trailing slash. */\nexport function normalizeBase(url: string): string {\n  return url.endsWith('/') ? url : `${url}/`;\n}\n\n/** The 37 santoor samples, as a Tone.Sampler `urls` map (`C4` → `c4.mp3`). */\nexport function santoorUrls(): Record<string, string> {\n  const urls: Record<string, string> = {};\n  const add = (midi: number) => {\n    const stem = sampleFileName(midi); // e.g. cs4\n    const name = stem.replace('s', '#').replace(/^(.)/, (c) => c.toUpperCase()); // C#4\n    urls[name] = `${stem}.mp3`;\n  };\n  for (let midi = 60; midi <= 95; midi++) add(midi); // C4..B6 (full)\n  add(96); // C7\n  return urls;\n}\n\nconst PC_BASE: Record<string, number> = { c: 0, d: 2, e: 4, f: 5, g: 7, a: 9, b: 11 };\n\n/** Parse a sample note name (`C#4`, `Ds3`, `Bb2`) to a MIDI number. */\nexport function noteToMidi(name: string): number {\n  const m = /^([a-g])([#sb]?)(-?\\d+)$/i.exec(name.trim());\n  if (!m) return NaN;\n  const base = PC_BASE[m[1]!.toLowerCase()]!;\n  const acc = m[2] === 'b' ? -1 : m[2] === '' ? 0 : 1; // # / s → sharp\n  return (Number(m[3]) + 1) * 12 + base + acc;\n}\n\n/**\n * Restrict a Sampler `urls` map to just the samples needed to cover MIDI\n * `[lo, hi]`: every sample inside the range, plus the nearest one below and\n * above it (so Tone interpolates the edges without extrapolating). Cuts a\n * typical song from ~37 santoor files to a handful — a big win on mobile and\n * never worse on fast links (Tone fetches what's left in parallel). The\n * Sampler pitch-shifts from the nearest sample, so audio is unchanged.\n */\nexport function subsetUrls(\n  urls: Record<string, string>,\n  lo: number,\n  hi: number,\n): Record<string, string> {\n  const entries = Object.entries(urls)\n    .map(([k, f]) => ({ k, f, midi: noteToMidi(k) }))\n    .filter((e) => Number.isFinite(e.midi))\n    .sort((a, b) => a.midi - b.midi);\n  if (entries.length === 0) return { ...urls };\n\n  const keep = new Set<string>();\n  for (const e of entries) if (e.midi >= lo && e.midi <= hi) keep.add(e.k);\n  // nearest sample at/below lo and at/above hi for clean interpolation\n  let floor: string | undefined;\n  let ceil: string | undefined;\n  for (const e of entries) if (e.midi <= lo) floor = e.k;\n  for (const e of entries) if (e.midi >= hi) { ceil = e.k; break; }\n  if (floor) keep.add(floor);\n  if (ceil) keep.add(ceil);\n  if (keep.size === 0) {\n    // range entirely outside the sample set — keep the single nearest sample\n    const mid = (lo + hi) / 2;\n    const nearest = entries.reduce((a, b) => (Math.abs(b.midi - mid) < Math.abs(a.midi - mid) ? b : a));\n    keep.add(nearest.k);\n  }\n\n  const out: Record<string, string> = {};\n  for (const e of entries) if (keep.has(e.k)) out[e.k] = e.f;\n  return out;\n}\n\n/** Resolve a representative sample URL for an instrument (its first sample),\n * used to probe availability. undefined when a local instrument has no\n * `soundsBaseUrl` or the def has no samples. */\nexport function instrumentSampleUrl(def: InstrumentDef, soundsBaseUrl?: string): string | undefined {\n  if (def.local && soundsBaseUrl === undefined) return undefined;\n  const base = def.local ? `${normalizeBase(soundsBaseUrl ?? '')}${def.baseUrl}` : def.baseUrl;\n  const file = Object.values(def.urls)[0];\n  return file === undefined ? undefined : `${normalizeBase(base)}${file}`;\n}\n\n/**\n * Liveness check for a sample URL: a single tiny ranged GET (one byte), the\n * same CORS-enabled fetch Tone uses to load the buffer — so a pass means Tone\n * can actually load it. Resolves false on any error/timeout/non-2xx, and false\n * (no throw) when `fetch` is unavailable (Node/SSR). `Range: bytes=0-0` is a\n * CORS-safelisted header, so no preflight.\n */\nexport async function probeUrl(url: string, timeoutMs = 6000): Promise<boolean> {\n  if (typeof fetch === 'undefined') return false;\n  const ctrl = typeof AbortController !== 'undefined' ? new AbortController() : undefined;\n  const timer = ctrl ? setTimeout(() => ctrl.abort(), timeoutMs) : undefined;\n  try {\n    const res = await fetch(url, {\n      method: 'GET',\n      headers: { Range: 'bytes=0-0' },\n      cache: 'no-store',\n      signal: ctrl?.signal,\n    });\n    return res.ok; // 200 / 206\n  } catch {\n    return false;\n  } finally {\n    if (timer !== undefined) clearTimeout(timer);\n  }\n}\n\n/** Snap an arbitrary bpm to the nearest available tabla tempo. */\nexport function nearestTablaBpm(bpm: number): number {\n  return TABLA_BPMS.reduce((best, b) => (Math.abs(b - bpm) < Math.abs(best - bpm) ? b : best), TABLA_BPMS[0]!);\n}\n\n/** URL of the tabla loop for a taal at a (snapped) bpm. */\nexport function tablaUrl(base: string, taalId: string, bpm: number): string {\n  return `${normalizeBase(base)}tabla/${taalId}/${taalId}${bpm}bpm.mp3`;\n}\n\n/** URL of the metronome click. */\nexport function metronomeUrl(base: string): string {\n  return `${normalizeBase(base)}metronome/metro2.mp3`;\n}\n\n/** Build the metronome click `Tone.Player`. */\nexport function createMetronome(Tone: ToneModule, base: string) {\n  return new Tone.Player(metronomeUrl(base));\n}\n\n/** Tanpura pitch-class sample stems (filename = `<stem>.mp3`). */\nexport const TANPURA_PCS = ['c', 'cs', 'd', 'ds', 'e', 'f', 'fs', 'g', 'gs', 'a', 'as', 'b'] as const;\n\n/**\n * Build a melody `Tone.Sampler` for an instrument def. Resolves the sample\n * directory (local → under `soundsBaseUrl`, else the def's absolute CDN URL)\n * and, when a MIDI `range` is given, loads only the samples that cover it.\n */\nexport function createSampler(\n  Tone: ToneModule,\n  def: InstrumentDef,\n  soundsBaseUrl: string | undefined,\n  range?: { lo: number; hi: number },\n) {\n  const base = def.local ? `${normalizeBase(soundsBaseUrl ?? '')}${def.baseUrl}` : def.baseUrl;\n  const urls = range ? subsetUrls(def.urls, range.lo, range.hi) : def.urls;\n  return new Tone.Sampler({ urls, baseUrl: normalizeBase(base), release: def.release ?? 1 });\n}\n\n/** Build a tanpura `Tone.Players` loading only the given pitch-class stems\n * (the drone only ever plays Sa + Pa, so we fetch 2 files, not 12). */\nexport function createTanpura(Tone: ToneModule, base: string, stems: readonly string[] = TANPURA_PCS) {\n  const urls: Record<string, string> = {};\n  for (const s of stems) urls[s] = `${s}.mp3`;\n  return new Tone.Players({ urls, baseUrl: `${normalizeBase(base)}tanpura/` });\n}\n","/**\n * `SwaralipiPlayer` — the stateful audio facade over Tone.js.\n *\n * Tone is **dynamically imported** on first `play()` so that importing\n * `@ugfoundation/swaralipi-js/player` in Node/SSR (or just to reach the pure\n * helpers) never pulls in the audio engine or touches `AudioContext`. The\n * pure cores (pitch.ts, schedule.ts, instruments.ts) carry the logic; this\n * class only wires them onto the Tone Transport and drives the viewer's\n * `highlight()`.\n *\n * Model: build a beat-timed `Schedule`, lay each note onto the Transport in\n * seconds (`beat × 60/bpm`), loop a tabla (or click a metronome) underneath,\n * drone a tanpura, and fire highlights on Tone's draw thread. Any setting\n * change while playing re-arranges from the top (documented v1 behavior — no\n * mid-stream tempo ramp or seek).\n */\nimport type { Gain, Players, Player, Sampler } from 'tone';\nimport type { Swaralipi } from '../spec/index.js';\n// TAALS from the taals subpath, not the barrel — see the note in instruments.ts\n// (the barrel pulls zod, which would defeat the player's bare-load guarantee).\nimport { TAALS, type TaalId } from '../spec/taals.js';\nimport { midiToSampleName, parseTonic } from './pitch.js';\nimport { buildSchedule, type Schedule } from './schedule.js';\nimport {\n  DEFAULT_SOUNDS_BASE,\n  INSTRUMENTS,\n  SAMPLED_TAALS,\n  TANPURA_PCS,\n  createMetronome,\n  createSampler,\n  createTanpura,\n  instrumentSampleUrl,\n  nearestTablaBpm,\n  normalizeBase,\n  probeUrl,\n  tablaUrl,\n  type InstrumentDef,\n  type InstrumentId,\n  type ToneModule,\n} from './instruments.js';\n\n/** Seconds the accompaniment fades over when playback is stopped. */\nconst STOP_FADE_SEC = 0.5;\n\nexport type PlayerState = 'idle' | 'loading' | 'ready' | 'playing' | 'paused';\nexport type RhythmMode = 'tabla' | 'metronome' | 'none';\n\nexport interface PlayerOptions {\n  /** Base URL for the project's samples (santoor/tabla/tanpura/metronome).\n   * Defaults to `DEFAULT_SOUNDS_BASE` (the project's CORS-enabled CDN), so the\n   * player works with zero config; override to self-host. */\n  soundsBaseUrl?: string;\n  /** Grand-piano sample host. Default: the Salamander CDN (see SALAMANDER_BASE).\n   * Set this to self-host the piano under your own URL. */\n  pianoBaseUrl?: string;\n  /** Tonic (Sa). Accepts `C`, `C#`, `cs`… Default: doc tonic, else `C`. */\n  tonic?: string;\n  /** Tempo in matra/min. Default 90. Snapped to the 15-grid while tabla plays. */\n  bpm?: number;\n  /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */\n  baseOctave?: number;\n  /** Active melody instrument id (a built-in or a `customInstruments` key).\n   * Default `piano` (CDN-hosted, zero-config). Built-ins: piano, santoor,\n   * harmonium, violin, flute. */\n  instrument?: InstrumentId;\n  /** Instrument ids the UI may expose. Default: all built-ins. Narrow it to\n   * e.g. `['santoor','harmonium']` to limit the picker. */\n  instruments?: InstrumentId[];\n  /** Extra melody instruments, keyed by id — e.g. a self-hosted sitar/sarod.\n   * (True sampled sitar/sarod/sarangi/esraj have no free web set; supply your\n   * own Tone.Sampler `urls` + `baseUrl` here and they slot into the picker.) */\n  customInstruments?: Record<string, InstrumentDef>;\n  /** Rhythm accompaniment. Default `tabla` (→ metronome for unsampled taals). */\n  rhythm?: RhythmMode;\n  /** Play the tanpura drone. Default true. */\n  tanpura?: boolean;\n  /** Stop playback after this many seconds (a policy-neutral preview cap).\n   * Default `Infinity` (unlimited). The library only enforces the number it is\n   * handed; who is capped / the value / the upsell is the consumer's policy. */\n  previewLimitSec?: number;\n  /** Called when the preview cap stops playback (so the consumer can show an\n   * upsell). Not called on a normal stop()/end. */\n  onLimit?: () => void;\n  /** Called with the active note's `part.row.note` path, or null when idle. */\n  onHighlight?: (path: string | null) => void;\n  /** Called on every state transition. */\n  onState?: (state: PlayerState) => void;\n}\n\n/** Minimal shape of the viewer element the player drives (avoids a hard\n * dependency on the viewer module). `highlight` returns the highlighted node\n * (or null) so bindSheet can optionally scroll it into view. */\ninterface HighlightTarget {\n  highlight(path: string): HTMLElement | null;\n  clearHighlights(): void;\n}\n\n/** MIDI span (incl. kan graces) of a schedule's notes, for sample subsetting;\n * undefined when there are no pitched events. */\nfunction midiRange(schedule: Schedule): { lo: number; hi: number } | undefined {\n  let lo = Infinity;\n  let hi = -Infinity;\n  for (const ev of schedule.events) {\n    for (const m of [ev.midi, ev.kan]) {\n      if (m !== null) {\n        if (m < lo) lo = m;\n        if (m > hi) hi = m;\n      }\n    }\n  }\n  return lo <= hi ? { lo, hi } : undefined;\n}\n\nexport interface BindSheetOptions {\n  /** Keep the active note visible while playing by calling `scrollIntoView`\n   * on it. `true` → `'center'` (keeps the note's lyric, rendered just below it,\n   * on screen too); or pass an explicit block position (`'nearest'`, `'start'`,\n   * …). Default off so it never fights a host that manages its own scrolling.\n   * Works through the shadow boundary, so it scrolls the page, not just the\n   * sheet. */\n  autoScroll?: boolean | ScrollLogicalPosition;\n}\n\n/** The common melody-voice call the scheduler needs — both melody instruments\n * are `Tone.Sampler`s, but this keeps the call site decoupled from the class. */\ninterface MelodyVoice {\n  triggerAttackRelease(note: string, duration: number, time: number): unknown;\n}\n\nexport class SwaralipiPlayer {\n  #opts: Required<\n    Omit<\n      PlayerOptions,\n      | 'soundsBaseUrl'\n      | 'pianoBaseUrl'\n      | 'customInstruments'\n      | 'onHighlight'\n      | 'onState'\n      | 'onLimit'\n      | 'tonic'\n      | 'bpm'\n    >\n  > & {\n    soundsBaseUrl?: string;\n    pianoBaseUrl?: string;\n    customInstruments?: Record<string, InstrumentDef>;\n    tonic?: string;\n    /** Pinned constructor tempo: overrides meta.bpm, survives load(). */\n    bpm?: number;\n    onHighlight?: (path: string | null) => void;\n    onState?: (state: PlayerState) => void;\n    onLimit?: () => void;\n  };\n  /** Per-song setBpm tweak: beats meta.bpm but is cleared by the next load(). */\n  #bpmTweak: number | undefined;\n  #doc: Swaralipi | undefined;\n  #state: PlayerState = 'idle';\n\n  #tone: ToneModule | undefined;\n  /** Master bus everything routes through, so stop() can fade it out. */\n  #master: Gain | undefined;\n  /** Cached melody samplers keyed by instrument id, with the MIDI range each\n   * was loaded for (rebuilt when a song needs a wider range). */\n  #samplers = new Map<string, { sampler: Sampler; lo: number; hi: number }>();\n  #tanpura: Players | undefined;\n  #tanpuraKey = '';\n  #metronome: Player | undefined;\n  #tabla: Player | undefined;\n  #scheduleIds: number[] = [];\n  #fadeTimer: ReturnType<typeof setTimeout> | undefined;\n\n  constructor(options: PlayerOptions = {}) {\n    this.#opts = {\n      soundsBaseUrl: options.soundsBaseUrl ?? DEFAULT_SOUNDS_BASE,\n      pianoBaseUrl: options.pianoBaseUrl,\n      customInstruments: options.customInstruments,\n      tonic: options.tonic,\n      bpm: options.bpm,\n      baseOctave: options.baseOctave ?? 4,\n      instrument: options.instrument ?? 'piano',\n      instruments: options.instruments ?? Object.keys(INSTRUMENTS),\n      rhythm: options.rhythm ?? 'tabla',\n      tanpura: options.tanpura ?? true,\n      previewLimitSec: options.previewLimitSec ?? Infinity,\n      onHighlight: options.onHighlight,\n      onState: options.onState,\n      onLimit: options.onLimit,\n    };\n  }\n\n  /* ----------------------------------------------------------------- */\n  /* Public getters                                                     */\n  /* ----------------------------------------------------------------- */\n\n  get state(): PlayerState {\n    return this.#state;\n  }\n  get bpm(): number {\n    return this.#bpmTweak ?? this.#opts.bpm ?? this.#doc?.meta.bpm ?? 90;\n  }\n  /** The preview cap in seconds (`Infinity` = unlimited). */\n  get previewLimitSec(): number {\n    return this.#opts.previewLimitSec;\n  }\n  get instrument(): InstrumentId {\n    return this.#effectiveInstrument();\n  }\n  get instruments(): InstrumentId[] {\n    return [...this.#opts.instruments];\n  }\n  /** The taal currently driving the rhythm (auto from the doc, or an override). */\n  get taalId(): TaalId | undefined {\n    return this.#taalId();\n  }\n  /** Whether the effective rhythm will actually be a sampled tabla. */\n  get usesTabla(): boolean {\n    const id = this.#taalId();\n    return this.#opts.rhythm === 'tabla' && id !== undefined && SAMPLED_TAALS.has(id) && !!this.#opts.soundsBaseUrl;\n  }\n\n  /* ----------------------------------------------------------------- */\n  /* Loading + transport control                                        */\n  /* ----------------------------------------------------------------- */\n\n  /** Set the document to play. Stops any current playback. */\n  load(doc: Swaralipi): void {\n    this.#halt();\n    this.#doc = doc;\n    this.#taalOverride = undefined;\n    this.#bpmTweak = undefined; // per-song tweak does not carry across songs\n    this.#setState('ready');\n  }\n\n  /** Start (or resume) playback. Must be triggered from a user gesture so the\n   * browser permits `AudioContext` resume. */\n  async play(): Promise<void> {\n    if (this.#doc === undefined || this.#state === 'playing') return;\n    const Tone = await this.#ensureTone();\n    await Tone.start();\n\n    if (this.#state === 'paused') {\n      Tone.getTransport().start();\n      this.#setState('playing');\n      return;\n    }\n\n    // Fresh start — abort any in-flight stop fade and clear a left-running\n    // transport before re-arranging.\n    this.#cancelFade();\n    Tone.getTransport().stop();\n    this.#setState('loading');\n    await this.#arrange(Tone);\n    Tone.getTransport().start();\n    this.#setState('playing');\n\n    // Preview cap: stop at the limit and notify (policy is the consumer's).\n    const limit = this.#opts.previewLimitSec;\n    if (Number.isFinite(limit)) {\n      Tone.getTransport().scheduleOnce(() => {\n        // getDraw defers to the visual frame so stop() runs off the audio thread.\n        Tone.getDraw().schedule(() => {\n          if (this.#state === 'playing') {\n            this.stop();\n            this.#opts.onLimit?.();\n          }\n        }, this.#tone!.now());\n      }, limit);\n    }\n  }\n\n  /** Pause; `play()` resumes from the same position. */\n  pause(): void {\n    if (this.#tone === undefined || this.#state !== 'playing') return;\n    this.#tone.getTransport().pause();\n    this.#setState('paused');\n  }\n\n  /**\n   * Stop and rewind to the start. When sounding, the accompaniment (tabla /\n   * metronome / tanpura, which otherwise loop) is gently faded out over\n   * STOP_FADE_SEC before the transport is halted, so the rhythm doesn't keep\n   * playing or cut abruptly; otherwise it halts immediately.\n   */\n  stop(): void {\n    if (this.#tone === undefined || this.#state === 'idle') {\n      this.#halt();\n      return;\n    }\n    if ((this.#state === 'playing' || this.#state === 'paused') && this.#master !== undefined) {\n      const now = this.#tone.now();\n      this.#master.gain.cancelScheduledValues(now);\n      this.#master.gain.rampTo(0, STOP_FADE_SEC, now);\n      this.#emitHighlight(null);\n      this.#setState(this.#doc ? 'ready' : 'idle');\n      this.#cancelFadeTimer();\n      this.#fadeTimer = setTimeout(() => this.#halt(), STOP_FADE_SEC * 1000 + 60);\n      return;\n    }\n    this.#halt();\n  }\n\n  /** Immediate, synchronous teardown: stop+rewind the transport, kill the\n   * looping accompaniment, restore the master gain for the next play. */\n  #halt(): void {\n    this.#cancelFadeTimer();\n    if (this.#tone !== undefined) {\n      const transport = this.#tone.getTransport();\n      transport.stop();\n      transport.cancel(0);\n      transport.position = 0;\n    }\n    // Dispose the looping tabla outright — a synced loop can outlive a bare\n    // transport.stop(); #arrange recreates it on the next play.\n    this.#tabla?.dispose();\n    this.#tabla = undefined;\n    this.#restoreMasterGain();\n    this.#scheduleIds = [];\n    this.#emitHighlight(null);\n    if (this.#state !== 'idle') this.#setState(this.#doc ? 'ready' : 'idle');\n  }\n\n  #cancelFadeTimer(): void {\n    if (this.#fadeTimer !== undefined) {\n      clearTimeout(this.#fadeTimer);\n      this.#fadeTimer = undefined;\n    }\n  }\n\n  /** Abort an in-flight stop-fade (timer + gain ramp) without touching the\n   * transport — used when play() interrupts a fade. */\n  #cancelFade(): void {\n    this.#cancelFadeTimer();\n    this.#restoreMasterGain();\n  }\n\n  #restoreMasterGain(): void {\n    if (this.#master !== undefined && this.#tone !== undefined) {\n      this.#master.gain.cancelScheduledValues(this.#tone.now());\n      this.#master.gain.value = 1;\n    }\n  }\n\n  /* ----------------------------------------------------------------- */\n  /* Settings (re-arrange from the top if mid-playback)                 */\n  /* ----------------------------------------------------------------- */\n\n  setTonic(tonic: string): void {\n    this.#opts.tonic = tonic;\n    this.#reapply();\n  }\n  setBpm(bpm: number): void {\n    this.#bpmTweak = bpm;\n    this.#reapply();\n  }\n  /** Update the preview cap (`Infinity` lifts it). Takes effect on next play. */\n  setPreviewLimit(sec: number): void {\n    this.#opts.previewLimitSec = sec;\n  }\n  setInstrument(instrument: InstrumentId): void {\n    this.#opts.instrument = instrument;\n    this.#reapply();\n  }\n  setRhythm(rhythm: RhythmMode): void {\n    this.#opts.rhythm = rhythm;\n    this.#reapply();\n  }\n  setTanpura(on: boolean): void {\n    this.#opts.tanpura = on;\n    this.#reapply();\n  }\n  /** Override the taal (null restores auto-detection from `meta.taal`). */\n  setTaal(id: TaalId | null): void {\n    this.#taalOverride = id ?? undefined;\n    this.#taalAuto = id === null;\n    this.#reapply();\n  }\n\n  /** Wire highlight output to a `<swaralipi-sheet>` (or any highlight target).\n   * Pass `{ autoScroll }` to keep the active note in view while playing. */\n  bindSheet(target: HighlightTarget, opts: BindSheetOptions = {}): void {\n    // 'center' so the lyric directly below the note stays on screen too\n    // ('nearest' can park the note at the bottom edge, hiding its lyric).\n    const block: ScrollLogicalPosition | undefined =\n      opts.autoScroll === true ? 'center' : opts.autoScroll || undefined;\n    this.#opts.onHighlight = (path) => {\n      target.clearHighlights();\n      if (path === null) return;\n      const el = target.highlight(path);\n      if (block !== undefined && el !== null) {\n        el.scrollIntoView({ block, inline: 'nearest', behavior: 'smooth' });\n      }\n    };\n  }\n\n  /**\n   * Check whether an instrument's samples are reachable (its CDN is up / the\n   * local files exist), via a one-byte ranged fetch of a representative sample.\n   * A pass means Tone can actually load it. `false` for unknown ids, local\n   * instruments with no `soundsBaseUrl`, or any network failure/timeout.\n   */\n  async checkInstrument(id: string, timeoutMs?: number): Promise<boolean> {\n    const def = this.#resolveDef(id);\n    if (def === undefined) return false;\n    const url = instrumentSampleUrl(def, this.#opts.soundsBaseUrl);\n    if (url === undefined) return false;\n    return probeUrl(url, timeoutMs);\n  }\n\n  /**\n   * Probe several instruments at once (default: the exposed `instruments`),\n   * returning `{ id: available }`. Use it to disable picker options whose CDN\n   * or files are down. Probes run concurrently; a check never throws.\n   */\n  async checkInstruments(\n    ids: string[] = this.#opts.instruments,\n    timeoutMs?: number,\n  ): Promise<Record<string, boolean>> {\n    const entries = await Promise.all(\n      ids.map(async (id) => [id, await this.checkInstrument(id, timeoutMs)] as const),\n    );\n    return Object.fromEntries(entries);\n  }\n\n  /** Release all audio resources. The instance is unusable afterward. */\n  dispose(): void {\n    this.#halt();\n    for (const { sampler } of this.#samplers.values()) sampler.dispose();\n    this.#samplers.clear();\n    this.#tanpura?.dispose();\n    this.#metronome?.dispose();\n    this.#tabla?.dispose();\n    this.#master?.dispose();\n    this.#tanpura = this.#metronome = this.#tabla = this.#master = undefined;\n  }\n\n  /* ----------------------------------------------------------------- */\n  /* Internals                                                          */\n  /* ----------------------------------------------------------------- */\n\n  #taalOverride: TaalId | undefined;\n  #taalAuto = true;\n\n  #setState(state: PlayerState): void {\n    this.#state = state;\n    this.#opts.onState?.(state);\n  }\n\n  #emitHighlight(path: string | null): void {\n    this.#opts.onHighlight?.(path);\n  }\n\n  /** Resolve the active taal: an explicit override, else the doc's. */\n  #taalId(): TaalId | undefined {\n    if (!this.#taalAuto && this.#taalOverride !== undefined) return this.#taalOverride;\n    const id = this.#doc?.meta.taal?.id;\n    return id !== undefined && id in TAALS ? (id as TaalId) : undefined;\n  }\n\n  /** Resolve an instrument id to its def (custom overrides built-ins; the\n   * `pianoBaseUrl` shortcut self-hosts the built-in piano). */\n  #resolveDef(id: string): InstrumentDef | undefined {\n    const custom = this.#opts.customInstruments?.[id];\n    if (custom) return custom;\n    const def = INSTRUMENTS[id];\n    if (def && id === 'piano' && this.#opts.pianoBaseUrl) {\n      return { ...def, baseUrl: normalizeBase(this.#opts.pianoBaseUrl) };\n    }\n    return def;\n  }\n\n  /** A CDN-backed instrument that needs no `soundsBaseUrl` — used when the\n   * chosen one is local-only and no samples host is set, or is unknown. */\n  #fallbackInstrument(): string {\n    const exposed = this.#opts.instruments.find((id) => {\n      const d = this.#resolveDef(id);\n      return d !== undefined && d.local !== true;\n    });\n    return exposed ?? 'harmonium';\n  }\n\n  /** The instrument actually used: the chosen one, unless it's local-only with\n   * no `soundsBaseUrl` (or unknown), in which case a CDN fallback. */\n  #effectiveInstrument(): string {\n    const id = this.#opts.instrument;\n    const def = this.#resolveDef(id);\n    if (def === undefined) return this.#fallbackInstrument();\n    if (def.local === true && !this.#opts.soundsBaseUrl) return this.#fallbackInstrument();\n    return id;\n  }\n\n  /** Effective tempo: snapped to the tabla grid while a tabla actually plays. */\n  #effectiveBpm(): number {\n    return this.usesTabla ? nearestTablaBpm(this.bpm) : this.bpm;\n  }\n\n  async #ensureTone(): Promise<ToneModule> {\n    this.#tone ??= await import('tone');\n    return this.#tone;\n  }\n\n  /** Hard stop → rebuild → restart, only while playing; otherwise just store.\n   * Uses #halt (not the stop() fade) so a setting change restarts instantly. */\n  #reapply(): void {\n    if (this.#state !== 'playing') return;\n    this.#halt();\n    void this.play();\n  }\n\n  /** The master bus everything routes through (created once, → destination). */\n  #ensureMaster(Tone: ToneModule): Gain {\n    this.#master ??= new Tone.Gain(1).toDestination();\n    return this.#master;\n  }\n\n  /** Build the melody instrument(s)/rhythm/drone for the current settings and\n   * wait for their buffers, then schedule everything on the Transport. */\n  async #arrange(Tone: ToneModule): Promise<void> {\n    if (this.#doc === undefined) return;\n    const base = this.#opts.soundsBaseUrl;\n    const transport = Tone.getTransport();\n    transport.cancel(0);\n    transport.position = 0;\n    this.#scheduleIds = [];\n\n    // Fresh master bus at unity gain (a prior stop-fade may have lowered it).\n    this.#ensureMaster(Tone);\n    this.#restoreMasterGain();\n\n    const bpm = this.#effectiveBpm();\n    transport.bpm.value = bpm;\n    const spb = 60 / bpm;\n\n    // Build the (pure) schedule first so the melody sampler loads only the\n    // samples covering this song's pitch range — fewer files to fetch.\n    const schedule: Schedule = buildSchedule(this.#doc, {\n      tonic: this.#opts.tonic,\n      baseOctave: this.#opts.baseOctave,\n    });\n    const range = midiRange(schedule);\n\n    // --- melody instrument ---\n    const melody = this.#buildMelody(Tone, this.#effectiveInstrument(), base, range);\n\n    // --- rhythm ---\n    this.#buildRhythm(Tone, transport, base, spb);\n\n    // --- tanpura drone ---\n    this.#buildTanpura(Tone, transport, base, spb);\n\n    // wait for the (now-minimal) sample set to load before scheduling\n    await Tone.loaded();\n\n    // --- notes + highlights ---\n    const draw = Tone.getDraw();\n\n    for (const ev of schedule.events) {\n      const at = ev.beat * spb;\n      if (ev.midi !== null) {\n        const name = midiToSampleName(ev.midi);\n        const dur = Math.max(ev.durationBeats * spb, 0.05);\n        if (ev.kan !== null) {\n          const kanName = midiToSampleName(ev.kan);\n          transport.scheduleOnce((time) => melody.triggerAttackRelease(kanName, spb * 0.4, time), Math.max(at - spb * 0.12, 0));\n        }\n        transport.scheduleOnce((time) => melody.triggerAttackRelease(name, dur, time), at);\n      }\n      transport.scheduleOnce((time) => {\n        draw.schedule(() => this.#emitHighlight(ev.path), time);\n      }, at);\n    }\n\n    // clear highlight + auto-stop at the end\n    const endAt = schedule.totalBeats * spb + spb;\n    transport.scheduleOnce((time) => {\n      draw.schedule(() => this.#emitHighlight(null), time);\n    }, schedule.totalBeats * spb);\n    transport.scheduleOnce(() => this.stop(), endAt);\n  }\n\n  /** Build (or reuse) the melody sampler for `id`, loading only the samples\n   * covering `range`. A cached sampler is reused while it still covers the\n   * range; otherwise it's rebuilt (so changing songs/tonic widens it lazily). */\n  #buildMelody(\n    Tone: ToneModule,\n    id: string,\n    base: string | undefined,\n    range: { lo: number; hi: number } | undefined,\n  ): MelodyVoice {\n    const def = this.#resolveDef(id) ?? INSTRUMENTS.harmonium!;\n    const master = this.#ensureMaster(Tone);\n    const cached = this.#samplers.get(id);\n    if (cached && (range === undefined || (cached.lo <= range.lo && cached.hi >= range.hi))) {\n      return cached.sampler;\n    }\n    cached?.sampler.dispose();\n    const sampler = createSampler(Tone, def, base, range).connect(master);\n    this.#samplers.set(id, { sampler, lo: range?.lo ?? -Infinity, hi: range?.hi ?? Infinity });\n    return sampler;\n  }\n\n  #buildRhythm(Tone: ToneModule, transport: ReturnType<ToneModule['getTransport']>, base: string | undefined, spb: number): void {\n    // dispose a stale tabla loop so it doesn't double up after a re-arrange\n    this.#tabla?.dispose();\n    this.#tabla = undefined;\n\n    const master = this.#ensureMaster(Tone);\n    const taalId = this.#taalId();\n    const wantsTabla = this.#opts.rhythm === 'tabla' && taalId !== undefined && SAMPLED_TAALS.has(taalId) && base !== undefined;\n\n    if (wantsTabla) {\n      const url = tablaUrl(base!, taalId!, nearestTablaBpm(this.bpm));\n      this.#tabla = new Tone.Player({ url, loop: true }).connect(master);\n      this.#tabla.sync().start(0);\n      return;\n    }\n\n    if (this.#opts.rhythm === 'none' || base === undefined) return;\n\n    // metronome fallback: a click each beat, louder on sam (cycle start)\n    this.#metronome ??= createMetronome(Tone, base).connect(master);\n    const metro = this.#metronome;\n    const cycle = (taalId !== undefined ? TAALS[taalId].numBeats : 4);\n    let beat = 0;\n    const id = transport.scheduleRepeat((time) => {\n      metro.volume.setValueAtTime(beat % cycle === 0 ? 0 : -8, time);\n      metro.start(time);\n      beat += 1;\n    }, spb, 0);\n    this.#scheduleIds.push(id);\n  }\n\n  #buildTanpura(Tone: ToneModule, transport: ReturnType<ToneModule['getTransport']>, base: string | undefined, spb: number): void {\n    if (!this.#opts.tanpura || base === undefined) return;\n\n    // Pa–Sa–Sa–Sa drone, one pluck every two beats, cycling.\n    const tonicPc = ((this.#tonicSemitone() % 12) + 12) % 12;\n    const sa = TANPURA_PCS[tonicPc]!;\n    const pa = TANPURA_PCS[(tonicPc + 7) % 12]!;\n\n    // Load only the two pitch classes the drone uses (not all 12); rebuild if\n    // the tonic changed.\n    const key = `${sa},${pa}`;\n    if (this.#tanpura === undefined || this.#tanpuraKey !== key) {\n      this.#tanpura?.dispose();\n      this.#tanpura = createTanpura(Tone, base, [sa, pa]).connect(this.#ensureMaster(Tone));\n      this.#tanpuraKey = key;\n    }\n    const players = this.#tanpura;\n    players.volume.value = -14;\n\n    const pattern = [pa, sa, sa, sa];\n    let i = 0;\n    const id = transport.scheduleRepeat((time) => {\n      const stem = pattern[i % pattern.length]!;\n      if (players.has(stem)) players.player(stem).start(time);\n      i += 1;\n    }, spb * 2, 0);\n    this.#scheduleIds.push(id);\n  }\n\n  #tonicSemitone(): number {\n    return parseTonic(this.#opts.tonic ?? this.#doc?.meta.tonic);\n  }\n}\n"]}
+{"version":3,"sources":["../../src/spec/taals.ts","../../src/player/pitch.ts","../../src/player/schedule.ts","../../src/player/instruments.ts","../../src/player/player.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { Taal } from './schema.js';\n\n/**\n * Reference definitions for the taals the player will sample:\n * adachautaal, dadra, ektaal, jhaptaal, kehrwa, rupak, shashthi, teentaal.\n *\n * `numBeats` and the `bhaags` given below are standard Hindustani taal theory.\n * `bhaags` is omitted where a single canonical division isn't well-agreed\n * (adachautaal) — we assert only what's uncontested. `sam` is beat 0 for all.\n *\n * Tabla loops live under `tabla/<id>/` by default; per-taal variation and\n * skip-bpm overrides (e.g. shashthi → `tabla/shashthi-pro/`) are in\n * instruments.ts's `TABLA_VARIATIONS`.\n */\nexport const TAALS = {\n  dadra: { id: 'dadra', numBeats: 6, bhaags: [3, 3], sam: 0, khaali: [3] },\n  kehrwa: { id: 'kehrwa', numBeats: 8, bhaags: [4, 4], sam: 0, khaali: [4] },\n  rupak: { id: 'rupak', numBeats: 7, bhaags: [3, 2, 2], sam: 0, khaali: [0] },\n  jhaptaal: { id: 'jhaptaal', numBeats: 10, bhaags: [2, 3, 2, 3], sam: 0, khaali: [5] },\n  ektaal: { id: 'ektaal', numBeats: 12, bhaags: [2, 2, 2, 2, 2, 2], sam: 0, khaali: [2, 6] },\n  adachautaal: { id: 'adachautaal', numBeats: 14, sam: 0 },\n  shashthi: { id: 'shashthi', numBeats: 6, bhaags: [2, 4], sam: 0 }, // ষষ্ঠী\n  teentaal: { id: 'teentaal', numBeats: 16, bhaags: [4, 4, 4, 4], sam: 0, khaali: [8] },\n} as const satisfies Record<string, Taal>;\n\nexport type TaalId = keyof typeof TAALS;\n","/**\n * Pure svara → pitch math for the player. No Tone, no audio — unit-testable\n * in plain Node and shared by the scheduler.\n *\n * The model: a tonic (Sa) pitch-class + a per-note scale degree + octave\n * register + komal/tivra/microtone accidentals → an absolute MIDI number,\n * which the Tone.Sampler pitch-shifts from the nearest santoor sample.\n */\nimport type { Note, Octave, SvaraLetter } from '../spec/index.js';\n\n/** Octave register offset in octaves, relative to madhyam (middle). */\nexport const OCTAVE_OFFSET: Record<Octave, number> = {\n  'ati-mandra': -2,\n  mandra: -1,\n  madhyam: 0,\n  taar: 1,\n  'ati-taar': 2,\n};\n\n/**\n * Shuddha (natural) scale degrees in semitones above Sa — the Bilawal/major\n * thaat that Rabindrasangeet swaralipi notates against. `d` = dha, `n` = ni\n * (standard sargam letter convention).\n */\nexport const SHUDDHA: Record<SvaraLetter, number> = {\n  s: 0,\n  r: 2,\n  g: 4,\n  m: 5,\n  p: 7,\n  d: 9,\n  n: 11,\n};\n\n/** Sharp-spelled pitch-class names, index = semitone 0–11. */\nconst SHARP_NAMES = ['C', 'C#', 'D', 'D#', 'E', 'F', 'F#', 'G', 'G#', 'A', 'A#', 'B'] as const;\n\n/** Pitch-class lookup. Accepts sharps (`C#`, `Cs`, `cs`) and flats (`Db`). */\nconst PITCH_CLASS: Record<string, number> = {\n  c: 0,\n  'c#': 1,\n  db: 1,\n  d: 2,\n  'd#': 3,\n  eb: 3,\n  e: 4,\n  'e#': 5,\n  fb: 4,\n  f: 5,\n  'f#': 6,\n  gb: 6,\n  g: 7,\n  'g#': 8,\n  ab: 8,\n  a: 9,\n  'a#': 10,\n  bb: 10,\n  b: 11,\n  'b#': 0,\n  cb: 11,\n};\n\n/**\n * Parse a tonic string to a pitch-class 0–11. Accepts `C`, `C#`, `Db`, and\n * the player/sample lowercase-`s` sharp form (`cs`, `Cs`); case-insensitive.\n * Unknown input falls back to 0 (C).\n */\nexport function parseTonic(tonic: string | undefined): number {\n  if (!tonic) return 0;\n  const key = tonic.trim().toLowerCase().replace(/s/g, '#');\n  return PITCH_CLASS[key] ?? 0;\n}\n\n/**\n * Semitone of a note relative to Sa (degree + accidentals), ignoring octave.\n * Returns null when the note carries no pitch (rest/sustain-hold/bar).\n *\n * Microtones (অল্পকোমল/অতিকোমল) are approximated to the komal pitch — a\n * documented v1 limitation (the sampler can't bend a sub-komal microtone\n * cleanly per note); matches the viewer's placeholder treatment.\n */\nexport function svaraSemitone(note: Note): number | null {\n  if (note.svara === undefined) return null;\n  const [, letter] = note.svara;\n  let semi = SHUDDHA[letter];\n  if (note.komal === true || note.microtone !== undefined) semi -= 1;\n  if (note.tivra === true) semi += 1;\n  return semi;\n}\n\n/**\n * Absolute MIDI for a note, or null when it has no pitch. madhyam Sa lands on\n * the tonic in octave `baseOctave` (C4 = MIDI 60). Out-of-sample registers\n * are produced by the Sampler pitch-shifting from the nearest recorded note.\n */\nexport function svaraToMidi(note: Note, tonicPc: number, baseOctave = 4): number | null {\n  const semi = svaraSemitone(note);\n  if (semi === null || note.svara === undefined) return null;\n  const [octave] = note.svara;\n  return (baseOctave + 1 + OCTAVE_OFFSET[octave]) * 12 + tonicPc + semi;\n}\n\n/** MIDI of a kan (grace) svara — a bare `Svara` tuple, no accidentals. */\nexport function kanToMidi(\n  svara: Note['kan'],\n  tonicPc: number,\n  baseOctave = 4,\n): number | null {\n  if (svara === undefined) return null;\n  const [octave, letter] = svara;\n  return (baseOctave + 1 + OCTAVE_OFFSET[octave]) * 12 + tonicPc + SHUDDHA[letter];\n}\n\n/** MIDI → Tone note name (`C#4`). */\nexport function midiToSampleName(midi: number): string {\n  const pc = ((midi % 12) + 12) % 12;\n  const octave = Math.floor(midi / 12) - 1;\n  return `${SHARP_NAMES[pc]}${octave}`;\n}\n\n/** MIDI → santoor sample filename stem (`cs4`): lowercase, `#` → `s`. */\nexport function sampleFileName(midi: number): string {\n  return midiToSampleName(midi).toLowerCase().replace('#', 's');\n}\n","/**\n * Pure spec-doc → playback timeline. No Tone, no audio — the player turns\n * this `Schedule` into Transport events, but it is fully unit-testable on its\n * own and mirrors the viewer's spec-driven (not raw-driven) reading.\n *\n * Timing unit is the মাত্রা (matra / beat). One global beat cursor runs across\n * every part and row: NLTR \"systems\" (rows) are wraps of one continuous line,\n * and parts (asthayi → antara …) play back-to-back, so the music never pauses\n * at a row or part boundary.\n *\n * Each audible column carries the same `data-note` path the viewer emits\n * (`part.row.note`, note = absolute index into `row.notes`; see\n * src/viewer/render.ts), so `SwaralipiPlayer` can drive `highlight()` directly.\n */\nimport type { Note, Swaralipi } from '../spec/index.js';\nimport { kanToMidi, parseTonic, svaraToMidi } from './pitch.js';\n\nexport interface PlayEvent {\n  /** Onset in matra from the start of the document. */\n  beat: number;\n  /** Ring length in matra (extended by following আ-কার holds). */\n  durationBeats: number;\n  /** Pitch as MIDI, or null for a rest / আ-কার hold column. */\n  midi: number | null;\n  /** Grace-note MIDI struck just before the main attack, when present. */\n  kan: number | null;\n  /** `part.row.note` highlight path. */\n  path: string;\n  kind: 'note' | 'rest' | 'sustain';\n}\n\nexport interface Schedule {\n  events: PlayEvent[];\n  /** Total length in matra (the cursor's final value). */\n  totalBeats: number;\n}\n\nexport interface ScheduleOptions {\n  /** Tonic; accepts `C`, `C#`, `cs`… (see parseTonic). Default C. */\n  tonic?: string;\n  /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */\n  baseOctave?: number;\n}\n\n/** A column that produces no sound and no time advance (bar, bracket-only,\n * carrier, raw-only). Mirrors the viewer's non-pitched, non-rest classes. */\nconst isSilent = (n: Note): boolean =>\n  n.svara === undefined && n.rest !== true && n.sustain !== true;\n\n/**\n * Walk a document into a flat, time-ordered list of play events.\n *\n *  - svara note → an attack at the cursor; advances by `durationMatra ?? 1`.\n *  - rest → a silent column that still advances the cursor.\n *  - sustain **with** svara (melisma) → a fresh attack (the pitch moves under\n *    a held vowel); advances.\n *  - sustain **without** svara (আ-কার hold) → no attack, but the previous\n *    audible note's ring is extended; still emitted (midi null) so the lyric\n *    column highlights; advances.\n *  - bar / bracket-only / carrier / raw-only → ignored (no event, no advance).\n */\nexport function buildSchedule(doc: Swaralipi, opts: ScheduleOptions = {}): Schedule {\n  const tonicPc = parseTonic(opts.tonic ?? doc.meta.tonic);\n  const baseOctave = opts.baseOctave ?? 4;\n  const events: PlayEvent[] = [];\n  let cursor = 0;\n  /** Index in `events` of the last pitched attack, for hold-extension. */\n  let lastPitched = -1;\n\n  doc.parts.forEach((part, p) => {\n    part.rows.forEach((row, r) => {\n      row.notes.forEach((note, i) => {\n        if (note.bar !== undefined || isSilent(note)) return;\n        const path = `${p}.${r}.${i}`;\n        const dur = note.durationMatra ?? 1;\n\n        if (note.svara !== undefined) {\n          // svara note or melisma — a real attack.\n          events.push({\n            beat: cursor,\n            durationBeats: dur,\n            midi: svaraToMidi(note, tonicPc, baseOctave),\n            kan: kanToMidi(note.kan, tonicPc, baseOctave),\n            path,\n            kind: note.sustain === true ? 'sustain' : 'note',\n          });\n          lastPitched = events.length - 1;\n        } else if (note.sustain === true) {\n          // আ-কার hold — extend the ringing note, emit a silent highlight column.\n          if (lastPitched >= 0) events[lastPitched]!.durationBeats += dur;\n          events.push({ beat: cursor, durationBeats: dur, midi: null, kan: null, path, kind: 'sustain' });\n        } else {\n          // rest.\n          events.push({ beat: cursor, durationBeats: dur, midi: null, kan: null, path, kind: 'rest' });\n        }\n        cursor += dur;\n      });\n    });\n  });\n\n  return { events, totalBeats: cursor };\n}\n","/**\n * Tone.js instrument/asset factories. Tone is **injected** (never imported\n * here) so this module — like the scheduler — stays free of a static `tone`\n * dependency; the player passes the dynamically-imported module in.\n *\n * Melodic instruments are a small registry (INSTRUMENTS) of Tone.Sampler\n * note→file maps + where to fetch them. `piano` (CC-BY Salamander) is the\n * default and CDN-hosted, as are `harmonium`/`violin`/`flute` (CC-BY,\n * tonejs-instruments); `santoor` is local (under the player's `soundsBaseUrl`).\n * Consumers can register more (e.g. a self-hosted sitar) via the player's\n * `customInstruments` option — true sampled sitar/sarod/sarangi/esraj have no\n * free web set, only commercial Kontakt libraries.\n *\n * Asset layout under `soundsBaseUrl`:\n *   santoor/<note>.mp3        c4..c7 + sharps (37 files)\n *   tanpura/<pc>.mp3          12 pitch classes (c, cs, d, …)\n *   tabla/<seg>/<seg><bpm>bpm.mp3   seg = <taal>[-<variation>], bpm 60..300 step 15\n *   metronome/metro2.mp3\n */\n// Import TAALS from the taals subpath (not the ../spec/index barrel): the\n// barrel re-exports schema.ts, which statically imports zod — pulling that into\n// the player would break its \"loads bare in a browser\" guarantee. taals.ts has\n// only a type-only schema import, so this keeps the player runtime zod-free.\nimport { TAALS, type TaalId } from '../spec/taals.js';\nimport { sampleFileName } from './pitch.js';\n\n/** The dynamically-imported Tone module, typed without importing it. */\nexport type ToneModule = typeof import('tone');\n\n/** A melodic instrument: a Tone.Sampler note→filename map + where to find it. */\nexport interface InstrumentDef {\n  /** Human label for UIs. */\n  label: string;\n  /** Tone.Sampler `urls`: note name (`C#4`) → filename (`Cs4.mp3`). */\n  urls: Record<string, string>;\n  /** Sample directory: an absolute URL, or — when `local` — a path segment\n   * appended to the player's `soundsBaseUrl`. */\n  baseUrl: string;\n  /** `baseUrl` is relative to `soundsBaseUrl` (needs it set). */\n  local?: boolean;\n  /** Sampler release time in seconds. */\n  release?: number;\n}\n\n/** Built-in melody instrument ids (consumers may add their own via the\n * player's `customInstruments`, so the runtime id type stays open). */\nexport type InstrumentId = string;\n\n/**\n * Default host for the project's samples (santoor / tabla / tanpura /\n * metronome) — CC-BY, redistribution-verified and CORS-enabled, so the player\n * works with zero config. Override via the player's `soundsBaseUrl` to\n * self-host. (Melody defaults to the CDN-hosted piano, so it needs no host.)\n */\nexport const DEFAULT_SOUNDS_BASE = 'https://cdn.daserve.in/swaralipijs-instruments/';\n/** CC-BY Salamander Grand Piano (Tone's de-facto piano), CDN-hosted. */\nexport const SALAMANDER_BASE = 'https://tonejs.github.io/audio/salamander/';\n/** CC-BY tonejs-instruments sample CDN (harmonium/violin/flute). */\nexport const TONEJS_INSTRUMENTS_BASE = 'https://nbrosowsky.github.io/tonejs-instruments/samples/';\n\n/** Build a Tone.Sampler `urls` map from bare note keys (`C#4` → `Cs4.mp3`). */\nfunction keyMap(keys: readonly string[]): Record<string, string> {\n  const m: Record<string, string> = {};\n  for (const k of keys) m[k] = `${k.replace('#', 's')}.mp3`;\n  return m;\n}\n\nconst PIANO_KEYS = [\n  'A0', 'C1', 'D#1', 'F#1', 'A1', 'C2', 'D#2', 'F#2', 'A2', 'C3', 'D#3', 'F#3',\n  'A3', 'C4', 'D#4', 'F#4', 'A4', 'C5', 'D#5', 'F#5', 'A5', 'C6', 'D#6', 'F#6',\n  'A6', 'C7', 'D#7', 'F#7', 'A7', 'C8',\n] as const;\n// harmonium — a core Rabindrasangeet accompaniment (C2..C5).\nconst HARMONIUM_KEYS = [\n  'C2', 'C#2', 'D2', 'D#2', 'E2', 'F2', 'F#2', 'G2', 'G#2', 'A2', 'A#2',\n  'C3', 'C#3', 'D3', 'D#3', 'E3', 'F3', 'F#3', 'G3', 'G#3', 'A3', 'A#3',\n  'C4', 'C#4', 'D4', 'D#4', 'E4', 'F4', 'F#4', 'G4', 'G#4', 'A4', 'A#4',\n  'C5', 'C#5', 'D5',\n] as const;\nconst VIOLIN_KEYS = ['A3', 'C4', 'E4', 'G4', 'A4', 'C5', 'E5', 'G5', 'A5', 'C6', 'E6', 'G6', 'A6', 'C7'] as const;\nconst FLUTE_KEYS = ['C4', 'E4', 'A4', 'C5', 'E5', 'A5', 'C6', 'E6', 'A6', 'C7'] as const;\n\n/** Built-in melody instruments. santoor is local; the rest are CDN-hosted\n * (CC-BY) so they need only network — `pianoBaseUrl`/`customInstruments`\n * override for self-hosting. */\nexport const INSTRUMENTS: Record<string, InstrumentDef> = {\n  piano: { label: 'Grand piano', urls: keyMap(PIANO_KEYS), baseUrl: SALAMANDER_BASE, release: 1 },\n  santoor: { label: 'Santoor', urls: santoorUrls(), baseUrl: 'santoor/', local: true, release: 1.2 },\n  harmonium: { label: 'Harmonium', urls: keyMap(HARMONIUM_KEYS), baseUrl: `${TONEJS_INSTRUMENTS_BASE}harmonium/`, release: 1.4 },\n  violin: { label: 'Violin', urls: keyMap(VIOLIN_KEYS), baseUrl: `${TONEJS_INSTRUMENTS_BASE}violin/`, release: 1 },\n  flute: { label: 'Flute', urls: keyMap(FLUTE_KEYS), baseUrl: `${TONEJS_INSTRUMENTS_BASE}flute/`, release: 1 },\n};\n\n/** Taals with recorded tabla loops (everything else → metronome fallback). */\nexport const SAMPLED_TAALS: ReadonlySet<TaalId> = new Set(\n  Object.keys(TAALS) as TaalId[],\n);\n\n/** Available tabla loop tempos (file suffix `…<bpm>bpm.mp3`). */\nexport const TABLA_BPMS: readonly number[] = Array.from({ length: 17 }, (_, i) => 60 + i * 15);\n\n/**\n * Tabla loop variations per taal. Most taals have one unnamed loop at\n * `tabla/<id>/`; an entry here overrides that:\n *  - `variations` lists the named variation suffixes, **first = default**.\n *    A lone named variation (shashthi → `pro`, i.e. `tabla/shashthi-pro/`) IS\n *    the default; later entries are premium upsells the player never auto-selects.\n *  - `skipBpms` are grid tempos this taal's loops were not recorded at.\n * Consumers read this to build a variation/upsell UI; the player itself only\n * ever plays the default (or whatever a doc's `meta.taal.variation` pins).\n */\nexport const TABLA_VARIATIONS: Record<\n  string,\n  { variations: string[]; skipBpms?: number[] }\n> = {\n  // ষষ্ঠী loops live under `tabla/shashthi-pro/`; full bpm grid recorded except 225.\n  shashthi: { variations: ['pro'], skipBpms: [225] },\n};\n\n/** Tabla tempos actually available for a taal: the grid minus any it lacks. */\nexport function tablaBpms(taalId: string): readonly number[] {\n  const skip = TABLA_VARIATIONS[taalId]?.skipBpms;\n  return skip && skip.length ? TABLA_BPMS.filter((b) => !skip.includes(b)) : TABLA_BPMS;\n}\n\n/** CDN directory/filename segment for a taal's tabla loop: `<taalId>` or\n * `<taalId>-<variation>` (explicit variation, else the taal's default). */\nfunction tablaSeg(taalId: string, variation?: string): string {\n  const v = variation ?? TABLA_VARIATIONS[taalId]?.variations[0]; // default = first variation, else unnamed\n  return v ? `${taalId}-${v}` : taalId;\n}\n\n/** Ensure exactly one trailing slash. */\nexport function normalizeBase(url: string): string {\n  return url.endsWith('/') ? url : `${url}/`;\n}\n\n/** The 37 santoor samples, as a Tone.Sampler `urls` map (`C4` → `c4.mp3`). */\nexport function santoorUrls(): Record<string, string> {\n  const urls: Record<string, string> = {};\n  const add = (midi: number) => {\n    const stem = sampleFileName(midi); // e.g. cs4\n    const name = stem.replace('s', '#').replace(/^(.)/, (c) => c.toUpperCase()); // C#4\n    urls[name] = `${stem}.mp3`;\n  };\n  for (let midi = 60; midi <= 95; midi++) add(midi); // C4..B6 (full)\n  add(96); // C7\n  return urls;\n}\n\nconst PC_BASE: Record<string, number> = { c: 0, d: 2, e: 4, f: 5, g: 7, a: 9, b: 11 };\n\n/** Parse a sample note name (`C#4`, `Ds3`, `Bb2`) to a MIDI number. */\nexport function noteToMidi(name: string): number {\n  const m = /^([a-g])([#sb]?)(-?\\d+)$/i.exec(name.trim());\n  if (!m) return NaN;\n  const base = PC_BASE[m[1]!.toLowerCase()]!;\n  const acc = m[2] === 'b' ? -1 : m[2] === '' ? 0 : 1; // # / s → sharp\n  return (Number(m[3]) + 1) * 12 + base + acc;\n}\n\n/**\n * Restrict a Sampler `urls` map to just the samples needed to cover MIDI\n * `[lo, hi]`: every sample inside the range, plus the nearest one below and\n * above it (so Tone interpolates the edges without extrapolating). Cuts a\n * typical song from ~37 santoor files to a handful — a big win on mobile and\n * never worse on fast links (Tone fetches what's left in parallel). The\n * Sampler pitch-shifts from the nearest sample, so audio is unchanged.\n */\nexport function subsetUrls(\n  urls: Record<string, string>,\n  lo: number,\n  hi: number,\n): Record<string, string> {\n  const entries = Object.entries(urls)\n    .map(([k, f]) => ({ k, f, midi: noteToMidi(k) }))\n    .filter((e) => Number.isFinite(e.midi))\n    .sort((a, b) => a.midi - b.midi);\n  if (entries.length === 0) return { ...urls };\n\n  const keep = new Set<string>();\n  for (const e of entries) if (e.midi >= lo && e.midi <= hi) keep.add(e.k);\n  // nearest sample at/below lo and at/above hi for clean interpolation\n  let floor: string | undefined;\n  let ceil: string | undefined;\n  for (const e of entries) if (e.midi <= lo) floor = e.k;\n  for (const e of entries) if (e.midi >= hi) { ceil = e.k; break; }\n  if (floor) keep.add(floor);\n  if (ceil) keep.add(ceil);\n  if (keep.size === 0) {\n    // range entirely outside the sample set — keep the single nearest sample\n    const mid = (lo + hi) / 2;\n    const nearest = entries.reduce((a, b) => (Math.abs(b.midi - mid) < Math.abs(a.midi - mid) ? b : a));\n    keep.add(nearest.k);\n  }\n\n  const out: Record<string, string> = {};\n  for (const e of entries) if (keep.has(e.k)) out[e.k] = e.f;\n  return out;\n}\n\n/** Resolve a representative sample URL for an instrument (its first sample),\n * used to probe availability. undefined when a local instrument has no\n * `soundsBaseUrl` or the def has no samples. */\nexport function instrumentSampleUrl(def: InstrumentDef, soundsBaseUrl?: string): string | undefined {\n  if (def.local && soundsBaseUrl === undefined) return undefined;\n  const base = def.local ? `${normalizeBase(soundsBaseUrl ?? '')}${def.baseUrl}` : def.baseUrl;\n  const file = Object.values(def.urls)[0];\n  return file === undefined ? undefined : `${normalizeBase(base)}${file}`;\n}\n\n/**\n * Liveness check for a sample URL: a single tiny ranged GET (one byte), the\n * same CORS-enabled fetch Tone uses to load the buffer — so a pass means Tone\n * can actually load it. Resolves false on any error/timeout/non-2xx, and false\n * (no throw) when `fetch` is unavailable (Node/SSR). `Range: bytes=0-0` is a\n * CORS-safelisted header, so no preflight.\n */\nexport async function probeUrl(url: string, timeoutMs = 6000): Promise<boolean> {\n  if (typeof fetch === 'undefined') return false;\n  const ctrl = typeof AbortController !== 'undefined' ? new AbortController() : undefined;\n  const timer = ctrl ? setTimeout(() => ctrl.abort(), timeoutMs) : undefined;\n  try {\n    const res = await fetch(url, {\n      method: 'GET',\n      headers: { Range: 'bytes=0-0' },\n      cache: 'no-store',\n      signal: ctrl?.signal,\n    });\n    return res.ok; // 200 / 206\n  } catch {\n    return false;\n  } finally {\n    if (timer !== undefined) clearTimeout(timer);\n  }\n}\n\n/**\n * Snap a tabla loop's end to the nearest whole beat of its measured length so a\n * slightly-mistrimmed file still phase-locks to the melody grid instead of\n * drifting a fraction of a beat each cycle. `spb` = seconds per beat (60/bpm).\n * No-op for correctly trimmed loops (already an integer beat count); never\n * extends past the buffer — a too-short file can't be repaired here.\n *\n * ponytail: belt-and-braces for off-spec audio; the real fix is trimming each\n * loop to exactly `cycles × numBeats × 60/bpm` seconds at production time.\n */\nexport function quantizeLoopEnd(durationSec: number, spb: number): number {\n  if (spb <= 0) return durationSec;\n  const beats = Math.round(durationSec / spb);\n  if (beats < 1) return durationSec; // too short to snap to a beat\n  return Math.min(beats * spb, durationSec);\n}\n\n/** Snap an arbitrary bpm to the nearest available tabla tempo (default grid;\n * pass a taal's `tablaBpms()` so it never snaps to a tempo that taal lacks). */\nexport function nearestTablaBpm(bpm: number, bpms: readonly number[] = TABLA_BPMS): number {\n  return bpms.reduce((best, b) => (Math.abs(b - bpm) < Math.abs(best - bpm) ? b : best), bpms[0]!);\n}\n\n/** URL of the tabla loop for a taal at a (snapped) bpm, optionally a named\n * variation (defaults to the taal's default variation — see TABLA_VARIATIONS). */\nexport function tablaUrl(base: string, taalId: string, bpm: number, variation?: string): string {\n  const seg = tablaSeg(taalId, variation);\n  return `${normalizeBase(base)}tabla/${seg}/${seg}${bpm}bpm.mp3`;\n}\n\n/** URL of the metronome click. */\nexport function metronomeUrl(base: string): string {\n  return `${normalizeBase(base)}metronome/metro2.mp3`;\n}\n\n/** Build the metronome click `Tone.Player`. */\nexport function createMetronome(Tone: ToneModule, base: string) {\n  return new Tone.Player(metronomeUrl(base));\n}\n\n/** Tanpura pitch-class sample stems (filename = `<stem>.mp3`). */\nexport const TANPURA_PCS = ['c', 'cs', 'd', 'ds', 'e', 'f', 'fs', 'g', 'gs', 'a', 'as', 'b'] as const;\n\n/**\n * Build a melody `Tone.Sampler` for an instrument def. Resolves the sample\n * directory (local → under `soundsBaseUrl`, else the def's absolute CDN URL)\n * and, when a MIDI `range` is given, loads only the samples that cover it.\n */\nexport function createSampler(\n  Tone: ToneModule,\n  def: InstrumentDef,\n  soundsBaseUrl: string | undefined,\n  range?: { lo: number; hi: number },\n) {\n  const base = def.local ? `${normalizeBase(soundsBaseUrl ?? '')}${def.baseUrl}` : def.baseUrl;\n  const urls = range ? subsetUrls(def.urls, range.lo, range.hi) : def.urls;\n  return new Tone.Sampler({ urls, baseUrl: normalizeBase(base), release: def.release ?? 1 });\n}\n\n/** Build a tanpura `Tone.Players` loading only the given pitch-class stems\n * (the drone only ever plays Sa + Pa, so we fetch 2 files, not 12). */\nexport function createTanpura(Tone: ToneModule, base: string, stems: readonly string[] = TANPURA_PCS) {\n  const urls: Record<string, string> = {};\n  for (const s of stems) urls[s] = `${s}.mp3`;\n  return new Tone.Players({ urls, baseUrl: `${normalizeBase(base)}tanpura/` });\n}\n","/**\n * `SwaralipiPlayer` — the stateful audio facade over Tone.js.\n *\n * Tone is **dynamically imported** on first `play()` so that importing\n * `@ugfoundation/swaralipi-js/player` in Node/SSR (or just to reach the pure\n * helpers) never pulls in the audio engine or touches `AudioContext`. The\n * pure cores (pitch.ts, schedule.ts, instruments.ts) carry the logic; this\n * class only wires them onto the Tone Transport and drives the viewer's\n * `highlight()`.\n *\n * Model: build a beat-timed `Schedule`, lay each note onto the Transport in\n * seconds (`beat × 60/bpm`), loop a tabla (or click a metronome) underneath,\n * drone a tanpura, and fire highlights on Tone's draw thread. Any setting\n * change while playing re-arranges from the top (documented v1 behavior — no\n * mid-stream tempo ramp or seek).\n */\nimport type { Gain, Players, Player, Sampler } from 'tone';\nimport type { Swaralipi } from '../spec/index.js';\n// TAALS from the taals subpath, not the barrel — see the note in instruments.ts\n// (the barrel pulls zod, which would defeat the player's bare-load guarantee).\nimport { TAALS, type TaalId } from '../spec/taals.js';\nimport { midiToSampleName, parseTonic } from './pitch.js';\nimport { buildSchedule, type Schedule } from './schedule.js';\nimport {\n  DEFAULT_SOUNDS_BASE,\n  INSTRUMENTS,\n  SAMPLED_TAALS,\n  TANPURA_PCS,\n  createMetronome,\n  createSampler,\n  createTanpura,\n  instrumentSampleUrl,\n  nearestTablaBpm,\n  normalizeBase,\n  probeUrl,\n  quantizeLoopEnd,\n  tablaBpms,\n  tablaUrl,\n  type InstrumentDef,\n  type InstrumentId,\n  type ToneModule,\n} from './instruments.js';\n\n/** Seconds the accompaniment fades over when playback is stopped. */\nconst STOP_FADE_SEC = 0.5;\n\nexport type PlayerState = 'idle' | 'loading' | 'ready' | 'playing' | 'paused';\nexport type RhythmMode = 'tabla' | 'metronome' | 'none';\n\nexport interface PlayerOptions {\n  /** Base URL for the project's samples (santoor/tabla/tanpura/metronome).\n   * Defaults to `DEFAULT_SOUNDS_BASE` (the project's CORS-enabled CDN), so the\n   * player works with zero config; override to self-host. */\n  soundsBaseUrl?: string;\n  /** Grand-piano sample host. Default: the Salamander CDN (see SALAMANDER_BASE).\n   * Set this to self-host the piano under your own URL. */\n  pianoBaseUrl?: string;\n  /** Tonic (Sa). Accepts `C`, `C#`, `cs`… Default: doc tonic, else `C`. */\n  tonic?: string;\n  /** Tempo in matra/min. Default 90. Snapped to the 15-grid while tabla plays. */\n  bpm?: number;\n  /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */\n  baseOctave?: number;\n  /** Active melody instrument id (a built-in or a `customInstruments` key).\n   * Default `piano` (CDN-hosted, zero-config). Built-ins: piano, santoor,\n   * harmonium, violin, flute. */\n  instrument?: InstrumentId;\n  /** Instrument ids the UI may expose. Default: all built-ins. Narrow it to\n   * e.g. `['santoor','harmonium']` to limit the picker. */\n  instruments?: InstrumentId[];\n  /** Extra melody instruments, keyed by id — e.g. a self-hosted sitar/sarod.\n   * (True sampled sitar/sarod/sarangi/esraj have no free web set; supply your\n   * own Tone.Sampler `urls` + `baseUrl` here and they slot into the picker.) */\n  customInstruments?: Record<string, InstrumentDef>;\n  /** Rhythm accompaniment. Default `tabla` (→ metronome for unsampled taals). */\n  rhythm?: RhythmMode;\n  /** Play the tanpura drone. Default true. */\n  tanpura?: boolean;\n  /** Stop playback after this many seconds (a policy-neutral preview cap).\n   * Default `Infinity` (unlimited). The library only enforces the number it is\n   * handed; who is capped / the value / the upsell is the consumer's policy. */\n  previewLimitSec?: number;\n  /** Called when the preview cap stops playback (so the consumer can show an\n   * upsell). Not called on a normal stop()/end. */\n  onLimit?: () => void;\n  /** Called with the active note's `part.row.note` path, or null when idle. */\n  onHighlight?: (path: string | null) => void;\n  /** Called on every state transition. */\n  onState?: (state: PlayerState) => void;\n}\n\n/** Minimal shape of the viewer element the player drives (avoids a hard\n * dependency on the viewer module). `highlight` returns the highlighted node\n * (or null) so bindSheet can optionally scroll it into view. */\ninterface HighlightTarget {\n  highlight(path: string): HTMLElement | null;\n  clearHighlights(): void;\n}\n\n/** MIDI span (incl. kan graces) of a schedule's notes, for sample subsetting;\n * undefined when there are no pitched events. */\nfunction midiRange(schedule: Schedule): { lo: number; hi: number } | undefined {\n  let lo = Infinity;\n  let hi = -Infinity;\n  for (const ev of schedule.events) {\n    for (const m of [ev.midi, ev.kan]) {\n      if (m !== null) {\n        if (m < lo) lo = m;\n        if (m > hi) hi = m;\n      }\n    }\n  }\n  return lo <= hi ? { lo, hi } : undefined;\n}\n\nexport interface BindSheetOptions {\n  /** Keep the active note visible while playing by calling `scrollIntoView`\n   * on it. `true` → `'center'` (keeps the note's lyric, rendered just below it,\n   * on screen too); or pass an explicit block position (`'nearest'`, `'start'`,\n   * …). Default off so it never fights a host that manages its own scrolling.\n   * Works through the shadow boundary, so it scrolls the page, not just the\n   * sheet. */\n  autoScroll?: boolean | ScrollLogicalPosition;\n}\n\n/** The common melody-voice call the scheduler needs — both melody instruments\n * are `Tone.Sampler`s, but this keeps the call site decoupled from the class. */\ninterface MelodyVoice {\n  triggerAttackRelease(note: string, duration: number, time: number): unknown;\n}\n\nexport class SwaralipiPlayer {\n  #opts: Required<\n    Omit<\n      PlayerOptions,\n      | 'soundsBaseUrl'\n      | 'pianoBaseUrl'\n      | 'customInstruments'\n      | 'onHighlight'\n      | 'onState'\n      | 'onLimit'\n      | 'tonic'\n      | 'bpm'\n    >\n  > & {\n    soundsBaseUrl?: string;\n    pianoBaseUrl?: string;\n    customInstruments?: Record<string, InstrumentDef>;\n    tonic?: string;\n    /** Pinned constructor tempo: overrides meta.bpm, survives load(). */\n    bpm?: number;\n    onHighlight?: (path: string | null) => void;\n    onState?: (state: PlayerState) => void;\n    onLimit?: () => void;\n  };\n  /** Per-song setBpm tweak: beats meta.bpm but is cleared by the next load(). */\n  #bpmTweak: number | undefined;\n  #doc: Swaralipi | undefined;\n  #state: PlayerState = 'idle';\n\n  #tone: ToneModule | undefined;\n  /** Master bus everything routes through, so stop() can fade it out. */\n  #master: Gain | undefined;\n  /** Cached melody samplers keyed by instrument id, with the MIDI range each\n   * was loaded for (rebuilt when a song needs a wider range). */\n  #samplers = new Map<string, { sampler: Sampler; lo: number; hi: number }>();\n  #tanpura: Players | undefined;\n  #tanpuraKey = '';\n  #metronome: Player | undefined;\n  #tabla: Player | undefined;\n  #scheduleIds: number[] = [];\n  #fadeTimer: ReturnType<typeof setTimeout> | undefined;\n\n  constructor(options: PlayerOptions = {}) {\n    this.#opts = {\n      soundsBaseUrl: options.soundsBaseUrl ?? DEFAULT_SOUNDS_BASE,\n      pianoBaseUrl: options.pianoBaseUrl,\n      customInstruments: options.customInstruments,\n      tonic: options.tonic,\n      bpm: options.bpm,\n      baseOctave: options.baseOctave ?? 4,\n      instrument: options.instrument ?? 'piano',\n      instruments: options.instruments ?? Object.keys(INSTRUMENTS),\n      rhythm: options.rhythm ?? 'tabla',\n      tanpura: options.tanpura ?? true,\n      previewLimitSec: options.previewLimitSec ?? Infinity,\n      onHighlight: options.onHighlight,\n      onState: options.onState,\n      onLimit: options.onLimit,\n    };\n  }\n\n  /* ----------------------------------------------------------------- */\n  /* Public getters                                                     */\n  /* ----------------------------------------------------------------- */\n\n  get state(): PlayerState {\n    return this.#state;\n  }\n  get bpm(): number {\n    return this.#bpmTweak ?? this.#opts.bpm ?? this.#doc?.meta.bpm ?? 90;\n  }\n  /** The preview cap in seconds (`Infinity` = unlimited). */\n  get previewLimitSec(): number {\n    return this.#opts.previewLimitSec;\n  }\n  get instrument(): InstrumentId {\n    return this.#effectiveInstrument();\n  }\n  get instruments(): InstrumentId[] {\n    return [...this.#opts.instruments];\n  }\n  /** The taal currently driving the rhythm (auto from the doc, or an override). */\n  get taalId(): TaalId | undefined {\n    return this.#taalId();\n  }\n  /** Whether the effective rhythm will actually be a sampled tabla. */\n  get usesTabla(): boolean {\n    const id = this.#taalId();\n    return this.#opts.rhythm === 'tabla' && id !== undefined && SAMPLED_TAALS.has(id) && !!this.#opts.soundsBaseUrl;\n  }\n\n  /* ----------------------------------------------------------------- */\n  /* Loading + transport control                                        */\n  /* ----------------------------------------------------------------- */\n\n  /** Set the document to play. Stops any current playback. */\n  load(doc: Swaralipi): void {\n    this.#halt();\n    this.#doc = doc;\n    this.#taalOverride = undefined;\n    this.#bpmTweak = undefined; // per-song tweak does not carry across songs\n    this.#setState('ready');\n  }\n\n  /** Start (or resume) playback. Must be triggered from a user gesture so the\n   * browser permits `AudioContext` resume. */\n  async play(): Promise<void> {\n    if (this.#doc === undefined || this.#state === 'playing') return;\n    const Tone = await this.#ensureTone();\n    await Tone.start();\n\n    if (this.#state === 'paused') {\n      Tone.getTransport().start();\n      this.#setState('playing');\n      return;\n    }\n\n    // Fresh start — abort any in-flight stop fade and clear a left-running\n    // transport before re-arranging.\n    this.#cancelFade();\n    Tone.getTransport().stop();\n    this.#setState('loading');\n    await this.#arrange(Tone);\n    Tone.getTransport().start();\n    this.#setState('playing');\n\n    // Preview cap: stop at the limit and notify (policy is the consumer's).\n    const limit = this.#opts.previewLimitSec;\n    if (Number.isFinite(limit)) {\n      Tone.getTransport().scheduleOnce(() => {\n        // getDraw defers to the visual frame so stop() runs off the audio thread.\n        Tone.getDraw().schedule(() => {\n          if (this.#state === 'playing') {\n            this.stop();\n            this.#opts.onLimit?.();\n          }\n        }, this.#tone!.now());\n      }, limit);\n    }\n  }\n\n  /** Pause; `play()` resumes from the same position. */\n  pause(): void {\n    if (this.#tone === undefined || this.#state !== 'playing') return;\n    this.#tone.getTransport().pause();\n    this.#setState('paused');\n  }\n\n  /**\n   * Stop and rewind to the start. When sounding, the accompaniment (tabla /\n   * metronome / tanpura, which otherwise loop) is gently faded out over\n   * STOP_FADE_SEC before the transport is halted, so the rhythm doesn't keep\n   * playing or cut abruptly; otherwise it halts immediately.\n   */\n  stop(): void {\n    if (this.#tone === undefined || this.#state === 'idle') {\n      this.#halt();\n      return;\n    }\n    if ((this.#state === 'playing' || this.#state === 'paused') && this.#master !== undefined) {\n      const now = this.#tone.now();\n      this.#master.gain.cancelScheduledValues(now);\n      this.#master.gain.rampTo(0, STOP_FADE_SEC, now);\n      this.#emitHighlight(null);\n      this.#setState(this.#doc ? 'ready' : 'idle');\n      this.#cancelFadeTimer();\n      this.#fadeTimer = setTimeout(() => this.#halt(), STOP_FADE_SEC * 1000 + 60);\n      return;\n    }\n    this.#halt();\n  }\n\n  /** Immediate, synchronous teardown: stop+rewind the transport, kill the\n   * looping accompaniment, restore the master gain for the next play. */\n  #halt(): void {\n    this.#cancelFadeTimer();\n    if (this.#tone !== undefined) {\n      const transport = this.#tone.getTransport();\n      transport.stop();\n      transport.cancel(0);\n      transport.position = 0;\n    }\n    // Dispose the looping tabla outright — a synced loop can outlive a bare\n    // transport.stop(); #arrange recreates it on the next play.\n    this.#tabla?.dispose();\n    this.#tabla = undefined;\n    this.#restoreMasterGain();\n    this.#scheduleIds = [];\n    this.#emitHighlight(null);\n    if (this.#state !== 'idle') this.#setState(this.#doc ? 'ready' : 'idle');\n  }\n\n  #cancelFadeTimer(): void {\n    if (this.#fadeTimer !== undefined) {\n      clearTimeout(this.#fadeTimer);\n      this.#fadeTimer = undefined;\n    }\n  }\n\n  /** Abort an in-flight stop-fade (timer + gain ramp) without touching the\n   * transport — used when play() interrupts a fade. */\n  #cancelFade(): void {\n    this.#cancelFadeTimer();\n    this.#restoreMasterGain();\n  }\n\n  #restoreMasterGain(): void {\n    if (this.#master !== undefined && this.#tone !== undefined) {\n      this.#master.gain.cancelScheduledValues(this.#tone.now());\n      this.#master.gain.value = 1;\n    }\n  }\n\n  /* ----------------------------------------------------------------- */\n  /* Settings (re-arrange from the top if mid-playback)                 */\n  /* ----------------------------------------------------------------- */\n\n  setTonic(tonic: string): void {\n    this.#opts.tonic = tonic;\n    this.#reapply();\n  }\n  setBpm(bpm: number): void {\n    this.#bpmTweak = bpm;\n    this.#reapply();\n  }\n  /** Update the preview cap (`Infinity` lifts it). Takes effect on next play. */\n  setPreviewLimit(sec: number): void {\n    this.#opts.previewLimitSec = sec;\n  }\n  setInstrument(instrument: InstrumentId): void {\n    this.#opts.instrument = instrument;\n    this.#reapply();\n  }\n  setRhythm(rhythm: RhythmMode): void {\n    this.#opts.rhythm = rhythm;\n    this.#reapply();\n  }\n  setTanpura(on: boolean): void {\n    this.#opts.tanpura = on;\n    this.#reapply();\n  }\n  /** Override the taal (null restores auto-detection from `meta.taal`). */\n  setTaal(id: TaalId | null): void {\n    this.#taalOverride = id ?? undefined;\n    this.#taalAuto = id === null;\n    this.#reapply();\n  }\n\n  /** Wire highlight output to a `<swaralipi-sheet>` (or any highlight target).\n   * Pass `{ autoScroll }` to keep the active note in view while playing. */\n  bindSheet(target: HighlightTarget, opts: BindSheetOptions = {}): void {\n    // 'center' so the lyric directly below the note stays on screen too\n    // ('nearest' can park the note at the bottom edge, hiding its lyric).\n    const block: ScrollLogicalPosition | undefined =\n      opts.autoScroll === true ? 'center' : opts.autoScroll || undefined;\n    this.#opts.onHighlight = (path) => {\n      target.clearHighlights();\n      if (path === null) return;\n      const el = target.highlight(path);\n      if (block !== undefined && el !== null) {\n        el.scrollIntoView({ block, inline: 'nearest', behavior: 'smooth' });\n      }\n    };\n  }\n\n  /**\n   * Check whether an instrument's samples are reachable (its CDN is up / the\n   * local files exist), via a one-byte ranged fetch of a representative sample.\n   * A pass means Tone can actually load it. `false` for unknown ids, local\n   * instruments with no `soundsBaseUrl`, or any network failure/timeout.\n   */\n  async checkInstrument(id: string, timeoutMs?: number): Promise<boolean> {\n    const def = this.#resolveDef(id);\n    if (def === undefined) return false;\n    const url = instrumentSampleUrl(def, this.#opts.soundsBaseUrl);\n    if (url === undefined) return false;\n    return probeUrl(url, timeoutMs);\n  }\n\n  /**\n   * Probe several instruments at once (default: the exposed `instruments`),\n   * returning `{ id: available }`. Use it to disable picker options whose CDN\n   * or files are down. Probes run concurrently; a check never throws.\n   */\n  async checkInstruments(\n    ids: string[] = this.#opts.instruments,\n    timeoutMs?: number,\n  ): Promise<Record<string, boolean>> {\n    const entries = await Promise.all(\n      ids.map(async (id) => [id, await this.checkInstrument(id, timeoutMs)] as const),\n    );\n    return Object.fromEntries(entries);\n  }\n\n  /** Release all audio resources. The instance is unusable afterward. */\n  dispose(): void {\n    this.#halt();\n    for (const { sampler } of this.#samplers.values()) sampler.dispose();\n    this.#samplers.clear();\n    this.#tanpura?.dispose();\n    this.#metronome?.dispose();\n    this.#tabla?.dispose();\n    this.#master?.dispose();\n    this.#tanpura = this.#metronome = this.#tabla = this.#master = undefined;\n  }\n\n  /* ----------------------------------------------------------------- */\n  /* Internals                                                          */\n  /* ----------------------------------------------------------------- */\n\n  #taalOverride: TaalId | undefined;\n  #taalAuto = true;\n\n  #setState(state: PlayerState): void {\n    this.#state = state;\n    this.#opts.onState?.(state);\n  }\n\n  #emitHighlight(path: string | null): void {\n    this.#opts.onHighlight?.(path);\n  }\n\n  /** The tabla variation to play: the doc's own (in auto mode), else none — an\n   * explicit setTaal override plays the taal's default variation. */\n  #variation(): string | undefined {\n    return this.#taalAuto ? this.#doc?.meta.taal?.variation : undefined;\n  }\n\n  /** Resolve the active taal: an explicit override, else the doc's. */\n  #taalId(): TaalId | undefined {\n    if (!this.#taalAuto && this.#taalOverride !== undefined) return this.#taalOverride;\n    const id = this.#doc?.meta.taal?.id;\n    return id !== undefined && id in TAALS ? (id as TaalId) : undefined;\n  }\n\n  /** Resolve an instrument id to its def (custom overrides built-ins; the\n   * `pianoBaseUrl` shortcut self-hosts the built-in piano). */\n  #resolveDef(id: string): InstrumentDef | undefined {\n    const custom = this.#opts.customInstruments?.[id];\n    if (custom) return custom;\n    const def = INSTRUMENTS[id];\n    if (def && id === 'piano' && this.#opts.pianoBaseUrl) {\n      return { ...def, baseUrl: normalizeBase(this.#opts.pianoBaseUrl) };\n    }\n    return def;\n  }\n\n  /** A CDN-backed instrument that needs no `soundsBaseUrl` — used when the\n   * chosen one is local-only and no samples host is set, or is unknown. */\n  #fallbackInstrument(): string {\n    const exposed = this.#opts.instruments.find((id) => {\n      const d = this.#resolveDef(id);\n      return d !== undefined && d.local !== true;\n    });\n    return exposed ?? 'harmonium';\n  }\n\n  /** The instrument actually used: the chosen one, unless it's local-only with\n   * no `soundsBaseUrl` (or unknown), in which case a CDN fallback. */\n  #effectiveInstrument(): string {\n    const id = this.#opts.instrument;\n    const def = this.#resolveDef(id);\n    if (def === undefined) return this.#fallbackInstrument();\n    if (def.local === true && !this.#opts.soundsBaseUrl) return this.#fallbackInstrument();\n    return id;\n  }\n\n  /** Effective tempo: snapped to the taal's available tabla tempos while a\n   * tabla actually plays (so it never snaps to a bpm that taal lacks). */\n  #effectiveBpm(): number {\n    const id = this.#taalId();\n    return this.usesTabla && id ? nearestTablaBpm(this.bpm, tablaBpms(id)) : this.bpm;\n  }\n\n  async #ensureTone(): Promise<ToneModule> {\n    this.#tone ??= await import('tone');\n    return this.#tone;\n  }\n\n  /** Hard stop → rebuild → restart, only while playing; otherwise just store.\n   * Uses #halt (not the stop() fade) so a setting change restarts instantly. */\n  #reapply(): void {\n    if (this.#state !== 'playing') return;\n    this.#halt();\n    void this.play();\n  }\n\n  /** The master bus everything routes through (created once, → destination). */\n  #ensureMaster(Tone: ToneModule): Gain {\n    this.#master ??= new Tone.Gain(1).toDestination();\n    return this.#master;\n  }\n\n  /** Build the melody instrument(s)/rhythm/drone for the current settings and\n   * wait for their buffers, then schedule everything on the Transport. */\n  async #arrange(Tone: ToneModule): Promise<void> {\n    if (this.#doc === undefined) return;\n    const base = this.#opts.soundsBaseUrl;\n    const transport = Tone.getTransport();\n    transport.cancel(0);\n    transport.position = 0;\n    this.#scheduleIds = [];\n\n    // Fresh master bus at unity gain (a prior stop-fade may have lowered it).\n    this.#ensureMaster(Tone);\n    this.#restoreMasterGain();\n\n    const bpm = this.#effectiveBpm();\n    transport.bpm.value = bpm;\n    const spb = 60 / bpm;\n\n    // Build the (pure) schedule first so the melody sampler loads only the\n    // samples covering this song's pitch range — fewer files to fetch.\n    const schedule: Schedule = buildSchedule(this.#doc, {\n      tonic: this.#opts.tonic,\n      baseOctave: this.#opts.baseOctave,\n    });\n    const range = midiRange(schedule);\n\n    // --- melody instrument ---\n    const melody = this.#buildMelody(Tone, this.#effectiveInstrument(), base, range);\n\n    // --- rhythm ---\n    this.#buildRhythm(Tone, transport, base, spb);\n\n    // --- tanpura drone ---\n    this.#buildTanpura(Tone, transport, base, spb);\n\n    // wait for the (now-minimal) sample set to load before scheduling\n    await Tone.loaded();\n\n    // Snap the tabla loop to a whole number of beats now its buffer length is\n    // known, so a mistrimmed loop phase-locks instead of drifting (no-op for a\n    // correctly trimmed file).\n    if (this.#tabla?.buffer?.loaded) {\n      this.#tabla.loopEnd = quantizeLoopEnd(this.#tabla.buffer.duration, spb);\n    }\n\n    // --- notes + highlights ---\n    const draw = Tone.getDraw();\n\n    for (const ev of schedule.events) {\n      const at = ev.beat * spb;\n      if (ev.midi !== null) {\n        const name = midiToSampleName(ev.midi);\n        const dur = Math.max(ev.durationBeats * spb, 0.05);\n        if (ev.kan !== null) {\n          const kanName = midiToSampleName(ev.kan);\n          transport.scheduleOnce((time) => melody.triggerAttackRelease(kanName, spb * 0.4, time), Math.max(at - spb * 0.12, 0));\n        }\n        transport.scheduleOnce((time) => melody.triggerAttackRelease(name, dur, time), at);\n      }\n      transport.scheduleOnce((time) => {\n        draw.schedule(() => this.#emitHighlight(ev.path), time);\n      }, at);\n    }\n\n    // clear highlight + auto-stop at the end\n    const endAt = schedule.totalBeats * spb + spb;\n    transport.scheduleOnce((time) => {\n      draw.schedule(() => this.#emitHighlight(null), time);\n    }, schedule.totalBeats * spb);\n    transport.scheduleOnce(() => this.stop(), endAt);\n  }\n\n  /** Build (or reuse) the melody sampler for `id`, loading only the samples\n   * covering `range`. A cached sampler is reused while it still covers the\n   * range; otherwise it's rebuilt (so changing songs/tonic widens it lazily). */\n  #buildMelody(\n    Tone: ToneModule,\n    id: string,\n    base: string | undefined,\n    range: { lo: number; hi: number } | undefined,\n  ): MelodyVoice {\n    const def = this.#resolveDef(id) ?? INSTRUMENTS.harmonium!;\n    const master = this.#ensureMaster(Tone);\n    const cached = this.#samplers.get(id);\n    if (cached && (range === undefined || (cached.lo <= range.lo && cached.hi >= range.hi))) {\n      return cached.sampler;\n    }\n    cached?.sampler.dispose();\n    const sampler = createSampler(Tone, def, base, range).connect(master);\n    this.#samplers.set(id, { sampler, lo: range?.lo ?? -Infinity, hi: range?.hi ?? Infinity });\n    return sampler;\n  }\n\n  #buildRhythm(Tone: ToneModule, transport: ReturnType<ToneModule['getTransport']>, base: string | undefined, spb: number): void {\n    // dispose a stale tabla loop so it doesn't double up after a re-arrange\n    this.#tabla?.dispose();\n    this.#tabla = undefined;\n\n    const master = this.#ensureMaster(Tone);\n    const taalId = this.#taalId();\n    const wantsTabla = this.#opts.rhythm === 'tabla' && taalId !== undefined && SAMPLED_TAALS.has(taalId) && base !== undefined;\n\n    if (wantsTabla) {\n      const url = tablaUrl(base!, taalId!, nearestTablaBpm(this.bpm, tablaBpms(taalId!)), this.#variation());\n      this.#tabla = new Tone.Player({ url, loop: true }).connect(master);\n      this.#tabla.sync().start(0);\n      return;\n    }\n\n    if (this.#opts.rhythm === 'none' || base === undefined) return;\n\n    // metronome fallback: a click each beat, louder on sam (cycle start)\n    this.#metronome ??= createMetronome(Tone, base).connect(master);\n    const metro = this.#metronome;\n    const cycle = (taalId !== undefined ? TAALS[taalId].numBeats : 4);\n    let beat = 0;\n    const id = transport.scheduleRepeat((time) => {\n      metro.volume.setValueAtTime(beat % cycle === 0 ? 0 : -8, time);\n      metro.start(time);\n      beat += 1;\n    }, spb, 0);\n    this.#scheduleIds.push(id);\n  }\n\n  #buildTanpura(Tone: ToneModule, transport: ReturnType<ToneModule['getTransport']>, base: string | undefined, spb: number): void {\n    if (!this.#opts.tanpura || base === undefined) return;\n\n    // Pa–Sa–Sa–Sa drone, one pluck every two beats, cycling.\n    const tonicPc = ((this.#tonicSemitone() % 12) + 12) % 12;\n    const sa = TANPURA_PCS[tonicPc]!;\n    const pa = TANPURA_PCS[(tonicPc + 7) % 12]!;\n\n    // Load only the two pitch classes the drone uses (not all 12); rebuild if\n    // the tonic changed.\n    const key = `${sa},${pa}`;\n    if (this.#tanpura === undefined || this.#tanpuraKey !== key) {\n      this.#tanpura?.dispose();\n      this.#tanpura = createTanpura(Tone, base, [sa, pa]).connect(this.#ensureMaster(Tone));\n      this.#tanpuraKey = key;\n    }\n    const players = this.#tanpura;\n    players.volume.value = -14;\n\n    const pattern = [pa, sa, sa, sa];\n    let i = 0;\n    const id = transport.scheduleRepeat((time) => {\n      const stem = pattern[i % pattern.length]!;\n      if (players.has(stem)) players.player(stem).start(time);\n      i += 1;\n    }, spb * 2, 0);\n    this.#scheduleIds.push(id);\n  }\n\n  #tonicSemitone(): number {\n    return parseTonic(this.#opts.tonic ?? this.#doc?.meta.tonic);\n  }\n}\n"]}

package/dist/player/index.d.cts

@@ -1,5 +1,5 @@
-import { S as Swaralipi, O as Octave, a as SvaraLetter, N as Note } from '../schema-gxhG45OK.cjs';
-import { T as TaalId } from '../taals-DguYW0wf.cjs';
+import { S as Swaralipi, O as Octave, a as SvaraLetter, N as Note } from '../schema-D3wyNRqM.cjs';
+import { T as TaalId } from '../taals-B5RcMMIt.cjs';
 import * as tone from 'tone';
 import 'zod';
 
@@ -41,6 +41,22 @@ declare const INSTRUMENTS: Record<string, InstrumentDef>;
 declare const SAMPLED_TAALS: ReadonlySet<TaalId>;
 /** Available tabla loop tempos (file suffix `…<bpm>bpm.mp3`). */
 declare const TABLA_BPMS: readonly number[];
+/**
+ * Tabla loop variations per taal. Most taals have one unnamed loop at
+ * `tabla/<id>/`; an entry here overrides that:
+ *  - `variations` lists the named variation suffixes, **first = default**.
+ *    A lone named variation (shashthi → `pro`, i.e. `tabla/shashthi-pro/`) IS
+ *    the default; later entries are premium upsells the player never auto-selects.
+ *  - `skipBpms` are grid tempos this taal's loops were not recorded at.
+ * Consumers read this to build a variation/upsell UI; the player itself only
+ * ever plays the default (or whatever a doc's `meta.taal.variation` pins).
+ */
+declare const TABLA_VARIATIONS: Record<string, {
+    variations: string[];
+    skipBpms?: number[];
+}>;
+/** Tabla tempos actually available for a taal: the grid minus any it lacks. */
+declare function tablaBpms(taalId: string): readonly number[];
 /** Ensure exactly one trailing slash. */
 declare function normalizeBase(url: string): string;
 /** The 37 santoor samples, as a Tone.Sampler `urls` map (`C4` → `c4.mp3`). */
@@ -66,10 +82,23 @@ declare function instrumentSampleUrl(def: InstrumentDef, soundsBaseUrl?: string)
  * CORS-safelisted header, so no preflight.
  */
 declare function probeUrl(url: string, timeoutMs?: number): Promise<boolean>;
-/** Snap an arbitrary bpm to the nearest available tabla tempo. */
-declare function nearestTablaBpm(bpm: number): number;
-/** URL of the tabla loop for a taal at a (snapped) bpm. */
-declare function tablaUrl(base: string, taalId: string, bpm: number): string;
+/**
+ * Snap a tabla loop's end to the nearest whole beat of its measured length so a
+ * slightly-mistrimmed file still phase-locks to the melody grid instead of
+ * drifting a fraction of a beat each cycle. `spb` = seconds per beat (60/bpm).
+ * No-op for correctly trimmed loops (already an integer beat count); never
+ * extends past the buffer — a too-short file can't be repaired here.
+ *
+ * ponytail: belt-and-braces for off-spec audio; the real fix is trimming each
+ * loop to exactly `cycles × numBeats × 60/bpm` seconds at production time.
+ */
+declare function quantizeLoopEnd(durationSec: number, spb: number): number;
+/** Snap an arbitrary bpm to the nearest available tabla tempo (default grid;
+ * pass a taal's `tablaBpms()` so it never snaps to a tempo that taal lacks). */
+declare function nearestTablaBpm(bpm: number, bpms?: readonly number[]): number;
+/** URL of the tabla loop for a taal at a (snapped) bpm, optionally a named
+ * variation (defaults to the taal's default variation — see TABLA_VARIATIONS). */
+declare function tablaUrl(base: string, taalId: string, bpm: number, variation?: string): string;
 
 type PlayerState = 'idle' | 'loading' | 'ready' | 'playing' | 'paused';
 type RhythmMode = 'tabla' | 'metronome' | 'none';
@@ -282,4 +311,4 @@ declare function midiToSampleName(midi: number): string;
 /** MIDI → santoor sample filename stem (`cs4`): lowercase, `#` → `s`. */
 declare function sampleFileName(midi: number): string;
 
-export { type BindSheetOptions, DEFAULT_SOUNDS_BASE, INSTRUMENTS, type InstrumentDef, type InstrumentId, OCTAVE_OFFSET, type PlayEvent, type PlayerOptions, type PlayerState, type RhythmMode, SALAMANDER_BASE, SAMPLED_TAALS, SHUDDHA, type Schedule, type ScheduleOptions, SwaralipiPlayer, TABLA_BPMS, TONEJS_INSTRUMENTS_BASE, type ToneModule, buildSchedule, instrumentSampleUrl, midiToSampleName, nearestTablaBpm, normalizeBase, parseTonic, probeUrl, sampleFileName, santoorUrls, subsetUrls, svaraSemitone, svaraToMidi, tablaUrl };
+export { type BindSheetOptions, DEFAULT_SOUNDS_BASE, INSTRUMENTS, type InstrumentDef, type InstrumentId, OCTAVE_OFFSET, type PlayEvent, type PlayerOptions, type PlayerState, type RhythmMode, SALAMANDER_BASE, SAMPLED_TAALS, SHUDDHA, type Schedule, type ScheduleOptions, SwaralipiPlayer, TABLA_BPMS, TABLA_VARIATIONS, TONEJS_INSTRUMENTS_BASE, type ToneModule, buildSchedule, instrumentSampleUrl, midiToSampleName, nearestTablaBpm, normalizeBase, parseTonic, probeUrl, quantizeLoopEnd, sampleFileName, santoorUrls, subsetUrls, svaraSemitone, svaraToMidi, tablaBpms, tablaUrl };