@tspro/web-music-score 5.4.1 → 5.4.2

package/dist/score/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v5.4.1 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v5.4.2 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -66,13 +66,14 @@ __export(score_exports, {
   MRest: () => MRest,
   MRhythmColumn: () => MRhythmColumn,
   MScoreRow: () => MScoreRow,
+  MScoreRowGroup: () => MScoreRowGroup,
   MSpecialText: () => MSpecialText,
   MStaff: () => MStaff,
+  MStaffBarLine: () => MStaffBarLine,
   MStaffBeamGroup: () => MStaffBeamGroup,
   MStaffNoteGroup: () => MStaffNoteGroup,
   MStaffRest: () => MStaffRest,
   MStaffSignature: () => MStaffSignature,
-  MStaffTabBarLine: () => MStaffTabBarLine,
   MTab: () => MTab,
   MTabNoteGroup: () => MTabNoteGroup,
   MTabRhythm: () => MTabRhythm,
@@ -425,7 +426,7 @@ var DivRect = class _DivRect {
 };
 
 // src/score/pub/document-builder.ts
-var import_ts_utils_lib32 = require("@tspro/ts-utils-lib");
+var import_ts_utils_lib33 = require("@tspro/ts-utils-lib");
 
 // src/score/pub/types.ts
 var import_ts_utils_lib2 = require("@tspro/ts-utils-lib");
@@ -657,13 +658,52 @@ var MusicObject = class {
   }
   updateRect() {
   }
+  forceRectUpdate() {
+    this.needRectUpdate = true;
+    this.updateRect();
+    this.needRectUpdate = false;
+  }
   getRect() {
-    if (this.needRectUpdate) {
-      this.updateRect();
-      this.needRectUpdate = false;
-    }
+    if (this.needRectUpdate)
+      this.forceRectUpdate();
     return this.rect;
   }
+  offsetX(dx) {
+    this.offset(dx, 0);
+  }
+  offsetY(dy) {
+    this.offset(0, dy);
+  }
+  setLeft(x) {
+    this.offset(x - this.getRect().left, 0);
+  }
+  setRight(x) {
+    this.offset(x - this.getRect().right, 0);
+  }
+  setTop(y) {
+    this.offset(0, y - this.getRect().top);
+  }
+  setBottom(y) {
+    this.offset(0, y - this.getRect().bottom);
+  }
+  setAnchor(x, y) {
+    this.offset(x - this.getRect().anchorX, y - this.getRect().anchorY);
+  }
+  setAnchorX(x) {
+    this.offset(x - this.getRect().anchorX, 0);
+  }
+  setAnchorY(y) {
+    this.offset(0, y - this.getRect().anchorY);
+  }
+  setCenter(x, y) {
+    this.offset(x - this.getRect().centerX, y - this.getRect().centerY);
+  }
+  setCenterX(x) {
+    this.offset(x - this.getRect().centerX, 0);
+  }
+  setCenterY(y) {
+    this.offset(0, y - this.getRect().centerY);
+  }
   /**
    * Most objects are simple rects in shape.
    * Some objects might be more complex consisting of multiple rects.
@@ -707,7 +747,7 @@ var DebugSettings = {
 };
 var DocumentSettings = {
   DocumentScale: 1,
-  DocumentMinWidth: 75,
+  MinStaffWidth: 75,
   MinColumnsWidth: 10,
   ColumnWidthScale: 1.7,
   PostMeasureBreakWidth: 10,
@@ -1516,63 +1556,103 @@ var RenderContext = class {
     }
   }
   arc(x, y, radius, startRadians, endRadians) {
-    var _a;
-    (_a = this.ctx) == null ? void 0 : _a.arc(x, y, radius, startRadians, endRadians);
+    if (this.ctx) this.ctx.arc(x, y, radius, startRadians, endRadians);
+    return this;
   }
   fillCircle(x, y, radius) {
-    if (this.ctx) {
-      this.ctx.beginPath();
-      this.ctx.arc(x, y, radius, 0, 2 * Math.PI);
-      this.ctx.fill();
-    }
+    if (!this.ctx) return this;
+    this.ctx.beginPath();
+    this.ctx.arc(x, y, radius, 0, 2 * Math.PI);
+    this.ctx.fill();
+    return this;
   }
   strokeLine(startX, startY, endX, endY) {
-    if (this.ctx) {
-      this.ctx.beginPath();
-      this.ctx.moveTo(startX, startY);
-      this.ctx.lineTo(endX, endY);
-      this.ctx.stroke();
-    }
+    if (!this.ctx) return this;
+    this.ctx.beginPath();
+    this.ctx.moveTo(startX, startY);
+    this.ctx.lineTo(endX, endY);
+    this.ctx.stroke();
+    return this;
   }
   strokePartialLine(startX, startY, endX, endY, startT, endT) {
+    if (!this.ctx) return this;
     let x1 = startX + (endX - startX) * startT;
     let y1 = startY + (endY - startY) * startT;
     let x2 = startX + (endX - startX) * endT;
     let y2 = startY + (endY - startY) * endT;
-    if (this.ctx) {
-      this.ctx.beginPath();
-      this.ctx.moveTo(x1, y1);
-      this.ctx.lineTo(x2, y2);
-      this.ctx.stroke();
-    }
+    this.ctx.beginPath();
+    this.ctx.moveTo(x1, y1);
+    this.ctx.lineTo(x2, y2);
+    this.ctx.stroke();
+    return this;
   }
+  /** @deprecated - Use {@link drawBracket} instead. */
   drawBrace(rect, side) {
-    if (this.ctx) {
-      let { left, right, width, top, bottom, anchorY } = rect;
-      if (side === "right") {
-        [left, right, width] = [right, left, -width];
-      }
-      this.ctx.beginPath();
-      this.ctx.moveTo(right, top);
-      this.ctx.bezierCurveTo(
-        left + width * 0.1,
-        top,
-        left + width * 0.8,
-        anchorY,
-        left,
-        anchorY
-      );
-      this.ctx.moveTo(right, bottom);
-      this.ctx.bezierCurveTo(
-        left + width * 0.1,
-        bottom,
-        left + width * 0.8,
-        anchorY,
-        left,
-        anchorY
-      );
-      this.ctx.stroke();
+    return this.drawBracket(rect, side === "left" ? "{" : "}");
+  }
+  drawBracket(rect, bracket) {
+    if (!this.ctx) return this;
+    let { left, right, width, top, bottom, height, anchorY } = rect;
+    if ([")", "]", "}", ">"].includes(bracket)) {
+      [left, right, width] = [right, left, -width];
+    }
+    switch (bracket) {
+      case "(":
+      case ")":
+        this.ctx.beginPath();
+        this.ctx.moveTo(right, top);
+        this.ctx.bezierCurveTo(
+          left - width * 0.2,
+          top + height * 0.3,
+          left - width * 0.2,
+          top + height * 0.7,
+          right,
+          bottom
+        );
+        this.ctx.stroke();
+        break;
+      case "{":
+      case "}":
+        this.ctx.beginPath();
+        this.ctx.moveTo(right, top);
+        this.ctx.bezierCurveTo(
+          left + width * 0.1,
+          top,
+          left + width * 0.8,
+          anchorY,
+          left,
+          anchorY
+        );
+        this.ctx.moveTo(right, bottom);
+        this.ctx.bezierCurveTo(
+          left + width * 0.1,
+          bottom,
+          left + width * 0.8,
+          anchorY,
+          left,
+          anchorY
+        );
+        this.ctx.stroke();
+        break;
+      case "[":
+      case "]":
+        this.ctx.beginPath();
+        this.ctx.moveTo(right, top);
+        this.ctx.lineTo(left, top);
+        this.ctx.lineTo(left, bottom);
+        this.ctx.lineTo(right, bottom);
+        this.ctx.stroke();
+        break;
+      case "<":
+      case ">":
+        this.ctx.beginPath();
+        this.ctx.moveTo(right, top);
+        this.ctx.lineTo(left, anchorY);
+        this.ctx.lineTo(right, bottom);
+        this.ctx.stroke();
+        break;
     }
+    return this;
   }
 };
 
@@ -2009,20 +2089,21 @@ var ObjStaffSignature = class extends MusicObject {
     if (this.clefImage) {
       x += paddingX;
       this.clefImage.layout(ctx);
-      this.clefImage.offset(x, staff.getDiatonicIdY(staff.clefLineDiatonicId));
+      this.clefImage.setAnchor(x, staff.getDiatonicIdY(staff.clefLineDiatonicId));
       this.rect.expandInPlace(this.clefImage.getRect());
       x = this.rect.right;
       if (this.eightBelowClef) {
         let r = this.clefImage.getRect();
         this.eightBelowClef.layout(ctx);
-        this.eightBelowClef.offset(r.centerX, Math.max(r.anchorY + r.height * 0.3, staff.getBottomLineY()));
+        this.eightBelowClef.setCenterX(r.centerX);
+        this.eightBelowClef.setTop(Math.max(r.anchorY + r.height * 0.3, staff.getBottomLineY()));
         this.rect.expandInPlace(this.eightBelowClef.getRect());
       }
     }
     if (this.measureNumber) {
       this.measureNumber.layout(ctx);
-      let y = Math.min(staff.getTopLineY(), this.clefImage ? this.clefImage.getRect().top : staff.getTopLineY());
-      this.measureNumber.offset(0, y);
+      this.measureNumber.setLeft(0);
+      this.measureNumber.setBottom(Math.min(staff.getTopLineY(), this.clefImage ? this.clefImage.getRect().top : staff.getTopLineY()));
       this.rect.expandInPlace(this.measureNumber.getRect());
       x = Math.max(x, this.rect.right);
     }
@@ -2030,7 +2111,8 @@ var ObjStaffSignature = class extends MusicObject {
       x += paddingX;
       this.ksNeutralizeAccidentals.forEach((objAcc) => {
         objAcc.layout(ctx);
-        objAcc.offset(x + objAcc.getRect().leftw, staff.getDiatonicIdY(objAcc.diatonicId));
+        objAcc.setLeft(x);
+        objAcc.setAnchorY(staff.getDiatonicIdY(objAcc.diatonicId));
         this.rect.expandInPlace(objAcc.getRect());
         x = this.rect.right;
       });
@@ -2039,7 +2121,8 @@ var ObjStaffSignature = class extends MusicObject {
       x += paddingX;
       this.ksNewAccidentals.forEach((objAcc) => {
         objAcc.layout(ctx);
-        objAcc.offset(x + objAcc.getRect().leftw, staff.getDiatonicIdY(objAcc.diatonicId));
+        objAcc.setLeft(x);
+        objAcc.setAnchorY(staff.getDiatonicIdY(objAcc.diatonicId));
         this.rect.expandInPlace(objAcc.getRect());
         x = this.rect.right;
       });
@@ -2049,24 +2132,34 @@ var ObjStaffSignature = class extends MusicObject {
     (_b = this.beatSizeText) == null ? void 0 : _b.layout(ctx);
     let tsWidth = Math.max((_d = (_c = this.beatCountText) == null ? void 0 : _c.getRect().width) != null ? _d : 0, (_f = (_e = this.beatSizeText) == null ? void 0 : _e.getRect().width) != null ? _f : 0);
     if (this.beatCountText) {
-      this.beatCountText.offset(x + tsWidth / 2 + paddingX, staff.getDiatonicIdY(staff.middleLineDiatonicId + 2));
+      this.beatCountText.setCenter(
+        x + tsWidth / 2 + paddingX,
+        staff.getDiatonicIdY(staff.middleLineDiatonicId + 2)
+      );
       this.rect.expandInPlace(this.beatCountText.getRect());
       right = Math.max(right, this.rect.right);
     }
     if (this.beatSizeText) {
-      this.beatSizeText.offset(x + tsWidth / 2 + paddingX, staff.getDiatonicIdY(staff.bottomLineDiatonicId + 2));
+      this.beatSizeText.setCenter(
+        x + tsWidth / 2 + paddingX,
+        staff.getDiatonicIdY(staff.bottomLineDiatonicId + 2)
+      );
       this.rect.expandInPlace(this.beatSizeText.getRect());
       right = Math.max(right, this.rect.right);
     }
     x = right;
     if (this.tempoText) {
-      let tempoBottom = Math.min(
-        this.clefImage ? this.clefImage.getRect().top : staff.getTopLineY(),
-        ...this.ksNeutralizeAccidentals.map((o) => o.getRect().top),
-        ...this.ksNewAccidentals.map((o) => o.getRect().top)
-      );
       this.tempoText.layout(ctx);
-      this.tempoText.offset(x, tempoBottom);
+      this.tempoText.setCenterX(x);
+      this.tempoText.setBottom(staff.getTopLineY());
+      if (this.clefImage && import_ts_utils_lib9.AnchoredRect.overlap(this.clefImage.getRect(), this.tempoText.getRect())) {
+        this.tempoText.setBottom(this.clefImage.getRect().top);
+      }
+      [...this.ksNeutralizeAccidentals, ...this.ksNewAccidentals].forEach((acc) => {
+        if (this.tempoText && import_ts_utils_lib9.AnchoredRect.overlap(acc.getRect(), this.tempoText.getRect())) {
+          this.tempoText.setBottom(acc.getRect().top);
+        }
+      });
       this.rect.expandInPlace(this.tempoText.getRect());
     }
     this.rect.right += paddingX;
@@ -2177,7 +2270,8 @@ var ObjTabSignature = class extends MusicObject {
     this.rect = new import_ts_utils_lib9.AnchoredRect();
     if (this.measureNumber) {
       this.measureNumber.layout(ctx);
-      this.measureNumber.offset(0, topLineY);
+      this.measureNumber.setLeft(0);
+      this.measureNumber.setBottom(topLineY);
       this.rect.expandInPlace(this.measureNumber.getRect());
       x = Math.max(x, this.rect.right);
     }
@@ -2185,16 +2279,23 @@ var ObjTabSignature = class extends MusicObject {
     (_b = this.beatSizeText) == null ? void 0 : _b.layout(ctx);
     let tsWidth = Math.max((_d = (_c = this.beatCountText) == null ? void 0 : _c.getRect().width) != null ? _d : 0, (_f = (_e = this.beatSizeText) == null ? void 0 : _e.getRect().width) != null ? _f : 0);
     if (this.beatCountText) {
-      this.beatCountText.offset(0 + tsWidth / 2 + paddingX, tab.getRect().anchorY - this.beatCountText.getRect().bottomh);
+      this.beatCountText.setCenter(
+        0 + tsWidth / 2 + paddingX,
+        tab.getRect().anchorY - this.beatCountText.getRect().bottomh
+      );
       this.rect.expandInPlace(this.beatCountText.getRect());
     }
     if (this.beatSizeText) {
-      this.beatSizeText.offset(0 + tsWidth / 2 + paddingX, tab.getRect().anchorY + this.beatSizeText.getRect().toph);
+      this.beatSizeText.setCenter(
+        0 + tsWidth / 2 + paddingX,
+        tab.getRect().anchorY + this.beatSizeText.getRect().toph
+      );
       this.rect.expandInPlace(this.beatSizeText.getRect());
     }
     if (this.tempoText) {
       this.tempoText.layout(ctx);
-      this.tempoText.offset(x + unitSize * 2, topLineY);
+      this.tempoText.setLeft(x + unitSize * 2);
+      this.tempoText.setBottom(topLineY);
       this.rect.expandInPlace(this.tempoText.getRect());
     }
     this.rect.right += paddingX;
@@ -2493,7 +2594,7 @@ var _ObjRest = class _ObjRest extends MusicObject {
         let dotY = this.getRestDotVerticalDisplacement(noteSize) * unitSize;
         obj.dotRects.push(import_ts_utils_lib11.AnchoredRect.createCentered(dotX, dotY, dotWidth, dotWidth));
       }
-      obj.offset(0, staff.getDiatonicIdY(diatonicId));
+      obj.setAnchor(0, staff.getDiatonicIdY(diatonicId));
       this.staffObjects.push(obj);
       this.measure.addStaticObject(staff, obj);
     });
@@ -3001,7 +3102,10 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
           let acc = obj.accidentals[noteIndex] = new ObjAccidental(this, note.diatonicId, note.accidental, this.color);
           if (acc) {
             acc.layout(ctx);
-            acc.offset(-noteHeadRect.leftw - unitSize * DocumentSettings.NoteAccSpace - acc.getRect().rightw, noteY);
+            acc.setAnchor(
+              -noteHeadRect.leftw - unitSize * DocumentSettings.NoteAccSpace - acc.getRect().rightw,
+              noteY
+            );
           }
           noteStaff.addObject(acc);
         }
@@ -3065,9 +3169,7 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
           let color = fretId < 0 ? "red" : "black";
           let fretNumber = new ObjText(this, { text: String(fretId), color, bgcolor: "white" }, 0.5, 0.5);
           fretNumber.layout(ctx);
-          let x = this.col.getRect().anchorX;
-          let y = tab.getStringY(stringNumber - 1);
-          fretNumber.offset(x, y);
+          fretNumber.setAnchor(this.col.getRect().anchorX, tab.getStringY(stringNumber - 1));
           obj.fretNumbers.push(fretNumber);
         }
       });
@@ -3242,7 +3344,7 @@ var ObjRhythmColumn = class extends MusicObject {
     return Math.max(0, nextPositionTicks - curPositionTicks);
   }
   getShapeRects() {
-    this.getRect();
+    this.forceRectUpdate();
     return this.shapeRects;
   }
   get doc() {
@@ -3408,6 +3510,8 @@ var ObjRhythmColumn = class extends MusicObject {
       return;
     }
     let { row } = this;
+    this.rect = new import_ts_utils_lib13.AnchoredRect();
+    this.requestRectUpdate();
     let leftw = 0;
     let rightw = 0;
     this.voiceSymbol.forEach((symbol) => {
@@ -3421,7 +3525,7 @@ var ObjRhythmColumn = class extends MusicObject {
       this.arpeggios.forEach((a) => a.layout(ctx));
       const arpeggioWidth = this.arpeggios.map((a) => a.getRect().width).reduce((accState2, cur) => Math.max(accState2, cur)) + ctx.unitSize;
       this.arpeggios.forEach((a) => {
-        a.offset(-leftw - arpeggioWidth + a.getRect().leftw, a.line.getRect().anchorY - a.getRect().anchorY);
+        a.setAnchor(-leftw - arpeggioWidth / 2, a.line.getRect().anchorY);
         a.line.addObject(a);
         this.measure.addStaticObject(a.line, a);
       });
@@ -3436,7 +3540,9 @@ var ObjRhythmColumn = class extends MusicObject {
     rightw = Math.max(rightw, MinColumnWidth / 2);
     leftw *= DocumentSettings.ColumnWidthScale;
     rightw *= DocumentSettings.ColumnWidthScale;
-    this.rect = new import_ts_utils_lib13.AnchoredRect(-leftw, 0, rightw, 0, 0, 0);
+    this.rect.left = -leftw;
+    this.rect.anchorX = 0;
+    this.rect.right = rightw;
     this.requestRectUpdate();
     this.voiceSymbol.forEach((symbol) => symbol.updateAccidentalState(accState));
     this.row.getStaves().forEach((staff) => {
@@ -3588,8 +3694,8 @@ var _ObjSpecialText = class _ObjSpecialText extends MusicObject {
         let codaText = this.components[1];
         codaSym.layout(ctx);
         codaText.layout(ctx);
-        codaSym.offset(0, codaText.getRect().centerY);
-        codaText.offset(codaSym.getRect().right, 0);
+        codaSym.setAnchorY(codaText.getRect().centerY);
+        codaText.setLeft(codaSym.getRect().right);
         this.rect = new import_ts_utils_lib14.AnchoredRect(
           codaSym.getRect().left,
           codaSym.getRect().anchorX,
@@ -3605,8 +3711,8 @@ var _ObjSpecialText = class _ObjSpecialText extends MusicObject {
         let codaSym = this.components[1];
         toCodaText.layout(ctx);
         codaSym.layout(ctx);
-        codaSym.offset(0, toCodaText.getRect().centerY);
-        toCodaText.offset(codaSym.getRect().left, 0);
+        codaSym.setAnchorY(toCodaText.getRect().centerY);
+        toCodaText.setRight(codaSym.getRect().left);
         this.rect = new import_ts_utils_lib14.AnchoredRect(
           toCodaText.getRect().left,
           codaSym.getRect().anchorX,
@@ -4186,16 +4292,16 @@ var Player = class _Player {
 
 // src/score/engine/obj-bar-line.ts
 var import_ts_utils_lib17 = require("@tspro/ts-utils-lib");
-var ObjStaffTabBarLine = class extends MusicObject {
+var ObjStaffBarLine = class extends MusicObject {
   constructor(barLine, line) {
     super(line);
     this.barLine = barLine;
     this.line = line;
-    __publicField(this, "verticalLines", []);
+    __publicField(this, "vlines", []);
     __publicField(this, "dots", []);
     __publicField(this, "mi");
     line.addObject(this);
-    this.mi = new MStaffTabBarLine(this);
+    this.mi = new MStaffBarLine(this);
   }
   getMusicInterface() {
     return this.mi;
@@ -4203,11 +4309,17 @@ var ObjStaffTabBarLine = class extends MusicObject {
   pick(x, y) {
     return this.getRect().contains(x, y) ? [this] : [];
   }
-  setRect(r) {
-    this.rect = r;
+  updateRect() {
+    this.rect = new import_ts_utils_lib17.AnchoredRect(0, 0, this.line.getTopLineY(), this.line.getBottomLineY());
+    this.vlines.forEach(
+      (l) => this.rect.expandInPlace(new import_ts_utils_lib17.AnchoredRect(l.left, l.left + l.width, this.rect.top, this.rect.bottom))
+    );
+    this.dots.forEach(
+      (d) => this.rect.expandInPlace(new import_ts_utils_lib17.AnchoredRect(d.x - d.r, d.x + d.r, d.y - d.r, d.y + d.r))
+    );
   }
   offset(dx, dy) {
-    this.verticalLines.forEach((l) => l.left += dx);
+    this.vlines.forEach((l) => l.left += dx);
     this.dots.forEach((d) => {
       d.x += dx;
       d.y += dy;
@@ -4219,16 +4331,16 @@ var ObjBarLine = class extends MusicObject {
   constructor(measure) {
     super(measure);
     this.measure = measure;
-    __publicField(this, "staffTabObjects", []);
-    __publicField(this, "staffTabObjectGroups", []);
+    __publicField(this, "notationLineObjects", []);
+    __publicField(this, "notationLineObjectsByGrp", new import_ts_utils_lib17.UniMap());
     __publicField(this, "barLineType", 0 /* None */);
   }
   pick(x, y) {
     if (!this.getRect().contains(x, y)) {
       return [];
     }
-    for (let i = 0; i < this.staffTabObjects.length; i++) {
-      let arr = this.staffTabObjects[i].pick(x, y);
+    for (let i = 0; i < this.notationLineObjects.length; i++) {
+      let arr = this.notationLineObjects[i].pick(x, y);
       if (arr.length > 0) {
         return [this, ...arr];
       }
@@ -4237,7 +4349,6 @@ var ObjBarLine = class extends MusicObject {
   }
   layout(ctx) {
     this.requestRectUpdate();
-    this.staffTabObjects.length = 0;
     this.barLineType = this.solveBarLineType();
     let { unitSize, _lineWidth } = ctx;
     let { measure, barLineType } = this;
@@ -4247,102 +4358,95 @@ var ObjBarLine = class extends MusicObject {
     let spaceW = 0.7 * unitSize;
     let dotW = DocumentSettings.DotSize * unitSize;
     let dotRadius = dotW / 2;
-    row.getNotationLines().forEach((line) => {
-      let obj = new ObjStaffTabBarLine(this, line);
-      let lineCenterY;
-      let lineDotOff;
-      let top, bottom;
-      const addVerticalLine = (left, width) => {
-        obj.verticalLines.push({ left, width });
-      };
-      const addDotPair = (cx) => {
-        for (let i = -1; i <= 1; i += 2) {
-          let y = lineCenterY + i * lineDotOff;
-          obj.dots.push({ x: cx, y, r: dotRadius });
+    this.notationLineObjects = [];
+    this.notationLineObjectsByGrp.clear();
+    row.getRowGroups().forEach((grp) => {
+      grp.lines.forEach((line) => {
+        let obj = new ObjStaffBarLine(this, line);
+        this.notationLineObjects.push(obj);
+        this.notationLineObjectsByGrp.getOrCreate(grp, []).push(obj);
+        let lineCenterY;
+        let lineDotOff;
+        const addVerticalLine = (left, width) => {
+          obj.vlines.push({ left, width });
+        };
+        const addDotPair = (cx) => {
+          for (let i = -1; i <= 1; i += 2) {
+            let y = lineCenterY + i * lineDotOff;
+            obj.dots.push({ x: cx, y, r: dotRadius });
+          }
+        };
+        if (line instanceof ObjStaff) {
+          lineCenterY = line.getMiddleLineY();
+          lineDotOff = line.getDiatonicSpacing();
+        } else {
+          lineCenterY = (line.getBottomLineY() + line.getTopLineY()) / 2;
+          lineDotOff = (line.getBottomLineY() - line.getTopLineY()) / 6;
         }
-      };
-      if (line instanceof ObjStaff) {
-        lineCenterY = line.getMiddleLineY();
-        lineDotOff = line.getDiatonicSpacing();
-      } else {
-        lineCenterY = (line.getBottomLineY() + line.getTopLineY()) / 2;
-        lineDotOff = (line.getBottomLineY() - line.getTopLineY()) / 6;
-      }
-      top = line.getTopLineY();
-      bottom = line.getBottomLineY();
-      switch (barLineType) {
-        case 0 /* None */:
-          obj.setRect(new import_ts_utils_lib17.AnchoredRect(0, 0, 0, top, 0, bottom));
-          break;
-        case 1 /* Single */:
-          obj.setRect(new import_ts_utils_lib17.AnchoredRect(-thinW, 0, 0, top, 0, bottom));
-          addVerticalLine(-thinW, thinW);
-          break;
-        case 2 /* Double */:
-          obj.setRect(new import_ts_utils_lib17.AnchoredRect(-thinW - spaceW - thinW, 0, 0, top, 0, bottom));
-          addVerticalLine(-thinW - spaceW - thinW, thinW);
-          addVerticalLine(-thinW, thinW);
-          break;
-        case 3 /* EndSong */:
-          obj.setRect(new import_ts_utils_lib17.AnchoredRect(-thicW - spaceW - thinW, 0, 0, top, 0, bottom));
-          addVerticalLine(-thinW - spaceW - thicW, thinW);
-          addVerticalLine(-thicW, thicW);
-          break;
-        case 4 /* StartRepeat */:
-          obj.setRect(new import_ts_utils_lib17.AnchoredRect(0, 0, thicW + spaceW + thinW + spaceW + dotW, top, 0, bottom));
-          addVerticalLine(0, thicW);
-          addVerticalLine(thicW + spaceW, thinW);
-          addDotPair(thicW + spaceW + thinW + spaceW + dotRadius);
-          break;
-        case 5 /* EndRepeat */:
-          obj.setRect(new import_ts_utils_lib17.AnchoredRect(-thicW - spaceW - thinW - spaceW - dotW, 0, 0, top, 0, bottom));
-          addVerticalLine(-thinW - spaceW - thicW, thinW);
-          addVerticalLine(-thicW, thicW);
-          addDotPair(-thinW - spaceW - thicW - spaceW - dotRadius);
-          break;
-        case 6 /* EndStartRepeat */:
-          obj.setRect(new import_ts_utils_lib17.AnchoredRect(-dotW - spaceW - thinW - spaceW - thicW / 2, 0, thicW / 2 + spaceW + thinW + spaceW + dotW, top, 0, bottom));
-          addVerticalLine(-thicW / 2, thicW);
-          addVerticalLine(-thicW / 2 - spaceW - thinW, thinW);
-          addVerticalLine(thicW / 2 + spaceW, thinW);
-          addDotPair(-thicW / 2 - spaceW - thinW - spaceW - dotRadius);
-          addDotPair(thicW / 2 + spaceW + thinW + spaceW + dotRadius);
-          break;
-      }
-      this.staffTabObjects.push(obj);
+        switch (barLineType) {
+          case 0 /* None */:
+            break;
+          case 1 /* Single */:
+            addVerticalLine(-thinW, thinW);
+            break;
+          case 2 /* Double */:
+            addVerticalLine(-thinW - spaceW - thinW, thinW);
+            addVerticalLine(-thinW, thinW);
+            break;
+          case 3 /* EndSong */:
+            addVerticalLine(-thinW - spaceW - thicW, thinW);
+            addVerticalLine(-thicW, thicW);
+            break;
+          case 4 /* StartRepeat */:
+            addVerticalLine(0, thicW);
+            addVerticalLine(thicW + spaceW, thinW);
+            addDotPair(thicW + spaceW + thinW + spaceW + dotRadius);
+            break;
+          case 5 /* EndRepeat */:
+            addVerticalLine(-thinW - spaceW - thicW, thinW);
+            addVerticalLine(-thicW, thicW);
+            addDotPair(-thinW - spaceW - thicW - spaceW - dotRadius);
+            break;
+          case 6 /* EndStartRepeat */:
+            addVerticalLine(-thicW / 2, thicW);
+            addVerticalLine(-thicW / 2 - spaceW - thinW, thinW);
+            addVerticalLine(thicW / 2 + spaceW, thinW);
+            addDotPair(-thicW / 2 - spaceW - thinW - spaceW - dotRadius);
+            addDotPair(thicW / 2 + spaceW + thinW + spaceW + dotRadius);
+            break;
+        }
+        obj.forceRectUpdate();
+      });
     });
-    this.staffTabObjectGroups = row.getInstrumentLineGroups().map(
-      (lines) => lines.map((line) => this.staffTabObjects.find((obj) => obj.line === line)).filter((obj) => obj !== void 0)
-    );
   }
   updateRect() {
-    if (this.staffTabObjects.length > 0) {
-      this.rect = this.staffTabObjects[0].getRect().clone();
-      for (let i = 1; i < this.staffTabObjects.length; i++) {
-        this.rect.expandInPlace(this.staffTabObjects[i].getRect());
+    if (this.notationLineObjects.length > 0) {
+      this.rect = this.notationLineObjects[0].getRect().clone();
+      for (let i = 1; i < this.notationLineObjects.length; i++) {
+        this.rect.expandInPlace(this.notationLineObjects[i].getRect());
       }
     } else {
       this.rect = new import_ts_utils_lib17.AnchoredRect();
     }
   }
   offset(dx, dy) {
-    this.staffTabObjects.forEach((obj) => obj.offset(dx, 0));
+    this.notationLineObjects.forEach((obj) => obj.offset(dx, 0));
     this.requestRectUpdate();
   }
   draw(ctx) {
-    if (this.barLineType === 0 /* None */) {
+    if (this.barLineType === 0 /* None */)
       return;
-    }
     ctx.drawDebugRect(this.getRect());
     ctx.color("black");
-    this.staffTabObjectGroups.forEach((objs) => {
-      if (objs.length > 0) {
-        objs.forEach((obj) => obj.dots.forEach((d) => ctx.fillCircle(d.x, d.y, d.r)));
-        let top = objs[0].getRect().top;
-        let height = objs[objs.length - 1].getRect().bottom - top;
-        objs[0].verticalLines.forEach((vline) => ctx.fillRect(vline.left, top, vline.width, height));
-      }
-    });
+    for (const [grp, objects] of this.notationLineObjectsByGrp) {
+      objects.forEach((obj, i) => {
+        obj.dots.forEach((d) => ctx.fillCircle(d.x, d.y, d.r));
+        if (i === 0) {
+          let { top, height } = obj.barLine.getRect();
+          obj.vlines.forEach((l) => ctx.fillRect(l.left, top, l.width, height));
+        }
+      });
+    }
   }
 };
 var ObjBarLineLeft = class extends ObjBarLine {
@@ -4459,7 +4563,8 @@ var ObjEnding = class extends MusicObject {
     let measureContent = measure.getColumnsContentRect();
     let endingHeight = textRect.height;
     this.rect = new import_ts_utils_lib18.AnchoredRect(measureContent.left + unitSize, measureContent.right - unitSize, -endingHeight, 0);
-    this.endingText.offset(this.rect.left + unitSize / 2, this.rect.bottom);
+    this.endingText.setLeft(this.rect.left + unitSize / 2);
+    this.endingText.setBottom(this.rect.bottom);
     this.shapeRects = [
       new import_ts_utils_lib18.AnchoredRect(this.rect.left, this.rect.left + 1, this.rect.top, this.rect.bottom),
       new import_ts_utils_lib18.AnchoredRect(this.rect.left, this.rect.right, this.rect.top, this.rect.top + 1),
@@ -4886,8 +4991,7 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
         });
       }
       if (obj.tupletNumber) {
-        let y = (left.y + right.y) / 2 + obj.tupletNumberOffsetY;
-        obj.tupletNumber.offset(0, -obj.tupletNumber.getRect().anchorY + y);
+        obj.tupletNumber.setAnchorY((left.y + right.y) / 2 + obj.tupletNumberOffsetY);
       }
     });
   }
@@ -5647,8 +5751,7 @@ var ObjTabRhythm = class extends MusicObject {
             this.tupletPartsTextObjMap.set(text, textObj = new ObjText(this, { text, scale: 0.75 }, 0.5, 0.5));
             textObj.layout(ctx);
           }
-          textObj.offset(-textObj.getRect().anchorX, -textObj.getRect().anchorY);
-          textObj.offset(cx, stemTop - fontSize / 2);
+          textObj.setCenter(cx, stemTop - fontSize / 2);
           textObj.draw(ctx);
         }
         if (symbols.length > 1) {
@@ -6690,7 +6793,8 @@ var ObjMeasure = class extends MusicObject {
           let note = tab.getTuningStrings()[stringId].format(import_theory9.PitchNotation.Helmholtz, import_theory9.SymbolSet.Unicode);
           let obj = new ObjText(this, { text: note, scale: 0.8 }, 1, 0.5);
           obj.layout(ctx);
-          obj.offset(this.regions.tabTuning_0 * 0.8, tab.getStringY(stringId));
+          obj.setRight(this.regions.tabTuning_0 * 0.8);
+          obj.setCenterY(tab.getStringY(stringId));
           this.tabStringNotes.push(obj);
           tab.addObject(obj);
         }
@@ -6716,7 +6820,6 @@ var ObjMeasure = class extends MusicObject {
     this.regions.rightBarLine_6 = this.barLineRight.getRect().width;
   }
   layoutWidth(ctx, width) {
-    var _a;
     if (!this.needLayout) {
       return;
     }
@@ -6724,17 +6827,19 @@ var ObjMeasure = class extends MusicObject {
     this.rect = new import_ts_utils_lib26.AnchoredRect();
     this.rect.anchorX = this.rect.left + width / 2;
     this.rect.right = this.rect.left + width;
-    let rect;
     this.signatures.forEach((signature) => {
-      rect = signature.getRect();
-      signature.offset(this.rect.left + this.regions.tabTuning_0 - rect.left, -rect.anchorY);
+      signature.setLeft(this.rect.left + this.regions.tabTuning_0);
+      signature.setAnchorY(this.rect.anchorY);
     });
     let signaturesWidth = Math.max(0, ...this.signatures.map((signature) => signature.getRect().width));
-    rect = this.barLineLeft.getRect();
-    this.barLineLeft.offset(this.rect.left + this.regions.tabTuning_0 + signaturesWidth - rect.left, -rect.anchorY);
-    rect = this.barLineRight.getRect();
-    this.barLineRight.offset(this.rect.right - rect.right, -rect.anchorY);
-    (_a = this.endRepeatPlayCountText) == null ? void 0 : _a.offset(this.barLineRight.getRect().left, this.barLineRight.getRect().top);
+    this.barLineLeft.setLeft(this.rect.left + this.regions.tabTuning_0 + signaturesWidth);
+    this.barLineLeft.setAnchorY(this.rect.anchorY);
+    this.barLineRight.setRight(this.rect.right);
+    this.barLineRight.setAnchorY(this.rect.anchorY);
+    if (this.endRepeatPlayCountText) {
+      this.endRepeatPlayCountText.setCenterX(this.barLineRight.getRect().left);
+      this.endRepeatPlayCountText.setBottom(this.barLineRight.getRect().top);
+    }
     let columnsLeft = this.rect.left + this.regions.leftSolid;
     let columnsRight = this.rect.right - this.regions.rightSolid;
     let columnsWidth = columnsRight - columnsLeft;
@@ -6742,9 +6847,9 @@ var ObjMeasure = class extends MusicObject {
     let columnScale = columnsWidth / columnsMinWidth;
     let curColumnLeft = columnsLeft;
     this.columns.forEach((col) => {
-      rect = col.getRect();
+      let rect = col.getRect();
       let columnAnchorX = curColumnLeft + rect.leftw * columnScale;
-      col.offset(columnAnchorX - rect.anchorX, -rect.anchorY);
+      col.setAnchor(columnAnchorX, this.rect.anchorY);
       curColumnLeft += rect.width * columnScale;
     });
     getVoiceIds().forEach((voiceId) => {
@@ -6753,8 +6858,7 @@ var ObjMeasure = class extends MusicObject {
       if (!onlyRest) return;
       const isOnlySymbolInCol = getVoiceIds().map((voiceId2) => onlyRest.col.getVoiceSymbol(voiceId2)).filter((sym) => sym !== void 0 && sym !== onlyRest).length === 0;
       if (isOnlySymbolInCol) return;
-      const r = this.getColumnsContentRect();
-      onlyRest.offset(r.centerX - onlyRest.getRect().anchorX, 0);
+      onlyRest.setAnchorX(this.getColumnsContentRect().centerX);
     });
   }
   layoutConnectives(ctx) {
@@ -6823,9 +6927,8 @@ var ObjMeasure = class extends MusicObject {
     this.barLineLeft.offset(dx, dy);
     this.columns.forEach((col) => col.offset(dx, dy));
     this.barLineRight.offset(dx, dy);
-    if (this.endRepeatPlayCountText) {
+    if (this.endRepeatPlayCountText)
       this.endRepeatPlayCountText.offset(dx, dy);
-    }
     this.connectives.forEach((connective) => connective.offset(dx, 0));
     this.beamGroups.forEach((beam) => beam.offset(dx, dy));
     this.layoutObjects.forEach((layoutObj) => layoutObj.offset(dx, 0));
@@ -6973,6 +7076,9 @@ var LayoutObjectWrapper = class {
   offset(dx, dy) {
     this.musicObj.offset(dx, dy);
   }
+  setAnchorY(y) {
+    this.musicObj.setAnchorY(y);
+  }
   getRect() {
     return this.musicObj.getRect();
   }
@@ -7043,7 +7149,7 @@ var ObjNotationLine5 = class extends MusicObject {
     if (y === void 0) {
       return;
     }
-    layoutObj.offset(0, y - layoutObj.getRect().anchorY);
+    layoutObj.setAnchorY(y - layoutObj.getRect().anchorY);
     layoutObj.setPositionResolved();
   }
   alignObjectsY(ctx, layoutObjects, verticalPos) {
@@ -7064,7 +7170,7 @@ var ObjNotationLine5 = class extends MusicObject {
       if (musicObj instanceof ObjEnding || musicObj instanceof ObjExtensionLine || musicObj instanceof ObjTabRhythm) {
         musicObj.layoutFitToMeasure(ctx);
       } else {
-        musicObj.offset(anchor.getRect().anchorX - musicObj.getRect().anchorX, 0);
+        musicObj.setAnchorX(anchor.getRect().anchorX);
       }
     });
     if (layoutGroup.rowAlign) {
@@ -7344,7 +7450,112 @@ var ObjTab = class extends ObjNotationLine5 {
 
 // src/score/engine/obj-score-row.ts
 var import_core16 = require("@tspro/web-music-score/core");
+var import_ts_utils_lib30 = require("@tspro/ts-utils-lib");
+
+// src/score/engine/obj-score-row-group.ts
 var import_ts_utils_lib29 = require("@tspro/ts-utils-lib");
+var ObjScoreRowGroup = class extends MusicObject {
+  constructor(lines) {
+    var _a;
+    super(lines[0].row);
+    this.lines = lines;
+    __publicField(this, "space", 0);
+    __publicField(this, "instrument");
+    __publicField(this, "instrText");
+    __publicField(this, "braceRect", new import_ts_utils_lib29.AnchoredRect());
+    __publicField(this, "mi");
+    this.instrument = (_a = lines[0].getConfig().instrument) != null ? _a : "";
+    this.instrText = new ObjText(this, { text: this.instrument, color: "black", scale: 1 }, 1, 0.5);
+    this.mi = new MScoreRowGroup(this);
+  }
+  getMusicInterface() {
+    return this.mi;
+  }
+  get row() {
+    return this.lines[0].row;
+  }
+  get hasBrace() {
+    return this.hasInstrument && this.lines.length > 1;
+  }
+  get hasInstrument() {
+    return this.instrument.length > 0;
+  }
+  pick(x, y) {
+    if (!this.getRect().contains(x, y))
+      return [];
+    let arr = this.instrText.pick(x, y);
+    if (arr.length > 0) {
+      return [this, ...arr];
+    }
+    return [this];
+  }
+  updateRect() {
+    this.instrText.setRight(this.braceRect.left - this.space);
+    this.instrText.setCenterY(this.braceRect.anchorY);
+    this.rect = this.instrText.getRect().clone().expandInPlace(this.braceRect);
+  }
+  layout(ctx) {
+    this.space = ctx.unitSize;
+    this.instrText.layout(ctx);
+    this.braceRect = new import_ts_utils_lib29.AnchoredRect(-(this.hasBrace ? ctx.unitSize * 5 : 0), 0, 0, 0);
+    this.forceRectUpdate();
+  }
+  layoutToNotationLines() {
+    this.braceRect.top = this.lines[0].getTopLineY();
+    this.braceRect.bottom = this.lines[this.lines.length - 1].getBottomLineY();
+    this.braceRect.anchorY = this.braceRect.centerY;
+    this.forceRectUpdate();
+  }
+  offset(dx, dy) {
+    this.instrText.offset(dx, dy);
+    this.braceRect.offsetInPlace(dx, dy);
+    this.rect.offsetInPlace(dx, dy);
+  }
+  draw(ctx) {
+    this.instrText.draw(ctx);
+    if (this.hasBrace) {
+      ctx.color("brack").lineWidth(1).drawBracket(this.braceRect, "{");
+    }
+  }
+};
+
+// src/score/engine/obj-score-row.ts
+var ScoreRowRegions = class {
+  constructor() {
+    __publicField(this, "instrWidth", 0);
+    __publicField(this, "staffWidth", 0);
+  }
+  resetWidths() {
+    this.instrWidth = this.staffWidth = 0;
+  }
+  addRowInstrWidth(w) {
+    this.instrWidth = Math.max(this.instrWidth, w);
+  }
+  addRowstaffWidth(w) {
+    this.staffWidth = Math.max(this.staffWidth, w);
+  }
+  get instrLeft() {
+    return 0;
+  }
+  get instrRight() {
+    return this.instrWidth;
+  }
+  get staffLeft() {
+    return this.instrRight;
+  }
+  get staffRight() {
+    return this.staffLeft + this.staffWidth;
+  }
+  get left() {
+    return this.instrLeft;
+  }
+  get right() {
+    return this.staffRight;
+  }
+  get width() {
+    return this.instrWidth + this.staffWidth;
+  }
+};
 var ObjScoreRow = class extends MusicObject {
   constructor(doc, prevRow, scoreConfig) {
     super(doc);
@@ -7352,12 +7563,10 @@ var ObjScoreRow = class extends MusicObject {
     this.prevRow = prevRow;
     this.scoreConfig = scoreConfig;
     __publicField(this, "nextRow");
-    __publicField(this, "minWidth", 0);
     __publicField(this, "notationLines");
-    __publicField(this, "instrumentLineGroups");
+    __publicField(this, "rowGroups");
     __publicField(this, "staves");
     __publicField(this, "tabs");
-    __publicField(this, "instrumentNames");
     __publicField(this, "measures", []);
     __publicField(this, "needLayout", true);
     __publicField(this, "mi");
@@ -7374,10 +7583,7 @@ var ObjScoreRow = class extends MusicObject {
         prevGroup.push(line);
       }
     }
-    this.instrumentLineGroups = lineGroups;
-    this.instrumentNames = this.instrumentLineGroups.map((lines) => {
-      return lines.length > 0 && import_ts_utils_lib29.Guard.isNonEmptyString(lines[0].getConfig().instrument) ? new ObjText(this, String(lines[0].getConfig().instrument), 0, 0.5) : void 0;
-    });
+    this.rowGroups = lineGroups.filter((lines) => lines.length > 0).map((lines) => new ObjScoreRowGroup(lines));
     if (this.prevRow) {
       this.prevRow.nextRow = this;
     }
@@ -7401,14 +7607,17 @@ var ObjScoreRow = class extends MusicObject {
   getNotationLines() {
     return this.notationLines;
   }
-  getInstrumentLineGroups() {
-    return this.instrumentLineGroups;
+  getRowGroups() {
+    return this.rowGroups;
   }
   findMatchingLine(line) {
     return line.row === this ? line : this.notationLines.find(
-      (curLine) => import_ts_utils_lib29.Utils.Obj.deepEqual(line.row.scoreConfig, curLine.row.scoreConfig) && line.id === curLine.id || import_ts_utils_lib29.Guard.isNonEmptyString(line.getConfig().name) && line.getConfig().name === curLine.getConfig().name && line.getConfig().type === curLine.getConfig().type
+      (curLine) => import_ts_utils_lib30.Utils.Obj.deepEqual(line.row.scoreConfig, curLine.row.scoreConfig) && line.id === curLine.id || import_ts_utils_lib30.Guard.isNonEmptyString(line.getConfig().name) && line.getConfig().name === curLine.getConfig().name && line.getConfig().type === curLine.getConfig().type
     );
   }
+  get regions() {
+    return this.doc.regions;
+  }
   getStaves() {
     return this.staves;
   }
@@ -7454,7 +7663,6 @@ var ObjScoreRow = class extends MusicObject {
     this.notationLines.forEach((line) => line.layoutLayoutGroups(ctx));
   }
   pick(x, y) {
-    var _a, _b;
     if (!this.getRect().contains(x, y)) {
       return [];
     }
@@ -7464,8 +7672,8 @@ var ObjScoreRow = class extends MusicObject {
         return [this, ...arr];
       }
     }
-    for (let i = 0; i < this.instrumentNames.length; i++) {
-      let arr = (_b = (_a = this.instrumentNames[i]) == null ? void 0 : _a.pick(x, y)) != null ? _b : [];
+    for (let i = 0; i < this.rowGroups.length; i++) {
+      let arr = this.rowGroups[i].pick(x, y);
       if (arr.length > 0) {
         return [this, ...arr];
       }
@@ -7482,7 +7690,7 @@ var ObjScoreRow = class extends MusicObject {
     let r = this.getRect();
     let firstMeasure = this.getFirstMeasure();
     let left = firstMeasure ? firstMeasure.getColumnsContentRect().left : r.left;
-    return new import_ts_utils_lib29.AnchoredRect(left, (left + r.right) / 2, r.right, r.top, r.anchorY, r.bottom);
+    return new import_ts_utils_lib30.AnchoredRect(left, (left + r.right) / 2, r.right, r.top, r.anchorY, r.bottom);
   }
   getDiatonicIdAt(y) {
     for (let i = 0; i < this.notationLines.length; i++) {
@@ -7518,9 +7726,6 @@ var ObjScoreRow = class extends MusicObject {
   getLastMeasure() {
     return this.measures.length > 0 ? this.measures[this.measures.length - 1] : void 0;
   }
-  getMinWidth() {
-    return this.minWidth;
-  }
   solveAutoStemDir(symbols) {
     if (symbols.length === 0) {
       return "up" /* Up */;
@@ -7532,14 +7737,11 @@ var ObjScoreRow = class extends MusicObject {
         return "up" /* Up */;
       }
       let diatonicIds = noteGroupDiatonicIds.length > 0 ? noteGroupDiatonicIds : restDiatonicIds;
-      let avgDiatonicId = Math.floor(import_ts_utils_lib29.Utils.Math.avg(...diatonicIds));
+      let avgDiatonicId = Math.floor(import_ts_utils_lib30.Utils.Math.avg(...diatonicIds));
       let staves = this.getStaves().filter((staff) => staff.containsVoiceId(voiceId) && staff.containsDiatonicId(avgDiatonicId));
       return staves.length > 0 ? avgDiatonicId >= staves[0].middleLineDiatonicId ? "down" /* Down */ : "up" /* Up */ : "up" /* Up */;
     }
   }
-  getInstrumentNameWidth(ctx) {
-    return Math.max(0, ...this.instrumentNames.map((obj) => obj ? obj.getRect().width : 0));
-  }
   requestLayout() {
     if (!this.needLayout) {
       this.needLayout = true;
@@ -7551,37 +7753,39 @@ var ObjScoreRow = class extends MusicObject {
       return;
     }
     this.requestRectUpdate();
-    this.instrumentNames.forEach((obj) => obj == null ? void 0 : obj.layout(ctx));
     this.notationLines.forEach((line) => {
       line.removeObjects();
       line.layoutHeight(ctx);
     });
-    this.minWidth = 0;
-    this.measures.forEach((m) => {
-      m.layout(ctx);
-      this.minWidth += m.getMinWidth();
-      this.minWidth += m.getPostMeasureBreakWidth();
+    this.rowGroups.forEach((grp) => {
+      grp.layout(ctx);
+      this.regions.addRowInstrWidth(grp.getRect().width);
     });
+    this.measures.forEach((m) => m.layout(ctx));
+    let packedWidth = this.measures.map((m) => m.getMinWidth() + m.getPostMeasureBreakWidth()).reduce((acc, cur) => acc + cur);
+    this.regions.addRowstaffWidth(packedWidth);
   }
-  layoutWidth(ctx, left, right) {
+  layoutStretch(ctx) {
     if (!this.needLayout) {
       return;
     }
-    this.rect = new import_ts_utils_lib29.AnchoredRect(0, right, 0, 0);
+    this.rect = new import_ts_utils_lib30.AnchoredRect(this.regions.left, this.regions.right, 0, 0);
     this.notationLines.forEach((line) => line.layoutWidth(ctx));
-    let targetColumnsAreaWidth = right - left;
+    this.rowGroups.forEach((grp) => grp.setRight(this.regions.instrRight));
+    let targetColumnsAreaWidth = this.regions.staffWidth;
     let minColumnsAreaWidth = 0;
     this.measures.forEach((m) => {
       targetColumnsAreaWidth -= m.getTotalSolidWidth() + m.getPostMeasureBreakWidth();
       minColumnsAreaWidth += m.getMinColumnsWidth();
     });
     let columnsAreaScale = targetColumnsAreaWidth / minColumnsAreaWidth;
-    let x = this.doc.getInstrumentGroupRegions(ctx).braceRight;
+    let x = this.regions.staffLeft;
     this.measures.forEach((m) => {
       let newMeasureWidth = m.getTotalSolidWidth() + m.getMinColumnsWidth() * columnsAreaScale;
       m.layoutWidth(ctx, newMeasureWidth);
       let r = m.getRect();
-      m.offset(x - r.left, -r.anchorY);
+      m.setLeft(x);
+      m.setAnchorY(0);
       x += r.width;
       x += m.getPostMeasureBreakWidth();
     });
@@ -7591,11 +7795,20 @@ var ObjScoreRow = class extends MusicObject {
     });
   }
   updateRect() {
-    let left = 0;
-    let right = this.measures.length > 0 ? this.measures[this.measures.length - 1].getRect().right : left;
-    let top = this.measures.length > 0 ? Math.min(...this.measures.map((m) => m.getRect().top)) : 0;
-    let bottom = this.measures.length > 0 ? Math.max(...this.measures.map((m) => m.getRect().bottom)) : 0;
-    this.rect = new import_ts_utils_lib29.AnchoredRect(left, right, top, bottom);
+    var _a;
+    let left = this.regions.left;
+    let right = this.regions.right;
+    let top = 0;
+    let bottom = 0;
+    const fermata = (_a = this.getLastMeasure()) == null ? void 0 : _a.getBarLineRight().getAnchoredLayoutObjects().map((o) => o.musicObj).find((o) => o instanceof ObjFermata);
+    if (fermata) {
+      right = Math.max(right, fermata.getRect().right);
+    }
+    if (this.measures.length > 0) {
+      top = Math.min(...this.measures.map((m) => m.getRect().top));
+      bottom = Math.max(...this.measures.map((m) => m.getRect().bottom));
+    }
+    this.rect = new import_ts_utils_lib30.AnchoredRect(left, right, top, bottom);
   }
   alignStemsToBeams() {
     this.measures.forEach((m) => m.alignStemsToBeams());
@@ -7607,10 +7820,10 @@ var ObjScoreRow = class extends MusicObject {
       let cur = this.notationLines[i];
       if (prev instanceof ObjStaff && cur instanceof ObjStaff && prev.staffConfig.grandId !== void 0 && prev.staffConfig.grandId === cur.staffConfig.grandId) {
         let dy = prev.getBottomLineY() - cur.getTopLineY() + unitSize * 6;
-        cur.offset(0, dy);
+        cur.offsetY(dy);
       } else {
         let dy = prev.calcBottom() - cur.calcTop() + unitSize * 3;
-        cur.offset(0, dy);
+        cur.offsetY(dy);
       }
     }
     this.measures.forEach((m) => {
@@ -7625,26 +7838,10 @@ var ObjScoreRow = class extends MusicObject {
         });
       });
     });
-    this.instrumentNames.forEach((obj, i) => {
-      let grp = this.instrumentLineGroups[i];
-      if (obj && grp.length > 0) {
-        obj.offset(
-          -obj.getRect().left,
-          -obj.getRect().anchorY + (grp[0].getRect().top + grp[grp.length - 1].getRect().bottom) / 2
-        );
-      }
-    });
+    this.rowGroups.forEach((grp) => grp.layoutToNotationLines());
     this.alignStemsToBeams();
     this.requestRectUpdate();
   }
-  layoutPadding(ctx) {
-    let p = ctx.unitSize / 2;
-    this.getRect();
-    this.rect.left -= p;
-    this.rect.right += p;
-    this.rect.top -= p;
-    this.rect.bottom += p;
-  }
   layoutDone() {
     this.measures.forEach((m) => m.layoutDone());
     this.needLayout = false;
@@ -7653,13 +7850,14 @@ var ObjScoreRow = class extends MusicObject {
     this.measures.forEach((m) => m.offset(dx, dy));
     this.rect.offsetInPlace(dx, dy);
     this.notationLines.forEach((l) => l.offset(dx, dy));
-    this.instrumentNames.forEach((obj) => obj == null ? void 0 : obj.offset(dx, dy));
+    this.rowGroups.forEach((grp) => grp.offset(dx, dy));
   }
   draw(ctx) {
     ctx.drawDebugRect(this.getRect());
+    const { left, top, width, height } = this.getRect();
+    const p = ctx._lineWidth;
     ctx.save();
-    let { left, top, width, height } = this.getRect();
-    ctx.rect(left, top, width, height);
+    ctx.rect(left - p, top, width + 2 * p, height);
     ctx.clip();
     if (this.getFirstMeasure() && (this.notationLines.length > 1 || this.notationLines[0] instanceof ObjTab)) {
       let left2 = this.getFirstMeasure().getStaffLineLeft();
@@ -7669,31 +7867,17 @@ var ObjScoreRow = class extends MusicObject {
     }
     this.measures.forEach((m) => m.draw(ctx));
     this.notationLines.forEach((m) => m.draw(ctx));
-    let grpSize = this.doc.getInstrumentGroupRegions(ctx);
-    this.instrumentNames.forEach((obj, i) => {
-      let grp = this.instrumentLineGroups[i];
-      if (grp.length > 1) {
-        let r = new import_ts_utils_lib29.AnchoredRect(
-          grpSize.braceLeft,
-          grpSize.braceRight,
-          grp[0].getTopLineY(),
-          grp[grp.length - 1].getBottomLineY()
-        );
-        ctx.color("brack").lineWidth(1).drawBrace(r, "left");
-      }
-      if (obj) {
-        obj.draw(ctx);
-      }
-    });
+    this.rowGroups.forEach((grp) => grp.draw(ctx));
     ctx.restore();
   }
 };
 
 // src/score/engine/obj-header.ts
-var import_ts_utils_lib30 = require("@tspro/ts-utils-lib");
+var import_ts_utils_lib31 = require("@tspro/ts-utils-lib");
 var ObjHeader = class extends MusicObject {
   constructor(doc, title, composer, arranger) {
     super(doc);
+    this.doc = doc;
     this.title = title;
     this.composer = composer;
     this.arranger = arranger;
@@ -7733,24 +7917,29 @@ var ObjHeader = class extends MusicObject {
     }
     return [this];
   }
-  layoutWidth(ctx, left, right) {
+  layout(ctx) {
     let top = 0;
-    this.rect = new import_ts_utils_lib30.AnchoredRect(left, right, 0, 0);
+    const left = this.doc.regions.staffLeft;
+    const right = this.doc.regions.staffRight;
+    this.rect = new import_ts_utils_lib31.AnchoredRect(left, right, 0, 0);
     if (this.titleText) {
       this.titleText.layout(ctx);
-      this.titleText.offset((left + right) / 2, top);
+      this.titleText.setCenterX((left + right) / 2);
+      this.titleText.setTop(top);
       top += this.titleText.getRect().height;
       this.rect.expandInPlace(this.titleText.getRect());
     }
     if (this.composerText) {
       this.composerText.layout(ctx);
-      this.composerText.offset(right, top);
+      this.composerText.setRight(right);
+      this.composerText.setTop(top);
       top += this.composerText.getRect().height;
       this.rect.expandInPlace(this.composerText.getRect());
     }
     if (this.arrangerText) {
       this.arrangerText.layout(ctx);
-      this.arrangerText.offset(right, top);
+      this.arrangerText.setRight(right);
+      this.arrangerText.setTop(top);
       top += this.arrangerText.getRect().height;
       this.rect.expandInPlace(this.arrangerText.getRect());
     }
@@ -7781,30 +7970,14 @@ var ObjHeader = class extends MusicObject {
 };
 
 // src/score/engine/obj-document.ts
-var import_ts_utils_lib31 = require("@tspro/ts-utils-lib");
+var import_ts_utils_lib32 = require("@tspro/ts-utils-lib");
 var import_core17 = require("@tspro/web-music-score/core");
-var InstrumentGroupRegions = class {
-  constructor() {
-    __publicField(this, "nameLeft", 0);
-    __publicField(this, "nameRight", 0);
-    __publicField(this, "braceLeft", 0);
-    __publicField(this, "braceRight", 0);
-  }
-  get left() {
-    return this.nameLeft;
-  }
-  get right() {
-    return this.braceRight;
-  }
-  get width() {
-    return this.right - this.left;
-  }
-};
 var ObjDocument = class extends MusicObject {
   constructor() {
     super(void 0);
     __publicField(this, "needLayout", true);
     __publicField(this, "ctx");
+    __publicField(this, "regions", new ScoreRowRegions());
     __publicField(this, "rows", []);
     __publicField(this, "measures", []);
     __publicField(this, "measuresPerRow", Infinity);
@@ -7812,8 +7985,7 @@ var ObjDocument = class extends MusicObject {
     __publicField(this, "header");
     __publicField(this, "newRowRequested", false);
     __publicField(this, "allConnectiveProps", []);
-    __publicField(this, "staffGroups", new import_ts_utils_lib31.UniMap());
-    __publicField(this, "instrumentGroupRegions", new InstrumentGroupRegions());
+    __publicField(this, "staffGroups", new import_ts_utils_lib32.UniMap());
     __publicField(this, "mi");
     this.mi = new MDocument2(this);
   }
@@ -7821,7 +7993,7 @@ var ObjDocument = class extends MusicObject {
     return this.mi;
   }
   setScoreConfiguration(config) {
-    if (import_ts_utils_lib31.Guard.isEnumValue(config, StaffPreset)) {
+    if (import_ts_utils_lib32.Guard.isEnumValue(config, StaffPreset)) {
       switch (config) {
         default:
         case "treble" /* Treble */:
@@ -7849,7 +8021,7 @@ var ObjDocument = class extends MusicObject {
           ];
           break;
       }
-    } else if (import_ts_utils_lib31.Guard.isArray(config)) {
+    } else if (import_ts_utils_lib32.Guard.isArray(config)) {
       this.curScoreConfig = config;
     } else {
       this.curScoreConfig = [config];
@@ -8010,17 +8182,6 @@ var ObjDocument = class extends MusicObject {
       this.ctx.updateCursorRect(cursorRect);
     }
   }
-  getInstrumentGroupRegions(ctx) {
-    let nameWidth = Math.max(0, ...this.rows.map((row) => row.getInstrumentNameWidth(ctx)));
-    let hasName = nameWidth > 0;
-    let padding = hasName ? ctx.unitSize : 0;
-    let braceWidth = hasName ? ctx.unitSize * 5 : 0;
-    this.instrumentGroupRegions.nameLeft = 0;
-    this.instrumentGroupRegions.nameRight = nameWidth;
-    this.instrumentGroupRegions.braceLeft = nameWidth + padding;
-    this.instrumentGroupRegions.braceRight = nameWidth + padding + braceWidth + padding;
-    return this.instrumentGroupRegions;
-  }
   requestLayout() {
     this.needLayout = true;
   }
@@ -8048,28 +8209,27 @@ var ObjDocument = class extends MusicObject {
     this.allConnectiveProps.forEach((props) => props.removeConnectives());
     this.allConnectiveProps.forEach((props) => props.createConnectives());
     this.rows.forEach((row) => row.resetLayoutGroups(ctx));
+    this.regions.resetWidths();
+    this.regions.addRowstaffWidth(DocumentSettings.MinStaffWidth * unitSize);
     this.rows.forEach((row) => row.layout(ctx));
-    let rowLeft = this.getInstrumentGroupRegions(ctx).right;
-    let rowRight = rowLeft + Math.max(
-      DocumentSettings.DocumentMinWidth * unitSize,
-      ...this.rows.map((row) => row.getMinWidth())
-    );
-    this.rows.forEach((row) => row.layoutWidth(ctx, rowLeft, rowRight));
+    this.rows.forEach((row) => row.layoutStretch(ctx));
     this.rows.forEach((row) => row.layoutLayoutGroups(ctx));
     this.rows.forEach((row) => row.layoutSetNotationLines(ctx));
-    this.rows.forEach((row) => row.layoutPadding(ctx));
-    this.rect = new import_ts_utils_lib31.AnchoredRect();
+    this.rect = new import_ts_utils_lib32.AnchoredRect();
     if (this.header) {
-      this.header.layoutWidth(ctx, rowLeft, rowRight);
+      this.header.layout(ctx);
       this.rect.expandInPlace(this.header.getRect());
     }
     this.rows.forEach((row) => {
-      row.offset(-this.rect.left, this.rect.bottom + unitSize * 2 - row.getRect().top);
+      row.setLeft(0);
+      row.setTop(this.rect.bottom + unitSize * 2);
       this.rect.expandInPlace(row.getRect());
     });
     this.rows.forEach((row) => row.layoutDone());
     this.needLayout = false;
   }
+  offset(dx, dy) {
+  }
   drawContent() {
     const { ctx } = this;
     if (!ctx) {
@@ -8138,86 +8298,86 @@ function assertArgMsg(condition, msg) {
 function assertBaseConfig(baseConfig) {
   var _a;
   assertArg(
-    import_ts_utils_lib32.Guard.isObject(baseConfig),
-    import_ts_utils_lib32.Guard.isStringOrUndefined(baseConfig.name),
-    import_ts_utils_lib32.Guard.isUndefined(baseConfig.voiceId) || isVoiceId(baseConfig.voiceId) || import_ts_utils_lib32.Guard.isArray(baseConfig.voiceId) && baseConfig.voiceId.every((voiceId) => isVoiceId(voiceId))
+    import_ts_utils_lib33.Guard.isObject(baseConfig),
+    import_ts_utils_lib33.Guard.isStringOrUndefined(baseConfig.name),
+    import_ts_utils_lib33.Guard.isUndefined(baseConfig.voiceId) || isVoiceId(baseConfig.voiceId) || import_ts_utils_lib33.Guard.isArray(baseConfig.voiceId) && baseConfig.voiceId.every((voiceId) => isVoiceId(voiceId))
   );
-  if (!import_ts_utils_lib32.Guard.isUndefined(baseConfig.voiceIds)) {
-    assertArg(isVoiceId(baseConfig.voiceIds) || import_ts_utils_lib32.Guard.isArray(baseConfig.voiceIds) && baseConfig.voiceIds.every((voiceId) => isVoiceId(voiceId)));
+  if (!import_ts_utils_lib33.Guard.isUndefined(baseConfig.voiceIds)) {
+    assertArg(isVoiceId(baseConfig.voiceIds) || import_ts_utils_lib33.Guard.isArray(baseConfig.voiceIds) && baseConfig.voiceIds.every((voiceId) => isVoiceId(voiceId)));
     console.warn(`Staff/tab config property 'voiceIds' is deprecated, use 'voiceId' instead.`);
-    let arr = import_ts_utils_lib32.Utils.Arr.toArray((_a = baseConfig.voiceId) != null ? _a : []);
-    import_ts_utils_lib32.Utils.Arr.toArray(baseConfig.voiceIds).forEach((voiceId) => arr.push(voiceId));
+    let arr = import_ts_utils_lib33.Utils.Arr.toArray((_a = baseConfig.voiceId) != null ? _a : []);
+    import_ts_utils_lib33.Utils.Arr.toArray(baseConfig.voiceIds).forEach((voiceId) => arr.push(voiceId));
     baseConfig.voiceId = arr;
   }
-  if (import_ts_utils_lib32.Guard.isArray(baseConfig.voiceId)) {
-    baseConfig.voiceId = import_ts_utils_lib32.Utils.Arr.removeDuplicates(baseConfig.voiceId);
+  if (import_ts_utils_lib33.Guard.isArray(baseConfig.voiceId)) {
+    baseConfig.voiceId = import_ts_utils_lib33.Utils.Arr.removeDuplicates(baseConfig.voiceId);
   }
-  assertArg(import_ts_utils_lib32.Guard.isStringOrUndefined(baseConfig.instrument));
+  assertArg(import_ts_utils_lib33.Guard.isStringOrUndefined(baseConfig.instrument));
 }
 function assertStaffConfig(staffConfig) {
   assertBaseConfig(staffConfig);
   assertArg(
-    import_ts_utils_lib32.Guard.isObject(staffConfig),
-    import_ts_utils_lib32.Guard.isStrictEqual(staffConfig.type, "staff"),
-    import_ts_utils_lib32.Guard.isEnumValue(staffConfig.clef, Clef),
-    import_ts_utils_lib32.Guard.isBooleanOrUndefined(staffConfig.isOctaveDown),
-    import_ts_utils_lib32.Guard.isUndefined(staffConfig.minNote) || import_theory13.Note.isNote(staffConfig.minNote),
-    import_ts_utils_lib32.Guard.isUndefined(staffConfig.maxNote) || import_theory13.Note.isNote(staffConfig.maxNote),
-    import_ts_utils_lib32.Guard.isStringOrUndefined(staffConfig.grandId),
-    import_ts_utils_lib32.Guard.isBooleanOrUndefined(staffConfig.isGrand)
+    import_ts_utils_lib33.Guard.isObject(staffConfig),
+    import_ts_utils_lib33.Guard.isStrictEqual(staffConfig.type, "staff"),
+    import_ts_utils_lib33.Guard.isEnumValue(staffConfig.clef, Clef),
+    import_ts_utils_lib33.Guard.isBooleanOrUndefined(staffConfig.isOctaveDown),
+    import_ts_utils_lib33.Guard.isUndefined(staffConfig.minNote) || import_theory13.Note.isNote(staffConfig.minNote),
+    import_ts_utils_lib33.Guard.isUndefined(staffConfig.maxNote) || import_theory13.Note.isNote(staffConfig.maxNote),
+    import_ts_utils_lib33.Guard.isStringOrUndefined(staffConfig.grandId),
+    import_ts_utils_lib33.Guard.isBooleanOrUndefined(staffConfig.isGrand)
   );
-  if (!import_ts_utils_lib32.Guard.isUndefined(staffConfig.isGrand))
+  if (!import_ts_utils_lib33.Guard.isUndefined(staffConfig.isGrand))
     console.warn(`Staff config property 'isGrand' is deprecated, use 'grandId' instead.`);
 }
 function assertTabConfig(tabConfig) {
   assertBaseConfig(tabConfig);
   assertArg(
-    import_ts_utils_lib32.Guard.isObject(tabConfig),
-    import_ts_utils_lib32.Guard.isStrictEqual(tabConfig.type, "tab"),
-    import_ts_utils_lib32.Guard.isUndefined(tabConfig.tuning) || import_ts_utils_lib32.Guard.isString(tabConfig.tuning) && import_ts_utils_lib32.Guard.isIncluded(tabConfig.tuning, import_theory13.TuningNameList) || import_ts_utils_lib32.Guard.isArray(tabConfig.tuning) && import_ts_utils_lib32.Guard.isStrictEqual(tabConfig.tuning.length, getStringNumbers().length && tabConfig.tuning.every((s) => import_theory13.Note.isNote(s)))
+    import_ts_utils_lib33.Guard.isObject(tabConfig),
+    import_ts_utils_lib33.Guard.isStrictEqual(tabConfig.type, "tab"),
+    import_ts_utils_lib33.Guard.isUndefined(tabConfig.tuning) || import_ts_utils_lib33.Guard.isString(tabConfig.tuning) && import_ts_utils_lib33.Guard.isIncluded(tabConfig.tuning, import_theory13.TuningNameList) || import_ts_utils_lib33.Guard.isArray(tabConfig.tuning) && import_ts_utils_lib33.Guard.isStrictEqual(tabConfig.tuning.length, getStringNumbers().length && tabConfig.tuning.every((s) => import_theory13.Note.isNote(s)))
   );
 }
 function assertNoteOptions(noteOptions) {
   assertArg(
-    import_ts_utils_lib32.Guard.isObject(noteOptions),
-    import_ts_utils_lib32.Guard.isBooleanOrUndefined(noteOptions.dotted) || import_ts_utils_lib32.Guard.isIntegerGte(noteOptions.dotted, 0),
-    import_ts_utils_lib32.Guard.isEnumValueOrUndefined(noteOptions.stem, Stem),
-    import_ts_utils_lib32.Guard.isStringOrUndefined(noteOptions.color),
-    import_ts_utils_lib32.Guard.isBooleanOrUndefined(noteOptions.arpeggio) || import_ts_utils_lib32.Guard.isEnumValue(noteOptions.arpeggio, Arpeggio),
-    import_ts_utils_lib32.Guard.isBooleanOrUndefined(noteOptions.staccato),
-    import_ts_utils_lib32.Guard.isBooleanOrUndefined(noteOptions.diamond),
-    import_ts_utils_lib32.Guard.isBooleanOrUndefined(noteOptions.triplet),
-    import_ts_utils_lib32.Guard.isUndefined(noteOptions.string) || isStringNumber(noteOptions.string) || import_ts_utils_lib32.Guard.isEmptyArray(noteOptions.string) || import_ts_utils_lib32.Guard.isNonEmptyArray(noteOptions.string) && noteOptions.string.every((string) => isStringNumber(string))
+    import_ts_utils_lib33.Guard.isObject(noteOptions),
+    import_ts_utils_lib33.Guard.isBooleanOrUndefined(noteOptions.dotted) || import_ts_utils_lib33.Guard.isIntegerGte(noteOptions.dotted, 0),
+    import_ts_utils_lib33.Guard.isEnumValueOrUndefined(noteOptions.stem, Stem),
+    import_ts_utils_lib33.Guard.isStringOrUndefined(noteOptions.color),
+    import_ts_utils_lib33.Guard.isBooleanOrUndefined(noteOptions.arpeggio) || import_ts_utils_lib33.Guard.isEnumValue(noteOptions.arpeggio, Arpeggio),
+    import_ts_utils_lib33.Guard.isBooleanOrUndefined(noteOptions.staccato),
+    import_ts_utils_lib33.Guard.isBooleanOrUndefined(noteOptions.diamond),
+    import_ts_utils_lib33.Guard.isBooleanOrUndefined(noteOptions.triplet),
+    import_ts_utils_lib33.Guard.isUndefined(noteOptions.string) || isStringNumber(noteOptions.string) || import_ts_utils_lib33.Guard.isEmptyArray(noteOptions.string) || import_ts_utils_lib33.Guard.isNonEmptyArray(noteOptions.string) && noteOptions.string.every((string) => isStringNumber(string))
   );
-  assertArgMsg(import_ts_utils_lib32.Guard.isUndefined(noteOptions.tieSpan), `NoteOptions.tieSpan was removed. Use addConnective("tie", tieSpan)`);
-  assertArgMsg(import_ts_utils_lib32.Guard.isUndefined(noteOptions.slurSpan), `NoteOptions.slurSpan was removed. Use addConnective("slur", slurSpan)`);
+  assertArgMsg(import_ts_utils_lib33.Guard.isUndefined(noteOptions.tieSpan), `NoteOptions.tieSpan was removed. Use addConnective("tie", tieSpan)`);
+  assertArgMsg(import_ts_utils_lib33.Guard.isUndefined(noteOptions.slurSpan), `NoteOptions.slurSpan was removed. Use addConnective("slur", slurSpan)`);
 }
 function assertRestOptions(restOptions) {
   assertArg(
-    import_ts_utils_lib32.Guard.isObject(restOptions),
-    import_ts_utils_lib32.Guard.isBooleanOrUndefined(restOptions.dotted) || import_ts_utils_lib32.Guard.isIntegerGte(restOptions.dotted, 0),
-    import_ts_utils_lib32.Guard.isStringOrUndefined(restOptions.staffPos) || import_ts_utils_lib32.Guard.isInteger(restOptions.staffPos) || restOptions.staffPos instanceof import_theory13.Note,
-    import_ts_utils_lib32.Guard.isStringOrUndefined(restOptions.color),
-    import_ts_utils_lib32.Guard.isBooleanOrUndefined(restOptions.hide),
-    import_ts_utils_lib32.Guard.isBooleanOrUndefined(restOptions.triplet)
+    import_ts_utils_lib33.Guard.isObject(restOptions),
+    import_ts_utils_lib33.Guard.isBooleanOrUndefined(restOptions.dotted) || import_ts_utils_lib33.Guard.isIntegerGte(restOptions.dotted, 0),
+    import_ts_utils_lib33.Guard.isStringOrUndefined(restOptions.staffPos) || import_ts_utils_lib33.Guard.isInteger(restOptions.staffPos) || restOptions.staffPos instanceof import_theory13.Note,
+    import_ts_utils_lib33.Guard.isStringOrUndefined(restOptions.color),
+    import_ts_utils_lib33.Guard.isBooleanOrUndefined(restOptions.hide),
+    import_ts_utils_lib33.Guard.isBooleanOrUndefined(restOptions.triplet)
   );
 }
 function assertLyricsOptions(lyricsOptions) {
   assertArg(
-    import_ts_utils_lib32.Guard.isObject(lyricsOptions),
-    import_ts_utils_lib32.Guard.isEnumValueOrUndefined(lyricsOptions.align, LyricsAlign),
-    import_ts_utils_lib32.Guard.isEnumValueOrUndefined(lyricsOptions.hyphen, LyricsHyphen)
+    import_ts_utils_lib33.Guard.isObject(lyricsOptions),
+    import_ts_utils_lib33.Guard.isEnumValueOrUndefined(lyricsOptions.align, LyricsAlign),
+    import_ts_utils_lib33.Guard.isEnumValueOrUndefined(lyricsOptions.hyphen, LyricsHyphen)
   );
 }
 function assertMeasureOptions(measureOptions) {
   assertArg(
-    import_ts_utils_lib32.Guard.isObject(measureOptions),
-    import_ts_utils_lib32.Guard.isBooleanOrUndefined(measureOptions.showNumber)
+    import_ts_utils_lib33.Guard.isObject(measureOptions),
+    import_ts_utils_lib33.Guard.isBooleanOrUndefined(measureOptions.showNumber)
   );
 }
 function assertStaffTabOrGRoups(staffTabOrGroups) {
   assertArg(
-    import_ts_utils_lib32.Guard.isStringOrUndefined(staffTabOrGroups) || import_ts_utils_lib32.Guard.isIntegerGte(staffTabOrGroups, 0) || import_ts_utils_lib32.Guard.isNonEmptyArray(staffTabOrGroups) && staffTabOrGroups.every((staffTabOrGroup) => import_ts_utils_lib32.Guard.isString(staffTabOrGroup) || import_ts_utils_lib32.Guard.isIntegerGte(staffTabOrGroup, 0))
+    import_ts_utils_lib33.Guard.isStringOrUndefined(staffTabOrGroups) || import_ts_utils_lib33.Guard.isIntegerGte(staffTabOrGroups, 0) || import_ts_utils_lib33.Guard.isNonEmptyArray(staffTabOrGroups) && staffTabOrGroups.every((staffTabOrGroup) => import_ts_utils_lib33.Guard.isString(staffTabOrGroup) || import_ts_utils_lib33.Guard.isIntegerGte(staffTabOrGroup, 0))
   );
 }
 var _DocumentBuilder = class _DocumentBuilder {
@@ -8231,19 +8391,19 @@ var _DocumentBuilder = class _DocumentBuilder {
   }
   setScoreConfiguration(config) {
     setAssertFunction("setScoreConfiguration", config);
-    if (import_ts_utils_lib32.Guard.isEnumValue(config, StaffPreset)) {
+    if (import_ts_utils_lib33.Guard.isEnumValue(config, StaffPreset)) {
       this.doc.setScoreConfiguration(config);
-    } else if (import_ts_utils_lib32.Guard.isObject(config) && config.type === "staff") {
+    } else if (import_ts_utils_lib33.Guard.isObject(config) && config.type === "staff") {
       assertStaffConfig(config);
       this.doc.setScoreConfiguration(config);
-    } else if (import_ts_utils_lib32.Guard.isObject(config) && config.type === "tab") {
+    } else if (import_ts_utils_lib33.Guard.isObject(config) && config.type === "tab") {
       assertTabConfig(config);
       this.doc.setScoreConfiguration(config);
-    } else if (import_ts_utils_lib32.Guard.isNonEmptyArray(config)) {
+    } else if (import_ts_utils_lib33.Guard.isNonEmptyArray(config)) {
       config.forEach((c) => {
-        if (import_ts_utils_lib32.Guard.isObject(c) && c.type === "staff") {
+        if (import_ts_utils_lib33.Guard.isObject(c) && c.type === "staff") {
           assertStaffConfig(c);
-        } else if (import_ts_utils_lib32.Guard.isObject(c) && c.type === "tab") {
+        } else if (import_ts_utils_lib33.Guard.isObject(c) && c.type === "tab") {
           assertTabConfig(c);
         } else {
           assertArg(false);
@@ -8276,9 +8436,9 @@ var _DocumentBuilder = class _DocumentBuilder {
   setHeader(title, composer, arranger) {
     setAssertFunction("setHeader", title, composer, arranger);
     assertArg(
-      import_ts_utils_lib32.Guard.isStringOrUndefined(title),
-      import_ts_utils_lib32.Guard.isStringOrUndefined(composer),
-      import_ts_utils_lib32.Guard.isStringOrUndefined(arranger)
+      import_ts_utils_lib33.Guard.isStringOrUndefined(title),
+      import_ts_utils_lib33.Guard.isStringOrUndefined(composer),
+      import_ts_utils_lib33.Guard.isStringOrUndefined(arranger)
     );
     this.doc.setHeader(title, composer, arranger);
     return this;
@@ -8290,7 +8450,7 @@ var _DocumentBuilder = class _DocumentBuilder {
    */
   setMeasuresPerRow(measuresPerRow) {
     setAssertFunction("setMeasuresPerRow", measuresPerRow);
-    assertArg(import_ts_utils_lib32.Guard.isIntegerGte(measuresPerRow, 1) || import_ts_utils_lib32.Guard.isPosInfinity(measuresPerRow));
+    assertArg(import_ts_utils_lib33.Guard.isIntegerGte(measuresPerRow, 1) || import_ts_utils_lib33.Guard.isPosInfinity(measuresPerRow));
     this.doc.setMeasuresPerRow(measuresPerRow);
     return this;
   }
@@ -8308,7 +8468,7 @@ var _DocumentBuilder = class _DocumentBuilder {
   }
   setKeySignature(...args) {
     setAssertFunction("setKeySignature", ...args);
-    assertArg(args[0] instanceof import_theory13.Scale || args[0] instanceof import_theory13.KeySignature || import_ts_utils_lib32.Guard.isNonEmptyString(args[0]) && import_ts_utils_lib32.Guard.isEnumValueOrUndefined(args[1], import_theory13.ScaleType));
+    assertArg(args[0] instanceof import_theory13.Scale || args[0] instanceof import_theory13.KeySignature || import_ts_utils_lib33.Guard.isNonEmptyString(args[0]) && import_ts_utils_lib33.Guard.isEnumValueOrUndefined(args[1], import_theory13.ScaleType));
     this.getMeasure().setKeySignature(...args);
     return this;
   }
@@ -8316,9 +8476,9 @@ var _DocumentBuilder = class _DocumentBuilder {
     setAssertFunction("setTimeSignature", ...args);
     if (args[0] instanceof import_theory13.TimeSignature) {
       this.getMeasure().setTimeSignature(args[0]);
-    } else if (import_ts_utils_lib32.Guard.isEnumValue(args[0], import_theory13.TimeSignatures) && import_ts_utils_lib32.Guard.isEnumValueOrUndefined(args[1], import_theory13.BeamGrouping)) {
+    } else if (import_ts_utils_lib33.Guard.isEnumValue(args[0], import_theory13.TimeSignatures) && import_ts_utils_lib33.Guard.isEnumValueOrUndefined(args[1], import_theory13.BeamGrouping)) {
       this.getMeasure().setTimeSignature(new import_theory13.TimeSignature(args[0], args[1]));
-    } else if (import_ts_utils_lib32.Guard.isIntegerGte(args[0], 1) && import_ts_utils_lib32.Guard.isIntegerGte(args[1], 1) && import_ts_utils_lib32.Guard.isEnumValueOrUndefined(args[2], import_theory13.BeamGrouping)) {
+    } else if (import_ts_utils_lib33.Guard.isIntegerGte(args[0], 1) && import_ts_utils_lib33.Guard.isIntegerGte(args[1], 1) && import_ts_utils_lib33.Guard.isEnumValueOrUndefined(args[2], import_theory13.BeamGrouping)) {
       this.getMeasure().setTimeSignature(new import_theory13.TimeSignature(args[0], args[1], args[2]));
     } else {
       assertArg(false);
@@ -8328,8 +8488,8 @@ var _DocumentBuilder = class _DocumentBuilder {
   setTempo(beatsPerMinute, beatLength, dotted) {
     setAssertFunction("setTempo", beatsPerMinute, beatLength, dotted);
     assertArg(
-      import_ts_utils_lib32.Guard.isIntegerGte(beatsPerMinute, 1),
-      import_ts_utils_lib32.Guard.isUndefined(beatLength) && import_ts_utils_lib32.Guard.isUndefined(dotted) || (0, import_theory13.isNoteLength)(beatLength) && (import_ts_utils_lib32.Guard.isBooleanOrUndefined(dotted) || import_ts_utils_lib32.Guard.isIntegerGte(dotted, 0))
+      import_ts_utils_lib33.Guard.isIntegerGte(beatsPerMinute, 1),
+      import_ts_utils_lib33.Guard.isUndefined(beatLength) && import_ts_utils_lib33.Guard.isUndefined(dotted) || (0, import_theory13.isNoteLength)(beatLength) && (import_ts_utils_lib33.Guard.isBooleanOrUndefined(dotted) || import_ts_utils_lib33.Guard.isIntegerGte(dotted, 0))
     );
     this.getMeasure().setTempo(beatsPerMinute, beatLength, dotted);
     return this;
@@ -8346,15 +8506,15 @@ var _DocumentBuilder = class _DocumentBuilder {
     setAssertFunction("addNote", voiceId, note, noteLength, noteOptions);
     assertArg(
       isVoiceId(voiceId),
-      note instanceof import_theory13.Note || import_ts_utils_lib32.Guard.isNonEmptyString(note) || import_ts_utils_lib32.Guard.isArray(note) && note.every((note2) => note2 instanceof import_theory13.Note || import_ts_utils_lib32.Guard.isNonEmptyString(note2)),
+      note instanceof import_theory13.Note || import_ts_utils_lib33.Guard.isNonEmptyString(note) || import_ts_utils_lib33.Guard.isArray(note) && note.every((note2) => note2 instanceof import_theory13.Note || import_ts_utils_lib33.Guard.isNonEmptyString(note2)),
       (0, import_theory13.isNoteLength)(noteLength)
     );
     noteOptions != null ? noteOptions : noteOptions = {};
     assertNoteOptions(noteOptions);
-    if (import_ts_utils_lib32.Guard.isArray(note)) {
+    if (import_ts_utils_lib33.Guard.isArray(note)) {
       let string = noteOptions.string;
       note.forEach((note2, noteId) => {
-        noteOptions.string = import_ts_utils_lib32.Guard.isArray(string) ? string[noteId] : string;
+        noteOptions.string = import_ts_utils_lib33.Guard.isArray(string) ? string[noteId] : string;
         this.getMeasure().addNoteGroup(voiceId, [note2], noteLength, noteOptions);
       });
     } else {
@@ -8374,7 +8534,7 @@ var _DocumentBuilder = class _DocumentBuilder {
     setAssertFunction("addChord", voiceId, notes, noteLength, noteOptions);
     assertArg(
       isVoiceId(voiceId),
-      import_ts_utils_lib32.Guard.isNonEmptyArray(notes) && notes.every((note) => note instanceof import_theory13.Note || import_ts_utils_lib32.Guard.isNonEmptyString(note)),
+      import_ts_utils_lib33.Guard.isNonEmptyArray(notes) && notes.every((note) => note instanceof import_theory13.Note || import_ts_utils_lib33.Guard.isNonEmptyString(note)),
       (0, import_theory13.isNoteLength)(noteLength)
     );
     noteOptions != null ? noteOptions : noteOptions = {};
@@ -8419,24 +8579,24 @@ var _DocumentBuilder = class _DocumentBuilder {
     setAssertFunction("addTuplet", voiceId, tupletRatio);
     assertArg(
       isVoiceId(voiceId),
-      import_ts_utils_lib32.Guard.isFunction(tupletBuilder),
-      (0, import_theory13.isTupletRatio)(tupletRatio) && import_ts_utils_lib32.Guard.isBooleanOrUndefined(tupletRatio.showRatio)
+      import_ts_utils_lib33.Guard.isFunction(tupletBuilder),
+      (0, import_theory13.isTupletRatio)(tupletRatio) && import_ts_utils_lib33.Guard.isBooleanOrUndefined(tupletRatio.showRatio)
     );
     let tupletSymbols = [];
     const helper = {
       addNote: (note, noteLength, noteOptions) => {
         setAssertFunction("addTuplet => addNote", note, noteLength, noteOptions);
         assertArg(
-          note instanceof import_theory13.Note || import_ts_utils_lib32.Guard.isNonEmptyString(note) || import_ts_utils_lib32.Guard.isArray(note) && note.every((note2) => note2 instanceof import_theory13.Note || import_ts_utils_lib32.Guard.isNonEmptyString(note2)),
+          note instanceof import_theory13.Note || import_ts_utils_lib33.Guard.isNonEmptyString(note) || import_ts_utils_lib33.Guard.isArray(note) && note.every((note2) => note2 instanceof import_theory13.Note || import_ts_utils_lib33.Guard.isNonEmptyString(note2)),
           (0, import_theory13.isNoteLength)(noteLength)
         );
         noteOptions != null ? noteOptions : noteOptions = {};
         delete noteOptions.triplet;
         assertNoteOptions(noteOptions);
-        if (import_ts_utils_lib32.Guard.isArray(note)) {
+        if (import_ts_utils_lib33.Guard.isArray(note)) {
           let string = noteOptions.string;
           note.forEach((note2, noteId) => {
-            noteOptions.string = import_ts_utils_lib32.Guard.isArray(string) ? string[noteId] : string;
+            noteOptions.string = import_ts_utils_lib33.Guard.isArray(string) ? string[noteId] : string;
             let s = this.getMeasure().addNoteGroup(voiceId, [note2], noteLength, noteOptions, tupletRatio);
             tupletSymbols.push(s);
           });
@@ -8449,7 +8609,7 @@ var _DocumentBuilder = class _DocumentBuilder {
       addChord: (notes, noteLength, noteOptions) => {
         setAssertFunction("addTuplet => addChord", notes, noteLength, noteOptions);
         assertArg(
-          import_ts_utils_lib32.Guard.isNonEmptyArray(notes) && notes.every((note) => note instanceof import_theory13.Note || import_ts_utils_lib32.Guard.isNonEmptyString(note)),
+          import_ts_utils_lib33.Guard.isNonEmptyArray(notes) && notes.every((note) => note instanceof import_theory13.Note || import_ts_utils_lib33.Guard.isNonEmptyString(note)),
           (0, import_theory13.isNoteLength)(noteLength)
         );
         noteOptions != null ? noteOptions : noteOptions = {};
@@ -8479,8 +8639,8 @@ var _DocumentBuilder = class _DocumentBuilder {
     assertStaffTabOrGRoups(staffTabOrGroups);
     assertArg(
       isVerseNumber(verse),
-      import_ts_utils_lib32.Guard.isEnumValue(lyricsLength, import_theory13.NoteLength),
-      import_ts_utils_lib32.Guard.isString(lyricsText) || import_ts_utils_lib32.Guard.isArray(lyricsText) && lyricsText.every((text) => import_ts_utils_lib32.Guard.isString(text))
+      import_ts_utils_lib33.Guard.isEnumValue(lyricsLength, import_theory13.NoteLength),
+      import_ts_utils_lib33.Guard.isString(lyricsText) || import_ts_utils_lib33.Guard.isArray(lyricsText) && lyricsText.every((text) => import_ts_utils_lib33.Guard.isString(text))
     );
     lyricsOptions != null ? lyricsOptions : lyricsOptions = {};
     assertLyricsOptions(lyricsOptions);
@@ -8489,7 +8649,7 @@ var _DocumentBuilder = class _DocumentBuilder {
     } else {
       (_a = lyricsOptions.align) != null ? _a : lyricsOptions.align = this.currentLyricsAlign;
     }
-    if (import_ts_utils_lib32.Guard.isArray(lyricsText)) {
+    if (import_ts_utils_lib33.Guard.isArray(lyricsText)) {
       lyricsText.forEach((text) => this.getMeasure().addLyrics(staffTabOrGroups, verse, lyricsLength, text, lyricsOptions));
     } else {
       this.getMeasure().addLyrics(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions);
@@ -8523,7 +8683,7 @@ var _DocumentBuilder = class _DocumentBuilder {
   }
   addFermataInternal(staffTabOrGroups, fermata) {
     assertStaffTabOrGRoups(staffTabOrGroups);
-    assertArg(import_ts_utils_lib32.Guard.isEnumValue(fermata, Fermata));
+    assertArg(import_ts_utils_lib33.Guard.isEnumValue(fermata, Fermata));
     this.getMeasure().addFermata(staffTabOrGroups, fermata);
     return this;
   }
@@ -8549,7 +8709,7 @@ var _DocumentBuilder = class _DocumentBuilder {
   addNavigationInternal(staffTabOrGroups, navigation, ...args) {
     assertStaffTabOrGRoups(staffTabOrGroups);
     assertArg(
-      import_ts_utils_lib32.Guard.isStrictEqual(navigation, "endRepeat" /* EndRepeat */) && import_ts_utils_lib32.Guard.isStrictEqual(args.length, 1) || import_ts_utils_lib32.Guard.isStrictEqual(navigation, "ending" /* Ending */) && import_ts_utils_lib32.Guard.isIntegerGte(args.length, 1) && args.every((passage) => import_ts_utils_lib32.Guard.isIntegerGte(passage, 1)) || import_ts_utils_lib32.Guard.isEnumValue(navigation, Navigation) && import_ts_utils_lib32.Guard.isEmptyArray(args)
+      import_ts_utils_lib33.Guard.isStrictEqual(navigation, "endRepeat" /* EndRepeat */) && import_ts_utils_lib33.Guard.isStrictEqual(args.length, 1) || import_ts_utils_lib33.Guard.isStrictEqual(navigation, "ending" /* Ending */) && import_ts_utils_lib33.Guard.isIntegerGte(args.length, 1) && args.every((passage) => import_ts_utils_lib33.Guard.isIntegerGte(passage, 1)) || import_ts_utils_lib33.Guard.isEnumValue(navigation, Navigation) && import_ts_utils_lib33.Guard.isEmptyArray(args)
     );
     this.getMeasure().addNavigation(staffTabOrGroups, navigation, ...args);
     return this;
@@ -8569,8 +8729,8 @@ var _DocumentBuilder = class _DocumentBuilder {
     }
     assertStaffTabOrGRoups(staffTabOrGroups);
     assertArg(
-      import_ts_utils_lib32.Guard.isEnumValue(annotation, Annotation),
-      import_ts_utils_lib32.Guard.isNonEmptyString(text)
+      import_ts_utils_lib33.Guard.isEnumValue(annotation, Annotation),
+      import_ts_utils_lib33.Guard.isNonEmptyString(text)
     );
     this.getMeasure().addAnnotation(staffTabOrGroups, annotation, text);
     return this;
@@ -8594,8 +8754,8 @@ var _DocumentBuilder = class _DocumentBuilder {
   addLabelInternal(staffTabOrGroups, label, text) {
     assertStaffTabOrGRoups(staffTabOrGroups);
     assertArg(
-      import_ts_utils_lib32.Guard.isEnumValue(label, Label),
-      import_ts_utils_lib32.Guard.isNonEmptyString(text)
+      import_ts_utils_lib33.Guard.isEnumValue(label, Label),
+      import_ts_utils_lib33.Guard.isNonEmptyString(text)
     );
     this.getMeasure().addLabel(staffTabOrGroups, label, text);
     return this;
@@ -8623,21 +8783,21 @@ var _DocumentBuilder = class _DocumentBuilder {
   }
   addConnective(connective, ...args) {
     setAssertFunction("addConnective", connective, ...args);
-    assertArg(import_ts_utils_lib32.Guard.isEnumValue(connective, Connective));
+    assertArg(import_ts_utils_lib33.Guard.isEnumValue(connective, Connective));
     if (connective === "tie" /* Tie */) {
-      assertArg(import_ts_utils_lib32.Guard.isIntegerOrUndefined(args[0]) || import_ts_utils_lib32.Guard.isEnumValue(args[0], TieType));
-      assertArg(import_ts_utils_lib32.Guard.isEnumValueOrUndefined(args[1], NoteAnchor));
+      assertArg(import_ts_utils_lib33.Guard.isIntegerOrUndefined(args[0]) || import_ts_utils_lib33.Guard.isEnumValue(args[0], TieType));
+      assertArg(import_ts_utils_lib33.Guard.isEnumValueOrUndefined(args[1], NoteAnchor));
       let tieSpan = args[0];
       let noteAnchor = args[1];
       this.getMeasure().addConnective(connective, tieSpan, noteAnchor);
     } else if (connective === "slur" /* Slur */) {
-      assertArg(import_ts_utils_lib32.Guard.isIntegerOrUndefined(args[0]));
-      assertArg(import_ts_utils_lib32.Guard.isEnumValueOrUndefined(args[1], NoteAnchor));
+      assertArg(import_ts_utils_lib33.Guard.isIntegerOrUndefined(args[0]));
+      assertArg(import_ts_utils_lib33.Guard.isEnumValueOrUndefined(args[1], NoteAnchor));
       let slurSpan = args[0];
       let noteAnchor = args[1];
       this.getMeasure().addConnective(connective, slurSpan, noteAnchor);
     } else if (connective === "slide" /* Slide */) {
-      assertArg(import_ts_utils_lib32.Guard.isEnumValueOrUndefined(args[0], NoteAnchor));
+      assertArg(import_ts_utils_lib33.Guard.isEnumValueOrUndefined(args[0], NoteAnchor));
       let noteAnchor = args[0];
       this.getMeasure().addConnective(connective, noteAnchor);
     }
@@ -8657,20 +8817,20 @@ var _DocumentBuilder = class _DocumentBuilder {
    */
   addExtension(extensionBuilder) {
     setAssertFunction("addExtension");
-    assertArgMsg(import_ts_utils_lib32.Guard.isFunctionOrUndefined(extensionBuilder), "addExtension() has new usage, e.g. addExtension(ext => ext.measures(2)).");
+    assertArgMsg(import_ts_utils_lib33.Guard.isFunctionOrUndefined(extensionBuilder), "addExtension() has new usage, e.g. addExtension(ext => ext.measures(2)).");
     let ticks = 0;
     let visible = true;
     const helper = {
       notes: (noteLength, noteCount) => {
         setAssertFunction("addExtension.notes", noteLength, noteCount);
         assertArg((0, import_theory13.isNoteLength)(noteLength));
-        assertArg(import_ts_utils_lib32.Guard.isUndefined(noteCount) || import_ts_utils_lib32.Guard.isNumber(noteCount) && noteCount >= 0);
+        assertArg(import_ts_utils_lib33.Guard.isUndefined(noteCount) || import_ts_utils_lib33.Guard.isNumber(noteCount) && noteCount >= 0);
         ticks += import_theory13.RhythmProps.get(noteLength).ticks * (noteCount != null ? noteCount : 1);
         return helper;
       },
       measures: (measureCount) => {
         setAssertFunction("addExtension.measures", measureCount);
-        assertArg(import_ts_utils_lib32.Guard.isNumber(measureCount) && measureCount >= 1);
+        assertArg(import_ts_utils_lib33.Guard.isNumber(measureCount) && measureCount >= 1);
         ticks += this.getMeasure().getMeasureTicks() * measureCount;
         return helper;
       },
@@ -8703,9 +8863,9 @@ var _DocumentBuilder = class _DocumentBuilder {
   addStaffGroup(groupName, staffsTabsAndGroups, verticalPosition = "auto" /* Auto */) {
     setAssertFunction("addStaffGroup", groupName, staffsTabsAndGroups, verticalPosition);
     assertArg(
-      import_ts_utils_lib32.Guard.isNonEmptyString(groupName),
-      import_ts_utils_lib32.Guard.isNonEmptyString(staffsTabsAndGroups) || import_ts_utils_lib32.Guard.isIntegerGte(staffsTabsAndGroups, 0) || import_ts_utils_lib32.Guard.isNonEmptyArray(staffsTabsAndGroups) && staffsTabsAndGroups.every((line) => import_ts_utils_lib32.Guard.isNonEmptyString(line) || import_ts_utils_lib32.Guard.isIntegerGte(line, 0)),
-      import_ts_utils_lib32.Guard.isEnumValue(verticalPosition, VerticalPosition)
+      import_ts_utils_lib33.Guard.isNonEmptyString(groupName),
+      import_ts_utils_lib33.Guard.isNonEmptyString(staffsTabsAndGroups) || import_ts_utils_lib33.Guard.isIntegerGte(staffsTabsAndGroups, 0) || import_ts_utils_lib33.Guard.isNonEmptyArray(staffsTabsAndGroups) && staffsTabsAndGroups.every((line) => import_ts_utils_lib33.Guard.isNonEmptyString(line) || import_ts_utils_lib33.Guard.isIntegerGte(line, 0)),
+      import_ts_utils_lib33.Guard.isEnumValue(verticalPosition, VerticalPosition)
     );
     this.doc.addStaffGroup(groupName, staffsTabsAndGroups, verticalPosition);
     return this;
@@ -8745,7 +8905,7 @@ var _DocumentBuilder = class _DocumentBuilder {
    */
   completeRests(voiceId) {
     setAssertFunction("completeRests", voiceId);
-    assertArg(import_ts_utils_lib32.Guard.isUndefined(voiceId) || isVoiceId(voiceId) || import_ts_utils_lib32.Guard.isArray(voiceId) && voiceId.every((id) => isVoiceId(id)));
+    assertArg(import_ts_utils_lib33.Guard.isUndefined(voiceId) || isVoiceId(voiceId) || import_ts_utils_lib33.Guard.isArray(voiceId) && voiceId.every((id) => isVoiceId(id)));
     this.getMeasure().completeRests(voiceId);
     return this;
   }
@@ -8759,8 +8919,8 @@ var _DocumentBuilder = class _DocumentBuilder {
   addScaleArpeggio(scale, bottomNote, numOctaves) {
     setAssertFunction("addScaleArpeggio", scale, bottomNote, numOctaves);
     assertArg(
-      import_ts_utils_lib32.Guard.isNonEmptyString(bottomNote),
-      import_ts_utils_lib32.Guard.isIntegerGte(numOctaves, 1)
+      import_ts_utils_lib33.Guard.isNonEmptyString(bottomNote),
+      import_ts_utils_lib33.Guard.isIntegerGte(numOctaves, 1)
     );
     let ts = this.getMeasure().getTimeSignature();
     let notes = scale.getScaleNotes(bottomNote, numOctaves);
@@ -8847,10 +9007,10 @@ var ScoreObjectEvent = class extends ScoreEvent {
 
 // src/score/pub/music-interface.ts
 var Audio2 = __toESM(require("@tspro/web-music-score/audio"));
-var import_ts_utils_lib34 = require("@tspro/ts-utils-lib");
+var import_ts_utils_lib35 = require("@tspro/ts-utils-lib");
 
 // src/score/pub/music-objects.ts
-var import_ts_utils_lib33 = require("@tspro/ts-utils-lib");
+var import_ts_utils_lib34 = require("@tspro/ts-utils-lib");
 var import_core20 = require("@tspro/web-music-score/core");
 function assertArg2(condition, argName, argValue) {
   if (!condition) {
@@ -9031,7 +9191,7 @@ var _MDocument = class _MDocument extends MusicInterface5 {
    * @returns - Player instance.
    */
   play(playStateChangeListener) {
-    assertArg2(import_ts_utils_lib33.Guard.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
+    assertArg2(import_ts_utils_lib34.Guard.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
     return new MPlayer(this, playStateChangeListener).play();
   }
 };
@@ -9061,7 +9221,7 @@ var _MEnding = class _MEnding extends MusicInterface5 {
    * @returns - Boolean whether this ending has asked passage number.
    */
   hasPassage(passage) {
-    assertArg2(import_ts_utils_lib33.Guard.isIntegerGte(passage, 1), "passage", passage);
+    assertArg2(import_ts_utils_lib34.Guard.isIntegerGte(passage, 1), "passage", passage);
     return this.obj.hasPassage(passage);
   }
 };
@@ -9194,10 +9354,10 @@ var _MBarLineLeft = class _MBarLineLeft extends MusicInterface5 {
 /** Object name. */
 __publicField(_MBarLineLeft, "Name", "BarLineLeft");
 var MBarLineLeft = _MBarLineLeft;
-var _MStaffTabBarLine = class _MStaffTabBarLine extends MusicInterface5 {
+var _MStaffBarLine = class _MStaffBarLine extends MusicInterface5 {
   /** @internal */
   constructor(obj) {
-    super(_MStaffTabBarLine.Name);
+    super(_MStaffBarLine.Name);
     this.obj = obj;
   }
   /** @internal */
@@ -9213,7 +9373,7 @@ var _MStaffTabBarLine = class _MStaffTabBarLine extends MusicInterface5 {
     if (barLine instanceof ObjBarLineLeft || barLine instanceof ObjBarLineRight) {
       return barLine.getMusicInterface();
     } else {
-      throw new import_core20.MusicError(import_core20.MusicErrorType.Score, `Bar line not let nor right.`);
+      throw new import_core20.MusicError(import_core20.MusicErrorType.Score, `Bar line not left nor right.`);
     }
   }
   /**
@@ -9225,8 +9385,8 @@ var _MStaffTabBarLine = class _MStaffTabBarLine extends MusicInterface5 {
   }
 };
 /** Object name. */
-__publicField(_MStaffTabBarLine, "Name", "StaffTabBarLine");
-var MStaffTabBarLine = _MStaffTabBarLine;
+__publicField(_MStaffBarLine, "Name", "StaffBarLine");
+var MStaffBarLine = _MStaffBarLine;
 var _MNoteGroup = class _MNoteGroup extends MusicInterface5 {
   /** @internal */
   constructor(obj) {
@@ -9507,6 +9667,27 @@ var _MScoreRow = class _MScoreRow extends MusicInterface5 {
 /** Object name. */
 __publicField(_MScoreRow, "Name", "ScoreRow");
 var MScoreRow = _MScoreRow;
+var _MScoreRowGroup = class _MScoreRowGroup extends MusicInterface5 {
+  /** @internal */
+  constructor(obj) {
+    super(_MScoreRowGroup.Name);
+    this.obj = obj;
+  }
+  /** @internal */
+  getMusicObject() {
+    return this.obj;
+  }
+  /**
+   * Get instrument name.
+   * @returns - instrument name.
+   */
+  getInstrument() {
+    return this.obj.instrument;
+  }
+};
+/** Object name. */
+__publicField(_MScoreRowGroup, "Name", "ScoreRowGroup");
+var MScoreRowGroup = _MScoreRowGroup;
 var _MStaff = class _MStaff extends MusicInterface5 {
   /** @internal */
   constructor(obj) {
@@ -9748,7 +9929,7 @@ var _MPlayer = class _MPlayer {
   constructor(doc, playStateChangeListener) {
     __publicField(this, "player");
     assertArg3(doc instanceof MDocument2, "doc", doc);
-    assertArg3(import_ts_utils_lib34.Guard.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
+    assertArg3(import_ts_utils_lib35.Guard.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
     this.player = new Player();
     this.player.setDocument(doc.getMusicObject());
     this.player.setCursorPositionChangeListener((cursorRect) => {
@@ -9792,7 +9973,7 @@ var _MPlayer = class _MPlayer {
     return this;
   }
 };
-__publicField(_MPlayer, "currentlyPlaying", new import_ts_utils_lib34.ValueSet());
+__publicField(_MPlayer, "currentlyPlaying", new import_ts_utils_lib35.ValueSet());
 var MPlayer = _MPlayer;
 var MRenderContext2 = class {
   /**
@@ -9808,7 +9989,7 @@ var MRenderContext2 = class {
    * @returns - This render context instance.
    */
   setDocument(doc) {
-    assertArg3(import_ts_utils_lib34.Guard.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
+    assertArg3(import_ts_utils_lib35.Guard.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
     this.ctx.setDocument(doc);
     return this;
   }
@@ -9818,7 +9999,7 @@ var MRenderContext2 = class {
    * @returns - This render context instance.
    */
   setCanvas(canvas) {
-    canvas = require_t(import_ts_utils_lib34.Utils.Dom.getCanvas(canvas), typeof canvas === "string" ? "Cannot set render canvas because invalid canvas id: " + canvas : "Cannot set render canvas because given canvas is undefined.");
+    canvas = require_t(import_ts_utils_lib35.Utils.Dom.getCanvas(canvas), typeof canvas === "string" ? "Cannot set render canvas because invalid canvas id: " + canvas : "Cannot set render canvas because given canvas is undefined.");
     this.ctx.setCanvas(canvas);
     return this;
   }
@@ -9827,7 +10008,7 @@ var MRenderContext2 = class {
    * @param scoreEventListener - Score event listener.
    */
   setScoreEventListener(scoreEventListener) {
-    assertArg3(import_ts_utils_lib34.Guard.isFunctionOrUndefined(scoreEventListener), "scoreEventListener", scoreEventListener);
+    assertArg3(import_ts_utils_lib35.Guard.isFunctionOrUndefined(scoreEventListener), "scoreEventListener", scoreEventListener);
     this.ctx.setScoreEventListener(scoreEventListener);
   }
   /**
@@ -9902,7 +10083,7 @@ var _MPlaybackButtons = class _MPlaybackButtons {
    * @returns 
    */
   setDocument(doc) {
-    assertArg3(import_ts_utils_lib34.Guard.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
+    assertArg3(import_ts_utils_lib35.Guard.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
     this.onStop();
     if (doc) {
       this.player = new MPlayer(doc, (playState) => {
@@ -9946,9 +10127,9 @@ var _MPlaybackButtons = class _MPlaybackButtons {
    * @returns - This playback buttons class instance.
    */
   setPlayButton(btn, btnLabel) {
-    assertArg3(import_ts_utils_lib34.Guard.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(import_ts_utils_lib35.Guard.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.playButton, this.onPlay);
-    this.playButton = require_t(import_ts_utils_lib34.Utils.Dom.getButton(btn), "Play button required!");
+    this.playButton = require_t(import_ts_utils_lib35.Utils.Dom.getButton(btn), "Play button required!");
     this.playLabel = btnLabel != null ? btnLabel : "Play";
     _MPlaybackButtons.removeOnClickListeners(this.playButton, "all");
     _MPlaybackButtons.addOnClickListener(this.playButton, this.onPlay);
@@ -9962,9 +10143,9 @@ var _MPlaybackButtons = class _MPlaybackButtons {
    * @returns - This playback buttons class instance.
    */
   setStopButton(btn, btnLabel) {
-    assertArg3(import_ts_utils_lib34.Guard.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(import_ts_utils_lib35.Guard.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.stopButton, this.onStop);
-    this.stopButton = require_t(import_ts_utils_lib34.Utils.Dom.getButton(btn), "Stop button required!");
+    this.stopButton = require_t(import_ts_utils_lib35.Utils.Dom.getButton(btn), "Stop button required!");
     this.stopLabel = btnLabel != null ? btnLabel : "Stop";
     _MPlaybackButtons.removeOnClickListeners(this.stopButton, "all");
     _MPlaybackButtons.addOnClickListener(this.stopButton, this.onStop);
@@ -9979,10 +10160,10 @@ var _MPlaybackButtons = class _MPlaybackButtons {
    * @returns - This playback buttons class instance.
    */
   setPlayStopButton(btn, playLabel, stopLabel) {
-    assertArg3(import_ts_utils_lib34.Guard.isStringOrUndefined(playLabel), "playLabel", playLabel);
-    assertArg3(import_ts_utils_lib34.Guard.isStringOrUndefined(stopLabel), "stopLabel", stopLabel);
+    assertArg3(import_ts_utils_lib35.Guard.isStringOrUndefined(playLabel), "playLabel", playLabel);
+    assertArg3(import_ts_utils_lib35.Guard.isStringOrUndefined(stopLabel), "stopLabel", stopLabel);
     _MPlaybackButtons.removeOnClickListeners(this.playStopButton, this.onPlayStop);
-    this.playStopButton = require_t(import_ts_utils_lib34.Utils.Dom.getButton(btn), "Play/stop button required!");
+    this.playStopButton = require_t(import_ts_utils_lib35.Utils.Dom.getButton(btn), "Play/stop button required!");
     this.playLabel = playLabel != null ? playLabel : "Play";
     this.stopLabel = stopLabel != null ? stopLabel : "Stop";
     _MPlaybackButtons.removeOnClickListeners(this.playStopButton, "all");
@@ -9997,9 +10178,9 @@ var _MPlaybackButtons = class _MPlaybackButtons {
    * @returns - This playback buttons class instance.
    */
   setPauseButton(btn, btnLabel) {
-    assertArg3(import_ts_utils_lib34.Guard.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(import_ts_utils_lib35.Guard.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.pauseButton, this.onPause);
-    this.pauseButton = require_t(import_ts_utils_lib34.Utils.Dom.getButton(btn), "Pause button required!");
+    this.pauseButton = require_t(import_ts_utils_lib35.Utils.Dom.getButton(btn), "Pause button required!");
     this.pauseLabel = btnLabel != null ? btnLabel : "Pause";
     _MPlaybackButtons.removeOnClickListeners(this.pauseButton, "all");
     _MPlaybackButtons.addOnClickListener(this.pauseButton, this.onPause);
@@ -10020,12 +10201,12 @@ var _MPlaybackButtons = class _MPlaybackButtons {
     this.savedOnClickListeners.set(btn, curListeners);
   }
   static addOnClickListener(btn, onClickListener) {
-    assertArg3(import_ts_utils_lib34.Guard.isFunction(onClickListener), "onClick", onClickListener);
+    assertArg3(import_ts_utils_lib35.Guard.isFunction(onClickListener), "onClick", onClickListener);
     btn.addEventListener("click", onClickListener);
     this.savedOnClickListeners.getOrCreate(btn, []).push(onClickListener);
   }
 };
-__publicField(_MPlaybackButtons, "savedOnClickListeners", new import_ts_utils_lib34.UniMap());
+__publicField(_MPlaybackButtons, "savedOnClickListeners", new import_ts_utils_lib35.UniMap());
 var MPlaybackButtons = _MPlaybackButtons;
 
 // src/score/index.ts
@@ -10066,13 +10247,14 @@ var import_core22 = require("@tspro/web-music-score/core");
   MRest,
   MRhythmColumn,
   MScoreRow,
+  MScoreRowGroup,
   MSpecialText,
   MStaff,
+  MStaffBarLine,
   MStaffBeamGroup,
   MStaffNoteGroup,
   MStaffRest,
   MStaffSignature,
-  MStaffTabBarLine,
   MTab,
   MTabNoteGroup,
   MTabRhythm,