@ugfoundation/swaralipi-js 0.8.1 → 0.9.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/spec/schema.ts","../src/spec/taals.ts","../src/spec/grace.ts","../src/spec/lay.ts","../src/spec/svara.ts","../src/spec/index.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["import { z } from 'zod';\nimport type { Lay } from './lay.js';\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 কণ / রেশ payload. Historically one `Svara` tuple; real notation puts\n * *several* svaras in a grace, and each may itself be a melisma, so the\n * richer form is a list of notes — reusing `Note` brings komal/tivra/\n * microtone/sustain along for free. The tuple form stays valid, so 0.7.x\n * documents parse unchanged; read either with `graceNotes()`.\n */\nexport type Grace = Svara | Note[];\nexport const graceSchema: z.ZodType<Grace> = z.lazy(() =>\n  z.union([svaraSchema, z.array(noteSchema).min(1)]),\n);\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  /** কণ স্বর: one or more grace notes attached before this note. */\n  kan?: Grace;\n  /**\n   * রেশ: an after-touch grace — the legend's mirror of কণ, written small to\n   * the *right* of the note (\"আসল স্বরের পরে … অন্য স্বরের ঈষৎ রেশ লাগে;\n   * তখন সেই স্বর ক্ষুদ্র অক্ষরে দক্ষিণ পার্শ্বে লিখিত হয়, যথা— রা˰স\").\n   * Swarabitan writes it as a trailing uppercase letter (`mpaM`, `raS`).\n   */\n  resh?: Grace;\n  /** মীড় (glide/slur) endpoint. */\n  meend?: 'start' | 'end';\n  /**\n   * অর্ধমাত্রা (ঃ): this note closes a cell whose matra unit is a *half* —\n   * `সঃ` = ½ matra, `সরঃ` = two ¼s, `রাঃ` = 1½ (legend p. ১৩৫).\n   * Explicit rather than derived, because durations alone cannot distinguish\n   * two half-matra cells (`সঃ গঃ`) from one matra split in two (`সরা`); this\n   * flag is what closes the cell and prints the ঃ.\n   */\n  halfMatra?: boolean;\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: graceSchema.optional(),\n      resh: graceSchema.optional(),\n      meend: z.enum(['start', 'end']).optional(),\n      halfMatra: z.boolean().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/** লয় tier. `Lay` (and the tempo factors) live in the zod-free ./lay.js,\n * which the viewer/player import directly; `satisfies` keeps the two in step. */\nexport const laySchema = z.enum(['drut', 'madhya', 'vilambit']) satisfies z.ZodType<Lay>;\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  /**\n   * লয়: the tempo tier this row switches to, held until another row changes\n   * it (absent on every row = the whole song at `meta.bpm`, i.e. দ্রুত).\n   * Read it with `rowLay()`, which also picks up the mark NLTR *prints*\n   * (\"বিলম্বিত লয়:\") in already-converted documents.\n   */\n  lay: laySchema.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    /**\n     * Which tabla loop variation to play, e.g. `pro` (CDN dir suffix). Optional\n     * and additive — omitted means the taal's default variation, so existing\n     * docs are unaffected. The player honors it but never exposes a variation\n     * picker; selecting a non-default variation is the consumer's premium policy.\n     */\n    variation: z.string().optional(),\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 as printed in the source (e.g. `ষষ্ঠী(২/৪)`), except\n   * free rhythm which is normalised to `মুক্তছন্দ`. Always set by the NLTR\n   * converter; `taal` is set only when the name resolves to a 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  /** Per-document override of the লয় tempo factors (fractions of `bpm`).\n   * Defaults live in `LAY_SPEEDS`; a player/export option overrides both. */\n  laySpeeds: z\n    .object({ drut: z.number().positive(), madhya: z.number().positive(), vilambit: z.number().positive() })\n    .partial()\n    .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:\n * adachautaal, dadra, ektaal, jhaptaal, kehrwa, rupak, shashthi, teentaal,\n * jhampak, dhamaar.\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 *\n * Tabla loops live under `tabla/<id>/` by default; per-taal variation and\n * skip-bpm overrides (e.g. shashthi → `tabla/shashthi-pro/`) are in\n * instruments.ts's `TABLA_VARIATIONS`.\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  choutaal: { id: 'choutaal', numBeats: 12, bhaags: [2, 2, 2, 2, 2, 2], sam: 0, khaali: [2, 6] }, // চৌতাল\n  shashthi: { id: 'shashthi', numBeats: 6, bhaags: [2, 4], sam: 0 }, // ষষ্ঠী\n  teora: { id: 'teora', numBeats: 7, bhaags: [3, 2, 2], sam: 0 }, // টেওরা\n  teentaal: { id: 'teentaal', numBeats: 16, bhaags: [4, 4, 4, 4], sam: 0, khaali: [8] },\n  aratheka: { id: 'aratheka', numBeats: 16, bhaags: [4, 4, 4, 4], sam: 0, khaali: [8] }, // আড়াঠেকা\n  jhampak: { id: 'jhampak', numBeats: 5, bhaags: [3, 2], sam: 0 }, // ঝম্পক\n  dhamaar: { id: 'dhamaar', numBeats: 14, bhaags: [5, 2, 3, 4], sam: 0, khaali: [7] }, // ধামার\n} as const satisfies Record<string, Taal>;\n\nexport type TaalId = keyof typeof TAALS;\n","/**\n * কণ / রেশ readers. Zod-free on purpose: the viewer and the player import\n * this directly (the `spec/index.js` barrel would drag zod into their\n * browser bundles — see `taals.ts` for the same rule).\n */\nimport type { Grace, Note, Svara } from './schema.js';\n\n/** Normalise a grace payload to its note list; the legacy tuple is one note. */\nexport function graceNotes(grace: Grace | undefined): Note[] {\n  if (grace === undefined) return [];\n  return typeof grace[0] === 'string' ? [{ svara: grace as Svara }] : (grace as Note[]);\n}\n","/**\n * লয় (laya) — the tempo tier a passage is sung at.\n *\n * Hindustani names the three tiers বিলম্বিত / মধ্য / দ্রুত (vilambit = slow,\n * madhya = medium, drut = fast), and Rabindrasangeet swaralipi uses the same\n * words: NLTR prints \"বিলম্বিত লয়:\" / \"দ্রুত লয়:\" at the head of the line\n * where the tempo changes (see `printedLay`).\n *\n * `meta.bpm` is the **দ্রুত** tempo — the fast one — so the tiers are\n * multipliers ≤ 1 on it and a document with no লয় marks plays exactly as it\n * did before this field existed.\n *\n * Zod-free on purpose: the viewer, player and creator import this directly\n * (the `spec/index.js` barrel would drag zod into their browser bundles — the\n * same rule as `taals.ts` and `grace.ts`).\n */\nimport type { Note, Row } from './schema.js';\n\nexport type Lay = 'drut' | 'madhya' | 'vilambit';\n\nexport const LAYS: readonly Lay[] = ['drut', 'madhya', 'vilambit'];\n\n/**\n * ### The tempo factors — change them HERE.\n *\n * Fraction of `meta.bpm` each tier is played at. Consumers override per\n * document (`meta.laySpeeds`) or per player/export call (`laySpeeds`), so\n * these are only the fallback.\n */\nexport const LAY_SPEEDS: Record<Lay, number> = {\n  drut: 1,\n  madhya: 0.75,\n  vilambit: 0.5,\n};\n\nexport type LaySpeeds = Partial<Record<Lay, number>>;\n\n/** Resolve the factors actually in force: call option → document → default. */\nexport function resolveLaySpeeds(doc?: LaySpeeds, opt?: LaySpeeds): Record<Lay, number> {\n  return { ...LAY_SPEEDS, ...doc, ...opt };\n}\n\n/**\n * The printed লয় mark: the leading lyric-only cells NLTR writes a tempo\n * change as (\"বিলম্বিত\" \"লয়:\"). Reading it means the 1738 already-converted\n * songs change tempo without being reconverted or edited.\n *\n * ponytail: matches the first word only, and only in the leading annotation\n * position where real lyrics never sit — so 'মধ্যমান' (a taal) can't trip it.\n * If a source ever writes the mark elsewhere in the row, give it `row.lay`.\n */\nconst PRINTED: Record<string, Lay> = { দ্রুত: 'drut', মধ্য: 'madhya', বিলম্বিত: 'vilambit' };\n\nexport function printedLay(notes: Note[]): Lay | undefined {\n  const first = notes[0];\n  if (first === undefined || first.lyric === undefined) return undefined;\n  for (const k of Object.keys(first)) if (k !== 'lyric') return undefined;\n  return PRINTED[first.lyric.normalize('NFC')];\n}\n\n/** The লয় this row switches to, if any: the explicit field wins over the\n * source's printed mark. `undefined` = carry on at the previous tier. */\nexport function rowLay(row: Row): Lay | undefined {\n  return row.lay ?? printedLay(row.notes);\n}\n","/**\n * Which svaras admit which alteration — স and প are অচল (immovable), ম has\n * only its তীব্র (কড়ি) form, and র গ ধ ন only their কোমল form. The notation\n * fonts encode exactly this (no glyph exists for a কোমল প), so a flag the\n * sheet cannot draw must not move the pitch either.\n *\n * Zod-free on purpose: the viewer and the player import this directly (the\n * `spec/index.js` barrel would drag zod into their browser bundles — see\n * `taals.ts` and `grace.ts` for the same rule).\n */\nimport type { SvaraLetter } from './schema.js';\n\nexport function hasKomal(letter: SvaraLetter): boolean {\n  return letter === 'r' || letter === 'g' || letter === 'd' || letter === 'n';\n}\n\nexport function hasTivra(letter: SvaraLetter): boolean {\n  return letter === 'm';\n}\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.8.1';\n\nexport {\n  octaveSchema,\n  svaraLetterSchema,\n  svaraSchema,\n  microtoneSchema,\n  barSchema,\n  bracketSchema,\n  graceSchema,\n  laySchema,\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  Grace,\n  Note,\n  Row,\n  Part,\n  Taal,\n  Meta,\n  Swaralipi,\n} from './schema.js';\n\nexport { TAALS, type TaalId } from './taals.js';\nexport { graceNotes } from './grace.js';\nexport {\n  LAYS,\n  LAY_SPEEDS,\n  printedLay,\n  resolveLaySpeeds,\n  rowLay,\n  type Lay,\n  type LaySpeeds,\n} from './lay.js';\nexport { hasKomal, hasTivra } from './svara.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"]}
+{"version":3,"sources":["../src/spec/schema.ts","../src/spec/taals.ts","../src/spec/grace.ts","../src/spec/lay.ts","../src/spec/svara.ts","../src/spec/index.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["import { z } from 'zod';\nimport type { Lay } from './lay.js';\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 কণ / রেশ payload. Historically one `Svara` tuple; real notation puts\n * *several* svaras in a grace, and each may itself be a melisma, so the\n * richer form is a list of notes — reusing `Note` brings komal/tivra/\n * microtone/sustain along for free. The tuple form stays valid, so 0.7.x\n * documents parse unchanged; read either with `graceNotes()`.\n */\nexport type Grace = Svara | Note[];\nexport const graceSchema: z.ZodType<Grace> = z.lazy(() =>\n  z.union([svaraSchema, z.array(noteSchema).min(1)]),\n);\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  /** কণ স্বর: one or more grace notes attached before this note. */\n  kan?: Grace;\n  /**\n   * রেশ: an after-touch grace — the legend's mirror of কণ, written small to\n   * the *right* of the note (\"আসল স্বরের পরে … অন্য স্বরের ঈষৎ রেশ লাগে;\n   * তখন সেই স্বর ক্ষুদ্র অক্ষরে দক্ষিণ পার্শ্বে লিখিত হয়, যথা— রা˰স\").\n   * Swarabitan writes it as a trailing uppercase letter (`mpaM`, `raS`).\n   */\n  resh?: Grace;\n  /** মীড় (glide/slur) endpoint. */\n  meend?: 'start' | 'end';\n  /**\n   * অর্ধমাত্রা (ঃ): this note closes a cell whose matra unit is a *half* —\n   * `সঃ` = ½ matra, `সরঃ` = two ¼s, `রাঃ` = 1½ (legend p. ১৩৫).\n   * Explicit rather than derived, because durations alone cannot distinguish\n   * two half-matra cells (`সঃ গঃ`) from one matra split in two (`সরা`); this\n   * flag is what closes the cell and prints the ঃ.\n   */\n  halfMatra?: boolean;\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: graceSchema.optional(),\n      resh: graceSchema.optional(),\n      meend: z.enum(['start', 'end']).optional(),\n      halfMatra: z.boolean().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/** লয় tier. `Lay` (and the tempo factors) live in the zod-free ./lay.js,\n * which the viewer/player import directly; `satisfies` keeps the two in step. */\nexport const laySchema = z.enum(['drut', 'madhya', 'vilambit']) satisfies z.ZodType<Lay>;\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    /**\n     * Which tabla loop variation to play, e.g. `pro` (CDN dir suffix). Optional\n     * and additive — omitted means the taal's default variation, so existing\n     * docs are unaffected. The player honors it but never exposes a variation\n     * picker; selecting a non-default variation is the consumer's premium policy.\n     */\n    variation: z.string().optional(),\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/** 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  /**\n   * লয়: the tempo tier this row switches to, held until another row changes\n   * it (absent on every row = the whole song at `meta.bpm`, i.e. দ্রুত).\n   * Read it with `rowLay()`, which also picks up the mark NLTR *prints*\n   * (\"বিলম্বিত লয়:\") in already-converted documents.\n   */\n  lay: laySchema.optional(),\n  /**\n   * তালফেরতা: the তাল this row switches to, held until another row changes it\n   * (absent on every row = the whole song in `meta.taal`). `null` = মুক্তছন্দ\n   * from here on: the accompaniment rests until a later row names a taal.\n   * Independent of `lay` — either, both or neither may change on one row.\n   */\n  taal: taalSchema.nullable().optional(),\n  /** That taal's name as printed (e.g. `ষষ্ঠী(২/৪)`) — `meta.taalName`'s twin. */\n  taalName: 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/** 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 as printed in the source (e.g. `ষষ্ঠী(২/৪)`), except\n   * free rhythm which is normalised to `মুক্তছন্দ`. Always set by the NLTR\n   * converter; `taal` is set only when the name resolves to a 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  /** Per-document override of the লয় tempo factors (fractions of `bpm`).\n   * Defaults live in `LAY_SPEEDS`; a player/export option overrides both. */\n  laySpeeds: z\n    .object({ drut: z.number().positive(), madhya: z.number().positive(), vilambit: z.number().positive() })\n    .partial()\n    .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:\n * adachautaal, dadra, ektaal, jhaptaal, kehrwa, rupak, shashthi, teentaal,\n * jhampak, dhamaar.\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 *\n * Tabla loops live under `tabla/<id>/` by default; per-taal variation and\n * skip-bpm overrides (e.g. shashthi → `tabla/shashthi-pro/`) are in\n * instruments.ts's `TABLA_VARIATIONS`.\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  choutaal: { id: 'choutaal', numBeats: 12, bhaags: [2, 2, 2, 2, 2, 2], sam: 0, khaali: [2, 6] }, // চৌতাল\n  shashthi: { id: 'shashthi', numBeats: 6, bhaags: [2, 4], sam: 0 }, // ষষ্ঠী\n  teora: { id: 'teora', numBeats: 7, bhaags: [3, 2, 2], sam: 0 }, // টেওরা\n  teentaal: { id: 'teentaal', numBeats: 16, bhaags: [4, 4, 4, 4], sam: 0, khaali: [8] },\n  aratheka: { id: 'aratheka', numBeats: 16, bhaags: [4, 4, 4, 4], sam: 0, khaali: [8] }, // আড়াঠেকা\n  jhampak: { id: 'jhampak', numBeats: 5, bhaags: [3, 2], sam: 0 }, // ঝম্পক\n  dhamaar: { id: 'dhamaar', numBeats: 14, bhaags: [5, 2, 3, 4], sam: 0, khaali: [7] }, // ধামার\n} as const satisfies Record<string, Taal>;\n\nexport type TaalId = keyof typeof TAALS;\n\n/**\n * The name a তালফেরতা song's header prints instead of one taal (Swarabitan /\n * Gitabitan's own word; gitabitan.io's taxonomy spells it তাল-ফেরতা). The\n * taals themselves live on the rows (`row.taal`).\n */\nexport const TAAL_FERTA = 'তালফেরতা';\n\n/** Whether a printed taal name is the তালফেরতা heading (either spelling). */\nexport function isTaalFerta(name: string | undefined): boolean {\n  return name !== undefined && name.normalize('NFC').replace(/[\\s-]/g, '') === TAAL_FERTA;\n}\n\n/**\n * Whether two taal marks name the same accompaniment — the তালফেরতা test.\n * `null` (মুক্তছন্দ) and `undefined` (no taal) are only equal to themselves.\n * Compared by value: a row restating the taal in force is not a change.\n */\nexport function sameTaal(a: Taal | null | undefined, b: Taal | null | undefined): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  return a.id === b.id && a.numBeats === b.numBeats && a.variation === b.variation && String(a.bhaags) === String(b.bhaags);\n}\n","/**\n * কণ / রেশ readers. Zod-free on purpose: the viewer and the player import\n * this directly (the `spec/index.js` barrel would drag zod into their\n * browser bundles — see `taals.ts` for the same rule).\n */\nimport type { Grace, Note, Svara } from './schema.js';\n\n/** Normalise a grace payload to its note list; the legacy tuple is one note. */\nexport function graceNotes(grace: Grace | undefined): Note[] {\n  if (grace === undefined) return [];\n  return typeof grace[0] === 'string' ? [{ svara: grace as Svara }] : (grace as Note[]);\n}\n","/**\n * লয় (laya) — the tempo tier a passage is sung at.\n *\n * Hindustani names the three tiers বিলম্বিত / মধ্য / দ্রুত (vilambit = slow,\n * madhya = medium, drut = fast), and Rabindrasangeet swaralipi uses the same\n * words: NLTR prints \"বিলম্বিত লয়:\" / \"দ্রুত লয়:\" at the head of the line\n * where the tempo changes (see `printedLay`).\n *\n * `meta.bpm` is the **দ্রুত** tempo — the fast one — so the tiers are\n * multipliers ≤ 1 on it and a document with no লয় marks plays exactly as it\n * did before this field existed.\n *\n * Zod-free on purpose: the viewer, player and creator import this directly\n * (the `spec/index.js` barrel would drag zod into their browser bundles — the\n * same rule as `taals.ts` and `grace.ts`).\n */\nimport type { Note, Row } from './schema.js';\n\nexport type Lay = 'drut' | 'madhya' | 'vilambit';\n\nexport const LAYS: readonly Lay[] = ['drut', 'madhya', 'vilambit'];\n\n/**\n * ### The tempo factors — change them HERE.\n *\n * Fraction of `meta.bpm` each tier is played at. Consumers override per\n * document (`meta.laySpeeds`) or per player/export call (`laySpeeds`), so\n * these are only the fallback.\n */\nexport const LAY_SPEEDS: Record<Lay, number> = {\n  drut: 1,\n  madhya: 0.75,\n  vilambit: 0.5,\n};\n\nexport type LaySpeeds = Partial<Record<Lay, number>>;\n\n/** Resolve the factors actually in force: call option → document → default. */\nexport function resolveLaySpeeds(doc?: LaySpeeds, opt?: LaySpeeds): Record<Lay, number> {\n  return { ...LAY_SPEEDS, ...doc, ...opt };\n}\n\n/**\n * The printed লয় mark: the leading lyric-only cells NLTR writes a tempo\n * change as (\"বিলম্বিত\" \"লয়:\"). Reading it means the 1738 already-converted\n * songs change tempo without being reconverted or edited.\n *\n * ponytail: matches the first word only, and only in the leading annotation\n * position where real lyrics never sit — so 'মধ্যমান' (a taal) can't trip it.\n * If a source ever writes the mark elsewhere in the row, give it `row.lay`.\n */\nconst PRINTED: Record<string, Lay> = { দ্রুত: 'drut', মধ্য: 'madhya', বিলম্বিত: 'vilambit' };\n\nexport function printedLay(notes: Note[]): Lay | undefined {\n  const first = notes[0];\n  if (first === undefined || first.lyric === undefined) return undefined;\n  for (const k of Object.keys(first)) if (k !== 'lyric') return undefined;\n  return PRINTED[first.lyric.normalize('NFC')];\n}\n\n/** The লয় this row switches to, if any: the explicit field wins over the\n * source's printed mark. `undefined` = carry on at the previous tier. */\nexport function rowLay(row: Row): Lay | undefined {\n  return row.lay ?? printedLay(row.notes);\n}\n","/**\n * Which svaras admit which alteration — স and প are অচল (immovable), ম has\n * only its তীব্র (কড়ি) form, and র গ ধ ন only their কোমল form. The notation\n * fonts encode exactly this (no glyph exists for a কোমল প), so a flag the\n * sheet cannot draw must not move the pitch either.\n *\n * Zod-free on purpose: the viewer and the player import this directly (the\n * `spec/index.js` barrel would drag zod into their browser bundles — see\n * `taals.ts` and `grace.ts` for the same rule).\n */\nimport type { SvaraLetter } from './schema.js';\n\nexport function hasKomal(letter: SvaraLetter): boolean {\n  return letter === 'r' || letter === 'g' || letter === 'd' || letter === 'n';\n}\n\nexport function hasTivra(letter: SvaraLetter): boolean {\n  return letter === 'm';\n}\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.9.0';\n\nexport {\n  octaveSchema,\n  svaraLetterSchema,\n  svaraSchema,\n  microtoneSchema,\n  barSchema,\n  bracketSchema,\n  graceSchema,\n  laySchema,\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  Grace,\n  Note,\n  Row,\n  Part,\n  Taal,\n  Meta,\n  Swaralipi,\n} from './schema.js';\n\nexport { TAALS, TAAL_FERTA, isTaalFerta, sameTaal, type TaalId } from './taals.js';\nexport { graceNotes } from './grace.js';\nexport {\n  LAYS,\n  LAY_SPEEDS,\n  printedLay,\n  resolveLaySpeeds,\n  rowLay,\n  type Lay,\n  type LaySpeeds,\n} from './lay.js';\nexport { hasKomal, hasTivra } from './svara.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"]}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
 export { SPEC_VERSION, graceNotes, hasKomal, hasTivra, parseSwaralipi, safeParseSwaralipi } from './spec/index.cjs';
-export { B as Bar, b as Bracket, G as Grace, M as Meta, c as Microtone, N as Note, O as Octave, P as Part, R as Row, d as Svara, a as SvaraLetter, S as Swaralipi, T as Taal, e as barSchema, f as bracketSchema, g as graceSchema, l as laySchema, m as metaSchema, h as microtoneSchema, n as noteSchema, o as octaveSchema, p as partSchema, r as rowSchema, s as svaraLetterSchema, i as svaraSchema, j as swaralipiSchema, t as taalSchema } from './schema-DGA_bNVZ.cjs';
-export { b as LAYS, c as LAY_SPEEDS, L as Lay, a as LaySpeeds, e as TAALS, T as TaalId, p as printedLay, r as resolveLaySpeeds, d as rowLay } from './lay-Csa4CD46.cjs';
+export { B as Bar, b as Bracket, G as Grace, M as Meta, c as Microtone, N as Note, O as Octave, P as Part, R as Row, d as Svara, a as SvaraLetter, S as Swaralipi, T as Taal, e as barSchema, f as bracketSchema, g as graceSchema, l as laySchema, m as metaSchema, h as microtoneSchema, n as noteSchema, o as octaveSchema, p as partSchema, r as rowSchema, s as svaraLetterSchema, i as svaraSchema, j as swaralipiSchema, t as taalSchema } from './schema-Cf_epUIC.cjs';
+export { b as LAYS, c as LAY_SPEEDS, L as Lay, a as LaySpeeds, e as TAALS, f as TAAL_FERTA, T as TaalId, i as isTaalFerta, p as printedLay, r as resolveLaySpeeds, d as rowLay, s as sameTaal } from './lay-CfDlPhH2.cjs';
 import 'zod';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { SPEC_VERSION, graceNotes, hasKomal, hasTivra, parseSwaralipi, safeParseSwaralipi } from './spec/index.js';
-export { B as Bar, b as Bracket, G as Grace, M as Meta, c as Microtone, N as Note, O as Octave, P as Part, R as Row, d as Svara, a as SvaraLetter, S as Swaralipi, T as Taal, e as barSchema, f as bracketSchema, g as graceSchema, l as laySchema, m as metaSchema, h as microtoneSchema, n as noteSchema, o as octaveSchema, p as partSchema, r as rowSchema, s as svaraLetterSchema, i as svaraSchema, j as swaralipiSchema, t as taalSchema } from './schema-DGA_bNVZ.js';
-export { b as LAYS, c as LAY_SPEEDS, L as Lay, a as LaySpeeds, e as TAALS, T as TaalId, p as printedLay, r as resolveLaySpeeds, d as rowLay } from './lay-Ct9ky_EE.js';
+export { B as Bar, b as Bracket, G as Grace, M as Meta, c as Microtone, N as Note, O as Octave, P as Part, R as Row, d as Svara, a as SvaraLetter, S as Swaralipi, T as Taal, e as barSchema, f as bracketSchema, g as graceSchema, l as laySchema, m as metaSchema, h as microtoneSchema, n as noteSchema, o as octaveSchema, p as partSchema, r as rowSchema, s as svaraLetterSchema, i as svaraSchema, j as swaralipiSchema, t as taalSchema } from './schema-Cf_epUIC.js';
+export { b as LAYS, c as LAY_SPEEDS, L as Lay, a as LaySpeeds, e as TAALS, f as TAAL_FERTA, T as TaalId, i as isTaalFerta, p as printedLay, r as resolveLaySpeeds, d as rowLay, s as sameTaal } from './lay-CZIzR9cM.js';
 import 'zod';

package/dist/index.js

@@ -1,4 +1,4 @@
-export { SPEC_VERSION, barSchema, bracketSchema, graceSchema, laySchema, metaSchema, microtoneSchema, noteSchema, octaveSchema, parseSwaralipi, partSchema, rowSchema, safeParseSwaralipi, svaraLetterSchema, svaraSchema, swaralipiSchema, taalSchema } from './chunk-LPCKL3AM.js';
-export { LAYS, LAY_SPEEDS, TAALS, graceNotes, hasKomal, hasTivra, printedLay, resolveLaySpeeds, rowLay } from './chunk-4HNT6OAT.js';
+export { SPEC_VERSION, barSchema, bracketSchema, graceSchema, laySchema, metaSchema, microtoneSchema, noteSchema, octaveSchema, parseSwaralipi, partSchema, rowSchema, safeParseSwaralipi, svaraLetterSchema, svaraSchema, swaralipiSchema, taalSchema } from './chunk-3ZQPM2CE.js';
+export { LAYS, LAY_SPEEDS, TAALS, TAAL_FERTA, graceNotes, hasKomal, hasTivra, isTaalFerta, printedLay, resolveLaySpeeds, rowLay, sameTaal } from './chunk-MYVIQU4O.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{lay-Csa4CD46.d.cts → lay-CZIzR9cM.d.ts}

@@ -1,4 +1,4 @@
-import { N as Note, R as Row } from './schema-DGA_bNVZ.cjs';
+import { T as Taal, N as Note, R as Row } from './schema-Cf_epUIC.js';
 
 /**
  * Reference definitions for the taals the player will sample:
@@ -102,6 +102,20 @@ declare const TAALS: {
     };
 };
 type TaalId = keyof typeof TAALS;
+/**
+ * The name a তালফেরতা song's header prints instead of one taal (Swarabitan /
+ * Gitabitan's own word; gitabitan.io's taxonomy spells it তাল-ফেরতা). The
+ * taals themselves live on the rows (`row.taal`).
+ */
+declare const TAAL_FERTA = "\u09A4\u09BE\u09B2\u09AB\u09C7\u09B0\u09A4\u09BE";
+/** Whether a printed taal name is the তালফেরতা heading (either spelling). */
+declare function isTaalFerta(name: string | undefined): boolean;
+/**
+ * Whether two taal marks name the same accompaniment — the তালফেরতা test.
+ * `null` (মুক্তছন্দ) and `undefined` (no taal) are only equal to themselves.
+ * Compared by value: a row restating the taal in force is not a change.
+ */
+declare function sameTaal(a: Taal | null | undefined, b: Taal | null | undefined): boolean;
 
 /**
  * লয় (laya) — the tempo tier a passage is sung at.
@@ -138,4 +152,4 @@ declare function printedLay(notes: Note[]): Lay | undefined;
  * source's printed mark. `undefined` = carry on at the previous tier. */
 declare function rowLay(row: Row): Lay | undefined;
 
-export { type Lay as L, type TaalId as T, type LaySpeeds as a, LAYS as b, LAY_SPEEDS as c, rowLay as d, TAALS as e, printedLay as p, resolveLaySpeeds as r };
+export { type Lay as L, type TaalId as T, type LaySpeeds as a, LAYS as b, LAY_SPEEDS as c, rowLay as d, TAALS as e, TAAL_FERTA as f, isTaalFerta as i, printedLay as p, resolveLaySpeeds as r, sameTaal as s };

package/dist/{lay-Ct9ky_EE.d.ts → lay-CfDlPhH2.d.cts}

@@ -1,4 +1,4 @@
-import { N as Note, R as Row } from './schema-DGA_bNVZ.js';
+import { T as Taal, N as Note, R as Row } from './schema-Cf_epUIC.cjs';
 
 /**
  * Reference definitions for the taals the player will sample:
@@ -102,6 +102,20 @@ declare const TAALS: {
     };
 };
 type TaalId = keyof typeof TAALS;
+/**
+ * The name a তালফেরতা song's header prints instead of one taal (Swarabitan /
+ * Gitabitan's own word; gitabitan.io's taxonomy spells it তাল-ফেরতা). The
+ * taals themselves live on the rows (`row.taal`).
+ */
+declare const TAAL_FERTA = "\u09A4\u09BE\u09B2\u09AB\u09C7\u09B0\u09A4\u09BE";
+/** Whether a printed taal name is the তালফেরতা heading (either spelling). */
+declare function isTaalFerta(name: string | undefined): boolean;
+/**
+ * Whether two taal marks name the same accompaniment — the তালফেরতা test.
+ * `null` (মুক্তছন্দ) and `undefined` (no taal) are only equal to themselves.
+ * Compared by value: a row restating the taal in force is not a change.
+ */
+declare function sameTaal(a: Taal | null | undefined, b: Taal | null | undefined): boolean;
 
 /**
  * লয় (laya) — the tempo tier a passage is sung at.
@@ -138,4 +152,4 @@ declare function printedLay(notes: Note[]): Lay | undefined;
  * source's printed mark. `undefined` = carry on at the previous tier. */
 declare function rowLay(row: Row): Lay | undefined;
 
-export { type Lay as L, type TaalId as T, type LaySpeeds as a, LAYS as b, LAY_SPEEDS as c, rowLay as d, TAALS as e, printedLay as p, resolveLaySpeeds as r };
+export { type Lay as L, type TaalId as T, type LaySpeeds as a, LAYS as b, LAY_SPEEDS as c, rowLay as d, TAALS as e, TAAL_FERTA as f, isTaalFerta as i, printedLay as p, resolveLaySpeeds as r, sameTaal as s };

package/dist/player/index.cjs

@@ -22,6 +22,11 @@ var TAALS = {
   dhamaar: { id: "dhamaar", numBeats: 14, bhaags: [5, 2, 3, 4], sam: 0, khaali: [7] }
   // ধামার
 };
+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) {
@@ -184,18 +189,23 @@ function buildSchedule(doc, opts = {}) {
   let matra = 0;
   const speeds = resolveLaySpeeds(doc.meta.laySpeeds, opts.laySpeeds);
   const withLay = opts.lay !== false;
-  const tempo = [{ beat: 0, endBeat: 0, scale: 1, lay: "drut" }];
+  const tempo = [{ beat: 0, endBeat: 0, scale: 1, lay: "drut", taal: doc.meta.taal }];
   let scale = 1;
+  let taal = doc.meta.taal;
   doc.parts.forEach((part, p) => {
     part.rows.forEach((row, r) => {
       const lay = withLay ? rowLay(row) : void 0;
-      if (lay !== void 0 && speeds[lay] !== scale) {
-        scale = speeds[lay];
+      const layChanged = lay !== void 0 && speeds[lay] !== scale;
+      const nextTaal = row.taal !== void 0 ? row.taal : taal;
+      if (layChanged || !sameTaal(nextTaal, taal)) {
+        if (layChanged) scale = speeds[lay];
+        taal = nextTaal;
         const last = tempo[tempo.length - 1];
-        if (last.beat === cursor) tempo[tempo.length - 1] = { beat: cursor, endBeat: cursor, scale, lay };
+        const seg = { beat: cursor, endBeat: cursor, scale, lay: layChanged ? lay : last.lay, taal };
+        if (last.beat === cursor) tempo[tempo.length - 1] = seg;
         else {
           last.endBeat = cursor;
-          tempo.push({ beat: cursor, endBeat: cursor, scale, lay });
+          tempo.push(seg);
         }
       }
       const glides = meendContinuations(row.notes);
@@ -234,7 +244,7 @@ function buildSchedule(doc, opts = {}) {
       });
     });
   });
-  const numBeats = doc.meta.taal?.numBeats;
+  const numBeats = tempo[0].taal?.numBeats;
   const pickupMatra = samMatra !== void 0 && numBeats !== void 0 && numBeats > 0 ? (numBeats - samMatra % numBeats) % numBeats : 0;
   tempo[tempo.length - 1].endBeat = cursor;
   return { events, totalBeats: cursor, pickupBeats: pickupMatra / tempo[0].scale, tempo };
@@ -888,16 +898,26 @@ var SwaralipiPlayer = class {
   #emitHighlight(path) {
     this.#opts.onHighlight?.(path);
   }
-  /** The tabla variation to play: taal-mode taal's, the doc's own (auto mode),
-   * else none — an explicit setTaal override plays the taal's default variation. */
-  #variation() {
+  /** The taal one accompaniment segment plays: taal mode's, an explicit
+   * setTaal override (pinned across the whole song, তালফেরতা included), else
+   * the segment's own. `null` = a মুক্তছন্দ passage. */
+  #segmentTaal(seg) {
+    if (this.#taal !== void 0) return this.#taal;
+    if (!this.#taalAuto && this.#taalOverride !== void 0) return TAALS[this.#taalOverride];
+    return seg.taal;
+  }
+  /** The tabla variation to play: taal-mode taal's, the segment's own (auto
+   * mode), else none — an explicit setTaal override plays the default variation. */
+  #variation(taal) {
     if (this.#taal !== void 0) return this.#taal.variation;
-    return this.#taalAuto ? this.#doc?.meta.taal?.variation : void 0;
+    return this.#taalAuto ? taal?.variation : void 0;
   }
   /** Resolve the active taal id: taal mode's taal, an explicit override, else
-   * the doc's — but only when it names a sampled taal. */
+   * the doc's opening one (a তালফেরতা doc may carry it on its first row) — but
+   * only when it names a sampled taal. */
   #taalId() {
-    const id = this.#taal?.id ?? (!this.#taalAuto && this.#taalOverride !== void 0 ? this.#taalOverride : this.#doc?.meta.taal?.id);
+    const opening = this.#doc?.parts[0]?.rows[0]?.taal || this.#doc?.meta.taal;
+    const id = this.#taal?.id ?? (!this.#taalAuto && this.#taalOverride !== void 0 ? this.#taalOverride : opening?.id);
     return id !== void 0 && id in TAALS ? id : void 0;
   }
   /** Resolve an instrument id to its def (custom overrides built-ins; the
@@ -1092,34 +1112,35 @@ var SwaralipiPlayer = class {
     return entry;
   }
   /**
-   * Accompaniment, one লয় segment at a time. A tempo change under the melody
-   * is a real tempo change under the drum: the tabla loop is rebuilt at the
-   * segment's own bpm — its own recorded file when the set has one at that
+   * Accompaniment, one লয় / তাল segment at a time. A tempo change under the
+   * melody is a real tempo change under the drum: the tabla loop is rebuilt at
+   * the segment's own bpm — its own recorded file when the set has one at that
    * tempo, else the nearest file time-stretched by `GrainPlayer` (which
    * stretches *without* transposing, unlike a plain playbackRate) — and the
-   * click / drum / drone patterns re-space their interval. A document with no
-   * লয় marks has exactly one segment, so this is the old single-loop path.
+   * click / drum / drone patterns re-space their interval. A তালফেরতা swaps the
+   * theka the same way: each segment loops its own taal's file (or pattern, or
+   * click cycle), and a মুক্তছন্দ segment rests. A document with neither mark
+   * has exactly one segment, so this is the old single-loop path.
    */
   #buildRhythm(Tone, transport, base, spb, segments, shift) {
     this.#disposeTabla();
     const master = this.#ensureMaster(Tone);
-    const taalId = this.#taalId();
-    const wantsTabla = this.#opts.rhythm === "tabla" && taalId !== void 0 && SAMPLED_TAALS.has(taalId) && base !== void 0;
-    if (!wantsTabla && this.#opts.rhythm !== "drums" && (this.#opts.rhythm === "none" || base === void 0)) return;
-    const taal = this.#taal ?? (taalId !== void 0 ? TAALS[taalId] : this.#doc?.meta.taal) ?? { numBeats: 4, sam: 0 };
-    const pattern = this.#opts.rhythm === "drums" ? drumPattern(taal) : [];
-    const cycle = this.#taal?.numBeats ?? this.#doc?.meta.taal?.numBeats ?? 4;
+    const rhythm = this.#opts.rhythm;
+    if (rhythm === "none" || base === void 0 && rhythm !== "drums") return;
     segments.forEach((seg, i) => {
+      const own = this.#segmentTaal(seg);
+      if (own === null) return;
+      const taalId = own !== void 0 && own.id in TAALS ? own.id : void 0;
       const from = i === 0 ? 0 : seg.beat * spb + shift;
       const to = i === segments.length - 1 ? Infinity : seg.endBeat * spb + shift;
       const beatSec = spb / seg.scale;
       const span = to === Infinity ? void 0 : to - from;
-      if (wantsTabla) {
+      if (rhythm === "tabla" && taalId !== void 0 && SAMPLED_TAALS.has(taalId) && base !== void 0) {
         const bpm = 60 / beatSec;
         const fileBpm = nearestTablaBpm(bpm, tablaBpms(taalId));
         const rate = bpm / fileBpm;
         const semis = tablaShiftSemitones(this.#tonicSemitone());
-        const url = tablaUrl(base, taalId, fileBpm, this.#variation());
+        const url = tablaUrl(base, taalId, fileBpm, this.#variation(own));
         const loop = (rate === 1 && semis === 0 ? new Tone.Player({ url, loop: true }) : new Tone.GrainPlayer({
           url,
           loop: true,
@@ -1141,9 +1162,10 @@ var SwaralipiPlayer = class {
         this.#tabla.push({ loop, fileSpb: 60 / fileBpm });
         return;
       }
-      if (this.#opts.rhythm === "drums") {
+      if (rhythm === "drums") {
         this.#drums ??= createDrumKit(Tone).connect(master);
         const drums = this.#drums;
+        const pattern = drumPattern(this.#taal ?? (taalId !== void 0 ? TAALS[taalId] : own) ?? { numBeats: 4, sam: 0 });
         let beat2 = 0;
         this.#scheduleIds.push(
           transport.scheduleRepeat(
@@ -1161,6 +1183,7 @@ var SwaralipiPlayer = class {
       }
       this.#metronome ??= createMetronome(Tone, base).connect(master);
       const metro = this.#metronome;
+      const cycle = (this.#taal ?? seg.taal)?.numBeats ?? 4;
       let beat = 0;
       this.#scheduleIds.push(
         transport.scheduleRepeat(
@@ -1236,7 +1259,7 @@ function pickDef(id, o) {
   return def;
 }
 function resolveTaal(doc, taal) {
-  const id = taal !== void 0 && taal !== "auto" ? taal : doc.meta.taal?.id;
+  const id = taal !== void 0 && taal !== "auto" ? taal : (doc.parts[0]?.rows[0]?.taal || doc.meta.taal)?.id;
   return id !== void 0 && id in TAALS ? id : void 0;
 }
 function safeName(title) {
@@ -1259,7 +1282,7 @@ async function exportAudio(doc, options = {}) {
   });
   const range = midiRange2(schedule);
   const taalId = resolveTaal(doc, options.taal);
-  const variation = options.taal === void 0 || options.taal === "auto" ? doc.meta.taal?.variation : void 0;
+  const pinned = options.taal !== void 0 && options.taal !== "auto" && taalId !== void 0 ? TAALS[taalId] : void 0;
   const usesTabla = rhythm === "tabla" && taalId !== void 0 && SAMPLED_TAALS.has(taalId) && !!base;
   const reqBpm = options.bpm ?? doc.meta.bpm ?? 90;
   const bpm = usesTabla && taalId ? nearestTablaBpm(reqBpm, tablaBpms(taalId)) : reqBpm;
@@ -1311,22 +1334,22 @@ async function exportAudio(doc, options = {}) {
       }
       const tablas = [];
       if (rhythm !== "none" && base) {
-        const taal = taalId !== void 0 ? TAALS[taalId] : doc.meta.taal ?? { numBeats: 4, sam: 0 };
-        const pattern = rhythm === "drums" ? drumPattern(taal) : [];
         const drums = rhythm === "drums" ? createDrumKit(Tone).connect(master) : void 0;
-        const metro = rhythm !== "drums" && !usesTabla ? createMetronome(Tone, base).connect(master) : void 0;
-        const cycle = taalId !== void 0 ? TAALS[taalId].numBeats : doc.meta.taal?.numBeats ?? 4;
+        let metro;
         const semis = tablaShiftSemitones(parseTonic(options.tonic ?? doc.meta.tonic));
         schedule.tempo.forEach((seg, i) => {
+          const own = pinned ?? seg.taal;
+          if (own === null) return;
+          const segId = own !== void 0 && own.id in TAALS ? own.id : void 0;
           const from = i === 0 ? 0 : seg.beat * spb + shift;
           const to = i === schedule.tempo.length - 1 ? Infinity : seg.endBeat * spb + shift;
           const beatSec = spb / seg.scale;
           const span = to === Infinity ? void 0 : to - from;
-          if (usesTabla && taalId) {
+          if (rhythm === "tabla" && segId !== void 0 && SAMPLED_TAALS.has(segId)) {
             const segBpm = 60 / beatSec;
-            const fileBpm = nearestTablaBpm(segBpm, tablaBpms(taalId));
+            const fileBpm = nearestTablaBpm(segBpm, tablaBpms(segId));
             const rate = segBpm / fileBpm;
-            const url = tablaUrl(base, taalId, fileBpm, variation);
+            const url = tablaUrl(base, segId, fileBpm, pinned === void 0 ? own?.variation : void 0);
             const loop = (rate === 1 && semis === 0 ? new Tone.Player({ url, loop: true }) : new Tone.GrainPlayer({
               url,
               loop: true,
@@ -1345,6 +1368,7 @@ async function exportAudio(doc, options = {}) {
             }
             tablas.push({ loop, fileSpb: 60 / fileBpm });
           } else if (drums !== void 0) {
+            const pattern = drumPattern(segId !== void 0 ? TAALS[segId] : own ?? { numBeats: 4, sam: 0 });
             let beat = 0;
             transport.scheduleRepeat(
               (time) => {
@@ -1356,12 +1380,14 @@ async function exportAudio(doc, options = {}) {
               from,
               span
             );
-          } else if (metro !== void 0) {
+          } else {
+            const click = metro ??= createMetronome(Tone, base).connect(master);
+            const cycle = own?.numBeats ?? 4;
             let beat = 0;
             transport.scheduleRepeat(
               (time) => {
-                metro.volume.setValueAtTime(beat % cycle === 0 ? 0 : -8, time);
-                metro.start(time);
+                click.volume.setValueAtTime(beat % cycle === 0 ? 0 : -8, time);
+                click.start(time);
                 beat += 1;
               },
               beatSec,
@@ -1587,14 +1613,18 @@ function encodeMidi(schedule, opts) {
   if (opts.name) head.push(...vlq(0), 255, 3, ...vlq(utf8(opts.name).length), ...utf8(opts.name));
   head.push(...vlq(0), 255, 81, 3, usPerBeat >> 16 & 255, usPerBeat >> 8 & 255, usPerBeat & 255);
   const chunks = [trackChunk(melody, head)];
-  if (opts.drums && opts.drums.length > 0) {
+  if (typeof opts.drums === "function" || opts.drums && opts.drums.length > 0) {
     const drum = [];
-    const totalBeats = Math.ceil(schedule.totalBeats);
-    for (let beat = 0; beat < totalBeats; beat++) {
-      const note = DRUM_NOTE[opts.drums[beat % opts.drums.length]];
-      const t = beat * PPQ;
-      drum.push({ tick: t, on: true, note, vel: 100, ch: 9 });
-      drum.push({ tick: t + Math.round(PPQ / 4), on: false, note, vel: 0, ch: 9 });
+    for (const seg of schedule.tempo) {
+      const pattern = typeof opts.drums === "function" ? opts.drums(seg) : opts.drums;
+      if (!pattern?.length) continue;
+      const end = seg === schedule.tempo[schedule.tempo.length - 1] ? Math.ceil(schedule.totalBeats) : seg.endBeat;
+      for (let k = 0; seg.beat + k / seg.scale < end - 1e-6; k++) {
+        const note = DRUM_NOTE[pattern[k % pattern.length]];
+        const t = Math.round((seg.beat + k / seg.scale) * PPQ);
+        drum.push({ tick: t, on: true, note, vel: 100, ch: 9 });
+        drum.push({ tick: t + Math.round(PPQ / 4), on: false, note, vel: 0, ch: 9 });
+      }
     }
     chunks.push(trackChunk(drum, [...vlq(0), 255, 3, ...vlq(5), 68, 114, 117, 109, 115]));
   }
@@ -1624,9 +1654,11 @@ function exportMidi(doc, options = {}) {
     laySpeeds: options.laySpeeds
   });
   const bpm = options.bpm ?? doc.meta.bpm ?? 90;
-  const taalId = doc.meta.taal?.id;
-  const taal = taalId !== void 0 && taalId in TAALS ? TAALS[taalId] : { numBeats: 4, sam: 0 };
-  const drums = options.drums ? drumPattern(taal) : void 0;
+  const drums = options.drums ? (seg) => {
+    const id = seg.taal?.id;
+    if (seg.taal === null) return void 0;
+    return drumPattern(id !== void 0 && id in TAALS ? TAALS[id] : { numBeats: 4, sam: 0 });
+  } : void 0;
   const bytes = encodeMidi(schedule, { bpm, name: options.name ?? doc.meta.title, drums });
   return {
     blob: new Blob([bytes], { type: "audio/midi" }),