@ugfoundation/swaralipi-js 0.1.0

package/dist/schema-gxhG45OK.d.ts

@@ -0,0 +1,467 @@
+import { z } from 'zod';
+
+/**
+ * swaralipi-js JSON spec — Zod schema + inferred types.
+
+/** Octave registers */
+declare const octaveSchema: z.ZodEnum<["ati-mandra", "mandra", "madhyam", "taar", "ati-taar"]>;
+type Octave = z.infer<typeof octaveSchema>;
+/**
+ * The seven shuddha svara letters:
+ * `d` = ধৈবত (dha), `n` = নিষাদ (ni). Komal/tivra are flags, not letters.
+ */
+declare const svaraLetterSchema: z.ZodEnum<["s", "r", "g", "m", "p", "d", "n"]>;
+type SvaraLetter = z.infer<typeof svaraLetterSchema>;
+/** A pitch as `[octave, letter]` */
+declare const svaraSchema: z.ZodTuple<[z.ZodEnum<["ati-mandra", "mandra", "madhyam", "taar", "ati-taar"]>, z.ZodEnum<["s", "r", "g", "m", "p", "d", "n"]>], null>;
+type Svara = z.infer<typeof svaraSchema>;
+/** Microtone variants below komal (legend: অল্পকোমল / অতিকোমল). */
+declare const microtoneSchema: z.ZodEnum<["alpakomal", "atikomal"]>;
+type Microtone = z.infer<typeof microtoneSchema>;
+/**
+ * Barline weights. Swarabitan distinguishes the light দাঁড়ি (।) that
+ * separates vibhags *within* a taal cycle from the দণ্ড (danda, I) strokes:
+ *  - `dari`   — । vibhag separator inside the cycle
+ *  - `single` — I  end of one taal cycle (ফেরা)
+ *  - `double` — II section (kali) boundary / return-to-asthayi marker
+ *  - `quad`   — IIII end of the song
+ */
+declare const barSchema: z.ZodEnum<["dari", "single", "double", "quad"]>;
+type Bar = z.infer<typeof barSchema>;
+/**
+ * A repeat-bracket edge. Brackets span a range of notes; the opening note
+ * carries `{ ..., edge: 'open' }` and the closing note `{ ..., edge: 'close' }`.
+ * kind: `repeat` = {} গুন্ডবন্ধনী, `skip` = () বক্রবন্ধনী (omit on repeat),
+ *       `alt` = [] সরল বন্ধনী (changed notes on repeat).
+ */
+declare const bracketSchema: z.ZodObject<{
+    kind: z.ZodEnum<["repeat", "skip", "alt"]>;
+    edge: z.ZodEnum<["open", "close"]>;
+}, "strip", z.ZodTypeAny, {
+    kind: "repeat" | "skip" | "alt";
+    edge: "open" | "close";
+}, {
+    kind: "repeat" | "skip" | "alt";
+    edge: "open" | "close";
+}>;
+type Bracket = z.infer<typeof bracketSchema>;
+/**
+ * A single token in a row. A token is one of: a pitched note (`svara`),
+ * a rest (`rest`), an আ-কার sustain (`sustain`), a barline (`bar`), or a
+ * purely raw/undecoded cell (`raw`) — possibly carrying annotations
+ * (`above`/`below`) or a lyric syllable on an otherwise empty column.
+ * The `.refine` enforces that a note carries at least one of these so
+ * truly empty tokens can't slip through.
+ *
+ * `above`/`below` make `Note` recursive, so the type is hand-written and
+ * the schema is typed `z.ZodType<Note>` via `z.lazy` (all fields are
+ * optional, hence input ≡ output and the annotation is sound).
+ */
+interface Note {
+    /** Pitch. Omitted for rests, sustains, and barlines. */
+    svara?: Svara;
+    /** কোমল (flat). */
+    komal?: boolean;
+    /** তীব্র / কড়ি (sharp — applies to ma). */
+    tivra?: boolean;
+    /** Sub-komal microtone (legend: অল্পকোমল / অতিকোমল). */
+    microtone?: Microtone;
+    /** Duration in মাত্রা (beats): 1 (default), 0.5, 0.25, 2, … */
+    durationMatra?: number;
+    /**
+     * আ-কার: no new syllable attack. Alone (no `svara`) it holds the previous
+     * note's pitch and vowel; combined with `svara` it is a melisma — the
+     * pitch moves while the previous syllable's vowel continues (Swarabitan
+     * writes these with a leading hyphen, e.g. `-sfa`).
+     */
+    sustain?: boolean;
+    /** বিরাম: a rest of `durationMatra` beats. */
+    rest?: boolean;
+    /** কণ স্বর: a grace note attached before this note. */
+    kan?: Svara;
+    /** মীড় (glide/slur) endpoint. */
+    meend?: 'start' | 'end';
+    /** Barline. A bar token usually has no `svara`. */
+    bar?: Bar;
+    /** Repeat-bracket edges opening/closing on this token. */
+    brackets?: Bracket[];
+    /** Lyric syllable aligned under this note */
+    lyric?: string;
+    /** Lossless passthrough of the source cell (e.g. raw Swarabitan code). */
+    raw?: string;
+    /**
+     * Annotation notes rendered above this column: alt-on-repeat passages
+     * (legend: পরিবর্তিত স্বর in [ ] শিরোদেশে), stop marks, beat numbers.
+     */
+    above?: Note[];
+    /** Annotation notes rendered below this column. */
+    below?: Note[];
+}
+declare const noteSchema: z.ZodType<Note>;
+/** 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>;
+    notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
+}, "strip", z.ZodTypeAny, {
+    notes: Note[];
+    label?: string | undefined;
+}, {
+    notes: Note[];
+    label?: string | undefined;
+}>;
+type Row = z.infer<typeof rowSchema>;
+/** A structural section: আস্থায়ী / অন্তরা / সঞ্চারী / আভোগ, or free text. */
+declare const partSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    rows: z.ZodArray<z.ZodObject<{
+        /** Optional line label (e.g. a tuk/section marker). */
+        label: z.ZodOptional<z.ZodString>;
+        notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        notes: Note[];
+        label?: string | undefined;
+    }, {
+        notes: Note[];
+        label?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    rows: {
+        notes: Note[];
+        label?: string | undefined;
+    }[];
+    name?: string | undefined;
+}, {
+    rows: {
+        notes: Note[];
+        label?: 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;
+    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;
+    bhaags?: number[] | undefined;
+    sam?: number | undefined;
+    khaali?: number[] | undefined;
+}, {
+    id: string;
+    numBeats: number;
+    bhaags?: number[] | undefined;
+    sam?: number | undefined;
+    khaali?: number[] | undefined;
+}>, {
+    id: string;
+    numBeats: number;
+    bhaags?: number[] | undefined;
+    sam?: number | undefined;
+    khaali?: number[] | undefined;
+}, {
+    id: string;
+    numBeats: number;
+    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;
+    /** Cross-reference to a gitabitan.io song content id (filename, immutable). */
+    songId: z.ZodOptional<z.ZodString>;
+    /** Source NLTR node/song id. */
+    nltrId: z.ZodOptional<z.ZodNumber>;
+    taal: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        /** Player sample key, e.g. `dadra`, `teentaal`. */
+        id: 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;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    }, {
+        id: string;
+        numBeats: number;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    }>, {
+        id: string;
+        numBeats: number;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    }, {
+        id: string;
+        numBeats: number;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    }>>;
+    /**
+     * The taal name exactly as printed in the source (e.g. `তালমুক্ত`,
+     * `ষষ্ঠী(২/৪)`). Always set by the NLTR converter; `taal` is set only
+     * when the name resolves to a known definition.
+     */
+    taalName: z.ZodOptional<z.ZodString>;
+    /** Base pitch for playback, e.g. `C`, `C#`, or the player's `cs` form. */
+    tonic: z.ZodOptional<z.ZodString>;
+    /** Default playback tempo in matra/min. Player-only — the viewer ignores it.
+     * 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>>;
+    raag: z.ZodOptional<z.ZodString>;
+    /** আবর্তন: number of taal cycles, when the source states it. */
+    avartan: z.ZodOptional<z.ZodNumber>;
+    /** স্বরলিপিকার (notation author). */
+    notationBy: z.ZodOptional<z.ZodString>;
+    /** Provenance note or URL. */
+    source: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    songId?: string | undefined;
+    nltrId?: number | undefined;
+    taal?: {
+        id: string;
+        numBeats: number;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    } | undefined;
+    taalName?: string | undefined;
+    tonic?: string | undefined;
+    bpm?: number | null | undefined;
+    raag?: string | undefined;
+    avartan?: number | undefined;
+    notationBy?: string | undefined;
+    source?: string | undefined;
+}, {
+    title: string;
+    songId?: string | undefined;
+    nltrId?: number | undefined;
+    taal?: {
+        id: string;
+        numBeats: number;
+        bhaags?: number[] | undefined;
+        sam?: number | undefined;
+        khaali?: number[] | undefined;
+    } | undefined;
+    taalName?: string | undefined;
+    tonic?: string | undefined;
+    bpm?: number | null | undefined;
+    raag?: string | undefined;
+    avartan?: number | undefined;
+    notationBy?: string | undefined;
+    source?: string | undefined;
+}>;
+type Meta = z.infer<typeof metaSchema>;
+/** A complete swaralipi document. */
+declare const swaralipiSchema: z.ZodObject<{
+    /** Spec version this document targets (see SPEC_VERSION in ./index). */
+    version: z.ZodString;
+    meta: z.ZodObject<{
+        title: z.ZodString;
+        /** Cross-reference to a gitabitan.io song content id (filename, immutable). */
+        songId: z.ZodOptional<z.ZodString>;
+        /** Source NLTR node/song id. */
+        nltrId: z.ZodOptional<z.ZodNumber>;
+        taal: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            /** Player sample key, e.g. `dadra`, `teentaal`. */
+            id: 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;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        }, {
+            id: string;
+            numBeats: number;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        }>, {
+            id: string;
+            numBeats: number;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        }, {
+            id: string;
+            numBeats: number;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        }>>;
+        /**
+         * The taal name exactly as printed in the source (e.g. `তালমুক্ত`,
+         * `ষষ্ঠী(২/৪)`). Always set by the NLTR converter; `taal` is set only
+         * when the name resolves to a known definition.
+         */
+        taalName: z.ZodOptional<z.ZodString>;
+        /** Base pitch for playback, e.g. `C`, `C#`, or the player's `cs` form. */
+        tonic: z.ZodOptional<z.ZodString>;
+        /** Default playback tempo in matra/min. Player-only — the viewer ignores it.
+         * 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>>;
+        raag: z.ZodOptional<z.ZodString>;
+        /** আবর্তন: number of taal cycles, when the source states it. */
+        avartan: z.ZodOptional<z.ZodNumber>;
+        /** স্বরলিপিকার (notation author). */
+        notationBy: z.ZodOptional<z.ZodString>;
+        /** Provenance note or URL. */
+        source: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        songId?: string | undefined;
+        nltrId?: number | undefined;
+        taal?: {
+            id: string;
+            numBeats: number;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        } | undefined;
+        taalName?: string | undefined;
+        tonic?: string | undefined;
+        bpm?: number | null | undefined;
+        raag?: string | undefined;
+        avartan?: number | undefined;
+        notationBy?: string | undefined;
+        source?: string | undefined;
+    }, {
+        title: string;
+        songId?: string | undefined;
+        nltrId?: number | undefined;
+        taal?: {
+            id: string;
+            numBeats: number;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        } | undefined;
+        taalName?: string | undefined;
+        tonic?: string | undefined;
+        bpm?: number | null | undefined;
+        raag?: string | undefined;
+        avartan?: number | undefined;
+        notationBy?: string | undefined;
+        source?: string | undefined;
+    }>;
+    parts: z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        rows: z.ZodArray<z.ZodObject<{
+            /** Optional line label (e.g. a tuk/section marker). */
+            label: z.ZodOptional<z.ZodString>;
+            notes: z.ZodArray<z.ZodType<Note, z.ZodTypeDef, Note>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            notes: Note[];
+            label?: string | undefined;
+        }, {
+            notes: Note[];
+            label?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        rows: {
+            notes: Note[];
+            label?: string | undefined;
+        }[];
+        name?: string | undefined;
+    }, {
+        rows: {
+            notes: Note[];
+            label?: string | undefined;
+        }[];
+        name?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    meta: {
+        title: string;
+        songId?: string | undefined;
+        nltrId?: number | undefined;
+        taal?: {
+            id: string;
+            numBeats: number;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        } | undefined;
+        taalName?: string | undefined;
+        tonic?: string | undefined;
+        bpm?: number | null | undefined;
+        raag?: string | undefined;
+        avartan?: number | undefined;
+        notationBy?: string | undefined;
+        source?: string | undefined;
+    };
+    parts: {
+        rows: {
+            notes: Note[];
+            label?: string | undefined;
+        }[];
+        name?: string | undefined;
+    }[];
+}, {
+    version: string;
+    meta: {
+        title: string;
+        songId?: string | undefined;
+        nltrId?: number | undefined;
+        taal?: {
+            id: string;
+            numBeats: number;
+            bhaags?: number[] | undefined;
+            sam?: number | undefined;
+            khaali?: number[] | undefined;
+        } | undefined;
+        taalName?: string | undefined;
+        tonic?: string | undefined;
+        bpm?: number | null | undefined;
+        raag?: string | undefined;
+        avartan?: number | undefined;
+        notationBy?: string | undefined;
+        source?: string | undefined;
+    };
+    parts: {
+        rows: {
+            notes: Note[];
+            label?: string | undefined;
+        }[];
+        name?: string | undefined;
+    }[];
+}>;
+type Swaralipi = z.infer<typeof swaralipiSchema>;
+
+export { type Bar as B, 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, microtoneSchema as g, svaraSchema as h, swaralipiSchema as i, metaSchema as m, noteSchema as n, octaveSchema as o, partSchema as p, rowSchema as r, svaraLetterSchema as s, taalSchema as t };

package/dist/spec/index.cjs

@@ -0,0 +1,143 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/spec/schema.ts
+var octaveSchema = zod.z.enum([
+  "ati-mandra",
+  // very low
+  "mandra",
+  // low (dot below)
+  "madhyam",
+  // middle
+  "taar",
+  // high (ref/dot above)
+  "ati-taar"
+  // very high
+]);
+var svaraLetterSchema = zod.z.enum(["s", "r", "g", "m", "p", "d", "n"]);
+var svaraSchema = zod.z.tuple([octaveSchema, svaraLetterSchema]);
+var microtoneSchema = zod.z.enum(["alpakomal", "atikomal"]);
+var barSchema = zod.z.enum(["dari", "single", "double", "quad"]);
+var bracketSchema = zod.z.object({
+  kind: zod.z.enum(["repeat", "skip", "alt"]),
+  edge: zod.z.enum(["open", "close"])
+});
+var noteSchema = zod.z.lazy(
+  () => zod.z.object({
+    svara: svaraSchema.optional(),
+    komal: zod.z.boolean().optional(),
+    tivra: zod.z.boolean().optional(),
+    microtone: microtoneSchema.optional(),
+    durationMatra: zod.z.number().positive().optional(),
+    sustain: zod.z.boolean().optional(),
+    rest: zod.z.boolean().optional(),
+    kan: svaraSchema.optional(),
+    meend: zod.z.enum(["start", "end"]).optional(),
+    bar: barSchema.optional(),
+    brackets: zod.z.array(bracketSchema).optional(),
+    lyric: zod.z.string().optional(),
+    raw: zod.z.string().optional(),
+    above: zod.z.array(noteSchema).optional(),
+    below: zod.z.array(noteSchema).optional()
+  }).refine(
+    (n) => n.svara !== void 0 || n.rest === true || n.sustain === true || n.bar !== void 0 || n.raw !== void 0 || n.brackets !== void 0 && n.brackets.length > 0 || n.above !== void 0 && n.above.length > 0 || n.below !== void 0 && n.below.length > 0 || n.lyric !== void 0,
+    {
+      message: "note must carry one of: svara, rest, sustain, bar, raw, lyric, brackets, or a non-empty above/below"
+    }
+  )
+);
+var rowSchema = zod.z.object({
+  /** Optional line label (e.g. a tuk/section marker). */
+  label: 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 taalSchema = zod.z.object({
+  /** Player sample key, e.g. `dadra`, `teentaal`. */
+  id: zod.z.string(),
+  numBeats: zod.z.number().int().positive(),
+  /** Vibhag groupings; if given, they sum to numBeats. */
+  bhaags: zod.z.array(zod.z.number().int().positive()).optional(),
+  /** Sam (cycle start) beat index, 0-based. */
+  sam: zod.z.number().int().nonnegative().optional(),
+  /** Khaali (wave) beat indices, 0-based. */
+  khaali: zod.z.array(zod.z.number().int().nonnegative()).optional()
+}).refine((t) => t.bhaags === void 0 || t.bhaags.reduce((a, b) => a + b, 0) === t.numBeats, {
+  message: "bhaags must sum to numBeats"
+});
+var metaSchema = zod.z.object({
+  title: zod.z.string(),
+  /** Cross-reference to a gitabitan.io song content id (filename, immutable). */
+  songId: zod.z.string().optional(),
+  /** Source NLTR node/song id. */
+  nltrId: zod.z.number().int().optional(),
+  taal: taalSchema.optional(),
+  /**
+   * The taal name exactly as printed in the source (e.g. `তালমুক্ত`,
+   * `ষষ্ঠী(২/৪)`). Always set by the NLTR converter; `taal` is set only
+   * when the name resolves to a known definition.
+   */
+  taalName: zod.z.string().optional(),
+  /** Base pitch for playback, e.g. `C`, `C#`, or the player's `cs` form. */
+  tonic: zod.z.string().optional(),
+  /** Default playback tempo in matra/min. Player-only — the viewer ignores it.
+   * The player adopts it on `load()` (precedence: constructor `bpm` → `setBpm`
+   * tweak → this → 90). `null` is the converter's blank placeholder = unset. */
+  bpm: zod.z.number().positive().nullable().optional(),
+  raag: zod.z.string().optional(),
+  /** আবর্তন: number of taal cycles, when the source states it. */
+  avartan: zod.z.number().int().positive().optional(),
+  /** স্বরলিপিকার (notation author). */
+  notationBy: zod.z.string().optional(),
+  /** Provenance note or URL. */
+  source: zod.z.string().optional()
+});
+var swaralipiSchema = zod.z.object({
+  /** Spec version this document targets (see SPEC_VERSION in ./index). */
+  version: zod.z.string(),
+  meta: metaSchema,
+  parts: zod.z.array(partSchema)
+});
+
+// src/spec/taals.ts
+var TAALS = {
+  dadra: { id: "dadra", numBeats: 6, bhaags: [3, 3], sam: 0, khaali: [3] },
+  kehrwa: { id: "kehrwa", numBeats: 8, bhaags: [4, 4], sam: 0, khaali: [4] },
+  rupak: { id: "rupak", numBeats: 7, bhaags: [3, 2, 2], sam: 0, khaali: [0] },
+  jhaptaal: { id: "jhaptaal", numBeats: 10, bhaags: [2, 3, 2, 3], sam: 0, khaali: [5] },
+  ektaal: { id: "ektaal", numBeats: 12, bhaags: [2, 2, 2, 2, 2, 2], sam: 0, khaali: [2, 6] },
+  adachautaal: { id: "adachautaal", numBeats: 14, sam: 0 },
+  teentaal: { id: "teentaal", numBeats: 16, bhaags: [4, 4, 4, 4], sam: 0, khaali: [8] }
+};
+
+// src/spec/index.ts
+var SPEC_VERSION = "0.1.0";
+function parseSwaralipi(data) {
+  return swaralipiSchema.parse(data);
+}
+function safeParseSwaralipi(data) {
+  return swaralipiSchema.safeParse(data);
+}
+
+exports.SPEC_VERSION = SPEC_VERSION;
+exports.TAALS = TAALS;
+exports.barSchema = barSchema;
+exports.bracketSchema = bracketSchema;
+exports.metaSchema = metaSchema;
+exports.microtoneSchema = microtoneSchema;
+exports.noteSchema = noteSchema;
+exports.octaveSchema = octaveSchema;
+exports.parseSwaralipi = parseSwaralipi;
+exports.partSchema = partSchema;
+exports.rowSchema = rowSchema;
+exports.safeParseSwaralipi = safeParseSwaralipi;
+exports.svaraLetterSchema = svaraLetterSchema;
+exports.svaraSchema = svaraSchema;
+exports.swaralipiSchema = swaralipiSchema;
+exports.taalSchema = taalSchema;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/spec/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/spec/schema.ts","../../src/spec/taals.ts","../../src/spec/index.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["import { z } from 'zod';\n\n/**\n * swaralipi-js JSON spec — Zod schema + inferred types.\n\n/** Octave registers */\nexport const octaveSchema = z.enum([\n  'ati-mandra', // very low\n  'mandra', // low (dot below)\n  'madhyam', // middle\n  'taar', // high (ref/dot above)\n  'ati-taar', // very high\n]);\nexport type Octave = z.infer<typeof octaveSchema>;\n\n/**\n * The seven shuddha svara letters:\n * `d` = ধৈবত (dha), `n` = নিষাদ (ni). Komal/tivra are flags, not letters.\n */\nexport const svaraLetterSchema = z.enum(['s', 'r', 'g', 'm', 'p', 'd', 'n']);\nexport type SvaraLetter = z.infer<typeof svaraLetterSchema>;\n\n/** A pitch as `[octave, letter]` */\nexport const svaraSchema = z.tuple([octaveSchema, svaraLetterSchema]);\nexport type Svara = z.infer<typeof svaraSchema>;\n\n/** Microtone variants below komal (legend: অল্পকোমল / অতিকোমল). */\nexport const microtoneSchema = z.enum(['alpakomal', 'atikomal']);\nexport type Microtone = z.infer<typeof microtoneSchema>;\n\n/**\n * Barline weights. Swarabitan distinguishes the light দাঁড়ি (।) that\n * separates vibhags *within* a taal cycle from the দণ্ড (danda, I) strokes:\n *  - `dari`   — । vibhag separator inside the cycle\n *  - `single` — I  end of one taal cycle (ফেরা)\n *  - `double` — II section (kali) boundary / return-to-asthayi marker\n *  - `quad`   — IIII end of the song\n */\nexport const barSchema = z.enum(['dari', 'single', 'double', 'quad']);\nexport type Bar = z.infer<typeof barSchema>;\n\n/**\n * A repeat-bracket edge. Brackets span a range of notes; the opening note\n * carries `{ ..., edge: 'open' }` and the closing note `{ ..., edge: 'close' }`.\n * kind: `repeat` = {} গুন্ডবন্ধনী, `skip` = () বক্রবন্ধনী (omit on repeat),\n *       `alt` = [] সরল বন্ধনী (changed notes on repeat).\n */\nexport const bracketSchema = z.object({\n  kind: z.enum(['repeat', 'skip', 'alt']),\n  edge: z.enum(['open', 'close']),\n});\nexport type Bracket = z.infer<typeof bracketSchema>;\n\n/**\n * A single token in a row. A token is one of: a pitched note (`svara`),\n * a rest (`rest`), an আ-কার sustain (`sustain`), a barline (`bar`), or a\n * purely raw/undecoded cell (`raw`) — possibly carrying annotations\n * (`above`/`below`) or a lyric syllable on an otherwise empty column.\n * The `.refine` enforces that a note carries at least one of these so\n * truly empty tokens can't slip through.\n *\n * `above`/`below` make `Note` recursive, so the type is hand-written and\n * the schema is typed `z.ZodType<Note>` via `z.lazy` (all fields are\n * optional, hence input ≡ output and the annotation is sound).\n */\nexport interface Note {\n  /** Pitch. Omitted for rests, sustains, and barlines. */\n  svara?: Svara;\n  /** কোমল (flat). */\n  komal?: boolean;\n  /** তীব্র / কড়ি (sharp — applies to ma). */\n  tivra?: boolean;\n  /** Sub-komal microtone (legend: অল্পকোমল / অতিকোমল). */\n  microtone?: Microtone;\n  /** Duration in মাত্রা (beats): 1 (default), 0.5, 0.25, 2, … */\n  durationMatra?: number;\n  /**\n   * আ-কার: no new syllable attack. Alone (no `svara`) it holds the previous\n   * note's pitch and vowel; combined with `svara` it is a melisma — the\n   * pitch moves while the previous syllable's vowel continues (Swarabitan\n   * writes these with a leading hyphen, e.g. `-sfa`).\n   */\n  sustain?: boolean;\n  /** বিরাম: a rest of `durationMatra` beats. */\n  rest?: boolean;\n  /** কণ স্বর: a grace note attached before this note. */\n  kan?: Svara;\n  /** মীড় (glide/slur) endpoint. */\n  meend?: 'start' | 'end';\n  /** Barline. A bar token usually has no `svara`. */\n  bar?: Bar;\n  /** Repeat-bracket edges opening/closing on this token. */\n  brackets?: Bracket[];\n  /** Lyric syllable aligned under this note */\n  lyric?: string;\n  /** Lossless passthrough of the source cell (e.g. raw Swarabitan code). */\n  raw?: string;\n  /**\n   * Annotation notes rendered above this column: alt-on-repeat passages\n   * (legend: পরিবর্তিত স্বর in [ ] শিরোদেশে), stop marks, beat numbers.\n   */\n  above?: Note[];\n  /** Annotation notes rendered below this column. */\n  below?: Note[];\n}\n\nexport const noteSchema: z.ZodType<Note> = z.lazy(() =>\n  z\n    .object({\n      svara: svaraSchema.optional(),\n      komal: z.boolean().optional(),\n      tivra: z.boolean().optional(),\n      microtone: microtoneSchema.optional(),\n      durationMatra: z.number().positive().optional(),\n      sustain: z.boolean().optional(),\n      rest: z.boolean().optional(),\n      kan: svaraSchema.optional(),\n      meend: z.enum(['start', 'end']).optional(),\n      bar: barSchema.optional(),\n      brackets: z.array(bracketSchema).optional(),\n      lyric: z.string().optional(),\n      raw: z.string().optional(),\n      above: z.array(noteSchema).optional(),\n      below: z.array(noteSchema).optional(),\n    })\n    .refine(\n      (n) =>\n        n.svara !== undefined ||\n        n.rest === true ||\n        n.sustain === true ||\n        n.bar !== undefined ||\n        n.raw !== undefined ||\n        (n.brackets !== undefined && n.brackets.length > 0) ||\n        (n.above !== undefined && n.above.length > 0) ||\n        (n.below !== undefined && n.below.length > 0) ||\n        n.lyric !== undefined,\n      {\n        message:\n          'note must carry one of: svara, rest, sustain, bar, raw, lyric, brackets, or a non-empty above/below',\n      },\n    ),\n);\n\n/** A written line of the song: a sequence of note tokens. */\nexport const rowSchema = z.object({\n  /** Optional line label (e.g. a tuk/section marker). */\n  label: z.string().optional(),\n  notes: z.array(noteSchema),\n});\nexport type Row = z.infer<typeof rowSchema>;\n\n/** A structural section: আস্থায়ী / অন্তরা / সঞ্চারী / আভোগ, or free text. */\nexport const partSchema = z.object({\n  name: z.string().optional(),\n  rows: z.array(rowSchema),\n});\nexport type Part = z.infer<typeof partSchema>;\n\n/**\n * Taal definition. `numBeats` is the cycle length in মাত্রা; `bhaags` (if\n * present) must sum to `numBeats`; `sam`/`khaali` are 0-based beat indices.\n */\nexport const taalSchema = z\n  .object({\n    /** Player sample key, e.g. `dadra`, `teentaal`. */\n    id: z.string(),\n    numBeats: z.number().int().positive(),\n    /** Vibhag groupings; if given, they sum to numBeats. */\n    bhaags: z.array(z.number().int().positive()).optional(),\n    /** Sam (cycle start) beat index, 0-based. */\n    sam: z.number().int().nonnegative().optional(),\n    /** Khaali (wave) beat indices, 0-based. */\n    khaali: z.array(z.number().int().nonnegative()).optional(),\n  })\n  .refine((t) => t.bhaags === undefined || t.bhaags.reduce((a, b) => a + b, 0) === t.numBeats, {\n    message: 'bhaags must sum to numBeats',\n  });\nexport type Taal = z.infer<typeof taalSchema>;\n\n/** Document-level metadata. */\nexport const metaSchema = z.object({\n  title: z.string(),\n  /** Cross-reference to a gitabitan.io song content id (filename, immutable). */\n  songId: z.string().optional(),\n  /** Source NLTR node/song id. */\n  nltrId: z.number().int().optional(),\n  taal: taalSchema.optional(),\n  /**\n   * The taal name exactly as printed in the source (e.g. `তালমুক্ত`,\n   * `ষষ্ঠী(২/৪)`). Always set by the NLTR converter; `taal` is set only\n   * when the name resolves to a known definition.\n   */\n  taalName: z.string().optional(),\n  /** Base pitch for playback, e.g. `C`, `C#`, or the player's `cs` form. */\n  tonic: z.string().optional(),\n  /** Default playback tempo in matra/min. Player-only — the viewer ignores it.\n   * The player adopts it on `load()` (precedence: constructor `bpm` → `setBpm`\n   * tweak → this → 90). `null` is the converter's blank placeholder = unset. */\n  bpm: z.number().positive().nullable().optional(),\n  raag: z.string().optional(),\n  /** আবর্তন: number of taal cycles, when the source states it. */\n  avartan: z.number().int().positive().optional(),\n  /** স্বরলিপিকার (notation author). */\n  notationBy: z.string().optional(),\n  /** Provenance note or URL. */\n  source: z.string().optional(),\n});\nexport type Meta = z.infer<typeof metaSchema>;\n\n/** A complete swaralipi document. */\nexport const swaralipiSchema = z.object({\n  /** Spec version this document targets (see SPEC_VERSION in ./index). */\n  version: z.string(),\n  meta: metaSchema,\n  parts: z.array(partSchema),\n});\nexport type Swaralipi = z.infer<typeof swaralipiSchema>;\n","import type { Taal } from './schema.js';\n\n/**\n * Reference definitions for the taals the player will sample (P2.3):\n * adachautaal, dadra, ektaal, jhaptaal, kehrwa, rupak, teentaal.\n *\n * `numBeats` and the `bhaags` given below are standard Hindustani taal theory.\n * `bhaags` is omitted where a single canonical division isn't well-agreed\n * (adachautaal) — we assert only what's uncontested. `sam` is beat 0 for all.\n */\nexport const TAALS = {\n  dadra: { id: 'dadra', numBeats: 6, bhaags: [3, 3], sam: 0, khaali: [3] },\n  kehrwa: { id: 'kehrwa', numBeats: 8, bhaags: [4, 4], sam: 0, khaali: [4] },\n  rupak: { id: 'rupak', numBeats: 7, bhaags: [3, 2, 2], sam: 0, khaali: [0] },\n  jhaptaal: { id: 'jhaptaal', numBeats: 10, bhaags: [2, 3, 2, 3], sam: 0, khaali: [5] },\n  ektaal: { id: 'ektaal', numBeats: 12, bhaags: [2, 2, 2, 2, 2, 2], sam: 0, khaali: [2, 6] },\n  adachautaal: { id: 'adachautaal', numBeats: 14, sam: 0 },\n  teentaal: { id: 'teentaal', numBeats: 16, bhaags: [4, 4, 4, 4], sam: 0, khaali: [8] },\n} as const satisfies Record<string, Taal>;\n\nexport type TaalId = keyof typeof TAALS;\n","/**\n * @ugfoundation/swaralipi-js/spec\n *\n * The swaralipi JSON spec: Zod schemas, inferred TS types, and parse helpers.\n */\nimport { swaralipiSchema, type Swaralipi } from './schema.js';\n\n/** Current spec version. Documents declare the version they target. */\nexport const SPEC_VERSION = '0.1.0';\n\nexport {\n  octaveSchema,\n  svaraLetterSchema,\n  svaraSchema,\n  microtoneSchema,\n  barSchema,\n  bracketSchema,\n  noteSchema,\n  rowSchema,\n  partSchema,\n  taalSchema,\n  metaSchema,\n  swaralipiSchema,\n} from './schema.js';\n\nexport type {\n  Octave,\n  SvaraLetter,\n  Svara,\n  Microtone,\n  Bar,\n  Bracket,\n  Note,\n  Row,\n  Part,\n  Taal,\n  Meta,\n  Swaralipi,\n} from './schema.js';\n\nexport { TAALS, type TaalId } from './taals.js';\n\n/** Parse + validate unknown data into a `Swaralipi`. Throws `ZodError` on failure. */\nexport function parseSwaralipi(data: unknown): Swaralipi {\n  return swaralipiSchema.parse(data);\n}\n\n/** Non-throwing variant: returns Zod's `{ success, data | error }` result. */\nexport function safeParseSwaralipi(data: unknown) {\n  return swaralipiSchema.safeParse(data);\n}\n"]}