vector-score 1.1.0 → 1.2.1

package/dist/vector-score.js

@@ -1,4 +1,4 @@
-const I = {
+const R = {
   treble: {
     staffType: "treble",
     paddingTop: 13,
@@ -31,16 +31,16 @@ const I = {
     topLineYPos: 0,
     bottomLineYPos: 110
   }
-}, E = {
+}, p = {
   w: 4,
   h: 2,
   q: 1,
   e: 0.5,
   s: 0.25
-}, w = 8, M = 40, X = {
+}, at = 6, ct = 5, _ = 22, T = 30, u = 10, g = 6, ht = 4, lt = u * 2, M = 51, dt = 12, ft = 4, $ = 1, P = 4, k = 1, W = g * 2 + P + 4, rt = 16, S = 12, Z = rt, ut = 2, V = 8, Et = 40, nt = {
   sharp: ["F", "C", "G", "D", "A", "E", "B"],
   flat: ["B", "E", "A", "D", "G", "C", "F"]
-}, G = {
+}, q = {
   C: { type: "sharp", count: 0 },
   G: { type: "sharp", count: 1 },
   D: { type: "sharp", count: 2 },
@@ -54,7 +54,7 @@ const I = {
   Ab: { type: "flat", count: 4 },
   Db: { type: "flat", count: 5 },
   Gb: { type: "flat", count: 6 }
-}, L = {
+}, x = {
   treble: {
     sharp: [5, 5, 5, 5, 4, 5, 4],
     // F5 C5 G5 D5 A4 E5 B4
@@ -75,22 +75,22 @@ const I = {
   },
   grand: { sharp: [], flat: [] }
 };
-function Y(h) {
-  const e = G[h];
-  if (!e) throw new Error(`Unknown key signature "${h}". Valid keys: ${Object.keys(G).join(", ")}`);
+function gt(h) {
+  const e = q[h];
+  if (!e) throw new Error(`Unknown key signature "${h}". Valid keys: ${Object.keys(q).join(", ")}`);
   return e;
 }
-function k(h, e, t, s) {
-  const r = Y(t);
+function At(h, e, t, s) {
+  const r = gt(t);
   if (r.count === 0) return 0;
   const n = r.type === "sharp" ? "ACCIDENTAL_SHARP" : "ACCIDENTAL_FLAT", o = h.getLayerByName("staff");
-  return e.getKeySignatureYPositions(r.type, r.count).forEach((i) => {
-    i.forEach((c, l) => {
-      h.drawGlyph(n, o, { xOffset: s + l * w, yOffset: c });
+  return e.getKeySignatureYPositions(r.type, r.count).forEach((a) => {
+    a.forEach((c, l) => {
+      h.drawGlyph(n, o, { xOffset: s + l * V, yOffset: c });
     });
-  }), r.count * w;
+  }), r.count * V;
 }
-const $ = {
+const pt = {
   CLEF_TREBLE: {
     path: "m150 273 10 58c2 7 2 7 12 7 59 0 96 46 96 97 0 45-26 79-67 95-5 2-6 2-5 7 4 25 12 63 12 85 0 68-52 80-79 80-61 0-76-39-76-65 0-25 16-46 43-46 24 0 38 19 38 41 0 23-14 34-27 38-9 2-13 4-13 6 0 6 11 12 32 12 24 0 64-7 64-66 0-19-6-54-11-81-1-5-1-4-6-3l-27 2C48 540 0 474 0 404c0-80 61-138 119-185 5-4 4-5 3-10-2-16-5-42-5-65 0-42 9-92 39-125 8-9 20-19 26-19 4 0 15 11 21 20 16 24 26 58 26 93 0 61-33 112-76 153-3 2-3 2-3 7Zm38-211c-24 0-53 38-53 101l2 37c1 5 3 5 5 3 32-28 70-64 70-108 0-22-11-33-24-33Zm-44 272-8-51c-1-4-2-5-6-1-18 15-37 30-61 56-33 38-37 70-37 93 0 56 45 95 115 95l23-2c6-2 6-2 5-6l-20-119c-1-5-1-5-8-3-24 6-40 24-40 46 0 19 12 36 29 43 3 1 6 3 6 5 0 3-2 5-5 5l-11-3c-27-9-46-34-46-70 0-34 23-66 58-78 8-2 8-2 6-10Zm28 64 20 114c0 5 1 5 6 2 22-11 38-31 38-56 0-36-27-63-60-66-4 0-5 1-4 6Z",
     xOffset: 0,
@@ -186,9 +186,9 @@ const $ = {
     xOffset: 0,
     yOffset: 0
   }
-}, W = /^(?<name>[A-Ga-g])(?<accidental>##|bb|[#bn]?)(?<octave>\d)(?<duration>[whqeWHQE]?)$/, Z = /^[whqeWHQE]$/, y = ["C", "D", "E", "F", "G", "A", "B"];
-function O(h) {
-  const e = h.match(W);
+}, It = /^(?<name>[A-Ga-g])(?<accidental>##|bb|[#bn]?)(?<octave>\d)(?<duration>[whqeWHQE]?)$/, _t = /^[whqeWHQE]$/, X = ["C", "D", "E", "F", "G", "A", "B"];
+function U(h) {
+  const e = h.match(It);
   if (!e || !e.groups)
     throw new Error(`Invalid note string format: ${h}. Expected format: [A-Ga-g][#|b]?[0-9][w|h|q|e].`);
   let { name: t, accidental: s, octave: r, duration: n } = e.groups;
@@ -200,12 +200,12 @@ function O(h) {
   };
   return s && (o.accidental = s), o;
 }
-function N(h) {
-  const e = h.match(Z);
+function b(h) {
+  const e = h.match(_t);
   if (!e) throw new Error(`Invalid note duration '${h}'. Use w | h | q | e.`);
   return e[0].toString().toLowerCase();
 }
-function R(h) {
+function Y(h) {
   let e;
   switch (h) {
     case "treble":
@@ -221,22 +221,22 @@ function R(h) {
   if (!e) throw new Error(`Invalid clef type: ${h}. Valid clef types are: treble, bass, alto.`);
   return e;
 }
-function F(h) {
-  let e = y.indexOf(h.name);
+function z(h) {
+  let e = X.indexOf(h.name);
   return e += h.octave * 12, e;
 }
-function _(h, e) {
-  return y.indexOf(h.name) - y.indexOf(e.name) + (h.octave - e.octave) * 7;
+function N(h, e) {
+  return X.indexOf(h.name) - X.indexOf(e.name) + (h.octave - e.octave) * 7;
 }
-const C = 48, v = 40 + 30 / 2, D = 20, B = 90;
-class x {
+const G = 48, j = 40 + 30 / 2, K = 20, Q = 90;
+class ot {
   params;
   rendererRef;
   width = 0;
   trebleStaffHeight = 0;
   constructor(e, t) {
     this.rendererRef = e;
-    const s = I[t];
+    const s = R[t];
     if (!s) throw new Error(`Staff type ${t} is not supported`);
     this.params = s;
   }
@@ -252,17 +252,17 @@ class x {
     let s = this.drawStaffLines(0, t), r = this.drawStaffLines(s + 30, t);
     this.rendererRef.drawLine(0, 0, 0, r, t), this.rendererRef.drawLine(this.width, 0, this.width, r, t), this.trebleStaffHeight = s;
     let n = r, o = 1;
-    const a = R("treble"), i = R("bass");
-    this.rendererRef.drawGlyph(a, t), this.rendererRef.drawGlyph(i, t, { yOffset: s + 30 }), n += this.params.paddingBottom + 1, o += this.params.paddingTop, this.rendererRef.addTotalRootSvgHeight(n), this.rendererRef.addTotalRootSvgYOffset(o);
+    const i = Y("treble"), a = Y("bass");
+    this.rendererRef.drawGlyph(i, t), this.rendererRef.drawGlyph(a, t, { yOffset: s + 30 }), n += this.params.paddingBottom + 1, o += this.params.paddingTop, this.rendererRef.addTotalRootSvgHeight(n), this.rendererRef.addTotalRootSvgYOffset(o);
   };
   shouldNoteFlip(e) {
-    const t = Math.abs(e - B), s = Math.abs(e - D);
-    return e === v ? !1 : t <= s ? !(e >= B) : e <= D;
+    const t = Math.abs(e - Q), s = Math.abs(e - K);
+    return e === j ? !1 : t <= s ? !(e >= Q) : e <= K;
   }
   getLedgerLinesX(e, t) {
-    const s = [], r = F(e);
+    const s = [], r = z(e);
     let n = e.duration === "w" ? 17 : 12.5;
-    if (r === C)
+    if (r === G)
       return s.push({ x1: -2, x2: n, yPos: 0 }), s;
     if (t < this.params.topLineYPos) {
       let o = this.params.topLineYPos - 10;
@@ -284,41 +284,41 @@ class x {
     return s;
   }
   calculateNoteYPos = (e) => {
-    let s = _(this.params.topLineNote, e) * (10 / 2);
-    const r = F(e);
-    return r < C ? s += 10 : r === C && (s = v), s;
+    let s = N(this.params.topLineNote, e) * (10 / 2);
+    const r = z(e);
+    return r < G ? s += 10 : r === G && (s = j), s;
   };
   getKeySignatureYPositions(e, t) {
-    const s = X[e].slice(0, t), r = L.treble[e], n = L.bass[e], o = s.map(
-      (i, c) => _(I.treble.topLineNote, { name: i, octave: r[c] }) * (10 / 2)
-    ), a = s.map(
-      (i, c) => _(I.bass.topLineNote, { name: i, octave: n[c] }) * (10 / 2) + this.trebleStaffHeight + 30
+    const s = nt[e].slice(0, t), r = x.treble[e], n = x.bass[e], o = s.map(
+      (a, c) => N(R.treble.topLineNote, { name: a, octave: r[c] }) * (10 / 2)
+    ), i = s.map(
+      (a, c) => N(R.bass.topLineNote, { name: a, octave: n[c] }) * (10 / 2) + this.trebleStaffHeight + 30
     );
-    return [o, a];
+    return [o, i];
   }
 }
-const V = 20;
-class A {
+const Tt = 20;
+class m {
   params;
   rendererRef;
   constructor(e, t) {
     this.rendererRef = e;
-    const s = I[t];
+    const s = R[t];
     if (!s) throw new Error(`Staff type ${t} is not supported`);
     this.params = s;
   }
   drawStaff = (e) => {
     const t = this.rendererRef.getLayerByName("staff");
     let s = 0;
-    for (let a = 0; a < 5; a++)
+    for (let i = 0; i < 5; i++)
       this.rendererRef.drawLine(0, s, e, s, t), s += 10;
     this.rendererRef.drawLine(0, 0, 0, s - 10, t), this.rendererRef.drawLine(e, 0, e, s - 10, t);
     let r = s - 10 + 1, n = 1;
-    const o = R(this.params.staffType);
+    const o = Y(this.params.staffType);
     this.rendererRef.drawGlyph(o, t), r += this.params.paddingTop + this.params.paddingBottom, n += this.params.paddingTop, this.rendererRef.addTotalRootSvgHeight(r), this.rendererRef.addTotalRootSvgYOffset(n);
   };
   shouldNoteFlip(e) {
-    return e <= V;
+    return e <= Tt;
   }
   getLedgerLinesX(e, t) {
     const s = [];
@@ -342,15 +342,15 @@ class A {
     }
     return s;
   }
-  calculateNoteYPos = (e) => _(this.params.topLineNote, e) * (10 / 2);
+  calculateNoteYPos = (e) => N(this.params.topLineNote, e) * (10 / 2);
   getKeySignatureYPositions(e, t) {
-    const s = X[e].slice(0, t), r = L[this.params.staffType][e];
+    const s = nt[e].slice(0, t), r = x[this.params.staffType][e];
     return [s.map(
-      (o, a) => this.calculateNoteYPos({ name: o, octave: r[a] })
+      (o, i) => this.calculateNoteYPos({ name: o, octave: r[i] })
     )];
   }
 }
-class U {
+class it {
   svgRendererInstance;
   strategyInstance;
   constructor(e, t) {
@@ -364,9 +364,9 @@ class U {
     for (let n = 0; n < e.length; n++) {
       const o = e[n];
       if (o.noteObj.accidental && r < 3 ? (t += -8, s = Math.min(s, t), r++) : o.noteObj.accidental && r <= 3 ? (t = -8, r = 1) : (t = 0, r = 0), t !== 0) {
-        const i = Array.from(o.noteGroup.getElementsByTagName("use")).find((c) => c.getAttribute("href")?.includes("ACCIDENTAL"));
-        if (!i) continue;
-        i.setAttribute("transform", `translate(${t + 8}, 0)`);
+        const a = Array.from(o.noteGroup.getElementsByTagName("use")).find((c) => c.getAttribute("href")?.includes("ACCIDENTAL"));
+        if (!a) continue;
+        a.setAttribute("transform", `translate(${t + 8}, 0)`);
       }
     }
     return -s;
@@ -375,13 +375,13 @@ class U {
     let t = e[0], s = 0;
     for (let r = 1; r < e.length; r++) {
       const n = e[r];
-      if (-_(t.noteObj, n.noteObj) === 1) {
+      if (-N(t.noteObj, n.noteObj) === 1) {
         s = 28 / 2, n.noteGroup.setAttribute("transform", `translate(${s}, ${n.noteYPos})`);
-        const i = Array.from(n.noteGroup.getElementsByTagName("use")).find((c) => c.getAttribute("href")?.includes("ACCIDENTAL"));
-        if (i) {
-          const c = i.getAttribute("transform")?.match(/([-]?\d+)/), l = c && c[0];
-          let f = -s;
-          l && (f += Number(l)), i.setAttribute("transform", `translate(${f}, 0)`);
+        const a = Array.from(n.noteGroup.getElementsByTagName("use")).find((c) => c.getAttribute("href")?.includes("ACCIDENTAL"));
+        if (a) {
+          const c = a.getAttribute("transform")?.match(/([-]?\d+)/), l = c && c[0];
+          let d = -s;
+          l && (d += Number(l)), a.setAttribute("transform", `translate(${d}, 0)`);
         }
         r++, t = e[r];
         continue;
@@ -392,7 +392,7 @@ class U {
   }
   // Handles drawing the glyphs to internal group, applies the xPositioning to note Cursor X
   renderNote(e) {
-    const t = this.svgRendererInstance.createGroup("note"), s = O(e), r = this.strategyInstance.calculateNoteYPos({
+    const t = this.svgRendererInstance.createGroup("note"), s = U(e), r = this.strategyInstance.calculateNoteYPos({
       name: s.name,
       octave: s.octave
     });
@@ -428,8 +428,8 @@ class U {
         this.svgRendererInstance.drawGlyph("ACCIDENTAL_DOUBLE_FLAT", t), o -= -14;
         break;
     }
-    return this.strategyInstance.getLedgerLinesX(s, r).forEach((i) => {
-      this.svgRendererInstance.drawLine(i.x1, i.yPos, i.x2, i.yPos, t);
+    return this.strategyInstance.getLedgerLinesX(s, r).forEach((a) => {
+      this.svgRendererInstance.drawLine(a.x1, a.yPos, a.x2, a.yPos, t);
     }), {
       noteGroup: t,
       noteObj: s,
@@ -441,11 +441,11 @@ class U {
   renderChord(e) {
     const t = this.svgRendererInstance.createGroup("chord"), s = [];
     for (const o of e) {
-      const a = this.renderNote(o);
-      a.noteGroup.setAttribute("transform", `translate(0, ${a.noteYPos})`), t.appendChild(a.noteGroup), s.push({
-        noteGroup: a.noteGroup,
-        noteObj: a.noteObj,
-        noteYPos: a.noteYPos,
+      const i = this.renderNote(o);
+      i.noteGroup.setAttribute("transform", `translate(0, ${i.noteYPos})`), t.appendChild(i.noteGroup), s.push({
+        noteGroup: i.noteGroup,
+        noteObj: i.noteObj,
+        noteYPos: i.noteYPos,
         cursorOffset: 0,
         accidentalOffset: 0
       });
@@ -460,8 +460,8 @@ class U {
     };
   }
 }
-const u = "http://www.w3.org/2000/svg", q = 0.1, S = 1200;
-class b {
+const A = "http://www.w3.org/2000/svg", mt = 0.1, v = 1200;
+class w {
   rootElementRef;
   svgElementRef;
   // Layers
@@ -479,18 +479,21 @@ class b {
   // from get rootSvgElement().
   // HEIGHT and YOfsset should be set externally, values are calculated internally.
   constructor(e, t) {
-    this.rootElementRef = e, this.width = t.width, this.scale = t.scale, this.width > S && (this.width = S, console.warn(`Width provided for the staff ${this.width} exceeds the limit ${S}. Please use this value to fix positioning issues.`)), this.svgElementRef = document.createElementNS(u, "svg"), this.svgElementRef.classList.add("vs-svg-renderer-root"), this.svgElementRef.style.maxWidth = "100%", this.svgElementRef.style.height = "auto", this.svgElementRef.style.display = "block", this.svgElementRef.setAttribute("color", t.staffColor), this.svgElementRef.style.backgroundColor = t.staffBackgroundColor, this.makeGlyphDefs(t.useGlyphs), this.parentGroupContainer = this.createGroup("svg-renderer-parent"), this.svgElementRef.appendChild(this.parentGroupContainer), this.musicStaffLayer = this.createGroup("music-staff-layer"), this.musicNotesLayer = this.createGroup("music-notes-layer"), this.musicUILayer = this.createGroup("music-ui-layer"), this.parentGroupContainer.appendChild(this.musicStaffLayer), this.parentGroupContainer.appendChild(this.musicNotesLayer), this.parentGroupContainer.appendChild(this.musicUILayer);
+    this.rootElementRef = e, this.width = t.width, this.scale = t.scale, this.width > v && (this.width = v, console.warn(`Width provided for the staff ${this.width} exceeds the limit ${v}. Please use this value to fix positioning issues.`)), this.svgElementRef = document.createElementNS(A, "svg"), this.svgElementRef.classList.add("vs-svg-renderer-root"), this.svgElementRef.style.maxWidth = "100%", this.svgElementRef.style.height = "auto", this.svgElementRef.style.display = "block", this.svgElementRef.setAttribute("color", t.staffColor), this.svgElementRef.style.backgroundColor = t.staffBackgroundColor, this.makeGlyphDefs(t.useGlyphs), this.parentGroupContainer = this.createGroup("svg-renderer-parent"), this.svgElementRef.appendChild(this.parentGroupContainer), this.musicStaffLayer = this.createGroup("music-staff-layer"), this.musicNotesLayer = this.createGroup("music-notes-layer"), this.musicUILayer = this.createGroup("music-ui-layer"), this.parentGroupContainer.appendChild(this.musicStaffLayer), this.parentGroupContainer.appendChild(this.musicNotesLayer), this.parentGroupContainer.appendChild(this.musicUILayer);
   }
   // Creates SVG defs for all glyphs in GLYPH_ENTRIES, applies global scale and offsets, appends to root SVG
   makeGlyphDefs(e) {
-    const t = document.createElementNS(u, "defs");
-    Object.entries($).filter(([r]) => e.includes(r)).forEach(([r, n]) => {
-      const o = document.createElementNS(u, "path");
-      o.setAttribute("id", `glyph-${r}`), o.setAttribute("d", n.path), o.setAttribute("fill", "currentColor"), o.setAttribute("transform", `translate(${n.xOffset}, ${n.yOffset}) scale(${q})`), t.appendChild(o);
+    const t = document.createElementNS(A, "defs");
+    Object.entries(pt).filter(([r]) => e.includes(r)).forEach(([r, n]) => {
+      const o = document.createElementNS(A, "path");
+      o.setAttribute("id", `glyph-${r}`), o.setAttribute("d", n.path), o.setAttribute("fill", "currentColor"), o.setAttribute("transform", `translate(${n.xOffset}, ${n.yOffset}) scale(${mt})`), t.appendChild(o);
     }), this.rootSvgElement.appendChild(t);
   }
+  addNamespacedClassesToElement(e, t) {
+    [e].flat().forEach((r) => t.classList.add(`vs-${r}`));
+  }
   createGroup(e) {
-    const t = document.createElementNS(u, "g");
+    const t = document.createElementNS(A, "g");
     return e && t.classList.add(`vs-${e}`), t;
   }
   commitElementsToDOM(e, t = this.rootElementRef) {
@@ -514,6 +517,9 @@ class b {
   addTotalRootSvgHeight(e) {
     this.totalHeight += e;
   }
+  setTotalRootSvgHeight(e) {
+    this.totalHeight = e;
+  }
   addTotalRootSvgYOffset(e) {
     this.totalYOffset += e;
   }
@@ -531,12 +537,12 @@ class b {
   }
   // Drawing Methods
   drawLine(e, t, s, r, n) {
-    const o = document.createElementNS(u, "line");
+    const o = document.createElementNS(A, "line");
     o.setAttribute("x1", e.toString()), o.setAttribute("y1", t.toString()), o.setAttribute("x2", s.toString()), o.setAttribute("y2", r.toString()), o.setAttribute("stroke", "currentColor"), o.setAttribute("stroke-width", "1"), n.appendChild(o);
   }
   drawRect(e, t, s, r) {
-    const n = document.createElementNS(u, "rect");
-    return n.setAttribute("width", e.toString()), n.setAttribute("height", t.toString()), n.setAttribute("x", (r?.x ?? 0).toString()), n.setAttribute("y", (r?.y ?? 0).toString()), r?.fill ? n.setAttribute("fill", r.fill) : n.setAttribute("fill", "currentColor"), s.appendChild(n), n;
+    const n = document.createElementNS(A, "rect");
+    return n.setAttribute("width", e.toString()), n.setAttribute("height", t.toString()), n.setAttribute("x", (r?.x ?? 0).toString()), n.setAttribute("y", (r?.y ?? 0).toString()), r?.fill ? n.setAttribute("fill", r.fill) : n.setAttribute("fill", "currentColor"), r?.rx && n.setAttribute("rx", r.rx.toString()), r?.classes && this.addNamespacedClassesToElement(r.classes, n), s.appendChild(n), n;
   }
   drawGlyph(e, t, s) {
     s = {
@@ -544,14 +550,22 @@ class b {
       yOffset: 0,
       ...s
     };
-    const r = document.createElementNS(u, "use");
+    const r = document.createElementNS(A, "use");
     r.setAttribute("href", `#glyph-${e}`), (s.xOffset || s.yOffset) && r.setAttribute("transform", `translate(${s.xOffset}, ${s.yOffset})`), t.appendChild(r);
   }
+  drawCircle(e, t, s, r, n) {
+    const o = document.createElementNS(A, "circle");
+    return o.setAttribute("cx", e.toString()), o.setAttribute("cy", t.toString()), o.setAttribute("r", s.toString()), n?.filled === !1 ? (o.setAttribute("fill", "none"), o.setAttribute("stroke", "currentColor"), o.setAttribute("stroke-width", (n?.strokeWidth ?? 1.5).toString())) : o.setAttribute("fill", n?.fill ?? "currentColor"), n?.classes && this.addNamespacedClassesToElement(n.classes, o), r.appendChild(o), o;
+  }
+  drawText(e, t, s, r, n) {
+    const o = document.createElementNS(A, "text");
+    return o.setAttribute("x", t.toString()), o.setAttribute("y", s.toString()), o.setAttribute("text-anchor", n?.anchor ?? "middle"), o.setAttribute("fill", n?.fill ?? "currentColor"), n?.fontSize && o.setAttribute("font-size", n.fontSize + "px"), n?.fontWeight && o.setAttribute("font-weight", n.fontWeight), n?.classes && this.addNamespacedClassesToElement(n.classes, o), o.textContent = e, r.appendChild(o), o;
+  }
   destroy() {
     this.rootElementRef && this.svgElementRef && this.rootElementRef.contains(this.svgElementRef) && this.rootElementRef.removeChild(this.svgElementRef);
   }
 }
-const j = [
+const Ct = [
   "CLEF_TREBLE",
   "CLEF_BASS",
   "CLEF_ALTO",
@@ -566,7 +580,7 @@ const j = [
   "ACCIDENTAL_DOUBLE_SHARP",
   "ACCIDENTAL_DOUBLE_FLAT"
 ];
-class et {
+class bt {
   svgRendererInstance;
   strategyInstance;
   noteRendererInstance;
@@ -591,32 +605,32 @@ class et {
       staffColor: "black",
       staffBackgroundColor: "transparent",
       ...t
-    }, this.svgRendererInstance = new b(e, {
+    }, this.svgRendererInstance = new w(e, {
       width: this.options.width,
       height: 100,
       scale: this.options.scale,
       staffColor: this.options.staffColor,
       staffBackgroundColor: this.options.staffBackgroundColor,
-      useGlyphs: j
+      useGlyphs: Ct
     });
     const s = this.svgRendererInstance.rootSvgElement;
     switch (this.options.staffType) {
       case "grand":
-        this.strategyInstance = new x(this.svgRendererInstance, "grand");
+        this.strategyInstance = new ot(this.svgRendererInstance, "grand");
         break;
       case "bass":
-        this.strategyInstance = new A(this.svgRendererInstance, "bass");
+        this.strategyInstance = new m(this.svgRendererInstance, "bass");
         break;
       case "treble":
-        this.strategyInstance = new A(this.svgRendererInstance, "treble");
+        this.strategyInstance = new m(this.svgRendererInstance, "treble");
         break;
       case "alto":
-        this.strategyInstance = new A(this.svgRendererInstance, "alto");
+        this.strategyInstance = new m(this.svgRendererInstance, "alto");
         break;
       default:
         throw new Error(`The staff type ${this.options.staffType} is not supported. Please use "treble", "bass", "alto", or "grand".`);
     }
-    if (this.strategyInstance.drawStaff(this.options.width), this.noteRendererInstance = new U(this.svgRendererInstance, this.strategyInstance), this.options.spaceAbove) {
+    if (this.strategyInstance.drawStaff(this.options.width), this.noteRendererInstance = new it(this.svgRendererInstance, this.strategyInstance), this.options.spaceAbove) {
       const n = this.options.spaceAbove * 10;
       this.svgRendererInstance.addTotalRootSvgYOffset(n);
     }
@@ -628,7 +642,7 @@ class et {
     this.options.keySignature && (r = this.createKeySignature(this.options.keySignature)), this.noteStartX = 38 + this.options.noteStartX + r, this.svgRendererInstance.getLayerByName("notes").setAttribute("transform", `translate(${this.noteStartX}, 0)`), this.svgRendererInstance.applySizingToRootSvg(), this.svgRendererInstance.commitElementsToDOM(s);
   }
   createKeySignature(e) {
-    return k(this.svgRendererInstance, this.strategyInstance, e, M);
+    return At(this.svgRendererInstance, this.strategyInstance, e, Et);
   }
   /**
    * Draws a note on the staff.
@@ -656,8 +670,8 @@ class et {
       let o;
       try {
         o = this.noteRendererInstance.renderNote(n);
-      } catch (a) {
-        throw r.length > 0 && this.svgRendererInstance.commitElementsToDOM(r, s), a;
+      } catch (i) {
+        throw r.length > 0 && this.svgRendererInstance.commitElementsToDOM(r, s), i;
       }
       o.noteGroup.setAttribute("transform", `translate(${this.noteCursorX + o.accidentalOffset}, ${o.noteYPos})`), this.noteEntries.push({
         gElement: o.noteGroup,
@@ -689,7 +703,7 @@ class et {
     const t = this.svgRendererInstance.getLayerByName("notes"), s = this.noteRendererInstance.renderChord(e);
     s.noteGroup.setAttribute("transform", `translate(${this.noteCursorX + s.accidentalOffset}, 0)`), this.noteEntries.push({
       gElement: s.noteGroup,
-      note: O(e[0]),
+      note: U(e[0]),
       xPos: this.noteCursorX + s.accidentalOffset,
       yPos: 0,
       accidentalXOffset: s.accidentalOffset
@@ -704,15 +718,15 @@ class et {
     if (t <= 0 || e <= 0) return;
     const s = Math.round(e / t);
     this.noteEntries.map((n, o) => {
-      const a = (o + 0.5) * s, i = n.gElement.getBBox(), c = a - i.width / 2 - i.x, l = Math.round(c * 10) / 10;
+      const i = (o + 0.5) * s, a = n.gElement.getBBox(), c = i - a.width / 2 - a.x, l = Math.round(c * 10) / 10;
       return {
         entry: n,
         newX: l,
         isChord: n.gElement.classList.contains("chord")
       };
     }).forEach((n) => {
-      const { entry: o, newX: a, isChord: i } = n;
-      i ? o.gElement.setAttribute("transform", `translate(${a}, 0)`) : o.gElement.setAttribute("transform", `translate(${a}, ${o.yPos})`), o.xPos = a;
+      const { entry: o, newX: i, isChord: a } = n;
+      a ? o.gElement.setAttribute("transform", `translate(${i}, 0)`) : o.gElement.setAttribute("transform", `translate(${i}, ${o.yPos})`), o.xPos = i;
     });
   }
   /**
@@ -771,7 +785,7 @@ class et {
     const s = this.noteEntries[t], r = this.noteRendererInstance.renderChord(e), o = s.xPos - s.accidentalXOffset + r.accidentalOffset;
     r.noteGroup.setAttribute("transform", `translate(${o}, 0)`), this.svgRendererInstance.getLayerByName("notes").replaceChild(r.noteGroup, s.gElement), this.noteEntries[t] = {
       gElement: r.noteGroup,
-      note: O(e[0]),
+      note: U(e[0]),
       xPos: o,
       yPos: 0,
       accidentalXOffset: r.accidentalOffset
@@ -807,7 +821,7 @@ class et {
     this.noteEntries = [], this.svgRendererInstance.destroy();
   }
 }
-const d = 30, H = 19, g = 12, K = 4, Q = 6, P = 1, m = 38, z = [
+const I = 30, J = 19, F = 12, St = 4, Nt = 6, tt = 1, D = 38, Lt = [
   "TIME_4",
   "TIME_3",
   "NOTE_HEAD_WHOLE",
@@ -819,7 +833,7 @@ const d = 30, H = 19, g = 12, K = 4, Q = 6, P = 1, m = 38, z = [
   "REST_QUARTER",
   "REST_EIGHTH"
 ];
-class st {
+class Gt {
   rendererInstance;
   options;
   barSpacing;
@@ -830,7 +844,7 @@ class st {
   currentBeatCount = 0;
   currentBeatUICount = 0;
   currentBeatUIElement = null;
-  currentBeatUIXPos = m;
+  currentBeatUIXPos = D;
   /**
    * Creates an instance of a RhythmStaff, A single staff that will automatically apply positioning of elements based on the duration of a note.
    *
@@ -850,13 +864,13 @@ class st {
       staffBackgroundColor: "white",
       currentBeatUIColor: "#24ff7450",
       ...t
-    }, this.rendererInstance = new b(e, {
+    }, this.rendererInstance = new w(e, {
       width: this.options.width,
       height: 100,
       scale: this.options.scale,
       staffColor: this.options.staffColor,
       staffBackgroundColor: this.options.staffBackgroundColor,
-      useGlyphs: z
+      useGlyphs: Lt
     });
     const s = this.rendererInstance.rootSvgElement;
     let r = "TIME_4";
@@ -872,41 +886,41 @@ class st {
     }
     if (this.options.barsCount < 1 || this.options.barsCount > 3) throw new Error(`Bars count ${this.options.barsCount} not supported. Please use 1 - 3`);
     if (this.options.spaceAbove) {
-      const p = this.options.spaceAbove * 10;
-      this.rendererInstance.addTotalRootSvgYOffset(p);
+      const f = this.options.spaceAbove * 10;
+      this.rendererInstance.addTotalRootSvgYOffset(f);
     }
     if (this.options.spaceBelow) {
-      let p = this.options.spaceBelow * 10;
-      this.rendererInstance.addTotalRootSvgHeight(p);
+      let f = this.options.spaceBelow * 10;
+      this.rendererInstance.addTotalRootSvgHeight(f);
     }
     const n = this.rendererInstance.getLayerByName("staff");
-    this.rendererInstance.addTotalRootSvgHeight(d * 2);
+    this.rendererInstance.addTotalRootSvgHeight(I * 2);
     const o = this.rendererInstance.createGroup("time-signature");
     n.appendChild(o);
-    const a = d - H;
-    this.rendererInstance.drawGlyph(r, o), this.rendererInstance.drawGlyph("TIME_4", o, { yOffset: H }), o.setAttribute("transform", `translate(0, ${a})`);
-    let i = this.options.width - 38;
-    this.options.barsCount > 1 && (i -= (this.options.barsCount - 1) * g), i -= P, this.rendererInstance.drawLine(0, d, this.options.width - P, d, n), this.barSpacing = i / this.options.barsCount, this.quarterNoteSpacing = Math.round(this.barSpacing / this.options.topNumber), this.maxBeatCount = this.options.barsCount * this.options.topNumber;
+    const i = I - J;
+    this.rendererInstance.drawGlyph(r, o), this.rendererInstance.drawGlyph("TIME_4", o, { yOffset: J }), o.setAttribute("transform", `translate(0, ${i})`);
+    let a = this.options.width - 38;
+    this.options.barsCount > 1 && (a -= (this.options.barsCount - 1) * F), a -= tt, this.rendererInstance.drawLine(0, I, this.options.width - tt, I, n), this.barSpacing = a / this.options.barsCount, this.quarterNoteSpacing = Math.round(this.barSpacing / this.options.topNumber), this.maxBeatCount = this.options.barsCount * this.options.topNumber;
     let c = this.barSpacing + 38;
-    const l = d / 2, f = d + l;
-    for (let p = 0; p < this.options.barsCount - 1; p++)
-      this.rendererInstance.drawLine(c, l, c, f, n), c += this.barSpacing;
-    this.rendererInstance.getLayerByName("notes").setAttribute("transform", `translate(38, ${d})`), this.rendererInstance.applySizingToRootSvg(), this.rendererInstance.commitElementsToDOM(s);
+    const l = I / 2, d = I + l;
+    for (let f = 0; f < this.options.barsCount - 1; f++)
+      this.rendererInstance.drawLine(c, l, c, d, n), c += this.barSpacing;
+    this.rendererInstance.getLayerByName("notes").setAttribute("transform", `translate(38, ${I})`), this.rendererInstance.applySizingToRootSvg(), this.rendererInstance.commitElementsToDOM(s);
   }
   createBeatUIElement() {
     const e = this.rendererInstance.getLayerByName("ui");
     this.currentBeatUIElement = this.rendererInstance.drawRect(
       this.quarterNoteSpacing / 2,
-      d * 2,
+      I * 2,
       e,
       {
-        x: m,
+        x: D,
         fill: this.options.currentBeatUIColor
       }
     );
   }
   handleNewBar() {
-    this.noteCursorX += g;
+    this.noteCursorX += F;
   }
   // Translates group, returns cursor increment amount
   translateGroupByDuration(e, t) {
@@ -966,14 +980,14 @@ class st {
     for (; s > 0; ) {
       const r = this.rendererInstance.createGroup("rest");
       let n = 0;
-      s - E.h >= 0 ? (this.rendererInstance.drawGlyph("REST_HALF", r), n = E.h) : s - E.q >= 0 ? (this.rendererInstance.drawGlyph("REST_QUARTER", r), n = E.q) : (this.rendererInstance.drawGlyph("REST_EIGHTH", r), n = E.e), s -= n, this.currentBeatCount += n, r.setAttribute("transform", `translate(${this.noteCursorX}, 0)`), this.noteCursorX += n * this.quarterNoteSpacing, t.push(r);
+      s - p.h >= 0 ? (this.rendererInstance.drawGlyph("REST_HALF", r), n = p.h) : s - p.q >= 0 ? (this.rendererInstance.drawGlyph("REST_QUARTER", r), n = p.q) : (this.rendererInstance.drawGlyph("REST_EIGHTH", r), n = p.e), s -= n, this.currentBeatCount += n, r.setAttribute("transform", `translate(${this.noteCursorX}, 0)`), this.noteCursorX += n * this.quarterNoteSpacing, t.push(r);
     }
     return t;
   }
   renderBeamRect(e, t, s, r) {
     this.rendererInstance.drawRect(
       e - t,
-      K,
+      St,
       s,
       {
         x: 10,
@@ -1005,20 +1019,20 @@ class st {
     for (const n of t) {
       let o = "w";
       try {
-        o = N(n);
-      } catch (f) {
-        throw r.length > 0 && this.rendererInstance.commitElementsToDOM(r, s), f;
+        o = b(n);
+      } catch (d) {
+        throw r.length > 0 && this.rendererInstance.commitElementsToDOM(r, s), d;
       }
-      const a = E[o];
+      const i = p[o];
       if (this.currentBeatCount >= this.maxBeatCount)
         throw r.length > 0 && this.rendererInstance.commitElementsToDOM(r, s), new Error("Max beat count reached. Can't add additional notes.");
       this.checkAndCreateNewBar();
-      const i = this.checkAndFillBarWithRests(a);
-      i && i.forEach((f) => {
-        r.push(f), this.noteEntries.push(f);
+      const a = this.checkAndFillBarWithRests(i);
+      a && a.forEach((d) => {
+        r.push(d), this.noteEntries.push(d);
       });
-      const c = this.rendererInstance.createGroup("note"), l = this.translateGroupByDuration(a, c);
-      this.noteCursorX += l, this.currentBeatCount += a, this.renderNote(o, c), r.push(c), this.noteEntries.push(c);
+      const c = this.rendererInstance.createGroup("note"), l = this.translateGroupByDuration(i, c);
+      this.noteCursorX += l, this.currentBeatCount += i, this.renderNote(o, c), r.push(c), this.noteEntries.push(c);
     }
     this.rendererInstance.commitElementsToDOM(r, s);
   }
@@ -1045,18 +1059,18 @@ class st {
     for (const n of t) {
       let o = "w";
       try {
-        o = N(n);
-      } catch (f) {
-        throw r.length > 0 && this.rendererInstance.commitElementsToDOM(r, s), f;
+        o = b(n);
+      } catch (d) {
+        throw r.length > 0 && this.rendererInstance.commitElementsToDOM(r, s), d;
       }
-      const a = this.rendererInstance.createGroup("rest"), i = E[o], c = i * this.quarterNoteSpacing;
+      const i = this.rendererInstance.createGroup("rest"), a = p[o], c = a * this.quarterNoteSpacing;
       if (this.currentBeatCount >= this.maxBeatCount)
         throw r.length > 0 && this.rendererInstance.commitElementsToDOM(r, s), new Error("Max beat count reached. Can't add additional notes.");
       this.checkAndCreateNewBar();
-      const l = this.checkAndFillBarWithRests(i);
-      l && l.forEach((f) => {
-        r.push(f), this.noteEntries.push(f);
-      }), this.renderRest(o, a), a.setAttribute("transform", `translate(${this.noteCursorX}, 0)`), this.noteCursorX += c, this.currentBeatCount += i, r.push(a), this.noteEntries.push(a);
+      const l = this.checkAndFillBarWithRests(a);
+      l && l.forEach((d) => {
+        r.push(d), this.noteEntries.push(d);
+      }), this.renderRest(o, i), i.setAttribute("transform", `translate(${this.noteCursorX}, 0)`), this.noteCursorX += c, this.currentBeatCount += a, r.push(i), this.noteEntries.push(i);
     }
     this.rendererInstance.commitElementsToDOM(r, s);
   }
@@ -1083,13 +1097,13 @@ class st {
     if (this.currentBeatCount >= this.maxBeatCount)
       throw new Error("Max beat count reached. Can't add additional beamed note.");
     let s = "s";
-    e === "s" ? s = "s" : s = N(e), this.checkAndCreateNewBar();
-    const r = this.rendererInstance.getLayerByName("notes"), n = E[s], o = n * this.quarterNoteSpacing, a = this.options.topNumber - this.currentBeatCount % this.options.topNumber, i = Math.min(t, a / n), c = this.rendererInstance.createGroup("beamed-note");
+    e === "s" ? s = "s" : s = b(e), this.checkAndCreateNewBar();
+    const r = this.rendererInstance.getLayerByName("notes"), n = p[s], o = n * this.quarterNoteSpacing, i = this.options.topNumber - this.currentBeatCount % this.options.topNumber, a = Math.min(t, i / n), c = this.rendererInstance.createGroup("beamed-note");
     c.setAttribute("transform", `translate(${this.noteCursorX}, 0)`);
     let l = 0;
-    for (let f = 0; f < i; f++)
+    for (let d = 0; d < a; d++)
       this.rendererInstance.drawGlyph("NOTE_HEAD_QUARTER", c, { xOffset: l }), this.drawStem(c, l), l += o, this.currentBeatCount += n;
-    this.renderBeamRect(l, o, c), e === "s" && this.renderBeamRect(l, o, c, Q), this.noteCursorX += l, this.noteEntries.push(c), this.rendererInstance.commitElementsToDOM(c, r);
+    this.renderBeamRect(l, o, c), e === "s" && this.renderBeamRect(l, o, c, Nt), this.noteCursorX += l, this.noteEntries.push(c), this.rendererInstance.commitElementsToDOM(c, r);
   }
   /**
    * Will increment the UI showing the current beat in quarters. Once exceeded, must be reset with `resetCurrentBeatUI()`
@@ -1100,14 +1114,14 @@ class st {
       this.currentBeatUIElement.setAttribute("display", "none");
       return;
     }
-    this.currentBeatUIElement?.getAttribute("display") === "none" && this.currentBeatUIElement.removeAttribute("display"), this.currentBeatUICount++, this.currentBeatUICount > this.options.topNumber && this.currentBeatUICount % this.options.topNumber === 1 && (this.currentBeatUIXPos += g), this.currentBeatUICount > 1 && (this.currentBeatUIXPos += this.quarterNoteSpacing), this.currentBeatUIElement.setAttribute("x", this.currentBeatUIXPos.toString());
+    this.currentBeatUIElement?.getAttribute("display") === "none" && this.currentBeatUIElement.removeAttribute("display"), this.currentBeatUICount++, this.currentBeatUICount > this.options.topNumber && this.currentBeatUICount % this.options.topNumber === 1 && (this.currentBeatUIXPos += F), this.currentBeatUICount > 1 && (this.currentBeatUIXPos += this.quarterNoteSpacing), this.currentBeatUIElement.setAttribute("x", this.currentBeatUIXPos.toString());
   }
   /**
    * Resets the ui showing the current beat value.
    * @returns void
   */
   resetCurrentBeatUI() {
-    this.currentBeatUICount = 0, this.currentBeatUIXPos = m, this.currentBeatUIElement && (this.currentBeatUIElement.setAttribute("display", "none"), this.currentBeatUIElement.setAttribute("x", this.currentBeatUIXPos.toString()));
+    this.currentBeatUICount = 0, this.currentBeatUIXPos = D, this.currentBeatUIElement && (this.currentBeatUIElement.setAttribute("display", "none"), this.currentBeatUIElement.setAttribute("x", this.currentBeatUIXPos.toString()));
   }
   /**
    * Clears staff of notes and resets internal positioning.
@@ -1124,7 +1138,7 @@ class st {
     this.noteEntries = [], this.rendererInstance.destroy();
   }
 }
-const J = [
+const Rt = [
   "CLEF_TREBLE",
   "CLEF_BASS",
   "CLEF_ALTO",
@@ -1138,8 +1152,8 @@ const J = [
   "ACCIDENTAL_NATURAL",
   "ACCIDENTAL_DOUBLE_SHARP",
   "ACCIDENTAL_DOUBLE_FLAT"
-], T = 60, tt = T;
-class rt {
+], y = 60, yt = y;
+class vt {
   svgRendererInstance;
   strategyInstance;
   noteRendererInstance;
@@ -1166,32 +1180,32 @@ class rt {
       staffColor: "black",
       staffBackgroundColor: "transparent",
       ...t
-    }, this.svgRendererInstance = new b(e, {
+    }, this.svgRendererInstance = new w(e, {
       width: this.options.width,
       height: 100,
       scale: this.options.scale,
       staffColor: this.options.staffColor,
       staffBackgroundColor: this.options.staffBackgroundColor,
-      useGlyphs: J
+      useGlyphs: Rt
     });
     const s = this.svgRendererInstance.rootSvgElement;
     switch (this.options.staffType) {
       case "grand":
-        this.strategyInstance = new x(this.svgRendererInstance, "grand");
+        this.strategyInstance = new ot(this.svgRendererInstance, "grand");
         break;
       case "bass":
-        this.strategyInstance = new A(this.svgRendererInstance, "bass");
+        this.strategyInstance = new m(this.svgRendererInstance, "bass");
         break;
       case "treble":
-        this.strategyInstance = new A(this.svgRendererInstance, "treble");
+        this.strategyInstance = new m(this.svgRendererInstance, "treble");
         break;
       case "alto":
-        this.strategyInstance = new A(this.svgRendererInstance, "alto");
+        this.strategyInstance = new m(this.svgRendererInstance, "alto");
         break;
       default:
         throw new Error(`The staff type ${this.options.staffType} is not supported. Please use "treble", "bass", "alto", or "grand".`);
     }
-    if (this.strategyInstance.drawStaff(this.options.width), this.noteRendererInstance = new U(this.svgRendererInstance, this.strategyInstance), this.options.spaceAbove) {
+    if (this.strategyInstance.drawStaff(this.options.width), this.noteRendererInstance = new it(this.svgRendererInstance, this.strategyInstance), this.options.spaceAbove) {
       const r = this.options.spaceAbove * 10;
       this.svgRendererInstance.addTotalRootSvgYOffset(r);
     }
@@ -1202,10 +1216,10 @@ class rt {
     this.notesLayer = this.svgRendererInstance.getLayerByName("notes"), this.notesLayer.classList.add("vs-scrolling-notes-layer"), this.noteStartX = 38 + this.options.noteStartX, this.svgRendererInstance.getLayerByName("notes").setAttribute("transform", `translate(${this.noteStartX}, 0)`), this.svgRendererInstance.applySizingToRootSvg(), this.svgRendererInstance.commitElementsToDOM(s);
   }
   renderFirstNoteGroups() {
-    const e = this.options.width - this.options.noteStartX + tt;
+    const e = this.options.width - this.options.noteStartX + yt;
     for (; this.noteBuffer.length > 0 && this.noteCursorX < e; )
-      this.renderNextNote(), this.noteCursorX += T;
-    this.activeEntries.length > 1 && (this.noteCursorX -= T);
+      this.renderNextNote(), this.noteCursorX += y;
+    this.activeEntries.length > 1 && (this.noteCursorX -= y);
   }
   renderNextNote() {
     if (this.noteBuffer.length < 1) return;
@@ -1264,7 +1278,7 @@ class rt {
       return;
     }
     this.activeEntries.forEach((t) => {
-      t.xPos -= T, t.noteWrapper.style.transform = `translate(${t.xPos}px, 0px)`;
+      t.xPos -= y, t.noteWrapper.style.transform = `translate(${t.xPos}px, 0px)`;
     });
     const e = this.activeEntries[0];
     e.xPos <= 0 && (this.notesLayer.removeChild(e.noteWrapper), this.activeEntries.shift()), this.renderNextNote();
@@ -1284,8 +1298,321 @@ class rt {
     this.svgRendererInstance.destroy(), this.activeEntries = [], this.noteBuffer = [];
   }
 }
+const wt = /^[xX\da-zA-Z]+$/, Ot = /^[\d]+$/;
+function et(h, e) {
+  const t = [];
+  for (let s = 0; s < h.length; s++)
+    t.push({
+      fret: h[s],
+      finger: e[s]
+    });
+  return t;
+}
+function st(h, e) {
+  const t = h.filter((n) => n.toLowerCase() !== "x" && n !== "0").map((n) => parseInt(n, 36));
+  if (t.length === 0) return 1;
+  const s = Math.min(...t);
+  return Math.max(...t) <= e ? 1 : s;
+}
+function H(h) {
+  if (!wt.test(h)) throw new Error("Invalid frets string. Only 'x', 'X', and digits are allowed.");
+  return h.split("");
+}
+function B(h) {
+  if (!Ot.test(h)) throw new Error("Invalid fingers string. Only digits are allowed.");
+  return h.split("");
+}
+class Ft {
+  svgRendererInstance;
+  options;
+  chordEntries = [];
+  cursorX = 0;
+  cursorY = 0;
+  diagramWidth;
+  diagramHeight;
+  gridTopY;
+  rowHeight;
+  /**
+   * Creates an instance of a GuitarChord diagram renderer.
+   *
+   * @param rootElementCtx - The element (div) reference that the chord diagram(s) will be appended to.
+   * @param options - Optional configuration. Can adjust total width, scale, string/fret count, and coloring.
+   * All config options are in the type GuitarChordOptions.
+  */
+  constructor(e, t) {
+    if (this.options = {
+      stringCount: at,
+      fretCount: ct,
+      stringLabels: [],
+      inlineChordsAmount: 2,
+      scale: 1,
+      color: "black",
+      backgroundColor: "transparent",
+      ...t
+    }, this.diagramWidth = (this.options.stringCount - 1) * _, this.diagramHeight = this.options.fretCount * T, this.gridTopY = Z + W, this.rowHeight = this.gridTopY + this.diagramHeight + $, t?.width ? this.options.width = t.width : this.options.width = (this.diagramWidth + M) * this.options.inlineChordsAmount, this.options.stringLabels.length >= 1 && (this.rowHeight += lt + ht), this.diagramWidth > this.options.width)
+      throw new Error(`The configured width (${this.options.width}) is too small to fit a single ${this.options.stringCount}-string diagram (needs at least ${this.diagramWidth}). Increase 'width'.`);
+    this.svgRendererInstance = new w(e, {
+      width: this.options.width,
+      height: 100,
+      scale: this.options.scale,
+      staffColor: this.options.color,
+      staffBackgroundColor: this.options.backgroundColor,
+      useGlyphs: []
+    });
+    const s = this.svgRendererInstance.rootSvgElement;
+    this.svgRendererInstance.setTotalRootSvgHeight(this.rowHeight), this.svgRendererInstance.applySizingToRootSvg(), this.svgRendererInstance.commitElementsToDOM(s);
+  }
+  getDotsToHide(e) {
+    const t = /* @__PURE__ */ new Set();
+    return e && e.forEach((s) => {
+      const r = s.fromString - 1, n = s.toString - 1;
+      for (let o = r; o <= n; o++)
+        t.add(`${o}-${s.fret}`);
+    }), t;
+  }
+  drawFretDots(e, t, s, r, n) {
+    const o = this.gridTopY - W / 2;
+    for (let i = 0; i < this.options.stringCount; i++) {
+      const a = i * _, c = e[i].toLowerCase(), l = t[i];
+      if (c === "x")
+        this.svgRendererInstance.drawLine(a - g, o - g, a + g, o + g, n), this.svgRendererInstance.drawLine(a - g, o + g, a + g, o - g, n);
+      else if (c === "0")
+        this.svgRendererInstance.drawCircle(a, o, g, n, { filled: !1 });
+      else {
+        const d = parseInt(c, 36);
+        if (r.has(`${i}-${d}`))
+          continue;
+        const f = d - s + 1;
+        if (f < 1 || f > this.options.fretCount)
+          throw new Error(`Fret ${c} on string ${i + 1} is outside the visible range (${s}-${s + this.options.fretCount - 1}). Adjust 'startFret' or 'fretCount'.`);
+        const C = this.gridTopY + (f - 0.5) * T;
+        if (this.svgRendererInstance.drawCircle(a, C, u, n, {
+          classes: "guitar-fret-dot"
+        }), l !== "0") {
+          const E = this.options.backgroundColor === "transparent" ? "white" : this.options.backgroundColor;
+          this.svgRendererInstance.drawText(l, a, C + S / 3, n, {
+            fontSize: S,
+            fill: E,
+            classes: "guitar-text-small"
+          });
+        }
+      }
+    }
+  }
+  drawStringLabels(e, t) {
+    if (!t || t.length === 0) return;
+    const s = u, r = this.rowHeight - s - $;
+    for (let n = 0; n < this.options.stringCount; n++) {
+      const o = t[n];
+      if (!o) continue;
+      const i = n * _, a = r + s / 2;
+      this.svgRendererInstance.drawText(o, i, a, e, {
+        fontSize: S,
+        classes: "guitar-text-small"
+      });
+    }
+  }
+  // Passed in 'from' and 'to' index values are zero-based
+  drawBarre(e, t) {
+    const s = t.fret;
+    if (t.fromIndex < 0 || t.toIndex >= this.options.stringCount || t.fromIndex >= t.toIndex)
+      throw new Error(`Barre fret error: Invalid string range ${t.fromIndex + 1}:${t.toIndex + 1}.`);
+    if (s < t.startingFret || s > t.startingFret + (this.options.fretCount - 1))
+      throw new Error(`Barre fret error: ${t.fret} is outside the visible range.`);
+    const r = s - t.startingFret, n = t.fromIndex * _, o = t.toIndex * _, i = u * 2, a = o - n + i, c = this.gridTopY + u / 2 + T * r, l = this.gridTopY + T * r + u * 2;
+    if (this.svgRendererInstance.drawRect(a, i, e, {
+      x: n - u,
+      y: c,
+      rx: u,
+      classes: "guitar-barre"
+    }), t.finger) {
+      const d = this.options.backgroundColor === "transparent" ? "white" : this.options.backgroundColor;
+      this.svgRendererInstance.drawText(t.finger.toString(), (n + o) / 2, l, e, {
+        fontSize: S,
+        fill: d,
+        classes: "guitar-text-small"
+      });
+    }
+  }
+  // Builds a single chord diagram's group element: grid, nut/fret-position label, and per-string markers.
+  renderChordDiagram(e, t, s) {
+    const r = this.svgRendererInstance.createGroup("chord"), n = s?.startFret ?? 1;
+    s?.label && this.svgRendererInstance.drawText(s.label, this.diagramWidth / 2, Z - 5, r, {
+      fontSize: rt,
+      fontWeight: "bold",
+      classes: "guitar-text-base"
+    });
+    for (let i = 0; i <= this.options.fretCount; i++) {
+      const a = this.gridTopY + i * T;
+      i === 0 && n === 1 ? this.svgRendererInstance.drawRect(this.diagramWidth + k * 2, P, r, {
+        x: -k,
+        y: a - P / 2
+      }) : this.svgRendererInstance.drawLine(0, a, this.diagramWidth, a, r);
+    }
+    n > 1 && this.svgRendererInstance.drawText(`${n}fr`, this.diagramWidth + u + ut, this.gridTopY + T / 2 + 4, r, {
+      anchor: "start",
+      fontSize: S,
+      fontWeight: "bold",
+      classes: "guitar-text-small"
+    });
+    for (let i = 0; i < this.options.stringCount; i++) {
+      const a = i * _;
+      this.svgRendererInstance.drawLine(a, this.gridTopY, a, this.gridTopY + this.diagramHeight, r);
+    }
+    const o = this.getDotsToHide(s?.barres);
+    return this.drawFretDots(e, t, n, o, r), this.options.stringLabels.length >= 1 && this.drawStringLabels(r, this.options.stringLabels), s?.barres?.forEach((i) => {
+      this.drawBarre(r, {
+        fromIndex: i.fromString - 1,
+        toIndex: i.toString - 1,
+        fret: i.fret,
+        finger: i.finger,
+        startingFret: n
+      });
+    }), r;
+  }
+  // Repositions every existing chord diagram from scratch, in order, wrapping rows as needed.
+  // Called after any add/remove/change so the layout never has to track incremental deltas.
+  relayoutChords() {
+    if (this.cursorX = u, this.cursorY = ft, this.chordEntries.length === 1) {
+      const t = this.chordEntries[0];
+      this.cursorX = this.options.width / 2 - this.diagramWidth / 2, t.xPos = this.cursorX, t.yPos = this.cursorY, t.gElement.setAttribute("transform", `translate(${this.cursorX}, ${this.cursorY})`);
+    } else
+      this.chordEntries.forEach((t, s) => {
+        s > 0 && this.cursorX + this.diagramWidth > this.options.width && (this.cursorX = u, this.cursorY += this.rowHeight + dt), t.xPos = this.cursorX, t.yPos = this.cursorY, t.gElement.setAttribute("transform", `translate(${this.cursorX}, ${this.cursorY})`), this.cursorX += this.diagramWidth + M;
+      });
+    const e = this.cursorY + this.rowHeight;
+    this.svgRendererInstance.setTotalRootSvgHeight(e), this.svgRendererInstance.applySizingToRootSvg();
+  }
+  /**
+   * Adds a new chord diagram. Diagrams are placed left-to-right in the order added, wrapping to a
+   * new row automatically once the configured width is exceeded.
+   *
+   * @param frets - A string, with each value being ordered low-to-high (e.g. first position in string 0 is the low E string)
+   * * `x` - muted string
+   * * `0` - open string
+   * * `1...n` - fretted at the given absolute fret number (e.g. `3`)
+   * @param fingers - A string, with each value being ordered low-to-high (e.g. first position in string 0 is the low E string)
+   * * `0` - No finger labeled
+   * * `1...n` - Finger labeled as number provided
+   * 
+   * @param options - Optional per-chord settings: `startFret` (default `1`, for diagrams higher up the neck)
+   * and `label` (a chord name drawn above the diagram).
+   * 
+   * @returns The index of the newly added chord, for later use with the CRUD-by-index methods.
+   * 
+   * @throws {Error} If fret or finger's string length doesn't match the configured string count.
+   *
+   * @example
+   * // Draw an open C major chord
+   * guitarChord.addChord("x32010", "032010", { label: "C" });
+  */
+  addChord(e, t, s) {
+    const r = H(e), n = B(t);
+    if (r.length !== this.options.stringCount) throw new Error("Invalid number of frets provided, entries should be equal to number of strings in diagram.");
+    if (n.length !== this.options.stringCount) throw new Error("Invalid number of fingers provided, entries should be equal to number of strings in diagram.");
+    const o = s?.startFret ?? st(r, this.options.fretCount), i = s?.label, a = s?.barres, c = { startFret: o, label: i, barres: a }, l = this.renderChordDiagram(r, n, c), d = this.svgRendererInstance.getLayerByName("notes");
+    return this.svgRendererInstance.commitElementsToDOM(l, d), this.chordEntries.push({
+      gElement: l,
+      strings: et(r, n),
+      ...c,
+      xPos: 0,
+      yPos: 0
+    }), this.relayoutChords(), this.chordEntries.length - 1;
+  }
+  /**
+   * Replaces the chord diagram at the specified index with a new one, in place.
+   * 
+  * @param frets - A string, with each value being ordered low-to-high (e.g. first position in string 0 is the low E string)
+   * * `x` - muted string
+   * * `0` - open string
+   * * `1...n` - fretted at the given absolute fret number (e.g. `3`)
+   * @param fingers - A string, with each value being ordered low-to-high (e.g. first position in string 0 is the low E string)
+   * * `0` - No finger labeled
+   * * `1...n` - Finger labeled as number provided
+   * 
+   * @param chordIndex - The index of the chord to replace (as returned by addChord).
+   * 
+   * @param options - Optional per-chord settings, see addChord.
+   * 
+   * @returns void
+   * 
+   * @throws {Error} If the index is out of bounds, or if chordDef is invalid (see addChord).
+   *
+   * @example
+   * // Change chord at index 0 to a D major chord
+   * guitarChord.modifyChordByIndex("xx0232", "000132", 0, { label: "D" });
+   *   
+  */
+  modifyChordByIndex(e, t, s, r) {
+    if (s >= this.chordEntries.length || s < 0) throw new Error("Chord index was out of bounds.");
+    const n = H(e), o = B(t);
+    if (n.length !== this.options.stringCount) throw new Error("Invalid number of frets provided, entries should be equal to number of strings in diagram.");
+    if (o.length !== this.options.stringCount) throw new Error("Invalid number of fingers provided, entries should be equal to number of strings in diagram.");
+    const i = this.chordEntries[s], a = r && "label" in r ? r.label === "" ? void 0 : r.label : i.label, c = r?.startFret ?? st(n, this.options.fretCount), l = { ...r, label: a, startFret: c }, d = this.renderChordDiagram(n, o, l);
+    this.svgRendererInstance.getLayerByName("notes").replaceChild(d, i.gElement), this.chordEntries[s] = {
+      gElement: d,
+      strings: et(n, o),
+      ...l,
+      xPos: i.xPos,
+      yPos: i.yPos
+    }, this.relayoutChords();
+  }
+  /**
+   * Removes the chord diagram at the specified index. Remaining chords are re-flowed to close the gap.
+   * @param chordIndex - The index of the chord to remove.
+   * @returns void
+   * @throws {Error} If the index is out of bounds.
+  */
+  removeChordByIndex(e) {
+    if (e >= this.chordEntries.length || e < 0) throw new Error("Chord index was out of bounds.");
+    this.chordEntries[e].gElement.remove(), this.chordEntries.splice(e, 1), this.relayoutChords();
+  }
+  /**
+   * Removes all chord diagrams and resets internal positioning.
+   * @returns void
+  */
+  clearAllChords() {
+    this.svgRendererInstance.getLayerByName("notes").replaceChildren(), this.chordEntries = [], this.cursorX = 0, this.cursorY = 0, this.svgRendererInstance.setTotalRootSvgHeight(this.rowHeight), this.svgRendererInstance.applySizingToRootSvg();
+  }
+  /**
+   * * Used to automatically determine options for creating barre lines.
+   * * The returned value then can be used in addChord and modifyChord methods.
+   * @returns GuitarBarreDef[]
+  */
+  determineBarreOptions(e, t, s) {
+    const r = H(e), n = B(t), o = [];
+    return s.forEach((i) => {
+      if (i === 0) return;
+      const a = [], c = {};
+      for (let E = 0; E < r.length; E++) {
+        if (r[E].toLowerCase() === "x") continue;
+        const L = parseInt(r[E], 36), O = Number(n[E]);
+        L === i && (c[O] ? c[O] += 1 : c[O] = 1, a.push(E + 1));
+      }
+      a.sort();
+      let l = 0, d = 0;
+      for (const [E, L] of Object.entries(c))
+        L > d && (d = L, l = Number(E));
+      const f = a[0], C = a.at(-1);
+      a.length > 1 && C && o.push({
+        fret: i,
+        fromString: f,
+        toString: C,
+        finger: l
+      });
+    }), o;
+  }
+  /**
+   * Removes the root svg element and cleans up arrays.
+   * @returns void
+  */
+  destroy() {
+    this.chordEntries = [], this.svgRendererInstance.destroy();
+  }
+}
 export {
-  et as MusicStaff,
-  st as RhythmStaff,
-  rt as ScrollingStaff
+  Ft as GuitarChord,
+  bt as MusicStaff,
+  Gt as RhythmStaff,
+  vt as ScrollingStaff
 };