@ugfoundation/swaralipi-js 0.8.2 → 0.9.1

package/dist/{schedule-B_UaluBi.d.cts → schedule-BaovCtmf.d.ts}

@@ -1,6 +1,6 @@
 import * as tone from 'tone';
-import { T as Taal, S as Swaralipi, N as Note } from './schema-DGA_bNVZ.cjs';
-import { T as TaalId, L as Lay, a as LaySpeeds } from './lay-Csa4CD46.cjs';
+import { T as Taal, S as Swaralipi, N as Note } from './schema-Cf_epUIC.js';
+import { T as TaalId, L as Lay, a as LaySpeeds } from './lay-CZIzR9cM.js';
 
 /** The dynamically-imported Tone module, typed without importing it. */
 type ToneModule = typeof tone;
@@ -161,9 +161,10 @@ interface PlayEvent {
     durationBeats: number;
     /** Pitch as MIDI, or null for a rest / আ-কার hold column. */
     midi: number | null;
-    /** Grace-note MIDI struck just before the main attack, when present. */
-    /** MIDI of each কণ grace on this note, in written order (empty = none). */
+    /** MIDI of each কণ grace on this column, in written order (empty = none). */
     kan: number[];
+    /** MIDI of each রেশ grace on this column, in written order (empty = none). */
+    resh: number[];
     /** `part.row.note` highlight path. */
     path: string;
     kind: 'note' | 'rest' | 'sustain';
@@ -176,10 +177,12 @@ interface PlayEvent {
     glide?: true;
 }
 /**
- * One লয় stretch of the timeline. `scale` is the fraction of the base bpm the
- * passage sounds at, and it is exactly the factor a looping accompaniment must
- * change its own tempo by — `beat` × secondsPerBeat gives its start in seconds.
- * Always at least one segment, the first at beat 0.
+ * One accompaniment stretch of the timeline: a লয় and a তাল held constant.
+ * A new segment starts wherever either changes — they are independent marks.
+ * `scale` is the fraction of the base bpm the passage sounds at, and it is
+ * exactly the factor a looping accompaniment must change its own tempo by —
+ * `beat` × secondsPerBeat gives its start in seconds. Always at least one
+ * segment, the first at beat 0.
  */
 interface TempoSegment {
     /** Start, in schedule beats (see PlayEvent.beat). */
@@ -188,6 +191,9 @@ interface TempoSegment {
     endBeat: number;
     scale: number;
     lay: Lay;
+    /** তাল in force: `meta.taal` until a row's `taal` changes it. `null` = an
+     * explicit মুক্তছন্দ passage; `undefined` = the document names no taal. */
+    taal?: Taal | null;
 }
 interface Schedule {
     events: PlayEvent[];
@@ -203,9 +209,9 @@ interface Schedule {
      * no sam tick. The player/exporter apply it only when a rhythm actually loops.
      */
     pickupBeats: number;
-    /** লয় stretches, in order and gapless. One entry (drut, scale 1) for a
-     * document that never changes tempo — i.e. every document written before
-     * `row.lay` existed. */
+    /** লয় / তাল stretches, in order and gapless. One entry (drut, scale 1,
+     * `meta.taal`) for a document that never changes either — i.e. every
+     * document written before `row.lay` / `row.taal` existed. */
     tempo: TempoSegment[];
 }
 interface ScheduleOptions {
@@ -255,6 +261,19 @@ declare function meendContinuations(notes: Note[]): Set<number>;
  * Consumers skip events that are themselves `glide` (already consumed here).
  */
 declare function glideTargets(events: PlayEvent[], i: number): PlayEvent[];
+/** Schedule beats between a grace and its column's start; consecutive graces step by it. */
+declare const GRACE_STEP = 0.12;
+/**
+ * When each grace of `ev` sounds, in written order, mirrored around the
+ * column's start: a কণ (written left of its svara) touches just before it, a
+ * রেশ (written right) just after — so on a hold or rest column they touch under
+ * whatever is still ringing. Not at the column's end: every grace is a fresh
+ * strike, and one struck just before the next column is heard as its কণ.
+ */
+declare function graceTouches(ev: PlayEvent): {
+    midi: number;
+    beat: number;
+}[];
 /**
  * Walk a document into a flat, time-ordered list of play events.
  *
@@ -274,4 +293,4 @@ declare function glideTargets(events: PlayEvent[], i: number): PlayEvent[];
  */
 declare function buildSchedule(doc: Swaralipi, opts?: ScheduleOptions): Schedule;
 
-export { ARC_RAW_RE as A, tablaUrl as B, triggerGlide as C, type DrumVoice as D, type GlideLeg as G, type InstrumentId as I, MEEND_HOLD as M, type PlayEvent as P, type Schedule as S, TABLA_BPMS as T, type InstrumentDef as a, DEFAULT_SOUNDS_BASE as b, DRUM_KIT_BASE as c, INSTRUMENTS as d, SALAMANDER_BASE as e, SAMPLED_TAALS as f, type ScheduleOptions as g, TABLA_VARIATIONS as h, TONEJS_INSTRUMENTS_BASE as i, type TempoSegment as j, type ToneModule as k, buildSchedule as l, createBuffers as m, drumPattern as n, glideTargets as o, instrumentSampleUrl as p, isArcRaw as q, meendContinuations as r, nearestSampleKey as s, nearestTablaBpm as t, normalizeBase as u, probeUrl as v, quantizeLoopEnd as w, santoorUrls as x, subsetUrls as y, tablaBpms as z };
+export { ARC_RAW_RE as A, subsetUrls as B, tablaBpms as C, type DrumVoice as D, tablaUrl as E, triggerGlide as F, GRACE_STEP as G, type InstrumentId as I, MEEND_HOLD as M, type PlayEvent as P, type Schedule as S, type TempoSegment as T, type InstrumentDef as a, DEFAULT_SOUNDS_BASE as b, DRUM_KIT_BASE as c, type GlideLeg as d, INSTRUMENTS as e, SALAMANDER_BASE as f, SAMPLED_TAALS as g, type ScheduleOptions as h, TABLA_BPMS as i, TABLA_VARIATIONS as j, TONEJS_INSTRUMENTS_BASE as k, type ToneModule as l, buildSchedule as m, createBuffers as n, drumPattern as o, glideTargets as p, graceTouches as q, instrumentSampleUrl as r, isArcRaw as s, meendContinuations as t, nearestSampleKey as u, nearestTablaBpm as v, normalizeBase as w, probeUrl as x, quantizeLoopEnd as y, santoorUrls as z };

package/dist/{schedule-CdILTNsk.d.ts → schedule-CU-VECDH.d.cts}

@@ -1,6 +1,6 @@
 import * as tone from 'tone';
-import { T as Taal, S as Swaralipi, N as Note } from './schema-DGA_bNVZ.js';
-import { T as TaalId, L as Lay, a as LaySpeeds } from './lay-Ct9ky_EE.js';
+import { T as Taal, S as Swaralipi, N as Note } from './schema-Cf_epUIC.cjs';
+import { T as TaalId, L as Lay, a as LaySpeeds } from './lay-CfDlPhH2.cjs';
 
 /** The dynamically-imported Tone module, typed without importing it. */
 type ToneModule = typeof tone;
@@ -161,9 +161,10 @@ interface PlayEvent {
     durationBeats: number;
     /** Pitch as MIDI, or null for a rest / আ-কার hold column. */
     midi: number | null;
-    /** Grace-note MIDI struck just before the main attack, when present. */
-    /** MIDI of each কণ grace on this note, in written order (empty = none). */
+    /** MIDI of each কণ grace on this column, in written order (empty = none). */
     kan: number[];
+    /** MIDI of each রেশ grace on this column, in written order (empty = none). */
+    resh: number[];
     /** `part.row.note` highlight path. */
     path: string;
     kind: 'note' | 'rest' | 'sustain';
@@ -176,10 +177,12 @@ interface PlayEvent {
     glide?: true;
 }
 /**
- * One লয় stretch of the timeline. `scale` is the fraction of the base bpm the
- * passage sounds at, and it is exactly the factor a looping accompaniment must
- * change its own tempo by — `beat` × secondsPerBeat gives its start in seconds.
- * Always at least one segment, the first at beat 0.
+ * One accompaniment stretch of the timeline: a লয় and a তাল held constant.
+ * A new segment starts wherever either changes — they are independent marks.
+ * `scale` is the fraction of the base bpm the passage sounds at, and it is
+ * exactly the factor a looping accompaniment must change its own tempo by —
+ * `beat` × secondsPerBeat gives its start in seconds. Always at least one
+ * segment, the first at beat 0.
  */
 interface TempoSegment {
     /** Start, in schedule beats (see PlayEvent.beat). */
@@ -188,6 +191,9 @@ interface TempoSegment {
     endBeat: number;
     scale: number;
     lay: Lay;
+    /** তাল in force: `meta.taal` until a row's `taal` changes it. `null` = an
+     * explicit মুক্তছন্দ passage; `undefined` = the document names no taal. */
+    taal?: Taal | null;
 }
 interface Schedule {
     events: PlayEvent[];
@@ -203,9 +209,9 @@ interface Schedule {
      * no sam tick. The player/exporter apply it only when a rhythm actually loops.
      */
     pickupBeats: number;
-    /** লয় stretches, in order and gapless. One entry (drut, scale 1) for a
-     * document that never changes tempo — i.e. every document written before
-     * `row.lay` existed. */
+    /** লয় / তাল stretches, in order and gapless. One entry (drut, scale 1,
+     * `meta.taal`) for a document that never changes either — i.e. every
+     * document written before `row.lay` / `row.taal` existed. */
     tempo: TempoSegment[];
 }
 interface ScheduleOptions {
@@ -255,6 +261,19 @@ declare function meendContinuations(notes: Note[]): Set<number>;
  * Consumers skip events that are themselves `glide` (already consumed here).
  */
 declare function glideTargets(events: PlayEvent[], i: number): PlayEvent[];
+/** Schedule beats between a grace and its column's start; consecutive graces step by it. */
+declare const GRACE_STEP = 0.12;
+/**
+ * When each grace of `ev` sounds, in written order, mirrored around the
+ * column's start: a কণ (written left of its svara) touches just before it, a
+ * রেশ (written right) just after — so on a hold or rest column they touch under
+ * whatever is still ringing. Not at the column's end: every grace is a fresh
+ * strike, and one struck just before the next column is heard as its কণ.
+ */
+declare function graceTouches(ev: PlayEvent): {
+    midi: number;
+    beat: number;
+}[];
 /**
  * Walk a document into a flat, time-ordered list of play events.
  *
@@ -274,4 +293,4 @@ declare function glideTargets(events: PlayEvent[], i: number): PlayEvent[];
  */
 declare function buildSchedule(doc: Swaralipi, opts?: ScheduleOptions): Schedule;
 
-export { ARC_RAW_RE as A, tablaUrl as B, triggerGlide as C, type DrumVoice as D, type GlideLeg as G, type InstrumentId as I, MEEND_HOLD as M, type PlayEvent as P, type Schedule as S, TABLA_BPMS as T, type InstrumentDef as a, DEFAULT_SOUNDS_BASE as b, DRUM_KIT_BASE as c, INSTRUMENTS as d, SALAMANDER_BASE as e, SAMPLED_TAALS as f, type ScheduleOptions as g, TABLA_VARIATIONS as h, TONEJS_INSTRUMENTS_BASE as i, type TempoSegment as j, type ToneModule as k, buildSchedule as l, createBuffers as m, drumPattern as n, glideTargets as o, instrumentSampleUrl as p, isArcRaw as q, meendContinuations as r, nearestSampleKey as s, nearestTablaBpm as t, normalizeBase as u, probeUrl as v, quantizeLoopEnd as w, santoorUrls as x, subsetUrls as y, tablaBpms as z };
+export { ARC_RAW_RE as A, subsetUrls as B, tablaBpms as C, type DrumVoice as D, tablaUrl as E, triggerGlide as F, GRACE_STEP as G, type InstrumentId as I, MEEND_HOLD as M, type PlayEvent as P, type Schedule as S, type TempoSegment as T, type InstrumentDef as a, DEFAULT_SOUNDS_BASE as b, DRUM_KIT_BASE as c, type GlideLeg as d, INSTRUMENTS as e, SALAMANDER_BASE as f, SAMPLED_TAALS as g, type ScheduleOptions as h, TABLA_BPMS as i, TABLA_VARIATIONS as j, TONEJS_INSTRUMENTS_BASE as k, type ToneModule as l, buildSchedule as m, createBuffers as n, drumPattern as o, glideTargets as p, graceTouches as q, instrumentSampleUrl as r, isArcRaw as s, meendContinuations as t, nearestSampleKey as u, nearestTablaBpm as v, normalizeBase as w, probeUrl as x, quantizeLoopEnd as y, santoorUrls as z };