@libraz/libcantus 0.9.5 → 1.0.0

package/dist/chunk-WTAN4ACG.cjs

@@ -1,1548 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
-
-var _chunk357ZDPVUcjs = require('./chunk-357ZDPVU.cjs');
-
-
-
-
-
-
-
-
-
-
-
-
-
-var _chunkKQN2ZYNDcjs = require('./chunk-KQN2ZYND.cjs');
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-var _chunkOL3IHHSJcjs = require('./chunk-OL3IHHSJ.cjs');
-
-
-
-
-
-
-
-
-
-
-
-
-var _chunkBSLTLGM3cjs = require('./chunk-BSLTLGM3.cjs');
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-var _chunkPI3UXRWKcjs = require('./chunk-PI3UXRWK.cjs');
-
-// src/model/interval.ts
-var INVERSION_SUM = 9;
-function invertQuality(quality) {
-  if (quality === "P") {
-    return "P";
-  }
-  if (quality === "M") {
-    return "m";
-  }
-  if (quality === "m") {
-    return "M";
-  }
-  return quality.startsWith("A") ? `d${"d".repeat(quality.length - 1)}` : `A${"A".repeat(quality.length - 1)}`;
-}
-var Interval = class _Interval {
-  #number;
-  #quality;
-  #semitones;
-  #descending;
-  constructor(numberValue, quality, semitones, descending = semitones < 0) {
-    this.#number = numberValue;
-    this.#quality = quality;
-    this.#semitones = semitones;
-    this.#descending = descending;
-  }
-  /**
-   * The spelled interval between two notes.
-   *
-   * @param a The first note.
-   * @param b The second note.
-   * @returns The interval from `a` to `b`.
-   */
-  static between(a, b) {
-    return a.intervalTo(b);
-  }
-  /**
-   * Build an interval from explicit components.
-   *
-   * @param numberValue Diatonic size: 1 = unison, 2 = second, ... 8 = octave.
-   * @param quality Quality label: `'P'`, `'M'`, `'m'`, or repeated `'A'`/`'d'`.
-   * @param semitones Signed semitone span; its magnitude must be the span the
-   *   number and quality describe.
-   * @returns The interval.
-   * @throws If the three components do not describe the same interval — a
-   *   `P5` spanning 8 semitones is not a value any other method can produce.
-   */
-  static of(numberValue, quality, semitones) {
-    const expected = _chunkPI3UXRWKcjs.intervalSemitones.call(void 0, numberValue, quality);
-    if (Math.abs(semitones) !== expected) {
-      throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(
-        `${quality}${numberValue} spans ${expected} semitones; received ${semitones}`
-      );
-    }
-    return new _Interval(numberValue, quality, semitones);
-  }
-  /**
-   * Wrap a plain spelled interval, as returned by the pitch module.
-   *
-   * @param data The plain interval.
-   * @returns The wrapped interval.
-   */
-  static fromData(data) {
-    return new _Interval(
-      data.number,
-      data.quality,
-      data.semitones,
-      _nullishCoalesce(data.descending, () => ( data.semitones < 0))
-    );
-  }
-  /**
-   * Rebuild an interval from its {@link Interval.toJSON} output.
-   *
-   * @param data The serialized interval.
-   * @returns The wrapped interval.
-   */
-  static fromJSON(data) {
-    return _Interval.fromData(data);
-  }
-  /**
-   * Parse an interval name such as `'P5'`, `'m3'`, or `'AA4'`.
-   *
-   * @param name The interval name.
-   * @returns The ascending interval of that name.
-   * @throws If the name is not a quality label followed by a diatonic number.
-   */
-  static parse(name) {
-    return _Interval.fromData(_chunkPI3UXRWKcjs.parseInterval.call(void 0, name));
-  }
-  /** Diatonic size: 1 = unison, 2 = second, ... 8 = octave, and beyond. */
-  get number() {
-    return this.#number;
-  }
-  /** Quality label: `'P'`, `'M'`, `'m'`, or repeated `'A'`/`'d'`. */
-  get quality() {
-    return this.#quality;
-  }
-  /** Signed semitone span. */
-  get semitones() {
-    return this.#semitones;
-  }
-  /** A readable label composed of quality and number, e.g. `'P5'` or `'M3'`. */
-  get name() {
-    return `${this.#quality}${this.#number}`;
-  }
-  /**
-   * The interval's inversion: the complement that completes the octave.
-   *
-   * A compound interval is reduced to its simple form first, and the result is
-   * always ascending — an inversion answers "what is left of the octave",
-   * which has no direction of its own.
-   *
-   * @returns The inverted interval, e.g. `M3` becomes `m6`.
-   */
-  invert() {
-    const simple = this.#number === 8 ? 8 : (this.#number - 1) % 7 + 1;
-    const numberValue = INVERSION_SUM - simple;
-    const quality = invertQuality(this.#quality);
-    return _Interval.of(numberValue, quality, _chunkPI3UXRWKcjs.intervalSemitones.call(void 0, numberValue, quality));
-  }
-  /**
-   * Whether the interval is consonant.
-   *
-   * @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 _chunkPI3UXRWKcjs.isConsonantInterval.call(void 0, this.#semitones, twoVoice);
-  }
-  /**
-   * Whether another interval is spelled identically.
-   *
-   * Enharmonic equivalents are not equal: an augmented second and a minor
-   * third span the same distance but are different intervals.
-   *
-   * @param other The interval to compare with.
-   * @returns True when number, quality, and span all match.
-   */
-  equals(other) {
-    return this.#number === other.number && this.#quality === other.quality && this.#semitones === other.semitones && this.#descending === other.#descending;
-  }
-  /**
-   * The plain interval data, for JSON serialization.
-   *
-   * Private class fields do not serialize, so an explicit `toJSON` keeps
-   * `JSON.stringify(interval)` from collapsing to `{}`.
-   *
-   * @returns The diatonic number, quality, and semitone span.
-   */
-  toJSON() {
-    return this.#descending ? {
-      number: this.#number,
-      quality: this.#quality,
-      semitones: this.#semitones,
-      descending: true
-    } : this.#semitones < 0 ? {
-      number: this.#number,
-      quality: this.#quality,
-      semitones: this.#semitones,
-      descending: false
-    } : { number: this.#number, quality: this.#quality, semitones: this.#semitones };
-  }
-  /**
-   * The interval's name, so a template literal or a log line reads as the
-   * interval.
-   *
-   * @returns The name, e.g. `'M3'`.
-   */
-  toString() {
-    return this.name;
-  }
-};
-
-// src/model/note.ts
-function copyNote(data) {
-  if (!Number.isInteger(data.letter) || data.letter < 0 || data.letter > 6) {
-    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(
-      `note letter must be an integer in [0, 6]; received ${data.letter}`
-    );
-  }
-  const copy = { letter: data.letter, alter: data.alter };
-  if (data.octave !== void 0) {
-    copy.octave = data.octave;
-  }
-  _chunkPI3UXRWKcjs.noteToPitchClass.call(void 0, copy);
-  return copy;
-}
-var Note = class _Note {
-  #data;
-  /**
-   * Wrap a plain note object.
-   *
-   * @param data The spelled note; it is copied, never retained or mutated.
-   * @throws If `letter` is not an integer in 0..6.
-   */
-  constructor(data) {
-    this.#data = copyNote(data);
-  }
-  /**
-   * Parse scientific pitch notation (e.g. `'C#4'`, `'Bb'`, `'F##3'`).
-   *
-   * @param name The note text.
-   * @returns The parsed note.
-   * @throws If the text is not a valid note.
-   */
-  static of(name) {
-    return new _Note(_chunkPI3UXRWKcjs.parseNote.call(void 0, name));
-  }
-  /**
-   * Name a MIDI number (middle C = C4 = 60) as a note.
-   *
-   * @param midi The MIDI number.
-   * @param spelling Whether to prefer sharps or flats for black keys.
-   * @returns The spelled note, with octave.
-   */
-  static fromMidi(midi, spelling = "sharp") {
-    return new _Note(_chunkPI3UXRWKcjs.midiToNote.call(void 0, midi, spelling));
-  }
-  /**
-   * Wrap an existing plain note object.
-   *
-   * @param data The plain note.
-   * @returns The wrapped note.
-   * @throws If `letter` is not an integer in 0..6.
-   */
-  static fromData(data) {
-    return new _Note(data);
-  }
-  /** The note rendered as scientific pitch notation, e.g. `'G4'` or `'Bb'`. */
-  get name() {
-    return _chunkPI3UXRWKcjs.formatNote.call(void 0, this.#data);
-  }
-  /** The pitch class (0..11), ignoring octave. */
-  get pitchClass() {
-    return _chunkPI3UXRWKcjs.noteToPitchClass.call(void 0, this.#data);
-  }
-  /**
-   * The MIDI number (middle C = C4 = 60).
-   *
-   * @throws If the note has no octave and therefore no fixed pitch.
-   */
-  get midi() {
-    if (this.#data.octave === void 0) {
-      throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(`note ${this.name} has no octave, so it has no MIDI number`);
-    }
-    return _chunkPI3UXRWKcjs.noteToMidi.call(void 0, this.#data);
-  }
-  /** The diatonic letter number: 0..6 for C..B. */
-  get letter() {
-    return this.#data.letter;
-  }
-  /** The chromatic alteration in semitones: -1 flat, 0 natural, +1 sharp, ... */
-  get alter() {
-    return this.#data.alter;
-  }
-  /** The octave (scientific pitch notation), or undefined for a bare pitch class. */
-  get octave() {
-    return this.#data.octave;
-  }
-  /** A copy of the underlying plain note object. */
-  get data() {
-    return copyNote(this.#data);
-  }
-  /**
-   * Transpose by a signed number of semitones, keeping the spelling.
-   *
-   * The letter moves by the diatonic distance of the conventional interval for
-   * that many semitones, so `Ab4` up a major second is `Bb4` rather than `A#4`
-   * and a flat key stays on the flat side. An octave-less note stays
-   * octave-less: only its pitch class is moved. Transposing by zero is the
-   * identity: the original spelling is preserved (no enharmonic respelling).
-   *
-   * @param semitones The signed semitone offset.
-   * @param opts `spelling` forces the result onto the sharp or flat side
-   *   instead of following this note's letter.
-   * @returns The transposed note.
-   * @example
-   * ```ts
-   * import { Note } from '@libraz/libcantus';
-   * Note.of('Ab4').transpose(2).name; // 'Bb4'
-   * Note.of('Ab4').transpose(2, { spelling: 'sharp' }).name; // 'A#4'
-   * ```
-   */
-  transpose(semitones, opts) {
-    if (semitones === 0 && _optionalChain([opts, 'optionalAccess', _ => _.spelling]) === void 0) {
-      return new _Note(this.#data);
-    }
-    return new _Note(_chunkPI3UXRWKcjs.transposeNote.call(void 0, this.#data, semitones, opts));
-  }
-  /**
-   * The spelled interval from this note to another.
-   *
-   * @param other The second note.
-   * @returns The interval, which {@link Interval.toJSON} unwraps to plain data.
-   */
-  intervalTo(other) {
-    return Interval.fromData(_chunkPI3UXRWKcjs.spelledInterval.call(void 0, this.#data, other.data));
-  }
-  /**
-   * Transpose by a spelled interval, keeping the spelling the interval names.
-   *
-   * Unlike {@link Note.transpose}, which picks a letter from the semitone
-   * count, the interval's diatonic number decides the letter: C up an
-   * augmented second is D#, not Eb.
-   *
-   * @param interval The interval to apply; a descending interval moves down.
-   * @returns The transposed note.
-   * @example
-   * ```ts
-   * import { Interval, Note } from '@libraz/libcantus';
-   * Note.of('C4').transposeBy(Interval.parse('A2')).name; // 'D#4'
-   * ```
-   */
-  transposeBy(interval) {
-    return new _Note(_chunkPI3UXRWKcjs.transposeByInterval.call(void 0, this.#data, interval.toJSON()));
-  }
-  /**
-   * Rebuild a note from its {@link Note.toJSON} output.
-   *
-   * @param data The serialized note.
-   * @returns The wrapped note.
-   * @throws If `letter` is not an integer in 0..6.
-   */
-  static fromJSON(data) {
-    return new _Note(data);
-  }
-  /**
-   * Whether another note has the same letter, alteration, and octave.
-   *
-   * @param other The note to compare.
-   * @returns True if the spellings are identical.
-   */
-  equals(other) {
-    const b = other.data;
-    return this.#data.letter === b.letter && this.#data.alter === b.alter && this.#data.octave === b.octave;
-  }
-  /**
-   * The plain note data, for JSON serialization.
-   *
-   * Private class fields do not serialize, so an explicit `toJSON` keeps
-   * `JSON.stringify(note)` from collapsing to `{}`.
-   *
-   * @returns A copy of the underlying plain note object.
-   */
-  toJSON() {
-    return this.data;
-  }
-  /**
-   * The note's name, so a template literal or a log line reads as the note.
-   *
-   * @returns The spelled name, e.g. `'Bb3'`.
-   */
-  toString() {
-    return this.name;
-  }
-};
-
-// src/model/shared.ts
-function spellPitchClassBare(pc, spelling) {
-  const spelled = _chunkPI3UXRWKcjs.midiToNote.call(void 0, 60 + _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, pc), spelling);
-  return { letter: spelled.letter, alter: spelled.alter };
-}
-
-// src/model/key.ts
-function accidentalLoad(tonic, scale) {
-  return _chunkOL3IHHSJcjs.spellScale.call(void 0, tonic, scale).reduce((sum, note) => sum + Math.abs(note.alter), 0);
-}
-function bestTonicForScale(rootPc, scale) {
-  const sharp = spellPitchClassBare(rootPc, "sharp");
-  const flat = spellPitchClassBare(rootPc, "flat");
-  if (sharp.letter === flat.letter && sharp.alter === flat.alter) {
-    return new Note(sharp);
-  }
-  return accidentalLoad(flat, scale) <= accidentalLoad(sharp, scale) ? new Note(flat) : new Note(sharp);
-}
-var Key = class _Key {
-  #scale;
-  #tonic;
-  #variant;
-  /**
-   * Wrap a key/scale and its spelled tonic.
-   *
-   * @param scale The key/scale; its root is normalized to a pitch class.
-   * @param tonic The spelled tonic anchoring letter-name spelling.
-   * @param variant Optional detected scale form retained for display.
-   */
-  constructor(scale, tonic, variant) {
-    _chunkPI3UXRWKcjs.assertInteger.call(void 0, scale.rootPc, "scale.rootPc");
-    _chunkPI3UXRWKcjs.assertInteger.call(void 0, scale.modeMask12, "scale.modeMask12", 1, 4095);
-    if ((scale.modeMask12 & 1) === 0) {
-      throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)("scale.modeMask12 must include the tonic (bit 0)");
-    }
-    const rootPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, scale.rootPc);
-    if (tonic.pitchClass !== rootPc) {
-      throw new (0, _chunkPI3UXRWKcjs.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`
-      );
-    }
-    this.#scale = { rootPc, modeMask12: scale.modeMask12 };
-    this.#tonic = tonic;
-    this.#variant = variant;
-  }
-  /** Preserve detection metadata while replacing its plain key with this API's Key. */
-  static #fromMatch(match) {
-    const key = new _Key(
-      match.key,
-      bestTonicForScale(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, match.key.rootPc), match.key),
-      match.variant
-    );
-    return { ...match, key };
-  }
-  /**
-   * A major key.
-   *
-   * @param root Tonic as a note name (e.g. `'Eb'`) or a pitch class; a numeric
-   *   root is spelled with whichever accidental side yields the fewest
-   *   accidentals across the scale.
-   * @returns The major key.
-   */
-  static major(root) {
-    if (typeof root === "string") {
-      const tonic = Note.of(root);
-      return new _Key(_chunkBSLTLGM3cjs.majorKey.call(void 0, tonic.pitchClass), tonic);
-    }
-    const scale = _chunkBSLTLGM3cjs.majorKey.call(void 0, root);
-    return new _Key(scale, bestTonicForScale(root, scale));
-  }
-  /**
-   * A natural-minor key.
-   *
-   * @param root Tonic as a note name or a pitch class; a numeric root is
-   *   spelled with whichever accidental side yields the fewest accidentals
-   *   across the scale.
-   * @returns The minor key.
-   */
-  static minor(root) {
-    if (typeof root === "string") {
-      const tonic = Note.of(root);
-      return new _Key(_chunkBSLTLGM3cjs.minorKey.call(void 0, tonic.pitchClass), tonic);
-    }
-    const scale = _chunkBSLTLGM3cjs.minorKey.call(void 0, root);
-    return new _Key(scale, bestTonicForScale(root, scale));
-  }
-  /**
-   * A key on a named scale (e.g. `'dorian'`, `'harmonicMinor'`).
-   *
-   * @param name The scale name, a key of the scale module's named-scale table.
-   * @param root Tonic as a note name or a pitch class; a numeric root is
-   *   spelled with whichever accidental side yields the fewest accidentals
-   *   across the scale, exactly as {@link Key.major} does.
-   * @returns The key.
-   * @throws If the name is not a known scale.
-   */
-  static named(name, root) {
-    if (typeof root === "string") {
-      const tonic = Note.of(root);
-      return new _Key(_chunkBSLTLGM3cjs.scaleByName.call(void 0, name, tonic.pitchClass), tonic);
-    }
-    const scale = _chunkBSLTLGM3cjs.scaleByName.call(void 0, name, _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, root));
-    return new _Key(scale, bestTonicForScale(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, root), scale));
-  }
-  /**
-   * Wrap an existing `KeyScale`, synthesizing a spelled tonic when none is
-   * given.
-   *
-   * The synthesized tonic is chosen the same way as for a numeric root
-   * elsewhere: whichever accidental side spells the scale with the fewest
-   * accidentals. This is what keeps `Key.of(detectKey(...).scale)` from handing
-   * every downstream chord a double-sharp spelling.
-   *
-   * @param scale The key/scale to wrap.
-   * @param tonic Optional spelled tonic; must spell the scale's root pitch class.
-   * @returns The key.
-   * @throws If the given tonic is not the scale's root pitch class.
-   */
-  static of(scale, tonic) {
-    return new _Key(scale, _nullishCoalesce(tonic, () => ( bestTonicForScale(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, scale.rootPc), scale))));
-  }
-  /**
-   * Rebuild a key from its {@link Key.toJSON} output.
-   *
-   * @param data The serialized key and tonic.
-   * @returns The key.
-   */
-  static fromJSON(data) {
-    return new _Key(data.scale, new Note(data.tonic));
-  }
-  /**
-   * Identify the keys a set of pitches fits, best interpretation first.
-   *
-   * The counterpart of {@link Chord.detect}.
-   *
-   * @param pitches MIDI pitches or bare pitch classes.
-   * @param opts How to weigh the input; see {@link DetectKeyOptions}.
-   * @returns Ranked keys (may be empty).
-   */
-  static detect(pitches, opts) {
-    return _Key.detectMatches(pitches, opts).map((match) => match.key);
-  }
-  /**
-   * Identify keys while retaining each candidate's score, fit, and scale form.
-   *
-   * @param pitches MIDI pitches or bare pitch classes.
-   * @param opts How to weigh the input; see {@link DetectKeyOptions}.
-   * @returns Ranked key matches (may be empty).
-   */
-  static detectMatches(pitches, opts) {
-    return _chunkKQN2ZYNDcjs.detectKey.call(void 0, pitches, opts).map((match) => _Key.#fromMatch(match));
-  }
-  /**
-   * The single best key interpretation of a pitch set.
-   *
-   * @param pitches MIDI pitches or bare pitch classes.
-   * @param opts How to weigh the input; see {@link DetectKeyOptions}.
-   * @returns The top-ranked key, or null when nothing matches.
-   * @example
-   * ```ts
-   * import { Key } from '@libraz/libcantus';
-   * Key.detectBest([0, 2, 4, 5, 7, 9, 11])?.toString(); // 'C major'
-   * ```
-   */
-  static detectBest(pitches, opts) {
-    const best = _chunkKQN2ZYNDcjs.detectKeyBest.call(void 0, pitches, opts);
-    return best === null ? null : _Key.#fromMatch(best).key;
-  }
-  /**
-   * Whether another key has the same tonic pitch class and mode.
-   *
-   * The spelled tonic is not compared: C# major and Db major are the same key
-   * written two ways.
-   *
-   * @param other The key to compare.
-   * @returns True when tonic and mode mask both match.
-   */
-  equals(other) {
-    const scale = other.scale;
-    return this.#scale.rootPc === scale.rootPc && this.#scale.modeMask12 === scale.modeMask12;
-  }
-  /** A copy of the underlying plain `KeyScale`. */
-  get scale() {
-    return { rootPc: this.#scale.rootPc, modeMask12: this.#scale.modeMask12 };
-  }
-  /** The spelled tonic. */
-  get tonic() {
-    return this.#tonic;
-  }
-  /** The tonic pitch class (0..11). */
-  get rootPc() {
-    return this.#scale.rootPc;
-  }
-  /** Whether the scale has a minor third and no major third. */
-  get isMinor() {
-    return _chunkKQN2ZYNDcjs.isMinorKey.call(void 0, this.#scale);
-  }
-  /** The detected scale form, when this key came from key detection. */
-  get variant() {
-    return this.#variant;
-  }
-  /**
-   * The scale's pitch classes in ascending scale-degree order (degree 0 first).
-   *
-   * @returns One pitch class per scale degree.
-   */
-  pitchClasses() {
-    return _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, this.#scale);
-  }
-  /**
-   * Transpose the key by a number of semitones.
-   *
-   * The mode mask is unchanged, so the scale keeps its shape; only the tonic
-   * moves. The new tonic is spelled the way that key is conventionally written
-   * — D major, not C## major.
-   *
-   * @param semitones The signed semitone offset.
-   * @returns The transposed key.
-   * @example
-   * ```ts
-   * import { Key } from '@libraz/libcantus';
-   * Key.major('C').transpose(2).toString(); // 'D major'
-   * ```
-   */
-  transpose(semitones) {
-    _chunkPI3UXRWKcjs.assertFiniteNumber.call(void 0, semitones, "semitones");
-    const rootPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, this.#scale.rootPc + Math.round(semitones));
-    return new _Key(
-      { rootPc, modeMask12: this.#scale.modeMask12 },
-      this.#tonic.transpose(semitones),
-      this.#variant
-    );
-  }
-  /**
-   * The spelled scale, one note per degree (e.g. C D E F G A B for C major).
-   *
-   * @returns Spelled octave-less notes in scale-degree order.
-   */
-  notes() {
-    return _chunkOL3IHHSJcjs.spellScale.call(void 0, this.#tonic.data, this.#scale).map((note) => new Note(note));
-  }
-  /**
-   * Alias of {@link Key.notes}.
-   *
-   * @returns Spelled octave-less notes in scale-degree order.
-   */
-  spell() {
-    return this.notes();
-  }
-  /**
-   * The spelled scale as letter-name strings.
-   *
-   * @returns One name per scale degree.
-   */
-  noteNames() {
-    return this.notes().map((note) => note.name);
-  }
-  /**
-   * Build a chord on a scale degree, carrying this key as context.
-   *
-   * With an explicit quality the quality's interval template is attached to the
-   * degree's diatonic root; without one the scale-correct diatonic triad is
-   * stacked (e.g. a diminished triad on the leading tone of a major key).
-   *
-   * @param degree 0-based scale degree of the chord root.
-   * @param quality Optional chord quality.
-   * @returns The chord, with this key attached.
-   * @throws Without a `quality`, if this key's scale is not heptatonic —
-   *   stacking thirds needs seven degrees, so the pentatonic, blues,
-   *   whole-tone, octatonic and chromatic scales have no diatonic triad. Pass
-   *   an explicit `quality` for those.
-   */
-  chord(degree, quality) {
-    const data = quality === void 0 ? _chunkBSLTLGM3cjs.diatonicTriad.call(void 0, degree, this.#scale) : _chunkBSLTLGM3cjs.chordFromDegree.call(void 0, degree, quality, this.#scale);
-    return new Chord(data, this);
-  }
-  /**
-   * The diatonic triad on a scale degree, carrying this key as context.
-   *
-   * @param degree 0-based scale degree of the chord root.
-   * @returns The triad, with this key attached.
-   * @throws If this key's scale is not heptatonic; stacking thirds needs seven
-   *   degrees. Use {@link Key.chord} with an explicit quality instead.
-   */
-  diatonicTriad(degree) {
-    return new Chord(_chunkBSLTLGM3cjs.diatonicTriad.call(void 0, degree, this.#scale), this);
-  }
-  /**
-   * The diatonic seventh chord on a scale degree, carrying this key as context.
-   *
-   * @param degree 0-based scale degree of the chord root.
-   * @returns The seventh chord, with this key attached.
-   * @throws If this key's scale is not heptatonic; stacking thirds needs seven
-   *   degrees. Use {@link Key.chord} with an explicit quality instead.
-   */
-  diatonicSeventh(degree) {
-    return new Chord(_chunkBSLTLGM3cjs.diatonicSeventh.call(void 0, degree, this.#scale), this);
-  }
-  /**
-   * Build the chord denoted by a Roman numeral in this key (including applied
-   * chords such as `'V7/V'`), carrying this key as context.
-   *
-   * @param text The Roman numeral.
-   * @returns The chord, with this key attached.
-   * @throws If the numeral is not valid.
-   */
-  roman(text) {
-    return new Chord(_chunkKQN2ZYNDcjs.romanToChord.call(void 0, text, this.#scale), this);
-  }
-  /**
-   * Whether a pitch belongs to the scale.
-   *
-   * @param x A MIDI pitch, bare pitch class, or note.
-   * @returns True if the pitch class is a scale tone.
-   */
-  contains(x) {
-    return _chunkBSLTLGM3cjs.isScaleTone.call(void 0, typeof x === "number" ? x : x.pitchClass, this.#scale);
-  }
-  /**
-   * The plain key data, for JSON serialization.
-   *
-   * 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, enough to reconstruct the key via
-   * {@link Key.of}.
-   *
-   * @returns The key/scale and its spelled tonic.
-   */
-  toJSON() {
-    return { scale: this.scale, tonic: this.#tonic.data };
-  }
-  /**
-   * The key's tonic and mode, so a template literal or a log line reads as the
-   * key. Detected harmonic and melodic minor keys retain their scale form.
-   *
-   * @returns The name, e.g. `'C major'` or `'A minor'`.
-   */
-  toString() {
-    if (this.#variant === "harmonic" || this.#variant === "melodic") {
-      return `${this.#tonic.name} ${this.#variant} minor`;
-    }
-    return `${this.#tonic.name} ${this.isMinor ? "minor" : "major"}`;
-  }
-};
-
-// src/model/progression.ts
-var Progression = class _Progression {
-  #chords;
-  #key;
-  /**
-   * Wrap a chord sequence.
-   *
-   * @param chords The chords in order; the array is copied.
-   * @param key Optional key context for analysis methods.
-   */
-  constructor(chords, key) {
-    this.#chords = Object.freeze(_Progression.#attachKey(chords, key));
-    this.#key = key;
-  }
-  /** Attach a progression key to chord members that do not already carry one. */
-  static #attachKey(chords, key) {
-    return key === void 0 ? [...chords] : chords.map((chord) => chord.key === void 0 ? chord.withKey(key) : chord);
-  }
-  /**
-   * Build a progression from the {@link ChordSpan} records the generators
-   * return, keeping their order.
-   *
-   * The spans' `startBeat`, `degree`, and `secondaryDominant` are analysis
-   * annotations that a chord sequence does not carry; only the harmony crosses
-   * over. Keep the spans themselves if the timing matters.
-   *
-   * @param spans The chord spans, in order.
-   * @param key Optional key context for the analysis methods.
-   * @returns The progression.
-   * @example
-   * ```ts
-   * import { generateProgression, Key, Progression } from '@libraz/libcantus';
-   * const key = Key.major('C');
-   * const spans = generateProgression({ key: key.scale, style: 'dance', bars: 4 });
-   * Progression.fromSpans(spans, key).roman();
-   * ```
-   */
-  static fromSpans(spans, key) {
-    const chords = spans.map(
-      (span) => Chord.from(_chunkBSLTLGM3cjs.makeChord.call(void 0, span.rootPc, span.quality, span.bassPc))
-    );
-    return new _Progression(chords, key);
-  }
-  /**
-   * Rebuild a progression from its {@link Progression.toJSON} output.
-   *
-   * @param data The serialized chords and key.
-   * @returns The progression.
-   */
-  static fromJSON(data) {
-    const key = data.key === void 0 ? void 0 : Key.fromJSON(data.key);
-    const chords = data.chords.map((chord) => Chord.fromJSON(chord));
-    return key === void 0 ? new _Progression(chords) : new _Progression(chords, key);
-  }
-  /**
-   * The chord sequence.
-   *
-   * The array is the progression's own and is frozen rather than copied, so
-   * reading it in a loop stays linear.
-   */
-  get chords() {
-    return this.#chords;
-  }
-  /** The carried key context, if any. */
-  get key() {
-    return this.#key;
-  }
-  /** The number of chords. */
-  get length() {
-    return this.#chords.length;
-  }
-  /**
-   * The chord at an index.
-   *
-   * @param index 0-based position; a negative index counts from the end.
-   * @returns The chord, or undefined when the index is out of range.
-   */
-  at(index) {
-    return this.#chords.at(index);
-  }
-  /** Iterate the chords in order, so a progression works with `for...of`. */
-  [Symbol.iterator]() {
-    return this.#chords[Symbol.iterator]();
-  }
-  /**
-   * Whether another progression holds the same chords in the same order.
-   *
-   * The key context is not compared: it is an analysis lens, not part of the
-   * harmony. Chord equality follows {@link Chord.equals}.
-   *
-   * @param other The progression to compare.
-   * @returns True when the chord sequences match.
-   */
-  equals(other) {
-    if (this.#chords.length !== other.length) {
-      return false;
-    }
-    return this.#chords.every((chord, index) => {
-      const theirs = other.at(index);
-      return theirs !== void 0 && chord.equals(theirs);
-    });
-  }
-  /**
-   * A copy of this progression with a chord appended.
-   *
-   * @param chord The chord to append.
-   * @returns The new progression.
-   */
-  add(chord) {
-    return new _Progression([...this.#chords, chord], this.#key);
-  }
-  /**
-   * A copy of this progression carrying the given key context.
-   *
-   * @param key The key context to attach.
-   * @returns The new progression.
-   */
-  withKey(key) {
-    return new _Progression(this.#chords, key);
-  }
-  /**
-   * Voice the progression with smooth voice leading.
-   *
-   * @param opts Voicing options; defaults to four SATB voices.
-   * @returns One ascending voicing (MIDI pitches) per chord.
-   * @throws If any chord admits no voicing within the given ranges.
-   */
-  voice(opts) {
-    const key = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _2 => _2.key]), () => ( _optionalChain([this, 'access', _3 => _3.#key, 'optionalAccess', _4 => _4.scale])));
-    return _chunkOL3IHHSJcjs.voiceProgression.call(void 0, 
-      this.#chords.map((chord) => chord.data),
-      key === void 0 ? opts : { ...opts, key }
-    );
-  }
-  /**
-   * The Roman numeral of each chord in a key.
-   *
-   * @param key Key to analyze in; falls back to the carried context.
-   * @param opts Applied-numeral rendering options.
-   * @returns One numeral per chord.
-   * @throws If no key is given and none is carried.
-   */
-  roman(key, opts) {
-    const resolved = this.#resolveKey(key);
-    return this.#chords.map((chord) => chord.roman(resolved, opts));
-  }
-  /**
-   * The harmonic function of each chord in a key.
-   *
-   * @param key Key to analyze in; falls back to the carried context.
-   * @returns One function per chord.
-   * @throws If no key is given and none is carried.
-   */
-  functions(key) {
-    const resolved = this.#resolveKey(key);
-    return this.#chords.map((chord) => chord.function(resolved));
-  }
-  /**
-   * Analyze every chord and classify the closing cadence.
-   *
-   * The cadence is detected on the final chord pair and is null when the
-   * progression has fewer than two chords.
-   *
-   * @param key Key to analyze in; falls back to the carried context.
-   * @param opts Applied-numeral rendering options.
-   * @returns Per-chord analyses and the closing cadence.
-   * @throws If no key is given and none is carried.
-   */
-  analyze(key, opts) {
-    const resolved = this.#resolveKey(key);
-    const chords = this.#chords.map((chord) => chord.analyze(resolved, opts));
-    const from = this.#chords[this.#chords.length - 2];
-    const to = this.#chords[this.#chords.length - 1];
-    const cadence = from !== void 0 && to !== void 0 ? _chunkKQN2ZYNDcjs.detectCadence.call(void 0, from.data, to.data, resolved.scale) : null;
-    return { chords, cadence };
-  }
-  /**
-   * Choose one compatible scale for every chord, favoring smooth changes.
-   *
-   * @returns One scale choice per chord in this progression.
-   */
-  scales() {
-    return _chunkOL3IHHSJcjs.scalesForChanges.call(void 0, this.#chords.map((chord) => chord.data));
-  }
-  /**
-   * The plain progression data, for JSON serialization.
-   *
-   * Private class fields do not serialize, so an explicit `toJSON` keeps
-   * `JSON.stringify(progression)` from collapsing to `{}`. The chords are
-   * emitted as plain data and the carried key, when present, as its own data.
-   *
-   * @returns The chord data sequence and the carried key, if any.
-   */
-  /**
-   * Transpose every chord by a number of semitones.
-   *
-   * A carried key moves with the chords, so the progression keeps its degrees
-   * and functions in the new key.
-   *
-   * @param semitones The signed semitone offset.
-   * @returns The transposed progression.
-   * @example
-   * ```ts
-   * import { Chord, Progression } from '@libraz/libcantus';
-   * new Progression([Chord.parse('C'), Chord.parse('G')]).transpose(2).toString(); // 'D A'
-   * ```
-   */
-  transpose(semitones) {
-    const key = _optionalChain([this, 'access', _5 => _5.#key, 'optionalAccess', _6 => _6.transpose, 'call', _7 => _7(semitones)]);
-    const chords = this.#chords.map((chord) => {
-      const moved = chord.transpose(semitones);
-      return key !== void 0 && moved.key === void 0 ? moved.withKey(key) : moved;
-    });
-    return new _Progression(chords, key);
-  }
-  /**
-   * The chord symbols separated by spaces, so a template literal or a log line
-   * reads as the progression.
-   *
-   * @returns The symbols in order, e.g. `'C Am F G'`.
-   */
-  toString() {
-    return this.#chords.map((chord) => chord.symbol()).join(" ");
-  }
-  /**
-   * 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)`.
-   *
-   * @returns The chord data sequence and the carried key, if any.
-   */
-  toJSON() {
-    return {
-      chords: this.#chords.map((chord) => chord.toJSON()),
-      key: _optionalChain([this, 'access', _8 => _8.#key, 'optionalAccess', _9 => _9.toJSON, 'call', _10 => _10()])
-    };
-  }
-  /** Resolve the key for an analysis method: explicit first, then carried. */
-  #resolveKey(key) {
-    const resolved = _nullishCoalesce(key, () => ( this.#key));
-    if (resolved === void 0) {
-      throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(
-        "progression has no key context; pass a Key or attach one with withKey()"
-      );
-    }
-    return resolved;
-  }
-};
-
-// src/model/chord.ts
-function hintMatches(hint, pc) {
-  return hint !== void 0 && pc !== void 0 && _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, _chunkPI3UXRWKcjs.noteToPitchClass.call(void 0, hint)) === _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, pc);
-}
-function transposeHint(hint, semitones) {
-  if (hint === void 0) {
-    return void 0;
-  }
-  const moved = _chunkPI3UXRWKcjs.transposeNote.call(void 0, hint, semitones);
-  return { letter: moved.letter, alter: moved.alter };
-}
-function copyChord(data) {
-  const copy = {
-    rootPc: data.rootPc,
-    quality: data.quality,
-    intervals: [...data.intervals]
-  };
-  if (data.bassPc !== void 0) {
-    copy.bassPc = data.bassPc;
-  }
-  if (hintMatches(data.rootSpelling, data.rootPc) && data.rootSpelling !== void 0) {
-    copy.rootSpelling = { letter: data.rootSpelling.letter, alter: data.rootSpelling.alter };
-  }
-  if (hintMatches(data.bassSpelling, data.bassPc) && data.bassSpelling !== void 0) {
-    copy.bassSpelling = { letter: data.bassSpelling.letter, alter: data.bassSpelling.alter };
-  }
-  return copy;
-}
-function deriveBassSpelling(chord, key) {
-  const bassPc = chord.bassPc;
-  if (bassPc === void 0) {
-    return void 0;
-  }
-  const root = chord.rootSpelling;
-  if (root !== void 0) {
-    const index = chord.intervals.findIndex((i) => _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc + i) === bassPc);
-    const tone = index >= 0 ? _chunkOL3IHHSJcjs.spellChordFromRoot.call(void 0, chord, root)[index] : void 0;
-    if (tone !== void 0) {
-      return { letter: tone.letter, alter: tone.alter };
-    }
-  }
-  if (key === void 0) {
-    return void 0;
-  }
-  const spelled = _chunkOL3IHHSJcjs.spellPitchClass.call(void 0, bassPc, key.tonic.data, key.scale);
-  return { letter: spelled.letter, alter: spelled.alter };
-}
-var Chord = class _Chord {
-  /** Exactly what the caller supplied: any spelling here is the caller's own. */
-  #given;
-  #key;
-  /**
-   * Wrap a plain chord object.
-   *
-   * @param data The chord; it is copied, never retained or mutated.
-   * @param key Optional key context for analysis methods.
-   */
-  constructor(data, key) {
-    this.#given = copyChord(data);
-    this.#key = key;
-  }
-  /**
-   * The chord data with any missing spelling hint filled in from the key.
-   *
-   * Derived spellings are computed on read rather than baked in at construction,
-   * so re-attaching a different key re-spells the chord instead of carrying the
-   * first key's letters forever. A spelling the caller supplied always wins.
-   */
-  get #data() {
-    return this.#dataWithKey(this.#key);
-  }
-  /** Build a read view whose missing spellings are derived from `key`. */
-  #dataWithKey(key) {
-    const out = copyChord(this.#given);
-    if (out.rootSpelling === void 0 && key !== void 0) {
-      out.rootSpelling = _chunkOL3IHHSJcjs.spellPitchClass.call(void 0, out.rootPc, key.tonic.data, key.scale);
-    }
-    if (out.bassSpelling === void 0) {
-      const bass = deriveBassSpelling(out, key);
-      if (bass !== void 0) {
-        out.bassSpelling = bass;
-      }
-    }
-    return out;
-  }
-  /**
-   * Build a chord from a root and quality.
-   *
-   * @param root Root as a note name (e.g. `'Eb'`) or a pitch class.
-   * @param quality The chord quality.
-   * @param bass Optional slash-chord bass, as a note name (e.g. `'Bb'`) or a
-   *   pitch class. A named bass keeps its own spelling.
-   * @returns The chord (without key context).
-   */
-  static of(root, quality, bass) {
-    const bassNote = typeof bass === "string" ? Note.of(bass) : void 0;
-    const bassPc = bassNote !== void 0 ? bassNote.pitchClass : bass;
-    const rootNote = typeof root === "string" ? Note.of(root) : void 0;
-    const data = _chunkBSLTLGM3cjs.makeChord.call(void 0, 
-      rootNote !== void 0 ? rootNote.pitchClass : root,
-      quality,
-      bassPc
-    );
-    if (rootNote !== void 0) {
-      data.rootSpelling = { letter: rootNote.letter, alter: rootNote.alter };
-    }
-    if (bassNote !== void 0) {
-      data.bassSpelling = { letter: bassNote.letter, alter: bassNote.alter };
-    }
-    return new _Chord(data);
-  }
-  /**
-   * Wrap an existing plain chord object.
-   *
-   * @param data The plain chord.
-   * @returns The wrapped chord (without key context).
-   */
-  static from(data) {
-    return new _Chord(data);
-  }
-  /**
-   * Alias of {@link Chord.from}, matching the `fromData` factory on the other
-   * classes.
-   *
-   * @param data The plain chord.
-   * @returns The wrapped chord (without key context).
-   */
-  static fromData(data) {
-    return new _Chord(data);
-  }
-  /**
-   * Rebuild a chord from its {@link Chord.toJSON} output.
-   *
-   * The key context is not serialized, so the result carries none; re-attach
-   * one with {@link Chord.withKey}.
-   *
-   * @param data The serialized chord.
-   * @returns The wrapped chord.
-   */
-  static fromJSON(data) {
-    return new _Chord(data);
-  }
-  /**
-   * Parse a lead-sheet chord symbol (e.g. `'Cmaj7'`, `'F#m7b5'`, `'C/G'`).
-   *
-   * @param symbol The chord symbol.
-   * @returns The chord (without key context).
-   * @throws If the root or quality is not recognized.
-   */
-  static parse(symbol) {
-    return new _Chord(_chunkOL3IHHSJcjs.parseChordSymbol.call(void 0, symbol));
-  }
-  /**
-   * Identify the chords matching a set of pitches, best interpretation first.
-   *
-   * @param pitches MIDI pitches or bare pitch classes.
-   * @param opts How to interpret the input; see {@link DetectChordOptions}.
-   * @returns Ranked chord interpretations (may be empty).
-   */
-  static detect(pitches, opts) {
-    return _chunkKQN2ZYNDcjs.detectChord.call(void 0, pitches, opts).map(
-      (match) => new _Chord(_chunkBSLTLGM3cjs.makeChord.call(void 0, match.rootPc, match.quality, match.bassPc))
-    );
-  }
-  /**
-   * Identify the chords matching a set of pitches, keeping each match's
-   * recognition metadata beside the chord.
-   *
-   * {@link Chord.detect} discards the confidence signals a recognition UI needs
-   * — whether the set matched exactly, which chord tones were missing, which
-   * input notes were foreign, and which inversion the bass implies.
-   *
-   * @param pitches MIDI pitches or bare pitch classes.
-   * @param opts How to interpret the input; see {@link DetectChordOptions}.
-   * @returns Ranked interpretations, each with its chord and its match record.
-   * @example
-   * ```ts
-   * import { Chord } from '@libraz/libcantus';
-   * const [best] = Chord.detectMatches([60, 64, 67]);
-   * best?.match.exact; // true
-   * ```
-   */
-  static detectMatches(pitches, opts) {
-    return _chunkKQN2ZYNDcjs.detectChord.call(void 0, pitches, opts).map((match) => ({
-      chord: new _Chord(_chunkBSLTLGM3cjs.makeChord.call(void 0, match.rootPc, match.quality, match.bassPc)),
-      match
-    }));
-  }
-  /**
-   * The single best chord interpretation of a pitch set.
-   *
-   * @param pitches MIDI pitches or bare pitch classes.
-   * @param opts How to interpret the input; see {@link DetectChordOptions}.
-   * @returns The top-ranked chord, or null when nothing matches.
-   */
-  static detectBest(pitches, opts) {
-    const best = _chunkKQN2ZYNDcjs.detectChordBest.call(void 0, pitches, opts);
-    return best === null ? null : new _Chord(best);
-  }
-  /** The root pitch class (0..11). */
-  get rootPc() {
-    return this.#data.rootPc;
-  }
-  /** The chord quality. */
-  get quality() {
-    return this.#data.quality;
-  }
-  /** A copy of the semitone offsets above the root. */
-  get intervals() {
-    return [...this.#data.intervals];
-  }
-  /** The slash-chord bass pitch class, or undefined in root position. */
-  get bassPc() {
-    return this.#data.bassPc;
-  }
-  /**
-   * A copy of the underlying plain chord object, including the spellings
-   * derived from any attached key.
-   */
-  get data() {
-    return this.#data;
-  }
-  /** The carried key context, if any. */
-  get key() {
-    return this.#key;
-  }
-  /**
-   * A copy of this chord carrying the given key context.
-   *
-   * Only a spelling the caller supplied (via `Chord.parse`, `Chord.of` with a
-   * named root, or plain data carrying a hint) survives; a spelling that came
-   * from a previously attached key is re-derived, so re-keying a progression
-   * during a modulation does not keep the old key's letters and the order of
-   * `withKey` calls does not affect the result.
-   *
-   * @param key The key context to attach.
-   * @returns The new chord.
-   */
-  withKey(key) {
-    return new _Chord(this.#given, key);
-  }
-  /**
-   * The chord's sorted, deduplicated pitch classes.
-   *
-   * @returns Pitch classes ascending in [0, 11].
-   */
-  pitchClasses() {
-    return _chunkBSLTLGM3cjs.chordPitchClasses.call(void 0, this.#data);
-  }
-  /**
-   * The chord's Roman numeral in a key.
-   *
-   * @param key Key to analyze in; falls back to the carried context.
-   * @param opts Applied-numeral rendering options.
-   * @returns The Roman numeral string.
-   * @throws If no key is given and none is carried.
-   */
-  roman(key, opts) {
-    return _chunkKQN2ZYNDcjs.chordToRoman.call(void 0, this.#data, this.#resolveKey(key).scale, opts);
-  }
-  /**
-   * The chord's harmonic function (tonic / subdominant / dominant) in a key.
-   *
-   * @param key Key to analyze in; falls back to the carried context.
-   * @returns The harmonic function.
-   * @throws If no key is given and none is carried.
-   */
-  function(key) {
-    return _chunkKQN2ZYNDcjs.functionOf.call(void 0, this.#data, this.#resolveKey(key).scale);
-  }
-  /**
-   * Full functional analysis: function, borrowing, and Roman numeral.
-   *
-   * @param key Key to analyze in; falls back to the carried context.
-   * @param opts Applied-numeral rendering options.
-   * @returns The chord analysis.
-   * @throws If no key is given and none is carried.
-   */
-  analyze(key, opts) {
-    return _chunkKQN2ZYNDcjs.analyzeChord.call(void 0, this.#data, this.#resolveKey(key).scale, opts);
-  }
-  /**
-   * Whether the chord is borrowed from the parallel mode (modal interchange).
-   *
-   * @param key Key to analyze in; falls back to the carried context.
-   * @returns True if the chord is borrowed.
-   * @throws If no key is given and none is carried.
-   */
-  isBorrowed(key) {
-    return _chunkKQN2ZYNDcjs.isBorrowedChord.call(void 0, this.#data, this.#resolveKey(key).scale);
-  }
-  /**
-   * The origin of a non-diatonic chord (parallel mode or Neapolitan), or null.
-   *
-   * @param key Key to analyze in; falls back to the carried context.
-   * @returns The borrowing source, or null.
-   * @throws If no key is given and none is carried.
-   */
-  borrowedSource(key) {
-    return _chunkKQN2ZYNDcjs.borrowedSource.call(void 0, this.#data, this.#resolveKey(key).scale);
-  }
-  /**
-   * The chord rendered as a lead-sheet symbol (e.g. `'Cmaj7'`, `'F#m7'`, `'C/G'`).
-   *
-   * @param opts Set `flats: true` to spell the root/bass with flats.
-   * @returns The chord symbol.
-   */
-  symbol(opts) {
-    return _chunkOL3IHHSJcjs.formatChordSymbol.call(void 0, this.#data, opts);
-  }
-  /**
-   * Realize the chord as one MIDI pitch per voice, ascending.
-   *
-   * A chord that carries a key passes it to the voicer, so the leading tone is
-   * not doubled; an explicit `opts.key` overrides it.
-   *
-   * @param opts Voicing options; defaults to four SATB voices.
-   * @returns MIDI pitches, ascending, one per voice.
-   * @throws If no voicing fits the given ranges.
-   */
-  voice(opts) {
-    const key = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _11 => _11.key]), () => ( _optionalChain([this, 'access', _12 => _12.#key, 'optionalAccess', _13 => _13.scale])));
-    return _chunkOL3IHHSJcjs.voiceChord.call(void 0, this.#data, key === void 0 ? opts : { ...opts, key });
-  }
-  /**
-   * Realize the chord as a single styled voicing (`close`, `drop2`, `drop3`,
-   * `shell`, or `rootless`), optionally constraining the top voice.
-   *
-   * @param opts Styled-voicing options; defaults to a close-position voicing.
-   * @returns MIDI pitches, ascending.
-   */
-  styledVoicing(opts) {
-    return _chunkOL3IHHSJcjs.voiceChordStyled.call(void 0, this.#data, opts);
-  }
-  /**
-   * The negative-harmony mirror of the chord about the key's tonic–dominant
-   * axis (major becomes minor and vice versa).
-   *
-   * @param key Key providing the reflection axis; falls back to the carried
-   *   context.
-   * @returns The mirrored chord, keeping any key context.
-   * @throws If no key is given and none is carried.
-   */
-  negativeHarmony(key) {
-    const resolved = this.#resolveKey(key);
-    return new _Chord(_chunk357ZDPVUcjs.negativeHarmonyMirror.call(void 0, this.#data, resolved.scale), _nullishCoalesce(key, () => ( this.#key)));
-  }
-  /**
-   * The n-th inversion: a copy whose bass is the chord tone `n` steps above the
-   * root in the interval template (`invert(1)` puts the third in the bass).
-   * `n` wraps around the template length; negative values count backwards.
-   *
-   * `invert(0)` (and any `n` that wraps to it) is root position, so it carries
-   * no slash bass and equals the original chord.
-   *
-   * @param n The inversion number.
-   * @returns The inverted chord, keeping any key context.
-   * @throws If the chord has no intervals.
-   */
-  invert(n) {
-    const data = copyChord(this.#given);
-    const intervals = data.intervals;
-    const length = intervals.length;
-    if (length === 0) {
-      throw new (0, _chunkPI3UXRWKcjs.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 = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, data.rootPc + (_nullishCoalesce(intervals[index], () => ( 0))));
-    }
-    return new _Chord(data, this.#key);
-  }
-  /**
-   * Transpose the chord by a number of semitones.
-   *
-   * The quality and interval template are carried over, so a chord that a
-   * symbol round-trip could not express — a custom interval set, an inversion —
-   * survives. A carried key moves with the chord, so the transposed chord keeps
-   * the same degree and function inside the transposed key.
-   *
-   * @param semitones The signed semitone offset.
-   * @returns The transposed chord, in the transposed key when one is carried.
-   * @example
-   * ```ts
-   * import { Chord } from '@libraz/libcantus';
-   * Chord.parse('C/G').transpose(2).symbol(); // 'D/A'
-   * ```
-   */
-  transpose(semitones) {
-    const moved = _chunkBSLTLGM3cjs.transposeChord.call(void 0, this.#given, semitones);
-    const rootSpelling = transposeHint(this.#given.rootSpelling, semitones);
-    const bassSpelling = transposeHint(this.#given.bassSpelling, semitones);
-    if (rootSpelling !== void 0) {
-      moved.rootSpelling = rootSpelling;
-    }
-    if (bassSpelling !== void 0) {
-      moved.bassSpelling = bassSpelling;
-    }
-    return new _Chord(moved, _optionalChain([this, 'access', _14 => _14.#key, 'optionalAccess', _15 => _15.transpose, 'call', _16 => _16(semitones)]));
-  }
-  /**
-   * The named scales that fit over this chord, best fit first, rooted on the
-   * chord root.
-   *
-   * @returns The matching scales.
-   */
-  scales() {
-    return _chunkOL3IHHSJcjs.chordScales.call(void 0, this.#data);
-  }
-  /**
-   * The available tensions (usable non-chord, non-avoid scale tones) of a
-   * scale over this chord.
-   *
-   * @param scaleName A named scale, rooted on the chord root.
-   * @returns Tension pitch classes, ascending in [0, 11].
-   * @throws If `scaleName` is not a built-in scale.
-   */
-  tensions(scaleName) {
-    return _chunkOL3IHHSJcjs.availableTensions.call(void 0, this.#data, scaleName);
-  }
-  /**
-   * The avoid notes (scale tones a semitone above a chord tone) of a scale
-   * over this chord.
-   *
-   * @param scaleName A named scale, rooted on the chord root.
-   * @returns Avoid-note pitch classes, ascending in [0, 11].
-   * @throws If `scaleName` is not a built-in scale.
-   */
-  avoidNotes(scaleName) {
-    return _chunkOL3IHHSJcjs.avoidNotes.call(void 0, this.#data, scaleName);
-  }
-  /**
-   * Spell the chord tones with letter names, root first, in the key's spelling.
-   *
-   * A chord that already knows how its root is spelled — one from
-   * `Chord.parse`, or `Chord.of` with a named root — can spell itself with no
-   * key at all; a key is only needed to choose a spelling for a bare pitch
-   * class.
-   *
-   * A slash bass outside the chord tones is appended, so the spelled notes
-   * are the notes the chord sounds — the same set {@link Chord.pitchClasses}
-   * reports.
-   *
-   * @param key Key providing the spelled tonic; falls back to the carried
-   *   context, then to the chord's own root spelling.
-   * @returns Spelled octave-less notes in the chord's own (tertian) order,
-   *   with any foreign slash bass last.
-   * @throws If no key is given, none is carried, and the chord has no root
-   *   spelling of its own.
-   */
-  spell(key) {
-    const resolved = _nullishCoalesce(key, () => ( this.#key));
-    const data = this.#dataWithKey(resolved);
-    let tones;
-    if (resolved === void 0) {
-      const root = data.rootSpelling;
-      if (root === void 0) {
-        throw new (0, _chunkPI3UXRWKcjs.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 = _chunkOL3IHHSJcjs.spellChordFromRoot.call(void 0, data, root);
-    } else {
-      tones = _chunkOL3IHHSJcjs.spellChord.call(void 0, data, resolved.tonic.data, resolved.scale);
-    }
-    const bassPc = data.bassPc;
-    const bass = data.bassSpelling;
-    if (bassPc !== void 0 && bass !== void 0 && !tones.some((tone) => _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, _chunkPI3UXRWKcjs.noteToPitchClass.call(void 0, tone)) === _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, bassPc))) {
-      tones = [...tones, { letter: bass.letter, alter: bass.alter }];
-    }
-    return tones.map((note) => new Note(note));
-  }
-  /**
-   * Start a progression with this chord followed by others, carrying this
-   * chord's key context (if any).
-   *
-   * @param others The chords following this one.
-   * @returns The progression.
-   */
-  progressionTo(...others) {
-    return new Progression([this, ...others], this.#key);
-  }
-  /**
-   * Whether another chord has the same root, quality, intervals, and bass.
-   * Key context is not compared.
-   *
-   * @param other The chord to compare.
-   * @returns True if the chord data is identical.
-   */
-  equals(other) {
-    const a = this.#data;
-    const b = other.data;
-    return a.rootPc === b.rootPc && a.quality === b.quality && a.bassPc === b.bassPc && a.intervals.length === b.intervals.length && a.intervals.every((interval, i) => interval === b.intervals[i]);
-  }
-  /**
-   * The plain chord data, for JSON serialization.
-   *
-   * @returns A copy of the underlying plain chord object.
-   */
-  toJSON() {
-    return copyChord(this.#given);
-  }
-  /**
-   * The chord symbol, so a template literal or a log line reads as the chord.
-   *
-   * @returns The symbol, e.g. `'Cmaj7'`.
-   */
-  toString() {
-    return this.symbol();
-  }
-  /** Resolve the key for an analysis method: explicit first, then carried. */
-  #resolveKey(key) {
-    const resolved = _nullishCoalesce(key, () => ( this.#key));
-    if (resolved === void 0) {
-      throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(
-        "chord has no key context; pass a Key or attach one with withKey()"
-      );
-    }
-    return resolved;
-  }
-};
-
-
-
-
-
-
-
-exports.Interval = Interval; exports.Note = Note; exports.Key = Key; exports.Progression = Progression; exports.Chord = Chord;
-//# sourceMappingURL=chunk-WTAN4ACG.cjs.map