musicxml-io 0.1.0

package/dist/query/index.js

@@ -0,0 +1,272 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/query/index.ts
+var query_exports = {};
+__export(query_exports, {
+  countNotes: () => countNotes,
+  findNotes: () => findNotes,
+  getAttributesAtMeasure: () => getAttributesAtMeasure,
+  getDivisions: () => getDivisions,
+  getDuration: () => getDuration,
+  getMeasure: () => getMeasure,
+  getMeasureByIndex: () => getMeasureByIndex,
+  getMeasureCount: () => getMeasureCount,
+  getPartById: () => getPartById,
+  getPartIndex: () => getPartIndex,
+  getStaveCount: () => getStaveCount,
+  hasMultipleStaves: () => hasMultipleStaves,
+  measureRoundtrip: () => measureRoundtrip,
+  scoresEqual: () => scoresEqual
+});
+module.exports = __toCommonJS(query_exports);
+
+// src/utils/index.ts
+var STEP_SEMITONES = {
+  "C": 0,
+  "D": 2,
+  "E": 4,
+  "F": 5,
+  "G": 7,
+  "A": 9,
+  "B": 11
+};
+function pitchToSemitone(pitch) {
+  return pitch.octave * 12 + STEP_SEMITONES[pitch.step] + (pitch.alter ?? 0);
+}
+
+// src/query/index.ts
+function getMeasure(score, options) {
+  const part = score.parts[options.part];
+  if (!part) return void 0;
+  const targetMeasure = String(options.measure);
+  return part.measures.find((m) => m.number === targetMeasure);
+}
+function getMeasureByIndex(score, options) {
+  const part = score.parts[options.part];
+  if (!part) return void 0;
+  return part.measures[options.measureIndex];
+}
+function getMeasureCount(score) {
+  if (score.parts.length === 0) return 0;
+  return score.parts[0].measures.length;
+}
+function getDivisions(score, options) {
+  const part = score.parts[options.part];
+  if (!part) return 1;
+  const targetMeasure = parseInt(String(options.measure), 10);
+  if (isNaN(targetMeasure)) return 1;
+  for (let i = 0; i < part.measures.length; i++) {
+    const m = part.measures[i];
+    const mNum = parseInt(m.number, 10);
+    if (!isNaN(mNum) && mNum > targetMeasure) break;
+    if (m.attributes?.divisions !== void 0) {
+    }
+  }
+  let divisions = 1;
+  for (const m of part.measures) {
+    const mNum = parseInt(m.number, 10);
+    if (!isNaN(mNum) && mNum > targetMeasure) break;
+    if (m.attributes?.divisions !== void 0) {
+      divisions = m.attributes.divisions;
+    }
+  }
+  return divisions;
+}
+function getAttributesAtMeasure(score, options) {
+  const part = score.parts[options.part];
+  if (!part) return {};
+  const targetMeasure = parseInt(String(options.measure), 10);
+  const result = {};
+  for (const m of part.measures) {
+    const mNum = parseInt(m.number, 10);
+    if (!isNaN(targetMeasure) && !isNaN(mNum) && mNum > targetMeasure) break;
+    if (m.attributes) {
+      if (m.attributes.divisions !== void 0) result.divisions = m.attributes.divisions;
+      if (m.attributes.time !== void 0) result.time = m.attributes.time;
+      if (m.attributes.key !== void 0) result.key = m.attributes.key;
+      if (m.attributes.clef !== void 0) result.clef = m.attributes.clef;
+      if (m.attributes.staves !== void 0) result.staves = m.attributes.staves;
+      if (m.attributes.transpose !== void 0) result.transpose = m.attributes.transpose;
+    }
+  }
+  return result;
+}
+function findNotes(score, filter) {
+  const results = [];
+  for (const part of score.parts) {
+    for (const measure of part.measures) {
+      for (const entry of measure.entries) {
+        if (entry.type !== "note") continue;
+        if (filter.pitchRange && entry.pitch) {
+          const noteValue = pitchToSemitone(entry.pitch);
+          if (filter.pitchRange.min) {
+            const minValue = pitchToSemitone(filter.pitchRange.min);
+            if (noteValue < minValue) continue;
+          }
+          if (filter.pitchRange.max) {
+            const maxValue = pitchToSemitone(filter.pitchRange.max);
+            if (noteValue > maxValue) continue;
+          }
+        }
+        if (filter.voice !== void 0 && entry.voice !== filter.voice) continue;
+        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;
+        }
+        results.push(entry);
+      }
+    }
+  }
+  return results;
+}
+function getDuration(score) {
+  if (score.parts.length === 0) return 0;
+  const part = score.parts[0];
+  let totalDuration = 0;
+  let divisions = 1;
+  for (const measure of part.measures) {
+    if (measure.attributes?.divisions !== void 0) {
+      divisions = measure.attributes.divisions;
+    }
+    let measureDuration = 0;
+    for (const entry of measure.entries) {
+      if (entry.type === "note" && !entry.chord) {
+        measureDuration = Math.max(measureDuration, entry.duration);
+      }
+    }
+    const attrs = getAttributesAtMeasure(score, { part: 0, measure: measure.number });
+    if (attrs.time) {
+      const beats = parseInt(attrs.time.beats, 10) || 4;
+      const expectedDuration = beats / attrs.time.beatType * 4 * divisions;
+      measureDuration = Math.max(measureDuration, expectedDuration);
+    }
+    totalDuration += measureDuration;
+  }
+  return totalDuration;
+}
+function getPartById(score, id) {
+  return score.parts.find((p) => p.id === id);
+}
+function getPartIndex(score, id) {
+  return score.parts.findIndex((p) => p.id === id);
+}
+function hasMultipleStaves(score, partIndex = 0) {
+  const part = score.parts[partIndex];
+  if (!part) return false;
+  for (const measure of part.measures) {
+    if (measure.attributes?.staves !== void 0 && measure.attributes.staves > 1) {
+      return true;
+    }
+  }
+  return false;
+}
+function getStaveCount(score, partIndex = 0) {
+  const part = score.parts[partIndex];
+  if (!part) return 1;
+  for (const measure of part.measures) {
+    if (measure.attributes?.staves !== void 0) {
+      return measure.attributes.staves;
+    }
+  }
+  return 1;
+}
+function measureRoundtrip(original, exported) {
+  const notesOriginal = countNotes(original);
+  const notesExported = countNotes(exported);
+  const notesPreserved = Math.min(notesOriginal, notesExported);
+  const measuresOriginal = getMeasureCount(original);
+  const measuresExported = getMeasureCount(exported);
+  const measuresPreserved = Math.min(measuresOriginal, measuresExported);
+  const partsOriginal = original.parts.length;
+  const partsExported = exported.parts.length;
+  const partsPreserved = Math.min(partsOriginal, partsExported);
+  const preservationRate = notesOriginal > 0 ? notesPreserved / notesOriginal : 1;
+  return {
+    notesOriginal,
+    notesPreserved,
+    measuresOriginal,
+    measuresPreserved,
+    partsOriginal,
+    partsPreserved,
+    preservationRate
+  };
+}
+function countNotes(score) {
+  let count = 0;
+  for (const part of score.parts) {
+    for (const measure of part.measures) {
+      for (const entry of measure.entries) {
+        if (entry.type === "note") {
+          count++;
+        }
+      }
+    }
+  }
+  return count;
+}
+function scoresEqual(a, b) {
+  if (a.parts.length !== b.parts.length) return false;
+  for (let i = 0; i < a.parts.length; i++) {
+    const partA = a.parts[i];
+    const partB = b.parts[i];
+    if (partA.measures.length !== partB.measures.length) return false;
+    for (let j = 0; j < partA.measures.length; j++) {
+      const measureA = partA.measures[j];
+      const measureB = partB.measures[j];
+      if (measureA.number !== measureB.number) return false;
+      const notesA = measureA.entries.filter((e) => e.type === "note");
+      const notesB = measureB.entries.filter((e) => e.type === "note");
+      if (notesA.length !== notesB.length) return false;
+      for (let k = 0; k < notesA.length; k++) {
+        const noteA = notesA[k];
+        const noteB = notesB[k];
+        if (!pitchesEqual(noteA.pitch, noteB.pitch)) return false;
+        if (noteA.duration !== noteB.duration) return false;
+        if (noteA.voice !== noteB.voice) return false;
+      }
+    }
+  }
+  return true;
+}
+function pitchesEqual(a, b) {
+  if (a === void 0 && b === void 0) return true;
+  if (a === void 0 || b === void 0) return false;
+  return a.step === b.step && a.octave === b.octave && (a.alter ?? 0) === (b.alter ?? 0);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  countNotes,
+  findNotes,
+  getAttributesAtMeasure,
+  getDivisions,
+  getDuration,
+  getMeasure,
+  getMeasureByIndex,
+  getMeasureCount,
+  getPartById,
+  getPartIndex,
+  getStaveCount,
+  hasMultipleStaves,
+  measureRoundtrip,
+  scoresEqual
+});
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/query/index.ts","../../src/utils/index.ts"],"sourcesContent":["import type {\n  Score,\n  Part,\n  Measure,\n  MeasureAttributes,\n  NoteEntry,\n  Pitch,\n} from '../types';\nimport { pitchToSemitone } from '../utils';\n\n/**\n * Get a specific measure from the score\n */\nexport function getMeasure(score: Score, options: { part: number; measure: string | number }): Measure | undefined {\n  const part = score.parts[options.part];\n  if (!part) return undefined;\n  const targetMeasure = String(options.measure);\n\n  return part.measures.find((m) => m.number === targetMeasure);\n}\n\n/**\n * Get measure by index\n */\nexport function getMeasureByIndex(score: Score, options: { part: number; measureIndex: number }): Measure | undefined {\n  const part = score.parts[options.part];\n  if (!part) return undefined;\n\n  return part.measures[options.measureIndex];\n}\n\n/**\n * Get the total number of measures in a score\n */\nexport function getMeasureCount(score: Score): number {\n  if (score.parts.length === 0) return 0;\n  return score.parts[0].measures.length;\n}\n\n/**\n * Get the divisions value at a specific measure\n * Searches backwards from the specified measure to find the most recent divisions\n */\nexport function getDivisions(score: Score, options: { part: number; measure: string | number }): number {\n  const part = score.parts[options.part];\n  if (!part) return 1;\n  const targetMeasure = parseInt(String(options.measure), 10);\n  if (isNaN(targetMeasure)) return 1;\n\n  for (let i = 0; i < part.measures.length; i++) {\n    const m = part.measures[i];\n    const mNum = parseInt(m.number, 10);\n    if (!isNaN(mNum) && mNum > targetMeasure) break;\n\n    if (m.attributes?.divisions !== undefined) {\n      // Continue searching for a more recent value\n    }\n  }\n\n  // Search from the beginning up to the specified measure\n  let divisions = 1;\n  for (const m of part.measures) {\n    const mNum = parseInt(m.number, 10);\n    if (!isNaN(mNum) && mNum > targetMeasure) break;\n    if (m.attributes?.divisions !== undefined) {\n      divisions = m.attributes.divisions;\n    }\n  }\n\n  return divisions;\n}\n\n/**\n * Get the current attributes at a specific measure\n * Merges all attribute changes from measure 1 to the specified measure\n */\nexport function getAttributesAtMeasure(score: Score, options: { part: number; measure: string | number }): MeasureAttributes {\n  const part = score.parts[options.part];\n  if (!part) return {};\n  const targetMeasure = parseInt(String(options.measure), 10);\n\n  const result: MeasureAttributes = {};\n\n  for (const m of part.measures) {\n    const mNum = parseInt(m.number, 10);\n    if (!isNaN(targetMeasure) && !isNaN(mNum) && mNum > targetMeasure) break;\n\n    if (m.attributes) {\n      if (m.attributes.divisions !== undefined) result.divisions = m.attributes.divisions;\n      if (m.attributes.time !== undefined) result.time = m.attributes.time;\n      if (m.attributes.key !== undefined) result.key = m.attributes.key;\n      if (m.attributes.clef !== undefined) result.clef = m.attributes.clef;\n      if (m.attributes.staves !== undefined) result.staves = m.attributes.staves;\n      if (m.attributes.transpose !== undefined) result.transpose = m.attributes.transpose;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Pitch range filter\n */\nexport interface PitchRange {\n  min?: Pitch;\n  max?: Pitch;\n}\n\n/**\n * Find notes filter\n */\nexport interface FindNotesFilter {\n  pitchRange?: PitchRange;\n  voice?: number;\n  staff?: number;\n  noteType?: string;\n  hasTie?: boolean;\n}\n\n/**\n * Find notes matching specific criteria\n */\nexport function findNotes(score: Score, filter: FindNotesFilter): NoteEntry[] {\n  const results: NoteEntry[] = [];\n\n  for (const part of score.parts) {\n    for (const measure of part.measures) {\n      for (const entry of measure.entries) {\n        if (entry.type !== 'note') continue;\n\n        // Filter by pitch range\n        if (filter.pitchRange && entry.pitch) {\n          const noteValue = pitchToSemitone(entry.pitch);\n\n          if (filter.pitchRange.min) {\n            const minValue = pitchToSemitone(filter.pitchRange.min);\n            if (noteValue < minValue) continue;\n          }\n\n          if (filter.pitchRange.max) {\n            const maxValue = pitchToSemitone(filter.pitchRange.max);\n            if (noteValue > maxValue) continue;\n          }\n        }\n\n        // Filter by voice\n        if (filter.voice !== undefined && entry.voice !== filter.voice) continue;\n\n        // Filter by staff\n        if (filter.staff !== undefined && (entry.staff ?? 1) !== filter.staff) continue;\n\n        // Filter by note type\n        if (filter.noteType !== undefined && entry.noteType !== filter.noteType) continue;\n\n        // Filter by tie\n        if (filter.hasTie !== undefined) {\n          const hasTie = entry.tie !== undefined;\n          if (filter.hasTie !== hasTie) continue;\n        }\n\n        results.push(entry);\n      }\n    }\n  }\n\n  return results;\n}\n\n/**\n * Get the total duration of the score in divisions\n */\nexport function getDuration(score: Score): number {\n  if (score.parts.length === 0) return 0;\n\n  const part = score.parts[0];\n  let totalDuration = 0;\n  let divisions = 1;\n\n  for (const measure of part.measures) {\n    if (measure.attributes?.divisions !== undefined) {\n      divisions = measure.attributes.divisions;\n    }\n\n    // Calculate measure duration based on time signature or actual notes\n    let measureDuration = 0;\n\n    for (const entry of measure.entries) {\n      if (entry.type === 'note' && !entry.chord) {\n        measureDuration = Math.max(measureDuration, entry.duration);\n      }\n    }\n\n    // Use time signature to calculate expected duration if available\n    const attrs = getAttributesAtMeasure(score, { part: 0, measure: measure.number });\n    if (attrs.time) {\n      const beats = parseInt(attrs.time.beats, 10) || 4;\n      const expectedDuration = (beats / attrs.time.beatType) * 4 * divisions;\n      measureDuration = Math.max(measureDuration, expectedDuration);\n    }\n\n    totalDuration += measureDuration;\n  }\n\n  return totalDuration;\n}\n\n/**\n * Get part by ID\n */\nexport function getPartById(score: Score, id: string): Part | undefined {\n  return score.parts.find((p) => p.id === id);\n}\n\n/**\n * Get part index by ID\n */\nexport function getPartIndex(score: Score, id: string): number {\n  return score.parts.findIndex((p) => p.id === id);\n}\n\n/**\n * Check if the score has multiple staves (e.g., piano grand staff)\n */\nexport function hasMultipleStaves(score: Score, partIndex: number = 0): boolean {\n  const part = score.parts[partIndex];\n  if (!part) return false;\n\n  for (const measure of part.measures) {\n    if (measure.attributes?.staves !== undefined && measure.attributes.staves > 1) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Get the number of staves for a part\n */\nexport function getStaveCount(score: Score, partIndex: number = 0): number {\n  const part = score.parts[partIndex];\n  if (!part) return 1;\n\n  for (const measure of part.measures) {\n    if (measure.attributes?.staves !== undefined) {\n      return measure.attributes.staves;\n    }\n  }\n\n  return 1;\n}\n\n/**\n * Round-trip metrics for measuring preservation fidelity\n */\nexport interface RoundtripMetrics {\n  notesOriginal: number;\n  notesPreserved: number;\n  measuresOriginal: number;\n  measuresPreserved: number;\n  partsOriginal: number;\n  partsPreserved: number;\n  preservationRate: number;\n}\n\n/**\n * Compare two scores and calculate round-trip preservation metrics\n */\nexport function measureRoundtrip(original: Score, exported: Score): RoundtripMetrics {\n  const notesOriginal = countNotes(original);\n  const notesExported = countNotes(exported);\n  const notesPreserved = Math.min(notesOriginal, notesExported);\n\n  const measuresOriginal = getMeasureCount(original);\n  const measuresExported = getMeasureCount(exported);\n  const measuresPreserved = Math.min(measuresOriginal, measuresExported);\n\n  const partsOriginal = original.parts.length;\n  const partsExported = exported.parts.length;\n  const partsPreserved = Math.min(partsOriginal, partsExported);\n\n  // Calculate preservation rate based on notes (most granular)\n  const preservationRate = notesOriginal > 0\n    ? notesPreserved / notesOriginal\n    : 1;\n\n  return {\n    notesOriginal,\n    notesPreserved,\n    measuresOriginal,\n    measuresPreserved,\n    partsOriginal,\n    partsPreserved,\n    preservationRate,\n  };\n}\n\n/**\n * Count total notes in a score\n */\nexport function countNotes(score: Score): number {\n  let count = 0;\n\n  for (const part of score.parts) {\n    for (const measure of part.measures) {\n      for (const entry of measure.entries) {\n        if (entry.type === 'note') {\n          count++;\n        }\n      }\n    }\n  }\n\n  return count;\n}\n\n/**\n * Compare two scores for structural equality\n */\nexport function scoresEqual(a: Score, b: Score): boolean {\n  // Check parts count\n  if (a.parts.length !== b.parts.length) return false;\n\n  for (let i = 0; i < a.parts.length; i++) {\n    const partA = a.parts[i];\n    const partB = b.parts[i];\n\n    if (partA.measures.length !== partB.measures.length) return false;\n\n    for (let j = 0; j < partA.measures.length; j++) {\n      const measureA = partA.measures[j];\n      const measureB = partB.measures[j];\n\n      if (measureA.number !== measureB.number) return false;\n\n      // Compare entries count\n      const notesA = measureA.entries.filter(e => e.type === 'note');\n      const notesB = measureB.entries.filter(e => e.type === 'note');\n\n      if (notesA.length !== notesB.length) return false;\n\n      // Compare each note\n      for (let k = 0; k < notesA.length; k++) {\n        const noteA = notesA[k] as NoteEntry;\n        const noteB = notesB[k] as NoteEntry;\n\n        if (!pitchesEqual(noteA.pitch, noteB.pitch)) return false;\n        if (noteA.duration !== noteB.duration) return false;\n        if (noteA.voice !== noteB.voice) return false;\n      }\n    }\n  }\n\n  return true;\n}\n\n/**\n * Compare two pitches for equality\n */\nfunction pitchesEqual(a: Pitch | undefined, b: Pitch | undefined): boolean {\n  if (a === undefined && b === undefined) return true;\n  if (a === undefined || b === undefined) return false;\n  return a.step === b.step && a.octave === b.octave && (a.alter ?? 0) === (b.alter ?? 0);\n}\n","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"],"mappings":"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","names":[]}

package/dist/query/index.mjs

@@ -0,0 +1,232 @@
+// src/utils/index.ts
+var STEP_SEMITONES = {
+  "C": 0,
+  "D": 2,
+  "E": 4,
+  "F": 5,
+  "G": 7,
+  "A": 9,
+  "B": 11
+};
+function pitchToSemitone(pitch) {
+  return pitch.octave * 12 + STEP_SEMITONES[pitch.step] + (pitch.alter ?? 0);
+}
+
+// src/query/index.ts
+function getMeasure(score, options) {
+  const part = score.parts[options.part];
+  if (!part) return void 0;
+  const targetMeasure = String(options.measure);
+  return part.measures.find((m) => m.number === targetMeasure);
+}
+function getMeasureByIndex(score, options) {
+  const part = score.parts[options.part];
+  if (!part) return void 0;
+  return part.measures[options.measureIndex];
+}
+function getMeasureCount(score) {
+  if (score.parts.length === 0) return 0;
+  return score.parts[0].measures.length;
+}
+function getDivisions(score, options) {
+  const part = score.parts[options.part];
+  if (!part) return 1;
+  const targetMeasure = parseInt(String(options.measure), 10);
+  if (isNaN(targetMeasure)) return 1;
+  for (let i = 0; i < part.measures.length; i++) {
+    const m = part.measures[i];
+    const mNum = parseInt(m.number, 10);
+    if (!isNaN(mNum) && mNum > targetMeasure) break;
+    if (m.attributes?.divisions !== void 0) {
+    }
+  }
+  let divisions = 1;
+  for (const m of part.measures) {
+    const mNum = parseInt(m.number, 10);
+    if (!isNaN(mNum) && mNum > targetMeasure) break;
+    if (m.attributes?.divisions !== void 0) {
+      divisions = m.attributes.divisions;
+    }
+  }
+  return divisions;
+}
+function getAttributesAtMeasure(score, options) {
+  const part = score.parts[options.part];
+  if (!part) return {};
+  const targetMeasure = parseInt(String(options.measure), 10);
+  const result = {};
+  for (const m of part.measures) {
+    const mNum = parseInt(m.number, 10);
+    if (!isNaN(targetMeasure) && !isNaN(mNum) && mNum > targetMeasure) break;
+    if (m.attributes) {
+      if (m.attributes.divisions !== void 0) result.divisions = m.attributes.divisions;
+      if (m.attributes.time !== void 0) result.time = m.attributes.time;
+      if (m.attributes.key !== void 0) result.key = m.attributes.key;
+      if (m.attributes.clef !== void 0) result.clef = m.attributes.clef;
+      if (m.attributes.staves !== void 0) result.staves = m.attributes.staves;
+      if (m.attributes.transpose !== void 0) result.transpose = m.attributes.transpose;
+    }
+  }
+  return result;
+}
+function findNotes(score, filter) {
+  const results = [];
+  for (const part of score.parts) {
+    for (const measure of part.measures) {
+      for (const entry of measure.entries) {
+        if (entry.type !== "note") continue;
+        if (filter.pitchRange && entry.pitch) {
+          const noteValue = pitchToSemitone(entry.pitch);
+          if (filter.pitchRange.min) {
+            const minValue = pitchToSemitone(filter.pitchRange.min);
+            if (noteValue < minValue) continue;
+          }
+          if (filter.pitchRange.max) {
+            const maxValue = pitchToSemitone(filter.pitchRange.max);
+            if (noteValue > maxValue) continue;
+          }
+        }
+        if (filter.voice !== void 0 && entry.voice !== filter.voice) continue;
+        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;
+        }
+        results.push(entry);
+      }
+    }
+  }
+  return results;
+}
+function getDuration(score) {
+  if (score.parts.length === 0) return 0;
+  const part = score.parts[0];
+  let totalDuration = 0;
+  let divisions = 1;
+  for (const measure of part.measures) {
+    if (measure.attributes?.divisions !== void 0) {
+      divisions = measure.attributes.divisions;
+    }
+    let measureDuration = 0;
+    for (const entry of measure.entries) {
+      if (entry.type === "note" && !entry.chord) {
+        measureDuration = Math.max(measureDuration, entry.duration);
+      }
+    }
+    const attrs = getAttributesAtMeasure(score, { part: 0, measure: measure.number });
+    if (attrs.time) {
+      const beats = parseInt(attrs.time.beats, 10) || 4;
+      const expectedDuration = beats / attrs.time.beatType * 4 * divisions;
+      measureDuration = Math.max(measureDuration, expectedDuration);
+    }
+    totalDuration += measureDuration;
+  }
+  return totalDuration;
+}
+function getPartById(score, id) {
+  return score.parts.find((p) => p.id === id);
+}
+function getPartIndex(score, id) {
+  return score.parts.findIndex((p) => p.id === id);
+}
+function hasMultipleStaves(score, partIndex = 0) {
+  const part = score.parts[partIndex];
+  if (!part) return false;
+  for (const measure of part.measures) {
+    if (measure.attributes?.staves !== void 0 && measure.attributes.staves > 1) {
+      return true;
+    }
+  }
+  return false;
+}
+function getStaveCount(score, partIndex = 0) {
+  const part = score.parts[partIndex];
+  if (!part) return 1;
+  for (const measure of part.measures) {
+    if (measure.attributes?.staves !== void 0) {
+      return measure.attributes.staves;
+    }
+  }
+  return 1;
+}
+function measureRoundtrip(original, exported) {
+  const notesOriginal = countNotes(original);
+  const notesExported = countNotes(exported);
+  const notesPreserved = Math.min(notesOriginal, notesExported);
+  const measuresOriginal = getMeasureCount(original);
+  const measuresExported = getMeasureCount(exported);
+  const measuresPreserved = Math.min(measuresOriginal, measuresExported);
+  const partsOriginal = original.parts.length;
+  const partsExported = exported.parts.length;
+  const partsPreserved = Math.min(partsOriginal, partsExported);
+  const preservationRate = notesOriginal > 0 ? notesPreserved / notesOriginal : 1;
+  return {
+    notesOriginal,
+    notesPreserved,
+    measuresOriginal,
+    measuresPreserved,
+    partsOriginal,
+    partsPreserved,
+    preservationRate
+  };
+}
+function countNotes(score) {
+  let count = 0;
+  for (const part of score.parts) {
+    for (const measure of part.measures) {
+      for (const entry of measure.entries) {
+        if (entry.type === "note") {
+          count++;
+        }
+      }
+    }
+  }
+  return count;
+}
+function scoresEqual(a, b) {
+  if (a.parts.length !== b.parts.length) return false;
+  for (let i = 0; i < a.parts.length; i++) {
+    const partA = a.parts[i];
+    const partB = b.parts[i];
+    if (partA.measures.length !== partB.measures.length) return false;
+    for (let j = 0; j < partA.measures.length; j++) {
+      const measureA = partA.measures[j];
+      const measureB = partB.measures[j];
+      if (measureA.number !== measureB.number) return false;
+      const notesA = measureA.entries.filter((e) => e.type === "note");
+      const notesB = measureB.entries.filter((e) => e.type === "note");
+      if (notesA.length !== notesB.length) return false;
+      for (let k = 0; k < notesA.length; k++) {
+        const noteA = notesA[k];
+        const noteB = notesB[k];
+        if (!pitchesEqual(noteA.pitch, noteB.pitch)) return false;
+        if (noteA.duration !== noteB.duration) return false;
+        if (noteA.voice !== noteB.voice) return false;
+      }
+    }
+  }
+  return true;
+}
+function pitchesEqual(a, b) {
+  if (a === void 0 && b === void 0) return true;
+  if (a === void 0 || b === void 0) return false;
+  return a.step === b.step && a.octave === b.octave && (a.alter ?? 0) === (b.alter ?? 0);
+}
+export {
+  countNotes,
+  findNotes,
+  getAttributesAtMeasure,
+  getDivisions,
+  getDuration,
+  getMeasure,
+  getMeasureByIndex,
+  getMeasureCount,
+  getPartById,
+  getPartIndex,
+  getStaveCount,
+  hasMultipleStaves,
+  measureRoundtrip,
+  scoresEqual
+};
+//# sourceMappingURL=index.mjs.map

package/dist/query/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/index.ts","../../src/query/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  Part,\n  Measure,\n  MeasureAttributes,\n  NoteEntry,\n  Pitch,\n} from '../types';\nimport { pitchToSemitone } from '../utils';\n\n/**\n * Get a specific measure from the score\n */\nexport function getMeasure(score: Score, options: { part: number; measure: string | number }): Measure | undefined {\n  const part = score.parts[options.part];\n  if (!part) return undefined;\n  const targetMeasure = String(options.measure);\n\n  return part.measures.find((m) => m.number === targetMeasure);\n}\n\n/**\n * Get measure by index\n */\nexport function getMeasureByIndex(score: Score, options: { part: number; measureIndex: number }): Measure | undefined {\n  const part = score.parts[options.part];\n  if (!part) return undefined;\n\n  return part.measures[options.measureIndex];\n}\n\n/**\n * Get the total number of measures in a score\n */\nexport function getMeasureCount(score: Score): number {\n  if (score.parts.length === 0) return 0;\n  return score.parts[0].measures.length;\n}\n\n/**\n * Get the divisions value at a specific measure\n * Searches backwards from the specified measure to find the most recent divisions\n */\nexport function getDivisions(score: Score, options: { part: number; measure: string | number }): number {\n  const part = score.parts[options.part];\n  if (!part) return 1;\n  const targetMeasure = parseInt(String(options.measure), 10);\n  if (isNaN(targetMeasure)) return 1;\n\n  for (let i = 0; i < part.measures.length; i++) {\n    const m = part.measures[i];\n    const mNum = parseInt(m.number, 10);\n    if (!isNaN(mNum) && mNum > targetMeasure) break;\n\n    if (m.attributes?.divisions !== undefined) {\n      // Continue searching for a more recent value\n    }\n  }\n\n  // Search from the beginning up to the specified measure\n  let divisions = 1;\n  for (const m of part.measures) {\n    const mNum = parseInt(m.number, 10);\n    if (!isNaN(mNum) && mNum > targetMeasure) break;\n    if (m.attributes?.divisions !== undefined) {\n      divisions = m.attributes.divisions;\n    }\n  }\n\n  return divisions;\n}\n\n/**\n * Get the current attributes at a specific measure\n * Merges all attribute changes from measure 1 to the specified measure\n */\nexport function getAttributesAtMeasure(score: Score, options: { part: number; measure: string | number }): MeasureAttributes {\n  const part = score.parts[options.part];\n  if (!part) return {};\n  const targetMeasure = parseInt(String(options.measure), 10);\n\n  const result: MeasureAttributes = {};\n\n  for (const m of part.measures) {\n    const mNum = parseInt(m.number, 10);\n    if (!isNaN(targetMeasure) && !isNaN(mNum) && mNum > targetMeasure) break;\n\n    if (m.attributes) {\n      if (m.attributes.divisions !== undefined) result.divisions = m.attributes.divisions;\n      if (m.attributes.time !== undefined) result.time = m.attributes.time;\n      if (m.attributes.key !== undefined) result.key = m.attributes.key;\n      if (m.attributes.clef !== undefined) result.clef = m.attributes.clef;\n      if (m.attributes.staves !== undefined) result.staves = m.attributes.staves;\n      if (m.attributes.transpose !== undefined) result.transpose = m.attributes.transpose;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Pitch range filter\n */\nexport interface PitchRange {\n  min?: Pitch;\n  max?: Pitch;\n}\n\n/**\n * Find notes filter\n */\nexport interface FindNotesFilter {\n  pitchRange?: PitchRange;\n  voice?: number;\n  staff?: number;\n  noteType?: string;\n  hasTie?: boolean;\n}\n\n/**\n * Find notes matching specific criteria\n */\nexport function findNotes(score: Score, filter: FindNotesFilter): NoteEntry[] {\n  const results: NoteEntry[] = [];\n\n  for (const part of score.parts) {\n    for (const measure of part.measures) {\n      for (const entry of measure.entries) {\n        if (entry.type !== 'note') continue;\n\n        // Filter by pitch range\n        if (filter.pitchRange && entry.pitch) {\n          const noteValue = pitchToSemitone(entry.pitch);\n\n          if (filter.pitchRange.min) {\n            const minValue = pitchToSemitone(filter.pitchRange.min);\n            if (noteValue < minValue) continue;\n          }\n\n          if (filter.pitchRange.max) {\n            const maxValue = pitchToSemitone(filter.pitchRange.max);\n            if (noteValue > maxValue) continue;\n          }\n        }\n\n        // Filter by voice\n        if (filter.voice !== undefined && entry.voice !== filter.voice) continue;\n\n        // Filter by staff\n        if (filter.staff !== undefined && (entry.staff ?? 1) !== filter.staff) continue;\n\n        // Filter by note type\n        if (filter.noteType !== undefined && entry.noteType !== filter.noteType) continue;\n\n        // Filter by tie\n        if (filter.hasTie !== undefined) {\n          const hasTie = entry.tie !== undefined;\n          if (filter.hasTie !== hasTie) continue;\n        }\n\n        results.push(entry);\n      }\n    }\n  }\n\n  return results;\n}\n\n/**\n * Get the total duration of the score in divisions\n */\nexport function getDuration(score: Score): number {\n  if (score.parts.length === 0) return 0;\n\n  const part = score.parts[0];\n  let totalDuration = 0;\n  let divisions = 1;\n\n  for (const measure of part.measures) {\n    if (measure.attributes?.divisions !== undefined) {\n      divisions = measure.attributes.divisions;\n    }\n\n    // Calculate measure duration based on time signature or actual notes\n    let measureDuration = 0;\n\n    for (const entry of measure.entries) {\n      if (entry.type === 'note' && !entry.chord) {\n        measureDuration = Math.max(measureDuration, entry.duration);\n      }\n    }\n\n    // Use time signature to calculate expected duration if available\n    const attrs = getAttributesAtMeasure(score, { part: 0, measure: measure.number });\n    if (attrs.time) {\n      const beats = parseInt(attrs.time.beats, 10) || 4;\n      const expectedDuration = (beats / attrs.time.beatType) * 4 * divisions;\n      measureDuration = Math.max(measureDuration, expectedDuration);\n    }\n\n    totalDuration += measureDuration;\n  }\n\n  return totalDuration;\n}\n\n/**\n * Get part by ID\n */\nexport function getPartById(score: Score, id: string): Part | undefined {\n  return score.parts.find((p) => p.id === id);\n}\n\n/**\n * Get part index by ID\n */\nexport function getPartIndex(score: Score, id: string): number {\n  return score.parts.findIndex((p) => p.id === id);\n}\n\n/**\n * Check if the score has multiple staves (e.g., piano grand staff)\n */\nexport function hasMultipleStaves(score: Score, partIndex: number = 0): boolean {\n  const part = score.parts[partIndex];\n  if (!part) return false;\n\n  for (const measure of part.measures) {\n    if (measure.attributes?.staves !== undefined && measure.attributes.staves > 1) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Get the number of staves for a part\n */\nexport function getStaveCount(score: Score, partIndex: number = 0): number {\n  const part = score.parts[partIndex];\n  if (!part) return 1;\n\n  for (const measure of part.measures) {\n    if (measure.attributes?.staves !== undefined) {\n      return measure.attributes.staves;\n    }\n  }\n\n  return 1;\n}\n\n/**\n * Round-trip metrics for measuring preservation fidelity\n */\nexport interface RoundtripMetrics {\n  notesOriginal: number;\n  notesPreserved: number;\n  measuresOriginal: number;\n  measuresPreserved: number;\n  partsOriginal: number;\n  partsPreserved: number;\n  preservationRate: number;\n}\n\n/**\n * Compare two scores and calculate round-trip preservation metrics\n */\nexport function measureRoundtrip(original: Score, exported: Score): RoundtripMetrics {\n  const notesOriginal = countNotes(original);\n  const notesExported = countNotes(exported);\n  const notesPreserved = Math.min(notesOriginal, notesExported);\n\n  const measuresOriginal = getMeasureCount(original);\n  const measuresExported = getMeasureCount(exported);\n  const measuresPreserved = Math.min(measuresOriginal, measuresExported);\n\n  const partsOriginal = original.parts.length;\n  const partsExported = exported.parts.length;\n  const partsPreserved = Math.min(partsOriginal, partsExported);\n\n  // Calculate preservation rate based on notes (most granular)\n  const preservationRate = notesOriginal > 0\n    ? notesPreserved / notesOriginal\n    : 1;\n\n  return {\n    notesOriginal,\n    notesPreserved,\n    measuresOriginal,\n    measuresPreserved,\n    partsOriginal,\n    partsPreserved,\n    preservationRate,\n  };\n}\n\n/**\n * Count total notes in a score\n */\nexport function countNotes(score: Score): number {\n  let count = 0;\n\n  for (const part of score.parts) {\n    for (const measure of part.measures) {\n      for (const entry of measure.entries) {\n        if (entry.type === 'note') {\n          count++;\n        }\n      }\n    }\n  }\n\n  return count;\n}\n\n/**\n * Compare two scores for structural equality\n */\nexport function scoresEqual(a: Score, b: Score): boolean {\n  // Check parts count\n  if (a.parts.length !== b.parts.length) return false;\n\n  for (let i = 0; i < a.parts.length; i++) {\n    const partA = a.parts[i];\n    const partB = b.parts[i];\n\n    if (partA.measures.length !== partB.measures.length) return false;\n\n    for (let j = 0; j < partA.measures.length; j++) {\n      const measureA = partA.measures[j];\n      const measureB = partB.measures[j];\n\n      if (measureA.number !== measureB.number) return false;\n\n      // Compare entries count\n      const notesA = measureA.entries.filter(e => e.type === 'note');\n      const notesB = measureB.entries.filter(e => e.type === 'note');\n\n      if (notesA.length !== notesB.length) return false;\n\n      // Compare each note\n      for (let k = 0; k < notesA.length; k++) {\n        const noteA = notesA[k] as NoteEntry;\n        const noteB = notesB[k] as NoteEntry;\n\n        if (!pitchesEqual(noteA.pitch, noteB.pitch)) return false;\n        if (noteA.duration !== noteB.duration) return false;\n        if (noteA.voice !== noteB.voice) return false;\n      }\n    }\n  }\n\n  return true;\n}\n\n/**\n * Compare two pitches for equality\n */\nfunction pitchesEqual(a: Pitch | undefined, b: Pitch | undefined): boolean {\n  if (a === undefined && b === undefined) return true;\n  if (a === undefined || b === undefined) return false;\n  return a.step === b.step && a.octave === b.octave && (a.alter ?? 0) === (b.alter ?? 0);\n}\n"],"mappings":"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","names":[]}