@tspro/web-music-score 3.1.0 → 3.2.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [3.2.0] - 2025-09-12
+## Added
+- Added getter functions to score interface (MDocument, MMeasure, etc.)
+
+## Fixed
+- Extension line tip direction.
+- Cursor top was always 0 (top of document instead of top of row).
+- Pick accidental.
+
+## Changed
+- Do not pick note groups, rests and rhythm columns (only visible with multiple staff/tab anyway).
+
+## [3.1.1] - 2025-09-10
+## Fixed
+- Accept array of staff/tab/group for addFermataTo(), addNavigationTo(), addAnnotationTo() and addLabelTo().
+- Better infinite recursion detection for staff groups.
+
 ## [3.1.0] - 2025-09-09
 ## Added
 - Staff/TabConfig.name.

package/README.md

@@ -144,6 +144,7 @@ builder.setScoreConfiguration(config: (Score.StaffConfig | Score.TabConfig)[]);
 * `type`: "staff"
 * `clef`: Clef can be `Score.Clef.G` or `Score.Clef.F`.
 * `isOctaveDown`: boolean (optional)
+* `name`: staff name.
 * `minNote`: string (optional), minimum note allowed in staff.
 * `maxNote`: string (optional), maximum note allowed in staff.
 * `voiceIds`: number[] (optional), array of voice ids are visible on this staff.
@@ -151,6 +152,7 @@ builder.setScoreConfiguration(config: (Score.StaffConfig | Score.TabConfig)[]);
 
 `TabConfig` contains following properties:
 * `type`: "tab"
+* `name`: tab name.
 * `tuning`: string | string[] (optional), tuning name or array of 6 note names for tuning.
 * `voiceIds`: number[] (optional), array of voice ids are visible on this tab.
 
@@ -395,13 +397,13 @@ There are alternatives to these functions:
 
 First argument of these alterate functions is:
 
- `staffTabOrGroup: number | string | (number | string)[]`.
+ `staffTabOrGroups: Score.StaffTabOrGroups`.
 
-It can be one of following things:
+`StaffTabOrGroups` can be:
 - `number`: staff/tab index, 0=top staff/tab, etc.
 - `string`: staff/tab name.
 - `string`: staff group name.
-- Or an array of the above.
+- `(number | string)[]`: an array of staff/tab indices, names or group names.
 
 ```js
 // Example: add label to top staff/tab.

package/dist/audio/index.d.mts

@@ -1,22 +1,15 @@
-import { N as Note } from '../note-B5ZtlHc8.mjs';
+import { N as Note } from '../note-BFa43I86.mjs';
 
-/** @public */
 interface Instrument {
     getName(): string;
     playNote(note: string, duration?: number, volume?: number): void;
     stop(): void;
 }
-/** @public */
 declare function getInstrumentList(): ReadonlyArray<string>;
-/** @public */
 declare function getCurrentInstrument(): string;
-/** @public */
 declare function registerInstrument(instr: Instrument): void;
-/** @public */
 declare function setInstrument(instrName: string): void;
-/** @public */
 declare function playNote(note: Note | string | number, duration?: number, linearVolume?: number): void;
-/** @public */
 declare function stop(): void;
 
 export { type Instrument, getCurrentInstrument, getInstrumentList, playNote, registerInstrument, setInstrument, stop };

package/dist/audio/index.d.ts

@@ -1,22 +1,15 @@
-import { N as Note } from '../note-B5ZtlHc8.js';
+import { N as Note } from '../note-BFa43I86.js';
 
-/** @public */
 interface Instrument {
     getName(): string;
     playNote(note: string, duration?: number, volume?: number): void;
     stop(): void;
 }
-/** @public */
 declare function getInstrumentList(): ReadonlyArray<string>;
-/** @public */
 declare function getCurrentInstrument(): string;
-/** @public */
 declare function registerInstrument(instr: Instrument): void;
-/** @public */
 declare function setInstrument(instrName: string): void;
-/** @public */
 declare function playNote(note: Note | string | number, duration?: number, linearVolume?: number): void;
-/** @public */
 declare function stop(): void;
 
 export { type Instrument, getCurrentInstrument, getInstrumentList, playNote, registerInstrument, setInstrument, stop };

package/dist/audio/index.js

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

package/dist/audio/index.mjs

@@ -1,7 +1,7 @@
-/* WebMusicScore v3.1.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v3.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
   __publicField
-} from "../chunk-B4J3KED2.mjs";
+} from "../chunk-LCTM7BID.mjs";
 
 // src/audio/index.ts
 import { Note, PitchNotation, SymbolSet } from "@tspro/web-music-score/theory";

package/dist/audio-cg/index.d.mts

@@ -1,4 +1,3 @@
-/** @public */
 declare function registerClassicalGuitar(): void;
 
 export { registerClassicalGuitar };

package/dist/audio-cg/index.d.ts

@@ -1,4 +1,3 @@
-/** @public */
 declare function registerClassicalGuitar(): void;
 
 export { registerClassicalGuitar };

package/dist/audio-cg/index.js

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

package/dist/audio-cg/index.mjs

@@ -1,7 +1,7 @@
-/* WebMusicScore v3.1.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v3.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
   __publicField
-} from "../chunk-B4J3KED2.mjs";
+} from "../chunk-LCTM7BID.mjs";
 
 // src/audio-cg/index.ts
 import * as Tone from "tone";

package/dist/{chunk-B4J3KED2.mjs → chunk-LCTM7BID.mjs}

@@ -1,4 +1,4 @@
-/* WebMusicScore v3.1.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v3.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -6,4 +6,4 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 export {
   __publicField
 };
-//# sourceMappingURL=chunk-B4J3KED2.mjs.map
+//# sourceMappingURL=chunk-LCTM7BID.mjs.map

package/dist/core/index.d.mts

@@ -1,4 +1,3 @@
-/** @public */
 declare enum MusicErrorType {
     Unknown = 0,
     InvalidArg = 1,
@@ -8,14 +7,12 @@ declare enum MusicErrorType {
     Timesignature = 5,
     Score = 6
 }
-/** @public */
 declare class MusicError extends Error {
     readonly type: MusicErrorType;
     constructor(message: string);
     constructor(type: MusicErrorType, message: string);
 }
 
-/** @public */
 declare function init(): void;
 
 export { MusicError, MusicErrorType, init };

package/dist/core/index.d.ts

@@ -1,4 +1,3 @@
-/** @public */
 declare enum MusicErrorType {
     Unknown = 0,
     InvalidArg = 1,
@@ -8,14 +7,12 @@ declare enum MusicErrorType {
     Timesignature = 5,
     Score = 6
 }
-/** @public */
 declare class MusicError extends Error {
     readonly type: MusicErrorType;
     constructor(message: string);
     constructor(type: MusicErrorType, message: string);
 }
 
-/** @public */
 declare function init(): void;
 
 export { MusicError, MusicErrorType, init };

package/dist/core/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v3.1.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v3.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -61,7 +61,7 @@ function init() {
     return;
   }
   initialized = true;
-  console.log("%cWebMusicScore v3.1.0 (cjs) initialized.", "background: black; color: white; padding: 2px;");
+  console.log("%cWebMusicScore v3.2.0 (cjs) initialized.", "background: black; color: white; padding: 2px;");
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/core/index.mjs

@@ -1,7 +1,7 @@
-/* WebMusicScore v3.1.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v3.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
   __publicField
-} from "../chunk-B4J3KED2.mjs";
+} from "../chunk-LCTM7BID.mjs";
 
 // src/core/error.ts
 var MusicErrorType = /* @__PURE__ */ ((MusicErrorType2) => {
@@ -35,7 +35,7 @@ function init() {
     return;
   }
   initialized = true;
-  console.log("%cWebMusicScore v3.1.0 (esm) initialized.", "background: black; color: white; padding: 2px;");
+  console.log("%cWebMusicScore v3.2.0 (esm) initialized.", "background: black; color: white; padding: 2px;");
 }
 export {
   MusicError,

package/dist/{guitar-BIFwFT31.d.ts → guitar-C2Cp71NZ.d.ts}

@@ -1,22 +1,15 @@
-import { N as Note } from './note-B5ZtlHc8.js';
+import { N as Note } from './note-BFa43I86.js';
 
-/** @public */
 declare enum Handedness {
     RightHanded = 0,
     LeftHanded = 1
 }
-/** @public */
 declare const DefaultHandedness = Handedness.RightHanded;
-/** @public */
 declare function validateHandedness(h: unknown): Handedness;
-/** @public */
 declare const TuningNameList: ReadonlyArray<string>;
-/** @public */
 declare const DefaultTuningName: string;
-/** @public */
 declare function validateTuningName(tuningName: string): string;
 /**
- * @public
  * @returns Array of open string notes, note for each string.
  */
 declare function getTuningStrings(tuningName: string): ReadonlyArray<Note>;

package/dist/{guitar-zASF7B1g.d.mts → guitar-DggbM2UL.d.mts}

@@ -1,22 +1,15 @@
-import { N as Note } from './note-B5ZtlHc8.mjs';
+import { N as Note } from './note-BFa43I86.mjs';
 
-/** @public */
 declare enum Handedness {
     RightHanded = 0,
     LeftHanded = 1
 }
-/** @public */
 declare const DefaultHandedness = Handedness.RightHanded;
-/** @public */
 declare function validateHandedness(h: unknown): Handedness;
-/** @public */
 declare const TuningNameList: ReadonlyArray<string>;
-/** @public */
 declare const DefaultTuningName: string;
-/** @public */
 declare function validateTuningName(tuningName: string): string;
 /**
- * @public
  * @returns Array of open string notes, note for each string.
  */
 declare function getTuningStrings(tuningName: string): ReadonlyArray<Note>;