@ugfoundation/swaralipi-js 0.8.2 → 0.9.1

package/dist/viewer/index.d.cts

@@ -1,6 +1,6 @@
-import { O as Octave, a as SvaraLetter, N as Note, M as Meta, S as Swaralipi, T as Taal } from '../schema-DGA_bNVZ.cjs';
-import { L as Lay } from '../lay-Csa4CD46.cjs';
-import { D as DrumVoice, S as Schedule, P as PlayEvent } from '../schedule-B_UaluBi.cjs';
+import { O as Octave, a as SvaraLetter, N as Note, M as Meta, S as Swaralipi, T as Taal } from '../schema-Cf_epUIC.cjs';
+import { L as Lay } from '../lay-CfDlPhH2.cjs';
+import { D as DrumVoice, S as Schedule, P as PlayEvent } from '../schedule-CU-VECDH.cjs';
 import 'zod';
 import 'tone';
 
@@ -31,6 +31,9 @@ declare const LABELS: Record<GridLang, {
  * term; en names the tempo first (a reader of the English sheet may not know
  * the word — the same call `LABELS.en` makes with "Cycles" over "Avartan"). */
 declare const LAY_LABELS: Record<GridLang, Record<Lay, string>>;
+/** Printed where a row switches to free rhythm (`row.taal: null`) with no
+ * `taalName` of its own. bn is the converter's canonical মুক্তছন্দ. */
+declare const FREE_TAAL_LABELS: Record<GridLang, string>;
 /** A composed notation cluster: the font's ASCII text plus any residual CSS
  * classes the font itself cannot express (only the bn ati-octave dot). */
 interface Cluster {
@@ -214,7 +217,7 @@ declare const ZOOM_STEP = 1.2;
  *   --sw-matra      minimum width of one matra column
  *   --sw-header-min floor for the নাম/তাল/আবর্তন header (it must stay legible
  *                   when the notation is scaled down to fit a phone)
- *   --sw-lay-min    same floor for the লয় (tempo tier) marker band
+ *   --sw-lay-min    same floor for the তাল / লয় change band
  *   --sw-hl         player-highlight background (P2.3)
  *   --sw-rule       header rule / muted line color
  *
@@ -242,7 +245,7 @@ declare const SWARALIPI_CSS: string;
  *  - rows are un-clipped (no scrollbar on paper) and kept whole across page
  *    breaks; part headings stay with their first row.
  */
-declare const SWARALIPI_PRINT_CSS = "\n@page { margin: 16mm; }\n@media print {\n  .sw-sheet, .sw-staff { -webkit-print-color-adjust: exact; print-color-adjust: exact; color: #000; }\n  .sw-scroll { overflow: visible !important; }\n  .sw-row { break-inside: avoid; page-break-inside: avoid; }\n  .sw-part-name, .sw-header, .sw-lay { break-after: avoid-page; page-break-after: avoid; }\n  .sw-hl { background: none !important; }\n  /* Keep each engraved staff system whole across a page break (the abcjs line\n     is a <div> wrapping the <svg>, so the break rule must sit on the div). */\n  .sw-staff-lines > div { break-inside: avoid; page-break-inside: avoid; }\n  .sw-staff-meta { break-after: avoid-page; page-break-after: avoid; }\n}\n";
+declare const SWARALIPI_PRINT_CSS = "\n@page { margin: 16mm; }\n@media print {\n  .sw-sheet, .sw-staff { -webkit-print-color-adjust: exact; print-color-adjust: exact; color: #000; }\n  .sw-scroll { overflow: visible !important; }\n  .sw-row { break-inside: avoid; page-break-inside: avoid; }\n  .sw-part-name, .sw-header, .sw-change { break-after: avoid-page; page-break-after: avoid; }\n  .sw-hl { background: none !important; }\n  /* Keep each engraved staff system whole across a page break (the abcjs line\n     is a <div> wrapping the <svg>, so the break rule must sit on the div). */\n  .sw-staff-lines > div { break-inside: avoid; page-break-inside: avoid; }\n  .sw-staff-meta { break-after: avoid-page; page-break-after: avoid; }\n}\n";
 /** Staff-notation (abcjs) wrapper chrome: instrument/tempo header + a fluid
  * SVG. The engraving itself is drawn by abcjs; this only frames it. */
 declare const SWARALIPI_STAFF_CSS = "\n.sw-staff { color: currentColor; }\n.sw-staff-meta { display: flex; gap: 1.25em; align-items: baseline; margin: 0 0 .5em; font-size: .95em; opacity: .85; }\n.sw-staff-instrument { font-weight: 600; }\n.sw-staff-drums { opacity: .75; }\n.sw-staff-tempo { font-variant-numeric: tabular-nums; }\n/* abcjs (oneSvgPerLine) wraps the music into one <div><svg> per system; stack\n   them as short, swaralipi-style lines. abcjs sets a fixed pixel height +\n   overflow:hidden on each wrapper div \u2014 neutralise it so the viewBox'd SVG can\n   scale to the container (and to the print page) instead of being clipped. */\n.sw-staff-lines > div { margin: 0 0 .35em; height: auto !important; overflow: visible !important; }\n/* Fill up to the engraved (staffwidth) size \u2014 shrink to fit a narrow container,\n   but never stretch past natural width (abcToSvg pins per-SVG max-width in px),\n   else a short last system balloons. */\n.sw-staff-lines svg { display: block; width: 100%; height: auto; }\n.sw-staff-missing { padding: 1em; border: 1px dashed currentColor; border-radius: 6px; opacity: .8; font-size: .9em; }\n.sw-staff-title { font-size: 1.15em; font-weight: 700; }\n.sw-staff-subtitle { opacity: .8; font-size: .95em; margin-top: .15em; }\n";
@@ -311,6 +314,15 @@ declare function midiToAbc(midi: number): string;
  * nearest 1/4-matra count of `/4` units so odd durations still sum correctly.
  */
 declare function abcDuration(beats: number): string;
+/** One তাল stretch of the score: its meter, and drum voices when drums are on. */
+interface AbcMeter {
+    /** Start, in schedule beats. */
+    beat: number;
+    /** Matra per bar (one তাল cycle) from here on. */
+    beatsPerBar: number;
+    /** Per-matra drum voices from here on; `undefined` rests (মুক্তছন্দ). */
+    drums?: DrumVoice[];
+}
 /**
  * Build a complete ABC tune string from a schedule. Pure and dependency-free
  * (the testable seam). Rests advance time as `z`; melody notes carry duration;
@@ -326,15 +338,21 @@ declare function abcDuration(beats: number): string;
  * pattern one quarter-note per matra with `%%percmap` GM drum sounds (see
  * `buildDrumVoice`). Both voices share the same bar grid, so they wrap and
  * align together.
+ *
+ * `meters`, if given, is one entry per তাল stretch (তালফেরতা): at each start
+ * the running bar is closed and the new meter restated inline as `[M:n/4]` —
+ * the bracketed form, because a bare `M:` line forces a new system.
  */
 declare function buildAbc(schedule: Schedule, lyricOf: (ev: PlayEvent) => string | undefined, opts: {
     bpm: number;
     lyrics: boolean;
     beatsPerBar: number;
     drums?: DrumVoice[];
+    meters?: AbcMeter[];
 }): string;
 /** Build the ABC tune string for a whole document (schedule + lyrics + tempo).
- * The measure length is one তাল cycle (`meta.taal.numBeats`), falling back to 4.
+ * The measure length is one তাল cycle — per stretch, so a তালফেরতা changes the
+ * time signature where the taal changes — falling back to 4.
  * `opts.drums` adds the percussion staff (see `buildAbc`). */
 declare function docToAbc(doc: Swaralipi, opts?: StaffOptions): string;
 /**
@@ -533,4 +551,4 @@ type Transliterator = (bengaliText: string) => string;
  */
 declare function loadLyricTransliterator(lang: ViewerLang): Promise<Transliterator | undefined>;
 
-export { type Arc, type Cell, type Cluster, type ComposeOptions, DEFAULT_NOTATOR, DEFAULT_WATERMARK, DIGITS, type GridLang, LABELS, LAY_LABELS, type Layout, MARKS, MAX_ZOOM, MIN_ZOOM, NOTATION_FONT_URLS, type PrintOptions, type RenderOptions, SWARALIPI_CSS, SWARALIPI_PRINT_CSS, SWARALIPI_STAFF_CSS, type StaffOptions, type SwaralipiSheetElement, type TaalStaffOptions, type Transliterator, type ViewerLang, ZOOM_STEP, abcDuration, abcToSvg, alignRows, buildAbc, buildTaalAbc, cellMatra, composeCluster, defineSwaralipiSheet, docToAbc, fitSwaralipi, groupRowIntoCells, loadLyricTransliterator, localizeDigits, midiToAbc, printSwaralipi, renderMetaHeader, renderPrintDocument, renderStaffHtml, renderStaffPrintDocument, renderTaalStaffHtml, renderToHtml, resolveArcs };
+export { type AbcMeter, type Arc, type Cell, type Cluster, type ComposeOptions, DEFAULT_NOTATOR, DEFAULT_WATERMARK, DIGITS, FREE_TAAL_LABELS, type GridLang, LABELS, LAY_LABELS, type Layout, MARKS, MAX_ZOOM, MIN_ZOOM, NOTATION_FONT_URLS, type PrintOptions, type RenderOptions, SWARALIPI_CSS, SWARALIPI_PRINT_CSS, SWARALIPI_STAFF_CSS, type StaffOptions, type SwaralipiSheetElement, type TaalStaffOptions, type Transliterator, type ViewerLang, ZOOM_STEP, abcDuration, abcToSvg, alignRows, buildAbc, buildTaalAbc, cellMatra, composeCluster, defineSwaralipiSheet, docToAbc, fitSwaralipi, groupRowIntoCells, loadLyricTransliterator, localizeDigits, midiToAbc, printSwaralipi, renderMetaHeader, renderPrintDocument, renderStaffHtml, renderStaffPrintDocument, renderTaalStaffHtml, renderToHtml, resolveArcs };

package/dist/viewer/index.d.ts

@@ -1,6 +1,6 @@
-import { O as Octave, a as SvaraLetter, N as Note, M as Meta, S as Swaralipi, T as Taal } from '../schema-DGA_bNVZ.js';
-import { L as Lay } from '../lay-Ct9ky_EE.js';
-import { D as DrumVoice, S as Schedule, P as PlayEvent } from '../schedule-CdILTNsk.js';
+import { O as Octave, a as SvaraLetter, N as Note, M as Meta, S as Swaralipi, T as Taal } from '../schema-Cf_epUIC.js';
+import { L as Lay } from '../lay-CZIzR9cM.js';
+import { D as DrumVoice, S as Schedule, P as PlayEvent } from '../schedule-BaovCtmf.js';
 import 'zod';
 import 'tone';
 
@@ -31,6 +31,9 @@ declare const LABELS: Record<GridLang, {
  * term; en names the tempo first (a reader of the English sheet may not know
  * the word — the same call `LABELS.en` makes with "Cycles" over "Avartan"). */
 declare const LAY_LABELS: Record<GridLang, Record<Lay, string>>;
+/** Printed where a row switches to free rhythm (`row.taal: null`) with no
+ * `taalName` of its own. bn is the converter's canonical মুক্তছন্দ. */
+declare const FREE_TAAL_LABELS: Record<GridLang, string>;
 /** A composed notation cluster: the font's ASCII text plus any residual CSS
  * classes the font itself cannot express (only the bn ati-octave dot). */
 interface Cluster {
@@ -214,7 +217,7 @@ declare const ZOOM_STEP = 1.2;
  *   --sw-matra      minimum width of one matra column
  *   --sw-header-min floor for the নাম/তাল/আবর্তন header (it must stay legible
  *                   when the notation is scaled down to fit a phone)
- *   --sw-lay-min    same floor for the লয় (tempo tier) marker band
+ *   --sw-lay-min    same floor for the তাল / লয় change band
  *   --sw-hl         player-highlight background (P2.3)
  *   --sw-rule       header rule / muted line color
  *
@@ -242,7 +245,7 @@ declare const SWARALIPI_CSS: string;
  *  - rows are un-clipped (no scrollbar on paper) and kept whole across page
  *    breaks; part headings stay with their first row.
  */
-declare const SWARALIPI_PRINT_CSS = "\n@page { margin: 16mm; }\n@media print {\n  .sw-sheet, .sw-staff { -webkit-print-color-adjust: exact; print-color-adjust: exact; color: #000; }\n  .sw-scroll { overflow: visible !important; }\n  .sw-row { break-inside: avoid; page-break-inside: avoid; }\n  .sw-part-name, .sw-header, .sw-lay { break-after: avoid-page; page-break-after: avoid; }\n  .sw-hl { background: none !important; }\n  /* Keep each engraved staff system whole across a page break (the abcjs line\n     is a <div> wrapping the <svg>, so the break rule must sit on the div). */\n  .sw-staff-lines > div { break-inside: avoid; page-break-inside: avoid; }\n  .sw-staff-meta { break-after: avoid-page; page-break-after: avoid; }\n}\n";
+declare const SWARALIPI_PRINT_CSS = "\n@page { margin: 16mm; }\n@media print {\n  .sw-sheet, .sw-staff { -webkit-print-color-adjust: exact; print-color-adjust: exact; color: #000; }\n  .sw-scroll { overflow: visible !important; }\n  .sw-row { break-inside: avoid; page-break-inside: avoid; }\n  .sw-part-name, .sw-header, .sw-change { break-after: avoid-page; page-break-after: avoid; }\n  .sw-hl { background: none !important; }\n  /* Keep each engraved staff system whole across a page break (the abcjs line\n     is a <div> wrapping the <svg>, so the break rule must sit on the div). */\n  .sw-staff-lines > div { break-inside: avoid; page-break-inside: avoid; }\n  .sw-staff-meta { break-after: avoid-page; page-break-after: avoid; }\n}\n";
 /** Staff-notation (abcjs) wrapper chrome: instrument/tempo header + a fluid
  * SVG. The engraving itself is drawn by abcjs; this only frames it. */
 declare const SWARALIPI_STAFF_CSS = "\n.sw-staff { color: currentColor; }\n.sw-staff-meta { display: flex; gap: 1.25em; align-items: baseline; margin: 0 0 .5em; font-size: .95em; opacity: .85; }\n.sw-staff-instrument { font-weight: 600; }\n.sw-staff-drums { opacity: .75; }\n.sw-staff-tempo { font-variant-numeric: tabular-nums; }\n/* abcjs (oneSvgPerLine) wraps the music into one <div><svg> per system; stack\n   them as short, swaralipi-style lines. abcjs sets a fixed pixel height +\n   overflow:hidden on each wrapper div \u2014 neutralise it so the viewBox'd SVG can\n   scale to the container (and to the print page) instead of being clipped. */\n.sw-staff-lines > div { margin: 0 0 .35em; height: auto !important; overflow: visible !important; }\n/* Fill up to the engraved (staffwidth) size \u2014 shrink to fit a narrow container,\n   but never stretch past natural width (abcToSvg pins per-SVG max-width in px),\n   else a short last system balloons. */\n.sw-staff-lines svg { display: block; width: 100%; height: auto; }\n.sw-staff-missing { padding: 1em; border: 1px dashed currentColor; border-radius: 6px; opacity: .8; font-size: .9em; }\n.sw-staff-title { font-size: 1.15em; font-weight: 700; }\n.sw-staff-subtitle { opacity: .8; font-size: .95em; margin-top: .15em; }\n";
@@ -311,6 +314,15 @@ declare function midiToAbc(midi: number): string;
  * nearest 1/4-matra count of `/4` units so odd durations still sum correctly.
  */
 declare function abcDuration(beats: number): string;
+/** One তাল stretch of the score: its meter, and drum voices when drums are on. */
+interface AbcMeter {
+    /** Start, in schedule beats. */
+    beat: number;
+    /** Matra per bar (one তাল cycle) from here on. */
+    beatsPerBar: number;
+    /** Per-matra drum voices from here on; `undefined` rests (মুক্তছন্দ). */
+    drums?: DrumVoice[];
+}
 /**
  * Build a complete ABC tune string from a schedule. Pure and dependency-free
  * (the testable seam). Rests advance time as `z`; melody notes carry duration;
@@ -326,15 +338,21 @@ declare function abcDuration(beats: number): string;
  * pattern one quarter-note per matra with `%%percmap` GM drum sounds (see
  * `buildDrumVoice`). Both voices share the same bar grid, so they wrap and
  * align together.
+ *
+ * `meters`, if given, is one entry per তাল stretch (তালফেরতা): at each start
+ * the running bar is closed and the new meter restated inline as `[M:n/4]` —
+ * the bracketed form, because a bare `M:` line forces a new system.
  */
 declare function buildAbc(schedule: Schedule, lyricOf: (ev: PlayEvent) => string | undefined, opts: {
     bpm: number;
     lyrics: boolean;
     beatsPerBar: number;
     drums?: DrumVoice[];
+    meters?: AbcMeter[];
 }): string;
 /** Build the ABC tune string for a whole document (schedule + lyrics + tempo).
- * The measure length is one তাল cycle (`meta.taal.numBeats`), falling back to 4.
+ * The measure length is one তাল cycle — per stretch, so a তালফেরতা changes the
+ * time signature where the taal changes — falling back to 4.
  * `opts.drums` adds the percussion staff (see `buildAbc`). */
 declare function docToAbc(doc: Swaralipi, opts?: StaffOptions): string;
 /**
@@ -533,4 +551,4 @@ type Transliterator = (bengaliText: string) => string;
  */
 declare function loadLyricTransliterator(lang: ViewerLang): Promise<Transliterator | undefined>;
 
-export { type Arc, type Cell, type Cluster, type ComposeOptions, DEFAULT_NOTATOR, DEFAULT_WATERMARK, DIGITS, type GridLang, LABELS, LAY_LABELS, type Layout, MARKS, MAX_ZOOM, MIN_ZOOM, NOTATION_FONT_URLS, type PrintOptions, type RenderOptions, SWARALIPI_CSS, SWARALIPI_PRINT_CSS, SWARALIPI_STAFF_CSS, type StaffOptions, type SwaralipiSheetElement, type TaalStaffOptions, type Transliterator, type ViewerLang, ZOOM_STEP, abcDuration, abcToSvg, alignRows, buildAbc, buildTaalAbc, cellMatra, composeCluster, defineSwaralipiSheet, docToAbc, fitSwaralipi, groupRowIntoCells, loadLyricTransliterator, localizeDigits, midiToAbc, printSwaralipi, renderMetaHeader, renderPrintDocument, renderStaffHtml, renderStaffPrintDocument, renderTaalStaffHtml, renderToHtml, resolveArcs };
+export { type AbcMeter, type Arc, type Cell, type Cluster, type ComposeOptions, DEFAULT_NOTATOR, DEFAULT_WATERMARK, DIGITS, FREE_TAAL_LABELS, type GridLang, LABELS, LAY_LABELS, type Layout, MARKS, MAX_ZOOM, MIN_ZOOM, NOTATION_FONT_URLS, type PrintOptions, type RenderOptions, SWARALIPI_CSS, SWARALIPI_PRINT_CSS, SWARALIPI_STAFF_CSS, type StaffOptions, type SwaralipiSheetElement, type TaalStaffOptions, type Transliterator, type ViewerLang, ZOOM_STEP, abcDuration, abcToSvg, alignRows, buildAbc, buildTaalAbc, cellMatra, composeCluster, defineSwaralipiSheet, docToAbc, fitSwaralipi, groupRowIntoCells, loadLyricTransliterator, localizeDigits, midiToAbc, printSwaralipi, renderMetaHeader, renderPrintDocument, renderStaffHtml, renderStaffPrintDocument, renderTaalStaffHtml, renderToHtml, resolveArcs };

package/dist/viewer/index.js

@@ -1,5 +1,5 @@
-import { isArcRaw, glideTargets, buildSchedule, drumPattern } from '../chunk-4IVUPMRK.js';
-import { hasKomal, TAALS, graceNotes } from '../chunk-4HNT6OAT.js';
+import { isArcRaw, glideTargets, buildSchedule, drumPattern } from '../chunk-SEN266BY.js';
+import { hasKomal, isTaalFerta, sameTaal, TAALS, graceNotes } from '../chunk-MYVIQU4O.js';
 
 // src/viewer/glyphs.ts
 var SWARABITAN_SHUDDHA = {
@@ -49,6 +49,11 @@ var LAY_LABELS = {
   hi: { drut: "\u0926\u094D\u0930\u0941\u0924 \u0932\u092F", madhya: "\u092E\u0927\u094D\u092F \u0932\u092F", vilambit: "\u0935\u093F\u0932\u0902\u092C\u093F\u0924 \u0932\u092F" },
   en: { drut: "Fast (drut)", madhya: "Medium (madhya)", vilambit: "Slow (vilambit)" }
 };
+var FREE_TAAL_LABELS = {
+  bn: "\u09AE\u09C1\u0995\u09CD\u09A4\u099B\u09A8\u09CD\u09A6",
+  hi: "\u092E\u0941\u0915\u094D\u0924\u091B\u0902\u0926",
+  en: "Free rhythm"
+};
 function composeCluster(letter, opts) {
   const classes = [];
   if (opts.lang === "bn") {
@@ -521,15 +526,25 @@ function renderToHtml(doc, opts = {}) {
   out.push(`<div class="sw-scroll"><div class="sw-block" style="${tracks}">`);
   let n = 0;
   let lay;
+  let taal = doc.meta.taal;
+  let named = !isTaalFerta(doc.meta.taalName);
   doc.parts.forEach((part, p) => {
     out.push('<section class="sw-part">');
     if (part.name !== void 0)
       out.push(`<h3 class="sw-part-name">${escapeHtml(ctx.tr(part.name))}</h3>`);
     part.rows.forEach((row, r) => {
+      const marks = [];
+      if (row.taal !== void 0 && (!named || !sameTaal(row.taal, taal))) {
+        taal = row.taal;
+        named = true;
+        const name = row.taalName ?? (taal === null ? FREE_TAAL_LABELS[ctx.lang] : taal.id);
+        marks.push(`<span class="sw-taal" data-taal="${escapeHtml(taal?.id ?? "free")}">${escapeHtml(ctx.tr(name))}</span>`);
+      }
       if (row.lay !== void 0 && row.lay !== lay) {
         lay = row.lay;
-        out.push(`<div class="sw-lay" data-lay="${lay}">${escapeHtml(LAY_LABELS[ctx.lang][lay])}</div>`);
+        marks.push(`<span class="sw-lay" data-lay="${lay}">${escapeHtml(LAY_LABELS[ctx.lang][lay])}</span>`);
       }
+      if (marks.length > 0) out.push(`<div class="sw-change">${marks.join("")}</div>`);
       out.push(renderRow(row, p, r, layout.offsets[n++], ctx));
     });
     out.push("</section>");
@@ -623,10 +638,12 @@ ${FONT_FACES}
 
 .sw-part-name { font-size: 0.85em; font-weight: 600; margin: 1em 0 0.2em; opacity: 0.85; }
 
-/* \u09B2\u09AF\u09BC marker: the line where the tempo tier turns over. A full-width rule
-   rather than a row label \u2014 the label track is what the notation columns are
-   measured against, and a six-em word in it would shove the whole sheet right. */
-.sw-lay {
+/* \u09A4\u09BE\u09B2 / \u09B2\u09AF\u09BC change: the line where the \u09A4\u09BE\u09B2\u09AB\u09C7\u09B0\u09A4\u09BE or the tempo tier turns over,
+   centred between two systems the way \u09B8\u09CD\u09AC\u09B0\u09AC\u09BF\u09A4\u09BE\u09A8 prints "\u099D\u09BE\u0981\u09AA\u09A4\u09BE\u09B2" or
+   "\u09A6\u09CD\u09B0\u09C1\u09A4 \u09B2\u09AF\u09BC". A full-width band rather than a row label \u2014 the label track is
+   what the notation columns are measured against, and a six-em word in it
+   would shove the whole sheet right. */
+.sw-change {
   grid-column: 1 / -1;
   display: flex;
   align-items: center;
@@ -640,12 +657,14 @@ ${FONT_FACES}
   opacity: 0.75;
   break-after: avoid;
 }
-.sw-lay::after {
+.sw-change::before,
+.sw-change::after {
   content: '';
   flex: 1;
   height: 1px;
   background: var(--sw-rule, rgba(128, 128, 128, 0.35));
 }
+.sw-taal + .sw-lay::before { content: '\xB7'; margin-right: 0.6em; }
 
 /* ---- block grid: ONE column set for the whole sheet ----
  * NLTR emits a song as a single html table, which is why its lines align
@@ -863,7 +882,7 @@ var SWARALIPI_PRINT_CSS = `
   .sw-sheet, .sw-staff { -webkit-print-color-adjust: exact; print-color-adjust: exact; color: #000; }
   .sw-scroll { overflow: visible !important; }
   .sw-row { break-inside: avoid; page-break-inside: avoid; }
-  .sw-part-name, .sw-header, .sw-lay { break-after: avoid-page; page-break-after: avoid; }
+  .sw-part-name, .sw-header, .sw-change { break-after: avoid-page; page-break-after: avoid; }
   .sw-hl { background: none !important; }
   /* Keep each engraved staff system whole across a page break (the abcjs line
      is a <div> wrapping the <svg>, so the break rule must sit on the div). */
@@ -920,11 +939,15 @@ function eventPaths(schedule) {
   }
   return paths;
 }
+var barLen = (m) => m.beatsPerBar > 0 ? m.beatsPerBar : 4;
 function abcText(s) {
   return s.replace(/[\r\n]+/g, " ").trim();
 }
 function buildAbc(schedule, lyricOf, opts) {
-  const beatsPerBar = opts.beatsPerBar > 0 ? opts.beatsPerBar : 4;
+  const meters = opts.meters?.length ? opts.meters : [{ beat: 0, beatsPerBar: opts.beatsPerBar, drums: opts.drums }];
+  const withDrums = opts.drums !== void 0 || meters.some((m2) => m2.drums !== void 0);
+  let m = 0;
+  let beatsPerBar = barLen(meters[0]);
   const tokens = [];
   const words = [];
   let barPos = 0;
@@ -938,6 +961,17 @@ function buildAbc(schedule, lyricOf, opts) {
     }
   };
   schedule.events.forEach((ev, i) => {
+    while (m + 1 < meters.length && ev.beat >= meters[m + 1].beat - EPS2) {
+      m++;
+      if (barPos > EPS2) {
+        tokens.push("|");
+        words.push("|");
+      }
+      barPos = 0;
+      const next = barLen(meters[m]);
+      if (next !== beatsPerBar) tokens.push(`[M:${ratioMeter(next)}]`);
+      beatsPerBar = next;
+    }
     if (ev.midi === null) {
       if (ev.kind === "rest") {
         tokens.push(`z${abcDuration(ev.durationBeats)}`);
@@ -956,16 +990,16 @@ function buildAbc(schedule, lyricOf, opts) {
   });
   if (tokens.length && tokens[tokens.length - 1] !== "|") tokens.push("|]");
   else if (tokens.length) tokens[tokens.length - 1] = "|]";
-  const meter = ratioMeter(beatsPerBar);
+  const meter = ratioMeter(barLen(meters[0]));
   const head = ["X:1", `M:${meter}`, "L:1/4", `Q:1/4=${Math.round(opts.bpm)}`];
-  if (opts.drums) head.push(...percMapLines(opts.drums));
+  if (withDrums) head.push(...percMapLines(meters.flatMap((x) => x.drums ?? [])));
   head.push("K:C treble");
   const melodyBody = tokens.length ? tokens.join(" ") : "z |]";
   const lines = [...head];
-  if (opts.drums) {
+  if (withDrums) {
     lines.push("V:1", melodyBody);
     if (opts.lyrics && words.some((w) => w !== "*" && w !== "|")) lines.push(`w: ${words.join(" ")}`);
-    lines.push("V:2 clef=perc stem=up", buildDrumVoice(schedule.totalBeats, beatsPerBar, opts.drums));
+    lines.push("V:2 clef=perc stem=up", buildDrumVoice(schedule.totalBeats, meters));
   } else {
     lines.push(melodyBody);
     if (opts.lyrics && words.some((w) => w !== "*" && w !== "|")) lines.push(`w: ${words.join(" ")}`);
@@ -994,13 +1028,21 @@ function percMapLines(voices) {
   }
   return lines;
 }
-function buildDrumVoice(totalBeats, beatsPerBar, pattern) {
-  const n = Math.max(1, Math.ceil(totalBeats));
+function buildDrumVoice(totalBeats, meters) {
   const tokens = [];
-  for (let beat = 0; beat < n; beat++) {
-    tokens.push(DRUM_ABC[pattern[beat % pattern.length]].note);
-    if ((beat + 1) % beatsPerBar === 0) tokens.push("|");
-  }
+  meters.forEach((m, i) => {
+    const bpb = barLen(m);
+    if (i > 0) {
+      if (tokens.length > 0 && tokens[tokens.length - 1] !== "|") tokens.push("|");
+      if (bpb !== barLen(meters[i - 1])) tokens.push(`[M:${ratioMeter(bpb)}]`);
+    }
+    const end = meters[i + 1]?.beat ?? Math.max(1, Math.ceil(totalBeats));
+    const n = Math.ceil(end - m.beat - 1e-6);
+    for (let beat = 0; beat < n; beat++) {
+      tokens.push(m.drums?.length ? DRUM_ABC[m.drums[beat % m.drums.length]].note : "z");
+      if ((beat + 1) % bpb === 0) tokens.push("|");
+    }
+  });
   if (tokens.length === 0 || tokens[tokens.length - 1] !== "|") tokens.push("|]");
   else tokens[tokens.length - 1] = "|]";
   return tokens.join(" ");
@@ -1011,16 +1053,25 @@ function lyricLookup(doc) {
     return doc.parts[p]?.rows[r]?.notes[i]?.lyric;
   };
 }
-function resolveDrumTaal(doc) {
-  const id = doc.meta.taal?.id;
+function resolveDrumTaal(taal) {
+  const id = taal?.id;
   return id !== void 0 && id in TAALS ? TAALS[id] : { numBeats: 4, sam: 0 };
 }
 function docToAbc(doc, opts = {}) {
   const schedule = buildSchedule(doc, { tonic: opts.tonic, baseOctave: opts.baseOctave, lay: false });
   const bpm = opts.bpm ?? doc.meta.bpm ?? 90;
-  const beatsPerBar = opts.beatsPerBar ?? doc.meta.taal?.numBeats ?? 4;
-  const drums = opts.drums ? drumPattern(resolveDrumTaal(doc)) : void 0;
-  return buildAbc(schedule, lyricLookup(doc), { bpm, lyrics: opts.lyrics !== false, beatsPerBar, drums });
+  const meters = schedule.tempo.map((seg) => ({
+    beat: seg.beat,
+    beatsPerBar: opts.beatsPerBar ?? seg.taal?.numBeats ?? 4,
+    drums: opts.drums && seg.taal !== null ? drumPattern(resolveDrumTaal(seg.taal)) : void 0
+  }));
+  return buildAbc(schedule, lyricLookup(doc), {
+    bpm,
+    lyrics: opts.lyrics !== false,
+    beatsPerBar: meters[0].beatsPerBar,
+    drums: opts.drums ? meters[0].drums ?? [] : void 0,
+    meters
+  });
 }
 async function abcToSvg(abc, opts = {}, notePaths) {
   if (typeof document === "undefined") {
@@ -1099,7 +1150,7 @@ function buildTaalAbc(taal, opts = {}) {
   const voices = Array.from({ length: n }, (_, i) => src[i % src.length]);
   const bpm = Math.round(opts.bpm ?? 90);
   const head = ["X:1", `M:${ratioMeter(n)}`, "L:1/4", `Q:1/4=${bpm}`, ...percMapLines(voices), "K:C"];
-  const lines = [...head, "V:1 clef=perc stem=up", buildDrumVoice(n, n, voices)];
+  const lines = [...head, "V:1 clef=perc stem=up", buildDrumVoice(n, [{ beat: 0, beatsPerBar: n, drums: voices }])];
   if (opts.bols?.length) {
     const w = opts.bols.slice(0, n).map((b) => b.trim() ? abcText(b).replace(/\s+/g, "~") : "*");
     while (w.length < n) w.push("*");
@@ -1487,6 +1538,6 @@ function defineSwaralipiSheet(tagName = "swaralipi-sheet") {
   return ctor;
 }
 
-export { DEFAULT_NOTATOR, DEFAULT_WATERMARK, DIGITS, LABELS, LAY_LABELS, MARKS, MAX_ZOOM, MIN_ZOOM, NOTATION_FONT_URLS, SWARALIPI_CSS, SWARALIPI_PRINT_CSS, SWARALIPI_STAFF_CSS, ZOOM_STEP, abcDuration, abcToSvg, alignRows, buildAbc, buildTaalAbc, cellMatra, composeCluster, defineSwaralipiSheet, docToAbc, fitSwaralipi, groupRowIntoCells, loadLyricTransliterator, localizeDigits, midiToAbc, printSwaralipi, renderMetaHeader, renderPrintDocument, renderStaffHtml, renderStaffPrintDocument, renderTaalStaffHtml, renderToHtml, resolveArcs };
+export { DEFAULT_NOTATOR, DEFAULT_WATERMARK, DIGITS, FREE_TAAL_LABELS, LABELS, LAY_LABELS, MARKS, MAX_ZOOM, MIN_ZOOM, NOTATION_FONT_URLS, SWARALIPI_CSS, SWARALIPI_PRINT_CSS, SWARALIPI_STAFF_CSS, ZOOM_STEP, abcDuration, abcToSvg, alignRows, buildAbc, buildTaalAbc, cellMatra, composeCluster, defineSwaralipiSheet, docToAbc, fitSwaralipi, groupRowIntoCells, loadLyricTransliterator, localizeDigits, midiToAbc, printSwaralipi, renderMetaHeader, renderPrintDocument, renderStaffHtml, renderStaffPrintDocument, renderTaalStaffHtml, renderToHtml, resolveArcs };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map