@libraz/libcantus 1.2.0 → 1.4.0

package/dist/{chunk-DSMJRXCZ.cjs → chunk-HYSVSFNI.cjs}

@@ -14,9 +14,9 @@
 
 
 
-var _chunkHPVSH7SFcjs = require('./chunk-HPVSH7SF.cjs');
 
 
+var _chunk3MDOEFIQcjs = require('./chunk-3MDOEFIQ.cjs');
 
 
 
@@ -38,9 +38,9 @@ var _chunkHPVSH7SFcjs = require('./chunk-HPVSH7SF.cjs');
 
 
 
-var _chunkNM7UAMC3cjs = require('./chunk-NM7UAMC3.cjs');
 
 
+var _chunk3FDBMIPRcjs = require('./chunk-3FDBMIPR.cjs');
 
 
 
@@ -69,13 +69,13 @@ var _chunkNM7UAMC3cjs = require('./chunk-NM7UAMC3.cjs');
 
 
 
-var _chunkJ7FHVZIIcjs = require('./chunk-J7FHVZII.cjs');
 
 
 
 
 
 
+var _chunk6TTBEON3cjs = require('./chunk-6TTBEON3.cjs');
 
 
 
@@ -97,7 +97,6 @@ var _chunkJ7FHVZIIcjs = require('./chunk-J7FHVZII.cjs');
 
 
 
-var _chunkSGLEQVJHcjs = require('./chunk-SGLEQVJH.cjs');
 
 
 
@@ -110,12 +109,11 @@ var _chunkSGLEQVJHcjs = require('./chunk-SGLEQVJH.cjs');
 
 
 
-var _chunkCGBADIO5cjs = require('./chunk-CGBADIO5.cjs');
 
 
-var _chunk35NBV2FTcjs = require('./chunk-35NBV2FT.cjs');
 
 
+var _chunkLQZQDBCDcjs = require('./chunk-LQZQDBCD.cjs');
 
 
 
@@ -128,14 +126,14 @@ var _chunk35NBV2FTcjs = require('./chunk-35NBV2FT.cjs');
 
 
 
-var _chunk76ZBTRG2cjs = require('./chunk-76ZBTRG2.cjs');
+var _chunkWOMCXN2Wcjs = require('./chunk-WOMCXN2W.cjs');
 
 
+var _chunkKMYGRFZ6cjs = require('./chunk-KMYGRFZ6.cjs');
 
 
 
 
-var _chunkPM4XJE2Ycjs = require('./chunk-PM4XJE2Y.cjs');
 
 
 
@@ -146,12 +144,14 @@ var _chunkPM4XJE2Ycjs = require('./chunk-PM4XJE2Y.cjs');
 
 
 
+var _chunkU4EQTDGNcjs = require('./chunk-U4EQTDGN.cjs');
 
 
 
 
 
 
+var _chunkP3CPXAJ5cjs = require('./chunk-P3CPXAJ5.cjs');
 
 
 
@@ -191,7 +191,6 @@ var _chunkPM4XJE2Ycjs = require('./chunk-PM4XJE2Y.cjs');
 
 
 
-var _chunk3R3QVKY5cjs = require('./chunk-3R3QVKY5.cjs');
 
 
 
@@ -209,6 +208,7 @@ var _chunk3R3QVKY5cjs = require('./chunk-3R3QVKY5.cjs');
 
 
 
+var _chunkYDGMWH43cjs = require('./chunk-YDGMWH43.cjs');
 
 
 
@@ -235,7 +235,26 @@ var _chunk3R3QVKY5cjs = require('./chunk-3R3QVKY5.cjs');
 
 
 
-var _chunkS5BKZZGMcjs = require('./chunk-S5BKZZGM.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkS3QELJUEcjs = require('./chunk-S3QELJUE.cjs');
 
 // src/model/interval.ts
 var INVERSION_SUM = 9;
@@ -244,6 +263,14 @@ function simpleDegree(numberValue) {
   const reduced = (numberValue - 1) % 7 + 1;
   return reduced === 1 && numberValue > 1 ? OCTAVE_DEGREES : reduced;
 }
+function checkedDirection(descending) {
+  if (typeof descending !== "boolean") {
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+      `interval.descending must be a boolean; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, descending)}`
+    );
+  }
+  return descending;
+}
 function invertQuality(quality) {
   if (quality === "P") {
     return "P";
@@ -275,6 +302,12 @@ var Interval = class _Interval {
    * @returns The interval from `a` to `b`.
    */
   static between(a, b) {
+    if (typeof a !== "object" || a === null || typeof a.intervalTo !== "function") {
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(`interval a must be a Note; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, a)}`);
+    }
+    if (typeof b !== "object" || b === null || typeof b.data !== "object" || b.data === null) {
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(`interval b must be a Note; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, b)}`);
+    }
     return a.intervalTo(b);
   }
   /**
@@ -304,8 +337,13 @@ var Interval = class _Interval {
    * @throws If the number, quality, and span do not describe the same interval.
    */
   static fromData(data) {
-    const checked = _chunkS5BKZZGMcjs.toSpelledInterval.call(void 0, data);
-    return new _Interval(checked.number, checked.quality, checked.semitones, checked.descending);
+    const checked = _chunkS3QELJUEcjs.toSpelledInterval.call(void 0, data);
+    return new _Interval(
+      checked.number,
+      checked.quality,
+      checked.semitones,
+      checkedDirection(checked.descending)
+    );
   }
   /**
    * Rebuild an interval from its {@link Interval.toJSON} output.
@@ -328,7 +366,7 @@ var Interval = class _Interval {
    *   interval field read on every keystroke.
    */
   static parse(name) {
-    return _chunkS5BKZZGMcjs.unwrapParse.call(void 0, _Interval.tryParse(name));
+    return _chunkS3QELJUEcjs.unwrapParse.call(void 0, _Interval.tryParse(name));
   }
   /**
    * Parse an interval name, reporting failure instead of throwing it.
@@ -347,7 +385,7 @@ var Interval = class _Interval {
    * ```
    */
   static tryParse(name) {
-    const parsed = _chunkS5BKZZGMcjs.tryParseInterval.call(void 0, name);
+    const parsed = _chunkS3QELJUEcjs.tryParseInterval.call(void 0, name);
     return parsed.ok ? { ok: true, value: _Interval.fromData(parsed.value) } : parsed;
   }
   /** Diatonic size: 1 = unison, 2 = second, ... 8 = octave, and beyond. */
@@ -403,7 +441,7 @@ var Interval = class _Interval {
   invert() {
     const numberValue = INVERSION_SUM - simpleDegree(this.#number);
     const quality = invertQuality(this.#quality);
-    return _Interval.of(numberValue, quality, _chunkS5BKZZGMcjs.intervalSemitones.call(void 0, numberValue, quality));
+    return _Interval.of(numberValue, quality, _chunkS3QELJUEcjs.intervalSemitones.call(void 0, numberValue, quality));
   }
   /**
    * The same interval taken in the opposite direction.
@@ -430,12 +468,15 @@ var Interval = class _Interval {
   /**
    * Whether the interval is consonant.
    *
+   * The spelling decides, not the span: a diminished fourth is a dissonance
+   * though it sounds like a major third.
+   *
    * @param twoVoice When true, the perfect fourth counts as a dissonance,
    *   matching two-voice counterpoint.
    * @returns True if the interval is consonant in that context.
    */
   isConsonant(twoVoice = true) {
-    return _chunkS5BKZZGMcjs.isConsonantInterval.call(void 0, this.#semitones, twoVoice);
+    return _chunkYDGMWH43cjs.classifySpelledInterval.call(void 0, this.toJSON(), twoVoice) !== 2 /* Dissonance */;
   }
   /**
    * Whether another interval is spelled identically.
@@ -482,7 +523,6 @@ var Interval = class _Interval {
 };
 
 // src/model/shared.ts
-var STATED_KEY_CONFIDENCE = 1;
 function describeShape(value) {
   if (value === null) {
     return "null";
@@ -491,13 +531,13 @@ function describeShape(value) {
 }
 function assertDataObject(value, name) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`${name} must be an object; received ${describeShape(value)}`);
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(`${name} must be an object; received ${describeShape(value)}`);
   }
   return value;
 }
 function assertDataArray(value, name) {
   if (!Array.isArray(value)) {
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`${name} must be an array; received ${describeShape(value)}`);
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(`${name} must be an array; received ${describeShape(value)}`);
   }
   return value;
 }
@@ -509,14 +549,14 @@ function assertDataObjects(value, name) {
   return items;
 }
 function assertNoteEventArray(notes, name, options) {
-  return _chunkS5BKZZGMcjs.assertNoteEvents.call(void 0, assertDataArray(notes, name), name, options);
+  return _chunkS3QELJUEcjs.assertNoteEvents.call(void 0, assertDataArray(notes, name), name, options);
 }
 function assertKeyArgument(value, name) {
   if (value === void 0 || typeof value === "string" || isKeyShaped(value)) {
     return;
   }
   const received = value === null ? "null" : typeof value === "object" ? "an object" : `a ${typeof value}`;
-  throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+  throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
     `${name} must be a Key; received ${received}. A method that also takes options takes them after the key, not in its place`
   );
 }
@@ -554,7 +594,7 @@ function copyNoteEvent(note) {
 }
 function copyTimeSignature(ts, name) {
   assertDataObject(ts, _nullishCoalesce(name, () => ( "time signature")));
-  _chunkS5BKZZGMcjs.assertTimeSignature.call(void 0, ts, name);
+  _chunkS3QELJUEcjs.assertTimeSignature.call(void 0, ts, name);
   const copy = { numerator: ts.numerator, denominator: ts.denominator };
   if (ts.grouping !== void 0) {
     copy.grouping = [...ts.grouping];
@@ -567,19 +607,19 @@ function copyPlain(value, name) {
 }
 function copyPlainAt(value, name, seen, depth) {
   if (typeof value === "number") {
-    return _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, value, name);
+    return _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, value, name);
   }
   if (typeof value === "function" || typeof value === "symbol" || typeof value === "bigint") {
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`${name} must be plain data; received ${typeof value}`);
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(`${name} must be plain data; received ${typeof value}`);
   }
   if (typeof value !== "object" || value === null) {
     return value;
   }
   if (seen.has(value)) {
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`${name} must be plain data; received a value referring to itself`);
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(`${name} must be plain data; received a value referring to itself`);
   }
   if (depth >= MAX_PLAIN_DEPTH) {
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
       `${name} must be plain data; received a value nested more than ${MAX_PLAIN_DEPTH} levels deep`
     );
   }
@@ -617,7 +657,7 @@ function samePlain(value, other) {
 function copyNote(data) {
   assertDataObject(data, "note data");
   if (!Number.isInteger(data.letter) || data.letter < 0 || data.letter > 6) {
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
       `note letter must be an integer in [0, 6]; received ${data.letter}`
     );
   }
@@ -625,7 +665,7 @@ function copyNote(data) {
   if (data.octave !== void 0) {
     copy.octave = data.octave;
   }
-  _chunkS5BKZZGMcjs.noteToPitchClass.call(void 0, copy);
+  _chunkS3QELJUEcjs.noteToPitchClass.call(void 0, copy);
   return copy;
 }
 var NATURAL_LETTER = /^[A-G]$/;
@@ -634,11 +674,11 @@ function letterNumberOf(letter) {
     return letter;
   }
   if (!NATURAL_LETTER.test(letter)) {
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
-      `Note.of takes a letter number 0..6 or a bare letter name 'C'..'B'; received ${_chunkS5BKZZGMcjs.describeRejected.call(void 0, letter)}. Use Note.parse(${_chunkS5BKZZGMcjs.describeRejected.call(void 0, letter)}) to read a note name with an accidental or an octave.`
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+      `Note.of takes a letter number 0..6 or a bare letter name 'C'..'B'; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, letter)}. Use Note.parse(${_chunkS3QELJUEcjs.describeRejected.call(void 0, letter)}) to read a note name with an accidental or an octave.`
     );
   }
-  return _chunkS5BKZZGMcjs.unwrapParse.call(void 0, _chunkS5BKZZGMcjs.tryParseNote.call(void 0, letter)).letter;
+  return _chunkS3QELJUEcjs.unwrapParse.call(void 0, _chunkS3QELJUEcjs.tryParseNote.call(void 0, letter)).letter;
 }
 var DIMINISHED_SECOND = {
   number: 2,
@@ -651,7 +691,7 @@ var DESCENDING_DIMINISHED_SECOND = {
   descending: true
 };
 function soundingOrder(note) {
-  return note.octave === void 0 ? _chunkS5BKZZGMcjs.noteToPitchClass.call(void 0, note) : _chunkS5BKZZGMcjs.noteToMidi.call(void 0, note);
+  return note.octave === void 0 ? _chunkS3QELJUEcjs.noteToPitchClass.call(void 0, note) : _chunkS3QELJUEcjs.noteToMidi.call(void 0, note);
 }
 var Note = class _Note {
   #data;
@@ -715,7 +755,7 @@ var Note = class _Note {
    * ```
    */
   static parse(text, opts) {
-    return _chunkS5BKZZGMcjs.unwrapParse.call(void 0, _Note.tryParse(text, opts));
+    return _chunkS3QELJUEcjs.unwrapParse.call(void 0, _Note.tryParse(text, opts));
   }
   /**
    * Parse a note name, reporting failure instead of throwing it.
@@ -736,7 +776,7 @@ var Note = class _Note {
    * ```
    */
   static tryParse(name, opts) {
-    const parsed = _chunkS5BKZZGMcjs.tryParseNote.call(void 0, name, opts);
+    const parsed = _chunkS3QELJUEcjs.tryParseNote.call(void 0, name, opts);
     return parsed.ok ? { ok: true, value: new _Note(parsed.value) } : parsed;
   }
   /**
@@ -747,7 +787,7 @@ var Note = class _Note {
    * @returns The spelled note, with octave.
    */
   static fromMidi(midi, spelling = "sharp") {
-    return new _Note(_chunkS5BKZZGMcjs.midiToNote.call(void 0, midi, spelling));
+    return new _Note(_chunkS3QELJUEcjs.midiToNote.call(void 0, midi, spelling));
   }
   /**
    * Wrap an existing plain note object.
@@ -764,7 +804,7 @@ var Note = class _Note {
    * `'Bb'`. Use {@link Note.format} to write it in another notation system.
    */
   get name() {
-    return _chunkS5BKZZGMcjs.formatNote.call(void 0, this.#data);
+    return _chunkS3QELJUEcjs.formatNote.call(void 0, this.#data);
   }
   /**
    * The note name written in a notation system.
@@ -783,11 +823,11 @@ var Note = class _Note {
    * ```
    */
   format(opts) {
-    return _chunkS5BKZZGMcjs.formatNote.call(void 0, this.#data, opts);
+    return _chunkS3QELJUEcjs.formatNote.call(void 0, this.#data, opts);
   }
   /** The pitch class (0..11), ignoring octave. */
   get pitchClass() {
-    return _chunkS5BKZZGMcjs.noteToPitchClass.call(void 0, this.#data);
+    return _chunkS3QELJUEcjs.noteToPitchClass.call(void 0, this.#data);
   }
   /**
    * The MIDI number (middle C = C4 = 60).
@@ -796,9 +836,9 @@ var Note = class _Note {
    */
   get midi() {
     if (this.#data.octave === void 0) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`note ${this.name} has no octave, so it has no MIDI number`);
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(`note ${this.name} has no octave, so it has no MIDI number`);
     }
-    return _chunkS5BKZZGMcjs.noteToMidi.call(void 0, this.#data);
+    return _chunkS3QELJUEcjs.noteToMidi.call(void 0, this.#data);
   }
   /** The diatonic letter number: 0..6 for C..B. */
   get letter() {
@@ -840,7 +880,7 @@ var Note = class _Note {
    * ```
    */
   frequency(tuning) {
-    return _chunkNM7UAMC3cjs.frequencyOf.call(void 0, this.midi, tuning);
+    return _chunk3FDBMIPRcjs.frequencyOf.call(void 0, this.midi, tuning);
   }
   /**
    * Transpose by a signed number of semitones, keeping the spelling.
@@ -866,7 +906,7 @@ var Note = class _Note {
     if (semitones === 0 && _optionalChain([opts, 'optionalAccess', _ => _.spelling]) === void 0) {
       return new _Note(this.#data);
     }
-    return new _Note(_chunkS5BKZZGMcjs.transposeNote.call(void 0, this.#data, semitones, opts));
+    return new _Note(_chunkS3QELJUEcjs.transposeNote.call(void 0, this.#data, semitones, opts));
   }
   /**
    * The spelled interval from this note to another.
@@ -875,7 +915,7 @@ var Note = class _Note {
    * @returns The interval, which {@link Interval.toJSON} unwraps to plain data.
    */
   intervalTo(other) {
-    return Interval.fromData(_chunkS5BKZZGMcjs.spelledInterval.call(void 0, this.#data, other.data));
+    return Interval.fromData(_chunkS3QELJUEcjs.spelledInterval.call(void 0, this.#data, other.data));
   }
   /**
    * Transpose by a spelled interval, keeping the spelling the interval names.
@@ -896,7 +936,7 @@ var Note = class _Note {
    * ```
    */
   transposeBy(interval) {
-    return new _Note(_chunkS5BKZZGMcjs.transposeByInterval.call(void 0, this.#data, _chunkS5BKZZGMcjs.toSpelledInterval.call(void 0, interval)));
+    return new _Note(_chunkS3QELJUEcjs.transposeByInterval.call(void 0, this.#data, _chunkS3QELJUEcjs.toSpelledInterval.call(void 0, interval)));
   }
   /**
    * The same spelled note in another octave.
@@ -945,7 +985,7 @@ var Note = class _Note {
    * ```
    */
   forInstrument(instrument) {
-    return new _Note(_chunk76ZBTRG2cjs.toWrittenPitch.call(void 0, this.#data, instrument));
+    return new _Note(_chunkU4EQTDGNcjs.toWrittenPitch.call(void 0, this.#data, instrument));
   }
   /**
    * The other ways this note can be spelled: the same sounding pitch written on
@@ -966,7 +1006,7 @@ var Note = class _Note {
    * ```
    */
   enharmonic() {
-    return [DIMINISHED_SECOND, DESCENDING_DIMINISHED_SECOND].map((interval) => _chunkS5BKZZGMcjs.transposeByInterval.call(void 0, this.#data, interval)).filter((note) => Math.abs(note.alter) <= _chunkS5BKZZGMcjs.MAX_NAME_ACCIDENTALS).map((note) => new _Note(note));
+    return [DIMINISHED_SECOND, DESCENDING_DIMINISHED_SECOND].map((interval) => _chunkS3QELJUEcjs.transposeByInterval.call(void 0, this.#data, interval)).filter((note) => Math.abs(note.alter) <= _chunkS3QELJUEcjs.MAX_NAME_ACCIDENTALS).map((note) => new _Note(note));
   }
   /**
    * The scale degree this note occupies in a key, counted from 1 at the tonic.
@@ -987,7 +1027,7 @@ var Note = class _Note {
    * ```
    */
   degreeIn(key) {
-    const degree = _chunk3R3QVKY5cjs.pitchToScaleDegree.call(void 0, this.pitchClass, key);
+    const degree = _chunkYDGMWH43cjs.pitchToScaleDegree.call(void 0, this.pitchClass, key);
     return degree === -1 ? null : degree;
   }
   /**
@@ -1065,11 +1105,27 @@ var Note = class _Note {
 };
 
 // src/model/timeline.ts
+var KEY_RELATIONS = [
+  "same",
+  "enharmonic",
+  "relative",
+  "parallel",
+  "dominant",
+  "subdominant",
+  "relativeOfDominant",
+  "relativeOfSubdominant"
+];
+function assertNumeral(numeral, name) {
+  if (typeof numeral !== "string") {
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(`${name} must be a string; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, numeral)}`);
+  }
+  return numeral;
+}
 function copySegment(segment) {
   assertDataObject(segment, "timeline segment");
   return {
-    startBeat: _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, segment.startBeat, "timeline segment startBeat"),
-    endBeat: _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, segment.endBeat, "timeline segment endBeat"),
+    startBeat: _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, segment.startBeat, "timeline segment startBeat"),
+    endBeat: _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, segment.endBeat, "timeline segment endBeat"),
     // The chord is checked by the same boundary every other chord crosses, so a
     // root of 25 or an interval of NaN is refused or reduced here rather than
     // surfacing wherever the number is finally used.
@@ -1079,22 +1135,22 @@ function copySegment(segment) {
 function copyKeyRegion(region) {
   assertDataObject(region, "key region");
   const copy = {
-    startBeat: _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, region.startBeat, "key region startBeat"),
-    endBeat: _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, region.endBeat, "key region endBeat"),
+    startBeat: _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, region.startBeat, "key region startBeat"),
+    endBeat: _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, region.endBeat, "key region endBeat"),
     // Read through the key itself, so a tonic that does not spell the region's
     // own root is refused here rather than spelling later notes wrongly.
     key: keyIdentity(toKey(region.key)),
-    confidence: _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, region.confidence, "key region confidence")
+    confidence: _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, region.confidence, "key region confidence")
   };
   if (region.modulation !== void 0) {
-    copy.modulation = region.modulation;
+    copy.modulation = _chunkS3QELJUEcjs.assertOneOf.call(void 0, region.modulation, KEY_RELATIONS, "key region modulation");
   }
   if (region.pivot !== void 0) {
     assertDataObject(region.pivot, "key region pivot");
     copy.pivot = {
       chord: new Chord(region.pivot.chord).toJSON(),
-      romanFrom: region.pivot.romanFrom,
-      romanTo: region.pivot.romanTo
+      romanFrom: assertNumeral(region.pivot.romanFrom, "key region pivot romanFrom"),
+      romanTo: assertNumeral(region.pivot.romanTo, "key region pivot romanTo")
     };
   }
   return copy;
@@ -1105,14 +1161,18 @@ function copyConfidence(confidence, segments) {
   }
   assertDataArray(confidence, "timeline segmentConfidence");
   if (confidence.length !== segments) {
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
       `timeline segmentConfidence must hold one value per segment; received ${confidence.length} for ${segments}`
     );
   }
   return confidence.map(
-    (value, index) => _chunkS5BKZZGMcjs.assertRange.call(void 0, value, 0, 1, `timeline segmentConfidence[${index}]`)
+    (value, index) => _chunkS3QELJUEcjs.assertRange.call(void 0, value, 0, 1, `timeline segmentConfidence[${index}]`)
   );
 }
+function validateTimeline(segments, keys) {
+  _chunkLQZQDBCDcjs.assertSpansInOrder.call(void 0, segments, "timeline segments");
+  _chunkLQZQDBCDcjs.assertSpansInOrder.call(void 0, keys, "timeline keys");
+}
 function clipSpan(span, fromBeat, toBeat) {
   const startBeat = Math.max(span.startBeat, fromBeat);
   const endBeat = Math.min(span.endBeat, toBeat);
@@ -1128,15 +1188,16 @@ var Timeline = class _Timeline {
    *
    * @param data The segments and the span they cover; copied, never retained.
    * @throws If the span, a segment, or a key region carries a number it cannot
-   *   hold — a beat that is not finite, a mode mask that names no scale — or if
-   *   the confidences do not run one per segment.
+   *   hold — a beat that is not finite, a mode mask that names no scale — if
+   *   the segments or the key regions are not disjoint, in beat order and of
+   *   positive length, or if the confidences do not run one per segment.
    */
   constructor(data) {
     assertDataObject(data, "timeline data");
     this.#segments = Object.freeze(
       assertDataArray(data.segments, "timeline segments").map(copySegment)
     );
-    this.#totalBeats = _chunkS5BKZZGMcjs.assertRange.call(void 0, 
+    this.#totalBeats = _chunkS3QELJUEcjs.assertRange.call(void 0, 
       data.totalBeats,
       0,
       Number.MAX_SAFE_INTEGER,
@@ -1148,6 +1209,7 @@ var Timeline = class _Timeline {
     this.#segmentConfidence = Object.freeze(
       copyConfidence(data.segmentConfidence, this.#segments.length)
     );
+    validateTimeline(this.#segments, this.#keys);
   }
   /**
    * Build a timeline from placed chords.
@@ -1155,24 +1217,18 @@ var Timeline = class _Timeline {
    * @param spans The chords with their onsets, in any order.
    * @param totalBeats Where the last chord stops sounding.
    * @param key The key the chords are read in, when it is already known. It
-   *   becomes the one key region under the whole span; without it the timeline
+   *   becomes the one key region from the first chord to the end of the span;
+   *   without it, or without a chord for it to be in force over, the timeline
    *   carries no key, and the members that need one say so.
    * @returns The timeline.
    */
   static fromChords(spans, totalBeats, key) {
-    const timeline = _chunkSGLEQVJHcjs.chordTimelineFromChords.call(void 0, spans, totalBeats);
+    const timeline = _chunkLQZQDBCDcjs.chordTimelineFromChords.call(void 0, spans, totalBeats);
     const data = { segments: timeline.segments, totalBeats };
     if (key !== void 0) {
-      data.keys = [
-        {
-          // The region starts where the music does, as an inferred one does,
-          // so a chord placed in a pickup is covered by the key it sounds in.
-          startBeat: _nullishCoalesce(_optionalChain([timeline, 'access', _2 => _2.segments, 'access', _3 => _3[0], 'optionalAccess', _4 => _4.startBeat]), () => ( 0)),
-          endBeat: totalBeats,
-          key: keyIdentity(toKey(key)),
-          confidence: STATED_KEY_CONFIDENCE
-        }
-      ];
+      const stated = keyIdentity(toKey(key));
+      const first = timeline.segments[0];
+      data.keys = first === void 0 ? [] : _chunkLQZQDBCDcjs.statedKeyRegions.call(void 0, stated, first.startBeat, totalBeats);
     }
     return new _Timeline(data);
   }
@@ -1184,8 +1240,8 @@ var Timeline = class _Timeline {
    * @returns The inferred timeline, carrying the key regions the analysis found.
    */
   static fromNotes(notes, opts) {
-    const { timeline, keys, segmentConfidence } = _chunkSGLEQVJHcjs.chordTimelineFromNotes.call(void 0, notes, opts);
-    const totalBeats = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _5 => _5.totalBeats]), () => ( spanEnd(timeline.segments, keys)));
+    const { timeline, keys, segmentConfidence } = _chunkLQZQDBCDcjs.chordTimelineFromNotes.call(void 0, notes, opts);
+    const totalBeats = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _2 => _2.totalBeats]), () => ( spanEnd(timeline.segments, keys)));
     return new _Timeline({ segments: timeline.segments, totalBeats, keys, segmentConfidence });
   }
   /**
@@ -1203,11 +1259,25 @@ var Timeline = class _Timeline {
    * @throws If `beatsEach` is not a positive finite number of beats.
    */
   static fromProgression(progression, beatsEach) {
-    _chunkS5BKZZGMcjs.assertRange.call(void 0, beatsEach, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "timeline beatsEach");
-    const chords = progression.chords;
-    const spans = chords.map((chord, index) => _chunk3R3QVKY5cjs.spanFromChord.call(void 0, chord.data, index * beatsEach));
+    const read = progression;
+    if (typeof read !== "object" || read === null || !Array.isArray(read.chords)) {
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+        `timeline progression must be a Progression; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, progression)}`
+      );
+    }
+    _chunkS3QELJUEcjs.assertRange.call(void 0, beatsEach, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "timeline beatsEach");
+    const chords = read.chords;
+    const spans = chords.map((chord, index) => {
+      const data = _optionalChain([chord, 'optionalAccess', _3 => _3.data]);
+      if (typeof data !== "object" || data === null) {
+        throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+          `timeline progression chords[${index}] must be a Chord; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, chord)}`
+        );
+      }
+      return _chunkYDGMWH43cjs.spanFromChord.call(void 0, data, index * beatsEach);
+    });
     const totalBeats = chords.length * beatsEach;
-    const key = progression.key;
+    const key = read.key;
     return key === void 0 ? _Timeline.fromChords(spans, totalBeats) : _Timeline.fromChords(spans, totalBeats, key);
   }
   /** Rebuild a timeline from the plain data {@link Timeline.data} hands out. */
@@ -1231,7 +1301,7 @@ var Timeline = class _Timeline {
    * @throws If `beat` is not finite.
    */
   at(beat) {
-    const chord = _chunkSGLEQVJHcjs.chordAtBeat.call(void 0, this.#segments, beat);
+    const chord = _chunkLQZQDBCDcjs.chordAtBeat.call(void 0, this.#segments, beat);
     if (chord === null) {
       return null;
     }
@@ -1248,7 +1318,7 @@ var Timeline = class _Timeline {
   }
   /** The key held longest across the span, when the analysis found one. */
   get key() {
-    const prevailing = _chunkSGLEQVJHcjs.prevailingKeyOf.call(void 0, this.#keys);
+    const prevailing = _chunkLQZQDBCDcjs.prevailingKeyOf.call(void 0, this.#keys);
     return prevailing === null ? void 0 : toKey(prevailing);
   }
   /**
@@ -1320,7 +1390,7 @@ var Timeline = class _Timeline {
    * @throws If the timeline carries no key region to read the chords against.
    */
   reduce(opts) {
-    return _chunkHPVSH7SFcjs.reduceProgression.call(void 0, this.chordTimeline, this.#keyContext(), opts);
+    return _chunkLQZQDBCDcjs.reduceProgression.call(void 0, this.chordTimeline, this.#keyContext(), opts);
   }
   /**
    * The cadences the harmony arrives at.
@@ -1333,7 +1403,7 @@ var Timeline = class _Timeline {
    * @throws If the timeline carries no key region to read the chords against.
    */
   cadences() {
-    return _chunkSGLEQVJHcjs.detectCadences.call(void 0, this.chordTimeline, this.#keyContext());
+    return _chunkLQZQDBCDcjs.detectCadences.call(void 0, this.chordTimeline, this.#keyContext());
   }
   /**
    * The keys the chords themselves imply, in time order.
@@ -1362,7 +1432,7 @@ var Timeline = class _Timeline {
    * ```
    */
   modulations(opts) {
-    return _chunkSGLEQVJHcjs.detectModulations.call(void 0, this.#copySegments(), {
+    return _chunkLQZQDBCDcjs.detectModulations.call(void 0, this.#copySegments(), {
       totalBeats: this.#totalBeats,
       ...opts
     }).map(copyKeyRegion);
@@ -1380,12 +1450,12 @@ var Timeline = class _Timeline {
    */
   roman(key, opts) {
     assertKeyArgument(key, "timeline key");
-    const given = key === void 0 ? void 0 : _chunk3R3QVKY5cjs.resolveKey.call(void 0, key);
+    const given = key === void 0 ? void 0 : _chunkYDGMWH43cjs.resolveKey.call(void 0, key);
     const keyAt = given === void 0 ? this.#resolvedKeyAt() : () => given;
     return this.#segments.map((segment) => ({
       startBeat: segment.startBeat,
       endBeat: segment.endBeat,
-      roman: _chunkSGLEQVJHcjs.chordToRoman.call(void 0, segment.chord, keyAt(segment.startBeat), opts)
+      roman: _chunkLQZQDBCDcjs.chordToRoman.call(void 0, segment.chord, keyAt(segment.startBeat), opts)
     }));
   }
   /**
@@ -1402,10 +1472,10 @@ var Timeline = class _Timeline {
    * @throws If either beat is not finite, or `toBeat` precedes `fromBeat`.
    */
   slice(fromBeat, toBeat) {
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, fromBeat, "timeline slice fromBeat");
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, toBeat, "timeline slice toBeat");
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, fromBeat, "timeline slice fromBeat");
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, toBeat, "timeline slice toBeat");
     if (toBeat < fromBeat) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         `timeline slice toBeat must not precede fromBeat; received [${fromBeat}, ${toBeat})`
       );
     }
@@ -1500,7 +1570,7 @@ var Timeline = class _Timeline {
   /** The `{ at, segments }` shape the analysis functions take. */
   get chordTimeline() {
     const segments = this.#copySegments();
-    return { at: (beat) => _chunkSGLEQVJHcjs.chordAtBeat.call(void 0, segments, beat), segments };
+    return { at: (beat) => _chunkLQZQDBCDcjs.chordAtBeat.call(void 0, segments, beat), segments };
   }
   /** A fresh copy of the segments, which is what every reader is handed. */
   #copySegments() {
@@ -1508,8 +1578,8 @@ var Timeline = class _Timeline {
   }
   /** The key in force at a beat, or undefined when the timeline knows none. */
   #keyAt(beat) {
-    const prevailing = _chunkSGLEQVJHcjs.prevailingKeyOf.call(void 0, this.#keys);
-    return prevailing === null ? void 0 : toKey(_chunkSGLEQVJHcjs.keyLookup.call(void 0, this.#keys, prevailing)(beat));
+    const prevailing = _chunkLQZQDBCDcjs.prevailingKeyOf.call(void 0, this.#keys);
+    return prevailing === null ? void 0 : toKey(_chunkLQZQDBCDcjs.keyLookup.call(void 0, this.#keys, prevailing)(beat));
   }
   /**
    * The key every beat of the timeline is read against, spelling and all.
@@ -1522,13 +1592,13 @@ var Timeline = class _Timeline {
    * would number it as the G# minor those read best as.
    */
   #resolvedKeyAt() {
-    const prevailing = _chunkSGLEQVJHcjs.prevailingKeyOf.call(void 0, this.#keys);
+    const prevailing = _chunkLQZQDBCDcjs.prevailingKeyOf.call(void 0, this.#keys);
     if (prevailing === null) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         "timeline carries no key; build it from notes, or pass a key to Timeline.fromChords"
       );
     }
-    return _chunkSGLEQVJHcjs.keyLookup.call(void 0, this.#keys, prevailing);
+    return _chunkLQZQDBCDcjs.keyLookup.call(void 0, this.#keys, prevailing);
   }
   /**
    * The pitch classes of that key, for the readings that want them.
@@ -1540,7 +1610,7 @@ var Timeline = class _Timeline {
    */
   #keyContext() {
     const keyAt = this.#resolvedKeyAt();
-    return (beat) => _chunk3R3QVKY5cjs.scaleOf.call(void 0, keyAt(beat));
+    return (beat) => _chunkYDGMWH43cjs.scaleOf.call(void 0, keyAt(beat));
   }
   /** Move every chord and every key region by the same step. */
   #moved(moveChord, moveKey) {
@@ -1599,7 +1669,14 @@ var Progression = class _Progression {
    */
   static #attachKey(chords, key) {
     const given = assertDataObjects(chords, "progression chords");
-    return key === void 0 ? [...given] : given.map((chord) => chord.withKey(key));
+    return given.map((chord, index) => {
+      if (typeof chord.toJSON !== "function") {
+        throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+          `progression chords[${index}] must be a Chord; received ${_chunkS3QELJUEcjs.describeRejected.call(void 0, chord)}`
+        );
+      }
+      return new Chord(chord.toJSON(), _nullishCoalesce(key, () => ( chord.key)));
+    });
   }
   /**
    * Start from a chord sequence, matching the `of` factory on the other
@@ -1642,24 +1719,39 @@ var Progression = class _Progression {
    */
   static fromSpans(spans, key) {
     const chords = assertDataObjects(spans, "progression spans").map(
-      (span) => Chord.fromData(_chunk3R3QVKY5cjs.chordFromSpan.call(void 0, span))
+      (span) => Chord.fromData(_chunkYDGMWH43cjs.chordFromSpan.call(void 0, span))
     );
     return new _Progression(chords, key);
   }
   /**
-   * Rebuild a progression from its {@link Progression.toJSON} output.
+   * Rebuild a progression from its {@link Progression.toJSON} output, with the
+   * carried key or, without one, each chord's own key.
    *
-   * @param data The serialized chords and key.
+   * @param data The serialized chords and keys.
    * @returns The progression.
+   * @throws If `chordKeys` does not hold one entry per chord.
    */
   static fromJSON(data) {
     assertDataObject(data, "progression data");
     const key = data.key === void 0 ? void 0 : Key.fromJSON(data.key);
-    const chords = assertDataArray(data.chords, "progression chords").map(
-      (chord) => Chord.fromJSON(chord)
-    );
+    const given = assertDataArray(data.chords, "progression chords");
+    const chordKeys = key === void 0 && data.chordKeys !== void 0 ? _Progression.#readChordKeys(data.chordKeys, given.length) : void 0;
+    const chords = given.map((chord, index) => {
+      const own = _optionalChain([chordKeys, 'optionalAccess', _4 => _4[index]]);
+      return own === void 0 ? Chord.fromJSON(chord) : Chord.fromJSON(chord).withKey(own);
+    });
     return key === void 0 ? new _Progression(chords) : new _Progression(chords, key);
   }
+  /** Read the per-chord keys of {@link ProgressionData}, one entry per chord. */
+  static #readChordKeys(value, count) {
+    const entries = assertDataArray(value, "progression chord keys");
+    if (entries.length !== count) {
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+        `progression chord keys must hold one entry per chord (${count}); received ${entries.length}`
+      );
+    }
+    return entries.map((entry) => entry === null ? void 0 : Key.fromJSON(entry));
+  }
   /**
    * Wrap plain progression data, matching the `fromData` factory on the other
    * classes.
@@ -1869,11 +1961,9 @@ var Progression = class _Progression {
    * @throws If any chord admits no voicing within the given ranges.
    */
   voice(opts) {
-    const key = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _6 => _6.key]), () => ( this.#key));
-    return _chunk76ZBTRG2cjs.voiceProgression.call(void 0, 
-      this.#chords.map((chord) => chord.data),
-      key === void 0 ? opts : { ...opts, key }
-    );
+    const key = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _5 => _5.key]), () => ( this.#key));
+    const views = _optionalChain([opts, 'optionalAccess', _6 => _6.key]) === void 0 ? this.#chords.map((chord) => chord.data) : this.#viewsIn(toKey(opts.key));
+    return _chunkU4EQTDGNcjs.voiceProgression.call(void 0, views, key === void 0 ? opts : { ...opts, key });
   }
   /**
    * The Roman numeral of each chord in a key.
@@ -1934,12 +2024,13 @@ var Progression = class _Progression {
     const resolved = this.#resolveKey(key);
     const chords = this.#chords.map((chord) => chord.analyze(resolved, opts));
     const { voicing, ...cadenceOpts } = _nullishCoalesce(opts, () => ( {}));
-    const from = this.#chords[this.#chords.length - 2];
-    const to = this.#chords[this.#chords.length - 1];
-    const approach = this.#chords[this.#chords.length - 3];
-    const cadence = from !== void 0 && to !== void 0 ? _chunkSGLEQVJHcjs.detectCadence.call(void 0, from.data, to.data, resolved, {
+    const views = this.#viewsIn(resolved);
+    const from = views[views.length - 2];
+    const to = views[views.length - 1];
+    const approach = views[views.length - 3];
+    const cadence = from !== void 0 && to !== void 0 ? _chunkLQZQDBCDcjs.detectCadence.call(void 0, from, to, resolved, {
       ...cadenceOpts,
-      ...approach === void 0 ? {} : { approach: approach.data },
+      ...approach === void 0 ? {} : { approach },
       ...voicing === void 0 ? {} : { voicing: this.#closingVoicing(voicing) }
     }) : null;
     return { chords, cadence };
@@ -1957,7 +2048,7 @@ var Progression = class _Progression {
     if (voicing.length === this.#chords.length || voicing.length === 2) {
       return [_nullishCoalesce(voicing[voicing.length - 2], () => ( [])), _nullishCoalesce(voicing[voicing.length - 1], () => ( []))];
     }
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
       `voicing must hold one voicing per chord (${this.#chords.length}) or the closing pair; received ${voicing.length}`
     );
   }
@@ -1967,7 +2058,7 @@ var Progression = class _Progression {
    * @returns One scale choice per chord in this progression.
    */
   scales() {
-    return _chunkPM4XJE2Ycjs.scalesForChanges.call(void 0, this.#chords.map((chord) => chord.data));
+    return _chunkP3CPXAJ5cjs.scalesForChanges.call(void 0, this.#chords.map((chord) => chord.data));
   }
   /**
    * Classify the motion at every chord change, not only the closing one.
@@ -2004,18 +2095,19 @@ var Progression = class _Progression {
    */
   cadences(key, opts) {
     const resolved = this.#resolveKey(key);
+    const views = this.#viewsIn(resolved);
     const found = [];
-    for (let index = 1; index < this.#chords.length; index += 1) {
-      const from = this.#chords[index - 1];
-      const to = this.#chords[index];
+    for (let index = 1; index < views.length; index += 1) {
+      const from = views[index - 1];
+      const to = views[index];
       if (from === void 0 || to === void 0) {
         continue;
       }
-      const approach = index >= 2 ? _optionalChain([this, 'access', _7 => _7.#chords, 'access', _8 => _8[index - 2], 'optionalAccess', _9 => _9.data]) : _optionalChain([opts, 'optionalAccess', _10 => _10.approach]);
-      const pair = _optionalChain([opts, 'optionalAccess', _11 => _11.voicing]);
+      const approach = index >= 2 ? views[index - 2] : _optionalChain([opts, 'optionalAccess', _7 => _7.approach]);
+      const pair = _optionalChain([opts, 'optionalAccess', _8 => _8.voicing]);
       found.push(
-        _chunkSGLEQVJHcjs.detectCadence.call(void 0, from.data, to.data, resolved, {
-          ..._optionalChain([opts, 'optionalAccess', _12 => _12.alternatives]) === void 0 ? {} : { alternatives: opts.alternatives },
+        _chunkLQZQDBCDcjs.detectCadence.call(void 0, from, to, resolved, {
+          ..._optionalChain([opts, 'optionalAccess', _9 => _9.alternatives]) === void 0 ? {} : { alternatives: opts.alternatives },
           ...approach === void 0 ? {} : { approach },
           ...pair === void 0 ? {} : { voicing: [_nullishCoalesce(pair[index - 1], () => ( [])), _nullishCoalesce(pair[index], () => ( []))] }
         })
@@ -2051,16 +2143,16 @@ var Progression = class _Progression {
     const position = index < 0 ? this.#chords.length + index : index;
     const target = this.#chords[position];
     if (target === void 0) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         `progression has no chord at index ${index}; it holds ${this.#chords.length}`
       );
     }
     const key = this.#resolveKey();
-    const chosen = _chunkJ7FHVZIIcjs.substituteChord.call(void 0, target.data, key, opts).find(
+    const chosen = _chunk6TTBEON3cjs.substituteChord.call(void 0, target.data, key, opts).find(
       (candidate) => candidate.type === type
     );
     if (chosen === void 0) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         `no ${type} substitution for ${target.symbol()} in ${key.toString()}`
       );
     }
@@ -2102,7 +2194,7 @@ var Progression = class _Progression {
    * ```
    */
   transpose(semitones) {
-    const key = _optionalChain([this, 'access', _13 => _13.#key, 'optionalAccess', _14 => _14.transpose, 'call', _15 => _15(semitones)]);
+    const key = _optionalChain([this, 'access', _10 => _10.#key, 'optionalAccess', _11 => _11.transpose, 'call', _12 => _12(semitones)]);
     const chords = this.#chords.map((chord) => chord.transpose(semitones));
     return new _Progression(chords, key);
   }
@@ -2125,7 +2217,7 @@ var Progression = class _Progression {
    * ```
    */
   transposeBy(interval) {
-    const key = _optionalChain([this, 'access', _16 => _16.#key, 'optionalAccess', _17 => _17.transposeBy, 'call', _18 => _18(interval)]);
+    const key = _optionalChain([this, 'access', _13 => _13.#key, 'optionalAccess', _14 => _14.transposeBy, 'call', _15 => _15(interval)]);
     const chords = this.#chords.map((chord) => chord.transposeBy(interval));
     return new _Progression(chords, key);
   }
@@ -2153,7 +2245,7 @@ var Progression = class _Progression {
   transposeTo(target) {
     const from = this.#key;
     if (from === void 0) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         "progression has no key context; attach one with withKey() before transposing to another key"
       );
     }
@@ -2175,16 +2267,26 @@ var Progression = class _Progression {
   /**
    * The plain progression data, for JSON serialization.
    *
-   * Private class fields do not serialize, so this preserves both the chord
-   * data and any carried key in `JSON.stringify(progression)`.
+   * Private class fields do not serialize, so this preserves the chord data,
+   * any carried key, and — for a progression with no key of its own — each
+   * chord's own key in `JSON.stringify(progression)`.
    *
-   * @returns The chord data sequence and the carried key, if any.
+   * @returns The chord data sequence, the carried key, if any, and the
+   *   per-chord keys when they are what spells the chords.
    */
   toJSON() {
-    return {
+    const out = {
       chords: this.#chords.map((chord) => chord.toJSON()),
-      key: _optionalChain([this, 'access', _19 => _19.#key, 'optionalAccess', _20 => _20.toJSON, 'call', _21 => _21()])
+      key: _optionalChain([this, 'access', _16 => _16.#key, 'optionalAccess', _17 => _17.toJSON, 'call', _18 => _18()])
     };
+    if (this.#key === void 0 && this.#chords.some((chord) => chord.key !== void 0)) {
+      out.chordKeys = this.#chords.map((chord) => _nullishCoalesce(_optionalChain([chord, 'access', _19 => _19.key, 'optionalAccess', _20 => _20.toJSON, 'call', _21 => _21()]), () => ( null)));
+    }
+    return out;
+  }
+  /** The members read in `key`: spellings the caller gave, the rest derived from it. */
+  #viewsIn(key) {
+    return this.#chords.map((chord) => chord.withKey(key).data);
   }
   /**
    * Resolve the key for an analysis method: explicit first, then carried.
@@ -2196,7 +2298,7 @@ var Progression = class _Progression {
     assertKeyArgument(key, "progression key");
     const resolved = key === void 0 ? this.#key : toKey(key);
     if (resolved === void 0) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         "progression has no key context; pass a Key or attach one with withKey()"
       );
     }
@@ -2206,25 +2308,25 @@ var Progression = class _Progression {
 
 // src/model/chord.ts
 function hintMatches(hint, pc) {
-  return hint !== void 0 && pc !== void 0 && _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, _chunkS5BKZZGMcjs.noteToPitchClass.call(void 0, hint)) === _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, pc);
+  return hint !== void 0 && pc !== void 0 && _chunkS3QELJUEcjs.pitchClassOf.call(void 0, _chunkS3QELJUEcjs.noteToPitchClass.call(void 0, hint)) === _chunkS3QELJUEcjs.pitchClassOf.call(void 0, pc);
 }
 function transposeHintByInterval(hint, interval) {
   if (hint === void 0) {
     return void 0;
   }
-  const moved = _chunkS5BKZZGMcjs.transposeByInterval.call(void 0, hint, interval);
+  const moved = _chunkS3QELJUEcjs.transposeByInterval.call(void 0, hint, interval);
   return { letter: moved.letter, alter: moved.alter };
 }
 function transposeToneHintsByInterval(hints, interval) {
   return _optionalChain([hints, 'optionalAccess', _22 => _22.map, 'call', _23 => _23((hint) => {
-    const moved = _chunkS5BKZZGMcjs.transposeByInterval.call(void 0, hint, interval);
+    const moved = _chunkS3QELJUEcjs.transposeByInterval.call(void 0, hint, interval);
     return { letter: moved.letter, alter: moved.alter };
   })]);
 }
 function copyChord(data) {
   assertDataObject(data, "chord data");
-  _chunk3R3QVKY5cjs.assertChordQuality.call(void 0, data.quality);
-  const rootPc = _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, data.rootPc);
+  _chunkYDGMWH43cjs.assertChordQuality.call(void 0, data.quality);
+  const rootPc = _chunkS3QELJUEcjs.pitchClassOf.call(void 0, data.rootPc);
   const copy = {
     rootPc,
     quality: data.quality,
@@ -2232,14 +2334,14 @@ function copyChord(data) {
     // interval voices, spells and formats as a chord that looks real, and the
     // failure surfaces wherever the number is finally used.
     intervals: assertDataArray(data.intervals, "chord intervals").map(
-      (interval, index) => _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, interval, `chord intervals[${index}]`)
+      (interval, index) => _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, interval, `chord intervals[${index}]`)
     )
   };
-  const bassPc = data.bassPc === void 0 ? void 0 : _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, data.bassPc);
+  const bassPc = data.bassPc === void 0 ? void 0 : _chunkS3QELJUEcjs.pitchClassOf.call(void 0, data.bassPc);
   if (bassPc !== void 0 && bassPc !== rootPc) {
     copy.bassPc = bassPc;
   }
-  const tones = _chunk3R3QVKY5cjs.chordToneSpellings.call(void 0, data);
+  const tones = _chunkYDGMWH43cjs.chordToneSpellings.call(void 0, data);
   if (tones !== void 0) {
     copy.toneSpellings = tones;
   }
@@ -2258,8 +2360,8 @@ function deriveBassSpelling(chord, key) {
   }
   const root = chord.rootSpelling;
   if (root !== void 0) {
-    const index = chord.intervals.findIndex((i) => _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, chord.rootPc + i) === bassPc);
-    const tone = index >= 0 ? _chunk3R3QVKY5cjs.spellChordFromRoot.call(void 0, chord, root)[index] : void 0;
+    const index = chord.intervals.findIndex((i) => _chunkS3QELJUEcjs.pitchClassOf.call(void 0, chord.rootPc + i) === bassPc);
+    const tone = index >= 0 ? _chunkYDGMWH43cjs.spellChordFromRoot.call(void 0, chord, root)[index] : void 0;
     if (tone !== void 0) {
       return { letter: tone.letter, alter: tone.alter };
     }
@@ -2267,7 +2369,7 @@ function deriveBassSpelling(chord, key) {
   if (key === void 0) {
     return void 0;
   }
-  const spelled = _chunk3R3QVKY5cjs.spellPitchClass.call(void 0, bassPc, key.tonic.data, key);
+  const spelled = _chunkYDGMWH43cjs.spellPitchClass.call(void 0, bassPc, key.tonic.data, key);
   return { letter: spelled.letter, alter: spelled.alter };
 }
 var Chord = class _Chord {
@@ -2300,7 +2402,7 @@ var Chord = class _Chord {
   #dataWithKey(key) {
     const out = copyChord(this.#given);
     if (out.rootSpelling === void 0 && key !== void 0) {
-      out.rootSpelling = _chunk3R3QVKY5cjs.spellPitchClass.call(void 0, out.rootPc, key.tonic.data, key);
+      out.rootSpelling = _chunkYDGMWH43cjs.spellPitchClass.call(void 0, out.rootPc, key.tonic.data, key);
     }
     if (out.bassSpelling === void 0) {
       const bass = deriveBassSpelling(out, key);
@@ -2323,7 +2425,7 @@ var Chord = class _Chord {
     const bassNote = typeof bass === "string" ? Note.parse(bass) : void 0;
     const bassPc = bassNote !== void 0 ? bassNote.pitchClass : bass;
     const rootNote = typeof root === "string" ? Note.parse(root) : void 0;
-    const data = _chunk3R3QVKY5cjs.makeChord.call(void 0, 
+    const data = _chunkYDGMWH43cjs.makeChord.call(void 0, 
       rootNote !== void 0 ? rootNote.pitchClass : root,
       quality,
       bassPc
@@ -2389,7 +2491,7 @@ var Chord = class _Chord {
    * ```
    */
   static fromFiguredBass(bass, figures, key) {
-    return new _Chord(_chunk76ZBTRG2cjs.realizeFiguredBass.call(void 0, _chunkS5BKZZGMcjs.toNoteData.call(void 0, bass), figures, key));
+    return new _Chord(_chunkU4EQTDGNcjs.realizeFiguredBass.call(void 0, _chunkS3QELJUEcjs.toNoteData.call(void 0, bass), figures, key));
   }
   /**
    * Parse a lead-sheet chord symbol (e.g. `'Cmaj7'`, `'F#m7b5'`, `'C/G'`).
@@ -2412,7 +2514,7 @@ var Chord = class _Chord {
    * ```
    */
   static parse(symbol, opts) {
-    return _chunkS5BKZZGMcjs.unwrapParse.call(void 0, _Chord.tryParse(symbol, opts));
+    return _chunkS3QELJUEcjs.unwrapParse.call(void 0, _Chord.tryParse(symbol, opts));
   }
   /**
    * Parse a lead-sheet chord symbol, reporting failure instead of throwing it.
@@ -2435,7 +2537,7 @@ var Chord = class _Chord {
    * ```
    */
   static tryParse(symbol, opts) {
-    const parsed = _chunk3R3QVKY5cjs.tryParseChordSymbol.call(void 0, symbol, opts);
+    const parsed = _chunkYDGMWH43cjs.tryParseChordSymbol.call(void 0, symbol, opts);
     return parsed.ok ? { ok: true, value: new _Chord(parsed.value) } : parsed;
   }
   /**
@@ -2446,8 +2548,8 @@ var Chord = class _Chord {
    * @returns Ranked chord interpretations (may be empty).
    */
   static detect(pitches, opts) {
-    return _chunkSGLEQVJHcjs.detectChord.call(void 0, pitches, opts).map(
-      (match) => new _Chord(_chunk3R3QVKY5cjs.makeChord.call(void 0, match.rootPc, match.quality, match.bassPc))
+    return _chunkLQZQDBCDcjs.detectChord.call(void 0, pitches, opts).map(
+      (match) => new _Chord(_chunkYDGMWH43cjs.makeChord.call(void 0, match.rootPc, match.quality, match.bassPc))
     );
   }
   /**
@@ -2469,8 +2571,8 @@ var Chord = class _Chord {
    * ```
    */
   static detectMatches(pitches, opts) {
-    return _chunkSGLEQVJHcjs.detectChord.call(void 0, pitches, opts).map((match) => ({
-      chord: new _Chord(_chunk3R3QVKY5cjs.makeChord.call(void 0, match.rootPc, match.quality, match.bassPc)),
+    return _chunkLQZQDBCDcjs.detectChord.call(void 0, pitches, opts).map((match) => ({
+      chord: new _Chord(_chunkYDGMWH43cjs.makeChord.call(void 0, match.rootPc, match.quality, match.bassPc)),
       match
     }));
   }
@@ -2482,7 +2584,7 @@ var Chord = class _Chord {
    * @returns The top-ranked chord, or null when nothing matches.
    */
   static detectBest(pitches, opts) {
-    const best = _chunkSGLEQVJHcjs.detectChordBest.call(void 0, pitches, opts);
+    const best = _chunkLQZQDBCDcjs.detectChordBest.call(void 0, pitches, opts);
     return best === null ? null : new _Chord(best);
   }
   /** The root pitch class (0..11). */
@@ -2526,7 +2628,7 @@ var Chord = class _Chord {
    * ```
    */
   get spec() {
-    return _chunk3R3QVKY5cjs.chordSpecOf.call(void 0, this.#data);
+    return _chunkYDGMWH43cjs.chordSpecOf.call(void 0, this.#data);
   }
   /** The carried key context, if any. */
   get key() {
@@ -2564,7 +2666,7 @@ var Chord = class _Chord {
    * ```
    */
   pitchClasses(opts) {
-    return _chunk3R3QVKY5cjs.chordPitchClasses.call(void 0, this.#data, opts);
+    return _chunkYDGMWH43cjs.chordPitchClasses.call(void 0, this.#data, opts);
   }
   /**
    * Whether a pitch is one of the chord's tones, ignoring octave.
@@ -2582,7 +2684,7 @@ var Chord = class _Chord {
    * ```
    */
   contains(pitch) {
-    return _chunk3R3QVKY5cjs.isChordMember.call(void 0, pitch, this.#data);
+    return _chunkYDGMWH43cjs.isChordMember.call(void 0, pitch, this.#data);
   }
   /**
    * A pitch's harmonic role in the chord: root, third, fifth, sixth, or
@@ -2605,7 +2707,7 @@ var Chord = class _Chord {
    * ```
    */
   roleOf(pitch) {
-    return _chunk3R3QVKY5cjs.chordToneRole.call(void 0, pitch, this.#data);
+    return _chunkYDGMWH43cjs.chordToneRole.call(void 0, pitch, this.#data);
   }
   /**
    * The chord's Roman numeral in a key.
@@ -2617,7 +2719,8 @@ var Chord = class _Chord {
    * @throws If no key is given and none is carried.
    */
   roman(key, opts) {
-    return _chunkSGLEQVJHcjs.chordToRoman.call(void 0, this.#data, this.#resolveKey(key), opts);
+    const resolved = this.#resolveKey(key);
+    return _chunkLQZQDBCDcjs.chordToRoman.call(void 0, this.#dataWithKey(resolved), resolved, opts);
   }
   /**
    * The chord's Roman numeral together with the reasoning behind it: the degree
@@ -2645,7 +2748,8 @@ var Chord = class _Chord {
    * ```
    */
   explain(key, opts) {
-    return _chunkSGLEQVJHcjs.explainRoman.call(void 0, this.#data, this.#resolveKey(key), opts);
+    const resolved = this.#resolveKey(key);
+    return _chunkLQZQDBCDcjs.explainRoman.call(void 0, this.#dataWithKey(resolved), resolved, opts);
   }
   /**
    * The chord's harmonic function (tonic / subdominant / dominant) in a key.
@@ -2656,7 +2760,8 @@ var Chord = class _Chord {
    * @throws If no key is given and none is carried.
    */
   function(key) {
-    return _chunkSGLEQVJHcjs.functionOf.call(void 0, this.#data, this.#resolveKey(key));
+    const resolved = this.#resolveKey(key);
+    return _chunkLQZQDBCDcjs.functionOf.call(void 0, this.#dataWithKey(resolved), resolved);
   }
   /**
    * Full functional analysis: function, borrowing, Roman numeral, and the
@@ -2676,7 +2781,8 @@ var Chord = class _Chord {
    * ```
    */
   analyze(key, opts) {
-    return _chunkSGLEQVJHcjs.analyzeChord.call(void 0, this.#data, this.#resolveKey(key), opts);
+    const resolved = this.#resolveKey(key);
+    return _chunkLQZQDBCDcjs.analyzeChord.call(void 0, this.#dataWithKey(resolved), resolved, opts);
   }
   /**
    * Whether the chord is borrowed from the parallel mode (modal interchange).
@@ -2687,7 +2793,8 @@ var Chord = class _Chord {
    * @throws If no key is given and none is carried.
    */
   isBorrowed(key) {
-    return _chunkSGLEQVJHcjs.isBorrowedChord.call(void 0, this.#data, this.#resolveKey(key));
+    const resolved = this.#resolveKey(key);
+    return _chunkLQZQDBCDcjs.isBorrowedChord.call(void 0, this.#dataWithKey(resolved), resolved);
   }
   /**
    * The origin of a non-diatonic chord (parallel mode or Neapolitan), or null.
@@ -2698,7 +2805,8 @@ var Chord = class _Chord {
    * @throws If no key is given and none is carried.
    */
   borrowedSource(key) {
-    return _chunkSGLEQVJHcjs.borrowedSource.call(void 0, this.#data, this.#resolveKey(key));
+    const resolved = this.#resolveKey(key);
+    return _chunkLQZQDBCDcjs.borrowedSource.call(void 0, this.#dataWithKey(resolved), resolved);
   }
   /**
    * The chord written as the figures a bass would carry under it: `6`, `64`,
@@ -2723,7 +2831,8 @@ var Chord = class _Chord {
    * ```
    */
   figuredBass(key) {
-    return _chunk76ZBTRG2cjs.figuredBassOf.call(void 0, this.#data, this.#resolveKey(key));
+    const resolved = this.#resolveKey(key);
+    return _chunkU4EQTDGNcjs.figuredBassOf.call(void 0, this.#dataWithKey(resolved), resolved);
   }
   /**
    * The chords that can stand in for this one in a key: its tritone substitute,
@@ -2750,7 +2859,8 @@ var Chord = class _Chord {
    * ```
    */
   substitutions(key, opts) {
-    return _chunkJ7FHVZIIcjs.substituteChord.call(void 0, this.#data, this.#resolveKey(key), opts);
+    const resolved = this.#resolveKey(key);
+    return _chunk6TTBEON3cjs.substituteChord.call(void 0, this.#dataWithKey(resolved), resolved, opts);
   }
   /**
    * The modal-interchange palette of the chord's key: the parallel mode's
@@ -2775,7 +2885,7 @@ var Chord = class _Chord {
    * ```
    */
   modalInterchange(key) {
-    return _chunkJ7FHVZIIcjs.modalInterchangePalette.call(void 0, this.#resolveKey(key));
+    return _chunk6TTBEON3cjs.modalInterchangePalette.call(void 0, this.#resolveKey(key));
   }
   /**
    * The chord rendered as a lead-sheet symbol (e.g. `'Cmaj7'`, `'F#m7'`, `'C/G'`).
@@ -2790,7 +2900,7 @@ var Chord = class _Chord {
    * ```
    */
   symbol(opts) {
-    return _chunk3R3QVKY5cjs.formatChordSymbol.call(void 0, this.#data, opts);
+    return _chunkYDGMWH43cjs.formatChordSymbol.call(void 0, this.#data, opts);
   }
   /**
    * Realize the chord as one MIDI pitch per voice, ascending.
@@ -2804,7 +2914,8 @@ var Chord = class _Chord {
    */
   voice(opts) {
     const key = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _24 => _24.key]), () => ( this.#key));
-    return _chunk76ZBTRG2cjs.voiceChord.call(void 0, this.#data, key === void 0 ? opts : { ...opts, key });
+    const data = _optionalChain([opts, 'optionalAccess', _25 => _25.key]) === void 0 ? this.#data : this.#dataWithKey(toKey(opts.key));
+    return _chunkU4EQTDGNcjs.voiceChord.call(void 0, data, key === void 0 ? opts : { ...opts, key });
   }
   /**
    * Realize the chord as a single styled voicing (`close`, `drop2`, `drop3`,
@@ -2814,7 +2925,7 @@ var Chord = class _Chord {
    * @returns MIDI pitches, ascending.
    */
   styledVoicing(opts) {
-    return _chunk76ZBTRG2cjs.voiceChordStyled.call(void 0, this.#data, opts);
+    return _chunkU4EQTDGNcjs.voiceChordStyled.call(void 0, this.#data, opts);
   }
   /**
    * The negative-harmony mirror of the chord about the key's tonic–dominant
@@ -2827,7 +2938,7 @@ var Chord = class _Chord {
    */
   negativeHarmony(key) {
     const resolved = this.#resolveKey(key);
-    return new _Chord(_chunkJ7FHVZIIcjs.negativeHarmonyMirror.call(void 0, this.#data, resolved), resolved);
+    return new _Chord(_chunk6TTBEON3cjs.negativeHarmonyMirror.call(void 0, this.#dataWithKey(resolved), resolved), resolved);
   }
   /**
    * The V7 that tonicizes this chord: a dominant seventh a perfect fifth above
@@ -2845,7 +2956,7 @@ var Chord = class _Chord {
    * ```
    */
   secondaryDominant() {
-    return new _Chord(_chunkSGLEQVJHcjs.secondaryDominantOf.call(void 0, this.#given), this.#key);
+    return new _Chord(_chunkLQZQDBCDcjs.secondaryDominantOf.call(void 0, this.#given), this.#key);
   }
   /**
    * The n-th inversion: a copy whose bass is the chord tone `n` steps above the
@@ -2864,14 +2975,14 @@ var Chord = class _Chord {
     const intervals = data.intervals;
     const length = intervals.length;
     if (length === 0) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)("cannot invert a chord with no intervals");
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)("cannot invert a chord with no intervals");
     }
     const index = (n % length + length) % length;
     delete data.bassSpelling;
     if (index === 0) {
       delete data.bassPc;
     } else {
-      data.bassPc = _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, data.rootPc + (_nullishCoalesce(intervals[index], () => ( 0))));
+      data.bassPc = _chunkS3QELJUEcjs.pitchClassOf.call(void 0, data.rootPc + (_nullishCoalesce(intervals[index], () => ( 0))));
     }
     return new _Chord(data, this.#key);
   }
@@ -2892,8 +3003,8 @@ var Chord = class _Chord {
    * ```
    */
   transpose(semitones) {
-    const moved = _chunk3R3QVKY5cjs.transposeChord.call(void 0, this.#given, semitones);
-    const { rootSpelling, bassSpelling, toneSpellings } = _chunk3R3QVKY5cjs.transposeChordSpellings.call(void 0, 
+    const moved = _chunkYDGMWH43cjs.transposeChord.call(void 0, this.#given, semitones);
+    const { rootSpelling, bassSpelling, toneSpellings } = _chunkYDGMWH43cjs.transposeChordSpellings.call(void 0, 
       this.#given,
       semitones
     );
@@ -2906,7 +3017,7 @@ var Chord = class _Chord {
     if (toneSpellings !== void 0) {
       moved.toneSpellings = toneSpellings;
     }
-    return new _Chord(moved, _optionalChain([this, 'access', _25 => _25.#key, 'optionalAccess', _26 => _26.transpose, 'call', _27 => _27(semitones)]));
+    return new _Chord(moved, _optionalChain([this, 'access', _26 => _26.#key, 'optionalAccess', _27 => _27.transpose, 'call', _28 => _28(semitones)]));
   }
   /**
    * Transpose the chord by a spelled interval.
@@ -2928,8 +3039,8 @@ var Chord = class _Chord {
    * ```
    */
   transposeBy(interval) {
-    const spelled = _chunkS5BKZZGMcjs.toSpelledInterval.call(void 0, interval);
-    const moved = _chunk3R3QVKY5cjs.transposeChord.call(void 0, this.#given, spelled.semitones);
+    const spelled = _chunkS3QELJUEcjs.toSpelledInterval.call(void 0, interval);
+    const moved = _chunkYDGMWH43cjs.transposeChord.call(void 0, this.#given, spelled.semitones);
     const rootSpelling = transposeHintByInterval(this.#given.rootSpelling, spelled);
     const bassSpelling = transposeHintByInterval(this.#given.bassSpelling, spelled);
     const toneSpellings = transposeToneHintsByInterval(this.#given.toneSpellings, spelled);
@@ -2942,7 +3053,7 @@ var Chord = class _Chord {
     if (toneSpellings !== void 0) {
       moved.toneSpellings = toneSpellings;
     }
-    return new _Chord(moved, _optionalChain([this, 'access', _28 => _28.#key, 'optionalAccess', _29 => _29.transposeBy, 'call', _30 => _30(spelled)]));
+    return new _Chord(moved, _optionalChain([this, 'access', _29 => _29.#key, 'optionalAccess', _30 => _30.transposeBy, 'call', _31 => _31(spelled)]));
   }
   /**
    * The named scales that fit over this chord, best fit first, rooted on the
@@ -2955,7 +3066,7 @@ var Chord = class _Chord {
    * @returns The matching scales.
    */
   scales() {
-    return _chunkPM4XJE2Ycjs.chordScales.call(void 0, this.#data);
+    return _chunkP3CPXAJ5cjs.chordScales.call(void 0, this.#data);
   }
   /**
    * The scales that fit over this chord, each with the tones it does not state
@@ -2977,7 +3088,7 @@ var Chord = class _Chord {
    * ```
    */
   scaleReport(limit) {
-    return _chunkPM4XJE2Ycjs.chordScaleReport.call(void 0, this.#data, limit);
+    return _chunkP3CPXAJ5cjs.chordScaleReport.call(void 0, this.#data, limit);
   }
   /**
    * The available tensions (usable non-chord, non-avoid scale tones) of a
@@ -3002,7 +3113,7 @@ var Chord = class _Chord {
    * ```
    */
   tensions(scaleName, opts) {
-    return _chunkPM4XJE2Ycjs.availableTensions.call(void 0, this.#data, scaleName, opts);
+    return _chunkP3CPXAJ5cjs.availableTensions.call(void 0, this.#data, scaleName, opts);
   }
   /**
    * The avoid notes (scale tones a semitone above a chord tone) of a scale
@@ -3026,7 +3137,7 @@ var Chord = class _Chord {
    * ```
    */
   avoidNotes(scaleName, opts) {
-    return _chunkPM4XJE2Ycjs.avoidNotes.call(void 0, this.#data, scaleName, opts);
+    return _chunkP3CPXAJ5cjs.avoidNotes.call(void 0, this.#data, scaleName, opts);
   }
   /**
    * Spell the chord tones with letter names, root first, in the key's spelling.
@@ -3057,17 +3168,17 @@ var Chord = class _Chord {
     if (resolved === void 0) {
       const root = data.rootSpelling;
       if (root === void 0) {
-        throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+        throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
           "chord has no key context and no root spelling; pass a Key, attach one with withKey(), or build the chord from a symbol"
         );
       }
-      tones = _chunk3R3QVKY5cjs.spellChordFromRoot.call(void 0, data, root);
+      tones = _chunkYDGMWH43cjs.spellChordFromRoot.call(void 0, data, root);
     } else {
-      tones = _chunk3R3QVKY5cjs.spellChord.call(void 0, data, resolved.tonic.data, resolved);
+      tones = _chunkYDGMWH43cjs.spellChord.call(void 0, data, resolved.tonic.data, resolved);
     }
     const bassPc = data.bassPc;
     const bass = data.bassSpelling;
-    if (bassPc !== void 0 && bass !== void 0 && !tones.some((tone) => _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, _chunkS5BKZZGMcjs.noteToPitchClass.call(void 0, tone)) === _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, bassPc))) {
+    if (bassPc !== void 0 && bass !== void 0 && !tones.some((tone) => _chunkS3QELJUEcjs.pitchClassOf.call(void 0, _chunkS3QELJUEcjs.noteToPitchClass.call(void 0, tone)) === _chunkS3QELJUEcjs.pitchClassOf.call(void 0, bassPc))) {
       tones = [...tones, { letter: bass.letter, alter: bass.alter }];
     }
     return tones.map((note) => new Note(note));
@@ -3101,7 +3212,7 @@ var Chord = class _Chord {
    * ```
    */
   span(startBeat) {
-    return _chunk3R3QVKY5cjs.spanFromChord.call(void 0, this.#data, startBeat);
+    return _chunkYDGMWH43cjs.spanFromChord.call(void 0, this.#data, startBeat);
   }
   /**
    * Whether another chord has the same root, quality, intervals, and bass.
@@ -3141,7 +3252,7 @@ var Chord = class _Chord {
     assertKeyArgument(key, "chord key");
     const resolved = key === void 0 ? this.#key : toKey(key);
     if (resolved === void 0) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         "chord has no key context; pass a Key or attach one with withKey()"
       );
     }
@@ -3151,11 +3262,11 @@ var Chord = class _Chord {
 
 // src/model/key.ts
 function detectedKeyMatch(match) {
-  const key = { ..._chunk3R3QVKY5cjs.resolveKey.call(void 0, match.key), variant: match.variant };
+  const key = { ..._chunkYDGMWH43cjs.resolveKey.call(void 0, match.key), variant: match.variant };
   return { ...match, key: toKey(key) };
 }
 function scaleWord(mask, isMinor) {
-  const name = _chunk3R3QVKY5cjs.scaleNameOfMask.call(void 0, mask);
+  const name = _chunkYDGMWH43cjs.scaleNameOfMask.call(void 0, mask);
   if (name === void 0) {
     return isMinor ? "minor" : "major";
   }
@@ -3170,13 +3281,13 @@ function scaleWord(mask, isMinor) {
 var HEPTATONIC_DEGREES = 7;
 var REFERENCE_TONIC = { letter: 0, alter: 0 };
 function bareInterval(from, to) {
-  return _chunkS5BKZZGMcjs.spelledInterval.call(void 0, 
+  return _chunkS3QELJUEcjs.spelledInterval.call(void 0, 
     { letter: from.letter, alter: from.alter },
     { letter: to.letter, alter: to.alter }
   );
 }
 function spelledTonicFor(scale) {
-  return new Note(_chunk3R3QVKY5cjs.resolveKey.call(void 0, scale).tonic);
+  return new Note(_chunkYDGMWH43cjs.resolveKey.call(void 0, scale).tonic);
 }
 function isNoteInstance(value) {
   if (value === null || typeof value !== "object") {
@@ -3207,28 +3318,29 @@ var Key = class _Key {
    */
   constructor(scale, tonic, variant) {
     assertDataObject(scale, "scale");
-    _chunkS5BKZZGMcjs.assertInteger.call(void 0, scale.rootPc, "scale.rootPc");
-    _chunkS5BKZZGMcjs.assertInteger.call(void 0, scale.modeMask12, "scale.modeMask12", 1, 4095);
+    _chunkS3QELJUEcjs.assertInteger.call(void 0, scale.rootPc, "scale.rootPc");
+    _chunkS3QELJUEcjs.assertInteger.call(void 0, scale.modeMask12, "scale.modeMask12", 1, 4095);
     if ((scale.modeMask12 & 1) === 0) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)("scale.modeMask12 must include the tonic (bit 0)");
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)("scale.modeMask12 must include the tonic (bit 0)");
     }
     if (!isNoteInstance(tonic)) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         `tonic must be the class API's Note; received ${describeTonic(tonic)}; wrap plain note data with Note.fromData, or omit the tonic to have one chosen`
       );
     }
-    const rootPc = _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, scale.rootPc);
-    if (tonic.pitchClass !== rootPc) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
-        `tonic ${tonic.name} does not match the scale root pitch class ${rootPc}; pass a tonic that spells the scale root, or omit it to have one chosen`
+    const note = tonic instanceof Note ? tonic : new Note(tonic.data);
+    const rootPc = _chunkS3QELJUEcjs.pitchClassOf.call(void 0, scale.rootPc);
+    if (note.pitchClass !== rootPc) {
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+        `tonic ${note.name} does not match the scale root pitch class ${rootPc}; pass a tonic that spells the scale root, or omit it to have one chosen`
       );
     }
     if (variant !== void 0) {
-      _chunk3R3QVKY5cjs.assertKeyVariant.call(void 0, variant, scale.modeMask12);
+      _chunkYDGMWH43cjs.assertKeyVariant.call(void 0, variant, scale.modeMask12);
     }
     this.#scale = { rootPc, modeMask12: scale.modeMask12 };
-    this.#tonic = tonic;
-    this.#variant = _nullishCoalesce(variant, () => ( _chunk3R3QVKY5cjs.variantOfMask.call(void 0, scale.modeMask12)));
+    this.#tonic = note;
+    this.#variant = _nullishCoalesce(variant, () => ( _chunkYDGMWH43cjs.variantOfMask.call(void 0, scale.modeMask12)));
   }
   /** Preserve detection metadata while replacing its plain key with this API's Key. */
   static #fromMatch(match) {
@@ -3255,9 +3367,9 @@ var Key = class _Key {
   static major(root) {
     if (typeof root === "string") {
       const tonic = Note.parse(root);
-      return new _Key(_chunk3R3QVKY5cjs.majorKey.call(void 0, tonic.pitchClass), tonic);
+      return new _Key(_chunkYDGMWH43cjs.majorKey.call(void 0, tonic.pitchClass), tonic);
     }
-    const scale = _chunk3R3QVKY5cjs.majorKey.call(void 0, root);
+    const scale = _chunkYDGMWH43cjs.majorKey.call(void 0, root);
     return new _Key(scale, spelledTonicFor(scale));
   }
   /**
@@ -3271,9 +3383,9 @@ var Key = class _Key {
   static minor(root) {
     if (typeof root === "string") {
       const tonic = Note.parse(root);
-      return new _Key(_chunk3R3QVKY5cjs.minorKey.call(void 0, tonic.pitchClass), tonic);
+      return new _Key(_chunkYDGMWH43cjs.minorKey.call(void 0, tonic.pitchClass), tonic);
     }
-    const scale = _chunk3R3QVKY5cjs.minorKey.call(void 0, root);
+    const scale = _chunkYDGMWH43cjs.minorKey.call(void 0, root);
     return new _Key(scale, spelledTonicFor(scale));
   }
   /**
@@ -3289,9 +3401,9 @@ var Key = class _Key {
   static named(name, root) {
     if (typeof root === "string") {
       const tonic = Note.parse(root);
-      return new _Key(_chunk3R3QVKY5cjs.scaleByName.call(void 0, name, tonic.pitchClass), tonic);
+      return new _Key(_chunkYDGMWH43cjs.scaleByName.call(void 0, name, tonic.pitchClass), tonic);
     }
-    const scale = _chunk3R3QVKY5cjs.scaleByName.call(void 0, name, _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, root));
+    const scale = _chunkYDGMWH43cjs.scaleByName.call(void 0, name, _chunkS3QELJUEcjs.pitchClassOf.call(void 0, root));
     return new _Key(scale, spelledTonicFor(scale));
   }
   /**
@@ -3326,7 +3438,7 @@ var Key = class _Key {
    * ```
    */
   static parse(text, opts) {
-    return _chunkS5BKZZGMcjs.unwrapParse.call(void 0, _Key.tryParse(text, opts));
+    return _chunkS3QELJUEcjs.unwrapParse.call(void 0, _Key.tryParse(text, opts));
   }
   /**
    * Parse a key name, reporting failure instead of throwing it.
@@ -3348,7 +3460,7 @@ var Key = class _Key {
    * ```
    */
   static tryParse(text, opts) {
-    const parsed = _chunk3R3QVKY5cjs.tryResolveKeyName.call(void 0, text, opts);
+    const parsed = _chunkYDGMWH43cjs.tryResolveKeyName.call(void 0, text, opts);
     return parsed.ok ? {
       ok: true,
       value: new _Key(parsed.value.scale, new Note(parsed.value.tonic), parsed.value.variant)
@@ -3375,7 +3487,7 @@ var Key = class _Key {
    * ```
    */
   static fromFifths(fifths, mode = "major") {
-    return _Key.#fromSpelled(_chunk3R3QVKY5cjs.keyFromFifths.call(void 0, fifths, mode));
+    return _Key.#fromSpelled(_chunkYDGMWH43cjs.keyFromFifths.call(void 0, fifths, mode));
   }
   /**
    * Wrap an existing `KeyScale`, synthesizing a spelled tonic when none is
@@ -3398,7 +3510,7 @@ var Key = class _Key {
    * @throws If the given tonic is not the scale's root pitch class.
    */
   static of(key, tonic) {
-    const resolved = _chunk3R3QVKY5cjs.resolveKey.call(void 0, key);
+    const resolved = _chunkYDGMWH43cjs.resolveKey.call(void 0, key);
     return new _Key(resolved.scale, _nullishCoalesce(tonic, () => ( new Note(resolved.tonic))), resolved.variant);
   }
   /**
@@ -3440,7 +3552,7 @@ var Key = class _Key {
    * @returns Ranked key matches (may be empty).
    */
   static detectMatches(pitches, opts) {
-    return _chunkSGLEQVJHcjs.detectKey.call(void 0, pitches, opts).map((match) => _Key.#fromMatch(match));
+    return _chunkLQZQDBCDcjs.detectKey.call(void 0, pitches, opts).map((match) => _Key.#fromMatch(match));
   }
   /**
    * The single best key interpretation of a pitch set.
@@ -3455,7 +3567,7 @@ var Key = class _Key {
    * ```
    */
   static detectBest(pitches, opts) {
-    const best = _chunkSGLEQVJHcjs.detectKeyBest.call(void 0, pitches, opts);
+    const best = _chunkLQZQDBCDcjs.detectKeyBest.call(void 0, pitches, opts);
     return best === null ? null : _Key.#fromMatch(best).key;
   }
   /**
@@ -3485,7 +3597,7 @@ var Key = class _Key {
   }
   /** Whether the scale has a minor third and no major third. */
   get isMinor() {
-    return _chunkSGLEQVJHcjs.isMinorKey.call(void 0, this.#scale);
+    return _chunkLQZQDBCDcjs.isMinorKey.call(void 0, this.#scale);
   }
   /**
    * The key signature as a signed count of sharps (positive) or flats
@@ -3503,7 +3615,7 @@ var Key = class _Key {
    * ```
    */
   get fifths() {
-    return _chunk3R3QVKY5cjs.keySignatureFifths.call(void 0, this.#tonic.data, this.#scale);
+    return _chunkYDGMWH43cjs.keySignatureFifths.call(void 0, this.#tonic.data, this.#scale);
   }
   /**
    * The built-in scale this key's mode mask is, or undefined when no built-in
@@ -3527,13 +3639,13 @@ var Key = class _Key {
    */
   get scaleName() {
     const mask = this.#scale.modeMask12;
-    return Object.keys(_chunk3R3QVKY5cjs.NAMED_SCALES).find((name) => _chunk3R3QVKY5cjs.NAMED_SCALES[name] === mask);
+    return Object.keys(_chunkYDGMWH43cjs.NAMED_SCALES).find((name) => _chunkYDGMWH43cjs.NAMED_SCALES[name] === mask);
   }
   /** A copy of the underlying plain key data. */
   get data() {
     return this.toJSON();
   }
-  /** The detected scale form, when this key came from key detection. */
+  /** The scale form this key stands in: natural, harmonic or melodic, read from the mask unless named. */
   get variant() {
     return this.#variant;
   }
@@ -3559,8 +3671,8 @@ var Key = class _Key {
    * ```
    */
   pitchClasses(opts) {
-    const order = _optionalChain([opts, 'optionalAccess', _31 => _31.order]) === void 0 ? "degree" : _chunkS5BKZZGMcjs.assertOneOf.call(void 0, opts.order, ["degree", "ascending"], "pitch-class order");
-    return order === "ascending" ? _chunk3R3QVKY5cjs.diatonicPitchClasses.call(void 0, this.#scale) : _chunk3R3QVKY5cjs.scaleTonesInDegreeOrder.call(void 0, this.#scale);
+    const order = _optionalChain([opts, 'optionalAccess', _32 => _32.order]) === void 0 ? "degree" : _chunkS3QELJUEcjs.assertOneOf.call(void 0, opts.order, ["degree", "ascending"], "pitch-class order");
+    return order === "ascending" ? _chunkYDGMWH43cjs.diatonicPitchClasses.call(void 0, this.#scale) : _chunkYDGMWH43cjs.scaleTonesInDegreeOrder.call(void 0, this.#scale);
   }
   /**
    * The kind of pitch organisation this key's scale belongs to: the
@@ -3584,7 +3696,7 @@ var Key = class _Key {
    * ```
    */
   system() {
-    return _chunk3R3QVKY5cjs.scaleSystemOf.call(void 0, this.#scale);
+    return _chunkYDGMWH43cjs.scaleSystemOf.call(void 0, this.#scale);
   }
   /**
    * Whether functional (Roman-numeral) analysis describes this key.
@@ -3604,7 +3716,7 @@ var Key = class _Key {
    * ```
    */
   supportsFunctionalHarmony() {
-    return _chunk3R3QVKY5cjs.supportsFunctionalHarmony.call(void 0, this.#scale);
+    return _chunkYDGMWH43cjs.supportsFunctionalHarmony.call(void 0, this.#scale);
   }
   /**
    * The relative key: for a plain major or minor key, the same key signature
@@ -3628,7 +3740,7 @@ var Key = class _Key {
    * ```
    */
   relative() {
-    return _Key.#fromSpelled(_chunk3R3QVKY5cjs.relativeKeyOf.call(void 0, this.#tonic.data, this.#scale));
+    return _Key.#fromSpelled(_chunkYDGMWH43cjs.relativeKeyOf.call(void 0, this.#tonic.data, this.#scale));
   }
   /**
    * The parallel key: the other mode on the same tonic, which keeps this key's
@@ -3642,7 +3754,7 @@ var Key = class _Key {
    * ```
    */
   parallel() {
-    return _Key.#fromSpelled(_chunk3R3QVKY5cjs.parallelKeyOf.call(void 0, this.#tonic.data, this.#scale));
+    return _Key.#fromSpelled(_chunkYDGMWH43cjs.parallelKeyOf.call(void 0, this.#tonic.data, this.#scale));
   }
   /**
    * The dominant key: the key a fifth above, in the mode this key's third names.
@@ -3659,7 +3771,7 @@ var Key = class _Key {
    * ```
    */
   dominantKey() {
-    return _Key.#fromSpelled(_chunk3R3QVKY5cjs.dominantKeyOf.call(void 0, this.#tonic.data, this.#scale));
+    return _Key.#fromSpelled(_chunkYDGMWH43cjs.dominantKeyOf.call(void 0, this.#tonic.data, this.#scale));
   }
   /**
    * The subdominant key: the key a fifth below, in the mode this key's third
@@ -3675,7 +3787,7 @@ var Key = class _Key {
    * ```
    */
   subdominantKey() {
-    return _Key.#fromSpelled(_chunk3R3QVKY5cjs.subdominantKeyOf.call(void 0, this.#tonic.data, this.#scale));
+    return _Key.#fromSpelled(_chunkYDGMWH43cjs.subdominantKeyOf.call(void 0, this.#tonic.data, this.#scale));
   }
   /**
    * The same sounding key written the other way round the circle of fifths.
@@ -3693,7 +3805,7 @@ var Key = class _Key {
    * ```
    */
   enharmonic() {
-    const other = _chunk3R3QVKY5cjs.enharmonicKeyOf.call(void 0, this.#tonic.data, this.#scale);
+    const other = _chunkYDGMWH43cjs.enharmonicKeyOf.call(void 0, this.#tonic.data, this.#scale);
     return other === null ? null : _Key.#fromSpelled(other);
   }
   /**
@@ -3724,7 +3836,7 @@ var Key = class _Key {
    * ```
    */
   relatedKeys() {
-    return _chunk3R3QVKY5cjs.relatedKeysOf.call(void 0, this.#tonic.data, this.#scale).map(({ relation, ...spelled }) => ({
+    return _chunkYDGMWH43cjs.relatedKeysOf.call(void 0, this.#tonic.data, this.#scale).map(({ relation, ...spelled }) => ({
       relation,
       key: _Key.#fromSpelled(spelled)
     }));
@@ -3751,7 +3863,7 @@ var Key = class _Key {
    * ```
    */
   relationTo(other) {
-    return _chunk3R3QVKY5cjs.keyRelationBetween.call(void 0, this.toJSON(), other.toJSON());
+    return _chunkYDGMWH43cjs.keyRelationBetween.call(void 0, this.toJSON(), other.toJSON());
   }
   /**
    * The chords a modulation from this key into another can pivot on.
@@ -3778,7 +3890,7 @@ var Key = class _Key {
    */
   pivotsTo(other) {
     assertKeyArgument(other, "key");
-    return _chunkSGLEQVJHcjs.pivotChords.call(void 0, this.#scale, other).map(({ chord, romanFrom, romanTo }) => ({
+    return _chunkLQZQDBCDcjs.pivotChords.call(void 0, this, _chunkYDGMWH43cjs.resolveKey.call(void 0, other)).map(({ chord, romanFrom, romanTo }) => ({
       chord: new Chord(chord, this),
       romanFrom,
       romanTo
@@ -3800,7 +3912,7 @@ var Key = class _Key {
    */
   degree(n) {
     const notes = this.notes();
-    _chunkS5BKZZGMcjs.assertInteger.call(void 0, n, "degree", 1, notes.length);
+    _chunkS3QELJUEcjs.assertInteger.call(void 0, n, "degree", 1, notes.length);
     return _nullishCoalesce(notes[n - 1], () => ( this.#tonic));
   }
   /**
@@ -3851,12 +3963,12 @@ var Key = class _Key {
    */
   keyHavingTonicAsDegree(n, mode) {
     const resolved = _nullishCoalesce(mode, () => ( (this.isMinor ? "minor" : "major")));
-    const reference = _chunk3R3QVKY5cjs.spellScale.call(void 0, REFERENCE_TONIC, resolved === "minor" ? _chunk3R3QVKY5cjs.minorKey.call(void 0, 0) : _chunk3R3QVKY5cjs.majorKey.call(void 0, 0));
-    _chunkS5BKZZGMcjs.assertInteger.call(void 0, n, "degree", 1, reference.length);
+    const reference = _chunkYDGMWH43cjs.spellScale.call(void 0, REFERENCE_TONIC, resolved === "minor" ? _chunkYDGMWH43cjs.minorKey.call(void 0, 0) : _chunkYDGMWH43cjs.majorKey.call(void 0, 0));
+    _chunkS3QELJUEcjs.assertInteger.call(void 0, n, "degree", 1, reference.length);
     const first = reference[0];
-    const step = _chunkS5BKZZGMcjs.spelledInterval.call(void 0, first, reference[n - 1]);
+    const step = _chunkS3QELJUEcjs.spelledInterval.call(void 0, first, reference[n - 1]);
     const tonic = new Note(
-      _chunkS5BKZZGMcjs.transposeByInterval.call(void 0, this.#tonic.data, {
+      _chunkS3QELJUEcjs.transposeByInterval.call(void 0, this.#tonic.data, {
         number: step.number,
         quality: step.quality,
         // Negating a zero span yields -0, which compares unequal to 0.
@@ -3876,7 +3988,7 @@ var Key = class _Key {
    */
   static #modeOn(mode, tonic) {
     const rootPc = tonic.pitchClass;
-    return new _Key(mode === "minor" ? _chunk3R3QVKY5cjs.minorKey.call(void 0, rootPc) : _chunk3R3QVKY5cjs.majorKey.call(void 0, rootPc), tonic).#asWritten();
+    return new _Key(mode === "minor" ? _chunkYDGMWH43cjs.minorKey.call(void 0, rootPc) : _chunkYDGMWH43cjs.majorKey.call(void 0, rootPc), tonic).#asWritten();
   }
   /**
    * The mode a scale degree implies, read off its diatonic triad. Scales that
@@ -3887,7 +3999,7 @@ var Key = class _Key {
     if (this.pitchClasses().length !== HEPTATONIC_DEGREES) {
       return this.isMinor ? "minor" : "major";
     }
-    const { quality } = _chunk3R3QVKY5cjs.diatonicTriad.call(void 0, n, this.#scale);
+    const { quality } = _chunkYDGMWH43cjs.diatonicTriad.call(void 0, n, this);
     return quality === "min" || quality === "dim" ? "minor" : "major";
   }
   /**
@@ -3896,7 +4008,7 @@ var Key = class _Key {
    *
    * Unlike {@link Key.transpose}, which picks a letter from the semitone count,
    * the interval's diatonic number decides the tonic's letter: G# minor down an
-   * augmented fourth is D minor, while down a diminished fifth it is Dbb minor.
+   * augmented fourth is D minor, while down a diminished fifth it is C## minor.
    * The mode mask is unchanged, so the scale keeps its shape.
    *
    * @param interval The interval to apply, as a name (`'A4'`, `'-A4'`), plain
@@ -3911,10 +4023,10 @@ var Key = class _Key {
    * ```
    */
   transposeBy(interval) {
-    const step = _chunkS5BKZZGMcjs.toSpelledInterval.call(void 0, interval);
+    const step = _chunkS3QELJUEcjs.toSpelledInterval.call(void 0, interval);
     return new _Key(
-      { rootPc: _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, this.#scale.rootPc + step.semitones), modeMask12: this.#scale.modeMask12 },
-      new Note(_chunkS5BKZZGMcjs.transposeByInterval.call(void 0, this.#tonic.data, step)),
+      { rootPc: _chunkS3QELJUEcjs.pitchClassOf.call(void 0, this.#scale.rootPc + step.semitones), modeMask12: this.#scale.modeMask12 },
+      new Note(_chunkS3QELJUEcjs.transposeByInterval.call(void 0, this.#tonic.data, step)),
       this.#variant
     );
   }
@@ -3962,8 +4074,8 @@ var Key = class _Key {
    * ```
    */
   transpose(semitones) {
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, semitones, "semitones");
-    const rootPc = _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, this.#scale.rootPc + Math.round(semitones));
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, semitones, "semitones");
+    const rootPc = _chunkS3QELJUEcjs.pitchClassOf.call(void 0, this.#scale.rootPc + Math.round(semitones));
     const scale = { rootPc, modeMask12: this.#scale.modeMask12 };
     return new _Key(scale, this.#tonic.transpose(semitones), this.#variant).#asWritten();
   }
@@ -3987,9 +4099,9 @@ var Key = class _Key {
     if (this.#isWritten()) {
       return this;
     }
-    const other = _chunk3R3QVKY5cjs.enharmonicKeyOf.call(void 0, this.#tonic.data, this.#scale);
+    const other = _chunkYDGMWH43cjs.enharmonicKeyOf.call(void 0, this.#tonic.data, this.#scale);
     const respelled = other === null ? null : new Note(other.tonic);
-    return respelled === null || respelled.pitchClass !== _chunkS5BKZZGMcjs.pitchClassOf.call(void 0, this.#scale.rootPc) ? this : new _Key(this.#scale, respelled, this.#variant);
+    return respelled === null || respelled.pitchClass !== _chunkS3QELJUEcjs.pitchClassOf.call(void 0, this.#scale.rootPc) ? this : new _Key(this.#scale, respelled, this.#variant);
   }
   /**
    * Whether this key is spelled the way keys are actually written, which is
@@ -4003,7 +4115,7 @@ var Key = class _Key {
    * drawn from the mode itself disagree.
    */
   #isWritten() {
-    return _chunk3R3QVKY5cjs.isWrittenTonic.call(void 0, this.#tonic.data, this.#scale);
+    return _chunkYDGMWH43cjs.isWrittenTonic.call(void 0, this.#tonic.data, this.#scale);
   }
   /**
    * The key a transposing instrument's part is written in, for this key at
@@ -4039,7 +4151,7 @@ var Key = class _Key {
    * ```
    */
   forInstrument(instrument) {
-    const tonic = new Note(_chunk76ZBTRG2cjs.toWrittenPitch.call(void 0, this.#tonic.data, instrument));
+    const tonic = new Note(_chunkU4EQTDGNcjs.toWrittenPitch.call(void 0, this.#tonic.data, instrument));
     return new _Key(
       { rootPc: tonic.pitchClass, modeMask12: this.#scale.modeMask12 },
       tonic,
@@ -4052,7 +4164,7 @@ var Key = class _Key {
    * @returns Spelled octave-less notes in scale-degree order.
    */
   notes() {
-    return _chunk3R3QVKY5cjs.spellScale.call(void 0, this.#tonic.data, this.#scale).map((note) => new Note(note));
+    return _chunkYDGMWH43cjs.spellScale.call(void 0, this.#tonic.data, this.#scale).map((note) => new Note(note));
   }
   /**
    * Alias of {@link Key.notes}.
@@ -4106,8 +4218,17 @@ var Key = class _Key {
    * ```
    */
   spellPitchClasses(pcs, tonic) {
-    const anchor = tonic === void 0 ? this.#tonic.data : _chunkS5BKZZGMcjs.toNoteData.call(void 0, tonic);
-    return _chunk3R3QVKY5cjs.spellPitchClasses.call(void 0, [...pcs], anchor, this.#scale).map((note) => new Note(note));
+    const anchor = tonic === void 0 ? this.#tonic.data : _chunkS3QELJUEcjs.toNoteData.call(void 0, tonic);
+    return _chunkYDGMWH43cjs.spellPitchClasses.call(void 0, [...pcs], anchor, this.#scale).map((note) => new Note(note));
+  }
+  /**
+   * A degree chord without the spelling its builder attached.
+   *
+   * The chord carries this key, which spells its root on read, so a chord
+   * re-keyed later follows its new key instead of keeping these letters.
+   */
+  #withoutSpelling(chord) {
+    return _chunkYDGMWH43cjs.makeChord.call(void 0, chord.rootPc, chord.quality);
   }
   /**
    * Build a chord on a scale degree, carrying this key as context.
@@ -4126,8 +4247,8 @@ var Key = class _Key {
    *   an explicit `quality` for those.
    */
   chord(degree, quality) {
-    const data = quality === void 0 ? _chunk3R3QVKY5cjs.diatonicTriad.call(void 0, degree, this.#scale) : _chunk3R3QVKY5cjs.chordFromDegree.call(void 0, degree, quality, this.#scale);
-    return new Chord(data, this);
+    const data = quality === void 0 ? _chunkYDGMWH43cjs.diatonicTriad.call(void 0, degree, this) : _chunkYDGMWH43cjs.chordFromDegree.call(void 0, degree, quality, this);
+    return new Chord(this.#withoutSpelling(data), this);
   }
   /**
    * The diatonic triad on a scale degree, carrying this key as context.
@@ -4139,7 +4260,7 @@ var Key = class _Key {
    *   degrees. Use {@link Key.chord} with an explicit quality instead.
    */
   diatonicTriad(degree) {
-    return new Chord(_chunk3R3QVKY5cjs.diatonicTriad.call(void 0, degree, this.#scale), this);
+    return new Chord(this.#withoutSpelling(_chunkYDGMWH43cjs.diatonicTriad.call(void 0, degree, this)), this);
   }
   /**
    * The diatonic seventh chord on a scale degree, carrying this key as context.
@@ -4151,7 +4272,7 @@ var Key = class _Key {
    *   degrees. Use {@link Key.chord} with an explicit quality instead.
    */
   diatonicSeventh(degree) {
-    return new Chord(_chunk3R3QVKY5cjs.diatonicSeventh.call(void 0, degree, this.#scale), this);
+    return new Chord(this.#withoutSpelling(_chunkYDGMWH43cjs.diatonicSeventh.call(void 0, degree, this)), this);
   }
   /**
    * Build the chord denoted by a Roman numeral in this key (including applied
@@ -4162,7 +4283,7 @@ var Key = class _Key {
    * @throws If the numeral is not valid.
    */
   roman(text) {
-    return new Chord(_chunkSGLEQVJHcjs.romanToChord.call(void 0, text, this), this);
+    return new Chord(_chunkLQZQDBCDcjs.romanToChord.call(void 0, text, this), this);
   }
   /**
    * The augmented sixth chord of a kind, built in this key.
@@ -4183,7 +4304,7 @@ var Key = class _Key {
    * ```
    */
   augmentedSixth(kind) {
-    return new Chord(_chunkSGLEQVJHcjs.augmentedSixthChord.call(void 0, kind, keyIdentity(this)), this);
+    return new Chord(_chunkLQZQDBCDcjs.augmentedSixthChord.call(void 0, kind, keyIdentity(this)), this);
   }
   /**
    * Build a progression from Roman numerals in this key.
@@ -4216,7 +4337,7 @@ var Key = class _Key {
    * @returns True if the pitch class is a scale tone.
    */
   contains(x) {
-    return _chunk3R3QVKY5cjs.isScaleTone.call(void 0, typeof x === "number" ? x : x.pitchClass, this.#scale);
+    return _chunkYDGMWH43cjs.isScaleTone.call(void 0, typeof x === "number" ? x : x.pitchClass, this.#scale);
   }
   /**
    * The nearest MIDI pitch whose pitch class is in the scale.
@@ -4235,7 +4356,7 @@ var Key = class _Key {
    * ```
    */
   nearestTone(pitch) {
-    return _chunk3R3QVKY5cjs.nearestScaleTone.call(void 0, pitch, this.#scale);
+    return _chunkYDGMWH43cjs.nearestScaleTone.call(void 0, pitch, this.#scale);
   }
   /**
    * The scale degree a pitch sits on, counted from 1: the tonic is degree 1.
@@ -4253,7 +4374,7 @@ var Key = class _Key {
    * ```
    */
   degreeOf(pitch) {
-    const degree = _chunk3R3QVKY5cjs.pitchToScaleDegree.call(void 0, pitch, this.#scale);
+    const degree = _chunkYDGMWH43cjs.pitchToScaleDegree.call(void 0, pitch, this.#scale);
     return degree === -1 ? null : degree;
   }
   /**
@@ -4261,12 +4382,11 @@ var Key = class _Key {
    *
    * Private class fields do not serialize, so an explicit `toJSON` keeps
    * `JSON.stringify(key)` from collapsing to `{}`. The result pairs the
-   * `KeyScale` with the spelled tonic and, for a detected harmonic or melodic
-   * minor, the scale form — everything {@link Key.fromJSON} needs to rebuild a
-   * key that reads and prints as this one.
+   * `KeyScale` with the spelled tonic and the scale form — everything
+   * {@link Key.fromJSON} needs to rebuild a key that reads and prints as this
+   * one.
    *
-   * @returns The key/scale, its spelled tonic, and its scale form when it has
-   *   one.
+   * @returns The key/scale, its spelled tonic, and its scale form.
    */
   toJSON() {
     return { scale: this.scale, tonic: this.#tonic.data, variant: this.#variant };
@@ -4299,8 +4419,8 @@ var Key = class _Key {
    * ```
    */
   toString(opts) {
-    if (_optionalChain([opts, 'optionalAccess', _32 => _32.system]) !== void 0 && opts.system !== "english") {
-      return _chunkS5BKZZGMcjs.formatKeyName.call(void 0, 
+    if (_optionalChain([opts, 'optionalAccess', _33 => _33.system]) !== void 0 && opts.system !== "english") {
+      return _chunkS3QELJUEcjs.formatKeyName.call(void 0, 
         { tonic: this.#tonic.data, mode: this.isMinor ? "minor" : "major" },
         opts
       );
@@ -4317,13 +4437,13 @@ function toKey(value) {
     if (typeof data === "object" && data !== null) {
       const record = data;
       if (record.scale === void 0) {
-        const scale = _chunk3R3QVKY5cjs.toKeyScale.call(void 0, data);
+        const scale = _chunkYDGMWH43cjs.toKeyScale.call(void 0, data);
         return record.tonic === void 0 ? new Key(scale, spelledTonicFor(scale), record.variant) : new Key(scale, new Note(record.tonic), record.variant);
       }
-      return record.tonic === void 0 ? Key.of(_chunk3R3QVKY5cjs.toKeyScale.call(void 0, record.scale)) : Key.fromJSON(record);
+      return record.tonic === void 0 ? Key.of(_chunkYDGMWH43cjs.toKeyScale.call(void 0, record.scale)) : Key.fromJSON(record);
     }
   }
-  throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`key must be a key name or a key/scale; received ${typeof value}`);
+  throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(`key must be a key name or a key/scale; received ${typeof value}`);
 }
 function keyIdentity(key) {
   return { scale: key.scale, tonic: key.tonic.data, variant: key.variant };
@@ -4351,7 +4471,7 @@ function copyMeters(meters) {
 }
 function copyTempo(tempo) {
   assertDataObjects(tempo, "score tempo");
-  _chunkNM7UAMC3cjs.tempoAt.call(void 0, 0, tempo);
+  _chunk3FDBMIPRcjs.tempoAt.call(void 0, 0, tempo);
   return tempo.map((event) => ({
     startBeat: withoutNegativeZero(event.startBeat),
     bpm: event.bpm
@@ -4363,7 +4483,7 @@ function copyScore(data) {
     notes: orderNotes(data.notes, "score notes"),
     // The map is validated by the same resolver every meter-aware entry point
     // reads its options through, so a score accepts exactly what they accept.
-    meters: copyMeters(_chunkS5BKZZGMcjs.resolveMeters.call(void 0, { meters: data.meters }, "score meters")),
+    meters: copyMeters(_chunkS3QELJUEcjs.resolveMeters.call(void 0, { meters: data.meters }, "score meters")),
     tempo: copyTempo(data.tempo)
   };
   if (data.key !== void 0) {
@@ -4377,29 +4497,17 @@ function tempoFrom(tempo) {
   }
   return typeof tempo === "number" ? [{ startBeat: 0, bpm: tempo }] : tempo;
 }
-function statedKeyRegions(key, notes, totalBeats) {
+function scoreKeyRegions(key, notes, totalBeats) {
   const first = notes[0];
-  if (first === void 0 || totalBeats <= first.startBeat) {
-    return [];
-  }
-  return [
-    {
-      // The region starts where the music does, as an inferred one does, so a
-      // pickup is covered by the key it sounds in.
-      startBeat: first.startBeat,
-      endBeat: totalBeats,
-      key: keyIdentity(key),
-      confidence: STATED_KEY_CONFIDENCE
-    }
-  ];
+  return first === void 0 ? [] : _chunkLQZQDBCDcjs.statedKeyRegions.call(void 0, keyIdentity(key), first.startBeat, totalBeats);
 }
 function scoreData(notes, opts) {
   const data = {
     notes: [...assertDataArray(notes, "score notes")],
-    meters: _chunkS5BKZZGMcjs.resolveMeters.call(void 0, { meters: _optionalChain([opts, 'optionalAccess', _33 => _33.meters]) }, "score meters"),
-    tempo: tempoFrom(_optionalChain([opts, 'optionalAccess', _34 => _34.tempo]))
+    meters: _chunkS3QELJUEcjs.resolveMeters.call(void 0, { meters: _optionalChain([opts, 'optionalAccess', _34 => _34.meters]) }, "score meters"),
+    tempo: tempoFrom(_optionalChain([opts, 'optionalAccess', _35 => _35.tempo]))
   };
-  if (_optionalChain([opts, 'optionalAccess', _35 => _35.key]) !== void 0) {
+  if (_optionalChain([opts, 'optionalAccess', _36 => _36.key]) !== void 0) {
     data.key = toKey(opts.key).toJSON();
   }
   return data;
@@ -4411,6 +4519,8 @@ var Score = class _Score {
   #chords;
   /** The key regions, made on the first member that needs them. */
   #regions;
+  /** The reference profile asked for with no options, made on first read. */
+  #profile;
   /**
    * Wrap plain score data.
    *
@@ -4471,8 +4581,8 @@ var Score = class _Score {
   static fromTicks(events, ppq, opts) {
     const notes = assertDataObjects(events, "score notes").map((event) => ({
       ...event,
-      startBeat: _chunkNM7UAMC3cjs.ticksToBeats.call(void 0, event.startBeat, ppq),
-      durationBeat: _chunkNM7UAMC3cjs.ticksToBeats.call(void 0, event.durationBeat, ppq)
+      startBeat: _chunk3FDBMIPRcjs.ticksToBeats.call(void 0, event.startBeat, ppq),
+      durationBeat: _chunk3FDBMIPRcjs.ticksToBeats.call(void 0, event.durationBeat, ppq)
     }));
     return new _Score(scoreData(notes, opts));
   }
@@ -4521,8 +4631,8 @@ var Score = class _Score {
    * @returns The score holding those notes.
    */
   slice(fromBeat, toBeat) {
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, fromBeat, "slice fromBeat");
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, toBeat, "slice toBeat");
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, fromBeat, "slice fromBeat");
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, toBeat, "slice toBeat");
     return this.#withNotes(
       this.#data.notes.filter((note) => note.startBeat >= fromBeat && note.startBeat < toBeat)
     );
@@ -4554,7 +4664,7 @@ var Score = class _Score {
    * @returns The moved score.
    */
   shift(beats) {
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, beats, "shift beats");
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, beats, "shift beats");
     return this.#withNotes(
       this.#data.notes.map((note) => ({ ...note, startBeat: note.startBeat + beats }))
     );
@@ -4572,7 +4682,7 @@ var Score = class _Score {
    * @throws If a note would leave the MIDI range.
    */
   transpose(semitones) {
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, semitones, "transpose semitones");
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, semitones, "transpose semitones");
     return this.#moved(
       this.#data.notes.map((note) => ({ ...note, pitch: note.pitch + semitones })),
       (key) => key.transpose(semitones)
@@ -4592,7 +4702,7 @@ var Score = class _Score {
    * @returns The transposed score.
    */
   transposeBy(interval) {
-    const step = _chunkS5BKZZGMcjs.toSpelledInterval.call(void 0, interval);
+    const step = _chunkS3QELJUEcjs.toSpelledInterval.call(void 0, interval);
     return this.#moved(
       this.#data.notes.map((note) => ({ ...note, pitch: note.pitch + step.semitones })),
       // Moved by the interval rather than by its semitone count, so a key taken
@@ -4603,7 +4713,7 @@ var Score = class _Score {
   }
   /** The same notes read against a different meter. */
   withMeters(meters) {
-    return new _Score({ ...this.#data, meters: _chunkS5BKZZGMcjs.resolveMeters.call(void 0, { meters }, "score meters") });
+    return new _Score({ ...this.#data, meters: _chunkS3QELJUEcjs.resolveMeters.call(void 0, { meters }, "score meters") });
   }
   /** The same notes read against a different tempo. */
   withTempo(tempo) {
@@ -4632,7 +4742,7 @@ var Score = class _Score {
    * ```
    */
   quantize(grid) {
-    _chunkS5BKZZGMcjs.assertRange.call(void 0, grid, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "quantize grid");
+    _chunkS3QELJUEcjs.assertRange.call(void 0, grid, Number.MIN_VALUE, Number.MAX_SAFE_INTEGER, "quantize grid");
     return this.#withNotes(
       this.#data.notes.map((note) => ({
         ...note,
@@ -4644,43 +4754,42 @@ var Score = class _Score {
   /**
    * The notes pushed off the grid the way a player would.
    *
-   * The metric accents are read from the score's opening signature, since
-   * {@link HumanizeOptions} names one signature rather than a map; pass `ts`
-   * to read a later stretch of a score that changes meter.
+   * The metric accents are read against the score's meter map, exactly as
+   * {@link humanize} reads that map; pass `ts` to read against another meter.
    *
    * @param opts Jitter amounts, accent depth and the seed; see
    *   {@link HumanizeOptions}.
    * @returns The humanized score.
    */
   humanize(opts) {
-    return this.#withNotes(_chunkJ7FHVZIIcjs.humanize.call(void 0, this.#data.notes, { ts: this.meterAt(0), ...opts }));
+    return this.#withNotes(_chunk6TTBEON3cjs.humanize.call(void 0, this.#data.notes, { ts: this.#data.meters, ...opts }));
   }
   /**
    * The notes with ornaments added.
    *
-   * Strong positions are read from the score's opening signature, since
-   * {@link OrnamentOptions} names one signature rather than a map.
+   * Strong positions are read against the score's meter map, exactly as
+   * {@link ornament} reads that map.
    *
    * @param opts The ornament style, how much is decorated, and the seed; see
    *   {@link OrnamentOptions}.
    * @returns The ornamented score.
    */
   ornament(opts) {
-    return this.#withNotes(_chunkJ7FHVZIIcjs.ornament.call(void 0, this.#data.notes, { ts: this.meterAt(0), ...opts }));
+    return this.#withNotes(_chunk6TTBEON3cjs.ornament.call(void 0, this.#data.notes, { ts: this.#data.meters, ...opts }));
   }
   /**
    * The notes placed on a groove template's slots.
    *
-   * The template's per-bar grid is laid out against the score's opening
-   * signature, which is the signature the template must have been extracted
-   * under; a template carrying a different one is refused rather than drifting.
+   * The template's per-bar grid is laid out against the score's meter map,
+   * exactly as {@link applyGrooveTemplate} reads that map; a template extracted
+   * under another meter is refused rather than drifting.
    *
    * @param template The groove template, from `extractGrooveTemplate`.
    * @returns The score with the template's feel imposed.
    * @throws If the template was extracted under another meter.
    */
   groove(template) {
-    return this.#withNotes(_chunkJ7FHVZIIcjs.applyGrooveTemplate.call(void 0, this.#data.notes, template, this.meterAt(0)));
+    return this.#withNotes(_chunk6TTBEON3cjs.applyGrooveTemplate.call(void 0, this.#data.notes, template, this.#data.meters));
   }
   /**
    * The feel of the score's own timing, as a template another score can take on.
@@ -4689,8 +4798,8 @@ var Score = class _Score {
    * slot by slot for how far ahead of or behind the grid it sits and how hard
    * it is struck, and the reading is handed back as a template. Only the
    * subdivision is named, because the score already holds the meter the grid is
-   * laid out against — its opening signature, which is the one the template
-   * records and the one an apply-time meter is checked against.
+   * laid out against — its meter map, read exactly as
+   * {@link extractGrooveTemplate} reads that map.
    *
    * @param subdivision Grid steps per quarter-note beat; a sixteenth-note grid
    *   by default, which is where swing, push and drag are audible.
@@ -4704,7 +4813,7 @@ var Score = class _Score {
    * ```
    */
   grooveTemplate(subdivision) {
-    return _chunkJ7FHVZIIcjs.extractGrooveTemplate.call(void 0, this.#data.notes, this.meterAt(0), subdivision);
+    return _chunk6TTBEON3cjs.extractGrooveTemplate.call(void 0, this.#data.notes, this.#data.meters, subdivision);
   }
   /**
    * The harmony the notes spell out, in time.
@@ -4717,10 +4826,10 @@ var Score = class _Score {
    *   and how sure it is of each segment.
    */
   timeline(opts) {
-    const result = opts === void 0 ? this.#chordAnalysis() : _chunkSGLEQVJHcjs.chordTimelineFromNotes.call(void 0, this.#data.notes, this.#analysisOptions(opts));
+    const result = opts === void 0 ? this.#chordAnalysis() : _chunkLQZQDBCDcjs.chordTimelineFromNotes.call(void 0, this.#data.notes, this.#analysisOptions(opts));
     return Timeline.fromData({
       segments: result.timeline.segments,
-      totalBeats: _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _36 => _36.totalBeats]), () => ( this.totalBeats)),
+      totalBeats: _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _37 => _37.totalBeats]), () => ( this.totalBeats)),
       keys: result.keys,
       segmentConfidence: result.segmentConfidence
     });
@@ -4739,7 +4848,7 @@ var Score = class _Score {
     if (this.#key !== void 0) {
       return this.#key;
     }
-    const prevailing = _chunkSGLEQVJHcjs.prevailingKeyOf.call(void 0, this.#keyRegions());
+    const prevailing = _chunkLQZQDBCDcjs.prevailingKeyOf.call(void 0, this.#keyRegions());
     return prevailing === null ? void 0 : toKey(prevailing);
   }
   /**
@@ -4758,9 +4867,10 @@ var Score = class _Score {
   keys(opts) {
     if (opts !== void 0) {
       if (this.#key !== void 0) {
-        return statedKeyRegions(this.#key, this.#data.notes, _nullishCoalesce(opts.totalBeats, () => ( this.totalBeats)));
+        const totalBeats = opts.totalBeats === void 0 || opts.totalBeats === null ? this.totalBeats : _chunkS3QELJUEcjs.assertRange.call(void 0, opts.totalBeats, 0, Number.MAX_SAFE_INTEGER, "key timeline totalBeats");
+        return scoreKeyRegions(this.#key, this.#data.notes, totalBeats);
       }
-      return _chunkSGLEQVJHcjs.keyTimelineFromNotes.call(void 0, this.#data.notes, { meters: this.#data.meters, ...opts });
+      return _chunkLQZQDBCDcjs.keyTimelineFromNotes.call(void 0, this.#data.notes, { meters: this.#data.meters, ...opts });
     }
     return this.#keyRegions().map(copyKeyRegion);
   }
@@ -4788,7 +4898,7 @@ var Score = class _Score {
    * ```
    */
   detectKeys(opts) {
-    return _chunkSGLEQVJHcjs.detectKeyFromNotes.call(void 0, this.#data.notes, opts).map(detectedKeyMatch);
+    return _chunkLQZQDBCDcjs.detectKeyFromNotes.call(void 0, this.#data.notes, opts).map(detectedKeyMatch);
   }
   /**
    * The phrases the notes fall into.
@@ -4800,7 +4910,7 @@ var Score = class _Score {
    * @returns The phrases, in time order.
    */
   phrases(opts) {
-    return _chunkHPVSH7SFcjs.phrasesFromTimeline.call(void 0, this.#chordTimeline(), this.#data.notes, {
+    return _chunk3MDOEFIQcjs.phrasesFromTimeline.call(void 0, this.#chordTimeline(), this.#data.notes, {
       meters: this.#data.meters,
       ...this.#key === void 0 ? {} : { key: keyIdentity(this.#key) },
       ...opts
@@ -4820,7 +4930,7 @@ var Score = class _Score {
    * @returns The cadences, heaviest first; ties keep the earlier one.
    */
   structuralCadences(opts) {
-    return _chunkHPVSH7SFcjs.structuralCadences.call(void 0, this.phrases(opts));
+    return _chunk3MDOEFIQcjs.structuralCadences.call(void 0, this.phrases(opts));
   }
   /**
    * The sections the score divides into.
@@ -4829,7 +4939,7 @@ var Score = class _Score {
    * @returns The sections, in time order.
    */
   sections(opts) {
-    return _chunkHPVSH7SFcjs.sectionsFromNotes.call(void 0, this.#data.notes, { meters: this.#data.meters, ...opts });
+    return _chunk3MDOEFIQcjs.sectionsFromNotes.call(void 0, this.#data.notes, { meters: this.#data.meters, ...opts });
   }
   /**
    * The bar-level pulse above the meter.
@@ -4842,10 +4952,16 @@ var Score = class _Score {
    * @returns The grouping, its downbeats, a confidence, and a rationale.
    */
   hypermeter(opts) {
-    return _chunkHPVSH7SFcjs.hypermeter.call(void 0, this.#data.notes, this.#data.meters, {
-      cadenceBeats: this.#cadenceBeats(),
-      ...opts
-    });
+    const asked = { ...opts };
+    if ((_nullishCoalesce(asked.cadenceBeats, () => ( null))) !== null) {
+      return _chunk3MDOEFIQcjs.hypermeter.call(void 0, this.#data.notes, this.#data.meters, asked);
+    }
+    return _chunk3MDOEFIQcjs.hypermeterOver.call(void 0, 
+      this.#data.notes,
+      this.#data.meters,
+      asked,
+      () => this.#cadenceSpans(asked.budget)
+    );
   }
   /**
    * The motifs the melody repeats.
@@ -4860,8 +4976,9 @@ var Score = class _Score {
    *
    * A melody is one line, so a score holding several is read as its top voice:
    * notes struck together are one event and the highest of them stands for it.
-   * A piano part read whole therefore answers for the voice a listener follows
-   * rather than for a line assembled from the insides of its chords. Split the
+   * A block-chord part read whole therefore answers for its top voice rather
+   * than for a line assembled from the insides of its chords; a lower note
+   * struck while a higher one still sounds stays in the line, though. Split the
    * score into lines first to have each of them answered for.
    *
    * @param opts Cell-length bounds and the recurrence threshold; see
@@ -4884,7 +5001,7 @@ var Score = class _Score {
    * ```
    */
   motifs(opts) {
-    return _chunkHPVSH7SFcjs.extractMotifs.call(void 0, this.#data.notes, opts);
+    return _chunkLQZQDBCDcjs.extractMotifs.call(void 0, this.#data.notes, opts);
   }
   /**
    * The shape the melody traces.
@@ -4896,7 +5013,144 @@ var Score = class _Score {
    * answered for; {@link Score.voices} is what reads the polyphony as polyphony.
    */
   contour() {
-    return _chunkHPVSH7SFcjs.melodicContour.call(void 0, this.#data.notes);
+    return _chunkLQZQDBCDcjs.melodicContour.call(void 0, this.#data.notes);
+  }
+  /**
+   * The score's structural fingerprint: form, phrase shape, harmonic function
+   * and rhythm, and how its motifs derive from one another.
+   *
+   * The harmony is the score's own kept chord analysis, read once whether this
+   * is asked before or after {@link Score.timeline} — unless `opts.timeline`
+   * gives the harmony directly, in which case the reading runs fresh through
+   * {@link analyzeReference} rather than the harmony this score already holds.
+   * The meter, the key and the span are the score's own and are not on offer
+   * here: a caller wanting another meter reads through {@link
+   * Score.withMeters}, and one wanting another key or span calls {@link
+   * analyzeReference} directly.
+   *
+   * Asked with no options, the answer is kept and a copy of it handed back, as
+   * {@link Score.timeline} keeps its own reading; asked with options, the
+   * answer is read afresh and not kept.
+   *
+   * @param opts The harmony, the melody, and the budget; see {@link
+   *   ReferenceProfileOptions}. Meter, key and span are the score's own.
+   * @returns The profile.
+   * @example
+   * ```ts
+   * import { Score } from '@libraz/libcantus';
+   * const triad = (pitches: number[], startBeat: number) =>
+   *   pitches.map((pitch) => ({ pitch, startBeat, durationBeat: 4 }));
+   * const score = Score.of(
+   *   [
+   *     ...triad([60, 64, 67], 0),
+   *     ...triad([65, 69, 72], 4),
+   *     ...triad([67, 71, 74], 8),
+   *     ...triad([60, 64, 67], 12),
+   *   ],
+   *   { key: 'C major' },
+   * );
+   * score.reference().harmony.chords.map((chord) => chord.roman); // ['I', 'IV', 'V', 'I']
+   * ```
+   */
+  reference(opts) {
+    if (opts === void 0 && this.#profile !== void 0) {
+      return copyPlain(this.#profile, "reference profile");
+    }
+    const keyed = this.#key === void 0 ? {} : { key: keyIdentity(this.#key) };
+    const asked = {
+      meters: this.#data.meters,
+      totalBeats: this.totalBeats,
+      ...keyed,
+      ...opts
+    };
+    const profile = _optionalChain([opts, 'optionalAccess', _38 => _38.timeline]) === void 0 ? _chunk3MDOEFIQcjs.referenceFromReadings.call(void 0, this.#data.notes, this.#chordAnalysis(), asked) : _chunk3MDOEFIQcjs.analyzeReference.call(void 0, this.#data.notes, asked);
+    if (opts === void 0) {
+      this.#profile = profile;
+      return copyPlain(profile, "reference profile");
+    }
+    return profile;
+  }
+  /**
+   * The onset placement of the score's melodic line.
+   *
+   * A melody is one line, so a score holding several is read as its top voice,
+   * as {@link Score.motifs} and {@link Score.contour} are.
+   *
+   * @param opts The span's end and the budget; see {@link
+   *   RhythmAnalysisOptions}. The meter is the score's own.
+   * @returns The rhythm reading.
+   * @example
+   * ```ts
+   * import { Score } from '@libraz/libcantus';
+   * const score = Score.of([
+   *   { pitch: 60, startBeat: 0, durationBeat: 1 },
+   *   { pitch: 62, startBeat: 1, durationBeat: 1 },
+   *   { pitch: 64, startBeat: 2, durationBeat: 1 },
+   *   { pitch: 65, startBeat: 3, durationBeat: 1 },
+   * ]);
+   * score.rhythm().onsetDensity; // 4
+   * ```
+   */
+  rhythm(opts) {
+    return _chunkLQZQDBCDcjs.analyzeRhythm.call(void 0, this.#data.notes, {
+      meters: this.#data.meters,
+      totalBeats: this.totalBeats,
+      ...opts
+    });
+  }
+  /**
+   * How the score's motifs derive from one another: which statement grew out
+   * of which, and by what transformation.
+   *
+   * {@link Score.motifs} finds the cells; this reads across their occurrences
+   * and names, for every statement after the first, the earlier one it most
+   * plausibly grew out of. A melody is one line, so a score holding several is
+   * read as its top voice, as {@link Score.motifs} is.
+   *
+   * @param opts Cell-length bounds and the recurrence threshold {@link
+   *   Score.motifs} takes, plus the variation threshold and the budget; see
+   *   {@link MotifGraphOptions} and {@link ExtractMotifsOptions}.
+   * @returns The derivation forest.
+   * @example
+   * ```ts
+   * import { Score } from '@libraz/libcantus';
+   * const score = Score.of([
+   *   { pitch: 60, startBeat: 0, durationBeat: 1 },
+   *   { pitch: 62, startBeat: 1, durationBeat: 1 },
+   *   { pitch: 64, startBeat: 2, durationBeat: 1 },
+   *   { pitch: 60, startBeat: 3, durationBeat: 1 },
+   *   { pitch: 62, startBeat: 4, durationBeat: 1 },
+   *   { pitch: 64, startBeat: 5, durationBeat: 1 },
+   * ]);
+   * score.motifGraph().edges.length; // 1
+   * ```
+   */
+  motifGraph(opts) {
+    return _chunkLQZQDBCDcjs.motifGraph.call(void 0, this.#data.notes, _chunkLQZQDBCDcjs.extractMotifs.call(void 0, this.#data.notes, opts), {
+      key: this.key(),
+      ...opts
+    });
+  }
+  /**
+   * How this score, read as a melody, keeps to a composition plan.
+   *
+   * @param plan The plan the melody was written for.
+   * @param opts The budget; see {@link EvaluateCompositionOptions}.
+   * @returns The violations found and the fit reading; see {@link
+   *   evaluateComposition}.
+   * @example
+   * ```ts
+   * import { Composer, Score } from '@libraz/libcantus';
+   * const notes = [60, 62, 64, 65, 67, 65, 64, 62, 60, 62, 64, 65, 67, 65, 64, 60].map(
+   *   (pitch, startBeat) => ({ pitch, startBeat, durationBeat: 1 }),
+   * );
+   * const composer = Composer.of({ key: 'C major', seed: 5 });
+   * const plan = composer.plan(Score.of(notes, { key: 'C major' }).reference());
+   * composer.melody(plan).evaluate(plan).violations.some((v) => v.severity === 'error'); // false
+   * ```
+   */
+  evaluate(plan, opts) {
+    return _chunk6TTBEON3cjs.evaluateComposition.call(void 0, this.#data.notes, plan, opts);
   }
   /**
    * Each note's role in the harmony sounding under it.
@@ -4920,7 +5174,7 @@ var Score = class _Score {
    */
   voices(key) {
     const timeline = this.#chordTimeline();
-    return _chunkHPVSH7SFcjs.analyzePolyphony.call(void 0, this.#data.notes, timeline.at, this.#keyContext(key));
+    return _chunk3MDOEFIQcjs.analyzePolyphony.call(void 0, this.#data.notes, timeline.at, this.#keyContext(key));
   }
   /**
    * The notes carrying the ids the voice analysis reports them back under.
@@ -4934,7 +5188,7 @@ var Score = class _Score {
    * @returns One voice note per note, in the score's own time order.
    */
   voiceNotes() {
-    return _chunkSGLEQVJHcjs.toVoiceNotes.call(void 0, this.#data.notes);
+    return _chunkLQZQDBCDcjs.toVoiceNotes.call(void 0, this.#data.notes);
   }
   /**
    * Whether an instrument can play the score, and what makes it hard.
@@ -4958,14 +5212,14 @@ var Score = class _Score {
    * ```
    */
   playability(instrument) {
-    const profile = _chunkCGBADIO5cjs.toInstrumentProfile.call(void 0, instrument);
+    const profile = _chunkWOMCXN2Wcjs.toInstrumentProfile.call(void 0, instrument);
     const tempo = this.#data.tempo;
-    const openingBpm = _chunkNM7UAMC3cjs.tempoAt.call(void 0, 0, tempo);
+    const openingBpm = _chunk3FDBMIPRcjs.tempoAt.call(void 0, 0, tempo);
     if (tempo.length < 2) {
-      return _chunkCGBADIO5cjs.playability.call(void 0, this.#data.notes, profile, openingBpm);
+      return _chunkWOMCXN2Wcjs.playability.call(void 0, this.#data.notes, profile, openingBpm);
     }
-    const played = _chunkNM7UAMC3cjs.tempoReader.call(void 0, tempo);
-    const evenly = _chunkNM7UAMC3cjs.tempoReader.call(void 0, [{ startBeat: 0, bpm: openingBpm }]);
+    const played = _chunk3FDBMIPRcjs.tempoReader.call(void 0, tempo);
+    const evenly = _chunk3FDBMIPRcjs.tempoReader.call(void 0, [{ startBeat: 0, bpm: openingBpm }]);
     const restate = (beat) => evenly.beatAt(played.secondsAt(beat));
     const scoreBeats = /* @__PURE__ */ new Map();
     const evenlyPaced = this.#data.notes.map((note) => {
@@ -4977,7 +5231,7 @@ var Score = class _Score {
         durationBeat: restate(note.startBeat + note.durationBeat) - startBeat
       };
     });
-    const report = _chunkCGBADIO5cjs.playability.call(void 0, evenlyPaced, profile, openingBpm);
+    const report = _chunkWOMCXN2Wcjs.playability.call(void 0, evenlyPaced, profile, openingBpm);
     return {
       ...report,
       issues: report.issues.map((issue) => ({
@@ -4993,7 +5247,7 @@ var Score = class _Score {
    * @returns The index.
    */
   index(opts) {
-    return _chunk35NBV2FTcjs.createNoteEventIndex.call(void 0, this.#data.notes, {
+    return _chunkKMYGRFZ6cjs.createNoteEventIndex.call(void 0, this.#data.notes, {
       allowNonPositiveDuration: true,
       name: "score notes",
       ...opts
@@ -5010,7 +5264,7 @@ var Score = class _Score {
    * @returns Elapsed seconds from the tempo map's origin.
    */
   secondsAt(beat) {
-    return _chunkNM7UAMC3cjs.beatsToSeconds.call(void 0, beat, this.#data.tempo);
+    return _chunk3FDBMIPRcjs.beatsToSeconds.call(void 0, beat, this.#data.tempo);
   }
   /**
    * Where a beat falls in bars, read through the meter map.
@@ -5020,7 +5274,7 @@ var Score = class _Score {
    *   reports bar -1.
    */
   barAt(beat) {
-    return _chunkS5BKZZGMcjs.beatToBarPosition.call(void 0, beat, this.#data.meters);
+    return _chunkS3QELJUEcjs.beatToBarPosition.call(void 0, beat, this.#data.meters);
   }
   /**
    * The time signature sounding at a beat.
@@ -5029,7 +5283,7 @@ var Score = class _Score {
    * @returns The signature in force there.
    */
   meterAt(beat) {
-    return _chunkS5BKZZGMcjs.meterAt.call(void 0, beat, this.#data.meters);
+    return _chunkS3QELJUEcjs.meterAt.call(void 0, beat, this.#data.meters);
   }
   /**
    * The score's beats as MIDI ticks, for a writer that counts in them.
@@ -5040,8 +5294,8 @@ var Score = class _Score {
   toTicks(ppq) {
     return this.#data.notes.map((note) => ({
       ...note,
-      startBeat: _chunkNM7UAMC3cjs.beatsToTicks.call(void 0, note.startBeat, ppq),
-      durationBeat: _chunkNM7UAMC3cjs.beatsToTicks.call(void 0, note.durationBeat, ppq)
+      startBeat: _chunk3FDBMIPRcjs.beatsToTicks.call(void 0, note.startBeat, ppq),
+      durationBeat: _chunk3FDBMIPRcjs.beatsToTicks.call(void 0, note.durationBeat, ppq)
     }));
   }
   /**
@@ -5114,7 +5368,7 @@ var Score = class _Score {
    * Score.timeline} hands all three to the class it builds.
    */
   #chordAnalysis() {
-    const analysis = _nullishCoalesce(this.#chords, () => ( _chunkSGLEQVJHcjs.chordTimelineFromNotes.call(void 0, this.#data.notes, this.#analysisOptions())));
+    const analysis = _nullishCoalesce(this.#chords, () => ( _chunkLQZQDBCDcjs.chordTimelineFromNotes.call(void 0, this.#data.notes, this.#analysisOptions())));
     this.#chords = analysis;
     return analysis;
   }
@@ -5125,15 +5379,24 @@ var Score = class _Score {
    * Kept on first reading for the same reason the chord timeline is.
    */
   #keyRegions() {
-    const regions = _nullishCoalesce(this.#regions, () => ( (this.#key === void 0 ? _chunkSGLEQVJHcjs.keyTimelineFromNotes.call(void 0, this.#data.notes, { meters: this.#data.meters }) : statedKeyRegions(this.#key, this.#data.notes, this.totalBeats))));
+    const regions = _nullishCoalesce(this.#regions, () => ( (this.#key === void 0 ? _chunkLQZQDBCDcjs.keyTimelineFromNotes.call(void 0, this.#data.notes, { meters: this.#data.meters }) : scoreKeyRegions(this.#key, this.#data.notes, this.totalBeats))));
     this.#regions = regions;
     return regions;
   }
-  /** Where the score's own harmony closes, as beats. */
-  #cadenceBeats() {
-    return _chunkSGLEQVJHcjs.detectCadences.call(void 0, this.#chordTimeline(), this.#keyContext(void 0)).map(
-      (hit) => hit.atBeat
+  /**
+   * Where the score's own harmony closes, as the spans its arrival chords sound
+   * through, read in the key {@link Score.phrases} reads them in.
+   */
+  #cadenceSpans(budget) {
+    const timeline = this.#chordTimeline();
+    const key = _chunk3MDOEFIQcjs.keyContextFor.call(void 0, 
+      this.#key === void 0 ? void 0 : keyIdentity(this.#key),
+      timeline,
+      this.#data.meters,
+      void 0,
+      budget
     );
+    return _chunk3MDOEFIQcjs.boundaryCadences.call(void 0, timeline, key).spans;
   }
   /** The score's context as chord-timeline options, with the caller's on top. */
   #analysisOptions(opts) {
@@ -5156,9 +5419,9 @@ var Score = class _Score {
       return keyIdentity(this.#key);
     }
     const regions = this.#keyRegions();
-    const prevailing = _nullishCoalesce(_chunkSGLEQVJHcjs.prevailingKeyOf.call(void 0, regions), () => ( keyIdentity(Key.major("C"))));
-    const keyAt = _chunkSGLEQVJHcjs.keyLookup.call(void 0, regions, prevailing);
-    return (beat) => _chunk3R3QVKY5cjs.scaleOf.call(void 0, keyAt(beat));
+    const prevailing = _nullishCoalesce(_chunkLQZQDBCDcjs.prevailingKeyOf.call(void 0, regions), () => ( keyIdentity(Key.major("C"))));
+    const keyAt = _chunkLQZQDBCDcjs.keyLookup.call(void 0, regions, prevailing);
+    return (beat) => _chunkYDGMWH43cjs.scaleOf.call(void 0, keyAt(beat));
   }
 };
 function sameNote(note, other) {
@@ -5194,7 +5457,7 @@ function copyTrack(track, index, budget) {
     copy.name = track.name;
   }
   if (track.role !== void 0) {
-    copy.role = _chunkHPVSH7SFcjs.trackRoleOf.call(void 0, track.role, `tracks[${index}].role`);
+    copy.role = _chunk3MDOEFIQcjs.trackRoleOf.call(void 0, track.role, `tracks[${index}].role`);
   }
   return copy;
 }
@@ -5209,21 +5472,21 @@ function copySegments(segments) {
 function chordTimelineOf(segments) {
   return new Timeline({ segments: [...segments], totalBeats: spanEnd(segments) }).chordTimeline;
 }
-function copySettings(settings, trackCount) {
+function copySettings(settings, tracks) {
   if (settings === void 0) {
     return void 0;
   }
   assertDataObject(settings, "arrangement settings");
   const copy = {};
-  const meters = _chunkS5BKZZGMcjs.resolveMeters.call(void 0, { ts: settings.ts, meters: settings.meters }, "arrangement meters");
+  const meters = _chunkS3QELJUEcjs.resolveMeters.call(void 0, { ts: settings.ts, meters: settings.meters }, "arrangement meters");
   if (settings.ts !== void 0) {
-    copy.ts = copyPlain(_chunkS5BKZZGMcjs.toMeterData.call(void 0, settings.ts, "arrangement ts"), "arrangement ts");
+    copy.ts = copyPlain(_chunkS3QELJUEcjs.toMeterData.call(void 0, settings.ts, "arrangement ts"), "arrangement ts");
   }
   if (settings.meters !== void 0) {
     copy.meters = copyPlain(meters, "arrangement meters");
   }
   if (settings.key !== void 0) {
-    copy.key = _chunk3R3QVKY5cjs.resolveKey.call(void 0, settings.key);
+    copy.key = _chunkYDGMWH43cjs.resolveKey.call(void 0, settings.key);
   }
   if (settings.keys !== void 0) {
     copy.keys = copyKeyRegions(settings.keys);
@@ -5236,11 +5499,12 @@ function copySettings(settings, trackCount) {
       settings.harmonyTracks,
       "arrangement harmonyTracks"
     ).map(
-      (track, index) => _chunkS5BKZZGMcjs.assertInteger.call(void 0, track, `arrangement harmonyTracks[${index}]`, 0, trackCount - 1)
+      (track, index) => _chunkS3QELJUEcjs.assertInteger.call(void 0, track, `arrangement harmonyTracks[${index}]`, 0, tracks.length - 1)
     );
+    _chunk3MDOEFIQcjs.harmonyTrackSet.call(void 0, copy.harmonyTracks, tracks, "arrangement harmonyTracks");
   }
   if (settings.minSeverity !== void 0) {
-    copy.minSeverity = _chunkS5BKZZGMcjs.assertInteger.call(void 0, 
+    copy.minSeverity = _chunkS3QELJUEcjs.assertInteger.call(void 0, 
       settings.minSeverity,
       "arrangement minSeverity",
       0 /* Safe */,
@@ -5248,15 +5512,20 @@ function copySettings(settings, trackCount) {
     );
   }
   if (settings.pickupBeats !== void 0) {
-    copy.pickupBeats = _chunkS5BKZZGMcjs.assertRange.call(void 0, 
+    copy.pickupBeats = _chunkS3QELJUEcjs.assertRange.call(void 0, 
       settings.pickupBeats,
       0,
       Number.MAX_SAFE_INTEGER,
       "arrangement pickupBeats"
     );
+    _chunk3MDOEFIQcjs.assertTrackNotes.call(void 0, tracks, {
+      allowNonPositiveDuration: true,
+      minStartBeat: -copy.pickupBeats,
+      budget: settings.budget
+    });
   }
   if (settings.harmonicRhythm !== void 0) {
-    copy.harmonicRhythm = _chunkS5BKZZGMcjs.assertRange.call(void 0, 
+    copy.harmonicRhythm = _chunkS3QELJUEcjs.assertRange.call(void 0, 
       settings.harmonicRhythm,
       Number.MIN_VALUE,
       Number.MAX_SAFE_INTEGER,
@@ -5264,20 +5533,20 @@ function copySettings(settings, trackCount) {
     );
   }
   if (settings.profile !== void 0) {
-    copy.profile = settings.profile;
+    copy.profile = _chunk3MDOEFIQcjs.arrangementProfile.call(void 0, settings.profile);
   }
   if (settings.budget !== void 0) {
-    copy.budget = _chunkS5BKZZGMcjs.assertPositiveInt.call(void 0, settings.budget, "arrangement budget", Number.MAX_SAFE_INTEGER);
+    copy.budget = _chunkS3QELJUEcjs.assertPositiveInt.call(void 0, settings.budget, "arrangement budget", Number.MAX_SAFE_INTEGER);
   }
   return Object.keys(copy).length === 0 ? void 0 : copy;
 }
 function copyArrangement(data) {
   assertDataObject(data, "arrangement data");
-  const budget = _optionalChain([data, 'access', _37 => _37.settings, 'optionalAccess', _38 => _38.budget]);
+  const budget = _optionalChain([data, 'access', _39 => _39.settings, 'optionalAccess', _40 => _40.budget]);
   const tracks = assertDataArray(data.tracks, "arrangement tracks").map(
     (track, index) => copyTrack(track, index, budget)
   );
-  const settings = copySettings(data.settings, tracks.length);
+  const settings = copySettings(data.settings, tracks);
   return settings === void 0 ? { tracks } : { tracks, settings };
 }
 function arrangementData(tracks, settings) {
@@ -5297,10 +5566,10 @@ function settingsFrom(setup) {
   const { key, meters, timeline, ...rest } = setup;
   const settings = { ...rest };
   if (key !== void 0) {
-    settings.key = _chunk3R3QVKY5cjs.resolveKey.call(void 0, key);
+    settings.key = _chunkYDGMWH43cjs.resolveKey.call(void 0, key);
   }
   if (meters !== void 0) {
-    settings.meters = _chunkS5BKZZGMcjs.resolveMeters.call(void 0, { meters }, "arrangement meters");
+    settings.meters = _chunkS3QELJUEcjs.resolveMeters.call(void 0, { meters }, "arrangement meters");
   }
   if (timeline !== void 0) {
     assertDataObject(timeline, "arrangement timeline");
@@ -5318,10 +5587,10 @@ function analysisOptionsOf(setup) {
   const { key, meters, ...rest } = setup;
   const opts = { ...rest };
   if (key !== void 0) {
-    opts.key = _chunk3R3QVKY5cjs.resolveKey.call(void 0, key);
+    opts.key = _chunkYDGMWH43cjs.resolveKey.call(void 0, key);
   }
   if (meters !== void 0) {
-    opts.meters = _chunkS5BKZZGMcjs.resolveMeters.call(void 0, { meters }, "arrangement meters");
+    opts.meters = _chunkS3QELJUEcjs.resolveMeters.call(void 0, { meters }, "arrangement meters");
   }
   return opts;
 }
@@ -5463,7 +5732,7 @@ var Arrangement = class _Arrangement {
       }
       copied.push({
         trackIndex: edit.trackIndex,
-        notes: copyNotes(edit.notes, `edits[${index}].notes`, _optionalChain([this, 'access', _39 => _39.#data, 'access', _40 => _40.settings, 'optionalAccess', _41 => _41.budget]))
+        notes: copyNotes(edit.notes, `edits[${index}].notes`, _optionalChain([this, 'access', _41 => _41.#data, 'access', _42 => _42.settings, 'optionalAccess', _43 => _43.budget]))
       });
     }
     const session = this.#session().update(copied);
@@ -5488,7 +5757,7 @@ var Arrangement = class _Arrangement {
    * @returns One tension reading per sampled beat, in beat order.
    */
   tension(opts) {
-    return _chunkHPVSH7SFcjs.tensionCurveFrom.call(void 0, 
+    return _chunk3MDOEFIQcjs.tensionCurveFrom.call(void 0, 
       [...this.#data.tracks],
       this.#session().analysis,
       this.#layered(analysisOptionsOf(opts))
@@ -5514,7 +5783,7 @@ var Arrangement = class _Arrangement {
    *   tracks exceed the budget.
    */
   analyze(opts) {
-    return _chunkHPVSH7SFcjs.analyzeArrangement.call(void 0, [...this.#data.tracks], this.#layered(analysisOptionsOf(opts)));
+    return _chunk3MDOEFIQcjs.analyzeArrangement.call(void 0, [...this.#data.tracks], this.#layered(analysisOptionsOf(opts)));
   }
   /**
    * The harmony the tracks spell out together, in time.
@@ -5532,6 +5801,71 @@ var Arrangement = class _Arrangement {
       keys: [...keys]
     });
   }
+  /**
+   * The arrangement's structural fingerprint: form, phrase shape, harmonic
+   * function and rhythm, and how its melody's motifs derive from one another.
+   *
+   * The harmony reads the arrangement's own session analysis directly — the
+   * tracks `settings.harmonyTracks` names, or else every track but the
+   * percussion ones — so the harmony is never inferred a second time. The
+   * melody is the notes of the tracks played with `role: 'melody'`, joined in
+   * the order the tracks were given; an arrangement naming none reads the top
+   * line of the harmony notes instead, as {@link analyzeReference} does
+   * without a `melody` option. Meter, key, harmony and melody are the
+   * arrangement's own and are not on offer here: a caller wanting others calls
+   * {@link analyzeReference} directly, with the same notes {@link
+   * Arrangement.tracks} hands out.
+   *
+   * @param opts The budget; see {@link ReferenceProfileOptions}.
+   * @returns The profile.
+   * @example
+   * ```ts
+   * import { Arrangement } from '@libraz/libcantus';
+   * const triad = (pitches: number[], startBeat: number) =>
+   *   pitches.map((pitch) => ({ pitch, startBeat, durationBeat: 4 }));
+   * const arrangement = Arrangement.of(
+   *   [
+   *     {
+   *       name: 'lead',
+   *       role: 'melody',
+   *       notes: [
+   *         ...triad([60, 64, 67], 0),
+   *         ...triad([65, 69, 72], 4),
+   *         ...triad([67, 71, 74], 8),
+   *         ...triad([60, 64, 67], 12),
+   *       ],
+   *     },
+   *   ],
+   *   { key: 'C major' },
+   * );
+   * arrangement.reference().harmony.chords.map((chord) => chord.roman); // ['I', 'IV', 'V', 'I']
+   * ```
+   */
+  reference(opts) {
+    const tracks = this.#data.tracks;
+    const harmonyTracks = _optionalChain([this, 'access', _44 => _44.#data, 'access', _45 => _45.settings, 'optionalAccess', _46 => _46.harmonyTracks]);
+    const harmony = [];
+    const melody = [];
+    for (let index = 0; index < tracks.length; index += 1) {
+      const track = tracks[index];
+      if (track === void 0) {
+        continue;
+      }
+      if (track.role !== "drums" && (harmonyTracks === void 0 || harmonyTracks.includes(index))) {
+        harmony.push(...track.notes);
+      }
+      if (track.role === "melody") {
+        melody.push(...track.notes);
+      }
+    }
+    return _chunk3MDOEFIQcjs.referenceFromReadings.call(void 0, harmony, this.#session().analysis, {
+      // The meter the arrangement's own analysis reads, `ts` included.
+      meters: _nullishCoalesce(_optionalChain([this, 'access', _47 => _47.#data, 'access', _48 => _48.settings, 'optionalAccess', _49 => _49.meters]), () => ( _optionalChain([this, 'access', _50 => _50.#data, 'access', _51 => _51.settings, 'optionalAccess', _52 => _52.ts]))),
+      totalBeats: this.timeline().totalBeats,
+      ...melody.length === 0 ? {} : { melody },
+      ...opts
+    });
+  }
   /**
    * Whether another arrangement holds the same tracks under the same settings.
    *
@@ -5556,7 +5890,7 @@ var Arrangement = class _Arrangement {
   }
   /** The open reading, analysing the tracks on the first call. */
   #session() {
-    const open = _nullishCoalesce(this.#open, () => ( _chunkHPVSH7SFcjs.createArrangementSession.call(void 0, [...this.#data.tracks], this.#analysisOptions())));
+    const open = _nullishCoalesce(this.#open, () => ( _chunk3MDOEFIQcjs.createArrangementSession.call(void 0, [...this.#data.tracks], this.#analysisOptions())));
     this.#open = open;
     return open;
   }
@@ -5596,12 +5930,12 @@ var Arrangement = class _Arrangement {
   #scoreOptions() {
     const settings = this.#data.settings;
     const opts = {};
-    if (_optionalChain([settings, 'optionalAccess', _42 => _42.meters]) !== void 0) {
+    if (_optionalChain([settings, 'optionalAccess', _53 => _53.meters]) !== void 0) {
       opts.meters = settings.meters;
-    } else if (_optionalChain([settings, 'optionalAccess', _43 => _43.ts]) !== void 0) {
+    } else if (_optionalChain([settings, 'optionalAccess', _54 => _54.ts]) !== void 0) {
       opts.meters = settings.ts;
     }
-    if (_optionalChain([settings, 'optionalAccess', _44 => _44.key]) !== void 0) {
+    if (_optionalChain([settings, 'optionalAccess', _55 => _55.key]) !== void 0) {
       opts.key = settings.key;
     }
     return opts;
@@ -5637,7 +5971,9 @@ function copyProfile(profile) {
   }
   const reach = {};
   for (const [pitch, limbs] of Object.entries(profile.reach)) {
-    reach[Number(pitch)] = [...limbs];
+    if (String(Number(pitch)) === pitch) {
+      reach[Number(pitch)] = [...limbs];
+    }
   }
   const percussion = {
     kind: "percussion",
@@ -5651,7 +5987,7 @@ function copyProfile(profile) {
   return percussion;
 }
 function checkedProfile(profile) {
-  return copyProfile(_chunkCGBADIO5cjs.toInstrumentProfile.call(void 0, profile));
+  return copyProfile(_chunkWOMCXN2Wcjs.toInstrumentProfile.call(void 0, profile));
 }
 var Instrument = class _Instrument {
   #profile;
@@ -5687,7 +6023,7 @@ var Instrument = class _Instrument {
    * @returns The instrument.
    */
   static guitar() {
-    return _Instrument.of(_chunkCGBADIO5cjs.GUITAR_STANDARD);
+    return _Instrument.of(_chunkWOMCXN2Wcjs.GUITAR_STANDARD);
   }
   /**
    * Six-string guitar in drop D: the lowest string down a tone to D2, the rest
@@ -5696,7 +6032,7 @@ var Instrument = class _Instrument {
    * @returns The instrument.
    */
   static guitarDropD() {
-    return _Instrument.of(_chunkCGBADIO5cjs.GUITAR_DROP_D);
+    return _Instrument.of(_chunkWOMCXN2Wcjs.GUITAR_DROP_D);
   }
   /**
    * Electric bass in standard tuning: E1 A1 D2 G2.
@@ -5704,7 +6040,7 @@ var Instrument = class _Instrument {
    * @returns The instrument.
    */
   static bass4() {
-    return _Instrument.of(_chunkCGBADIO5cjs.BASS_4_STRING);
+    return _Instrument.of(_chunkWOMCXN2Wcjs.BASS_4_STRING);
   }
   /**
    * Five-string bass with the low B: B0 E1 A1 D2 G2.
@@ -5717,7 +6053,7 @@ var Instrument = class _Instrument {
    * ```
    */
   static bass5() {
-    return _Instrument.of(_chunkCGBADIO5cjs.BASS_5_STRING);
+    return _Instrument.of(_chunkWOMCXN2Wcjs.BASS_5_STRING);
   }
   /**
    * Rebuild an instrument from the plain profile {@link Instrument.data} hands
@@ -5775,7 +6111,7 @@ var Instrument = class _Instrument {
    * ```
    */
   range() {
-    return _chunkCGBADIO5cjs.rangeIn.call(void 0, this.#profile);
+    return _chunkWOMCXN2Wcjs.rangeIn.call(void 0, this.#profile);
   }
   /**
    * Whether the instrument has this pitch at all.
@@ -5785,8 +6121,8 @@ var Instrument = class _Instrument {
    *   produces it.
    */
   canSound(pitch) {
-    _chunkS5BKZZGMcjs.assertMidiPitch.call(void 0, pitch, "pitch");
-    return _chunkCGBADIO5cjs.soundsIn.call(void 0, this.#profile, pitch);
+    _chunkS3QELJUEcjs.assertMidiPitch.call(void 0, pitch, "pitch");
+    return _chunkWOMCXN2Wcjs.soundsIn.call(void 0, this.#profile, pitch);
   }
   /**
    * Every position on the neck that sounds a pitch, lowest string first.
@@ -5798,10 +6134,10 @@ var Instrument = class _Instrument {
   fingerings(pitch) {
     const profile = this.#profile;
     if (profile.kind !== "stringed") {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(`${profile.name} has no strings to finger`);
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(`${profile.name} has no strings to finger`);
     }
-    _chunkS5BKZZGMcjs.assertMidiPitch.call(void 0, pitch, "pitch");
-    return _chunkCGBADIO5cjs.fingeringsIn.call(void 0, profile, pitch);
+    _chunkS3QELJUEcjs.assertMidiPitch.call(void 0, pitch, "pitch");
+    return _chunkWOMCXN2Wcjs.fingeringsIn.call(void 0, profile, pitch);
   }
   /**
    * Move a pitch by whole octaves until the instrument can sound it, which is
@@ -5818,8 +6154,8 @@ var Instrument = class _Instrument {
    * ```
    */
   foldIntoRange(pitch) {
-    _chunkS5BKZZGMcjs.assertMidiPitch.call(void 0, pitch, "pitch");
-    return _chunkCGBADIO5cjs.foldIn.call(void 0, pitch, this.#profile);
+    _chunkS3QELJUEcjs.assertMidiPitch.call(void 0, pitch, "pitch");
+    return _chunkWOMCXN2Wcjs.foldIn.call(void 0, pitch, this.#profile);
   }
   /**
    * The pitch this instrument sounds for a note written in its part.
@@ -5851,7 +6187,7 @@ var Instrument = class _Instrument {
    * ```
    */
   soundingPitch(note, transposition = this.#profile.name) {
-    return new Note(_chunk76ZBTRG2cjs.toSoundingPitch.call(void 0, _chunkS5BKZZGMcjs.toNoteData.call(void 0, note), transposition));
+    return new Note(_chunkU4EQTDGNcjs.toSoundingPitch.call(void 0, _chunkS3QELJUEcjs.toNoteData.call(void 0, note), transposition));
   }
   /**
    * Judge whether a passage can be played on this instrument, and how hard it
@@ -5877,7 +6213,7 @@ var Instrument = class _Instrument {
    * ```
    */
   playability(notes, bpm) {
-    return _chunkCGBADIO5cjs.playability.call(void 0, notes, this.#profile, bpm);
+    return _chunkWOMCXN2Wcjs.playability.call(void 0, notes, this.#profile, bpm);
   }
   /**
    * Whether another instrument is described identically.
@@ -5937,7 +6273,7 @@ function copyComplexity(complexity) {
   for (const dial of ["rhythmic", "harmonic", "ornament", "difficulty"]) {
     const value = complexity[dial];
     if (value !== void 0) {
-      copy[dial] = _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, value, `composer complexity ${dial}`);
+      copy[dial] = _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, value, `composer complexity ${dial}`);
     }
   }
   return copy;
@@ -5953,10 +6289,10 @@ function copyInstruments(instruments) {
 function copyOptions(options) {
   assertDataObject(options, "composer options");
   const copy = {
-    meters: _chunkS5BKZZGMcjs.resolveMeters.call(void 0, { meters: options.meters }, "composer meters")
+    meters: _chunkS3QELJUEcjs.resolveMeters.call(void 0, { meters: options.meters }, "composer meters")
   };
   if (options.key !== void 0) {
-    copy.key = _chunk3R3QVKY5cjs.resolveKey.call(void 0, options.key);
+    copy.key = _chunkYDGMWH43cjs.resolveKey.call(void 0, options.key);
   }
   if (options.bpm !== void 0) {
     copy.bpm = options.bpm;
@@ -5982,7 +6318,7 @@ function copyOptions(options) {
   if (options.rng !== void 0) {
     copy.rng = options.rng;
   }
-  const resolved = _chunkJ7FHVZIIcjs.resolveContext.call(void 0, contextOf(copy));
+  const resolved = _chunk6TTBEON3cjs.resolveContext.call(void 0, contextOf(copy));
   copy.seed = resolved.seed;
   copy.algorithmVersion = resolved.algorithmVersion;
   return copy;
@@ -6039,8 +6375,8 @@ var Composer = class _Composer {
    */
   constructor(options) {
     this.#options = copyOptions(options);
-    this.#meters = _chunkS5BKZZGMcjs.resolveMeters.call(void 0, { meters: this.#options.meters }, "composer meters");
-    this.#key = this.#options.key === void 0 ? void 0 : _chunk3R3QVKY5cjs.resolveKey.call(void 0, this.#options.key);
+    this.#meters = _chunkS3QELJUEcjs.resolveMeters.call(void 0, { meters: this.#options.meters }, "composer meters");
+    this.#key = this.#options.key === void 0 ? void 0 : _chunkYDGMWH43cjs.resolveKey.call(void 0, this.#options.key);
   }
   /**
    * Start from a set of settings.
@@ -6097,8 +6433,8 @@ var Composer = class _Composer {
   progression(opts) {
     const key = this.#requireKey("progression");
     const ts = this.#unchangingMeter("progression");
-    const chords = _chunkJ7FHVZIIcjs.generateProgression.call(void 0, { ...opts, key, ts, ctx: this.context });
-    return Timeline.fromChords(chords, opts.bars * _chunkS5BKZZGMcjs.beatsPerBar.call(void 0, ts), key);
+    const chords = _chunk6TTBEON3cjs.generateProgression.call(void 0, { ...opts, key, ts, ctx: this.context });
+    return Timeline.fromChords(chords, opts.bars * _chunkS3QELJUEcjs.beatsPerBar.call(void 0, ts), key);
   }
   /**
    * A drum part.
@@ -6117,7 +6453,7 @@ var Composer = class _Composer {
    *   request is refused rather than answered with 4/4 bars over the change.
    */
   drums(opts) {
-    const hits = _chunkJ7FHVZIIcjs.generateDrums.call(void 0, { ...opts, ts: this.#unchangingMeter("drums"), ctx: this.context });
+    const hits = _chunk6TTBEON3cjs.generateDrums.call(void 0, { ...opts, ts: this.#unchangingMeter("drums"), ctx: this.context });
     return Score.of(hits, this.#scoreOptions());
   }
   /**
@@ -6144,12 +6480,12 @@ var Composer = class _Composer {
     const segments = Array.isArray(source) ? source : source.segments;
     const key = this.#requireKey("bass");
     const { instrument, ...rest } = _nullishCoalesce(opts, () => ( {}));
-    const notes = _chunkJ7FHVZIIcjs.generateBassLine.call(void 0, {
+    const notes = _chunk6TTBEON3cjs.generateBassLine.call(void 0, {
       ...rest,
-      ...instrument === void 0 ? {} : { instrument: _chunkCGBADIO5cjs.toStringedProfile.call(void 0, instrument, "bass instrument") },
+      ...instrument === void 0 ? {} : { instrument: _chunkWOMCXN2Wcjs.toStringedProfile.call(void 0, instrument, "bass instrument") },
       segments,
       key,
-      ts: this.#openingMeter(),
+      ts: this.#meters,
       ctx: this.context
     });
     return Score.of(notes, this.#scoreOptions(key));
@@ -6176,12 +6512,12 @@ var Composer = class _Composer {
   counterMelody(melody, opts) {
     const key = this.#requireKey("counterMelody");
     const { timeline, ...rest } = _nullishCoalesce(opts, () => ( {}));
-    const notes = _chunkJ7FHVZIIcjs.generateCounterMelody.call(void 0, {
+    const notes = _chunk6TTBEON3cjs.generateCounterMelody.call(void 0, {
       ...rest,
       ...timeline === void 0 ? {} : { timeline: toChordTimeline(timeline) },
       melody: melody.notes,
       key,
-      ts: this.#openingMeter(),
+      ts: this.#meters,
       ctx: this.context
     });
     return Score.of(notes, this.#scoreOptions(key));
@@ -6207,18 +6543,19 @@ var Composer = class _Composer {
    * ```
    */
   harmonize(melody, opts) {
-    const result = _chunkJ7FHVZIIcjs.harmonizeMelody.call(void 0, {
+    const result = _chunk6TTBEON3cjs.harmonizeMelody.call(void 0, {
       ...opts,
       melody: melody.notes,
       ...this.#key === void 0 ? {} : { key: this.#key },
-      ts: this.#openingMeter(),
+      ts: this.#meters,
       ctx: this.context
     });
     const moved = melody.transpose(result.transposeSemitones);
+    const last = result.chords[result.chords.length - 1];
     const totalBeats = harmonizedSpan(
       moved.totalBeats,
       result.chords,
-      _chunkS5BKZZGMcjs.beatsPerBar.call(void 0, this.#openingMeter())
+      _chunkS3QELJUEcjs.beatsPerBarAt.call(void 0, _nullishCoalesce(_optionalChain([last, 'optionalAccess', _56 => _56.startBeat]), () => ( 0)), this.#meters)
     );
     return {
       chords: Timeline.fromChords(result.chords, totalBeats, result.key),
@@ -6228,6 +6565,73 @@ var Composer = class _Composer {
       transposeSemitones: result.transposeSemitones
     };
   }
+  /**
+   * A composition plan derived from a reference profile.
+   *
+   * The composer's key is the plan's home key unless `opts.key` names another,
+   * and its seed and algorithm version are the ones the plan records, so the
+   * plan is written under the same recipe as the composer's other parts.
+   *
+   * @param reference The reference profile to derive from.
+   * @param opts Everything {@link deriveCompositionPlan} takes but the context,
+   *   which is the composer's.
+   * @returns The plan.
+   * @throws If the composer draws from a caller-held `rng`: a plan records its
+   *   seed, and a source cannot be written into it.
+   * @example
+   * ```ts
+   * import { Composer, Score } from '@libraz/libcantus';
+   * const notes = [60, 62, 64, 65, 67, 65, 64, 62, 60, 62, 64, 65, 67, 65, 64, 60].map(
+   *   (pitch, startBeat) => ({ pitch, startBeat, durationBeat: 1 }),
+   * );
+   * const reference = Score.of(notes, { key: 'C major' }).reference();
+   * const plan = Composer.of({ key: 'D major', seed: 5 }).plan(reference);
+   * plan.seed; // 5
+   * plan.keys[0].scale.rootPc; // 2
+   * ```
+   */
+  plan(reference, opts) {
+    const ctx = this.context;
+    if (ctx.rng !== void 0) {
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
+        "composer plan cannot record a caller-held rng; give the composer a seed instead"
+      );
+    }
+    return _chunk6TTBEON3cjs.deriveCompositionPlan.call(void 0, reference, {
+      ...this.#key === void 0 ? {} : { key: this.#key },
+      ...opts,
+      ctx
+    });
+  }
+  /**
+   * A melody written to a composition plan.
+   *
+   * The plan is the reproduction recipe, so its seed and algorithm version are
+   * the ones the melody is drawn under, not the composer's. The score is read
+   * in the plan's meter and home key, at the composer's tempo.
+   *
+   * @param plan The plan to follow.
+   * @param opts The budget; see {@link MelodyOptions}.
+   * @returns The melody, as a score.
+   * @example
+   * ```ts
+   * import { Composer, Score } from '@libraz/libcantus';
+   * const notes = [60, 62, 64, 65, 67, 65, 64, 62, 60, 62, 64, 65, 67, 65, 64, 60].map(
+   *   (pitch, startBeat) => ({ pitch, startBeat, durationBeat: 1 }),
+   * );
+   * const composer = Composer.of({ key: 'C major', seed: 5 });
+   * const plan = composer.plan(Score.of(notes, { key: 'C major' }).reference());
+   * composer.melody(plan).notes.length > 0; // true
+   * ```
+   */
+  melody(plan, opts) {
+    const notes = _chunk6TTBEON3cjs.generateMelody.call(void 0, plan, opts);
+    const score = { meters: plan.meters, key: plan.keys[0] };
+    if (this.#options.bpm !== void 0) {
+      score.tempo = this.#options.bpm;
+    }
+    return Score.of(notes, score);
+  }
   /**
    * Whether another composer holds the same settings.
    *
@@ -6280,22 +6684,12 @@ var Composer = class _Composer {
    */
   #requireKey(part) {
     if (this.#key === void 0) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         `composer ${part} needs a key for the part it writes; the composer names none \u2014 give it one, or take the key harmonize reads off a melody and pass it on with with({ key })`
       );
     }
     return this.#key;
   }
-  /**
-   * The signature the parts are written against.
-   *
-   * Each generator names one time signature rather than a map, so a composer
-   * whose meter changes hands over the signature its music opens on — the same
-   * reading {@link Score.humanize} and its siblings take.
-   */
-  #openingMeter() {
-    return _chunkS5BKZZGMcjs.meterAt.call(void 0, 0, this.#meters);
-  }
   /**
    * The one signature a part laid out in bars is written against.
    *
@@ -6306,11 +6700,11 @@ var Composer = class _Composer {
    */
   #unchangingMeter(part) {
     if (this.#meters.length > 1) {
-      throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)(
+      throw new (0, _chunkS3QELJUEcjs.InvalidInputError)(
         `composer ${part} needs one meter for the whole part; the composer changes meter`
       );
     }
-    return this.#openingMeter();
+    return _chunkS3QELJUEcjs.meterAt.call(void 0, 0, this.#meters);
   }
   /** The context every score a composer hands back is read against. */
   #scoreOptions(key) {
@@ -6327,7 +6721,7 @@ var Composer = class _Composer {
 
 // src/model/duration.ts
 function copyDuration(value) {
-  _chunkNM7UAMC3cjs.durationToBeats.call(void 0, value);
+  _chunk3FDBMIPRcjs.durationToBeats.call(void 0, value);
   if (typeof value === "string") {
     return { base: value, dots: 0 };
   }
@@ -6378,7 +6772,7 @@ var Duration = class _Duration {
    *   {@link Duration.tieChain} for those.
    */
   static ofBeats(beats, options = {}) {
-    return new _Duration(_chunkNM7UAMC3cjs.beatsToDuration.call(void 0, beats, options));
+    return new _Duration(_chunk3FDBMIPRcjs.beatsToDuration.call(void 0, beats, options));
   }
   /**
    * Spell a length in beats as a chain of tied durations.
@@ -6402,7 +6796,7 @@ var Duration = class _Duration {
    * ```
    */
   static tieChain(beats, options = {}) {
-    return _chunkNM7UAMC3cjs.beatsToTiedDurations.call(void 0, beats, options).map((spelled) => new _Duration(spelled));
+    return _chunk3FDBMIPRcjs.beatsToTiedDurations.call(void 0, beats, options).map((spelled) => new _Duration(spelled));
   }
   /**
    * Wrap a plain duration, or a bare base value as shorthand for an undotted
@@ -6466,7 +6860,7 @@ var Duration = class _Duration {
    * ```
    */
   beats(options = {}) {
-    return _chunkNM7UAMC3cjs.durationToBeats.call(void 0, this.toJSON(), options);
+    return _chunk3FDBMIPRcjs.durationToBeats.call(void 0, this.toJSON(), options);
   }
   /**
    * Whether another duration is written identically.
@@ -6480,7 +6874,7 @@ var Duration = class _Duration {
    */
   equals(other) {
     const b = other.data;
-    return this.#base === b.base && this.#dots === b.dots && _optionalChain([this, 'access', _45 => _45.#tuplet, 'optionalAccess', _46 => _46.actual]) === _optionalChain([b, 'access', _47 => _47.tuplet, 'optionalAccess', _48 => _48.actual]) && _optionalChain([this, 'access', _49 => _49.#tuplet, 'optionalAccess', _50 => _50.normal]) === _optionalChain([b, 'access', _51 => _51.tuplet, 'optionalAccess', _52 => _52.normal]);
+    return this.#base === b.base && this.#dots === b.dots && _optionalChain([this, 'access', _57 => _57.#tuplet, 'optionalAccess', _58 => _58.actual]) === _optionalChain([b, 'access', _59 => _59.tuplet, 'optionalAccess', _60 => _60.actual]) && _optionalChain([this, 'access', _61 => _61.#tuplet, 'optionalAccess', _62 => _62.normal]) === _optionalChain([b, 'access', _63 => _63.tuplet, 'optionalAccess', _64 => _64.normal]);
   }
   /**
    * The plain duration, for JSON serialization.
@@ -6547,7 +6941,7 @@ var Meter = class _Meter {
    *   is ordinary, such as a meter field read on every keystroke.
    */
   static parse(text) {
-    return new _Meter(_chunkS5BKZZGMcjs.parseTimeSignature.call(void 0, text));
+    return new _Meter(_chunkS3QELJUEcjs.parseTimeSignature.call(void 0, text));
   }
   /**
    * Parse a time signature, reporting failure instead of throwing it.
@@ -6566,7 +6960,7 @@ var Meter = class _Meter {
    * ```
    */
   static tryParse(text) {
-    const parsed = _chunkS5BKZZGMcjs.tryParseTimeSignature.call(void 0, text);
+    const parsed = _chunkS3QELJUEcjs.tryParseTimeSignature.call(void 0, text);
     return parsed.ok ? { ok: true, value: new _Meter(parsed.value) } : parsed;
   }
   /**
@@ -6611,22 +7005,22 @@ var Meter = class _Meter {
    * neither is a signature whose grouping selects the additive reading.
    */
   get isCompound() {
-    return _chunkS5BKZZGMcjs.isCompound.call(void 0, this.#ts);
+    return _chunkS3QELJUEcjs.isCompound.call(void 0, this.#ts);
   }
   /** Length of a bar in quarter-note beats. */
   get beatsPerBar() {
-    return _chunkS5BKZZGMcjs.beatsPerBar.call(void 0, this.#ts);
+    return _chunkS3QELJUEcjs.beatsPerBar.call(void 0, this.#ts);
   }
   /** Main pulses (felt beats) in a bar: 2 in 6/8, 4 in 4/4. */
   get pulsesPerBar() {
-    return _chunkS5BKZZGMcjs.pulsesPerBar.call(void 0, this.#ts);
+    return _chunkS3QELJUEcjs.pulsesPerBar.call(void 0, this.#ts);
   }
   /**
    * Length of one felt beat in quarter-note beats: a quarter note in simple
    * meters, a dotted quarter in compound ones.
    */
   get pulseBeats() {
-    return _chunkS5BKZZGMcjs.pulseBeats.call(void 0, this.#ts);
+    return _chunkS3QELJUEcjs.pulseBeats.call(void 0, this.#ts);
   }
   /**
    * Render the signature as `'n/d'`, or as `'a+b+c/d'` when it carries an
@@ -6649,7 +7043,7 @@ var Meter = class _Meter {
    * ```
    */
   format(opts = {}) {
-    return _chunkS5BKZZGMcjs.formatTimeSignature.call(void 0, this.#ts, opts);
+    return _chunkS3QELJUEcjs.formatTimeSignature.call(void 0, this.#ts, opts);
   }
   /**
    * Metric weight of a position within its bar, on a 0–3 scale: 3 the
@@ -6662,7 +7056,7 @@ var Meter = class _Meter {
    * @throws If the position is not finite.
    */
   weightAt(beatInQuarters) {
-    return _chunkS5BKZZGMcjs.metricWeight.call(void 0, beatInQuarters, this.#ts);
+    return _chunkS3QELJUEcjs.metricWeight.call(void 0, beatInQuarters, this.#ts);
   }
   /**
    * Whether a position is metrically accented — a downbeat or a secondary
@@ -6673,7 +7067,7 @@ var Meter = class _Meter {
    * @throws If the position is not finite.
    */
   isStrongBeat(beatInQuarters) {
-    return _chunkS5BKZZGMcjs.isStrongBeat.call(void 0, beatInQuarters, this.#ts);
+    return _chunkS3QELJUEcjs.isStrongBeat.call(void 0, beatInQuarters, this.#ts);
   }
   /**
    * Convert a position in quarter-note beats to a bar index and in-bar offset.
@@ -6683,7 +7077,7 @@ var Meter = class _Meter {
    * @throws If the position is not finite.
    */
   barPositionAt(beatInQuarters) {
-    return _chunkS5BKZZGMcjs.beatToBarPosition.call(void 0, beatInQuarters, this.#ts);
+    return _chunkS3QELJUEcjs.beatToBarPosition.call(void 0, beatInQuarters, this.#ts);
   }
   /**
    * Render a position as the `bar.beat` a DAW or a score shows: 1-based bar,
@@ -6706,7 +7100,7 @@ var Meter = class _Meter {
    * ```
    */
   formatPosition(beatInQuarters, decimals = 2) {
-    return _chunkS5BKZZGMcjs.formatBarPosition.call(void 0, beatInQuarters, this.#ts, decimals);
+    return _chunkS3QELJUEcjs.formatBarPosition.call(void 0, beatInQuarters, this.#ts, decimals);
   }
   /**
    * Subdivide a span into equal tuplet durations — an eighth-note triplet is
@@ -6718,7 +7112,7 @@ var Meter = class _Meter {
    * @throws If the span is negative or `count` is not a positive integer.
    */
   tuplet(totalBeats, count) {
-    return _chunkS5BKZZGMcjs.tuplet.call(void 0, totalBeats, count);
+    return _chunkS3QELJUEcjs.tuplet.call(void 0, totalBeats, count);
   }
   /**
    * Whether another meter is the same signature, grouping included.
@@ -6736,7 +7130,7 @@ var Meter = class _Meter {
     if (grouping === void 0 || b.grouping === void 0) {
       return this.#ts.numerator === b.numerator && this.#ts.denominator === b.denominator && grouping === b.grouping;
     }
-    return this.#ts.numerator === b.numerator && this.#ts.denominator === b.denominator && grouping.length === b.grouping.length && grouping.every((entry, index) => entry === _optionalChain([b, 'access', _53 => _53.grouping, 'optionalAccess', _54 => _54[index]]));
+    return this.#ts.numerator === b.numerator && this.#ts.denominator === b.denominator && grouping.length === b.grouping.length && grouping.every((entry, index) => entry === _optionalChain([b, 'access', _65 => _65.grouping, 'optionalAccess', _66 => _66[index]]));
   }
   /**
    * The plain time signature, for JSON serialization.
@@ -6775,7 +7169,7 @@ function copyCell(cell) {
   return { notes: assertNoteEventArray(cell.notes, "motif notes").map(copyNote2) };
 }
 function chordFrom(chord) {
-  return chord === void 0 || chord === null ? chord : _chunk3R3QVKY5cjs.toChordData.call(void 0, chord);
+  return chord === void 0 || chord === null ? chord : _chunkYDGMWH43cjs.toChordData.call(void 0, chord);
 }
 var Motif = class _Motif {
   #cell;
@@ -6807,7 +7201,8 @@ var Motif = class _Motif {
    * ```
    */
   static generate(opts) {
-    return new _Motif(_chunkJ7FHVZIIcjs.generateMotif.call(void 0, { ...opts, chord: chordFrom(opts.chord) }));
+    _chunkS3QELJUEcjs.assertRecord.call(void 0, opts, "motif options");
+    return new _Motif(_chunk6TTBEON3cjs.generateMotif.call(void 0, { ...opts, chord: chordFrom(opts.chord) }));
   }
   /**
    * Read a run of notes as a motif.
@@ -6821,7 +7216,7 @@ var Motif = class _Motif {
    * @throws If a note carries a value the transforms cannot hold.
    */
   static fromNotes(notes) {
-    return new _Motif({ notes: [...notes] });
+    return new _Motif({ notes: [..._chunkS3QELJUEcjs.assertArray.call(void 0, notes, "motif notes")] });
   }
   /** Rebuild a motif from the plain data {@link Motif.data} hands out. */
   static fromData(cell) {
@@ -6837,7 +7232,7 @@ var Motif = class _Motif {
   }
   /** Where the cell stops sounding, measured from its own first onset. */
   get totalBeats() {
-    return _chunkJ7FHVZIIcjs.cellSpan.call(void 0, this.#cell);
+    return _chunk6TTBEON3cjs.cellSpan.call(void 0, this.#cell);
   }
   /** A copy of the underlying plain cell. */
   get data() {
@@ -6874,7 +7269,7 @@ var Motif = class _Motif {
    * ```
    */
   transform(kind, amount, key) {
-    return new _Motif(_chunkJ7FHVZIIcjs.transformMotif.call(void 0, this.#cell, kind, amount, key));
+    return new _Motif(_chunk6TTBEON3cjs.transformMotif.call(void 0, this.#cell, kind, amount, key));
   }
   /**
    * The cell laid across a span and snapped to the harmony under it.
@@ -6896,7 +7291,7 @@ var Motif = class _Motif {
    */
   develop(timeline, key, bars, ts) {
     const chords = "chordTimeline" in timeline ? timeline.chordTimeline : timeline;
-    return new _Motif(_chunkJ7FHVZIIcjs.developMotif.call(void 0, this.#cell, chords, key, bars, ts));
+    return new _Motif(_chunk6TTBEON3cjs.developMotif.call(void 0, this.#cell, chords, key, bars, ts));
   }
   /**
    * How this motif stands to another: the transformation that turns one into
@@ -6910,7 +7305,7 @@ var Motif = class _Motif {
    * @returns The relation, or null when the two stand in none.
    */
   relateTo(other, key) {
-    return _chunkHPVSH7SFcjs.relateMotifs.call(void 0, _chunkHPVSH7SFcjs.motifFromNotes.call(void 0, this.#cell.notes), _chunkHPVSH7SFcjs.motifFromNotes.call(void 0, other.notes), key);
+    return _chunkLQZQDBCDcjs.relateMotifs.call(void 0, _chunkLQZQDBCDcjs.motifFromNotes.call(void 0, this.#cell.notes), _chunkLQZQDBCDcjs.motifFromNotes.call(void 0, other.notes), key);
   }
   /**
    * How alike two lines are, in [0, 1].
@@ -6923,7 +7318,7 @@ var Motif = class _Motif {
    * @returns The likeness: 1 for the same line, a transposition of it included.
    */
   similarityTo(other) {
-    return _chunkHPVSH7SFcjs.melodicSimilarity.call(void 0, this.#cell.notes, other.notes);
+    return _chunkLQZQDBCDcjs.melodicSimilarity.call(void 0, this.#cell.notes, other.notes);
   }
   /**
    * The cell as a score, so it reaches the rest of the class API.
@@ -6933,7 +7328,7 @@ var Motif = class _Motif {
    * @returns The score holding the cell.
    */
   toScore(opts) {
-    return Score.of(_chunkJ7FHVZIIcjs.motifToNoteEvents.call(void 0, this.#cell), opts);
+    return Score.of(_chunk6TTBEON3cjs.motifToNoteEvents.call(void 0, this.#cell), opts);
   }
   /**
    * Whether another motif holds the same notes in the same order.
@@ -6966,10 +7361,10 @@ var PART = "rhythm";
 function copyEvent(event, name) {
   return {
     position: withoutNegativeZero(
-      _chunkS5BKZZGMcjs.assertRange.call(void 0, event.position, 0, Number.MAX_SAFE_INTEGER, `${name}.position`)
+      _chunkS3QELJUEcjs.assertRange.call(void 0, event.position, 0, Number.MAX_SAFE_INTEGER, `${name}.position`)
     ),
     duration: withoutNegativeZero(
-      _chunkS5BKZZGMcjs.assertRange.call(void 0, event.duration, 0, Number.MAX_SAFE_INTEGER, `${name}.duration`)
+      _chunkS3QELJUEcjs.assertRange.call(void 0, event.duration, 0, Number.MAX_SAFE_INTEGER, `${name}.duration`)
     )
   };
 }
@@ -6988,13 +7383,13 @@ function spanOf(events) {
 }
 function toGrid(events) {
   return events.map((event) => ({
-    step: event.position / _chunkJ7FHVZIIcjs.STEP_BEATS,
+    step: event.position / _chunk6TTBEON3cjs.STEP_BEATS,
     velocity: GRID_VELOCITY,
     source: event
   }));
 }
 function fromGrid(events, spanBeats) {
-  const positions = [...new Set(events.map((event) => event.step * _chunkJ7FHVZIIcjs.STEP_BEATS))].sort(
+  const positions = [...new Set(events.map((event) => event.step * _chunk6TTBEON3cjs.STEP_BEATS))].sort(
     (a, b) => a - b
   );
   return positions.map((position, index) => ({
@@ -7034,8 +7429,8 @@ var Rhythm = class _Rhythm {
    * ```
    */
   static generate(ts, opts) {
-    const meter = _chunkS5BKZZGMcjs.meterAt.call(void 0, 0, _chunkS5BKZZGMcjs.toMeterData.call(void 0, ts, "ts"));
-    return new _Rhythm({ events: _chunkJ7FHVZIIcjs.generateRhythm.call(void 0, meter, opts), ts: meter });
+    const meter = _chunkS3QELJUEcjs.meterAt.call(void 0, 0, _chunkS3QELJUEcjs.toMeterData.call(void 0, ts, "ts"));
+    return new _Rhythm({ events: _chunk6TTBEON3cjs.generateRhythm.call(void 0, meter, opts), ts: meter });
   }
   /**
    * Build a pattern from onsets that already exist.
@@ -7055,7 +7450,7 @@ var Rhythm = class _Rhythm {
   static of(events, ts) {
     return new _Rhythm({
       events: [...assertDataArray(events, "rhythm events")],
-      ts: _chunkS5BKZZGMcjs.meterAt.call(void 0, 0, _chunkS5BKZZGMcjs.toMeterData.call(void 0, ts, "ts"))
+      ts: _chunkS3QELJUEcjs.meterAt.call(void 0, 0, _chunkS3QELJUEcjs.toMeterData.call(void 0, ts, "ts"))
     });
   }
   /** Rebuild a pattern from the plain data {@link Rhythm.data} hands out. */
@@ -7091,7 +7486,7 @@ var Rhythm = class _Rhythm {
    * @returns The onset count divided by the number of bars it spans.
    */
   density() {
-    return _chunkJ7FHVZIIcjs.rhythmDensity.call(void 0, this.#data.events, this.#data.ts);
+    return _chunk6TTBEON3cjs.rhythmDensity.call(void 0, this.#data.events, this.#data.ts);
   }
   /**
    * Drop the onsets carrying the least of the metre.
@@ -7106,7 +7501,7 @@ var Rhythm = class _Rhythm {
    * @throws If the amount is outside [0, 1].
    */
   thin(amount) {
-    return this.#withGrid(_chunkJ7FHVZIIcjs.thin.call(void 0, toGrid(this.#data.events), amount, this.#data.ts));
+    return this.#withGrid(_chunk6TTBEON3cjs.thin.call(void 0, toGrid(this.#data.events), amount, this.#data.ts));
   }
   /**
    * Anticipate beats, one sixteenth early.
@@ -7125,10 +7520,10 @@ var Rhythm = class _Rhythm {
    */
   syncopate(amount, ctx) {
     return this.#withGrid(
-      _chunkJ7FHVZIIcjs.syncopate.call(void 0, 
+      _chunk6TTBEON3cjs.syncopate.call(void 0, 
         toGrid(this.#data.events),
         { amount, ts: this.#data.ts },
-        _chunkJ7FHVZIIcjs.resolveContext.call(void 0, ctx).part(PART)
+        _chunk6TTBEON3cjs.resolveContext.call(void 0, ctx).part(PART)
       )
     );
   }
@@ -7140,7 +7535,7 @@ var Rhythm = class _Rhythm {
    * @returns The compressed pattern.
    */
   doubleTime() {
-    return this.#withGrid(_chunkJ7FHVZIIcjs.doubleTime.call(void 0, toGrid(this.#data.events), this.#spanSteps()));
+    return this.#withGrid(_chunk6TTBEON3cjs.doubleTimeFigure.call(void 0, toGrid(this.#data.events), this.#spanSteps()));
   }
   /**
    * Stretch the pattern to twice its length: everything falls half as often.
@@ -7151,7 +7546,7 @@ var Rhythm = class _Rhythm {
    * @returns The stretched pattern.
    */
   halfTime() {
-    return this.#withGrid(_chunkJ7FHVZIIcjs.halfTime.call(void 0, toGrid(this.#data.events), this.#spanSteps()));
+    return this.#withGrid(_chunk6TTBEON3cjs.halfTimeFigure.call(void 0, toGrid(this.#data.events), this.#spanSteps()));
   }
   /**
    * Keep as much decoration as the ornament dial asks for.
@@ -7168,11 +7563,11 @@ var Rhythm = class _Rhythm {
    */
   ornamentBy(isOrnament, amount, ctx) {
     return this.#withGrid(
-      _chunkJ7FHVZIIcjs.ornamentBy.call(void 0, 
+      _chunk6TTBEON3cjs.ornamentBy.call(void 0, 
         toGrid(this.#data.events),
         (grid) => isOrnament(grid.source),
         amount,
-        _chunkJ7FHVZIIcjs.resolveContext.call(void 0, ctx).part(PART)
+        _chunk6TTBEON3cjs.resolveContext.call(void 0, ctx).part(PART)
       )
     );
   }
@@ -7192,20 +7587,22 @@ var Rhythm = class _Rhythm {
    * @throws If a dial is outside [0, 1].
    */
   deform(opts, ctx) {
-    const resolved = _chunkJ7FHVZIIcjs.resolveContext.call(void 0, ctx);
-    const isOrnament = _optionalChain([opts, 'optionalAccess', _55 => _55.isOrnament]);
+    const resolved = _chunk6TTBEON3cjs.resolveContext.call(void 0, ctx);
+    const isOrnament = _optionalChain([opts, 'optionalAccess', _67 => _67.isOrnament]);
     const options = {
       rhythmic: resolved.rhythmic,
       ornament: resolved.ornament,
-      rate: _optionalChain([opts, 'optionalAccess', _56 => _56.rate]),
-      spanSteps: this.#spanSteps(),
+      rate: _optionalChain([opts, 'optionalAccess', _68 => _68.rate]),
       ts: this.#data.ts,
       // The transform hands the predicate the events it was given, which carry
       // the onset each was built from; the parameter is declared over the bare
       // grid event the rule reads, so the field is named back here.
       isOrnament: isOrnament === void 0 ? void 0 : (grid) => isOrnament(grid.source)
     };
-    return this.#withGrid(_chunkJ7FHVZIIcjs.deform.call(void 0, toGrid(this.#data.events), options, resolved.part(PART)));
+    const dials = _chunk6TTBEON3cjs.resolveDials.call(void 0, options);
+    return this.#withGrid(
+      _chunk6TTBEON3cjs.deformFigure.call(void 0, toGrid(this.#data.events), this.#spanSteps(), dials, resolved.part(PART), [])
+    );
   }
   /**
    * Whether one player can sustain the pattern at the context's tempo.
@@ -7219,8 +7616,8 @@ var Rhythm = class _Rhythm {
    * @returns True when the pattern is inside the ceiling.
    */
   withinCeiling(ctx) {
-    const resolved = _chunkJ7FHVZIIcjs.resolveContext.call(void 0, ctx);
-    return _chunkJ7FHVZIIcjs.withinCeiling.call(void 0, toGrid(this.#data.events), resolved.bpm, resolved.difficulty);
+    const resolved = _chunk6TTBEON3cjs.resolveContext.call(void 0, ctx);
+    return _chunk6TTBEON3cjs.withinCeiling.call(void 0, toGrid(this.#data.events), resolved.bpm, resolved.difficulty);
   }
   /**
    * The pattern as sounding notes at one pitch, in its own meter.
@@ -7244,7 +7641,7 @@ var Rhythm = class _Rhythm {
    * ```
    */
   toScore(pitch, velocity) {
-    return Score.of(_chunkJ7FHVZIIcjs.rhythmToNoteEvents.call(void 0, this.#data.events, pitch, velocity), {
+    return Score.of(_chunk6TTBEON3cjs.rhythmToNoteEvents.call(void 0, this.#data.events, pitch, velocity), {
       meters: this.#data.ts
     });
   }
@@ -7266,9 +7663,13 @@ var Rhythm = class _Rhythm {
   toJSON() {
     return this.data;
   }
-  /** The pattern's span as a count of sixteenths, for the transforms. */
+  /**
+   * The pattern's span as a count of sixteenths, for the transforms: whatever
+   * span the pattern covers, an empty one or one ending off the straight grid
+   * included.
+   */
   #spanSteps() {
-    return spanOf(this.#data.events) / _chunkJ7FHVZIIcjs.STEP_BEATS;
+    return spanOf(this.#data.events) / _chunk6TTBEON3cjs.STEP_BEATS;
   }
   /** The same meter carrying the onsets a transform returned. */
   #withGrid(events) {
@@ -7293,7 +7694,7 @@ var MIN_BPM = 0.1;
 var Tempo = class _Tempo {
   #bpm;
   constructor(bpm) {
-    this.#bpm = _chunkS5BKZZGMcjs.assertRange.call(void 0, bpm, MIN_BPM, MAX_BPM, "bpm");
+    this.#bpm = _chunkS3QELJUEcjs.assertRange.call(void 0, bpm, MIN_BPM, MAX_BPM, "bpm");
   }
   /**
    * The one-event tempo map every conversion here is measured against.
@@ -7353,7 +7754,7 @@ var Tempo = class _Tempo {
    * @throws If the position is not finite.
    */
   secondsAt(beat) {
-    return _chunkNM7UAMC3cjs.beatsToSeconds.call(void 0, beat, this.#map);
+    return _chunk3FDBMIPRcjs.beatsToSeconds.call(void 0, beat, this.#map);
   }
   /**
    * The position reached after a number of seconds — the inverse of
@@ -7370,7 +7771,7 @@ var Tempo = class _Tempo {
    * ```
    */
   beatAtSeconds(seconds) {
-    return _chunkNM7UAMC3cjs.secondsToBeats.call(void 0, seconds, this.#map);
+    return _chunk3FDBMIPRcjs.secondsToBeats.call(void 0, seconds, this.#map);
   }
   /**
    * Duration in seconds of a span of beats.
@@ -7383,7 +7784,7 @@ var Tempo = class _Tempo {
    * @throws If the length is negative or not finite.
    */
   secondsOf(lengthBeats) {
-    return _chunkNM7UAMC3cjs.durationToSeconds.call(void 0, 0, lengthBeats, this.#map);
+    return _chunk3FDBMIPRcjs.durationToSeconds.call(void 0, 0, lengthBeats, this.#map);
   }
   /**
    * Convert quarter-note beats to MIDI ticks, rounded to the nearest tick.
@@ -7394,7 +7795,7 @@ var Tempo = class _Tempo {
    * @throws If the position is not finite or `ppq` is not a positive integer.
    */
   ticksAt(beat, ppq) {
-    return _chunkNM7UAMC3cjs.beatsToTicks.call(void 0, beat, ppq);
+    return _chunk3FDBMIPRcjs.beatsToTicks.call(void 0, beat, ppq);
   }
   /**
    * Convert MIDI ticks to quarter-note beats.
@@ -7405,7 +7806,7 @@ var Tempo = class _Tempo {
    * @throws If `ticks` is not an integer or `ppq` is not a positive integer.
    */
   beatAtTicks(ticks, ppq) {
-    return _chunkNM7UAMC3cjs.ticksToBeats.call(void 0, ticks, ppq);
+    return _chunk3FDBMIPRcjs.ticksToBeats.call(void 0, ticks, ppq);
   }
   /**
    * Whether another tempo carries the same marking.
@@ -7465,10 +7866,10 @@ var Tuning = class _Tuning {
    */
   static of(table) {
     const given = assertDataObject(table, "tuning table");
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, given.divisions, "tuning table.divisions");
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, given.refFreq, "tuning table.refFreq");
-    _chunkS5BKZZGMcjs.assertFiniteNumber.call(void 0, given.refStep, "tuning table.refStep");
-    return new _Tuning(_chunkNM7UAMC3cjs.edo.call(void 0, given.divisions, given.refFreq, given.refStep));
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, given.divisions, "tuning table.divisions");
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, given.refFreq, "tuning table.refFreq");
+    _chunkS3QELJUEcjs.assertFiniteNumber.call(void 0, given.refStep, "tuning table.refStep");
+    return new _Tuning(_chunk3FDBMIPRcjs.edo.call(void 0, given.divisions, given.refFreq, given.refStep));
   }
   /**
    * Build an equal temperament with `divisions` divisions of the octave.
@@ -7489,7 +7890,7 @@ var Tuning = class _Tuning {
    * ```
    */
   static edo(divisions, refFreq, refStep) {
-    return new _Tuning(_chunkNM7UAMC3cjs.edo.call(void 0, divisions, refFreq, refStep));
+    return new _Tuning(_chunk3FDBMIPRcjs.edo.call(void 0, divisions, refFreq, refStep));
   }
   /**
    * Standard twelve-tone equal temperament, A4 (MIDI 69) = 440 Hz.
@@ -7502,7 +7903,7 @@ var Tuning = class _Tuning {
    * ```
    */
   static twelveTet() {
-    return _Tuning.of(_chunkNM7UAMC3cjs.TWELVE_TET);
+    return _Tuning.of(_chunk3FDBMIPRcjs.TWELVE_TET);
   }
   /**
    * Rebuild a tuning from the plain table {@link Tuning.data} hands out.
@@ -7541,7 +7942,7 @@ var Tuning = class _Tuning {
    * ```
    */
   static ratioToCents(numerator, denominator) {
-    return _chunkNM7UAMC3cjs.ratioToCents.call(void 0, numerator, denominator);
+    return _chunk3FDBMIPRcjs.ratioToCents.call(void 0, numerator, denominator);
   }
   /**
    * The frequency ratio an interval in cents spans, the inverse of
@@ -7559,7 +7960,7 @@ var Tuning = class _Tuning {
    * ```
    */
   static centsToRatio(cents) {
-    return _chunkNM7UAMC3cjs.centsToRatio.call(void 0, cents);
+    return _chunk3FDBMIPRcjs.centsToRatio.call(void 0, cents);
   }
   /**
    * Interval in cents between two frequencies.
@@ -7575,7 +7976,7 @@ var Tuning = class _Tuning {
    * ```
    */
   static centsBetweenFreq(a, b) {
-    return _chunkNM7UAMC3cjs.centsBetweenFreq.call(void 0, a, b);
+    return _chunk3FDBMIPRcjs.centsBetweenFreq.call(void 0, a, b);
   }
   /**
    * Cents by which a five-limit just interval departs from its 12-TET
@@ -7591,7 +7992,7 @@ var Tuning = class _Tuning {
    * ```
    */
   static justDeviationCents(semitoneClass) {
-    return _chunkNM7UAMC3cjs.justDeviationCents.call(void 0, semitoneClass);
+    return _chunk3FDBMIPRcjs.justDeviationCents.call(void 0, semitoneClass);
   }
   /** Step index whose frequency is {@link Tuning.refFreq}. */
   get refStep() {
@@ -7633,7 +8034,7 @@ var Tuning = class _Tuning {
    * ```
    */
   frequencyOf(note, tuning = this.#table) {
-    return _chunkNM7UAMC3cjs.frequencyOf.call(void 0, _chunkS5BKZZGMcjs.noteToMidi.call(void 0, _chunkS5BKZZGMcjs.toNoteData.call(void 0, note)), tuning);
+    return _chunk3FDBMIPRcjs.frequencyOf.call(void 0, _chunkS3QELJUEcjs.noteToMidi.call(void 0, _chunkS3QELJUEcjs.toNoteData.call(void 0, note)), tuning);
   }
   /**
    * Frequency in Hz of a step index.
@@ -7655,7 +8056,7 @@ var Tuning = class _Tuning {
    * ```
    */
   frequencyOfStep(step, tuning = this.#table) {
-    return _chunkNM7UAMC3cjs.frequencyOf.call(void 0, step, tuning);
+    return _chunk3FDBMIPRcjs.frequencyOf.call(void 0, step, tuning);
   }
   /**
    * Nearest step index to a frequency, the rounded inverse of
@@ -7672,7 +8073,7 @@ var Tuning = class _Tuning {
    * ```
    */
   nearestStep(freq, tuning = this.#table) {
-    return _chunkNM7UAMC3cjs.nearestStep.call(void 0, freq, tuning);
+    return _chunk3FDBMIPRcjs.nearestStep.call(void 0, freq, tuning);
   }
   /**
    * Step index of a frequency, unrounded.
@@ -7692,7 +8093,7 @@ var Tuning = class _Tuning {
    * ```
    */
   stepOf(freq, tuning = this.#table) {
-    return _chunkNM7UAMC3cjs.stepOf.call(void 0, freq, tuning);
+    return _chunk3FDBMIPRcjs.stepOf.call(void 0, freq, tuning);
   }
   /**
    * How far a frequency sits from its nearest step, in cents; positive means
@@ -7709,7 +8110,7 @@ var Tuning = class _Tuning {
    * ```
    */
   centsFromNearestStep(freq, tuning = this.#table) {
-    return _chunkNM7UAMC3cjs.centsFromNearestStep.call(void 0, freq, tuning);
+    return _chunk3FDBMIPRcjs.centsFromNearestStep.call(void 0, freq, tuning);
   }
   /**
    * Cents spanned by a number of steps.
@@ -7725,7 +8126,7 @@ var Tuning = class _Tuning {
    * ```
    */
   centsOfSteps(steps, tuning = this.#table) {
-    return _chunkNM7UAMC3cjs.centsOfSteps.call(void 0, steps, tuning);
+    return _chunk3FDBMIPRcjs.centsOfSteps.call(void 0, steps, tuning);
   }
   /**
    * Steps spanned by an interval in cents, unrounded — the inverse of
@@ -7742,7 +8143,7 @@ var Tuning = class _Tuning {
    * ```
    */
   stepsOfCents(cents, tuning = this.#table) {
-    return _chunkNM7UAMC3cjs.stepsOfCents.call(void 0, cents, tuning);
+    return _chunk3FDBMIPRcjs.stepsOfCents.call(void 0, cents, tuning);
   }
   /**
    * Whether another tuning divides the octave the same way from the same
@@ -7791,17 +8192,17 @@ var Tuning = class _Tuning {
 function copyPitches(pitches) {
   assertDataArray(pitches, "voicing pitches");
   if (pitches.length === 0) {
-    throw new (0, _chunkS5BKZZGMcjs.InvalidInputError)("a voicing must contain at least one pitch");
+    throw new (0, _chunkS3QELJUEcjs.InvalidInputError)("a voicing must contain at least one pitch");
   }
-  return pitches.map((pitch, index) => _chunkS5BKZZGMcjs.assertMidiPitch.call(void 0, pitch, `pitches[${index}]`));
+  return pitches.map((pitch, index) => _chunkS3QELJUEcjs.assertMidiPitch.call(void 0, pitch, `pitches[${index}]`));
 }
 function spellLine(line, key) {
   return line.map(
-    (value) => typeof value === "number" ? _chunk3R3QVKY5cjs.spellPitch.call(void 0, value, key.tonic, key) : _chunkS5BKZZGMcjs.toNoteData.call(void 0, value)
+    (value) => typeof value === "number" ? _chunkYDGMWH43cjs.spellPitch.call(void 0, value, key.tonic, key) : _chunkS3QELJUEcjs.toNoteData.call(void 0, value)
   );
 }
 function lineOf(pitches, key) {
-  return key === void 0 ? pitches.map((pitch) => _chunkS5BKZZGMcjs.toNoteData.call(void 0, pitch)) : spellLine(pitches, key);
+  return key === void 0 ? pitches.map((pitch) => _chunkS3QELJUEcjs.toNoteData.call(void 0, pitch)) : spellLine(pitches, key);
 }
 function carriedKeyOf(chord) {
   if (typeof chord !== "object" || chord === null) {
@@ -7811,7 +8212,7 @@ function carriedKeyOf(chord) {
   return typeof key === "object" && key !== null ? key : void 0;
 }
 function withCarriedKey(chord, opts) {
-  if (_optionalChain([opts, 'optionalAccess', _57 => _57.key]) !== void 0) {
+  if (_optionalChain([opts, 'optionalAccess', _69 => _69.key]) !== void 0) {
     return opts;
   }
   const key = carriedKeyOf(chord);
@@ -7857,7 +8258,7 @@ var Voicing = class _Voicing {
    * ```
    */
   static forChord(chord, opts) {
-    return new _Voicing(_chunk76ZBTRG2cjs.voiceChordStyled.call(void 0, chord, opts));
+    return new _Voicing(_chunkU4EQTDGNcjs.voiceChordStyled.call(void 0, chord, opts));
   }
   /**
    * Realize a chord as one pitch per voice inside the voice ranges, defaulting
@@ -7881,7 +8282,7 @@ var Voicing = class _Voicing {
    * ```
    */
   static satb(chord, opts) {
-    return new _Voicing(_chunk76ZBTRG2cjs.voiceChord.call(void 0, _chunk3R3QVKY5cjs.toChordData.call(void 0, chord), withCarriedKey(chord, opts)));
+    return new _Voicing(_chunkU4EQTDGNcjs.voiceChord.call(void 0, _chunkYDGMWH43cjs.toChordData.call(void 0, chord), withCarriedKey(chord, opts)));
   }
   /**
    * Wrap a plain pitch array, as {@link Voicing.data} hands it out.
@@ -7909,7 +8310,7 @@ var Voicing = class _Voicing {
    * four-voice exercise against.
    */
   static get satbRanges() {
-    return _chunk76ZBTRG2cjs.SATB_RANGES.map((range) => ({ min: range.min, max: range.max }));
+    return _chunkU4EQTDGNcjs.SATB_RANGES.map((range) => ({ min: range.min, max: range.max }));
   }
   /** A copy of the sounding MIDI pitches, lowest voice first. */
   get pitches() {
@@ -7952,7 +8353,7 @@ var Voicing = class _Voicing {
    */
   spell(key, chord) {
     assertKeyArgument(key, "voicing key");
-    return this.#spelled(_chunk3R3QVKY5cjs.resolveKey.call(void 0, key), chord).map((note) => new Note(note));
+    return this.#spelled(_chunkYDGMWH43cjs.resolveKey.call(void 0, key), chord).map((note) => new Note(note));
   }
   /**
    * Voice a chord to follow smoothly from this voicing.
@@ -7982,7 +8383,7 @@ var Voicing = class _Voicing {
    * ```
    */
   next(chord, opts) {
-    return new _Voicing(_chunk76ZBTRG2cjs.nextVoicing.call(void 0, this.pitches, _chunk3R3QVKY5cjs.toChordData.call(void 0, chord), withCarriedKey(chord, opts)));
+    return new _Voicing(_chunkU4EQTDGNcjs.nextVoicing.call(void 0, this.pitches, _chunkYDGMWH43cjs.toChordData.call(void 0, chord), withCarriedKey(chord, opts)));
   }
   /**
    * The voice-leading cost from this voicing to another: the summed absolute
@@ -7994,7 +8395,7 @@ var Voicing = class _Voicing {
    *   voices and are therefore not comparable.
    */
   costTo(other) {
-    return _chunk76ZBTRG2cjs.voiceLeadingCost.call(void 0, this.pitches, other.pitches);
+    return _chunkU4EQTDGNcjs.voiceLeadingCost.call(void 0, this.pitches, other.pitches);
   }
   /**
    * Check the motion from this voicing to another against the four-part rules,
@@ -8025,14 +8426,14 @@ var Voicing = class _Voicing {
    */
   checkTo(other, chords, key, opts) {
     assertKeyArgument(key, "voicing key");
-    const resolved = _chunk3R3QVKY5cjs.resolveKey.call(void 0, key);
-    const from = _chunk3R3QVKY5cjs.toChordData.call(void 0, chords[0]);
-    const to = _chunk3R3QVKY5cjs.toChordData.call(void 0, chords[1]);
+    const resolved = _chunkYDGMWH43cjs.resolveKey.call(void 0, key);
+    const from = _chunkYDGMWH43cjs.toChordData.call(void 0, chords[0]);
+    const to = _chunkYDGMWH43cjs.toChordData.call(void 0, chords[1]);
     const voicings = [
-      _chunk76ZBTRG2cjs.spellVoicing.call(void 0, this.pitches, from, resolved),
-      _chunk76ZBTRG2cjs.spellVoicing.call(void 0, other.pitches, to, resolved)
+      _chunkU4EQTDGNcjs.spellVoicing.call(void 0, this.pitches, from, resolved),
+      _chunkU4EQTDGNcjs.spellVoicing.call(void 0, other.pitches, to, resolved)
     ];
-    return _chunk76ZBTRG2cjs.checkPartWriting.call(void 0, voicings, [from, to], resolved, opts);
+    return _chunkU4EQTDGNcjs.checkPartWriting.call(void 0, voicings, [from, to], resolved, opts);
   }
   /**
    * Mark this voicing, read as a written counterpoint line, against a cantus
@@ -8062,8 +8463,8 @@ var Voicing = class _Voicing {
    */
   species(cantusFirmus, species, mode, opts) {
     assertKeyArgument(mode, "voicing mode");
-    const resolved = _chunk3R3QVKY5cjs.resolveKey.call(void 0, mode);
-    return _chunk76ZBTRG2cjs.checkSpecies.call(void 0, 
+    const resolved = _chunkYDGMWH43cjs.resolveKey.call(void 0, mode);
+    return _chunkU4EQTDGNcjs.checkSpecies.call(void 0, 
       spellLine(cantusFirmus, resolved),
       spellLine(this.#pitches, resolved),
       species,
@@ -8089,8 +8490,8 @@ var Voicing = class _Voicing {
    */
   independence(other, opts) {
     const { key, ...rest } = _nullishCoalesce(opts, () => ( {}));
-    const resolved = key === void 0 ? void 0 : _chunk3R3QVKY5cjs.resolveKey.call(void 0, key);
-    return _chunk3R3QVKY5cjs.voiceIndependence.call(void 0, 
+    const resolved = key === void 0 ? void 0 : _chunkYDGMWH43cjs.resolveKey.call(void 0, key);
+    return _chunkYDGMWH43cjs.voiceIndependence.call(void 0, 
       lineOf(this.#pitches, resolved),
       lineOf(other.pitches, resolved),
       rest
@@ -8121,7 +8522,7 @@ var Voicing = class _Voicing {
    * ```
    */
   safetyOf(pitch, query, opts) {
-    return _chunk3R3QVKY5cjs.evaluateSafety.call(void 0, { ...this.#context(query), candidatePitch: pitch }, opts);
+    return _chunkYDGMWH43cjs.evaluateSafety.call(void 0, { ...this.#context(query), candidatePitch: pitch }, opts);
   }
   /**
    * Enumerate the pitches placeable against these voices in a range, chord
@@ -8136,7 +8537,7 @@ var Voicing = class _Voicing {
    *   bound is not a MIDI pitch in 0..127 or is reversed.
    */
   safePitches(query, pitchLow, pitchHigh) {
-    return _chunk3R3QVKY5cjs.enumerateSafePitches.call(void 0, this.#context(query), pitchLow, pitchHigh);
+    return _chunkYDGMWH43cjs.enumerateSafePitches.call(void 0, this.#context(query), pitchLow, pitchHigh);
   }
   /**
    * The n-th inversion of the voicing: the lowest voice taken up an octave, n
@@ -8160,7 +8561,7 @@ var Voicing = class _Voicing {
    * ```
    */
   invert(n) {
-    _chunkS5BKZZGMcjs.assertInteger.call(void 0, n, "voicing inversion", -128, 128);
+    _chunkS3QELJUEcjs.assertInteger.call(void 0, n, "voicing inversion", -128, 128);
     if (n === 0) {
       return this;
     }
@@ -8169,7 +8570,7 @@ var Voicing = class _Voicing {
       const index = n > 0 ? 0 : pitches.length - 1;
       const pitch = pitches[index] + (n > 0 ? 12 : -12);
       pitches.splice(index, 1);
-      pitches.push(_chunkS5BKZZGMcjs.assertMidiPitch.call(void 0, pitch, "inverted voice"));
+      pitches.push(_chunkS3QELJUEcjs.assertMidiPitch.call(void 0, pitch, "inverted voice"));
       pitches.sort((a, b) => a - b);
     }
     return new _Voicing(pitches);
@@ -8209,19 +8610,19 @@ var Voicing = class _Voicing {
   }
   /** Spell the voicing, by the key alone or against a chord as well. */
   #spelled(key, chord) {
-    return chord === void 0 ? spellLine(this.#pitches, key) : _chunk76ZBTRG2cjs.spellVoicing.call(void 0, this.pitches, _chunk3R3QVKY5cjs.toChordData.call(void 0, chord), key);
+    return chord === void 0 ? spellLine(this.#pitches, key) : _chunkU4EQTDGNcjs.spellVoicing.call(void 0, this.pitches, _chunkYDGMWH43cjs.toChordData.call(void 0, chord), key);
   }
   /** The safety context these voices supply, minus the candidate pitch. */
   #context(query) {
-    const previous = _optionalChain([query, 'access', _58 => _58.previous, 'optionalAccess', _59 => _59.pitches]);
+    const previous = _optionalChain([query, 'access', _70 => _70.previous, 'optionalAccess', _71 => _71.pitches]);
     const otherVoices = this.#pitches.map((pitch, index) => {
-      const prevPitch = _optionalChain([previous, 'optionalAccess', _60 => _60[index]]);
+      const prevPitch = _optionalChain([previous, 'optionalAccess', _72 => _72[index]]);
       return prevPitch === void 0 ? { pitch } : { pitch, prevPitch };
     });
     return {
       profile: query.profile,
-      chord: query.chord === null ? null : _chunk3R3QVKY5cjs.toChordData.call(void 0, query.chord),
-      key: _chunk3R3QVKY5cjs.resolveKey.call(void 0, query.key).scale,
+      chord: query.chord === null ? null : _chunkYDGMWH43cjs.toChordData.call(void 0, query.chord),
+      key: _chunkYDGMWH43cjs.resolveKey.call(void 0, query.key).scale,
       otherVoices,
       strongBeat: query.strongBeat,
       prevPitch: query.prevPitch,
@@ -8250,4 +8651,4 @@ var Voicing = class _Voicing {
 
 
 exports.Interval = Interval; exports.Note = Note; exports.Timeline = Timeline; exports.Progression = Progression; exports.Chord = Chord; exports.Key = Key; exports.Score = Score; exports.Arrangement = Arrangement; exports.Instrument = Instrument; exports.Composer = Composer; exports.Duration = Duration; exports.Meter = Meter; exports.Motif = Motif; exports.Rhythm = Rhythm; exports.Tempo = Tempo; exports.Tuning = Tuning; exports.Voicing = Voicing;
-//# sourceMappingURL=chunk-DSMJRXCZ.cjs.map
+//# sourceMappingURL=chunk-HYSVSFNI.cjs.map