musicxml-io 0.2.0 → 0.2.7

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { S as Score, P as Pitch, M as Measure } from './types-Dp9zcgIg.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, f as MeasureAttributes, g 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, e as Part, c as PartGroup, b as PartInfo, d 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-Dp9zcgIg.mjs';
-import { V as ValidateOptions, a as ValidationResult } from './index-nCaclfqu.mjs';
-export { L as LocalValidateOptions, M as MeasureValidationContext, G as ValidationError, I as ValidationErrorCode, C as ValidationException, J as ValidationLevel, H as ValidationLocation, g as addChordNote, b as addNote, F as assertMeasureValid, k as assertValid, c as changeKey, e as changeTime, f as deleteMeasure, d as deleteNote, B as formatLocation, E as getMeasureContext, i as insertMeasure, j as isValid, h as modifyNoteDuration, m as modifyNotePitch, t as transpose, v as validate, o as validateBackupForward, q as validateBeams, l as validateDivisions, n as validateMeasureDuration, D as validateMeasureLocal, u as validatePartReferences, w as validatePartStructure, r as validateSlurs, A as validateSlursAcrossMeasures, x as validateStaffStructure, p as validateTies, z as validateTiesAcrossMeasures, s as validateTuplets, y as validateVoiceStaff } from './index-nCaclfqu.mjs';
+import { S as Score, P as Pitch, M as Measure } from './types-CSI8kV28.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, f as MeasureAttributes, g 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, e as Part, c as PartGroup, b as PartInfo, d 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-CSI8kV28.mjs';
+import { V as ValidateOptions, a as ValidationResult } from './index-D4hW6ANJ.mjs';
+export { L as LocalValidateOptions, M as MeasureValidationContext, G as ValidationError, I as ValidationErrorCode, C as ValidationException, J as ValidationLevel, H as ValidationLocation, g as addChordNote, b as addNote, F as assertMeasureValid, k as assertValid, c as changeKey, e as changeTime, f as deleteMeasure, d as deleteNote, B as formatLocation, E as getMeasureContext, i as insertMeasure, j as isValid, h as modifyNoteDuration, m as modifyNotePitch, t as transpose, v as validate, o as validateBackupForward, q as validateBeams, l as validateDivisions, n as validateMeasureDuration, D as validateMeasureLocal, u as validatePartReferences, w as validatePartStructure, r as validateSlurs, A as validateSlursAcrossMeasures, x as validateStaffStructure, p as validateTies, z as validateTiesAcrossMeasures, s as validateTuplets, y as validateVoiceStaff } from './index-D4hW6ANJ.mjs';
 export { NormalizedPositionOptions, VoiceFilter, buildVoiceToStaffMap, buildVoiceToStaffMapForPart, findBarlines, findDirectionsByType, findNotesWithNotation, getAbsolutePosition, getAdjacentNotes, getAllNotes, getBeamGroups, getChordProgression, getChords, getClefChanges, getClefForStaff, getDirections, getDirectionsAtPosition, getDynamics, getEffectiveStaff, getEndings, getEntriesAtPosition, getEntriesForStaff, getEntriesInRange, getHarmonies, getHarmonyAtPosition, getKeyChanges, getLyricText, getLyrics, getNextNote, getNormalizedDuration, getNormalizedPosition, getNotesAtPosition, getNotesForStaff, getNotesForVoice, getNotesInRange, getOctaveShifts, getPartByIndex, getPartCount, getPartIds, getPedalMarkings, getPrevNote, getRepeatStructure, getSlurSpans, getStaffRange, getStaves, getStructuralChanges, getTempoMarkings, getTiedNoteGroups, getTimeChanges, getTupletGroups, getVerseCount, getVerticalSlice, getVoiceLine, getVoiceLineInRange, getVoices, getVoicesForStaff, getWedges, groupByStaff, groupByVoice, hasNotes, inferStaff, isRestMeasure, iterateEntries, iterateNotes, withAbsolutePositions } from './accessors/index.mjs';
 export { FindNotesFilter, PitchRange, RoundtripMetrics, countNotes, findNotes, getAttributesAtMeasure, getDivisions, getDuration, getMeasure, getMeasureByIndex, getMeasureCount, getPartById, getPartIndex, getStaveCount, hasMultipleStaves, measureRoundtrip, scoresEqual } from './query/index.mjs';
 
@@ -104,4 +104,17 @@ declare function pitchToSemitone(pitch: Pitch): number;
 /** Get position at end of measure */
 declare function getMeasureEndPosition(measure: Measure): number;
 
-export { Measure, type MidiExportOptions, Pitch, STEPS, STEP_SEMITONES, Score, type SerializeOptions, ValidateOptions, ValidationResult, decodeBuffer, exportMidi, getMeasureEndPosition, isCompressed, parse, parseAuto, parseCompressed, parseFile, pitchToSemitone, serialize, serializeCompressed, serializeToFile };
+/**
+ * Generates a unique ID for elements in the Score structure.
+ *
+ * The ID format is "i" + nanoid(10), where:
+ * - "i" prefix ensures XML ID compatibility (XML IDs must start with a letter or underscore)
+ * - nanoid(10) generates a 10-character URL-safe unique identifier
+ *
+ * Example: "iV1StGXR8_"
+ *
+ * @returns A unique 11-character ID string
+ */
+declare function generateId(): string;
+
+export { Measure, type MidiExportOptions, Pitch, STEPS, STEP_SEMITONES, Score, type SerializeOptions, ValidateOptions, ValidationResult, decodeBuffer, exportMidi, generateId, getMeasureEndPosition, isCompressed, parse, parseAuto, parseCompressed, parseFile, pitchToSemitone, serialize, serializeCompressed, serializeToFile };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { S as Score, P as Pitch, M as Measure } from './types-Dp9zcgIg.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, f as MeasureAttributes, g 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, e as Part, c as PartGroup, b as PartInfo, d 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-Dp9zcgIg.js';
-import { V as ValidateOptions, a as ValidationResult } from './index-DCty0U8p.js';
-export { L as LocalValidateOptions, M as MeasureValidationContext, G as ValidationError, I as ValidationErrorCode, C as ValidationException, J as ValidationLevel, H as ValidationLocation, g as addChordNote, b as addNote, F as assertMeasureValid, k as assertValid, c as changeKey, e as changeTime, f as deleteMeasure, d as deleteNote, B as formatLocation, E as getMeasureContext, i as insertMeasure, j as isValid, h as modifyNoteDuration, m as modifyNotePitch, t as transpose, v as validate, o as validateBackupForward, q as validateBeams, l as validateDivisions, n as validateMeasureDuration, D as validateMeasureLocal, u as validatePartReferences, w as validatePartStructure, r as validateSlurs, A as validateSlursAcrossMeasures, x as validateStaffStructure, p as validateTies, z as validateTiesAcrossMeasures, s as validateTuplets, y as validateVoiceStaff } from './index-DCty0U8p.js';
+import { S as Score, P as Pitch, M as Measure } from './types-CSI8kV28.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, f as MeasureAttributes, g 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, e as Part, c as PartGroup, b as PartInfo, d 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-CSI8kV28.js';
+import { V as ValidateOptions, a as ValidationResult } from './index-CVGy8DJi.js';
+export { L as LocalValidateOptions, M as MeasureValidationContext, G as ValidationError, I as ValidationErrorCode, C as ValidationException, J as ValidationLevel, H as ValidationLocation, g as addChordNote, b as addNote, F as assertMeasureValid, k as assertValid, c as changeKey, e as changeTime, f as deleteMeasure, d as deleteNote, B as formatLocation, E as getMeasureContext, i as insertMeasure, j as isValid, h as modifyNoteDuration, m as modifyNotePitch, t as transpose, v as validate, o as validateBackupForward, q as validateBeams, l as validateDivisions, n as validateMeasureDuration, D as validateMeasureLocal, u as validatePartReferences, w as validatePartStructure, r as validateSlurs, A as validateSlursAcrossMeasures, x as validateStaffStructure, p as validateTies, z as validateTiesAcrossMeasures, s as validateTuplets, y as validateVoiceStaff } from './index-CVGy8DJi.js';
 export { NormalizedPositionOptions, VoiceFilter, buildVoiceToStaffMap, buildVoiceToStaffMapForPart, findBarlines, findDirectionsByType, findNotesWithNotation, getAbsolutePosition, getAdjacentNotes, getAllNotes, getBeamGroups, getChordProgression, getChords, getClefChanges, getClefForStaff, getDirections, getDirectionsAtPosition, getDynamics, getEffectiveStaff, getEndings, getEntriesAtPosition, getEntriesForStaff, getEntriesInRange, getHarmonies, getHarmonyAtPosition, getKeyChanges, getLyricText, getLyrics, getNextNote, getNormalizedDuration, getNormalizedPosition, getNotesAtPosition, getNotesForStaff, getNotesForVoice, getNotesInRange, getOctaveShifts, getPartByIndex, getPartCount, getPartIds, getPedalMarkings, getPrevNote, getRepeatStructure, getSlurSpans, getStaffRange, getStaves, getStructuralChanges, getTempoMarkings, getTiedNoteGroups, getTimeChanges, getTupletGroups, getVerseCount, getVerticalSlice, getVoiceLine, getVoiceLineInRange, getVoices, getVoicesForStaff, getWedges, groupByStaff, groupByVoice, hasNotes, inferStaff, isRestMeasure, iterateEntries, iterateNotes, withAbsolutePositions } from './accessors/index.js';
 export { FindNotesFilter, PitchRange, RoundtripMetrics, countNotes, findNotes, getAttributesAtMeasure, getDivisions, getDuration, getMeasure, getMeasureByIndex, getMeasureCount, getPartById, getPartIndex, getStaveCount, hasMultipleStaves, measureRoundtrip, scoresEqual } from './query/index.js';
 
@@ -104,4 +104,17 @@ declare function pitchToSemitone(pitch: Pitch): number;
 /** Get position at end of measure */
 declare function getMeasureEndPosition(measure: Measure): number;
 
-export { Measure, type MidiExportOptions, Pitch, STEPS, STEP_SEMITONES, Score, type SerializeOptions, ValidateOptions, ValidationResult, decodeBuffer, exportMidi, getMeasureEndPosition, isCompressed, parse, parseAuto, parseCompressed, parseFile, pitchToSemitone, serialize, serializeCompressed, serializeToFile };
+/**
+ * Generates a unique ID for elements in the Score structure.
+ *
+ * The ID format is "i" + nanoid(10), where:
+ * - "i" prefix ensures XML ID compatibility (XML IDs must start with a letter or underscore)
+ * - nanoid(10) generates a 10-character URL-safe unique identifier
+ *
+ * Example: "iV1StGXR8_"
+ *
+ * @returns A unique 11-character ID string
+ */
+declare function generateId(): string;
+
+export { Measure, type MidiExportOptions, Pitch, STEPS, STEP_SEMITONES, Score, type SerializeOptions, ValidateOptions, ValidationResult, decodeBuffer, exportMidi, generateId, getMeasureEndPosition, isCompressed, parse, parseAuto, parseCompressed, parseFile, pitchToSemitone, serialize, serializeCompressed, serializeToFile };

package/dist/index.js

@@ -41,6 +41,7 @@ __export(src_exports, {
   findNotes: () => findNotes,
   findNotesWithNotation: () => findNotesWithNotation,
   formatLocation: () => formatLocation,
+  generateId: () => generateId,
   getAbsolutePosition: () => getAbsolutePosition,
   getAdjacentNotes: () => getAdjacentNotes,
   getAllNotes: () => getAllNotes,
@@ -147,6 +148,14 @@ module.exports = __toCommonJS(src_exports);
 
 // src/importers/musicxml.ts
 var import_fast_xml_parser = require("fast-xml-parser");
+
+// src/id.ts
+var import_nanoid = require("nanoid");
+function generateId() {
+  return "i" + (0, import_nanoid.nanoid)(10);
+}
+
+// src/importers/musicxml.ts
 var xmlParser = new import_fast_xml_parser.XMLParser({
   ignoreAttributes: false,
   attributeNamePrefix: "@_",
@@ -233,6 +242,7 @@ function parseScorePartwise(elements) {
   const defaults = parseDefaults(elements);
   const credits = parseCredits(elements);
   return {
+    _id: generateId(),
     metadata,
     partList,
     parts,
@@ -434,7 +444,7 @@ function parseSystemLayout(elements) {
 }
 function parseCredits(elements) {
   const credits = collectElements(elements, "credit", (content, attrs) => {
-    const credit = {};
+    const credit = { _id: generateId() };
     if (attrs["page"]) credit.page = parseInt(attrs["page"], 10);
     const types = collectElements(content, "credit-type", (c) => extractText(c));
     const words = collectElements(content, "credit-words", (c, a) => {
@@ -476,6 +486,7 @@ function parsePartList(elements) {
       const attrs = getAttributes(el);
       const content = el["score-part"];
       const partInfo = {
+        _id: generateId(),
         type: "score-part",
         id: attrs["id"] || ""
       };
@@ -568,6 +579,7 @@ function parsePartList(elements) {
       const attrs = getAttributes(el);
       const content = el["part-group"];
       const group = {
+        _id: generateId(),
         type: "part-group",
         groupType: attrs["type"] === "stop" ? "stop" : "start"
       };
@@ -603,6 +615,7 @@ function parseParts(elements) {
       const attrs = getAttributes(el);
       const content = el["part"];
       const part = {
+        _id: generateId(),
         id: attrs["id"] || "",
         measures: []
       };
@@ -620,6 +633,7 @@ function parseParts(elements) {
 }
 function parseMeasure(elements, attrs) {
   const measure = {
+    _id: generateId(),
     number: attrs["number"] || "0",
     // Keep as string per MusicXML spec (token type)
     entries: []
@@ -636,6 +650,7 @@ function parseMeasure(elements, attrs) {
         isFirstAttributes = false;
       } else {
         const attrEntry = {
+          _id: generateId(),
           type: "attributes",
           attributes: parsedAttrs
         };
@@ -861,6 +876,7 @@ function parseTranspose(elements) {
 }
 function parseNote(elements, attrs) {
   const note = {
+    _id: generateId(),
     type: "note",
     duration: getElementTextAsInt(elements, "duration", 0),
     voice: getElementTextAsInt(elements, "voice", 1)
@@ -1515,12 +1531,14 @@ function parseLyric(elements, attrs) {
 }
 function parseBackup(elements) {
   return {
+    _id: generateId(),
     type: "backup",
     duration: parseInt(getElementText(elements, "duration") || "0", 10)
   };
 }
 function parseForward(elements) {
   const forward = {
+    _id: generateId(),
     type: "forward",
     duration: parseInt(getElementText(elements, "duration") || "0", 10)
   };
@@ -1532,6 +1550,7 @@ function parseForward(elements) {
 }
 function parseDirection(elements, attrs) {
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: []
   };
@@ -1907,7 +1926,7 @@ function parseDirectionType(elements) {
 }
 function parseBarline(elements, attrs) {
   const location = attrs["location"] || "right";
-  const barline = { location };
+  const barline = { _id: generateId(), location };
   const barStyle = getElementText(elements, "bar-style");
   if (barStyle && isValidBarStyle(barStyle)) {
     barline.barStyle = barStyle;
@@ -2123,6 +2142,7 @@ function parseMeasureStyle(elements, attrs) {
 }
 function parseHarmony(elements, attrs) {
   const harmony = {
+    _id: generateId(),
     type: "harmony",
     root: { rootStep: "C" },
     kind: "major"
@@ -2246,6 +2266,7 @@ function parseHarmony(elements, attrs) {
 }
 function parseFiguredBass(elements, attrs) {
   const fb = {
+    _id: generateId(),
     type: "figured-bass",
     figures: []
   };
@@ -2292,6 +2313,7 @@ function parseFiguredBass(elements, attrs) {
 }
 function parseSound(elements, attrs) {
   const sound = {
+    _id: generateId(),
     type: "sound"
   };
   if (attrs["tempo"]) sound.tempo = parseFloat(attrs["tempo"]);
@@ -7140,6 +7162,7 @@ function hasNotesInRange(voiceEntries, startPos, endPos) {
 }
 function createRest(duration, voice, staff) {
   return {
+    _id: generateId(),
     type: "note",
     rest: { displayStep: void 0, displayOctave: void 0 },
     duration,
@@ -7201,10 +7224,11 @@ function rebuildMeasureWithVoice(measure, voice, newEntries, measureDuration, st
   for (const { position: targetPos, entry } of allEntries) {
     const diff = targetPos - currentPosition;
     if (diff < 0) {
-      result.push({ type: "backup", duration: -diff });
+      result.push({ _id: generateId(), type: "backup", duration: -diff });
       currentPosition = targetPos;
     } else if (diff > 0) {
       result.push({
+        _id: generateId(),
         type: "forward",
         duration: diff,
         voice: entry.type === "note" ? entry.voice : 1,
@@ -7259,6 +7283,7 @@ function insertNote(score, options) {
     )]);
   }
   const newNote = {
+    _id: generateId(),
     type: "note",
     pitch: options.pitch,
     duration: options.duration,
@@ -7365,6 +7390,7 @@ function addChord(score, options) {
     return failure([operationError("NOTE_NOT_FOUND", `Note index ${options.noteIndex} not found`, { partIndex: options.partIndex, measureIndex: options.measureIndex })]);
   }
   const chordNote = {
+    _id: generateId(),
     type: "note",
     pitch: options.pitch,
     duration: targetEntry.duration,
@@ -7588,7 +7614,7 @@ function insertMeasure(score, options) {
     if (insertIndex === -1) continue;
     const numericPart = parseInt(targetMeasure, 10);
     const newMeasureNumber = String(isNaN(numericPart) ? insertIndex + 2 : numericPart + 1);
-    const newMeasure = { number: newMeasureNumber, entries: [] };
+    const newMeasure = { _id: generateId(), number: newMeasureNumber, entries: [] };
     if (options.copyAttributes && part.measures[insertIndex].attributes) {
       newMeasure.attributes = { ...part.measures[insertIndex].attributes };
     }
@@ -7707,6 +7733,7 @@ async function serializeToFile(score, filePath, options = {}) {
   findNotes,
   findNotesWithNotation,
   formatLocation,
+  generateId,
   getAbsolutePosition,
   getAdjacentNotes,
   getAllNotes,

package/dist/index.mjs

@@ -1,5 +1,13 @@
 // src/importers/musicxml.ts
 import { XMLParser } from "fast-xml-parser";
+
+// src/id.ts
+import { nanoid } from "nanoid";
+function generateId() {
+  return "i" + nanoid(10);
+}
+
+// src/importers/musicxml.ts
 var xmlParser = new XMLParser({
   ignoreAttributes: false,
   attributeNamePrefix: "@_",
@@ -86,6 +94,7 @@ function parseScorePartwise(elements) {
   const defaults = parseDefaults(elements);
   const credits = parseCredits(elements);
   return {
+    _id: generateId(),
     metadata,
     partList,
     parts,
@@ -287,7 +296,7 @@ function parseSystemLayout(elements) {
 }
 function parseCredits(elements) {
   const credits = collectElements(elements, "credit", (content, attrs) => {
-    const credit = {};
+    const credit = { _id: generateId() };
     if (attrs["page"]) credit.page = parseInt(attrs["page"], 10);
     const types = collectElements(content, "credit-type", (c) => extractText(c));
     const words = collectElements(content, "credit-words", (c, a) => {
@@ -329,6 +338,7 @@ function parsePartList(elements) {
       const attrs = getAttributes(el);
       const content = el["score-part"];
       const partInfo = {
+        _id: generateId(),
         type: "score-part",
         id: attrs["id"] || ""
       };
@@ -421,6 +431,7 @@ function parsePartList(elements) {
       const attrs = getAttributes(el);
       const content = el["part-group"];
       const group = {
+        _id: generateId(),
         type: "part-group",
         groupType: attrs["type"] === "stop" ? "stop" : "start"
       };
@@ -456,6 +467,7 @@ function parseParts(elements) {
       const attrs = getAttributes(el);
       const content = el["part"];
       const part = {
+        _id: generateId(),
         id: attrs["id"] || "",
         measures: []
       };
@@ -473,6 +485,7 @@ function parseParts(elements) {
 }
 function parseMeasure(elements, attrs) {
   const measure = {
+    _id: generateId(),
     number: attrs["number"] || "0",
     // Keep as string per MusicXML spec (token type)
     entries: []
@@ -489,6 +502,7 @@ function parseMeasure(elements, attrs) {
         isFirstAttributes = false;
       } else {
         const attrEntry = {
+          _id: generateId(),
           type: "attributes",
           attributes: parsedAttrs
         };
@@ -714,6 +728,7 @@ function parseTranspose(elements) {
 }
 function parseNote(elements, attrs) {
   const note = {
+    _id: generateId(),
     type: "note",
     duration: getElementTextAsInt(elements, "duration", 0),
     voice: getElementTextAsInt(elements, "voice", 1)
@@ -1368,12 +1383,14 @@ function parseLyric(elements, attrs) {
 }
 function parseBackup(elements) {
   return {
+    _id: generateId(),
     type: "backup",
     duration: parseInt(getElementText(elements, "duration") || "0", 10)
   };
 }
 function parseForward(elements) {
   const forward = {
+    _id: generateId(),
     type: "forward",
     duration: parseInt(getElementText(elements, "duration") || "0", 10)
   };
@@ -1385,6 +1402,7 @@ function parseForward(elements) {
 }
 function parseDirection(elements, attrs) {
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: []
   };
@@ -1760,7 +1778,7 @@ function parseDirectionType(elements) {
 }
 function parseBarline(elements, attrs) {
   const location = attrs["location"] || "right";
-  const barline = { location };
+  const barline = { _id: generateId(), location };
   const barStyle = getElementText(elements, "bar-style");
   if (barStyle && isValidBarStyle(barStyle)) {
     barline.barStyle = barStyle;
@@ -1976,6 +1994,7 @@ function parseMeasureStyle(elements, attrs) {
 }
 function parseHarmony(elements, attrs) {
   const harmony = {
+    _id: generateId(),
     type: "harmony",
     root: { rootStep: "C" },
     kind: "major"
@@ -2099,6 +2118,7 @@ function parseHarmony(elements, attrs) {
 }
 function parseFiguredBass(elements, attrs) {
   const fb = {
+    _id: generateId(),
     type: "figured-bass",
     figures: []
   };
@@ -2145,6 +2165,7 @@ function parseFiguredBass(elements, attrs) {
 }
 function parseSound(elements, attrs) {
   const sound = {
+    _id: generateId(),
     type: "sound"
   };
   if (attrs["tempo"]) sound.tempo = parseFloat(attrs["tempo"]);
@@ -6993,6 +7014,7 @@ function hasNotesInRange(voiceEntries, startPos, endPos) {
 }
 function createRest(duration, voice, staff) {
   return {
+    _id: generateId(),
     type: "note",
     rest: { displayStep: void 0, displayOctave: void 0 },
     duration,
@@ -7054,10 +7076,11 @@ function rebuildMeasureWithVoice(measure, voice, newEntries, measureDuration, st
   for (const { position: targetPos, entry } of allEntries) {
     const diff = targetPos - currentPosition;
     if (diff < 0) {
-      result.push({ type: "backup", duration: -diff });
+      result.push({ _id: generateId(), type: "backup", duration: -diff });
       currentPosition = targetPos;
     } else if (diff > 0) {
       result.push({
+        _id: generateId(),
         type: "forward",
         duration: diff,
         voice: entry.type === "note" ? entry.voice : 1,
@@ -7112,6 +7135,7 @@ function insertNote(score, options) {
     )]);
   }
   const newNote = {
+    _id: generateId(),
     type: "note",
     pitch: options.pitch,
     duration: options.duration,
@@ -7218,6 +7242,7 @@ function addChord(score, options) {
     return failure([operationError("NOTE_NOT_FOUND", `Note index ${options.noteIndex} not found`, { partIndex: options.partIndex, measureIndex: options.measureIndex })]);
   }
   const chordNote = {
+    _id: generateId(),
     type: "note",
     pitch: options.pitch,
     duration: targetEntry.duration,
@@ -7441,7 +7466,7 @@ function insertMeasure(score, options) {
     if (insertIndex === -1) continue;
     const numericPart = parseInt(targetMeasure, 10);
     const newMeasureNumber = String(isNaN(numericPart) ? insertIndex + 2 : numericPart + 1);
-    const newMeasure = { number: newMeasureNumber, entries: [] };
+    const newMeasure = { _id: generateId(), number: newMeasureNumber, entries: [] };
     if (options.copyAttributes && part.measures[insertIndex].attributes) {
       newMeasure.attributes = { ...part.measures[insertIndex].attributes };
     }
@@ -7559,6 +7584,7 @@ export {
   findNotes,
   findNotesWithNotation,
   formatLocation,
+  generateId,
   getAbsolutePosition,
   getAdjacentNotes,
   getAllNotes,

package/dist/operations/index.d.mts

@@ -1,2 +1,2 @@
-import '../types-Dp9zcgIg.mjs';
-export { W as AddPartOptions, N as InsertNoteOptions, K as OperationErrorCode, O as OperationResult, G as ValidationError, R as addChord, g as addChordNote, a2 as addChordNoteChecked, b as addNote, a0 as addNoteChecked, X as addPart, U as addVoice, c as changeKey, S as changeNoteDuration, e as changeTime, f as deleteMeasure, d as deleteNote, a1 as deleteNoteChecked, Z as duplicatePart, i as insertMeasure, P as insertNote, h as modifyNoteDuration, a4 as modifyNoteDurationChecked, m as modifyNotePitch, a3 as modifyNotePitchChecked, $ as moveNoteToStaff, Q as removeNote, Y as removePart, T as setNotePitch, _ as setStaves, t as transpose, a5 as transposeChecked } from '../index-nCaclfqu.mjs';
+import '../types-CSI8kV28.mjs';
+export { ag as AddArticulationOptions, aA as AddBeamOptions, bW as AddBowingOptions, ca as AddBreathMarkOptions, cf as AddCaesuraOptions, br as AddCodaOptions, ak as AddDynamicsOptions, bj as AddEndingOptions, a_ as AddFermataOptions, bR as AddFingeringOptions, by as AddGraceNoteOptions, bL as AddHarmonyOptions, bE as AddLyricOptions, bt as AddNavigationOptions, c3 as AddOctaveShiftOptions, b2 as AddOrnamentOptions, a2 as AddPartOptions, b6 as AddPedalOptions, bc as AddRehearsalMarkOptions, bf as AddRepeatBarlineOptions, bp as AddSegnoOptions, ac as AddSlurOptions, b_ as AddStringNumberOptions, aS as AddTempoOptions, ba as AddTextDirectionOptions, a8 as AddTieOptions, aW as AddWedgeOptions, aE as AutoBeamOptions, be as BarStyle, bV as BowingType, c9 as BreathMarkValue, ce as CaesuraValue, bn as ChangeBarlineOptions, bC as ConvertToGraceOptions, aN as CopyNotesMultiMeasureOptions, aH as CopyNotesOptions, aw as CreateTupletOptions, aL as CutNotesOptions, bK as HarmonyKind, ao as InsertClefChangeOptions, N as InsertNoteOptions, $ as LowerAccidentalOptions, aO as MultiMeasureSelection, aG as NoteSelection, c2 as OctaveShiftType, K as OperationErrorCode, O as OperationResult, aQ as PasteNotesMultiMeasureOptions, aJ as PasteNotesOptions, Z as RaiseAccidentalOptions, ai as RemoveArticulationOptions, aC as RemoveBeamOptions, bY as RemoveBowingOptions, cc as RemoveBreathMarkOptions, ch as RemoveCaesuraOptions, am as RemoveDynamicsOptions, bl as RemoveEndingOptions, b0 as RemoveFermataOptions, bT as RemoveFingeringOptions, bA as RemoveGraceNoteOptions, bN as RemoveHarmonyOptions, bG as RemoveLyricOptions, c7 as RemoveOctaveShiftOptions, b4 as RemoveOrnamentOptions, b8 as RemovePedalOptions, bh as RemoveRepeatBarlineOptions, ae as RemoveSlurOptions, c0 as RemoveStringNumberOptions, aU as RemoveTempoOptions, aa as RemoveTieOptions, ay as RemoveTupletOptions, aY as RemoveWedgeOptions, U as SetNotePitchBySemitoneOptions, X as ShiftNotePitchOptions, c5 as StopOctaveShiftOptions, bP as UpdateHarmonyOptions, bI as UpdateLyricOptions, G as ValidationError, ah as addArticulation, aB as addBeam, bX as addBowing, cb as addBreathMark, cg as addCaesura, R as addChord, g as addChordNote, as as addChordNoteChecked, bs as addCoda, bu as addDaCapo, bv as addDalSegno, al as addDynamics, bk as addEnding, a$ as addFermata, bw as addFine, bS as addFingering, bz as addGraceNote, bM as addHarmony, bF as addLyric, b as addNote, aq as addNoteChecked, c4 as addOctaveShift, b3 as addOrnament, a3 as addPart, b7 as addPedal, bd as addRehearsalMark, bg as addRepeatBarline, bq as addSegno, ad as addSlur, b$ as addStringNumber, aT as addTempo, bb as addTextDirection, a9 as addTie, bx as addToCoda, a1 as addVoice, aX as addWedge, aF as autoBeam, bo as changeBarline, c as changeKey, S as changeNoteDuration, e as changeTime, bD as convertToGrace, aI as copyNotes, aP as copyNotesMultiMeasure, ax as createTuplet, aM as cutNotes, f as deleteMeasure, d as deleteNote, ar as deleteNoteChecked, a5 as duplicatePart, ap as insertClefChange, i as insertMeasure, P as insertNote, a0 as lowerAccidental, h as modifyNoteDuration, au as modifyNoteDurationChecked, m as modifyNotePitch, at as modifyNotePitchChecked, a7 as moveNoteToStaff, aK as pasteNotes, aR as pasteNotesMultiMeasure, _ as raiseAccidental, aj as removeArticulation, aD as removeBeam, bZ as removeBowing, cd as removeBreathMark, ci as removeCaesura, an as removeDynamics, bm as removeEnding, b1 as removeFermata, bU as removeFingering, bB as removeGraceNote, bO as removeHarmony, bH as removeLyric, Q as removeNote, c8 as removeOctaveShift, b5 as removeOrnament, a4 as removePart, b9 as removePedal, bi as removeRepeatBarline, af as removeSlur, c1 as removeStringNumber, aV as removeTempo, ab as removeTie, az as removeTuplet, aZ as removeWedge, T as setNotePitch, W as setNotePitchBySemitone, a6 as setStaves, Y as shiftNotePitch, c6 as stopOctaveShift, t as transpose, av as transposeChecked, bQ as updateHarmony, bJ as updateLyric } from '../index-D4hW6ANJ.mjs';

package/dist/operations/index.d.ts

@@ -1,2 +1,2 @@
-import '../types-Dp9zcgIg.js';
-export { W as AddPartOptions, N as InsertNoteOptions, K as OperationErrorCode, O as OperationResult, G as ValidationError, R as addChord, g as addChordNote, a2 as addChordNoteChecked, b as addNote, a0 as addNoteChecked, X as addPart, U as addVoice, c as changeKey, S as changeNoteDuration, e as changeTime, f as deleteMeasure, d as deleteNote, a1 as deleteNoteChecked, Z as duplicatePart, i as insertMeasure, P as insertNote, h as modifyNoteDuration, a4 as modifyNoteDurationChecked, m as modifyNotePitch, a3 as modifyNotePitchChecked, $ as moveNoteToStaff, Q as removeNote, Y as removePart, T as setNotePitch, _ as setStaves, t as transpose, a5 as transposeChecked } from '../index-DCty0U8p.js';
+import '../types-CSI8kV28.js';
+export { ag as AddArticulationOptions, aA as AddBeamOptions, bW as AddBowingOptions, ca as AddBreathMarkOptions, cf as AddCaesuraOptions, br as AddCodaOptions, ak as AddDynamicsOptions, bj as AddEndingOptions, a_ as AddFermataOptions, bR as AddFingeringOptions, by as AddGraceNoteOptions, bL as AddHarmonyOptions, bE as AddLyricOptions, bt as AddNavigationOptions, c3 as AddOctaveShiftOptions, b2 as AddOrnamentOptions, a2 as AddPartOptions, b6 as AddPedalOptions, bc as AddRehearsalMarkOptions, bf as AddRepeatBarlineOptions, bp as AddSegnoOptions, ac as AddSlurOptions, b_ as AddStringNumberOptions, aS as AddTempoOptions, ba as AddTextDirectionOptions, a8 as AddTieOptions, aW as AddWedgeOptions, aE as AutoBeamOptions, be as BarStyle, bV as BowingType, c9 as BreathMarkValue, ce as CaesuraValue, bn as ChangeBarlineOptions, bC as ConvertToGraceOptions, aN as CopyNotesMultiMeasureOptions, aH as CopyNotesOptions, aw as CreateTupletOptions, aL as CutNotesOptions, bK as HarmonyKind, ao as InsertClefChangeOptions, N as InsertNoteOptions, $ as LowerAccidentalOptions, aO as MultiMeasureSelection, aG as NoteSelection, c2 as OctaveShiftType, K as OperationErrorCode, O as OperationResult, aQ as PasteNotesMultiMeasureOptions, aJ as PasteNotesOptions, Z as RaiseAccidentalOptions, ai as RemoveArticulationOptions, aC as RemoveBeamOptions, bY as RemoveBowingOptions, cc as RemoveBreathMarkOptions, ch as RemoveCaesuraOptions, am as RemoveDynamicsOptions, bl as RemoveEndingOptions, b0 as RemoveFermataOptions, bT as RemoveFingeringOptions, bA as RemoveGraceNoteOptions, bN as RemoveHarmonyOptions, bG as RemoveLyricOptions, c7 as RemoveOctaveShiftOptions, b4 as RemoveOrnamentOptions, b8 as RemovePedalOptions, bh as RemoveRepeatBarlineOptions, ae as RemoveSlurOptions, c0 as RemoveStringNumberOptions, aU as RemoveTempoOptions, aa as RemoveTieOptions, ay as RemoveTupletOptions, aY as RemoveWedgeOptions, U as SetNotePitchBySemitoneOptions, X as ShiftNotePitchOptions, c5 as StopOctaveShiftOptions, bP as UpdateHarmonyOptions, bI as UpdateLyricOptions, G as ValidationError, ah as addArticulation, aB as addBeam, bX as addBowing, cb as addBreathMark, cg as addCaesura, R as addChord, g as addChordNote, as as addChordNoteChecked, bs as addCoda, bu as addDaCapo, bv as addDalSegno, al as addDynamics, bk as addEnding, a$ as addFermata, bw as addFine, bS as addFingering, bz as addGraceNote, bM as addHarmony, bF as addLyric, b as addNote, aq as addNoteChecked, c4 as addOctaveShift, b3 as addOrnament, a3 as addPart, b7 as addPedal, bd as addRehearsalMark, bg as addRepeatBarline, bq as addSegno, ad as addSlur, b$ as addStringNumber, aT as addTempo, bb as addTextDirection, a9 as addTie, bx as addToCoda, a1 as addVoice, aX as addWedge, aF as autoBeam, bo as changeBarline, c as changeKey, S as changeNoteDuration, e as changeTime, bD as convertToGrace, aI as copyNotes, aP as copyNotesMultiMeasure, ax as createTuplet, aM as cutNotes, f as deleteMeasure, d as deleteNote, ar as deleteNoteChecked, a5 as duplicatePart, ap as insertClefChange, i as insertMeasure, P as insertNote, a0 as lowerAccidental, h as modifyNoteDuration, au as modifyNoteDurationChecked, m as modifyNotePitch, at as modifyNotePitchChecked, a7 as moveNoteToStaff, aK as pasteNotes, aR as pasteNotesMultiMeasure, _ as raiseAccidental, aj as removeArticulation, aD as removeBeam, bZ as removeBowing, cd as removeBreathMark, ci as removeCaesura, an as removeDynamics, bm as removeEnding, b1 as removeFermata, bU as removeFingering, bB as removeGraceNote, bO as removeHarmony, bH as removeLyric, Q as removeNote, c8 as removeOctaveShift, b5 as removeOrnament, a4 as removePart, b9 as removePedal, bi as removeRepeatBarline, af as removeSlur, c1 as removeStringNumber, aV as removeTempo, ab as removeTie, az as removeTuplet, aZ as removeWedge, T as setNotePitch, W as setNotePitchBySemitone, a6 as setStaves, Y as shiftNotePitch, c6 as stopOctaveShift, t as transpose, av as transposeChecked, bQ as updateHarmony, bJ as updateLyric } from '../index-CVGy8DJi.js';