@ugfoundation/swaralipi-js 0.13.1 → 0.14.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-DZag9qkF.cjs';
 import { L as Lay } from '../lay-CXhC-HRO.cjs';
-import { D as DrumVoice, S as Schedule, P as PlayEvent } from '../schedule-V-fgepvP.cjs';
+import { D as DrumVoice, S as Schedule, P as PlayEvent } from '../instruments-DTIuTlda.cjs';
 import 'zod';
 import 'tone';
 
@@ -467,6 +467,66 @@ interface PrintOptions extends StaffOptions {
      * A document's `meta.notationBy` takes precedence when present. */
     notator?: string;
 }
+/** Diagonal watermark: an SVG data-URI **background** on a fixed, empty `<div>`.
+ *
+ * Two constraints, and only this shape satisfies both.
+ *
+ * 1. IT MUST FIT. The box is unknowable from in here — a phone's print page, an A4
+ *    page, or a 1240×6000 rendered sheet whose `<body>` the consumer additionally
+ *    `zoom`s. A `vw` font-size answers to the viewport, not to that box, so the old
+ *    rotated `<span>` ran off the edge and was clipped: "www.gitabitan" with the ".io"
+ *    shorn off. `preserveAspectRatio` + `background-size: contain` scale the mark into
+ *    whatever box it lands in, and `textLength` pins the line inside the viewBox — so it
+ *    fits BY CONSTRUCTION at every size, aspect ratio, zoom, watermark string and font.
+ *
+ * 2. IT MUST BE ON EVERY PRINTED PAGE. Chrome tiles a `position: fixed` BOX per page, but
+ *    WebKit — Safari, and every browser on iOS — paints it ONCE, centred on the whole
+ *    document (WebKit bug 6790), so a printout carries one mark across a page break. A
+ *    print therefore pins one `.sw-page-mark` box over each page itself (`paginate`); the
+ *    fixed `.sw-watermark` is left for a single-image render. Both are backgrounds, and
+ *    `print-color-adjust: exact` carries them past Chrome's "Background graphics"
+ *    checkbox, which is off by default.
+ *
+ * The SVG is an isolated document and cannot inherit the page's fonts, hence the inline
+ * `sans-serif`. `font-size` then only sets the HEIGHT (textLength fixes the width), so it
+ * is estimated from the character count to keep glyph proportions natural (~0.62em average
+ * advance for bold sans). Capped, or a short mark like "DRAFT" would be stretched across
+ * the whole page — there the natural width is used instead and the line simply centres. */
+declare function watermarkCss(text: string): string;
+/** The page-area height, in CSS px, that a print `widthPx` wide can count on. */
+declare function printPageHeight(widthPx: number, heightMm?: number, ua?: string): number;
+/**
+ * Fit every printed page to the paper picked in the print dialog. Pages are laid out (and
+ * paginate()d) at one size, `width` × `height`; when printing, Chrome and Firefox resolve vw/vh
+ * against the chosen paper's page area, so one zoom of min(area ÷ page) on both axes makes each
+ * laid-out page exactly one sheet of any paper at any margins. tan(atan2(a, b)) is a ÷ b as a
+ * plain number: Firefox has no typed arithmetic. The page is taken a hair taller than it is, so
+ * rounding never pushes its last line onto a sheet of its own. WebKit resolves vw/vh against the
+ * window, not the paper, and already shrinks a page to the paper's width, so it is left alone
+ * (printPageHeight keeps its pages short enough).
+ */
+declare function fitPaperCss(width: string, height: string, ua?: string): string;
+interface PaginateOptions {
+    /** The blocks a page may break before, in document order. */
+    atoms: string;
+    /** Blocks never left last on a page (headings, a song's first line). */
+    keep?: string;
+    /** Containers whose CSS already starts a page (`break-before: page`), to count. */
+    starts?: string;
+    /** The page area's height, CSS px (see printPageHeight). */
+    pageHeight: number;
+    /** Class of an empty box pinned over each page — the watermark (`sw-page-mark`). */
+    mark?: string;
+}
+/**
+ * Decide every page break here: walk the blocks a page may break before and, wherever the
+ * next one would overflow, force the break. Every page then holds less than a page, the
+ * printer never breaks anywhere else, and the pages counted are the printed ones — which is
+ * what lets a box be pinned over each page (a watermark WebKit cannot repeat) and an index
+ * name its pages (Chrome has no target-counter()). Returns each atom's page; the total is
+ * left on `body[data-pages]`.
+ */
+declare function paginate(doc: Document, o: PaginateOptions): Map<Element, number>;
 /**
  * Build a complete, standalone HTML document for printing an akarmatrik
  * (bn/hi/en) swaralipi sheet, with watermark + notator footer. Usable for a
@@ -568,4 +628,4 @@ type Transliterator = (bengaliText: string) => string;
  */
 declare function loadLyricTransliterator(lang: ViewerLang): Promise<Transliterator | undefined>;
 
-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, PRACTICE_LABELS, 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, PRACTICE_LABELS, type PaginateOptions, 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, fitPaperCss, fitSwaralipi, groupRowIntoCells, loadLyricTransliterator, localizeDigits, midiToAbc, paginate, printPageHeight, printSwaralipi, renderMetaHeader, renderPrintDocument, renderStaffHtml, renderStaffPrintDocument, renderTaalStaffHtml, renderToHtml, resolveArcs, watermarkCss };

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-DZag9qkF.js';
 import { L as Lay } from '../lay-CWlEhImP.js';
-import { D as DrumVoice, S as Schedule, P as PlayEvent } from '../schedule-ClyON98C.js';
+import { D as DrumVoice, S as Schedule, P as PlayEvent } from '../instruments-NcUb0ozc.js';
 import 'zod';
 import 'tone';
 
@@ -467,6 +467,66 @@ interface PrintOptions extends StaffOptions {
      * A document's `meta.notationBy` takes precedence when present. */
     notator?: string;
 }
+/** Diagonal watermark: an SVG data-URI **background** on a fixed, empty `<div>`.
+ *
+ * Two constraints, and only this shape satisfies both.
+ *
+ * 1. IT MUST FIT. The box is unknowable from in here — a phone's print page, an A4
+ *    page, or a 1240×6000 rendered sheet whose `<body>` the consumer additionally
+ *    `zoom`s. A `vw` font-size answers to the viewport, not to that box, so the old
+ *    rotated `<span>` ran off the edge and was clipped: "www.gitabitan" with the ".io"
+ *    shorn off. `preserveAspectRatio` + `background-size: contain` scale the mark into
+ *    whatever box it lands in, and `textLength` pins the line inside the viewBox — so it
+ *    fits BY CONSTRUCTION at every size, aspect ratio, zoom, watermark string and font.
+ *
+ * 2. IT MUST BE ON EVERY PRINTED PAGE. Chrome tiles a `position: fixed` BOX per page, but
+ *    WebKit — Safari, and every browser on iOS — paints it ONCE, centred on the whole
+ *    document (WebKit bug 6790), so a printout carries one mark across a page break. A
+ *    print therefore pins one `.sw-page-mark` box over each page itself (`paginate`); the
+ *    fixed `.sw-watermark` is left for a single-image render. Both are backgrounds, and
+ *    `print-color-adjust: exact` carries them past Chrome's "Background graphics"
+ *    checkbox, which is off by default.
+ *
+ * The SVG is an isolated document and cannot inherit the page's fonts, hence the inline
+ * `sans-serif`. `font-size` then only sets the HEIGHT (textLength fixes the width), so it
+ * is estimated from the character count to keep glyph proportions natural (~0.62em average
+ * advance for bold sans). Capped, or a short mark like "DRAFT" would be stretched across
+ * the whole page — there the natural width is used instead and the line simply centres. */
+declare function watermarkCss(text: string): string;
+/** The page-area height, in CSS px, that a print `widthPx` wide can count on. */
+declare function printPageHeight(widthPx: number, heightMm?: number, ua?: string): number;
+/**
+ * Fit every printed page to the paper picked in the print dialog. Pages are laid out (and
+ * paginate()d) at one size, `width` × `height`; when printing, Chrome and Firefox resolve vw/vh
+ * against the chosen paper's page area, so one zoom of min(area ÷ page) on both axes makes each
+ * laid-out page exactly one sheet of any paper at any margins. tan(atan2(a, b)) is a ÷ b as a
+ * plain number: Firefox has no typed arithmetic. The page is taken a hair taller than it is, so
+ * rounding never pushes its last line onto a sheet of its own. WebKit resolves vw/vh against the
+ * window, not the paper, and already shrinks a page to the paper's width, so it is left alone
+ * (printPageHeight keeps its pages short enough).
+ */
+declare function fitPaperCss(width: string, height: string, ua?: string): string;
+interface PaginateOptions {
+    /** The blocks a page may break before, in document order. */
+    atoms: string;
+    /** Blocks never left last on a page (headings, a song's first line). */
+    keep?: string;
+    /** Containers whose CSS already starts a page (`break-before: page`), to count. */
+    starts?: string;
+    /** The page area's height, CSS px (see printPageHeight). */
+    pageHeight: number;
+    /** Class of an empty box pinned over each page — the watermark (`sw-page-mark`). */
+    mark?: string;
+}
+/**
+ * Decide every page break here: walk the blocks a page may break before and, wherever the
+ * next one would overflow, force the break. Every page then holds less than a page, the
+ * printer never breaks anywhere else, and the pages counted are the printed ones — which is
+ * what lets a box be pinned over each page (a watermark WebKit cannot repeat) and an index
+ * name its pages (Chrome has no target-counter()). Returns each atom's page; the total is
+ * left on `body[data-pages]`.
+ */
+declare function paginate(doc: Document, o: PaginateOptions): Map<Element, number>;
 /**
  * Build a complete, standalone HTML document for printing an akarmatrik
  * (bn/hi/en) swaralipi sheet, with watermark + notator footer. Usable for a
@@ -568,4 +628,4 @@ type Transliterator = (bengaliText: string) => string;
  */
 declare function loadLyricTransliterator(lang: ViewerLang): Promise<Transliterator | undefined>;
 
-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, PRACTICE_LABELS, 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, PRACTICE_LABELS, type PaginateOptions, 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, fitPaperCss, fitSwaralipi, groupRowIntoCells, loadLyricTransliterator, localizeDigits, midiToAbc, paginate, printPageHeight, printSwaralipi, renderMetaHeader, renderPrintDocument, renderStaffHtml, renderStaffPrintDocument, renderTaalStaffHtml, renderToHtml, resolveArcs, watermarkCss };

package/dist/viewer/index.js

@@ -1,4 +1,4 @@
-import { isArcRaw, glideTargets, buildSchedule, drumPattern } from '../chunk-L6YZ3GC6.js';
+import { isArcRaw, glideTargets, buildSchedule, drumPattern } from '../chunk-GIOGYJMM.js';
 import '../chunk-BSZ3WQUP.js';
 import { hasKomal, isTaalFerta, sameTaal, TAALS, graceNotes } from '../chunk-KOHSKHXI.js';
 
@@ -1233,14 +1233,123 @@ function watermarkCss(text) {
   const len = Math.min(span, 0.62 * text.length * size);
   const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="xMidYMid meet"><text x="50" y="50" dy=".35em" text-anchor="middle" font-family="sans-serif" font-weight="700" fill="rgba(0,0,0,0.07)" font-size="${size.toFixed(2)}" textLength="${len.toFixed(2)}" lengthAdjust="spacingAndGlyphs" transform="rotate(-35 50 50)">${escapeHtml2(text)}</text></svg>`;
   return `
-.sw-watermark {
-  position: fixed; inset: 0; z-index: 0; pointer-events: none;
+.sw-watermark, .sw-page-mark {
+  pointer-events: none;
   background: url("data:image/svg+xml,${encodeURIComponent(svg)}") center / contain no-repeat;
   -webkit-print-color-adjust: exact; print-color-adjust: exact;
 }
+.sw-watermark { position: fixed; inset: 0; z-index: 0; }
+.sw-page-mark { position: absolute; z-index: -1; }
 body > .sw-sheet, body > .sw-footer { position: relative; z-index: 1; }
 `;
 }
+var A4_MM = 297 - 2 * 16;
+var WEBKIT_PAGE_ASPECT = 1.2;
+var isWebKit = (ua) => /AppleWebKit/.test(ua) && !/Chrome\//.test(ua);
+function printPageHeight(widthPx, heightMm = A4_MM, ua = navigator.userAgent) {
+  const px = heightMm * 96 / 25.4;
+  return isWebKit(ua) ? Math.min(px, widthPx * WEBKIT_PAGE_ASPECT) : px;
+}
+function fitPaperCss(width, height, ua = globalThis.navigator?.userAgent ?? "") {
+  if (isWebKit(ua)) return "";
+  return `@media print { html { zoom: min(tan(atan2(100vw, ${width})), tan(atan2(100vh, calc(${height} + 2px)))); } }`;
+}
+function paginate(doc, o) {
+  const atoms = [...doc.querySelectorAll(o.atoms)];
+  const pages = /* @__PURE__ */ new Map();
+  if (atoms.length === 0) return pages;
+  const view = doc.defaultView;
+  const forced = new Set(o.starts ? [...doc.querySelectorAll(o.starts)].map((c) => c.matches(o.atoms) ? c : c.querySelector(o.atoms)) : []);
+  const keep = (el) => !!o.keep && el.matches(o.keep);
+  const start = (el) => {
+    let y = Infinity;
+    for (let e = el; e && e !== doc.body; e = e.parentElement) {
+      if (e.getClientRects().length) y = Math.min(y, e.getBoundingClientRect().top - parseFloat(view.getComputedStyle(e).marginTop));
+      if (e.previousElementSibling) break;
+    }
+    return y;
+  };
+  let page = 1;
+  let first = 0;
+  let top = start(atoms[0]);
+  const heads = [atoms[0]];
+  atoms.forEach((el, i) => {
+    let at = -1;
+    if (i > first && forced.has(el)) at = i;
+    else if (i > first && el.getBoundingClientRect().bottom - top > o.pageHeight) {
+      at = i;
+      while (at - 1 > first && keep(atoms[at - 1])) at--;
+    }
+    if (at >= 0) {
+      page++;
+      first = at;
+      top = start(atoms[at]);
+      heads.push(atoms[at]);
+      for (let k = at; k < i; k++) pages.set(atoms[k], page);
+    }
+    while (el.getBoundingClientRect().bottom - top > o.pageHeight) {
+      page++;
+      top += o.pageHeight;
+    }
+    pages.set(el, page);
+  });
+  const grids = /* @__PURE__ */ new Map();
+  for (const el of heads) {
+    for (let a = el.parentElement; a && a !== doc.body; a = a.parentElement) {
+      const css = view.getComputedStyle(a);
+      if (!grids.has(a) && css.display.endsWith("grid")) grids.set(a, css.gridTemplateColumns);
+    }
+  }
+  for (const [g, cols] of grids) g.style.gridTemplateColumns = cols;
+  const hosts = heads.map((el, i) => i === 0 ? topOf(el) : splitBefore(el));
+  if (o.mark) {
+    const body = doc.body.getBoundingClientRect();
+    const side = Math.min(body.width, o.pageHeight);
+    const at = heads.map((el, i) => ({ top: start(el), box: hosts[i].getBoundingClientRect(), fixed: view.getComputedStyle(hosts[i]).position !== "static" }));
+    hosts.forEach((host, i) => {
+      const { top: top2, box, fixed } = at[i];
+      if (!fixed) host.style.position = "relative";
+      host.style.isolation = "isolate";
+      const mark = doc.createElement("div");
+      mark.className = o.mark;
+      mark.setAttribute("aria-hidden", "true");
+      mark.style.cssText = `top:${top2 - box.top + (o.pageHeight - side) / 2}px; left:${body.left - box.left}px; width:${body.width}px; height:${side}px;`;
+      host.append(mark);
+    });
+  }
+  doc.body.dataset.pages = String(page);
+  return pages;
+}
+function topOf(el) {
+  let top = el;
+  while (top.parentElement !== top.ownerDocument.body) top = top.parentElement;
+  return top;
+}
+function splitBefore(el) {
+  const top = topOf(el);
+  let from = el;
+  while (from !== top && !from.previousElementSibling) from = from.parentElement;
+  if (from === top) {
+    top.style.breakBefore = "page";
+    return top;
+  }
+  const cut = [];
+  for (let a = from.parentElement; a !== top.parentElement; a = a.parentElement) cut.push(a);
+  const range = el.ownerDocument.createRange();
+  range.setStartBefore(from);
+  range.setEndAfter(top.lastChild);
+  const rest = top.cloneNode(false);
+  rest.append(range.extractContents());
+  top.after(rest);
+  for (const a of cut) Object.assign(a.style, { marginBottom: "0", paddingBottom: "0", borderBottomWidth: "0" });
+  for (let a = from.parentElement; a !== rest.parentElement; a = a.parentElement) {
+    Object.assign(a.style, { marginTop: "0", paddingTop: "0", borderTopWidth: "0" });
+  }
+  rest.style.breakBefore = "page";
+  return rest;
+}
+var SHEET_ATOMS = ".sw-header, .sw-part-name, .sw-change, .sw-row, .sw-staff-meta, .sw-staff-lines > div, body > .sw-footer";
+var SHEET_KEEP = ".sw-header, .sw-part-name, .sw-change, .sw-staff-meta";
 function chrome(text, notator) {
   const top = text ? '<div class="sw-watermark" aria-hidden="true"></div>' : "";
   const bottom = notator ? `<footer class="sw-footer">${escapeHtml2(notator)}</footer>` : "";
@@ -1264,6 +1373,9 @@ ${SWARALIPI_CSS}
 ${SWARALIPI_STAFF_CSS}
 ${SWARALIPI_PRINT_CSS}
 ${watermarkCss(watermark)}
+/* Laid out as A4 \u2014 the page paginate() fills \u2014 and fitted to whatever paper is picked. */
+@page { margin: 16mm; }
+${fitPaperCss("178mm", `${A4_MM}mm`)}
 html, body { margin: 0; }
 /* The printable width of A4 at the @page margin above. The sheet is one grid
    with one natural width, so the fit script needs a real page-sized box to
@@ -1319,6 +1431,13 @@ function printHtmlInIframe(html) {
       printed = true;
       try {
         win.__swFit?.();
+        const doc = iframe.contentDocument;
+        const fixed = doc.querySelector(".sw-watermark");
+        if (fixed) {
+          fixed.remove();
+          const pageHeight = printPageHeight(doc.body.clientWidth);
+          paginate(doc, { atoms: SHEET_ATOMS, keep: SHEET_KEEP, pageHeight, mark: "sw-page-mark" });
+        }
         win.focus();
         win.print();
       } catch {
@@ -1675,6 +1794,6 @@ function defineSwaralipiSheet(tagName = "swaralipi-sheet") {
   return ctor;
 }
 
-export { DEFAULT_NOTATOR, DEFAULT_WATERMARK, DIGITS, FREE_TAAL_LABELS, LABELS, LAY_LABELS, MARKS, MAX_ZOOM, MIN_ZOOM, NOTATION_FONT_URLS, PRACTICE_LABELS, 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, PRACTICE_LABELS, SWARALIPI_CSS, SWARALIPI_PRINT_CSS, SWARALIPI_STAFF_CSS, ZOOM_STEP, abcDuration, abcToSvg, alignRows, buildAbc, buildTaalAbc, cellMatra, composeCluster, defineSwaralipiSheet, docToAbc, fitPaperCss, fitSwaralipi, groupRowIntoCells, loadLyricTransliterator, localizeDigits, midiToAbc, paginate, printPageHeight, printSwaralipi, renderMetaHeader, renderPrintDocument, renderStaffHtml, renderStaffPrintDocument, renderTaalStaffHtml, renderToHtml, resolveArcs, watermarkCss };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map