@libraz/libcantus 1.2.0 → 1.4.0

package/dist/{chunk-HPVSH7SF.cjs → chunk-3MDOEFIQ.cjs}

@@ -30,7 +30,6 @@
 
 
 
-var _chunkSGLEQVJHcjs = require('./chunk-SGLEQVJH.cjs');
 
 
 
@@ -41,7 +40,6 @@ var _chunkSGLEQVJHcjs = require('./chunk-SGLEQVJH.cjs');
 
 
 
-var _chunk3R3QVKY5cjs = require('./chunk-3R3QVKY5.cjs');
 
 
 
@@ -60,17 +58,42 @@ var _chunk3R3QVKY5cjs = require('./chunk-3R3QVKY5.cjs');
 
 
 
+var _chunkLQZQDBCDcjs = require('./chunk-LQZQDBCD.cjs');
 
 
 
 
 
-var _chunkS5BKZZGMcjs = require('./chunk-S5BKZZGM.cjs');
+
+
+var _chunkYDGMWH43cjs = require('./chunk-YDGMWH43.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkS3QELJUEcjs = require('./chunk-S3QELJUE.cjs');
 
 // src/analyze/arrange/internal.ts
 var MAX_LANE_LEAP = 24;
 function covers(note, beat) {
-  return beat >= note.startBeat - _chunkS5BKZZGMcjs.BEAT_EPS && beat < note.endBeat - _chunkS5BKZZGMcjs.BEAT_EPS;
+  return beat >= note.startBeat - _chunkS3QELJUEcjs.BEAT_EPS && beat < note.endBeat - _chunkS3QELJUEcjs.BEAT_EPS;
 }
 function isPercussion(role) {
   return role === "drums";
@@ -84,31 +107,31 @@ var TRACK_ROLE_TABLE = {
 };
 var TRACK_ROLES = Object.keys(TRACK_ROLE_TABLE);
 function trackRoleOf(role, name) {
-  return role === void 0 ? "other" : _chunkS5BKZZGMcjs.assertOneOf.call(void 0, role, TRACK_ROLES, name);
+  return role === void 0 ? "other" : _chunkS3QELJUEcjs.assertOneOf.call(void 0, role, TRACK_ROLES, name);
 }
 var DEFAULT_PROFILE = "pop";
-var SAFETY_PROFILES = Object.keys(_chunk3R3QVKY5cjs.PROFILE_WEIGHTS);
+var SAFETY_PROFILES = Object.keys(_chunkYDGMWH43cjs.PROFILE_WEIGHTS);
 function arrangementProfile(profile) {
-  return _chunkS5BKZZGMcjs.assertOneOf.call(void 0, _nullishCoalesce(profile, () => ( DEFAULT_PROFILE)), SAFETY_PROFILES, "arrangement profile");
+  return _chunkS3QELJUEcjs.assertOneOf.call(void 0, _nullishCoalesce(profile, () => ( DEFAULT_PROFILE)), SAFETY_PROFILES, "arrangement profile");
 }
 function assertTrackNotes(tracks, options) {
-  _chunkS5BKZZGMcjs.assertArray.call(void 0, tracks, "arrangement tracks");
+  _chunkS3QELJUEcjs.assertArray.call(void 0, tracks, "arrangement tracks");
   let noteCount = 0;
   for (let index = 0; index < tracks.length; index += 1) {
     const notes = _optionalChain([tracks, 'access', _2 => _2[index], 'optionalAccess', _3 => _3.notes]);
     if (!Array.isArray(notes)) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
-        `tracks[${index}].notes must be an array; received ${typeof notes}`
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+        `tracks[${index}].notes must be an array; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, notes)}`
       );
     }
-    _chunkS5BKZZGMcjs.assertNoteEvents.call(void 0, notes, `tracks[${index}].notes`, options);
+    _chunkS3QELJUEcjs.assertNoteEvents.call(void 0, notes, `tracks[${index}].notes`, options);
     noteCount += notes.length;
   }
   return noteCount;
 }
 function assertGivenTimeline(timeline, name) {
   if (timeline !== void 0) {
-    _chunkSGLEQVJHcjs.assertChordTimeline.call(void 0, timeline, name);
+    _chunkLQZQDBCDcjs.assertChordTimeline.call(void 0, timeline, name);
   }
 }
 function assertGivenKeys(keys, name) {
@@ -116,26 +139,27 @@ function assertGivenKeys(keys, name) {
     return;
   }
   if (!Array.isArray(keys)) {
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
-      `${name} must be an array of key regions; received ${_chunkS5BKZZGMcjs.describeRejected.call(void 0, keys)}`
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+      `${name} must be an array of key regions; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, keys)}`
     );
   }
   for (let index = 0; index < keys.length; index += 1) {
     const region = keys[index];
     if (typeof region !== "object" || region === null) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
-        `${name}[${index}] must be a key region; received ${_chunkS5BKZZGMcjs.describeRejected.call(void 0, region)}`
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+        `${name}[${index}] must be a key region; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, region)}`
       );
     }
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, region.startBeat, `${name}[${index}].startBeat`);
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, region.endBeat, `${name}[${index}].endBeat`);
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, region.startBeat, `${name}[${index}].startBeat`);
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, region.endBeat, `${name}[${index}].endBeat`);
     if (region.key === void 0 || region.key === null || typeof region.key !== "string" && typeof region.key !== "object") {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
-        `${name}[${index}].key must name a key; received ${_chunkS5BKZZGMcjs.describeRejected.call(void 0, region.key)}`
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+        `${name}[${index}].key must name a key; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, region.key)}`
       );
     }
-    _chunk3R3QVKY5cjs.resolveKey.call(void 0, region.key);
+    _chunkYDGMWH43cjs.resolveKey.call(void 0, region.key);
   }
+  _chunkLQZQDBCDcjs.assertSpansInOrder.call(void 0, keys, name);
 }
 function harmonyTrackSet(harmonyTracks, tracks, name = "harmonyTracks") {
   if (harmonyTracks === void 0) {
@@ -145,16 +169,16 @@ function harmonyTrackSet(harmonyTracks, tracks, name = "harmonyTracks") {
   for (let index = 0; index < harmonyTracks.length; index += 1) {
     const value = harmonyTracks[index];
     if (value === void 0 || !Number.isFinite(value)) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`${name}[${index}] must be a track index; received ${value}`);
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(`${name}[${index}] must be a track index; received ${value}`);
     }
     const track = Math.trunc(value);
     if (track < 0 || track >= tracks.length) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         `${name}[${index}] ${track} is outside the arrangement's ${tracks.length} tracks`
       );
     }
     if (isPercussion(_optionalChain([tracks, 'access', _4 => _4[track], 'optionalAccess', _5 => _5.role]))) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         `${name}[${index}] ${track} names a percussion track, whose pitches state no harmony`
       );
     }
@@ -195,7 +219,7 @@ function splitIntoSubVoices(ordered) {
         continue;
       }
       const end = last.startBeat + last.durationBeat;
-      if (!_chunkSGLEQVJHcjs.hasEnded.call(void 0, end, note.startBeat)) {
+      if (!_chunkLQZQDBCDcjs.hasEnded.call(void 0, end, note.startBeat)) {
         continue;
       }
       const distance = Math.abs(last.pitch - note.pitch);
@@ -216,13 +240,13 @@ function splitIntoSubVoices(ordered) {
   for (let start = 0; start < ordered.length; ) {
     const onset = _nullishCoalesce(_optionalChain([ordered, 'access', _13 => _13[start], 'optionalAccess', _14 => _14.startBeat]), () => ( 0));
     let end = start + 1;
-    while (end < ordered.length && _chunkSGLEQVJHcjs.sameInstant.call(void 0, _nullishCoalesce(_optionalChain([ordered, 'access', _15 => _15[end], 'optionalAccess', _16 => _16.startBeat]), () => ( 0)), onset)) {
+    while (end < ordered.length && _chunkLQZQDBCDcjs.sameInstant.call(void 0, _nullishCoalesce(_optionalChain([ordered, 'access', _15 => _15[end], 'optionalAccess', _16 => _16.startBeat]), () => ( 0)), onset)) {
       end += 1;
     }
     const block = ordered.slice(start, end);
     if (block.length > 1) {
       const freeLanes = lanes.map((lane, index) => ({ index, last: lane[lane.length - 1] })).filter(
-        (entry) => entry.last !== void 0 && _chunkSGLEQVJHcjs.hasEnded.call(void 0, entry.last.startBeat + entry.last.durationBeat, onset)
+        (entry) => entry.last !== void 0 && _chunkLQZQDBCDcjs.hasEnded.call(void 0, entry.last.startBeat + entry.last.durationBeat, onset)
       ).sort((a, b) => a.last.pitch - b.last.pitch);
       const assignment = pairWithFreeLanes(block, freeLanes);
       const taken = new Set(
@@ -310,7 +334,7 @@ function lastStartingAtOrBefore(sounding, beat) {
   let high = sounding.length;
   while (low < high) {
     const middle = Math.floor((low + high) / 2);
-    if ((_nullishCoalesce(_optionalChain([sounding, 'access', _22 => _22[middle], 'optionalAccess', _23 => _23.startBeat]), () => ( Number.POSITIVE_INFINITY))) <= beat + _chunkS5BKZZGMcjs.BEAT_EPS) {
+    if ((_nullishCoalesce(_optionalChain([sounding, 'access', _22 => _22[middle], 'optionalAccess', _23 => _23.startBeat]), () => ( Number.POSITIVE_INFINITY))) <= beat + _chunkS3QELJUEcjs.BEAT_EPS) {
       low = middle + 1;
     } else {
       high = middle;
@@ -321,12 +345,17 @@ function lastStartingAtOrBefore(sounding, beat) {
 function prepareTracks(tracks) {
   let nextId = 0;
   return tracks.map((track, index) => {
-    const ordered = track.notes.map((note, originalIndex) => ({ note, originalIndex })).filter(({ note }) => note.durationBeat > 0).sort((a, b) => a.note.startBeat - b.note.startBeat || a.note.pitch - b.note.pitch).map(({ note, originalIndex }) => ({ ...note, id: nextId++, originalIndex }));
+    const ordered = track.notes.map((note, originalIndex) => ({ note, originalIndex })).filter(({ note }) => note.durationBeat > 0).sort((a, b) => a.note.startBeat - b.note.startBeat || a.note.pitch - b.note.pitch).map(({ note, originalIndex }) => ({
+      ...note,
+      pitch: note.pitch === 0 ? 0 : note.pitch,
+      id: nextId++,
+      originalIndex
+    }));
     const voices = splitIntoSubVoices(ordered).map((voice) => {
       const sounding = voice.map((note, i) => {
         const prev = i > 0 ? voice[i - 1] : void 0;
         const prevEnd = prev === void 0 ? void 0 : prev.startBeat + prev.durationBeat;
-        const contiguous = prevEnd !== void 0 && _chunkSGLEQVJHcjs.adjacent.call(void 0, prevEnd, note.startBeat);
+        const contiguous = prevEnd !== void 0 && _chunkLQZQDBCDcjs.adjacent.call(void 0, prevEnd, note.startBeat);
         return {
           id: note.id,
           originalIndex: note.originalIndex,
@@ -359,24 +388,25 @@ function withGivenKeys(result, given) {
   if (given === void 0) {
     return result;
   }
-  return { ...result, keys: given, prevailingKey: _nullishCoalesce(_chunkSGLEQVJHcjs.prevailingKeyOf.call(void 0, given), () => ( result.prevailingKey)) };
+  return { ...result, keys: given, prevailingKey: _nullishCoalesce(_chunkLQZQDBCDcjs.prevailingKeyOf.call(void 0, given), () => ( result.prevailingKey)) };
 }
 function callerTimeline(timeline, key, given, pooled, meters, budget) {
-  const chartEnd = timeline.segments.reduce((end, segment) => Math.max(end, segment.endBeat), 0);
-  const soundingEnd = pooled.reduce(
-    (end, note) => Math.max(end, note.startBeat + note.durationBeat),
-    0
+  const chartEnd = timeline.segments.reduce(
+    (end, segment) => Math.max(end, segment.endBeat),
+    Number.NEGATIVE_INFINITY
   );
-  const totalBeats = Math.max(chartEnd, soundingEnd);
-  const { startBeat: musicStart } = _chunkSGLEQVJHcjs.gridForNotes.call(void 0, pooled, _chunkS5BKZZGMcjs.beatsPerBarAt.call(void 0, 0, meters));
-  const keys = _nullishCoalesce(given, () => ( _chunkSGLEQVJHcjs.attachPivots.call(void 0, 
-    key !== void 0 ? [{ startBeat: musicStart, endBeat: totalBeats, key: _chunk3R3QVKY5cjs.resolveKey.call(void 0, key), confidence: 1 }] : _chunkSGLEQVJHcjs.keyTimelineFromNotes.call(void 0, pooled, { meters, totalBeats, budget }),
+  const soundingEnd = _chunkLQZQDBCDcjs.latestSoundingEnd.call(void 0, pooled, Number.NEGATIVE_INFINITY);
+  const spanEnd = Math.max(chartEnd, soundingEnd);
+  const totalBeats = Number.isFinite(spanEnd) ? spanEnd : 0;
+  const { startBeat: musicStart } = _chunkLQZQDBCDcjs.gridForNotes.call(void 0, pooled, _chunkS3QELJUEcjs.beatsPerBarAt.call(void 0, 0, meters));
+  const keys = _nullishCoalesce(given, () => ( _chunkLQZQDBCDcjs.attachPivots.call(void 0, 
+    key !== void 0 ? _chunkLQZQDBCDcjs.statedKeyRegions.call(void 0, _chunkYDGMWH43cjs.resolveKey.call(void 0, key), musicStart, totalBeats) : _chunkLQZQDBCDcjs.keyTimelineFromNotes.call(void 0, pooled, { meters, totalBeats, budget }),
     timeline.segments
   )));
   return {
     timeline,
     keys,
-    prevailingKey: _nullishCoalesce(_chunkSGLEQVJHcjs.prevailingKeyOf.call(void 0, keys), () => ( _chunk3R3QVKY5cjs.resolveKey.call(void 0, _chunk3R3QVKY5cjs.majorKey.call(void 0, 0)))),
+    prevailingKey: _nullishCoalesce(_chunkLQZQDBCDcjs.prevailingKeyOf.call(void 0, keys), () => ( _chunkYDGMWH43cjs.resolveKey.call(void 0, _chunkYDGMWH43cjs.majorKey.call(void 0, 0)))),
     segmentConfidence: timeline.segments.map(() => 0)
   };
 }
@@ -393,7 +423,7 @@ function soundingVoicesAt(prepared, beat) {
         continue;
       }
       const snap = { pitch: note.pitch };
-      const previous = _chunkSGLEQVJHcjs.sameInstant.call(void 0, note.startBeat, beat) ? note.prevPitch : note.pitch;
+      const previous = _chunkLQZQDBCDcjs.sameInstant.call(void 0, note.startBeat, beat) ? note.prevPitch : note.pitch;
       if (previous !== void 0) {
         snap.prevPitch = previous;
       }
@@ -422,11 +452,11 @@ function snapshotsOf(voices) {
   return voices.map(({ snapshot }) => snapshot);
 }
 function analyzePolyphony(notes, chordAtBeat, key) {
-  const passage = _chunkS5BKZZGMcjs.assertNoteEvents.call(void 0, notes, "notes", { allowNonPositiveDuration: true });
-  _chunkS5BKZZGMcjs.assertFunction.call(void 0, chordAtBeat, "chordAtBeat");
+  const passage = _chunkS3QELJUEcjs.assertNoteEvents.call(void 0, notes, "notes", { allowNonPositiveDuration: true });
+  _chunkS3QELJUEcjs.assertFunction.call(void 0, chordAtBeat, "chordAtBeat");
   const prepared = prepareTracks([{ notes: [...passage] }]);
   const track = prepared[0];
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, 
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, 
     passage.length * (_nullishCoalesce(_optionalChain([track, 'optionalAccess', _29 => _29.voices, 'access', _30 => _30.length]), () => ( 0))),
     "polyphony note-voice comparisons"
   );
@@ -437,7 +467,7 @@ function analyzePolyphony(notes, chordAtBeat, key) {
     if (subVoice === void 0) {
       continue;
     }
-    const analyzed = _chunkSGLEQVJHcjs.analyzeVoice.call(void 0, 
+    const analyzed = _chunkLQZQDBCDcjs.analyzeVoice.call(void 0, 
       subVoice.voice,
       chordAtBeat,
       key,
@@ -455,7 +485,7 @@ function analyzePolyphony(notes, chordAtBeat, key) {
     if (analyzed !== void 0) {
       return analyzed;
     }
-    const [only] = _chunkSGLEQVJHcjs.analyzeVoice.call(void 0, [{ ...note, id: index }], chordAtBeat, key);
+    const [only] = _chunkLQZQDBCDcjs.analyzeVoice.call(void 0, [{ ...note, id: index }], chordAtBeat, key);
     return _nullishCoalesce(only, () => ( {
       noteId: index,
       pitch: note.pitch,
@@ -470,7 +500,7 @@ function firstSegmentAfter(timeline, beat) {
   let high = timeline.segments.length;
   while (low < high) {
     const middle = Math.floor((low + high) / 2);
-    if ((_nullishCoalesce(_optionalChain([timeline, 'access', _35 => _35.segments, 'access', _36 => _36[middle], 'optionalAccess', _37 => _37.startBeat]), () => ( Number.POSITIVE_INFINITY))) <= beat + _chunkS5BKZZGMcjs.BEAT_EPS) {
+    if ((_nullishCoalesce(_optionalChain([timeline, 'access', _35 => _35.segments, 'access', _36 => _36[middle], 'optionalAccess', _37 => _37.startBeat]), () => ( Number.POSITIVE_INFINITY))) <= beat + _chunkS3QELJUEcjs.BEAT_EPS) {
       low = middle + 1;
     } else {
       high = middle;
@@ -483,7 +513,7 @@ function evaluationBeats(note, timeline) {
   const beats = [note.startBeat];
   for (let i = firstSegmentAfter(timeline, note.startBeat); i < timeline.segments.length; i += 1) {
     const start = _optionalChain([timeline, 'access', _38 => _38.segments, 'access', _39 => _39[i], 'optionalAccess', _40 => _40.startBeat]);
-    if (start === void 0 || start >= noteEnd - _chunkS5BKZZGMcjs.BEAT_EPS) {
+    if (start === void 0 || start >= noteEnd - _chunkS3QELJUEcjs.BEAT_EPS) {
       break;
     }
     beats.push(start);
@@ -494,19 +524,19 @@ function analyzeArrangement(tracks, opts = {}) {
   return analyzeArrangementWith(tracks, opts).analysis;
 }
 function analyzeArrangementWith(tracks, opts = {}, previous, dirty) {
-  const meters = _chunkS5BKZZGMcjs.resolveMeters.call(void 0, opts, "arrangement meters");
+  const meters = _chunkS3QELJUEcjs.resolveMeters.call(void 0, opts, "arrangement meters");
   const budget = opts.budget;
   const noteOptions = { allowNonPositiveDuration: true, budget };
   if (opts.pickupBeats !== void 0) {
-    _chunkS5BKZZGMcjs.assertRange.call(void 0, opts.pickupBeats, 0, Number.MAX_SAFE_INTEGER, "arrangement pickupBeats");
+    _chunkS3QELJUEcjs.assertRange.call(void 0, opts.pickupBeats, 0, Number.MAX_SAFE_INTEGER, "arrangement pickupBeats");
     noteOptions.minStartBeat = -opts.pickupBeats;
   }
-  _chunkS5BKZZGMcjs.assertArray.call(void 0, tracks, "arrangement tracks");
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, tracks.length, "arrangement tracks", budget);
+  _chunkS3QELJUEcjs.assertArray.call(void 0, tracks, "arrangement tracks");
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, tracks.length, "arrangement tracks", budget);
   const noteCount = assertTrackNotes(tracks, noteOptions);
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, noteCount, "arrangement notes", budget);
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, noteCount, "arrangement notes", budget);
   const profile = arrangementProfile(opts.profile);
-  const minSeverity = opts.minSeverity === void 0 ? 1 /* Warning */ : _chunkS5BKZZGMcjs.assertInteger.call(void 0, 
+  const minSeverity = opts.minSeverity === void 0 ? 1 /* Warning */ : _chunkS3QELJUEcjs.assertInteger.call(void 0, 
     opts.minSeverity,
     "arrangement minSeverity",
     0 /* Safe */,
@@ -517,12 +547,12 @@ function analyzeArrangementWith(tracks, opts = {}, previous, dirty) {
   const harmonyTracks = harmonyTrackSet(opts.harmonyTracks, tracks);
   const prepared = prepareTracks(tracks);
   const voiceCount = prepared.reduce((sum, track) => sum + track.voices.length, 0);
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, noteCount * voiceCount, "arrangement note-voice comparisons", budget);
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, noteCount * voiceCount, "arrangement note-voice comparisons", budget);
   const pooled = poolNotes(tracks, harmonyTracks);
   let evidence;
   let inferred;
   if (opts.timeline === void 0) {
-    const run = _chunkSGLEQVJHcjs.analyzeTimeline.call(void 0, 
+    const run = _chunkLQZQDBCDcjs.analyzeTimeline.call(void 0, 
       pooled,
       {
         key: opts.key,
@@ -540,9 +570,9 @@ function analyzeArrangementWith(tracks, opts = {}, previous, dirty) {
     inferred = callerTimeline(opts.timeline, opts.key, opts.keys, pooled, meters, budget);
   }
   const { timeline, keys, prevailingKey, segmentConfidence } = inferred;
-  const keyAt = _chunkSGLEQVJHcjs.keyLookup.call(void 0, keys, prevailingKey);
-  const scaleAt = (beat) => _chunk3R3QVKY5cjs.scaleOf.call(void 0, keyAt(beat));
-  const cadences = _chunkSGLEQVJHcjs.detectCadences.call(void 0, timeline, scaleAt);
+  const keyAt = _chunkLQZQDBCDcjs.keyLookup.call(void 0, keys, prevailingKey);
+  const scaleAt = (beat) => _chunkYDGMWH43cjs.scaleOf.call(void 0, keyAt(beat));
+  const cadences = _chunkLQZQDBCDcjs.detectCadences.call(void 0, timeline, scaleAt);
   const soundingCache = /* @__PURE__ */ new Map();
   const trackAnalyses = [];
   const conflicts = [];
@@ -561,7 +591,7 @@ function analyzeArrangementWith(tracks, opts = {}, previous, dirty) {
       if (!subVoice) {
         continue;
       }
-      const analyzed = _chunkSGLEQVJHcjs.analyzeVoice.call(void 0, 
+      const analyzed = _chunkLQZQDBCDcjs.analyzeVoice.call(void 0, 
         subVoice.voice,
         timeline.at,
         scaleAt,
@@ -578,7 +608,7 @@ function analyzeArrangementWith(tracks, opts = {}, previous, dirty) {
           continue;
         }
         for (const beat of evaluationBeats(note, timeline)) {
-          const atOnset = _chunkSGLEQVJHcjs.sameInstant.call(void 0, beat, note.startBeat);
+          const atOnset = _chunkLQZQDBCDcjs.sameInstant.call(void 0, beat, note.startBeat);
           const others = otherVoicesSounding(prepared, t, v, beat, soundingCache);
           const safetyQuery = {
             profile,
@@ -587,11 +617,11 @@ function analyzeArrangementWith(tracks, opts = {}, previous, dirty) {
             chord: timeline.at(beat),
             key: scaleAt(beat),
             otherVoices: snapshotsOf(others),
-            strongBeat: _chunkS5BKZZGMcjs.isStrongBeat.call(void 0, beat, meters)
+            strongBeat: _chunkS3QELJUEcjs.isStrongBeat.call(void 0, beat, meters)
           };
-          let result = _chunk3R3QVKY5cjs.evaluateSafety.call(void 0, safetyQuery, { suggestions: false });
+          let result = _chunkYDGMWH43cjs.evaluateSafety.call(void 0, safetyQuery, { suggestions: false });
           if (result.safety !== 0 /* Safe */ && result.safety >= minSeverity) {
-            result = _chunk3R3QVKY5cjs.evaluateSafety.call(void 0, safetyQuery, { partners: true });
+            result = _chunkYDGMWH43cjs.evaluateSafety.call(void 0, safetyQuery, { partners: true });
             const conflict = {
               beat,
               trackName: track.name,
@@ -704,7 +734,7 @@ function sessionOf(tracks, opts, analysis, evidence) {
     tracks,
     analysis,
     update(edits) {
-      _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, edits.length, "arrangement edits", opts.budget);
+      _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, edits.length, "arrangement edits", opts.budget);
       const next = [...tracks];
       let edited = null;
       let reordered = false;
@@ -715,16 +745,16 @@ function sessionOf(tracks, opts, analysis, evidence) {
         }
         const target = next[edit.trackIndex];
         if (target === void 0) {
-          throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+          throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
             `edits[${index}].trackIndex ${edit.trackIndex} is outside the session's ${tracks.length} tracks`
           );
         }
         if (!Array.isArray(edit.notes)) {
-          throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
-            `edits[${index}].notes must be an array; received ${typeof edit.notes}`
+          throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+            `edits[${index}].notes must be an array; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, edit.notes)}`
           );
         }
-        _chunkS5BKZZGMcjs.assertNoteEvents.call(void 0, edit.notes, `edits[${index}].notes`, {
+        _chunkS3QELJUEcjs.assertNoteEvents.call(void 0, edit.notes, `edits[${index}].notes`, {
           allowNonPositiveDuration: true,
           budget: opts.budget
         });
@@ -735,7 +765,7 @@ function sessionOf(tracks, opts, analysis, evidence) {
       if (edited === null && !reordered) {
         return sessionOf(next, opts, analysis, evidence);
       }
-      const dirty = evidence === void 0 ? void 0 : edited === null ? { from: 0, to: 0 } : _chunkSGLEQVJHcjs.dirtySlotsFor.call(void 0, evidence, edited.startBeat, edited.endBeat);
+      const dirty = evidence === void 0 ? void 0 : edited === null ? { from: 0, to: 0 } : _chunkLQZQDBCDcjs.dirtySlotsFor.call(void 0, evidence, edited.startBeat, edited.endBeat);
       const run = analyzeArrangementWith(next, opts, evidence, dirty);
       return sessionOf(next, opts, run.analysis, run.evidence);
     }
@@ -756,26 +786,27 @@ var FUNCTION_WEIGHT = 0.5;
 var DISSONANCE_WEIGHT = 0.35;
 var SPAN_WEIGHT = 0.15;
 var SPAN_SATURATION = 24;
+var MAX_DISTINCT_PITCHES = 128;
 function clamp012(value) {
   return Math.min(1, Math.max(0, value));
 }
 function tensionCurve(tracks, opts = {}) {
-  const meters = _chunkS5BKZZGMcjs.resolveMeters.call(void 0, opts, "arrangement meters");
+  const meters = _chunkS3QELJUEcjs.resolveMeters.call(void 0, opts, "arrangement meters");
   const budget = opts.budget;
   const noteOptions = { allowNonPositiveDuration: true, budget };
   if (opts.pickupBeats !== void 0) {
-    _chunkS5BKZZGMcjs.assertRange.call(void 0, opts.pickupBeats, 0, Number.MAX_SAFE_INTEGER, "arrangement pickupBeats");
+    _chunkS3QELJUEcjs.assertRange.call(void 0, opts.pickupBeats, 0, Number.MAX_SAFE_INTEGER, "arrangement pickupBeats");
     noteOptions.minStartBeat = -opts.pickupBeats;
   }
-  _chunkS5BKZZGMcjs.assertArray.call(void 0, tracks, "arrangement tracks");
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, tracks.length, "arrangement tracks", budget);
+  _chunkS3QELJUEcjs.assertArray.call(void 0, tracks, "arrangement tracks");
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, tracks.length, "arrangement tracks", budget);
   const noteCount = assertTrackNotes(tracks, noteOptions);
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, noteCount, "arrangement notes", budget);
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, noteCount, "arrangement notes", budget);
   const profile = arrangementProfile(opts.profile);
   const step = _nullishCoalesce(opts.step, () => ( 1));
-  _chunkS5BKZZGMcjs.assertRange.call(void 0, step, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "tension sampling step");
+  _chunkS3QELJUEcjs.assertRange.call(void 0, step, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "tension sampling step");
   if (opts.minSeverity !== void 0) {
-    _chunkS5BKZZGMcjs.assertInteger.call(void 0, 
+    _chunkS3QELJUEcjs.assertInteger.call(void 0, 
       opts.minSeverity,
       "arrangement minSeverity",
       0 /* Safe */,
@@ -787,20 +818,15 @@ function tensionCurve(tracks, opts = {}) {
   const harmonyTracks = harmonyTrackSet(opts.harmonyTracks, tracks);
   const pooled = poolNotes(tracks, harmonyTracks);
   const all = poolNotes(tracks);
-  const totalBeats = all.reduce((end, n) => Math.max(end, n.startBeat + n.durationBeat), 0);
-  const { origin: sampleStart, startBeat: musicStart } = _chunkSGLEQVJHcjs.gridForNotes.call(void 0, all, step);
-  const suppliedKeys = opts.timeline === void 0 ? void 0 : _nullishCoalesce(opts.keys, () => ( (opts.key !== void 0 ? [
-    {
-      // The one region a named key holds starts where the music does,
-      // as the searched regions and the timeline's own key window do:
-      // a key cannot be in force over beats nothing sounds in.
-      startBeat: musicStart,
-      endBeat: totalBeats,
-      key: _chunk3R3QVKY5cjs.resolveKey.call(void 0, opts.key),
-      confidence: 1
-    }
-  ] : _chunkSGLEQVJHcjs.keyTimelineFromNotes.call(void 0, pooled, { meters, totalBeats, budget }))));
-  const { timeline, keys, prevailingKey } = opts.timeline === void 0 || suppliedKeys === void 0 ? _chunkSGLEQVJHcjs.chordTimelineFromNotes.call(void 0, pooled, {
+  const totalBeats = _chunkLQZQDBCDcjs.latestSoundingEnd.call(void 0, all);
+  const { origin: sampleStart, startBeat: musicStart } = _chunkLQZQDBCDcjs.gridForNotes.call(void 0, all, step);
+  const suppliedKeys = opts.timeline === void 0 ? void 0 : _nullishCoalesce(opts.keys, () => ( (opts.key !== void 0 ? (
+    // The one region a named key holds starts where the music does, as
+    // the searched regions and the timeline's own key window do: a key
+    // cannot be in force over beats nothing sounds in.
+    _chunkLQZQDBCDcjs.statedKeyRegions.call(void 0, _chunkYDGMWH43cjs.resolveKey.call(void 0, opts.key), musicStart, totalBeats)
+  ) : _chunkLQZQDBCDcjs.keyTimelineFromNotes.call(void 0, pooled, { meters, totalBeats, budget }))));
+  const { timeline, keys, prevailingKey } = opts.timeline === void 0 || suppliedKeys === void 0 ? _chunkLQZQDBCDcjs.chordTimelineFromNotes.call(void 0, pooled, {
     key: opts.key,
     meters,
     pickupBeats: opts.pickupBeats,
@@ -809,17 +835,17 @@ function tensionCurve(tracks, opts = {}) {
   }) : {
     timeline: opts.timeline,
     keys: suppliedKeys,
-    prevailingKey: _nullishCoalesce(_chunkSGLEQVJHcjs.prevailingKeyOf.call(void 0, suppliedKeys), () => ( _chunk3R3QVKY5cjs.resolveKey.call(void 0, _chunk3R3QVKY5cjs.majorKey.call(void 0, 0))))
+    prevailingKey: _nullishCoalesce(_chunkLQZQDBCDcjs.prevailingKeyOf.call(void 0, suppliedKeys), () => ( _chunkYDGMWH43cjs.resolveKey.call(void 0, _chunkYDGMWH43cjs.majorKey.call(void 0, 0))))
   };
   const regions = _nullishCoalesce(opts.keys, () => ( keys));
-  const keyAt = _chunkSGLEQVJHcjs.keyLookup.call(void 0, regions, _nullishCoalesce(_chunkSGLEQVJHcjs.prevailingKeyOf.call(void 0, regions), () => ( prevailingKey)));
+  const keyAt = _chunkLQZQDBCDcjs.keyLookup.call(void 0, regions, _nullishCoalesce(_chunkLQZQDBCDcjs.prevailingKeyOf.call(void 0, regions), () => ( prevailingKey)));
   const prepared = prepareTracks(tracks);
   const points = [];
-  const sampleCount = Math.max(0, Math.ceil((totalBeats - sampleStart) / step - _chunkS5BKZZGMcjs.BEAT_EPS));
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, sampleCount, "tension samples", budget);
+  const sampleCount = Math.max(0, Math.ceil((totalBeats - sampleStart) / step - _chunkS3QELJUEcjs.BEAT_EPS));
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, sampleCount, "tension samples", budget);
   const voiceCount = prepared.reduce((sum, track) => sum + track.voices.length, 0);
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, 
-    sampleCount * Math.min(128, voiceCount) * voiceCount,
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, 
+    sampleCount * Math.min(MAX_DISTINCT_PITCHES, voiceCount) * voiceCount,
     "tension sample-voice comparisons",
     budget
   );
@@ -827,16 +853,15 @@ function tensionCurve(tracks, opts = {}) {
     const beat = i === 0 ? Math.max(sampleStart, musicStart) : sampleStart + i * step;
     points.push({
       beat,
-      // The pitch classes alone: tension is scored from what sounds against
-      // the tonic, and no reading below here asks how the key is written.
-      tension: sampleTension(prepared, timeline, _chunk3R3QVKY5cjs.scaleOf.call(void 0, keyAt(beat)), meters, profile, beat)
+      // The key whole: an augmented sixth is told from a dominant by its letters.
+      tension: sampleTension(prepared, timeline, keyAt(beat), meters, profile, beat)
     });
   }
   return points;
 }
 function tensionCurveFrom(tracks, analysis, opts = {}) {
-  const asked = _chunkS5BKZZGMcjs.assertRecord.call(void 0, opts, "opts");
-  const carried = carriedHarmony(_chunkS5BKZZGMcjs.assertRecord.call(void 0, analysis, "analysis"), asked);
+  const asked = _chunkS3QELJUEcjs.assertRecord.call(void 0, opts, "opts");
+  const carried = carriedHarmony(_chunkS3QELJUEcjs.assertRecord.call(void 0, analysis, "analysis"), asked);
   return tensionCurve(tracks, { ...carried, ...asked });
 }
 function carriedHarmony(analysis, opts) {
@@ -870,9 +895,9 @@ function sampleTension(prepared, timeline, key, meters, profile, beat) {
     return 0;
   }
   const chord = timeline.at(beat);
-  const functionScore = chord ? FUNCTION_TENSION[_chunkSGLEQVJHcjs.functionOf.call(void 0, chord, key)] : 0;
-  const chordPcs = chord ? new Set(_chunk3R3QVKY5cjs.chordPitchClasses.call(void 0, chord)) : null;
-  const strongBeat = _chunkS5BKZZGMcjs.isStrongBeat.call(void 0, beat, meters);
+  const functionScore = chord ? FUNCTION_TENSION[_chunkLQZQDBCDcjs.functionOf.call(void 0, chord, key)] : 0;
+  const chordPcs = chord ? new Set(_chunkYDGMWH43cjs.chordPitchClasses.call(void 0, chord)) : null;
+  const strongBeat = _chunkS3QELJUEcjs.isStrongBeat.call(void 0, beat, meters);
   let nonChord = 0;
   let dissonant = 0;
   const pitches = /* @__PURE__ */ new Map();
@@ -888,7 +913,7 @@ function sampleTension(prepared, timeline, key, meters, profile, beat) {
     }
   }
   for (const [pitch, count] of pitches) {
-    if (chordPcs && !chordPcs.has(_chunkS5BKZZGMcjs.pitchClassOf.call(void 0, pitch))) {
+    if (chordPcs && !chordPcs.has(_chunkS3QELJUEcjs.pitchClassOf.call(void 0, pitch))) {
       nonChord += count;
     }
     const at = _nullishCoalesce(firstOf.get(pitch), () => ( 0));
@@ -899,8 +924,8 @@ function sampleTension(prepared, timeline, key, meters, profile, beat) {
       others[at] = tail;
       others.pop();
     }
-    const result = _chunk3R3QVKY5cjs.evaluateSafety.call(void 0, 
-      { profile, candidatePitch: pitch, chord, key, otherVoices: others, strongBeat },
+    const result = _chunkYDGMWH43cjs.evaluateSafety.call(void 0, 
+      { profile, candidatePitch: pitch, chord, key: key.scale, otherVoices: others, strongBeat },
       { suggestions: false }
     );
     if (held !== void 0 && tail !== void 0) {
@@ -926,19 +951,34 @@ function sampleTension(prepared, timeline, key, meters, profile, beat) {
 
 // src/analyze/form/hypermeter.ts
 var GROUP_CANDIDATES = [2, 3, 4, 6, 8];
-var GROUP_PRIOR = /* @__PURE__ */ new Map([
+var GROUP_PRIOR_LIST = [
   [2, 0.9],
   [3, 0.75],
   [4, 1],
   [6, 0.7],
   [8, 0.85]
-]);
+];
+var GROUP_PRIOR = new Map(GROUP_PRIOR_LIST);
 var CONTRAST_SHARE = 0.65;
 var CADENCE_SHARE = 0.35;
 var GROUP_FINAL_FIT = 1;
 var ELIDED_FIT = 0.5;
 var MIN_GROUPS = 2;
 var MARGIN_FLOOR = 0.7;
+function cadenceSpans(arrivals, segments) {
+  return arrivals.map(({ atBeat, strength }) => ({
+    atBeat,
+    endBeat: _nullishCoalesce(_optionalChain([_chunkLQZQDBCDcjs.segmentStartingAt.call(void 0, segments, atBeat), 'optionalAccess', _41 => _41.endBeat]), () => ( atBeat)),
+    strength
+  }));
+}
+function cadenceBarsOf(spans, meter) {
+  return spans.map((span) => ({
+    arrival: _chunkS3QELJUEcjs.barIndexAt.call(void 0, span.atBeat, meter),
+    last: _chunkLQZQDBCDcjs.lastBarOf.call(void 0, meter, span.atBeat, span.endBeat),
+    strength: span.strength
+  }));
+}
 function accentContrast(novelty, slices, groupBars, phase) {
   let headSum = 0;
   let headCount = 0;
@@ -950,7 +990,7 @@ function accentContrast(novelty, slices, groupBars, phase) {
       continue;
     }
     const value = _nullishCoalesce(novelty[i], () => ( 0));
-    if (_chunkSGLEQVJHcjs.floorMod.call(void 0, slice.index - phase, groupBars) === 0) {
+    if (_chunkLQZQDBCDcjs.floorMod.call(void 0, slice.index - phase, groupBars) === 0) {
       headSum += value;
       headCount += 1;
     } else {
@@ -963,22 +1003,41 @@ function accentContrast(novelty, slices, groupBars, phase) {
   }
   return headSum / headCount - otherSum / otherCount;
 }
-function cadenceFitOf(cadenceBars, slices, groupBars, phase) {
-  const lastBar = _nullishCoalesce(_optionalChain([slices, 'access', _41 => _41[slices.length - 1], 'optionalAccess', _42 => _42.index]), () => ( -1));
+function cadenceFitOf(cadences, slices, groupBars, phase) {
+  const lastBar = _nullishCoalesce(_optionalChain([slices, 'access', _42 => _42[slices.length - 1], 'optionalAccess', _43 => _43.index]), () => ( -1));
+  const closing = /* @__PURE__ */ new Map();
+  const eliding = /* @__PURE__ */ new Map();
+  const credit = (bars, bar, strength) => {
+    bars.set(bar, Math.max(_nullishCoalesce(bars.get(bar), () => ( 0)), strength));
+  };
+  for (const cadence of cadences) {
+    const end = cadence.arrival + _chunkLQZQDBCDcjs.floorMod.call(void 0, groupBars - 1 + phase - cadence.arrival, groupBars);
+    if (end <= cadence.last) {
+      credit(closing, end, cadence.strength);
+    } else if (_chunkLQZQDBCDcjs.floorMod.call(void 0, cadence.arrival - phase, groupBars) === 0 && // Elision needs a next group to arrive into. Past the last bar the span
+    // holds there is none, so a cadence beat beyond the music is not evidence
+    // about how the music that was read is grouped.
+    cadence.arrival <= lastBar) {
+      credit(eliding, cadence.arrival - 1, cadence.strength);
+    }
+  }
   let ends = 0;
-  let fit = 0;
+  let closed = 0;
+  let weighted = 0;
   for (const slice of slices) {
-    if (slice.index < 0 || _chunkSGLEQVJHcjs.floorMod.call(void 0, slice.index - phase, groupBars) !== groupBars - 1) {
+    if (slice.index < 0 || _chunkLQZQDBCDcjs.floorMod.call(void 0, slice.index - phase, groupBars) !== groupBars - 1) {
       continue;
     }
     ends += 1;
-    if (cadenceBars.has(slice.index)) {
-      fit += GROUP_FINAL_FIT;
-    } else if (slice.index < lastBar && cadenceBars.has(slice.index + 1)) {
-      fit += ELIDED_FIT;
-    }
+    const final = closing.get(slice.index);
+    const elided = eliding.get(slice.index);
+    closed += Math.max(
+      final === void 0 ? 0 : GROUP_FINAL_FIT,
+      elided === void 0 ? 0 : ELIDED_FIT
+    );
+    weighted += Math.max(GROUP_FINAL_FIT * (_nullishCoalesce(final, () => ( 0))), ELIDED_FIT * (_nullishCoalesce(elided, () => ( 0))));
   }
-  return ends === 0 ? 0 : _chunkSGLEQVJHcjs.clamp01.call(void 0, fit / ends);
+  return ends === 0 ? { closed: 0, weighted: 0 } : { closed: _chunkLQZQDBCDcjs.clamp01.call(void 0, closed / ends), weighted: _chunkLQZQDBCDcjs.clamp01.call(void 0, weighted / ends) };
 }
 function undecidedReading(slices) {
   const fullBars = slices.filter((slice) => slice.index >= 0);
@@ -992,52 +1051,70 @@ function undecidedReading(slices) {
   };
 }
 function hypermeter(notes, meter, opts = {}) {
-  const asked = _chunkS5BKZZGMcjs.assertOptions.call(void 0, opts, "opts");
-  const meters = _chunkS5BKZZGMcjs.resolveMeters.call(void 0, { meters: meter }, "meter");
-  _chunkS5BKZZGMcjs.assertNoteEvents.call(void 0, notes, "hypermeter notes", {
+  return hypermeterOver(
+    notes,
+    meter,
+    opts,
+    (asked) => cadenceSpans(
+      (_nullishCoalesce(asked.cadenceBeats, () => ( []))).map((atBeat) => ({ atBeat, strength: 1 })),
+      []
+    )
+  );
+}
+function hypermeterOver(notes, meter, opts, spansOf) {
+  const asked = _chunkS3QELJUEcjs.assertOptions.call(void 0, opts, "opts");
+  const meters = _chunkS3QELJUEcjs.resolveMeters.call(void 0, { meters: meter }, "meter");
+  _chunkS3QELJUEcjs.assertNoteEvents.call(void 0, notes, "hypermeter notes", {
     allowNonPositiveDuration: true,
     budget: asked.budget
   });
   const sounding = notes.filter((note) => note.durationBeat > 0);
-  const firstOnset = _chunkSGLEQVJHcjs.firstSoundingBeat.call(void 0, sounding);
-  const lastEnd = sounding.reduce((end, n) => Math.max(end, n.startBeat + n.durationBeat), 0);
-  const spanEnd = _nullishCoalesce(asked.totalBeats, () => ( lastEnd));
-  _chunkS5BKZZGMcjs.assertRange.call(void 0, spanEnd, 0, Number.MAX_SAFE_INTEGER, "hypermeter totalBeats");
-  const spanStart = _chunkSGLEQVJHcjs.barGridStart.call(void 0, firstOnset, meters);
-  const slices = _chunkSGLEQVJHcjs.sliceBars.call(void 0, sounding, meters, spanStart, spanEnd, asked.budget);
+  const firstOnset = _chunkLQZQDBCDcjs.firstSoundingBeat.call(void 0, sounding);
+  const spanEnd = _chunkLQZQDBCDcjs.resolveSpanEnd.call(void 0, 
+    asked.totalBeats,
+    firstOnset,
+    _chunkLQZQDBCDcjs.latestSoundingEnd.call(void 0, sounding),
+    "hypermeter totalBeats"
+  );
+  const spanStart = _chunkLQZQDBCDcjs.barGridStart.call(void 0, firstOnset, meters);
+  if (sounding.length === 0 || spanEnd <= spanStart + _chunkS3QELJUEcjs.BEAT_EPS) {
+    return undecidedReading([]);
+  }
+  const slices = _chunkLQZQDBCDcjs.sliceBars.call(void 0, sounding, meters, spanStart, spanEnd, asked.budget);
   const fullBars = slices.reduce((count, slice) => slice.index >= 0 ? count + 1 : count, 0);
   const candidates = GROUP_CANDIDATES.filter((groupBars) => fullBars >= groupBars * MIN_GROUPS);
   if (candidates.length === 0) {
     return undecidedReading(slices);
   }
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, 
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, 
     candidates.reduce((sum, groupBars) => sum + groupBars * slices.length, 0),
     "hypermeter readings",
     asked.budget
   );
-  const novelty = slices.map((_, index) => _chunkSGLEQVJHcjs.harmonicNovelty.call(void 0, slices, index));
-  const cadenceBars = new Set((_nullishCoalesce(asked.cadenceBeats, () => ( []))).map((beat) => _chunkS5BKZZGMcjs.barIndexAt.call(void 0, beat, meters)));
-  const hasCadences = cadenceBars.size > 0;
+  const novelty = slices.map((_, index) => _chunkLQZQDBCDcjs.harmonicNovelty.call(void 0, slices, index));
+  const cadenceBars = cadenceBarsOf(spansOf(asked), meters);
+  const hasCadences = cadenceBars.length > 0;
   const readings = [];
   for (const groupBars of candidates) {
     const phases = Array.from({ length: groupBars }, (_, phase) => ({
       phase,
       contrast: accentContrast(novelty, slices, groupBars, phase),
-      cadenceFit: cadenceFitOf(cadenceBars, slices, groupBars, phase)
+      fit: cadenceFitOf(cadenceBars, slices, groupBars, phase)
     }));
-    const bestFit = phases.reduce((best2, reading) => Math.max(best2, reading.cadenceFit), 0);
-    for (const { phase, contrast, cadenceFit } of phases) {
-      if (hasCadences && cadenceFit < bestFit - _chunkS5BKZZGMcjs.BEAT_EPS) {
+    const bestFit = phases.reduce((best2, reading) => Math.max(best2, reading.fit.weighted), 0);
+    for (const { phase, contrast, fit } of phases) {
+      if (hasCadences && fit.weighted < bestFit - _chunkS3QELJUEcjs.BEAT_EPS) {
         continue;
       }
-      const evidence = _chunkSGLEQVJHcjs.clamp01.call(void 0, 
+      const cadenceFit = fit.closed;
+      const evidence = _chunkLQZQDBCDcjs.clamp01.call(void 0, 
         hasCadences ? (
           // Floored at zero rather than summed raw: group heads that restate
           // the harmony their group opened with — the commonest way a phrase
           // begins — change less than the bars between them, and a negative
           // contrast subtracted from the cadence term would count that
           // restatement as evidence against the very phase it confirms.
-          CONTRAST_SHARE * _chunkSGLEQVJHcjs.clamp01.call(void 0, contrast) + CADENCE_SHARE * cadenceFit
+          CONTRAST_SHARE * _chunkLQZQDBCDcjs.clamp01.call(void 0, contrast) + CADENCE_SHARE * cadenceFit
         ) : contrast
       );
       readings.push({
@@ -1058,8 +1135,8 @@ function hypermeter(notes, meter, opts = {}) {
     return undecidedReading(slices);
   }
   const runnerUp = readings.find((reading) => reading.groupBars !== best.groupBars);
-  const margin = runnerUp === void 0 || best.score <= _chunkS5BKZZGMcjs.BEAT_EPS ? 1 : _chunkSGLEQVJHcjs.clamp01.call(void 0, (best.score - runnerUp.score) / best.score);
-  const downbeats = slices.filter((slice) => slice.index >= 0 && _chunkSGLEQVJHcjs.floorMod.call(void 0, slice.index - best.phase, best.groupBars) === 0).map((slice) => slice.startBeat);
+  const margin = runnerUp === void 0 || best.score <= _chunkS3QELJUEcjs.BEAT_EPS ? 1 : _chunkLQZQDBCDcjs.clamp01.call(void 0, (best.score - runnerUp.score) / best.score);
+  const downbeats = slices.filter((slice) => slice.index >= 0 && _chunkLQZQDBCDcjs.floorMod.call(void 0, slice.index - best.phase, best.groupBars) === 0).map((slice) => slice.startBeat);
   const cadencePart = hasCadences ? `${Math.round(best.cadenceFit * 100)}% of group ends closed by a cadence` : "no cadences given";
   return {
     groupBars: best.groupBars,
@@ -1069,554 +1146,11 @@ function hypermeter(notes, meter, opts = {}) {
     // runner-up is nearly always a multiple or a divisor of the winner — four
     // bars nest inside eight — and a reading of the same accents at another
     // level is weaker counter-evidence than an unrelated rival would be.
-    confidence: _chunkSGLEQVJHcjs.clamp01.call(void 0, best.evidence * (MARGIN_FLOOR + (1 - MARGIN_FLOOR) * margin)),
+    confidence: _chunkLQZQDBCDcjs.clamp01.call(void 0, best.evidence * (MARGIN_FLOOR + (1 - MARGIN_FLOOR) * margin)),
     rationale: `${best.groupBars}-bar groups from bar ${best.phase}: harmonic change ${Math.round(best.contrast * 100)}% stronger on group heads, ${cadencePart}`
   };
 }
 
-// src/analyze/melody/internal.ts
-var RHYTHM_GRID = 64;
-function phraseNotes(phrase) {
-  if (Array.isArray(phrase)) {
-    return phrase;
-  }
-  return _chunkS5BKZZGMcjs.assertRecord.call(void 0, phrase, "melodic phrase").notes;
-}
-function orderedNotes(notes, name, budget) {
-  _chunkS5BKZZGMcjs.assertNoteEvents.call(void 0, notes, name, { allowNonPositiveDuration: true, budget });
-  const sounding = notes.filter((note) => note.durationBeat > 0).sort((a, b) => a.startBeat - b.startBeat || a.pitch - b.pitch);
-  const line = [];
-  for (const note of sounding) {
-    const previous = line[line.length - 1];
-    if (previous !== void 0 && Math.abs(note.startBeat - previous.startBeat) <= _chunkS5BKZZGMcjs.BEAT_EPS) {
-      line[line.length - 1] = note;
-      continue;
-    }
-    line.push(note);
-  }
-  return line;
-}
-function intervalsOf(notes) {
-  const out = [];
-  for (let i = 1; i < notes.length; i += 1) {
-    out.push((_nullishCoalesce(_optionalChain([notes, 'access', _43 => _43[i], 'optionalAccess', _44 => _44.pitch]), () => ( 0))) - (_nullishCoalesce(_optionalChain([notes, 'access', _45 => _45[i - 1], 'optionalAccess', _46 => _46.pitch]), () => ( 0))));
-  }
-  return out;
-}
-function onsetGaps(notes) {
-  const out = [];
-  for (let i = 1; i < notes.length; i += 1) {
-    out.push((_nullishCoalesce(_optionalChain([notes, 'access', _47 => _47[i], 'optionalAccess', _48 => _48.startBeat]), () => ( 0))) - (_nullishCoalesce(_optionalChain([notes, 'access', _49 => _49[i - 1], 'optionalAccess', _50 => _50.startBeat]), () => ( 0))));
-  }
-  return out;
-}
-function retrogradeGaps(notes) {
-  const out = [];
-  for (let i = notes.length - 1; i >= 1; i -= 1) {
-    const later = notes[i];
-    const earlier = notes[i - 1];
-    out.push(
-      (_nullishCoalesce(_optionalChain([later, 'optionalAccess', _51 => _51.startBeat]), () => ( 0))) + (_nullishCoalesce(_optionalChain([later, 'optionalAccess', _52 => _52.durationBeat]), () => ( 0))) - ((_nullishCoalesce(_optionalChain([earlier, 'optionalAccess', _53 => _53.startBeat]), () => ( 0))) + (_nullishCoalesce(_optionalChain([earlier, 'optionalAccess', _54 => _54.durationBeat]), () => ( 0))))
-    );
-  }
-  return out;
-}
-function rhythmProfile(gaps) {
-  const unit = _nullishCoalesce(gaps[0], () => ( 0));
-  if (!(unit > _chunkS5BKZZGMcjs.BEAT_EPS)) {
-    return gaps.length === 0 ? [] : null;
-  }
-  return gaps.map((gap) => Math.round(gap / unit * RHYTHM_GRID) / RHYTHM_GRID);
-}
-function sameNumbers(a, b) {
-  if (a.length !== b.length) {
-    return false;
-  }
-  for (let i = 0; i < a.length; i += 1) {
-    if (Math.abs((_nullishCoalesce(a[i], () => ( 0))) - (_nullishCoalesce(b[i], () => ( 0)))) > _chunkS5BKZZGMcjs.BEAT_EPS) {
-      return false;
-    }
-  }
-  return true;
-}
-function roundTo(value, digits) {
-  const scale = 10 ** digits;
-  return Math.round(value * scale) / scale;
-}
-function endBeatOf(notes) {
-  let end = 0;
-  for (const note of notes) {
-    end = Math.max(end, note.startBeat + note.durationBeat);
-  }
-  return end;
-}
-function onsetSpan(notes) {
-  if (notes.length < 2) {
-    return 0;
-  }
-  return (_nullishCoalesce(_optionalChain([notes, 'access', _55 => _55[notes.length - 1], 'optionalAccess', _56 => _56.startBeat]), () => ( 0))) - (_nullishCoalesce(_optionalChain([notes, 'access', _57 => _57[0], 'optionalAccess', _58 => _58.startBeat]), () => ( 0)));
-}
-
-// src/analyze/melody/contour.ts
-var DIRECTIONAL_SHARE = 0.75;
-function extremes(notes) {
-  if (notes.length === 0) {
-    return { peak: -1, trough: -1 };
-  }
-  let peak = 0;
-  let trough = 0;
-  for (let i = 1; i < notes.length; i += 1) {
-    if ((_nullishCoalesce(_optionalChain([notes, 'access', _59 => _59[i], 'optionalAccess', _60 => _60.pitch]), () => ( 0))) > (_nullishCoalesce(_optionalChain([notes, 'access', _61 => _61[peak], 'optionalAccess', _62 => _62.pitch]), () => ( 0)))) {
-      peak = i;
-    }
-    if ((_nullishCoalesce(_optionalChain([notes, 'access', _63 => _63[i], 'optionalAccess', _64 => _64.pitch]), () => ( 0))) < (_nullishCoalesce(_optionalChain([notes, 'access', _65 => _65[trough], 'optionalAccess', _66 => _66.pitch]), () => ( 0)))) {
-      trough = i;
-    }
-  }
-  return { peak, trough };
-}
-function melodicContour(notes) {
-  const line = orderedNotes(phraseNotes(notes), "contour notes");
-  const intervals = intervalsOf(line);
-  const directions = intervals.map(
-    (step) => step > 0 ? "up" : step < 0 ? "down" : "same"
-  );
-  const { peak, trough } = extremes(line);
-  const range = (_nullishCoalesce(_optionalChain([line, 'access', _67 => _67[peak], 'optionalAccess', _68 => _68.pitch]), () => ( 0))) - (_nullishCoalesce(_optionalChain([line, 'access', _69 => _69[trough], 'optionalAccess', _70 => _70.pitch]), () => ( 0)));
-  const motion = intervals.reduce((sum, step) => sum + Math.abs(step), 0);
-  if (motion === 0) {
-    return {
-      directions,
-      shape: "static",
-      peakIndex: peak,
-      troughIndex: trough,
-      range: 0,
-      rationale: line.length < 2 ? "Too short to have a direction, so the line is static" : "Every note at the same pitch, so the line is static"
-    };
-  }
-  const first = _nullishCoalesce(_optionalChain([line, 'access', _71 => _71[0], 'optionalAccess', _72 => _72.pitch]), () => ( 0));
-  const last = _nullishCoalesce(_optionalChain([line, 'access', _73 => _73[line.length - 1], 'optionalAccess', _74 => _74.pitch]), () => ( 0));
-  const net = last - first;
-  const directness = Math.abs(net) / motion;
-  const share = Math.round(directness * 100);
-  if (directness >= DIRECTIONAL_SHARE) {
-    const shape = net > 0 ? "ascending" : "descending";
-    return {
-      directions,
-      shape,
-      peakIndex: peak,
-      troughIndex: trough,
-      range,
-      rationale: `${share}% of the motion runs ${net > 0 ? "up" : "down"}, so the line is ${shape}`
-    };
-  }
-  const peakPitch = _nullishCoalesce(_optionalChain([line, 'access', _75 => _75[peak], 'optionalAccess', _76 => _76.pitch]), () => ( 0));
-  const archMotion = peakPitch - first + (peakPitch - last);
-  if (peak > 0 && peak < line.length - 1 && archMotion >= DIRECTIONAL_SHARE * motion) {
-    return {
-      directions,
-      shape: "arch",
-      peakIndex: peak,
-      troughIndex: trough,
-      range,
-      rationale: `Rises to its peak at note ${peak + 1} of ${line.length} and falls back, so the line is an arch`
-    };
-  }
-  return {
-    directions,
-    shape: "wave",
-    peakIndex: peak,
-    troughIndex: trough,
-    range,
-    rationale: `Changes direction without settling either way (${share}% of the motion nets out), so the line is a wave`
-  };
-}
-
-// src/analyze/melody/motifs.ts
-var MIN_CELL_NOTES = 3;
-var MAX_CELL_NOTES = 8;
-var MIN_OCCURRENCES = 2;
-function windowSignature(notes) {
-  const profile = rhythmProfile(onsetGaps(notes));
-  if (profile === null) {
-    return null;
-  }
-  return `${notes.length}|${intervalsOf(notes).join(",")}|${profile.join(",")}`;
-}
-function nonOverlapping(starts, length) {
-  const picked = [];
-  let lastEnd = Number.NEGATIVE_INFINITY;
-  for (const start of starts) {
-    if (start > lastEnd) {
-      picked.push(start);
-      lastEnd = start + length - 1;
-    }
-  }
-  return picked;
-}
-function subsumes(outer, inner) {
-  let at = 0;
-  for (const start of inner.starts) {
-    while (at + 1 < outer.starts.length && (_nullishCoalesce(outer.starts[at + 1], () => ( 0))) <= start) {
-      at += 1;
-    }
-    const from = outer.starts[at];
-    if (from === void 0 || start < from || start + inner.length > from + outer.length) {
-      return false;
-    }
-  }
-  return true;
-}
-function listBeats(occurrences) {
-  const shown = occurrences.slice(0, 5).map((occurrence) => roundTo(occurrence.startBeat, 3));
-  return occurrences.length > shown.length ? `${shown.join(", ")}, and ${occurrences.length - shown.length} more` : shown.join(", ");
-}
-function motifFromGroup(group, notes) {
-  const first = _nullishCoalesce(group.starts[0], () => ( 0));
-  const prime = notes.slice(first, first + group.length).map((note) => ({ ...note }));
-  const primePitch = _nullishCoalesce(_optionalChain([prime, 'access', _77 => _77[0], 'optionalAccess', _78 => _78.pitch]), () => ( 0));
-  const primeSpan = onsetSpan(prime);
-  const occurrences = group.starts.map((start) => {
-    const statement = notes.slice(start, start + group.length);
-    const span = onsetSpan(statement);
-    return {
-      noteIndex: start,
-      startBeat: _nullishCoalesce(_optionalChain([statement, 'access', _79 => _79[0], 'optionalAccess', _80 => _80.startBeat]), () => ( 0)),
-      endBeat: endBeatOf(statement),
-      transpose: (_nullishCoalesce(_optionalChain([statement, 'access', _81 => _81[0], 'optionalAccess', _82 => _82.pitch]), () => ( 0))) - primePitch,
-      timeRatio: primeSpan > _chunkS5BKZZGMcjs.BEAT_EPS ? span / primeSpan : 1
-    };
-  });
-  const shape = melodicContour(prime).shape;
-  const transposed = occurrences.some((occurrence) => occurrence.transpose !== 0);
-  const stretched = occurrences.some((occurrence) => Math.abs(occurrence.timeRatio - 1) > _chunkS5BKZZGMcjs.BEAT_EPS);
-  const detail = [
-    transposed ? "at more than one pitch level" : "at the same pitch level",
-    stretched ? "and in more than one set of note values" : ""
-  ].filter((part) => part !== "").join(" ");
-  return {
-    notes: prime,
-    intervals: intervalsOf(prime),
-    rhythm: _nullishCoalesce(rhythmProfile(onsetGaps(prime)), () => ( [])),
-    occurrences,
-    rationale: `${group.length}-note ${shape} cell stated ${occurrences.length} ${occurrences.length === 1 ? "time" : "times"} (beats ${listBeats(occurrences)}), ${detail}`
-  };
-}
-function extractMotifs(notes, opts = {}) {
-  const asked = _chunkS5BKZZGMcjs.assertOptions.call(void 0, opts, "opts");
-  const minNotes = _chunkS5BKZZGMcjs.assertInteger.call(void 0, _nullishCoalesce(asked.minNotes, () => ( MIN_CELL_NOTES)), "motif minNotes", 2, 64);
-  const maxNotes = _chunkS5BKZZGMcjs.assertInteger.call(void 0, _nullishCoalesce(asked.maxNotes, () => ( MAX_CELL_NOTES)), "motif maxNotes", 2, 64);
-  if (maxNotes < minNotes) {
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
-      `motif maxNotes must be at least minNotes ${minNotes}; received ${maxNotes}`
-    );
-  }
-  const minOccurrences = _chunkS5BKZZGMcjs.assertInteger.call(void 0, 
-    _nullishCoalesce(asked.minOccurrences, () => ( MIN_OCCURRENCES)),
-    "motif minOccurrences",
-    2
-  );
-  const sounding = orderedNotes(notes, "melody notes", asked.budget);
-  if (sounding.length < minNotes) {
-    return [];
-  }
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, 
-    sounding.length * (maxNotes - minNotes + 1),
-    "motif windows",
-    asked.budget
-  );
-  const groups = /* @__PURE__ */ new Map();
-  for (let length = minNotes; length <= maxNotes; length += 1) {
-    for (let start = 0; start + length <= sounding.length; start += 1) {
-      const signature = windowSignature(sounding.slice(start, start + length));
-      if (signature === null) {
-        continue;
-      }
-      const group = groups.get(signature);
-      if (group === void 0) {
-        groups.set(signature, { signature, length, starts: [start] });
-      } else {
-        group.starts.push(start);
-      }
-    }
-  }
-  const candidates = [...groups.values()].map((group) => ({ ...group, starts: nonOverlapping(group.starts, group.length) })).filter((group) => group.starts.length >= minOccurrences).sort(
-    (a, b) => b.length - a.length || b.starts.length - a.starts.length || (_nullishCoalesce(a.starts[0], () => ( 0))) - (_nullishCoalesce(b.starts[0], () => ( 0))) || (a.signature < b.signature ? -1 : a.signature > b.signature ? 1 : 0)
-  );
-  const keptByLength = /* @__PURE__ */ new Map();
-  const kept = [];
-  let comparisons = 0;
-  for (const candidate of candidates) {
-    const first = _nullishCoalesce(candidate.starts[0], () => ( 0));
-    let covered = false;
-    for (let length = candidate.length + 1; length <= maxNotes && !covered; length += 1) {
-      const byStart = keptByLength.get(length);
-      if (byStart === void 0) {
-        continue;
-      }
-      for (let from = Math.max(0, first - (length - candidate.length)); from <= first; from += 1) {
-        comparisons += 1;
-        const outer = byStart.get(from);
-        if (outer === void 0 || outer.starts.length < candidate.starts.length) {
-          continue;
-        }
-        comparisons += outer.starts.length + candidate.starts.length;
-        if (subsumes(outer, candidate)) {
-          covered = true;
-          break;
-        }
-      }
-    }
-    _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, comparisons, "motif subsumption comparisons", asked.budget);
-    if (!covered) {
-      kept.push(candidate);
-      let byStart = keptByLength.get(candidate.length);
-      if (byStart === void 0) {
-        byStart = /* @__PURE__ */ new Map();
-        keptByLength.set(candidate.length, byStart);
-      }
-      for (const start of candidate.starts) {
-        byStart.set(start, candidate);
-      }
-    }
-  }
-  return kept.map((group) => motifFromGroup(group, sounding));
-}
-function motifFromNotes(notes) {
-  const sounding = orderedNotes(notes, "motif notes").map((note) => ({ ...note }));
-  return motifFromGroup(
-    { signature: _nullishCoalesce(windowSignature(sounding), () => ( "")), length: sounding.length, starts: [0] },
-    sounding
-  );
-}
-
-// src/analyze/melody/relation.ts
-function spellingOf(key) {
-  if (key === void 0) {
-    return "sharp";
-  }
-  return _chunk3R3QVKY5cjs.keySignatureFifths.call(void 0, key.tonic, key.scale) < 0 ? "flat" : "sharp";
-}
-function intervalBetween(from, to, key) {
-  const spelling = spellingOf(key);
-  return _chunkS5BKZZGMcjs.spelledInterval.call(void 0, _chunkS5BKZZGMcjs.midiToNote.call(void 0, from, spelling), _chunkS5BKZZGMcjs.midiToNote.call(void 0, to, spelling));
-}
-function intervalName(interval) {
-  return `${interval.descending && interval.semitones !== 0 ? "-" : ""}${interval.quality}${interval.number}`;
-}
-function ladderIndices(notes, key) {
-  const root = _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, key.rootPc);
-  const offsets = _chunk3R3QVKY5cjs.scaleTonesInDegreeOrder.call(void 0, key).map((pc) => _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, pc - root));
-  if (offsets.length === 0) {
-    return null;
-  }
-  const out = [];
-  for (const note of notes) {
-    const semitones = note.pitch - root;
-    const octave = Math.floor(semitones / 12);
-    const degree = offsets.indexOf(semitones - octave * 12);
-    if (degree < 0) {
-      return null;
-    }
-    out.push(octave * offsets.length + degree);
-  }
-  return out;
-}
-function ladderSteps(indices) {
-  const out = [];
-  for (let i = 1; i < indices.length; i += 1) {
-    out.push((_nullishCoalesce(indices[i], () => ( 0))) - (_nullishCoalesce(indices[i - 1], () => ( 0))));
-  }
-  return out;
-}
-function pitchShapes(a, b) {
-  const shapes = [];
-  if (sameNumbers(a, b)) {
-    shapes.push("exact");
-  }
-  if (sameNumbers(
-    b,
-    a.map((step) => -step)
-  )) {
-    shapes.push("inversion");
-  }
-  const reversed = [...a].reverse();
-  if (sameNumbers(
-    b,
-    reversed.map((step) => -step)
-  )) {
-    shapes.push("retrograde");
-  }
-  if (sameNumbers(b, reversed)) {
-    shapes.push("retrogradeInversion");
-  }
-  return shapes;
-}
-function totalGap(gaps) {
-  return gaps.reduce((sum, gap) => sum + gap, 0);
-}
-function stretchRatio(modelGaps, answerGaps) {
-  const span = totalGap(modelGaps);
-  return span > _chunkS5BKZZGMcjs.BEAT_EPS ? totalGap(answerGaps) / span : 1;
-}
-function stretchPhrase(ratio) {
-  return `note values ${roundTo(ratio, 3)}x the model's`;
-}
-function relateMotifs(a, b, keyLike) {
-  const key = keyLike === void 0 ? void 0 : _chunk3R3QVKY5cjs.resolveKey.call(void 0, keyLike);
-  const model = _chunkS5BKZZGMcjs.assertArray.call(void 0, _chunkS5BKZZGMcjs.assertRecord.call(void 0, a, "a").notes, "a.notes");
-  const answer = _chunkS5BKZZGMcjs.assertArray.call(void 0, _chunkS5BKZZGMcjs.assertRecord.call(void 0, b, "b").notes, "b.notes");
-  if (model.length === 0 || model.length !== answer.length) {
-    return null;
-  }
-  const modelGaps = onsetGaps(model);
-  const answerGaps = onsetGaps(answer);
-  const modelProfile = rhythmProfile(modelGaps);
-  const answerProfile = rhythmProfile(answerGaps);
-  const retroGaps = retrogradeGaps(model);
-  const retroProfile = rhythmProfile(retroGaps);
-  if (modelProfile === null || answerProfile === null) {
-    return null;
-  }
-  const forward = sameNumbers(modelProfile, answerProfile);
-  const backward = retroProfile !== null && sameNumbers(retroProfile, answerProfile);
-  const semitones = (_nullishCoalesce(_optionalChain([answer, 'access', _83 => _83[0], 'optionalAccess', _84 => _84.pitch]), () => ( 0))) - (_nullishCoalesce(_optionalChain([model, 'access', _85 => _85[0], 'optionalAccess', _86 => _86.pitch]), () => ( 0)));
-  const interval = intervalBetween(_nullishCoalesce(_optionalChain([model, 'access', _87 => _87[0], 'optionalAccess', _88 => _88.pitch]), () => ( 0)), _nullishCoalesce(_optionalChain([answer, 'access', _89 => _89[0], 'optionalAccess', _90 => _90.pitch]), () => ( 0)), key);
-  const gap = (_nullishCoalesce(_optionalChain([answer, 'access', _91 => _91[0], 'optionalAccess', _92 => _92.startBeat]), () => ( 0))) - endBeatOf(model);
-  const sequence = gap >= -_chunkSGLEQVJHcjs.HUMANIZE_ADJACENCY && gap <= _chunkSGLEQVJHcjs.HUMANIZE_ADJACENCY;
-  const timeRatio = stretchRatio(modelGaps, answerGaps);
-  const stretched = Math.abs(timeRatio - 1) > _chunkS5BKZZGMcjs.BEAT_EPS;
-  const shapes = pitchShapes(intervalsOf(model), intervalsOf(answer));
-  const base = { sequence, semitones, interval, timeRatio };
-  const backwardBase = { ...base, timeRatio: stretchRatio(retroGaps, answerGaps) };
-  if (forward && shapes.includes("exact")) {
-    if (semitones === 0) {
-      if (!stretched) {
-        return {
-          ...base,
-          kind: "repetition",
-          rationale: "Exact repetition: the same pitches in the same rhythm"
-        };
-      }
-      const augmented = timeRatio > 1;
-      return {
-        ...base,
-        kind: augmented ? "augmentation" : "diminution",
-        rationale: `${augmented ? "Augmentation" : "Diminution"}: the same pitches in ${stretchPhrase(timeRatio)}`
-      };
-    }
-    const name = intervalName(interval);
-    return {
-      ...base,
-      kind: "transposition",
-      rationale: sequence ? `Real sequence: the cell restated ${name} away with every interval kept literally` + (stretched ? `, in ${stretchPhrase(timeRatio)}` : "") : `Transposition by ${name}: every interval kept literally` + (stretched ? `, in ${stretchPhrase(timeRatio)}` : "")
-    };
-  }
-  if (forward && key !== void 0) {
-    const modelLadder = ladderIndices(model, key.scale);
-    const answerLadder = ladderIndices(answer, key.scale);
-    if (modelLadder !== null && answerLadder !== null) {
-      const degrees = (_nullishCoalesce(answerLadder[0], () => ( 0))) - (_nullishCoalesce(modelLadder[0], () => ( 0)));
-      if (degrees !== 0 && sameNumbers(ladderSteps(modelLadder), ladderSteps(answerLadder))) {
-        const direction = degrees > 0 ? "higher" : "lower";
-        const count = Math.abs(degrees);
-        return {
-          ...base,
-          kind: "tonalTransposition",
-          degrees,
-          rationale: `${sequence ? "Tonal sequence" : "Tonal transposition"}: the cell restated ${count} scale ${count === 1 ? "degree" : "degrees"} ${direction} inside the key, so the key resizes its intervals \u2014 a real one would have kept them literal`
-        };
-      }
-    }
-  }
-  if (forward && shapes.includes("inversion")) {
-    return {
-      ...base,
-      kind: "inversion",
-      rationale: "Inversion: every interval turned upside down about the first note" + (stretched ? `, in ${stretchPhrase(timeRatio)}` : "")
-    };
-  }
-  if (backward && shapes.includes("retrograde")) {
-    return {
-      ...backwardBase,
-      kind: "retrograde",
-      rationale: "Retrograde: the cell read back to front, rhythm included"
-    };
-  }
-  if (backward && shapes.includes("retrogradeInversion")) {
-    return {
-      ...backwardBase,
-      kind: "retrogradeInversion",
-      rationale: "Retrograde inversion: the cell read back to front and turned upside down"
-    };
-  }
-  return null;
-}
-
-// src/analyze/melody/similarity.ts
-var INTERVAL_TOLERANCE = 6;
-var PITCH_WEIGHT = 0.75;
-var RHYTHM_WEIGHT = 0.25;
-function gradedEditDistance(a, b, cost) {
-  let previous = Array.from({ length: b.length + 1 }, (_, i) => i);
-  for (let i = 1; i <= a.length; i += 1) {
-    const row = new Array(b.length + 1);
-    row[0] = i;
-    for (let j = 1; j <= b.length; j += 1) {
-      const substitution = (_nullishCoalesce(previous[j - 1], () => ( 0))) + cost(_nullishCoalesce(a[i - 1], () => ( 0)), _nullishCoalesce(b[j - 1], () => ( 0)));
-      const deletion = (_nullishCoalesce(previous[j], () => ( 0))) + 1;
-      const insertion = (_nullishCoalesce(row[j - 1], () => ( 0))) + 1;
-      row[j] = Math.min(substitution, deletion, insertion);
-    }
-    previous = row;
-  }
-  return _nullishCoalesce(previous[b.length], () => ( 0));
-}
-function distanceToSimilarity(distance, a, b) {
-  const longest = Math.max(a, b);
-  if (longest === 0) {
-    return 1;
-  }
-  return Math.min(1, Math.max(0, 1 - distance / longest));
-}
-function intervalCost(x, y) {
-  return Math.min(1, Math.abs(x - y) / INTERVAL_TOLERANCE);
-}
-function gapCost(x, y) {
-  if (!(x > _chunkS5BKZZGMcjs.BEAT_EPS) || !(y > _chunkS5BKZZGMcjs.BEAT_EPS)) {
-    return Math.abs(x - y) > _chunkS5BKZZGMcjs.BEAT_EPS ? 1 : 0;
-  }
-  return Math.min(1, Math.abs(Math.log2(x / y)));
-}
-function compareMelodies(a, b) {
-  const left = orderedNotes(phraseNotes(a), "melody a");
-  const right = orderedNotes(phraseNotes(b), "melody b");
-  const leftIntervals = intervalsOf(left);
-  const rightIntervals = intervalsOf(right);
-  const pitchSimilarity = distanceToSimilarity(
-    gradedEditDistance(leftIntervals, rightIntervals, intervalCost),
-    leftIntervals.length,
-    rightIntervals.length
-  );
-  const leftGaps = _nullishCoalesce(rhythmProfile(onsetGaps(left)), () => ( onsetGaps(left)));
-  const rightGaps = _nullishCoalesce(rhythmProfile(onsetGaps(right)), () => ( onsetGaps(right)));
-  const rhythmSimilarity = distanceToSimilarity(
-    gradedEditDistance(leftGaps, rightGaps, gapCost),
-    leftGaps.length,
-    rightGaps.length
-  );
-  const similarity = PITCH_WEIGHT * pitchSimilarity + RHYTHM_WEIGHT * rhythmSimilarity;
-  return {
-    similarity,
-    pitchSimilarity,
-    rhythmSimilarity,
-    rationale: `Interval shapes ${Math.round(pitchSimilarity * 100)}% alike, rhythms ${Math.round(rhythmSimilarity * 100)}% alike, weighted ${PITCH_WEIGHT}/${RHYTHM_WEIGHT} into ${roundTo(similarity, 3)}`
-  };
-}
-function melodicSimilarity(a, b) {
-  return compareMelodies(a, b).similarity;
-}
-
 // src/analyze/form/phrase.ts
 var CADENCE_BOUNDARY_STRENGTH = {
   authentic: 0.9,
@@ -1644,6 +1178,7 @@ var PHRASE_CUT_COST = 1.3;
 var CLOSING_SHARE = 0.65;
 var FINAL_PHRASE_BONUS = 0.15;
 var HYPERMETRIC_CLOSE_BONUS = 0.1;
+var IMPERFECT_CLOSURE_FACTOR = 0.8;
 var EVADED_FACTOR = 0.6;
 var SIGNAL_ORDER = [
   "cadence",
@@ -1654,7 +1189,7 @@ var SIGNAL_ORDER = [
   "hypermeter"
 ];
 function addSignal(boundaries, beat, signal, strength, cadence = null) {
-  const key = Math.round(beat / _chunkS5BKZZGMcjs.BEAT_EPS);
+  const key = Math.round(beat / _chunkS3QELJUEcjs.BEAT_EPS);
   const existing = boundaries.get(key);
   const boundary = _nullishCoalesce(existing, () => ( { beat, strengths: /* @__PURE__ */ new Map(), cadence: null }));
   boundary.strengths.set(signal, Math.max(_nullishCoalesce(boundary.strengths.get(signal), () => ( 0)), strength));
@@ -1668,17 +1203,23 @@ function readBoundary(boundary) {
     (a, b) => b[1] - a[1] || SIGNAL_ORDER.indexOf(a[0]) - SIGNAL_ORDER.indexOf(b[0])
   );
   return {
-    strength: _chunkSGLEQVJHcjs.combineEvidence.call(void 0, signals.map(([, strength]) => strength)),
+    strength: _chunkLQZQDBCDcjs.combineEvidence.call(void 0, signals.map(([, strength]) => strength)),
+    uncredited: _chunkLQZQDBCDcjs.combineEvidence.call(void 0, 
+      signals.filter(([signal]) => signal !== "cadence").map(([, strength]) => strength)
+    ),
     signals: signals.map(([signal]) => signal)
   };
 }
+function closesPhrase(atBeat, startBeat, endBeat) {
+  return atBeat >= startBeat - _chunkS3QELJUEcjs.BEAT_EPS && atBeat < endBeat - _chunkS3QELJUEcjs.BEAT_EPS;
+}
 function lengthFit(length, expected) {
   if (!(expected > 0)) {
     return 0;
   }
   return Math.max(-1, 1 - Math.abs(length - expected) / expected);
 }
-function choosePhrasePath(beats, strengths, minPhraseBeats, expected) {
+function choosePhrasePath(beats, strengths, minPhraseBeats, expected, held) {
   const value = new Array(beats.length).fill(Number.NEGATIVE_INFINITY);
   const cameFrom = new Array(beats.length).fill(-1);
   value[0] = 0;
@@ -1689,10 +1230,12 @@ function choosePhrasePath(beats, strengths, minPhraseBeats, expected) {
         continue;
       }
       const length = endBeat - (_nullishCoalesce(beats[i], () => ( 0)));
-      if (length < minPhraseBeats - _chunkS5BKZZGMcjs.BEAT_EPS) {
+      if (length < minPhraseBeats - _chunkS3QELJUEcjs.BEAT_EPS) {
         continue;
       }
-      const gain = (_nullishCoalesce(value[i], () => ( 0))) + (_nullishCoalesce(strengths[j], () => ( 0))) + lengthFit(length, expected) - PHRASE_CUT_COST;
+      const credited = held === void 0 || closesPhrase(_nullishCoalesce(held.arrivals[j], () => ( endBeat)), _nullishCoalesce(beats[i], () => ( 0)), endBeat);
+      const strength = credited ? _nullishCoalesce(strengths[j], () => ( 0)) : _nullishCoalesce(held.uncredited[j], () => ( 0));
+      const gain = (_nullishCoalesce(value[i], () => ( 0))) + strength + lengthFit(length, expected) - PHRASE_CUT_COST;
       if (gain > (_nullishCoalesce(value[j], () => ( Number.NEGATIVE_INFINITY)))) {
         value[j] = gain;
         cameFrom[j] = i;
@@ -1711,44 +1254,47 @@ function choosePhrasePath(beats, strengths, minPhraseBeats, expected) {
   }
   return path;
 }
-function arrivalEnd(timeline, atBeat) {
-  return _nullishCoalesce(_optionalChain([_chunkSGLEQVJHcjs.segmentStartingAt.call(void 0, timeline.segments, atBeat), 'optionalAccess', _93 => _93.endBeat]), () => ( atBeat));
+function boundaryCadences(timeline, key) {
+  const hits = _chunkLQZQDBCDcjs.detectCadences.call(void 0, timeline, key).filter((hit) => hit.cadence.type !== null);
+  const spans = cadenceSpans(
+    hits.map((hit) => ({
+      atBeat: hit.atBeat,
+      strength: CADENCE_BOUNDARY_STRENGTH[hit.cadence.type]
+    })),
+    timeline.segments
+  );
+  return { hits, spans };
 }
-function barSpanOf(startBeat, endBeat, meters) {
-  const firstBar = _chunkS5BKZZGMcjs.barIndexAt.call(void 0, startBeat, meters);
-  const lastBar = _chunkS5BKZZGMcjs.barIndexAt.call(void 0, endBeat, meters);
-  const partOf = (beat, bar) => {
-    const barStart = _chunkS5BKZZGMcjs.barPositionToBeat.call(void 0, { bar, beat: 0 }, meters);
-    const barLength = _chunkS5BKZZGMcjs.beatsPerBarAt.call(void 0, barStart, meters);
-    return barLength > 0 ? (beat - barStart) / barLength : 0;
-  };
-  const bars = lastBar - firstBar + partOf(endBeat, lastBar) - partOf(startBeat, firstBar);
-  return Math.round(bars * 100) / 100;
+function keyContextFor(key, timeline, meters, totalBeats, budget) {
+  if (key !== void 0) {
+    return key;
+  }
+  const regions = _chunkLQZQDBCDcjs.detectModulations.call(void 0, timeline.segments, { meters, totalBeats, budget });
+  const keyAt = _chunkLQZQDBCDcjs.keyLookup.call(void 0, regions, _nullishCoalesce(_chunkLQZQDBCDcjs.prevailingKeyOf.call(void 0, regions), () => ( _chunkYDGMWH43cjs.resolveKey.call(void 0, _chunkYDGMWH43cjs.majorKey.call(void 0, 0)))));
+  return (beat) => _chunkYDGMWH43cjs.scaleOf.call(void 0, keyAt(beat));
 }
-function keyContextFor(opts, notes, meters, totalBeats) {
-  if (opts.key !== void 0) {
-    return opts.key;
+function heldCadenceBoundaries(boundaries, hit, span, meters, spanEnd) {
+  const firstLine = _chunkS3QELJUEcjs.barIndexAt.call(void 0, span.atBeat, meters) + 1;
+  const lastLine = _chunkS3QELJUEcjs.barIndexAt.call(void 0, Math.min(span.endBeat, spanEnd), meters);
+  for (let bar = firstLine; bar <= lastLine; bar += 1) {
+    const line = _chunkS3QELJUEcjs.barPositionToBeat.call(void 0, { bar, beat: 0 }, meters);
+    if (line < span.endBeat - _chunkS3QELJUEcjs.BEAT_EPS) {
+      addSignal(boundaries, line, "cadence", span.strength, hit);
+    }
   }
-  const regions = _chunkSGLEQVJHcjs.keyTimelineFromNotes.call(void 0, notes, {
-    meters,
-    totalBeats,
-    budget: opts.budget
-  });
-  const keyAt = _chunkSGLEQVJHcjs.keyLookup.call(void 0, regions, _nullishCoalesce(_chunkSGLEQVJHcjs.prevailingKeyOf.call(void 0, regions), () => ( _chunk3R3QVKY5cjs.resolveKey.call(void 0, _chunk3R3QVKY5cjs.majorKey.call(void 0, 0)))));
-  return (beat) => _chunk3R3QVKY5cjs.scaleOf.call(void 0, keyAt(beat));
 }
 function restBoundaries(boundaries, notes, meters, restBeats) {
   const ordered = [...notes].sort((a, b) => a.startBeat - b.startBeat || a.pitch - b.pitch);
   let covered = Number.NEGATIVE_INFINITY;
   for (const note of ordered) {
     const gap = note.startBeat - covered;
-    if (Number.isFinite(covered) && gap >= restBeats - _chunkS5BKZZGMcjs.BEAT_EPS) {
-      const bar = _chunkS5BKZZGMcjs.beatsPerBarAt.call(void 0, note.startBeat, meters);
+    if (Number.isFinite(covered) && gap >= restBeats - _chunkS3QELJUEcjs.BEAT_EPS) {
+      const bar = _chunkS3QELJUEcjs.beatsPerBarAt.call(void 0, note.startBeat, meters);
       addSignal(
         boundaries,
         note.startBeat,
         "rest",
-        REST_STRENGTH * _chunkSGLEQVJHcjs.clamp01.call(void 0, bar > 0 ? gap / bar : 1)
+        REST_STRENGTH * _chunkLQZQDBCDcjs.clamp01.call(void 0, bar > 0 ? gap / bar : 1)
       );
     }
     covered = Math.max(covered, note.startBeat + note.durationBeat);
@@ -1758,13 +1304,13 @@ function repetitionBoundaries(boundaries, notes, meters, spanStart, spanEnd, win
   if (!(windowBeats > 0)) {
     return;
   }
-  const slices = _chunkSGLEQVJHcjs.sliceBars.call(void 0, notes, meters, spanStart, spanEnd, budget);
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, slices.length * notes.length, "form repetition comparisons", budget);
-  const onsetsIn = (from, to) => notes.filter((note) => note.startBeat >= from - _chunkS5BKZZGMcjs.BEAT_EPS && note.startBeat < to - _chunkS5BKZZGMcjs.BEAT_EPS);
+  const slices = _chunkLQZQDBCDcjs.sliceBars.call(void 0, notes, meters, spanStart, spanEnd, budget);
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, slices.length * notes.length, "form repetition comparisons", budget);
+  const onsetsIn = (from, to) => notes.filter((note) => note.startBeat >= from - _chunkS3QELJUEcjs.BEAT_EPS && note.startBeat < to - _chunkS3QELJUEcjs.BEAT_EPS);
   let comparisons = 0;
   for (const slice of slices) {
     const beat = slice.startBeat;
-    if (beat - windowBeats < spanStart - _chunkS5BKZZGMcjs.BEAT_EPS || beat + windowBeats > spanEnd + _chunkS5BKZZGMcjs.BEAT_EPS) {
+    if (beat - windowBeats < spanStart - _chunkS3QELJUEcjs.BEAT_EPS || beat + windowBeats > spanEnd + _chunkS3QELJUEcjs.BEAT_EPS) {
       continue;
     }
     const before = onsetsIn(beat - windowBeats, beat);
@@ -1773,8 +1319,8 @@ function repetitionBoundaries(boundaries, notes, meters, spanStart, spanEnd, win
       continue;
     }
     comparisons += before.length * after.length;
-    _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, comparisons, "form repetition melody comparisons", budget);
-    const similarity = melodicSimilarity(before, after);
+    _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, comparisons, "form repetition melody comparisons", budget);
+    const similarity = _chunkLQZQDBCDcjs.melodicSimilarity.call(void 0, before, after);
     if (similarity >= REPETITION_THRESHOLD) {
       addSignal(boundaries, beat, "repetition", REPETITION_STRENGTH * similarity);
     }
@@ -1790,7 +1336,7 @@ function structuralWeightOf(cadence, confidence, aligned, isLast) {
     if (result.strength === "perfect") {
       base = 1;
     } else if (result.strength === "imperfect") {
-      base *= 0.8;
+      base *= IMPERFECT_CLOSURE_FACTOR;
     }
   }
   if (result.evaded) {
@@ -1803,7 +1349,7 @@ function structuralWeightOf(cadence, confidence, aligned, isLast) {
   if (aligned) {
     weight += HYPERMETRIC_CLOSE_BONUS;
   }
-  return _chunkSGLEQVJHcjs.clamp01.call(void 0, weight);
+  return _chunkLQZQDBCDcjs.clamp01.call(void 0, weight);
 }
 function describeCadence(cadence) {
   if (cadence === null || cadence.cadence.type === null) {
@@ -1814,72 +1360,61 @@ function describeCadence(cadence) {
   return `a ${graded} cadence at beat ${cadence.atBeat}`;
 }
 function phrasesFromTimeline(timeline, notes, opts = {}) {
-  _chunkSGLEQVJHcjs.assertChordTimeline.call(void 0, timeline);
-  const meters = _chunkS5BKZZGMcjs.resolveMeters.call(void 0, opts, "phrase meters");
-  _chunkS5BKZZGMcjs.assertNoteEvents.call(void 0, notes, "phrase notes", {
+  _chunkLQZQDBCDcjs.assertChordTimeline.call(void 0, timeline);
+  const meters = _chunkS3QELJUEcjs.resolveMeters.call(void 0, opts, "phrase meters");
+  _chunkS3QELJUEcjs.assertNoteEvents.call(void 0, notes, "phrase notes", {
     allowNonPositiveDuration: true,
     budget: opts.budget
   });
   if (opts.hypermeter !== void 0) {
-    _chunkS5BKZZGMcjs.assertRange.call(void 0, opts.hypermeter.confidence, 0, 1, "phrase hypermeter confidence");
-    _chunkS5BKZZGMcjs.assertPositiveInt.call(void 0, opts.hypermeter.groupBars, "phrase hypermeter groupBars");
+    _chunkS3QELJUEcjs.assertRange.call(void 0, opts.hypermeter.confidence, 0, 1, "phrase hypermeter confidence");
+    _chunkS3QELJUEcjs.assertPositiveInt.call(void 0, opts.hypermeter.groupBars, "phrase hypermeter groupBars");
   }
   const sounding = notes.filter((note) => note.durationBeat > 0);
   const segments = timeline.segments;
   const firstSegment = segments[0];
   const lastSegment = segments[segments.length - 1];
-  const firstOnset = sounding.reduce(
-    (first, n) => Math.min(first, n.startBeat),
-    _nullishCoalesce(_optionalChain([firstSegment, 'optionalAccess', _94 => _94.startBeat]), () => ( 0))
+  const earliest = Math.min(
+    _chunkLQZQDBCDcjs.firstSoundingBeat.call(void 0, sounding, Number.POSITIVE_INFINITY),
+    _nullishCoalesce(_optionalChain([firstSegment, 'optionalAccess', _44 => _44.startBeat]), () => ( Number.POSITIVE_INFINITY))
   );
-  const spanStart = _chunkSGLEQVJHcjs.barGridStart.call(void 0, firstOnset, meters);
-  const notesEnd = sounding.reduce(
-    (end, n) => Math.max(end, n.startBeat + n.durationBeat),
-    _nullishCoalesce(_optionalChain([lastSegment, 'optionalAccess', _95 => _95.endBeat]), () => ( 0))
+  const firstOnset = Number.isFinite(earliest) ? earliest : 0;
+  const spanStart = _chunkLQZQDBCDcjs.barGridStart.call(void 0, firstOnset, meters);
+  const latestEnd = Math.max(
+    _nullishCoalesce(_optionalChain([lastSegment, 'optionalAccess', _45 => _45.endBeat]), () => ( Number.NEGATIVE_INFINITY)),
+    _chunkLQZQDBCDcjs.latestSoundingEnd.call(void 0, sounding, Number.NEGATIVE_INFINITY)
   );
-  const spanEnd = Math.max(spanStart, _nullishCoalesce(opts.totalBeats, () => ( notesEnd)));
-  _chunkS5BKZZGMcjs.assertRange.call(void 0, spanEnd, 0, Number.MAX_SAFE_INTEGER, "phrase totalBeats");
-  if (spanEnd <= spanStart + _chunkS5BKZZGMcjs.BEAT_EPS) {
+  const notesEnd = Number.isFinite(latestEnd) ? latestEnd : 0;
+  const spanEnd = _chunkLQZQDBCDcjs.resolveSpanEnd.call(void 0, opts.totalBeats, spanStart, notesEnd, "phrase totalBeats");
+  if (spanEnd <= spanStart + _chunkS3QELJUEcjs.BEAT_EPS) {
     return [];
   }
-  const barBeats = _chunkS5BKZZGMcjs.beatsPerBarAt.call(void 0, Math.max(0, spanStart), meters);
+  const barBeats = _chunkS3QELJUEcjs.beatsPerBarAt.call(void 0, Math.max(0, spanStart), meters);
   const restBeats = _nullishCoalesce(opts.restBeats, () => ( barBeats / 2));
-  _chunkS5BKZZGMcjs.assertRange.call(void 0, restBeats, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "phrase restBeats");
+  _chunkS3QELJUEcjs.assertRange.call(void 0, restBeats, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "phrase restBeats");
   const longNoteBeats = _nullishCoalesce(opts.longNoteBeats, () => ( barBeats));
-  _chunkS5BKZZGMcjs.assertRange.call(void 0, longNoteBeats, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "phrase longNoteBeats");
+  _chunkS3QELJUEcjs.assertRange.call(void 0, longNoteBeats, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "phrase longNoteBeats");
   const minPhraseBeats = _nullishCoalesce(opts.minPhraseBeats, () => ( barBeats));
-  _chunkS5BKZZGMcjs.assertRange.call(void 0, minPhraseBeats, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "phrase minPhraseBeats");
-  const key = keyContextFor(opts, sounding, meters, spanEnd);
-  const cadences = _chunkSGLEQVJHcjs.detectCadences.call(void 0, timeline, key);
-  const grouping = _nullishCoalesce(opts.hypermeter, () => ( hypermeter(sounding, meters, {
-    totalBeats: spanEnd,
-    cadenceBeats: cadences.map((hit) => hit.atBeat),
-    budget: opts.budget
-  })));
-  const firstBar = _chunkS5BKZZGMcjs.barIndexAt.call(void 0, Math.max(0, spanStart), meters);
+  _chunkS3QELJUEcjs.assertRange.call(void 0, minPhraseBeats, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "phrase minPhraseBeats");
+  const key = keyContextFor(opts.key, timeline, meters, spanEnd, opts.budget);
+  const { hits: cadences, spans } = boundaryCadences(timeline, key);
+  const grouping = _nullishCoalesce(opts.hypermeter, () => ( hypermeterOver(sounding, meters, { totalBeats: spanEnd, budget: opts.budget }, () => spans)));
+  const firstBar = _chunkS3QELJUEcjs.barIndexAt.call(void 0, Math.max(0, spanStart), meters);
   const hyperBeats = Math.max(
     barBeats,
-    _chunkS5BKZZGMcjs.barPositionToBeat.call(void 0, { bar: firstBar + grouping.groupBars, beat: 0 }, meters) - _chunkS5BKZZGMcjs.barPositionToBeat.call(void 0, { bar: firstBar, beat: 0 }, meters)
+    _chunkS3QELJUEcjs.barPositionToBeat.call(void 0, { bar: firstBar + grouping.groupBars, beat: 0 }, meters) - _chunkS3QELJUEcjs.barPositionToBeat.call(void 0, { bar: firstBar, beat: 0 }, meters)
   );
   const expected = _nullishCoalesce(opts.expectedPhraseBeats, () => ( hyperBeats));
-  _chunkS5BKZZGMcjs.assertRange.call(void 0, expected, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "phrase expectedPhraseBeats");
+  _chunkS3QELJUEcjs.assertRange.call(void 0, expected, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "phrase expectedPhraseBeats");
   const boundaries = /* @__PURE__ */ new Map();
-  for (const hit of cadences) {
-    const type = hit.cadence.type;
-    if (type === null) {
-      continue;
-    }
-    const strength = CADENCE_BOUNDARY_STRENGTH[type];
-    const chordEnd = arrivalEnd(timeline, hit.atBeat);
-    addSignal(boundaries, chordEnd, "cadence", strength, hit);
-    const barEnd = _chunkS5BKZZGMcjs.barPositionToBeat.call(void 0, { bar: _chunkS5BKZZGMcjs.barIndexAt.call(void 0, hit.atBeat, meters) + 1, beat: 0 }, meters);
-    if (chordEnd > barEnd + _chunkS5BKZZGMcjs.BEAT_EPS) {
-      addSignal(boundaries, barEnd, "cadence", strength, hit);
-    }
-  }
+  cadences.forEach((hit, index) => {
+    const span = spans[index];
+    addSignal(boundaries, span.endBeat, "cadence", span.strength, hit);
+    heldCadenceBoundaries(boundaries, hit, span, meters, spanEnd);
+  });
   restBoundaries(boundaries, sounding, meters, restBeats);
   for (const note of sounding) {
-    if (note.durationBeat >= longNoteBeats - _chunkS5BKZZGMcjs.BEAT_EPS) {
+    if (note.durationBeat >= longNoteBeats - _chunkS3QELJUEcjs.BEAT_EPS) {
       addSignal(boundaries, note.startBeat + note.durationBeat, "longNote", LONG_NOTE_STRENGTH);
     }
   }
@@ -1889,9 +1424,9 @@ function phrasesFromTimeline(timeline, notes, opts = {}) {
   }
   addSignal(boundaries, spanEnd, "pieceEnd", PIECE_END_STRENGTH);
   const candidates = [...boundaries.values()].filter(
-    (boundary) => boundary.beat > spanStart + _chunkS5BKZZGMcjs.BEAT_EPS && boundary.beat < spanEnd - _chunkS5BKZZGMcjs.BEAT_EPS
+    (boundary) => boundary.beat > spanStart + _chunkS3QELJUEcjs.BEAT_EPS && boundary.beat < spanEnd - _chunkS3QELJUEcjs.BEAT_EPS
   ).filter((boundary) => readBoundary(boundary).strength > 0).sort((a, b) => a.beat - b.beat);
-  const endBoundary = _nullishCoalesce(boundaries.get(Math.round(spanEnd / _chunkS5BKZZGMcjs.BEAT_EPS)), () => ( {
+  const endBoundary = _nullishCoalesce(boundaries.get(Math.round(spanEnd / _chunkS3QELJUEcjs.BEAT_EPS)), () => ( {
     beat: spanEnd,
     strengths: /* @__PURE__ */ new Map(),
     cadence: null
@@ -1901,40 +1436,45 @@ function phrasesFromTimeline(timeline, notes, opts = {}) {
     ...candidates,
     endBoundary
   ];
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, stops.length * stops.length, "form phrase boundary pairs", opts.budget);
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, stops.length * stops.length, "form phrase boundary pairs", opts.budget);
   const readings = stops.map(readBoundary);
   const path = choosePhrasePath(
     stops.map((stop) => stop.beat),
     readings.map((reading) => reading.strength),
     minPhraseBeats,
-    expected
+    expected,
+    {
+      arrivals: stops.map((stop) => _nullishCoalesce(_optionalChain([stop, 'access', _46 => _46.cadence, 'optionalAccess', _47 => _47.atBeat]), () => ( stop.beat))),
+      uncredited: readings.map((reading) => reading.uncredited)
+    }
   );
   const downbeatKeys = new Set(
-    grouping.downbeats.map((downbeat) => Math.round(downbeat / _chunkS5BKZZGMcjs.BEAT_EPS))
+    grouping.downbeats.map((downbeat) => Math.round(downbeat / _chunkS3QELJUEcjs.BEAT_EPS))
   );
   const phrases = [];
   let from = 0;
   for (let n = 0; n < path.length; n += 1) {
     const to = _nullishCoalesce(path[n], () => ( stops.length - 1));
-    const startBeat = _nullishCoalesce(_optionalChain([stops, 'access', _96 => _96[from], 'optionalAccess', _97 => _97.beat]), () => ( spanStart));
+    const startBeat = _nullishCoalesce(_optionalChain([stops, 'access', _48 => _48[from], 'optionalAccess', _49 => _49.beat]), () => ( spanStart));
     const stop = stops[to];
-    const endBeat = _nullishCoalesce(_optionalChain([stop, 'optionalAccess', _98 => _98.beat]), () => ( spanEnd));
-    const reading = _nullishCoalesce(readings[to], () => ( { strength: 0, signals: [] }));
+    const endBeat = _nullishCoalesce(_optionalChain([stop, 'optionalAccess', _50 => _50.beat]), () => ( spanEnd));
+    const reading = _nullishCoalesce(readings[to], () => ( { strength: 0, uncredited: 0, signals: [] }));
     const length = endBeat - startBeat;
-    const confidence = _chunkSGLEQVJHcjs.clamp01.call(void 0, 
-      CLOSING_SHARE * reading.strength + (1 - CLOSING_SHARE) * Math.max(0, lengthFit(length, expected))
-    );
     const isLast = n === path.length - 1;
-    const closing = _nullishCoalesce(_optionalChain([stop, 'optionalAccess', _99 => _99.cadence]), () => ( null));
-    const cadence = closing !== null && closing.atBeat >= startBeat - _chunkS5BKZZGMcjs.BEAT_EPS && closing.atBeat < endBeat - _chunkS5BKZZGMcjs.BEAT_EPS ? closing : null;
+    const closing = _nullishCoalesce(_optionalChain([stop, 'optionalAccess', _51 => _51.cadence]), () => ( null));
+    const cadence = closing !== null && closesPhrase(closing.atBeat, startBeat, endBeat) ? closing : null;
+    const closingStrength = cadence === null ? reading.uncredited : reading.strength;
+    const confidence = _chunkLQZQDBCDcjs.clamp01.call(void 0, 
+      CLOSING_SHARE * closingStrength + (1 - CLOSING_SHARE) * Math.max(0, lengthFit(length, expected))
+    );
     const structuralWeight = structuralWeightOf(
       cadence,
       confidence,
-      downbeatKeys.has(Math.round(endBeat / _chunkS5BKZZGMcjs.BEAT_EPS)),
+      downbeatKeys.has(Math.round(endBeat / _chunkS3QELJUEcjs.BEAT_EPS)),
       isLast
     );
     const signals = cadence === null ? reading.signals.filter((signal) => signal !== "cadence") : reading.signals;
-    const bars = barSpanOf(startBeat, endBeat, meters);
+    const bars = Math.round(_chunkLQZQDBCDcjs.barSpanOf.call(void 0, startBeat, endBeat, meters) * 100) / 100;
     phrases.push({
       startBeat,
       endBeat,
@@ -1949,10 +1489,10 @@ function phrasesFromTimeline(timeline, notes, opts = {}) {
   return phrases;
 }
 function structuralCadences(phrases) {
-  _chunkS5BKZZGMcjs.assertArray.call(void 0, phrases, "phrases");
+  _chunkS3QELJUEcjs.assertArray.call(void 0, phrases, "phrases");
   const ranked = [];
   for (let index = 0; index < phrases.length; index += 1) {
-    const phrase = _chunkS5BKZZGMcjs.assertRecord.call(void 0, phrases[index], `phrases[${index}]`);
+    const phrase = _chunkS3QELJUEcjs.assertRecord.call(void 0, phrases[index], `phrases[${index}]`);
     if (phrase.cadence === null || phrase.cadence === void 0 || phrase.cadence.cadence.type === null) {
       continue;
     }
@@ -1986,50 +1526,55 @@ function isSilent(unit) {
   return unit.notes.length === 0;
 }
 function unitSimilarity(a, b) {
-  const harmony = _chunkSGLEQVJHcjs.weightSimilarity.call(void 0, a.weights, b.weights);
+  const harmony = _chunkLQZQDBCDcjs.weightSimilarity.call(void 0, a.weights, b.weights);
   if (a.notes.length < 2 || b.notes.length < 2) {
     return a.notes.length === b.notes.length ? harmony : 0;
   }
-  const melody = melodicSimilarity(a.notes, b.notes);
-  return _chunkSGLEQVJHcjs.clamp01.call(void 0, MELODY_SHARE * melody + HARMONY_SHARE * harmony);
+  const melody = _chunkLQZQDBCDcjs.melodicSimilarity.call(void 0, a.notes, b.notes);
+  return _chunkLQZQDBCDcjs.clamp01.call(void 0, MELODY_SHARE * melody + HARMONY_SHARE * harmony);
 }
 function sectionsFromNotes(notes, opts = {}) {
-  const meters = _chunkS5BKZZGMcjs.resolveMeters.call(void 0, opts, "section meters");
-  _chunkS5BKZZGMcjs.assertNoteEvents.call(void 0, notes, "section notes", {
+  const meters = _chunkS3QELJUEcjs.resolveMeters.call(void 0, opts, "section meters");
+  _chunkS3QELJUEcjs.assertNoteEvents.call(void 0, notes, "section notes", {
     allowNonPositiveDuration: true,
     budget: opts.budget
   });
   const sounding = notes.filter((note) => note.durationBeat > 0);
+  const firstSounding = _chunkLQZQDBCDcjs.firstSoundingBeat.call(void 0, sounding);
+  const firstOnset = _chunkLQZQDBCDcjs.barGridStart.call(void 0, firstSounding, meters);
+  const spanEnd = _chunkLQZQDBCDcjs.resolveSpanEnd.call(void 0, 
+    opts.totalBeats,
+    firstOnset,
+    _chunkLQZQDBCDcjs.latestSoundingEnd.call(void 0, sounding),
+    "section totalBeats"
+  );
   if (sounding.length === 0) {
     return [];
   }
-  const firstOnset = _chunkSGLEQVJHcjs.barGridStart.call(void 0, _chunkSGLEQVJHcjs.firstSoundingBeat.call(void 0, sounding), meters);
-  const lastEnd = sounding.reduce((end, n) => Math.max(end, n.startBeat + n.durationBeat), 0);
-  const spanEnd = Math.max(firstOnset, _nullishCoalesce(opts.totalBeats, () => ( lastEnd)));
-  _chunkS5BKZZGMcjs.assertRange.call(void 0, spanEnd, 0, Number.MAX_SAFE_INTEGER, "section totalBeats");
   const threshold = _nullishCoalesce(opts.threshold, () => ( DEFAULT_THRESHOLD));
-  _chunkS5BKZZGMcjs.assertRange.call(void 0, threshold, 0, 1, "section threshold");
+  _chunkS3QELJUEcjs.assertRange.call(void 0, threshold, 0, 1, "section threshold");
   const unitBars = _nullishCoalesce(opts.unitBars, () => ( hypermeter(sounding, meters, { totalBeats: spanEnd, budget: opts.budget }).groupBars));
-  _chunkS5BKZZGMcjs.assertPositiveInt.call(void 0, unitBars, "section unitBars");
-  const firstBar = _chunkS5BKZZGMcjs.barIndexAt.call(void 0, firstOnset, meters);
-  const lastBar = _chunkSGLEQVJHcjs.lastBarOf.call(void 0, meters, firstOnset, spanEnd);
+  _chunkS3QELJUEcjs.assertPositiveInt.call(void 0, unitBars, "section unitBars");
+  const firstBar = _chunkS3QELJUEcjs.barIndexAt.call(void 0, firstOnset, meters);
+  const lastBar = _chunkLQZQDBCDcjs.lastBarOf.call(void 0, meters, firstOnset, spanEnd);
   const startBar = Math.max(0, firstBar);
   const unitCount = Math.max(1, Math.ceil((lastBar - startBar + 1) / unitBars));
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, unitCount * unitCount, "form section comparisons", opts.budget);
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, unitCount * sounding.length, "form section unit notes", opts.budget);
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, unitCount * unitCount, "form section comparisons", opts.budget);
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, unitCount * sounding.length, "form section unit notes", opts.budget);
   const units = [];
   for (let index = 0; index < unitCount; index += 1) {
     const barStart = startBar + index * unitBars;
-    const startBeat = index === 0 ? firstOnset : _chunkS5BKZZGMcjs.barPositionToBeat.call(void 0, { bar: barStart, beat: 0 }, meters);
-    const endBeat = index === unitCount - 1 ? spanEnd : _chunkS5BKZZGMcjs.barPositionToBeat.call(void 0, { bar: barStart + unitBars, beat: 0 }, meters);
+    const startBeat = index === 0 ? firstOnset : _chunkS3QELJUEcjs.barPositionToBeat.call(void 0, { bar: barStart, beat: 0 }, meters);
+    const endBeat = index === unitCount - 1 ? spanEnd : _chunkS3QELJUEcjs.barPositionToBeat.call(void 0, { bar: barStart + unitBars, beat: 0 }, meters);
+    const fromBeat = index === 0 ? Math.min(firstSounding, startBeat) : startBeat;
     const unitNotes = sounding.filter(
-      (note) => note.startBeat >= startBeat - _chunkS5BKZZGMcjs.BEAT_EPS && note.startBeat < endBeat - _chunkS5BKZZGMcjs.BEAT_EPS
+      (note) => note.startBeat >= fromBeat - _chunkS3QELJUEcjs.BEAT_EPS && note.startBeat < endBeat - _chunkS3QELJUEcjs.BEAT_EPS
     ).sort((a, b) => a.startBeat - b.startBeat || a.pitch - b.pitch);
     units.push({
       startBeat,
       endBeat,
       notes: unitNotes,
-      weights: _chunkSGLEQVJHcjs.windowWeights.call(void 0, unitNotes, startBeat, endBeat, meters).weights
+      weights: _chunkLQZQDBCDcjs.windowWeights.call(void 0, unitNotes, startBeat, endBeat, meters).weights
     });
   }
   let comparisons = 0;
@@ -2038,7 +1583,7 @@ function sectionsFromNotes(notes, opts = {}) {
     comparisons += unit.notes.length * earlierNotes;
     earlierNotes += unit.notes.length;
   }
-  _chunkS5BKZZGMcjs.assertGenerationBudget.call(void 0, comparisons, "form section melody comparisons", opts.budget);
+  _chunkS3QELJUEcjs.assertGenerationBudget.call(void 0, comparisons, "form section melody comparisons", opts.budget);
   const labels = [];
   const scores = [];
   let distinct = 0;
@@ -2093,8 +1638,8 @@ function sectionsFromNotes(notes, opts = {}) {
     while (end < units.length && labels[end] === null) {
       end += 1;
     }
-    const startBeat = _nullishCoalesce(_optionalChain([units, 'access', _100 => _100[index], 'optionalAccess', _101 => _101.startBeat]), () => ( 0));
-    const endBeat = _nullishCoalesce(_optionalChain([units, 'access', _102 => _102[end - 1], 'optionalAccess', _103 => _103.endBeat]), () => ( spanEnd));
+    const startBeat = _nullishCoalesce(_optionalChain([units, 'access', _52 => _52[index], 'optionalAccess', _53 => _53.startBeat]), () => ( 0));
+    const endBeat = _nullishCoalesce(_optionalChain([units, 'access', _54 => _54[end - 1], 'optionalAccess', _55 => _55.endBeat]), () => ( spanEnd));
     const sectionFirstBar = startBar + index * unitBars;
     const sectionLastBar = Math.max(
       sectionFirstBar,
@@ -2105,7 +1650,7 @@ function sectionsFromNotes(notes, opts = {}) {
     if (first === void 0) {
       firstByLabel.set(label, sectionIndex);
     }
-    const similarity = first === void 0 ? 1 : _chunkSGLEQVJHcjs.clamp01.call(void 0, scoreSum / Math.max(1, sounded));
+    const similarity = first === void 0 ? 1 : _chunkLQZQDBCDcjs.clamp01.call(void 0, scoreSum / Math.max(1, sounded));
     sections.push({
       label,
       startBeat,
@@ -2113,163 +1658,280 @@ function sectionsFromNotes(notes, opts = {}) {
       bars: sectionLastBar - sectionFirstBar + 1,
       firstOccurrence: _nullishCoalesce(first, () => ( sectionIndex)),
       similarity,
-      rationale: first === void 0 ? `Section ${label}: material first heard at beat ${startBeat}` : `Section ${label}: ${Math.round(similarity * 100)}% alike the ${label} at beat ${_nullishCoalesce(_optionalChain([sections, 'access', _104 => _104[first], 'optionalAccess', _105 => _105.startBeat]), () => ( 0))}`
+      rationale: first === void 0 ? `Section ${label}: material first heard at beat ${startBeat}` : `Section ${label}: ${Math.round(similarity * 100)}% alike the ${label} at beat ${_nullishCoalesce(_optionalChain([sections, 'access', _56 => _56[first], 'optionalAccess', _57 => _57.startBeat]), () => ( 0))}`
     });
     index = end;
   }
   return sections;
 }
 
-// src/analyze/reduction/index.ts
-var TONIC_ARRIVING = /* @__PURE__ */ new Set(["authentic", "plagal", "modal", "deceptive"]);
-function signedStep(fromPc, toPc) {
-  return (_chunkS5BKZZGMcjs.pitchClassOf.call(void 0, toPc) - _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, fromPc) + 18) % 12 - 6;
+// src/analyze/reference/compare.ts
+var RATIONALE_FIELDS = 2;
+function rationaleOf(comparison) {
+  const measured = [];
+  for (const group of [comparison.form, comparison.harmony, comparison.melody, comparison.rhythm]) {
+    for (const [name, value] of Object.entries(group)) {
+      if (value !== null) {
+        measured.push({ name, value, order: measured.length });
+      }
+    }
+  }
+  if (measured.length === 0) {
+    return "Nothing to compare: neither profile has material for any field";
+  }
+  const describe = (entries) => entries.map((entry) => `${entry.name} ${Math.round(entry.value * 100)}%`).join(", ");
+  const highest = [...measured].sort((x, y) => y.value - x.value || x.order - y.order);
+  const lowest = [...measured].sort((x, y) => x.value - y.value || x.order - y.order);
+  return `Most alike: ${describe(highest.slice(0, RATIONALE_FIELDS))}; least alike: ${describe(lowest.slice(0, RATIONALE_FIELDS))}`;
+}
+function compareReferences(a, b, opts) {
+  _chunkLQZQDBCDcjs.assertReferenceProfile.call(void 0, a, "reference profile a");
+  _chunkLQZQDBCDcjs.assertReferenceProfile.call(void 0, b, "reference profile b");
+  const { budget } = _chunkS3QELJUEcjs.assertOptions.call(void 0, opts, "compare options");
+  const structural = (profile) => profile.harmony.chords.filter((chord) => chord.level === "structural");
+  const cadences = (profile) => profile.form.phrases.map((phrase) => _nullishCoalesce(_optionalChain([phrase, 'access', _58 => _58.cadence, 'optionalAccess', _59 => _59.type]), () => ( null)));
+  const phraseMelodies = (profile) => profile.form.phrases.map((phrase) => phrase.melody);
+  const comparison = {
+    form: {
+      sectionSequenceSimilarity: _chunkLQZQDBCDcjs.sectionSequenceSimilarity.call(void 0, 
+        a.form.sections.map((section) => section.label),
+        b.form.sections.map((section) => section.label)
+      ),
+      phraseLengthSimilarity: _chunkLQZQDBCDcjs.phraseLengthSimilarity.call(void 0, 
+        a.form.phrases.map((phrase) => phrase.bars),
+        b.form.phrases.map((phrase) => phrase.bars)
+      )
+    },
+    harmony: {
+      progressionSimilarity: _chunkLQZQDBCDcjs.progressionSimilarity.call(void 0, structural(a), structural(b), budget),
+      functionSimilarity: _chunkLQZQDBCDcjs.functionSimilarity.call(void 0, a.harmony.chords, b.harmony.chords),
+      cadenceSimilarity: _chunkLQZQDBCDcjs.cadenceSimilarity.call(void 0, cadences(a), cadences(b)),
+      keyPlanSimilarity: _chunkLQZQDBCDcjs.keyPlanSimilarity.call(void 0, 
+        a.harmony.keys.map((region) => region.key),
+        b.harmony.keys.map((region) => region.key)
+      ),
+      harmonicRhythmOnsetSimilarity: _chunkLQZQDBCDcjs.onsetSimilarity.call(void 0, a.harmony.rhythm, b.harmony.rhythm),
+      harmonicRhythmDensitySimilarity: _chunkLQZQDBCDcjs.densitySimilarity.call(void 0, a.harmony.rhythm, b.harmony.rhythm)
+    },
+    melody: {
+      surfaceSimilarity: _chunkLQZQDBCDcjs.surfaceSimilarity.call(void 0, a.melody.motifs, b.melody.motifs),
+      motifStructureSimilarity: _chunkLQZQDBCDcjs.motifStructureSimilarity.call(void 0, 
+        { graph: a.melody.graph, spanBeats: a.span.endBeat - a.span.startBeat },
+        { graph: b.melody.graph, spanBeats: b.span.endBeat - b.span.startBeat }
+      ),
+      contourSimilarity: _chunkLQZQDBCDcjs.contourSimilarity.call(void 0, phraseMelodies(a), phraseMelodies(b)),
+      registerSimilarity: _chunkLQZQDBCDcjs.registerSimilarity.call(void 0, 
+        { phrases: phraseMelodies(a), mean: _nullishCoalesce(_optionalChain([a, 'access', _60 => _60.melody, 'access', _61 => _61.register, 'optionalAccess', _62 => _62.mean]), () => ( null)) },
+        { phrases: phraseMelodies(b), mean: _nullishCoalesce(_optionalChain([b, 'access', _63 => _63.melody, 'access', _64 => _64.register, 'optionalAccess', _65 => _65.mean]), () => ( null)) }
+      )
+    },
+    rhythm: {
+      onsetSimilarity: _chunkLQZQDBCDcjs.onsetSimilarity.call(void 0, a.melody.rhythm, b.melody.rhythm),
+      densitySimilarity: _chunkLQZQDBCDcjs.densitySimilarity.call(void 0, a.melody.rhythm, b.melody.rhythm),
+      durationSimilarity: _chunkLQZQDBCDcjs.durationSimilarity.call(void 0, a.melody.rhythm, b.melody.rhythm),
+      syncopationSimilarity: _chunkLQZQDBCDcjs.syncopationSimilarity.call(void 0, a.melody.rhythm, b.melody.rhythm)
+    }
+  };
+  return { ...comparison, rationale: rationaleOf(comparison) };
 }
-function isStep(distance) {
-  const size = Math.abs(distance);
-  return size === 1 || size === 2;
+
+// src/analyze/reference/profile.ts
+function spanOf(sounding, timeline, meters, totalBeats) {
+  const segments = timeline.segments;
+  const firstSegment = segments[0];
+  const lastSegment = segments[segments.length - 1];
+  const firstOnset = _chunkLQZQDBCDcjs.firstSoundingBeat.call(void 0, sounding, _nullishCoalesce(_optionalChain([firstSegment, 'optionalAccess', _66 => _66.startBeat]), () => ( 0)));
+  const startBeat = _chunkLQZQDBCDcjs.barGridStart.call(void 0, 
+    Math.min(firstOnset, _nullishCoalesce(_optionalChain([firstSegment, 'optionalAccess', _67 => _67.startBeat]), () => ( firstOnset))),
+    meters
+  );
+  const latestEnd = Math.max(
+    _nullishCoalesce(_optionalChain([lastSegment, 'optionalAccess', _68 => _68.endBeat]), () => ( Number.NEGATIVE_INFINITY)),
+    _chunkLQZQDBCDcjs.latestSoundingEnd.call(void 0, sounding, Number.NEGATIVE_INFINITY)
+  );
+  const notesEnd = Number.isFinite(latestEnd) ? latestEnd : 0;
+  return { startBeat, endBeat: Math.max(startBeat, _nullishCoalesce(totalBeats, () => ( notesEnd))) };
 }
-function touches(before, after) {
-  return Math.abs(after.startBeat - before.endBeat) <= _chunkS5BKZZGMcjs.BEAT_EPS;
+function sameKey(a, b) {
+  return _chunkS3QELJUEcjs.pitchClassOf.call(void 0, a.scale.rootPc) === _chunkS3QELJUEcjs.pitchClassOf.call(void 0, b.scale.rootPc) && a.scale.modeMask12 === b.scale.modeMask12;
 }
-function salienceFloors(durations) {
-  const order = durations.map((_, index) => index).sort((a, b) => {
-    const left = _nullishCoalesce(durations[a], () => ( 0));
-    const right = _nullishCoalesce(durations[b], () => ( 0));
-    return left - right || a - b;
+function keyIndexAt(regions, beat, prevailing) {
+  const holding = regions.findIndex((region) => region.startBeat <= beat && beat < region.endBeat);
+  if (holding >= 0) {
+    return holding;
+  }
+  return Math.max(
+    0,
+    regions.findIndex((region) => sameKey(region.key, prevailing))
+  );
+}
+function sectionAt(sections, beat) {
+  const index = sections.findIndex(
+    (section) => beat >= section.startBeat - _chunkS3QELJUEcjs.BEAT_EPS && beat < section.endBeat - _chunkS3QELJUEcjs.BEAT_EPS
+  );
+  return index < 0 ? null : index;
+}
+function readingsFor(notes, opts = {}) {
+  const asked = _chunkS3QELJUEcjs.assertOptions.call(void 0, opts, "reference options");
+  const meters = _chunkS3QELJUEcjs.resolveMeters.call(void 0, asked, "reference meters");
+  const budget = asked.budget;
+  if (asked.timeline === void 0) {
+    return _chunkLQZQDBCDcjs.chordTimelineFromNotes.call(void 0, notes, {
+      meters,
+      key: asked.key,
+      totalBeats: asked.totalBeats,
+      budget
+    });
+  }
+  const timeline = _chunkLQZQDBCDcjs.assertChordTimeline.call(void 0, asked.timeline, "reference timeline");
+  let keys;
+  if (asked.key === void 0) {
+    keys = _chunkLQZQDBCDcjs.keyTimelineFromNotes.call(void 0, notes, { meters, totalBeats: asked.totalBeats, budget });
+  } else {
+    const sounding = _chunkS3QELJUEcjs.assertNoteEvents.call(void 0, notes, "reference notes", {
+      allowNonPositiveDuration: true,
+      budget
+    }).filter((note) => note.durationBeat > 0);
+    const span = spanOf(sounding, timeline, meters, asked.totalBeats);
+    keys = _chunkLQZQDBCDcjs.statedKeyRegions.call(void 0, _chunkYDGMWH43cjs.resolveKey.call(void 0, asked.key), span.startBeat, span.endBeat);
+  }
+  return { timeline, keys, prevailingKey: _nullishCoalesce(_chunkLQZQDBCDcjs.prevailingKeyOf.call(void 0, keys), () => ( _chunkYDGMWH43cjs.resolveKey.call(void 0, _chunkYDGMWH43cjs.majorKey.call(void 0, 0)))) };
+}
+function referenceFromReadings(notes, readings, opts = {}) {
+  const asked = _chunkS3QELJUEcjs.assertOptions.call(void 0, opts, "reference options");
+  const meters = _chunkS3QELJUEcjs.resolveMeters.call(void 0, asked, "reference meters");
+  const budget = asked.budget;
+  const sounding = _chunkS3QELJUEcjs.assertNoteEvents.call(void 0, notes, "reference notes", {
+    allowNonPositiveDuration: true,
+    budget
+  }).filter((note) => note.durationBeat > 0);
+  if (asked.totalBeats !== void 0) {
+    _chunkS3QELJUEcjs.assertRange.call(void 0, asked.totalBeats, 0, Number.MAX_SAFE_INTEGER, "reference totalBeats");
+  }
+  const line = _chunkLQZQDBCDcjs.orderedNotes.call(void 0, _nullishCoalesce(asked.melody, () => ( notes)), "reference melody", budget).map(
+    (note) => Object.is(note.pitch, -0) ? { ...note, pitch: 0 } : note
+  );
+  const { timeline, prevailingKey } = readings;
+  const span = spanOf(sounding, timeline, meters, asked.totalBeats);
+  const spanEnd = span.endBeat;
+  const keyAt = _chunkLQZQDBCDcjs.keyLookup.call(void 0, readings.keys, prevailingKey);
+  const scaleAt = (beat) => _chunkYDGMWH43cjs.scaleOf.call(void 0, keyAt(beat));
+  const cadenceBeats = _chunkLQZQDBCDcjs.detectCadences.call(void 0, timeline, scaleAt).map((hit) => hit.atBeat);
+  const grouping = hypermeter(sounding, meters, { cadenceBeats, totalBeats: spanEnd, budget });
+  const phrases = phrasesFromTimeline(timeline, notes, {
+    meters,
+    key: scaleAt,
+    hypermeter: grouping,
+    totalBeats: spanEnd,
+    budget
   });
-  const rankOf = new Array(durations.length).fill(0);
-  for (let rank = 0; rank < order.length; rank += 1) {
-    rankOf[_nullishCoalesce(order[rank], () => ( 0))] = rank;
-  }
-  const floors = [];
-  const remaining = durations.length - 1;
-  for (let index = 0; index < durations.length; index += 1) {
-    if (remaining <= 0) {
-      floors.push(0);
-      continue;
-    }
-    const skipped = _nullishCoalesce(rankOf[index], () => ( 0));
-    const at = (position) => _nullishCoalesce(durations[_nullishCoalesce(order[position < skipped ? position : position + 1], () => ( 0))], () => ( 0));
-    const middle = remaining >> 1;
-    floors.push(remaining % 2 === 1 ? at(middle) : (at(middle - 1) + at(middle)) / 2);
-  }
-  return floors;
-}
-function isTonicChord(chord, key) {
-  return _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, chord.rootPc - key.rootPc) === 0 && !_chunkSGLEQVJHcjs.isAppliedDominant.call(void 0, chord, key);
-}
-function functionalReason(segment, before, after, keyAt) {
-  const key = keyAt(segment.startBeat);
-  if (after !== void 0 && _chunkSGLEQVJHcjs.isCadentialSixFour.call(void 0, segment.chord, after.chord, key)) {
-    return { kind: "cadentialSixFour" };
-  }
-  if (isTonicChord(segment.chord, key)) {
-    return { kind: "tonic" };
-  }
-  if (_chunk3R3QVKY5cjs.isDominantChordOf.call(void 0, segment.chord, key)) {
-    return { kind: "dominant" };
-  }
-  if (before !== void 0) {
-    const arrival = _chunkSGLEQVJHcjs.detectCadence.call(void 0, before.chord, segment.chord, key).type;
-    if (arrival !== null) {
-      return { kind: "cadenceArrival", cadence: arrival };
-    }
-  }
-  if (after !== void 0) {
-    const agent = _chunkSGLEQVJHcjs.detectCadence.call(void 0, segment.chord, after.chord, keyAt(after.startBeat)).type;
-    if (agent !== null && TONIC_ARRIVING.has(agent)) {
-      return { kind: "cadenceAgent", cadence: agent };
-    }
-  }
-  return null;
-}
-function figureReason(segment, before, after) {
-  if (before === void 0 || after === void 0) {
-    return null;
-  }
-  const incoming = signedStep(before.chord.rootPc, segment.chord.rootPc);
-  const outgoing = signedStep(segment.chord.rootPc, after.chord.rootPc);
-  if (!isStep(incoming) || !isStep(outgoing)) {
-    return null;
-  }
-  if (incoming > 0 === outgoing > 0) {
-    return { kind: "passing" };
-  }
-  return _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, before.chord.rootPc) === _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, after.chord.rootPc) ? { kind: "neighbor" } : null;
-}
-function describe(reason) {
-  switch (reason.kind) {
-    case "tonic":
-      return "Structural: the tonic of the key, which the progression is heard against";
-    case "dominant":
-      return "Structural: the dominant of the key, the chord its tonic is approached from";
-    case "cadentialSixFour":
-      return "Structural: a tonic six-four on the bass of the dominant that follows, which prolongs that dominant rather than framing the tonic";
-    case "cadenceArrival":
-      return `Structural: the arrival of a ${reason.cadence} cadence`;
-    case "cadenceAgent":
-      return `Structural: the chord that drives a ${reason.cadence} cadence`;
-    case "salient":
-      return "Structural: it holds the harmony longer than the chords around it";
-    case "first":
-      return "Structural: the first chord of the progression frames it";
-    case "last":
-      return "Structural: the last chord of the progression frames it";
-    case "unfigured":
-      return "Structural: its root neither steps through to the next chord nor returns to the last, so it embellishes nothing";
-    case "passing":
-      return "Passing: its root steps in from the previous chord and on to the next in the same direction";
-    case "neighbor":
-      return "Neighbor: its root steps away from the surrounding harmony and returns to it";
-  }
-}
-var BASIS_READINGS = {
-  function: ({ segment, before, after, keyAt }) => functionalReason(segment, before, after, keyAt),
-  duration: ({ segment, salienceFloor }) => segment.endBeat - segment.startBeat > salienceFloor ? { kind: "salient" } : null
-};
-var REDUCTION_BASES = Object.keys(BASIS_READINGS);
-function levelOf(reason) {
-  if (reason.kind === "passing") {
-    return "passing";
-  }
-  return reason.kind === "neighbor" ? "neighbor" : "structural";
-}
-function reduceProgression(timeline, key, opts = {}) {
-  _chunkSGLEQVJHcjs.assertChordTimeline.call(void 0, timeline);
-  const asked = _chunkS5BKZZGMcjs.assertOptions.call(void 0, opts, "opts");
-  const keyAt = _chunkSGLEQVJHcjs.keyScaleAt.call(void 0, key);
-  const basis = _chunkS5BKZZGMcjs.assertOneOf.call(void 0, _nullishCoalesce(asked.basis, () => ( "function")), REDUCTION_BASES, "reduction basis");
-  const reading = BASIS_READINGS[basis];
-  const segments = timeline.segments;
-  const floors = basis === "duration" ? salienceFloors(segments.map((segment) => segment.endBeat - segment.startBeat)) : [];
-  const result = [];
-  for (let index = 0; index < segments.length; index += 1) {
-    const segment = segments[index];
-    if (segment === void 0) {
-      continue;
+  const cadences = /* @__PURE__ */ new Map();
+  for (const closing of structuralCadences(phrases)) {
+    const type = closing.cadence.type;
+    if (type !== null) {
+      cadences.set(closing.phraseIndex, {
+        atBeat: closing.atBeat,
+        type,
+        weight: closing.weight
+      });
     }
-    const previous = segments[index - 1];
-    const following = segments[index + 1];
-    const before = previous !== void 0 && touches(previous, segment) ? previous : void 0;
-    const after = following !== void 0 && touches(segment, following) ? following : void 0;
-    let reason = reading({ segment, before, after, keyAt, salienceFloor: _nullishCoalesce(floors[index], () => ( 0)) });
-    if (reason === null && index === 0) {
-      reason = { kind: "first" };
-    }
-    if (reason === null && index === segments.length - 1) {
-      reason = { kind: "last" };
-    }
-    reason ??= _nullishCoalesce(figureReason(segment, before, after), () => ( { kind: "unfigured" }));
-    result.push({
-      chord: segment.chord,
-      startBeat: segment.startBeat,
-      endBeat: segment.endBeat,
-      level: levelOf(reason),
-      rationale: describe(reason)
-    });
   }
-  return result;
+  const sections = sectionsFromNotes(notes, {
+    meters,
+    unitBars: grouping.groupBars,
+    totalBeats: spanEnd,
+    budget
+  });
+  const keys = readings.keys.length === 0 && timeline.segments.length > 0 ? [
+    {
+      startBeat: span.startBeat,
+      endBeat: spanEnd,
+      key: _chunkYDGMWH43cjs.resolveKey.call(void 0, prevailingKey),
+      confidence: 0
+    }
+  ] : readings.keys.map((region) => ({
+    startBeat: region.startBeat,
+    endBeat: region.endBeat,
+    key: _chunkYDGMWH43cjs.resolveKey.call(void 0, region.key),
+    confidence: region.confidence
+  }));
+  const chords = _chunkLQZQDBCDcjs.reduceProgression.call(void 0, timeline, scaleAt).map((reduced) => {
+    const index = keyIndexAt(keys, (reduced.startBeat + reduced.endBeat) / 2, prevailingKey);
+    const key = keys[index].key;
+    return {
+      startBeat: reduced.startBeat,
+      endBeat: reduced.endBeat,
+      key: index,
+      roman: _chunkLQZQDBCDcjs.chordToRoman.call(void 0, reduced.chord, key),
+      function: _chunkLQZQDBCDcjs.functionOf.call(void 0, reduced.chord, key),
+      level: reduced.level
+    };
+  });
+  const chordOnsets = timeline.segments.map((segment) => ({
+    pitch: 60,
+    startBeat: segment.startBeat,
+    durationBeat: segment.endBeat - segment.startBeat
+  }));
+  const harmonyRhythm = _chunkLQZQDBCDcjs.analyzeRhythm.call(void 0, chordOnsets, { meters, totalBeats: spanEnd, budget });
+  const motifs = _chunkLQZQDBCDcjs.extractMotifs.call(void 0, line, { budget });
+  const graph = _chunkLQZQDBCDcjs.motifGraph.call(void 0, line, motifs, { key: prevailingKey, budget });
+  let register = null;
+  if (line.length > 0) {
+    const pitches = line.map((note) => note.pitch);
+    register = {
+      low: Math.min(...pitches),
+      high: Math.max(...pitches),
+      mean: _chunkLQZQDBCDcjs.weightedMean.call(void 0, line)
+    };
+  }
+  const lineMean = _nullishCoalesce(_optionalChain([register, 'optionalAccess', _69 => _69.mean]), () => ( 0));
+  const referenceMotifs = motifs.map((motif) => {
+    const first = motif.occurrences[0];
+    return {
+      intervals: motif.intervals,
+      rhythm: motif.rhythm,
+      unitBeats: motif.notes.length < 2 ? 0 : motif.notes[1].startBeat - motif.notes[0].startBeat,
+      spanBeats: first === void 0 ? 0 : first.endBeat - first.startBeat,
+      occurrences: motif.occurrences.length
+    };
+  });
+  const referencePhrases = phrases.map((phrase, index) => ({
+    startBeat: phrase.startBeat,
+    endBeat: phrase.endBeat,
+    bars: _chunkLQZQDBCDcjs.barSpanOf.call(void 0, phrase.startBeat, phrase.endBeat, meters),
+    section: sectionAt(sections, phrase.startBeat),
+    confidence: phrase.confidence,
+    cadence: _nullishCoalesce(cadences.get(index), () => ( null)),
+    melody: _chunkLQZQDBCDcjs.phraseMelody.call(void 0, line, phrase.startBeat, phrase.endBeat, lineMean, meters, budget),
+    motifNodes: graph.nodes.flatMap(
+      (node, nodeIndex) => node.startBeat >= phrase.startBeat - _chunkS3QELJUEcjs.BEAT_EPS && node.startBeat < phrase.endBeat - _chunkS3QELJUEcjs.BEAT_EPS ? [nodeIndex] : []
+    )
+  }));
+  return {
+    profileVersion: _chunkLQZQDBCDcjs.REFERENCE_PROFILE_VERSION,
+    span: {
+      startBeat: span.startBeat,
+      endBeat: spanEnd,
+      bars: _chunkLQZQDBCDcjs.barSpanOf.call(void 0, span.startBeat, spanEnd, meters)
+    },
+    meters,
+    form: {
+      hypermeter: { groupBars: grouping.groupBars, confidence: grouping.confidence },
+      sections,
+      phrases: referencePhrases
+    },
+    harmony: { keys, chords, rhythm: harmonyRhythm },
+    melody: {
+      register,
+      shape: line.length < 2 ? null : _chunkLQZQDBCDcjs.melodicContour.call(void 0, line).shape,
+      motifs: referenceMotifs,
+      graph,
+      rhythm: _chunkLQZQDBCDcjs.rhythmOver.call(void 0, line, { meters, totalBeats: spanEnd, budget }, span.startBeat)
+    }
+  };
+}
+function analyzeReference(notes, opts) {
+  return referenceFromReadings(notes, readingsFor(notes, opts), opts);
 }
 
 
@@ -2290,5 +1952,7 @@ function reduceProgression(timeline, key, opts = {}) {
 
 
 
-exports.trackRoleOf = trackRoleOf; exports.analyzePolyphony = analyzePolyphony; exports.analyzeArrangement = analyzeArrangement; exports.createArrangementSession = createArrangementSession; exports.tensionCurve = tensionCurve; exports.tensionCurveFrom = tensionCurveFrom; exports.hypermeter = hypermeter; exports.melodicContour = melodicContour; exports.extractMotifs = extractMotifs; exports.motifFromNotes = motifFromNotes; exports.relateMotifs = relateMotifs; exports.compareMelodies = compareMelodies; exports.melodicSimilarity = melodicSimilarity; exports.phrasesFromTimeline = phrasesFromTimeline; exports.structuralCadences = structuralCadences; exports.sectionsFromNotes = sectionsFromNotes; exports.reduceProgression = reduceProgression;
-//# sourceMappingURL=chunk-HPVSH7SF.cjs.map
+
+
+exports.trackRoleOf = trackRoleOf; exports.arrangementProfile = arrangementProfile; exports.assertTrackNotes = assertTrackNotes; exports.harmonyTrackSet = harmonyTrackSet; exports.analyzePolyphony = analyzePolyphony; exports.analyzeArrangement = analyzeArrangement; exports.createArrangementSession = createArrangementSession; exports.tensionCurve = tensionCurve; exports.tensionCurveFrom = tensionCurveFrom; exports.hypermeter = hypermeter; exports.hypermeterOver = hypermeterOver; exports.boundaryCadences = boundaryCadences; exports.keyContextFor = keyContextFor; exports.phrasesFromTimeline = phrasesFromTimeline; exports.structuralCadences = structuralCadences; exports.sectionsFromNotes = sectionsFromNotes; exports.compareReferences = compareReferences; exports.referenceFromReadings = referenceFromReadings; exports.analyzeReference = analyzeReference;
+//# sourceMappingURL=chunk-3MDOEFIQ.cjs.map