musicxml-io 0.7.0 → 0.7.1

package/dist/{chunk-CJZK2DGV.js → chunk-F6GPX6VW.js}

@@ -509,6 +509,188 @@ function hasPlaybackControls(score, options) {
   return controls.repeatStarts.length > 0 || controls.repeatEnds.length > 0 || controls.voltas.length > 0 || controls.jumps.length > 0 || controls.segnoIndex !== null || controls.codaIndex !== null;
 }
 
+// src/query/playback-timeline.ts
+function metronomeBpm(perMinute) {
+  if (perMinute === void 0) return null;
+  const bpm = typeof perMinute === "number" ? perMinute : parseFloat(perMinute);
+  return isNaN(bpm) ? null : bpm;
+}
+function measureMaxPosition(measure) {
+  let position = 0;
+  let max = 0;
+  for (const entry of measure.entries) {
+    if (entry.type === "note") {
+      if (!entry.chord && !entry.grace) {
+        position += entry.duration;
+        if (position > max) max = position;
+      }
+    } else if (entry.type === "backup") {
+      position -= entry.duration;
+    } else if (entry.type === "forward") {
+      position += entry.duration;
+      if (position > max) max = position;
+    }
+  }
+  return max;
+}
+function findTimeSignature(part, measureNumber) {
+  const targetMeasure = parseInt(String(measureNumber), 10);
+  let time;
+  for (const measure of part.measures) {
+    const mNum = parseInt(measure.number, 10);
+    if (!isNaN(targetMeasure) && !isNaN(mNum) && mNum > targetMeasure) break;
+    if (_optionalChain([measure, 'access', _5 => _5.attributes, 'optionalAccess', _6 => _6.time])) {
+      time = {
+        beats: parseInt(measure.attributes.time.beats, 10) || 4,
+        beatType: measure.attributes.time.beatType
+      };
+    }
+  }
+  return time;
+}
+function measureEndTick(measure, part, divisions, measureStartTick, maxPosition, ticksPerQuarterNote) {
+  const actualTicks = Math.round(maxPosition * ticksPerQuarterNote / divisions);
+  if (measure.implicit) {
+    return measureStartTick + actualTicks;
+  }
+  const timeAttrs = findTimeSignature(part, measure.number);
+  if (timeAttrs) {
+    const measureDuration = timeAttrs.beats / timeAttrs.beatType * 4 * divisions;
+    const calculatedTicks = Math.round(measureDuration * ticksPerQuarterNote / divisions);
+    const ticksToAdd = Math.min(calculatedTicks, actualTicks > 0 ? actualTicks : calculatedTicks);
+    return measureStartTick + ticksToAdd;
+  }
+  return measureStartTick + actualTicks;
+}
+function buildGridTimeline(score, ticksPerQuarterNote, sequence) {
+  const tempoEvents = [];
+  const measures = [];
+  if (score.parts.length === 0) {
+    return { tempoEvents, measures, totalTicks: 0 };
+  }
+  const part = score.parts[0];
+  let divisions = 1;
+  let currentTick = 0;
+  for (const { measureIndex, repeatIteration } of sequence) {
+    const measure = part.measures[measureIndex];
+    if (!measure) continue;
+    if (_optionalChain([measure, 'access', _7 => _7.attributes, 'optionalAccess', _8 => _8.divisions])) {
+      divisions = measure.attributes.divisions;
+    }
+    const measureStartTick = currentTick;
+    let position = 0;
+    const tickAt = (pos) => measureStartTick + Math.round(pos * ticksPerQuarterNote / divisions);
+    for (const entry of measure.entries) {
+      if (entry.type === "direction") {
+        for (const dirType of entry.directionTypes) {
+          if (dirType.kind === "metronome") {
+            const bpm = metronomeBpm(dirType.perMinute);
+            if (bpm !== null) tempoEvents.push({ tick: tickAt(position), bpm });
+          }
+        }
+        if (_optionalChain([entry, 'access', _9 => _9.sound, 'optionalAccess', _10 => _10.tempo])) {
+          tempoEvents.push({ tick: tickAt(position), bpm: entry.sound.tempo });
+        }
+      } else if (entry.type === "sound") {
+        if (entry.tempo) tempoEvents.push({ tick: tickAt(position), bpm: entry.tempo });
+      } else if (entry.type === "note" && !entry.chord) {
+        position += entry.duration;
+      } else if (entry.type === "backup") {
+        position -= entry.duration;
+      } else if (entry.type === "forward") {
+        position += entry.duration;
+      }
+    }
+    const endTick = measureEndTick(
+      measure,
+      part,
+      divisions,
+      measureStartTick,
+      measureMaxPosition(measure),
+      ticksPerQuarterNote
+    );
+    measures.push({
+      measureIndex,
+      repeatIteration,
+      measureNumber: measure.number,
+      startTick: measureStartTick,
+      endTick
+    });
+    currentTick = endTick;
+  }
+  return { tempoEvents, measures, totalTicks: currentTick };
+}
+function makeTickToSec(tempoEvents, defaultTempo, ticksPerQuarterNote) {
+  const sorted = [...tempoEvents].sort((a, b) => a.tick - b.tick);
+  const startBpm = sorted.length > 0 && sorted[0].tick === 0 ? sorted[0].bpm : defaultTempo;
+  const changes = [{ tick: 0, bpm: startBpm }];
+  let lastBpm = startBpm;
+  for (const ev of sorted) {
+    if (ev.tick === 0) continue;
+    if (ev.bpm === lastBpm) continue;
+    changes.push({ tick: ev.tick, bpm: ev.bpm });
+    lastBpm = ev.bpm;
+  }
+  const cumSec = [0];
+  for (let i = 1; i < changes.length; i++) {
+    const dTick = changes[i].tick - changes[i - 1].tick;
+    cumSec[i] = cumSec[i - 1] + dTick / ticksPerQuarterNote * (60 / changes[i - 1].bpm);
+  }
+  return (tick) => {
+    let i = changes.length - 1;
+    while (i > 0 && changes[i].tick > tick) i--;
+    return cumSec[i] + (tick - changes[i].tick) / ticksPerQuarterNote * (60 / changes[i].bpm);
+  };
+}
+function buildTimingSidecar(grid, defaultTempo, ticksPerQuarterNote) {
+  const tickToSec = makeTickToSec(grid.tempoEvents, defaultTempo, ticksPerQuarterNote);
+  const breakpoints = [];
+  const measureStartTicks = new Set(grid.measures.map((m) => m.startTick));
+  for (const m of grid.measures) {
+    breakpoints.push({
+      midiSec: tickToSec(m.startTick),
+      quarterPos: m.startTick / ticksPerQuarterNote,
+      measureNumber: m.measureNumber,
+      beatInMeasure: 0,
+      repeatIteration: m.repeatIteration
+    });
+  }
+  for (const ev of grid.tempoEvents) {
+    if (measureStartTicks.has(ev.tick)) continue;
+    const m = grid.measures.find((mm) => ev.tick >= mm.startTick && ev.tick < mm.endTick);
+    if (!m) continue;
+    breakpoints.push({
+      midiSec: tickToSec(ev.tick),
+      quarterPos: ev.tick / ticksPerQuarterNote,
+      measureNumber: m.measureNumber,
+      beatInMeasure: (ev.tick - m.startTick) / ticksPerQuarterNote,
+      repeatIteration: m.repeatIteration
+    });
+  }
+  const last = grid.measures[grid.measures.length - 1];
+  breakpoints.push({
+    midiSec: tickToSec(grid.totalTicks),
+    quarterPos: grid.totalTicks / ticksPerQuarterNote,
+    measureNumber: last ? last.measureNumber : "0",
+    beatInMeasure: last ? (grid.totalTicks - last.startTick) / ticksPerQuarterNote : 0,
+    repeatIteration: last ? last.repeatIteration : 0
+  });
+  breakpoints.sort((a, b) => a.midiSec - b.midiSec || a.quarterPos - b.quarterPos);
+  return {
+    version: "1",
+    durationSec: tickToSec(grid.totalTicks),
+    ticksPerQuarterNote,
+    breakpoints
+  };
+}
+function generatePlaybackTimeline(score, options = {}) {
+  const ticksPerQuarterNote = _nullishCoalesce(options.ticksPerQuarterNote, () => ( 480));
+  const defaultTempo = _nullishCoalesce(options.defaultTempo, () => ( 120));
+  const sequence = generatePlaybackSequence(score);
+  const grid = buildGridTimeline(score, ticksPerQuarterNote, sequence);
+  return buildTimingSidecar(grid, defaultTempo, ticksPerQuarterNote);
+}
+
 // src/query/index.ts
 function getNotesForVoice(measure, filter) {
   return measure.entries.filter((entry) => {
@@ -646,7 +828,7 @@ function isRestMeasure(measure) {
 }
 function getNormalizedPosition(note, measure, options) {
   const absolutePosition = getAbsolutePosition(note, measure);
-  const currentDivisions = _nullishCoalesce(_nullishCoalesce(options.currentDivisions, () => ( _optionalChain([measure, 'access', _5 => _5.attributes, 'optionalAccess', _6 => _6.divisions]))), () => ( 1));
+  const currentDivisions = _nullishCoalesce(_nullishCoalesce(options.currentDivisions, () => ( _optionalChain([measure, 'access', _11 => _11.attributes, 'optionalAccess', _12 => _12.divisions]))), () => ( 1));
   return absolutePosition * options.baseDivisions / currentDivisions;
 }
 function getNormalizedDuration(note, options) {
@@ -739,7 +921,7 @@ function getClefForStaff(score, options) {
         }
       }
     }
-    if (_optionalChain([measure, 'access', _7 => _7.attributes, 'optionalAccess', _8 => _8.clef])) {
+    if (_optionalChain([measure, 'access', _13 => _13.attributes, 'optionalAccess', _14 => _14.clef])) {
       for (const clef of measure.attributes.clef) {
         if ((_nullishCoalesce(clef.staff, () => ( 1))) === options.staff) {
           return clef;
@@ -767,7 +949,7 @@ function getStaffRange(score, partIndex) {
   let min = 1;
   let max = 1;
   for (const measure of part.measures) {
-    if (_optionalChain([measure, 'access', _9 => _9.attributes, 'optionalAccess', _10 => _10.staves]) !== void 0) {
+    if (_optionalChain([measure, 'access', _15 => _15.attributes, 'optionalAccess', _16 => _16.staves]) !== void 0) {
       max = Math.max(max, measure.attributes.staves);
     }
     for (const entry of measure.entries) {
@@ -785,15 +967,15 @@ function getEntriesAtPosition(measure, position, options) {
     const currentPosition = entry.type === "note" && entry.chord ? state.lastNonChordPosition : state.position;
     if (currentPosition === position) {
       if (entry.type === "note") {
-        if (_optionalChain([options, 'optionalAccess', _11 => _11.staff]) !== void 0 && (_nullishCoalesce(entry.staff, () => ( 1))) !== options.staff) {
+        if (_optionalChain([options, 'optionalAccess', _17 => _17.staff]) !== void 0 && (_nullishCoalesce(entry.staff, () => ( 1))) !== options.staff) {
           updatePositionForEntry(state, entry);
           continue;
         }
-        if (_optionalChain([options, 'optionalAccess', _12 => _12.voice]) !== void 0 && entry.voice !== options.voice) {
+        if (_optionalChain([options, 'optionalAccess', _18 => _18.voice]) !== void 0 && entry.voice !== options.voice) {
           updatePositionForEntry(state, entry);
           continue;
         }
-        if (_optionalChain([options, 'optionalAccess', _13 => _13.includeChordNotes]) === false && entry.chord) {
+        if (_optionalChain([options, 'optionalAccess', _19 => _19.includeChordNotes]) === false && entry.chord) {
           updatePositionForEntry(state, entry);
           continue;
         }
@@ -816,15 +998,15 @@ function getEntriesInRange(measure, range, options) {
     const currentPosition = entry.type === "note" && entry.chord ? state.lastNonChordPosition : state.position;
     if (currentPosition >= range.start && currentPosition < range.end) {
       if (entry.type === "note") {
-        if (_optionalChain([options, 'optionalAccess', _14 => _14.staff]) !== void 0 && (_nullishCoalesce(entry.staff, () => ( 1))) !== options.staff) {
+        if (_optionalChain([options, 'optionalAccess', _20 => _20.staff]) !== void 0 && (_nullishCoalesce(entry.staff, () => ( 1))) !== options.staff) {
           updatePositionForEntry(state, entry);
           continue;
         }
-        if (_optionalChain([options, 'optionalAccess', _15 => _15.voice]) !== void 0 && entry.voice !== options.voice) {
+        if (_optionalChain([options, 'optionalAccess', _21 => _21.voice]) !== void 0 && entry.voice !== options.voice) {
           updatePositionForEntry(state, entry);
           continue;
         }
-        if (_optionalChain([options, 'optionalAccess', _16 => _16.includeChordNotes]) === false && entry.chord) {
+        if (_optionalChain([options, 'optionalAccess', _22 => _22.includeChordNotes]) === false && entry.chord) {
           updatePositionForEntry(state, entry);
           continue;
         }
@@ -1030,13 +1212,13 @@ function getAdjacentNotes(score, context) {
 }
 function getDirections(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _17 => _17.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _18 => _18.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _23 => _23.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _24 => _24.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
-    const startMeasure = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _19 => _19.measureIndex]), () => ( 0));
-    const endMeasure = _optionalChain([options, 'optionalAccess', _20 => _20.measureIndex]) !== void 0 ? options.measureIndex + 1 : part.measures.length;
+    const startMeasure = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _25 => _25.measureIndex]), () => ( 0));
+    const endMeasure = _optionalChain([options, 'optionalAccess', _26 => _26.measureIndex]) !== void 0 ? options.measureIndex + 1 : part.measures.length;
     for (let measureIndex = startMeasure; measureIndex < endMeasure; measureIndex++) {
       const measure = part.measures[measureIndex];
       if (!measure) continue;
@@ -1077,8 +1259,8 @@ function findDirectionsByType(score, kind) {
 }
 function getDynamics(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _21 => _21.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _22 => _22.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _27 => _27.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _28 => _28.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1139,8 +1321,8 @@ function getTempoMarkings(score) {
 }
 function getPedalMarkings(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _23 => _23.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _24 => _24.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _29 => _29.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _30 => _30.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1169,8 +1351,8 @@ function getPedalMarkings(score, options) {
 }
 function getWedges(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _25 => _25.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _26 => _26.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _31 => _31.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _32 => _32.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1199,8 +1381,8 @@ function getWedges(score, options) {
 }
 function getOctaveShifts(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _27 => _27.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _28 => _28.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _33 => _33.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _34 => _34.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1230,8 +1412,8 @@ function getOctaveShifts(score, options) {
 }
 function getTiedNoteGroups(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _29 => _29.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _30 => _30.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _35 => _35.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _36 => _36.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1251,8 +1433,8 @@ function getTiedNoteGroups(score, options) {
             measureIndex,
             position
           };
-          const hasTieStart = _optionalChain([entry, 'access', _31 => _31.tie, 'optionalAccess', _32 => _32.type]) === "start" || _optionalChain([entry, 'access', _33 => _33.ties, 'optionalAccess', _34 => _34.some, 'call', _35 => _35((t) => t.type === "start")]) || _optionalChain([entry, 'access', _36 => _36.notations, 'optionalAccess', _37 => _37.some, 'call', _38 => _38((n) => n.type === "tied" && n.tiedType === "start")]);
-          const hasTieStop = _optionalChain([entry, 'access', _39 => _39.tie, 'optionalAccess', _40 => _40.type]) === "stop" || _optionalChain([entry, 'access', _41 => _41.ties, 'optionalAccess', _42 => _42.some, 'call', _43 => _43((t) => t.type === "stop")]) || _optionalChain([entry, 'access', _44 => _44.notations, 'optionalAccess', _45 => _45.some, 'call', _46 => _46((n) => n.type === "tied" && n.tiedType === "stop")]);
+          const hasTieStart = _optionalChain([entry, 'access', _37 => _37.tie, 'optionalAccess', _38 => _38.type]) === "start" || _optionalChain([entry, 'access', _39 => _39.ties, 'optionalAccess', _40 => _40.some, 'call', _41 => _41((t) => t.type === "start")]) || _optionalChain([entry, 'access', _42 => _42.notations, 'optionalAccess', _43 => _43.some, 'call', _44 => _44((n) => n.type === "tied" && n.tiedType === "start")]);
+          const hasTieStop = _optionalChain([entry, 'access', _45 => _45.tie, 'optionalAccess', _46 => _46.type]) === "stop" || _optionalChain([entry, 'access', _47 => _47.ties, 'optionalAccess', _48 => _48.some, 'call', _49 => _49((t) => t.type === "stop")]) || _optionalChain([entry, 'access', _50 => _50.notations, 'optionalAccess', _51 => _51.some, 'call', _52 => _52((n) => n.type === "tied" && n.tiedType === "stop")]);
           if (hasTieStop && pendingTies.has(pitchKey)) {
             const group = pendingTies.get(pitchKey);
             group.push(context);
@@ -1273,8 +1455,8 @@ function getTiedNoteGroups(score, options) {
 }
 function getSlurSpans(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _47 => _47.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _48 => _48.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _53 => _53.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _54 => _54.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1330,8 +1512,8 @@ function getSlurSpans(score, options) {
 }
 function getTupletGroups(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _49 => _49.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _50 => _50.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _55 => _55.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _56 => _56.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1355,8 +1537,8 @@ function getTupletGroups(score, options) {
               if (notation.type === "tuplet") {
                 const tupletNumber = _nullishCoalesce(notation.number, () => ( 1));
                 if (notation.tupletType === "start") {
-                  const actualNotes = _nullishCoalesce(_optionalChain([entry, 'access', _51 => _51.timeModification, 'optionalAccess', _52 => _52.actualNotes]), () => ( 3));
-                  const normalNotes = _nullishCoalesce(_optionalChain([entry, 'access', _53 => _53.timeModification, 'optionalAccess', _54 => _54.normalNotes]), () => ( 2));
+                  const actualNotes = _nullishCoalesce(_optionalChain([entry, 'access', _57 => _57.timeModification, 'optionalAccess', _58 => _58.actualNotes]), () => ( 3));
+                  const normalNotes = _nullishCoalesce(_optionalChain([entry, 'access', _59 => _59.timeModification, 'optionalAccess', _60 => _60.normalNotes]), () => ( 2));
                   pendingTuplets.set(tupletNumber, {
                     notes: [context],
                     actualNotes,
@@ -1376,7 +1558,7 @@ function getTupletGroups(score, options) {
               }
             }
           }
-          if (entry.timeModification && !_optionalChain([entry, 'access', _55 => _55.notations, 'optionalAccess', _56 => _56.some, 'call', _57 => _57((n) => n.type === "tuplet")])) {
+          if (entry.timeModification && !_optionalChain([entry, 'access', _61 => _61.notations, 'optionalAccess', _62 => _62.some, 'call', _63 => _63((n) => n.type === "tuplet")])) {
             for (const [, pending] of pendingTuplets) {
               if (entry.timeModification.actualNotes === pending.actualNotes && entry.timeModification.normalNotes === pending.normalNotes) {
                 pending.notes.push(context);
@@ -1429,8 +1611,8 @@ function getBeamGroups(measure) {
 }
 function findNotesWithNotation(score, notationType, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _58 => _58.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _59 => _59.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _64 => _64.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _65 => _65.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1440,7 +1622,7 @@ function findNotesWithNotation(score, notationType, options) {
       for (const entry of measure.entries) {
         if (entry.type === "note") {
           const position = entry.chord ? state.lastNonChordPosition : state.position;
-          if (_optionalChain([entry, 'access', _60 => _60.notations, 'optionalAccess', _61 => _61.some, 'call', _62 => _62((n) => n.type === notationType)])) {
+          if (_optionalChain([entry, 'access', _66 => _66.notations, 'optionalAccess', _67 => _67.some, 'call', _68 => _68((n) => n.type === notationType)])) {
             results.push({
               note: entry,
               part,
@@ -1459,8 +1641,8 @@ function findNotesWithNotation(score, notationType, options) {
 }
 function getHarmonies(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _63 => _63.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _64 => _64.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _69 => _69.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _70 => _70.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1523,8 +1705,8 @@ function getChordProgression(score, options) {
 }
 function getLyrics(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _65 => _65.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _66 => _66.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _71 => _71.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _72 => _72.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1536,7 +1718,7 @@ function getLyrics(score, options) {
           const position = entry.chord ? state.lastNonChordPosition : state.position;
           for (const lyric of entry.lyrics) {
             const verse = _nullishCoalesce(lyric.number, () => ( 1));
-            if (_optionalChain([options, 'optionalAccess', _67 => _67.verse]) !== void 0 && verse !== options.verse) {
+            if (_optionalChain([options, 'optionalAccess', _73 => _73.verse]) !== void 0 && verse !== options.verse) {
               continue;
             }
             results.push({
@@ -1596,8 +1778,8 @@ function getLyricText(score, options) {
 }
 function getVerseCount(score, options) {
   const verses = /* @__PURE__ */ new Set();
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _68 => _68.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _69 => _69.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _74 => _74.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _75 => _75.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1615,7 +1797,7 @@ function getVerseCount(score, options) {
 }
 function getRepeatStructure(score, options) {
   const results = [];
-  const partIndex = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _70 => _70.partIndex]), () => ( 0));
+  const partIndex = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _76 => _76.partIndex]), () => ( 0));
   const part = score.parts[partIndex];
   if (!part) return results;
   for (let measureIndex = 0; measureIndex < part.measures.length; measureIndex++) {
@@ -1638,8 +1820,8 @@ function getRepeatStructure(score, options) {
 }
 function findBarlines(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _71 => _71.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _72 => _72.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _77 => _77.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _78 => _78.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1648,10 +1830,10 @@ function findBarlines(score, options) {
       const measureNumber = _nullishCoalesce(measure.number, () => ( String(measureIndex + 1)));
       if (measure.barlines) {
         for (const barline of measure.barlines) {
-          if (_optionalChain([options, 'optionalAccess', _73 => _73.style]) !== void 0 && barline.barStyle !== options.style) {
+          if (_optionalChain([options, 'optionalAccess', _79 => _79.style]) !== void 0 && barline.barStyle !== options.style) {
             continue;
           }
-          if (_optionalChain([options, 'optionalAccess', _74 => _74.repeat]) !== void 0) {
+          if (_optionalChain([options, 'optionalAccess', _80 => _80.repeat]) !== void 0) {
             const hasRepeat = barline.repeat !== void 0;
             if (hasRepeat !== options.repeat) {
               continue;
@@ -1671,8 +1853,8 @@ function findBarlines(score, options) {
 }
 function getEndings(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _75 => _75.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _76 => _76.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _81 => _81.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _82 => _82.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1698,8 +1880,8 @@ function getEndings(score, options) {
 }
 function getKeyChanges(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _77 => _77.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _78 => _78.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _83 => _83.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _84 => _84.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1708,7 +1890,7 @@ function getKeyChanges(score, options) {
       const measure = part.measures[measureIndex];
       const measureNumber = _nullishCoalesce(measure.number, () => ( String(measureIndex + 1)));
       const state = createPositionState();
-      if (_optionalChain([measure, 'access', _79 => _79.attributes, 'optionalAccess', _80 => _80.key])) {
+      if (_optionalChain([measure, 'access', _85 => _85.attributes, 'optionalAccess', _86 => _86.key])) {
         const key = measure.attributes.key;
         if (!lastKey || lastKey.fifths !== key.fifths || lastKey.mode !== key.mode) {
           results.push({
@@ -1743,8 +1925,8 @@ function getKeyChanges(score, options) {
 }
 function getTimeChanges(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _81 => _81.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _82 => _82.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _87 => _87.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _88 => _88.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1752,7 +1934,7 @@ function getTimeChanges(score, options) {
     for (let measureIndex = 0; measureIndex < part.measures.length; measureIndex++) {
       const measure = part.measures[measureIndex];
       const measureNumber = _nullishCoalesce(measure.number, () => ( String(measureIndex + 1)));
-      if (_optionalChain([measure, 'access', _83 => _83.attributes, 'optionalAccess', _84 => _84.time])) {
+      if (_optionalChain([measure, 'access', _89 => _89.attributes, 'optionalAccess', _90 => _90.time])) {
         const time = measure.attributes.time;
         if (!lastTime || lastTime.beats !== time.beats || lastTime.beatType !== time.beatType) {
           results.push({
@@ -1784,8 +1966,8 @@ function getTimeChanges(score, options) {
 }
 function getClefChanges(score, options) {
   const results = [];
-  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _85 => _85.partIndex]), () => ( 0));
-  const endPart = _optionalChain([options, 'optionalAccess', _86 => _86.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
+  const startPart = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _91 => _91.partIndex]), () => ( 0));
+  const endPart = _optionalChain([options, 'optionalAccess', _92 => _92.partIndex]) !== void 0 ? options.partIndex + 1 : score.parts.length;
   for (let partIndex = startPart; partIndex < endPart; partIndex++) {
     const part = score.parts[partIndex];
     if (!part) continue;
@@ -1794,10 +1976,10 @@ function getClefChanges(score, options) {
       const measure = part.measures[measureIndex];
       const measureNumber = _nullishCoalesce(measure.number, () => ( String(measureIndex + 1)));
       const state = createPositionState();
-      if (_optionalChain([measure, 'access', _87 => _87.attributes, 'optionalAccess', _88 => _88.clef])) {
+      if (_optionalChain([measure, 'access', _93 => _93.attributes, 'optionalAccess', _94 => _94.clef])) {
         for (const clef of measure.attributes.clef) {
           const staff = _nullishCoalesce(clef.staff, () => ( 1));
-          if (_optionalChain([options, 'optionalAccess', _89 => _89.staff]) !== void 0 && staff !== options.staff) {
+          if (_optionalChain([options, 'optionalAccess', _95 => _95.staff]) !== void 0 && staff !== options.staff) {
             continue;
           }
           const lastClef = lastClefs.get(staff);
@@ -1818,7 +2000,7 @@ function getClefChanges(score, options) {
         if (entry.type === "attributes" && entry.attributes.clef) {
           for (const clef of entry.attributes.clef) {
             const staff = _nullishCoalesce(clef.staff, () => ( 1));
-            if (_optionalChain([options, 'optionalAccess', _90 => _90.staff]) !== void 0 && staff !== options.staff) {
+            if (_optionalChain([options, 'optionalAccess', _96 => _96.staff]) !== void 0 && staff !== options.staff) {
               continue;
             }
             const lastClef = lastClefs.get(staff);
@@ -1881,14 +2063,14 @@ function getDivisions(score, options) {
     const m = part.measures[i];
     const mNum = parseInt(m.number, 10);
     if (!isNaN(mNum) && mNum > targetMeasure) break;
-    if (_optionalChain([m, 'access', _91 => _91.attributes, 'optionalAccess', _92 => _92.divisions]) !== void 0) {
+    if (_optionalChain([m, 'access', _97 => _97.attributes, 'optionalAccess', _98 => _98.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 (_optionalChain([m, 'access', _93 => _93.attributes, 'optionalAccess', _94 => _94.divisions]) !== void 0) {
+    if (_optionalChain([m, 'access', _99 => _99.attributes, 'optionalAccess', _100 => _100.divisions]) !== void 0) {
       divisions = m.attributes.divisions;
     }
   }
@@ -1949,7 +2131,7 @@ function getDuration(score) {
   let totalDuration = 0;
   let divisions = 1;
   for (const measure of part.measures) {
-    if (_optionalChain([measure, 'access', _95 => _95.attributes, 'optionalAccess', _96 => _96.divisions]) !== void 0) {
+    if (_optionalChain([measure, 'access', _101 => _101.attributes, 'optionalAccess', _102 => _102.divisions]) !== void 0) {
       divisions = measure.attributes.divisions;
     }
     let measureDuration = 0;
@@ -1978,7 +2160,7 @@ function hasMultipleStaves(score, partIndex = 0) {
   const part = score.parts[partIndex];
   if (!part) return false;
   for (const measure of part.measures) {
-    if (_optionalChain([measure, 'access', _97 => _97.attributes, 'optionalAccess', _98 => _98.staves]) !== void 0 && measure.attributes.staves > 1) {
+    if (_optionalChain([measure, 'access', _103 => _103.attributes, 'optionalAccess', _104 => _104.staves]) !== void 0 && measure.attributes.staves > 1) {
       return true;
     }
   }
@@ -1988,7 +2170,7 @@ function getStaveCount(score, partIndex = 0) {
   const part = score.parts[partIndex];
   if (!part) return 1;
   for (const measure of part.measures) {
-    if (_optionalChain([measure, 'access', _99 => _99.attributes, 'optionalAccess', _100 => _100.staves]) !== void 0) {
+    if (_optionalChain([measure, 'access', _105 => _105.attributes, 'optionalAccess', _106 => _106.staves]) !== void 0) {
       return measure.attributes.staves;
     }
   }
@@ -2147,4 +2329,8 @@ function pitchesEqual(a, b) {
 
 
 
-exports.extractPlaybackControls = extractPlaybackControls; exports.generatePlaybackSequence = generatePlaybackSequence; exports.hasPlaybackControls = hasPlaybackControls; exports.STEPS = STEPS; exports.STEP_SEMITONES = STEP_SEMITONES; exports.pitchToSemitone = pitchToSemitone; exports.getAccidentalsInMeasure = getAccidentalsInMeasure; exports.semitoneToKeyAwarePitch = semitoneToKeyAwarePitch; exports.determineAccidental = determineAccidental; exports.getAbsolutePositionForNote = getAbsolutePositionForNote; exports.getMeasureEndPosition = getMeasureEndPosition; exports.getNotesForVoice = getNotesForVoice; exports.getNotesForStaff = getNotesForStaff; exports.groupByVoice = groupByVoice; exports.groupByStaff = groupByStaff; exports.getAbsolutePosition = getAbsolutePosition; exports.withAbsolutePositions = withAbsolutePositions; exports.getChords = getChords; exports.iterateNotes = iterateNotes; exports.getAllNotes = getAllNotes; exports.getVoices = getVoices; exports.getStaves = getStaves; exports.hasNotes = hasNotes; exports.isRestMeasure = isRestMeasure; exports.getNormalizedPosition = getNormalizedPosition; exports.getNormalizedDuration = getNormalizedDuration; exports.getEntriesForStaff = getEntriesForStaff; exports.buildVoiceToStaffMap = buildVoiceToStaffMap; exports.buildVoiceToStaffMapForPart = buildVoiceToStaffMapForPart; exports.inferStaff = inferStaff; exports.getEffectiveStaff = getEffectiveStaff; exports.getClefForStaff = getClefForStaff; exports.getVoicesForStaff = getVoicesForStaff; exports.getStaffRange = getStaffRange; exports.getEntriesAtPosition = getEntriesAtPosition; exports.getNotesAtPosition = getNotesAtPosition; exports.getEntriesInRange = getEntriesInRange; exports.getNotesInRange = getNotesInRange; exports.getVerticalSlice = getVerticalSlice; exports.getVoiceLine = getVoiceLine; exports.getVoiceLineInRange = getVoiceLineInRange; exports.iterateEntries = iterateEntries; exports.getNextNote = getNextNote; exports.getPrevNote = getPrevNote; exports.getAdjacentNotes = getAdjacentNotes; exports.getDirections = getDirections; exports.getDirectionsAtPosition = getDirectionsAtPosition; exports.findDirectionsByType = findDirectionsByType; exports.getDynamics = getDynamics; exports.getTempoMarkings = getTempoMarkings; exports.getPedalMarkings = getPedalMarkings; exports.getWedges = getWedges; exports.getOctaveShifts = getOctaveShifts; exports.getTiedNoteGroups = getTiedNoteGroups; exports.getSlurSpans = getSlurSpans; exports.getTupletGroups = getTupletGroups; exports.getBeamGroups = getBeamGroups; exports.findNotesWithNotation = findNotesWithNotation; exports.getHarmonies = getHarmonies; exports.getHarmonyAtPosition = getHarmonyAtPosition; exports.getChordProgression = getChordProgression; exports.getLyrics = getLyrics; exports.getLyricText = getLyricText; exports.getVerseCount = getVerseCount; exports.getRepeatStructure = getRepeatStructure; exports.findBarlines = findBarlines; exports.getEndings = getEndings; exports.getKeyChanges = getKeyChanges; exports.getTimeChanges = getTimeChanges; exports.getClefChanges = getClefChanges; exports.getStructuralChanges = getStructuralChanges; exports.getPartByIndex = getPartByIndex; exports.getPartCount = getPartCount; exports.getPartIds = getPartIds; exports.getMeasure = getMeasure; exports.getMeasureByIndex = getMeasureByIndex; exports.getMeasureCount = getMeasureCount; exports.getDivisions = getDivisions; exports.getAttributesAtMeasure = getAttributesAtMeasure; exports.findNotes = findNotes; exports.getDuration = getDuration; exports.getPartById = getPartById; exports.getPartIndex = getPartIndex; exports.hasMultipleStaves = hasMultipleStaves; exports.getStaveCount = getStaveCount; exports.measureRoundtrip = measureRoundtrip; exports.countNotes = countNotes; exports.scoresEqual = scoresEqual;
+
+
+
+
+exports.extractPlaybackControls = extractPlaybackControls; exports.generatePlaybackSequence = generatePlaybackSequence; exports.hasPlaybackControls = hasPlaybackControls; exports.measureEndTick = measureEndTick; exports.buildGridTimeline = buildGridTimeline; exports.buildTimingSidecar = buildTimingSidecar; exports.generatePlaybackTimeline = generatePlaybackTimeline; exports.STEPS = STEPS; exports.STEP_SEMITONES = STEP_SEMITONES; exports.pitchToSemitone = pitchToSemitone; exports.getAccidentalsInMeasure = getAccidentalsInMeasure; exports.semitoneToKeyAwarePitch = semitoneToKeyAwarePitch; exports.determineAccidental = determineAccidental; exports.getAbsolutePositionForNote = getAbsolutePositionForNote; exports.getMeasureEndPosition = getMeasureEndPosition; exports.getNotesForVoice = getNotesForVoice; exports.getNotesForStaff = getNotesForStaff; exports.groupByVoice = groupByVoice; exports.groupByStaff = groupByStaff; exports.getAbsolutePosition = getAbsolutePosition; exports.withAbsolutePositions = withAbsolutePositions; exports.getChords = getChords; exports.iterateNotes = iterateNotes; exports.getAllNotes = getAllNotes; exports.getVoices = getVoices; exports.getStaves = getStaves; exports.hasNotes = hasNotes; exports.isRestMeasure = isRestMeasure; exports.getNormalizedPosition = getNormalizedPosition; exports.getNormalizedDuration = getNormalizedDuration; exports.getEntriesForStaff = getEntriesForStaff; exports.buildVoiceToStaffMap = buildVoiceToStaffMap; exports.buildVoiceToStaffMapForPart = buildVoiceToStaffMapForPart; exports.inferStaff = inferStaff; exports.getEffectiveStaff = getEffectiveStaff; exports.getClefForStaff = getClefForStaff; exports.getVoicesForStaff = getVoicesForStaff; exports.getStaffRange = getStaffRange; exports.getEntriesAtPosition = getEntriesAtPosition; exports.getNotesAtPosition = getNotesAtPosition; exports.getEntriesInRange = getEntriesInRange; exports.getNotesInRange = getNotesInRange; exports.getVerticalSlice = getVerticalSlice; exports.getVoiceLine = getVoiceLine; exports.getVoiceLineInRange = getVoiceLineInRange; exports.iterateEntries = iterateEntries; exports.getNextNote = getNextNote; exports.getPrevNote = getPrevNote; exports.getAdjacentNotes = getAdjacentNotes; exports.getDirections = getDirections; exports.getDirectionsAtPosition = getDirectionsAtPosition; exports.findDirectionsByType = findDirectionsByType; exports.getDynamics = getDynamics; exports.getTempoMarkings = getTempoMarkings; exports.getPedalMarkings = getPedalMarkings; exports.getWedges = getWedges; exports.getOctaveShifts = getOctaveShifts; exports.getTiedNoteGroups = getTiedNoteGroups; exports.getSlurSpans = getSlurSpans; exports.getTupletGroups = getTupletGroups; exports.getBeamGroups = getBeamGroups; exports.findNotesWithNotation = findNotesWithNotation; exports.getHarmonies = getHarmonies; exports.getHarmonyAtPosition = getHarmonyAtPosition; exports.getChordProgression = getChordProgression; exports.getLyrics = getLyrics; exports.getLyricText = getLyricText; exports.getVerseCount = getVerseCount; exports.getRepeatStructure = getRepeatStructure; exports.findBarlines = findBarlines; exports.getEndings = getEndings; exports.getKeyChanges = getKeyChanges; exports.getTimeChanges = getTimeChanges; exports.getClefChanges = getClefChanges; exports.getStructuralChanges = getStructuralChanges; exports.getPartByIndex = getPartByIndex; exports.getPartCount = getPartCount; exports.getPartIds = getPartIds; exports.getMeasure = getMeasure; exports.getMeasureByIndex = getMeasureByIndex; exports.getMeasureCount = getMeasureCount; exports.getDivisions = getDivisions; exports.getAttributesAtMeasure = getAttributesAtMeasure; exports.findNotes = findNotes; exports.getDuration = getDuration; exports.getPartById = getPartById; exports.getPartIndex = getPartIndex; exports.hasMultipleStaves = hasMultipleStaves; exports.getStaveCount = getStaveCount; exports.measureRoundtrip = measureRoundtrip; exports.countNotes = countNotes; exports.scoresEqual = scoresEqual;