@libraz/libcantus 1.2.0 → 1.3.0

package/dist/{chunk-DSMJRXCZ.cjs → chunk-4R2LWV7E.cjs}

@@ -10,11 +10,11 @@
 
 
 
+var _chunkYFA7X2F6cjs = require('./chunk-YFA7X2F6.cjs');
 
 
 
 
-var _chunkHPVSH7SFcjs = require('./chunk-HPVSH7SF.cjs');
 
 
 
@@ -34,11 +34,17 @@ var _chunkHPVSH7SFcjs = require('./chunk-HPVSH7SF.cjs');
 
 
 
+var _chunkNM7UAMC3cjs = require('./chunk-NM7UAMC3.cjs');
+
+
+
+
+
+
 
 
 
 
-var _chunkNM7UAMC3cjs = require('./chunk-NM7UAMC3.cjs');
 
 
 
@@ -62,6 +68,7 @@ var _chunkNM7UAMC3cjs = require('./chunk-NM7UAMC3.cjs');
 
 
 
+var _chunkB2PW6EHNcjs = require('./chunk-B2PW6EHN.cjs');
 
 
 
@@ -69,7 +76,6 @@ var _chunkNM7UAMC3cjs = require('./chunk-NM7UAMC3.cjs');
 
 
 
-var _chunkJ7FHVZIIcjs = require('./chunk-J7FHVZII.cjs');
 
 
 
@@ -97,7 +103,8 @@ var _chunkJ7FHVZIIcjs = require('./chunk-J7FHVZII.cjs');
 
 
 
-var _chunkSGLEQVJHcjs = require('./chunk-SGLEQVJH.cjs');
+
+var _chunkIFZDWIKMcjs = require('./chunk-IFZDWIKM.cjs');
 
 
 
@@ -1160,7 +1167,7 @@ var Timeline = class _Timeline {
    * @returns The timeline.
    */
   static fromChords(spans, totalBeats, key) {
-    const timeline = _chunkSGLEQVJHcjs.chordTimelineFromChords.call(void 0, spans, totalBeats);
+    const timeline = _chunkIFZDWIKMcjs.chordTimelineFromChords.call(void 0, spans, totalBeats);
     const data = { segments: timeline.segments, totalBeats };
     if (key !== void 0) {
       data.keys = [
@@ -1184,7 +1191,7 @@ 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 { timeline, keys, segmentConfidence } = _chunkIFZDWIKMcjs.chordTimelineFromNotes.call(void 0, notes, opts);
     const totalBeats = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _5 => _5.totalBeats]), () => ( spanEnd(timeline.segments, keys)));
     return new _Timeline({ segments: timeline.segments, totalBeats, keys, segmentConfidence });
   }
@@ -1231,7 +1238,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 = _chunkIFZDWIKMcjs.chordAtBeat.call(void 0, this.#segments, beat);
     if (chord === null) {
       return null;
     }
@@ -1248,7 +1255,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 = _chunkIFZDWIKMcjs.prevailingKeyOf.call(void 0, this.#keys);
     return prevailing === null ? void 0 : toKey(prevailing);
   }
   /**
@@ -1320,7 +1327,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 _chunkIFZDWIKMcjs.reduceProgression.call(void 0, this.chordTimeline, this.#keyContext(), opts);
   }
   /**
    * The cadences the harmony arrives at.
@@ -1333,7 +1340,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 _chunkIFZDWIKMcjs.detectCadences.call(void 0, this.chordTimeline, this.#keyContext());
   }
   /**
    * The keys the chords themselves imply, in time order.
@@ -1362,7 +1369,7 @@ var Timeline = class _Timeline {
    * ```
    */
   modulations(opts) {
-    return _chunkSGLEQVJHcjs.detectModulations.call(void 0, this.#copySegments(), {
+    return _chunkIFZDWIKMcjs.detectModulations.call(void 0, this.#copySegments(), {
       totalBeats: this.#totalBeats,
       ...opts
     }).map(copyKeyRegion);
@@ -1385,7 +1392,7 @@ var Timeline = class _Timeline {
     return this.#segments.map((segment) => ({
       startBeat: segment.startBeat,
       endBeat: segment.endBeat,
-      roman: _chunkSGLEQVJHcjs.chordToRoman.call(void 0, segment.chord, keyAt(segment.startBeat), opts)
+      roman: _chunkIFZDWIKMcjs.chordToRoman.call(void 0, segment.chord, keyAt(segment.startBeat), opts)
     }));
   }
   /**
@@ -1500,7 +1507,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) => _chunkIFZDWIKMcjs.chordAtBeat.call(void 0, segments, beat), segments };
   }
   /** A fresh copy of the segments, which is what every reader is handed. */
   #copySegments() {
@@ -1508,8 +1515,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 = _chunkIFZDWIKMcjs.prevailingKeyOf.call(void 0, this.#keys);
+    return prevailing === null ? void 0 : toKey(_chunkIFZDWIKMcjs.keyLookup.call(void 0, this.#keys, prevailing)(beat));
   }
   /**
    * The key every beat of the timeline is read against, spelling and all.
@@ -1522,13 +1529,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 = _chunkIFZDWIKMcjs.prevailingKeyOf.call(void 0, this.#keys);
     if (prevailing === null) {
       throw new (0, _chunkS5BKZZGMcjs.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 _chunkIFZDWIKMcjs.keyLookup.call(void 0, this.#keys, prevailing);
   }
   /**
    * The pitch classes of that key, for the readings that want them.
@@ -1937,7 +1944,7 @@ var Progression = class _Progression {
     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 cadence = from !== void 0 && to !== void 0 ? _chunkIFZDWIKMcjs.detectCadence.call(void 0, from.data, to.data, resolved, {
       ...cadenceOpts,
       ...approach === void 0 ? {} : { approach: approach.data },
       ...voicing === void 0 ? {} : { voicing: this.#closingVoicing(voicing) }
@@ -2014,7 +2021,7 @@ var Progression = class _Progression {
       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]);
       found.push(
-        _chunkSGLEQVJHcjs.detectCadence.call(void 0, from.data, to.data, resolved, {
+        _chunkIFZDWIKMcjs.detectCadence.call(void 0, from.data, to.data, resolved, {
           ..._optionalChain([opts, 'optionalAccess', _12 => _12.alternatives]) === void 0 ? {} : { alternatives: opts.alternatives },
           ...approach === void 0 ? {} : { approach },
           ...pair === void 0 ? {} : { voicing: [_nullishCoalesce(pair[index - 1], () => ( [])), _nullishCoalesce(pair[index], () => ( []))] }
@@ -2056,7 +2063,7 @@ var Progression = class _Progression {
       );
     }
     const key = this.#resolveKey();
-    const chosen = _chunkJ7FHVZIIcjs.substituteChord.call(void 0, target.data, key, opts).find(
+    const chosen = _chunkB2PW6EHNcjs.substituteChord.call(void 0, target.data, key, opts).find(
       (candidate) => candidate.type === type
     );
     if (chosen === void 0) {
@@ -2446,7 +2453,7 @@ var Chord = class _Chord {
    * @returns Ranked chord interpretations (may be empty).
    */
   static detect(pitches, opts) {
-    return _chunkSGLEQVJHcjs.detectChord.call(void 0, pitches, opts).map(
+    return _chunkIFZDWIKMcjs.detectChord.call(void 0, pitches, opts).map(
       (match) => new _Chord(_chunk3R3QVKY5cjs.makeChord.call(void 0, match.rootPc, match.quality, match.bassPc))
     );
   }
@@ -2469,7 +2476,7 @@ var Chord = class _Chord {
    * ```
    */
   static detectMatches(pitches, opts) {
-    return _chunkSGLEQVJHcjs.detectChord.call(void 0, pitches, opts).map((match) => ({
+    return _chunkIFZDWIKMcjs.detectChord.call(void 0, pitches, opts).map((match) => ({
       chord: new _Chord(_chunk3R3QVKY5cjs.makeChord.call(void 0, match.rootPc, match.quality, match.bassPc)),
       match
     }));
@@ -2482,7 +2489,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 = _chunkIFZDWIKMcjs.detectChordBest.call(void 0, pitches, opts);
     return best === null ? null : new _Chord(best);
   }
   /** The root pitch class (0..11). */
@@ -2617,7 +2624,7 @@ 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);
+    return _chunkIFZDWIKMcjs.chordToRoman.call(void 0, this.#data, this.#resolveKey(key), opts);
   }
   /**
    * The chord's Roman numeral together with the reasoning behind it: the degree
@@ -2645,7 +2652,7 @@ var Chord = class _Chord {
    * ```
    */
   explain(key, opts) {
-    return _chunkSGLEQVJHcjs.explainRoman.call(void 0, this.#data, this.#resolveKey(key), opts);
+    return _chunkIFZDWIKMcjs.explainRoman.call(void 0, this.#data, this.#resolveKey(key), opts);
   }
   /**
    * The chord's harmonic function (tonic / subdominant / dominant) in a key.
@@ -2656,7 +2663,7 @@ 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));
+    return _chunkIFZDWIKMcjs.functionOf.call(void 0, this.#data, this.#resolveKey(key));
   }
   /**
    * Full functional analysis: function, borrowing, Roman numeral, and the
@@ -2676,7 +2683,7 @@ var Chord = class _Chord {
    * ```
    */
   analyze(key, opts) {
-    return _chunkSGLEQVJHcjs.analyzeChord.call(void 0, this.#data, this.#resolveKey(key), opts);
+    return _chunkIFZDWIKMcjs.analyzeChord.call(void 0, this.#data, this.#resolveKey(key), opts);
   }
   /**
    * Whether the chord is borrowed from the parallel mode (modal interchange).
@@ -2687,7 +2694,7 @@ 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));
+    return _chunkIFZDWIKMcjs.isBorrowedChord.call(void 0, this.#data, this.#resolveKey(key));
   }
   /**
    * The origin of a non-diatonic chord (parallel mode or Neapolitan), or null.
@@ -2698,7 +2705,7 @@ 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));
+    return _chunkIFZDWIKMcjs.borrowedSource.call(void 0, this.#data, this.#resolveKey(key));
   }
   /**
    * The chord written as the figures a bass would carry under it: `6`, `64`,
@@ -2750,7 +2757,7 @@ var Chord = class _Chord {
    * ```
    */
   substitutions(key, opts) {
-    return _chunkJ7FHVZIIcjs.substituteChord.call(void 0, this.#data, this.#resolveKey(key), opts);
+    return _chunkB2PW6EHNcjs.substituteChord.call(void 0, this.#data, this.#resolveKey(key), opts);
   }
   /**
    * The modal-interchange palette of the chord's key: the parallel mode's
@@ -2775,7 +2782,7 @@ var Chord = class _Chord {
    * ```
    */
   modalInterchange(key) {
-    return _chunkJ7FHVZIIcjs.modalInterchangePalette.call(void 0, this.#resolveKey(key));
+    return _chunkB2PW6EHNcjs.modalInterchangePalette.call(void 0, this.#resolveKey(key));
   }
   /**
    * The chord rendered as a lead-sheet symbol (e.g. `'Cmaj7'`, `'F#m7'`, `'C/G'`).
@@ -2827,7 +2834,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(_chunkB2PW6EHNcjs.negativeHarmonyMirror.call(void 0, this.#data, resolved), resolved);
   }
   /**
    * The V7 that tonicizes this chord: a dominant seventh a perfect fifth above
@@ -2845,7 +2852,7 @@ var Chord = class _Chord {
    * ```
    */
   secondaryDominant() {
-    return new _Chord(_chunkSGLEQVJHcjs.secondaryDominantOf.call(void 0, this.#given), this.#key);
+    return new _Chord(_chunkIFZDWIKMcjs.secondaryDominantOf.call(void 0, this.#given), this.#key);
   }
   /**
    * The n-th inversion: a copy whose bass is the chord tone `n` steps above the
@@ -3440,7 +3447,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 _chunkIFZDWIKMcjs.detectKey.call(void 0, pitches, opts).map((match) => _Key.#fromMatch(match));
   }
   /**
    * The single best key interpretation of a pitch set.
@@ -3455,7 +3462,7 @@ var Key = class _Key {
    * ```
    */
   static detectBest(pitches, opts) {
-    const best = _chunkSGLEQVJHcjs.detectKeyBest.call(void 0, pitches, opts);
+    const best = _chunkIFZDWIKMcjs.detectKeyBest.call(void 0, pitches, opts);
     return best === null ? null : _Key.#fromMatch(best).key;
   }
   /**
@@ -3485,7 +3492,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 _chunkIFZDWIKMcjs.isMinorKey.call(void 0, this.#scale);
   }
   /**
    * The key signature as a signed count of sharps (positive) or flats
@@ -3778,7 +3785,7 @@ var Key = class _Key {
    */
   pivotsTo(other) {
     assertKeyArgument(other, "key");
-    return _chunkSGLEQVJHcjs.pivotChords.call(void 0, this.#scale, other).map(({ chord, romanFrom, romanTo }) => ({
+    return _chunkIFZDWIKMcjs.pivotChords.call(void 0, this.#scale, other).map(({ chord, romanFrom, romanTo }) => ({
       chord: new Chord(chord, this),
       romanFrom,
       romanTo
@@ -4162,7 +4169,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(_chunkIFZDWIKMcjs.romanToChord.call(void 0, text, this), this);
   }
   /**
    * The augmented sixth chord of a kind, built in this key.
@@ -4183,7 +4190,7 @@ var Key = class _Key {
    * ```
    */
   augmentedSixth(kind) {
-    return new Chord(_chunkSGLEQVJHcjs.augmentedSixthChord.call(void 0, kind, keyIdentity(this)), this);
+    return new Chord(_chunkIFZDWIKMcjs.augmentedSixthChord.call(void 0, kind, keyIdentity(this)), this);
   }
   /**
    * Build a progression from Roman numerals in this key.
@@ -4411,6 +4418,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.
    *
@@ -4653,7 +4662,7 @@ var Score = class _Score {
    * @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(_chunkB2PW6EHNcjs.humanize.call(void 0, this.#data.notes, { ts: this.meterAt(0), ...opts }));
   }
   /**
    * The notes with ornaments added.
@@ -4666,7 +4675,7 @@ var Score = class _Score {
    * @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(_chunkB2PW6EHNcjs.ornament.call(void 0, this.#data.notes, { ts: this.meterAt(0), ...opts }));
   }
   /**
    * The notes placed on a groove template's slots.
@@ -4680,7 +4689,7 @@ var Score = class _Score {
    * @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(_chunkB2PW6EHNcjs.applyGrooveTemplate.call(void 0, this.#data.notes, template, this.meterAt(0)));
   }
   /**
    * The feel of the score's own timing, as a template another score can take on.
@@ -4704,7 +4713,7 @@ var Score = class _Score {
    * ```
    */
   grooveTemplate(subdivision) {
-    return _chunkJ7FHVZIIcjs.extractGrooveTemplate.call(void 0, this.#data.notes, this.meterAt(0), subdivision);
+    return _chunkB2PW6EHNcjs.extractGrooveTemplate.call(void 0, this.#data.notes, this.meterAt(0), subdivision);
   }
   /**
    * The harmony the notes spell out, in time.
@@ -4717,7 +4726,7 @@ 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() : _chunkIFZDWIKMcjs.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)),
@@ -4739,7 +4748,7 @@ var Score = class _Score {
     if (this.#key !== void 0) {
       return this.#key;
     }
-    const prevailing = _chunkSGLEQVJHcjs.prevailingKeyOf.call(void 0, this.#keyRegions());
+    const prevailing = _chunkIFZDWIKMcjs.prevailingKeyOf.call(void 0, this.#keyRegions());
     return prevailing === null ? void 0 : toKey(prevailing);
   }
   /**
@@ -4760,7 +4769,7 @@ var Score = class _Score {
       if (this.#key !== void 0) {
         return statedKeyRegions(this.#key, this.#data.notes, _nullishCoalesce(opts.totalBeats, () => ( this.totalBeats)));
       }
-      return _chunkSGLEQVJHcjs.keyTimelineFromNotes.call(void 0, this.#data.notes, { meters: this.#data.meters, ...opts });
+      return _chunkIFZDWIKMcjs.keyTimelineFromNotes.call(void 0, this.#data.notes, { meters: this.#data.meters, ...opts });
     }
     return this.#keyRegions().map(copyKeyRegion);
   }
@@ -4788,7 +4797,7 @@ var Score = class _Score {
    * ```
    */
   detectKeys(opts) {
-    return _chunkSGLEQVJHcjs.detectKeyFromNotes.call(void 0, this.#data.notes, opts).map(detectedKeyMatch);
+    return _chunkIFZDWIKMcjs.detectKeyFromNotes.call(void 0, this.#data.notes, opts).map(detectedKeyMatch);
   }
   /**
    * The phrases the notes fall into.
@@ -4800,7 +4809,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 _chunkYFA7X2F6cjs.phrasesFromTimeline.call(void 0, this.#chordTimeline(), this.#data.notes, {
       meters: this.#data.meters,
       ...this.#key === void 0 ? {} : { key: keyIdentity(this.#key) },
       ...opts
@@ -4820,7 +4829,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 _chunkYFA7X2F6cjs.structuralCadences.call(void 0, this.phrases(opts));
   }
   /**
    * The sections the score divides into.
@@ -4829,7 +4838,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 _chunkYFA7X2F6cjs.sectionsFromNotes.call(void 0, this.#data.notes, { meters: this.#data.meters, ...opts });
   }
   /**
    * The bar-level pulse above the meter.
@@ -4842,7 +4851,7 @@ 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, {
+    return _chunkYFA7X2F6cjs.hypermeter.call(void 0, this.#data.notes, this.#data.meters, {
       cadenceBeats: this.#cadenceBeats(),
       ...opts
     });
@@ -4884,7 +4893,7 @@ var Score = class _Score {
    * ```
    */
   motifs(opts) {
-    return _chunkHPVSH7SFcjs.extractMotifs.call(void 0, this.#data.notes, opts);
+    return _chunkIFZDWIKMcjs.extractMotifs.call(void 0, this.#data.notes, opts);
   }
   /**
    * The shape the melody traces.
@@ -4896,7 +4905,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 _chunkIFZDWIKMcjs.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', _37 => _37.timeline]) === void 0 ? _chunkYFA7X2F6cjs.referenceFromReadings.call(void 0, this.#data.notes, this.#chordAnalysis(), asked) : _chunkYFA7X2F6cjs.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 _chunkIFZDWIKMcjs.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 _chunkIFZDWIKMcjs.motifGraph.call(void 0, this.#data.notes, _chunkIFZDWIKMcjs.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 _chunkB2PW6EHNcjs.evaluateComposition.call(void 0, this.#data.notes, plan, opts);
   }
   /**
    * Each note's role in the harmony sounding under it.
@@ -4920,7 +5066,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 _chunkYFA7X2F6cjs.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 +5080,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 _chunkIFZDWIKMcjs.toVoiceNotes.call(void 0, this.#data.notes);
   }
   /**
    * Whether an instrument can play the score, and what makes it hard.
@@ -5114,7 +5260,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, () => ( _chunkIFZDWIKMcjs.chordTimelineFromNotes.call(void 0, this.#data.notes, this.#analysisOptions())));
     this.#chords = analysis;
     return analysis;
   }
@@ -5125,13 +5271,13 @@ 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 ? _chunkIFZDWIKMcjs.keyTimelineFromNotes.call(void 0, this.#data.notes, { meters: this.#data.meters }) : statedKeyRegions(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(
+    return _chunkIFZDWIKMcjs.detectCadences.call(void 0, this.#chordTimeline(), this.#keyContext(void 0)).map(
       (hit) => hit.atBeat
     );
   }
@@ -5156,8 +5302,8 @@ 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);
+    const prevailing = _nullishCoalesce(_chunkIFZDWIKMcjs.prevailingKeyOf.call(void 0, regions), () => ( keyIdentity(Key.major("C"))));
+    const keyAt = _chunkIFZDWIKMcjs.keyLookup.call(void 0, regions, prevailing);
     return (beat) => _chunk3R3QVKY5cjs.scaleOf.call(void 0, keyAt(beat));
   }
 };
@@ -5194,7 +5340,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 = _chunkYFA7X2F6cjs.trackRoleOf.call(void 0, track.role, `tracks[${index}].role`);
   }
   return copy;
 }
@@ -5273,7 +5419,7 @@ function copySettings(settings, trackCount) {
 }
 function copyArrangement(data) {
   assertDataObject(data, "arrangement data");
-  const budget = _optionalChain([data, 'access', _37 => _37.settings, 'optionalAccess', _38 => _38.budget]);
+  const budget = _optionalChain([data, 'access', _38 => _38.settings, 'optionalAccess', _39 => _39.budget]);
   const tracks = assertDataArray(data.tracks, "arrangement tracks").map(
     (track, index) => copyTrack(track, index, budget)
   );
@@ -5463,7 +5609,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', _40 => _40.#data, 'access', _41 => _41.settings, 'optionalAccess', _42 => _42.budget]))
       });
     }
     const session = this.#session().update(copied);
@@ -5488,7 +5634,7 @@ var Arrangement = class _Arrangement {
    * @returns One tension reading per sampled beat, in beat order.
    */
   tension(opts) {
-    return _chunkHPVSH7SFcjs.tensionCurveFrom.call(void 0, 
+    return _chunkYFA7X2F6cjs.tensionCurveFrom.call(void 0, 
       [...this.#data.tracks],
       this.#session().analysis,
       this.#layered(analysisOptionsOf(opts))
@@ -5514,7 +5660,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 _chunkYFA7X2F6cjs.analyzeArrangement.call(void 0, [...this.#data.tracks], this.#layered(analysisOptionsOf(opts)));
   }
   /**
    * The harmony the tracks spell out together, in time.
@@ -5532,6 +5678,70 @@ 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', _43 => _43.#data, 'access', _44 => _44.settings, 'optionalAccess', _45 => _45.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 _chunkYFA7X2F6cjs.referenceFromReadings.call(void 0, harmony, this.#session().analysis, {
+      meters: _optionalChain([this, 'access', _46 => _46.#data, 'access', _47 => _47.settings, 'optionalAccess', _48 => _48.meters]),
+      totalBeats: this.timeline().totalBeats,
+      ...melody.length === 0 ? {} : { melody },
+      ...opts
+    });
+  }
   /**
    * Whether another arrangement holds the same tracks under the same settings.
    *
@@ -5556,7 +5766,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, () => ( _chunkYFA7X2F6cjs.createArrangementSession.call(void 0, [...this.#data.tracks], this.#analysisOptions())));
     this.#open = open;
     return open;
   }
@@ -5596,12 +5806,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', _49 => _49.meters]) !== void 0) {
       opts.meters = settings.meters;
-    } else if (_optionalChain([settings, 'optionalAccess', _43 => _43.ts]) !== void 0) {
+    } else if (_optionalChain([settings, 'optionalAccess', _50 => _50.ts]) !== void 0) {
       opts.meters = settings.ts;
     }
-    if (_optionalChain([settings, 'optionalAccess', _44 => _44.key]) !== void 0) {
+    if (_optionalChain([settings, 'optionalAccess', _51 => _51.key]) !== void 0) {
       opts.key = settings.key;
     }
     return opts;
@@ -5982,7 +6192,7 @@ function copyOptions(options) {
   if (options.rng !== void 0) {
     copy.rng = options.rng;
   }
-  const resolved = _chunkJ7FHVZIIcjs.resolveContext.call(void 0, contextOf(copy));
+  const resolved = _chunkB2PW6EHNcjs.resolveContext.call(void 0, contextOf(copy));
   copy.seed = resolved.seed;
   copy.algorithmVersion = resolved.algorithmVersion;
   return copy;
@@ -6097,7 +6307,7 @@ 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 });
+    const chords = _chunkB2PW6EHNcjs.generateProgression.call(void 0, { ...opts, key, ts, ctx: this.context });
     return Timeline.fromChords(chords, opts.bars * _chunkS5BKZZGMcjs.beatsPerBar.call(void 0, ts), key);
   }
   /**
@@ -6117,7 +6327,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 = _chunkB2PW6EHNcjs.generateDrums.call(void 0, { ...opts, ts: this.#unchangingMeter("drums"), ctx: this.context });
     return Score.of(hits, this.#scoreOptions());
   }
   /**
@@ -6144,7 +6354,7 @@ 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 = _chunkB2PW6EHNcjs.generateBassLine.call(void 0, {
       ...rest,
       ...instrument === void 0 ? {} : { instrument: _chunkCGBADIO5cjs.toStringedProfile.call(void 0, instrument, "bass instrument") },
       segments,
@@ -6176,7 +6386,7 @@ 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 = _chunkB2PW6EHNcjs.generateCounterMelody.call(void 0, {
       ...rest,
       ...timeline === void 0 ? {} : { timeline: toChordTimeline(timeline) },
       melody: melody.notes,
@@ -6207,7 +6417,7 @@ var Composer = class _Composer {
    * ```
    */
   harmonize(melody, opts) {
-    const result = _chunkJ7FHVZIIcjs.harmonizeMelody.call(void 0, {
+    const result = _chunkB2PW6EHNcjs.harmonizeMelody.call(void 0, {
       ...opts,
       melody: melody.notes,
       ...this.#key === void 0 ? {} : { key: this.#key },
@@ -6228,6 +6438,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, _chunkS5BKZZGMcjs.InvalidInputError)(
+        "composer plan cannot record a caller-held rng; give the composer a seed instead"
+      );
+    }
+    return _chunkB2PW6EHNcjs.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 = _chunkB2PW6EHNcjs.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.
    *
@@ -6480,7 +6757,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', _52 => _52.#tuplet, 'optionalAccess', _53 => _53.actual]) === _optionalChain([b, 'access', _54 => _54.tuplet, 'optionalAccess', _55 => _55.actual]) && _optionalChain([this, 'access', _56 => _56.#tuplet, 'optionalAccess', _57 => _57.normal]) === _optionalChain([b, 'access', _58 => _58.tuplet, 'optionalAccess', _59 => _59.normal]);
   }
   /**
    * The plain duration, for JSON serialization.
@@ -6736,7 +7013,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', _60 => _60.grouping, 'optionalAccess', _61 => _61[index]]));
   }
   /**
    * The plain time signature, for JSON serialization.
@@ -6807,7 +7084,7 @@ var Motif = class _Motif {
    * ```
    */
   static generate(opts) {
-    return new _Motif(_chunkJ7FHVZIIcjs.generateMotif.call(void 0, { ...opts, chord: chordFrom(opts.chord) }));
+    return new _Motif(_chunkB2PW6EHNcjs.generateMotif.call(void 0, { ...opts, chord: chordFrom(opts.chord) }));
   }
   /**
    * Read a run of notes as a motif.
@@ -6837,7 +7114,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 _chunkB2PW6EHNcjs.cellSpan.call(void 0, this.#cell);
   }
   /** A copy of the underlying plain cell. */
   get data() {
@@ -6874,7 +7151,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(_chunkB2PW6EHNcjs.transformMotif.call(void 0, this.#cell, kind, amount, key));
   }
   /**
    * The cell laid across a span and snapped to the harmony under it.
@@ -6896,7 +7173,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(_chunkB2PW6EHNcjs.developMotif.call(void 0, this.#cell, chords, key, bars, ts));
   }
   /**
    * How this motif stands to another: the transformation that turns one into
@@ -6910,7 +7187,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 _chunkIFZDWIKMcjs.relateMotifs.call(void 0, _chunkIFZDWIKMcjs.motifFromNotes.call(void 0, this.#cell.notes), _chunkIFZDWIKMcjs.motifFromNotes.call(void 0, other.notes), key);
   }
   /**
    * How alike two lines are, in [0, 1].
@@ -6923,7 +7200,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 _chunkIFZDWIKMcjs.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 +7210,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(_chunkB2PW6EHNcjs.motifToNoteEvents.call(void 0, this.#cell), opts);
   }
   /**
    * Whether another motif holds the same notes in the same order.
@@ -6988,13 +7265,13 @@ function spanOf(events) {
 }
 function toGrid(events) {
   return events.map((event) => ({
-    step: event.position / _chunkJ7FHVZIIcjs.STEP_BEATS,
+    step: event.position / _chunkB2PW6EHNcjs.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 * _chunkB2PW6EHNcjs.STEP_BEATS))].sort(
     (a, b) => a - b
   );
   return positions.map((position, index) => ({
@@ -7035,7 +7312,7 @@ 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 });
+    return new _Rhythm({ events: _chunkB2PW6EHNcjs.generateRhythm.call(void 0, meter, opts), ts: meter });
   }
   /**
    * Build a pattern from onsets that already exist.
@@ -7091,7 +7368,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 _chunkB2PW6EHNcjs.rhythmDensity.call(void 0, this.#data.events, this.#data.ts);
   }
   /**
    * Drop the onsets carrying the least of the metre.
@@ -7106,7 +7383,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(_chunkB2PW6EHNcjs.thin.call(void 0, toGrid(this.#data.events), amount, this.#data.ts));
   }
   /**
    * Anticipate beats, one sixteenth early.
@@ -7125,10 +7402,10 @@ var Rhythm = class _Rhythm {
    */
   syncopate(amount, ctx) {
     return this.#withGrid(
-      _chunkJ7FHVZIIcjs.syncopate.call(void 0, 
+      _chunkB2PW6EHNcjs.syncopate.call(void 0, 
         toGrid(this.#data.events),
         { amount, ts: this.#data.ts },
-        _chunkJ7FHVZIIcjs.resolveContext.call(void 0, ctx).part(PART)
+        _chunkB2PW6EHNcjs.resolveContext.call(void 0, ctx).part(PART)
       )
     );
   }
@@ -7140,7 +7417,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(_chunkB2PW6EHNcjs.doubleTime.call(void 0, toGrid(this.#data.events), this.#spanSteps()));
   }
   /**
    * Stretch the pattern to twice its length: everything falls half as often.
@@ -7151,7 +7428,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(_chunkB2PW6EHNcjs.halfTime.call(void 0, toGrid(this.#data.events), this.#spanSteps()));
   }
   /**
    * Keep as much decoration as the ornament dial asks for.
@@ -7168,11 +7445,11 @@ var Rhythm = class _Rhythm {
    */
   ornamentBy(isOrnament, amount, ctx) {
     return this.#withGrid(
-      _chunkJ7FHVZIIcjs.ornamentBy.call(void 0, 
+      _chunkB2PW6EHNcjs.ornamentBy.call(void 0, 
         toGrid(this.#data.events),
         (grid) => isOrnament(grid.source),
         amount,
-        _chunkJ7FHVZIIcjs.resolveContext.call(void 0, ctx).part(PART)
+        _chunkB2PW6EHNcjs.resolveContext.call(void 0, ctx).part(PART)
       )
     );
   }
@@ -7192,12 +7469,12 @@ 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 = _chunkB2PW6EHNcjs.resolveContext.call(void 0, ctx);
+    const isOrnament = _optionalChain([opts, 'optionalAccess', _62 => _62.isOrnament]);
     const options = {
       rhythmic: resolved.rhythmic,
       ornament: resolved.ornament,
-      rate: _optionalChain([opts, 'optionalAccess', _56 => _56.rate]),
+      rate: _optionalChain([opts, 'optionalAccess', _63 => _63.rate]),
       spanSteps: this.#spanSteps(),
       ts: this.#data.ts,
       // The transform hands the predicate the events it was given, which carry
@@ -7205,7 +7482,7 @@ var Rhythm = class _Rhythm {
       // 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)));
+    return this.#withGrid(_chunkB2PW6EHNcjs.deform.call(void 0, toGrid(this.#data.events), options, resolved.part(PART)));
   }
   /**
    * Whether one player can sustain the pattern at the context's tempo.
@@ -7219,8 +7496,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 = _chunkB2PW6EHNcjs.resolveContext.call(void 0, ctx);
+    return _chunkB2PW6EHNcjs.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 +7521,7 @@ var Rhythm = class _Rhythm {
    * ```
    */
   toScore(pitch, velocity) {
-    return Score.of(_chunkJ7FHVZIIcjs.rhythmToNoteEvents.call(void 0, this.#data.events, pitch, velocity), {
+    return Score.of(_chunkB2PW6EHNcjs.rhythmToNoteEvents.call(void 0, this.#data.events, pitch, velocity), {
       meters: this.#data.ts
     });
   }
@@ -7268,7 +7545,7 @@ var Rhythm = class _Rhythm {
   }
   /** The pattern's span as a count of sixteenths, for the transforms. */
   #spanSteps() {
-    return spanOf(this.#data.events) / _chunkJ7FHVZIIcjs.STEP_BEATS;
+    return spanOf(this.#data.events) / _chunkB2PW6EHNcjs.STEP_BEATS;
   }
   /** The same meter carrying the onsets a transform returned. */
   #withGrid(events) {
@@ -7811,7 +8088,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', _64 => _64.key]) !== void 0) {
     return opts;
   }
   const key = carriedKeyOf(chord);
@@ -8213,9 +8490,9 @@ var Voicing = class _Voicing {
   }
   /** 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', _65 => _65.previous, 'optionalAccess', _66 => _66.pitches]);
     const otherVoices = this.#pitches.map((pitch, index) => {
-      const prevPitch = _optionalChain([previous, 'optionalAccess', _60 => _60[index]]);
+      const prevPitch = _optionalChain([previous, 'optionalAccess', _67 => _67[index]]);
       return prevPitch === void 0 ? { pitch } : { pitch, prevPitch };
     });
     return {
@@ -8250,4 +8527,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-4R2LWV7E.cjs.map