musicxml-io 0.1.0

package/dist/operations/index.mjs

@@ -0,0 +1,315 @@
+// src/utils/index.ts
+var STEPS = ["C", "D", "E", "F", "G", "A", "B"];
+var STEP_SEMITONES = {
+  "C": 0,
+  "D": 2,
+  "E": 4,
+  "F": 5,
+  "G": 7,
+  "A": 9,
+  "B": 11
+};
+function createPositionState() {
+  return { position: 0, lastNonChordPosition: 0 };
+}
+function updatePositionForEntry(state, entry) {
+  const pos = state.position;
+  switch (entry.type) {
+    case "note": {
+      const note = entry;
+      if (!note.chord) {
+        state.lastNonChordPosition = state.position;
+        state.position += note.duration;
+      }
+      return note.chord ? state.lastNonChordPosition : pos;
+    }
+    case "backup":
+      state.position -= entry.duration;
+      state.lastNonChordPosition = state.position;
+      return pos;
+    case "forward":
+      state.position += entry.duration;
+      state.lastNonChordPosition = state.position;
+      return pos;
+    default:
+      return pos;
+  }
+}
+function getMeasureEndPosition(measure) {
+  const state = createPositionState();
+  for (const entry of measure.entries) updatePositionForEntry(state, entry);
+  return state.position;
+}
+
+// src/operations/index.ts
+function cloneScore(score) {
+  return JSON.parse(JSON.stringify(score));
+}
+function transposePitch(pitch, semitones) {
+  const currentSemitone = STEP_SEMITONES[pitch.step] + (pitch.alter ?? 0) + pitch.octave * 12;
+  const targetSemitone = currentSemitone + semitones;
+  const targetOctave = Math.floor(targetSemitone / 12);
+  const targetPitchClass = (targetSemitone % 12 + 12) % 12;
+  let bestStep = "C";
+  let bestAlter = 99;
+  for (const step of STEPS) {
+    const stepSemitone = STEP_SEMITONES[step];
+    let diff = targetPitchClass - stepSemitone;
+    if (diff > 6) diff -= 12;
+    if (diff < -6) diff += 12;
+    if (diff >= -2 && diff <= 2) {
+      if (Math.abs(diff) < Math.abs(bestAlter)) {
+        bestStep = step;
+        bestAlter = diff;
+      }
+    }
+  }
+  return {
+    step: bestStep,
+    octave: targetOctave,
+    alter: bestAlter !== 0 ? bestAlter : void 0
+  };
+}
+function transpose(score, semitones) {
+  if (semitones === 0) return score;
+  const result = cloneScore(score);
+  for (const part of result.parts) {
+    for (const measure of part.measures) {
+      for (const entry of measure.entries) {
+        if (entry.type === "note" && entry.pitch) {
+          entry.pitch = transposePitch(entry.pitch, semitones);
+        }
+      }
+    }
+  }
+  return result;
+}
+function addNote(score, options) {
+  const result = cloneScore(score);
+  const part = result.parts[options.partIndex];
+  if (!part) return result;
+  const measure = part.measures[options.measureIndex];
+  if (!measure) return result;
+  const newNote = {
+    type: "note",
+    voice: options.voice,
+    staff: options.staff,
+    ...options.note
+  };
+  const currentPosition = getMeasureEndPosition(measure);
+  const positionDiff = options.position - currentPosition;
+  if (positionDiff < 0) {
+    measure.entries.push({
+      type: "backup",
+      duration: -positionDiff
+    });
+  } else if (positionDiff > 0) {
+    measure.entries.push({
+      type: "forward",
+      duration: positionDiff,
+      voice: options.voice,
+      staff: options.staff
+    });
+  }
+  measure.entries.push(newNote);
+  return result;
+}
+function deleteNote(score, options) {
+  const result = cloneScore(score);
+  const part = result.parts[options.partIndex];
+  if (!part) return result;
+  const measure = part.measures[options.measureIndex];
+  if (!measure) return result;
+  let noteCount = 0;
+  let entryIndex = -1;
+  for (let i = 0; i < measure.entries.length; i++) {
+    if (measure.entries[i].type === "note") {
+      if (noteCount === options.noteIndex) {
+        entryIndex = i;
+        break;
+      }
+      noteCount++;
+    }
+  }
+  if (entryIndex !== -1) {
+    measure.entries.splice(entryIndex, 1);
+  }
+  return result;
+}
+function changeKey(score, key, options) {
+  const result = cloneScore(score);
+  const targetMeasure = String(options.fromMeasure);
+  for (const part of result.parts) {
+    for (const measure of part.measures) {
+      if (measure.number === targetMeasure) {
+        if (!measure.attributes) {
+          measure.attributes = {};
+        }
+        measure.attributes.key = key;
+      }
+    }
+  }
+  return result;
+}
+function changeTime(score, time, options) {
+  const result = cloneScore(score);
+  const targetMeasure = String(options.fromMeasure);
+  for (const part of result.parts) {
+    for (const measure of part.measures) {
+      if (measure.number === targetMeasure) {
+        if (!measure.attributes) {
+          measure.attributes = {};
+        }
+        measure.attributes.time = time;
+      }
+    }
+  }
+  return result;
+}
+function insertMeasure(score, options) {
+  const result = cloneScore(score);
+  const targetMeasure = String(options.afterMeasure);
+  for (const part of result.parts) {
+    const insertIndex = part.measures.findIndex((m) => m.number === targetMeasure);
+    if (insertIndex === -1) continue;
+    const numericPart = parseInt(targetMeasure, 10);
+    const newMeasureNumber = String(isNaN(numericPart) ? insertIndex + 2 : numericPart + 1);
+    const newMeasure = {
+      number: newMeasureNumber,
+      entries: []
+    };
+    if (options.copyAttributes) {
+      const sourceMeasure = part.measures[insertIndex];
+      if (sourceMeasure.attributes) {
+        newMeasure.attributes = { ...sourceMeasure.attributes };
+      }
+    }
+    part.measures.splice(insertIndex + 1, 0, newMeasure);
+    for (let i = insertIndex + 2; i < part.measures.length; i++) {
+      const currentNum = parseInt(part.measures[i].number, 10);
+      if (!isNaN(currentNum)) {
+        part.measures[i].number = String(currentNum + 1);
+      }
+    }
+  }
+  return result;
+}
+function deleteMeasure(score, measureNumber) {
+  const result = cloneScore(score);
+  const targetMeasure = String(measureNumber);
+  for (const part of result.parts) {
+    const deleteIndex = part.measures.findIndex((m) => m.number === targetMeasure);
+    if (deleteIndex === -1) continue;
+    part.measures.splice(deleteIndex, 1);
+    for (let i = deleteIndex; i < part.measures.length; i++) {
+      const currentNum = parseInt(part.measures[i].number, 10);
+      if (!isNaN(currentNum)) {
+        part.measures[i].number = String(currentNum - 1);
+      }
+    }
+  }
+  return result;
+}
+function setDivisions(score, options) {
+  const result = cloneScore(score);
+  const part = result.parts[options.partIndex];
+  if (!part) return result;
+  const measure = part.measures[options.measureIndex];
+  if (!measure) return result;
+  if (!measure.attributes) {
+    measure.attributes = {};
+  }
+  measure.attributes.divisions = options.divisions;
+  return result;
+}
+function addChordNote(score, options) {
+  const result = cloneScore(score);
+  const part = result.parts[options.partIndex];
+  if (!part) return result;
+  const measure = part.measures[options.measureIndex];
+  if (!measure) return result;
+  let noteCount = 0;
+  let entryIndex = -1;
+  let targetNote = null;
+  for (let i = 0; i < measure.entries.length; i++) {
+    const entry = measure.entries[i];
+    if (entry.type === "note") {
+      if (noteCount === options.afterNoteIndex) {
+        entryIndex = i;
+        targetNote = entry;
+        break;
+      }
+      noteCount++;
+    }
+  }
+  if (entryIndex !== -1 && targetNote) {
+    const chordNote = {
+      type: "note",
+      pitch: options.pitch,
+      duration: targetNote.duration,
+      voice: targetNote.voice,
+      staff: targetNote.staff,
+      chord: true,
+      noteType: targetNote.noteType,
+      dots: targetNote.dots
+    };
+    measure.entries.splice(entryIndex + 1, 0, chordNote);
+  }
+  return result;
+}
+function modifyNotePitch(score, options) {
+  const result = cloneScore(score);
+  const part = result.parts[options.partIndex];
+  if (!part) return result;
+  const measure = part.measures[options.measureIndex];
+  if (!measure) return result;
+  let noteCount = 0;
+  for (const entry of measure.entries) {
+    if (entry.type === "note") {
+      if (noteCount === options.noteIndex) {
+        entry.pitch = options.pitch;
+        break;
+      }
+      noteCount++;
+    }
+  }
+  return result;
+}
+function modifyNoteDuration(score, options) {
+  const result = cloneScore(score);
+  const part = result.parts[options.partIndex];
+  if (!part) return result;
+  const measure = part.measures[options.measureIndex];
+  if (!measure) return result;
+  let noteCount = 0;
+  for (const entry of measure.entries) {
+    if (entry.type === "note") {
+      if (noteCount === options.noteIndex) {
+        entry.duration = options.duration;
+        if (options.noteType !== void 0) {
+          entry.noteType = options.noteType;
+        }
+        if (options.dots !== void 0) {
+          entry.dots = options.dots;
+        }
+        break;
+      }
+      noteCount++;
+    }
+  }
+  return result;
+}
+export {
+  addChordNote,
+  addNote,
+  changeKey,
+  changeTime,
+  deleteMeasure,
+  deleteNote,
+  insertMeasure,
+  modifyNoteDuration,
+  modifyNotePitch,
+  setDivisions,
+  transpose
+};
+//# sourceMappingURL=index.mjs.map

package/dist/operations/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/index.ts","../../src/operations/index.ts"],"sourcesContent":["import type { Pitch, Measure, MeasureEntry, NoteEntry } from '../types';\n\n// Pitch constants\nexport const STEPS: Pitch['step'][] = ['C', 'D', 'E', 'F', 'G', 'A', 'B'];\nexport const STEP_SEMITONES: Record<Pitch['step'], number> = {\n  'C': 0, 'D': 2, 'E': 4, 'F': 5, 'G': 7, 'A': 9, 'B': 11,\n};\n\n/** Convert pitch to semitone value (MIDI-like) */\nexport function pitchToSemitone(pitch: Pitch): number {\n  return pitch.octave * 12 + STEP_SEMITONES[pitch.step] + (pitch.alter ?? 0);\n}\n\n// Position tracking for measure iteration\nexport interface PositionState {\n  position: number;\n  lastNonChordPosition: number;\n}\n\nexport function createPositionState(): PositionState {\n  return { position: 0, lastNonChordPosition: 0 };\n}\n\n/** Update position state for entry, returns position before update */\nexport function updatePositionForEntry(state: PositionState, entry: MeasureEntry): number {\n  const pos = state.position;\n  switch (entry.type) {\n    case 'note': {\n      const note = entry as NoteEntry;\n      if (!note.chord) {\n        state.lastNonChordPosition = state.position;\n        state.position += note.duration;\n      }\n      return note.chord ? state.lastNonChordPosition : pos;\n    }\n    case 'backup':\n      state.position -= entry.duration;\n      state.lastNonChordPosition = state.position;\n      return pos;\n    case 'forward':\n      state.position += entry.duration;\n      state.lastNonChordPosition = state.position;\n      return pos;\n    default:\n      return pos;\n  }\n}\n\n/** Get absolute position of a note within a measure */\nexport function getAbsolutePositionForNote(note: NoteEntry, measure: Measure): number {\n  const state = createPositionState();\n  for (const entry of measure.entries) {\n    if (entry === note) return entry.chord ? state.lastNonChordPosition : state.position;\n    updatePositionForEntry(state, entry);\n  }\n  return state.position;\n}\n\n/** Get position at end of measure */\nexport function getMeasureEndPosition(measure: Measure): number {\n  const state = createPositionState();\n  for (const entry of measure.entries) updatePositionForEntry(state, entry);\n  return state.position;\n}\n","import type {\n  Score,\n  Measure,\n  NoteEntry,\n  Pitch,\n  KeySignature,\n  TimeSignature,\n} from '../types';\nimport { STEPS, STEP_SEMITONES, getMeasureEndPosition } from '../utils';\n\n/**\n * Deep clone a score\n */\nfunction cloneScore(score: Score): Score {\n  return JSON.parse(JSON.stringify(score));\n}\n\n/**\n * Transpose a pitch by a number of semitones\n */\nfunction transposePitch(pitch: Pitch, semitones: number): Pitch {\n  const currentSemitone = STEP_SEMITONES[pitch.step] + (pitch.alter ?? 0) + pitch.octave * 12;\n  const targetSemitone = currentSemitone + semitones;\n\n  const targetOctave = Math.floor(targetSemitone / 12);\n  const targetPitchClass = ((targetSemitone % 12) + 12) % 12;\n\n  // Find the closest natural step with smallest alteration\n  let bestStep: Pitch['step'] = 'C';\n  let bestAlter = 99; // Start with large value so any real alter is smaller\n\n  for (const step of STEPS) {\n    const stepSemitone = STEP_SEMITONES[step];\n    // Calculate the alteration needed to reach target from this step\n    let diff = targetPitchClass - stepSemitone;\n\n    // Normalize to range -6 to +6 for smallest alteration\n    if (diff > 6) diff -= 12;\n    if (diff < -6) diff += 12;\n\n    // Only consider alterations within -2 to +2 (double flat to double sharp)\n    if (diff >= -2 && diff <= 2) {\n      if (Math.abs(diff) < Math.abs(bestAlter)) {\n        bestStep = step;\n        bestAlter = diff;\n      }\n    }\n  }\n\n  return {\n    step: bestStep,\n    octave: targetOctave,\n    alter: bestAlter !== 0 ? bestAlter : undefined,\n  };\n}\n\n/**\n * Transpose all notes in a score by a number of semitones\n */\nexport function transpose(score: Score, semitones: number): Score {\n  if (semitones === 0) return score;\n\n  const result = cloneScore(score);\n\n  for (const part of result.parts) {\n    for (const measure of part.measures) {\n      for (const entry of measure.entries) {\n        if (entry.type === 'note' && entry.pitch) {\n          entry.pitch = transposePitch(entry.pitch, semitones);\n        }\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Options for adding a note\n */\nexport interface AddNoteOptions {\n  partIndex: number;\n  measureIndex: number;\n  staff?: number;\n  voice: number;\n  position: number;\n  note: Omit<NoteEntry, 'type' | 'voice' | 'staff'>;\n}\n\n/**\n * Add a note to a measure\n * Automatically handles backup/forward insertion\n */\nexport function addNote(score: Score, options: AddNoteOptions): Score {\n  const result = cloneScore(score);\n  const part = result.parts[options.partIndex];\n  if (!part) return result;\n\n  const measure = part.measures[options.measureIndex];\n  if (!measure) return result;\n\n  const newNote: NoteEntry = {\n    type: 'note',\n    voice: options.voice,\n    staff: options.staff,\n    ...options.note,\n  };\n\n  // Find the current position at the end of the measure using shared utility\n  const currentPosition = getMeasureEndPosition(measure);\n\n  // Calculate backup/forward needed\n  const positionDiff = options.position - currentPosition;\n\n  if (positionDiff < 0) {\n    // Need to backup\n    measure.entries.push({\n      type: 'backup',\n      duration: -positionDiff,\n    });\n  } else if (positionDiff > 0) {\n    // Need to forward\n    measure.entries.push({\n      type: 'forward',\n      duration: positionDiff,\n      voice: options.voice,\n      staff: options.staff,\n    });\n  }\n\n  measure.entries.push(newNote);\n\n  return result;\n}\n\n/**\n * Delete a note from a measure\n */\nexport function deleteNote(score: Score, options: {\n  partIndex: number;\n  measureIndex: number;\n  noteIndex: number;\n}): Score {\n  const result = cloneScore(score);\n  const part = result.parts[options.partIndex];\n  if (!part) return result;\n\n  const measure = part.measures[options.measureIndex];\n  if (!measure) return result;\n\n  // Find the note by counting only notes\n  let noteCount = 0;\n  let entryIndex = -1;\n\n  for (let i = 0; i < measure.entries.length; i++) {\n    if (measure.entries[i].type === 'note') {\n      if (noteCount === options.noteIndex) {\n        entryIndex = i;\n        break;\n      }\n      noteCount++;\n    }\n  }\n\n  if (entryIndex !== -1) {\n    measure.entries.splice(entryIndex, 1);\n  }\n\n  return result;\n}\n\n/**\n * Change key signature from a specific measure\n */\nexport function changeKey(\n  score: Score,\n  key: KeySignature,\n  options: { fromMeasure: string | number }\n): Score {\n  const result = cloneScore(score);\n  const targetMeasure = String(options.fromMeasure);\n\n  for (const part of result.parts) {\n    for (const measure of part.measures) {\n      if (measure.number === targetMeasure) {\n        if (!measure.attributes) {\n          measure.attributes = {};\n        }\n        measure.attributes.key = key;\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Change time signature from a specific measure\n */\nexport function changeTime(\n  score: Score,\n  time: TimeSignature,\n  options: { fromMeasure: string | number }\n): Score {\n  const result = cloneScore(score);\n  const targetMeasure = String(options.fromMeasure);\n\n  for (const part of result.parts) {\n    for (const measure of part.measures) {\n      if (measure.number === targetMeasure) {\n        if (!measure.attributes) {\n          measure.attributes = {};\n        }\n        measure.attributes.time = time;\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Insert a new measure after a specific measure number\n */\nexport function insertMeasure(\n  score: Score,\n  options: {\n    afterMeasure: string | number;\n    copyAttributes?: boolean;\n  }\n): Score {\n  const result = cloneScore(score);\n  const targetMeasure = String(options.afterMeasure);\n\n  for (const part of result.parts) {\n    const insertIndex = part.measures.findIndex((m) => m.number === targetMeasure);\n    if (insertIndex === -1) continue;\n\n    // Parse target measure number and increment for new measure\n    const numericPart = parseInt(targetMeasure, 10);\n    const newMeasureNumber = String(isNaN(numericPart) ? insertIndex + 2 : numericPart + 1);\n\n    // Create new empty measure\n    const newMeasure: Measure = {\n      number: newMeasureNumber,\n      entries: [],\n    };\n\n    // Copy attributes if requested\n    if (options.copyAttributes) {\n      const sourceMeasure = part.measures[insertIndex];\n      if (sourceMeasure.attributes) {\n        newMeasure.attributes = { ...sourceMeasure.attributes };\n      }\n    }\n\n    // Insert the new measure\n    part.measures.splice(insertIndex + 1, 0, newMeasure);\n\n    // Update measure numbers for subsequent measures\n    for (let i = insertIndex + 2; i < part.measures.length; i++) {\n      const currentNum = parseInt(part.measures[i].number, 10);\n      if (!isNaN(currentNum)) {\n        part.measures[i].number = String(currentNum + 1);\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Delete a measure\n */\nexport function deleteMeasure(score: Score, measureNumber: string | number): Score {\n  const result = cloneScore(score);\n  const targetMeasure = String(measureNumber);\n\n  for (const part of result.parts) {\n    const deleteIndex = part.measures.findIndex((m) => m.number === targetMeasure);\n    if (deleteIndex === -1) continue;\n\n    // Remove the measure\n    part.measures.splice(deleteIndex, 1);\n\n    // Update measure numbers for subsequent measures\n    for (let i = deleteIndex; i < part.measures.length; i++) {\n      const currentNum = parseInt(part.measures[i].number, 10);\n      if (!isNaN(currentNum)) {\n        part.measures[i].number = String(currentNum - 1);\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Set divisions for a measure\n */\nexport function setDivisions(\n  score: Score,\n  options: {\n    partIndex: number;\n    measureIndex: number;\n    divisions: number;\n  }\n): Score {\n  const result = cloneScore(score);\n  const part = result.parts[options.partIndex];\n  if (!part) return result;\n\n  const measure = part.measures[options.measureIndex];\n  if (!measure) return result;\n\n  if (!measure.attributes) {\n    measure.attributes = {};\n  }\n  measure.attributes.divisions = options.divisions;\n\n  return result;\n}\n\n/**\n * Add a chord note (note that sounds simultaneously with the previous note)\n */\nexport function addChordNote(\n  score: Score,\n  options: {\n    partIndex: number;\n    measureIndex: number;\n    afterNoteIndex: number;\n    pitch: Pitch;\n  }\n): Score {\n  const result = cloneScore(score);\n  const part = result.parts[options.partIndex];\n  if (!part) return result;\n\n  const measure = part.measures[options.measureIndex];\n  if (!measure) return result;\n\n  // Find the note by counting only notes\n  let noteCount = 0;\n  let entryIndex = -1;\n  let targetNote: NoteEntry | null = null;\n\n  for (let i = 0; i < measure.entries.length; i++) {\n    const entry = measure.entries[i];\n    if (entry.type === 'note') {\n      if (noteCount === options.afterNoteIndex) {\n        entryIndex = i;\n        targetNote = entry;\n        break;\n      }\n      noteCount++;\n    }\n  }\n\n  if (entryIndex !== -1 && targetNote) {\n    const chordNote: NoteEntry = {\n      type: 'note',\n      pitch: options.pitch,\n      duration: targetNote.duration,\n      voice: targetNote.voice,\n      staff: targetNote.staff,\n      chord: true,\n      noteType: targetNote.noteType,\n      dots: targetNote.dots,\n    };\n\n    measure.entries.splice(entryIndex + 1, 0, chordNote);\n  }\n\n  return result;\n}\n\n/**\n * Modify a note's pitch\n */\nexport function modifyNotePitch(\n  score: Score,\n  options: {\n    partIndex: number;\n    measureIndex: number;\n    noteIndex: number;\n    pitch: Pitch;\n  }\n): Score {\n  const result = cloneScore(score);\n  const part = result.parts[options.partIndex];\n  if (!part) return result;\n\n  const measure = part.measures[options.measureIndex];\n  if (!measure) return result;\n\n  // Find the note by counting only notes\n  let noteCount = 0;\n\n  for (const entry of measure.entries) {\n    if (entry.type === 'note') {\n      if (noteCount === options.noteIndex) {\n        entry.pitch = options.pitch;\n        break;\n      }\n      noteCount++;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Modify a note's duration\n */\nexport function modifyNoteDuration(\n  score: Score,\n  options: {\n    partIndex: number;\n    measureIndex: number;\n    noteIndex: number;\n    duration: number;\n    noteType?: NoteEntry['noteType'];\n    dots?: number;\n  }\n): Score {\n  const result = cloneScore(score);\n  const part = result.parts[options.partIndex];\n  if (!part) return result;\n\n  const measure = part.measures[options.measureIndex];\n  if (!measure) return result;\n\n  // Find the note by counting only notes\n  let noteCount = 0;\n\n  for (const entry of measure.entries) {\n    if (entry.type === 'note') {\n      if (noteCount === options.noteIndex) {\n        entry.duration = options.duration;\n        if (options.noteType !== undefined) {\n          entry.noteType = options.noteType;\n        }\n        if (options.dots !== undefined) {\n          entry.dots = options.dots;\n        }\n        break;\n      }\n      noteCount++;\n    }\n  }\n\n  return result;\n}\n"],"mappings":"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","names":[]}

package/dist/query/index.d.mts

@@ -0,0 +1,103 @@
+import { S as Score, M as Measure, f as MeasureAttributes, a as Pitch, N as NoteEntry, P as Part } from '../types-DC_TnJu_.mjs';
+
+/**
+ * Get a specific measure from the score
+ */
+declare function getMeasure(score: Score, options: {
+    part: number;
+    measure: string | number;
+}): Measure | undefined;
+/**
+ * Get measure by index
+ */
+declare function getMeasureByIndex(score: Score, options: {
+    part: number;
+    measureIndex: number;
+}): Measure | undefined;
+/**
+ * Get the total number of measures in a score
+ */
+declare function getMeasureCount(score: Score): number;
+/**
+ * Get the divisions value at a specific measure
+ * Searches backwards from the specified measure to find the most recent divisions
+ */
+declare function getDivisions(score: Score, options: {
+    part: number;
+    measure: string | number;
+}): number;
+/**
+ * Get the current attributes at a specific measure
+ * Merges all attribute changes from measure 1 to the specified measure
+ */
+declare function getAttributesAtMeasure(score: Score, options: {
+    part: number;
+    measure: string | number;
+}): MeasureAttributes;
+/**
+ * Pitch range filter
+ */
+interface PitchRange {
+    min?: Pitch;
+    max?: Pitch;
+}
+/**
+ * Find notes filter
+ */
+interface FindNotesFilter {
+    pitchRange?: PitchRange;
+    voice?: number;
+    staff?: number;
+    noteType?: string;
+    hasTie?: boolean;
+}
+/**
+ * Find notes matching specific criteria
+ */
+declare function findNotes(score: Score, filter: FindNotesFilter): NoteEntry[];
+/**
+ * Get the total duration of the score in divisions
+ */
+declare function getDuration(score: Score): number;
+/**
+ * Get part by ID
+ */
+declare function getPartById(score: Score, id: string): Part | undefined;
+/**
+ * Get part index by ID
+ */
+declare function getPartIndex(score: Score, id: string): number;
+/**
+ * Check if the score has multiple staves (e.g., piano grand staff)
+ */
+declare function hasMultipleStaves(score: Score, partIndex?: number): boolean;
+/**
+ * Get the number of staves for a part
+ */
+declare function getStaveCount(score: Score, partIndex?: number): number;
+/**
+ * Round-trip metrics for measuring preservation fidelity
+ */
+interface RoundtripMetrics {
+    notesOriginal: number;
+    notesPreserved: number;
+    measuresOriginal: number;
+    measuresPreserved: number;
+    partsOriginal: number;
+    partsPreserved: number;
+    preservationRate: number;
+}
+/**
+ * Compare two scores and calculate round-trip preservation metrics
+ */
+declare function measureRoundtrip(original: Score, exported: Score): RoundtripMetrics;
+/**
+ * Count total notes in a score
+ */
+declare function countNotes(score: Score): number;
+/**
+ * Compare two scores for structural equality
+ */
+declare function scoresEqual(a: Score, b: Score): boolean;
+
+export { type FindNotesFilter, type PitchRange, type RoundtripMetrics, countNotes, findNotes, getAttributesAtMeasure, getDivisions, getDuration, getMeasure, getMeasureByIndex, getMeasureCount, getPartById, getPartIndex, getStaveCount, hasMultipleStaves, measureRoundtrip, scoresEqual };

package/dist/query/index.d.ts

@@ -0,0 +1,103 @@
+import { S as Score, M as Measure, f as MeasureAttributes, a as Pitch, N as NoteEntry, P as Part } from '../types-DC_TnJu_.js';
+
+/**
+ * Get a specific measure from the score
+ */
+declare function getMeasure(score: Score, options: {
+    part: number;
+    measure: string | number;
+}): Measure | undefined;
+/**
+ * Get measure by index
+ */
+declare function getMeasureByIndex(score: Score, options: {
+    part: number;
+    measureIndex: number;
+}): Measure | undefined;
+/**
+ * Get the total number of measures in a score
+ */
+declare function getMeasureCount(score: Score): number;
+/**
+ * Get the divisions value at a specific measure
+ * Searches backwards from the specified measure to find the most recent divisions
+ */
+declare function getDivisions(score: Score, options: {
+    part: number;
+    measure: string | number;
+}): number;
+/**
+ * Get the current attributes at a specific measure
+ * Merges all attribute changes from measure 1 to the specified measure
+ */
+declare function getAttributesAtMeasure(score: Score, options: {
+    part: number;
+    measure: string | number;
+}): MeasureAttributes;
+/**
+ * Pitch range filter
+ */
+interface PitchRange {
+    min?: Pitch;
+    max?: Pitch;
+}
+/**
+ * Find notes filter
+ */
+interface FindNotesFilter {
+    pitchRange?: PitchRange;
+    voice?: number;
+    staff?: number;
+    noteType?: string;
+    hasTie?: boolean;
+}
+/**
+ * Find notes matching specific criteria
+ */
+declare function findNotes(score: Score, filter: FindNotesFilter): NoteEntry[];
+/**
+ * Get the total duration of the score in divisions
+ */
+declare function getDuration(score: Score): number;
+/**
+ * Get part by ID
+ */
+declare function getPartById(score: Score, id: string): Part | undefined;
+/**
+ * Get part index by ID
+ */
+declare function getPartIndex(score: Score, id: string): number;
+/**
+ * Check if the score has multiple staves (e.g., piano grand staff)
+ */
+declare function hasMultipleStaves(score: Score, partIndex?: number): boolean;
+/**
+ * Get the number of staves for a part
+ */
+declare function getStaveCount(score: Score, partIndex?: number): number;
+/**
+ * Round-trip metrics for measuring preservation fidelity
+ */
+interface RoundtripMetrics {
+    notesOriginal: number;
+    notesPreserved: number;
+    measuresOriginal: number;
+    measuresPreserved: number;
+    partsOriginal: number;
+    partsPreserved: number;
+    preservationRate: number;
+}
+/**
+ * Compare two scores and calculate round-trip preservation metrics
+ */
+declare function measureRoundtrip(original: Score, exported: Score): RoundtripMetrics;
+/**
+ * Count total notes in a score
+ */
+declare function countNotes(score: Score): number;
+/**
+ * Compare two scores for structural equality
+ */
+declare function scoresEqual(a: Score, b: Score): boolean;
+
+export { type FindNotesFilter, type PitchRange, type RoundtripMetrics, countNotes, findNotes, getAttributesAtMeasure, getDivisions, getDuration, getMeasure, getMeasureByIndex, getMeasureCount, getPartById, getPartIndex, getStaveCount, hasMultipleStaves, measureRoundtrip, scoresEqual };