musicxml-io 0.12.0 → 0.12.2

package/README.md

@@ -76,6 +76,8 @@ const output = serialize(transposed);
 
 ### ABC Notation
 
+For MusicXML-first applications, see [Bundle size and optional formats](#bundle-size-and-optional-formats).
+
 ```typescript
 import { parseAbc, serializeAbc } from 'musicxml-io';
 
@@ -95,11 +97,95 @@ import { parseAbcTunes, serializeAbcTunes } from 'musicxml-io';
 const tunes = parseAbcTunes(abcString);   // Score[]
 const book = serializeAbcTunes(tunes);
 
-// Auto-detect format (MusicXML, .mxl, or ABC)
+// Auto-detect MusicXML or .mxl (ABC uses parseAbc)
 import { parseAuto } from 'musicxml-io';
 const score2 = parseAuto(input);
 ```
 
+### Bundle size and optional formats
+
+The existing `musicxml-io` and `musicxml-io/browser` exports remain compatible.
+Unused ABC initialization can now be tree-shaken away. For applications that
+load optional formats dynamically, use the format-specific entry points:
+
+| Import | Contents |
+|--------|----------|
+| `musicxml-io/core` | MusicXML/XML/MXL, query, operations, accessors, validation, IDs and their types; no ABC, MIDI or file I/O |
+| `musicxml-io/musicxml` | `parse`, `serialize`, `serializeUnchecked`, serialization options and score types; no ZIP dependency |
+| `musicxml-io/musicxml-compressed` | `parseAuto`, `parseCompressed`, `isCompressed`, `serializeCompressed` |
+| `musicxml-io/abc` | `parseAbc`, `parseAbcTunes`, `serializeAbc`, `serializeAbcTunes`, `AbcSerializeOptions` |
+| `musicxml-io/midi` | `exportMidi`, `exportMidiWithTimingMap` and MIDI export types |
+| `musicxml-io/file` | Node.js `parseFile`, `serializeToFile`, `decodeBuffer`; optional codecs load on demand |
+
+The existing `/query`, `/operations` and `/accessors` entry points remain available.
+All entry points support ESM and CommonJS, with TypeScript declarations.
+
+```typescript
+import { parseAuto, serialize, generateId } from 'musicxml-io/core';
+import type { Score } from 'musicxml-io/core';
+
+// Normal MusicXML / MXL loading remains synchronous.
+const score = parseAuto(xmlOrMxl);
+
+// Call only when the user opens an ABC file.
+async function openAbc(text: string): Promise<Score> {
+  const { parseAbc } = await import('musicxml-io/abc');
+  return parseAbc(text);
+}
+
+async function saveMidi(score: Score): Promise<Uint8Array> {
+  const { exportMidi } = await import('musicxml-io/midi');
+  return exportMidi(score);
+}
+```
+
+For reliable code splitting, migrate **all runtime imports** in the relevant
+application graph from the full root/browser entry to `/core` or narrower
+entry points. A full entry also re-exports ABC and MIDI; some bundlers can
+hoist those into an initially loaded shared chunk when a dynamic import of
+the same format exists elsewhere. Type-only root imports do not add runtime code.
+Dynamic imports need code-splitting support in the consuming bundler.
+
+For `musicxml-layout`, its MusicXML re-exports and other runtime imports can use
+`/core` (or `/musicxml`, `/query`, `/accessors` as appropriate). For Octava,
+`src/data/musicxml-importer.ts` currently imports `parseAbc` eagerly. Load `/abc`
+only on the ABC path, and finish the asynchronous parsing **before** entering
+the synchronous Yjs transaction in `ScoreDataManager.importFromMusicXML`.
+Both projects need the version containing these entry points installed first.
+
+For export paths that do not request validation, use `serializeUnchecked` to
+keep the validator out of the bundle. Its output is identical to `serialize`
+with validation disabled (the default), and it accepts `version` and `indent`:
+
+```typescript
+import { serializeUnchecked as serialize } from 'musicxml-io/musicxml';
+
+const xml = serialize(score);
+```
+
+For example, Octava's `src/data/musicxml-exporter.ts` can use this import after
+upgrading the dependency. Keep using `serialize` for callers that pass
+`validate`, `validateOptions`, `throwOnValidationError` or `onValidation`.
+The existing `serialize` API and its validation behavior remain unchanged.
+
+`npm run check:bundle` builds the package, measures minified/gzipped consumer
+bundles, checks that ABC stays out of initial MusicXML bundles (including a
+lazy ABC consumer), checks that unchecked export excludes validation, and
+smoke-tests the published ESM and CommonJS exports.
+`npm run bench:loading` measures XML/MXL parsing and ID generation; the MXL
+benchmark includes an embedded asset to verify that unused files are not inflated.
+`npm run bench:io` measures XML import/export at several sizes and peak import
+RSS in a separate process. The largest case repeats ActorPrelude's measures
+eight times (about 10 MB). To compare against a saved previous build, run
+`npm run bench:io -- --baseline=/absolute/path/to/previous/dist`.
+Timings are medians of nine runs, with baseline/current execution order
+alternated. No performance thresholds are imposed on shared CI machines.
+
+The importer converts completed measures immediately and releases their XML
+subtrees. The exporter joins lines per measure and avoids temporary notation
+groups on the common single-container path, reducing allocation and GC for
+large scores while preserving the existing XML formatting.
+
 `parseAbc` returns the first tune of a multi-tune file; use `parseAbcTunes`
 to get them all.
 
@@ -476,19 +562,21 @@ import { isRest, getPartName } from 'musicxml-io/accessors';
 ```
 
 The package declares `"sideEffects": false`, so bundlers can drop everything
-you don't import — pulling in only `parse` costs roughly 51 KB minified
-(~14 KB gzip).
+you don't import — pulling in only `parse` costs roughly 48 KB minified
+(~13 KB gzip).
 
 Approximate cost of common imports (minified / gzipped, measured with
 esbuild against the published ESM build):
 
 | Import | Size |
 |--------|------|
-| `parse` (.xml only) | ~51 KB / ~14 KB |
-| `parseAuto` (.xml + .mxl, adds fflate's unzip) | ~57 KB / ~17 KB |
-| `serialize` (includes the validator behind `validate: true`) | ~62 KB / ~15 KB |
-| `parse` + `serialize` | ~109 KB / ~28 KB |
-| everything | ~316 KB / ~78 KB |
+| `parse` (.xml only) | ~48 KB / ~13 KB |
+| `parseAuto` (.xml + .mxl, adds fflate's unzip) | ~54 KB / ~16 KB |
+| `serialize` (includes the validator behind `validate: true`) | ~58 KB / ~14 KB |
+| `serializeUnchecked` (no validator) | ~45 KB / ~10 KB |
+| `parse` + `serialize` | ~106 KB / ~27 KB |
+| `parse` + `serializeUnchecked` | ~93 KB / ~23 KB |
+| everything (browser entry) | ~324 KB / ~81 KB |
 
 The ABC notation codecs (`parseAbc`, `serializeAbc`), MIDI export, query
 helpers, operations, and the validator are all separate modules — they only

package/dist/abc-HXITSXCS.js

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkZSEJQPBOjs = require('./chunk-ZSEJQPBO.js');
+require('./chunk-LS5SHP75.js');
+
+
+
+exports.serializeAbc = _chunkZSEJQPBOjs.serializeAbc; exports.serializeAbcTunes = _chunkZSEJQPBOjs.serializeAbcTunes;

package/dist/abc-IAD53SFI.mjs

@@ -0,0 +1,11 @@
+import {
+  parseAbc,
+  parseAbcTunes
+} from "./chunk-KYGLANYG.mjs";
+import "./chunk-F2UCOAO6.mjs";
+import "./chunk-AOSK4RGV.mjs";
+import "./chunk-5VF442RA.mjs";
+export {
+  parseAbc,
+  parseAbcTunes
+};

package/dist/abc-MTGVOYKS.js

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkNIUEAHPNjs = require('./chunk-NIUEAHPN.js');
+require('./chunk-LS5SHP75.js');
+require('./chunk-776XPK66.js');
+require('./chunk-5EK7K5X3.js');
+
+
+
+exports.parseAbc = _chunkNIUEAHPNjs.parseAbc; exports.parseAbcTunes = _chunkNIUEAHPNjs.parseAbcTunes;

package/dist/abc-R7DIJSHG.mjs

@@ -0,0 +1,9 @@
+import {
+  serializeAbc,
+  serializeAbcTunes
+} from "./chunk-QKUNJEVW.mjs";
+import "./chunk-F2UCOAO6.mjs";
+export {
+  serializeAbc,
+  serializeAbcTunes
+};

package/dist/abc.d.mts

@@ -0,0 +1,67 @@
+import { S as Score } from './types-B-RGHY0c.mjs';
+
+/**
+ * ABC Notation Parser
+ * Parses ABC notation format into the Score internal model.
+ *
+ * Supports ABC standard v2.1 core features:
+ * - Header fields (X, T, C, M, L, Q, K, V, P, U, w, W, and `+:` continuations)
+ * - Notes with pitch, duration, accidentals (including microtones), octaves
+ * - Rests (z, Z, multi-measure Zn), invisible rests (x, Xn) and spacers (y)
+ * - Bar lines (|, ||, |], [|, |:, :|, ::, [|], .|)
+ * - Repeats and volta endings, including lists and ranges ([1,3, [1-3)
+ * - Chords (simultaneous notes: [CEG]) with rests and per-note durations
+ * - Chord symbols ("Am", "G7") and text annotations ("^above", "_below", ...)
+ * - Ties (-), slurs ((...)) and dotted slurs (.(...))
+ * - Grace notes ({...}) and acciaccaturas ({/...})
+ * - Tuplets ((3..., (p:q:r...)
+ * - Decorations: shorthand (. ~ H L M O P S T u v), !name! and legacy +name+
+ * - Lyrics (w: field, multiple verses) and symbol lines (s:)
+ * - Multi-voice (V: field) and multi-tune files (repeated X: fields)
+ */
+
+/**
+ * Parse every tune in an ABC file.
+ *
+ * ABC files may hold any number of tunes, each introduced by an `X:` field.
+ * {@link parseAbc} returns only the first; use this to get them all.
+ */
+declare function parseAbcTunes(abcString: string): Score[];
+/**
+ * Parse an ABC notation string into a Score object.
+ *
+ * When the input holds several tunes, only the first is returned — use
+ * {@link parseAbcTunes} to parse them all.
+ */
+declare function parseAbc(abcString: string): Score;
+
+/**
+ * ABC Notation Serializer
+ * Converts Score internal model to ABC notation format string.
+ */
+
+interface AbcSerializeOptions {
+    /** Reference number (X: field). Default: 1 */
+    referenceNumber?: number;
+    /** Maximum notes per line before wrapping. Default: no limit */
+    notesPerLine?: number;
+    /** Include chord symbols. Default: true */
+    includeChordSymbols?: boolean;
+    /** Include dynamics. Default: true */
+    includeDynamics?: boolean;
+    /** Include lyrics. Default: true */
+    includeLyrics?: boolean;
+}
+/**
+ * Serialize several Scores into a single multi-tune ABC file.
+ *
+ * Counterpart to `parseAbcTunes`: each Score becomes one tune, separated by a
+ * blank line as the ABC standard requires.
+ */
+declare function serializeAbcTunes(scores: Score[], options?: AbcSerializeOptions): string;
+/**
+ * Serialize a Score object to ABC notation format string.
+ */
+declare function serializeAbc(score: Score, options?: AbcSerializeOptions): string;
+
+export { type AbcSerializeOptions, Score, parseAbc, parseAbcTunes, serializeAbc, serializeAbcTunes };

package/dist/abc.d.ts

@@ -0,0 +1,67 @@
+import { S as Score } from './types-B-RGHY0c.js';
+
+/**
+ * ABC Notation Parser
+ * Parses ABC notation format into the Score internal model.
+ *
+ * Supports ABC standard v2.1 core features:
+ * - Header fields (X, T, C, M, L, Q, K, V, P, U, w, W, and `+:` continuations)
+ * - Notes with pitch, duration, accidentals (including microtones), octaves
+ * - Rests (z, Z, multi-measure Zn), invisible rests (x, Xn) and spacers (y)
+ * - Bar lines (|, ||, |], [|, |:, :|, ::, [|], .|)
+ * - Repeats and volta endings, including lists and ranges ([1,3, [1-3)
+ * - Chords (simultaneous notes: [CEG]) with rests and per-note durations
+ * - Chord symbols ("Am", "G7") and text annotations ("^above", "_below", ...)
+ * - Ties (-), slurs ((...)) and dotted slurs (.(...))
+ * - Grace notes ({...}) and acciaccaturas ({/...})
+ * - Tuplets ((3..., (p:q:r...)
+ * - Decorations: shorthand (. ~ H L M O P S T u v), !name! and legacy +name+
+ * - Lyrics (w: field, multiple verses) and symbol lines (s:)
+ * - Multi-voice (V: field) and multi-tune files (repeated X: fields)
+ */
+
+/**
+ * Parse every tune in an ABC file.
+ *
+ * ABC files may hold any number of tunes, each introduced by an `X:` field.
+ * {@link parseAbc} returns only the first; use this to get them all.
+ */
+declare function parseAbcTunes(abcString: string): Score[];
+/**
+ * Parse an ABC notation string into a Score object.
+ *
+ * When the input holds several tunes, only the first is returned — use
+ * {@link parseAbcTunes} to parse them all.
+ */
+declare function parseAbc(abcString: string): Score;
+
+/**
+ * ABC Notation Serializer
+ * Converts Score internal model to ABC notation format string.
+ */
+
+interface AbcSerializeOptions {
+    /** Reference number (X: field). Default: 1 */
+    referenceNumber?: number;
+    /** Maximum notes per line before wrapping. Default: no limit */
+    notesPerLine?: number;
+    /** Include chord symbols. Default: true */
+    includeChordSymbols?: boolean;
+    /** Include dynamics. Default: true */
+    includeDynamics?: boolean;
+    /** Include lyrics. Default: true */
+    includeLyrics?: boolean;
+}
+/**
+ * Serialize several Scores into a single multi-tune ABC file.
+ *
+ * Counterpart to `parseAbcTunes`: each Score becomes one tune, separated by a
+ * blank line as the ABC standard requires.
+ */
+declare function serializeAbcTunes(scores: Score[], options?: AbcSerializeOptions): string;
+/**
+ * Serialize a Score object to ABC notation format string.
+ */
+declare function serializeAbc(score: Score, options?: AbcSerializeOptions): string;
+
+export { type AbcSerializeOptions, Score, parseAbc, parseAbcTunes, serializeAbc, serializeAbcTunes };

package/dist/abc.js

@@ -0,0 +1,17 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkNIUEAHPNjs = require('./chunk-NIUEAHPN.js');
+
+
+
+var _chunkZSEJQPBOjs = require('./chunk-ZSEJQPBO.js');
+require('./chunk-LS5SHP75.js');
+require('./chunk-776XPK66.js');
+require('./chunk-5EK7K5X3.js');
+
+
+
+
+
+exports.parseAbc = _chunkNIUEAHPNjs.parseAbc; exports.parseAbcTunes = _chunkNIUEAHPNjs.parseAbcTunes; exports.serializeAbc = _chunkZSEJQPBOjs.serializeAbc; exports.serializeAbcTunes = _chunkZSEJQPBOjs.serializeAbcTunes;

package/dist/abc.mjs

@@ -0,0 +1,17 @@
+import {
+  parseAbc,
+  parseAbcTunes
+} from "./chunk-KYGLANYG.mjs";
+import {
+  serializeAbc,
+  serializeAbcTunes
+} from "./chunk-QKUNJEVW.mjs";
+import "./chunk-F2UCOAO6.mjs";
+import "./chunk-AOSK4RGV.mjs";
+import "./chunk-5VF442RA.mjs";
+export {
+  parseAbc,
+  parseAbcTunes,
+  serializeAbc,
+  serializeAbcTunes
+};

package/dist/accessors/index.d.mts

@@ -1,4 +1,4 @@
-import { o as DirectionType, D as DirectionEntry, N as NoteEntry, c as PartListEntry, P as PartInfo, S as Score } from '../types-Cy0veafI.mjs';
+import { o as DirectionType, D as DirectionEntry, N as NoteEntry, c as PartListEntry, P as PartInfo, S as Score } from '../types-B-RGHY0c.mjs';
 
 /**
  * Entry-level accessors for DirectionEntry, NoteEntry, and PartInfo

package/dist/accessors/index.d.ts

@@ -1,4 +1,4 @@
-import { o as DirectionType, D as DirectionEntry, N as NoteEntry, c as PartListEntry, P as PartInfo, S as Score } from '../types-Cy0veafI.js';
+import { o as DirectionType, D as DirectionEntry, N as NoteEntry, c as PartListEntry, P as PartInfo, S as Score } from '../types-B-RGHY0c.js';
 
 /**
  * Entry-level accessors for DirectionEntry, NoteEntry, and PartInfo

package/dist/browser.d.mts

@@ -1,188 +1,12 @@
-import { S as Score, g as Pitch, M as Measure } from './types-Cy0veafI.mjs';
-export { A as Accidental, i as AccidentalInfo, j as AccidentalMarkInfo, a2 as AdjacentNotes, ag as AssembledLyrics, B as BackupEntry, y as Barline, ah as BarlineWithContext, ac as BeamGroup, m as BeamInfo, G as Chord, w as Clef, am as ClefChangeInfo, C as Color, Q as Credit, U as CreditImage, R as CreditWords, O as Defaults, D as DirectionEntry, a3 as DirectionKind, o as DirectionType, Z as DirectionWithContext, u as DisplayText, a4 as DynamicWithContext, p as DynamicsValue, aj as EndingInfo, Y as EntryWithContext, s as FiguredBassEntry, F as ForwardEntry, H as HarmonyEntry, r as HarmonyFrame, ae as HarmonyWithContext, ak as KeyChangeInfo, K as KeySignature, L as Lyric, q as LyricTextElement, af as LyricWithContext, e as MeasureAttributes, f as MeasureEntry, t as MeasureStyle, n as Notation, ad as NotationType, N as NoteEntry, I as NoteIteratorItem, h as NoteType, X as NoteWithContext, E as NoteWithPosition, k as NoteheadInfo, a8 as OctaveShiftWithContext, d as Part, b as PartGroup, P as PartInfo, c as PartListEntry, a6 as PedalWithContext, $ as PositionQueryOptions, J as Print, ai as RepeatInfo, a as ScoreMetadata, aa as SlurSpan, z as StaffGroup, _ as StaffRange, l as StemInfo, an as StructuralChanges, a5 as TempoWithContext, T as TieInfo, a9 as TiedNoteGroup, al as TimeChangeInfo, v as TimeSignature, x as Transpose, ab as TupletGroup, a0 as VerticalSlice, V as VoiceGroup, a1 as VoiceLine, W as VoiceToStaffMap, a7 as WedgeWithContext } from './types-Cy0veafI.mjs';
-import { cP as ValidateOptions, cL as ValidationResult } from './index-CuMPBK7U.mjs';
-export { aS as ALL_COLOR_TARGETS, bb as AddArticulationOptions, bk as AddBeamOptions, c9 as AddBowingOptions, ci as AddBreathMarkOptions, cl as AddCaesuraOptions, aX as AddChordOptions, c3 as AddChordSymbolOptions, bT as AddCodaOptions, bd as AddDynamicsOptions, bN as AddEndingOptions, bA as AddFermataOptions, c6 as AddFingeringOptions, bV as AddGraceNoteOptions, c0 as AddHarmonyOptions, bY as AddLyricOptions, bU as AddNavigationOptions, ce as AddOctaveShiftOptions, bC as AddOrnamentOptions, b3 as AddPartOptions, bE as AddPedalOptions, bI as AddRehearsalMarkOptions, bJ as AddRepeatBarlineOptions, bL as AddRepeatOptions, bS as AddSegnoOptions, b9 as AddSlurOptions, cb as AddStringNumberOptions, bv as AddTempoOptions, bG as AddTextDirectionOptions, bH as AddTextOptions, b7 as AddTieOptions, b2 as AddVoiceOptions, by as AddWedgeOptions, bm as AutoBeamOptions, bR as BarStyle, c8 as BowingType, ch as BreathMarkValue, ck as CaesuraValue, bP as ChangeBarlineOptions, bh as ChangeClefOptions, aY as ChangeNoteDurationOptions, cn as ColorTarget, bX as ConvertToGraceOptions, bs as CopyNotesMultiMeasureOptions, bp as CopyNotesOptions, bi as CreateTupletOptions, br as CutNotesOptions, b4 as DuplicatePartOptions, b$ as HarmonyKind, bg as InsertClefChangeOptions, aV as InsertNoteOptions, cR as LocalValidateOptions, b1 as LowerAccidentalOptions, cQ as MeasureValidationContext, bf as ModifyDynamicsOptions, bx as ModifyTempoOptions, b6 as MoveNoteToStaffOptions, bt as MultiMeasureSelection, bo as NoteSelection, cd as OctaveShiftType, aU as OperationErrorCode, aT as OperationResult, bu as PasteNotesMultiMeasureOptions, bq as PasteNotesOptions, b0 as RaiseAccidentalOptions, bc as RemoveArticulationOptions, bl as RemoveBeamOptions, ca as RemoveBowingOptions, cj as RemoveBreathMarkOptions, cm as RemoveCaesuraOptions, c4 as RemoveChordSymbolOptions, be as RemoveDynamicsOptions, bO as RemoveEndingOptions, bB as RemoveFermataOptions, c7 as RemoveFingeringOptions, bW as RemoveGraceNoteOptions, c1 as RemoveHarmonyOptions, bZ as RemoveLyricOptions, aW as RemoveNoteOptions, cg as RemoveOctaveShiftOptions, bD as RemoveOrnamentOptions, bF as RemovePedalOptions, bK as RemoveRepeatBarlineOptions, bM as RemoveRepeatOptions, ba as RemoveSlurOptions, cc as RemoveStringNumberOptions, bw as RemoveTempoOptions, b8 as RemoveTieOptions, bj as RemoveTupletOptions, bz as RemoveWedgeOptions, bQ as SetBarlineOptions, bn as SetBeamingOptions, co as SetColorOptions, a_ as SetNotePitchBySemitoneOptions, aZ as SetNotePitchOptions, b5 as SetStavesOptions, a$ as ShiftNotePitchOptions, cf as StopOctaveShiftOptions, c5 as UpdateChordSymbolOptions, c2 as UpdateHarmonyOptions, b_ as UpdateLyricOptions, cK as ValidationError, cN as ValidationErrorCode, cG as ValidationException, cO as ValidationLevel, cM as ValidationLocation, J as addArticulation, S as addBeam, aF as addBowing, aM as addBreathMark, aO as addCaesura, a as addChord, h as addChordNote, o as addChordNoteChecked, aA as addChordSymbol, am as addCoda, an as addDaCapo, ao as addDalSegno, L as addDynamics, ah as addEnding, a4 as addFermata, ap as addFine, aD as addFingering, ar as addGraceNote, ax as addHarmony, au as addLyric, f as addNote, k as addNoteChecked, aJ as addOctaveShift, a6 as addOrnament, w as addPart, a8 as addPedal, ac as addRehearsalMark, af as addRepeat, ad as addRepeatBarline, al as addSegno, H as addSlur, aH as addStringNumber, $ as addTempo, ab as addText, aa as addTextDirection, F as addTie, aq as addToCoda, v as addVoice, a2 as addWedge, cJ as assertMeasureValid, cr as assertValid, U as autoBeam, aj as changeBarline, P as changeClef, B as changeKey, d as changeNoteDuration, C as changeTime, aR as clearColors, at as convertToGrace, W as copyNotes, Z as copyNotesMultiMeasure, Q as createTuplet, Y as cutNotes, E as deleteMeasure, g as deleteNote, n as deleteNoteChecked, y as duplicatePart, cF as formatLocation, cI as getMeasureContext, O as insertClefChange, D as insertMeasure, i as insertNote, cq as isValid, l as lowerAccidental, N as modifyDynamics, j as modifyNoteDuration, q as modifyNoteDurationChecked, m as modifyNotePitch, p as modifyNotePitchChecked, a1 as modifyTempo, A as moveNoteToStaff, X as pasteNotes, _ as pasteNotesMultiMeasure, e as raiseAccidental, K as removeArticulation, T as removeBeam, aG as removeBowing, aN as removeBreathMark, aP as removeCaesura, aB as removeChordSymbol, M as removeDynamics, ai as removeEnding, a5 as removeFermata, aE as removeFingering, as as removeGraceNote, ay as removeHarmony, av as removeLyric, r as removeNote, aL as removeOctaveShift, a7 as removeOrnament, x as removePart, a9 as removePedal, ag as removeRepeat, ae as removeRepeatBarline, I as removeSlur, aI as removeStringNumber, a0 as removeTempo, G as removeTie, R as removeTuplet, a3 as removeWedge, ak as setBarline, V as setBeaming, aQ as setColor, s as setNotePitch, b as setNotePitchBySemitone, z as setStaves, c as shiftNotePitch, aK as stopOctaveShift, t as transpose, u as transposeChecked, aC as updateChordSymbol, az as updateHarmony, aw as updateLyric, cp as validate, cu as validateBackupForward, cw as validateBeams, cs as validateDivisions, ct as validateMeasureDuration, cH as validateMeasureLocal, cz as validatePartReferences, cA as validatePartStructure, cx as validateSlurs, cE as validateSlursAcrossMeasures, cB as validateStaffStructure, cv as validateTies, cD as validateTiesAcrossMeasures, cy as validateTuplets, cC as validateVoiceStaff } from './index-CuMPBK7U.mjs';
-import { ExpressionOptions, TimingSidecar } from './query/index.mjs';
-export { ExpressionHint, ExpressionKind, FindNotesFilter, NormalizedPositionOptions, PitchRange, PlaybackControls, PlaybackMeasure, RoundtripMetrics, TimingBreakpoint, TimingMapOptions, VoiceFilter, buildVoiceToStaffMap, buildVoiceToStaffMapForPart, countNotes, extractPlaybackControls, findBarlines, findDirectionsByType, findNotes, findNotesWithNotation, generatePlaybackSequence, generatePlaybackTimeline, getAbsolutePosition, getAdjacentNotes, getAllNotes, getAttributesAtMeasure, getBeamGroups, getChordProgression, getChords, getClefChanges, getClefForStaff, getDirections, getDirectionsAtPosition, getDivisions, getDuration, getDynamics, getEffectiveStaff, getEndings, getEntriesAtPosition, getEntriesForStaff, getEntriesInRange, getHarmonies, getHarmonyAtPosition, getKeyChanges, getLyricText, getLyrics, getMeasure, getMeasureByIndex, getMeasureCount, getNextNote, getNormalizedDuration, getNormalizedPosition, getNotesAtPosition, getNotesForStaff, getNotesForVoice, getNotesInRange, getOctaveShifts, getPartById, getPartByIndex, getPartCount, getPartIds, getPartIndex, getPedalMarkings, getPrevNote, getRepeatStructure, getSlurSpans, getStaffRange, getStaveCount, getStaves, getStructuralChanges, getTempoMarkings, getTiedNoteGroups, getTimeChanges, getTupletGroups, getVerseCount, getVerticalSlice, getVoiceLine, getVoiceLineInRange, getVoices, getVoicesForStaff, getWedges, groupByStaff, groupByVoice, hasMultipleStaves, hasNotes, hasPlaybackControls, inferStaff, isRestMeasure, iterateEntries, iterateNotes, measureRoundtrip, scoresEqual, withAbsolutePositions } from './query/index.mjs';
+export { A as Accidental, i as AccidentalInfo, j as AccidentalMarkInfo, a2 as AdjacentNotes, ag as AssembledLyrics, B as BackupEntry, y as Barline, ah as BarlineWithContext, ac as BeamGroup, m as BeamInfo, G as Chord, w as Clef, am as ClefChangeInfo, C as Color, Q as Credit, U as CreditImage, R as CreditWords, O as Defaults, D as DirectionEntry, a3 as DirectionKind, o as DirectionType, Z as DirectionWithContext, u as DisplayText, a4 as DynamicWithContext, p as DynamicsValue, aj as EndingInfo, Y as EntryWithContext, s as FiguredBassEntry, F as ForwardEntry, H as HarmonyEntry, r as HarmonyFrame, ae as HarmonyWithContext, ak as KeyChangeInfo, K as KeySignature, L as Lyric, q as LyricTextElement, af as LyricWithContext, M as Measure, e as MeasureAttributes, f as MeasureEntry, t as MeasureStyle, n as Notation, ad as NotationType, N as NoteEntry, I as NoteIteratorItem, h as NoteType, X as NoteWithContext, E as NoteWithPosition, k as NoteheadInfo, a8 as OctaveShiftWithContext, d as Part, b as PartGroup, P as PartInfo, c as PartListEntry, a6 as PedalWithContext, g as Pitch, $ as PositionQueryOptions, J as Print, ai as RepeatInfo, S as Score, a as ScoreMetadata, aa as SlurSpan, z as StaffGroup, _ as StaffRange, l as StemInfo, an as StructuralChanges, a5 as TempoWithContext, T as TieInfo, a9 as TiedNoteGroup, al as TimeChangeInfo, v as TimeSignature, x as Transpose, ab as TupletGroup, a0 as VerticalSlice, V as VoiceGroup, a1 as VoiceLine, W as VoiceToStaffMap, a7 as WedgeWithContext } from './types-B-RGHY0c.mjs';
+export { parse } from './musicxml.mjs';
+export { isCompressed, parseAuto, parseCompressed, serializeCompressed } from './musicxml-compressed.mjs';
+export { S as SerializeOptions, b as SerializeUncheckedOptions, s as serialize, a as serializeUnchecked } from './musicxml-DzuFr2c3.mjs';
+export { FindNotesFilter, NormalizedPositionOptions, PitchRange, PlaybackControls, PlaybackMeasure, RoundtripMetrics, VoiceFilter, buildVoiceToStaffMap, buildVoiceToStaffMapForPart, countNotes, extractPlaybackControls, findBarlines, findDirectionsByType, findNotes, findNotesWithNotation, generatePlaybackSequence, getAbsolutePosition, getAdjacentNotes, getAllNotes, getAttributesAtMeasure, getBeamGroups, getChordProgression, getChords, getClefChanges, getClefForStaff, getDirections, getDirectionsAtPosition, getDivisions, getDuration, getDynamics, getEffectiveStaff, getEndings, getEntriesAtPosition, getEntriesForStaff, getEntriesInRange, getHarmonies, getHarmonyAtPosition, getKeyChanges, getLyricText, getLyrics, getMeasure, getMeasureByIndex, getMeasureCount, getNextNote, getNormalizedDuration, getNormalizedPosition, getNotesAtPosition, getNotesForStaff, getNotesForVoice, getNotesInRange, getOctaveShifts, getPartById, getPartByIndex, getPartCount, getPartIds, getPartIndex, getPedalMarkings, getPrevNote, getRepeatStructure, getSlurSpans, getStaffRange, getStaveCount, getStaves, getStructuralChanges, getTempoMarkings, getTiedNoteGroups, getTimeChanges, getTupletGroups, getVerseCount, getVerticalSlice, getVoiceLine, getVoiceLineInRange, getVoices, getVoicesForStaff, getWedges, groupByStaff, groupByVoice, hasMultipleStaves, hasNotes, hasPlaybackControls, inferStaff, isRestMeasure, iterateEntries, iterateNotes, measureRoundtrip, scoresEqual, withAbsolutePositions } from './query/index.mjs';
+export { ALL_COLOR_TARGETS, AddArticulationOptions, AddBeamOptions, AddBowingOptions, AddBreathMarkOptions, AddCaesuraOptions, AddChordOptions, AddChordSymbolOptions, AddCodaOptions, AddDynamicsOptions, AddEndingOptions, AddFermataOptions, AddFingeringOptions, AddGraceNoteOptions, AddHarmonyOptions, AddLyricOptions, AddNavigationOptions, AddOctaveShiftOptions, AddOrnamentOptions, AddPartOptions, AddPedalOptions, AddRehearsalMarkOptions, AddRepeatBarlineOptions, AddRepeatOptions, AddSegnoOptions, AddSlurOptions, AddStringNumberOptions, AddTempoOptions, AddTextDirectionOptions, AddTextOptions, AddTieOptions, AddVoiceOptions, AddWedgeOptions, AutoBeamOptions, BarStyle, BowingType, BreathMarkValue, CaesuraValue, ChangeBarlineOptions, ChangeClefOptions, ChangeNoteDurationOptions, ColorTarget, ConvertToGraceOptions, CopyNotesMultiMeasureOptions, CopyNotesOptions, CreateTupletOptions, CutNotesOptions, DuplicatePartOptions, HarmonyKind, InsertClefChangeOptions, InsertNoteOptions, LowerAccidentalOptions, ModifyDynamicsOptions, ModifyTempoOptions, MoveNoteToStaffOptions, MultiMeasureSelection, NoteSelection, OctaveShiftType, OperationErrorCode, OperationResult, PasteNotesMultiMeasureOptions, PasteNotesOptions, RaiseAccidentalOptions, RemoveArticulationOptions, RemoveBeamOptions, RemoveBowingOptions, RemoveBreathMarkOptions, RemoveCaesuraOptions, RemoveChordSymbolOptions, RemoveDynamicsOptions, RemoveEndingOptions, RemoveFermataOptions, RemoveFingeringOptions, RemoveGraceNoteOptions, RemoveHarmonyOptions, RemoveLyricOptions, RemoveNoteOptions, RemoveOctaveShiftOptions, RemoveOrnamentOptions, RemovePedalOptions, RemoveRepeatBarlineOptions, RemoveRepeatOptions, RemoveSlurOptions, RemoveStringNumberOptions, RemoveTempoOptions, RemoveTieOptions, RemoveTupletOptions, RemoveWedgeOptions, SetBarlineOptions, SetBeamingOptions, SetColorOptions, SetNotePitchBySemitoneOptions, SetNotePitchOptions, SetStavesOptions, ShiftNotePitchOptions, StopOctaveShiftOptions, UpdateChordSymbolOptions, UpdateHarmonyOptions, UpdateLyricOptions, addArticulation, addBeam, addBowing, addBreathMark, addCaesura, addChord, addChordNote, addChordNoteChecked, addChordSymbol, addCoda, addDaCapo, addDalSegno, addDynamics, addEnding, addFermata, addFine, addFingering, addGraceNote, addHarmony, addLyric, addNote, addNoteChecked, addOctaveShift, addOrnament, addPart, addPedal, addRehearsalMark, addRepeat, addRepeatBarline, addSegno, addSlur, addStringNumber, addTempo, addText, addTextDirection, addTie, addToCoda, addVoice, addWedge, autoBeam, changeBarline, changeClef, changeKey, changeNoteDuration, changeTime, clearColors, convertToGrace, copyNotes, copyNotesMultiMeasure, createTuplet, cutNotes, deleteMeasure, deleteNote, deleteNoteChecked, duplicatePart, insertClefChange, insertMeasure, insertNote, lowerAccidental, modifyDynamics, modifyNoteDuration, modifyNoteDurationChecked, modifyNotePitch, modifyNotePitchChecked, modifyTempo, moveNoteToStaff, pasteNotes, pasteNotesMultiMeasure, raiseAccidental, removeArticulation, removeBeam, removeBowing, removeBreathMark, removeCaesura, removeChordSymbol, removeDynamics, removeEnding, removeFermata, removeFingering, removeGraceNote, removeHarmony, removeLyric, removeNote, removeOctaveShift, removeOrnament, removePart, removePedal, removeRepeat, removeRepeatBarline, removeSlur, removeStringNumber, removeTempo, removeTie, removeTuplet, removeWedge, setBarline, setBeaming, setColor, setNotePitch, setNotePitchBySemitone, setStaves, shiftNotePitch, stopOctaveShift, transpose, transposeChecked, updateChordSymbol, updateHarmony, updateLyric } from './operations/index.mjs';
+export { STEPS, STEP_SEMITONES, generateId, getMeasureEndPosition, pitchToSemitone } from './core.mjs';
 export { DirectionTypeOfKind, getAllPartInfos, getDirectionOfKind, getDirectionsOfKind, getPartAbbreviation, getPartInfo, getPartName, getPartNameMap, getSoundDamperPedal, getSoundDynamics, getSoundSoftPedal, getSoundSostenutoPedal, getSoundTempo, hasBeam, hasDirectionOfKind, hasLyrics, hasNotations, hasTie, hasTieStart, hasTieStop, hasTuplet, isChordNote, isCueNote, isGraceNote, isPartInfo, isPitchedNote, isRest, isUnpitchedNote } from './accessors/index.mjs';
-
-declare function parse(input: string | Uint8Array): Score;
-
-/**
- * Parse a compressed MusicXML (.mxl) file
- * @param data - The compressed file data as Uint8Array or Buffer
- * @returns The parsed Score
- */
-declare function parseCompressed(data: Uint8Array): Score;
-/**
- * Check if data is a compressed MusicXML file
- * @param data - The file data
- * @returns true if the data appears to be a ZIP file
- */
-declare function isCompressed(data: Uint8Array): boolean;
-/**
- * Parse either compressed (.mxl) or uncompressed (.xml/.musicxml) MusicXML
- * Automatically detects the format
- * @param data - The file data as Uint8Array or string
- * @returns The parsed Score
- */
-declare function parseAuto(data: Uint8Array | string): Score;
-
-/**
- * ABC Notation Parser
- * Parses ABC notation format into the Score internal model.
- *
- * Supports ABC standard v2.1 core features:
- * - Header fields (X, T, C, M, L, Q, K, V, P, U, w, W, and `+:` continuations)
- * - Notes with pitch, duration, accidentals (including microtones), octaves
- * - Rests (z, Z, multi-measure Zn), invisible rests (x, Xn) and spacers (y)
- * - Bar lines (|, ||, |], [|, |:, :|, ::, [|], .|)
- * - Repeats and volta endings, including lists and ranges ([1,3, [1-3)
- * - Chords (simultaneous notes: [CEG]) with rests and per-note durations
- * - Chord symbols ("Am", "G7") and text annotations ("^above", "_below", ...)
- * - Ties (-), slurs ((...)) and dotted slurs (.(...))
- * - Grace notes ({...}) and acciaccaturas ({/...})
- * - Tuplets ((3..., (p:q:r...)
- * - Decorations: shorthand (. ~ H L M O P S T u v), !name! and legacy +name+
- * - Lyrics (w: field, multiple verses) and symbol lines (s:)
- * - Multi-voice (V: field) and multi-tune files (repeated X: fields)
- */
-
-/**
- * Parse every tune in an ABC file.
- *
- * ABC files may hold any number of tunes, each introduced by an `X:` field.
- * {@link parseAbc} returns only the first; use this to get them all.
- */
-declare function parseAbcTunes(abcString: string): Score[];
-/**
- * Parse an ABC notation string into a Score object.
- *
- * When the input holds several tunes, only the first is returned — use
- * {@link parseAbcTunes} to parse them all.
- */
-declare function parseAbc(abcString: string): Score;
-
-interface SerializeOptions {
-    version?: string;
-    indent?: string;
-    /** Validate score before serializing (default: false) */
-    validate?: boolean;
-    /** Options for validation (if validate is true) */
-    validateOptions?: ValidateOptions;
-    /** Throw error if validation fails (default: false, will only warn) */
-    throwOnValidationError?: boolean;
-    /** Callback to receive validation result */
-    onValidation?: (result: ValidationResult) => void;
-}
-declare function serialize(score: Score, options?: SerializeOptions): string;
-
-/**
- * Serialize a Score to compressed MusicXML (.mxl) format
- * @param score - The Score to serialize
- * @param options - Serialization options
- * @returns The compressed file data as Uint8Array
- */
-declare function serializeCompressed(score: Score, options?: SerializeOptions): Uint8Array;
-
-/**
- * MIDI export options
- *
- * Extends {@link ExpressionOptions} so fermata holds and rit./accel. ramps land
- * in the exported tempo map (and the timing sidecar) identically.
- */
-interface MidiExportOptions extends ExpressionOptions {
-    /** Ticks per quarter note (default: 480) */
-    ticksPerQuarterNote?: number;
-    /** Default tempo in BPM (default: 120) */
-    defaultTempo?: number;
-    /** Default velocity for notes when no dynamics are present (default: 80) */
-    defaultVelocity?: number;
-}
-/**
- * A single point on the timing sidecar: a correspondence between a time in the
- * generated MIDI and a conceptual musical position (measure + beat).
- *
- * Breakpoints are emitted at every played-measure start and every tempo change
- * (plus a terminal point). Between two consecutive breakpoints the relationship
- * `midiSec ↔ quarterPos` is linear (tempo is piecewise-constant), so a consumer
- * can interpolate any intermediate time exactly.
- */
-/** Result of {@link exportMidiWithTimingMap}. */
-interface MidiWithTimingMap {
-    /** The Standard MIDI File data. */
-    midi: Uint8Array;
-    /** The MIDI-time ↔ musical-position sidecar. */
-    sidecar: TimingSidecar;
-}
-/**
- * Export a Score to Standard MIDI File format (SMF Type 1)
- * @param score - The Score to export
- * @param options - Export options
- * @returns The MIDI file data as Uint8Array
- */
-declare function exportMidi(score: Score, options?: MidiExportOptions): Uint8Array;
-/**
- * Export a Score to MIDI together with a timing sidecar that maps the generated
- * MIDI timeline to conceptual musical positions (measure + beat).
- *
- * The MIDI bytes are byte-for-byte identical to {@link exportMidi}; the sidecar
- * is derived from the same internal time computation so the two can never drift.
- *
- * @param score - The Score to export
- * @param options - Export options (must match those used for any aligned audio)
- * @returns The MIDI data and its timing sidecar
- */
-declare function exportMidiWithTimingMap(score: Score, options?: MidiExportOptions): MidiWithTimingMap;
-
-/**
- * ABC Notation Serializer
- * Converts Score internal model to ABC notation format string.
- */
-
-interface AbcSerializeOptions {
-    /** Reference number (X: field). Default: 1 */
-    referenceNumber?: number;
-    /** Maximum notes per line before wrapping. Default: no limit */
-    notesPerLine?: number;
-    /** Include chord symbols. Default: true */
-    includeChordSymbols?: boolean;
-    /** Include dynamics. Default: true */
-    includeDynamics?: boolean;
-    /** Include lyrics. Default: true */
-    includeLyrics?: boolean;
-}
-/**
- * Serialize several Scores into a single multi-tune ABC file.
- *
- * Counterpart to `parseAbcTunes`: each Score becomes one tune, separated by a
- * blank line as the ABC standard requires.
- */
-declare function serializeAbcTunes(scores: Score[], options?: AbcSerializeOptions): string;
-/**
- * Serialize a Score object to ABC notation format string.
- */
-declare function serializeAbc(score: Score, options?: AbcSerializeOptions): string;
-
-declare const STEPS: Pitch['step'][];
-declare const STEP_SEMITONES: Record<Pitch['step'], number>;
-/** Convert pitch to semitone value (MIDI-like) */
-declare function pitchToSemitone(pitch: Pitch): number;
-/** Get position at end of measure */
-declare function getMeasureEndPosition(measure: Measure): number;
-
-/**
- * Generates a unique ID for elements in the Score structure.
- *
- * The ID format is "i" + 10 random URL-safe characters, where:
- * - "i" prefix ensures XML ID compatibility (XML IDs must start with a letter or underscore)
- * - the 10-character suffix is drawn from the same 64-character URL-safe
- *   alphabet as nanoid, backed by `crypto.getRandomValues`
- *
- * Example: "iV1StGXR8_"
- *
- * @returns A unique 11-character ID string
- */
-declare function generateId(): string;
-
-export { type AbcSerializeOptions, ExpressionOptions, Measure, type MidiExportOptions, type MidiWithTimingMap, Pitch, STEPS, STEP_SEMITONES, Score, type SerializeOptions, TimingSidecar, ValidateOptions, ValidationResult, exportMidi, exportMidiWithTimingMap, generateId, getMeasureEndPosition, isCompressed, parse, parseAbc, parseAbcTunes, parseAuto, parseCompressed, pitchToSemitone, serialize, serializeAbc, serializeAbcTunes, serializeCompressed };
+export { L as LocalValidateOptions, M as MeasureValidationContext, z as ValidateOptions, t as ValidationError, x as ValidationErrorCode, V as ValidationException, y as ValidationLevel, w as ValidationLocation, u as ValidationResult, s as assertMeasureValid, a as assertValid, p as formatLocation, r as getMeasureContext, i as isValid, v as validate, d as validateBackupForward, f as validateBeams, b as validateDivisions, c as validateMeasureDuration, q as validateMeasureLocal, j as validatePartReferences, k as validatePartStructure, g as validateSlurs, o as validateSlursAcrossMeasures, l as validateStaffStructure, e as validateTies, n as validateTiesAcrossMeasures, h as validateTuplets, m as validateVoiceStaff } from './index-C9lLZwol.mjs';
+export { AbcSerializeOptions, parseAbc, parseAbcTunes, serializeAbc, serializeAbcTunes } from './abc.mjs';
+export { MidiExportOptions, MidiWithTimingMap, exportMidi, exportMidiWithTimingMap } from './midi.mjs';
+export { c as ExpressionHint, d as ExpressionKind, E as ExpressionOptions, b as TimingBreakpoint, T as TimingMapOptions, a as TimingSidecar, g as generatePlaybackTimeline } from './playback-timeline-CVRHsikj.mjs';