@ugfoundation/swaralipi-js 0.2.1 → 0.3.1

package/dist/player/index.js

@@ -1,326 +1,7 @@
+import { DEFAULT_SOUNDS_BASE, INSTRUMENTS, SAMPLED_TAALS, instrumentSampleUrl, probeUrl, normalizeBase, nearestTablaBpm, tablaBpms, buildSchedule, quantizeLoopEnd, midiToSampleName, createSampler, tablaUrl, createDrumKit, drumPattern, createMetronome, TANPURA_PCS, createTanpura, parseTonic } from '../chunk-V5ZSUJCA.js';
+export { DEFAULT_SOUNDS_BASE, DRUM_KIT_BASE, INSTRUMENTS, OCTAVE_OFFSET, SALAMANDER_BASE, SAMPLED_TAALS, SHUDDHA, TABLA_BPMS, TABLA_VARIATIONS, TONEJS_INSTRUMENTS_BASE, buildSchedule, drumPattern, instrumentSampleUrl, midiToSampleName, nearestTablaBpm, normalizeBase, parseTonic, probeUrl, quantizeLoopEnd, sampleFileName, santoorUrls, subsetUrls, svaraSemitone, svaraToMidi, tablaBpms, tablaUrl } from '../chunk-V5ZSUJCA.js';
 import { TAALS } from '../chunk-H6HC44PZ.js';
 
-// src/player/pitch.ts
-var OCTAVE_OFFSET = {
-  "ati-mandra": -2,
-  mandra: -1,
-  madhyam: 0,
-  taar: 1,
-  "ati-taar": 2
-};
-var SHUDDHA = {
-  s: 0,
-  r: 2,
-  g: 4,
-  m: 5,
-  p: 7,
-  d: 9,
-  n: 11
-};
-var SHARP_NAMES = ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"];
-var PITCH_CLASS = {
-  c: 0,
-  "c#": 1,
-  db: 1,
-  d: 2,
-  "d#": 3,
-  eb: 3,
-  e: 4,
-  "e#": 5,
-  fb: 4,
-  f: 5,
-  "f#": 6,
-  gb: 6,
-  g: 7,
-  "g#": 8,
-  ab: 8,
-  a: 9,
-  "a#": 10,
-  bb: 10,
-  b: 11,
-  "b#": 0,
-  cb: 11
-};
-function parseTonic(tonic) {
-  if (!tonic) return 0;
-  const key = tonic.trim().toLowerCase().replace(/s/g, "#");
-  return PITCH_CLASS[key] ?? 0;
-}
-function svaraSemitone(note) {
-  if (note.svara === void 0) return null;
-  const [, letter] = note.svara;
-  let semi = SHUDDHA[letter];
-  if (note.komal === true || note.microtone !== void 0) semi -= 1;
-  if (note.tivra === true) semi += 1;
-  return semi;
-}
-function svaraToMidi(note, tonicPc, baseOctave = 4) {
-  const semi = svaraSemitone(note);
-  if (semi === null || note.svara === void 0) return null;
-  const [octave] = note.svara;
-  return (baseOctave + 1 + OCTAVE_OFFSET[octave]) * 12 + tonicPc + semi;
-}
-function kanToMidi(svara, tonicPc, baseOctave = 4) {
-  if (svara === void 0) return null;
-  const [octave, letter] = svara;
-  return (baseOctave + 1 + OCTAVE_OFFSET[octave]) * 12 + tonicPc + SHUDDHA[letter];
-}
-function midiToSampleName(midi) {
-  const pc = (midi % 12 + 12) % 12;
-  const octave = Math.floor(midi / 12) - 1;
-  return `${SHARP_NAMES[pc]}${octave}`;
-}
-function sampleFileName(midi) {
-  return midiToSampleName(midi).toLowerCase().replace("#", "s");
-}
-
-// src/player/schedule.ts
-var isSilent = (n) => n.svara === void 0 && n.rest !== true && n.sustain !== true;
-function buildSchedule(doc, opts = {}) {
-  const tonicPc = parseTonic(opts.tonic ?? doc.meta.tonic);
-  const baseOctave = opts.baseOctave ?? 4;
-  const events = [];
-  let cursor = 0;
-  let lastPitched = -1;
-  doc.parts.forEach((part, p) => {
-    part.rows.forEach((row, r) => {
-      row.notes.forEach((note, i) => {
-        if (note.bar !== void 0 || isSilent(note)) return;
-        const path = `${p}.${r}.${i}`;
-        const dur = note.durationMatra ?? 1;
-        if (note.svara !== void 0) {
-          events.push({
-            beat: cursor,
-            durationBeats: dur,
-            midi: svaraToMidi(note, tonicPc, baseOctave),
-            kan: kanToMidi(note.kan, tonicPc, baseOctave),
-            path,
-            kind: note.sustain === true ? "sustain" : "note"
-          });
-          lastPitched = events.length - 1;
-        } else if (note.sustain === true) {
-          if (lastPitched >= 0) events[lastPitched].durationBeats += dur;
-          events.push({ beat: cursor, durationBeats: dur, midi: null, kan: null, path, kind: "sustain" });
-        } else {
-          events.push({ beat: cursor, durationBeats: dur, midi: null, kan: null, path, kind: "rest" });
-        }
-        cursor += dur;
-      });
-    });
-  });
-  return { events, totalBeats: cursor };
-}
-
-// src/player/instruments.ts
-var DEFAULT_SOUNDS_BASE = "https://cdn.daserve.in/swaralipijs-instruments/";
-var SALAMANDER_BASE = "https://tonejs.github.io/audio/salamander/";
-var TONEJS_INSTRUMENTS_BASE = "https://nbrosowsky.github.io/tonejs-instruments/samples/";
-function keyMap(keys) {
-  const m = {};
-  for (const k of keys) m[k] = `${k.replace("#", "s")}.mp3`;
-  return m;
-}
-var PIANO_KEYS = [
-  "A0",
-  "C1",
-  "D#1",
-  "F#1",
-  "A1",
-  "C2",
-  "D#2",
-  "F#2",
-  "A2",
-  "C3",
-  "D#3",
-  "F#3",
-  "A3",
-  "C4",
-  "D#4",
-  "F#4",
-  "A4",
-  "C5",
-  "D#5",
-  "F#5",
-  "A5",
-  "C6",
-  "D#6",
-  "F#6",
-  "A6",
-  "C7",
-  "D#7",
-  "F#7",
-  "A7",
-  "C8"
-];
-var HARMONIUM_KEYS = [
-  "C2",
-  "C#2",
-  "D2",
-  "D#2",
-  "E2",
-  "F2",
-  "F#2",
-  "G2",
-  "G#2",
-  "A2",
-  "A#2",
-  "C3",
-  "C#3",
-  "D3",
-  "D#3",
-  "E3",
-  "F3",
-  "F#3",
-  "G3",
-  "G#3",
-  "A3",
-  "A#3",
-  "C4",
-  "C#4",
-  "D4",
-  "D#4",
-  "E4",
-  "F4",
-  "F#4",
-  "G4",
-  "G#4",
-  "A4",
-  "A#4",
-  "C5",
-  "C#5",
-  "D5"
-];
-var VIOLIN_KEYS = ["A3", "C4", "E4", "G4", "A4", "C5", "E5", "G5", "A5", "C6", "E6", "G6", "A6", "C7"];
-var FLUTE_KEYS = ["C4", "E4", "A4", "C5", "E5", "A5", "C6", "E6", "A6", "C7"];
-var INSTRUMENTS = {
-  piano: { label: "Grand piano", urls: keyMap(PIANO_KEYS), baseUrl: SALAMANDER_BASE, release: 1 },
-  santoor: { label: "Santoor", urls: santoorUrls(), baseUrl: "santoor/", local: true, release: 1.2 },
-  harmonium: { label: "Harmonium", urls: keyMap(HARMONIUM_KEYS), baseUrl: `${TONEJS_INSTRUMENTS_BASE}harmonium/`, release: 1.4 },
-  violin: { label: "Violin", urls: keyMap(VIOLIN_KEYS), baseUrl: `${TONEJS_INSTRUMENTS_BASE}violin/`, release: 1 },
-  flute: { label: "Flute", urls: keyMap(FLUTE_KEYS), baseUrl: `${TONEJS_INSTRUMENTS_BASE}flute/`, release: 1 }
-};
-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] },
-  // Kehrwa keeps its unnamed default loop; `qawwali` (tabla/kehrwa-qawwali/) is a
-  // premium upsell variation recorded 90–300 (no 60/75).
-  // ponytail: skipBpms is per-taal, so it can't restrict qawwali's 60/75 without
-  // also dropping them from the default (which has them) — a qawwali doc pinned
-  // ≤67 bpm 404s harmlessly. Make skipBpms per-variation only if that edge bites.
-  kehrwa: { variations: ["", "qawwali"] }
-};
-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}/`;
-}
-function santoorUrls() {
-  const urls = {};
-  const add = (midi) => {
-    const stem = sampleFileName(midi);
-    const name = stem.replace("s", "#").replace(/^(.)/, (c) => c.toUpperCase());
-    urls[name] = `${stem}.mp3`;
-  };
-  for (let midi = 60; midi <= 95; midi++) add(midi);
-  add(96);
-  return urls;
-}
-var PC_BASE = { c: 0, d: 2, e: 4, f: 5, g: 7, a: 9, b: 11 };
-function noteToMidi(name) {
-  const m = /^([a-g])([#sb]?)(-?\d+)$/i.exec(name.trim());
-  if (!m) return NaN;
-  const base = PC_BASE[m[1].toLowerCase()];
-  const acc = m[2] === "b" ? -1 : m[2] === "" ? 0 : 1;
-  return (Number(m[3]) + 1) * 12 + base + acc;
-}
-function subsetUrls(urls, lo, hi) {
-  const entries = Object.entries(urls).map(([k, f]) => ({ k, f, midi: noteToMidi(k) })).filter((e) => Number.isFinite(e.midi)).sort((a, b) => a.midi - b.midi);
-  if (entries.length === 0) return { ...urls };
-  const keep = /* @__PURE__ */ new Set();
-  for (const e of entries) if (e.midi >= lo && e.midi <= hi) keep.add(e.k);
-  let floor;
-  let ceil;
-  for (const e of entries) if (e.midi <= lo) floor = e.k;
-  for (const e of entries) if (e.midi >= hi) {
-    ceil = e.k;
-    break;
-  }
-  if (floor) keep.add(floor);
-  if (ceil) keep.add(ceil);
-  if (keep.size === 0) {
-    const mid = (lo + hi) / 2;
-    const nearest = entries.reduce((a, b) => Math.abs(b.midi - mid) < Math.abs(a.midi - mid) ? b : a);
-    keep.add(nearest.k);
-  }
-  const out = {};
-  for (const e of entries) if (keep.has(e.k)) out[e.k] = e.f;
-  return out;
-}
-function instrumentSampleUrl(def, soundsBaseUrl) {
-  if (def.local && soundsBaseUrl === void 0) return void 0;
-  const base = def.local ? `${normalizeBase(soundsBaseUrl ?? "")}${def.baseUrl}` : def.baseUrl;
-  const file = Object.values(def.urls)[0];
-  return file === void 0 ? void 0 : `${normalizeBase(base)}${file}`;
-}
-async function probeUrl(url, timeoutMs = 6e3) {
-  if (typeof fetch === "undefined") return false;
-  const ctrl = typeof AbortController !== "undefined" ? new AbortController() : void 0;
-  const timer = ctrl ? setTimeout(() => ctrl.abort(), timeoutMs) : void 0;
-  try {
-    const res = await fetch(url, {
-      method: "GET",
-      headers: { Range: "bytes=0-0" },
-      cache: "no-store",
-      signal: ctrl?.signal
-    });
-    return res.ok;
-  } catch {
-    return false;
-  } finally {
-    if (timer !== void 0) clearTimeout(timer);
-  }
-}
-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, variation) {
-  const seg = tablaSeg(taalId, variation);
-  return `${normalizeBase(base)}tabla/${seg}/${seg}${bpm}bpm.mp3`;
-}
-function metronomeUrl(base) {
-  return `${normalizeBase(base)}metronome/metro2.mp3`;
-}
-function createMetronome(Tone, base) {
-  return new Tone.Player(metronomeUrl(base));
-}
-var TANPURA_PCS = ["c", "cs", "d", "ds", "e", "f", "fs", "g", "gs", "a", "as", "b"];
-function createSampler(Tone, def, soundsBaseUrl, range) {
-  const base = def.local ? `${normalizeBase(soundsBaseUrl ?? "")}${def.baseUrl}` : def.baseUrl;
-  const urls = range ? subsetUrls(def.urls, range.lo, range.hi) : def.urls;
-  return new Tone.Sampler({ urls, baseUrl: normalizeBase(base), release: def.release ?? 1 });
-}
-function createTanpura(Tone, base, stems = TANPURA_PCS) {
-  const urls = {};
-  for (const s of stems) urls[s] = `${s}.mp3`;
-  return new Tone.Players({ urls, baseUrl: `${normalizeBase(base)}tanpura/` });
-}
-
 // src/player/player.ts
 var STOP_FADE_SEC = 0.5;
 function midiRange(schedule) {
@@ -352,6 +33,7 @@ var SwaralipiPlayer = class {
   #tanpuraKey = "";
   #metronome;
   #tabla;
+  #drums;
   #scheduleIds = [];
   #fadeTimer;
   constructor(options = {}) {
@@ -582,8 +264,9 @@ var SwaralipiPlayer = class {
     this.#tanpura?.dispose();
     this.#metronome?.dispose();
     this.#tabla?.dispose();
+    this.#drums?.dispose();
     this.#master?.dispose();
-    this.#tanpura = this.#metronome = this.#tabla = this.#master = void 0;
+    this.#tanpura = this.#metronome = this.#tabla = this.#drums = this.#master = void 0;
   }
   /* ----------------------------------------------------------------- */
   /* Internals                                                          */
@@ -734,6 +417,20 @@ var SwaralipiPlayer = class {
       this.#tabla.sync().start(0);
       return;
     }
+    if (this.#opts.rhythm === "drums") {
+      this.#drums ??= createDrumKit(Tone).connect(master);
+      const drums = this.#drums;
+      const taal = taalId !== void 0 ? TAALS[taalId] : { numBeats: 4, sam: 0 };
+      const pattern = drumPattern(taal);
+      let beat2 = 0;
+      const id2 = transport.scheduleRepeat((time) => {
+        const voice = pattern[beat2 % pattern.length];
+        if (drums.has(voice)) drums.player(voice).start(time);
+        beat2 += 1;
+      }, spb, 0);
+      this.#scheduleIds.push(id2);
+      return;
+    }
     if (this.#opts.rhythm === "none" || base === void 0) return;
     this.#metronome ??= createMetronome(Tone, base).connect(master);
     const metro = this.#metronome;
@@ -841,7 +538,17 @@ async function exportAudio(doc, options = {}) {
         }
       }
       let tabla;
-      if (rhythm !== "none" && base) {
+      if (rhythm === "drums" && base) {
+        const drums = createDrumKit(Tone).connect(master);
+        const taal = taalId !== void 0 ? TAALS[taalId] : { numBeats: 4, sam: 0 };
+        const pattern = drumPattern(taal);
+        let beat = 0;
+        transport.scheduleRepeat((time) => {
+          const voice = pattern[beat % pattern.length];
+          if (drums.has(voice)) drums.player(voice).start(time);
+          beat += 1;
+        }, spb, 0);
+      } else if (rhythm !== "none" && base) {
         if (usesTabla && taalId) {
           const url = tablaUrl(base, taalId, bpm, variation);
           tabla = new Tone.Player({ url, loop: true }).connect(master);
@@ -993,34 +700,72 @@ function utf8(s) {
 function u32be(n) {
   return [n >>> 24 & 255, n >>> 16 & 255, n >>> 8 & 255, n & 255];
 }
+var DRUM_NOTE = {
+  kick: 36,
+  snare: 38,
+  hihat: 42,
+  // closed hi-hat
+  tom1: 48,
+  tom2: 45,
+  tom3: 41
+};
+function trackChunk(raw, head) {
+  raw.sort((a, b) => a.tick - b.tick || Number(a.on) - Number(b.on));
+  const track = [...head];
+  let last = 0;
+  for (const e of raw) {
+    const status = (e.on ? 144 : 128) | e.ch & 15;
+    track.push(...vlq(e.tick - last), status, e.note & 127, e.vel & 127);
+    last = e.tick;
+  }
+  track.push(...vlq(0), 255, 47, 0);
+  return [77, 84, 114, 107, ...u32be(track.length), ...track];
+}
 function encodeMidi(schedule, opts) {
-  const raw = [];
+  const melody = [];
   for (const ev of schedule.events) {
     if (ev.midi === null) continue;
     const start = Math.round(ev.beat * PPQ);
     const end = Math.max(Math.round((ev.beat + ev.durationBeats) * PPQ), start + 1);
     if (ev.kan !== null) {
       const kOn = Math.max(start - Math.round(0.12 * PPQ), 0);
-      raw.push({ tick: kOn, on: true, note: ev.kan, vel: 70 });
-      raw.push({ tick: start, on: false, note: ev.kan, vel: 0 });
+      melody.push({ tick: kOn, on: true, note: ev.kan, vel: 70, ch: 0 });
+      melody.push({ tick: start, on: false, note: ev.kan, vel: 0, ch: 0 });
     }
-    raw.push({ tick: start, on: true, note: ev.midi, vel: 100 });
-    raw.push({ tick: end, on: false, note: ev.midi, vel: 0 });
+    melody.push({ tick: start, on: true, note: ev.midi, vel: 100, ch: 0 });
+    melody.push({ tick: end, on: false, note: ev.midi, vel: 0, ch: 0 });
   }
-  raw.sort((a, b) => a.tick - b.tick || Number(a.on) - Number(b.on));
-  const track = [];
-  if (opts.name) track.push(...vlq(0), 255, 3, ...vlq(utf8(opts.name).length), ...utf8(opts.name));
   const usPerBeat = Math.round(6e7 / opts.bpm);
-  track.push(...vlq(0), 255, 81, 3, usPerBeat >> 16 & 255, usPerBeat >> 8 & 255, usPerBeat & 255);
-  let last = 0;
-  for (const e of raw) {
-    track.push(...vlq(e.tick - last), e.on ? 144 : 128, e.note & 127, e.vel & 127);
-    last = e.tick;
-  }
-  track.push(...vlq(0), 255, 47, 0);
-  const header = [77, 84, 104, 100, ...u32be(6), 0, 0, 0, 1, PPQ >> 8 & 255, PPQ & 255];
-  const trackChunk = [77, 84, 114, 107, ...u32be(track.length), ...track];
-  return new Uint8Array([...header, ...trackChunk]);
+  const head = [];
+  if (opts.name) head.push(...vlq(0), 255, 3, ...vlq(utf8(opts.name).length), ...utf8(opts.name));
+  head.push(...vlq(0), 255, 81, 3, usPerBeat >> 16 & 255, usPerBeat >> 8 & 255, usPerBeat & 255);
+  const chunks = [trackChunk(melody, head)];
+  if (opts.drums && opts.drums.length > 0) {
+    const drum = [];
+    const totalBeats = Math.ceil(schedule.totalBeats);
+    for (let beat = 0; beat < totalBeats; beat++) {
+      const note = DRUM_NOTE[opts.drums[beat % opts.drums.length]];
+      const t = beat * PPQ;
+      drum.push({ tick: t, on: true, note, vel: 100, ch: 9 });
+      drum.push({ tick: t + Math.round(PPQ / 4), on: false, note, vel: 0, ch: 9 });
+    }
+    chunks.push(trackChunk(drum, [...vlq(0), 255, 3, ...vlq(5), 68, 114, 117, 109, 115]));
+  }
+  const format = chunks.length > 1 ? 1 : 0;
+  const header = [
+    77,
+    84,
+    104,
+    100,
+    ...u32be(6),
+    0,
+    format,
+    chunks.length >> 8 & 255,
+    chunks.length & 255,
+    PPQ >> 8 & 255,
+    PPQ & 255
+  ];
+  return new Uint8Array([...header, ...chunks.flat()]);
 }
 function safeName2(title) {
   return (title ?? "").replace(/[\\/:*?"<>|]+/g, "").trim() || "swaralipi";
@@ -1028,7 +773,10 @@ function safeName2(title) {
 function exportMidi(doc, options = {}) {
   const schedule = buildSchedule(doc, { tonic: options.tonic, baseOctave: options.baseOctave });
   const bpm = options.bpm ?? doc.meta.bpm ?? 90;
-  const bytes = encodeMidi(schedule, { bpm, name: options.name ?? doc.meta.title });
+  const taalId = doc.meta.taal?.id;
+  const taal = taalId !== void 0 && taalId in TAALS ? TAALS[taalId] : { numBeats: 4, sam: 0 };
+  const drums = options.drums ? drumPattern(taal) : void 0;
+  const bytes = encodeMidi(schedule, { bpm, name: options.name ?? doc.meta.title, drums });
   return {
     blob: new Blob([bytes], { type: "audio/midi" }),
     filename: `${safeName2(doc.meta.title)}.mid`,
@@ -1036,6 +784,6 @@ function exportMidi(doc, options = {}) {
   };
 }
 
-export { DEFAULT_SOUNDS_BASE, INSTRUMENTS, OCTAVE_OFFSET, SALAMANDER_BASE, SAMPLED_TAALS, SHUDDHA, SwaralipiPlayer, TABLA_BPMS, TABLA_VARIATIONS, TONEJS_INSTRUMENTS_BASE, buildSchedule, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi, instrumentSampleUrl, midiToSampleName, nearestTablaBpm, normalizeBase, parseTonic, probeUrl, quantizeLoopEnd, sampleFileName, santoorUrls, subsetUrls, svaraSemitone, svaraToMidi, tablaBpms, tablaUrl };
+export { SwaralipiPlayer, encodeMidi, encodeMp3, encodeWav, exportAudio, exportMidi };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map