musicxml-io 0.2.7 → 0.2.9

package/dist/index.js

@@ -45,14 +45,17 @@ __export(src_exports, {
   getAbsolutePosition: () => getAbsolutePosition,
   getAdjacentNotes: () => getAdjacentNotes,
   getAllNotes: () => getAllNotes,
+  getAllPartInfos: () => getAllPartInfos,
   getAttributesAtMeasure: () => getAttributesAtMeasure,
   getBeamGroups: () => getBeamGroups,
   getChordProgression: () => getChordProgression,
   getChords: () => getChords,
   getClefChanges: () => getClefChanges,
   getClefForStaff: () => getClefForStaff,
+  getDirectionOfKind: () => getDirectionOfKind,
   getDirections: () => getDirections,
   getDirectionsAtPosition: () => getDirectionsAtPosition,
+  getDirectionsOfKind: () => getDirectionsOfKind,
   getDivisions: () => getDivisions,
   getDuration: () => getDuration,
   getDynamics: () => getDynamics,
@@ -79,15 +82,24 @@ __export(src_exports, {
   getNotesForVoice: () => getNotesForVoice,
   getNotesInRange: () => getNotesInRange,
   getOctaveShifts: () => getOctaveShifts,
+  getPartAbbreviation: () => getPartAbbreviation,
   getPartById: () => getPartById,
   getPartByIndex: () => getPartByIndex,
   getPartCount: () => getPartCount,
   getPartIds: () => getPartIds,
   getPartIndex: () => getPartIndex,
+  getPartInfo: () => getPartInfo,
+  getPartName: () => getPartName,
+  getPartNameMap: () => getPartNameMap,
   getPedalMarkings: () => getPedalMarkings,
   getPrevNote: () => getPrevNote,
   getRepeatStructure: () => getRepeatStructure,
   getSlurSpans: () => getSlurSpans,
+  getSoundDamperPedal: () => getSoundDamperPedal,
+  getSoundDynamics: () => getSoundDynamics,
+  getSoundSoftPedal: () => getSoundSoftPedal,
+  getSoundSostenutoPedal: () => getSoundSostenutoPedal,
+  getSoundTempo: () => getSoundTempo,
   getStaffRange: () => getStaffRange,
   getStaveCount: () => getStaveCount,
   getStaves: () => getStaves,
@@ -105,12 +117,27 @@ __export(src_exports, {
   getWedges: () => getWedges,
   groupByStaff: () => groupByStaff,
   groupByVoice: () => groupByVoice,
+  hasBeam: () => hasBeam,
+  hasDirectionOfKind: () => hasDirectionOfKind,
+  hasLyrics: () => hasLyrics,
   hasMultipleStaves: () => hasMultipleStaves,
+  hasNotations: () => hasNotations,
   hasNotes: () => hasNotes,
+  hasTie: () => hasTie,
+  hasTieStart: () => hasTieStart,
+  hasTieStop: () => hasTieStop,
+  hasTuplet: () => hasTuplet,
   inferStaff: () => inferStaff,
   insertMeasure: () => insertMeasure,
+  isChordNote: () => isChordNote,
   isCompressed: () => isCompressed,
+  isCueNote: () => isCueNote,
+  isGraceNote: () => isGraceNote,
+  isPartInfo: () => isPartInfo,
+  isPitchedNote: () => isPitchedNote,
+  isRest: () => isRest,
   isRestMeasure: () => isRestMeasure,
+  isUnpitchedNote: () => isUnpitchedNote,
   isValid: () => isValid,
   iterateEntries: () => iterateEntries,
   iterateNotes: () => iterateNotes,
@@ -3700,8 +3727,10 @@ function serializeSystemLayout(layout, indent) {
 }
 function serializeCredit(credit, indent) {
   const lines = [];
-  const pageAttr = credit.page !== void 0 ? ` page="${credit.page}"` : "";
-  lines.push(`${indent}<credit${pageAttr}>`);
+  let attrs = "";
+  if (credit._id) attrs += ` id="${escapeXml(credit._id)}"`;
+  if (credit.page !== void 0) attrs += ` page="${credit.page}"`;
+  lines.push(`${indent}<credit${attrs}>`);
   if (credit.creditType) {
     for (const ct of credit.creditType) {
       lines.push(`${indent}${indent}<credit-type>${escapeXml(ct)}</credit-type>`);
@@ -3709,19 +3738,19 @@ function serializeCredit(credit, indent) {
   }
   if (credit.creditWords) {
     for (const cw of credit.creditWords) {
-      let attrs = "";
-      if (cw.defaultX !== void 0) attrs += ` default-x="${cw.defaultX}"`;
-      if (cw.defaultY !== void 0) attrs += ` default-y="${cw.defaultY}"`;
-      if (cw.fontSize) attrs += ` font-size="${escapeXml(cw.fontSize)}"`;
-      if (cw.fontWeight) attrs += ` font-weight="${escapeXml(cw.fontWeight)}"`;
-      if (cw.fontStyle) attrs += ` font-style="${escapeXml(cw.fontStyle)}"`;
-      if (cw.justify) attrs += ` justify="${escapeXml(cw.justify)}"`;
-      if (cw.halign) attrs += ` halign="${escapeXml(cw.halign)}"`;
-      if (cw.valign) attrs += ` valign="${escapeXml(cw.valign)}"`;
-      if (cw.letterSpacing) attrs += ` letter-spacing="${escapeXml(cw.letterSpacing)}"`;
-      if (cw.xmlLang) attrs += ` xml:lang="${escapeXml(cw.xmlLang)}"`;
-      if (cw.xmlSpace) attrs += ` xml:space="${escapeXml(cw.xmlSpace)}"`;
-      lines.push(`${indent}${indent}<credit-words${attrs}>${escapeXml(cw.text)}</credit-words>`);
+      let attrs2 = "";
+      if (cw.defaultX !== void 0) attrs2 += ` default-x="${cw.defaultX}"`;
+      if (cw.defaultY !== void 0) attrs2 += ` default-y="${cw.defaultY}"`;
+      if (cw.fontSize) attrs2 += ` font-size="${escapeXml(cw.fontSize)}"`;
+      if (cw.fontWeight) attrs2 += ` font-weight="${escapeXml(cw.fontWeight)}"`;
+      if (cw.fontStyle) attrs2 += ` font-style="${escapeXml(cw.fontStyle)}"`;
+      if (cw.justify) attrs2 += ` justify="${escapeXml(cw.justify)}"`;
+      if (cw.halign) attrs2 += ` halign="${escapeXml(cw.halign)}"`;
+      if (cw.valign) attrs2 += ` valign="${escapeXml(cw.valign)}"`;
+      if (cw.letterSpacing) attrs2 += ` letter-spacing="${escapeXml(cw.letterSpacing)}"`;
+      if (cw.xmlLang) attrs2 += ` xml:lang="${escapeXml(cw.xmlLang)}"`;
+      if (cw.xmlSpace) attrs2 += ` xml:space="${escapeXml(cw.xmlSpace)}"`;
+      lines.push(`${indent}${indent}<credit-words${attrs2}>${escapeXml(cw.text)}</credit-words>`);
     }
   }
   lines.push(`${indent}</credit>`);
@@ -3841,6 +3870,7 @@ function serializePartGroup(group, indent) {
   const lines = [];
   let attrs = ` type="${group.groupType}"`;
   if (group.number !== void 0) attrs += ` number="${group.number}"`;
+  if (group._id) attrs += ` id="${escapeXml(group._id)}"`;
   lines.push(`${indent}<part-group${attrs}>`);
   if (group.groupName) {
     lines.push(`${indent}  <group-name>${escapeXml(group.groupName)}</group-name>`);
@@ -3881,6 +3911,7 @@ function serializePart(part, indent) {
 function serializeMeasure(measure, indent) {
   const lines = [];
   let attrs = ` number="${measure.number}"`;
+  if (measure._id) attrs += ` id="${escapeXml(measure._id)}"`;
   if (measure.width !== void 0) attrs += ` width="${measure.width}"`;
   if (measure.implicit) attrs += ` implicit="yes"`;
   lines.push(`${indent}<measure${attrs}>`);
@@ -3955,9 +3986,10 @@ function serializePrint(print, indent) {
   lines.push(`${indent}</print>`);
   return lines;
 }
-function serializeAttributes(attrs, indent) {
+function serializeAttributes(attrs, indent, id) {
   const lines = [];
-  lines.push(`${indent}<attributes>`);
+  const idAttr = id ? ` id="${escapeXml(id)}"` : "";
+  lines.push(`${indent}<attributes${idAttr}>`);
   if (attrs.divisions !== void 0) {
     lines.push(`${indent}  <divisions>${attrs.divisions}</divisions>`);
   }
@@ -4105,7 +4137,7 @@ function serializeEntry(entry, indent) {
     case "sound":
       return serializeSound(entry, indent);
     case "attributes":
-      return serializeAttributes(entry.attributes, indent);
+      return serializeAttributes(entry.attributes, indent, entry._id);
     default:
       return [];
   }
@@ -4113,6 +4145,7 @@ function serializeEntry(entry, indent) {
 function serializeNote(note, indent) {
   const lines = [];
   const noteAttrs = buildAttrs({
+    "id": note._id,
     "default-x": note.defaultX,
     "default-y": note.defaultY,
     "relative-x": note.relativeX,
@@ -4595,7 +4628,8 @@ function serializeBackup(backup, indent) {
 }
 function serializeForward(forward, indent) {
   const lines = [];
-  lines.push(`${indent}<forward>`);
+  const idAttr = forward._id ? ` id="${escapeXml(forward._id)}"` : "";
+  lines.push(`${indent}<forward${idAttr}>`);
   lines.push(`${indent}  <duration>${forward.duration}</duration>`);
   if (forward.voice !== void 0) {
     lines.push(`${indent}  <voice>${forward.voice}</voice>`);
@@ -4609,6 +4643,7 @@ function serializeForward(forward, indent) {
 function serializeDirection(direction, indent) {
   const lines = [];
   let attrs = "";
+  if (direction._id) attrs += ` id="${escapeXml(direction._id)}"`;
   if (direction.placement) attrs += ` placement="${direction.placement}"`;
   if (direction.directive) attrs += ' directive="yes"';
   if (direction.system) attrs += ` system="${direction.system}"`;
@@ -4870,7 +4905,9 @@ function serializeDirectionType(dirType, indent) {
 }
 function serializeBarline(barline, indent) {
   const lines = [];
-  lines.push(`${indent}<barline location="${barline.location}">`);
+  let attrs = ` location="${barline.location}"`;
+  if (barline._id) attrs += ` id="${escapeXml(barline._id)}"`;
+  lines.push(`${indent}<barline${attrs}>`);
   if (barline.barStyle) {
     lines.push(`${indent}  <bar-style>${barline.barStyle}</bar-style>`);
   }
@@ -4963,6 +5000,7 @@ function serializeMeasureStyle(ms, indent) {
 function serializeHarmony(harmony, indent) {
   const lines = [];
   const attrs = buildAttrs({
+    id: harmony._id,
     placement: harmony.placement,
     "print-frame": harmony.printFrame,
     "default-y": harmony.defaultY,
@@ -5040,6 +5078,7 @@ function serializeHarmony(harmony, indent) {
 function serializeFiguredBass(fb, indent) {
   const lines = [];
   let attrs = "";
+  if (fb._id) attrs += ` id="${escapeXml(fb._id)}"`;
   if (fb.parentheses) attrs += ' parentheses="yes"';
   lines.push(`${indent}<figured-bass${attrs}>`);
   for (const fig of fb.figures) {
@@ -5071,6 +5110,7 @@ function serializeFiguredBass(fb, indent) {
 function serializeSound(sound, indent) {
   const lines = [];
   const attrs = [];
+  if (sound._id) attrs.push(`id="${escapeXml(sound._id)}"`);
   if (sound.tempo !== void 0) attrs.push(`tempo="${sound.tempo}"`);
   if (sound.dynamics !== void 0) attrs.push(`dynamics="${sound.dynamics}"`);
   if (sound.dacapo) attrs.push('dacapo="yes"');
@@ -5102,7 +5142,7 @@ function serializeSound(sound, indent) {
     }
     lines.push(`${indent}  </swing>`);
     lines.push(`${indent}</sound>`);
-  } else if (attrs.length === 0) {
+  } else if (attrs.length === 0 && !sound._id) {
     lines.push(`${indent}<sound/>`);
   } else {
     lines.push(`${indent}<sound${attrStr}/>`);
@@ -5531,7 +5571,7 @@ function getMeasureEndPosition(measure) {
   return state.position;
 }
 
-// src/accessors/index.ts
+// src/query/index.ts
 function getNotesForVoice(measure, filter) {
   return measure.entries.filter((entry) => {
     if (entry.type !== "note") return false;
@@ -6272,17 +6312,17 @@ function getTiedNoteGroups(score, options) {
             measureIndex,
             position
           };
-          const hasTieStart = entry.tie?.type === "start" || entry.ties?.some((t) => t.type === "start") || entry.notations?.some((n) => n.type === "tied" && n.tiedType === "start");
-          const hasTieStop = entry.tie?.type === "stop" || entry.ties?.some((t) => t.type === "stop") || entry.notations?.some((n) => n.type === "tied" && n.tiedType === "stop");
-          if (hasTieStop && pendingTies.has(pitchKey)) {
+          const hasTieStart2 = entry.tie?.type === "start" || entry.ties?.some((t) => t.type === "start") || entry.notations?.some((n) => n.type === "tied" && n.tiedType === "start");
+          const hasTieStop2 = entry.tie?.type === "stop" || entry.ties?.some((t) => t.type === "stop") || entry.notations?.some((n) => n.type === "tied" && n.tiedType === "stop");
+          if (hasTieStop2 && pendingTies.has(pitchKey)) {
             const group = pendingTies.get(pitchKey);
             group.push(context);
-            if (!hasTieStart) {
+            if (!hasTieStart2) {
               const totalDuration = group.reduce((sum, nc) => sum + nc.note.duration, 0);
               results.push({ notes: group, totalDuration });
               pendingTies.delete(pitchKey);
             }
-          } else if (hasTieStart) {
+          } else if (hasTieStart2) {
             pendingTies.set(pitchKey, [context]);
           }
         }
@@ -6878,8 +6918,6 @@ function getPartCount(score) {
 function getPartIds(score) {
   return score.parts.map((part) => part.id);
 }
-
-// src/query/index.ts
 function getMeasure(score, options) {
   const part = score.parts[options.part];
   if (!part) return void 0;
@@ -6957,8 +6995,8 @@ function findNotes(score, filter) {
         if (filter.staff !== void 0 && (entry.staff ?? 1) !== filter.staff) continue;
         if (filter.noteType !== void 0 && entry.noteType !== filter.noteType) continue;
         if (filter.hasTie !== void 0) {
-          const hasTie = entry.tie !== void 0;
-          if (filter.hasTie !== hasTie) continue;
+          const hasTie2 = entry.tie !== void 0;
+          if (filter.hasTie !== hasTie2) continue;
         }
         results.push(entry);
       }
@@ -7710,6 +7748,97 @@ async function serializeToFile(score, filePath, options = {}) {
     await (0, import_promises.writeFile)(filePath, xmlString, "utf-8");
   }
 }
+
+// src/entry-accessors.ts
+function getDirectionOfKind(entry, kind) {
+  return entry.directionTypes.find((d) => d.kind === kind);
+}
+function getDirectionsOfKind(entry, kind) {
+  return entry.directionTypes.filter((d) => d.kind === kind);
+}
+function hasDirectionOfKind(entry, kind) {
+  return entry.directionTypes.some((d) => d.kind === kind);
+}
+function getSoundTempo(entry) {
+  return entry.sound?.tempo;
+}
+function getSoundDynamics(entry) {
+  return entry.sound?.dynamics;
+}
+function getSoundDamperPedal(entry) {
+  return entry.sound?.damperPedal;
+}
+function getSoundSoftPedal(entry) {
+  return entry.sound?.softPedal;
+}
+function getSoundSostenutoPedal(entry) {
+  return entry.sound?.sostenutoPedal;
+}
+function isRest(entry) {
+  return entry.rest !== void 0 || !entry.pitch && !entry.unpitched;
+}
+function isPitchedNote(entry) {
+  return entry.pitch !== void 0;
+}
+function isUnpitchedNote(entry) {
+  return entry.unpitched !== void 0;
+}
+function isChordNote(entry) {
+  return entry.chord === true;
+}
+function isGraceNote(entry) {
+  return entry.grace !== void 0;
+}
+function hasTie(entry) {
+  return entry.tie !== void 0 || entry.ties !== void 0 && entry.ties.length > 0;
+}
+function hasTieStart(entry) {
+  if (entry.tie?.type === "start") return true;
+  return entry.ties?.some((t) => t.type === "start") ?? false;
+}
+function hasTieStop(entry) {
+  if (entry.tie?.type === "stop") return true;
+  return entry.ties?.some((t) => t.type === "stop") ?? false;
+}
+function isCueNote(entry) {
+  return entry.cue === true;
+}
+function hasBeam(entry) {
+  return entry.beam !== void 0 && entry.beam.length > 0;
+}
+function hasLyrics(entry) {
+  return entry.lyrics !== void 0 && entry.lyrics.length > 0;
+}
+function hasNotations(entry) {
+  return entry.notations !== void 0 && entry.notations.length > 0;
+}
+function hasTuplet(entry) {
+  return entry.timeModification !== void 0;
+}
+function isPartInfo(entry) {
+  return entry.type === "score-part";
+}
+function getPartInfo(score, partId) {
+  return score.partList.find((entry) => {
+    return entry.type === "score-part" && entry.id === partId;
+  });
+}
+function getPartName(score, partId) {
+  return getPartInfo(score, partId)?.name;
+}
+function getPartAbbreviation(score, partId) {
+  return getPartInfo(score, partId)?.abbreviation;
+}
+function getAllPartInfos(score) {
+  return score.partList.filter(isPartInfo);
+}
+function getPartNameMap(score) {
+  const map = {};
+  for (const part of getAllPartInfos(score)) {
+    map[part.id] = part.name;
+  }
+  return map;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   STEPS,
@@ -7737,14 +7866,17 @@ async function serializeToFile(score, filePath, options = {}) {
   getAbsolutePosition,
   getAdjacentNotes,
   getAllNotes,
+  getAllPartInfos,
   getAttributesAtMeasure,
   getBeamGroups,
   getChordProgression,
   getChords,
   getClefChanges,
   getClefForStaff,
+  getDirectionOfKind,
   getDirections,
   getDirectionsAtPosition,
+  getDirectionsOfKind,
   getDivisions,
   getDuration,
   getDynamics,
@@ -7771,15 +7903,24 @@ async function serializeToFile(score, filePath, options = {}) {
   getNotesForVoice,
   getNotesInRange,
   getOctaveShifts,
+  getPartAbbreviation,
   getPartById,
   getPartByIndex,
   getPartCount,
   getPartIds,
   getPartIndex,
+  getPartInfo,
+  getPartName,
+  getPartNameMap,
   getPedalMarkings,
   getPrevNote,
   getRepeatStructure,
   getSlurSpans,
+  getSoundDamperPedal,
+  getSoundDynamics,
+  getSoundSoftPedal,
+  getSoundSostenutoPedal,
+  getSoundTempo,
   getStaffRange,
   getStaveCount,
   getStaves,
@@ -7797,12 +7938,27 @@ async function serializeToFile(score, filePath, options = {}) {
   getWedges,
   groupByStaff,
   groupByVoice,
+  hasBeam,
+  hasDirectionOfKind,
+  hasLyrics,
   hasMultipleStaves,
+  hasNotations,
   hasNotes,
+  hasTie,
+  hasTieStart,
+  hasTieStop,
+  hasTuplet,
   inferStaff,
   insertMeasure,
+  isChordNote,
   isCompressed,
+  isCueNote,
+  isGraceNote,
+  isPartInfo,
+  isPitchedNote,
+  isRest,
   isRestMeasure,
+  isUnpitchedNote,
   isValid,
   iterateEntries,
   iterateNotes,