@tspro/web-music-score 5.4.2 → 5.5.0

package/dist/react-ui/index.mjs

@@ -1,12 +1,17 @@
-/* WebMusicScore v5.4.2 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v5.5.0 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License), Color Name to Code (MIT License) */
+import {
+  Rect,
+  device_exports,
+  guard_exports,
+  utils_exports
+} from "../chunk-T6TYLAJE.mjs";
 import {
   __publicField
-} from "../chunk-ROBXPR34.mjs";
+} from "../chunk-BMKUAUSJ.mjs";
 
 // src/react-ui/circle-of-fifths.tsx
 import * as React from "react";
 import { Note, SymbolSet, getScale, ScaleType } from "@tspro/web-music-score/theory";
-import { Device, Rect, Utils } from "@tspro/ts-utils-lib";
 import { jsx } from "react/jsx-runtime";
 var SelectedColor = "#0A0";
 var MajorScaleTonics = [
@@ -52,8 +57,8 @@ var CircleOfFifths = class extends React.Component {
   render() {
     var _a, _b;
     let { style, scale } = this.props;
-    let defaultSize = Device.toPx("22em");
-    let dim = Utils.Dom.getDimension(style);
+    let defaultSize = device_exports.toPx("22em");
+    let dim = utils_exports.Dom.getDimension(style);
     let width = (_a = dim.width) != null ? _a : defaultSize;
     let height = (_b = dim.height) != null ? _b : defaultSize;
     style = Object.assign({}, style, { width, height });
@@ -149,7 +154,6 @@ var guitar_default = {
 
 // src/react-ui/guitar-context.ts
 import { MusicError, MusicErrorType } from "@tspro/web-music-score/core";
-import { Guard } from "@tspro/ts-utils-lib";
 var DefaultColors = {
   ScaleNoteColor: "#0A0",
   ScaleRootNoteColor: "#00A",
@@ -266,9 +270,9 @@ var GuitarContext = class _GuitarContext {
    * @returns - Fret position object.
    */
   getFretPosition(stringId, fretId) {
-    if (!Guard.isInteger(stringId) || stringId < 0 || stringId > 5) {
+    if (!guard_exports.isInteger(stringId) || stringId < 0 || stringId > 5) {
       throw new MusicError(MusicErrorType.InvalidArg, `Invalid stringId: + ${stringId}`);
-    } else if (!Guard.isInteger(fretId) || fretId < 0 || fretId > this.maxFretId) {
+    } else if (!guard_exports.isInteger(fretId) || fretId < 0 || fretId > this.maxFretId) {
       throw new MusicError(MusicErrorType.InvalidArg, `Invalid fretId: ${fretId}`);
     } else {
       return this.fretPositionTable[stringId][fretId];
@@ -333,7 +337,6 @@ var GuitarContext = class _GuitarContext {
 
 // src/react-ui/guitar-view.tsx
 import * as React2 from "react";
-import { Guard as Guard2, Rect as Rect2, Utils as Utils2 } from "@tspro/ts-utils-lib";
 import { Handedness as Handedness2 } from "@tspro/web-music-score/theory";
 
 // src/react-ui/assets/guitar.png
@@ -371,7 +374,7 @@ var t_table = [
   0.75
 ];
 function fret_t(fretId) {
-  if (!Guard2.isInteger(fretId) || fretId < 0 || fretId > t_table.length - 1) {
+  if (!guard_exports.isInteger(fretId) || fretId < 0 || fretId > t_table.length - 1) {
     throw new MusicError2(MusicErrorType2.InvalidArg, `Invalid fretId: ${fretId}`);
   } else {
     return t_table[fretId] * 2;
@@ -418,14 +421,14 @@ var GuitarView = class extends React2.Component {
   }
   componentDidUpdate(prevProps) {
     let { style, guitarContext: guitarCtx } = this.props;
-    if (Utils2.Dom.styleLayoutChanged(style, prevProps.style) || guitarCtx !== prevProps.guitarContext) {
+    if (utils_exports.Dom.styleLayoutChanged(style, prevProps.style) || guitarCtx !== prevProps.guitarContext) {
       this.setState(this.getLayoutState());
     }
   }
   getLayoutState() {
     var _a, _b;
     let { guitarContext: guitarCtx, style } = this.props;
-    let dim = Utils2.Dom.getDimension(style);
+    let dim = utils_exports.Dom.getDimension(style);
     let width = (_a = dim.width) != null ? _a : window.innerWidth;
     let height = guitar_default.height * width / guitar_default.width;
     let s = width / guitar_default.width;
@@ -442,16 +445,16 @@ var GuitarView = class extends React2.Component {
         let left = frets[fretId];
         let right = (_b = frets[fretId - 1]) != null ? _b : new Fret(width, left.topStringY, left.bottomStringY);
         let cellHeight = (left.bottomStringY - left.topStringY) / 5;
-        let cellRect = new Rect2(
+        let cellRect = new Rect(
           left.x,
           left.bottomStringY - cellHeight * (stringId + 0.5),
           right.x - left.x,
           cellHeight
         );
         if (guitarCtx.handedness === Handedness2.LeftHanded) {
-          cellRect = new Rect2(width - cellRect.right, cellRect.top, cellRect.width, cellRect.height);
+          cellRect = new Rect(width - cellRect.right, cellRect.top, cellRect.width, cellRect.height);
         }
-        let noteRect = new Rect2(
+        let noteRect = new Rect(
           cellRect.left + (guitarCtx.handedness === Handedness2.LeftHanded ? cellRect.width - noteWidth : 0),
           cellRect.top,
           noteWidth,

package/dist/{scale-CUYFBo-8.d.ts → scale-DulPFco_.d.ts}

@@ -1,5 +1,5 @@
-import { N as Note, S as SymbolSet } from './note-RVXvpfyV.js';
-import { K as KeySignature } from './tempo-DwuZsv2T.js';
+import { N as Note, S as SymbolSet } from './note-CJuq5aBy.js';
+import { K as KeySignature } from './tempo-BnUjm25M.js';
 
 /** Interval direction type. */
 type IntervalDirection = "Unison" | "Ascending" | "Descending";

package/dist/score/index.d.mts

@@ -1,10 +1,58 @@
-import { N as NoteOptions, R as RestOptions, S as StaffPreset, a as ScoreConfiguration, M as MDocument, b as MeasureOptions, V as VoiceId, T as TupletOptions, c as VerseNumber, L as LyricsOptions, d as StaffTabOrGroups, F as Fermata, e as Navigation, A as AnnotationText, f as Annotation, g as Label, C as Connective, h as TieType, i as NoteAnchor, j as VerticalPosition } from '../music-objects-DqoO-Sfv.mjs';
-export { al as Arpeggio, a7 as BaseConfig, a6 as Clef, ap as DynamicsAnnotation, an as LyricsAlign, ao as LyricsHyphen, u as MAccidental, w as MArpeggio, I as MBarLineLeft, H as MBarLineRight, x as MBeamGroup, v as MConnective, z as MEnding, a5 as MExtensionLine, B as MFermata, D as MHeader, E as MImage, a4 as MLyrics, G as MMeasure, K as MNoteGroup, s as MPlaybackButtons, p as MPlayer, q as MRenderContext, r as MRenderer, Q as MRest, W as MRhythmColumn, X as MScoreRow, Y as MScoreRowGroup, a2 as MSpecialText, Z as MStaff, J as MStaffBarLine, y as MStaffBeamGroup, O as MStaffNoteGroup, U as MStaffRest, $ as MStaffSignature, _ as MTab, P as MTabNoteGroup, a1 as MTabRhythm, a0 as MTabSignature, a3 as MText, t as MusicInterface, ar as PlayState, as as PlayStateChangeListener, l as ScoreEvent, o as ScoreEventListener, k as ScoreEventType, n as ScoreObjectEvent, m as ScoreStaffPosEvent, a8 as StaffConfig, am as StaffTabOrGroup, ak as Stem, ad as StringNumber, a9 as TabConfig, aq as TempoAnnotation, ae as getStringNumbers, ah as getVerseNumbers, aa as getVoiceIds, af as isStringNumber, ai as isVerseNumber, ab as isVoiceId, ag as validateStringNumber, aj as validateVerseNumber, ac as validateVoiceId } from '../music-objects-DqoO-Sfv.mjs';
+import { N as NoteOptions, R as RestOptions, S as StaffPreset, a as ScoreConfiguration, M as MDocument, b as MeasureOptions, V as VoiceId, T as TupletOptions, c as VerseNumber, L as LyricsOptions, d as StaffTabOrGroups, F as Fermata, e as Navigation, A as AnnotationText, f as Annotation, g as Label, C as Connective, h as TieType, i as NoteAnchor, j as VerticalPosition } from '../music-objects-CcJvZxS6.mjs';
+export { al as Arpeggio, a7 as BaseConfig, a6 as Clef, ap as DynamicsAnnotation, an as LyricsAlign, ao as LyricsHyphen, u as MAccidental, w as MArpeggio, I as MBarLineLeft, H as MBarLineRight, x as MBeamGroup, v as MConnective, z as MEnding, a5 as MExtensionLine, B as MFermata, D as MHeader, E as MImage, a4 as MLyrics, G as MMeasure, K as MNoteGroup, s as MPlaybackButtons, p as MPlayer, q as MRenderContext, r as MRenderer, Q as MRest, W as MRhythmColumn, X as MScoreRow, Y as MScoreRowGroup, a2 as MSpecialText, Z as MStaff, J as MStaffBarLine, y as MStaffBeamGroup, O as MStaffNoteGroup, U as MStaffRest, $ as MStaffSignature, _ as MTab, P as MTabNoteGroup, a1 as MTabRhythm, a0 as MTabSignature, a3 as MText, t as MusicInterface, ar as PlayState, as as PlayStateChangeListener, l as ScoreEvent, o as ScoreEventListener, k as ScoreEventType, n as ScoreObjectEvent, m as ScoreStaffPosEvent, a8 as StaffConfig, am as StaffTabOrGroup, ak as Stem, ad as StringNumber, a9 as TabConfig, aq as TempoAnnotation, ae as getStringNumbers, ah as getVerseNumbers, aa as getVoiceIds, af as isStringNumber, ai as isVerseNumber, ab as isVoiceId, ag as validateStringNumber, aj as validateVerseNumber, ac as validateVoiceId } from '../music-objects-CcJvZxS6.mjs';
 import { N as Note } from '../note-CJuq5aBy.mjs';
 import { S as ScaleType, c as Scale } from '../scale-DWM4RQco.mjs';
 import { N as NoteLength, i as NoteLengthStr, K as KeySignature, b as TimeSignature, T as TimeSignatures, B as BeamGrouping, l as TupletRatio } from '../tempo-Cxu8vusu.mjs';
 import '@tspro/ts-utils-lib';
 
+/**
+ * Color attributes.
+ * ```
+ * Attribute hierarchy is:
+ *  + background
+ *  + header
+ *      + title
+ *      + composer
+ *      + arranger
+ *  + rowgroup
+ *      + instrument
+ *      + frame
+ *  + staff|tab
+ *      + frame
+ *      + note
+ *      + rest
+ *      + connective
+ *      + signature
+ *          + clef (staff only)
+ *          + key (staff only)
+ *          + time
+ *          + tempo
+ *          + measurenum
+ *      + tuning (tab only)
+ *      + element
+ *          + fermata
+ *          + annotation
+ *          + navigation
+ *          + label
+ * ```
+ */
+type ColorAttr = "background" | "header" | "title" | "composer" | "arranger" | "rowgroup" | "instrument" | "frame" | "staff" | "tab" | "frame" | "note" | "rest" | "connective" | "signature" | "clef" | "key" | "time" | "tempo" | "measurenum" | "tuning" | "element" | "fermata" | "annotation" | "navigation" | "label";
+/**
+ * Set color of any score document element. Use combination of color attributes to set color of specific elements.
+ * ```ts
+ * setColor("red", "staff");                        // Set color of all staff elements to red.
+ * setColor("red", "staff", "signature");           // Set color of all signature elements of staff to red.
+ * setColor("red", "staff", "key", "signature");    // Set color of key signature of staff to red.
+ * setColor("green", "staff", "time", "signature"); // Set color of time signature of staff to green.
+ * // etc.
+ * ```
+ * See {@link ColorAttr} for attribute hierarchy tree.
+ *
+ * @param color - Color (HTML color code e.g. "green", "#AA6644", etc.)
+ * @param colorAttrs - Any number of color attributes.
+ */
+declare function setColor(color: string, ...colorAttrs: ColorAttr[]): void;
+
 /**
  * @deprecated - Will be removed in `v6.0.0`. Use `AnchoredRect` from `@tspro/ts-utils-lib` instead.
  *
@@ -649,4 +697,4 @@ declare class DocumentBuilder {
     addScaleArpeggio(scale: Scale, bottomNote: string, numOctaves: number): DocumentBuilder;
 }
 
-export { Annotation, AnnotationText, Connective, DivRect, DocumentBuilder, type ExtensionBuilder, Fermata, Label, LyricsOptions, MDocument, MeasureOptions, Navigation, NoteAnchor, NoteOptions, RestOptions, ScoreConfiguration, StaffPreset, StaffTabOrGroups, TieType, type TupletBuilder, TupletOptions, VerseNumber, VerticalPosition, VoiceId };
+export { Annotation, AnnotationText, type ColorAttr, Connective, DivRect, DocumentBuilder, type ExtensionBuilder, Fermata, Label, LyricsOptions, MDocument, MeasureOptions, Navigation, NoteAnchor, NoteOptions, RestOptions, ScoreConfiguration, StaffPreset, StaffTabOrGroups, TieType, type TupletBuilder, TupletOptions, VerseNumber, VerticalPosition, VoiceId, setColor };

package/dist/score/index.d.ts

@@ -1,10 +1,58 @@
-import { N as NoteOptions, R as RestOptions, S as StaffPreset, a as ScoreConfiguration, M as MDocument, b as MeasureOptions, V as VoiceId, T as TupletOptions, c as VerseNumber, L as LyricsOptions, d as StaffTabOrGroups, F as Fermata, e as Navigation, A as AnnotationText, f as Annotation, g as Label, C as Connective, h as TieType, i as NoteAnchor, j as VerticalPosition } from '../music-objects-T8u8bnNP.js';
-export { al as Arpeggio, a7 as BaseConfig, a6 as Clef, ap as DynamicsAnnotation, an as LyricsAlign, ao as LyricsHyphen, u as MAccidental, w as MArpeggio, I as MBarLineLeft, H as MBarLineRight, x as MBeamGroup, v as MConnective, z as MEnding, a5 as MExtensionLine, B as MFermata, D as MHeader, E as MImage, a4 as MLyrics, G as MMeasure, K as MNoteGroup, s as MPlaybackButtons, p as MPlayer, q as MRenderContext, r as MRenderer, Q as MRest, W as MRhythmColumn, X as MScoreRow, Y as MScoreRowGroup, a2 as MSpecialText, Z as MStaff, J as MStaffBarLine, y as MStaffBeamGroup, O as MStaffNoteGroup, U as MStaffRest, $ as MStaffSignature, _ as MTab, P as MTabNoteGroup, a1 as MTabRhythm, a0 as MTabSignature, a3 as MText, t as MusicInterface, ar as PlayState, as as PlayStateChangeListener, l as ScoreEvent, o as ScoreEventListener, k as ScoreEventType, n as ScoreObjectEvent, m as ScoreStaffPosEvent, a8 as StaffConfig, am as StaffTabOrGroup, ak as Stem, ad as StringNumber, a9 as TabConfig, aq as TempoAnnotation, ae as getStringNumbers, ah as getVerseNumbers, aa as getVoiceIds, af as isStringNumber, ai as isVerseNumber, ab as isVoiceId, ag as validateStringNumber, aj as validateVerseNumber, ac as validateVoiceId } from '../music-objects-T8u8bnNP.js';
-import { N as Note } from '../note-RVXvpfyV.js';
-import { S as ScaleType, c as Scale } from '../scale-CUYFBo-8.js';
-import { N as NoteLength, i as NoteLengthStr, K as KeySignature, b as TimeSignature, T as TimeSignatures, B as BeamGrouping, l as TupletRatio } from '../tempo-DwuZsv2T.js';
+import { N as NoteOptions, R as RestOptions, S as StaffPreset, a as ScoreConfiguration, M as MDocument, b as MeasureOptions, V as VoiceId, T as TupletOptions, c as VerseNumber, L as LyricsOptions, d as StaffTabOrGroups, F as Fermata, e as Navigation, A as AnnotationText, f as Annotation, g as Label, C as Connective, h as TieType, i as NoteAnchor, j as VerticalPosition } from '../music-objects-l5Ai97QA.js';
+export { al as Arpeggio, a7 as BaseConfig, a6 as Clef, ap as DynamicsAnnotation, an as LyricsAlign, ao as LyricsHyphen, u as MAccidental, w as MArpeggio, I as MBarLineLeft, H as MBarLineRight, x as MBeamGroup, v as MConnective, z as MEnding, a5 as MExtensionLine, B as MFermata, D as MHeader, E as MImage, a4 as MLyrics, G as MMeasure, K as MNoteGroup, s as MPlaybackButtons, p as MPlayer, q as MRenderContext, r as MRenderer, Q as MRest, W as MRhythmColumn, X as MScoreRow, Y as MScoreRowGroup, a2 as MSpecialText, Z as MStaff, J as MStaffBarLine, y as MStaffBeamGroup, O as MStaffNoteGroup, U as MStaffRest, $ as MStaffSignature, _ as MTab, P as MTabNoteGroup, a1 as MTabRhythm, a0 as MTabSignature, a3 as MText, t as MusicInterface, ar as PlayState, as as PlayStateChangeListener, l as ScoreEvent, o as ScoreEventListener, k as ScoreEventType, n as ScoreObjectEvent, m as ScoreStaffPosEvent, a8 as StaffConfig, am as StaffTabOrGroup, ak as Stem, ad as StringNumber, a9 as TabConfig, aq as TempoAnnotation, ae as getStringNumbers, ah as getVerseNumbers, aa as getVoiceIds, af as isStringNumber, ai as isVerseNumber, ab as isVoiceId, ag as validateStringNumber, aj as validateVerseNumber, ac as validateVoiceId } from '../music-objects-l5Ai97QA.js';
+import { N as Note } from '../note-CJuq5aBy.js';
+import { S as ScaleType, c as Scale } from '../scale-DulPFco_.js';
+import { N as NoteLength, i as NoteLengthStr, K as KeySignature, b as TimeSignature, T as TimeSignatures, B as BeamGrouping, l as TupletRatio } from '../tempo-BnUjm25M.js';
 import '@tspro/ts-utils-lib';
 
+/**
+ * Color attributes.
+ * ```
+ * Attribute hierarchy is:
+ *  + background
+ *  + header
+ *      + title
+ *      + composer
+ *      + arranger
+ *  + rowgroup
+ *      + instrument
+ *      + frame
+ *  + staff|tab
+ *      + frame
+ *      + note
+ *      + rest
+ *      + connective
+ *      + signature
+ *          + clef (staff only)
+ *          + key (staff only)
+ *          + time
+ *          + tempo
+ *          + measurenum
+ *      + tuning (tab only)
+ *      + element
+ *          + fermata
+ *          + annotation
+ *          + navigation
+ *          + label
+ * ```
+ */
+type ColorAttr = "background" | "header" | "title" | "composer" | "arranger" | "rowgroup" | "instrument" | "frame" | "staff" | "tab" | "frame" | "note" | "rest" | "connective" | "signature" | "clef" | "key" | "time" | "tempo" | "measurenum" | "tuning" | "element" | "fermata" | "annotation" | "navigation" | "label";
+/**
+ * Set color of any score document element. Use combination of color attributes to set color of specific elements.
+ * ```ts
+ * setColor("red", "staff");                        // Set color of all staff elements to red.
+ * setColor("red", "staff", "signature");           // Set color of all signature elements of staff to red.
+ * setColor("red", "staff", "key", "signature");    // Set color of key signature of staff to red.
+ * setColor("green", "staff", "time", "signature"); // Set color of time signature of staff to green.
+ * // etc.
+ * ```
+ * See {@link ColorAttr} for attribute hierarchy tree.
+ *
+ * @param color - Color (HTML color code e.g. "green", "#AA6644", etc.)
+ * @param colorAttrs - Any number of color attributes.
+ */
+declare function setColor(color: string, ...colorAttrs: ColorAttr[]): void;
+
 /**
  * @deprecated - Will be removed in `v6.0.0`. Use `AnchoredRect` from `@tspro/ts-utils-lib` instead.
  *
@@ -649,4 +697,4 @@ declare class DocumentBuilder {
     addScaleArpeggio(scale: Scale, bottomNote: string, numOctaves: number): DocumentBuilder;
 }
 
-export { Annotation, AnnotationText, Connective, DivRect, DocumentBuilder, type ExtensionBuilder, Fermata, Label, LyricsOptions, MDocument, MeasureOptions, Navigation, NoteAnchor, NoteOptions, RestOptions, ScoreConfiguration, StaffPreset, StaffTabOrGroups, TieType, type TupletBuilder, TupletOptions, VerseNumber, VerticalPosition, VoiceId };
+export { Annotation, AnnotationText, type ColorAttr, Connective, DivRect, DocumentBuilder, type ExtensionBuilder, Fermata, Label, LyricsOptions, MDocument, MeasureOptions, Navigation, NoteAnchor, NoteOptions, RestOptions, ScoreConfiguration, StaffPreset, StaffTabOrGroups, TieType, type TupletBuilder, TupletOptions, VerseNumber, VerticalPosition, VoiceId, setColor };