@ugfoundation/swaralipi-js 0.7.7 → 0.8.0

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

@@ -1,6 +1,6 @@
 import * as tone from 'tone';
-import { T as Taal, S as Swaralipi, N as Note } from './schema-DqBXPGkL.cjs';
-import { T as TaalId } from './taals-CjzBuZ35.cjs';
+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';
 
 /** The dynamically-imported Tone module, typed without importing it. */
 type ToneModule = typeof tone;
@@ -175,6 +175,20 @@ 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.
+ */
+interface TempoSegment {
+    /** Start, in schedule beats (see PlayEvent.beat). */
+    beat: number;
+    /** End, in schedule beats (= the next segment's start, or totalBeats). */
+    endBeat: number;
+    scale: number;
+    lay: Lay;
+}
 interface Schedule {
     events: PlayEvent[];
     /** Total length in matra (the cursor's final value). */
@@ -189,12 +203,22 @@ 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. */
+    tempo: TempoSegment[];
 }
 interface ScheduleOptions {
     /** Tonic; accepts `C`, `C#`, `cs`… (see parseTonic). Default C. */
     tonic?: string;
     /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */
     baseOctave?: number;
+    /** Override the লয় tempo factors (see LAY_SPEEDS / meta.laySpeeds). */
+    laySpeeds?: LaySpeeds;
+    /** Apply লয় at all. Default true. The staff view sets it false: it reads
+     * `durationBeats` as written note values, where a 0.75 stretch is not a
+     * writable duration. */
+    lay?: boolean;
 }
 /**
  * Below-annotation raws that are মীড় arc drawing segments (codec known-raw):
@@ -250,4 +274,4 @@ declare function glideTargets(events: PlayEvent[], i: number): PlayEvent[];
  */
 declare function buildSchedule(doc: Swaralipi, opts?: ScheduleOptions): Schedule;
 
-export { ARC_RAW_RE as A, triggerGlide as B, 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 ToneModule as j, buildSchedule as k, createBuffers as l, drumPattern as m, glideTargets as n, instrumentSampleUrl as o, isArcRaw as p, meendContinuations as q, nearestSampleKey as r, nearestTablaBpm as s, normalizeBase as t, probeUrl as u, quantizeLoopEnd as v, santoorUrls as w, subsetUrls as x, tablaBpms as y, tablaUrl as z };
+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 };

package/dist/{schedule-Tzk01FKj.d.ts → schedule-CdILTNsk.d.ts}

@@ -1,6 +1,6 @@
 import * as tone from 'tone';
-import { T as Taal, S as Swaralipi, N as Note } from './schema-DqBXPGkL.js';
-import { T as TaalId } from './taals-CjzBuZ35.js';
+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';
 
 /** The dynamically-imported Tone module, typed without importing it. */
 type ToneModule = typeof tone;
@@ -175,6 +175,20 @@ 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.
+ */
+interface TempoSegment {
+    /** Start, in schedule beats (see PlayEvent.beat). */
+    beat: number;
+    /** End, in schedule beats (= the next segment's start, or totalBeats). */
+    endBeat: number;
+    scale: number;
+    lay: Lay;
+}
 interface Schedule {
     events: PlayEvent[];
     /** Total length in matra (the cursor's final value). */
@@ -189,12 +203,22 @@ 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. */
+    tempo: TempoSegment[];
 }
 interface ScheduleOptions {
     /** Tonic; accepts `C`, `C#`, `cs`… (see parseTonic). Default C. */
     tonic?: string;
     /** Octave of madhyam Sa (C4 = MIDI 60). Default 4. */
     baseOctave?: number;
+    /** Override the লয় tempo factors (see LAY_SPEEDS / meta.laySpeeds). */
+    laySpeeds?: LaySpeeds;
+    /** Apply লয় at all. Default true. The staff view sets it false: it reads
+     * `durationBeats` as written note values, where a 0.75 stretch is not a
+     * writable duration. */
+    lay?: boolean;
 }
 /**
  * Below-annotation raws that are মীড় arc drawing segments (codec known-raw):
@@ -250,4 +274,4 @@ declare function glideTargets(events: PlayEvent[], i: number): PlayEvent[];
  */
 declare function buildSchedule(doc: Swaralipi, opts?: ScheduleOptions): Schedule;
 
-export { ARC_RAW_RE as A, triggerGlide as B, 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 ToneModule as j, buildSchedule as k, createBuffers as l, drumPattern as m, glideTargets as n, instrumentSampleUrl as o, isArcRaw as p, meendContinuations as q, nearestSampleKey as r, nearestTablaBpm as s, normalizeBase as t, probeUrl as u, quantizeLoopEnd as v, santoorUrls as w, subsetUrls as x, tablaBpms as y, tablaUrl as z };
+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 };

package/dist/{schema-DqBXPGkL.d.cts → schema-DGA_bNVZ.d.cts}

@@ -122,17 +122,29 @@ interface Note {
     below?: Note[];
 }
 declare const noteSchema: z.ZodType<Note>;
+/** লয় tier. `Lay` (and the tempo factors) live in the zod-free ./lay.js,
+ * which the viewer/player import directly; `satisfies` keeps the two in step. */
+declare const laySchema: z.ZodEnum<["drut", "madhya", "vilambit"]>;
 /** A written line of the song: a sequence of note tokens. */
 declare const rowSchema: z.ZodObject<{
     /** Optional line label (e.g. a tuk/section marker). */
     label: z.ZodOptional<z.ZodString>;
+    /**
+     * লয়: the tempo tier this row switches to, held until another row changes
+     * it (absent on every row = the whole song at `meta.bpm`, i.e. দ্রুত).
+     * Read it with `rowLay()`, which also picks up the mark NLTR *prints*
+     * ("বিলম্বিত লয়:") in already-converted documents.
+     */
+    lay: z.ZodOptional<z.ZodEnum<["drut", "madhya", "vilambit"]>>;
     notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
 }, "strip", z.ZodTypeAny, {
     notes: Note[];
     label?: string | undefined;
+    lay?: "drut" | "madhya" | "vilambit" | undefined;
 }, {
     notes: Note[];
     label?: string | undefined;
+    lay?: "drut" | "madhya" | "vilambit" | undefined;
 }>;
 type Row = z.infer<typeof rowSchema>;
 /** A structural section: আস্থায়ী / অন্তরা / সঞ্চারী / আভোগ, or free text. */
@@ -141,24 +153,35 @@ declare const partSchema: z.ZodObject<{
     rows: z.ZodArray<z.ZodObject<{
         /** Optional line label (e.g. a tuk/section marker). */
         label: z.ZodOptional<z.ZodString>;
+        /**
+         * লয়: the tempo tier this row switches to, held until another row changes
+         * it (absent on every row = the whole song at `meta.bpm`, i.e. দ্রুত).
+         * Read it with `rowLay()`, which also picks up the mark NLTR *prints*
+         * ("বিলম্বিত লয়:") in already-converted documents.
+         */
+        lay: z.ZodOptional<z.ZodEnum<["drut", "madhya", "vilambit"]>>;
         notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
     }, "strip", z.ZodTypeAny, {
         notes: Note[];
         label?: string | undefined;
+        lay?: "drut" | "madhya" | "vilambit" | undefined;
     }, {
         notes: Note[];
         label?: string | undefined;
+        lay?: "drut" | "madhya" | "vilambit" | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     rows: {
         notes: Note[];
         label?: string | undefined;
+        lay?: "drut" | "madhya" | "vilambit" | undefined;
     }[];
     name?: string | undefined;
 }, {
     rows: {
         notes: Note[];
         label?: string | undefined;
+        lay?: "drut" | "madhya" | "vilambit" | undefined;
     }[];
     name?: string | undefined;
 }>;
@@ -279,6 +302,21 @@ declare const metaSchema: z.ZodObject<{
      * The player adopts it on `load()` (precedence: constructor `bpm` → `setBpm`
      * tweak → this → 90). `null` is the converter's blank placeholder = unset. */
     bpm: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /** Per-document override of the লয় tempo factors (fractions of `bpm`).
+     * Defaults live in `LAY_SPEEDS`; a player/export option overrides both. */
+    laySpeeds: z.ZodOptional<z.ZodObject<{
+        drut: z.ZodOptional<z.ZodNumber>;
+        madhya: z.ZodOptional<z.ZodNumber>;
+        vilambit: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        drut?: number | undefined;
+        madhya?: number | undefined;
+        vilambit?: number | undefined;
+    }, {
+        drut?: number | undefined;
+        madhya?: number | undefined;
+        vilambit?: number | undefined;
+    }>>;
     raag: z.ZodOptional<z.ZodString>;
     /** আবর্তন: number of taal cycles, when the source states it. */
     avartan: z.ZodOptional<z.ZodNumber>;
@@ -301,6 +339,11 @@ declare const metaSchema: z.ZodObject<{
     taalName?: string | undefined;
     tonic?: string | undefined;
     bpm?: number | null | undefined;
+    laySpeeds?: {
+        drut?: number | undefined;
+        madhya?: number | undefined;
+        vilambit?: number | undefined;
+    } | undefined;
     raag?: string | undefined;
     avartan?: number | undefined;
     notationBy?: string | undefined;
@@ -320,6 +363,11 @@ declare const metaSchema: z.ZodObject<{
     taalName?: string | undefined;
     tonic?: string | undefined;
     bpm?: number | null | undefined;
+    laySpeeds?: {
+        drut?: number | undefined;
+        madhya?: number | undefined;
+        vilambit?: number | undefined;
+    } | undefined;
     raag?: string | undefined;
     avartan?: number | undefined;
     notationBy?: string | undefined;
@@ -394,6 +442,21 @@ declare const swaralipiSchema: z.ZodObject<{
          * The player adopts it on `load()` (precedence: constructor `bpm` → `setBpm`
          * tweak → this → 90). `null` is the converter's blank placeholder = unset. */
         bpm: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        /** Per-document override of the লয় tempo factors (fractions of `bpm`).
+         * Defaults live in `LAY_SPEEDS`; a player/export option overrides both. */
+        laySpeeds: z.ZodOptional<z.ZodObject<{
+            drut: z.ZodOptional<z.ZodNumber>;
+            madhya: z.ZodOptional<z.ZodNumber>;
+            vilambit: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        }, {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        }>>;
         raag: z.ZodOptional<z.ZodString>;
         /** আবর্তন: number of taal cycles, when the source states it. */
         avartan: z.ZodOptional<z.ZodNumber>;
@@ -416,6 +479,11 @@ declare const swaralipiSchema: z.ZodObject<{
         taalName?: string | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
+        laySpeeds?: {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        } | undefined;
         raag?: string | undefined;
         avartan?: number | undefined;
         notationBy?: string | undefined;
@@ -435,6 +503,11 @@ declare const swaralipiSchema: z.ZodObject<{
         taalName?: string | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
+        laySpeeds?: {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        } | undefined;
         raag?: string | undefined;
         avartan?: number | undefined;
         notationBy?: string | undefined;
@@ -445,24 +518,35 @@ declare const swaralipiSchema: z.ZodObject<{
         rows: z.ZodArray<z.ZodObject<{
             /** Optional line label (e.g. a tuk/section marker). */
             label: z.ZodOptional<z.ZodString>;
+            /**
+             * লয়: the tempo tier this row switches to, held until another row changes
+             * it (absent on every row = the whole song at `meta.bpm`, i.e. দ্রুত).
+             * Read it with `rowLay()`, which also picks up the mark NLTR *prints*
+             * ("বিলম্বিত লয়:") in already-converted documents.
+             */
+            lay: z.ZodOptional<z.ZodEnum<["drut", "madhya", "vilambit"]>>;
             notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
         }, "strip", z.ZodTypeAny, {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }, {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         rows: {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }[];
         name?: string | undefined;
     }, {
         rows: {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }[];
         name?: string | undefined;
     }>, "many">;
@@ -483,6 +567,11 @@ declare const swaralipiSchema: z.ZodObject<{
         taalName?: string | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
+        laySpeeds?: {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        } | undefined;
         raag?: string | undefined;
         avartan?: number | undefined;
         notationBy?: string | undefined;
@@ -492,6 +581,7 @@ declare const swaralipiSchema: z.ZodObject<{
         rows: {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }[];
         name?: string | undefined;
     }[];
@@ -512,6 +602,11 @@ declare const swaralipiSchema: z.ZodObject<{
         taalName?: string | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
+        laySpeeds?: {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        } | undefined;
         raag?: string | undefined;
         avartan?: number | undefined;
         notationBy?: string | undefined;
@@ -521,10 +616,11 @@ declare const swaralipiSchema: z.ZodObject<{
         rows: {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }[];
         name?: string | undefined;
     }[];
 }>;
 type Swaralipi = z.infer<typeof swaralipiSchema>;
 
-export { type Bar as B, type Grace as G, type Meta as M, type Note as N, type Octave as O, type Part as P, type Row as R, type Swaralipi as S, type Taal as T, type SvaraLetter as a, type Bracket as b, type Microtone as c, type Svara as d, barSchema as e, bracketSchema as f, graceSchema as g, microtoneSchema as h, svaraSchema as i, swaralipiSchema as j, metaSchema as m, noteSchema as n, octaveSchema as o, partSchema as p, rowSchema as r, svaraLetterSchema as s, taalSchema as t };
+export { type Bar as B, type Grace as G, type Meta as M, type Note as N, type Octave as O, type Part as P, type Row as R, type Swaralipi as S, type Taal as T, type SvaraLetter as a, type Bracket as b, type Microtone as c, type Svara as d, barSchema as e, bracketSchema as f, graceSchema as g, microtoneSchema as h, svaraSchema as i, swaralipiSchema as j, laySchema as l, metaSchema as m, noteSchema as n, octaveSchema as o, partSchema as p, rowSchema as r, svaraLetterSchema as s, taalSchema as t };

package/dist/{schema-DqBXPGkL.d.ts → schema-DGA_bNVZ.d.ts}

@@ -122,17 +122,29 @@ interface Note {
     below?: Note[];
 }
 declare const noteSchema: z.ZodType<Note>;
+/** লয় tier. `Lay` (and the tempo factors) live in the zod-free ./lay.js,
+ * which the viewer/player import directly; `satisfies` keeps the two in step. */
+declare const laySchema: z.ZodEnum<["drut", "madhya", "vilambit"]>;
 /** A written line of the song: a sequence of note tokens. */
 declare const rowSchema: z.ZodObject<{
     /** Optional line label (e.g. a tuk/section marker). */
     label: z.ZodOptional<z.ZodString>;
+    /**
+     * লয়: the tempo tier this row switches to, held until another row changes
+     * it (absent on every row = the whole song at `meta.bpm`, i.e. দ্রুত).
+     * Read it with `rowLay()`, which also picks up the mark NLTR *prints*
+     * ("বিলম্বিত লয়:") in already-converted documents.
+     */
+    lay: z.ZodOptional<z.ZodEnum<["drut", "madhya", "vilambit"]>>;
     notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
 }, "strip", z.ZodTypeAny, {
     notes: Note[];
     label?: string | undefined;
+    lay?: "drut" | "madhya" | "vilambit" | undefined;
 }, {
     notes: Note[];
     label?: string | undefined;
+    lay?: "drut" | "madhya" | "vilambit" | undefined;
 }>;
 type Row = z.infer<typeof rowSchema>;
 /** A structural section: আস্থায়ী / অন্তরা / সঞ্চারী / আভোগ, or free text. */
@@ -141,24 +153,35 @@ declare const partSchema: z.ZodObject<{
     rows: z.ZodArray<z.ZodObject<{
         /** Optional line label (e.g. a tuk/section marker). */
         label: z.ZodOptional<z.ZodString>;
+        /**
+         * লয়: the tempo tier this row switches to, held until another row changes
+         * it (absent on every row = the whole song at `meta.bpm`, i.e. দ্রুত).
+         * Read it with `rowLay()`, which also picks up the mark NLTR *prints*
+         * ("বিলম্বিত লয়:") in already-converted documents.
+         */
+        lay: z.ZodOptional<z.ZodEnum<["drut", "madhya", "vilambit"]>>;
         notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
     }, "strip", z.ZodTypeAny, {
         notes: Note[];
         label?: string | undefined;
+        lay?: "drut" | "madhya" | "vilambit" | undefined;
     }, {
         notes: Note[];
         label?: string | undefined;
+        lay?: "drut" | "madhya" | "vilambit" | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     rows: {
         notes: Note[];
         label?: string | undefined;
+        lay?: "drut" | "madhya" | "vilambit" | undefined;
     }[];
     name?: string | undefined;
 }, {
     rows: {
         notes: Note[];
         label?: string | undefined;
+        lay?: "drut" | "madhya" | "vilambit" | undefined;
     }[];
     name?: string | undefined;
 }>;
@@ -279,6 +302,21 @@ declare const metaSchema: z.ZodObject<{
      * The player adopts it on `load()` (precedence: constructor `bpm` → `setBpm`
      * tweak → this → 90). `null` is the converter's blank placeholder = unset. */
     bpm: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /** Per-document override of the লয় tempo factors (fractions of `bpm`).
+     * Defaults live in `LAY_SPEEDS`; a player/export option overrides both. */
+    laySpeeds: z.ZodOptional<z.ZodObject<{
+        drut: z.ZodOptional<z.ZodNumber>;
+        madhya: z.ZodOptional<z.ZodNumber>;
+        vilambit: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        drut?: number | undefined;
+        madhya?: number | undefined;
+        vilambit?: number | undefined;
+    }, {
+        drut?: number | undefined;
+        madhya?: number | undefined;
+        vilambit?: number | undefined;
+    }>>;
     raag: z.ZodOptional<z.ZodString>;
     /** আবর্তন: number of taal cycles, when the source states it. */
     avartan: z.ZodOptional<z.ZodNumber>;
@@ -301,6 +339,11 @@ declare const metaSchema: z.ZodObject<{
     taalName?: string | undefined;
     tonic?: string | undefined;
     bpm?: number | null | undefined;
+    laySpeeds?: {
+        drut?: number | undefined;
+        madhya?: number | undefined;
+        vilambit?: number | undefined;
+    } | undefined;
     raag?: string | undefined;
     avartan?: number | undefined;
     notationBy?: string | undefined;
@@ -320,6 +363,11 @@ declare const metaSchema: z.ZodObject<{
     taalName?: string | undefined;
     tonic?: string | undefined;
     bpm?: number | null | undefined;
+    laySpeeds?: {
+        drut?: number | undefined;
+        madhya?: number | undefined;
+        vilambit?: number | undefined;
+    } | undefined;
     raag?: string | undefined;
     avartan?: number | undefined;
     notationBy?: string | undefined;
@@ -394,6 +442,21 @@ declare const swaralipiSchema: z.ZodObject<{
          * The player adopts it on `load()` (precedence: constructor `bpm` → `setBpm`
          * tweak → this → 90). `null` is the converter's blank placeholder = unset. */
         bpm: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        /** Per-document override of the লয় tempo factors (fractions of `bpm`).
+         * Defaults live in `LAY_SPEEDS`; a player/export option overrides both. */
+        laySpeeds: z.ZodOptional<z.ZodObject<{
+            drut: z.ZodOptional<z.ZodNumber>;
+            madhya: z.ZodOptional<z.ZodNumber>;
+            vilambit: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        }, {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        }>>;
         raag: z.ZodOptional<z.ZodString>;
         /** আবর্তন: number of taal cycles, when the source states it. */
         avartan: z.ZodOptional<z.ZodNumber>;
@@ -416,6 +479,11 @@ declare const swaralipiSchema: z.ZodObject<{
         taalName?: string | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
+        laySpeeds?: {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        } | undefined;
         raag?: string | undefined;
         avartan?: number | undefined;
         notationBy?: string | undefined;
@@ -435,6 +503,11 @@ declare const swaralipiSchema: z.ZodObject<{
         taalName?: string | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
+        laySpeeds?: {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        } | undefined;
         raag?: string | undefined;
         avartan?: number | undefined;
         notationBy?: string | undefined;
@@ -445,24 +518,35 @@ declare const swaralipiSchema: z.ZodObject<{
         rows: z.ZodArray<z.ZodObject<{
             /** Optional line label (e.g. a tuk/section marker). */
             label: z.ZodOptional<z.ZodString>;
+            /**
+             * লয়: the tempo tier this row switches to, held until another row changes
+             * it (absent on every row = the whole song at `meta.bpm`, i.e. দ্রুত).
+             * Read it with `rowLay()`, which also picks up the mark NLTR *prints*
+             * ("বিলম্বিত লয়:") in already-converted documents.
+             */
+            lay: z.ZodOptional<z.ZodEnum<["drut", "madhya", "vilambit"]>>;
             notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
         }, "strip", z.ZodTypeAny, {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }, {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         rows: {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }[];
         name?: string | undefined;
     }, {
         rows: {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }[];
         name?: string | undefined;
     }>, "many">;
@@ -483,6 +567,11 @@ declare const swaralipiSchema: z.ZodObject<{
         taalName?: string | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
+        laySpeeds?: {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        } | undefined;
         raag?: string | undefined;
         avartan?: number | undefined;
         notationBy?: string | undefined;
@@ -492,6 +581,7 @@ declare const swaralipiSchema: z.ZodObject<{
         rows: {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }[];
         name?: string | undefined;
     }[];
@@ -512,6 +602,11 @@ declare const swaralipiSchema: z.ZodObject<{
         taalName?: string | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
+        laySpeeds?: {
+            drut?: number | undefined;
+            madhya?: number | undefined;
+            vilambit?: number | undefined;
+        } | undefined;
         raag?: string | undefined;
         avartan?: number | undefined;
         notationBy?: string | undefined;
@@ -521,10 +616,11 @@ declare const swaralipiSchema: z.ZodObject<{
         rows: {
             notes: Note[];
             label?: string | undefined;
+            lay?: "drut" | "madhya" | "vilambit" | undefined;
         }[];
         name?: string | undefined;
     }[];
 }>;
 type Swaralipi = z.infer<typeof swaralipiSchema>;
 
-export { type Bar as B, type Grace as G, type Meta as M, type Note as N, type Octave as O, type Part as P, type Row as R, type Swaralipi as S, type Taal as T, type SvaraLetter as a, type Bracket as b, type Microtone as c, type Svara as d, barSchema as e, bracketSchema as f, graceSchema as g, microtoneSchema as h, svaraSchema as i, swaralipiSchema as j, metaSchema as m, noteSchema as n, octaveSchema as o, partSchema as p, rowSchema as r, svaraLetterSchema as s, taalSchema as t };
+export { type Bar as B, type Grace as G, type Meta as M, type Note as N, type Octave as O, type Part as P, type Row as R, type Swaralipi as S, type Taal as T, type SvaraLetter as a, type Bracket as b, type Microtone as c, type Svara as d, barSchema as e, bracketSchema as f, graceSchema as g, microtoneSchema as h, svaraSchema as i, swaralipiSchema as j, laySchema as l, metaSchema as m, noteSchema as n, octaveSchema as o, partSchema as p, rowSchema as r, svaraLetterSchema as s, taalSchema as t };