@tspro/web-music-score 5.3.0 → 5.4.1

package/dist/{music-objects-Ih9vCl4p.d.ts → music-objects-DumXKWJp.d.ts}

@@ -1,207 +1,6 @@
-import { N as Note, A as Accidental } from './note-CgCIBwvR.js';
-import { R as RhythmProps, N as NoteLength, i as NoteLengthStr, k as TupletRatio, d as Tempo, K as KeySignature, b as TimeSignature } from './tempo-DMt3iwz9.js';
-import { Vec2 } from '@tspro/ts-utils-lib';
-
-/**
- * DivRect class, left, top, right, bottom rectangle divided into four sections by centerX, centerY.
- */
-declare class DivRect {
-    left: number;
-    centerX: number;
-    right: number;
-    top: number;
-    centerY: number;
-    bottom: number;
-    /**
-     * Create rectangle with all zero values.
-     */
-    constructor();
-    /**
-     * Create rectangle with left, right, top, bottom.
-     * Properties centerX and centerY will be centered in the middle.
-     *
-     * @param left - Left coordinate.
-     * @param right - Right coordinate.
-     * @param top - Top coordinate.
-     * @param bottom - Bottom coordinate.
-     */
-    constructor(left: number, right: number, top: number, bottom: number);
-    /**
-     * Create rectangle with full arguments.
-     *
-     * @param left - Left coordinate.
-     * @param centerX - Center x-coordinate.
-     * @param right - Right coordinate.
-     * @param top - Top coordinate.
-     * @param centerY - Center y-coordinate.
-     * @param bottom - Bottom coordinate.
-     */
-    constructor(left: number, centerX: number, right: number, top: number, centerY: number, bottom: number);
-    /**
-     * Create rect from basic left, top, width and height arguments.
-     *
-     * @param left - Left coordinate.
-     * @param top - Top coordinate.
-     * @param width - With.
-     * @param height - Height.
-     * @returns - DivRect.
-     */
-    static create(left: number, top: number, width: number, height: number): DivRect;
-    /**
-     * Create rect from centerX, centerY, width, height arguments.
-     *
-     * @param centerX - Center x-coordinate.
-     * @param centerY - Center y-coordinate.
-     * @param width - Width.
-     * @param height - Height.
-     * @returns - DivRect.
-     */
-    static createCentered(centerX: number, centerY: number, width: number, height: number): DivRect;
-    /**
-     * Create rect from sections.
-     *
-     * @param leftw - Left section width.
-     * @param rightw - Right section width.
-     * @param toph - Top section height.
-     * @param bottomh - Bottomsection height.
-     * @returns - DivRect.
-     */
-    static createSections(leftw: number, rightw: number, toph: number, bottomh: number): DivRect;
-    /**
-     * Width getter.
-     */
-    get width(): number;
-    /**
-     * Height getter.
-     */
-    get height(): number;
-    /**
-     * Left section width getter.
-     */
-    get leftw(): number;
-    /**
-     * Right section width getter.
-     */
-    get rightw(): number;
-    /**
-     * Top section height getter.
-     */
-    get toph(): number;
-    /**
-     * Bottom section height getter.
-     */
-    get bottomh(): number;
-    /**
-     * Does this Rect contain given (x, y)-point?
-     *
-     * @param x - X-coordinate.
-     * @param y - Y-coordinate.
-     * @returns - True/false.
-     */
-    contains(x: number, y: number): boolean;
-    /**
-     * Do a and b rects overlap?
-     *
-     * @param a - DivRect a.
-     * @param b - DivRect b.
-     * @returns - True/false.
-     */
-    static overlap(a: DivRect, b: DivRect): boolean;
-    /**
-     * Do horizontal measures of a and b rects overlap?
-     *
-     * @param a - DivRect a.
-     * @param b - DivRect b.
-     * @returns - True/false.
-     */
-    static overlapX(a: DivRect, b: DivRect): boolean;
-    /**
-     * Check if this Rect equals with given Rect.
-     * @param a - DivRect a.
-     * @param b - DivRect b.
-     * @returns - True/false.
-     */
-    static equals(a: DivRect | null | undefined, b: DivRect | null | undefined): boolean;
-    /**
-     * Check if frame of this Rect equals with given Rect, ignoring center x- and center y-coordinates.
-     *
-     * @param a - DivRect a.
-     * @param b - DivRect b.
-     * @returns - True/false.
-     */
-    static equalsFrame(a: DivRect | null | undefined, b: DivRect | null | undefined): boolean;
-    /**
-     * Created duplicate of this Rect.
-     *
-     * @returns - Duplicate.
-     */
-    copy(): DivRect;
-    /**
-     * Move this rect by (dx, dy). Modifies this Rect.
-     *
-     * @param dx - Offset amount in x-direction.
-     * @param dy - Offset amount in y-direction.
-     * @returns - This DivRect instance.
-     */
-    offsetInPlace(dx: number, dy: number): DivRect;
-    /**
-     * Move this rect by (dx, dy). Immutable, returns modified copy.
-     *
-     * @param dx - Offset amount in x-direction.
-     * @param dy - Offset amount in y-direction.
-     * @returns - DivRect copy with applied offset.
-     */
-    offsetCopy(dx: number, dy: number): DivRect;
-    /**
-     * Expand this Rect by given Rect. Modifies this Rect.
-     *
-     * @param rect - DivRect to expand this instance with.
-     * @returns - This DivRect instance.
-     */
-    expandInPlace(rect: DivRect): DivRect;
-    /**
-     * Expand this Rect by given Rect. Immutable, returns modified copy.
-     *
-     * @param rect - DivRect to expand this instance with.
-     * @returns - Expanded copy of this DivRect.
-     */
-    expandCopy(rect: DivRect): DivRect;
-    /**
-     * Clip this Rect by given Rect. Mmodifies this Rect.
-     *
-     * @param clipRect - DivRect to clip this instance with.
-     * @returns - This DivRect instance.
-     */
-    clipInPlace(clipRect: DivRect): DivRect;
-    /**
-     * Clip this Rect by given Rect. Immutable, return modified copy.
-     *
-     * @param clipRect - DivRecto to clip this instance with.
-     * @returns - Clipped DivRect copy.
-     */
-    clipCopy(clipRect: DivRect): DivRect;
-    /**
-     * Scale Rect. Anchor pos is (centerX, centerY). Modifies this Rect.
-     *
-     * @param scaleX - Scale x-amount.
-     * @param scaleY - Scale y-amount. If undefined then scale x-amount is used.
-     * @returns This DivRect instance.
-     */
-    scaleInPlace(scaleX: number, scaleY?: number): DivRect;
-    /**
-     * Scale Rect. Anchor pos is (centerX, centerY). Immutable, returns modified copy.
-     *
-     * @param scaleX - Scale x-amount.
-     * @param scaleY - Scale y-amount. If undefined then scale x-amount is used.
-     * @returns Scaled copy of this DivRect.
-     */
-    scaleCopy(scaleX: number, scaleY?: number): DivRect;
-    /**
-     * Get this DivRect instance.
-     * @returns - This DivRect instance.
-     */
-    getRect(): DivRect;
-}
+import { N as Note, A as Accidental } from './note-RVXvpfyV.js';
+import { R as RhythmProps, N as NoteLength, i as NoteLengthStr, l as TupletRatio, d as Tempo, K as KeySignature, b as TimeSignature } from './tempo-DwuZsv2T.js';
+import { AnchoredRect, Rect, Vec } from '@tspro/ts-utils-lib';
 
 /** Staff preset values for score configuration. */
 declare enum StaffPreset {
@@ -269,14 +68,20 @@ type ScoreConfiguration = StaffConfig | TabConfig | (StaffConfig | TabConfig)[];
 type VoiceId = 0 | 1 | 2 | 3;
 /** Get supported voice ids. Returns [0, 1, 2, 3]. */
 declare function getVoiceIds(): ReadonlyArray<VoiceId>;
+declare function isVoiceId(voiceId: unknown): voiceId is VoiceId;
+declare function validateVoiceId(voiceId: unknown): VoiceId;
 /** Strng number. */
 type StringNumber = 1 | 2 | 3 | 4 | 5 | 6;
 /** Get string numbers. Returns [0, 1, 2, 3, 4, 5]. */
 declare function getStringNumbers(): ReadonlyArray<StringNumber>;
+declare function isStringNumber(stringNum: unknown): stringNum is VerseNumber;
+declare function validateStringNumber(stringNum: unknown): VerseNumber;
 /** Verse number. */
 type VerseNumber = 1 | 2 | 3;
 /** Get supported verse numbers. Returns [1, 2, 3]. */
 declare function getVerseNumbers(): ReadonlyArray<VerseNumber>;
+declare function isVerseNumber(verse: unknown): verse is VerseNumber;
+declare function validateVerseNumber(verseNum: unknown): VerseNumber;
 /** Stem direction enum. */
 declare enum Stem {
     /** Auto stem direction. */
@@ -566,7 +371,7 @@ declare class ObjText extends MusicObject {
 }
 
 type NotationLineObject = {
-    getRect: () => DivRect;
+    getRect: () => AnchoredRect;
     offset?: (dx: number, dy: number) => void;
     offsetInPlace?: (dx: number, dy: number) => void;
 };
@@ -675,12 +480,12 @@ declare class ObjTab extends ObjNotationLine {
 declare class ObjStaffNoteGroup extends MusicObject {
     readonly staff: ObjStaff;
     readonly noteGroup: ObjNoteGroup;
-    noteHeadRects: DivRect[];
-    dotRects: DivRect[];
+    noteHeadRects: AnchoredRect[];
+    dotRects: AnchoredRect[];
     accidentals: ObjAccidental[];
-    stemTip?: DivRect;
-    stemBase?: DivRect;
-    flagRects: DivRect[];
+    stemTip?: AnchoredRect;
+    stemBase?: AnchoredRect;
+    flagRects: AnchoredRect[];
     private prevTopNoteY;
     private prevBottomNoteY;
     readonly mi: MStaffNoteGroup;
@@ -688,7 +493,7 @@ declare class ObjStaffNoteGroup extends MusicObject {
     getMusicInterface(): MusicInterface;
     pick(x: number, y: number): MusicObject[];
     updateRect(): void;
-    getRect(): DivRect;
+    getRect(): AnchoredRect;
     offset(dx: number, dy: number): void;
 }
 declare class ObjTabNoteGroup extends MusicObject {
@@ -725,6 +530,7 @@ declare class ObjNoteGroup extends MusicObject {
     private beamGroup?;
     private readonly staffObjects;
     private readonly tabObjects;
+    private isNoteDisplaced;
     readonly mi: MNoteGroup;
     constructor(col: ObjRhythmColumn, voiceId: VoiceId, notes: ReadonlyArray<Note>, noteLength: NoteLength | NoteLengthStr, options?: NoteOptions | undefined, tupletRatio?: TupletRatio);
     getMusicInterface(): MNoteGroup;
@@ -735,10 +541,10 @@ declare class ObjNoteGroup extends MusicObject {
     get maxDiatonicId(): number;
     getDiatonicId(staff?: ObjStaff): number;
     get stemDir(): Stem.Up | Stem.Down;
+    setNoteDisplacement(note: Note, isDisplaced: boolean): void;
     enableConnective(line: ObjNotationLine): boolean;
     startConnective(connectiveProps: ConnectiveProps): void;
     updateRunningArguments(diatonicId: number, stemDir: Stem.Up | Stem.Down, stringNumbers: StringNumber[]): void;
-    getStaticObjects(line: ObjNotationLine): ReadonlyArray<MusicObject>;
     pick(x: number, y: number): MusicObject[];
     getTopNote(): Note;
     getBottomNote(): Note;
@@ -777,7 +583,7 @@ declare class ObjNoteGroup extends MusicObject {
     setStemTipY(staff: ObjStaff, stemTipY: number): void;
     offset(dx: number, dy: number): void;
     draw(ctx: RenderContext): void;
-    getDotVerticalDisplacement(staff: ObjStaff, diatonicId: number, stemDir: Stem): 1 | 0 | -1;
+    getDotVerticalDisplacement(staff: ObjStaff, diatonicId: number, stemDir: Stem): 0 | 1 | -1;
     static hasSameNotes(ng1: ObjNoteGroup, ng2: ObjNoteGroup): boolean;
 }
 
@@ -796,7 +602,7 @@ declare class BeamPoint {
     bottomBeamsHeight: number;
     constructor(staff: ObjStaff, beamGroup: ObjBeamGroup, symbol: RhythmSymbol, x: number, y: number);
     offset(dx: number, dy: number): void;
-    getRect(): DivRect;
+    getRect(): AnchoredRect;
 }
 declare class ObjStaffBeamGroup extends MusicObject {
     readonly staff: ObjStaff;
@@ -846,8 +652,8 @@ declare class ObjBeamGroup extends MusicObject {
 declare class ObjStaffRest extends MusicObject {
     readonly staff: ObjStaff;
     readonly rest: ObjRest;
-    restRect: DivRect;
-    dotRects: DivRect[];
+    restRect: AnchoredRect;
+    dotRects: AnchoredRect[];
     readonly mi: MStaffRest;
     constructor(staff: ObjStaff, rest: ObjRest);
     getMusicInterface(): MusicInterface;
@@ -941,7 +747,6 @@ declare class ObjRhythmColumn extends MusicObject {
     private staffMaxDiatonicId;
     private arpeggioDir;
     private arpeggios;
-    private noteHeadDisplacements;
     private readonly playerProps;
     private needLayout;
     private shapeRects;
@@ -961,8 +766,7 @@ declare class ObjRhythmColumn extends MusicObject {
      */
     getNextColumn(): ObjRhythmColumn | undefined;
     getTicksToNextColumn(): number;
-    getShapeRects(): DivRect[];
-    getStaticObjects(line: ObjNotationLine): ReadonlyArray<MusicObject>;
+    getShapeRects(): AnchoredRect[];
     get doc(): ObjDocument;
     get row(): ObjScoreRow;
     pick(x: number, y: number): MusicObject[];
@@ -972,13 +776,12 @@ declare class ObjRhythmColumn extends MusicObject {
     getVoiceSymbol(voiceId: VoiceId): RhythmSymbol | undefined;
     getLyricsObject(verse: VerseNumber, line: ObjNotationLine, vpos: VerticalPos): ObjLyrics | undefined;
     addLyricsObject(lyricsObj: ObjLyrics): void;
-    getMinWidth(): number;
-    setupNoteHeadDisplacements(): void;
-    getNoteHeadDisplacement(noteGroup: ObjNoteGroup, note: Note): -1 | 0 | 1;
+    updateNoteDisplacements(): void;
     isEmpty(): boolean;
     getPlayerNotes(): ScorePlayerNote[];
     requestLayout(): void;
     layout(ctx: RenderContext, accState: AccidentalState): void;
+    layoutReserveSpace(ctx: RenderContext): void;
     layoutDone(): void;
     updateRect(): void;
     offset(dx: number, dy: number): void;
@@ -1027,7 +830,7 @@ declare class ObjStaffTabBarLine extends MusicObject {
     constructor(barLine: ObjBarLine, line: ObjNotationLine);
     getMusicInterface(): MusicInterface;
     pick(x: number, y: number): MusicObject[];
-    setRect(r: DivRect): void;
+    setRect(r: AnchoredRect): void;
     offset(dx: number, dy: number): void;
 }
 declare abstract class ObjBarLine extends MusicObject {
@@ -1090,7 +893,6 @@ declare class ObjConnective extends MusicObject {
 declare class ObjMeasure extends MusicObject {
     readonly row: ObjScoreRow;
     private readonly options;
-    static readonly MinFlexContentWidth = 10;
     private prevMeasure;
     private nextMeasure;
     private keySignature;
@@ -1106,12 +908,9 @@ declare class ObjMeasure extends MusicObject {
     private barLineRight;
     private connectives;
     private beamGroups;
-    private tabStringNotesWidth;
     private measureId;
+    private regions;
     private needLayout;
-    private leftSolidAreaWidth;
-    private minColumnsAreaWidth;
-    private rightSolidAreaWidth;
     private voiceSymbols;
     private lastAddedRhythmColumn?;
     private lastAddedRhythmSymbol?;
@@ -1194,17 +993,17 @@ declare class ObjMeasure extends MusicObject {
     private getRhythmColumn;
     getMeasureTicks(): number;
     getConsumedTicks(voiceId?: VoiceId): number;
-    getColumnsContentRect(): DivRect;
-    getLeftSolidAreaWidth(): number;
-    getMinColumnsAreaWidth(): number;
-    getRightSolidAreaWidth(): number;
-    getSolidAreaWidth(): number;
+    getColumnsContentRect(): AnchoredRect;
+    getLeftSolidWidth(): number;
+    getMinColumnsWidth(): number;
+    getRightSolidWidth(): number;
+    getTotalSolidWidth(): number;
     getMinWidth(): number;
     getStaffLineLeft(): number;
     getStaffLineRight(): number;
-    private getLyricsObjects;
     getPrevLyricsObject(lyricsObj: ObjLyrics): ObjLyrics | undefined;
     getStaticObjects(line: ObjNotationLine): ReadonlyArray<MusicObject>;
+    addStaticObject(line: ObjNotationLine, staticObj: MusicObject): void;
     removeLayoutObjects(musicObj: MusicObject): void;
     addConnectiveObject(connective: ObjConnective): void;
     removeConnectiveObjects(): void;
@@ -1260,7 +1059,7 @@ declare class ObjScoreRow extends MusicObject {
     resetLayoutGroups(ctx: RenderContext): void;
     layoutLayoutGroups(ctx: RenderContext): void;
     pick(x: number, y: number): MusicObject[];
-    getConnectivesContentRect(): DivRect;
+    getConnectivesContentRect(): AnchoredRect;
     getDiatonicIdAt(y: number): number | undefined;
     addMeasure(m: ObjMeasure): void;
     getMeasures(): ReadonlyArray<ObjMeasure>;
@@ -1285,6 +1084,15 @@ declare class ObjScoreRow extends MusicObject {
     draw(ctx: RenderContext): void;
 }
 
+declare class InstrumentGroupRegions {
+    nameLeft: number;
+    nameRight: number;
+    braceLeft: number;
+    braceRight: number;
+    get left(): number;
+    get right(): number;
+    get width(): number;
+}
 declare class ObjDocument extends MusicObject {
     private needLayout;
     private ctx?;
@@ -1296,6 +1104,7 @@ declare class ObjDocument extends MusicObject {
     private newRowRequested;
     private allConnectiveProps;
     private staffGroups;
+    private instrumentGroupRegions;
     private readonly mi;
     constructor();
     getMusicInterface(): MDocument;
@@ -1323,13 +1132,8 @@ declare class ObjDocument extends MusicObject {
     removeLayoutObjects(musicObj: MusicObject): void;
     private forEachMeasure;
     resetMeasures(): void;
-    updateCursorRect(cursorRect?: DivRect): void;
-    getInstrumentGroupSize(ctx: RenderContext): {
-        nameLeft: number;
-        nameRight: number;
-        braceLeft: number;
-        braceRight: number;
-    };
+    updateCursorRect(cursorRect?: Rect): void;
+    getInstrumentGroupRegions(ctx: RenderContext): InstrumentGroupRegions;
     requestLayout(): void;
     requestFullLayout(): void;
     layout(): void;
@@ -1375,7 +1179,7 @@ declare class RenderContext {
     setCanvas(canvas: HTMLCanvasElement): void;
     setScoreEventListener(fn: ScoreEventListener): void;
     needMouseInput(): boolean;
-    getMousePos(e: MouseEvent): Vec2;
+    getMousePos(e: MouseEvent): Vec;
     private updateCurStaffPos;
     private updateCurObjects;
     onClick(e: MouseEvent): void;
@@ -1388,20 +1192,20 @@ declare class RenderContext {
         scoreRow: ObjScoreRow;
         diatonicId: number;
     }): void;
-    updateCursorRect(cursorRect: DivRect | undefined): void;
+    updateCursorRect(cursorRect: Rect | undefined): void;
     updateCanvasSize(): void;
     draw(): void;
     drawHilightStaffPosRect(): void;
     drawHilightObjectRect(): void;
     drawPlayCursor(): void;
-    txFromScreenCoord(screenCoord: Vec2): Vec2;
-    txToScreenCoord(coord: Vec2): Vec2;
+    txFromScreenCoord(screenCoord: Vec): Vec;
+    txToScreenCoord(coord: Vec): Vec;
     clearCanvas(): void;
-    drawDebugRect(r: DivRect): void;
+    drawDebugRect(r: AnchoredRect | Rect): void;
     drawLedgerLines(staff: ObjStaff, diatonicId: number, x: number): void;
-    getRestRect(restSize: number): DivRect;
+    getRestRect(restSize: number): AnchoredRect;
     drawRest(restSize: number, x: number, y: number): void;
-    drawFlag(rect: DivRect, dir: "up" | "down"): void;
+    drawFlag(rect: Rect | AnchoredRect, dir: "up" | "down"): void;
     color(color: string): RenderContext;
     lineColor(color: string): RenderContext;
     fillColor(color: string): RenderContext;
@@ -1430,7 +1234,7 @@ declare class RenderContext {
     fillCircle(x: number, y: number, radius: number): void;
     strokeLine(startX: number, startY: number, endX: number, endY: number): void;
     strokePartialLine(startX: number, startY: number, endX: number, endY: number, startT: number, endT: number): void;
-    drawBrace(rect: DivRect, side: "left" | "right"): void;
+    drawBrace(rect: AnchoredRect, side: "left" | "right"): void;
 }
 
 declare class ObjEnding extends MusicObject {
@@ -1441,7 +1245,7 @@ declare class ObjEnding extends MusicObject {
     readonly mi: MEnding;
     constructor(measure: ObjMeasure, passages: number[]);
     getMusicInterface(): MEnding;
-    getShapeRects(): DivRect[];
+    getShapeRects(): AnchoredRect[];
     isSingleMeasureEnding(): boolean;
     hasPassage(pass: number): boolean;
     getHighestPassage(): number;
@@ -1576,25 +1380,27 @@ declare class LayoutObjectWrapper {
     readonly layoutGroup: LayoutGroup;
     private positionResolved;
     constructor(musicObj: LayoutableMusicObject, line: ObjNotationLine, layoutGroupId: LayoutGroupId, verticalPos: VerticalPos);
-    clearPositionResolved(): void;
+    resetPositionResolved(): void;
     setPositionResolved(): void;
     isPositionResolved(): boolean;
     resolveClosestToStaffY(ctx: RenderContext): number;
     getTextContent(): string | undefined;
     layout(ctx: RenderContext): void;
     offset(dx: number, dy: number): void;
-    getRect(): DivRect;
+    getRect(): AnchoredRect;
 }
 declare class LayoutGroup {
     readonly layoutGroupId: number;
-    private readonly layoutObjectTable;
+    private readonly layoutObject;
     readonly rowAlign: boolean;
-    readonly widensColumn: boolean;
+    readonly reserveSpace: boolean;
+    readonly padding: number;
     constructor(layoutGroupId: number);
     getLayoutObjects(verticalPos: VerticalPos): Readonly<LayoutObjectWrapper[]>;
     add(layoutObj: LayoutObjectWrapper): void;
     remove(layoutObj: LayoutObjectWrapper): void;
-    clearPositionAndLayout(ctx: RenderContext): void;
+    layout(ctx: RenderContext): void;
+    getPadding(ctx: RenderContext): number;
 }
 
 declare class MusicObjectLink {
@@ -1613,11 +1419,11 @@ declare abstract class MusicObject {
     constructor(parent: MusicObject | undefined);
     abstract getMusicInterface(): MusicInterface;
     getParent(): MusicObject | undefined;
-    protected rect: DivRect;
+    protected rect: AnchoredRect;
     private needRectUpdate;
     requestRectUpdate(): void;
     updateRect(): void;
-    getRect(): DivRect;
+    getRect(): AnchoredRect;
     /**
      * Most objects are simple rects in shape.
      * Some objects might be more complex consisting of multiple rects.
@@ -1625,7 +1431,7 @@ declare abstract class MusicObject {
      *
      * @returns Array of rects.
      */
-    getShapeRects(): DivRect[];
+    getShapeRects(): AnchoredRect[];
     /**
      * Pick objects.
      *
@@ -2543,4 +2349,4 @@ declare class MExtensionLine extends MusicInterface {
     getMusicObject(): ObjExtensionLine;
 }
 
-export { MStaffSignature as $, type AnnotationText as A, MFermata as B, Connective as C, DivRect as D, MHeader as E, Fermata as F, MImage as G, MMeasure as H, MBarLineRight as I, MBarLineLeft as J, MStaffTabBarLine as K, type LyricsOptions as L, MDocument as M, type NoteOptions as N, MNoteGroup as O, MStaffNoteGroup as P, MTabNoteGroup as Q, type RestOptions as R, StaffPreset as S, type TupletOptions as T, MRest as U, type VoiceId as V, MStaffRest as W, MRhythmColumn as X, MScoreRow as Y, MStaff as Z, MTab as _, type ScoreConfiguration as a, MTabSignature as a0, MTabRhythm as a1, MSpecialText as a2, MText as a3, MLyrics as a4, MExtensionLine as a5, Clef as a6, type BaseConfig as a7, type StaffConfig as a8, type TabConfig as a9, getVoiceIds as aa, type StringNumber as ab, getStringNumbers as ac, getVerseNumbers as ad, Stem as ae, Arpeggio as af, type StaffTabOrGroup as ag, LyricsAlign as ah, LyricsHyphen as ai, DynamicsAnnotation as aj, TempoAnnotation as ak, PlayState as al, type PlayStateChangeListener as am, type MeasureOptions as b, type VerseNumber as c, type StaffTabOrGroups as d, Navigation as e, Annotation as f, Label as g, TieType as h, NoteAnchor as i, VerticalPosition as j, type ScoreEventType as k, ScoreEvent as l, ScoreStaffPosEvent as m, ScoreObjectEvent as n, type ScoreEventListener as o, MPlayer as p, MRenderContext as q, MRenderer as r, MPlaybackButtons as s, MusicInterface as t, MAccidental as u, MConnective as v, MArpeggio as w, MBeamGroup as x, MStaffBeamGroup as y, MEnding as z };
+export { MTabSignature as $, type AnnotationText as A, MFermata as B, Connective as C, MHeader as D, MImage as E, Fermata as F, MMeasure as G, MBarLineRight as H, MBarLineLeft as I, MStaffTabBarLine as J, MNoteGroup as K, type LyricsOptions as L, MDocument as M, type NoteOptions as N, MStaffNoteGroup as O, MTabNoteGroup as P, MRest as Q, type RestOptions as R, StaffPreset as S, type TupletOptions as T, MStaffRest as U, type VoiceId as V, MRhythmColumn as W, MScoreRow as X, MStaff as Y, MTab as Z, MStaffSignature as _, type ScoreConfiguration as a, MTabRhythm as a0, MSpecialText as a1, MText as a2, MLyrics as a3, MExtensionLine as a4, Clef as a5, type BaseConfig as a6, type StaffConfig as a7, type TabConfig as a8, getVoiceIds as a9, isVoiceId as aa, validateVoiceId as ab, type StringNumber as ac, getStringNumbers as ad, isStringNumber as ae, validateStringNumber as af, getVerseNumbers as ag, isVerseNumber as ah, validateVerseNumber as ai, Stem as aj, Arpeggio as ak, type StaffTabOrGroup as al, LyricsAlign as am, LyricsHyphen as an, DynamicsAnnotation as ao, TempoAnnotation as ap, PlayState as aq, type PlayStateChangeListener as ar, type MeasureOptions as b, type VerseNumber as c, type StaffTabOrGroups as d, Navigation as e, Annotation as f, Label as g, TieType as h, NoteAnchor as i, VerticalPosition as j, type ScoreEventType as k, ScoreEvent as l, ScoreStaffPosEvent as m, ScoreObjectEvent as n, type ScoreEventListener as o, MPlayer as p, MRenderContext as q, MRenderer as r, MPlaybackButtons as s, MusicInterface as t, MAccidental as u, MConnective as v, MArpeggio as w, MBeamGroup as x, MStaffBeamGroup as y, MEnding as z };

package/dist/{note-eA2xPPiG.d.mts → note-RVXvpfyV.d.mts}

@@ -63,7 +63,7 @@ type ParsedNote = {
 };
 /** Note class. */
 declare class Note {
-    private static noteByNameCache;
+    private static noteCache;
     private static chromaticNoteCache;
     /** Diatonic class */
     readonly diatonicClass: number;
@@ -120,6 +120,18 @@ declare class Note {
      * @returns - Note.
      */
     static getNote(noteName: string): Note;
+    /**
+     * Test if given note name valid.
+     * @param noteName - Note name.
+     * @returns - True/false.
+     */
+    static isNote(noteName: string): boolean;
+    /**
+     * Validate given note name.
+     * @param noteName - Note name.
+     * @returns - True or throws.
+     */
+    static validateNote(noteName: string): true;
     /**
      * Get chromatic note. There are number of alternatives, this function uses simple logic to choose one.
      * @param chromaticId - Chromatic id.

package/dist/{note-CgCIBwvR.d.ts → note-RVXvpfyV.d.ts}

@@ -63,7 +63,7 @@ type ParsedNote = {
 };
 /** Note class. */
 declare class Note {
-    private static noteByNameCache;
+    private static noteCache;
     private static chromaticNoteCache;
     /** Diatonic class */
     readonly diatonicClass: number;
@@ -120,6 +120,18 @@ declare class Note {
      * @returns - Note.
      */
     static getNote(noteName: string): Note;
+    /**
+     * Test if given note name valid.
+     * @param noteName - Note name.
+     * @returns - True/false.
+     */
+    static isNote(noteName: string): boolean;
+    /**
+     * Validate given note name.
+     * @param noteName - Note name.
+     * @returns - True or throws.
+     */
+    static validateNote(noteName: string): true;
     /**
      * Get chromatic note. There are number of alternatives, this function uses simple logic to choose one.
      * @param chromaticId - Chromatic id.
@@ -288,7 +300,7 @@ declare class Note {
      * @param b - Note b.
      * @returns - -1, 0 or 1.
      */
-    static compareFunc(a: Note, b: Note): 1 | -1 | 0;
+    static compareFunc(a: Note, b: Note): 1 | 0 | -1;
 }
 
 export { type Accidental as A, DefaultPitchNotation as D, GuitarNoteLabel as G, Note as N, type ParsedNote as P, SymbolSet as S, type NoteLetter as a, PitchNotation as b, PitchNotationList as c, DefaultGuitarNoteLabel as d, GuitarNoteLabelList as e, validateGuitarNoteLabel as f, getPitchNotationName as g, validatePitchNotation as v };

package/dist/pieces/index.d.mts

@@ -1,6 +1,6 @@
-import { M as MDocument } from '../music-objects-BGiRQIXW.mjs';
-import '../note-eA2xPPiG.mjs';
-import '../tempo-dkctPkCS.mjs';
+import { M as MDocument } from '../music-objects-DYMqx839.mjs';
+import '../note-RVXvpfyV.mjs';
+import '../tempo-BlCGZuYg.mjs';
 import '@tspro/ts-utils-lib';
 
 /**

package/dist/pieces/index.d.ts

@@ -1,6 +1,6 @@
-import { M as MDocument } from '../music-objects-Ih9vCl4p.js';
-import '../note-CgCIBwvR.js';
-import '../tempo-DMt3iwz9.js';
+import { M as MDocument } from '../music-objects-DumXKWJp.js';
+import '../note-RVXvpfyV.js';
+import '../tempo-DwuZsv2T.js';
 import '@tspro/ts-utils-lib';
 
 /**

package/dist/pieces/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;

package/dist/pieces/index.mjs

@@ -1,5 +1,5 @@
-/* WebMusicScore v5.3.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
-import "../chunk-C6UQDKWU.mjs";
+/* WebMusicScore v5.4.1 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+import "../chunk-U2ACCEHX.mjs";
 
 // src/pieces/canon-pachelbel.ts
 import { DocumentBuilder } from "@tspro/web-music-score/score";