@tspro/web-music-score 3.1.0 → 3.1.1

package/dist/score/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v3.1.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v3.1.1 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -5111,12 +5111,59 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     this.requestLayout();
     this.requestRectUpdate();
   }
-  addFermata(staffTabOrGroup, fermata) {
+  forEachStaffGroup(staffTabOrGroups, defaultVerticalPos, addFn) {
+    const lines = this.row.getNotationLines();
+    const addToStaffTabOrGroup = (staffTabOrGroup, vpos, prevGroups = []) => {
+      if (typeof staffTabOrGroup === "number") {
+        if (lines[staffTabOrGroup]) {
+          addFn(lines[staffTabOrGroup], vpos);
+        }
+      } else if (typeof staffTabOrGroup === "string" && staffTabOrGroup.length > 0) {
+        let stavesAndTabs = lines.filter((l) => l.name === staffTabOrGroup);
+        stavesAndTabs.forEach((line) => addFn(line, vpos));
+        if (stavesAndTabs.length === 0) {
+          let grp = this.doc.getStaffGroup(staffTabOrGroup);
+          if (grp && !prevGroups.includes(staffTabOrGroup)) {
+            let curGroups = [...prevGroups, staffTabOrGroup];
+            (import_ts_utils_lib8.Utils.Is.isArray(grp.staffsTabsAndGroups) ? grp.staffsTabsAndGroups : [grp.staffsTabsAndGroups]).forEach((staffTabOrGroup2) => {
+              switch (grp.verticalPosition) {
+                case 0 /* Above */:
+                  addToStaffTabOrGroup(staffTabOrGroup2, 0 /* Above */, curGroups);
+                  break;
+                case 1 /* Below */:
+                  addToStaffTabOrGroup(staffTabOrGroup2, 1 /* Below */, curGroups);
+                  break;
+                case 2 /* Both */:
+                  addToStaffTabOrGroup(staffTabOrGroup2, 0 /* Above */, curGroups);
+                  addToStaffTabOrGroup(staffTabOrGroup2, 1 /* Below */, curGroups);
+                  break;
+                case 3 /* Auto */:
+                  addToStaffTabOrGroup(staffTabOrGroup2, defaultVerticalPos, curGroups);
+                  break;
+              }
+            });
+          }
+        }
+      }
+    };
+    if (staffTabOrGroups === void 0) {
+      if (lines.length >= 2 && lines[0] instanceof ObjStaff && lines[0].staffConfig.clef === "G" /* G */ && lines[0].isGrand() && lines[1] instanceof ObjStaff && lines[1].staffConfig.clef === "F" /* F */ && lines[1].isGrand()) {
+        addToStaffTabOrGroup(defaultVerticalPos === 1 /* Below */ ? 1 : 0, defaultVerticalPos);
+      } else {
+        addToStaffTabOrGroup(0, defaultVerticalPos);
+      }
+    } else if (import_ts_utils_lib8.Utils.Is.isArray(staffTabOrGroups)) {
+      staffTabOrGroups.forEach((staffTabOrGroup) => addToStaffTabOrGroup(staffTabOrGroup, defaultVerticalPos));
+    } else {
+      addToStaffTabOrGroup(staffTabOrGroups, defaultVerticalPos);
+    }
+  }
+  addFermata(staffTabOrGroups, fermata) {
     let anchor = fermata === 1 /* AtMeasureEnd */ ? this.barLineRight : this.lastAddedRhythmColumn;
     if (!anchor) {
       throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add Fermata because anchor is undefined.");
     }
-    this.forEachStaffGroup(staffTabOrGroup, 0 /* Above */, (line, vpos) => {
+    this.forEachStaffGroup(staffTabOrGroups, 0 /* Above */, (line, vpos) => {
       this.addLayoutObject(new ObjFermata(anchor, vpos), line, 0 /* Fermata */, vpos);
     });
     this.disableExtension();
@@ -5125,7 +5172,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   hasFermata(anchor) {
     return this.layoutObjects.some((layoutObj) => layoutObj.musicObj instanceof ObjFermata && layoutObj.anchor === anchor);
   }
-  addNavigation(staffTabOrGroup, navigation, ...args) {
+  addNavigation(staffTabOrGroups, navigation, ...args) {
     let addLayoutObjectProps = void 0;
     switch (navigation) {
       case 10 /* Ending */:
@@ -5151,7 +5198,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
           layoutGroupId: 2 /* Navigation */,
           defaultVerticalPos: 0 /* Above */
         };
-        this.addNavigation(staffTabOrGroup, 9 /* EndRepeat */);
+        this.addNavigation(staffTabOrGroups, 9 /* EndRepeat */);
         this.endSong();
         break;
       }
@@ -5204,7 +5251,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
         break;
     }
     if (addLayoutObjectProps) {
-      this.forEachStaffGroup(staffTabOrGroup, addLayoutObjectProps.defaultVerticalPos, (line, vpos) => {
+      this.forEachStaffGroup(staffTabOrGroups, addLayoutObjectProps.defaultVerticalPos, (line, vpos) => {
         this.addLayoutObject(addLayoutObjectProps.createObj(), line, addLayoutObjectProps.layoutGroupId, vpos);
       });
     }
@@ -5214,135 +5261,108 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   hasNavigation(n) {
     return this.navigationSet.has(n);
   }
-  getEnding() {
-    return this.layoutObjects.map((layoutObj) => layoutObj.musicObj).find((musicObj) => musicObj instanceof ObjEnding);
-  }
-  getEndRepeatPlayCount() {
-    return this.endRepeatPlayCount;
-  }
-  addConnective(connective, ...args) {
-    let anchor = this.lastAddedRhythmSymbol;
-    if (!(anchor instanceof ObjNoteGroup)) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Connective can be added to note group only.");
-    }
-    if (connective === 0 /* Tie */) {
-      let tieSpan = import_ts_utils_lib8.Utils.Is.isInteger(args[0]) || import_ts_utils_lib8.Utils.Is.isEnumValue(args[0], TieType) ? args[0] : 2;
-      let noteAnchor = import_ts_utils_lib8.Utils.Is.isEnumValue(args[1], NoteAnchor) ? args[1] : 0 /* Auto */;
-      anchor.startConnective(new ConnectiveProps(0 /* Tie */, tieSpan, noteAnchor, anchor));
-    } else if (connective === 1 /* Slur */) {
-      let slurSpan = import_ts_utils_lib8.Utils.Is.isInteger(args[0]) ? args[0] : 2;
-      let noteAnchor = import_ts_utils_lib8.Utils.Is.isEnumValue(args[1], NoteAnchor) ? args[1] : 0 /* Auto */;
-      anchor.startConnective(new ConnectiveProps(1 /* Slur */, slurSpan, noteAnchor, anchor));
-    } else if (connective === 2 /* Slide */) {
-      let noteAnchor = import_ts_utils_lib8.Utils.Is.isEnumValue(args[0], NoteAnchor) ? args[0] : 0 /* Auto */;
-      anchor.startConnective(new ConnectiveProps(2 /* Slide */, 2, noteAnchor, anchor));
-    }
-  }
-  forEachStaffGroup(staffTabOrGroup, defaultVerticalPos, add) {
-    const lines = this.row.getNotationLines();
-    const performAdd = (lineId, vpos, depth) => {
-      if (depth >= 5) {
-        return;
-      }
-      let success = false;
-      if (typeof lineId === "number") {
-        if (lines[lineId]) {
-          add(lines[lineId], vpos);
-          success = true;
-        }
-      } else if (typeof lineId === "string" && lineId.length > 0) {
-        lines.filter((l) => l.name === lineId).forEach((line) => {
-          add(line, vpos);
-          success = true;
-        });
-      }
-      if (typeof lineId === "string" && !success) {
-        let grp = this.doc.getStaffGroup(lineId);
-        if (grp) {
-          (import_ts_utils_lib8.Utils.Is.isArray(grp.staffsTabsAndGroups) ? grp.staffsTabsAndGroups : [grp.staffsTabsAndGroups]).forEach((lineId2) => {
-            switch (grp.verticalPosition) {
-              case 0 /* Above */:
-                performAdd(lineId2, 0 /* Above */, depth + 1);
-                break;
-              case 1 /* Below */:
-                performAdd(lineId2, 1 /* Below */, depth + 1);
-                break;
-              case 2 /* Both */:
-                performAdd(lineId2, 0 /* Above */, depth + 1);
-                performAdd(lineId2, 1 /* Below */, depth + 1);
-                break;
-              case 3 /* Auto */:
-                performAdd(lineId2, defaultVerticalPos, depth + 1);
-                break;
-            }
-          });
-        }
-      }
-    };
-    if (staffTabOrGroup === void 0) {
-      if (lines.length >= 2 && lines[0] instanceof ObjStaff && lines[0].staffConfig.clef === "G" /* G */ && lines[0].isGrand() && lines[1] instanceof ObjStaff && lines[1].staffConfig.clef === "F" /* F */ && lines[1].isGrand()) {
-        performAdd(defaultVerticalPos === 1 /* Below */ ? 1 : 0, defaultVerticalPos, 0);
-      } else {
-        performAdd(0, defaultVerticalPos, 0);
-      }
-    } else {
-      performAdd(staffTabOrGroup, defaultVerticalPos, 0);
-    }
-  }
-  addLabel(staffTabOrGroup, label, text) {
+  addAnnotation(staffTabOrGroups, annotation, text) {
     let anchor = this.lastAddedRhythmColumn;
     if (!anchor) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add label because anchor is undefined.");
+      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add annotation because anchor is undefined.");
     } else if (text.length === 0) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add label because label text is empty.");
+      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add annotation because annotation text is empty.");
     }
     let textProps = { text };
     let layoutGroupId;
     let defaultVerticalPos;
-    switch (label) {
-      case 0 /* Note */:
-        layoutGroupId = 1 /* NoteLabel */;
-        defaultVerticalPos = 1 /* Below */;
+    switch (annotation) {
+      case 0 /* Dynamics */:
+        layoutGroupId = 5 /* DynamicsAnnotation */;
+        defaultVerticalPos = 0 /* Above */;
+        textProps.italic = true;
         break;
-      case 1 /* Chord */:
-        layoutGroupId = 6 /* ChordLabel */;
+      case 1 /* Tempo */:
+        layoutGroupId = 4 /* TempoAnnotation */;
         defaultVerticalPos = 0 /* Above */;
+        textProps.italic = true;
         break;
     }
-    this.forEachStaffGroup(staffTabOrGroup, defaultVerticalPos, (line, vpos) => {
+    this.forEachStaffGroup(staffTabOrGroups, defaultVerticalPos, (line, vpos) => {
       let textObj = new ObjText(anchor, textProps, 0.5, 1);
       this.addLayoutObject(textObj, line, layoutGroupId, vpos);
       this.enableExtension(textObj);
     });
   }
-  addAnnotation(staffTabOrGroup, annotation, text) {
+  addLabel(staffTabOrGroups, label, text) {
     let anchor = this.lastAddedRhythmColumn;
     if (!anchor) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add annotation because anchor is undefined.");
+      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add label because anchor is undefined.");
     } else if (text.length === 0) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add annotation because annotation text is empty.");
+      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add label because label text is empty.");
     }
     let textProps = { text };
     let layoutGroupId;
     let defaultVerticalPos;
-    switch (annotation) {
-      case 0 /* Dynamics */:
-        layoutGroupId = 5 /* DynamicsAnnotation */;
-        defaultVerticalPos = 0 /* Above */;
-        textProps.italic = true;
+    switch (label) {
+      case 0 /* Note */:
+        layoutGroupId = 1 /* NoteLabel */;
+        defaultVerticalPos = 1 /* Below */;
         break;
-      case 1 /* Tempo */:
-        layoutGroupId = 4 /* TempoAnnotation */;
+      case 1 /* Chord */:
+        layoutGroupId = 6 /* ChordLabel */;
         defaultVerticalPos = 0 /* Above */;
-        textProps.italic = true;
         break;
     }
-    this.forEachStaffGroup(staffTabOrGroup, defaultVerticalPos, (line, vpos) => {
+    this.forEachStaffGroup(staffTabOrGroups, defaultVerticalPos, (line, vpos) => {
       let textObj = new ObjText(anchor, textProps, 0.5, 1);
       this.addLayoutObject(textObj, line, layoutGroupId, vpos);
       this.enableExtension(textObj);
     });
   }
+  addConnective(connective, ...args) {
+    let anchor = this.lastAddedRhythmSymbol;
+    if (!(anchor instanceof ObjNoteGroup)) {
+      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Connective can be added to note group only.");
+    }
+    if (connective === 0 /* Tie */) {
+      let tieSpan = import_ts_utils_lib8.Utils.Is.isInteger(args[0]) || import_ts_utils_lib8.Utils.Is.isEnumValue(args[0], TieType) ? args[0] : 2;
+      let noteAnchor = import_ts_utils_lib8.Utils.Is.isEnumValue(args[1], NoteAnchor) ? args[1] : 0 /* Auto */;
+      anchor.startConnective(new ConnectiveProps(0 /* Tie */, tieSpan, noteAnchor, anchor));
+    } else if (connective === 1 /* Slur */) {
+      let slurSpan = import_ts_utils_lib8.Utils.Is.isInteger(args[0]) ? args[0] : 2;
+      let noteAnchor = import_ts_utils_lib8.Utils.Is.isEnumValue(args[1], NoteAnchor) ? args[1] : 0 /* Auto */;
+      anchor.startConnective(new ConnectiveProps(1 /* Slur */, slurSpan, noteAnchor, anchor));
+    } else if (connective === 2 /* Slide */) {
+      let noteAnchor = import_ts_utils_lib8.Utils.Is.isEnumValue(args[0], NoteAnchor) ? args[0] : 0 /* Auto */;
+      anchor.startConnective(new ConnectiveProps(2 /* Slide */, 2, noteAnchor, anchor));
+    }
+  }
+  addExtension(extensionLength, extensionVisible) {
+    this.addExtensionToMusicObjects.forEach((musicObj) => {
+      let anchor = musicObj.getParent();
+      if (musicObj instanceof ObjText && anchor instanceof ObjRhythmColumn) {
+        let lineStyle = "dashed";
+        let linePos = "bottom";
+        let extension = new Extension(musicObj, anchor, extensionLength, extensionVisible, lineStyle, linePos);
+        musicObj.setLink(extension);
+      } else {
+        throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add extension becaue no compatible music object to attach it to.");
+      }
+    });
+    if (this.addExtensionToMusicObjects.length === 0) {
+      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add extension because music object to attach it to is undefined.");
+    }
+    this.disableExtension();
+    this.requestLayout();
+  }
+  enableExtension(musicObject) {
+    this.addExtensionToMusicObjects.push(musicObject);
+  }
+  disableExtension() {
+    this.addExtensionToMusicObjects = [];
+  }
+  getEnding() {
+    return this.layoutObjects.map((layoutObj) => layoutObj.musicObj).find((musicObj) => musicObj instanceof ObjEnding);
+  }
+  getEndRepeatPlayCount() {
+    return this.endRepeatPlayCount;
+  }
   endSong() {
     this.isEndSong = true;
     this.requestLayout();
@@ -5363,30 +5383,6 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     this.doc.requestNewRow();
     this.disableExtension();
   }
-  enableExtension(musicObject) {
-    this.addExtensionToMusicObjects.push(musicObject);
-  }
-  disableExtension() {
-    this.addExtensionToMusicObjects = [];
-  }
-  addExtension(extensionLength, extensionVisible) {
-    this.addExtensionToMusicObjects.forEach((musicObj) => {
-      let anchor = musicObj.getParent();
-      if (musicObj instanceof ObjText && anchor instanceof ObjRhythmColumn) {
-        let lineStyle = "dashed";
-        let linePos = "bottom";
-        let extension = new Extension(musicObj, anchor, extensionLength, extensionVisible, lineStyle, linePos);
-        musicObj.setLink(extension);
-      } else {
-        throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add extension becaue no compatible music object to attach it to.");
-      }
-    });
-    if (this.addExtensionToMusicObjects.length === 0) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add extension because music object to attach it to is undefined.");
-    }
-    this.disableExtension();
-    this.requestLayout();
-  }
   addRhythmSymbol(voiceId, symbol) {
     let { col } = symbol;
     col.setVoiceSymbol(voiceId, symbol);
@@ -7012,6 +7008,15 @@ function assertRestOptions(options) {
   assertArg(import_ts_utils_lib11.Utils.Is.isBooleanOrUndefined(options.hide), "restOptions.hide", options.hide);
   assertArg(import_ts_utils_lib11.Utils.Is.isBooleanOrUndefined(options.triplet), "restOptions.triplet", options.triplet);
 }
+function assertStaffTabOrGRoups(staffTabOrGroups) {
+  assertArg(
+    import_ts_utils_lib11.Utils.Is.isStringOrUndefined(staffTabOrGroups) || import_ts_utils_lib11.Utils.Is.isIntegerGte(staffTabOrGroups, 0) || import_ts_utils_lib11.Utils.Is.isArray(staffTabOrGroups) && staffTabOrGroups.every(
+      (staffTabOrGroup) => import_ts_utils_lib11.Utils.Is.isString(staffTabOrGroup) || import_ts_utils_lib11.Utils.Is.isIntegerGte(staffTabOrGroup, 0)
+    ),
+    "staffTabOrGroup",
+    staffTabOrGroups
+  );
+}
 var DocumentBuilder = class {
   constructor() {
     __publicField(this, "doc");
@@ -7113,63 +7118,63 @@ var DocumentBuilder = class {
     this.getMeasure().addRest(voiceId, restLength, options);
     return this;
   }
-  addFermataInternal(staffTabOrGroup, fermata) {
-    assertArg(import_ts_utils_lib11.Utils.Is.isStringOrUndefined(staffTabOrGroup) || import_ts_utils_lib11.Utils.Is.isIntegerGte(staffTabOrGroup, 0), "staffTabOrGroup", staffTabOrGroup);
+  addFermataInternal(staffTabOrGroups, fermata) {
+    assertStaffTabOrGRoups(staffTabOrGroups);
     assertArg(import_ts_utils_lib11.Utils.Is.isEnumValue(fermata, Fermata), "fermata", fermata);
-    this.getMeasure().addFermata(staffTabOrGroup, fermata);
+    this.getMeasure().addFermata(staffTabOrGroups, fermata);
     return this;
   }
   addFermata(fermata = 0 /* AtNote */) {
     return this.addFermataInternal(void 0, fermata);
   }
-  /** @param staffTabOrGroup  - staff/tab index (0=top), staff/tab name, or staff group name. */
-  addFermataTo(staffTabOrGroup, fermata = 0 /* AtNote */) {
-    return this.addFermataInternal(staffTabOrGroup, fermata);
+  /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
+  addFermataTo(staffTabOrGroups, fermata = 0 /* AtNote */) {
+    return this.addFermataInternal(staffTabOrGroups, fermata);
   }
-  addNavigationInternal(staffTabOrGroup, navigation, ...args) {
-    assertArg(import_ts_utils_lib11.Utils.Is.isStringOrUndefined(staffTabOrGroup) || import_ts_utils_lib11.Utils.Is.isIntegerGte(staffTabOrGroup, 0), "staffTabOrGroup", staffTabOrGroup);
+  addNavigationInternal(staffTabOrGroups, navigation, ...args) {
+    assertStaffTabOrGRoups(staffTabOrGroups);
     assertArg(import_ts_utils_lib11.Utils.Is.isEnumValue(navigation, Navigation), "navigation", navigation);
     if (navigation === 9 /* EndRepeat */ && args.length > 0) {
       assertArg(import_ts_utils_lib11.Utils.Is.isIntegerGte(args[0], 1), "playCount", args[0]);
     } else if (navigation === 10 /* Ending */ && args.length > 0) {
       assertArg(args.every((passage) => import_ts_utils_lib11.Utils.Is.isIntegerGte(passage, 1)), "passages", args);
     }
-    this.getMeasure().addNavigation(staffTabOrGroup, navigation, ...args);
+    this.getMeasure().addNavigation(staffTabOrGroups, navigation, ...args);
     return this;
   }
   addNavigation(navigation, ...args) {
     return this.addNavigationInternal(void 0, navigation, ...args);
   }
-  addNavigationTo(staffTabOrGroup, navigation, ...args) {
-    return this.addNavigationInternal(staffTabOrGroup, navigation, ...args);
+  addNavigationTo(staffTabOrGroups, navigation, ...args) {
+    return this.addNavigationInternal(staffTabOrGroups, navigation, ...args);
   }
-  addLabelInternal(staffTabOrGroup, label, text) {
-    assertArg(import_ts_utils_lib11.Utils.Is.isStringOrUndefined(staffTabOrGroup) || import_ts_utils_lib11.Utils.Is.isIntegerGte(staffTabOrGroup, 0), "staffTabOrGroup", staffTabOrGroup);
+  addLabelInternal(staffTabOrGroups, label, text) {
+    assertStaffTabOrGRoups(staffTabOrGroups);
     assertArg(import_ts_utils_lib11.Utils.Is.isEnumValue(label, Label), "label", label);
     assertArg(import_ts_utils_lib11.Utils.Is.isString(text), "text", text);
-    this.getMeasure().addLabel(staffTabOrGroup, label, text);
+    this.getMeasure().addLabel(staffTabOrGroups, label, text);
     return this;
   }
   addLabel(label, text) {
     return this.addLabelInternal(void 0, label, text);
   }
-  /** @param staffTabOrGroup  - staff/tab index (0=top), staff/tab name, or staff group name. */
-  addLabelTo(staffTabOrGroup, label, text) {
-    return this.addLabelInternal(staffTabOrGroup, label, text);
+  /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
+  addLabelTo(staffTabOrGroups, label, text) {
+    return this.addLabelInternal(staffTabOrGroups, label, text);
   }
-  addAnnotationInternal(staffTabOrGroup, annotation, text) {
-    assertArg(import_ts_utils_lib11.Utils.Is.isStringOrUndefined(staffTabOrGroup) || import_ts_utils_lib11.Utils.Is.isIntegerGte(staffTabOrGroup, 0), "staffTabOrGroup", staffTabOrGroup);
+  addAnnotationInternal(staffTabOrGroups, annotation, text) {
+    assertStaffTabOrGRoups(staffTabOrGroups);
     assertArg(import_ts_utils_lib11.Utils.Is.isEnumValue(annotation, Annotation), "annotation", annotation);
     assertArg(import_ts_utils_lib11.Utils.Is.isString(text), "text", text);
-    this.getMeasure().addAnnotation(staffTabOrGroup, annotation, text);
+    this.getMeasure().addAnnotation(staffTabOrGroups, annotation, text);
     return this;
   }
   addAnnotation(annotation, text) {
     return this.addAnnotationInternal(void 0, annotation, text);
   }
-  /** @param staffTabOrGroup  - staff/tab index (0=top), staff/tab name, or staff group name. */
-  addAnnotationTo(staffTabOrGroup, annotation, text) {
-    return this.addAnnotationInternal(staffTabOrGroup, annotation, text);
+  /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
+  addAnnotationTo(staffTabOrGroups, annotation, text) {
+    return this.addAnnotationInternal(staffTabOrGroups, annotation, text);
   }
   addConnective(connective, ...args) {
     assertArg(import_ts_utils_lib11.Utils.Is.isEnumValue(connective, Connective), "connective", connective);