@libraz/libcantus 0.9.1 → 0.9.3

package/dist/analyze/index.js

@@ -0,0 +1,51 @@
+import {
+  analyzeArrangement,
+  analyzeVoice,
+  chordTimelineFromChords,
+  chordTimelineFromNotes,
+  detectCadences,
+  tensionCurve
+} from "../chunk-GOAW4VYL.js";
+import "../chunk-I5R7ZBJS.js";
+import {
+  analyzeChord,
+  borrowedSource,
+  chordToRoman,
+  detectCadence,
+  detectChord,
+  detectChordBest,
+  detectKey,
+  functionOf,
+  isBorrowedChord,
+  isDiatonic,
+  isMinorKey,
+  parallelKey,
+  romanToChord,
+  secondaryDominant
+} from "../chunk-CHMXELDS.js";
+import "../chunk-EH6EM37U.js";
+import "../chunk-MIWO425M.js";
+import "../chunk-FBQK3ZQN.js";
+export {
+  analyzeArrangement,
+  analyzeChord,
+  analyzeVoice,
+  borrowedSource,
+  chordTimelineFromChords,
+  chordTimelineFromNotes,
+  chordToRoman,
+  detectCadence,
+  detectCadences,
+  detectChord,
+  detectChordBest,
+  detectKey,
+  functionOf,
+  isBorrowedChord,
+  isDiatonic,
+  isMinorKey,
+  parallelKey,
+  romanToChord,
+  secondaryDominant,
+  tensionCurve
+};
+//# sourceMappingURL=index.js.map

package/dist/analyze/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-2ZWMSJH6.js

@@ -0,0 +1,30 @@
+import {
+  chordToneRole
+} from "./chunk-MIWO425M.js";
+
+// src/theory/harmony/index.ts
+function roleOf(pitch, chord, chordId = 0) {
+  const interval = ((Math.trunc(pitch) - chord.rootPc) % 12 + 12) % 12;
+  const tones = new Set(chord.intervals.map((i) => (i % 12 + 12) % 12));
+  const hasThird = tones.has(3) || tones.has(4);
+  const isSuspendedTone = !hasThird && (interval === 5 && tones.has(5) || interval === 2 && tones.has(2));
+  const chordRole = chordToneRole(pitch, chord);
+  let role;
+  let lock;
+  if (isSuspendedTone) {
+    role = "third";
+    lock = "quality";
+  } else if (chordRole !== null) {
+    role = chordRole;
+    lock = chordRole === "root" ? "identity" : chordRole === "third" ? "quality" : "voicing";
+  } else {
+    role = "tension";
+    lock = "voicing";
+  }
+  return { role, lock, belongsToChordId: chordId };
+}
+
+export {
+  roleOf
+};
+//# sourceMappingURL=chunk-2ZWMSJH6.js.map

package/dist/chunk-2ZWMSJH6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/theory/harmony/index.ts"],"sourcesContent":["import { type Chord, chordToneRole } from '../chord/index.js';\n\n/**\n * Harmonic role a pitch plays within a chord.\n *\n * @category Functional Harmony\n */\nexport type HarmonyRole = 'root' | 'third' | 'fifth' | 'sixth' | 'seventh' | 'tension' | 'doubling';\n\n/**\n * How firmly a pitch is locked to the chord's identity.\n *\n * - `identity`: moving it produces a different chord (the root).\n * - `quality`: moving it flips the chord quality (the third).\n * - `voicing`: it can move freely without changing chord identity or quality.\n *\n * @category Functional Harmony\n */\nexport type LockLevel = 'identity' | 'quality' | 'voicing';\n\n/**\n * A pitch's role, lock level, and owning chord.\n *\n * @category Functional Harmony\n */\nexport type VoicedRole = {\n  role: HarmonyRole;\n  lock: LockLevel;\n  belongsToChordId: number;\n};\n\n/**\n * Classify a pitch's harmonic role and lock level within a chord.\n *\n * The role comes from the pitch's interval class above the chord root: root (0),\n * third (3/4), fifth (6/7/8), seventh (10/11), and 9/11/13 tensions (2/5/9, and\n * the flat ninth 1). The root locks the chord identity, the third locks its\n * quality, and everything else is free voicing. In a suspended chord (a chord\n * whose intervals include a 4th (5) or 2nd (2) but no third), the suspended tone\n * takes the third's place as the quality-defining tone and is locked to\n * `quality`, since moving it changes the chord. Detecting an octave doubling\n * requires the surrounding voicing, which this single-pitch query does not carry,\n * so `doubling` is part of the type but not returned here.\n *\n * @param pitch MIDI pitch or bare pitch class.\n * @param chord The chord providing the root reference.\n * @param chordId Identifier stored on the result (defaults to 0).\n * @returns The pitch's role, lock level, and owning chord id.\n * @example\n * ```ts\n * import { roleOf, makeChord } from '@libraz/libcantus';\n * roleOf(64, makeChord(0, 'maj')); // E over C major\n * // { role: 'third', lock: 'quality', belongsToChordId: 0 }\n * ```\n * @category Functional Harmony\n */\nexport function roleOf(pitch: number, chord: Chord, chordId = 0): VoicedRole {\n  const interval = (((Math.trunc(pitch) - chord.rootPc) % 12) + 12) % 12;\n  const tones = new Set(chord.intervals.map((i) => ((i % 12) + 12) % 12));\n  const hasThird = tones.has(3) || tones.has(4);\n  const isSuspendedTone =\n    !hasThird && ((interval === 5 && tones.has(5)) || (interval === 2 && tones.has(2)));\n  const chordRole = chordToneRole(pitch, chord);\n  let role: HarmonyRole;\n  let lock: LockLevel;\n  if (isSuspendedTone) {\n    role = 'third'; // suspended tone occupies the third's quality-defining slot\n    lock = 'quality';\n  } else if (chordRole !== null) {\n    role = chordRole;\n    lock = chordRole === 'root' ? 'identity' : chordRole === 'third' ? 'quality' : 'voicing';\n  } else {\n    role = 'tension';\n    lock = 'voicing';\n  }\n  return { role, lock, belongsToChordId: chordId };\n}\n"],"mappings":";;;;;AAwDO,SAAS,OAAO,OAAe,OAAc,UAAU,GAAe;AAC3E,QAAM,aAAc,KAAK,MAAM,KAAK,IAAI,MAAM,UAAU,KAAM,MAAM;AACpE,QAAM,QAAQ,IAAI,IAAI,MAAM,UAAU,IAAI,CAAC,OAAQ,IAAI,KAAM,MAAM,EAAE,CAAC;AACtE,QAAM,WAAW,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC;AAC5C,QAAM,kBACJ,CAAC,aAAc,aAAa,KAAK,MAAM,IAAI,CAAC,KAAO,aAAa,KAAK,MAAM,IAAI,CAAC;AAClF,QAAM,YAAY,cAAc,OAAO,KAAK;AAC5C,MAAI;AACJ,MAAI;AACJ,MAAI,iBAAiB;AACnB,WAAO;AACP,WAAO;AAAA,EACT,WAAW,cAAc,MAAM;AAC7B,WAAO;AACP,WAAO,cAAc,SAAS,aAAa,cAAc,UAAU,YAAY;AAAA,EACjF,OAAO;AACL,WAAO;AACP,WAAO;AAAA,EACT;AACA,SAAO,EAAE,MAAM,MAAM,kBAAkB,QAAQ;AACjD;","names":[]}