@ugfoundation/swaralipi-js 0.1.6 → 0.2.1

package/dist/viewer/index.d.cts

@@ -2,49 +2,42 @@ import { O as Octave, a as SvaraLetter, N as Note, S as Swaralipi } from '../sch
 import 'zod';
 
 /**
- * Per-language glyph tables + Unicode cluster composition for the viewer.
+ * Per-language notation encoding for the viewer.
  *
- * The akarmatrik system is script-portable: Bengali and Devanagari use the
- * same letters-with-distinct-komal-forms convention (legend: কোমল র—ঋ,
- * কোমল গ—জ্ঞ, কড়ি ম—ক্ষ, কোমল ধ—দ, কোমল ন—ণ), the same আ-কার matra carrier,
- * the same reph-above for taar and understroke for mandra. `en` has no
- * native convention, so it uses S R G M P D N with CSS marks (komal
- * underline, tivra prime, octave dots) and no matra carrier.
+ * Every language renders its notation through a dedicated, purpose-built
+ * font whose glyphs ARE the akarmatrik/Bhatkhande marks — so composeCluster
+ * emits that font's ASCII encoding and the font does all the hard work
+ * (komal/tivra forms, octave reph/dots, matra). This is why the viewer no
+ * longer touches Unicode cluster composition at all: the old reph-over-
+ * vowel, hasanta-before-matra and dotted-circle hazards simply don't exist
+ * when the font supplies precomposed glyphs keyed by plain ASCII.
  *
- * Unicode hazards owned here (see composeCluster):
- *  - mandra can NEVER be a real hasanta: letter + ্ + া is an invalid
- *    cluster (virama before vowel sign → dotted circle). It is always a
- *    CSS understroke (`sw-mandra`).
- *  - ঋ/ऋ (komal re) is an independent VOWEL letter: both র্+ঋ (reph over a
- *    vowel) and ঋ+া (vowel sign on a vowel) are invalid clusters. taar-ঋ
- *    falls back to a CSS reph (`sw-reph-css`); a matra following ঋ must be
- *    emitted as a separate isolated-matra span (`matraSeparate`).
- *  - Isolated dependent signs (া, ঃ) need a base: U+00A0 NBSP is the
- *    Unicode-sanctioned placeholder base and avoids dotted circles.
+ *  - bn → NLTR's **Swarabitan** (the akarmatrik font this project decodes).
+ *    Letters s r g m p q n = স র গ ম প ধ ন (q=ধ); komal v t d u = ঋ জ্ঞ দ ণ;
+ *    tivra ma k = the authentic কড়ি-ম conjunct (ম-based — has NO Unicode
+ *    form, which is what forced this whole approach); suffix f = taar reph,
+ *    h = mandra hasanta; trailing a = the আ-কার matra carrier. See codec.ts.
+ *  - hi/en → **Ome Bhatkhande** Hindi/English (SIL OFL 1.1, © Omenad —
+ *    github.com/omenad/fonts). Same clean keymap for both: lowercase
+ *    s r g m p d n = the seven shuddha swaras, uppercase R G M D N = komal
+ *    Re/Ga, tivra Ma, komal Dha/Ni; octave suffix u/l = taar/mandra dot,
+ *    U/L = ati (two dots). Bhatkhande has no আ-কার, so no matra is appended.
+ *
+ * The font is applied by CSS keyed on `.sw-sheet`'s `lang` (see styles.ts);
+ * composeCluster only chooses the ASCII. The single residual CSS mark is the
+ * bn ati-octave extra dot (Swarabitan's f/h are single reph/hasanta only).
  */
 
 type ViewerLang = 'bn' | 'hi' | 'en';
-interface LetterForms {
-    shuddha: string;
-    /** Distinct komal glyph (bn/hi); absent for en (CSS underline instead). */
-    komal?: string;
-    /** Distinct tivra glyph (bn/hi ক্ষ/क्ष); absent for en (CSS prime). */
-    tivra?: string;
-}
-declare const LETTERS: Record<ViewerLang, Record<SvaraLetter, LetterForms>>;
 /** Digits 0-9 in the target script (beat labels, avartan). */
 declare const DIGITS: Record<ViewerLang, string>;
 interface LangMarks {
-    /** আ-কার matra carrier appended to a group-final cluster ('' for en). */
-    matra: string;
     /** Melisma / no-new-attack dash before a sustained cluster. */
     hyphen: string;
     /** Lyric continuation mark shown under sustains (the source uses ৹). */
     melisma: string;
     /** ছেদ cut/articulation mark (two stacked rings, ঃ-shaped). */
     cut: string;
-    /** Real-text reph prefix for taar ('' for en → CSS dot instead). */
-    reph: string;
 }
 declare const MARKS: Record<ViewerLang, LangMarks>;
 /** Header labels (NLTR prints নাম / তাল / আবর্তন …). */
@@ -55,28 +48,24 @@ declare const LABELS: Record<ViewerLang, {
     avartan: string;
     notationBy: string;
 }>;
-/** A composed notation cluster: text plus the CSS classes for marks the
- * text itself cannot carry (mandra understroke, ati dots, en komal/tivra,
- * CSS-reph fallback). */
+/** 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 {
     text: string;
     classes: string[];
-    /** Set when the matra could not join the cluster (ঋ/ऋ, or en where the
-     * carrier doesn't exist) and must be emitted as an isolated-matra span. */
-    matraSeparate: boolean;
 }
 interface ComposeOptions {
     komal?: boolean;
     tivra?: boolean;
     octave: Octave;
-    /** Append the আ-কার matra carrier (group-final notes only). */
+    /** Append the আ-কার matra carrier (bn group-final notes only). */
     withMatra: boolean;
     lang: ViewerLang;
 }
 /**
- * Compose one svara cluster. The single place that knows Unicode
- * composition order: reph? + base + matra?, with the ঋ/mandra/en fallbacks
- * documented in the file header.
+ * Compose one svara into its notation-font ASCII. bn = Swarabitan
+ * (letter + f/h octave + a matra); hi/en = Ome Bhatkhande (case-encoded
+ * letter + u/l/U/L octave, no matra). The font renders the actual glyph.
  */
 declare function composeCluster(letter: SvaraLetter, opts: ComposeOptions): Cluster;
 /** Map ASCII digits in `s` to the target script's digits. */
@@ -97,8 +86,8 @@ declare function localizeDigits(s: string, lang: ViewerLang): string;
  * Rendering is spec-driven (semantics, not `raw`): grouping derives from
  * `durationMatra` accumulation so hand-authored documents without `raw`
  * render identically. `raw` is consulted only for (a) raw-only fallback
- * notes (never dropped — dimmed monospace), (b) the ছেদ cut mark and beat
- * labels, whose grammar lives in raw (see src/convert/codec.ts).
+ * notes (never dropped — dimmed, in Swarabitan when loaded), (b) the ছেদ
+ * cut mark and beat labels, whose grammar lives in raw (see codec.ts).
  */
 
 interface RenderOptions {
@@ -170,12 +159,17 @@ declare function renderToHtml(doc: Swaralipi, opts?: RenderOptions): string;
  *   --sw-rule       header rule / muted line color
  *
  * All ink uses `currentColor`, so the sheet follows the host's text color
- * (dark mode included). Octave marks that Unicode cannot express in a valid
- * cluster (mandra understroke, ati dots, ঋ-reph, en octave dots) are drawn
- * with positioned pseudo-elements; offsets are em-based and tuned against
- * the NLTR reference rendering of song 4270.
+ * (dark mode included). The only octave mark drawn as a pseudo-element is
+ * the bn ati-octave extra dot (Swarabitan's f/h glyphs are a single
+ * reph/hasanta); everything else is a real glyph in the notation font.
  */
-declare const SWARALIPI_CSS = "\n.sw-sheet {\n  font-family: var(--sw-font, 'Noto Sans Bengali', 'Kohinoor Bangla', 'Bangla Sangam MN', 'Nirmala UI', 'Noto Sans Devanagari', sans-serif);\n  font-size: var(--sw-size, 1.125rem);\n  line-height: 1.5;\n}\n\n/* ---- header ---- */\n.sw-header {\n  margin: 0 0 0.75em;\n  padding: 0 0 0.5em;\n  border-bottom: 1px solid var(--sw-rule, rgba(128, 128, 128, 0.35));\n  font-size: 0.95em;\n}\n.sw-meta-row { display: flex; gap: 0.3em; }\n.sw-meta-label { font-weight: 600; min-width: 4.5em; }\n.sw-meta-label::after { content: ':'; font-weight: 400; margin-left: 0.15em; }\n\n.sw-part-name { font-size: 0.85em; font-weight: 600; margin: 1em 0 0.2em; opacity: 0.85; }\n\n/* ---- row grid: above / notation / below(arcs) / lyric ---- */\n.sw-row {\n  display: flex;\n  align-items: flex-start;\n  overflow-x: auto;\n  padding: 0.4em 0;\n}\n.sw-label { flex: none; margin-right: 0.8em; font-weight: 600; }\n.sw-grid {\n  display: grid;\n  grid-template-rows: auto auto auto auto;\n  grid-auto-columns: max-content;\n  align-items: end;\n}\n.sw-above   { grid-row: 1; font-size: 0.62em; justify-self: start; white-space: nowrap; padding-left: 0.2em; }\n.sw-n       { grid-row: 2; white-space: nowrap; }\n.sw-arc,\n.sw-below   { grid-row: 3; }\n.sw-lyr     { grid-row: 4; white-space: nowrap; padding-top: 0.3em; }\n.sw-below   { font-size: 0.62em; justify-self: start; white-space: nowrap; padding-left: 0.2em; }\n\n/* inter-cell gap as padding on each cell's first notation item, so arcs\n * and above-spans crossing cells stay continuous */\n.sw-cs { padding-left: var(--sw-cell-gap, 0.55em); }\n\n/* ---- notation clusters & marks ---- */\n.sw-cl { position: relative; display: inline-block; }\n\n/* mandra: hasanta-shaped understroke (a real \u09CD before \u09BE is invalid Unicode) */\n.sw-mandra::after {\n  content: '';\n  position: absolute;\n  left: 0.1em;\n  bottom: -0.08em;\n  width: 0.45em;\n  height: 0.09em;\n  background: currentColor;\n  transform: rotate(-32deg);\n}\n/* ati-mandra: an extra dot below */\n.sw-ati-mandra::before {\n  content: '';\n  position: absolute;\n  left: 0.25em;\n  bottom: -0.35em;\n  width: 0.16em;\n  height: 0.16em;\n  border-radius: 50%;\n  background: currentColor;\n}\n/* ati-taar (reph already in the text): an extra dot above */\n.sw-ati-taar::before {\n  content: '';\n  position: absolute;\n  left: 0.25em;\n  top: -0.3em;\n  width: 0.16em;\n  height: 0.16em;\n  border-radius: 50%;\n  background: currentColor;\n}\n/* CSS reph fallback for vowel letters \u098B/\u090B that reject a real reph */\n.sw-reph-css::before {\n  content: '';\n  position: absolute;\n  top: -0.12em;\n  left: 0.12em;\n  width: 0.3em;\n  height: 0.3em;\n  border: 0.09em solid currentColor;\n  border-right: none;\n  border-bottom: none;\n  border-top-left-radius: 0.3em;\n}\n/* en octave dots (Bhatkhande-style) */\n.sw-dot-above::before,\n.sw-dot-below::before {\n  content: '';\n  position: absolute;\n  left: 50%;\n  margin-left: -0.07em;\n  width: 0.14em;\n  height: 0.14em;\n  border-radius: 50%;\n  background: currentColor;\n}\n.sw-dot-above::before { top: -0.25em; }\n.sw-dot-below::before { bottom: -0.2em; }\n.sw-ati-taar.sw-dot-above::before,\n.sw-ati-mandra.sw-dot-below::before { box-shadow: 0.24em 0 0 currentColor; margin-left: -0.19em; }\n/* en accidentals (bn/hi use distinct letters instead) */\n.sw-komal { text-decoration: underline; text-underline-offset: 0.18em; }\n.sw-tivra::after { content: '\\2032'; font-size: 0.7em; vertical-align: super; }\n\n/* kan grace: small raised cluster left of the main note */\n.sw-kan {\n  position: relative;\n  display: inline-block;\n  font-size: 0.58em;\n  vertical-align: 0.75em;\n  margin-right: 0.08em;\n}\n\n.sw-hy { padding-right: 0.02em; }\n.sw-iso { display: inline-block; margin-left: -0.18em; }\n.sw-cut { font-size: 0.8em; display: inline-block; margin-left: -0.15em; }\n.sw-br { opacity: 0.8; padding: 0 0.06em; }\n.sw-micro { font-size: 0.6em; vertical-align: super; opacity: 0.8; }\n\n/* raw fallback: never dropped, visibly non-notation */\n.sw-raw {\n  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;\n  font-size: 0.72em;\n  opacity: 0.55;\n}\n\n/* ---- bars: dari (thin) and danda strokes, notation-row height ---- */\n/* horizontal gap before a bar comes from its own .sw-cs padding-left \u2014\n * never reset it with a padding shorthand here */\n.sw-bar {\n  grid-row: 2;\n  align-self: stretch;\n  display: inline-flex;\n  align-items: stretch;\n  gap: 0.16em;\n  padding-right: 0.1em;\n}\n.sw-bar i { display: inline-block; width: 0.14em; min-height: 1.25em; background: currentColor; }\n.sw-bar--dari i { width: 0.05em; opacity: 0.9; }\n.sw-bar--quad i:nth-child(3) { margin-left: 0.18em; }\n.sw-above .sw-bar, .sw-below .sw-bar { display: inline-flex; vertical-align: baseline; }\n.sw-above .sw-bar i, .sw-below .sw-bar i { min-height: 1em; }\n\n/* ---- under-arcs (slurs decoded from w/x segments and meend) ---- */\n.sw-arc {\n  align-self: start;\n  height: 0.4em;\n  margin: 0.05em 0.25em 0;\n  border: 0.09em solid currentColor;\n  border-top: none;\n  border-bottom-left-radius: 0.6em;\n  border-bottom-right-radius: 0.6em;\n  opacity: 0.85;\n}\n.sw-arc--openl { border-left: none; border-bottom-left-radius: 0; }\n.sw-arc--openr { border-right: none; border-bottom-right-radius: 0; }\n.sw-arc--line { border-left: none; border-right: none; border-radius: 0; height: 0.22em; }\n\n/* ---- annotation content ---- */\n.sw-beat { position: relative; display: inline-block; padding: 0 0.1em; }\n.sw-sam::after {\n  content: '';\n  position: absolute;\n  top: -0.45em;\n  left: 50%;\n  width: 0.1em;\n  height: 0.4em;\n  background: currentColor;\n  transform: rotate(14deg);\n}\n.sw-stop i {\n  display: inline-block;\n  width: 0.07em;\n  height: 1em;\n  margin: 0 0.07em;\n  background: currentColor;\n  vertical-align: text-bottom;\n}\n\n/* ---- player sync (P2.3) ---- */\n.sw-hl { background: var(--sw-hl, rgba(255, 196, 64, 0.45)); border-radius: 0.15em; }\n\n/* ---- element error box ---- */\n.sw-error {\n  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;\n  font-size: 0.85em;\n  padding: 0.6em 0.8em;\n  border: 1px solid rgba(200, 64, 64, 0.6);\n  border-radius: 0.3em;\n  color: #b33;\n  background: rgba(200, 64, 64, 0.08);\n}\n";
+/** Notation fonts, self-hosted on the project CDN (CORS-enabled), keyed by
+ * the CSS `font-family` this stylesheet uses. bn = NLTR's Swarabitan; hi/en
+ * = Ome Bhatkhande (SIL OFL 1.1, © Omenad — github.com/omenad/fonts).
+ * Self-hosters: declare your own \`@font-face\` for any of these families
+ * before this stylesheet / before defineSwaralipiSheet() and it wins. */
+declare const NOTATION_FONT_URLS: Record<string, string>;
+declare const SWARALIPI_CSS: string;
 /**
  * Print stylesheet — pair with `SWARALIPI_CSS` (renderPrintDocument injects
  * both). Gated on `@media print`, so it also works if a consumer drops it into
@@ -282,4 +276,4 @@ type Transliterator = (bengaliText: string) => string;
  */
 declare function loadLyricTransliterator(lang: ViewerLang): Promise<Transliterator | undefined>;
 
-export { type Arc, type Cell, type Cluster, type ComposeOptions, DIGITS, LABELS, LETTERS, MARKS, type PrintOptions, type RenderOptions, SWARALIPI_CSS, SWARALIPI_PRINT_CSS, type SwaralipiSheetElement, type Transliterator, type ViewerLang, composeCluster, defineSwaralipiSheet, groupRowIntoCells, loadLyricTransliterator, localizeDigits, printSwaralipi, renderPrintDocument, renderToHtml, resolveArcs };
+export { type Arc, type Cell, type Cluster, type ComposeOptions, DIGITS, LABELS, MARKS, NOTATION_FONT_URLS, type PrintOptions, type RenderOptions, SWARALIPI_CSS, SWARALIPI_PRINT_CSS, type SwaralipiSheetElement, type Transliterator, type ViewerLang, composeCluster, defineSwaralipiSheet, groupRowIntoCells, loadLyricTransliterator, localizeDigits, printSwaralipi, renderPrintDocument, renderToHtml, resolveArcs };

package/dist/viewer/index.d.ts

@@ -2,49 +2,42 @@ import { O as Octave, a as SvaraLetter, N as Note, S as Swaralipi } from '../sch
 import 'zod';
 
 /**
- * Per-language glyph tables + Unicode cluster composition for the viewer.
+ * Per-language notation encoding for the viewer.
  *
- * The akarmatrik system is script-portable: Bengali and Devanagari use the
- * same letters-with-distinct-komal-forms convention (legend: কোমল র—ঋ,
- * কোমল গ—জ্ঞ, কড়ি ম—ক্ষ, কোমল ধ—দ, কোমল ন—ণ), the same আ-কার matra carrier,
- * the same reph-above for taar and understroke for mandra. `en` has no
- * native convention, so it uses S R G M P D N with CSS marks (komal
- * underline, tivra prime, octave dots) and no matra carrier.
+ * Every language renders its notation through a dedicated, purpose-built
+ * font whose glyphs ARE the akarmatrik/Bhatkhande marks — so composeCluster
+ * emits that font's ASCII encoding and the font does all the hard work
+ * (komal/tivra forms, octave reph/dots, matra). This is why the viewer no
+ * longer touches Unicode cluster composition at all: the old reph-over-
+ * vowel, hasanta-before-matra and dotted-circle hazards simply don't exist
+ * when the font supplies precomposed glyphs keyed by plain ASCII.
  *
- * Unicode hazards owned here (see composeCluster):
- *  - mandra can NEVER be a real hasanta: letter + ্ + া is an invalid
- *    cluster (virama before vowel sign → dotted circle). It is always a
- *    CSS understroke (`sw-mandra`).
- *  - ঋ/ऋ (komal re) is an independent VOWEL letter: both র্+ঋ (reph over a
- *    vowel) and ঋ+া (vowel sign on a vowel) are invalid clusters. taar-ঋ
- *    falls back to a CSS reph (`sw-reph-css`); a matra following ঋ must be
- *    emitted as a separate isolated-matra span (`matraSeparate`).
- *  - Isolated dependent signs (া, ঃ) need a base: U+00A0 NBSP is the
- *    Unicode-sanctioned placeholder base and avoids dotted circles.
+ *  - bn → NLTR's **Swarabitan** (the akarmatrik font this project decodes).
+ *    Letters s r g m p q n = স র গ ম প ধ ন (q=ধ); komal v t d u = ঋ জ্ঞ দ ণ;
+ *    tivra ma k = the authentic কড়ি-ম conjunct (ম-based — has NO Unicode
+ *    form, which is what forced this whole approach); suffix f = taar reph,
+ *    h = mandra hasanta; trailing a = the আ-কার matra carrier. See codec.ts.
+ *  - hi/en → **Ome Bhatkhande** Hindi/English (SIL OFL 1.1, © Omenad —
+ *    github.com/omenad/fonts). Same clean keymap for both: lowercase
+ *    s r g m p d n = the seven shuddha swaras, uppercase R G M D N = komal
+ *    Re/Ga, tivra Ma, komal Dha/Ni; octave suffix u/l = taar/mandra dot,
+ *    U/L = ati (two dots). Bhatkhande has no আ-কার, so no matra is appended.
+ *
+ * The font is applied by CSS keyed on `.sw-sheet`'s `lang` (see styles.ts);
+ * composeCluster only chooses the ASCII. The single residual CSS mark is the
+ * bn ati-octave extra dot (Swarabitan's f/h are single reph/hasanta only).
  */
 
 type ViewerLang = 'bn' | 'hi' | 'en';
-interface LetterForms {
-    shuddha: string;
-    /** Distinct komal glyph (bn/hi); absent for en (CSS underline instead). */
-    komal?: string;
-    /** Distinct tivra glyph (bn/hi ক্ষ/क्ष); absent for en (CSS prime). */
-    tivra?: string;
-}
-declare const LETTERS: Record<ViewerLang, Record<SvaraLetter, LetterForms>>;
 /** Digits 0-9 in the target script (beat labels, avartan). */
 declare const DIGITS: Record<ViewerLang, string>;
 interface LangMarks {
-    /** আ-কার matra carrier appended to a group-final cluster ('' for en). */
-    matra: string;
     /** Melisma / no-new-attack dash before a sustained cluster. */
     hyphen: string;
     /** Lyric continuation mark shown under sustains (the source uses ৹). */
     melisma: string;
     /** ছেদ cut/articulation mark (two stacked rings, ঃ-shaped). */
     cut: string;
-    /** Real-text reph prefix for taar ('' for en → CSS dot instead). */
-    reph: string;
 }
 declare const MARKS: Record<ViewerLang, LangMarks>;
 /** Header labels (NLTR prints নাম / তাল / আবর্তন …). */
@@ -55,28 +48,24 @@ declare const LABELS: Record<ViewerLang, {
     avartan: string;
     notationBy: string;
 }>;
-/** A composed notation cluster: text plus the CSS classes for marks the
- * text itself cannot carry (mandra understroke, ati dots, en komal/tivra,
- * CSS-reph fallback). */
+/** 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 {
     text: string;
     classes: string[];
-    /** Set when the matra could not join the cluster (ঋ/ऋ, or en where the
-     * carrier doesn't exist) and must be emitted as an isolated-matra span. */
-    matraSeparate: boolean;
 }
 interface ComposeOptions {
     komal?: boolean;
     tivra?: boolean;
     octave: Octave;
-    /** Append the আ-কার matra carrier (group-final notes only). */
+    /** Append the আ-কার matra carrier (bn group-final notes only). */
     withMatra: boolean;
     lang: ViewerLang;
 }
 /**
- * Compose one svara cluster. The single place that knows Unicode
- * composition order: reph? + base + matra?, with the ঋ/mandra/en fallbacks
- * documented in the file header.
+ * Compose one svara into its notation-font ASCII. bn = Swarabitan
+ * (letter + f/h octave + a matra); hi/en = Ome Bhatkhande (case-encoded
+ * letter + u/l/U/L octave, no matra). The font renders the actual glyph.
  */
 declare function composeCluster(letter: SvaraLetter, opts: ComposeOptions): Cluster;
 /** Map ASCII digits in `s` to the target script's digits. */
@@ -97,8 +86,8 @@ declare function localizeDigits(s: string, lang: ViewerLang): string;
  * Rendering is spec-driven (semantics, not `raw`): grouping derives from
  * `durationMatra` accumulation so hand-authored documents without `raw`
  * render identically. `raw` is consulted only for (a) raw-only fallback
- * notes (never dropped — dimmed monospace), (b) the ছেদ cut mark and beat
- * labels, whose grammar lives in raw (see src/convert/codec.ts).
+ * notes (never dropped — dimmed, in Swarabitan when loaded), (b) the ছেদ
+ * cut mark and beat labels, whose grammar lives in raw (see codec.ts).
  */
 
 interface RenderOptions {
@@ -170,12 +159,17 @@ declare function renderToHtml(doc: Swaralipi, opts?: RenderOptions): string;
  *   --sw-rule       header rule / muted line color
  *
  * All ink uses `currentColor`, so the sheet follows the host's text color
- * (dark mode included). Octave marks that Unicode cannot express in a valid
- * cluster (mandra understroke, ati dots, ঋ-reph, en octave dots) are drawn
- * with positioned pseudo-elements; offsets are em-based and tuned against
- * the NLTR reference rendering of song 4270.
+ * (dark mode included). The only octave mark drawn as a pseudo-element is
+ * the bn ati-octave extra dot (Swarabitan's f/h glyphs are a single
+ * reph/hasanta); everything else is a real glyph in the notation font.
  */
-declare const SWARALIPI_CSS = "\n.sw-sheet {\n  font-family: var(--sw-font, 'Noto Sans Bengali', 'Kohinoor Bangla', 'Bangla Sangam MN', 'Nirmala UI', 'Noto Sans Devanagari', sans-serif);\n  font-size: var(--sw-size, 1.125rem);\n  line-height: 1.5;\n}\n\n/* ---- header ---- */\n.sw-header {\n  margin: 0 0 0.75em;\n  padding: 0 0 0.5em;\n  border-bottom: 1px solid var(--sw-rule, rgba(128, 128, 128, 0.35));\n  font-size: 0.95em;\n}\n.sw-meta-row { display: flex; gap: 0.3em; }\n.sw-meta-label { font-weight: 600; min-width: 4.5em; }\n.sw-meta-label::after { content: ':'; font-weight: 400; margin-left: 0.15em; }\n\n.sw-part-name { font-size: 0.85em; font-weight: 600; margin: 1em 0 0.2em; opacity: 0.85; }\n\n/* ---- row grid: above / notation / below(arcs) / lyric ---- */\n.sw-row {\n  display: flex;\n  align-items: flex-start;\n  overflow-x: auto;\n  padding: 0.4em 0;\n}\n.sw-label { flex: none; margin-right: 0.8em; font-weight: 600; }\n.sw-grid {\n  display: grid;\n  grid-template-rows: auto auto auto auto;\n  grid-auto-columns: max-content;\n  align-items: end;\n}\n.sw-above   { grid-row: 1; font-size: 0.62em; justify-self: start; white-space: nowrap; padding-left: 0.2em; }\n.sw-n       { grid-row: 2; white-space: nowrap; }\n.sw-arc,\n.sw-below   { grid-row: 3; }\n.sw-lyr     { grid-row: 4; white-space: nowrap; padding-top: 0.3em; }\n.sw-below   { font-size: 0.62em; justify-self: start; white-space: nowrap; padding-left: 0.2em; }\n\n/* inter-cell gap as padding on each cell's first notation item, so arcs\n * and above-spans crossing cells stay continuous */\n.sw-cs { padding-left: var(--sw-cell-gap, 0.55em); }\n\n/* ---- notation clusters & marks ---- */\n.sw-cl { position: relative; display: inline-block; }\n\n/* mandra: hasanta-shaped understroke (a real \u09CD before \u09BE is invalid Unicode) */\n.sw-mandra::after {\n  content: '';\n  position: absolute;\n  left: 0.1em;\n  bottom: -0.08em;\n  width: 0.45em;\n  height: 0.09em;\n  background: currentColor;\n  transform: rotate(-32deg);\n}\n/* ati-mandra: an extra dot below */\n.sw-ati-mandra::before {\n  content: '';\n  position: absolute;\n  left: 0.25em;\n  bottom: -0.35em;\n  width: 0.16em;\n  height: 0.16em;\n  border-radius: 50%;\n  background: currentColor;\n}\n/* ati-taar (reph already in the text): an extra dot above */\n.sw-ati-taar::before {\n  content: '';\n  position: absolute;\n  left: 0.25em;\n  top: -0.3em;\n  width: 0.16em;\n  height: 0.16em;\n  border-radius: 50%;\n  background: currentColor;\n}\n/* CSS reph fallback for vowel letters \u098B/\u090B that reject a real reph */\n.sw-reph-css::before {\n  content: '';\n  position: absolute;\n  top: -0.12em;\n  left: 0.12em;\n  width: 0.3em;\n  height: 0.3em;\n  border: 0.09em solid currentColor;\n  border-right: none;\n  border-bottom: none;\n  border-top-left-radius: 0.3em;\n}\n/* en octave dots (Bhatkhande-style) */\n.sw-dot-above::before,\n.sw-dot-below::before {\n  content: '';\n  position: absolute;\n  left: 50%;\n  margin-left: -0.07em;\n  width: 0.14em;\n  height: 0.14em;\n  border-radius: 50%;\n  background: currentColor;\n}\n.sw-dot-above::before { top: -0.25em; }\n.sw-dot-below::before { bottom: -0.2em; }\n.sw-ati-taar.sw-dot-above::before,\n.sw-ati-mandra.sw-dot-below::before { box-shadow: 0.24em 0 0 currentColor; margin-left: -0.19em; }\n/* en accidentals (bn/hi use distinct letters instead) */\n.sw-komal { text-decoration: underline; text-underline-offset: 0.18em; }\n.sw-tivra::after { content: '\\2032'; font-size: 0.7em; vertical-align: super; }\n\n/* kan grace: small raised cluster left of the main note */\n.sw-kan {\n  position: relative;\n  display: inline-block;\n  font-size: 0.58em;\n  vertical-align: 0.75em;\n  margin-right: 0.08em;\n}\n\n.sw-hy { padding-right: 0.02em; }\n.sw-iso { display: inline-block; margin-left: -0.18em; }\n.sw-cut { font-size: 0.8em; display: inline-block; margin-left: -0.15em; }\n.sw-br { opacity: 0.8; padding: 0 0.06em; }\n.sw-micro { font-size: 0.6em; vertical-align: super; opacity: 0.8; }\n\n/* raw fallback: never dropped, visibly non-notation */\n.sw-raw {\n  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;\n  font-size: 0.72em;\n  opacity: 0.55;\n}\n\n/* ---- bars: dari (thin) and danda strokes, notation-row height ---- */\n/* horizontal gap before a bar comes from its own .sw-cs padding-left \u2014\n * never reset it with a padding shorthand here */\n.sw-bar {\n  grid-row: 2;\n  align-self: stretch;\n  display: inline-flex;\n  align-items: stretch;\n  gap: 0.16em;\n  padding-right: 0.1em;\n}\n.sw-bar i { display: inline-block; width: 0.14em; min-height: 1.25em; background: currentColor; }\n.sw-bar--dari i { width: 0.05em; opacity: 0.9; }\n.sw-bar--quad i:nth-child(3) { margin-left: 0.18em; }\n.sw-above .sw-bar, .sw-below .sw-bar { display: inline-flex; vertical-align: baseline; }\n.sw-above .sw-bar i, .sw-below .sw-bar i { min-height: 1em; }\n\n/* ---- under-arcs (slurs decoded from w/x segments and meend) ---- */\n.sw-arc {\n  align-self: start;\n  height: 0.4em;\n  margin: 0.05em 0.25em 0;\n  border: 0.09em solid currentColor;\n  border-top: none;\n  border-bottom-left-radius: 0.6em;\n  border-bottom-right-radius: 0.6em;\n  opacity: 0.85;\n}\n.sw-arc--openl { border-left: none; border-bottom-left-radius: 0; }\n.sw-arc--openr { border-right: none; border-bottom-right-radius: 0; }\n.sw-arc--line { border-left: none; border-right: none; border-radius: 0; height: 0.22em; }\n\n/* ---- annotation content ---- */\n.sw-beat { position: relative; display: inline-block; padding: 0 0.1em; }\n.sw-sam::after {\n  content: '';\n  position: absolute;\n  top: -0.45em;\n  left: 50%;\n  width: 0.1em;\n  height: 0.4em;\n  background: currentColor;\n  transform: rotate(14deg);\n}\n.sw-stop i {\n  display: inline-block;\n  width: 0.07em;\n  height: 1em;\n  margin: 0 0.07em;\n  background: currentColor;\n  vertical-align: text-bottom;\n}\n\n/* ---- player sync (P2.3) ---- */\n.sw-hl { background: var(--sw-hl, rgba(255, 196, 64, 0.45)); border-radius: 0.15em; }\n\n/* ---- element error box ---- */\n.sw-error {\n  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;\n  font-size: 0.85em;\n  padding: 0.6em 0.8em;\n  border: 1px solid rgba(200, 64, 64, 0.6);\n  border-radius: 0.3em;\n  color: #b33;\n  background: rgba(200, 64, 64, 0.08);\n}\n";
+/** Notation fonts, self-hosted on the project CDN (CORS-enabled), keyed by
+ * the CSS `font-family` this stylesheet uses. bn = NLTR's Swarabitan; hi/en
+ * = Ome Bhatkhande (SIL OFL 1.1, © Omenad — github.com/omenad/fonts).
+ * Self-hosters: declare your own \`@font-face\` for any of these families
+ * before this stylesheet / before defineSwaralipiSheet() and it wins. */
+declare const NOTATION_FONT_URLS: Record<string, string>;
+declare const SWARALIPI_CSS: string;
 /**
  * Print stylesheet — pair with `SWARALIPI_CSS` (renderPrintDocument injects
  * both). Gated on `@media print`, so it also works if a consumer drops it into
@@ -282,4 +276,4 @@ type Transliterator = (bengaliText: string) => string;
  */
 declare function loadLyricTransliterator(lang: ViewerLang): Promise<Transliterator | undefined>;
 
-export { type Arc, type Cell, type Cluster, type ComposeOptions, DIGITS, LABELS, LETTERS, MARKS, type PrintOptions, type RenderOptions, SWARALIPI_CSS, SWARALIPI_PRINT_CSS, type SwaralipiSheetElement, type Transliterator, type ViewerLang, composeCluster, defineSwaralipiSheet, groupRowIntoCells, loadLyricTransliterator, localizeDigits, printSwaralipi, renderPrintDocument, renderToHtml, resolveArcs };
+export { type Arc, type Cell, type Cluster, type ComposeOptions, DIGITS, LABELS, MARKS, NOTATION_FONT_URLS, type PrintOptions, type RenderOptions, SWARALIPI_CSS, SWARALIPI_PRINT_CSS, type SwaralipiSheetElement, type Transliterator, type ViewerLang, composeCluster, defineSwaralipiSheet, groupRowIntoCells, loadLyricTransliterator, localizeDigits, printSwaralipi, renderPrintDocument, renderToHtml, resolveArcs };