@tspro/web-music-score 5.4.1 → 5.5.0

package/dist/{music-objects-DumXKWJp.d.ts → music-objects-l5Ai97QA.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 { N as Note, A as Accidental } from './note-CJuq5aBy.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-BnUjm25M.js';
+import { AnchoredRect, UniMap, Rect, Vec } from '@tspro/ts-utils-lib';
 
 /** Staff preset values for score configuration. */
 declare enum StaffPreset {
@@ -32,7 +32,13 @@ type BaseConfig = {
     voiceId?: VoiceId | VoiceId[];
     /** @deprecated - Use `voiceId` instead. */
     voiceIds?: VoiceId | VoiceId[];
-    /** Staves/tabs with same instrument name a re grouped together with left brace. */
+    /**
+     * Instrument name for this staf/tab.<br />
+     * Consecutive staves/tabs with the same name are grouped together.<br />
+     * Hint!<br />
+     * `"!Piano"` hides name.<br />
+     * `"!{Piano"` hides both name and left brace of the group.
+     * */
     instrument?: string;
 };
 /** Staff config to add staff notation line in score configuration. */
@@ -362,14 +368,33 @@ declare class ObjText extends MusicObject {
     constructor(parent: MusicObject, text: TextProps, anchorX: number, anchorY: number);
     getMusicInterface(): MText;
     getText(): string;
-    updateAnchorX(anchorX: number): void;
-    updateAnchorY(anchorY: number): void;
     pick(x: number, y: number): MusicObject[];
     layout(ctx: RenderContext): void;
     offset(dx: number, dy: number): void;
     draw(ctx: RenderContext): void;
 }
 
+declare class ObjScoreRowGroup extends MusicObject {
+    readonly lines: readonly ObjNotationLine[];
+    private space;
+    readonly instrument: string;
+    readonly hasBrace: boolean;
+    private readonly instrText;
+    private braceRect;
+    readonly mi: MScoreRowGroup;
+    constructor(lines: readonly ObjNotationLine[]);
+    getMusicInterface(): MScoreRowGroup;
+    get row(): ObjScoreRow;
+    get hasInstrument(): boolean;
+    hasNotationLine(line: ObjNotationLine): 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;
+}
+
 type NotationLineObject = {
     getRect: () => AnchoredRect;
     offset?: (dx: number, dy: number) => void;
@@ -382,6 +407,7 @@ declare abstract class ObjNotationLine extends MusicObject {
     abstract readonly name: string;
     private layoutGroups;
     constructor(row: ObjScoreRow);
+    getRowGroup(): ObjScoreRowGroup;
     addObject(o: NotationLineObject): void;
     removeObjects(): void;
     getLayoutGroup(lauoutGroupId: LayoutGroupId): LayoutGroup;
@@ -390,6 +416,7 @@ declare abstract class ObjNotationLine extends MusicObject {
     private setObjectY;
     private alignObjectsY;
     layoutLayoutGroup(ctx: RenderContext, layoutGroup: LayoutGroup, verticalPos: VerticalPos): void;
+    drawVerticalLine(ctx: RenderContext, left: number, width: number, isSystemBarLine?: boolean): void;
     abstract getConfig(): StaffConfig | TabConfig;
     abstract calcTop(): number;
     abstract calcBottom(): number;
@@ -403,7 +430,6 @@ declare abstract class ObjNotationLine extends MusicObject {
     abstract draw(ctx: RenderContext): void;
 }
 declare class ObjStaff extends ObjNotationLine {
-    readonly row: ObjScoreRow;
     readonly staffConfig: StaffConfig;
     readonly id: number;
     readonly clefImageAsset: ImageAsset;
@@ -426,6 +452,8 @@ declare class ObjStaff extends ObjNotationLine {
     getMiddleLineY(): number;
     getBottomLineY(): number;
     joinGrandStaff(staff: ObjStaff): void;
+    isGrandTreble(): boolean;
+    isGrandBass(): boolean;
     getLineSpacing(): number;
     getDiatonicSpacing(): number;
     containsDiatonicId(diatonicId: number): boolean;
@@ -444,7 +472,6 @@ declare class ObjStaff extends ObjNotationLine {
     draw(ctx: RenderContext): void;
 }
 declare class ObjTab extends ObjNotationLine {
-    readonly row: ObjScoreRow;
     readonly tabConfig: TabConfig;
     readonly id: number;
     private top;
@@ -583,7 +610,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): 0 | 1 | -1;
+    getDotVerticalDisplacement(staff: ObjStaff, diatonicId: number, stemDir: Stem): 1 | 0 | -1;
     static hasSameNotes(ng1: ObjNoteGroup, ng2: ObjNoteGroup): boolean;
 }
 
@@ -639,7 +666,7 @@ declare class ObjBeamGroup extends MusicObject {
     getSymbols(): ReadonlyArray<RhythmSymbol>;
     getFirstSymbol(): RhythmSymbol | undefined;
     getLastSymbol(): RhythmSymbol | undefined;
-    get color(): string;
+    private get color();
     layout(ctx: RenderContext): void;
     updateRect(): void;
     updateStemTips(): void;
@@ -814,10 +841,11 @@ declare enum BarLineType {
     EndRepeat = 5,
     EndStartRepeat = 6
 }
-declare class ObjStaffTabBarLine extends MusicObject {
+declare class ObjStaffBarLine extends MusicObject {
     readonly barLine: ObjBarLine;
     readonly line: ObjNotationLine;
-    verticalLines: {
+    readonly rowGroup: ObjScoreRowGroup;
+    vlines: {
         left: number;
         width: number;
     }[];
@@ -826,20 +854,22 @@ declare class ObjStaffTabBarLine extends MusicObject {
         y: number;
         r: number;
     }[];
-    readonly mi: MStaffTabBarLine;
-    constructor(barLine: ObjBarLine, line: ObjNotationLine);
+    readonly mi: MStaffBarLine;
+    constructor(barLine: ObjBarLine, line: ObjNotationLine, rowGroup: ObjScoreRowGroup);
     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;
+    get doc(): ObjDocument;
+    get row(): ObjScoreRow;
     pick(x: number, y: number): MusicObject[];
     layout(ctx: RenderContext): void;
     updateRect(): void;
@@ -883,6 +913,7 @@ declare class ObjConnective extends MusicObject {
     constructor(connectiveProps: ConnectiveProps, line: ObjNotationLine, measure: ObjMeasure, leftNoteGroup: ObjNoteGroup, leftNoteId: number, rightNoteGroup: ObjNoteGroup, rightNoteId: number);
     constructor(connectiveProps: ConnectiveProps, line: ObjNotationLine, measure: ObjMeasure, leftNoteGroup: ObjNoteGroup, leftNoteId: number, tie: TieType);
     getMusicInterface(): MConnective;
+    get doc(): ObjDocument;
     isInsideMeasure(): boolean;
     pick(x: number, y: number): MusicObject[];
     layout(ctx: RenderContext): void;
@@ -890,6 +921,73 @@ declare class ObjConnective extends MusicObject {
     draw(ctx: RenderContext): void;
 }
 
+declare class ObjSpecialText extends MusicObject {
+    readonly text: string;
+    readonly color: string;
+    static toCoda: string;
+    static Coda: string;
+    static Segno: string;
+    private components;
+    readonly mi: MSpecialText;
+    constructor(parent: MusicObject, text: string, color?: string);
+    getMusicInterface(): MSpecialText;
+    getText(): string;
+    pick(x: number, y: number): MusicObject[];
+    layout(ctx: RenderContext): void;
+    offset(dx: number, dy: number): void;
+    draw(ctx: RenderContext): void;
+}
+
+type ExtensionStartObject = ObjText | ObjSpecialText;
+type ExtensionLineLeftObject = ObjBarLineLeft | MusicObject;
+type ExtensionLineRightObject = ObjRhythmColumn | ObjBarLineRight;
+type ExtensionStopObject = ObjBarLineRight | ObjText | ObjSpecialText;
+type ExtensionObjectAll = ExtensionStartObject | ExtensionLineLeftObject | ExtensionLineRightObject | ExtensionStopObject;
+declare class ObjExtensionLine extends MusicObject {
+    readonly measure: ObjMeasure;
+    readonly line: ObjNotationLine;
+    readonly extension: Extension;
+    readonly cols: ExtensionObjectAll[];
+    readonly mi: MExtensionLine;
+    constructor(measure: ObjMeasure, line: ObjNotationLine, extension: Extension, cols: ExtensionObjectAll[]);
+    get row(): ObjScoreRow;
+    getMusicInterface(): MExtensionLine;
+    private getLineLeft;
+    private getLineRight;
+    layoutFitToMeasure(ctx: RenderContext): void;
+    pick(x: number, y: number): MusicObject[];
+    layout(ctx: RenderContext): void;
+    offset(dx: number, dy: number): void;
+    draw(ctx: RenderContext): void;
+}
+
+type ExtensionLineStyle = "solid" | "dashed";
+type ExtensionLinePos = "bottom" | "middle";
+declare class ExtensionRange {
+    readonly startColumn: ObjRhythmColumn;
+    readonly columnRange: ObjRhythmColumn[];
+    stopObject?: ExtensionStopObject;
+    constructor(startColumn: ObjRhythmColumn);
+    get endColumn(): ObjRhythmColumn;
+    addColumn(col: ObjRhythmColumn): void;
+    setStopObject(obj: ExtensionStopObject): void;
+}
+declare class Extension extends MusicObjectLink {
+    readonly headObj: LayoutObjectWrapper;
+    private readonly length;
+    private readonly visible;
+    private readonly lineStyle;
+    private readonly linePos;
+    private readonly startColumn;
+    constructor(headObj: LayoutObjectWrapper, startColumn: ObjRhythmColumn, length: number, visible: boolean, lineStyle: ExtensionLineStyle, linePos: ExtensionLinePos);
+    isVisible(): boolean;
+    getLineStyle(): ExtensionLineStyle;
+    getLinePos(): ExtensionLinePos;
+    private static StopNavigations;
+    private whatStopped;
+    getRange(): ExtensionRange;
+}
+
 declare class ObjMeasure extends MusicObject {
     readonly row: ObjScoreRow;
     private readonly options;
@@ -914,7 +1012,7 @@ declare class ObjMeasure extends MusicObject {
     private voiceSymbols;
     private lastAddedRhythmColumn?;
     private lastAddedRhythmSymbol?;
-    private addExtensionToMusicObjects;
+    private addExtensionTo;
     private layoutObjects;
     private postMeasureBreakWidth;
     private passCount;
@@ -947,6 +1045,8 @@ declare class ObjMeasure extends MusicObject {
     getColumn(columnId: number): ObjRhythmColumn | undefined;
     isFirstMeasure(): boolean;
     isLastMeasure(): boolean;
+    isFirstMeasureInRow(): boolean;
+    isLastMeasureInRow(): boolean;
     getNextMeasure(): ObjMeasure | undefined;
     getPrevMeasure(): ObjMeasure | undefined;
     getKeySignature(): KeySignature;
@@ -1029,26 +1129,41 @@ 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 rowGroupByLine;
     private needLayout;
     readonly mi: MScoreRow;
     constructor(doc: ObjDocument, prevRow: ObjScoreRow | undefined, scoreConfig: (StaffConfig | TabConfig)[]);
     getMusicInterface(): MScoreRow;
     private createNotationLines;
     getNotationLines(): ReadonlyArray<ObjNotationLine>;
-    getInstrumentLineGroups(): ReadonlyArray<ReadonlyArray<ObjNotationLine>>;
+    getRowGroups(): ReadonlyArray<ObjScoreRowGroup>;
+    getRowGroupByLineId(id: number): ObjScoreRowGroup;
     findMatchingLine(line: ObjNotationLine): ObjNotationLine | undefined;
+    get regions(): ScoreRowRegions;
     getStaves(): ReadonlyArray<ObjStaff>;
     getTabs(): ReadonlyArray<ObjTab>;
     get hasStaff(): boolean;
@@ -1069,33 +1184,23 @@ 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;
+    getStaffLineLeft(): number | undefined;
     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 +1209,6 @@ declare class ObjDocument extends MusicObject {
     private newRowRequested;
     private allConnectiveProps;
     private staffGroups;
-    private instrumentGroupRegions;
     private readonly mi;
     constructor();
     getMusicInterface(): MDocument;
@@ -1133,10 +1237,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;
@@ -1173,8 +1277,9 @@ declare class RenderContext {
     constructor(mi: MRenderContext);
     getMusicInterface(): MRenderContext;
     get doc(): ObjDocument | undefined;
-    private finishImageAsset;
-    getImageAsset(imageAsset: ImageAsset): HTMLImageElement | undefined;
+    getImageAsset(asset: ImageAsset, color?: string): HTMLImageElement | undefined;
+    private forceDraw;
+    private onImageLoaded;
     setDocument(mdoc?: MDocument): void;
     setCanvas(canvas: HTMLCanvasElement): void;
     setScoreEventListener(fn: ScoreEventListener): void;
@@ -1186,7 +1291,6 @@ declare class RenderContext {
     onMouseMove(e: MouseEvent): void;
     onMouseLeave(e: MouseEvent): void;
     onTouchEnd(e: TouchEvent): void;
-    onLoad(): void;
     hilightObject(obj?: MusicObject): void;
     hilightStaffPos(staffPos?: {
         scoreRow: ObjScoreRow;
@@ -1230,20 +1334,23 @@ 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 {
     readonly measure: ObjMeasure;
+    readonly color: string;
     readonly passages: number[];
     private endingText;
     private shapeRects;
     readonly mi: MEnding;
-    constructor(measure: ObjMeasure, passages: number[]);
+    constructor(measure: ObjMeasure, color: string, passages: number[]);
     getMusicInterface(): MEnding;
     getShapeRects(): AnchoredRect[];
     isSingleMeasureEnding(): boolean;
@@ -1258,9 +1365,9 @@ declare class ObjEnding extends MusicObject {
 
 declare class ObjFermata extends MusicObject {
     readonly pos: VerticalPos;
-    private color;
+    readonly color: string;
     readonly mi: MFermata;
-    constructor(parent: ObjRhythmColumn | ObjBarLineRight, pos: VerticalPos);
+    constructor(parent: ObjRhythmColumn | ObjBarLineRight, pos: VerticalPos, color: string);
     getMusicInterface(): MFermata;
     static getFermataPositions(anchor: ObjRhythmColumn | ObjBarLineRight): VerticalPos[];
     pick(x: number, y: number): MusicObject[];
@@ -1269,66 +1376,6 @@ declare class ObjFermata extends MusicObject {
     draw(ctx: RenderContext): void;
 }
 
-declare class ObjSpecialText extends MusicObject {
-    readonly text: string;
-    static toCoda: string;
-    static Coda: string;
-    static Segno: string;
-    private components;
-    readonly mi: MSpecialText;
-    constructor(parent: MusicObject, text: string);
-    getMusicInterface(): MSpecialText;
-    getText(): string;
-    pick(x: number, y: number): MusicObject[];
-    layout(ctx: RenderContext): void;
-    offset(dx: number, dy: number): void;
-    draw(ctx: RenderContext): void;
-}
-
-type ExtensionLineStyle = "solid" | "dashed";
-type ExtensionLinePos = "bottom" | "middle";
-type ExtensionRangeInfo = {
-    startColumn: ObjRhythmColumn;
-    endColumn: ObjRhythmColumn;
-    columnRange: ObjRhythmColumn[];
-    extensionBreakText?: string;
-};
-declare class Extension extends MusicObjectLink {
-    private readonly length;
-    private readonly visible;
-    private readonly lineStyle;
-    private readonly linePos;
-    private readonly startColumn;
-    private readonly context;
-    constructor(head: MusicObject, startColumn: ObjRhythmColumn, length: number, visible: boolean, lineStyle: ExtensionLineStyle, linePos: ExtensionLinePos);
-    isVisible(): boolean;
-    getLineStyle(): ExtensionLineStyle;
-    getLinePos(): ExtensionLinePos;
-    private getSpanBreakText;
-    getExtensionRangeInfo(): ExtensionRangeInfo;
-}
-
-type ExtensionLineLeftObj = ObjBarLineLeft | MusicObject;
-type ExtensionLineRightObj = ObjRhythmColumn | ObjBarLineRight;
-declare class ObjExtensionLine extends MusicObject {
-    readonly measure: ObjMeasure;
-    readonly line: ObjNotationLine;
-    readonly extension: Extension;
-    readonly leftObj: ExtensionLineLeftObj;
-    readonly rightObj: ExtensionLineRightObj;
-    readonly mi: MExtensionLine;
-    constructor(measure: ObjMeasure, line: ObjNotationLine, extension: Extension, leftObj: ExtensionLineLeftObj, rightObj: ExtensionLineRightObj);
-    get row(): ObjScoreRow;
-    getMusicInterface(): MExtensionLine;
-    private getLineLeft;
-    private getLineRight;
-    layoutFitToMeasure(ctx: RenderContext): void;
-    pick(x: number, y: number): MusicObject[];
-    layout(ctx: RenderContext): void;
-    offset(dx: number, dy: number): void;
-    draw(ctx: RenderContext): void;
-}
-
 declare class ObjTabRhythm extends MusicObject {
     readonly measure: ObjMeasure;
     readonly tab: ObjTab;
@@ -1336,6 +1383,7 @@ declare class ObjTabRhythm extends MusicObject {
     readonly mi: MTabRhythm;
     constructor(measure: ObjMeasure, tab: ObjTab);
     getMusicInterface(): MTabRhythm;
+    get doc(): ObjDocument;
     pick(x: number, y: number): MusicObject[];
     layout(ctx: RenderContext): void;
     private hasTuplets;
@@ -1384,9 +1432,9 @@ declare class LayoutObjectWrapper {
     setPositionResolved(): void;
     isPositionResolved(): boolean;
     resolveClosestToStaffY(ctx: RenderContext): number;
-    getTextContent(): string | undefined;
     layout(ctx: RenderContext): void;
     offset(dx: number, dy: number): void;
+    setAnchorY(y: number): void;
     getRect(): AnchoredRect;
 }
 declare class LayoutGroup {
@@ -1416,6 +1464,7 @@ declare abstract class MusicObject {
     protected readonly parent: MusicObject | undefined;
     private anchoredLayoutObjects;
     private link?;
+    readonly userData: Record<string, unknown>;
     constructor(parent: MusicObject | undefined);
     abstract getMusicInterface(): MusicInterface;
     getParent(): MusicObject | undefined;
@@ -1423,7 +1472,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 +1529,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 +1540,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;
 }
@@ -1508,6 +1572,7 @@ declare class ObjStaffSignature extends MusicObject {
     private tempoText?;
     readonly mi: MStaffSignature;
     constructor(measure: ObjMeasure, staff: ObjStaff);
+    get doc(): ObjDocument;
     getMusicInterface(): MStaffSignature;
     updateClefImage(ctx: RenderContext, showClef: boolean): void;
     updateMeasureNumber(showMeasureNumber: boolean): void;
@@ -1530,6 +1595,7 @@ declare class ObjTabSignature extends MusicObject {
     readonly mi: MTabSignature;
     constructor(measure: ObjMeasure, tab: ObjTab);
     getMusicInterface(): MTabSignature;
+    get doc(): ObjDocument;
     updateMeasureNumber(showMeasureNumber: boolean): void;
     updateTimeSignature(showTimeSignature: boolean): void;
     updateTempo(showTempo: boolean): void;
@@ -1976,14 +2042,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 +2259,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 +2430,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/{note-RVXvpfyV.d.ts → note-CJuq5aBy.d.ts}

@@ -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,8 +1,15 @@
-import { M as MDocument } from '../music-objects-DYMqx839.mjs';
-import '../note-RVXvpfyV.mjs';
-import '../tempo-BlCGZuYg.mjs';
+import { M as MDocument } from '../music-objects-CcJvZxS6.mjs';
+import '../note-CJuq5aBy.mjs';
+import '../tempo-Cxu8vusu.mjs';
 import '@tspro/ts-utils-lib';
 
+/**
+ * Create Andante by A. Diabelli music piece.
+ *
+ * @returns - Music document.
+ */
+declare function createAndanteByDiabelli(): MDocument;
+
 /**
  * Create Canon in D by Pachelbel music piece.<br />
  * <br />
@@ -31,10 +38,9 @@ declare function createFrereJacques(): MDocument;
 declare function createGreensleeves(): MDocument;
 
 /**
- * Create Andante by A. Diabelli music piece.
- *
- * @returns - Music document.
+ * Create all music pieces.
+ * @returns - Array of music documents containing all available pieces.
  */
-declare function createAndanteByDiabelli(): MDocument;
+declare function createAll(): readonly MDocument[];
 
-export { createAndanteByDiabelli, createCanonInD, createFrereJacques, createGreensleeves };
+export { createAll, createAndanteByDiabelli, createCanonInD, createFrereJacques, createGreensleeves };