@tspro/web-music-score 5.4.1 → 5.4.2

package/dist/{music-objects-DYMqx839.d.mts → music-objects-DqoO-Sfv.d.mts}

@@ -1,6 +1,6 @@
-import { N as Note, A as Accidental } from './note-RVXvpfyV.mjs';
-import { R as RhythmProps, N as NoteLength, i as NoteLengthStr, l as TupletRatio, d as Tempo, K as KeySignature, b as TimeSignature } from './tempo-BlCGZuYg.mjs';
-import { AnchoredRect, Rect, Vec } from '@tspro/ts-utils-lib';
+import { N as Note, A as Accidental } from './note-CJuq5aBy.mjs';
+import { R as RhythmProps, N as NoteLength, i as NoteLengthStr, l as TupletRatio, d as Tempo, K as KeySignature, b as TimeSignature } from './tempo-Cxu8vusu.mjs';
+import { AnchoredRect, UniMap, Rect, Vec } from '@tspro/ts-utils-lib';
 
 /** Staff preset values for score configuration. */
 declare enum StaffPreset {
@@ -805,6 +805,26 @@ declare class PlayerColumnProps {
     getFermataHoldTicks(): number;
 }
 
+declare class ObjScoreRowGroup extends MusicObject {
+    readonly lines: readonly ObjNotationLine[];
+    private space;
+    readonly instrument: string;
+    private readonly instrText;
+    private braceRect;
+    readonly mi: MScoreRowGroup;
+    constructor(lines: readonly ObjNotationLine[]);
+    getMusicInterface(): MScoreRowGroup;
+    get row(): ObjScoreRow;
+    get hasBrace(): boolean;
+    get hasInstrument(): boolean;
+    pick(x: number, y: number): MusicObject[];
+    updateRect(): void;
+    layout(ctx: RenderContext): void;
+    layoutToNotationLines(): void;
+    offset(dx: number, dy: number): void;
+    draw(ctx: RenderContext): void;
+}
+
 declare enum BarLineType {
     None = 0,
     Single = 1,
@@ -814,10 +834,10 @@ declare enum BarLineType {
     EndRepeat = 5,
     EndStartRepeat = 6
 }
-declare class ObjStaffTabBarLine extends MusicObject {
+declare class ObjStaffBarLine extends MusicObject {
     readonly barLine: ObjBarLine;
     readonly line: ObjNotationLine;
-    verticalLines: {
+    vlines: {
         left: number;
         width: number;
     }[];
@@ -826,17 +846,17 @@ declare class ObjStaffTabBarLine extends MusicObject {
         y: number;
         r: number;
     }[];
-    readonly mi: MStaffTabBarLine;
+    readonly mi: MStaffBarLine;
     constructor(barLine: ObjBarLine, line: ObjNotationLine);
     getMusicInterface(): MusicInterface;
     pick(x: number, y: number): MusicObject[];
-    setRect(r: AnchoredRect): void;
+    updateRect(): void;
     offset(dx: number, dy: number): void;
 }
 declare abstract class ObjBarLine extends MusicObject {
     readonly measure: ObjMeasure;
-    protected staffTabObjects: ObjStaffTabBarLine[];
-    protected staffTabObjectGroups: ObjStaffTabBarLine[][];
+    protected notationLineObjects: ObjStaffBarLine[];
+    protected notationLineObjectsByGrp: UniMap<ObjScoreRowGroup, ObjStaffBarLine[]>;
     protected barLineType: BarLineType;
     constructor(measure: ObjMeasure);
     abstract solveBarLineType(): BarLineType;
@@ -1029,17 +1049,29 @@ declare class ObjMeasure extends MusicObject {
     draw(ctx: RenderContext): void;
 }
 
+declare class ScoreRowRegions {
+    instrWidth: number;
+    staffWidth: number;
+    resetWidths(): void;
+    addRowInstrWidth(w: number): void;
+    addRowstaffWidth(w: number): void;
+    get instrLeft(): number;
+    get instrRight(): number;
+    get staffLeft(): number;
+    get staffRight(): number;
+    get left(): number;
+    get right(): number;
+    get width(): number;
+}
 declare class ObjScoreRow extends MusicObject {
     readonly doc: ObjDocument;
     private readonly prevRow;
     private readonly scoreConfig;
     private nextRow?;
-    private minWidth;
     private readonly notationLines;
-    private readonly instrumentLineGroups;
+    private readonly rowGroups;
     private readonly staves;
     private readonly tabs;
-    private readonly instrumentNames;
     private readonly measures;
     private needLayout;
     readonly mi: MScoreRow;
@@ -1047,8 +1079,9 @@ declare class ObjScoreRow extends MusicObject {
     getMusicInterface(): MScoreRow;
     private createNotationLines;
     getNotationLines(): ReadonlyArray<ObjNotationLine>;
-    getInstrumentLineGroups(): ReadonlyArray<ReadonlyArray<ObjNotationLine>>;
+    getRowGroups(): ReadonlyArray<ObjScoreRowGroup>;
     findMatchingLine(line: ObjNotationLine): ObjNotationLine | undefined;
+    get regions(): ScoreRowRegions;
     getStaves(): ReadonlyArray<ObjStaff>;
     getTabs(): ReadonlyArray<ObjTab>;
     get hasStaff(): boolean;
@@ -1069,33 +1102,22 @@ declare class ObjScoreRow extends MusicObject {
     getNextRow(): ObjScoreRow | undefined;
     getFirstMeasure(): ObjMeasure | undefined;
     getLastMeasure(): ObjMeasure | undefined;
-    getMinWidth(): number;
     solveAutoStemDir(symbols: ReadonlyArray<RhythmSymbol>): Stem.Up | Stem.Down;
-    getInstrumentNameWidth(ctx: RenderContext): number;
     requestLayout(): void;
     layout(ctx: RenderContext): void;
-    layoutWidth(ctx: RenderContext, left: number, right: number): void;
+    layoutStretch(ctx: RenderContext): void;
     updateRect(): void;
     alignStemsToBeams(): void;
     layoutSetNotationLines(ctx: RenderContext): void;
-    layoutPadding(ctx: RenderContext): void;
     layoutDone(): void;
     offset(dx: number, dy: number): void;
     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?;
+    readonly regions: ScoreRowRegions;
     private readonly rows;
     private readonly measures;
     private measuresPerRow;
@@ -1104,7 +1126,6 @@ declare class ObjDocument extends MusicObject {
     private newRowRequested;
     private allConnectiveProps;
     private staffGroups;
-    private instrumentGroupRegions;
     private readonly mi;
     constructor();
     getMusicInterface(): MDocument;
@@ -1133,10 +1154,10 @@ declare class ObjDocument extends MusicObject {
     private forEachMeasure;
     resetMeasures(): void;
     updateCursorRect(cursorRect?: Rect): void;
-    getInstrumentGroupRegions(ctx: RenderContext): InstrumentGroupRegions;
     requestLayout(): void;
     requestFullLayout(): void;
     layout(): void;
+    offset(dx: number, dy: number): void;
     drawContent(): void;
     pickStaffPosAt(x: number, y: number): {
         scoreRow: ObjScoreRow;
@@ -1230,11 +1251,13 @@ declare class RenderContext {
     strokeRect(x: number, y: number, w: number, h: number): RenderContext;
     fillText(text: string, x: number, y: number): RenderContext;
     getTextWidth(text: string, font: string): number;
-    arc(x: number, y: number, radius: number, startRadians: number, endRadians: number): void;
-    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: AnchoredRect, side: "left" | "right"): void;
+    arc(x: number, y: number, radius: number, startRadians: number, endRadians: number): RenderContext;
+    fillCircle(x: number, y: number, radius: number): RenderContext;
+    strokeLine(startX: number, startY: number, endX: number, endY: number): RenderContext;
+    strokePartialLine(startX: number, startY: number, endX: number, endY: number, startT: number, endT: number): RenderContext;
+    /** @deprecated - Use {@link drawBracket} instead. */
+    drawBrace(rect: AnchoredRect, side: "left" | "right"): RenderContext;
+    drawBracket(rect: AnchoredRect, bracket: "(" | ")" | "[" | "]" | "{" | "}" | "<" | ">"): RenderContext;
 }
 
 declare class ObjEnding extends MusicObject {
@@ -1387,6 +1410,7 @@ declare class LayoutObjectWrapper {
     getTextContent(): string | undefined;
     layout(ctx: RenderContext): void;
     offset(dx: number, dy: number): void;
+    setAnchorY(y: number): void;
     getRect(): AnchoredRect;
 }
 declare class LayoutGroup {
@@ -1423,7 +1447,21 @@ declare abstract class MusicObject {
     private needRectUpdate;
     requestRectUpdate(): void;
     updateRect(): void;
+    forceRectUpdate(): void;
     getRect(): AnchoredRect;
+    abstract offset(dx: number, dy: number): void;
+    offsetX(dx: number): void;
+    offsetY(dy: number): void;
+    setLeft(x: number): void;
+    setRight(x: number): void;
+    setTop(y: number): void;
+    setBottom(y: number): void;
+    setAnchor(x: number, y: number): void;
+    setAnchorX(x: number): void;
+    setAnchorY(y: number): void;
+    setCenter(x: number, y: number): void;
+    setCenterX(x: number): void;
+    setCenterY(y: number): void;
     /**
      * Most objects are simple rects in shape.
      * Some objects might be more complex consisting of multiple rects.
@@ -1466,6 +1504,7 @@ declare class ObjArpeggio extends MusicObject {
 }
 
 declare class ObjHeader extends MusicObject {
+    readonly doc: ObjDocument;
     readonly title?: string | undefined;
     readonly composer?: string | undefined;
     readonly arranger?: string | undefined;
@@ -1476,7 +1515,7 @@ declare class ObjHeader extends MusicObject {
     constructor(doc: ObjDocument, title?: string | undefined, composer?: string | undefined, arranger?: string | undefined);
     getMusicInterface(): MHeader;
     pick(x: number, y: number): MusicObject[];
-    layoutWidth(ctx: RenderContext, left: number, right: number): void;
+    layout(ctx: RenderContext): void;
     offset(dx: number, dy: number): void;
     draw(ctx: RenderContext): void;
 }
@@ -1976,14 +2015,14 @@ declare class MBarLineLeft extends MusicInterface {
     getMusicObject(): ObjBarLineLeft;
 }
 /** Bar line object for certain staff or tab. */
-declare class MStaffTabBarLine extends MusicInterface {
+declare class MStaffBarLine extends MusicInterface {
     private readonly obj;
     /** Object name. */
-    static readonly Name = "StaffTabBarLine";
+    static readonly Name = "StaffBarLine";
     /** @internal */
-    constructor(obj: ObjStaffTabBarLine);
+    constructor(obj: ObjStaffBarLine);
     /** @internal */
-    getMusicObject(): ObjStaffTabBarLine;
+    getMusicObject(): ObjStaffBarLine;
     /**
      * Get parent bar line object.
      * @returns - Parent bar line object.
@@ -2193,6 +2232,21 @@ declare class MScoreRow extends MusicInterface {
      */
     getNotationLines(): ReadonlyArray<MStaff | MTab>;
 }
+/** Score row group object. */
+declare class MScoreRowGroup extends MusicInterface {
+    private readonly obj;
+    /** Object name. */
+    static readonly Name = "ScoreRowGroup";
+    /** @internal */
+    constructor(obj: ObjScoreRowGroup);
+    /** @internal */
+    getMusicObject(): ObjScoreRowGroup;
+    /**
+     * Get instrument name.
+     * @returns - instrument name.
+     */
+    getInstrument(): string;
+}
 /** Staff notatio line object. */
 declare class MStaff extends MusicInterface {
     private readonly obj;
@@ -2349,4 +2403,4 @@ declare class MExtensionLine extends MusicInterface {
     getMusicObject(): ObjExtensionLine;
 }
 
-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 };
+export { MStaffSignature 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, MStaffBarLine 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, MScoreRowGroup 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, isVoiceId as ab, validateVoiceId as ac, type StringNumber as ad, getStringNumbers as ae, isStringNumber as af, validateStringNumber as ag, getVerseNumbers as ah, isVerseNumber as ai, validateVerseNumber as aj, Stem as ak, Arpeggio as al, type StaffTabOrGroup as am, LyricsAlign as an, LyricsHyphen as ao, DynamicsAnnotation as ap, TempoAnnotation as aq, PlayState as ar, type PlayStateChangeListener as as, 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/{music-objects-DumXKWJp.d.ts → music-objects-T8u8bnNP.d.ts}

@@ -1,6 +1,6 @@
 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';
+import { AnchoredRect, UniMap, Rect, Vec } from '@tspro/ts-utils-lib';
 
 /** Staff preset values for score configuration. */
 declare enum StaffPreset {
@@ -805,6 +805,26 @@ declare class PlayerColumnProps {
     getFermataHoldTicks(): number;
 }
 
+declare class ObjScoreRowGroup extends MusicObject {
+    readonly lines: readonly ObjNotationLine[];
+    private space;
+    readonly instrument: string;
+    private readonly instrText;
+    private braceRect;
+    readonly mi: MScoreRowGroup;
+    constructor(lines: readonly ObjNotationLine[]);
+    getMusicInterface(): MScoreRowGroup;
+    get row(): ObjScoreRow;
+    get hasBrace(): boolean;
+    get hasInstrument(): boolean;
+    pick(x: number, y: number): MusicObject[];
+    updateRect(): void;
+    layout(ctx: RenderContext): void;
+    layoutToNotationLines(): void;
+    offset(dx: number, dy: number): void;
+    draw(ctx: RenderContext): void;
+}
+
 declare enum BarLineType {
     None = 0,
     Single = 1,
@@ -814,10 +834,10 @@ declare enum BarLineType {
     EndRepeat = 5,
     EndStartRepeat = 6
 }
-declare class ObjStaffTabBarLine extends MusicObject {
+declare class ObjStaffBarLine extends MusicObject {
     readonly barLine: ObjBarLine;
     readonly line: ObjNotationLine;
-    verticalLines: {
+    vlines: {
         left: number;
         width: number;
     }[];
@@ -826,17 +846,17 @@ declare class ObjStaffTabBarLine extends MusicObject {
         y: number;
         r: number;
     }[];
-    readonly mi: MStaffTabBarLine;
+    readonly mi: MStaffBarLine;
     constructor(barLine: ObjBarLine, line: ObjNotationLine);
     getMusicInterface(): MusicInterface;
     pick(x: number, y: number): MusicObject[];
-    setRect(r: AnchoredRect): void;
+    updateRect(): void;
     offset(dx: number, dy: number): void;
 }
 declare abstract class ObjBarLine extends MusicObject {
     readonly measure: ObjMeasure;
-    protected staffTabObjects: ObjStaffTabBarLine[];
-    protected staffTabObjectGroups: ObjStaffTabBarLine[][];
+    protected notationLineObjects: ObjStaffBarLine[];
+    protected notationLineObjectsByGrp: UniMap<ObjScoreRowGroup, ObjStaffBarLine[]>;
     protected barLineType: BarLineType;
     constructor(measure: ObjMeasure);
     abstract solveBarLineType(): BarLineType;
@@ -1029,17 +1049,29 @@ declare class ObjMeasure extends MusicObject {
     draw(ctx: RenderContext): void;
 }
 
+declare class ScoreRowRegions {
+    instrWidth: number;
+    staffWidth: number;
+    resetWidths(): void;
+    addRowInstrWidth(w: number): void;
+    addRowstaffWidth(w: number): void;
+    get instrLeft(): number;
+    get instrRight(): number;
+    get staffLeft(): number;
+    get staffRight(): number;
+    get left(): number;
+    get right(): number;
+    get width(): number;
+}
 declare class ObjScoreRow extends MusicObject {
     readonly doc: ObjDocument;
     private readonly prevRow;
     private readonly scoreConfig;
     private nextRow?;
-    private minWidth;
     private readonly notationLines;
-    private readonly instrumentLineGroups;
+    private readonly rowGroups;
     private readonly staves;
     private readonly tabs;
-    private readonly instrumentNames;
     private readonly measures;
     private needLayout;
     readonly mi: MScoreRow;
@@ -1047,8 +1079,9 @@ declare class ObjScoreRow extends MusicObject {
     getMusicInterface(): MScoreRow;
     private createNotationLines;
     getNotationLines(): ReadonlyArray<ObjNotationLine>;
-    getInstrumentLineGroups(): ReadonlyArray<ReadonlyArray<ObjNotationLine>>;
+    getRowGroups(): ReadonlyArray<ObjScoreRowGroup>;
     findMatchingLine(line: ObjNotationLine): ObjNotationLine | undefined;
+    get regions(): ScoreRowRegions;
     getStaves(): ReadonlyArray<ObjStaff>;
     getTabs(): ReadonlyArray<ObjTab>;
     get hasStaff(): boolean;
@@ -1069,33 +1102,22 @@ declare class ObjScoreRow extends MusicObject {
     getNextRow(): ObjScoreRow | undefined;
     getFirstMeasure(): ObjMeasure | undefined;
     getLastMeasure(): ObjMeasure | undefined;
-    getMinWidth(): number;
     solveAutoStemDir(symbols: ReadonlyArray<RhythmSymbol>): Stem.Up | Stem.Down;
-    getInstrumentNameWidth(ctx: RenderContext): number;
     requestLayout(): void;
     layout(ctx: RenderContext): void;
-    layoutWidth(ctx: RenderContext, left: number, right: number): void;
+    layoutStretch(ctx: RenderContext): void;
     updateRect(): void;
     alignStemsToBeams(): void;
     layoutSetNotationLines(ctx: RenderContext): void;
-    layoutPadding(ctx: RenderContext): void;
     layoutDone(): void;
     offset(dx: number, dy: number): void;
     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?;
+    readonly regions: ScoreRowRegions;
     private readonly rows;
     private readonly measures;
     private measuresPerRow;
@@ -1104,7 +1126,6 @@ declare class ObjDocument extends MusicObject {
     private newRowRequested;
     private allConnectiveProps;
     private staffGroups;
-    private instrumentGroupRegions;
     private readonly mi;
     constructor();
     getMusicInterface(): MDocument;
@@ -1133,10 +1154,10 @@ declare class ObjDocument extends MusicObject {
     private forEachMeasure;
     resetMeasures(): void;
     updateCursorRect(cursorRect?: Rect): void;
-    getInstrumentGroupRegions(ctx: RenderContext): InstrumentGroupRegions;
     requestLayout(): void;
     requestFullLayout(): void;
     layout(): void;
+    offset(dx: number, dy: number): void;
     drawContent(): void;
     pickStaffPosAt(x: number, y: number): {
         scoreRow: ObjScoreRow;
@@ -1230,11 +1251,13 @@ declare class RenderContext {
     strokeRect(x: number, y: number, w: number, h: number): RenderContext;
     fillText(text: string, x: number, y: number): RenderContext;
     getTextWidth(text: string, font: string): number;
-    arc(x: number, y: number, radius: number, startRadians: number, endRadians: number): void;
-    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: AnchoredRect, side: "left" | "right"): void;
+    arc(x: number, y: number, radius: number, startRadians: number, endRadians: number): RenderContext;
+    fillCircle(x: number, y: number, radius: number): RenderContext;
+    strokeLine(startX: number, startY: number, endX: number, endY: number): RenderContext;
+    strokePartialLine(startX: number, startY: number, endX: number, endY: number, startT: number, endT: number): RenderContext;
+    /** @deprecated - Use {@link drawBracket} instead. */
+    drawBrace(rect: AnchoredRect, side: "left" | "right"): RenderContext;
+    drawBracket(rect: AnchoredRect, bracket: "(" | ")" | "[" | "]" | "{" | "}" | "<" | ">"): RenderContext;
 }
 
 declare class ObjEnding extends MusicObject {
@@ -1387,6 +1410,7 @@ declare class LayoutObjectWrapper {
     getTextContent(): string | undefined;
     layout(ctx: RenderContext): void;
     offset(dx: number, dy: number): void;
+    setAnchorY(y: number): void;
     getRect(): AnchoredRect;
 }
 declare class LayoutGroup {
@@ -1423,7 +1447,21 @@ declare abstract class MusicObject {
     private needRectUpdate;
     requestRectUpdate(): void;
     updateRect(): void;
+    forceRectUpdate(): void;
     getRect(): AnchoredRect;
+    abstract offset(dx: number, dy: number): void;
+    offsetX(dx: number): void;
+    offsetY(dy: number): void;
+    setLeft(x: number): void;
+    setRight(x: number): void;
+    setTop(y: number): void;
+    setBottom(y: number): void;
+    setAnchor(x: number, y: number): void;
+    setAnchorX(x: number): void;
+    setAnchorY(y: number): void;
+    setCenter(x: number, y: number): void;
+    setCenterX(x: number): void;
+    setCenterY(y: number): void;
     /**
      * Most objects are simple rects in shape.
      * Some objects might be more complex consisting of multiple rects.
@@ -1466,6 +1504,7 @@ declare class ObjArpeggio extends MusicObject {
 }
 
 declare class ObjHeader extends MusicObject {
+    readonly doc: ObjDocument;
     readonly title?: string | undefined;
     readonly composer?: string | undefined;
     readonly arranger?: string | undefined;
@@ -1476,7 +1515,7 @@ declare class ObjHeader extends MusicObject {
     constructor(doc: ObjDocument, title?: string | undefined, composer?: string | undefined, arranger?: string | undefined);
     getMusicInterface(): MHeader;
     pick(x: number, y: number): MusicObject[];
-    layoutWidth(ctx: RenderContext, left: number, right: number): void;
+    layout(ctx: RenderContext): void;
     offset(dx: number, dy: number): void;
     draw(ctx: RenderContext): void;
 }
@@ -1976,14 +2015,14 @@ declare class MBarLineLeft extends MusicInterface {
     getMusicObject(): ObjBarLineLeft;
 }
 /** Bar line object for certain staff or tab. */
-declare class MStaffTabBarLine extends MusicInterface {
+declare class MStaffBarLine extends MusicInterface {
     private readonly obj;
     /** Object name. */
-    static readonly Name = "StaffTabBarLine";
+    static readonly Name = "StaffBarLine";
     /** @internal */
-    constructor(obj: ObjStaffTabBarLine);
+    constructor(obj: ObjStaffBarLine);
     /** @internal */
-    getMusicObject(): ObjStaffTabBarLine;
+    getMusicObject(): ObjStaffBarLine;
     /**
      * Get parent bar line object.
      * @returns - Parent bar line object.
@@ -2193,6 +2232,21 @@ declare class MScoreRow extends MusicInterface {
      */
     getNotationLines(): ReadonlyArray<MStaff | MTab>;
 }
+/** Score row group object. */
+declare class MScoreRowGroup extends MusicInterface {
+    private readonly obj;
+    /** Object name. */
+    static readonly Name = "ScoreRowGroup";
+    /** @internal */
+    constructor(obj: ObjScoreRowGroup);
+    /** @internal */
+    getMusicObject(): ObjScoreRowGroup;
+    /**
+     * Get instrument name.
+     * @returns - instrument name.
+     */
+    getInstrument(): string;
+}
 /** Staff notatio line object. */
 declare class MStaff extends MusicInterface {
     private readonly obj;
@@ -2349,4 +2403,4 @@ declare class MExtensionLine extends MusicInterface {
     getMusicObject(): ObjExtensionLine;
 }
 
-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 };
+export { MStaffSignature 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, MStaffBarLine 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, MScoreRowGroup 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, isVoiceId as ab, validateVoiceId as ac, type StringNumber as ad, getStringNumbers as ae, isStringNumber as af, validateStringNumber as ag, getVerseNumbers as ah, isVerseNumber as ai, validateVerseNumber as aj, Stem as ak, Arpeggio as al, type StaffTabOrGroup as am, LyricsAlign as an, LyricsHyphen as ao, DynamicsAnnotation as ap, TempoAnnotation as aq, PlayState as ar, type PlayStateChangeListener as as, 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-RVXvpfyV.d.mts → note-CJuq5aBy.d.mts}

@@ -300,7 +300,7 @@ declare class Note {
      * @param b - Note b.
      * @returns - -1, 0 or 1.
      */
-    static compareFunc(a: Note, b: Note): 1 | 0 | -1;
+    static compareFunc(a: Note, b: Note): 1 | -1 | 0;
 }
 
 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-DYMqx839.mjs';
-import '../note-RVXvpfyV.mjs';
-import '../tempo-BlCGZuYg.mjs';
+import { M as MDocument } from '../music-objects-DqoO-Sfv.mjs';
+import '../note-CJuq5aBy.mjs';
+import '../tempo-Cxu8vusu.mjs';
 import '@tspro/ts-utils-lib';
 
 /**

package/dist/pieces/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MDocument } from '../music-objects-DumXKWJp.js';
+import { M as MDocument } from '../music-objects-T8u8bnNP.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.4.1 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v5.4.2 | (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.4.1 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
-import "../chunk-U2ACCEHX.mjs";
+/* WebMusicScore v5.4.2 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+import "../chunk-ROBXPR34.mjs";
 
 // src/pieces/canon-pachelbel.ts
 import { DocumentBuilder } from "@tspro/web-music-score/score";

package/dist/react-ui/index.d.mts

@@ -1,11 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { c as Scale, S as ScaleType } from '../scale-C8gHC448.mjs';
-import { b as PitchNotation, G as GuitarNoteLabel, N as Note } from '../note-RVXvpfyV.mjs';
-import { H as Handedness } from '../guitar-DXlB-9vK.mjs';
+import { c as Scale, S as ScaleType } from '../scale-DWM4RQco.mjs';
+import { b as PitchNotation, G as GuitarNoteLabel, N as Note } from '../note-CJuq5aBy.mjs';
+import { H as Handedness } from '../guitar-DK18GZ6h.mjs';
 import { Rect } from '@tspro/ts-utils-lib';
-import { M as MDocument, o as ScoreEventListener, s as MPlaybackButtons } from '../music-objects-DYMqx839.mjs';
-import '../tempo-BlCGZuYg.mjs';
+import { M as MDocument, o as ScoreEventListener, s as MPlaybackButtons } from '../music-objects-DqoO-Sfv.mjs';
+import '../tempo-Cxu8vusu.mjs';
 
 interface CircleOfFifthsProps {
     style?: React.CSSProperties;

package/dist/react-ui/index.d.ts

@@ -4,7 +4,7 @@ import { c as Scale, S as ScaleType } from '../scale-CUYFBo-8.js';
 import { b as PitchNotation, G as GuitarNoteLabel, N as Note } from '../note-RVXvpfyV.js';
 import { H as Handedness } from '../guitar-CNOxM4ZK.js';
 import { Rect } from '@tspro/ts-utils-lib';
-import { M as MDocument, o as ScoreEventListener, s as MPlaybackButtons } from '../music-objects-DumXKWJp.js';
+import { M as MDocument, o as ScoreEventListener, s as MPlaybackButtons } from '../music-objects-T8u8bnNP.js';
 import '../tempo-DwuZsv2T.js';
 
 interface CircleOfFifthsProps {

package/dist/react-ui/index.js

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

package/dist/react-ui/index.mjs

@@ -1,7 +1,7 @@
-/* WebMusicScore v5.4.1 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v5.4.2 | (c) 2023-2025 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
   __publicField
-} from "../chunk-U2ACCEHX.mjs";
+} from "../chunk-ROBXPR34.mjs";
 
 // src/react-ui/circle-of-fifths.tsx
 import * as React from "react";