@tspro/web-music-score 5.3.0 → 5.4.1

package/dist/{chunk-ZBA5XLYR.mjs → chunk-A5SMODAT.mjs}

@@ -1,10 +1,10 @@
-/* WebMusicScore v5.3.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v5.4.1 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
   __publicField
-} from "./chunk-C6UQDKWU.mjs";
+} from "./chunk-U2ACCEHX.mjs";
 
 // src/theory/rhythm.ts
-import { Utils } from "@tspro/ts-utils-lib";
+import { Guard, IndexArray, UniMap, Utils } from "@tspro/ts-utils-lib";
 import { MusicError, MusicErrorType } from "@tspro/web-music-score/core";
 var MaxTupletRatioValue = 12;
 var TicksMultiplier = 12 * 11 * 9 * 7 * 5;
@@ -47,8 +47,11 @@ var NoteLength = /* @__PURE__ */ ((NoteLength2) => {
   NoteLength2["SixtyFourthTriplet"] = "64t";
   return NoteLength2;
 })(NoteLength || {});
+function isNoteLength(noteLength) {
+  return Guard.isEnumValue(noteLength, NoteLength);
+}
 function validateNoteLength(noteLength) {
-  if (Utils.Is.isEnumValue(noteLength, NoteLength)) {
+  if (isNoteLength(noteLength)) {
     return noteLength;
   } else {
     throw new MusicError(MusicErrorType.InvalidArg, `Invalid noteLength: ${noteLength}`);
@@ -95,11 +98,7 @@ var _NoteLengthProps = class _NoteLengthProps {
    * @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;
+    return this.cache.getOrCreate(noteLength, () => new _NoteLengthProps(noteLength));
   }
   /**
    * Create note length props.
@@ -109,7 +108,7 @@ var _NoteLengthProps = class _NoteLengthProps {
    */
   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"));
+    return this.get(noteSize + (Guard.isIntegerGte(dotCount, 1) ? ".".repeat(dotCount) : "n"));
   }
   /**
    * Compare note lengths/sizes. Whole (1) > half (2) > quarter (4), etc.
@@ -140,10 +139,13 @@ var _NoteLengthProps = class _NoteLengthProps {
 __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());
+__publicField(_NoteLengthProps, "cache", new UniMap());
 var NoteLengthProps = _NoteLengthProps;
+function isTupletRatio(tupletRatio) {
+  return Guard.isObject(tupletRatio) && Guard.isIntegerBetween(tupletRatio.parts, 2, MaxTupletRatioValue) && Guard.isIntegerBetween(tupletRatio.inTimeOf, 2, MaxTupletRatioValue);
+}
 function validateTupletRatio(tupletRatio) {
-  if (Utils.Is.isObject(tupletRatio) && Utils.Is.isIntegerBetween(tupletRatio.parts, 2, MaxTupletRatioValue) && Utils.Is.isIntegerBetween(tupletRatio.inTimeOf, 2, MaxTupletRatioValue)) {
+  if (isTupletRatio(tupletRatio)) {
     return tupletRatio;
   } else {
     throw new MusicError(MusicErrorType.Note, `Invalid tupletRatio ${JSON.stringify(tupletRatio)}`);
@@ -183,7 +185,7 @@ var _RhythmProps = class _RhythmProps {
     this.dotCount = dotCount != null ? dotCount : p.dotCount;
     this.hasStem = p.hasStem;
     this.isSolidNoteHead = p.isSolid;
-    if (Utils.Is.isObject(tupletRatio)) {
+    if (Guard.isObject(tupletRatio)) {
       this.tupletRatio = validateTupletRatio(tupletRatio);
     } else if (p.isTriplet) {
       this.tupletRatio = Tuplet.Triplet;
@@ -222,11 +224,7 @@ var _RhythmProps = class _RhythmProps {
     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;
+      return this.cache.getOrCreate(noteLength, () => new _RhythmProps(noteLength));
     }
   }
   /**
@@ -248,16 +246,18 @@ var _RhythmProps = class _RhythmProps {
     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());
+__publicField(_RhythmProps, "NoteSymbolMap", new IndexArray([[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", new UniMap());
 var RhythmProps = _RhythmProps;
 
 export {
   NoteLength,
+  isNoteLength,
   validateNoteLength,
   NoteLengthProps,
+  isTupletRatio,
   validateTupletRatio,
   Tuplet,
   RhythmProps
 };
-//# sourceMappingURL=chunk-ZBA5XLYR.mjs.map
+//# sourceMappingURL=chunk-A5SMODAT.mjs.map

package/dist/{chunk-C6UQDKWU.mjs → chunk-U2ACCEHX.mjs}

@@ -1,4 +1,4 @@
-/* WebMusicScore v5.3.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v5.4.1 | (c) 2023-2025 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-C6UQDKWU.mjs.map
+//# sourceMappingURL=chunk-U2ACCEHX.mjs.map

package/dist/core/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v5.3.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v5.4.1 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -63,7 +63,7 @@ function init() {
     return;
   }
   initialized = true;
-  console.log("%cWebMusicScore v5.3.0 (cjs) initialized.", "background: black; color: white; padding: 2px;");
+  console.log("%cWebMusicScore v5.4.1 (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,34 +1,9 @@
-/* WebMusicScore v5.3.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v5.4.1 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
-  __publicField
-} from "../chunk-C6UQDKWU.mjs";
-
-// src/core/error.ts
-var MusicErrorType = /* @__PURE__ */ ((MusicErrorType2) => {
-  MusicErrorType2[MusicErrorType2["Unknown"] = 0] = "Unknown";
-  MusicErrorType2[MusicErrorType2["InvalidArg"] = 1] = "InvalidArg";
-  MusicErrorType2[MusicErrorType2["Note"] = 2] = "Note";
-  MusicErrorType2[MusicErrorType2["Scale"] = 3] = "Scale";
-  MusicErrorType2[MusicErrorType2["KeySignature"] = 4] = "KeySignature";
-  MusicErrorType2[MusicErrorType2["Timesignature"] = 5] = "Timesignature";
-  MusicErrorType2[MusicErrorType2["Score"] = 6] = "Score";
-  MusicErrorType2[MusicErrorType2["Audio"] = 7] = "Audio";
-  return MusicErrorType2;
-})(MusicErrorType || {});
-function formatType(type) {
-  return type === void 0 ? "" : `[${MusicErrorType[type]}] `;
-}
-var MusicError = class extends Error {
-  constructor(...args) {
-    const [type, msg] = args.length === 1 ? [0 /* Unknown */, args[0]] : args;
-    super(formatType(type) + msg);
-    /** Music error type. */
-    __publicField(this, "type");
-    Object.setPrototypeOf(this, new.target.prototype);
-    this.name = "MusicError";
-    this.type = type;
-  }
-};
+  MusicError,
+  MusicErrorType
+} from "../chunk-6P4ECBUH.mjs";
+import "../chunk-U2ACCEHX.mjs";
 
 // src/core/index.ts
 var initialized = false;
@@ -37,7 +12,7 @@ function init() {
     return;
   }
   initialized = true;
-  console.log("%cWebMusicScore v5.3.0 (esm) initialized.", "background: black; color: white; padding: 2px;");
+  console.log("%cWebMusicScore v5.4.1 (esm) initialized.", "background: black; color: white; padding: 2px;");
 }
 export {
   MusicError,

package/dist/{guitar-BsSayRsH.d.ts → guitar-CNOxM4ZK.d.ts}

@@ -1,4 +1,4 @@
-import { N as Note } from './note-CgCIBwvR.js';
+import { N as Note } from './note-RVXvpfyV.js';
 
 /** Guitar handedness enum. */
 declare enum Handedness {

package/dist/{guitar-DdexKdN6.d.mts → guitar-DXlB-9vK.d.mts}

@@ -1,4 +1,4 @@
-import { N as Note } from './note-eA2xPPiG.mjs';
+import { N as Note } from './note-RVXvpfyV.mjs';
 
 /** Guitar handedness enum. */
 declare enum Handedness {