musicxml-io 0.2.5 → 0.2.7

package/dist/operations/index.mjs

@@ -1,3 +1,9 @@
+// src/id.ts
+import { nanoid } from "nanoid";
+function generateId() {
+  return "i" + nanoid(10);
+}
+
 // src/utils/index.ts
 var STEPS = ["C", "D", "E", "F", "G", "A", "B"];
 var STEP_SEMITONES = {
@@ -1074,6 +1080,34 @@ function operationError(code, message, location = {}, details) {
 function cloneScore(score) {
   return JSON.parse(JSON.stringify(score));
 }
+function cloneNoteWithNewId(note) {
+  const cloned = JSON.parse(JSON.stringify(note));
+  cloned._id = generateId();
+  return cloned;
+}
+function cloneEntryWithNewId(entry) {
+  const cloned = JSON.parse(JSON.stringify(entry));
+  cloned._id = generateId();
+  return cloned;
+}
+function cloneMeasureWithNewIds(measure) {
+  const cloned = JSON.parse(JSON.stringify(measure));
+  cloned._id = generateId();
+  cloned.entries = cloned.entries.map((entry) => cloneEntryWithNewId(entry));
+  if (cloned.barlines) {
+    cloned.barlines = cloned.barlines.map((barline) => ({
+      ...barline,
+      _id: generateId()
+    }));
+  }
+  return cloned;
+}
+function clonePartWithNewIds(part) {
+  const cloned = JSON.parse(JSON.stringify(part));
+  cloned._id = generateId();
+  cloned.measures = cloned.measures.map((measure) => cloneMeasureWithNewIds(measure));
+  return cloned;
+}
 function getMeasureDuration(divisions, time) {
   const beats = parseInt(time.beats, 10);
   if (isNaN(beats)) return divisions * 4;
@@ -1136,6 +1170,7 @@ function hasNotesInRange(voiceEntries, startPos, endPos) {
 }
 function createRest(duration, voice, staff) {
   return {
+    _id: generateId(),
     type: "note",
     rest: { displayStep: void 0, displayOctave: void 0 },
     duration,
@@ -1197,10 +1232,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,
@@ -1255,6 +1291,7 @@ function insertNote(score, options) {
     )]);
   }
   const newNote = {
+    _id: generateId(),
     type: "note",
     pitch: options.pitch,
     duration: options.duration,
@@ -1361,6 +1398,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,
@@ -1689,7 +1727,7 @@ function addVoice(score, options) {
   const rest = createRest(measureDuration, options.voice, options.staff);
   const currentEnd = getMeasureEndPosition(measure);
   if (currentEnd > 0) {
-    measure.entries.push({ type: "backup", duration: currentEnd });
+    measure.entries.push({ _id: generateId(), type: "backup", duration: currentEnd });
   }
   measure.entries.push(rest);
   return success(result);
@@ -1740,6 +1778,7 @@ function addPart(score, options) {
   const result = cloneScore(score);
   const insertIndex = options.insertIndex ?? result.parts.length;
   const partInfo = {
+    _id: generateId(),
     type: "score-part",
     id: options.id,
     name: options.name,
@@ -1758,10 +1797,10 @@ function addPart(score, options) {
   }
   result.partList.splice(partListInsertIndex, 0, partInfo);
   const measureCount = result.parts.length > 0 ? result.parts[0].measures.length : 1;
-  const newPart = { id: options.id, measures: [] };
+  const newPart = { _id: generateId(), id: options.id, measures: [] };
   for (let i = 0; i < measureCount; i++) {
     const measureNumber = result.parts.length > 0 ? result.parts[0].measures[i]?.number ?? String(i + 1) : String(i + 1);
-    const measure = { number: measureNumber, entries: [] };
+    const measure = { _id: generateId(), number: measureNumber, entries: [] };
     if (i === 0) {
       measure.attributes = {
         divisions: options.divisions ?? 4,
@@ -1805,10 +1844,11 @@ function duplicatePart(score, options) {
   }
   const result = cloneScore(score);
   const sourcePart = result.parts[sourceIndex];
-  const newPart = JSON.parse(JSON.stringify(sourcePart));
+  const newPart = clonePartWithNewIds(sourcePart);
   newPart.id = options.newPartId;
   const sourcePartInfo = result.partList.find((e) => e.type === "score-part" && e.id === options.sourcePartId);
   const newPartInfo = {
+    _id: generateId(),
     type: "score-part",
     id: options.newPartId,
     name: options.newPartName ?? sourcePartInfo?.name,
@@ -1922,7 +1962,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 };
     }
@@ -2198,6 +2238,7 @@ function addDynamics(score, options) {
   const result = cloneScore(score);
   const measure = result.parts[options.partIndex].measures[options.measureIndex];
   const directionEntry = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{
       kind: "dynamics",
@@ -2274,6 +2315,7 @@ function insertClefChange(score, options) {
     }
   } else {
     const attributesEntry = {
+      _id: generateId(),
       type: "attributes",
       attributes: {
         clef: [options.clef]
@@ -2742,7 +2784,7 @@ function copyNotes(score, options) {
         if (!entry.chord) {
           const noteEnd = position + entry.duration;
           if (position < options.endPosition && noteEnd > options.startPosition) {
-            const clonedNote = JSON.parse(JSON.stringify(entry));
+            const clonedNote = cloneNoteWithNewId(entry);
             if (clonedNote.tie) {
             }
             copiedNotes.push({
@@ -2755,7 +2797,7 @@ function copyNotes(score, options) {
           if (copiedNotes.length > 0) {
             const lastCopied = copiedNotes[copiedNotes.length - 1];
             if (lastCopied.note.voice === entry.voice && (options.staff === void 0 || (lastCopied.note.staff ?? 1) === (entry.staff ?? 1))) {
-              const clonedNote = JSON.parse(JSON.stringify(entry));
+              const clonedNote = cloneNoteWithNewId(entry);
               copiedNotes.push({
                 relativePosition: lastCopied.relativePosition,
                 note: clonedNote
@@ -2831,7 +2873,7 @@ function pasteNotes(score, options) {
     }
     for (const { relativePosition, note } of options.selection.notes) {
       const pastePosition = options.position + Math.max(0, relativePosition);
-      const newNote = JSON.parse(JSON.stringify(note));
+      const newNote = cloneNoteWithNewId(note);
       newNote.voice = targetVoice;
       if (targetStaff !== void 0) {
         newNote.staff = targetStaff;
@@ -2866,7 +2908,7 @@ function pasteNotes(score, options) {
     const existingNotes = voiceEntries.filter((e) => e.entry.type === "note").map((e) => ({ position: e.position, entry: e.entry }));
     for (const { relativePosition, note } of options.selection.notes) {
       const pastePosition = options.position + Math.max(0, relativePosition);
-      const newNote = JSON.parse(JSON.stringify(note));
+      const newNote = cloneNoteWithNewId(note);
       newNote.voice = targetVoice;
       if (targetStaff !== void 0) {
         newNote.staff = targetStaff;
@@ -2974,14 +3016,14 @@ function copyNotesMultiMeasure(score, options) {
       if (entry.type === "note") {
         if (entry.voice === options.voice && (options.staff === void 0 || (entry.staff ?? 1) === options.staff)) {
           if (!entry.chord && !entry.rest) {
-            const clonedNote = JSON.parse(JSON.stringify(entry));
+            const clonedNote = cloneNoteWithNewId(entry);
             copiedNotes.push({
               relativePosition: position,
               note: clonedNote
             });
             position += entry.duration;
           } else if (entry.chord && copiedNotes.length > 0) {
-            const clonedNote = JSON.parse(JSON.stringify(entry));
+            const clonedNote = cloneNoteWithNewId(entry);
             copiedNotes.push({
               relativePosition: copiedNotes[copiedNotes.length - 1].relativePosition,
               note: clonedNote
@@ -3035,7 +3077,7 @@ function pasteNotesMultiMeasure(score, options) {
       entriesToKeep = voiceEntries.filter((e) => e.entry.type === "note").map((e) => ({ position: e.position, entry: e.entry }));
     }
     for (const { relativePosition, note } of measureData.notes) {
-      const newNote = JSON.parse(JSON.stringify(note));
+      const newNote = cloneNoteWithNewId(note);
       newNote.voice = targetVoice;
       if (targetStaff !== void 0) {
         newNote.staff = targetStaff;
@@ -3097,6 +3139,7 @@ function addTempo(score, options) {
     });
   }
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes,
     placement: options.placement ?? "above",
@@ -3149,6 +3192,7 @@ function addWedge(score, options) {
   const result = cloneScore(score);
   const startMeasure = result.parts[options.partIndex].measures[options.startMeasureIndex];
   const startDirection = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{
       kind: "wedge",
@@ -3160,6 +3204,7 @@ function addWedge(score, options) {
   insertDirectionAtPosition(startMeasure, startDirection, options.startPosition);
   const endMeasure = result.parts[options.partIndex].measures[options.endMeasureIndex];
   const endDirection = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{
       kind: "wedge",
@@ -3340,6 +3385,7 @@ function addPedal(score, options) {
   const result = cloneScore(score);
   const measure = result.parts[options.partIndex].measures[options.measureIndex];
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{
       kind: "pedal",
@@ -3392,6 +3438,7 @@ function addTextDirection(score, options) {
   const result = cloneScore(score);
   const measure = result.parts[options.partIndex].measures[options.measureIndex];
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{
       kind: "words",
@@ -3415,6 +3462,7 @@ function addRehearsalMark(score, options) {
   const result = cloneScore(score);
   const measure = result.parts[options.partIndex].measures[options.measureIndex];
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{
       kind: "rehearsal",
@@ -3473,6 +3521,7 @@ function addRepeatBarline(score, options) {
       measure.barlines.splice(nonRepeatIndex, 1);
     }
     measure.barlines.push({
+      _id: generateId(),
       location,
       barStyle,
       repeat: {
@@ -3535,7 +3584,7 @@ function addEnding(score, options) {
     }
     let barline = measure.barlines.find((b) => b.location === location);
     if (!barline) {
-      barline = { location };
+      barline = { _id: generateId(), location };
       measure.barlines.push(barline);
     }
     if (barline.ending) {
@@ -3597,7 +3646,7 @@ function changeBarline(score, options) {
     }
     let barline = measure.barlines.find((b) => b.location === location);
     if (!barline) {
-      barline = { location };
+      barline = { _id: generateId(), location };
       measure.barlines.push(barline);
     }
     barline.barStyle = barStyle;
@@ -3616,6 +3665,7 @@ function addSegno(score, options) {
   const result = cloneScore(score);
   const measure = result.parts[partIndex].measures[measureIndex];
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{ kind: "segno" }],
     placement: "above"
@@ -3635,6 +3685,7 @@ function addCoda(score, options) {
   const result = cloneScore(score);
   const measure = result.parts[partIndex].measures[measureIndex];
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{ kind: "coda" }],
     placement: "above"
@@ -3657,12 +3708,14 @@ function addDaCapo(score, options) {
   const measureDuration = getMeasureDuration(attrs.divisions ?? 1, attrs.time ?? { beats: "4", beatType: 4 });
   const insertPos = position ?? measureDuration;
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{ kind: "words", text: "D.C." }],
     placement: "above"
   };
   insertDirectionAtPosition(measure, direction, insertPos);
   const sound = {
+    _id: generateId(),
     type: "sound",
     dacapo: true
   };
@@ -3684,12 +3737,14 @@ function addDalSegno(score, options) {
   const measureDuration = getMeasureDuration(attrs.divisions ?? 1, attrs.time ?? { beats: "4", beatType: 4 });
   const insertPos = position ?? measureDuration;
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{ kind: "words", text: "D.S." }],
     placement: "above"
   };
   insertDirectionAtPosition(measure, direction, insertPos);
   const sound = {
+    _id: generateId(),
     type: "sound",
     dalsegno: "segno"
   };
@@ -3711,12 +3766,14 @@ function addFine(score, options) {
   const measureDuration = getMeasureDuration(attrs.divisions ?? 1, attrs.time ?? { beats: "4", beatType: 4 });
   const insertPos = position ?? measureDuration;
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{ kind: "words", text: "Fine" }],
     placement: "above"
   };
   insertDirectionAtPosition(measure, direction, insertPos);
   const sound = {
+    _id: generateId(),
     type: "sound",
     fine: true
   };
@@ -3738,12 +3795,14 @@ function addToCoda(score, options) {
   const measureDuration = getMeasureDuration(attrs.divisions ?? 1, attrs.time ?? { beats: "4", beatType: 4 });
   const insertPos = position ?? measureDuration;
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{ kind: "words", text: "To Coda" }],
     placement: "above"
   };
   insertDirectionAtPosition(measure, direction, insertPos);
   const sound = {
+    _id: generateId(),
     type: "sound",
     tocoda: "coda"
   };
@@ -3780,6 +3839,7 @@ function addGraceNote(score, options) {
   const result = cloneScore(score);
   const resultMeasure = result.parts[partIndex].measures[measureIndex];
   const graceNote = {
+    _id: generateId(),
     type: "note",
     pitch,
     duration: 0,
@@ -4020,6 +4080,7 @@ function addHarmony(score, options) {
   const result = cloneScore(score);
   const measure = result.parts[partIndex].measures[measureIndex];
   const harmony = {
+    _id: generateId(),
     type: "harmony",
     root: {
       rootStep: root.step.toUpperCase(),
@@ -4418,6 +4479,7 @@ function addOctaveShift(score, options) {
   const result = cloneScore(score);
   const measure = result.parts[partIndex].measures[measureIndex];
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{
       kind: "octave-shift",
@@ -4441,6 +4503,7 @@ function stopOctaveShift(score, options) {
   const result = cloneScore(score);
   const measure = result.parts[partIndex].measures[measureIndex];
   const direction = {
+    _id: generateId(),
     type: "direction",
     directionTypes: [{
       kind: "octave-shift",

package/dist/query/index.d.mts

@@ -1,4 +1,4 @@
-import { S as Score, M as Measure, f as MeasureAttributes, P as Pitch, N as NoteEntry, e as Part } from '../types-D3LhKCDK.mjs';
+import { S as Score, M as Measure, f as MeasureAttributes, P as Pitch, N as NoteEntry, e as Part } from '../types-CSI8kV28.mjs';
 
 /**
  * Get a specific measure from the score

package/dist/query/index.d.ts

@@ -1,4 +1,4 @@
-import { S as Score, M as Measure, f as MeasureAttributes, P as Pitch, N as NoteEntry, e as Part } from '../types-D3LhKCDK.js';
+import { S as Score, M as Measure, f as MeasureAttributes, P as Pitch, N as NoteEntry, e as Part } from '../types-CSI8kV28.js';
 
 /**
  * Get a specific measure from the score

package/dist/{types-D3LhKCDK.d.mts → types-CSI8kV28.d.mts}

@@ -1,4 +1,5 @@
 interface Score {
+    _id: string;
     metadata: ScoreMetadata;
     partList: PartListEntry[];
     parts: Part[];
@@ -90,6 +91,7 @@ interface FontInfo {
     fontWeight?: string;
 }
 interface Credit {
+    _id: string;
     page?: number;
     creditType?: string[];
     creditWords?: CreditWords[];
@@ -116,6 +118,7 @@ interface CreditWords {
 }
 type PartListEntry = PartInfo | PartGroup;
 interface PartInfo {
+    _id: string;
     type: 'score-part';
     id: string;
     name?: string;
@@ -161,6 +164,7 @@ interface MidiInstrument {
     elevation?: number;
 }
 interface PartGroup {
+    _id: string;
     type: 'part-group';
     groupType: 'start' | 'stop';
     number?: number;
@@ -173,10 +177,12 @@ interface PartGroup {
     groupBarline?: 'yes' | 'no' | 'Mensurstrich';
 }
 interface Part {
+    _id: string;
     id: string;
     measures: Measure[];
 }
 interface Measure {
+    _id: string;
     number: string;
     width?: number;
     implicit?: boolean;
@@ -294,6 +300,7 @@ interface Transpose {
     octaveChange?: number;
 }
 interface Barline {
+    _id: string;
     location: 'left' | 'right' | 'middle';
     barStyle?: 'regular' | 'dotted' | 'dashed' | 'heavy' | 'light-light' | 'light-heavy' | 'heavy-light' | 'heavy-heavy' | 'tick' | 'short' | 'none';
     repeat?: {
@@ -307,10 +314,12 @@ interface Barline {
 }
 type MeasureEntry = NoteEntry | BackupEntry | ForwardEntry | DirectionEntry | HarmonyEntry | FiguredBassEntry | SoundEntry | AttributesEntry;
 interface AttributesEntry {
+    _id: string;
     type: 'attributes';
     attributes: MeasureAttributes;
 }
 interface NoteEntry {
+    _id: string;
     type: 'note';
     pitch?: Pitch;
     rest?: RestInfo;
@@ -356,10 +365,12 @@ interface NoteEntry {
     };
 }
 interface BackupEntry {
+    _id: string;
     type: 'backup';
     duration: number;
 }
 interface ForwardEntry {
+    _id: string;
     type: 'forward';
     duration: number;
     voice?: number;
@@ -380,6 +391,7 @@ interface DirectionSound {
     sostenutoPedal?: 'yes' | 'no';
 }
 interface DirectionEntry {
+    _id: string;
     type: 'direction';
     directionTypes: DirectionType[];
     placement?: 'above' | 'below';
@@ -398,6 +410,7 @@ interface Swing {
     swingType?: string;
 }
 interface SoundEntry {
+    _id: string;
     type: 'sound';
     tempo?: number;
     dynamics?: number;
@@ -414,6 +427,7 @@ interface SoundEntry {
     sostenutoPedal?: boolean | 'yes' | 'no';
 }
 interface HarmonyEntry {
+    _id: string;
     type: 'harmony';
     root: {
         rootStep: string;
@@ -455,6 +469,7 @@ interface FrameNote {
     barre?: 'start' | 'stop';
 }
 interface FiguredBassEntry {
+    _id: string;
     type: 'figured-bass';
     figures: Figure[];
     duration?: number;

package/dist/{types-D3LhKCDK.d.ts → types-CSI8kV28.d.ts}

@@ -1,4 +1,5 @@
 interface Score {
+    _id: string;
     metadata: ScoreMetadata;
     partList: PartListEntry[];
     parts: Part[];
@@ -90,6 +91,7 @@ interface FontInfo {
     fontWeight?: string;
 }
 interface Credit {
+    _id: string;
     page?: number;
     creditType?: string[];
     creditWords?: CreditWords[];
@@ -116,6 +118,7 @@ interface CreditWords {
 }
 type PartListEntry = PartInfo | PartGroup;
 interface PartInfo {
+    _id: string;
     type: 'score-part';
     id: string;
     name?: string;
@@ -161,6 +164,7 @@ interface MidiInstrument {
     elevation?: number;
 }
 interface PartGroup {
+    _id: string;
     type: 'part-group';
     groupType: 'start' | 'stop';
     number?: number;
@@ -173,10 +177,12 @@ interface PartGroup {
     groupBarline?: 'yes' | 'no' | 'Mensurstrich';
 }
 interface Part {
+    _id: string;
     id: string;
     measures: Measure[];
 }
 interface Measure {
+    _id: string;
     number: string;
     width?: number;
     implicit?: boolean;
@@ -294,6 +300,7 @@ interface Transpose {
     octaveChange?: number;
 }
 interface Barline {
+    _id: string;
     location: 'left' | 'right' | 'middle';
     barStyle?: 'regular' | 'dotted' | 'dashed' | 'heavy' | 'light-light' | 'light-heavy' | 'heavy-light' | 'heavy-heavy' | 'tick' | 'short' | 'none';
     repeat?: {
@@ -307,10 +314,12 @@ interface Barline {
 }
 type MeasureEntry = NoteEntry | BackupEntry | ForwardEntry | DirectionEntry | HarmonyEntry | FiguredBassEntry | SoundEntry | AttributesEntry;
 interface AttributesEntry {
+    _id: string;
     type: 'attributes';
     attributes: MeasureAttributes;
 }
 interface NoteEntry {
+    _id: string;
     type: 'note';
     pitch?: Pitch;
     rest?: RestInfo;
@@ -356,10 +365,12 @@ interface NoteEntry {
     };
 }
 interface BackupEntry {
+    _id: string;
     type: 'backup';
     duration: number;
 }
 interface ForwardEntry {
+    _id: string;
     type: 'forward';
     duration: number;
     voice?: number;
@@ -380,6 +391,7 @@ interface DirectionSound {
     sostenutoPedal?: 'yes' | 'no';
 }
 interface DirectionEntry {
+    _id: string;
     type: 'direction';
     directionTypes: DirectionType[];
     placement?: 'above' | 'below';
@@ -398,6 +410,7 @@ interface Swing {
     swingType?: string;
 }
 interface SoundEntry {
+    _id: string;
     type: 'sound';
     tempo?: number;
     dynamics?: number;
@@ -414,6 +427,7 @@ interface SoundEntry {
     sostenutoPedal?: boolean | 'yes' | 'no';
 }
 interface HarmonyEntry {
+    _id: string;
     type: 'harmony';
     root: {
         rootStep: string;
@@ -455,6 +469,7 @@ interface FrameNote {
     barre?: 'start' | 'stop';
 }
 interface FiguredBassEntry {
+    _id: string;
     type: 'figured-bass';
     figures: Figure[];
     duration?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musicxml-io",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Parse and serialize MusicXML (.xml/.mxl) with high round-trip fidelity",
   "author": "tan-z-tan",
   "license": "MIT",
@@ -76,7 +76,8 @@
   },
   "dependencies": {
     "fast-xml-parser": "^4.3.2",
-    "fflate": "^0.8.2"
+    "fflate": "^0.8.2",
+    "nanoid": "^5.1.6"
   },
   "files": [
     "dist"