@tspro/web-music-score 5.2.0 → 5.4.0

package/dist/react-ui/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v5.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v5.4.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -47,7 +47,6 @@ module.exports = __toCommonJS(react_ui_exports);
 // src/react-ui/circle-of-fifths.tsx
 var React = __toESM(require("react"));
 var import_theory = require("@tspro/web-music-score/theory");
-var import_score = require("@tspro/web-music-score/score");
 var import_ts_utils_lib = require("@tspro/ts-utils-lib");
 var import_jsx_runtime = require("react/jsx-runtime");
 var SelectedColor = "#0A0";
@@ -99,7 +98,7 @@ var CircleOfFifths = class extends React.Component {
     let width = (_a = dim.width) != null ? _a : defaultSize;
     let height = (_b = dim.height) != null ? _b : defaultSize;
     style = Object.assign({}, style, { width, height });
-    let circleRect = new import_score.DivRect(0, width, 0, height).scaleCopy(0.65);
+    let circleRect = new import_ts_utils_lib.Rect(0, 0, width, height).scaleCopy(0.65);
     let lineWidth = Math.max(1, circleRect.width / 100);
     let fontSize = circleRect.width / 15;
     let tonicSize = fontSize * 2;
@@ -308,9 +307,9 @@ var GuitarContext = class _GuitarContext {
    * @returns - Fret position object.
    */
   getFretPosition(stringId, fretId) {
-    if (!import_ts_utils_lib2.Utils.Is.isInteger(stringId) || stringId < 0 || stringId > 5) {
+    if (!import_ts_utils_lib2.Guard.isInteger(stringId) || stringId < 0 || stringId > 5) {
       throw new import_core.MusicError(import_core.MusicErrorType.InvalidArg, `Invalid stringId: + ${stringId}`);
-    } else if (!import_ts_utils_lib2.Utils.Is.isInteger(fretId) || fretId < 0 || fretId > this.maxFretId) {
+    } else if (!import_ts_utils_lib2.Guard.isInteger(fretId) || fretId < 0 || fretId > this.maxFretId) {
       throw new import_core.MusicError(import_core.MusicErrorType.InvalidArg, `Invalid fretId: ${fretId}`);
     } else {
       return this.fretPositionTable[stringId][fretId];
@@ -376,7 +375,6 @@ var GuitarContext = class _GuitarContext {
 // src/react-ui/guitar-view.tsx
 var React2 = __toESM(require("react"));
 var import_ts_utils_lib3 = require("@tspro/ts-utils-lib");
-var import_score2 = require("@tspro/web-music-score/score");
 var import_theory4 = require("@tspro/web-music-score/theory");
 
 // src/react-ui/assets/guitar.png
@@ -414,7 +412,7 @@ var t_table = [
   0.75
 ];
 function fret_t(fretId) {
-  if (!import_ts_utils_lib3.Utils.Is.isInteger(fretId) || fretId < 0 || fretId > t_table.length - 1) {
+  if (!import_ts_utils_lib3.Guard.isInteger(fretId) || fretId < 0 || fretId > t_table.length - 1) {
     throw new import_core2.MusicError(import_core2.MusicErrorType.InvalidArg, `Invalid fretId: ${fretId}`);
   } else {
     return t_table[fretId] * 2;
@@ -485,16 +483,16 @@ var GuitarView = class extends React2.Component {
         let left = frets[fretId];
         let right = (_b = frets[fretId - 1]) != null ? _b : new Fret(width, left.topStringY, left.bottomStringY);
         let cellHeight = (left.bottomStringY - left.topStringY) / 5;
-        let cellRect = import_score2.DivRect.create(
+        let cellRect = new import_ts_utils_lib3.Rect(
           left.x,
           left.bottomStringY - cellHeight * (stringId + 0.5),
           right.x - left.x,
           cellHeight
         );
         if (guitarCtx.handedness === import_theory4.Handedness.LeftHanded) {
-          cellRect = new import_score2.DivRect(width - cellRect.right, width - cellRect.left, cellRect.top, cellRect.bottom);
+          cellRect = new import_ts_utils_lib3.Rect(width - cellRect.right, cellRect.top, cellRect.width, cellRect.height);
         }
-        let noteRect = import_score2.DivRect.create(
+        let noteRect = new import_ts_utils_lib3.Rect(
           cellRect.left + (guitarCtx.handedness === import_theory4.Handedness.LeftHanded ? cellRect.width - noteWidth : 0),
           cellRect.top,
           noteWidth,
@@ -596,29 +594,29 @@ var GuitarView = class extends React2.Component {
 
 // src/react-ui/music-score-view.tsx
 var React3 = __toESM(require("react"));
-var import_score3 = require("@tspro/web-music-score/score");
+var import_score = require("@tspro/web-music-score/score");
 var import_jsx_runtime3 = require("react/jsx-runtime");
 var MusicScoreView = class extends React3.Component {
   constructor(props) {
     super(props);
-    __publicField(this, "renderer");
-    this.renderer = new import_score3.MRenderer();
-    this.renderer.setDocument(props.doc);
+    __publicField(this, "ctx");
+    this.ctx = new import_score.MRenderContext();
+    this.ctx.setDocument(props.doc);
     if (props.onScoreEvent) {
-      this.renderer.setScoreEventListener(props.onScoreEvent);
+      this.ctx.setScoreEventListener(props.onScoreEvent);
     }
   }
   componentDidUpdate(prevProps, prevState) {
     if (prevProps.doc !== this.props.doc) {
-      this.renderer.setDocument(this.props.doc);
-      this.renderer.draw();
+      this.ctx.setDocument(this.props.doc);
+      this.ctx.draw();
     }
   }
   render() {
     const setCanvas = (canvas) => {
       if (canvas) {
-        this.renderer.setCanvas(canvas);
-        this.renderer.draw();
+        this.ctx.setCanvas(canvas);
+        this.ctx.draw();
       }
     };
     return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("canvas", { style: { position: "relative" }, ref: setCanvas, children: "Your browser does not support the HTML canvas tag." });
@@ -627,7 +625,7 @@ var MusicScoreView = class extends React3.Component {
 
 // src/react-ui/playback-buttons.tsx
 var React4 = __toESM(require("react"));
-var import_score4 = require("@tspro/web-music-score/score");
+var import_score2 = require("@tspro/web-music-score/score");
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var PlaybackButtonsLayout = /* @__PURE__ */ ((PlaybackButtonsLayout2) => {
   PlaybackButtonsLayout2[PlaybackButtonsLayout2["PlayStopSingle"] = 0] = "PlayStopSingle";
@@ -640,7 +638,7 @@ var PlaybackButtons = class extends React4.Component {
     super(props);
     __publicField(this, "state");
     this.state = {
-      controller: new import_score4.MPlaybackButtons().setDocument(props.doc)
+      controller: new import_score2.MPlaybackButtons().setDocument(props.doc)
     };
   }
   componentDidUpdate(prevProps) {

package/dist/react-ui/index.mjs

@@ -1,13 +1,12 @@
-/* WebMusicScore v5.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v5.4.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
   __publicField
-} from "../chunk-LC5JMIVF.mjs";
+} from "../chunk-AUT4C6TY.mjs";
 
 // src/react-ui/circle-of-fifths.tsx
 import * as React from "react";
 import { Note, SymbolSet, getScale, ScaleType } from "@tspro/web-music-score/theory";
-import { DivRect } from "@tspro/web-music-score/score";
-import { Device, Utils } from "@tspro/ts-utils-lib";
+import { Device, Rect, Utils } from "@tspro/ts-utils-lib";
 import { jsx } from "react/jsx-runtime";
 var SelectedColor = "#0A0";
 var MajorScaleTonics = [
@@ -58,7 +57,7 @@ var CircleOfFifths = class extends React.Component {
     let width = (_a = dim.width) != null ? _a : defaultSize;
     let height = (_b = dim.height) != null ? _b : defaultSize;
     style = Object.assign({}, style, { width, height });
-    let circleRect = new DivRect(0, width, 0, height).scaleCopy(0.65);
+    let circleRect = new Rect(0, 0, width, height).scaleCopy(0.65);
     let lineWidth = Math.max(1, circleRect.width / 100);
     let fontSize = circleRect.width / 15;
     let tonicSize = fontSize * 2;
@@ -150,7 +149,7 @@ var guitar_default = {
 
 // src/react-ui/guitar-context.ts
 import { MusicError, MusicErrorType } from "@tspro/web-music-score/core";
-import { Utils as Utils2 } from "@tspro/ts-utils-lib";
+import { Guard } from "@tspro/ts-utils-lib";
 var DefaultColors = {
   ScaleNoteColor: "#0A0",
   ScaleRootNoteColor: "#00A",
@@ -267,9 +266,9 @@ var GuitarContext = class _GuitarContext {
    * @returns - Fret position object.
    */
   getFretPosition(stringId, fretId) {
-    if (!Utils2.Is.isInteger(stringId) || stringId < 0 || stringId > 5) {
+    if (!Guard.isInteger(stringId) || stringId < 0 || stringId > 5) {
       throw new MusicError(MusicErrorType.InvalidArg, `Invalid stringId: + ${stringId}`);
-    } else if (!Utils2.Is.isInteger(fretId) || fretId < 0 || fretId > this.maxFretId) {
+    } else if (!Guard.isInteger(fretId) || fretId < 0 || fretId > this.maxFretId) {
       throw new MusicError(MusicErrorType.InvalidArg, `Invalid fretId: ${fretId}`);
     } else {
       return this.fretPositionTable[stringId][fretId];
@@ -334,8 +333,7 @@ var GuitarContext = class _GuitarContext {
 
 // src/react-ui/guitar-view.tsx
 import * as React2 from "react";
-import { Utils as Utils3 } from "@tspro/ts-utils-lib";
-import { DivRect as DivRect2 } from "@tspro/web-music-score/score";
+import { Guard as Guard2, Rect as Rect2, Utils as Utils2 } from "@tspro/ts-utils-lib";
 import { Handedness as Handedness2 } from "@tspro/web-music-score/theory";
 
 // src/react-ui/assets/guitar.png
@@ -373,7 +371,7 @@ var t_table = [
   0.75
 ];
 function fret_t(fretId) {
-  if (!Utils3.Is.isInteger(fretId) || fretId < 0 || fretId > t_table.length - 1) {
+  if (!Guard2.isInteger(fretId) || fretId < 0 || fretId > t_table.length - 1) {
     throw new MusicError2(MusicErrorType2.InvalidArg, `Invalid fretId: ${fretId}`);
   } else {
     return t_table[fretId] * 2;
@@ -420,14 +418,14 @@ var GuitarView = class extends React2.Component {
   }
   componentDidUpdate(prevProps) {
     let { style, guitarContext: guitarCtx } = this.props;
-    if (Utils3.Dom.styleLayoutChanged(style, prevProps.style) || guitarCtx !== prevProps.guitarContext) {
+    if (Utils2.Dom.styleLayoutChanged(style, prevProps.style) || guitarCtx !== prevProps.guitarContext) {
       this.setState(this.getLayoutState());
     }
   }
   getLayoutState() {
     var _a, _b;
     let { guitarContext: guitarCtx, style } = this.props;
-    let dim = Utils3.Dom.getDimension(style);
+    let dim = Utils2.Dom.getDimension(style);
     let width = (_a = dim.width) != null ? _a : window.innerWidth;
     let height = guitar_default.height * width / guitar_default.width;
     let s = width / guitar_default.width;
@@ -444,16 +442,16 @@ var GuitarView = class extends React2.Component {
         let left = frets[fretId];
         let right = (_b = frets[fretId - 1]) != null ? _b : new Fret(width, left.topStringY, left.bottomStringY);
         let cellHeight = (left.bottomStringY - left.topStringY) / 5;
-        let cellRect = DivRect2.create(
+        let cellRect = new Rect2(
           left.x,
           left.bottomStringY - cellHeight * (stringId + 0.5),
           right.x - left.x,
           cellHeight
         );
         if (guitarCtx.handedness === Handedness2.LeftHanded) {
-          cellRect = new DivRect2(width - cellRect.right, width - cellRect.left, cellRect.top, cellRect.bottom);
+          cellRect = new Rect2(width - cellRect.right, cellRect.top, cellRect.width, cellRect.height);
         }
-        let noteRect = DivRect2.create(
+        let noteRect = new Rect2(
           cellRect.left + (guitarCtx.handedness === Handedness2.LeftHanded ? cellRect.width - noteWidth : 0),
           cellRect.top,
           noteWidth,
@@ -555,29 +553,29 @@ var GuitarView = class extends React2.Component {
 
 // src/react-ui/music-score-view.tsx
 import * as React3 from "react";
-import { MRenderer } from "@tspro/web-music-score/score";
+import { MRenderContext } from "@tspro/web-music-score/score";
 import { jsx as jsx3 } from "react/jsx-runtime";
 var MusicScoreView = class extends React3.Component {
   constructor(props) {
     super(props);
-    __publicField(this, "renderer");
-    this.renderer = new MRenderer();
-    this.renderer.setDocument(props.doc);
+    __publicField(this, "ctx");
+    this.ctx = new MRenderContext();
+    this.ctx.setDocument(props.doc);
     if (props.onScoreEvent) {
-      this.renderer.setScoreEventListener(props.onScoreEvent);
+      this.ctx.setScoreEventListener(props.onScoreEvent);
     }
   }
   componentDidUpdate(prevProps, prevState) {
     if (prevProps.doc !== this.props.doc) {
-      this.renderer.setDocument(this.props.doc);
-      this.renderer.draw();
+      this.ctx.setDocument(this.props.doc);
+      this.ctx.draw();
     }
   }
   render() {
     const setCanvas = (canvas) => {
       if (canvas) {
-        this.renderer.setCanvas(canvas);
-        this.renderer.draw();
+        this.ctx.setCanvas(canvas);
+        this.ctx.draw();
       }
     };
     return /* @__PURE__ */ jsx3("canvas", { style: { position: "relative" }, ref: setCanvas, children: "Your browser does not support the HTML canvas tag." });

package/dist/{scale-CBW4eTz7.d.ts → scale-C8gHC448.d.mts}

@@ -1,5 +1,5 @@
-import { N as Note, S as SymbolSet } from './note-CgCIBwvR.js';
-import { K as KeySignature } from './tempo-DMt3iwz9.js';
+import { N as Note, S as SymbolSet } from './note-RVXvpfyV.mjs';
+import { K as KeySignature } from './tempo-BlCGZuYg.mjs';
 
 /** Interval direction type. */
 type IntervalDirection = "Unison" | "Ascending" | "Descending";
@@ -147,7 +147,7 @@ declare class Scale extends KeySignature {
      * @returns - Interval.
      */
     getIntervalFromRootNote(note: Note): Interval;
-    private preferredChromaticNoteCache;
+    private preferredChromaticIdNoteCache;
     /**
      * Get preferred chromatic note from given chromatic id.
      * @param chromaticId - Chromatic id.

package/dist/{scale-DQP3b9Zx.d.mts → scale-DulPFco_.d.ts}

@@ -1,5 +1,5 @@
-import { N as Note, S as SymbolSet } from './note-eA2xPPiG.mjs';
-import { K as KeySignature } from './tempo-dkctPkCS.mjs';
+import { N as Note, S as SymbolSet } from './note-CJuq5aBy.js';
+import { K as KeySignature } from './tempo-BnUjm25M.js';
 
 /** Interval direction type. */
 type IntervalDirection = "Unison" | "Ascending" | "Descending";
@@ -147,7 +147,7 @@ declare class Scale extends KeySignature {
      * @returns - Interval.
      */
     getIntervalFromRootNote(note: Note): Interval;
-    private preferredChromaticNoteCache;
+    private preferredChromaticIdNoteCache;
     /**
      * Get preferred chromatic note from given chromatic id.
      * @param chromaticId - Chromatic id.

package/dist/score/index.d.mts

@@ -1,10 +1,236 @@
-import { N as NoteOptions, R as RestOptions, S as StaffPreset, a as ScoreConfiguration, M as MDocument, V as VoiceId, T as TupletOptions, b as VerseNumber, L as LyricsOptions, c as StaffTabOrGroups, F as Fermata, d as Navigation, A as AnnotationText, e as Annotation, f as Label, C as Connective, g as TieType, h as NoteAnchor, i as VerticalPosition } from '../music-objects-CB05XryE.mjs';
-export { ad as Arpeggio, a5 as BaseConfig, a4 as Clef, D as DivRect, ah as DynamicsAnnotation, af as LyricsAlign, ag as LyricsHyphen, s as MAccidental, u as MArpeggio, H as MBarLineLeft, G as MBarLineRight, v as MBeamGroup, t as MConnective, x as MEnding, a3 as MExtensionLine, y as MFermata, z as MHeader, B as MImage, a2 as MLyrics, E as MMeasure, J as MNoteGroup, q as MPlaybackButtons, o as MPlayer, p as MRenderer, P as MRest, U as MRhythmColumn, W as MScoreRow, a0 as MSpecialText, X as MStaff, w as MStaffBeamGroup, K as MStaffNoteGroup, Q as MStaffRest, Z as MStaffSignature, I as MStaffTabBarLine, Y as MTab, O as MTabNoteGroup, $ as MTabRhythm, _ as MTabSignature, a1 as MText, r as MusicInterface, aj as PlayState, ak as PlayStateChangeListener, k as ScoreEvent, n as ScoreEventListener, j as ScoreEventType, m as ScoreObjectEvent, l as ScoreStaffPosEvent, a6 as StaffConfig, ae as StaffTabOrGroup, ac as Stem, a9 as StringNumber, a7 as TabConfig, ai as TempoAnnotation, aa as getStringNumbers, ab as getVerseNumbers, a8 as getVoiceIds } from '../music-objects-CB05XryE.mjs';
-import { N as Note } from '../note-eA2xPPiG.mjs';
-import { S as ScaleType, c as Scale } from '../scale-DQP3b9Zx.mjs';
-import { N as NoteLength, i as NoteLengthStr, K as KeySignature, b as TimeSignature, T as TimeSignatures, B as BeamGrouping, k as TupletRatio } from '../tempo-dkctPkCS.mjs';
+import { N as NoteOptions, R as RestOptions, S as StaffPreset, a as ScoreConfiguration, M as MDocument, b as MeasureOptions, V as VoiceId, T as TupletOptions, c as VerseNumber, L as LyricsOptions, d as StaffTabOrGroups, F as Fermata, e as Navigation, A as AnnotationText, f as Annotation, g as Label, C as Connective, h as TieType, i as NoteAnchor, j as VerticalPosition } from '../music-objects-ONIuVUgs.mjs';
+export { ak as Arpeggio, a6 as BaseConfig, a5 as Clef, ao as DynamicsAnnotation, am as LyricsAlign, an as LyricsHyphen, u as MAccidental, w as MArpeggio, I as MBarLineLeft, H as MBarLineRight, x as MBeamGroup, v as MConnective, z as MEnding, a4 as MExtensionLine, B as MFermata, D as MHeader, E as MImage, a3 as MLyrics, G as MMeasure, K as MNoteGroup, s as MPlaybackButtons, p as MPlayer, q as MRenderContext, r as MRenderer, Q as MRest, W as MRhythmColumn, X as MScoreRow, a1 as MSpecialText, Y as MStaff, y as MStaffBeamGroup, O as MStaffNoteGroup, U as MStaffRest, _ as MStaffSignature, J as MStaffTabBarLine, Z as MTab, P as MTabNoteGroup, a0 as MTabRhythm, $ as MTabSignature, a2 as MText, t as MusicInterface, aq as PlayState, ar as PlayStateChangeListener, l as ScoreEvent, o as ScoreEventListener, k as ScoreEventType, n as ScoreObjectEvent, m as ScoreStaffPosEvent, a7 as StaffConfig, al as StaffTabOrGroup, aj as Stem, ac as StringNumber, a8 as TabConfig, ap as TempoAnnotation, ad as getStringNumbers, ag as getVerseNumbers, a9 as getVoiceIds, ae as isStringNumber, ah as isVerseNumber, aa as isVoiceId, af as validateStringNumber, ai as validateVerseNumber, ab as validateVoiceId } from '../music-objects-ONIuVUgs.mjs';
+import { N as Note } from '../note-RVXvpfyV.mjs';
+import { S as ScaleType, c as Scale } from '../scale-C8gHC448.mjs';
+import { N as NoteLength, i as NoteLengthStr, K as KeySignature, b as TimeSignature, T as TimeSignatures, B as BeamGrouping, l as TupletRatio } from '../tempo-BlCGZuYg.mjs';
 import '@tspro/ts-utils-lib';
 
+/**
+ * @deprecated - Will be removed in `v6.0.0`. Use `AnchoredRect` from `@tspro/ts-utils-lib` instead.
+ *
+ * DivRect class, left, top, right, bottom rectangle divided into four sections by anchorX, anchorY.
+ */
+declare class DivRect {
+    left: number;
+    anchorX: number;
+    right: number;
+    top: number;
+    anchorY: number;
+    bottom: number;
+    /**
+     * Create rectangle with all zero values.
+     */
+    constructor();
+    /**
+     * Create rectangle with left, right, top, bottom.
+     * Properties anchorX and anchorY 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 anchorX - Center x-coordinate.
+     * @param right - Right coordinate.
+     * @param top - Top coordinate.
+     * @param anchorY - Center y-coordinate.
+     * @param bottom - Bottom coordinate.
+     */
+    constructor(left: number, anchorX: number, right: number, top: number, anchorY: number, bottom: number);
+    /**
+     * Create rect from basic left, top, width and height arguments.
+     *
+     * @param left - Left coordinate.
+     * @param top - Top coordinate.
+     * @param width - Width.
+     * @param height - Height.
+     * @returns - DivRect.
+     */
+    static create(left: number, top: number, width: number, height: number): DivRect;
+    /**
+     * Create rect from anchorX, anchorY, 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;
+    /** @deprecated - Renamed to anchorX. */
+    get centerX(): number;
+    /** @deprecated - Renamed to anchorX. */
+    set centerX(x: number);
+    /** @deprecated - Renamed to anchorY. */
+    get centerY(): number;
+    /** @deprecated - Renamed to anchorY. */
+    set centerY(y: number);
+    /**
+     * 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 given rects are equal.
+     * @param a - DivRect a.
+     * @param b - DivRect b.
+     * @returns - True/false.
+     */
+    static equals(a: DivRect | null | undefined, b: DivRect | null | undefined): boolean;
+    /**
+     * Check if this rect equals with another rect.
+     * @param other - The other rect.
+     * @returns - True/false.
+     */
+    equals(other: DivRect): boolean;
+    /**
+     * Check if edges of given rects are equal, ignoring anchorX and anchorY.
+     *
+     * @param a - DivRect a.
+     * @param b - DivRect b.
+     * @returns - True/false.
+     */
+    static equalsEdges(a: DivRect | null | undefined, b: DivRect | null | undefined): boolean;
+    /**
+     * Check if edges of this Rect equals with given Rect, ignoring anchorX and anchorY.
+     *
+     * @param other - The other DivRect.
+     * @returns - True/false.
+     */
+    equalsEdges(other: DivRect): boolean;
+    /** @deprecated - Use `DivRect.equalsEdges()` instead. */
+    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 (anchorX, anchorY). 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 (anchorX, anchorY). 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;
+}
+
 /** Tuplet builder type. */
 type TupletBuilder = {
     /**
@@ -88,6 +314,7 @@ declare class DocumentBuilder {
      * @param config - Score configuration (e.g. { type: "staff", clef: "G", isOctavewDown: true }).
      */
     setScoreConfiguration(config: ScoreConfiguration): DocumentBuilder;
+    private static DefaultMeasureOptions;
     private getMeasure;
     /**
      * Get music document after finished building.
@@ -110,9 +337,10 @@ declare class DocumentBuilder {
     setMeasuresPerRow(measuresPerRow: number): DocumentBuilder;
     /**
      * Add new measure.
+     * @param measureOptions - Measure options.
      * @returns - This document builder instance.
      */
-    addMeasure(): DocumentBuilder;
+    addMeasure(measureOptions?: MeasureOptions): DocumentBuilder;
     /**
      * Set key signature for current measure and forward.
      * @param tonic - Tonic note (e.g. "C").
@@ -421,4 +649,4 @@ declare class DocumentBuilder {
     addScaleArpeggio(scale: Scale, bottomNote: string, numOctaves: number): DocumentBuilder;
 }
 
-export { Annotation, AnnotationText, Connective, DocumentBuilder, type ExtensionBuilder, Fermata, Label, LyricsOptions, MDocument, Navigation, NoteAnchor, NoteOptions, RestOptions, ScoreConfiguration, StaffPreset, StaffTabOrGroups, TieType, type TupletBuilder, TupletOptions, VerseNumber, VerticalPosition, VoiceId };
+export { Annotation, AnnotationText, Connective, DivRect, DocumentBuilder, type ExtensionBuilder, Fermata, Label, LyricsOptions, MDocument, MeasureOptions, Navigation, NoteAnchor, NoteOptions, RestOptions, ScoreConfiguration, StaffPreset, StaffTabOrGroups, TieType, type TupletBuilder, TupletOptions, VerseNumber, VerticalPosition, VoiceId };