web-music-score 6.0.0-pre.4 → 6.0.0

package/dist/score/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v6.0.0-pre.4 | (c) 2023-2025 Stefan Brockmann | MIT License | Includes: Tone.js (MIT License), Color Name to Code (MIT License) */
+/* WebMusicScore v6.0.0 | (c) 2023-2025 Stefan Brockmann | MIT License | Includes: Tone.js (MIT License), Color Name to Code (MIT License) */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -7022,17 +7022,15 @@ var _Extension = class _Extension extends MusicObjectLink {
     let range = new ExtensionRange(curColumn);
     let ticksLeft = length;
     while (true) {
-      if (ticksLeft <= 0) return range;
+      if (!curColumn || ticksLeft <= 0) return range;
       const stopObject = this.whatStopped(curColumn);
       if (stopObject !== void 0) {
         range.setStopObject(stopObject);
         return range;
       }
+      range.addColumn(curColumn);
       ticksLeft -= curColumn.getTicksToNextColumn();
       curColumn = curColumn.getNextColumn();
-      if (!curColumn) return range;
-      if (ticksLeft > 0)
-        range.addColumn(curColumn);
     }
   }
 };
@@ -7062,6 +7060,9 @@ function getNavigationString(navigation) {
       return navigation[0].toUpperCase() + navigation.substring(1);
   }
 }
+function isDynamicsText(text) {
+  return guard_exports.isEnumValue(text, DynamicsAnnotation);
+}
 function getDynamicsVolume(text) {
   if (/^(p+|f+|m|mp|mf)$/.test(text)) {
     let volume = 0.5 - utils_exports.Str.charCount(text, "p") * 0.1 + utils_exports.Str.charCount(text, "f") * 0.1;
@@ -7070,6 +7071,9 @@ function getDynamicsVolume(text) {
     return void 0;
   }
 }
+function isTempoText(text) {
+  return guard_exports.isEnumValue(text, TempoAnnotation);
+}
 function getAnnotation(text) {
   if (guard_exports.isEnumValue(text, DynamicsAnnotation)) {
     return "dynamics" /* Dynamics */;
@@ -7278,7 +7282,7 @@ var Player = class _Player {
     let volumeMap = new UniMap();
     const pushSpeed = (col, speed) => speedMap.getOrCreate(col, []).push(speed);
     const pushVolume = (col, volume) => volumeMap.getOrCreate(col, []).push(volume);
-    this.playerColumnSequence.forEach((col) => {
+    this.playerColumnSequence.forEach((col, colId) => {
       if (!(col instanceof ObjRhythmColumn)) {
         return;
       }
@@ -7289,8 +7293,8 @@ var Player = class _Player {
           curSpeed = 1;
         } else if ((vol = getDynamicsVolume(text)) !== void 0) {
           curVolume = vol;
-        } else if (layoutObj.musicObj.getLink() instanceof Extension) {
-          let extension = layoutObj.musicObj.getLink();
+        } else if (isTempoText(text) || isDynamicsText(text)) {
+          let extension = layoutObj.musicObj.getLink() instanceof Extension ? layoutObj.musicObj.getLink() : new Extension(layoutObj, col, Infinity, false, "solid", "bottom");
           const range = extension.getRange();
           const stopText = range.stopObject ? getTextContent(range.stopObject) : "";
           let totalTicks = utils_exports.Math.sum(range.columnRange.map((c) => c.getTicksToNextColumn()));
@@ -8364,6 +8368,17 @@ var ObjFermata = class extends MusicObject {
 };
 
 // src/score/engine/obj-extension-line.ts
+function getRow(obj) {
+  let o = obj;
+  while (o) {
+    if (o.row instanceof ObjScoreRow)
+      return o.row;
+    if (o.measure instanceof ObjMeasure)
+      return o.measure.row;
+    o = o.getParent();
+  }
+  return void 0;
+}
 function isExtensionStartObject(obj) {
   return obj instanceof ObjText || obj instanceof ObjSpecialText;
 }
@@ -8387,8 +8402,11 @@ var ObjExtensionLine = class extends MusicObject {
   getMusicInterface() {
     return this.mi;
   }
+  getLeftObj() {
+    return this.cols[0];
+  }
   getLineLeft(ctx) {
-    let obj = this.cols[0];
+    let obj = this.getLeftObj();
     if (isExtensionStartObject(obj))
       return obj.getRect().right + ctx.unitSize;
     if (obj instanceof ObjBarLineLeft)
@@ -8400,8 +8418,18 @@ var ObjExtensionLine = class extends MusicObject {
     }
     return obj.getRect().right;
   }
+  getRightObj() {
+    const obj = this.cols[this.cols.length - 1];
+    if (isExtensionStopObject(obj)) {
+      const objRow = getRow(obj);
+      const prevObj = this.cols[this.cols.length - 2];
+      const prevObjRow = getRow(prevObj);
+      return objRow && prevObjRow && objRow !== prevObjRow ? prevObj : obj;
+    }
+    return obj;
+  }
   getLineRight(ctx) {
-    let obj = this.cols[this.cols.length - 1];
+    let obj = this.getRightObj();
     if (isExtensionStopObject(obj))
       return obj.getRect().left - ctx.unitSize;
     if (obj instanceof ObjRhythmColumn) {
@@ -8441,7 +8469,7 @@ var ObjExtensionLine = class extends MusicObject {
     ctx.setLineDash([]);
     let tails = this.extension.getTails();
     let last = tails[tails.length - 1];
-    if (this === last && !isExtensionStopObject(this.cols[this.cols.length - 1])) {
+    if (this === last && !isExtensionStopObject(this.getRightObj())) {
       let tipH = rect.anchorY > this.line.getRect().anchorY ? -ctx.unitSize : ctx.unitSize;
       ctx.strokeLine(rect.right, rect.anchorY, rect.right, rect.anchorY + tipH);
     }
@@ -9708,7 +9736,7 @@ var ObjMeasure = class extends MusicObject {
     this.addRhythmSymbol(rest);
     return rest;
   }
-  addLyrics(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions) {
+  addLyrics(staffTabOrGroups, verse, lyricsText, lyricsLength, lyricsOptions) {
     this.forEachStaffGroup(staffTabOrGroups, 1 /* Below */, (line, vpos) => {
       var _a;
       let col = this.getRhythmColumn({ verse, line, vpos });
@@ -9968,21 +9996,22 @@ var ObjMeasure = class extends MusicObject {
   getVoiceSymbols(voiceId) {
     return this.voiceSymbols.getAll(voiceId);
   }
-  completeRests(voiceId) {
-    if (voiceId === void 0) {
+  fillWithRests(...voiceId) {
+    if (voiceId.length === 0) {
       if (this.getConsumedTicks() === 0) {
-        this.completeRests(0);
+        this.fillWithRests(0);
       } else {
-        this.completeRests(getVoiceIds().filter((id) => this.getConsumedTicks(id) > 0));
+        this.fillWithRests(...getVoiceIds().filter((id) => this.getConsumedTicks(id) > 0));
       }
       return;
-    } else if (guard_exports.isArray(voiceId)) {
-      voiceId.forEach((id) => this.completeRests(id));
+    } else if (voiceId.length > 1) {
+      voiceId.forEach((id) => this.fillWithRests(id));
       return;
     } else {
-      validateVoiceId(voiceId);
+      const id = voiceId[0];
+      validateVoiceId(id);
       let measureTicks = this.getMeasureTicks();
-      let consumedTicks = this.getConsumedTicks(voiceId);
+      let consumedTicks = this.getConsumedTicks(id);
       let remainingTicks = measureTicks - consumedTicks;
       let rests = [];
       while (remainingTicks > 0) {
@@ -9997,7 +10026,7 @@ var ObjMeasure = class extends MusicObject {
           }
         }
       }
-      rests.reverse().forEach((rest) => this.addRest(voiceId, import_theory9.NoteLengthProps.create(rest.noteLength, rest.dotCount).noteLength));
+      rests.reverse().forEach((rest) => this.addRest(id, import_theory9.NoteLengthProps.create(rest.noteLength, rest.dotCount).noteLength));
     }
   }
   requestLayout() {
@@ -11550,7 +11579,7 @@ var import_theory13 = require("web-music-score/theory");
 var import_core16 = require("web-music-score/core");
 var assertingFunction = "";
 function setAssertFunction(fnName, ...fnArgs) {
-  let argsStr = fnArgs.map((arg) => JSON.stringify(arg)).join(", ");
+  let argsStr = fnArgs.map((arg) => utils_exports.Str.stringify(arg)).join(", ");
   assertingFunction = `DocumentBuilder.${fnName}(${argsStr})`;
 }
 function assertArg(...conditions) {
@@ -11892,7 +11921,7 @@ var _DocumentBuilder = class _DocumentBuilder {
     ObjBeamGroup.createTuplet(tupletSymbols, tupletRatio);
     return this;
   }
-  addLyricsInternal(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions) {
+  addLyricsInternal(staffTabOrGroups, verse, lyricsText, lyricsLength, lyricsOptions) {
     var _a;
     assertStaffTabOrGRoups(staffTabOrGroups);
     assertArg(
@@ -11908,36 +11937,36 @@ var _DocumentBuilder = class _DocumentBuilder {
       (_a = lyricsOptions.align) != null ? _a : lyricsOptions.align = this.currentLyricsAlign;
     }
     if (guard_exports.isArray(lyricsText)) {
-      lyricsText.forEach((text) => this.getMeasure().addLyrics(staffTabOrGroups, verse, lyricsLength, text, lyricsOptions));
+      lyricsText.forEach((text) => this.getMeasure().addLyrics(staffTabOrGroups, verse, text, lyricsLength, lyricsOptions));
     } else {
-      this.getMeasure().addLyrics(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions);
+      this.getMeasure().addLyrics(staffTabOrGroups, verse, lyricsText, lyricsLength, lyricsOptions);
     }
     return this;
   }
   /**
    * Add lyrics to current measure.
    * @param verse - Verse number (e.g. 1).
-   * @param lyricsLength - Lyrics text length (e.g. "2n").
    * @param lyricsText - Lyrics text (empty space if omitted), single value or array.
+   * @param lyricsLength - Lyrics text length (e.g. "2n").
    * @param lyricsOptions - Lyrics options.
    * @returns - This document builder instance.
    */
-  addLyrics(verse, lyricsLength, lyricsText, lyricsOptions) {
+  addLyrics(verse, lyricsText, lyricsLength, lyricsOptions) {
     setAssertFunction("addLyrics", verse, lyricsLength, lyricsText, lyricsOptions);
-    return this.addLyricsInternal(void 0, verse, lyricsLength, lyricsText != null ? lyricsText : "", lyricsOptions);
+    return this.addLyricsInternal(void 0, verse, lyricsText, lyricsLength, lyricsOptions);
   }
   /**
    * Add lyrics to current measure to given staff/tab/group.
    * @param staffTabOrGroups - staff/tab index (0=top), staff/tab name, or staff group name.
    * @param verse - Verse number (e.g. 1).
-   * @param lyricsLength - Lyrics text length (e.g. "2n").
    * @param lyricsText - Lyrics text (empty space if omitted), single value or array.
+   * @param lyricsLength - Lyrics text length (e.g. "2n").
    * @param lyricsOptions - Lyrics options.
    * @returns - This document builder instance.
    */
-  addLyricsTo(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions) {
+  addLyricsTo(staffTabOrGroups, verse, lyricsText, lyricsLength, lyricsOptions) {
     setAssertFunction("addLyricsTo", verse, lyricsLength, lyricsText, lyricsOptions);
-    return this.addLyricsInternal(staffTabOrGroups, verse, lyricsLength, lyricsText != null ? lyricsText : "", lyricsOptions);
+    return this.addLyricsInternal(staffTabOrGroups, verse, lyricsText, lyricsLength, lyricsOptions);
   }
   addFermataInternal(staffTabOrGroups, fermata) {
     assertStaffTabOrGRoups(staffTabOrGroups);
@@ -12157,14 +12186,14 @@ var _DocumentBuilder = class _DocumentBuilder {
     return this;
   }
   /**
-   * Add rests to fill current measure.
+   * Fill current measure with rests.
    * @param voiceId - Voice id to add rests to. Single value, array or all if omitted.
    * @returns - This document builder instance.
    */
-  completeRests(voiceId) {
-    setAssertFunction("completeRests", voiceId);
-    assertArg(guard_exports.isUndefined(voiceId) || isVoiceId(voiceId) || guard_exports.isArray(voiceId) && voiceId.every((id) => isVoiceId(id)));
-    this.getMeasure().completeRests(voiceId);
+  fillWithRests(...voiceId) {
+    setAssertFunction("fillWithRests", ...voiceId);
+    assertArg(guard_exports.isArray(voiceId) && (voiceId.length === 0 || voiceId.every((id) => isVoiceId(id))));
+    this.getMeasure().fillWithRests(...voiceId);
     return this;
   }
   /**
@@ -12192,6 +12221,22 @@ var _DocumentBuilder = class _DocumentBuilder {
     }
     return this;
   }
+  /**
+   * Add and repeat builder section.
+   * @param times - Repeat count.
+   * @param repeatCreator - Repeat creator function.
+   * @returns - This document builder instance.
+   */
+  repeat(times, repeatCreator) {
+    setAssertFunction("repeat", repeatCreator);
+    assertArg(
+      guard_exports.isIntegerGte(times, 0),
+      guard_exports.isFunction(repeatCreator)
+    );
+    for (let i = 0; i < times; i++)
+      repeatCreator(this);
+    return this;
+  }
 };
 __publicField(_DocumentBuilder, "DefaultMeasureOptions", {});
 var DocumentBuilder = _DocumentBuilder;

package/dist/score/index.mjs

@@ -1,12 +1,12 @@
-/* WebMusicScore v6.0.0-pre.4 | (c) 2023-2025 Stefan Brockmann | MIT License | Includes: Tone.js (MIT License), Color Name to Code (MIT License) */
+/* WebMusicScore v6.0.0 | (c) 2023-2025 Stefan Brockmann | MIT License | Includes: Tone.js (MIT License), Color Name to Code (MIT License) */
 import {
   MusicError
-} from "../chunk-KFBULED3.mjs";
+} from "../chunk-422QLXBR.mjs";
 import {
   NoteLengthProps,
   RhythmProps,
   validateNoteLength
-} from "../chunk-UAVXEHYM.mjs";
+} from "../chunk-JOXUFYNU.mjs";
 import {
   AnchoredRect,
   BiMap,
@@ -20,12 +20,12 @@ import {
   device_exports,
   guard_exports,
   utils_exports
-} from "../chunk-DVKR62RS.mjs";
+} from "../chunk-7N2CWRTL.mjs";
 import {
   __publicField,
   __spreadProps,
   __spreadValues
-} from "../chunk-GNFDJFUO.mjs";
+} from "../chunk-ZAPOJP2K.mjs";
 
 // src/score/pub/types.ts
 var StaffPreset = /* @__PURE__ */ ((StaffPreset2) => {
@@ -3149,17 +3149,15 @@ var _Extension = class _Extension extends MusicObjectLink {
     let range = new ExtensionRange(curColumn);
     let ticksLeft = length;
     while (true) {
-      if (ticksLeft <= 0) return range;
+      if (!curColumn || ticksLeft <= 0) return range;
       const stopObject = this.whatStopped(curColumn);
       if (stopObject !== void 0) {
         range.setStopObject(stopObject);
         return range;
       }
+      range.addColumn(curColumn);
       ticksLeft -= curColumn.getTicksToNextColumn();
       curColumn = curColumn.getNextColumn();
-      if (!curColumn) return range;
-      if (ticksLeft > 0)
-        range.addColumn(curColumn);
     }
   }
 };
@@ -3189,6 +3187,9 @@ function getNavigationString(navigation) {
       return navigation[0].toUpperCase() + navigation.substring(1);
   }
 }
+function isDynamicsText(text) {
+  return guard_exports.isEnumValue(text, DynamicsAnnotation);
+}
 function getDynamicsVolume(text) {
   if (/^(p+|f+|m|mp|mf)$/.test(text)) {
     let volume = 0.5 - utils_exports.Str.charCount(text, "p") * 0.1 + utils_exports.Str.charCount(text, "f") * 0.1;
@@ -3197,6 +3198,9 @@ function getDynamicsVolume(text) {
     return void 0;
   }
 }
+function isTempoText(text) {
+  return guard_exports.isEnumValue(text, TempoAnnotation);
+}
 function getAnnotation(text) {
   if (guard_exports.isEnumValue(text, DynamicsAnnotation)) {
     return "dynamics" /* Dynamics */;
@@ -3405,7 +3409,7 @@ var Player = class _Player {
     let volumeMap = new UniMap();
     const pushSpeed = (col, speed) => speedMap.getOrCreate(col, []).push(speed);
     const pushVolume = (col, volume) => volumeMap.getOrCreate(col, []).push(volume);
-    this.playerColumnSequence.forEach((col) => {
+    this.playerColumnSequence.forEach((col, colId) => {
       if (!(col instanceof ObjRhythmColumn)) {
         return;
       }
@@ -3416,8 +3420,8 @@ var Player = class _Player {
           curSpeed = 1;
         } else if ((vol = getDynamicsVolume(text)) !== void 0) {
           curVolume = vol;
-        } else if (layoutObj.musicObj.getLink() instanceof Extension) {
-          let extension = layoutObj.musicObj.getLink();
+        } else if (isTempoText(text) || isDynamicsText(text)) {
+          let extension = layoutObj.musicObj.getLink() instanceof Extension ? layoutObj.musicObj.getLink() : new Extension(layoutObj, col, Infinity, false, "solid", "bottom");
           const range = extension.getRange();
           const stopText = range.stopObject ? getTextContent(range.stopObject) : "";
           let totalTicks = utils_exports.Math.sum(range.columnRange.map((c) => c.getTicksToNextColumn()));
@@ -4491,6 +4495,17 @@ var ObjFermata = class extends MusicObject {
 };
 
 // src/score/engine/obj-extension-line.ts
+function getRow(obj) {
+  let o = obj;
+  while (o) {
+    if (o.row instanceof ObjScoreRow)
+      return o.row;
+    if (o.measure instanceof ObjMeasure)
+      return o.measure.row;
+    o = o.getParent();
+  }
+  return void 0;
+}
 function isExtensionStartObject(obj) {
   return obj instanceof ObjText || obj instanceof ObjSpecialText;
 }
@@ -4514,8 +4529,11 @@ var ObjExtensionLine = class extends MusicObject {
   getMusicInterface() {
     return this.mi;
   }
+  getLeftObj() {
+    return this.cols[0];
+  }
   getLineLeft(ctx) {
-    let obj = this.cols[0];
+    let obj = this.getLeftObj();
     if (isExtensionStartObject(obj))
       return obj.getRect().right + ctx.unitSize;
     if (obj instanceof ObjBarLineLeft)
@@ -4527,8 +4545,18 @@ var ObjExtensionLine = class extends MusicObject {
     }
     return obj.getRect().right;
   }
+  getRightObj() {
+    const obj = this.cols[this.cols.length - 1];
+    if (isExtensionStopObject(obj)) {
+      const objRow = getRow(obj);
+      const prevObj = this.cols[this.cols.length - 2];
+      const prevObjRow = getRow(prevObj);
+      return objRow && prevObjRow && objRow !== prevObjRow ? prevObj : obj;
+    }
+    return obj;
+  }
   getLineRight(ctx) {
-    let obj = this.cols[this.cols.length - 1];
+    let obj = this.getRightObj();
     if (isExtensionStopObject(obj))
       return obj.getRect().left - ctx.unitSize;
     if (obj instanceof ObjRhythmColumn) {
@@ -4568,7 +4596,7 @@ var ObjExtensionLine = class extends MusicObject {
     ctx.setLineDash([]);
     let tails = this.extension.getTails();
     let last = tails[tails.length - 1];
-    if (this === last && !isExtensionStopObject(this.cols[this.cols.length - 1])) {
+    if (this === last && !isExtensionStopObject(this.getRightObj())) {
       let tipH = rect.anchorY > this.line.getRect().anchorY ? -ctx.unitSize : ctx.unitSize;
       ctx.strokeLine(rect.right, rect.anchorY, rect.right, rect.anchorY + tipH);
     }
@@ -5835,7 +5863,7 @@ var ObjMeasure = class extends MusicObject {
     this.addRhythmSymbol(rest);
     return rest;
   }
-  addLyrics(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions) {
+  addLyrics(staffTabOrGroups, verse, lyricsText, lyricsLength, lyricsOptions) {
     this.forEachStaffGroup(staffTabOrGroups, 1 /* Below */, (line, vpos) => {
       var _a;
       let col = this.getRhythmColumn({ verse, line, vpos });
@@ -6095,21 +6123,22 @@ var ObjMeasure = class extends MusicObject {
   getVoiceSymbols(voiceId) {
     return this.voiceSymbols.getAll(voiceId);
   }
-  completeRests(voiceId) {
-    if (voiceId === void 0) {
+  fillWithRests(...voiceId) {
+    if (voiceId.length === 0) {
       if (this.getConsumedTicks() === 0) {
-        this.completeRests(0);
+        this.fillWithRests(0);
       } else {
-        this.completeRests(getVoiceIds().filter((id) => this.getConsumedTicks(id) > 0));
+        this.fillWithRests(...getVoiceIds().filter((id) => this.getConsumedTicks(id) > 0));
       }
       return;
-    } else if (guard_exports.isArray(voiceId)) {
-      voiceId.forEach((id) => this.completeRests(id));
+    } else if (voiceId.length > 1) {
+      voiceId.forEach((id) => this.fillWithRests(id));
       return;
     } else {
-      validateVoiceId(voiceId);
+      const id = voiceId[0];
+      validateVoiceId(id);
       let measureTicks = this.getMeasureTicks();
-      let consumedTicks = this.getConsumedTicks(voiceId);
+      let consumedTicks = this.getConsumedTicks(id);
       let remainingTicks = measureTicks - consumedTicks;
       let rests = [];
       while (remainingTicks > 0) {
@@ -6124,7 +6153,7 @@ var ObjMeasure = class extends MusicObject {
           }
         }
       }
-      rests.reverse().forEach((rest) => this.addRest(voiceId, NoteLengthProps5.create(rest.noteLength, rest.dotCount).noteLength));
+      rests.reverse().forEach((rest) => this.addRest(id, NoteLengthProps5.create(rest.noteLength, rest.dotCount).noteLength));
     }
   }
   requestLayout() {
@@ -7677,7 +7706,7 @@ import { BeamGrouping, isNoteLength, isTupletRatio, KeySignature as KeySignature
 import { MusicError as MusicError16, MusicErrorType as MusicErrorType16 } from "web-music-score/core";
 var assertingFunction = "";
 function setAssertFunction(fnName, ...fnArgs) {
-  let argsStr = fnArgs.map((arg) => JSON.stringify(arg)).join(", ");
+  let argsStr = fnArgs.map((arg) => utils_exports.Str.stringify(arg)).join(", ");
   assertingFunction = `DocumentBuilder.${fnName}(${argsStr})`;
 }
 function assertArg(...conditions) {
@@ -8019,7 +8048,7 @@ var _DocumentBuilder = class _DocumentBuilder {
     ObjBeamGroup.createTuplet(tupletSymbols, tupletRatio);
     return this;
   }
-  addLyricsInternal(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions) {
+  addLyricsInternal(staffTabOrGroups, verse, lyricsText, lyricsLength, lyricsOptions) {
     var _a;
     assertStaffTabOrGRoups(staffTabOrGroups);
     assertArg(
@@ -8035,36 +8064,36 @@ var _DocumentBuilder = class _DocumentBuilder {
       (_a = lyricsOptions.align) != null ? _a : lyricsOptions.align = this.currentLyricsAlign;
     }
     if (guard_exports.isArray(lyricsText)) {
-      lyricsText.forEach((text) => this.getMeasure().addLyrics(staffTabOrGroups, verse, lyricsLength, text, lyricsOptions));
+      lyricsText.forEach((text) => this.getMeasure().addLyrics(staffTabOrGroups, verse, text, lyricsLength, lyricsOptions));
     } else {
-      this.getMeasure().addLyrics(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions);
+      this.getMeasure().addLyrics(staffTabOrGroups, verse, lyricsText, lyricsLength, lyricsOptions);
     }
     return this;
   }
   /**
    * Add lyrics to current measure.
    * @param verse - Verse number (e.g. 1).
-   * @param lyricsLength - Lyrics text length (e.g. "2n").
    * @param lyricsText - Lyrics text (empty space if omitted), single value or array.
+   * @param lyricsLength - Lyrics text length (e.g. "2n").
    * @param lyricsOptions - Lyrics options.
    * @returns - This document builder instance.
    */
-  addLyrics(verse, lyricsLength, lyricsText, lyricsOptions) {
+  addLyrics(verse, lyricsText, lyricsLength, lyricsOptions) {
     setAssertFunction("addLyrics", verse, lyricsLength, lyricsText, lyricsOptions);
-    return this.addLyricsInternal(void 0, verse, lyricsLength, lyricsText != null ? lyricsText : "", lyricsOptions);
+    return this.addLyricsInternal(void 0, verse, lyricsText, lyricsLength, lyricsOptions);
   }
   /**
    * Add lyrics to current measure to given staff/tab/group.
    * @param staffTabOrGroups - staff/tab index (0=top), staff/tab name, or staff group name.
    * @param verse - Verse number (e.g. 1).
-   * @param lyricsLength - Lyrics text length (e.g. "2n").
    * @param lyricsText - Lyrics text (empty space if omitted), single value or array.
+   * @param lyricsLength - Lyrics text length (e.g. "2n").
    * @param lyricsOptions - Lyrics options.
    * @returns - This document builder instance.
    */
-  addLyricsTo(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions) {
+  addLyricsTo(staffTabOrGroups, verse, lyricsText, lyricsLength, lyricsOptions) {
     setAssertFunction("addLyricsTo", verse, lyricsLength, lyricsText, lyricsOptions);
-    return this.addLyricsInternal(staffTabOrGroups, verse, lyricsLength, lyricsText != null ? lyricsText : "", lyricsOptions);
+    return this.addLyricsInternal(staffTabOrGroups, verse, lyricsText, lyricsLength, lyricsOptions);
   }
   addFermataInternal(staffTabOrGroups, fermata) {
     assertStaffTabOrGRoups(staffTabOrGroups);
@@ -8284,14 +8313,14 @@ var _DocumentBuilder = class _DocumentBuilder {
     return this;
   }
   /**
-   * Add rests to fill current measure.
+   * Fill current measure with rests.
    * @param voiceId - Voice id to add rests to. Single value, array or all if omitted.
    * @returns - This document builder instance.
    */
-  completeRests(voiceId) {
-    setAssertFunction("completeRests", voiceId);
-    assertArg(guard_exports.isUndefined(voiceId) || isVoiceId(voiceId) || guard_exports.isArray(voiceId) && voiceId.every((id) => isVoiceId(id)));
-    this.getMeasure().completeRests(voiceId);
+  fillWithRests(...voiceId) {
+    setAssertFunction("fillWithRests", ...voiceId);
+    assertArg(guard_exports.isArray(voiceId) && (voiceId.length === 0 || voiceId.every((id) => isVoiceId(id))));
+    this.getMeasure().fillWithRests(...voiceId);
     return this;
   }
   /**
@@ -8319,6 +8348,22 @@ var _DocumentBuilder = class _DocumentBuilder {
     }
     return this;
   }
+  /**
+   * Add and repeat builder section.
+   * @param times - Repeat count.
+   * @param repeatCreator - Repeat creator function.
+   * @returns - This document builder instance.
+   */
+  repeat(times, repeatCreator) {
+    setAssertFunction("repeat", repeatCreator);
+    assertArg(
+      guard_exports.isIntegerGte(times, 0),
+      guard_exports.isFunction(repeatCreator)
+    );
+    for (let i = 0; i < times; i++)
+      repeatCreator(this);
+    return this;
+  }
 };
 __publicField(_DocumentBuilder, "DefaultMeasureOptions", {});
 var DocumentBuilder = _DocumentBuilder;

package/dist/{tempo-D-JF-8b_.d.ts → tempo-pCAa6qgo.d.ts}

@@ -1,4 +1,4 @@
-import { N as Note, A as Accidental } from './note-RVXvpfyV.js';
+import { N as Note, A as Accidental } from './note-CJuq5aBy.js';
 
 /** Mode enum. */
 declare enum Mode {

package/dist/theory/index.d.ts

@@ -1,8 +1,8 @@
-import { N as Note } from '../note-RVXvpfyV.js';
-export { A as Accidental, d as DefaultGuitarNoteLabel, D as DefaultPitchNotation, G as GuitarNoteLabel, e as GuitarNoteLabelList, a as NoteLetter, P as ParsedNote, b as PitchNotation, c as PitchNotationList, S as SymbolSet, g as getPitchNotationName, f as validateGuitarNoteLabel, v as validatePitchNotation } from '../note-RVXvpfyV.js';
-import { D as Degree } from '../scale-B1M10_fu.js';
-export { b as Interval, I as IntervalDirection, a as IntervalQuality, c as Scale, d as ScaleFactory, S as ScaleType, i as getDefaultScale, h as getScale, e as getScaleFactory, g as getScaleFactoryList, v as validateIntervalQuality, f as validateScaleType } from '../scale-B1M10_fu.js';
-export { A as AccidentalType, B as BeamGrouping, K as KeySignature, M as Mode, N as NoteLength, j as NoteLengthProps, h as NoteLengthStr, R as RhythmProps, c as Tempo, a as TimeSignature, T as TimeSignatures, n as Tuplet, k as TupletRatio, f as alterTempoSpeed, g as getDefaultKeySignature, d as getDefaultTempo, b as getDefaultTimeSignature, e as getTempoString, i as isNoteLength, l as isTupletRatio, v as validateNoteLength, m as validateTupletRatio } from '../tempo-D-JF-8b_.js';
+import { N as Note } from '../note-CJuq5aBy.js';
+export { A as Accidental, d as DefaultGuitarNoteLabel, D as DefaultPitchNotation, G as GuitarNoteLabel, e as GuitarNoteLabelList, a as NoteLetter, P as ParsedNote, b as PitchNotation, c as PitchNotationList, S as SymbolSet, g as getPitchNotationName, f as validateGuitarNoteLabel, v as validatePitchNotation } from '../note-CJuq5aBy.js';
+import { D as Degree } from '../scale-DxGqFxlv.js';
+export { b as Interval, I as IntervalDirection, a as IntervalQuality, c as Scale, d as ScaleFactory, S as ScaleType, i as getDefaultScale, h as getScale, e as getScaleFactory, g as getScaleFactoryList, v as validateIntervalQuality, f as validateScaleType } from '../scale-DxGqFxlv.js';
+export { A as AccidentalType, B as BeamGrouping, K as KeySignature, M as Mode, N as NoteLength, j as NoteLengthProps, h as NoteLengthStr, R as RhythmProps, c as Tempo, a as TimeSignature, T as TimeSignatures, n as Tuplet, k as TupletRatio, f as alterTempoSpeed, g as getDefaultKeySignature, d as getDefaultTempo, b as getDefaultTimeSignature, e as getTempoString, i as isNoteLength, l as isTupletRatio, v as validateNoteLength, m as validateTupletRatio } from '../tempo-pCAa6qgo.js';
 
 /** Chord info type. */
 type ChordInfo = {

package/dist/theory/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v6.0.0-pre.4 | (c) 2023-2025 Stefan Brockmann | MIT License | Includes: Tone.js (MIT License), Color Name to Code (MIT License) */
+/* WebMusicScore v6.0.0 | (c) 2023-2025 Stefan Brockmann | MIT License | Includes: Tone.js (MIT License), Color Name to Code (MIT License) */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/theory/index.mjs

@@ -1,4 +1,4 @@
-/* WebMusicScore v6.0.0-pre.4 | (c) 2023-2025 Stefan Brockmann | MIT License | Includes: Tone.js (MIT License), Color Name to Code (MIT License) */
+/* WebMusicScore v6.0.0 | (c) 2023-2025 Stefan Brockmann | MIT License | Includes: Tone.js (MIT License), Color Name to Code (MIT License) */
 import {
   NoteLength,
   NoteLengthProps,
@@ -8,7 +8,7 @@ import {
   isTupletRatio,
   validateNoteLength,
   validateTupletRatio
-} from "../chunk-UAVXEHYM.mjs";
+} from "../chunk-JOXUFYNU.mjs";
 import {
   IndexArray,
   LRUCache,
@@ -16,10 +16,10 @@ import {
   UniMap,
   guard_exports,
   utils_exports
-} from "../chunk-DVKR62RS.mjs";
+} from "../chunk-7N2CWRTL.mjs";
 import {
   __publicField
-} from "../chunk-GNFDJFUO.mjs";
+} from "../chunk-ZAPOJP2K.mjs";
 
 // src/theory/types.ts
 import { MusicError, MusicErrorType } from "web-music-score/core";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "web-music-score",
-    "version": "6.0.0-pre.4",
+    "version": "6.0.0",
     "author": "Stefan Brockmann",
     "license": "MIT",
     "private": false,