@tspro/web-music-score 4.0.1 → 4.2.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [4.2.0] - 2025-10-03
+## Added
+- Add support for lyrics/syllables with alignment and hyphen/extender.
+- addNote accepts array of notes to add multiple notes at once.
+- 3/8 time signature.
+
+## [4.1.0] - 2025-10-01
+## Added
+- 4-4 (in adition to 2-2-2-2) beam grouping for 4/4 time signature.
+- 12/8 time signature.
+- 5/8 time signature and 2-3 and 3-2 beam groupings.
+- 7/8 time signature and 2-2-3 and 3-2-2 beam groupings.
+
 ## [4.0.1] - 2025-09-28
 ## Fixed
 - Invalid typedoc @params.

package/README.md

@@ -1,6 +1,6 @@
-# WebMusicScore
+# Web Music Score
 
-The API Reference, Examples and Demos can be found [here](https://pahkasoft.github.io). The API Reference is very little commented but gives idea of the full API.
+Homepage (docs, examples and demos): [Web Music Score](https://pahkasoft.github.io/web-music-score)
 
 ## About
 
@@ -13,8 +13,6 @@ This is a work in progress project. Lately there has been improvements that requ
 version update. As the project matures there might be less major updates, and more minor
 updates and patches.
 
-Version 4.0.0 added support for string arguments in addition to typescript enums (e.g. NoteLength.Quarter => "4n", just to name one).
-
 ## Installation
 
 ```sh
@@ -55,14 +53,17 @@ corresponding subpath modules (`react-ui` and `audio-cg` are not included in thi
 browser module).
 
 ```html
-<script src="https://unpkg.com/@tspro/web-music-score@4"></script>
-<script src="https://unpkg.com/@tspro/web-music-score@4.0.0"></script>
-<script src="https://unpkg.com/@tspro/web-music-score@4.0.0/dist/iife/index.global.js"></script>
+<!--
+    It is recommended to use exact version number so that if something
+    breaks between versions then your web site does not stop working.
+-->
+<script src="https://unpkg.com/@tspro/web-music-score@4.2.0"></script>
 
 <!--
-    Use one of above. It is recommended to use version number (e.g. @4.0.0 or at least @4).
-    This way if something breaks between versions then your web site does not stop working.
+    Or you can use direct link to the js bundle.
 -->
+<script src="https://unpkg.com/@tspro/web-music-score@4.2.0/dist/iife/index.global.js"></script>
+
 
 <script>
     const { Core, Audio, Theory, Score, Pieces } = window.WebMusicScore;
@@ -179,12 +180,22 @@ or corresponding string values (e.g. `"Major"`).
 ```
 
 ### Set Time Signature
+For time signature you can use `Theory.TimeSignatures` enum values (e.g. `Theory.TimeSignatures._2_4`)
+or corresponding string values (e.g. `"2/4"`).
+
+For optional beam grouping argument for 5/8 and 7/8 time signatures you can use `Theory.BeamGrouping`
+enum values (e.g. `Theory.BeamGrouping._2_2_3`) or corresponding string values (e.g. `"2-2-3"`).
+
 ```js
-.setTimeSignature("2/4") // Set time signature of 2/4
-.setTimeSignature("3/4") // Set time signature of 3/4
-.setTimeSignature("4/4") // Set time signature of 4/4
-.setTimeSignature("6/8") // Set time signature of 6/8
-.setTimeSignature("9/8") // Set time signature of 9/8
+.setTimeSignature("2/4")          // Set 2/4 time signature.
+.setTimeSignature("3/4")          // Set 3/4 time signature.
+.setTimeSignature("4/4")          // Set 4/4 time signature.
+.setTimeSignature("3/8")          // Set 3/8 time signature.
+.setTimeSignature("5/8", "2-3")   // Set 5/8 time signature. Available beam groupings are "2-3" (default) and "3-2".
+.setTimeSignature("6/8")          // Set 6/8 time signature.
+.setTimeSignature("7/8", "2-2-3") // Set 7/8 time signature. Available beam groupings are "2-2-3" (default) and "3-2-2".
+.setTimeSignature("9/8")          // Set 9/8 time signature.
+.setTimeSignature(12, 8)          // Set 12/8 time signature using number arguments.
 ```
 
 ### Set Tempo
@@ -195,8 +206,9 @@ or corresponding string values (e.g. `"Major"`).
 
 ### Add Note
 ```js
-.addNote(0, "C4", "1n")                     // Create whole note "C4"
-.addNote(0, "Bb4", "2..")                   // Create double dotted half note "Bb4"
+.addNote(0, "C4", "1n")                     // Add whole note "C4"
+.addNote(0, ["C4", "D4", "G4"], "1n")       // Add three notes "C4", "D4", "G4" seuqentially (no chord).
+.addNote(0, "Bb4", "2..")                   // Add double dotted half note "Bb4"
 .addNote(0, "C4", "4n", { stem: "up" })     // Stem direction Up (could be also Down)
 .addNote(0, "C4", "4n", { staccate: true }) // Show staccato dot and play in short
 .addNote(0, "C4", "4n", { diamond: true })  // Show diamond shaped note head
@@ -217,7 +229,7 @@ or corresponding string values (e.g. `"Major"`).
 ```
 
 ### Add Tuplet
-This works for any tuplet:
+This generic function works for any tuplet:
 ```js
 // Example: add triplet
 .addTuplet(0, { parts: 3, inTimeOf: 2 }, notes => {
@@ -230,14 +242,30 @@ This works for any tuplet:
 Triplets can also be created using note length (e.g. NoteLength.EighthTriplet or "8t").
 ```js
 // Example: add triplet using triplet note length.
-.addNote(0, "G3", "8t")
-.addNote(0, "B3", "8t")
-.addNote(0, "D4", "8t")
+.addNote(0, ["G3", "B3", "D4"], "8t")
+```
+
+### Add Lyrics
+
+For lyrics align you can use `Score.LyricsAlign` enum values (e.g. `Score.LyricsAlign.Left`)
+or corresponding string values (e.g. `"left"`).
+
+For lyrics hyphen you can use `Score.LyricsHyphen` enum values (e.g. `Score.LyricsHyphen.Hyphen`)
+or corresponding string values (e.g. `"-"`).
+
+```js
+.addLyrics(1, "4n", "La")                      // Add lyrics text/syllable "La", quarter note length, verse 1.
+.addLyrics(1, "4n", ["La", "la", "la", "la"])  // Add multiple lysics texts/syllables, each quarter note length, verse 1.
+.addLyrics(2, "4n", "La", { align: "left" })   // Left align lyrics text/syllable.
+.addLyrics(2, "4n", "La", { align: "center" }) // Center align lyrics text/syllable.
+.addLyrics(2, "4n", "La", { align: "right" })  // Right align lyrics text/syllable.
+.addLyrics(3, "4n", "La", { hyphen: "-" })     // Add hyphen (short line '-') centered between this and next syllable.
+.addLyrics(3, "4n", "La", { hyphen: "---" })   // Add extender (long line) between this and next syllable.
 ```
 
 ### Add Fermata
 
-For fermata you can use `Score.Fermata` enum values (e.g. `Scoore.Fermata.AtNote`)
+For fermata you can use `Score.Fermata` enum values (e.g. `Score.Fermata.AtNote`)
 or corresponding string values (e.g. `"atNote"`).
 
 ```js
@@ -293,8 +321,8 @@ or corresponding string values (e.g. `"chord"`).
 
 ### Positioning Elements
 
-`addFermata`, `addNavigation`, `addAnnotation` and `addLabel` functions have alternate versions 
-`addFermataTo`, `addNavigationTo`, `addAnnotationTo` and `addLabelTo` that contain extra first argument.
+`addLyrics`, `addFermata`, `addNavigation`, `addAnnotation` and `addLabel` functions have alternate versions 
+`addLyricsTo`, `addFermataTo`, `addNavigationTo`, `addAnnotationTo` and `addLabelTo` that contain extra first argument.
 
 ```js
 .addLabelTo(0, "chord", "Am")        // Add label to top (id 0) staff/tab.
@@ -354,7 +382,23 @@ Add notes with `string` property to specify at what string the fret number is re
 
 ### Beams
 
-Beams are detected and added automatically.
+Beams are detected using beam grouping logic that is defined for each time signature.
+These are the beam groupings for each time signature.
+
+| Time signature | Beam grouping |
+|----------------|---------------|
+| `2/4` | `2-2` |
+| `3/4` | `2-2-2` |
+| `4/4` | `4-4` and `2-2-2-2` together |
+| `3/8` | `3` |
+| `5/8` | `2-3` or `3-2`, user selectable |
+| `6/8` | `3-3` |
+| `7/8` | `2-2-3` or `3-2-2`, user selectable |
+| `9/8` | `3-3-3` |
+| `12/8` | `3-3-3-3` |
+
+How to set beam grouping for `5/8` and `7/8` time signatures,
+see [Set Time Signature](#set-time-signature) section above.
 
 ### Classical Guitar Audio Module
 
@@ -457,11 +501,9 @@ While designed for compatibility in mind, the library has not been explicitly te
 
 ## Report a Bug
 
-Found a bug or unexpected behavior?
-
-[Please open a new issue.](https://github.com/pahkasoft/issues/issues/new)
+Found a bug or unexpected behavior? Suggest a feature or impovement?
 
-You can also suggest a feature or impovement.
+[Please open a new issue.](https://github.com/pahkasoft/web-music-score/issues/new/choose)
 
 Thanks for helping improve the project!
 

package/dist/audio/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v4.0.1 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/dist/audio/index.mjs

@@ -1,7 +1,7 @@
-/* WebMusicScore v4.0.1 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
   __publicField
-} from "../chunk-YFPLOHP2.mjs";
+} from "../chunk-5NWLGWHS.mjs";
 
 // src/audio/index.ts
 import { Note, PitchNotation, SymbolSet } from "@tspro/web-music-score/theory";

package/dist/audio-cg/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v4.0.1 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/dist/audio-cg/index.mjs

@@ -1,7 +1,7 @@
-/* WebMusicScore v4.0.1 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
   __publicField
-} from "../chunk-YFPLOHP2.mjs";
+} from "../chunk-5NWLGWHS.mjs";
 
 // src/audio-cg/index.ts
 import * as Tone from "tone";

package/dist/{chunk-YFPLOHP2.mjs → chunk-5NWLGWHS.mjs}

@@ -1,4 +1,4 @@
-/* WebMusicScore v4.0.1 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -6,4 +6,4 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 export {
   __publicField
 };
-//# sourceMappingURL=chunk-YFPLOHP2.mjs.map
+//# sourceMappingURL=chunk-5NWLGWHS.mjs.map

package/dist/chunk-7MNV5JN6.mjs

@@ -0,0 +1,264 @@
+/* WebMusicScore v4.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+import {
+  __publicField
+} from "./chunk-5NWLGWHS.mjs";
+
+// src/theory/rhythm.ts
+import { Utils } from "@tspro/ts-utils-lib";
+import { MusicError, MusicErrorType } from "@tspro/web-music-score/core";
+var cmp = (a, b) => a === b ? 0 : a < b ? -1 : 1;
+var MaxTupletRatioValue = 12;
+var TicksMultiplier = 12 * 11 * 9 * 7 * 5;
+var NoteLength = /* @__PURE__ */ ((NoteLength2) => {
+  NoteLength2["Whole"] = "1n";
+  NoteLength2["WholeTriplet"] = "1t";
+  NoteLength2["WholeDot"] = "1.";
+  NoteLength2["Whole2Dots"] = "1..";
+  NoteLength2["Whole12Dots"] = "1..";
+  NoteLength2["Whole3Dots"] = "1...";
+  NoteLength2["Whole4Dots"] = "1....";
+  NoteLength2["Whole5Dots"] = "1.....";
+  NoteLength2["Whole6Dots"] = "1......";
+  NoteLength2["Half"] = "2n";
+  NoteLength2["HalfTriplet"] = "2t";
+  NoteLength2["HalfDot"] = "2.";
+  NoteLength2["Half2Dots"] = "2..";
+  NoteLength2["Half3Dots"] = "2...";
+  NoteLength2["Half4Dots"] = "2....";
+  NoteLength2["Half5Dots"] = "2.....";
+  NoteLength2["Quarter"] = "4n";
+  NoteLength2["QuarterTriplet"] = "4t";
+  NoteLength2["QuarterDot"] = "4.";
+  NoteLength2["Quarter2Dots"] = "4..";
+  NoteLength2["Quarter3Dots"] = "4...";
+  NoteLength2["Quarter4Dots"] = "4....";
+  NoteLength2["Eighth"] = "8n";
+  NoteLength2["EighthTriplet"] = "8t";
+  NoteLength2["EighthDot"] = "8.";
+  NoteLength2["Eighth2Dots"] = "8..";
+  NoteLength2["Eighth3Dots"] = "8...";
+  NoteLength2["Sixteenth"] = "16n";
+  NoteLength2["SixteenthTriplet"] = "16t";
+  NoteLength2["SixteenthDot"] = "16.";
+  NoteLength2["Sixteenth2Dots"] = "16..";
+  NoteLength2["ThirtySecond"] = "32n";
+  NoteLength2["ThirtySecondTriplet"] = "32t";
+  NoteLength2["ThirtySecondDot"] = "32.";
+  NoteLength2["SixtyFourth"] = "64n";
+  NoteLength2["SixtyFourthTriplet"] = "64t";
+  return NoteLength2;
+})(NoteLength || {});
+function validateNoteLength(noteLength) {
+  if (Utils.Is.isEnumValue(noteLength, NoteLength)) {
+    return noteLength;
+  } else {
+    throw new MusicError(MusicErrorType.InvalidArg, `Invalid noteLength: ${noteLength}`);
+  }
+}
+var _NoteLengthProps = class _NoteLengthProps {
+  constructor(noteLength) {
+    /** Note length. */
+    __publicField(this, "noteLength");
+    /** Note size (whole=1, half=2, quarter=4, ...). */
+    __publicField(this, "noteSize");
+    /** Number of ticks (not altered by isTriplet). */
+    __publicField(this, "ticks");
+    /** Flag count. */
+    __publicField(this, "flagCount");
+    /** Dot count. */
+    __publicField(this, "dotCount");
+    /** Max dot count. */
+    __publicField(this, "maxDotCount");
+    /** Is triplet? */
+    __publicField(this, "isTriplet");
+    /** Has note stem. */
+    __publicField(this, "hasStem");
+    /** Is note head solid (black)? */
+    __publicField(this, "isSolid");
+    this.noteLength = validateNoteLength(noteLength);
+    this.noteSize = parseInt(noteLength);
+    this.isTriplet = noteLength.endsWith("t");
+    this.maxDotCount = this.isTriplet ? 0 : Math.floor(Math.log2(_NoteLengthProps.ShortestNoteSize / this.noteSize));
+    this.dotCount = Utils.Str.charCount(noteLength, ".");
+    this.flagCount = this.noteSize > 4 ? Math.floor(Math.log2(this.noteSize / 4)) : 0;
+    this.ticks = TicksMultiplier * _NoteLengthProps.ShortestNoteSize / this.noteSize;
+    this.hasStem = this.noteSize > 1;
+    this.isSolid = this.noteSize > 2;
+    if (this.dotCount > this.maxDotCount) {
+      throw new MusicError(MusicErrorType.Note, `dotCount ${this.dotCount} > maxDotCount ${this.maxDotCount}, for noteLength "${this.noteLength}".`);
+    } else if (this.isTriplet && this.dotCount > 0) {
+      throw new MusicError(MusicErrorType.Note, `noteLength "${this.noteLength}" is both triplet and dotted!`);
+    }
+  }
+  /**
+   * Get note length props.
+   * @param noteLength - Note length.
+   * @returns - Note length props.
+   */
+  static get(noteLength) {
+    let p = this.cache.get(noteLength);
+    if (!p) {
+      this.cache.set(noteLength, p = new _NoteLengthProps(noteLength));
+    }
+    return p;
+  }
+  /**
+   * Create note length props.
+   * @param noteLength - Note length or note size.
+   * @param dotCount - Dot count.
+   * @returns - Note length props.
+   */
+  static create(noteLength, dotCount = 0) {
+    let noteSize = typeof noteLength === "number" ? noteLength : this.get(noteLength).noteSize;
+    return this.get(noteSize + (Utils.Is.isIntegerGte(dotCount, 1) ? ".".repeat(dotCount) : "n"));
+  }
+  /**
+   * Compare note lengths/sizes. Whole (1) > half (2) > quarter (4), etc.
+   * Ignores possible triplet property of note length.
+   * @param a - NoteLengthProps, NoteLength/Str or noteSize
+   * @param b - NoteLengthProps, NoteLength/Str or noteSize
+   * @returns - -1: a < b, 0: a === b, +1: a > b (note length/size comparisons)
+   */
+  static cmp(a, b) {
+    let aNoteSize = a instanceof _NoteLengthProps ? a.noteSize : typeof a === "number" ? a : _NoteLengthProps.get(a).noteSize;
+    let bNoteSize = b instanceof _NoteLengthProps ? b.noteSize : typeof b === "number" ? b : _NoteLengthProps.get(b).noteSize;
+    return cmp(bNoteSize, aNoteSize);
+  }
+  /**
+   * Compare note lengths/sizes for equality.
+   * Ignores possible triplet property of note length.
+   * @param a - NoteLengthProps, NoteLength/Str or noteSize
+   * @param b - NoteLengthProps, NoteLength/Str or noteSize
+   * @returns - true: a === b, false: a !== b (note length/size comparisons)
+   */
+  static equals(a, b) {
+    let aNoteSize = a instanceof _NoteLengthProps ? a.noteSize : typeof a === "number" ? a : _NoteLengthProps.get(a).noteSize;
+    let bNoteSize = b instanceof _NoteLengthProps ? b.noteSize : typeof b === "number" ? b : _NoteLengthProps.get(b).noteSize;
+    return aNoteSize === bNoteSize;
+  }
+};
+/** Longest note size (e.g. 1 = whole note). */
+__publicField(_NoteLengthProps, "LongestNoteSize", Math.min(...Utils.Enum.getEnumValues(NoteLength).map((noteLength) => parseInt(noteLength))));
+/** Shortest note size (e.g. 64 = sixtyfourth note). */
+__publicField(_NoteLengthProps, "ShortestNoteSize", Math.max(...Utils.Enum.getEnumValues(NoteLength).map((noteLength) => parseInt(noteLength))));
+__publicField(_NoteLengthProps, "cache", /* @__PURE__ */ new Map());
+var NoteLengthProps = _NoteLengthProps;
+function validateTupletRatio(tupletRatio) {
+  if (Utils.Is.isObject(tupletRatio) && Utils.Is.isIntegerBetween(tupletRatio.parts, 2, MaxTupletRatioValue) && Utils.Is.isIntegerBetween(tupletRatio.inTimeOf, 2, MaxTupletRatioValue)) {
+    return tupletRatio;
+  } else {
+    throw new MusicError(MusicErrorType.Note, `Invalid tupletRatio ${JSON.stringify(tupletRatio)}`);
+  }
+}
+var Tuplet = {
+  /** Duplet: 2 in the time of 3 */
+  Duplet: { parts: 2, inTimeOf: 3 },
+  /** Triplet: 3 in the time of 2 */
+  Triplet: { parts: 3, inTimeOf: 2 },
+  /** Quadruplet: 4 in the time of 3 */
+  Quadruplet: { parts: 4, inTimeOf: 3 }
+};
+var _RhythmProps = class _RhythmProps {
+  constructor(noteLength, dotCount, tupletRatio) {
+    /** Note length. */
+    __publicField(this, "noteLength");
+    /** Note size (whole=1, half=2, quarter=4, ...). */
+    __publicField(this, "noteSize");
+    /** Dot count. */
+    __publicField(this, "dotCount");
+    /** Tuplet ratio. */
+    __publicField(this, "tupletRatio");
+    /** Number of ticks. */
+    __publicField(this, "ticks");
+    /** Flag count. */
+    __publicField(this, "flagCount");
+    /** Has note stem. */
+    __publicField(this, "hasStem");
+    /** Is note head solid (black)? */
+    __publicField(this, "isSolidNoteHead");
+    this.noteLength = validateNoteLength(noteLength);
+    let p = NoteLengthProps.get(noteLength);
+    this.noteSize = p.noteSize;
+    this.ticks = p.ticks;
+    this.flagCount = p.flagCount;
+    this.dotCount = dotCount != null ? dotCount : p.dotCount;
+    this.hasStem = p.hasStem;
+    this.isSolidNoteHead = p.isSolid;
+    if (Utils.Is.isObject(tupletRatio)) {
+      this.tupletRatio = validateTupletRatio(tupletRatio);
+    } else if (p.isTriplet) {
+      this.tupletRatio = Tuplet.Triplet;
+    } else {
+      this.tupletRatio = void 0;
+    }
+    if (this.dotCount > 0 && this.tupletRatio !== void 0) {
+      throw new MusicError(MusicErrorType.Note, `Note cannot be both dotted and tuplet!`);
+    } else if (this.dotCount > p.maxDotCount) {
+      throw new MusicError(MusicErrorType.Note, `Too big dot count ${this.dotCount} for note length ${this.noteLength}.`);
+    }
+    for (let add = this.ticks / 2, i = 1; i <= this.dotCount; i++, add /= 2) {
+      this.ticks += add;
+    }
+    if (this.tupletRatio) {
+      this.ticks *= this.tupletRatio.inTimeOf / this.tupletRatio.parts;
+    }
+  }
+  /**
+   * Get string presentation of rhythm props.
+   * @returns - String presentation.
+   */
+  toString() {
+    let sym = _RhythmProps.NoteSymbolMap.get(this.noteSize);
+    let dots = ".".repeat(this.dotCount);
+    return sym ? sym + dots : "" + this.noteSize + (dots.length > 0 ? dots : "n");
+  }
+  /**
+   * Get rhythm props with given arguments.
+   * @param noteLength - Note length.
+   * @param dotCount - Dot count.
+   * @param tupletRatio - Tuplet ratio.
+   * @returns - Rhythm props.
+   */
+  static get(noteLength, dotCount, tupletRatio) {
+    if (dotCount !== void 0 || tupletRatio !== void 0) {
+      return new _RhythmProps(noteLength, dotCount, tupletRatio);
+    } else {
+      let rhythmProps = this.cache.get(noteLength);
+      if (!rhythmProps) {
+        this.cache.set(noteLength, rhythmProps = new _RhythmProps(noteLength));
+      }
+      return rhythmProps;
+    }
+  }
+  /**
+   * Compare duration of rhythm props.
+   * @param a - RhythmProps
+   * @param b - RhythmProps
+   * @returns - -1: a < b, 0: a === b, +1: a > b (duration comparisons)
+   */
+  static cmp(a, b) {
+    return cmp(a.ticks, b.ticks);
+  }
+  /**
+   * Compare duration equality of rhythm props.
+   * @param a - RhythmProps
+   * @param b - RhythmProps
+   * @returns - true: a === b, false: a !== b (duration comparisons)
+   */
+  static equals(a, b) {
+    return a.ticks === b.ticks;
+  }
+};
+__publicField(_RhythmProps, "NoteSymbolMap", /* @__PURE__ */ new Map([[1, "\u{1D15D}"], [2, "\u{1D15E}"], [4, "\u{1D15F}"], [8, "\u{1D160}"], [16, "\u{1D161}"], [32, "\u{1D162}"], [64, "\u{1D163}"], [128, "\u{1D164}"]]));
+__publicField(_RhythmProps, "cache", /* @__PURE__ */ new Map());
+var RhythmProps = _RhythmProps;
+
+export {
+  NoteLength,
+  validateNoteLength,
+  NoteLengthProps,
+  validateTupletRatio,
+  Tuplet,
+  RhythmProps
+};
+//# sourceMappingURL=chunk-7MNV5JN6.mjs.map

package/dist/core/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v4.0.1 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -62,7 +62,7 @@ function init() {
     return;
   }
   initialized = true;
-  console.log("%cWebMusicScore v4.0.1 (cjs) initialized.", "background: black; color: white; padding: 2px;");
+  console.log("%cWebMusicScore v4.2.0 (cjs) initialized.", "background: black; color: white; padding: 2px;");
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/core/index.mjs

@@ -1,7 +1,7 @@
-/* WebMusicScore v4.0.1 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
   __publicField
-} from "../chunk-YFPLOHP2.mjs";
+} from "../chunk-5NWLGWHS.mjs";
 
 // src/core/error.ts
 var MusicErrorType = /* @__PURE__ */ ((MusicErrorType2) => {
@@ -36,7 +36,7 @@ function init() {
     return;
   }
   initialized = true;
-  console.log("%cWebMusicScore v4.0.1 (esm) initialized.", "background: black; color: white; padding: 2px;");
+  console.log("%cWebMusicScore v4.2.0 (esm) initialized.", "background: black; color: white; padding: 2px;");
 }
 export {
   MusicError,