@ugfoundation/swaralipi-js 0.9.2 → 0.10.0

package/dist/{schedule-BaovCtmf.d.ts → schedule-BUopqmWm.d.ts}

@@ -274,6 +274,32 @@ declare function graceTouches(ev: PlayEvent): {
     midi: number;
     beat: number;
 }[];
+/**
+ * One line of the sheet as the practice controls move by it: a `part.row`
+ * with at least one timed column. It runs from its first event to the next
+ * line's (the last one to `totalBeats`), so a line's trailing bars and holds
+ * belong to it.
+ */
+interface Line {
+    /** `part.row` — the viewer's `data-row`. */
+    row: string;
+    /** Index of the line's first event. */
+    first: number;
+    beat: number;
+    endBeat: number;
+}
+/** The schedule's events grouped into sheet lines, in play order. A row of
+ * bars and annotations only has no events, so it is not a line. */
+declare function scheduleLines(schedule: Schedule): Line[];
+/**
+ * The event a tap or a seek to `path` (`part.row.note`, or `part.row` for the
+ * line's start) should start from: the first event at or after that note in
+ * its own row, else the row's last one — a closing bar belongs to its line,
+ * not the next — else the next line's first. A note reached by a মীড় glide has
+ * no attack of its own, so the glide's source is returned instead. -1 when
+ * nothing sounds from there on.
+ */
+declare function eventAt(events: PlayEvent[], path: string): number;
 /**
  * Walk a document into a flat, time-ordered list of play events.
  *
@@ -293,4 +319,4 @@ declare function graceTouches(ev: PlayEvent): {
  */
 declare function buildSchedule(doc: Swaralipi, opts?: ScheduleOptions): Schedule;
 
-export { ARC_RAW_RE as A, subsetUrls as B, tablaBpms as C, type DrumVoice as D, tablaUrl as E, triggerGlide as F, GRACE_STEP as G, type InstrumentId as I, MEEND_HOLD as M, type PlayEvent as P, type Schedule as S, type TempoSegment as T, type InstrumentDef as a, DEFAULT_SOUNDS_BASE as b, DRUM_KIT_BASE as c, type GlideLeg as d, INSTRUMENTS as e, SALAMANDER_BASE as f, SAMPLED_TAALS as g, type ScheduleOptions as h, TABLA_BPMS as i, TABLA_VARIATIONS as j, TONEJS_INSTRUMENTS_BASE as k, type ToneModule as l, buildSchedule as m, createBuffers as n, drumPattern as o, glideTargets as p, graceTouches as q, instrumentSampleUrl as r, isArcRaw as s, meendContinuations as t, nearestSampleKey as u, nearestTablaBpm as v, normalizeBase as w, probeUrl as x, quantizeLoopEnd as y, santoorUrls as z };
+export { ARC_RAW_RE as A, santoorUrls as B, scheduleLines as C, type DrumVoice as D, subsetUrls as E, tablaBpms as F, GRACE_STEP as G, tablaUrl as H, type InstrumentId as I, triggerGlide as J, type Line as L, MEEND_HOLD as M, type PlayEvent as P, type Schedule as S, type TempoSegment as T, type InstrumentDef as a, DEFAULT_SOUNDS_BASE as b, DRUM_KIT_BASE as c, type GlideLeg as d, INSTRUMENTS as e, SALAMANDER_BASE as f, SAMPLED_TAALS as g, type ScheduleOptions as h, TABLA_BPMS as i, TABLA_VARIATIONS as j, TONEJS_INSTRUMENTS_BASE as k, type ToneModule as l, buildSchedule as m, createBuffers as n, drumPattern as o, eventAt as p, glideTargets as q, graceTouches as r, instrumentSampleUrl as s, isArcRaw as t, meendContinuations as u, nearestSampleKey as v, nearestTablaBpm as w, normalizeBase as x, probeUrl as y, quantizeLoopEnd as z };

package/dist/{schedule-CU-VECDH.d.cts → schedule-IBu8lr-3.d.cts}

@@ -274,6 +274,32 @@ declare function graceTouches(ev: PlayEvent): {
     midi: number;
     beat: number;
 }[];
+/**
+ * One line of the sheet as the practice controls move by it: a `part.row`
+ * with at least one timed column. It runs from its first event to the next
+ * line's (the last one to `totalBeats`), so a line's trailing bars and holds
+ * belong to it.
+ */
+interface Line {
+    /** `part.row` — the viewer's `data-row`. */
+    row: string;
+    /** Index of the line's first event. */
+    first: number;
+    beat: number;
+    endBeat: number;
+}
+/** The schedule's events grouped into sheet lines, in play order. A row of
+ * bars and annotations only has no events, so it is not a line. */
+declare function scheduleLines(schedule: Schedule): Line[];
+/**
+ * The event a tap or a seek to `path` (`part.row.note`, or `part.row` for the
+ * line's start) should start from: the first event at or after that note in
+ * its own row, else the row's last one — a closing bar belongs to its line,
+ * not the next — else the next line's first. A note reached by a মীড় glide has
+ * no attack of its own, so the glide's source is returned instead. -1 when
+ * nothing sounds from there on.
+ */
+declare function eventAt(events: PlayEvent[], path: string): number;
 /**
  * Walk a document into a flat, time-ordered list of play events.
  *
@@ -293,4 +319,4 @@ declare function graceTouches(ev: PlayEvent): {
  */
 declare function buildSchedule(doc: Swaralipi, opts?: ScheduleOptions): Schedule;
 
-export { ARC_RAW_RE as A, subsetUrls as B, tablaBpms as C, type DrumVoice as D, tablaUrl as E, triggerGlide as F, GRACE_STEP as G, type InstrumentId as I, MEEND_HOLD as M, type PlayEvent as P, type Schedule as S, type TempoSegment as T, type InstrumentDef as a, DEFAULT_SOUNDS_BASE as b, DRUM_KIT_BASE as c, type GlideLeg as d, INSTRUMENTS as e, SALAMANDER_BASE as f, SAMPLED_TAALS as g, type ScheduleOptions as h, TABLA_BPMS as i, TABLA_VARIATIONS as j, TONEJS_INSTRUMENTS_BASE as k, type ToneModule as l, buildSchedule as m, createBuffers as n, drumPattern as o, glideTargets as p, graceTouches as q, instrumentSampleUrl as r, isArcRaw as s, meendContinuations as t, nearestSampleKey as u, nearestTablaBpm as v, normalizeBase as w, probeUrl as x, quantizeLoopEnd as y, santoorUrls as z };
+export { ARC_RAW_RE as A, santoorUrls as B, scheduleLines as C, type DrumVoice as D, subsetUrls as E, tablaBpms as F, GRACE_STEP as G, tablaUrl as H, type InstrumentId as I, triggerGlide as J, type Line as L, MEEND_HOLD as M, type PlayEvent as P, type Schedule as S, type TempoSegment as T, type InstrumentDef as a, DEFAULT_SOUNDS_BASE as b, DRUM_KIT_BASE as c, type GlideLeg as d, INSTRUMENTS as e, SALAMANDER_BASE as f, SAMPLED_TAALS as g, type ScheduleOptions as h, TABLA_BPMS as i, TABLA_VARIATIONS as j, TONEJS_INSTRUMENTS_BASE as k, type ToneModule as l, buildSchedule as m, createBuffers as n, drumPattern as o, eventAt as p, glideTargets as q, graceTouches as r, instrumentSampleUrl as s, isArcRaw as t, meendContinuations as u, nearestSampleKey as v, nearestTablaBpm as w, normalizeBase as x, probeUrl as y, quantizeLoopEnd as z };

package/dist/spec/index.cjs

@@ -203,7 +203,7 @@ function hasTivra(letter) {
 }
 
 // src/spec/index.ts
-var SPEC_VERSION = "0.9.2";
+var SPEC_VERSION = "0.10.0";
 function parseSwaralipi(data) {
   return swaralipiSchema.parse(data);
 }

package/dist/spec/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/**\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.2';\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"]}
+{"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.10.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/spec/index.d.cts

@@ -27,7 +27,7 @@ declare function hasKomal(letter: SvaraLetter): boolean;
 declare function hasTivra(letter: SvaraLetter): boolean;
 
 /** Current spec version. Documents declare the version they target. */
-declare const SPEC_VERSION = "0.9.2";
+declare const SPEC_VERSION = "0.10.0";
 
 /** Parse + validate unknown data into a `Swaralipi`. Throws `ZodError` on failure. */
 declare function parseSwaralipi(data: unknown): Swaralipi;

package/dist/spec/index.d.ts

@@ -27,7 +27,7 @@ declare function hasKomal(letter: SvaraLetter): boolean;
 declare function hasTivra(letter: SvaraLetter): boolean;
 
 /** Current spec version. Documents declare the version they target. */
-declare const SPEC_VERSION = "0.9.2";
+declare const SPEC_VERSION = "0.10.0";
 
 /** Parse + validate unknown data into a `Swaralipi`. Throws `ZodError` on failure. */
 declare function parseSwaralipi(data: unknown): Swaralipi;

package/dist/spec/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-F23LZMIU.js';
+export { SPEC_VERSION, barSchema, bracketSchema, graceSchema, laySchema, metaSchema, microtoneSchema, noteSchema, octaveSchema, parseSwaralipi, partSchema, rowSchema, safeParseSwaralipi, svaraLetterSchema, svaraSchema, swaralipiSchema, taalSchema } from '../chunk-I5GJWSD2.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/viewer/index.cjs

@@ -281,7 +281,7 @@ var init_spec = __esm({
     init_grace();
     init_lay();
     init_svara();
-    SPEC_VERSION = "0.9.2";
+    SPEC_VERSION = "0.10.0";
   }
 });
 
@@ -533,6 +533,11 @@ var FREE_TAAL_LABELS = {
   hi: "\u092E\u0941\u0915\u094D\u0924\u091B\u0902\u0926",
   en: "Free rhythm"
 };
+var PRACTICE_LABELS = {
+  bn: { sheet: "\u09B8\u09CD\u09AC\u09B0\u09B2\u09BF\u09AA\u09BF \u2014 \u09AF\u09C7 \u09B2\u09BE\u0987\u09A8 \u09A5\u09C7\u0995\u09C7 \u09B6\u09C1\u09A8\u09A4\u09C7 \u099A\u09BE\u09A8, \u09B8\u09C7\u0996\u09BE\u09A8\u09C7 \u099B\u09C1\u0981\u09AF\u09BC\u09C7 \u09A6\u09BF\u09A8", repeat: "\u09B2\u09BE\u0987\u09A8\u099F\u09BF \u09AC\u09BE\u09B0\u09AC\u09BE\u09B0 \u09AC\u09BE\u099C\u09AC\u09C7", turn: "\u098F\u09AC\u09BE\u09B0 \u0986\u09AA\u09A8\u09BF \u0997\u09BE\u09A8" },
+  hi: { sheet: "\u0938\u094D\u0935\u0930\u0932\u093F\u092A\u093F \u2014 \u091C\u093F\u0938 \u092A\u0902\u0915\u094D\u0924\u093F \u0938\u0947 \u0938\u0941\u0928\u0928\u093E \u0939\u094B, \u0909\u0938\u0947 \u091B\u0941\u090F\u0901", repeat: "\u092A\u0902\u0915\u094D\u0924\u093F \u0926\u094B\u0939\u0930\u093E\u0908 \u091C\u093E \u0930\u0939\u0940 \u0939\u0948", turn: "\u0905\u092C \u0906\u092A \u0917\u093E\u0907\u090F" },
+  en: { sheet: "Swaralipi \u2014 tap a line to play from it", repeat: "Repeating the line", turn: "Your turn \u2014 sing" }
+};
 function composeCluster(letter, opts) {
   const classes = [];
   if (opts.lang === "bn") {
@@ -975,7 +980,7 @@ function renderRow(row, partIdx, rowIdx, offset, ctx) {
     if (below.length > 0)
       out.push(`<span class="sw-below" style="grid-column:${col}">${renderAnnotation(below, ctx)}</span>`);
   });
-  return `<div class="sw-row">${out.join("")}</div>`;
+  return `<div class="sw-row" data-row="${partIdx}.${rowIdx}">${out.join("")}</div>`;
 }
 function renderHeader(meta, ctx) {
   return renderMetaHeader(meta, ctx.lang, ctx.tr);
@@ -1347,6 +1352,55 @@ ${FONT_FACES}
    glyph fill/stroke instead (abcjs draws note heads/stems as filled paths). */
 .sw-staff .sw-hl, .sw-staff .sw-hl * { fill: var(--sw-hl-note, #d68400); stroke: var(--sw-hl-note, #d68400); }
 
+/* ---- practice: tap a line, repeat it, sing it back ----
+ * Only a sheet a player drives is [seekable]. The whole line is the tap
+ * target, so it is the line that answers the pointer. A repeat shades its
+ * lines and fades the rest (focus, as Soundslice fades outside a loop); on the
+ * learner's pass the highlight goes hollow \u2014 it marks where to sing, not what
+ * is sounding \u2014 and the repeat's first line wears a "your turn" tag. None of
+ * it moves a column: backgrounds, opacity and an out-of-flow tag only. */
+:host([seekable]) .sw-row { cursor: pointer; }
+:host(:focus-visible) { outline: 2px solid var(--sw-focus, currentColor); outline-offset: 0.3em; border-radius: 0.2em; }
+.sw-row { border-radius: 0.3em; }
+@media (hover: hover) {
+  :host([seekable]) .sw-row:hover { background: var(--sw-row-hover, rgba(128, 128, 128, 0.08)); }
+}
+.sw-looping .sw-row:not(.sw-loop) { opacity: 0.6; }
+.sw-row.sw-loop {
+  background: var(--sw-loop, rgba(255, 196, 64, 0.13));
+  box-shadow: inset 0.2em 0 var(--sw-loop-edge, #a85a00);
+}
+.sw-hl.sw-hl-turn { background: none; box-shadow: inset 0 0 0 0.09em var(--sw-loop-edge, #a85a00); }
+/* The tag rides the line's above-band at its right end \u2014 a grid item spanning
+   every column, so it sizes no track \u2014 and is sticky, so on a phone where the
+   line runs past the screen it waits at the visible edge instead. */
+.sw-row[data-turn]::after {
+  content: attr(data-turn);
+  grid-column: 1 / -1;
+  grid-row: 1;
+  justify-self: end;
+  align-self: start;
+  position: sticky;
+  right: 0.2em;
+  translate: 0 -0.3em;
+  font-size: max(0.6em, 0.7rem);
+  font-weight: 600;
+  line-height: 1.6;
+  padding: 0 0.7em;
+  border-radius: 1em;
+  color: var(--sw-turn-ink, #fff);
+  background: var(--sw-loop-edge, #a85a00);
+}
+.sw-live { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
+@media (prefers-reduced-motion: no-preference) {
+  .sw-row { transition: opacity 0.25s, background-color 0.25s; }
+}
+@media print {
+  .sw-row { opacity: 1 !important; background: none !important; box-shadow: none !important; }
+  .sw-row[data-turn]::after { content: none; }
+  .sw-hl { background: none !important; box-shadow: none !important; }
+}
+
 /* ---- element error box ---- */
 .sw-error {
   font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
@@ -1901,6 +1955,17 @@ async function loadLyricTransliterator(lang) {
 
 // src/viewer/element.ts
 var LANGS = /* @__PURE__ */ new Set(["bn", "hi", "en", "staff"]);
+var KEYS = "Space ArrowUp ArrowDown ArrowLeft ArrowRight Home End R T Escape Shift+ArrowUp Shift+ArrowDown";
+function nearest(els, x) {
+  let best;
+  let gap = Infinity;
+  for (const el of els) {
+    const r = el.getBoundingClientRect();
+    const d = Math.abs(r.left + r.width / 2 - x);
+    if (d < gap) [best, gap] = [el, d];
+  }
+  return best;
+}
 function ensureNotationFonts() {
   if (typeof FontFace === "undefined" || typeof document === "undefined") return;
   const present = /* @__PURE__ */ new Set();
@@ -1913,7 +1978,7 @@ function ensureNotationFonts() {
 var sharedSheet;
 function createElementClass() {
   return class SwaralipiSheet extends HTMLElement {
-    static observedAttributes = ["src", "lang", "hide-header", "min-spacing", "min-size"];
+    static observedAttributes = ["src", "lang", "hide-header", "min-spacing", "min-size", "seekable"];
     #doc;
     #root;
     #adopted = false;
@@ -1925,10 +1990,20 @@ function createElementClass() {
     #resize;
     #fittedAt = -1;
     #zoom = 1;
+    /** Where the pointer went down, to tell a tap from a drag. */
+    #down;
+    #marks = { loop: null, turn: false };
+    /** Attributes `seekable` added, and so takes away again. */
+    #owned = [];
     validate = false;
     constructor() {
       super();
       this.#root = this.attachShadow({ mode: "open" });
+      this.#root.addEventListener("pointerdown", (e) => {
+        const { clientX, clientY } = e;
+        this.#down = [clientX, clientY];
+      });
+      this.#root.addEventListener("click", (e) => this.#onClick(e));
       if (typeof CSSStyleSheet !== "undefined" && "replaceSync" in CSSStyleSheet.prototype && "adoptedStyleSheets" in this.#root) {
         if (!sharedSheet) {
           sharedSheet = new CSSStyleSheet();
@@ -1962,6 +2037,27 @@ function createElementClass() {
       const attr = this.getAttribute("lang");
       return attr !== null && LANGS.has(attr) ? attr : "bn";
     }
+    get #practice() {
+      const lang = this.#lang;
+      return PRACTICE_LABELS[lang === "staff" ? "en" : lang];
+    }
+    /** A tap on a line plays from the note nearest the tap: the whole line is
+     * the target (WCAG 2.5.8 counts a position inside one target as picking
+     * a value), fired on the up-event like any click (2.5.2). The player bound
+     * by bindSheet answers it; a host can veto it with preventDefault(). */
+    #onClick(e) {
+      if (!this.hasAttribute("seekable") || e.button !== 0 || e.ctrlKey || e.metaKey || e.altKey) return;
+      if (this.#down !== void 0 && Math.hypot(e.clientX - this.#down[0], e.clientY - this.#down[1]) > 6) return;
+      const target = e.target;
+      const row = target.closest(".sw-row");
+      const notes = row === null ? [] : [...row.querySelectorAll("[data-note]:not(.sw-bar)")];
+      const hit = target.closest("[data-note]:not(.sw-bar)") ?? nearest(notes, e.clientX);
+      const path = hit?.getAttribute("data-note");
+      if (path == null) return;
+      this.dispatchEvent(
+        new CustomEvent("swaralipi-seek", { detail: { path, extend: e.shiftKey }, bubbles: true, cancelable: true })
+      );
+    }
     attributeChangedCallback(name, oldValue, newValue) {
       if (oldValue === newValue) return;
       if (name === "src") {
@@ -1972,6 +2068,19 @@ function createElementClass() {
         this.fit();
         return;
       }
+      if (name === "seekable") {
+        for (const a of this.#owned) this.removeAttribute(a);
+        this.#owned = [];
+        if (newValue === null) return;
+        const want = { tabindex: "0", role: "region", "aria-label": this.#practice.sheet, "aria-keyshortcuts": KEYS };
+        for (const [a, v] of Object.entries(want)) {
+          if (this.hasAttribute(a)) continue;
+          this.setAttribute(a, v);
+          this.#owned.push(a);
+        }
+        return;
+      }
+      if (name === "lang" && this.#owned.includes("aria-label")) this.setAttribute("aria-label", this.#practice.sheet);
       if (name === "lang") this.#ensureTransliterator();
       this.#render();
     }
@@ -2084,7 +2193,9 @@ function createElementClass() {
       if (lang === "staff") {
         const doc = this.#doc;
         void renderStaffHtml(doc, this.staffOptions).then((html2) => {
-          if (seq === this.#renderSeq) this.#root.innerHTML = this.#styleFallback() + html2;
+          if (seq !== this.#renderSeq) return;
+          this.#root.innerHTML = this.#styleFallback() + html2;
+          this.#applyMarks();
         }).catch(() => void 0);
         return;
       }
@@ -2094,8 +2205,34 @@ function createElementClass() {
         transliterate: this.#translitLang === lang ? this.#translit : void 0
       });
       this.#root.innerHTML = this.#styleFallback() + html;
+      this.#applyMarks();
       this.#fit();
     }
+    markLoop(loop, yourTurn = false) {
+      this.#marks = { loop, turn: yourTurn };
+      this.#applyMarks();
+    }
+    /** Shade the repeated lines and dim the rest; the first of them carries
+     * the "your turn" cue. A polite live region says the same aloud. */
+    #applyMarks() {
+      const { loop, turn } = this.#marks;
+      const rows = [...this.#root.querySelectorAll(".sw-row")];
+      const at = (row) => rows.findIndex((r) => r.dataset.row === row);
+      const [a, b] = loop === null ? [0, -1] : [at(loop.from), at(loop.to)];
+      rows.forEach((r, i) => {
+        r.classList.toggle("sw-loop", i >= a && i <= b);
+        if (turn && i === a) r.dataset.turn = this.#practice.turn;
+        else delete r.dataset.turn;
+      });
+      this.#root.querySelector(".sw-block")?.classList.toggle("sw-looping", loop !== null);
+      let live = this.#root.querySelector(".sw-live");
+      if (live === null) {
+        live = Object.assign(document.createElement("div"), { className: "sw-live" });
+        live.setAttribute("role", "status");
+        this.#root.append(live);
+      }
+      live.textContent = turn ? this.#practice.turn : loop !== null ? this.#practice.repeat : "";
+    }
     #renderError(message) {
       const div = document.createElement("div");
       div.className = "sw-error";
@@ -2103,14 +2240,15 @@ function createElementClass() {
       this.#root.innerHTML = this.#styleFallback();
       this.#root.appendChild(div);
     }
-    highlight(path) {
+    highlight(path, yourTurn = false) {
       if (!/^\d+\.\d+\.\d+$/.test(path)) return null;
       const el = this.#root.querySelector(`[data-note="${path}"]`);
       el?.classList.add("sw-hl");
+      el?.classList.toggle("sw-hl-turn", yourTurn);
       return el;
     }
     clearHighlights() {
-      for (const el of this.#root.querySelectorAll(".sw-hl")) el.classList.remove("sw-hl");
+      for (const el of this.#root.querySelectorAll(".sw-hl")) el.classList.remove("sw-hl", "sw-hl-turn");
     }
     print(options = {}) {
       if (this.#doc === void 0) return;
@@ -2149,6 +2287,7 @@ exports.MARKS = MARKS;
 exports.MAX_ZOOM = MAX_ZOOM;
 exports.MIN_ZOOM = MIN_ZOOM;
 exports.NOTATION_FONT_URLS = NOTATION_FONT_URLS;
+exports.PRACTICE_LABELS = PRACTICE_LABELS;
 exports.SWARALIPI_CSS = SWARALIPI_CSS;
 exports.SWARALIPI_PRINT_CSS = SWARALIPI_PRINT_CSS;
 exports.SWARALIPI_STAFF_CSS = SWARALIPI_STAFF_CSS;