musicxml-io 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Makoto Tanji
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+# musicxml-io
+
+[![npm version](https://img.shields.io/npm/v/musicxml-io.svg)](https://www.npmjs.com/package/musicxml-io)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+TypeScript library for parsing and serializing MusicXML.
+
+## Architecture
+
+```
+┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
+│   MusicXML      │      │                 │      │   MusicXML      │
+│   .xml / .mxl   │─────▶│      Score      │─────▶│   .xml / .mxl   │
+└─────────────────┘      │                 │      └─────────────────┘
+                   parse │   ┌─────────┐   │ serialize
+                         │   │  parts  │   │      ┌─────────────────┐
+                         │   │   └─measures      │      MIDI        │
+                         │   │       └─entries   │─────▶│   .mid          │
+                         │   └─────────┘   │      └─────────────────┘
+                         │                 │ exportMidi
+                         └────────┬────────┘
+                                  │
+                    ┌─────────────┼─────────────┐
+                    │             │             │
+                    ▼             ▼             ▼
+              ┌──────────┐ ┌──────────┐ ┌──────────┐
+              │ Query    │ │Operations│ │ Validate │
+              │          │ │          │ │          │
+              │findNotes │ │transpose │ │validate  │
+              │getMeasure│ │addNote   │ │isValid   │
+              │countNotes│ │changeKey │ │assertValid
+              └──────────┘ └──────────┘ └──────────┘
+```
+
+## Install
+
+```bash
+npm install musicxml-io
+```
+
+## Usage
+
+```typescript
+import { parse, serialize, transpose } from 'musicxml-io';
+
+const score = parse(xmlString);
+const transposed = transpose(score, 2);  // up 2 semitones
+const output = serialize(transposed);
+```
+
+### File I/O (Node.js)
+
+```typescript
+import { parseFile, serializeToFile } from 'musicxml-io';
+
+const score = await parseFile('input.mxl');
+await serializeToFile(score, 'output.xml');
+```
+
+### Operations
+
+```typescript
+import { addNote, changeKey, changeTime } from 'musicxml-io';
+
+const updated = addNote(score, {
+  partIndex: 0,
+  measureNumber: 1,
+  pitch: { step: 'C', octave: 4 },
+  duration: 4,
+  type: 'quarter',
+});
+
+const inG = changeKey(score, { fifths: 1 }, 0, 1);
+const waltz = changeTime(score, { beats: 3, beatType: 4 }, 0, 1);
+```
+
+### Query
+
+```typescript
+import { findNotes, getAllNotes, getMeasureCount } from 'musicxml-io';
+
+const notes = getAllNotes(score);
+const quarterNotes = findNotes(score, { type: 'quarter' });
+const count = getMeasureCount(score.parts[0]);
+```
+
+### MIDI Export
+
+```typescript
+import { exportMidi } from 'musicxml-io';
+
+const midi = exportMidi(score, { tempo: 120 });
+```
+
+### Validation
+
+```typescript
+import { validate, isValid } from 'musicxml-io';
+
+const { valid, errors } = validate(score);
+```
+
+## API
+
+### Parse / Serialize
+
+| Function | Description |
+|----------|-------------|
+| `parse(xml)` | Parse MusicXML string |
+| `parseFile(path)` | Parse from file |
+| `parseCompressed(buffer)` | Parse .mxl |
+| `parseAuto(data)` | Auto-detect format |
+| `serialize(score)` | To MusicXML string |
+| `serializeToFile(score, path)` | To file |
+| `serializeCompressed(score)` | To .mxl |
+| `exportMidi(score)` | To MIDI |
+
+### Operations
+
+| Function | Description |
+|----------|-------------|
+| `transpose(score, semitones)` | Transpose pitches |
+| `addNote(score, options)` | Add note |
+| `deleteNote(score, options)` | Delete note |
+| `addChordNote(score, options)` | Add to chord |
+| `changeKey(score, key, part, measure)` | Change key |
+| `changeTime(score, time, part, measure)` | Change time |
+| `insertMeasure(score, part, after)` | Insert measure |
+| `deleteMeasure(score, part, measure)` | Delete measure |
+
+### Query
+
+| Function | Description |
+|----------|-------------|
+| `getAllNotes(score)` | All notes |
+| `findNotes(score, filter)` | Filter notes |
+| `getMeasure(part, number)` | Get measure |
+| `getMeasureCount(part)` | Measure count |
+| `getChords(measure)` | Chord groups |
+| `countNotes(score)` | Notes per part |
+
+### Validate
+
+| Function | Description |
+|----------|-------------|
+| `validate(score)` | Validation errors |
+| `isValid(score)` | Boolean check |
+| `assertValid(score)` | Throw if invalid |
+
+## Tree-shaking
+
+```typescript
+import { transpose } from 'musicxml-io/operations';
+import { findNotes } from 'musicxml-io/query';
+```
+
+## Round-trip Fidelity
+
+| Metric | Score |
+|--------|------:|
+| Overall | 99.6% |
+| Node coverage | 99.9% |
+| Attribute coverage | 95.9% |
+
+## License
+
+MIT

package/dist/accessors/index.d.mts

@@ -0,0 +1,82 @@
+import { M as Measure, N as NoteEntry, V as VoiceGroup, q as StaffGroup, r as NoteWithPosition, s as Chord, S as Score, t as NoteIteratorItem } from '../types-DC_TnJu_.mjs';
+
+/**
+ * Filter options for voice/staff selection
+ */
+interface VoiceFilter {
+    voice?: number;
+    staff?: number;
+}
+/**
+ * Get all notes for a specific voice (and optionally staff)
+ */
+declare function getNotesForVoice(measure: Measure, filter: VoiceFilter): NoteEntry[];
+/**
+ * Get all notes for a specific staff (regardless of voice)
+ */
+declare function getNotesForStaff(measure: Measure, filter: {
+    staff: number;
+}): NoteEntry[];
+/**
+ * Group notes by voice (and staff)
+ */
+declare function groupByVoice(measure: Measure): VoiceGroup[];
+/**
+ * Group notes by staff
+ */
+declare function groupByStaff(measure: Measure): StaffGroup[];
+/**
+ * Calculate absolute position of a note within a measure
+ * Position is in divisions from the start of the measure
+ */
+declare function getAbsolutePosition(note: NoteEntry, measure: Measure): number;
+/**
+ * Add absolute position to all notes in a measure
+ */
+declare function withAbsolutePositions(measure: Measure): NoteWithPosition[];
+/**
+ * Get chords (groups of simultaneously sounding notes)
+ */
+declare function getChords(measure: Measure, filter?: VoiceFilter): Chord[];
+/**
+ * Iterate over all notes in a score
+ */
+declare function iterateNotes(score: Score): Generator<NoteIteratorItem>;
+/**
+ * Get all notes from a score as an array
+ */
+declare function getAllNotes(score: Score): NoteIteratorItem[];
+/**
+ * Get unique voices used in a measure
+ */
+declare function getVoices(measure: Measure): number[];
+/**
+ * Get unique staves used in a measure
+ */
+declare function getStaves(measure: Measure): number[];
+/**
+ * Check if a measure contains any notes
+ */
+declare function hasNotes(measure: Measure): boolean;
+/**
+ * Check if a measure is a rest (no pitched notes)
+ */
+declare function isRestMeasure(measure: Measure): boolean;
+/**
+ * Options for normalized position calculation
+ */
+interface NormalizedPositionOptions {
+    baseDivisions: number;
+    currentDivisions?: number;
+}
+/**
+ * Get a normalized position of a note using a common base divisions
+ * This is useful when comparing positions across measures with different divisions
+ */
+declare function getNormalizedPosition(note: NoteEntry, measure: Measure, options: NormalizedPositionOptions): number;
+/**
+ * Get normalized duration of a note using a common base divisions
+ */
+declare function getNormalizedDuration(note: NoteEntry, options: NormalizedPositionOptions): number;
+
+export { type NormalizedPositionOptions, type VoiceFilter, getAbsolutePosition, getAllNotes, getChords, getNormalizedDuration, getNormalizedPosition, getNotesForStaff, getNotesForVoice, getStaves, getVoices, groupByStaff, groupByVoice, hasNotes, isRestMeasure, iterateNotes, withAbsolutePositions };

package/dist/accessors/index.d.ts

@@ -0,0 +1,82 @@
+import { M as Measure, N as NoteEntry, V as VoiceGroup, q as StaffGroup, r as NoteWithPosition, s as Chord, S as Score, t as NoteIteratorItem } from '../types-DC_TnJu_.js';
+
+/**
+ * Filter options for voice/staff selection
+ */
+interface VoiceFilter {
+    voice?: number;
+    staff?: number;
+}
+/**
+ * Get all notes for a specific voice (and optionally staff)
+ */
+declare function getNotesForVoice(measure: Measure, filter: VoiceFilter): NoteEntry[];
+/**
+ * Get all notes for a specific staff (regardless of voice)
+ */
+declare function getNotesForStaff(measure: Measure, filter: {
+    staff: number;
+}): NoteEntry[];
+/**
+ * Group notes by voice (and staff)
+ */
+declare function groupByVoice(measure: Measure): VoiceGroup[];
+/**
+ * Group notes by staff
+ */
+declare function groupByStaff(measure: Measure): StaffGroup[];
+/**
+ * Calculate absolute position of a note within a measure
+ * Position is in divisions from the start of the measure
+ */
+declare function getAbsolutePosition(note: NoteEntry, measure: Measure): number;
+/**
+ * Add absolute position to all notes in a measure
+ */
+declare function withAbsolutePositions(measure: Measure): NoteWithPosition[];
+/**
+ * Get chords (groups of simultaneously sounding notes)
+ */
+declare function getChords(measure: Measure, filter?: VoiceFilter): Chord[];
+/**
+ * Iterate over all notes in a score
+ */
+declare function iterateNotes(score: Score): Generator<NoteIteratorItem>;
+/**
+ * Get all notes from a score as an array
+ */
+declare function getAllNotes(score: Score): NoteIteratorItem[];
+/**
+ * Get unique voices used in a measure
+ */
+declare function getVoices(measure: Measure): number[];
+/**
+ * Get unique staves used in a measure
+ */
+declare function getStaves(measure: Measure): number[];
+/**
+ * Check if a measure contains any notes
+ */
+declare function hasNotes(measure: Measure): boolean;
+/**
+ * Check if a measure is a rest (no pitched notes)
+ */
+declare function isRestMeasure(measure: Measure): boolean;
+/**
+ * Options for normalized position calculation
+ */
+interface NormalizedPositionOptions {
+    baseDivisions: number;
+    currentDivisions?: number;
+}
+/**
+ * Get a normalized position of a note using a common base divisions
+ * This is useful when comparing positions across measures with different divisions
+ */
+declare function getNormalizedPosition(note: NoteEntry, measure: Measure, options: NormalizedPositionOptions): number;
+/**
+ * Get normalized duration of a note using a common base divisions
+ */
+declare function getNormalizedDuration(note: NoteEntry, options: NormalizedPositionOptions): number;
+
+export { type NormalizedPositionOptions, type VoiceFilter, getAbsolutePosition, getAllNotes, getChords, getNormalizedDuration, getNormalizedPosition, getNotesForStaff, getNotesForVoice, getStaves, getVoices, groupByStaff, groupByVoice, hasNotes, isRestMeasure, iterateNotes, withAbsolutePositions };

package/dist/accessors/index.js

@@ -0,0 +1,239 @@
+"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/accessors/index.ts
+var accessors_exports = {};
+__export(accessors_exports, {
+  getAbsolutePosition: () => getAbsolutePosition,
+  getAllNotes: () => getAllNotes,
+  getChords: () => getChords,
+  getNormalizedDuration: () => getNormalizedDuration,
+  getNormalizedPosition: () => getNormalizedPosition,
+  getNotesForStaff: () => getNotesForStaff,
+  getNotesForVoice: () => getNotesForVoice,
+  getStaves: () => getStaves,
+  getVoices: () => getVoices,
+  groupByStaff: () => groupByStaff,
+  groupByVoice: () => groupByVoice,
+  hasNotes: () => hasNotes,
+  isRestMeasure: () => isRestMeasure,
+  iterateNotes: () => iterateNotes,
+  withAbsolutePositions: () => withAbsolutePositions
+});
+module.exports = __toCommonJS(accessors_exports);
+
+// src/utils/index.ts
+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 getAbsolutePositionForNote(note, measure) {
+  const state = createPositionState();
+  for (const entry of measure.entries) {
+    if (entry === note) return entry.chord ? state.lastNonChordPosition : state.position;
+    updatePositionForEntry(state, entry);
+  }
+  return state.position;
+}
+
+// src/accessors/index.ts
+function getNotesForVoice(measure, filter) {
+  return measure.entries.filter((entry) => {
+    if (entry.type !== "note") return false;
+    if (filter.voice !== void 0 && entry.voice !== filter.voice) return false;
+    if (filter.staff !== void 0 && (entry.staff ?? 1) !== filter.staff) return false;
+    return true;
+  });
+}
+function getNotesForStaff(measure, filter) {
+  return measure.entries.filter((entry) => {
+    if (entry.type !== "note") return false;
+    return (entry.staff ?? 1) === filter.staff;
+  });
+}
+function groupByVoice(measure) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const entry of measure.entries) {
+    if (entry.type !== "note") continue;
+    const staff = entry.staff ?? 1;
+    const voice = entry.voice;
+    const key = `${staff}-${voice}`;
+    if (!groups.has(key)) {
+      groups.set(key, { staff, voice, notes: [] });
+    }
+    groups.get(key).notes.push(entry);
+  }
+  return Array.from(groups.values()).sort((a, b) => {
+    if (a.staff !== b.staff) return a.staff - b.staff;
+    return a.voice - b.voice;
+  });
+}
+function groupByStaff(measure) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const entry of measure.entries) {
+    if (entry.type !== "note") continue;
+    const staff = entry.staff ?? 1;
+    if (!groups.has(staff)) {
+      groups.set(staff, { staff, notes: [] });
+    }
+    groups.get(staff).notes.push(entry);
+  }
+  return Array.from(groups.values()).sort((a, b) => a.staff - b.staff);
+}
+function getAbsolutePosition(note, measure) {
+  return getAbsolutePositionForNote(note, measure);
+}
+function withAbsolutePositions(measure) {
+  const result = [];
+  const state = createPositionState();
+  for (const entry of measure.entries) {
+    if (entry.type === "note") {
+      const notePosition = entry.chord ? state.lastNonChordPosition : state.position;
+      result.push({
+        ...entry,
+        absolutePosition: notePosition
+      });
+    }
+    updatePositionForEntry(state, entry);
+  }
+  return result;
+}
+function getChords(measure, filter) {
+  const notesWithPos = withAbsolutePositions(measure);
+  const filteredNotes = filter ? notesWithPos.filter((note) => {
+    if (filter.voice !== void 0 && note.voice !== filter.voice) return false;
+    if (filter.staff !== void 0 && (note.staff ?? 1) !== filter.staff) return false;
+    return true;
+  }) : notesWithPos;
+  const chordMap = /* @__PURE__ */ new Map();
+  for (const note of filteredNotes) {
+    const pos = note.absolutePosition;
+    if (!chordMap.has(pos)) {
+      chordMap.set(pos, []);
+    }
+    chordMap.get(pos).push(note);
+  }
+  const chords = [];
+  for (const [position, notes] of chordMap.entries()) {
+    const duration = notes[0].duration;
+    chords.push({
+      position,
+      duration,
+      notes: notes.map(({ absolutePosition, ...note }) => note)
+    });
+  }
+  return chords.sort((a, b) => a.position - b.position);
+}
+function* iterateNotes(score) {
+  for (const part of score.parts) {
+    for (const measure of part.measures) {
+      const state = createPositionState();
+      for (const entry of measure.entries) {
+        if (entry.type === "note") {
+          const notePosition = entry.chord ? state.lastNonChordPosition : state.position;
+          yield {
+            part,
+            measure,
+            note: entry,
+            position: notePosition
+          };
+        }
+        updatePositionForEntry(state, entry);
+      }
+    }
+  }
+}
+function getAllNotes(score) {
+  return Array.from(iterateNotes(score));
+}
+function getVoices(measure) {
+  const voices = /* @__PURE__ */ new Set();
+  for (const entry of measure.entries) {
+    if (entry.type === "note") {
+      voices.add(entry.voice);
+    }
+  }
+  return Array.from(voices).sort((a, b) => a - b);
+}
+function getStaves(measure) {
+  const staves = /* @__PURE__ */ new Set();
+  for (const entry of measure.entries) {
+    if (entry.type === "note") {
+      staves.add(entry.staff ?? 1);
+    }
+  }
+  return Array.from(staves).sort((a, b) => a - b);
+}
+function hasNotes(measure) {
+  return measure.entries.some((entry) => entry.type === "note");
+}
+function isRestMeasure(measure) {
+  const notes = measure.entries.filter((entry) => entry.type === "note");
+  return notes.length === 0 || notes.every((note) => !note.pitch);
+}
+function getNormalizedPosition(note, measure, options) {
+  const absolutePosition = getAbsolutePosition(note, measure);
+  const currentDivisions = options.currentDivisions ?? measure.attributes?.divisions ?? 1;
+  return absolutePosition * options.baseDivisions / currentDivisions;
+}
+function getNormalizedDuration(note, options) {
+  const currentDivisions = options.currentDivisions ?? 1;
+  return note.duration * options.baseDivisions / currentDivisions;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getAbsolutePosition,
+  getAllNotes,
+  getChords,
+  getNormalizedDuration,
+  getNormalizedPosition,
+  getNotesForStaff,
+  getNotesForVoice,
+  getStaves,
+  getVoices,
+  groupByStaff,
+  groupByVoice,
+  hasNotes,
+  isRestMeasure,
+  iterateNotes,
+  withAbsolutePositions
+});
+//# sourceMappingURL=index.js.map

package/dist/accessors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/accessors/index.ts","../../src/utils/index.ts"],"sourcesContent":["import type {\n  Score,\n  Measure,\n  NoteEntry,\n  VoiceGroup,\n  StaffGroup,\n  NoteWithPosition,\n  Chord,\n  NoteIteratorItem,\n} from '../types';\nimport { getAbsolutePositionForNote, createPositionState, updatePositionForEntry } from '../utils';\n\n/**\n * Filter options for voice/staff selection\n */\nexport interface VoiceFilter {\n  voice?: number;\n  staff?: number;\n}\n\n/**\n * Get all notes for a specific voice (and optionally staff)\n */\nexport function getNotesForVoice(measure: Measure, filter: VoiceFilter): NoteEntry[] {\n  return measure.entries.filter((entry): entry is NoteEntry => {\n    if (entry.type !== 'note') return false;\n    if (filter.voice !== undefined && entry.voice !== filter.voice) return false;\n    if (filter.staff !== undefined && (entry.staff ?? 1) !== filter.staff) return false;\n    return true;\n  });\n}\n\n/**\n * Get all notes for a specific staff (regardless of voice)\n */\nexport function getNotesForStaff(measure: Measure, filter: { staff: number }): NoteEntry[] {\n  return measure.entries.filter((entry): entry is NoteEntry => {\n    if (entry.type !== 'note') return false;\n    return (entry.staff ?? 1) === filter.staff;\n  });\n}\n\n/**\n * Group notes by voice (and staff)\n */\nexport function groupByVoice(measure: Measure): VoiceGroup[] {\n  const groups = new Map<string, VoiceGroup>();\n\n  for (const entry of measure.entries) {\n    if (entry.type !== 'note') continue;\n\n    const staff = entry.staff ?? 1;\n    const voice = entry.voice;\n    const key = `${staff}-${voice}`;\n\n    if (!groups.has(key)) {\n      groups.set(key, { staff, voice, notes: [] });\n    }\n\n    groups.get(key)!.notes.push(entry);\n  }\n\n  // Sort by staff, then by voice\n  return Array.from(groups.values()).sort((a, b) => {\n    if (a.staff !== b.staff) return a.staff - b.staff;\n    return a.voice - b.voice;\n  });\n}\n\n/**\n * Group notes by staff\n */\nexport function groupByStaff(measure: Measure): StaffGroup[] {\n  const groups = new Map<number, StaffGroup>();\n\n  for (const entry of measure.entries) {\n    if (entry.type !== 'note') continue;\n\n    const staff = entry.staff ?? 1;\n\n    if (!groups.has(staff)) {\n      groups.set(staff, { staff, notes: [] });\n    }\n\n    groups.get(staff)!.notes.push(entry);\n  }\n\n  return Array.from(groups.values()).sort((a, b) => a.staff - b.staff);\n}\n\n/**\n * Calculate absolute position of a note within a measure\n * Position is in divisions from the start of the measure\n */\nexport function getAbsolutePosition(note: NoteEntry, measure: Measure): number {\n  return getAbsolutePositionForNote(note, measure);\n}\n\n/**\n * Add absolute position to all notes in a measure\n */\nexport function withAbsolutePositions(measure: Measure): NoteWithPosition[] {\n  const result: NoteWithPosition[] = [];\n  const state = createPositionState();\n\n  for (const entry of measure.entries) {\n    if (entry.type === 'note') {\n      const notePosition = entry.chord ? state.lastNonChordPosition : state.position;\n      result.push({\n        ...entry,\n        absolutePosition: notePosition,\n      });\n    }\n    updatePositionForEntry(state, entry);\n  }\n\n  return result;\n}\n\n/**\n * Get chords (groups of simultaneously sounding notes)\n */\nexport function getChords(measure: Measure, filter?: VoiceFilter): Chord[] {\n  const notesWithPos = withAbsolutePositions(measure);\n\n  // Filter by voice/staff if specified\n  const filteredNotes = filter\n    ? notesWithPos.filter((note) => {\n        if (filter.voice !== undefined && note.voice !== filter.voice) return false;\n        if (filter.staff !== undefined && (note.staff ?? 1) !== filter.staff) return false;\n        return true;\n      })\n    : notesWithPos;\n\n  // Group by position\n  const chordMap = new Map<number, NoteWithPosition[]>();\n\n  for (const note of filteredNotes) {\n    const pos = note.absolutePosition;\n    if (!chordMap.has(pos)) {\n      chordMap.set(pos, []);\n    }\n    chordMap.get(pos)!.push(note);\n  }\n\n  // Convert to Chord array\n  const chords: Chord[] = [];\n\n  for (const [position, notes] of chordMap.entries()) {\n    // All notes in a chord should have the same duration (using first note's duration)\n    const duration = notes[0].duration;\n\n    chords.push({\n      position,\n      duration,\n      notes: notes.map(({ absolutePosition, ...note }) => note),\n    });\n  }\n\n  // Sort by position\n  return chords.sort((a, b) => a.position - b.position);\n}\n\n/**\n * Iterate over all notes in a score\n */\nexport function* iterateNotes(score: Score): Generator<NoteIteratorItem> {\n  for (const part of score.parts) {\n    for (const measure of part.measures) {\n      const state = createPositionState();\n\n      for (const entry of measure.entries) {\n        if (entry.type === 'note') {\n          const notePosition = entry.chord ? state.lastNonChordPosition : state.position;\n          yield {\n            part,\n            measure,\n            note: entry,\n            position: notePosition,\n          };\n        }\n        updatePositionForEntry(state, entry);\n      }\n    }\n  }\n}\n\n/**\n * Get all notes from a score as an array\n */\nexport function getAllNotes(score: Score): NoteIteratorItem[] {\n  return Array.from(iterateNotes(score));\n}\n\n/**\n * Get unique voices used in a measure\n */\nexport function getVoices(measure: Measure): number[] {\n  const voices = new Set<number>();\n\n  for (const entry of measure.entries) {\n    if (entry.type === 'note') {\n      voices.add(entry.voice);\n    }\n  }\n\n  return Array.from(voices).sort((a, b) => a - b);\n}\n\n/**\n * Get unique staves used in a measure\n */\nexport function getStaves(measure: Measure): number[] {\n  const staves = new Set<number>();\n\n  for (const entry of measure.entries) {\n    if (entry.type === 'note') {\n      staves.add(entry.staff ?? 1);\n    }\n  }\n\n  return Array.from(staves).sort((a, b) => a - b);\n}\n\n/**\n * Check if a measure contains any notes\n */\nexport function hasNotes(measure: Measure): boolean {\n  return measure.entries.some((entry) => entry.type === 'note');\n}\n\n/**\n * Check if a measure is a rest (no pitched notes)\n */\nexport function isRestMeasure(measure: Measure): boolean {\n  const notes = measure.entries.filter((entry): entry is NoteEntry => entry.type === 'note');\n  return notes.length === 0 || notes.every((note) => !note.pitch);\n}\n\n/**\n * Options for normalized position calculation\n */\nexport interface NormalizedPositionOptions {\n  baseDivisions: number;\n  currentDivisions?: number;\n}\n\n/**\n * Get a normalized position of a note using a common base divisions\n * This is useful when comparing positions across measures with different divisions\n */\nexport function getNormalizedPosition(\n  note: NoteEntry,\n  measure: Measure,\n  options: NormalizedPositionOptions\n): number {\n  const absolutePosition = getAbsolutePosition(note, measure);\n  const currentDivisions = options.currentDivisions ?? measure.attributes?.divisions ?? 1;\n\n  // Convert from current divisions to base divisions\n  return (absolutePosition * options.baseDivisions) / currentDivisions;\n}\n\n/**\n * Get normalized duration of a note using a common base divisions\n */\nexport function getNormalizedDuration(\n  note: NoteEntry,\n  options: NormalizedPositionOptions\n): number {\n  const currentDivisions = options.currentDivisions ?? 1;\n  return (note.duration * options.baseDivisions) / currentDivisions;\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":[]}