@libraz/libcantus 0.9.4 → 0.9.5

package/dist/{chunk-LW53AHQU.cjs → chunk-OL3IHHSJ.cjs}

@@ -9,7 +9,7 @@
 
 
 
-var _chunkFNDWXRRIcjs = require('./chunk-FNDWXRRI.cjs');
+var _chunkBSLTLGM3cjs = require('./chunk-BSLTLGM3.cjs');
 
 
 
@@ -24,7 +24,9 @@ var _chunkFNDWXRRIcjs = require('./chunk-FNDWXRRI.cjs');
 
 
 
-var _chunk7MGZ7D62cjs = require('./chunk-7MGZ7D62.cjs');
+
+
+var _chunkPI3UXRWKcjs = require('./chunk-PI3UXRWK.cjs');
 
 // src/theory/chordscale/index.ts
 function popcount12(mask) {
@@ -35,7 +37,7 @@ function popcount12(mask) {
   return count;
 }
 function maskHasPitchClass(mask, scaleRootPc, pc) {
-  const offset = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, pc - scaleRootPc);
+  const offset = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, pc - scaleRootPc);
   return (mask >> offset & 1) === 1;
 }
 function scaleMatchesChord(chordPcs, scaleMask, scaleRootPc) {
@@ -59,46 +61,63 @@ var SCALE_PREFERENCE = [
   "phrygian",
   "locrian"
 ];
+var IDIOMATIC_SCALES = {
+  aug: ["wholeTone"],
+  m7b5: ["locrian"]
+};
 function conventionalRank(name) {
   const index = SCALE_PREFERENCE.indexOf(name);
   return index < 0 ? SCALE_PREFERENCE.length : index;
 }
+function idiomaticRank(chord, name) {
+  const choices = IDIOMATIC_SCALES[chord.quality];
+  if (choices === void 0) {
+    return 0;
+  }
+  const index = choices.indexOf(name);
+  return index < 0 ? choices.length + 1 : index;
+}
+function isAlteredDominant(chord, scaleName) {
+  return chord.quality === "dom7" && scaleName === "altered";
+}
 function chordScales(chord) {
-  const chordPcs = _chunkFNDWXRRIcjs.chordPitchClasses.call(void 0, chord);
-  const rootPc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.rootPc);
+  const chordPcs = _chunkBSLTLGM3cjs.chordPitchClasses.call(void 0, chord);
+  const rootPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc);
   const ranked = [];
   const seenMasks = /* @__PURE__ */ new Set();
-  for (const name of Object.keys(_chunkFNDWXRRIcjs.NAMED_SCALES)) {
+  for (const name of Object.keys(_chunkBSLTLGM3cjs.NAMED_SCALES)) {
     if (name === "chromatic" || ALIASED_SCALE_NAMES.has(name)) {
       continue;
     }
-    const mask = _chunkFNDWXRRIcjs.namedScaleMask.call(void 0, name);
+    const mask = _chunkBSLTLGM3cjs.namedScaleMask.call(void 0, name);
     if (mask === void 0 || seenMasks.has(mask)) {
       continue;
     }
     seenMasks.add(mask);
-    if (scaleMatchesChord(chordPcs, mask, rootPc)) {
+    if (scaleMatchesChord(chordPcs, mask, rootPc) || isAlteredDominant(chord, name)) {
       const size = popcount12(mask);
       ranked.push({ name, extra: size - chordPcs.length, size });
     }
   }
   if (ranked.length === 0) {
-    if (_chunkFNDWXRRIcjs.NAMED_SCALES.chromatic !== void 0) {
+    if (_chunkBSLTLGM3cjs.NAMED_SCALES.chromatic !== void 0) {
       return [{ name: "chromatic", rootPc }];
     }
     return [];
   }
   const preferHeptatonic = chordPcs.length <= 3;
   ranked.sort((a, b) => {
+    const idiomaticA = idiomaticRank(chord, a.name);
+    const idiomaticB = idiomaticRank(chord, b.name);
+    if (idiomaticA !== idiomaticB) {
+      return idiomaticA - idiomaticB;
+    }
     if (preferHeptatonic && a.size === HEPTATONIC_SIZE !== (b.size === HEPTATONIC_SIZE)) {
       return a.size === HEPTATONIC_SIZE ? -1 : 1;
     }
     if (a.extra !== b.extra) {
       return a.extra - b.extra;
     }
-    if (a.size !== b.size) {
-      return a.size - b.size;
-    }
     const rankA = conventionalRank(a.name);
     const rankB = conventionalRank(b.name);
     if (rankA !== rankB) {
@@ -109,10 +128,11 @@ function chordScales(chord) {
   return ranked.map((entry) => ({ name: entry.name, rootPc }));
 }
 function avoidNotes(chord, scaleName) {
-  const mask = _chunkFNDWXRRIcjs.requireScaleMask.call(void 0, scaleName);
-  const rootPc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.rootPc);
-  const chordPcs = _chunkFNDWXRRIcjs.chordPitchClasses.call(void 0, chord);
-  if (!scaleMatchesChord(chordPcs, mask, rootPc)) {
+  const mask = _chunkBSLTLGM3cjs.requireScaleMask.call(void 0, scaleName);
+  const rootPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc);
+  const chordPcs = _chunkBSLTLGM3cjs.chordPitchClasses.call(void 0, chord);
+  const alteredDominant = isAlteredDominant(chord, scaleName);
+  if (!scaleMatchesChord(chordPcs, mask, rootPc) && !alteredDominant) {
     return [];
   }
   const chordSet = new Set(chordPcs);
@@ -121,21 +141,23 @@ function avoidNotes(chord, scaleName) {
     if (!maskHasPitchClass(mask, rootPc, pc) || chordSet.has(pc)) {
       continue;
     }
-    if (chordSet.has(_chunk7MGZ7D62cjs.pitchClassOf.call(void 0, pc - 1))) {
+    const suspendedThird = chord.quality === "sus4" || chord.quality === "7sus4" ? pc === _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, rootPc + 4) : false;
+    if (!alteredDominant && (chordSet.has(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, pc - 1)) || suspendedThird)) {
       avoid.push(pc);
     }
   }
   return avoid.sort((a, b) => a - b);
 }
 function availableTensions(chord, scaleName) {
-  const mask = _chunkFNDWXRRIcjs.requireScaleMask.call(void 0, scaleName);
-  const rootPc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.rootPc);
-  const chordPcs = _chunkFNDWXRRIcjs.chordPitchClasses.call(void 0, chord);
-  if (!scaleMatchesChord(chordPcs, mask, rootPc)) {
+  const mask = _chunkBSLTLGM3cjs.requireScaleMask.call(void 0, scaleName);
+  const rootPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc);
+  const chordPcs = _chunkBSLTLGM3cjs.chordPitchClasses.call(void 0, chord);
+  const alteredDominant = isAlteredDominant(chord, scaleName);
+  if (!scaleMatchesChord(chordPcs, mask, rootPc) && !alteredDominant) {
     return [];
   }
   const chordSet = new Set(chordPcs);
-  const avoidSet = new Set(avoidNotes(chord, scaleName));
+  const avoidSet = alteredDominant ? /* @__PURE__ */ new Set() : new Set(avoidNotes(chord, scaleName));
   const tensions = [];
   for (let pc = 0; pc < 12; pc += 1) {
     if (!maskHasPitchClass(mask, rootPc, pc) || chordSet.has(pc) || avoidSet.has(pc)) {
@@ -146,8 +168,11 @@ function availableTensions(chord, scaleName) {
   return tensions.sort((a, b) => a - b);
 }
 function chordScaleReport(chord, limit) {
+  if (limit !== void 0) {
+    _chunkPI3UXRWKcjs.assertPositiveInt.call(void 0, limit, "chord-scale report limit");
+  }
   const matches = chordScales(chord);
-  const chosen = limit === void 0 ? matches : matches.slice(0, Math.max(0, limit));
+  const chosen = limit === void 0 ? matches : matches.slice(0, limit);
   return chosen.map((match) => ({
     name: match.name,
     rootPc: match.rootPc,
@@ -157,14 +182,14 @@ function chordScaleReport(chord, limit) {
 }
 var RANK_PENALTY = 0.01;
 function scalePitchClassSet(name, rootPc) {
-  const mask = _chunkFNDWXRRIcjs.namedScaleMask.call(void 0, name);
+  const mask = _chunkBSLTLGM3cjs.namedScaleMask.call(void 0, name);
   const pcs = /* @__PURE__ */ new Set();
   if (mask === void 0) {
     return pcs;
   }
   for (let n = 0; n < 12; n += 1) {
     if ((mask >> n & 1) === 1) {
-      pcs.add(_chunk7MGZ7D62cjs.pitchClassOf.call(void 0, rootPc + n));
+      pcs.add(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, rootPc + n));
     }
   }
   return pcs;
@@ -184,6 +209,7 @@ function symmetricDifferenceSize(a, b) {
   return count;
 }
 function scalesForChanges(chords) {
+  _chunkPI3UXRWKcjs.assertGenerationBudget.call(void 0, chords.length, "chord-scale changes");
   if (chords.length === 0) {
     return [];
   }
@@ -296,7 +322,7 @@ var CHROMATIC_SPELLING_SHARP = {
   // M7
 };
 function alterFor(letter, pc) {
-  let d = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, pc - _chunk7MGZ7D62cjs.naturalPitchClassOf.call(void 0, letter));
+  let d = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, pc - _chunkPI3UXRWKcjs.naturalPitchClassOf.call(void 0, letter));
   if (d > 6) {
     d -= 12;
   }
@@ -306,7 +332,7 @@ function letterFor(tonic, degreeOffset, pc) {
   if (degreeOffset === void 0) {
     return void 0;
   }
-  const letter = _chunk7MGZ7D62cjs.diatonicLetterOf.call(void 0, tonic.letter + degreeOffset);
+  const letter = _chunkPI3UXRWKcjs.diatonicLetterOf.call(void 0, tonic.letter + degreeOffset);
   return { letter, alter: alterFor(letter, pc) };
 }
 function pickSpelling(flat, sharp, preferFlat) {
@@ -318,31 +344,37 @@ function pickSpelling(flat, sharp, preferFlat) {
   }
   return preferFlat ? flat : sharp;
 }
+function capChromaticAccidentals(preferred, alternative) {
+  return alternative !== void 0 && Math.abs(preferred.alter) - Math.abs(alternative.alter) >= 2 ? alternative : preferred;
+}
 function isHeptatonic(key) {
-  return _chunkFNDWXRRIcjs.scaleTonesInDegreeOrder.call(void 0, key).length === 7;
+  return _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, key).length === 7;
 }
 function hasMinorThird(key) {
-  const tones = _chunkFNDWXRRIcjs.scaleTonesInDegreeOrder.call(void 0, key);
-  const root = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, key.rootPc);
-  return tones.includes(_chunk7MGZ7D62cjs.pitchClassOf.call(void 0, root + 3)) && !tones.includes(_chunk7MGZ7D62cjs.pitchClassOf.call(void 0, root + 4));
+  const tones = _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, key);
+  const root = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc);
+  return tones.includes(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, root + 3)) && !tones.includes(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, root + 4));
 }
 function spellPitchClass(pc, tonic, key) {
-  const tonicPc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, _chunk7MGZ7D62cjs.naturalPitchClassOf.call(void 0, tonic.letter) + tonic.alter);
-  const offset = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, pc - tonicPc);
+  const tonicPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, _chunkPI3UXRWKcjs.naturalPitchClassOf.call(void 0, tonic.letter) + tonic.alter);
+  const offset = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, pc - tonicPc);
   if (offset === 0) {
-    return { letter: _chunk7MGZ7D62cjs.diatonicLetterOf.call(void 0, tonic.letter), alter: tonic.alter };
+    return { letter: _chunkPI3UXRWKcjs.diatonicLetterOf.call(void 0, tonic.letter), alter: tonic.alter };
   }
   const heptatonic = isHeptatonic(key);
   if (heptatonic) {
-    const degree = _chunkFNDWXRRIcjs.scaleTonesInDegreeOrder.call(void 0, key).indexOf(_chunk7MGZ7D62cjs.pitchClassOf.call(void 0, pc));
+    const degree = _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, key).indexOf(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, pc));
     if (degree >= 0) {
-      const letter = _chunk7MGZ7D62cjs.diatonicLetterOf.call(void 0, tonic.letter + degree);
+      const letter = _chunkPI3UXRWKcjs.diatonicLetterOf.call(void 0, tonic.letter + degree);
       return { letter, alter: alterFor(letter, pc) };
     }
     const degreeOffset = CHROMATIC_SPELLING[offset];
-    if (degreeOffset !== void 0) {
-      const letter = _chunk7MGZ7D62cjs.diatonicLetterOf.call(void 0, tonic.letter + degreeOffset);
-      return { letter, alter: alterFor(letter, pc) };
+    const preferred = letterFor(tonic, degreeOffset, pc);
+    if (preferred !== void 0) {
+      const flat = letterFor(tonic, CHROMATIC_SPELLING_FLAT[offset], pc);
+      const sharp = letterFor(tonic, CHROMATIC_SPELLING_SHARP[offset], pc);
+      const alternative = _optionalChain([flat, 'optionalAccess', _4 => _4.letter]) === preferred.letter ? sharp : _optionalChain([sharp, 'optionalAccess', _5 => _5.letter]) === preferred.letter ? flat : void 0;
+      return capChromaticAccidentals(preferred, alternative);
     }
   } else {
     const flat = letterFor(tonic, CHROMATIC_SPELLING_FLAT[offset], pc);
@@ -352,11 +384,11 @@ function spellPitchClass(pc, tonic, key) {
       return best;
     }
   }
-  const belowLetter = _chunk7MGZ7D62cjs.diatonicLetterOf.call(void 0, _nullishCoalesce([0, 0, 1, 1, 2, 3, 3, 4, 4, 5, 5, 6][_chunk7MGZ7D62cjs.pitchClassOf.call(void 0, pc)], () => ( 0)));
+  const belowLetter = _chunkPI3UXRWKcjs.diatonicLetterOf.call(void 0, _nullishCoalesce([0, 0, 1, 1, 2, 3, 3, 4, 4, 5, 5, 6][_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, pc)], () => ( 0)));
   return { letter: belowLetter, alter: alterFor(belowLetter, pc) };
 }
 function spellScale(tonic, key) {
-  return _chunkFNDWXRRIcjs.scaleTonesInDegreeOrder.call(void 0, key).map((pc) => spellPitchClass(pc, tonic, key));
+  return _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, key).map((pc) => spellPitchClass(pc, tonic, key));
 }
 function spellPitchClasses(pcs, tonic, key) {
   return pcs.map((pc) => spellPitchClass(pc, tonic, key));
@@ -398,16 +430,19 @@ function chordLetterOffset(interval, chord) {
       return 6;
     default: {
       const octaves = Math.floor(Math.max(0, interval) / 12);
-      const simple = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, interval);
+      const simple = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, interval);
       const simpleOffset = _nullishCoalesce([0, 1, 1, 2, 2, 3, 4, 4, 4, 5, 6, 6][simple], () => ( 0));
       return octaves * 7 + simpleOffset;
     }
   }
 }
 function spellChordFromRoot(chord, root) {
+  if (_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, _chunkPI3UXRWKcjs.naturalPitchClassOf.call(void 0, root.letter) + root.alter) !== _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc)) {
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)("chord root spelling must match chord.rootPc");
+  }
   return chord.intervals.map((interval) => {
-    const letter = _chunk7MGZ7D62cjs.diatonicLetterOf.call(void 0, root.letter + chordLetterOffset(interval, chord));
-    const pc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.rootPc + interval);
+    const letter = _chunkPI3UXRWKcjs.diatonicLetterOf.call(void 0, root.letter + chordLetterOffset(interval, chord));
+    const pc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc + interval);
     return { letter, alter: alterFor(letter, pc) };
   });
 }
@@ -416,26 +451,27 @@ function spellChord(chord, tonic, key) {
 }
 function chordRootSpelling(chord, tonic, key) {
   const hint = chord.rootSpelling;
-  if (hint !== void 0 && _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, _chunk7MGZ7D62cjs.naturalPitchClassOf.call(void 0, hint.letter) + hint.alter) === _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.rootPc)) {
-    return { letter: _chunk7MGZ7D62cjs.diatonicLetterOf.call(void 0, hint.letter), alter: hint.alter };
+  if (hint !== void 0 && _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, _chunkPI3UXRWKcjs.naturalPitchClassOf.call(void 0, hint.letter) + hint.alter) === _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc)) {
+    return { letter: _chunkPI3UXRWKcjs.diatonicLetterOf.call(void 0, hint.letter), alter: hint.alter };
   }
   return spellPitchClass(chord.rootPc, tonic, key);
 }
 function spellPitch(pitch, tonic, key) {
   const rounded = Math.round(pitch);
-  const spelled = spellPitchClass(_chunk7MGZ7D62cjs.pitchClassOf.call(void 0, rounded), tonic, key);
-  const octave = (rounded - _chunk7MGZ7D62cjs.naturalPitchClassOf.call(void 0, spelled.letter) - spelled.alter) / 12 - 1;
+  const spelled = spellPitchClass(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, rounded), tonic, key);
+  const octave = (rounded - _chunkPI3UXRWKcjs.naturalPitchClassOf.call(void 0, spelled.letter) - spelled.alter) / 12 - 1;
   return { letter: spelled.letter, alter: spelled.alter, octave };
 }
 function noteNames(notes) {
-  return notes.map(_chunk7MGZ7D62cjs.formatNote);
+  return notes.map(_chunkPI3UXRWKcjs.formatNote);
 }
 
 // src/theory/symbol/index.ts
-var ROOT_RE = /^[A-Ga-g](?:#{1,2}|b{1,2})?/;
-var BASS_RE = /^[A-Ga-g](?:#{1,2}|b{1,2})?$/;
+var ROOT_RE = /^[A-Ga-g](?:#{1,2}|b{1,2}|x)?/;
+var BASS_RE = /^[A-Ga-g](?:#{1,2}|b{1,2}|x)?$/;
 var QUALITY_MAP = {
   "": "maj",
+  maj: "maj",
   m: "min",
   min: "min",
   "-": "min",
@@ -460,6 +496,15 @@ var QUALITY_MAP = {
   mMaj7: "minMaj7",
   mM7: "minMaj7",
   minMaj7: "minMaj7",
+  mMaj9: "minMaj9",
+  mM9: "minMaj9",
+  minMaj9: "minMaj9",
+  mMaj11: "minMaj11",
+  mM11: "minMaj11",
+  minMaj11: "minMaj11",
+  mMaj13: "minMaj13",
+  mM13: "minMaj13",
+  minMaj13: "minMaj13",
   aug7: "aug7",
   "+7": "aug7",
   "7#5": "aug7",
@@ -533,6 +578,9 @@ var CANONICAL_SUFFIX = {
   dim7: "dim7",
   m7b5: "m7b5",
   minMaj7: "mMaj7",
+  minMaj9: "mMaj9",
+  minMaj11: "mMaj11",
+  minMaj13: "mMaj13",
   aug7: "aug7",
   augMaj7: "augMaj7",
   majb5: "maj(b5)",
@@ -568,10 +616,10 @@ function knownQuality(suffix) {
   return Object.hasOwn(QUALITY_MAP, suffix) ? QUALITY_MAP[suffix] : void 0;
 }
 function makeSpelledChord(root, quality, bass) {
-  const chord = _chunkFNDWXRRIcjs.makeChord.call(void 0, 
-    _chunk7MGZ7D62cjs.noteToPitchClass.call(void 0, root),
+  const chord = _chunkBSLTLGM3cjs.makeChord.call(void 0, 
+    _chunkPI3UXRWKcjs.noteToPitchClass.call(void 0, root),
     quality,
-    bass === void 0 ? void 0 : _chunk7MGZ7D62cjs.noteToPitchClass.call(void 0, bass)
+    bass === void 0 ? void 0 : _chunkPI3UXRWKcjs.noteToPitchClass.call(void 0, bass)
   );
   chord.rootSpelling = { letter: root.letter, alter: root.alter };
   if (bass !== void 0) {
@@ -580,13 +628,13 @@ function makeSpelledChord(root, quality, bass) {
   return chord;
 }
 function parseChordSymbol(text) {
-  const trimmed = text.trim();
+  const trimmed = text.trim().replaceAll("\u266F", "#").replaceAll("\u266D", "b").replaceAll("\u{1D12A}", "x").replaceAll("\u{1D12B}", "bb");
   const rootMatch = ROOT_RE.exec(trimmed);
   if (!rootMatch) {
-    throw new (0, _chunk7MGZ7D62cjs.InvalidInputError)(`Invalid chord symbol: ${text}`);
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(`Invalid chord symbol: ${text}`);
   }
   const rootToken = rootMatch[0];
-  const rootNote = _chunk7MGZ7D62cjs.parseNote.call(void 0, rootToken);
+  const rootNote = _chunkPI3UXRWKcjs.parseNote.call(void 0, rootToken);
   const rest = trimmed.slice(rootToken.length);
   const slashIndex = rest.lastIndexOf("/");
   if (slashIndex !== -1) {
@@ -594,46 +642,55 @@ function parseChordSymbol(text) {
     const after = rest.slice(slashIndex + 1);
     const beforeQuality = knownQuality(before);
     if (beforeQuality !== void 0 && BASS_RE.test(after)) {
-      return makeSpelledChord(rootNote, beforeQuality, _chunk7MGZ7D62cjs.parseNote.call(void 0, after));
+      return makeSpelledChord(rootNote, beforeQuality, _chunkPI3UXRWKcjs.parseNote.call(void 0, after));
     }
   }
   const quality = knownQuality(rest);
   if (quality === void 0) {
-    throw new (0, _chunk7MGZ7D62cjs.InvalidInputError)(`Unrecognized chord quality: ${text}`);
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(`Unrecognized chord quality: ${text}`);
   }
   return makeSpelledChord(rootNote, quality);
 }
 function pitchClassName(pc, hint, flats, inheritFlats) {
-  if (flats === void 0 && hint !== void 0 && _chunk7MGZ7D62cjs.noteToPitchClass.call(void 0, hint) === pc) {
-    return _chunk7MGZ7D62cjs.formatNote.call(void 0, hint);
+  if (flats === void 0 && hint !== void 0 && _chunkPI3UXRWKcjs.noteToPitchClass.call(void 0, hint) === pc) {
+    return _chunkPI3UXRWKcjs.formatNote.call(void 0, hint);
   }
-  const note = _chunk7MGZ7D62cjs.midiToNote.call(void 0, 60 + pc, _nullishCoalesce(flats, () => ( inheritFlats)) ? "flat" : "sharp");
-  return _chunk7MGZ7D62cjs.formatNote.call(void 0, { letter: note.letter, alter: note.alter });
+  const note = _chunkPI3UXRWKcjs.midiToNote.call(void 0, 60 + pc, _nullishCoalesce(flats, () => ( inheritFlats)) ? "flat" : "sharp");
+  return _chunkPI3UXRWKcjs.formatNote.call(void 0, { letter: note.letter, alter: note.alter });
 }
 function formatChordSymbol(chord, opts) {
-  _chunk7MGZ7D62cjs.assertFiniteNumber.call(void 0, chord.rootPc, "chord rootPc");
+  _chunkPI3UXRWKcjs.assertFiniteNumber.call(void 0, chord.rootPc, "chord rootPc");
   if (chord.bassPc !== void 0) {
-    _chunk7MGZ7D62cjs.assertFiniteNumber.call(void 0, chord.bassPc, "chord bassPc");
+    _chunkPI3UXRWKcjs.assertFiniteNumber.call(void 0, chord.bassPc, "chord bassPc");
   }
   if (!Object.hasOwn(CANONICAL_SUFFIX, chord.quality)) {
-    throw new (0, _chunk7MGZ7D62cjs.InvalidInputError)(`Unknown chord quality: ${String(chord.quality)}`);
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(`Unknown chord quality: ${String(chord.quality)}`);
   }
-  const rootPc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.rootPc);
+  const rootPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc);
   const rootHint = chord.rootSpelling;
-  const rootName = pitchClassName(rootPc, rootHint, _optionalChain([opts, 'optionalAccess', _4 => _4.flats]));
+  const rootName = pitchClassName(rootPc, rootHint, _optionalChain([opts, 'optionalAccess', _6 => _6.flats]));
   const suffix = CANONICAL_SUFFIX[chord.quality];
   let symbol = `${rootName}${suffix}`;
-  if (chord.bassPc !== void 0 && _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.bassPc) !== rootPc) {
-    const inheritFlats = rootHint !== void 0 && _chunk7MGZ7D62cjs.noteToPitchClass.call(void 0, rootHint) === rootPc ? rootHint.alter < 0 : void 0;
-    symbol += `/${pitchClassName(_chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.bassPc), chord.bassSpelling, _optionalChain([opts, 'optionalAccess', _5 => _5.flats]), inheritFlats)}`;
+  if (chord.bassPc !== void 0 && _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.bassPc) !== rootPc) {
+    const inheritFlats = rootHint !== void 0 && _chunkPI3UXRWKcjs.noteToPitchClass.call(void 0, rootHint) === rootPc ? rootHint.alter < 0 : void 0;
+    symbol += `/${pitchClassName(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.bassPc), chord.bassSpelling, _optionalChain([opts, 'optionalAccess', _7 => _7.flats]), inheritFlats)}`;
   }
   return symbol;
 }
 function transposeChordSymbol(text, semitones, opts) {
+  _chunkPI3UXRWKcjs.assertFiniteSemitones.call(void 0, semitones);
   const chord = parseChordSymbol(text);
-  const transposed = { ...chord, rootPc: _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.rootPc + semitones) };
+  const transposed = { ...chord, rootPc: _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc + semitones) };
+  if (chord.rootSpelling !== void 0) {
+    const hint = _chunkPI3UXRWKcjs.transposeNote.call(void 0, chord.rootSpelling, semitones);
+    transposed.rootSpelling = { letter: hint.letter, alter: hint.alter };
+  }
   if (chord.bassPc !== void 0) {
-    transposed.bassPc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.bassPc + semitones);
+    transposed.bassPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.bassPc + semitones);
+  }
+  if (chord.bassSpelling !== void 0) {
+    const hint = _chunkPI3UXRWKcjs.transposeNote.call(void 0, chord.bassSpelling, semitones);
+    transposed.bassSpelling = { letter: hint.letter, alter: hint.alter };
   }
   return formatChordSymbol(transposed, opts);
 }
@@ -644,14 +701,15 @@ var VIOLATION_PENALTY = 1e3;
 var MISSING_TONE_PENALTY = 500;
 var MISSING_FIFTH_PENALTY = 20;
 var POOR_DOUBLING_PENALTY = 4;
+var UNISON_PENALTY = 100;
 var LEADING_TONE_DOUBLING_PENALTY = 200;
-var RESOLUTION_PENALTY = 40;
-var MAX_CANDIDATES = 4e3;
-var MAX_SEARCH_NODES = MAX_CANDIDATES * 16;
+var RESOLUTION_PENALTY = 200;
+var DEFAULT_MAX_CANDIDATES = 4e3;
+var SEARCH_NODES_PER_CANDIDATE = 16;
 function pitchesForPc(pc, range) {
   const result = [];
   for (let midi = Math.ceil(range.min); midi <= range.max; midi += 1) {
-    if (_chunk7MGZ7D62cjs.pitchClassOf.call(void 0, midi) === pc) {
+    if (_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, midi) === pc) {
       result.push(midi);
     }
   }
@@ -662,23 +720,24 @@ function pitchesForPc(pc, range) {
     return da === db ? a - b : da - db;
   });
 }
-function enumerateVoicings(chord, ranges, maxSpacing) {
-  const chordPcs = _chunkFNDWXRRIcjs.chordPitchClasses.call(void 0, chord);
-  const bassPc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, _nullishCoalesce(chord.bassPc, () => ( chord.rootPc)));
+function enumerateVoicings(chord, ranges, maxSpacing, maxCandidates = DEFAULT_MAX_CANDIDATES) {
+  const chordPcs = _chunkBSLTLGM3cjs.chordPitchClasses.call(void 0, chord);
+  const bassPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, _nullishCoalesce(chord.bassPc, () => ( chord.rootPc)));
   const byVoice = ranges.map(
     (range, voice) => (voice === 0 ? [bassPc] : chordPcs).flatMap((pc) => pitchesForPc(pc, range))
   );
   for (let voice = 0; voice < byVoice.length; voice += 1) {
     if ((_nullishCoalesce(byVoice[voice], () => ( []))).length === 0) {
-      throw new (0, _chunk7MGZ7D62cjs.NoSolutionError)("no voicing satisfies the given ranges");
+      throw new (0, _chunkPI3UXRWKcjs.NoSolutionError)("no voicing satisfies the given ranges");
     }
   }
   const results = [];
   const current = [];
   let nodes = 0;
+  const maxSearchNodes = maxCandidates * SEARCH_NODES_PER_CANDIDATE;
   const build = (voice) => {
     nodes += 1;
-    if (results.length >= MAX_CANDIDATES || nodes > MAX_SEARCH_NODES) {
+    if (results.length >= maxCandidates || nodes > maxSearchNodes) {
       return;
     }
     if (voice === ranges.length) {
@@ -707,17 +766,22 @@ function enumerateVoicings(chord, ranges, maxSpacing) {
 function structuralPenalty(pitches, chord, key) {
   const counts = /* @__PURE__ */ new Map();
   for (const pitch of pitches) {
-    const pc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, pitch);
+    const pc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, pitch);
     counts.set(pc, (_nullishCoalesce(counts.get(pc), () => ( 0))) + 1);
   }
   let penalty = 0;
-  for (const pc of _chunkFNDWXRRIcjs.chordPitchClasses.call(void 0, chord)) {
+  for (let index = 1; index < pitches.length; index += 1) {
+    if (pitches[index] === pitches[index - 1]) {
+      penalty += UNISON_PENALTY;
+    }
+  }
+  for (const pc of _chunkBSLTLGM3cjs.chordPitchClasses.call(void 0, chord)) {
     if (!counts.has(pc)) {
-      penalty += _chunkFNDWXRRIcjs.chordToneRole.call(void 0, pc, chord) === "fifth" ? MISSING_FIFTH_PENALTY : MISSING_TONE_PENALTY;
+      penalty += _chunkBSLTLGM3cjs.chordToneRole.call(void 0, pc, chord) === "fifth" ? MISSING_FIFTH_PENALTY : MISSING_TONE_PENALTY;
     }
   }
-  const rootPc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.rootPc);
-  const leadingTonePc = key === void 0 ? void 0 : _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, key.rootPc - 1);
+  const rootPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc);
+  const leadingTonePc = key === void 0 ? void 0 : _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc - 1);
   for (const [pc, count] of counts) {
     if (count <= 1) {
       continue;
@@ -726,7 +790,7 @@ function structuralPenalty(pitches, chord, key) {
       penalty += (count - 1) * LEADING_TONE_DOUBLING_PENALTY;
       continue;
     }
-    if (pc !== rootPc && _chunkFNDWXRRIcjs.chordToneRole.call(void 0, pc, chord) !== "fifth") {
+    if (pc !== rootPc && _chunkBSLTLGM3cjs.chordToneRole.call(void 0, pc, chord) !== "fifth") {
       penalty += (count - 1) * POOR_DOUBLING_PENALTY;
     }
   }
@@ -734,8 +798,8 @@ function structuralPenalty(pitches, chord, key) {
 }
 function seventhPcOf(chord) {
   for (const interval of chord.intervals) {
-    const pc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.rootPc + interval);
-    if (_chunkFNDWXRRIcjs.chordToneRole.call(void 0, pc, chord) === "seventh") {
+    const pc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc + interval);
+    if (_chunkBSLTLGM3cjs.chordToneRole.call(void 0, pc, chord) === "seventh") {
       return pc;
     }
   }
@@ -743,9 +807,9 @@ function seventhPcOf(chord) {
 }
 function resolutionViolations(prev, cur, prevChord, nextChord, key) {
   const seventhPc = seventhPcOf(prevChord);
-  const leadingTonePc = key === void 0 ? void 0 : _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, key.rootPc - 1);
-  const tonicPc = key === void 0 ? void 0 : _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, key.rootPc);
-  const nextPcs = new Set(_chunkFNDWXRRIcjs.chordPitchClasses.call(void 0, nextChord));
+  const leadingTonePc = key === void 0 ? void 0 : _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc - 1);
+  const tonicPc = key === void 0 ? void 0 : _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc);
+  const nextPcs = new Set(_chunkBSLTLGM3cjs.chordPitchClasses.call(void 0, nextChord));
   let count = 0;
   for (let voice = 0; voice < prev.length && voice < cur.length; voice += 1) {
     const from = prev[voice];
@@ -753,7 +817,7 @@ function resolutionViolations(prev, cur, prevChord, nextChord, key) {
     if (from === void 0 || to === void 0) {
       continue;
     }
-    const fromPc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, from);
+    const fromPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, from);
     const motion = to - from;
     if (fromPc === seventhPc && !nextPcs.has(fromPc) && motion !== -1 && motion !== -2) {
       count += 1;
@@ -775,11 +839,11 @@ function violationCount(prev, cur) {
       if (prevLower === void 0 || prevUpper === void 0 || curLower === void 0 || curUpper === void 0) {
         continue;
       }
-      if (_chunkFNDWXRRIcjs.createsParallelPerfect.call(void 0, prevUpper, curUpper, prevLower, curLower)) {
+      if (_chunkBSLTLGM3cjs.createsParallelPerfect.call(void 0, prevUpper, curUpper, prevLower, curLower)) {
         count += 1;
       }
       if (upper === lower + 1) {
-        if (_chunkFNDWXRRIcjs.createsVoiceOverlap.call(void 0, prevUpper, curUpper, prevLower, curLower)) {
+        if (_chunkBSLTLGM3cjs.createsVoiceOverlap.call(void 0, prevUpper, curUpper, prevLower, curLower)) {
           count += 1;
         }
       }
@@ -808,39 +872,52 @@ function voiceLeadingCost(from, to) {
     const bassCur = to[0];
     const sopPrev = from[from.length - 1];
     const sopCur = to[to.length - 1];
-    if (bassPrev !== void 0 && bassCur !== void 0 && sopPrev !== void 0 && sopCur !== void 0 && _chunkFNDWXRRIcjs.createsHiddenParallelPerfect.call(void 0, bassPrev, bassCur, sopPrev, sopCur)) {
+    if (bassPrev !== void 0 && bassCur !== void 0 && sopPrev !== void 0 && sopCur !== void 0 && _chunkBSLTLGM3cjs.createsHiddenParallelPerfect.call(void 0, bassPrev, bassCur, sopPrev, sopCur)) {
       total += HIDDEN_PERFECT_PENALTY;
     }
   }
   return total;
 }
 function nextVoicing(current, chord, opts) {
-  const derived = _optionalChain([opts, 'optionalAccess', _6 => _6.ranges]) === void 0 && _optionalChain([opts, 'optionalAccess', _7 => _7.voices]) === void 0;
+  const derived = _optionalChain([opts, 'optionalAccess', _8 => _8.ranges]) === void 0 && _optionalChain([opts, 'optionalAccess', _9 => _9.voices]) === void 0;
   if (derived) {
     if (current.length === 0) {
-      throw new (0, _chunk7MGZ7D62cjs.InvalidInputError)("current must contain at least one pitch");
+      throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)("current must contain at least one pitch");
     }
     for (let index = 0; index < current.length; index += 1) {
-      _chunk7MGZ7D62cjs.assertFiniteNumber.call(void 0, _nullishCoalesce(current[index], () => ( Number.NaN)), `current[${index}]`);
+      _chunkPI3UXRWKcjs.assertFiniteNumber.call(void 0, _nullishCoalesce(current[index], () => ( Number.NaN)), `current[${index}]`);
     }
   }
   const ranges = derived ? current.map((pitch) => {
     const centre = Math.min(127, Math.max(0, pitch));
     return { min: Math.max(0, centre - 12), max: Math.min(127, centre + 12) };
   }) : resolveRanges(opts);
+  for (let index = 0; index < current.length; index += 1) {
+    _chunkPI3UXRWKcjs.assertFiniteNumber.call(void 0, _nullishCoalesce(current[index], () => ( Number.NaN)), `current[${index}]`);
+  }
+  if (current.length < ranges.length) {
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(
+      `current has ${current.length} voices but the requested ranges require ${ranges.length}`
+    );
+  }
+  const source = current.length === ranges.length ? current : ranges.length === 1 ? [_nullishCoalesce(current[0], () => ( Number.NaN))] : ranges.map((_, index) => {
+    const sourceIndex = Math.round(index * (current.length - 1) / (ranges.length - 1));
+    return _nullishCoalesce(current[sourceIndex], () => ( Number.NaN));
+  });
   const maxSpacing = resolveMaxSpacing(opts);
-  const candidates = enumerateVoicings(chord, ranges, maxSpacing);
+  const candidates = enumerateVoicings(chord, ranges, maxSpacing, resolveMaxCandidates(opts));
+  const previousChord = _optionalChain([opts, 'optionalAccess', _10 => _10.previousChord]);
   let best;
   let bestScore = Number.POSITIVE_INFINITY;
   for (const candidate of candidates) {
-    const score = structuralPenalty(candidate, chord, _optionalChain([opts, 'optionalAccess', _8 => _8.key])) + voiceLeadingCost(current, candidate) + VIOLATION_PENALTY * violationCount(current, candidate);
+    const score = structuralPenalty(candidate, chord, _optionalChain([opts, 'optionalAccess', _11 => _11.key])) + voiceLeadingCost(source, candidate) + VIOLATION_PENALTY * violationCount(source, candidate) + RESOLUTION_PENALTY * (previousChord === void 0 ? 0 : resolutionViolations(source, candidate, previousChord, chord, _optionalChain([opts, 'optionalAccess', _12 => _12.key])));
     if (score < bestScore) {
       bestScore = score;
       best = candidate;
     }
   }
   if (best === void 0) {
-    throw new (0, _chunk7MGZ7D62cjs.NoSolutionError)("no voicing satisfies the given ranges");
+    throw new (0, _chunkPI3UXRWKcjs.NoSolutionError)("no voicing satisfies the given ranges");
   }
   return best;
 }
@@ -856,18 +933,18 @@ var DERIVED_LOW = 40;
 var DERIVED_HIGH = 79;
 var DERIVED_SPAN = 19;
 function resolveRanges(opts) {
-  if (_optionalChain([opts, 'optionalAccess', _9 => _9.ranges]) !== void 0) {
+  if (_optionalChain([opts, 'optionalAccess', _13 => _13.ranges]) !== void 0) {
     if (opts.ranges.length === 0) {
-      throw new (0, _chunk7MGZ7D62cjs.InvalidInputError)("ranges must contain at least one voice range");
+      throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)("ranges must contain at least one voice range");
     }
-    _chunk7MGZ7D62cjs.assertGenerationBudget.call(void 0, opts.ranges.length, "voice ranges", 128);
+    _chunkPI3UXRWKcjs.assertGenerationBudget.call(void 0, opts.ranges.length, "voice ranges", 128);
     return opts.ranges.map((range, index) => {
-      _chunk7MGZ7D62cjs.assertFiniteNumber.call(void 0, range.min, `ranges[${index}].min`);
-      _chunk7MGZ7D62cjs.assertFiniteNumber.call(void 0, range.max, `ranges[${index}].max`);
+      _chunkPI3UXRWKcjs.assertFiniteNumber.call(void 0, range.min, `ranges[${index}].min`);
+      _chunkPI3UXRWKcjs.assertFiniteNumber.call(void 0, range.max, `ranges[${index}].max`);
       if (range.min > range.max) {
-        throw new (0, _chunk7MGZ7D62cjs.InvalidInputError)(`ranges[${index}].min must not exceed max`);
+        throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(`ranges[${index}].min must not exceed max`);
       }
-      _chunk7MGZ7D62cjs.assertGenerationBudget.call(void 0, 
+      _chunkPI3UXRWKcjs.assertGenerationBudget.call(void 0, 
         Math.floor(range.max) - Math.ceil(range.min) + 1,
         `ranges[${index}] span`,
         4096
@@ -875,8 +952,8 @@ function resolveRanges(opts) {
       return { ...range };
     });
   }
-  const voices = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _10 => _10.voices]), () => ( 4));
-  _chunk7MGZ7D62cjs.assertPositiveInt.call(void 0, voices, "voices", 128);
+  const voices = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _14 => _14.voices]), () => ( 4));
+  _chunkPI3UXRWKcjs.assertPositiveInt.call(void 0, voices, "voices", 128);
   if (voices === 4) {
     return SATB_RANGES.map((range) => ({ ...range }));
   }
@@ -893,21 +970,26 @@ function resolveRanges(opts) {
   return ranges;
 }
 function resolveMaxSpacing(opts) {
-  const maxSpacing = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _11 => _11.maxSpacing]), () => ( DEFAULT_MAX_SPACING));
-  _chunk7MGZ7D62cjs.assertFiniteNumber.call(void 0, maxSpacing, "maxSpacing");
+  const maxSpacing = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _15 => _15.maxSpacing]), () => ( DEFAULT_MAX_SPACING));
+  _chunkPI3UXRWKcjs.assertFiniteNumber.call(void 0, maxSpacing, "maxSpacing");
   if (maxSpacing < 0) {
-    throw new (0, _chunk7MGZ7D62cjs.InvalidInputError)("maxSpacing must be non-negative");
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)("maxSpacing must be non-negative");
   }
   return maxSpacing;
 }
+function resolveMaxCandidates(opts) {
+  if (_optionalChain([opts, 'optionalAccess', _16 => _16.maxCandidates]) === void 0) return void 0;
+  _chunkPI3UXRWKcjs.assertPositiveInt.call(void 0, opts.maxCandidates, "maxCandidates", 1e6);
+  return opts.maxCandidates;
+}
 function voiceChord(chord, opts) {
   const ranges = resolveRanges(opts);
   const maxSpacing = resolveMaxSpacing(opts);
-  const candidates = enumerateVoicings(chord, ranges, maxSpacing);
+  const candidates = enumerateVoicings(chord, ranges, maxSpacing, resolveMaxCandidates(opts));
   let best;
   let bestScore = Number.POSITIVE_INFINITY;
   for (const candidate of candidates) {
-    let score = structuralPenalty(candidate, chord, _optionalChain([opts, 'optionalAccess', _12 => _12.key]));
+    let score = structuralPenalty(candidate, chord, _optionalChain([opts, 'optionalAccess', _17 => _17.key]));
     for (let i = 0; i < candidate.length; i += 1) {
       const pitch = candidate[i];
       const range = ranges[i];
@@ -922,14 +1004,14 @@ function voiceChord(chord, opts) {
     }
   }
   if (best === void 0) {
-    throw new (0, _chunk7MGZ7D62cjs.NoSolutionError)(
+    throw new (0, _chunkPI3UXRWKcjs.NoSolutionError)(
       `no voicing satisfies the given ranges for ${formatChordSymbol(chord)}`
     );
   }
   return best;
 }
 function noSolutionAt(index, chord) {
-  return new (0, _chunk7MGZ7D62cjs.NoSolutionError)(
+  return new (0, _chunkPI3UXRWKcjs.NoSolutionError)(
     `no voicing satisfies the given ranges for ${formatChordSymbol(chord)} at index ${index}`,
     { at: index }
   );
@@ -938,16 +1020,17 @@ function locate(index, chord, work) {
   try {
     return work();
   } catch (error) {
-    if (error instanceof _chunk7MGZ7D62cjs.NoSolutionError) {
+    if (error instanceof _chunkPI3UXRWKcjs.NoSolutionError) {
       throw noSolutionAt(index, chord);
     }
     throw error;
   }
 }
 function voiceProgression(chords, opts) {
-  _chunk7MGZ7D62cjs.assertGenerationBudget.call(void 0, chords.length, "voiced progression chords", _optionalChain([opts, 'optionalAccess', _13 => _13.budget]));
+  _chunkPI3UXRWKcjs.assertGenerationBudget.call(void 0, chords.length, "voiced progression chords", _optionalChain([opts, 'optionalAccess', _18 => _18.budget]));
   const ranges = resolveRanges(opts);
   const maxSpacing = resolveMaxSpacing(opts);
+  const maxCandidates = resolveMaxCandidates(opts);
   const result = [];
   let prev;
   let prevChord;
@@ -962,12 +1045,16 @@ function voiceProgression(chords, opts) {
       result.push(prev);
       continue;
     }
-    const candidates = locate(index, chord, () => enumerateVoicings(chord, ranges, maxSpacing));
+    const candidates = locate(
+      index,
+      chord,
+      () => enumerateVoicings(chord, ranges, maxSpacing, maxCandidates)
+    );
     let best;
     let bestScore = Number.POSITIVE_INFINITY;
     for (const candidate of candidates) {
-      const unresolved = prevChord === void 0 ? 0 : resolutionViolations(prev, candidate, prevChord, chord, _optionalChain([opts, 'optionalAccess', _14 => _14.key]));
-      const score = structuralPenalty(candidate, chord, _optionalChain([opts, 'optionalAccess', _15 => _15.key])) + voiceLeadingCost(prev, candidate) + VIOLATION_PENALTY * violationCount(prev, candidate) + RESOLUTION_PENALTY * unresolved;
+      const unresolved = prevChord === void 0 ? 0 : resolutionViolations(prev, candidate, prevChord, chord, _optionalChain([opts, 'optionalAccess', _19 => _19.key]));
+      const score = structuralPenalty(candidate, chord, _optionalChain([opts, 'optionalAccess', _20 => _20.key])) + voiceLeadingCost(prev, candidate) + VIOLATION_PENALTY * violationCount(prev, candidate) + RESOLUTION_PENALTY * unresolved;
       if (score < bestScore) {
         bestScore = score;
         best = candidate;
@@ -997,7 +1084,7 @@ function dedupePcs(pcs) {
   return result;
 }
 function lowestPitchAtOrAbove(pc, floor) {
-  return floor + ((pc - _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, floor)) % 12 + 12) % 12;
+  return floor + ((pc - _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, floor)) % 12 + 12) % 12;
 }
 function nearestPc(target, pcs) {
   let best = _nullishCoalesce(pcs[0], () => ( target));
@@ -1012,17 +1099,17 @@ function nearestPc(target, pcs) {
   return best;
 }
 function voiceChordStyled(chord, opts) {
-  const style = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _16 => _16.style]), () => ( "close"));
-  const octave = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _17 => _17.octave]), () => ( DEFAULT_STYLE_OCTAVE));
-  _chunk7MGZ7D62cjs.assertInteger.call(void 0, octave, "styled voicing octave", -10, 10);
-  if (_optionalChain([opts, 'optionalAccess', _18 => _18.topNote]) !== void 0) {
-    _chunk7MGZ7D62cjs.assertFiniteNumber.call(void 0, opts.topNote, "styled voicing topNote");
+  const style = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _21 => _21.style]), () => ( "close"));
+  const octave = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _22 => _22.octave]), () => ( DEFAULT_STYLE_OCTAVE));
+  _chunkPI3UXRWKcjs.assertInteger.call(void 0, octave, "styled voicing octave", -10, 10);
+  if (_optionalChain([opts, 'optionalAccess', _23 => _23.topNote]) !== void 0) {
+    _chunkPI3UXRWKcjs.assertFiniteNumber.call(void 0, opts.topNote, "styled voicing topNote");
   }
   const base = 12 * (octave + 1);
-  const rootPc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.rootPc);
-  const bassPc = _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, _nullishCoalesce(chord.bassPc, () => ( chord.rootPc)));
-  const omitRoot = style === "rootless" || _optionalChain([opts, 'optionalAccess', _19 => _19.rootless]) === true;
-  let order = dedupePcs(chord.intervals.map((interval) => _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, chord.rootPc + interval)));
+  const rootPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc);
+  const bassPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, _nullishCoalesce(chord.bassPc, () => ( chord.rootPc)));
+  const omitRoot = style === "rootless" || _optionalChain([opts, 'optionalAccess', _24 => _24.rootless]) === true;
+  let order = dedupePcs(chord.intervals.map((interval) => _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc + interval)));
   const bassIndex = order.indexOf(bassPc);
   if (bassIndex > 0) {
     order = [...order.slice(bassIndex), ...order.slice(0, bassIndex)];
@@ -1030,7 +1117,7 @@ function voiceChordStyled(chord, opts) {
     order = [bassPc, ...order];
   }
   if (style === "shell") {
-    const roles = order.map((pc) => _chunkFNDWXRRIcjs.chordToneRole.call(void 0, pc, chord));
+    const roles = order.map((pc) => _chunkBSLTLGM3cjs.chordToneRole.call(void 0, pc, chord));
     const guide = roles.includes("seventh") ? "seventh" : roles.includes("sixth") ? "sixth" : "fifth";
     order = order.filter((_pc, i) => {
       const role = roles[i];
@@ -1043,8 +1130,8 @@ function voiceChordStyled(chord, opts) {
   if (order.length === 0) {
     return [];
   }
-  if (_optionalChain([opts, 'optionalAccess', _20 => _20.topNote]) !== void 0) {
-    const target = order.includes(_chunk7MGZ7D62cjs.pitchClassOf.call(void 0, opts.topNote)) ? _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, opts.topNote) : nearestPc(_chunk7MGZ7D62cjs.pitchClassOf.call(void 0, opts.topNote), order);
+  if (_optionalChain([opts, 'optionalAccess', _25 => _25.topNote]) !== void 0) {
+    const target = order.includes(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, opts.topNote)) ? _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, opts.topNote) : nearestPc(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, opts.topNote), order);
     const targetIndex = order.indexOf(target);
     order = [...order.slice(targetIndex + 1), ...order.slice(0, targetIndex + 1)];
   }
@@ -1054,7 +1141,7 @@ function voiceChordStyled(chord, opts) {
     if (prev === void 0) {
       prev = lowestPitchAtOrAbove(pc, base);
     } else {
-      let delta = ((pc - _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, prev)) % 12 + 12) % 12;
+      let delta = ((pc - _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, prev)) % 12 + 12) % 12;
       if (delta === 0) {
         delta = 12;
       }
@@ -1068,7 +1155,7 @@ function voiceChordStyled(chord, opts) {
     stack[stack.length - 3] = (_nullishCoalesce(stack[stack.length - 3], () => ( 0))) - 12;
   }
   if (chord.bassPc !== void 0) {
-    const bassIndexInStack = stack.findIndex((pitch) => _chunk7MGZ7D62cjs.pitchClassOf.call(void 0, pitch) === bassPc);
+    const bassIndexInStack = stack.findIndex((pitch) => _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, pitch) === bassPc);
     if (bassIndexInStack >= 0) {
       const otherLowest = Math.min(
         ...stack.filter((_pitch, index) => index !== bassIndexInStack),
@@ -1083,7 +1170,7 @@ function voiceChordStyled(chord, opts) {
   const lowest = _nullishCoalesce(voicing[0], () => ( 0));
   const highest = _nullishCoalesce(voicing[voicing.length - 1], () => ( 0));
   if (lowest < 0 || highest > 127) {
-    throw new (0, _chunk7MGZ7D62cjs.InvalidInputError)(
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(
       `styled voicing at octave ${octave} spans MIDI ${lowest}..${highest}, outside 0..127`
     );
   }
@@ -1114,4 +1201,4 @@ function voiceChordStyled(chord, opts) {
 
 
 exports.scaleMatchesChord = scaleMatchesChord; exports.chordScales = chordScales; exports.avoidNotes = avoidNotes; exports.availableTensions = availableTensions; exports.chordScaleReport = chordScaleReport; exports.scalesForChanges = scalesForChanges; exports.spellPitchClass = spellPitchClass; exports.spellScale = spellScale; exports.spellPitchClasses = spellPitchClasses; exports.spellChordFromRoot = spellChordFromRoot; exports.spellChord = spellChord; exports.spellPitch = spellPitch; exports.noteNames = noteNames; exports.parseChordSymbol = parseChordSymbol; exports.formatChordSymbol = formatChordSymbol; exports.transposeChordSymbol = transposeChordSymbol; exports.SATB_RANGES = SATB_RANGES; exports.voiceChord = voiceChord; exports.voiceProgression = voiceProgression; exports.voiceLeadingCost = voiceLeadingCost; exports.nextVoicing = nextVoicing; exports.voiceChordStyled = voiceChordStyled;
-//# sourceMappingURL=chunk-LW53AHQU.cjs.map
+//# sourceMappingURL=chunk-OL3IHHSJ.cjs.map