@ugfoundation/swaralipi-js 0.1.0

package/dist/convert/index.d.ts

@@ -0,0 +1,270 @@
+import { S as Swaralipi, N as Note, T as Taal } from '../schema-gxhG45OK.js';
+import 'zod';
+
+/**
+ * NLTR HTML extraction — the lowest layer of the converter.
+ *
+ * The 1,738 cached NLTR pages are machine-generated and 100% structurally
+ * uniform (verified across all 2.79M cells), so extraction is deliberately
+ * a strict regex parse with a count assertion rather than a lenient DOM
+ * walk: any structural surprise fails the file loudly (`ExtractError`)
+ * instead of silently mis-treeing.
+ *
+ * Page anatomy:
+ *  - a metadata table of `style3` triples: label (নাম / তাল / আবর্তন), ':',
+ *    value;
+ *  - one grid of cells `<td width='auto' id=R.C> <span class='styleN'>
+ *    <div align='center'>TOKEN</div></span></td>` where `id` is the
+ *    `row.col` coordinate (often unquoted) and `&nbsp;` marks an empty cell.
+ */
+/** One grid cell. `text` is entity-decoded and whitespace-normalized ('' = empty). */
+interface RawCell {
+    row: number;
+    col: number;
+    /** `style1` = Swarabitan notation, `style2` = Bengali lyric. */
+    style: string;
+    text: string;
+}
+/** The style3 metadata header values, verbatim (Bengali). */
+interface NltrHeader {
+    title?: string;
+    taalNameRaw?: string;
+    avartanRaw?: string;
+    /** NLTR's internal print node id (`/print/<id>`), for provenance. */
+    printId?: number;
+}
+interface NltrPage {
+    header: NltrHeader;
+    cells: RawCell[];
+    maxRow: number;
+}
+/** Structural surprise in the source HTML (not a decode problem). */
+declare class ExtractError extends Error {
+    constructor(message: string);
+}
+/** Parse one NLTR swaralipi page. Throws `ExtractError` on structural surprise. */
+declare function extractPage(html: string): NltrPage;
+
+/**
+ * Conversion reporting: per-file decode statistics and the batch aggregate.
+ * The unknown-token histogram is the feedback loop for growing the codec.
+ */
+interface FileReport {
+    nltrId?: number;
+    title: string;
+    taalName?: string;
+    taalId?: string;
+    taalMatched: 'taals' | 'table' | 'geometry' | 'none';
+    systems: number;
+    notationCells: number;
+    lyricCells: number;
+    annotationCells: number;
+    /** Notation cells with ≥1 semantic note and no unknown chunk. */
+    decodedCells: number;
+    /** Notation cells consisting only of understood-but-raw marks. */
+    knownRawCells: number;
+    /** Notation cells containing ≥1 chunk outside the grammar. */
+    unknownCells: number;
+    unknownTokens: Record<string, number>;
+    lyricAlignMismatches: number;
+    warnings: string[];
+}
+interface BatchFailure {
+    file: string;
+    error: string;
+}
+interface BatchReport {
+    files: number;
+    ok: number;
+    failed: number;
+    failures: BatchFailure[];
+    systems: number;
+    notationCells: number;
+    lyricCells: number;
+    annotationCells: number;
+    decodedCells: number;
+    knownRawCells: number;
+    unknownCells: number;
+    /** decoded / (decoded + knownRaw + unknown) over notation cells. */
+    decodeRate: number;
+    unknownRate: number;
+    /** All unknown tokens, sorted by frequency (descending). */
+    unknownTokens: Record<string, number>;
+    lyricAlignMismatches: number;
+    /** taalName → count + resolution outcome. */
+    taals: Record<string, {
+        count: number;
+        taalId?: string;
+        matched: string;
+    }>;
+    warningCounts: Record<string, number>;
+}
+declare function aggregate(reports: FileReport[], failures: BatchFailure[]): BatchReport;
+declare function formatSummary(r: BatchReport): string;
+
+/**
+ * Assembly: systems → spec document.
+ *
+ * Each system becomes one `Row`. Within a row, columns are walked in order;
+ * a notation cell's decoded notes join the row, with the column-aligned
+ * lyric / above / below content attached to the cell's first note. Columns
+ * that have lyric or annotation content but no notation emit a carrier note
+ * (legal per the spec refine). The whole song is one unnamed part: NLTR
+ * prints no section labels, and `ll` cannot be split on safely because it
+ * also marks mid-song asthayi returns.
+ */
+
+interface ConvertOptions {
+    /** NLTR song/node id (usually the source filename). */
+    nltrId?: number;
+    /** Override the provenance URL stored in `meta.source`. */
+    source?: string;
+}
+interface ConvertResult {
+    doc: Swaralipi;
+    report: FileReport;
+}
+/** Split a lyric cell into grapheme clusters (ক+া = 1, র+্ = 1, ৹ = 1). */
+declare function splitLyric(text: string): string[];
+declare function assemble(page: NltrPage, opts?: ConvertOptions): ConvertResult;
+
+/**
+ * Grid → systems.
+ *
+ * Rows group into 4-row "systems", role given by `row % 4` (verified with
+ * zero exceptions across the whole corpus):
+ *   0 → annotation row rendered ABOVE the staff (alt-on-repeat passages,
+ *       stop marks, beat numbers — sparse),
+ *   1 → notation row (style1, Swarabitan codes),
+ *   2 → annotation row rendered BELOW the staff (sparse),
+ *   3 → lyric row (style2, Bengali).
+ * Cells align across the four rows strictly by column id (rows can be
+ * ragged, so never align by index).
+ */
+
+interface System {
+    /** System index (source rows 4k..4k+3). */
+    index: number;
+    above: Map<number, string>;
+    notation: Map<number, string>;
+    below: Map<number, string>;
+    lyric: Map<number, string>;
+    maxCol: number;
+}
+declare function buildSystems(page: NltrPage): {
+    systems: System[];
+    warnings: string[];
+};
+
+/**
+ * The Swarabitan ASCII codec: decode one grid-cell text into spec `Note`s.
+ *
+ * NLTR renders notation through the legacy "Swarabitan" webfont, which maps
+ * ASCII to akarmatrik glyphs. The table below was derived by dumping every
+ * glyph of `Swarabitan.woff` (tools/font-dump/) and cross-checking against
+ * the Swarabitan legend scans, the rendered reference screenshot of song
+ * 4270, and corpus-wide token statistics. Evidence per assignment:
+ *
+ *   Letters (full-size glyphs):
+ *     s=স r=র g=গ m=ম p=প q=ধ n=ন        — the seven shuddha letters
+ *     d=দ (komal dha)  t=জ্ঞ (komal ga)   — legend: কোমল র—ঋ, কোমল গ—জ্ঞ,
+ *     k=ক্ষ (tivra ma)  u=ণ (komal ni)    —   কড়ি ম—ক্ষ, কোমল ধ—দ, কোমল ন—ণ
+ *     v=ঋ (komal re)
+ *   Modifiers:
+ *     f = রেফ above   → taar octave   (zero-width high combining mark)
+ *     h = হসন্ত below → mandra octave (low combining mark; corpus nh/uh/dh/ph)
+ *     leading '-' = no new vowel attack (melisma; lyric row shows ৹)
+ *     trailing 'a' = the আ-কার matra carrier; k letter-units in one cell
+ *                    share it → k notes of 1/k matra each
+ *     UPPERCASE letter = small raised form = কণ (kan/grace) prefix; takes its
+ *                    own f/h (corpus: Sfua, NHsa, QHpha); width ratios ~0.65
+ *                    confirm uppercase↔lowercase pairing
+ *   Structurals (own cells):
+ *     A = thin full-height bar  → দাঁড়ি vibhag separator (fixed columns)
+ *     l = serif danda I         → cycle end; ll / single-glyph L = section
+ *     %=সা &=নি  — precomposed one-matra forms (rare)
+ *   Known-but-kept-raw marks (drawn pieces the spec doesn't model yet):
+ *     w x = left/right ends of a long under-arc; E J j y $ < > = _ = arc/line
+ *     fill segments; | = thin yugal-dari stop mark (mostly annotation rows);
+ *     digits/!/@ (+f/F sam tick) = taal beat labels; b=× o O e ` + , . i : ;
+ *     = dots/ticks/duration marks; B C * ^ ~ c = rare precomposed/legacy forms.
+ *
+ * Decoding never throws: any chunk outside the grammar becomes a raw-only
+ * note and is reported as unknown — zero data loss by construction.
+ */
+
+interface CellDecode {
+    notes: Note[];
+    /** Chunks that failed the grammar (reported, kept as raw notes). */
+    unknownTokens: string[];
+    /** Chunks understood but intentionally left raw (marks, beat labels …). */
+    knownRawTokens: string[];
+    /** True if at least one chunk decoded to a semantic note. */
+    decoded: boolean;
+}
+/**
+ * Decode one cell's text. Multi-chunk cells (whitespace-separated) emit
+ * notes in order; the first note of each chunk carries that chunk's source
+ * text in `raw`, so joining a cell's `raw` values with spaces reproduces
+ * the normalized cell text (the lossless property tests rely on this).
+ */
+declare function decodeCell(text: string): CellDecode;
+
+/**
+ * Resolve the printed Bengali তাল name (+ the grid's own geometry) into a
+ * spec `Taal`.
+ *
+ * Evidence chain, strongest first:
+ *  1. bhaag hints in the name itself — `ধামার(৩/২/২/৩/৪)` → [3,2,2,3,4];
+ *  2. the name table below (the 7 player-sampled taals from TAALS, plus
+ *     well-attested Rabindrik taals with stable definitions);
+ *  3. the grid geometry: bar/dari columns partition each cycle into bhaags
+ *     (`numCols = avartan × (numBeats + nDaris) + 1` held on every checked
+ *     song), which both derives unknown taals and cross-checks named ones.
+ * তালমুক্ত (free rhythm) and unresolvable names yield no `taal`; the
+ * verbatim name always lands in `meta.taalName`.
+ */
+
+/** Parse an integer written with Bengali or ASCII digits. */
+declare function bnInt(s: string | undefined): number | undefined;
+interface GridGeometry {
+    /** Total columns of the widest full notation row. */
+    numCols: number;
+    /** Matra count of one cycle (notes between cycle bars, daris excluded). */
+    numBeats?: number;
+    /** Bhaag division of one cycle, from dari positions. */
+    bhaags?: number[];
+}
+/**
+ * Derive cycle geometry from the first notation row shaped `bar … bar`.
+ * Returns per-cycle numBeats/bhaags when at least one full cycle is visible.
+ */
+declare function deriveGeometry(systems: System[]): GridGeometry | undefined;
+interface ResolvedTaal {
+    taal?: Taal;
+    taalName?: string;
+    avartan?: number;
+    /** Which evidence resolved the taal. */
+    matched: 'taals' | 'table' | 'geometry' | 'none';
+    warnings: string[];
+}
+declare function resolveTaal(nameRaw: string | undefined, avartanRaw: string | undefined, geometry: GridGeometry | undefined): ResolvedTaal;
+
+/**
+ * @ugfoundation/swaralipi-js/convert
+ *
+ * NLTR HTML → swaralipi JSON converter (Node-only subpath export).
+ * `convertNltrHtml` itself is pure (string in, document out); file/dir
+ * batch helpers live in the CLI (`swaralipi convert`).
+ */
+
+/**
+ * Convert one NLTR swaralipi page (HTML source text) into a validated
+ * spec document plus a decode report.
+ *
+ * Throws `ExtractError` when the HTML does not look like an NLTR swaralipi
+ * grid; cell-level decode problems never throw (they degrade to `raw`).
+ */
+declare function convertNltrHtml(html: string, opts?: ConvertOptions): ConvertResult;
+
+export { type BatchFailure, type BatchReport, type CellDecode, type ConvertOptions, type ConvertResult, ExtractError, type FileReport, type GridGeometry, type NltrHeader, type NltrPage, type RawCell, type ResolvedTaal, type System, aggregate, assemble, bnInt, buildSystems, convertNltrHtml, decodeCell, deriveGeometry, extractPage, formatSummary, resolveTaal, splitLyric };

package/dist/convert/index.js

@@ -0,0 +1,5 @@
+export { ExtractError, aggregate, assemble, bnInt, buildSystems, convertNltrHtml, decodeCell, deriveGeometry, extractPage, formatSummary, resolveTaal, splitLyric } from '../chunk-N3NNWAOW.js';
+import '../chunk-C6O7DYU5.js';
+import '../chunk-GWXI2HJA.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/convert/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/index.cjs

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

package/dist/index.cjs.map

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

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+export { SPEC_VERSION, parseSwaralipi, safeParseSwaralipi } from './spec/index.cjs';
+export { B as Bar, b as Bracket, 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, m as metaSchema, g as microtoneSchema, n as noteSchema, o as octaveSchema, p as partSchema, r as rowSchema, s as svaraLetterSchema, h as svaraSchema, i as swaralipiSchema, t as taalSchema } from './schema-gxhG45OK.cjs';
+export { a as TAALS, T as TaalId } from './taals-DguYW0wf.cjs';
+import 'zod';

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { SPEC_VERSION, parseSwaralipi, safeParseSwaralipi } from './spec/index.js';
+export { B as Bar, b as Bracket, 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, m as metaSchema, g as microtoneSchema, n as noteSchema, o as octaveSchema, p as partSchema, r as rowSchema, s as svaraLetterSchema, h as svaraSchema, i as swaralipiSchema, t as taalSchema } from './schema-gxhG45OK.js';
+export { a as TAALS, T as TaalId } from './taals-DguYW0wf.js';
+import 'zod';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { SPEC_VERSION, barSchema, bracketSchema, metaSchema, microtoneSchema, noteSchema, octaveSchema, parseSwaralipi, partSchema, rowSchema, safeParseSwaralipi, svaraLetterSchema, svaraSchema, swaralipiSchema, taalSchema } from './chunk-C6O7DYU5.js';
+export { TAALS } from './chunk-GWXI2HJA.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}