@libraz/libcantus 0.9.4 → 1.0.0

package/dist/chunk-6XPTBE7Y.cjs

@@ -0,0 +1,49 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkUADYAYATcjs = require('./chunk-UADYAYAT.cjs');
+
+
+var _chunkQ2WGKJNNcjs = require('./chunk-Q2WGKJNN.cjs');
+
+// src/theory/harmony/index.ts
+function suspendedIntervalOf(chord) {
+  const sounds = (ic) => chord.intervals.some((interval) => _chunkQ2WGKJNNcjs.pitchClassOf.call(void 0, interval) === ic);
+  if (sounds(3) || sounds(4)) {
+    return void 0;
+  }
+  const spec = _chunkUADYAYATcjs.chordSpecOf.call(void 0, chord);
+  if (spec.base === "sus4") {
+    return sounds(5) ? 5 : void 0;
+  }
+  if (spec.base === "sus2") {
+    return sounds(2) ? 2 : void 0;
+  }
+  return spec.omissions.includes(3) && sounds(5) ? 5 : void 0;
+}
+function roleOf(pitch, chord, chordId = 0) {
+  const data = _chunkUADYAYATcjs.toChordData.call(void 0, chord);
+  const interval = (_chunkQ2WGKJNNcjs.pitchClassOf.call(void 0, pitch) - _chunkQ2WGKJNNcjs.pitchClassOf.call(void 0, data.rootPc) + 12) % 12;
+  const suspended = suspendedIntervalOf(data);
+  const isSuspendedTone = suspended !== void 0 && interval === suspended;
+  const chordRole = _chunkUADYAYATcjs.chordToneRole.call(void 0, pitch, data);
+  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 };
+}
+
+
+
+exports.roleOf = roleOf;
+//# sourceMappingURL=chunk-6XPTBE7Y.cjs.map

package/dist/chunk-6XPTBE7Y.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/libcantus/libcantus/dist/chunk-6XPTBE7Y.cjs","../src/theory/harmony/index.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;ACkCA,SAAS,mBAAA,CAAoB,KAAA,EAAkC;AAC7D,EAAA,MAAM,OAAA,EAAS,CAAC,EAAA,EAAA,GACd,KAAA,CAAM,SAAA,CAAU,IAAA,CAAK,CAAC,QAAA,EAAA,GAAa,4CAAA,QAAqB,EAAA,IAAM,EAAE,CAAA;AAClE,EAAA,GAAA,CAAI,MAAA,CAAO,CAAC,EAAA,GAAK,MAAA,CAAO,CAAC,CAAA,EAAG;AAC1B,IAAA,OAAO,KAAA,CAAA;AAAA,EACT;AACA,EAAA,MAAM,KAAA,EAAO,2CAAA,KAAiB,CAAA;AAC9B,EAAA,GAAA,CAAI,IAAA,CAAK,KAAA,IAAS,MAAA,EAAQ;AACxB,IAAA,OAAO,MAAA,CAAO,CAAC,EAAA,EAAI,EAAA,EAAI,KAAA,CAAA;AAAA,EACzB;AACA,EAAA,GAAA,CAAI,IAAA,CAAK,KAAA,IAAS,MAAA,EAAQ;AACxB,IAAA,OAAO,MAAA,CAAO,CAAC,EAAA,EAAI,EAAA,EAAI,KAAA,CAAA;AAAA,EACzB;AACA,EAAA,OAAO,IAAA,CAAK,SAAA,CAAU,QAAA,CAAS,CAAC,EAAA,GAAK,MAAA,CAAO,CAAC,EAAA,EAAI,EAAA,EAAI,KAAA,CAAA;AACvD;AAkCO,SAAS,MAAA,CAAO,KAAA,EAAe,KAAA,EAAkB,QAAA,EAAU,CAAA,EAAe;AAC/E,EAAA,MAAM,KAAA,EAAO,2CAAA,KAAiB,CAAA;AAC9B,EAAA,MAAM,SAAA,EAAA,CAAY,4CAAA,KAAkB,EAAA,EAAI,4CAAA,IAAa,CAAK,MAAM,EAAA,EAAI,EAAA,EAAA,EAAM,EAAA;AAC1E,EAAA,MAAM,UAAA,EAAY,mBAAA,CAAoB,IAAI,CAAA;AAC1C,EAAA,MAAM,gBAAA,EAAkB,UAAA,IAAc,KAAA,EAAA,GAAa,SAAA,IAAa,SAAA;AAChE,EAAA,MAAM,UAAA,EAAY,6CAAA,KAAc,EAAO,IAAI,CAAA;AAC3C,EAAA,IAAI,IAAA;AACJ,EAAA,IAAI,IAAA;AACJ,EAAA,GAAA,CAAI,eAAA,EAAiB;AACnB,IAAA,KAAA,EAAO,OAAA;AACP,IAAA,KAAA,EAAO,SAAA;AAAA,EACT,EAAA,KAAA,GAAA,CAAW,UAAA,IAAc,IAAA,EAAM;AAC7B,IAAA,KAAA,EAAO,SAAA;AACP,IAAA,KAAA,EAAO,UAAA,IAAc,OAAA,EAAS,WAAA,EAAa,UAAA,IAAc,QAAA,EAAU,UAAA,EAAY,SAAA;AAAA,EACjF,EAAA,KAAO;AACL,IAAA,KAAA,EAAO,SAAA;AACP,IAAA,KAAA,EAAO,SAAA;AAAA,EACT;AACA,EAAA,OAAO,EAAE,IAAA,EAAM,IAAA,EAAM,gBAAA,EAAkB,QAAQ,CAAA;AACjD;ADlEA;AACA;AACE;AACF,wBAAC","file":"/home/runner/work/libcantus/libcantus/dist/chunk-6XPTBE7Y.cjs","sourcesContent":[null,"import { pitchClassOf } from '../../core/pitch/index.js';\nimport { type Chord, type ChordToneRole, chordSpecOf, chordToneRole } from '../chord/index.js';\nimport { type ChordLike, toChordData } from '../symbol/index.js';\n\n/**\n * Harmonic role a pitch plays within a chord.\n *\n * @category Functional Harmony\n */\nexport type HarmonyRole = ChordToneRole | '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 * The one interval class standing in for a chord's absent third, if any.\n *\n * Read from the chord's structure rather than from its sounding pitch classes:\n * an eleventh chord's tensions fold onto 2 and 5 in pitch-class space, so a set\n * of folded intervals cannot say which of them replaced the third — and both\n * would answer, leaving one chord with two quality-defining tones. The\n * suspension a `sus4` or `sus2` names is its fourth or its second; an eleventh\n * chord's is the eleventh, the tone its omitted third gave way to.\n */\nfunction suspendedIntervalOf(chord: Chord): number | undefined {\n  const sounds = (ic: number): boolean =>\n    chord.intervals.some((interval) => pitchClassOf(interval) === ic);\n  if (sounds(3) || sounds(4)) {\n    return undefined;\n  }\n  const spec = chordSpecOf(chord);\n  if (spec.base === 'sus4') {\n    return sounds(5) ? 5 : undefined;\n  }\n  if (spec.base === 'sus2') {\n    return sounds(2) ? 2 : undefined;\n  }\n  return spec.omissions.includes(3) && sounds(5) ? 5 : undefined;\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, read\n * against the chord's own template: root (0), third (3/4), fifth (6/7/8),\n * sixth or seventh (9/10/11). Every pitch the template does not claim is\n * `'tension'` — including one that is simply foreign to the chord, which this\n * single-pitch query cannot tell from a colour tone. The root locks the chord\n * identity, the third locks its quality, and everything else is free voicing.\n * Where a chord has no third, the tone standing in its place — the fourth of a\n * `sus4`, the second of a `sus2`, the eleventh of an eleventh chord — takes the\n * third's slot and is locked to `quality`, since moving it changes the chord.\n * At most one interval class of a chord is ever reported as its third, so a\n * consumer reading `lock: 'quality'` as \"this tone identifies the chord\" gets\n * one answer rather than two. Detecting an octave doubling requires the\n * surrounding voicing, which this query does not carry, so `'doubling'` is part\n * of the type — the shared vocabulary of harmonic roles — but is never returned\n * here.\n *\n * @param pitch MIDI pitch or bare pitch class.\n * @param chord The chord providing the root reference, as a chord symbol, chord\n *   data, or a `Chord`.\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: ChordLike, chordId = 0): VoicedRole {\n  const data = toChordData(chord);\n  const interval = (pitchClassOf(pitch) - pitchClassOf(data.rootPc) + 12) % 12;\n  const suspended = suspendedIntervalOf(data);\n  const isSuspendedTone = suspended !== undefined && interval === suspended;\n  const chordRole = chordToneRole(pitch, data);\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"]}