@libraz/libcantus 0.9.3 → 0.9.5

package/dist/chunk-KQN2ZYND.cjs

@@ -0,0 +1,724 @@
+"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 _chunkBSLTLGM3cjs = require('./chunk-BSLTLGM3.cjs');
+
+
+
+
+
+
+
+
+var _chunkPI3UXRWKcjs = require('./chunk-PI3UXRWK.cjs');
+
+// src/analyze/detect/index.ts
+function uniquePitchClasses(pitches) {
+  return [...new Set(pitches.map(_chunkPI3UXRWKcjs.pitchClassOf))].sort((a, b) => a - b);
+}
+function assertPitches(pitches, name, budget = void 0) {
+  _chunkPI3UXRWKcjs.assertGenerationBudget.call(void 0, pitches.length, name, budget);
+  for (let index = 0; index < pitches.length; index += 1) {
+    _chunkPI3UXRWKcjs.assertMidiPitch.call(void 0, _nullishCoalesce(pitches[index], () => ( Number.NaN)), `pitches[${index}]`);
+  }
+}
+function detectChord(pitches, opts = {}) {
+  assertPitches(pitches, "chord detection pitches");
+  if (opts.bassPc !== void 0) _chunkPI3UXRWKcjs.assertFiniteNumber.call(void 0, opts.bassPc, "bassPc");
+  const input = uniquePitchClasses(pitches);
+  if (input.length === 0) {
+    return [];
+  }
+  const inputKind = opts.input === void 0 || opts.input === "auto" ? pitches.every((pitch) => Number.isInteger(pitch) && pitch >= 0 && pitch <= 11) ? "pitchClass" : "midi" : opts.input;
+  const bassPc = opts.bassPc !== void 0 ? _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, opts.bassPc) : inputKind === "midi" ? _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, pitches.reduce((lowest, pitch) => Math.min(lowest, pitch), Infinity)) : void 0;
+  const inputSet = new Set(input);
+  const matches = [];
+  const qualities = _chunkBSLTLGM3cjs.chordQualities.call(void 0, );
+  const toneCounts = new Map(
+    qualities.map((quality) => [quality, _chunkBSLTLGM3cjs.chordPitchClasses.call(void 0, _chunkBSLTLGM3cjs.makeChord.call(void 0, 0, quality)).length])
+  );
+  for (const rootPc of input) {
+    for (const quality of qualities) {
+      const chord = _chunkBSLTLGM3cjs.makeChord.call(void 0, rootPc, quality);
+      const tones = _chunkBSLTLGM3cjs.chordPitchClasses.call(void 0, chord);
+      const toneSet = new Set(tones);
+      const missingPcs = tones.filter((pc) => !inputSet.has(pc));
+      const fifthPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, rootPc + 7);
+      if (missingPcs.length > 1 || missingPcs.length === 1 && missingPcs[0] !== fifthPc) {
+        continue;
+      }
+      const extraPcs = input.filter((pc) => !toneSet.has(pc));
+      const bassIndex = bassPc === void 0 ? -1 : chord.intervals.findIndex((iv) => _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, rootPc + iv) === bassPc);
+      const inversion = bassPc === void 0 || bassIndex < 0 ? null : bassIndex;
+      const match = {
+        rootPc,
+        quality,
+        missingPcs,
+        extraPcs,
+        exact: extraPcs.length === 0 && missingPcs.length === 0,
+        inversion
+      };
+      if (bassPc !== void 0 && bassPc !== rootPc) {
+        match.bassPc = bassPc;
+      }
+      matches.push(match);
+    }
+  }
+  matches.sort((a, b) => {
+    if (a.extraPcs.length !== b.extraPcs.length) {
+      return a.extraPcs.length - b.extraPcs.length;
+    }
+    if (a.missingPcs.length !== b.missingPcs.length) {
+      return a.missingPcs.length - b.missingPcs.length;
+    }
+    if (a.inversion === 0 !== (b.inversion === 0)) {
+      return a.inversion === 0 ? -1 : 1;
+    }
+    const aSize = _nullishCoalesce(toneCounts.get(a.quality), () => ( 0));
+    const bSize = _nullishCoalesce(toneCounts.get(b.quality), () => ( 0));
+    return bSize - aSize;
+  });
+  return matches;
+}
+function detectChordBest(pitches, opts = {}) {
+  const best = detectChord(pitches, opts)[0];
+  if (!best) {
+    return null;
+  }
+  return _chunkBSLTLGM3cjs.makeChord.call(void 0, best.rootPc, best.quality, best.bassPc);
+}
+var MINOR_VARIANTS = [
+  { variant: "natural", mask: _chunkBSLTLGM3cjs.NATURAL_MINOR_MASK },
+  { variant: "harmonic", mask: _chunkBSLTLGM3cjs.HARMONIC_MINOR_MASK },
+  { variant: "melodic", mask: _chunkBSLTLGM3cjs.MELODIC_MINOR_MASK }
+];
+var MAJOR_VARIANTS = [{ variant: "major", mask: _chunkBSLTLGM3cjs.MAJOR_MASK }];
+function detectKey(pitches, opts = {}) {
+  assertPitches(pitches, "key detection pitches", opts.budget);
+  const weights = opts.weights;
+  if (weights !== void 0 && weights.length !== pitches.length) {
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)("weights must have one entry per pitch");
+  }
+  const counts = /* @__PURE__ */ new Map();
+  let total = 0;
+  for (let index = 0; index < pitches.length; index += 1) {
+    const weight = weights === void 0 ? 1 : _nullishCoalesce(weights[index], () => ( 0));
+    _chunkPI3UXRWKcjs.assertFiniteNumber.call(void 0, weight, `weights[${index}]`);
+    if (weight <= 0) {
+      continue;
+    }
+    const pc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, _nullishCoalesce(pitches[index], () => ( 0)));
+    counts.set(pc, (_nullishCoalesce(counts.get(pc), () => ( 0))) + weight);
+    total += weight;
+  }
+  if (total === 0) {
+    return [];
+  }
+  const input = [...counts.keys()];
+  const results = [];
+  for (let tonic = 0; tonic < 12; tonic += 1) {
+    for (const mode of ["major", "minor"]) {
+      const variants = mode === "major" ? MAJOR_VARIANTS : MINOR_VARIANTS;
+      let inScale = 0;
+      let weighted = Number.NEGATIVE_INFINITY;
+      let best = variants[0];
+      for (const candidate of variants) {
+        let variantInScale = 0;
+        let variantWeighted = 0;
+        for (const pc of input) {
+          const offset = (pc - tonic + 12) % 12;
+          if (candidate.mask >> offset & 1) {
+            variantInScale += 1;
+          }
+        }
+        for (const [pc, count] of counts) {
+          const offset = (pc - tonic + 12) % 12;
+          if (candidate.mask >> offset & 1) {
+            variantWeighted += count;
+          }
+        }
+        if (variantWeighted > weighted) {
+          weighted = variantWeighted;
+          inScale = variantInScale;
+          best = candidate;
+        }
+      }
+      weighted += (_nullishCoalesce(counts.get(tonic), () => ( 0))) * 0.5;
+      results.push({
+        key: { rootPc: tonic, modeMask12: best.mask },
+        mode,
+        variant: best.variant,
+        fit: inScale / input.length,
+        score: weighted / total
+      });
+    }
+  }
+  results.sort((a, b) => b.score - a.score);
+  return results;
+}
+var DEFAULT_VELOCITY = 100;
+function detectKeyFromNotes(notes, opts = {}) {
+  _chunkPI3UXRWKcjs.assertNoteEvents.call(void 0, notes, "key detection notes", {
+    allowNonPositiveDuration: true,
+    budget: opts.budget
+  });
+  const sounding = notes.filter((note) => note.durationBeat > 0);
+  return detectKey(
+    sounding.map((note) => note.pitch),
+    {
+      weights: sounding.map((note) => note.durationBeat * (_nullishCoalesce(note.velocity, () => ( DEFAULT_VELOCITY)))),
+      budget: opts.budget
+    }
+  );
+}
+function detectKeyBest(pitches, opts = {}) {
+  return _nullishCoalesce(detectKey(pitches, opts)[0], () => ( null));
+}
+
+// src/analyze/functional/internal.ts
+function degreeRootPc(degreeNumber, key) {
+  const tones = _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, key);
+  if (tones.length === 0) {
+    return _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc);
+  }
+  const index = ((degreeNumber - 1) % tones.length + tones.length) % tones.length;
+  return _nullishCoalesce(tones[index], () => ( _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc)));
+}
+function loweredDegrees(key) {
+  const tones = _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, key);
+  const out = /* @__PURE__ */ new Set();
+  if (tones.length !== 7) {
+    return out;
+  }
+  const major = _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, { rootPc: _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc), modeMask12: _chunkBSLTLGM3cjs.MAJOR_MASK });
+  for (let index = 0; index < 7; index += 1) {
+    const tone = tones[index];
+    const majorTone = major[index];
+    if (tone !== void 0 && majorTone !== void 0 && _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, majorTone - tone) === 1) {
+      out.add(index + 1);
+    }
+  }
+  return out;
+}
+function romanReference(key) {
+  return _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, key).length === 7 ? key : _chunkBSLTLGM3cjs.majorKey.call(void 0, _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc));
+}
+function isNeapolitan(chord, key) {
+  return _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc - key.rootPc) === 1 && chord.quality === "maj";
+}
+function isAppliedDominantSonority(chord) {
+  const has = (semitones) => chord.intervals.some((i) => _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, i) === semitones);
+  return chord.quality === "maj" || has(4) && has(10);
+}
+
+// src/analyze/functional/roman.ts
+var ROMAN = ["I", "II", "III", "IV", "V", "VI", "VII"];
+var ROMAN_TO_DEGREE = {
+  I: 1,
+  II: 2,
+  III: 3,
+  IV: 4,
+  V: 5,
+  VI: 6,
+  VII: 7
+};
+var OFFSET_SPELLING = [
+  [1, ""],
+  [2, "b"],
+  [2, ""],
+  [3, "b"],
+  [3, ""],
+  [4, ""],
+  [4, "#"],
+  [5, ""],
+  [6, "b"],
+  [6, ""],
+  [7, "b"],
+  [7, ""]
+];
+function seventhQuality(base, halfDim) {
+  if (halfDim) {
+    return "m7b5";
+  }
+  if (base === "dim") {
+    return "dim7";
+  }
+  if (base === "aug") {
+    return "aug7";
+  }
+  return base === "maj" ? "dom7" : "min7";
+}
+var INVERSION_FIGURES = /* @__PURE__ */ new Set(["6", "64", "65", "43", "42", "2", "7"]);
+var ROMAN_STYLE = {
+  maj: { lower: false, suffix: "" },
+  min: { lower: true, suffix: "" },
+  dim: { lower: true, suffix: "o" },
+  aug: { lower: false, suffix: "+" },
+  maj7: { lower: false, suffix: "maj7" },
+  min7: { lower: true, suffix: "7" },
+  dom7: { lower: false, suffix: "7" },
+  dim7: { lower: true, suffix: "o7" },
+  m7b5: { lower: true, suffix: "\xF87" },
+  minMaj7: { lower: true, suffix: "maj7" },
+  minMaj9: { lower: true, suffix: "maj9" },
+  minMaj11: { lower: true, suffix: "maj11" },
+  minMaj13: { lower: true, suffix: "maj13" },
+  aug7: { lower: false, suffix: "+7" },
+  augMaj7: { lower: false, suffix: "+maj7" },
+  majb5: { lower: false, suffix: "b5" },
+  "6": { lower: false, suffix: "add6" },
+  min6: { lower: true, suffix: "add6" },
+  "6/9": { lower: false, suffix: "69" },
+  sus2: { lower: false, suffix: "sus2" },
+  sus4: { lower: false, suffix: "sus4" },
+  add9: { lower: false, suffix: "add9" },
+  add11: { lower: false, suffix: "add11" },
+  maj9: { lower: false, suffix: "maj9" },
+  min9: { lower: true, suffix: "9" },
+  dom9: { lower: false, suffix: "9" },
+  "7b9": { lower: false, suffix: "7b9" },
+  "7#9": { lower: false, suffix: "7#9" },
+  "7#11": { lower: false, suffix: "7#11" },
+  "7b13": { lower: false, suffix: "7b13" },
+  "11": { lower: false, suffix: "11" },
+  "13": { lower: false, suffix: "13" },
+  "5": { lower: false, suffix: "5" },
+  "7sus4": { lower: false, suffix: "7sus4" },
+  "7b5": { lower: false, suffix: "7b5" },
+  "7alt": { lower: false, suffix: "7alt" },
+  "13b9": { lower: false, suffix: "13b9" },
+  maj13: { lower: false, suffix: "maj13" },
+  "maj7#11": { lower: false, suffix: "maj7#11" },
+  min11: { lower: true, suffix: "11" },
+  min13: { lower: true, suffix: "13" },
+  minAdd9: { lower: true, suffix: "add9" },
+  "min6/9": { lower: true, suffix: "69" }
+};
+var SUFFIX_QUALITY = new Map(
+  Object.entries(ROMAN_STYLE).map(
+    ([quality, style]) => [`${style.lower ? "l" : "u"}:${style.suffix}`, quality]
+  )
+);
+function parseInversion(figures) {
+  if (figures === "65") {
+    return { inversion: 1, seventh: true };
+  }
+  if (figures === "43") {
+    return { inversion: 2, seventh: true };
+  }
+  if (figures === "42" || figures === "2") {
+    return { inversion: 3, seventh: true };
+  }
+  if (figures === "7") {
+    return { inversion: 0, seventh: true };
+  }
+  if (figures === "64") {
+    return { inversion: 2, seventh: false };
+  }
+  if (figures === "6") {
+    return { inversion: 1, seventh: false };
+  }
+  return { inversion: 0, seventh: false };
+}
+function parseSimpleRoman(text, key) {
+  const match = /^([b#]?)([iIvV]+)(.*)$/.exec(text.trim());
+  if (!match) {
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(`Invalid Roman numeral: ${text}`);
+  }
+  const glyphText = _nullishCoalesce(match[2], () => ( ""));
+  if (glyphText !== glyphText.toUpperCase() && glyphText !== glyphText.toLowerCase()) {
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(`Roman numeral must use one case: ${text}`);
+  }
+  const accidental = match[1] === "b" ? -1 : match[1] === "#" ? 1 : 0;
+  const glyph = glyphText.toUpperCase();
+  const degreeNumber = ROMAN_TO_DEGREE[glyph];
+  if (degreeNumber === void 0) {
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(`Invalid Roman numeral: ${text}`);
+  }
+  const isUpper = glyphText[0] === _optionalChain([glyphText, 'access', _ => _[0], 'optionalAccess', _2 => _2.toUpperCase, 'call', _3 => _3()]);
+  const suffix = _nullishCoalesce(match[3], () => ( ""));
+  const frame = romanReference(key);
+  const redundantFlat = accidental === -1 && loweredDegrees(frame).has(degreeNumber);
+  const diatonicRootPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, 
+    degreeRootPc(degreeNumber, frame) + (redundantFlat ? 0 : accidental)
+  );
+  const rootForQuality = (quality2) => accidental === 0 && degreeNumber === 7 && loweredDegrees(frame).has(7) && (quality2 === "dim" || quality2 === "dim7") ? _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, diatonicRootPc + 1) : diatonicRootPc;
+  const canonical = SUFFIX_QUALITY.get(`${isUpper ? "u" : "l"}:${suffix}`);
+  if (canonical !== void 0) {
+    return { rootPc: rootForQuality(canonical), quality: canonical, inversion: 0 };
+  }
+  const parsedSuffix = /^(o|°|dim|ø|\+|aug)?(maj7|M7)?(65|64|43|42|7|6|2)?$/.exec(suffix);
+  if (!parsedSuffix) {
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(`Unsupported suffix "${suffix}" in Roman numeral: ${text}`);
+  }
+  const qualityMarker = _nullishCoalesce(parsedSuffix[1], () => ( ""));
+  const isDim = qualityMarker === "o" || qualityMarker === "\xB0" || qualityMarker === "dim";
+  const isAug = qualityMarker === "+" || qualityMarker === "aug";
+  const isHalfDim = qualityMarker === "\xF8";
+  const explicitMaj7 = parsedSuffix[2] !== void 0;
+  const figures = _nullishCoalesce(parsedSuffix[3], () => ( ""));
+  if (figures !== "" && !INVERSION_FIGURES.has(figures)) {
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(
+      `Unsupported figured-bass or extension "${figures}" in Roman numeral: ${text}`
+    );
+  }
+  const { inversion, seventh } = parseInversion(figures);
+  const hasSeventh = explicitMaj7 || seventh || isHalfDim;
+  let base;
+  if (isDim || isHalfDim) {
+    base = "dim";
+  } else if (isAug) {
+    base = "aug";
+  } else {
+    base = isUpper ? "maj" : "min";
+  }
+  let quality;
+  if (explicitMaj7) {
+    quality = base === "min" ? "minMaj7" : base === "aug" ? "augMaj7" : "maj7";
+  } else if (hasSeventh) {
+    quality = seventhQuality(base, isHalfDim);
+  } else if (base === "dim") {
+    quality = "dim";
+  } else if (base === "aug") {
+    quality = "aug";
+  } else {
+    quality = base;
+  }
+  return { rootPc: rootForQuality(quality), quality, inversion };
+}
+function chordFromParsed(parsed) {
+  const chord = _chunkBSLTLGM3cjs.makeChord.call(void 0, parsed.rootPc, parsed.quality);
+  if (parsed.inversion > 0 && parsed.inversion < chord.intervals.length) {
+    chord.bassPc = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, parsed.rootPc + (_nullishCoalesce(chord.intervals[parsed.inversion], () => ( 0))));
+  }
+  return chord;
+}
+function romanToChord(text, key) {
+  const trimmed = text.trim().replace(/(\d)\/(?=\d)/g, "$1");
+  const slash = trimmed.indexOf("/");
+  if (slash >= 0) {
+    const applied = trimmed.slice(0, slash);
+    const target = trimmed.slice(slash + 1);
+    const targetRoot = parseSimpleRoman(target, key).rootPc;
+    const localKey = _chunkBSLTLGM3cjs.majorKey.call(void 0, targetRoot);
+    return chordFromParsed(parseSimpleRoman(applied, localKey));
+  }
+  return chordFromParsed(parseSimpleRoman(trimmed, key));
+}
+function romanStyle(quality) {
+  return ROMAN_STYLE[quality];
+}
+function romanSpelling(rootPc, key) {
+  const tones = _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, romanReference(key));
+  const diatonic = tones.indexOf(_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, rootPc));
+  if (diatonic >= 0) {
+    return { degreeNumber: diatonic + 1, accidental: "" };
+  }
+  const lowered = loweredDegrees(romanReference(key));
+  for (let i = 0; i < tones.length; i += 1) {
+    if (lowered.has(i + 1) && _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, (_nullishCoalesce(tones[i], () => ( 0))) + 1) === _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, rootPc)) {
+      return { degreeNumber: i + 1, accidental: "#" };
+    }
+  }
+  for (let i = 0; i < tones.length; i += 1) {
+    const degreeNumber2 = i + 1;
+    if (degreeNumber2 === 1 || degreeNumber2 === 5) {
+      continue;
+    }
+    if (_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, (_nullishCoalesce(tones[i], () => ( 0))) - 1) === _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, rootPc)) {
+      return { degreeNumber: degreeNumber2, accidental: "b" };
+    }
+  }
+  for (let i = 0; i < tones.length; i += 1) {
+    if (_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, (_nullishCoalesce(tones[i], () => ( 0))) + 1) === _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, rootPc)) {
+      return { degreeNumber: i + 1, accidental: "#" };
+    }
+  }
+  const [degreeNumber, accidental] = _nullishCoalesce(OFFSET_SPELLING[_chunkPI3UXRWKcjs.pitchClassOf.call(void 0, rootPc - key.rootPc)], () => ( [1, ""]));
+  return { degreeNumber, accidental };
+}
+function baseMarker(quality) {
+  if (quality === "dim" || quality === "dim7") {
+    return "o";
+  }
+  if (quality === "m7b5") {
+    return "\xF8";
+  }
+  if (quality === "aug" || quality === "aug7") {
+    return "+";
+  }
+  if (quality === "augMaj7") {
+    return "+maj7";
+  }
+  if (quality === "maj7" || quality === "minMaj7") {
+    return "maj7";
+  }
+  return "";
+}
+var TRIAD_FIGURES = { 1: "6", 2: "64" };
+var SEVENTH_FIGURES = { 1: "65", 2: "43", 3: "42" };
+var TRIAD_FIGURE_QUALITIES = /* @__PURE__ */ new Set(["maj", "min", "dim", "aug"]);
+var SEVENTH_FIGURE_QUALITIES = /* @__PURE__ */ new Set([
+  "maj7",
+  "min7",
+  "dom7",
+  "dim7",
+  "m7b5",
+  "minMaj7",
+  "aug7",
+  "augMaj7"
+]);
+function numeralFor(degreeNumber, lower) {
+  const glyph = ROMAN[degreeNumber - 1];
+  if (glyph === void 0) {
+    throw new (0, _chunkPI3UXRWKcjs.InvalidInputError)(`no Roman numeral for scale degree ${degreeNumber}`);
+  }
+  return lower ? glyph.toLowerCase() : glyph;
+}
+function isDiatonicChord(chord, key) {
+  return _chunkBSLTLGM3cjs.chordPitchClasses.call(void 0, chord).every((pc) => _chunkBSLTLGM3cjs.isScaleTone.call(void 0, pc, key));
+}
+var LEADING_TONE_QUALITIES = /* @__PURE__ */ new Set(["dim", "dim7", "m7b5"]);
+function degreeTriad(tones, index) {
+  const root = _nullishCoalesce(tones[index], () => ( 0));
+  return {
+    third: _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, (_nullishCoalesce(tones[(index + 2) % tones.length], () => ( 0))) - root),
+    fifth: _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, (_nullishCoalesce(tones[(index + 4) % tones.length], () => ( 0))) - root)
+  };
+}
+function appliedTarget(chord, key) {
+  const dominant = isAppliedDominantSonority(chord);
+  const leadingTone = LEADING_TONE_QUALITIES.has(chord.quality);
+  if (!dominant && !leadingTone) {
+    return null;
+  }
+  const tones = _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, romanReference(key));
+  for (let index = 1; index < tones.length; index += 1) {
+    const targetRoot = tones[index];
+    if (targetRoot === void 0) {
+      continue;
+    }
+    const triad = degreeTriad(tones, index);
+    const expectedRoot = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, targetRoot + (dominant ? 7 : -1));
+    if (expectedRoot === _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc)) {
+      return { degreeNumber: index + 1, rootPc: targetRoot, lower: triad.third === 3 };
+    }
+  }
+  return null;
+}
+function chordToRoman(chord, key, opts = {}) {
+  if (opts.applied === true && !isDiatonicChord(chord, key)) {
+    const target = appliedTarget(chord, key);
+    if (target !== null) {
+      const local = chordToRoman(chord, _chunkBSLTLGM3cjs.majorKey.call(void 0, target.rootPc));
+      return `${local}/${numeralFor(target.degreeNumber, target.lower)}`;
+    }
+  }
+  const { degreeNumber, accidental: spelledAccidental } = romanSpelling(chord.rootPc, key);
+  const { lower, suffix } = romanStyle(chord.quality);
+  const cased = numeralFor(degreeNumber, lower);
+  const accidental = spelledAccidental === "#" && degreeNumber === 7 && loweredDegrees(romanReference(key)).has(7) && (chord.quality === "dim" || chord.quality === "dim7") ? "" : spelledAccidental;
+  let inversion = 0;
+  if (chord.bassPc !== void 0) {
+    const idx = chord.intervals.findIndex((iv) => _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc + iv) === chord.bassPc);
+    if (idx > 0) {
+      inversion = idx;
+    }
+  }
+  if (inversion > 0) {
+    const figure = SEVENTH_FIGURE_QUALITIES.has(chord.quality) ? SEVENTH_FIGURES[inversion] : TRIAD_FIGURE_QUALITIES.has(chord.quality) ? TRIAD_FIGURES[inversion] : void 0;
+    if (figure !== void 0) {
+      return `${accidental}${cased}${baseMarker(chord.quality)}${figure}`;
+    }
+  }
+  return `${accidental}${cased}${suffix}`;
+}
+
+// src/analyze/functional/borrowed.ts
+function isMinorScaleAlteration(chord, key) {
+  if (!isMinorKey(key)) return false;
+  const alteredKey = { rootPc: _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc), modeMask12: _chunkBSLTLGM3cjs.HARMONIC_MINOR_MASK };
+  if (isDiatonic(chord, alteredKey)) return true;
+  return _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc - key.rootPc) === 11 && isDiatonic(chord, { rootPc: _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc), modeMask12: _chunkBSLTLGM3cjs.MELODIC_MINOR_MASK });
+}
+function isBorrowedChord(chord, key) {
+  if (isDiatonic(chord, key)) {
+    return false;
+  }
+  if (isNeapolitan(chord, key)) {
+    return true;
+  }
+  if (isMinorScaleAlteration(chord, key)) {
+    return false;
+  }
+  return isDiatonic(chord, parallelKey(key));
+}
+function borrowedSource(chord, key) {
+  if (isDiatonic(chord, key)) {
+    return null;
+  }
+  if (isNeapolitan(chord, key)) return "neapolitan";
+  if (isBorrowedChord(chord, key)) {
+    return isMinorKey(key) ? "parallelMajor" : "parallelMinor";
+  }
+  return null;
+}
+
+// src/analyze/functional/function.ts
+var FUNCTION_BY_OFFSET = [
+  "tonic",
+  // 0  I
+  "subdominant",
+  // 1  bII (Neapolitan)
+  "subdominant",
+  // 2  ii
+  "tonic",
+  // 3  bIII
+  "tonic",
+  // 4  iii
+  "subdominant",
+  // 5  IV
+  "dominant",
+  // 6  #IV / bV
+  "dominant",
+  // 7  V
+  "subdominant",
+  // 8  bVI
+  "tonic",
+  // 9  vi
+  "subdominant",
+  // 10 bVII
+  "dominant"
+  // 11 vii
+];
+var MINOR_FUNCTION_BY_OFFSET = [
+  "tonic",
+  "subdominant",
+  "subdominant",
+  "tonic",
+  "dominant",
+  "subdominant",
+  "dominant",
+  "dominant",
+  "tonic",
+  "tonic",
+  "subdominant",
+  "dominant"
+];
+function isMinorKey(key) {
+  const hasMinorThird = key.modeMask12 >> 3 & 1;
+  const hasMajorThird2 = key.modeMask12 >> 4 & 1;
+  return Boolean(hasMinorThird) && !hasMajorThird2;
+}
+function functionOf(chord, key) {
+  const offset = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc - key.rootPc);
+  if (isNeapolitan(chord, key)) {
+    return "subdominant";
+  }
+  if (isAppliedDominant(chord, key)) {
+    return "dominant";
+  }
+  if (!isMinorKey(key) && hasMajorThird(chord) && (offset === 8 || offset === 10)) {
+    return "subdominant";
+  }
+  const functions = isMinorKey(key) ? MINOR_FUNCTION_BY_OFFSET : FUNCTION_BY_OFFSET;
+  return _nullishCoalesce(functions[offset], () => ( "tonic"));
+}
+function isAppliedDominant(chord, key) {
+  if (isDiatonic(chord, key)) {
+    return false;
+  }
+  const root = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, chord.rootPc);
+  const resolvesTo = (step) => _chunkBSLTLGM3cjs.isScaleTone.call(void 0, _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, root + step), key);
+  if (isAppliedDominantSonority(chord)) {
+    return chord.quality === "maj" ? resolvesTo(5) : resolvesTo(5) || resolvesTo(11);
+  }
+  return isDiminishedQuality(chord.quality) && resolvesTo(1);
+}
+function isDiatonic(chord, key) {
+  return _chunkBSLTLGM3cjs.chordPitchClasses.call(void 0, chord).every((pc) => _chunkBSLTLGM3cjs.isScaleTone.call(void 0, pc, key));
+}
+function parallelKey(key) {
+  return {
+    rootPc: _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc),
+    modeMask12: isMinorKey(key) ? _chunkBSLTLGM3cjs.MAJOR_MASK : _chunkBSLTLGM3cjs.NATURAL_MINOR_MASK
+  };
+}
+function isDiminishedQuality(quality) {
+  return quality === "dim" || quality === "dim7" || quality === "m7b5";
+}
+function hasMajorThird(chord) {
+  return chord.intervals.some((interval) => _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, interval) === 4);
+}
+function analyzeChord(chord, key, opts = {}) {
+  const source = borrowedSource(chord, key);
+  return {
+    function: functionOf(chord, key),
+    borrowed: source !== null,
+    source,
+    roman: chordToRoman(chord, key, opts)
+  };
+}
+function secondaryDominant(targetDegree, key) {
+  const degreeCount = _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder.call(void 0, key).length;
+  _chunkPI3UXRWKcjs.assertInteger.call(void 0, targetDegree, "targetDegree", 0, degreeCount - 1);
+  const targetRoot = degreeRootPc(targetDegree + 1, key);
+  return _chunkBSLTLGM3cjs.makeChord.call(void 0, _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, targetRoot + 7), "dom7");
+}
+
+// src/analyze/functional/cadence.ts
+function hasDominantThird(chord) {
+  return chord.intervals.some((interval) => _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, interval) === 4);
+}
+function isLeadingToneDiminished(chord) {
+  return chord.quality === "dim" || chord.quality === "dim7" || chord.quality === "m7b5";
+}
+function detectCadence(from, to, key) {
+  const tonic = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, key.rootPc);
+  const fromOffset = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, from.rootPc - tonic);
+  const toOffset = _chunkPI3UXRWKcjs.pitchClassOf.call(void 0, to.rootPc - tonic);
+  const deceptiveTargets = isMinorKey(key) ? [8] : [8, 9];
+  const dominant = fromOffset === 7 && hasDominantThird(from);
+  const leadingTone = fromOffset === 11 && isLeadingToneDiminished(from);
+  if ((dominant || leadingTone) && toOffset === 0) {
+    return "authentic";
+  }
+  if (fromOffset === 5 && toOffset === 0) {
+    return "plagal";
+  }
+  if (dominant && deceptiveTargets.includes(toOffset)) {
+    return "deceptive";
+  }
+  if (toOffset === 7 && hasDominantThird(to) && fromOffset !== 7) {
+    return "half";
+  }
+  return null;
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.detectChord = detectChord; exports.detectChordBest = detectChordBest; exports.detectKey = detectKey; exports.detectKeyFromNotes = detectKeyFromNotes; exports.detectKeyBest = detectKeyBest; exports.romanToChord = romanToChord; exports.chordToRoman = chordToRoman; exports.isMinorKey = isMinorKey; exports.functionOf = functionOf; exports.isDiatonic = isDiatonic; exports.parallelKey = parallelKey; exports.analyzeChord = analyzeChord; exports.secondaryDominant = secondaryDominant; exports.isBorrowedChord = isBorrowedChord; exports.borrowedSource = borrowedSource; exports.detectCadence = detectCadence;
+//# sourceMappingURL=chunk-KQN2ZYND.cjs.map