musicxml-io 0.8.1 → 0.9.0

package/dist/browser.d.mts

@@ -0,0 +1,171 @@
+import { S as Score, g as Pitch, M as Measure } from './types-B_6pqTfs.mjs';
+export { A as Accidental, i as AccidentalInfo, O as AdjacentNotes, a4 as AssembledLyrics, B as BackupEntry, p as Barline, a5 as BarlineWithContext, a0 as BeamGroup, j as BeamInfo, s as Chord, C as Clef, aa as ClefChangeInfo, w as Credit, v as Defaults, D as DirectionEntry, Q as DirectionKind, l as DirectionType, z as DirectionWithContext, R as DynamicWithContext, m as DynamicsValue, a7 as EndingInfo, E as EntryWithContext, F as ForwardEntry, a2 as HarmonyWithContext, a8 as KeyChangeInfo, K as KeySignature, L as Lyric, a3 as LyricWithContext, e as MeasureAttributes, f as MeasureEntry, k as Notation, a1 as NotationType, N as NoteEntry, t as NoteIteratorItem, h as NoteType, y as NoteWithContext, r as NoteWithPosition, Y as OctaveShiftWithContext, d as Part, b as PartGroup, P as PartInfo, c as PartListEntry, W as PedalWithContext, H as PositionQueryOptions, u as Print, a6 as RepeatInfo, a as ScoreMetadata, _ as SlurSpan, q as StaffGroup, G as StaffRange, ab as StructuralChanges, U as TempoWithContext, T as TieInfo, Z as TiedNoteGroup, a9 as TimeChangeInfo, n as TimeSignature, o as Transpose, $ as TupletGroup, I as VerticalSlice, V as VoiceGroup, J as VoiceLine, x as VoiceToStaffMap, X as WedgeWithContext } from './types-B_6pqTfs.mjs';
+import { cK as ValidateOptions, cG as ValidationResult } from './index-BGUfI7Li.mjs';
+export { b8 as AddArticulationOptions, bh as AddBeamOptions, c6 as AddBowingOptions, cf as AddBreathMarkOptions, ci as AddCaesuraOptions, aU as AddChordOptions, c0 as AddChordSymbolOptions, bQ as AddCodaOptions, ba as AddDynamicsOptions, bK as AddEndingOptions, bx as AddFermataOptions, c3 as AddFingeringOptions, bS as AddGraceNoteOptions, bZ as AddHarmonyOptions, bV as AddLyricOptions, bR as AddNavigationOptions, cb as AddOctaveShiftOptions, bz as AddOrnamentOptions, b0 as AddPartOptions, bB as AddPedalOptions, bF as AddRehearsalMarkOptions, bG as AddRepeatBarlineOptions, bI as AddRepeatOptions, bP as AddSegnoOptions, b6 as AddSlurOptions, c8 as AddStringNumberOptions, bs as AddTempoOptions, bD as AddTextDirectionOptions, bE as AddTextOptions, b4 as AddTieOptions, a$ as AddVoiceOptions, bv as AddWedgeOptions, bj as AutoBeamOptions, bO as BarStyle, c5 as BowingType, ce as BreathMarkValue, ch as CaesuraValue, bM as ChangeBarlineOptions, be as ChangeClefOptions, aV as ChangeNoteDurationOptions, bU as ConvertToGraceOptions, bp as CopyNotesMultiMeasureOptions, bm as CopyNotesOptions, bf as CreateTupletOptions, bo as CutNotesOptions, b1 as DuplicatePartOptions, bY as HarmonyKind, bd as InsertClefChangeOptions, aS as InsertNoteOptions, cM as LocalValidateOptions, a_ as LowerAccidentalOptions, cL as MeasureValidationContext, bc as ModifyDynamicsOptions, bu as ModifyTempoOptions, b3 as MoveNoteToStaffOptions, bq as MultiMeasureSelection, bl as NoteSelection, ca as OctaveShiftType, aR as OperationErrorCode, aQ as OperationResult, br as PasteNotesMultiMeasureOptions, bn as PasteNotesOptions, aZ as RaiseAccidentalOptions, b9 as RemoveArticulationOptions, bi as RemoveBeamOptions, c7 as RemoveBowingOptions, cg as RemoveBreathMarkOptions, cj as RemoveCaesuraOptions, c1 as RemoveChordSymbolOptions, bb as RemoveDynamicsOptions, bL as RemoveEndingOptions, by as RemoveFermataOptions, c4 as RemoveFingeringOptions, bT as RemoveGraceNoteOptions, b_ as RemoveHarmonyOptions, bW as RemoveLyricOptions, aT as RemoveNoteOptions, cd as RemoveOctaveShiftOptions, bA as RemoveOrnamentOptions, bC as RemovePedalOptions, bH as RemoveRepeatBarlineOptions, bJ as RemoveRepeatOptions, b7 as RemoveSlurOptions, c9 as RemoveStringNumberOptions, bt as RemoveTempoOptions, b5 as RemoveTieOptions, bg as RemoveTupletOptions, bw as RemoveWedgeOptions, bN as SetBarlineOptions, bk as SetBeamingOptions, aX as SetNotePitchBySemitoneOptions, aW as SetNotePitchOptions, b2 as SetStavesOptions, aY as ShiftNotePitchOptions, cc as StopOctaveShiftOptions, c2 as UpdateChordSymbolOptions, b$ as UpdateHarmonyOptions, bX as UpdateLyricOptions, cF as ValidationError, cI as ValidationErrorCode, cB as ValidationException, cJ as ValidationLevel, cH 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, cE as assertMeasureValid, cm as assertValid, U as autoBeam, aj as changeBarline, P as changeClef, B as changeKey, d as changeNoteDuration, C as changeTime, 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, cA as formatLocation, cD as getMeasureContext, O as insertClefChange, D as insertMeasure, i as insertNote, cl 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, 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, ck as validate, cp as validateBackupForward, cr as validateBeams, cn as validateDivisions, co as validateMeasureDuration, cC as validateMeasureLocal, cu as validatePartReferences, cv as validatePartStructure, cs as validateSlurs, cz as validateSlursAcrossMeasures, cw as validateStaffStructure, cq as validateTies, cy as validateTiesAcrossMeasures, ct as validateTuplets, cx as validateVoiceStaff } from './index-BGUfI7Li.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 { 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, w)
+ * - Notes with pitch, duration, accidentals, octave modifiers
+ * - Rests (z, Z)
+ * - Bar lines (|, ||, |], [|, |:, :|, ::)
+ * - Repeats and volta endings ([1, [2)
+ * - Chords (simultaneous notes: [CEG])
+ * - Chord symbols ("Am", "G7", etc.)
+ * - Ties (-) and slurs ((...))
+ * - Grace notes ({...})
+ * - Tuplets ((3..., (p:q:r...)
+ * - Dynamics (!p!, !f!, etc.)
+ * - Lyrics (w: field)
+ * - Multi-voice (V: field)
+ */
+
+/**
+ * Parse an ABC notation string into a Score object.
+ */
+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 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, parseAuto, parseCompressed, pitchToSemitone, serialize, serializeAbc, serializeCompressed };

package/dist/browser.d.ts

@@ -0,0 +1,171 @@
+import { S as Score, g as Pitch, M as Measure } from './types-B_6pqTfs.js';
+export { A as Accidental, i as AccidentalInfo, O as AdjacentNotes, a4 as AssembledLyrics, B as BackupEntry, p as Barline, a5 as BarlineWithContext, a0 as BeamGroup, j as BeamInfo, s as Chord, C as Clef, aa as ClefChangeInfo, w as Credit, v as Defaults, D as DirectionEntry, Q as DirectionKind, l as DirectionType, z as DirectionWithContext, R as DynamicWithContext, m as DynamicsValue, a7 as EndingInfo, E as EntryWithContext, F as ForwardEntry, a2 as HarmonyWithContext, a8 as KeyChangeInfo, K as KeySignature, L as Lyric, a3 as LyricWithContext, e as MeasureAttributes, f as MeasureEntry, k as Notation, a1 as NotationType, N as NoteEntry, t as NoteIteratorItem, h as NoteType, y as NoteWithContext, r as NoteWithPosition, Y as OctaveShiftWithContext, d as Part, b as PartGroup, P as PartInfo, c as PartListEntry, W as PedalWithContext, H as PositionQueryOptions, u as Print, a6 as RepeatInfo, a as ScoreMetadata, _ as SlurSpan, q as StaffGroup, G as StaffRange, ab as StructuralChanges, U as TempoWithContext, T as TieInfo, Z as TiedNoteGroup, a9 as TimeChangeInfo, n as TimeSignature, o as Transpose, $ as TupletGroup, I as VerticalSlice, V as VoiceGroup, J as VoiceLine, x as VoiceToStaffMap, X as WedgeWithContext } from './types-B_6pqTfs.js';
+import { cK as ValidateOptions, cG as ValidationResult } from './index-se1B-IZl.js';
+export { b8 as AddArticulationOptions, bh as AddBeamOptions, c6 as AddBowingOptions, cf as AddBreathMarkOptions, ci as AddCaesuraOptions, aU as AddChordOptions, c0 as AddChordSymbolOptions, bQ as AddCodaOptions, ba as AddDynamicsOptions, bK as AddEndingOptions, bx as AddFermataOptions, c3 as AddFingeringOptions, bS as AddGraceNoteOptions, bZ as AddHarmonyOptions, bV as AddLyricOptions, bR as AddNavigationOptions, cb as AddOctaveShiftOptions, bz as AddOrnamentOptions, b0 as AddPartOptions, bB as AddPedalOptions, bF as AddRehearsalMarkOptions, bG as AddRepeatBarlineOptions, bI as AddRepeatOptions, bP as AddSegnoOptions, b6 as AddSlurOptions, c8 as AddStringNumberOptions, bs as AddTempoOptions, bD as AddTextDirectionOptions, bE as AddTextOptions, b4 as AddTieOptions, a$ as AddVoiceOptions, bv as AddWedgeOptions, bj as AutoBeamOptions, bO as BarStyle, c5 as BowingType, ce as BreathMarkValue, ch as CaesuraValue, bM as ChangeBarlineOptions, be as ChangeClefOptions, aV as ChangeNoteDurationOptions, bU as ConvertToGraceOptions, bp as CopyNotesMultiMeasureOptions, bm as CopyNotesOptions, bf as CreateTupletOptions, bo as CutNotesOptions, b1 as DuplicatePartOptions, bY as HarmonyKind, bd as InsertClefChangeOptions, aS as InsertNoteOptions, cM as LocalValidateOptions, a_ as LowerAccidentalOptions, cL as MeasureValidationContext, bc as ModifyDynamicsOptions, bu as ModifyTempoOptions, b3 as MoveNoteToStaffOptions, bq as MultiMeasureSelection, bl as NoteSelection, ca as OctaveShiftType, aR as OperationErrorCode, aQ as OperationResult, br as PasteNotesMultiMeasureOptions, bn as PasteNotesOptions, aZ as RaiseAccidentalOptions, b9 as RemoveArticulationOptions, bi as RemoveBeamOptions, c7 as RemoveBowingOptions, cg as RemoveBreathMarkOptions, cj as RemoveCaesuraOptions, c1 as RemoveChordSymbolOptions, bb as RemoveDynamicsOptions, bL as RemoveEndingOptions, by as RemoveFermataOptions, c4 as RemoveFingeringOptions, bT as RemoveGraceNoteOptions, b_ as RemoveHarmonyOptions, bW as RemoveLyricOptions, aT as RemoveNoteOptions, cd as RemoveOctaveShiftOptions, bA as RemoveOrnamentOptions, bC as RemovePedalOptions, bH as RemoveRepeatBarlineOptions, bJ as RemoveRepeatOptions, b7 as RemoveSlurOptions, c9 as RemoveStringNumberOptions, bt as RemoveTempoOptions, b5 as RemoveTieOptions, bg as RemoveTupletOptions, bw as RemoveWedgeOptions, bN as SetBarlineOptions, bk as SetBeamingOptions, aX as SetNotePitchBySemitoneOptions, aW as SetNotePitchOptions, b2 as SetStavesOptions, aY as ShiftNotePitchOptions, cc as StopOctaveShiftOptions, c2 as UpdateChordSymbolOptions, b$ as UpdateHarmonyOptions, bX as UpdateLyricOptions, cF as ValidationError, cI as ValidationErrorCode, cB as ValidationException, cJ as ValidationLevel, cH 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, cE as assertMeasureValid, cm as assertValid, U as autoBeam, aj as changeBarline, P as changeClef, B as changeKey, d as changeNoteDuration, C as changeTime, 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, cA as formatLocation, cD as getMeasureContext, O as insertClefChange, D as insertMeasure, i as insertNote, cl 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, 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, ck as validate, cp as validateBackupForward, cr as validateBeams, cn as validateDivisions, co as validateMeasureDuration, cC as validateMeasureLocal, cu as validatePartReferences, cv as validatePartStructure, cs as validateSlurs, cz as validateSlursAcrossMeasures, cw as validateStaffStructure, cq as validateTies, cy as validateTiesAcrossMeasures, ct as validateTuplets, cx as validateVoiceStaff } from './index-se1B-IZl.js';
+import { ExpressionOptions, TimingSidecar } from './query/index.js';
+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.js';
+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.js';
+
+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, w)
+ * - Notes with pitch, duration, accidentals, octave modifiers
+ * - Rests (z, Z)
+ * - Bar lines (|, ||, |], [|, |:, :|, ::)
+ * - Repeats and volta endings ([1, [2)
+ * - Chords (simultaneous notes: [CEG])
+ * - Chord symbols ("Am", "G7", etc.)
+ * - Ties (-) and slurs ((...))
+ * - Grace notes ({...})
+ * - Tuplets ((3..., (p:q:r...)
+ * - Dynamics (!p!, !f!, etc.)
+ * - Lyrics (w: field)
+ * - Multi-voice (V: field)
+ */
+
+/**
+ * Parse an ABC notation string into a Score object.
+ */
+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 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, parseAuto, parseCompressed, pitchToSemitone, serialize, serializeAbc, serializeCompressed };