@ugfoundation/swaralipi-js 0.8.2 → 0.9.1

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

@@ -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;
     }[];

package/dist/spec/index.cjs

@@ -53,22 +53,6 @@ var noteSchema = zod.z.lazy(
   )
 );
 var laySchema = zod.z.enum(["drut", "madhya", "vilambit"]);
-var rowSchema = zod.z.object({
-  /** Optional line label (e.g. a tuk/section marker). */
-  label: zod.z.string().optional(),
-  /**
-   * লয়: 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: laySchema.optional(),
-  notes: zod.z.array(noteSchema)
-});
-var partSchema = zod.z.object({
-  name: zod.z.string().optional(),
-  rows: zod.z.array(rowSchema)
-});
 var taalSchema = zod.z.object({
   /** Player sample key, e.g. `dadra`, `teentaal`. */
   id: zod.z.string(),
@@ -89,6 +73,31 @@ var taalSchema = zod.z.object({
 }).refine((t) => t.bhaags === void 0 || t.bhaags.reduce((a, b) => a + b, 0) === t.numBeats, {
   message: "bhaags must sum to numBeats"
 });
+var rowSchema = zod.z.object({
+  /** Optional line label (e.g. a tuk/section marker). */
+  label: zod.z.string().optional(),
+  /**
+   * লয়: 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: laySchema.optional(),
+  /**
+   * তালফেরতা: 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: taalSchema.nullable().optional(),
+  /** That taal's name as printed (e.g. `ষষ্ঠী(২/৪)`) — `meta.taalName`'s twin. */
+  taalName: zod.z.string().optional(),
+  notes: zod.z.array(noteSchema)
+});
+var partSchema = zod.z.object({
+  name: zod.z.string().optional(),
+  rows: zod.z.array(rowSchema)
+});
 var metaSchema = zod.z.object({
   title: zod.z.string(),
   /** Cross-reference to a gitabitan.io song content id (filename, immutable). */
@@ -148,6 +157,15 @@ var TAALS = {
   dhamaar: { id: "dhamaar", numBeats: 14, bhaags: [5, 2, 3, 4], sam: 0, khaali: [7] }
   // ধামার
 };
+var TAAL_FERTA = "\u09A4\u09BE\u09B2\u09AB\u09C7\u09B0\u09A4\u09BE";
+function isTaalFerta(name) {
+  return name !== void 0 && name.normalize("NFC").replace(/[\s-]/g, "") === TAAL_FERTA;
+}
+function sameTaal(a, b) {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  return a.id === b.id && a.numBeats === b.numBeats && a.variation === b.variation && String(a.bhaags) === String(b.bhaags);
+}
 
 // src/spec/grace.ts
 function graceNotes(grace) {
@@ -185,7 +203,7 @@ function hasTivra(letter) {
 }
 
 // src/spec/index.ts
-var SPEC_VERSION = "0.8.2";
+var SPEC_VERSION = "0.9.1";
 function parseSwaralipi(data) {
   return swaralipiSchema.parse(data);
 }
@@ -197,12 +215,14 @@ exports.LAYS = LAYS;
 exports.LAY_SPEEDS = LAY_SPEEDS;
 exports.SPEC_VERSION = SPEC_VERSION;
 exports.TAALS = TAALS;
+exports.TAAL_FERTA = TAAL_FERTA;
 exports.barSchema = barSchema;
 exports.bracketSchema = bracketSchema;
 exports.graceNotes = graceNotes;
 exports.graceSchema = graceSchema;
 exports.hasKomal = hasKomal;
 exports.hasTivra = hasTivra;
+exports.isTaalFerta = isTaalFerta;
 exports.laySchema = laySchema;
 exports.metaSchema = metaSchema;
 exports.microtoneSchema = microtoneSchema;
@@ -215,6 +235,7 @@ exports.resolveLaySpeeds = resolveLaySpeeds;
 exports.rowLay = rowLay;
 exports.rowSchema = rowSchema;
 exports.safeParseSwaralipi = safeParseSwaralipi;
+exports.sameTaal = sameTaal;
 exports.svaraLetterSchema = svaraLetterSchema;
 exports.svaraSchema = svaraSchema;
 exports.swaralipiSchema = swaralipiSchema;