@ugfoundation/swaralipi-js 0.8.1 → 0.9.0

package/dist/{schedule-B_UaluBi.d.cts → schedule-9uvjnCG_.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;
@@ -176,10 +176,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 +190,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 +208,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 {
@@ -274,4 +279,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, 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, type TempoSegment 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_BPMS as h, TABLA_VARIATIONS as i, TONEJS_INSTRUMENTS_BASE 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-CdILTNsk.d.ts → schedule-TxSfHL-T.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;
@@ -176,10 +176,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 +190,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 +208,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 {
@@ -274,4 +279,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, 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, type TempoSegment 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_BPMS as h, TABLA_VARIATIONS as i, TONEJS_INSTRUMENTS_BASE 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-DGA_bNVZ.d.ts → schema-Cf_epUIC.d.cts}

@@ -125,6 +125,57 @@ 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"]>;
+/**
+ * Taal definition. `numBeats` is the cycle length in মাত্রা; `bhaags` (if
+ * present) must sum to `numBeats`; `sam`/`khaali` are 0-based beat indices.
+ */
+declare const taalSchema: z.ZodEffects<z.ZodObject<{
+    /** Player sample key, e.g. `dadra`, `teentaal`. */
+    id: z.ZodString;
+    /**
+     * Which tabla loop variation to play, e.g. `pro` (CDN dir suffix). Optional
+     * and additive — omitted means the taal's default variation, so existing
+     * docs are unaffected. The player honors it but never exposes a variation
+     * picker; selecting a non-default variation is the consumer's premium policy.
+     */
+    variation: z.ZodOptional<z.ZodString>;
+    numBeats: z.ZodNumber;
+    /** Vibhag groupings; if given, they sum to numBeats. */
+    bhaags: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    /** Sam (cycle start) beat index, 0-based. */
+    sam: z.ZodOptional<z.ZodNumber>;
+    /** Khaali (wave) beat indices, 0-based. */
+    khaali: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    numBeats: number;
+    variation?: string | undefined;
+    bhaags?: number[] | undefined;
+    sam?: number | undefined;
+    khaali?: number[] | undefined;
+}, {
+    id: string;
+    numBeats: number;
+    variation?: string | undefined;
+    bhaags?: number[] | undefined;
+    sam?: number | undefined;
+    khaali?: number[] | undefined;
+}>, {
+    id: string;
+    numBeats: number;
+    variation?: string | undefined;
+    bhaags?: number[] | undefined;
+    sam?: number | undefined;
+    khaali?: number[] | undefined;
+}, {
+    id: string;
+    numBeats: number;
+    variation?: string | undefined;
+    bhaags?: number[] | undefined;
+    sam?: number | undefined;
+    khaali?: number[] | undefined;
+}>;
+type Taal = z.infer<typeof taalSchema>;
 /** 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). */
@@ -136,15 +187,87 @@ declare const rowSchema: z.ZodObject<{
      * ("বিলম্বিত লয়:") in already-converted documents.
      */
     lay: z.ZodOptional<z.ZodEnum<["drut", "madhya", "vilambit"]>>;
+    /**
+     * তালফেরতা: the তাল this row switches to, held until another row changes it
+     * (absent on every row = the whole song in `meta.taal`). `null` = মুক্তছন্দ
+     * from here on: the accompaniment rests until a later row names a taal.
+     * Independent of `lay` — either, both or neither may change on one row.
+     */
+    taal: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodObject<{
+        /** Player sample key, e.g. `dadra`, `teentaal`. */
+        id: z.ZodString;
+        /**
+         * Which tabla loop variation to play, e.g. `pro` (CDN dir suffix). Optional
+         * and additive — omitted means the taal's default variation, so existing
+         * docs are unaffected. The player honors it but never exposes a variation
+         * picker; selecting a non-default variation is the consumer's premium policy.
+         */
+        variation: z.ZodOptional<z.ZodString>;
+        numBeats: z.ZodNumber;
+        /** Vibhag groupings; if given, they sum to numBeats. */
+        bhaags: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        /** Sam (cycle start) beat index, 0-based. */
+        sam: z.ZodOptional<z.ZodNumber>;
+        /** Khaali (wave) beat indices, 0-based. */
+        khaali: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        numBeats: number;
+        variation?: string | undefined;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    }, {
+        id: string;
+        numBeats: number;
+        variation?: string | undefined;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    }>, {
+        id: string;
+        numBeats: number;
+        variation?: string | undefined;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    }, {
+        id: string;
+        numBeats: number;
+        variation?: string | undefined;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    }>>>;
+    /** That taal's name as printed (e.g. `ষষ্ঠী(২/৪)`) — `meta.taalName`'s twin. */
+    taalName: z.ZodOptional<z.ZodString>;
     notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
 }, "strip", z.ZodTypeAny, {
     notes: Note[];
     label?: string | undefined;
     lay?: "drut" | "madhya" | "vilambit" | undefined;
+    taal?: {
+        id: string;
+        numBeats: number;
+        variation?: string | undefined;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    } | null | undefined;
+    taalName?: string | undefined;
 }, {
     notes: Note[];
     label?: string | undefined;
     lay?: "drut" | "madhya" | "vilambit" | undefined;
+    taal?: {
+        id: string;
+        numBeats: number;
+        variation?: string | undefined;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    } | null | undefined;
+    taalName?: string | undefined;
 }>;
 type Row = z.infer<typeof rowSchema>;
 /** A structural section: আস্থায়ী / অন্তরা / সঞ্চারী / আভোগ, or free text. */
@@ -160,21 +283,102 @@ declare const partSchema: z.ZodObject<{
          * ("বিলম্বিত লয়:") in already-converted documents.
          */
         lay: z.ZodOptional<z.ZodEnum<["drut", "madhya", "vilambit"]>>;
+        /**
+         * তালফেরতা: the তাল this row switches to, held until another row changes it
+         * (absent on every row = the whole song in `meta.taal`). `null` = মুক্তছন্দ
+         * from here on: the accompaniment rests until a later row names a taal.
+         * Independent of `lay` — either, both or neither may change on one row.
+         */
+        taal: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodObject<{
+            /** Player sample key, e.g. `dadra`, `teentaal`. */
+            id: z.ZodString;
+            /**
+             * Which tabla loop variation to play, e.g. `pro` (CDN dir suffix). Optional
+             * and additive — omitted means the taal's default variation, so existing
+             * docs are unaffected. The player honors it but never exposes a variation
+             * picker; selecting a non-default variation is the consumer's premium policy.
+             */
+            variation: z.ZodOptional<z.ZodString>;
+            numBeats: z.ZodNumber;
+            /** Vibhag groupings; if given, they sum to numBeats. */
+            bhaags: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            /** Sam (cycle start) beat index, 0-based. */
+            sam: z.ZodOptional<z.ZodNumber>;
+            /** Khaali (wave) beat indices, 0-based. */
+            khaali: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            numBeats: number;
+            variation?: string | undefined;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        }, {
+            id: string;
+            numBeats: number;
+            variation?: string | undefined;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        }>, {
+            id: string;
+            numBeats: number;
+            variation?: string | undefined;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        }, {
+            id: string;
+            numBeats: number;
+            variation?: string | undefined;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        }>>>;
+        /** That taal's name as printed (e.g. `ষষ্ঠী(২/৪)`) — `meta.taalName`'s twin. */
+        taalName: z.ZodOptional<z.ZodString>;
         notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
     }, "strip", z.ZodTypeAny, {
         notes: Note[];
         label?: string | undefined;
         lay?: "drut" | "madhya" | "vilambit" | undefined;
+        taal?: {
+            id: string;
+            numBeats: number;
+            variation?: string | undefined;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        } | null | undefined;
+        taalName?: string | undefined;
     }, {
         notes: Note[];
         label?: string | undefined;
         lay?: "drut" | "madhya" | "vilambit" | undefined;
+        taal?: {
+            id: string;
+            numBeats: number;
+            variation?: string | undefined;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        } | null | undefined;
+        taalName?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     rows: {
         notes: Note[];
         label?: string | undefined;
         lay?: "drut" | "madhya" | "vilambit" | undefined;
+        taal?: {
+            id: string;
+            numBeats: number;
+            variation?: string | undefined;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        } | null | undefined;
+        taalName?: string | undefined;
     }[];
     name?: string | undefined;
 }, {
@@ -182,61 +386,19 @@ declare const partSchema: z.ZodObject<{
         notes: Note[];
         label?: string | undefined;
         lay?: "drut" | "madhya" | "vilambit" | undefined;
+        taal?: {
+            id: string;
+            numBeats: number;
+            variation?: string | undefined;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        } | null | undefined;
+        taalName?: string | undefined;
     }[];
     name?: string | undefined;
 }>;
 type Part = z.infer<typeof partSchema>;
-/**
- * Taal definition. `numBeats` is the cycle length in মাত্রা; `bhaags` (if
- * present) must sum to `numBeats`; `sam`/`khaali` are 0-based beat indices.
- */
-declare const taalSchema: z.ZodEffects<z.ZodObject<{
-    /** Player sample key, e.g. `dadra`, `teentaal`. */
-    id: z.ZodString;
-    /**
-     * Which tabla loop variation to play, e.g. `pro` (CDN dir suffix). Optional
-     * and additive — omitted means the taal's default variation, so existing
-     * docs are unaffected. The player honors it but never exposes a variation
-     * picker; selecting a non-default variation is the consumer's premium policy.
-     */
-    variation: z.ZodOptional<z.ZodString>;
-    numBeats: z.ZodNumber;
-    /** Vibhag groupings; if given, they sum to numBeats. */
-    bhaags: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-    /** Sam (cycle start) beat index, 0-based. */
-    sam: z.ZodOptional<z.ZodNumber>;
-    /** Khaali (wave) beat indices, 0-based. */
-    khaali: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    numBeats: number;
-    variation?: string | undefined;
-    bhaags?: number[] | undefined;
-    sam?: number | undefined;
-    khaali?: number[] | undefined;
-}, {
-    id: string;
-    numBeats: number;
-    variation?: string | undefined;
-    bhaags?: number[] | undefined;
-    sam?: number | undefined;
-    khaali?: number[] | undefined;
-}>, {
-    id: string;
-    numBeats: number;
-    variation?: string | undefined;
-    bhaags?: number[] | undefined;
-    sam?: number | undefined;
-    khaali?: number[] | undefined;
-}, {
-    id: string;
-    numBeats: number;
-    variation?: string | undefined;
-    bhaags?: number[] | undefined;
-    sam?: number | undefined;
-    khaali?: number[] | undefined;
-}>;
-type Taal = z.infer<typeof taalSchema>;
 /** Document-level metadata. */
 declare const metaSchema: z.ZodObject<{
     title: z.ZodString;
@@ -326,8 +488,6 @@ declare const metaSchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     title: string;
-    songId?: string | undefined;
-    nltrId?: number | undefined;
     taal?: {
         id: string;
         numBeats: number;
@@ -337,6 +497,8 @@ declare const metaSchema: z.ZodObject<{
         khaali?: number[] | undefined;
     } | undefined;
     taalName?: string | undefined;
+    songId?: string | undefined;
+    nltrId?: number | undefined;
     tonic?: string | undefined;
     bpm?: number | null | undefined;
     laySpeeds?: {
@@ -350,8 +512,6 @@ declare const metaSchema: z.ZodObject<{
     source?: string | undefined;
 }, {
     title: string;
-    songId?: string | undefined;
-    nltrId?: number | undefined;
     taal?: {
         id: string;
         numBeats: number;
@@ -361,6 +521,8 @@ declare const metaSchema: z.ZodObject<{
         khaali?: number[] | undefined;
     } | undefined;
     taalName?: string | undefined;
+    songId?: string | undefined;
+    nltrId?: number | undefined;
     tonic?: string | undefined;
     bpm?: number | null | undefined;
     laySpeeds?: {
@@ -466,8 +628,6 @@ declare const swaralipiSchema: z.ZodObject<{
         source: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         title: string;
-        songId?: string | undefined;
-        nltrId?: number | undefined;
         taal?: {
             id: string;
             numBeats: number;
@@ -477,6 +637,8 @@ declare const swaralipiSchema: z.ZodObject<{
             khaali?: number[] | undefined;
         } | undefined;
         taalName?: string | undefined;
+        songId?: string | undefined;
+        nltrId?: number | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
         laySpeeds?: {
@@ -490,8 +652,6 @@ declare const swaralipiSchema: z.ZodObject<{
         source?: string | undefined;
     }, {
         title: string;
-        songId?: string | undefined;
-        nltrId?: number | undefined;
         taal?: {
             id: string;
             numBeats: number;
@@ -501,6 +661,8 @@ declare const swaralipiSchema: z.ZodObject<{
             khaali?: number[] | undefined;
         } | undefined;
         taalName?: string | undefined;
+        songId?: string | undefined;
+        nltrId?: number | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
         laySpeeds?: {
@@ -525,21 +687,102 @@ declare const swaralipiSchema: z.ZodObject<{
              * ("বিলম্বিত লয়:") in already-converted documents.
              */
             lay: z.ZodOptional<z.ZodEnum<["drut", "madhya", "vilambit"]>>;
+            /**
+             * তালফেরতা: the তাল this row switches to, held until another row changes it
+             * (absent on every row = the whole song in `meta.taal`). `null` = মুক্তছন্দ
+             * from here on: the accompaniment rests until a later row names a taal.
+             * Independent of `lay` — either, both or neither may change on one row.
+             */
+            taal: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodObject<{
+                /** Player sample key, e.g. `dadra`, `teentaal`. */
+                id: z.ZodString;
+                /**
+                 * Which tabla loop variation to play, e.g. `pro` (CDN dir suffix). Optional
+                 * and additive — omitted means the taal's default variation, so existing
+                 * docs are unaffected. The player honors it but never exposes a variation
+                 * picker; selecting a non-default variation is the consumer's premium policy.
+                 */
+                variation: z.ZodOptional<z.ZodString>;
+                numBeats: z.ZodNumber;
+                /** Vibhag groupings; if given, they sum to numBeats. */
+                bhaags: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+                /** Sam (cycle start) beat index, 0-based. */
+                sam: z.ZodOptional<z.ZodNumber>;
+                /** Khaali (wave) beat indices, 0-based. */
+                khaali: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                numBeats: number;
+                variation?: string | undefined;
+                bhaags?: number[] | undefined;
+                sam?: number | undefined;
+                khaali?: number[] | undefined;
+            }, {
+                id: string;
+                numBeats: number;
+                variation?: string | undefined;
+                bhaags?: number[] | undefined;
+                sam?: number | undefined;
+                khaali?: number[] | undefined;
+            }>, {
+                id: string;
+                numBeats: number;
+                variation?: string | undefined;
+                bhaags?: number[] | undefined;
+                sam?: number | undefined;
+                khaali?: number[] | undefined;
+            }, {
+                id: string;
+                numBeats: number;
+                variation?: string | undefined;
+                bhaags?: number[] | undefined;
+                sam?: number | undefined;
+                khaali?: number[] | undefined;
+            }>>>;
+            /** That taal's name as printed (e.g. `ষষ্ঠী(২/৪)`) — `meta.taalName`'s twin. */
+            taalName: z.ZodOptional<z.ZodString>;
             notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
         }, "strip", z.ZodTypeAny, {
             notes: Note[];
             label?: string | undefined;
             lay?: "drut" | "madhya" | "vilambit" | undefined;
+            taal?: {
+                id: string;
+                numBeats: number;
+                variation?: string | undefined;
+                bhaags?: number[] | undefined;
+                sam?: number | undefined;
+                khaali?: number[] | undefined;
+            } | null | undefined;
+            taalName?: string | undefined;
         }, {
             notes: Note[];
             label?: string | undefined;
             lay?: "drut" | "madhya" | "vilambit" | undefined;
+            taal?: {
+                id: string;
+                numBeats: number;
+                variation?: string | undefined;
+                bhaags?: number[] | undefined;
+                sam?: number | undefined;
+                khaali?: number[] | undefined;
+            } | null | undefined;
+            taalName?: string | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         rows: {
             notes: Note[];
             label?: string | undefined;
             lay?: "drut" | "madhya" | "vilambit" | undefined;
+            taal?: {
+                id: string;
+                numBeats: number;
+                variation?: string | undefined;
+                bhaags?: number[] | undefined;
+                sam?: number | undefined;
+                khaali?: number[] | undefined;
+            } | null | undefined;
+            taalName?: string | undefined;
         }[];
         name?: string | undefined;
     }, {
@@ -547,6 +790,15 @@ declare const swaralipiSchema: z.ZodObject<{
             notes: Note[];
             label?: string | undefined;
             lay?: "drut" | "madhya" | "vilambit" | undefined;
+            taal?: {
+                id: string;
+                numBeats: number;
+                variation?: string | undefined;
+                bhaags?: number[] | undefined;
+                sam?: number | undefined;
+                khaali?: number[] | undefined;
+            } | null | undefined;
+            taalName?: string | undefined;
         }[];
         name?: string | undefined;
     }>, "many">;
@@ -554,8 +806,6 @@ declare const swaralipiSchema: z.ZodObject<{
     version: string;
     meta: {
         title: string;
-        songId?: string | undefined;
-        nltrId?: number | undefined;
         taal?: {
             id: string;
             numBeats: number;
@@ -565,6 +815,8 @@ declare const swaralipiSchema: z.ZodObject<{
             khaali?: number[] | undefined;
         } | undefined;
         taalName?: string | undefined;
+        songId?: string | undefined;
+        nltrId?: number | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
         laySpeeds?: {
@@ -582,6 +834,15 @@ declare const swaralipiSchema: z.ZodObject<{
             notes: Note[];
             label?: string | undefined;
             lay?: "drut" | "madhya" | "vilambit" | undefined;
+            taal?: {
+                id: string;
+                numBeats: number;
+                variation?: string | undefined;
+                bhaags?: number[] | undefined;
+                sam?: number | undefined;
+                khaali?: number[] | undefined;
+            } | null | undefined;
+            taalName?: string | undefined;
         }[];
         name?: string | undefined;
     }[];
@@ -589,8 +850,6 @@ declare const swaralipiSchema: z.ZodObject<{
     version: string;
     meta: {
         title: string;
-        songId?: string | undefined;
-        nltrId?: number | undefined;
         taal?: {
             id: string;
             numBeats: number;
@@ -600,6 +859,8 @@ declare const swaralipiSchema: z.ZodObject<{
             khaali?: number[] | undefined;
         } | undefined;
         taalName?: string | undefined;
+        songId?: string | undefined;
+        nltrId?: number | undefined;
         tonic?: string | undefined;
         bpm?: number | null | undefined;
         laySpeeds?: {
@@ -617,6 +878,15 @@ declare const swaralipiSchema: z.ZodObject<{
             notes: Note[];
             label?: string | undefined;
             lay?: "drut" | "madhya" | "vilambit" | undefined;
+            taal?: {
+                id: string;
+                numBeats: number;
+                variation?: string | undefined;
+                bhaags?: number[] | undefined;
+                sam?: number | undefined;
+                khaali?: number[] | undefined;
+            } | null | undefined;
+            taalName?: string | undefined;
         }[];
         name?: string | undefined;
     }[];