@libraz/libcantus 1.2.0 → 1.4.0

package/dist/generate/index.d.ts

@@ -1,15 +1,16 @@
-import { h as NoteEvent, a as Articulation, b as IntervalLike } from '../index-Cy15oTvh.js';
-export { I as IntervalData, c as IntervalQualityLabel, e as KeyScale, g as NoteData, S as SpelledInterval } from '../index-Cy15oTvh.js';
-import { e as ChordSegment, c as ChordLike, K as KeyLike } from '../coerce-DP0vYu-x.js';
-export { b as ChordData, d as ChordQuality, g as ChordSpan, i as ChordToneRole, k as KeyVariant, l as PitchSpelling, m as ProfileWeights, n as ResolvedKey, r as SpelledKeyLike, s as SpelledKeyScale } from '../coerce-DP0vYu-x.js';
-export { B as BorrowedSource, e as ChordTimeline, H as HarmonicFunction } from '../index-CJBBiAmU.js';
-import { f as StringedProfile, P as PercussionProfile, c as Limb } from '../positional-DJgs6ltD.js';
-export { I as InstrumentProfile, a as InstrumentProfileCommon, d as PositionalRng, S as SeedPath } from '../positional-DJgs6ltD.js';
-import { b as MeterLike } from '../index-CL4b4gUQ.js';
-export { M as MeterChange, c as MeterMap, T as TimeSignature } from '../index-CL4b4gUQ.js';
-export { H as HarmonyRole } from '../index-Dw2DP7vm.js';
-import { r as Genre, q as GenerationContextInput, a4 as Vocabulary, s as GridEvent, m as DrumStyle, $ as Section, n as DrumVoice, t as GrooveFeel, k as DrumHit, H as HarmonizeOptions, y as HarmonizeResult } from '../index-BJgP97N1.js';
-export { B as BAR_STEPS, a as BASS_STYLES, b as BEAT_STEPS, c as BORROWED_DEGREES, d as BassLineOptions, e as BassSegment, f as BassStyle, g as BorrowedChord, C as Complexity, h as CounterMelodyOptions, D as DRUM_NOTES, i as DeformOptions, j as Draw, l as DrumRole, o as DrumsOptions, E as EuclideanKick, G as GENRES, p as GenerationContext, u as GrooveSlot, v as GrooveStyle, w as GrooveTemplate, x as HarmonizePlacement, z as HumanizeOptions, M as MelodyNote, A as MotifCell, F as MotifContour, I as MotifNote, J as MotifOptions, K as MotifTransform, O as ORNAMENT_STYLES, L as OrnamentOptions, N as OrnamentStyle, P as PROVENANCE_BASES, Q as ProgFunction, R as ProgStyle, S as ProgressionDegree, T as ProgressionOptions, U as ProgressionPreset, V as Provenance, W as ProvenanceBasis, X as ResolvedContext, Y as RhythmEvent, Z as RhythmOptions, _ as STEP_BEATS, a0 as SubstituteOptions, a1 as Substitution, a2 as SubstitutionType, a3 as SyncopateOptions, a5 as VocabularyQuery, a6 as applyGrooveTemplate, a7 as assertVocabulary, a8 as deform, a9 as developMotif, aa as double, ab as doubleTime, ac as drumVoiceOf, ad as extractGrooveTemplate, ae as fitsQuery, af as generateBassLine, ag as generateCounterMelody, ah as generateDrums, ai as generateMotif, aj as generateProgression, ak as generateRhythm, al as gridMetricWeight, am as halfTime, an as humanize, ao as mergeVocabulary, ap as modalInterchangePalette, aq as motifToNoteEvents, ar as negativeHarmonyMirror, as as onsetWeightCurve, at as ornament, au as ornamentBy, av as pickProgressionPreset, aw as pickVocabulary, ax as progressions, ay as progressionsByStyle, az as resolveContext, aA as rhythmDensity, aB as rhythmToNoteEvents, aC as selectVocabulary, aD as substituteChord, aE as syncopate, aF as thin, aG as transformMotif, aH as vocabularyOfKind, aI as withinCeiling } from '../index-BJgP97N1.js';
+import { b as MeterLike } from '../index-Bf0Sv8a9.js';
+export { M as MeterChange, c as MeterMap, T as TimeSignature } from '../index-Bf0Sv8a9.js';
+import { h as NoteEvent, a as Articulation, b as IntervalLike } from '../index-C9MYbuKS.js';
+export { I as IntervalData, c as IntervalQualityLabel, e as KeyScale, g as NoteData, S as SpelledInterval } from '../index-C9MYbuKS.js';
+import { e as ChordSegment, c as ChordLike, K as KeyLike } from '../coerce-CUhHc3Tu.js';
+export { b as ChordData, d as ChordQuality, g as ChordSpan, i as ChordToneRole, k as KeyVariant, l as PitchSpelling, m as ProfileWeights, n as ResolvedKey, r as SpelledKeyLike, s as SpelledKeyScale } from '../coerce-CUhHc3Tu.js';
+import { h as ChordTimeline } from '../types-7mGFwvMm.js';
+export { B as BarPositionProfile, b as BorrowedSource, e as CadenceType, F as FormSection, o as HarmonicFunction, v as MelodicContourShape, y as MotifGraph, z as MotifGraphEdge, G as MotifGraphNode, P as MotifRelationSummary, X as ReductionLevel, Y as ReferenceCadence, Z as ReferenceChord, _ as ReferenceForm, $ as ReferenceHarmony, a0 as ReferenceKeyRegion, a1 as ReferenceMelody, a2 as ReferenceMotif, a3 as ReferencePhrase, a4 as ReferencePhraseMelody, a5 as ReferenceProfile, a7 as RhythmAnalysis } from '../types-7mGFwvMm.js';
+import { f as StringedProfile, P as PercussionProfile, c as Limb } from '../positional-DLnfUgqG.js';
+export { I as InstrumentProfile, a as InstrumentProfileCommon, d as PositionalRng, S as SeedPath } from '../positional-DLnfUgqG.js';
+export { H as HarmonyRole } from '../index-C7KCaTRz.js';
+import { x as Genre, w as GenerationContextInput, ah as Vocabulary, y as GridEvent, r as DrumStyle, ac as Section, s as DrumVoice, z as GrooveFeel, p as DrumHit, I as HarmonizeOptions, K as HarmonizeResult, j as CompositionPlan } from '../index-jgeug9EA.js';
+export { B as BAR_STEPS, a as BASS_STYLES, b as BEAT_STEPS, c as BORROWED_DEGREES, d as BassLineOptions, e as BassSegment, f as BassStyle, g as BorrowedChord, C as COMPOSITION_PLAN_VERSION, h as Complexity, i as CompositionEvaluation, k as CompositionPlanOptions, l as CompositionViolation, m as CounterMelodyOptions, D as DRUM_NOTES, n as DeformOptions, o as Draw, q as DrumRole, t as DrumsOptions, E as EuclideanKick, u as EvaluateCompositionOptions, G as GENRES, v as GenerationContext, A as GrooveSlot, F as GrooveStyle, H as GrooveTemplate, J as HarmonizePlacement, L as HumanizeOptions, M as MelodyNote, N as MelodyOptions, O as MotifCell, P as MotifContour, Q as MotifNote, R as MotifOptions, S as MotifTransform, T as ORNAMENT_STYLES, U as OrnamentOptions, V as OrnamentStyle, W as PROVENANCE_BASES, X as PlannedChord, Y as PlannedMotif, Z as PlannedPhrase, _ as PlannedRhythm, $ as PlannedSection, a0 as PreserveWeights, a1 as ProgFunction, a2 as ProgStyle, a3 as ProgressionDegree, a4 as ProgressionOptions, a5 as ProgressionPreset, a6 as Provenance, a7 as ProvenanceBasis, a8 as ResolvedContext, a9 as RhythmEvent, aa as RhythmOptions, ab as STEP_BEATS, ad as SubstituteOptions, ae as Substitution, af as SubstitutionType, ag as SyncopateOptions, ai as VocabularyQuery, aj as applyGrooveTemplate, ak as assertVocabulary, al as deform, am as deriveCompositionPlan, an as developMotif, ao as double, ap as doubleTime, aq as drumVoiceOf, ar as evaluateComposition, as as extractGrooveTemplate, at as fitsQuery, au as generateBassLine, av as generateCounterMelody, aw as generateDrums, ax as generateMelody, ay as generateMotif, az as generateProgression, aA as generateRhythm, aB as gridMetricWeight, aC as halfTime, aD as humanize, aE as mergeVocabulary, aF as modalInterchangePalette, aG as motifToNoteEvents, aH as negativeHarmonyMirror, aI as onsetWeightCurve, aJ as ornament, aK as ornamentBy, aL as pickProgressionPreset, aM as pickVocabulary, aN as progressions, aO as progressionsByStyle, aP as resolveContext, aQ as rhythmDensity, aR as rhythmToNoteEvents, aS as selectVocabulary, aT as substituteChord, aU as syncopate, aV as thin, aW as transformMotif, aX as vocabularyOfKind, aY as withinCeiling } from '../index-jgeug9EA.js';
 
 /**
  * The playing-difficulty ceiling, as the generators apply it.
@@ -293,7 +294,8 @@ type ImitationOptions = {
  * `interval`: literally for a real answer, by scale degree for a tonal one, and
  * upside down first when `invert` is set. Inversion mirrors about the first note
  * of the copied span, so the answer starts where the transposition puts that
- * note either way. In a tonal answer a pitch outside the key keeps its distance
+ * note either way, whether or not it is in the key. In a tonal answer a pitch
+ * outside the key keeps its distance
  * from the scale tone below it, and inversion mirrors that distance too — a
  * chromatic passing note stays a chromatic passing note, on the other side.
  * Where a mirrored chromatic note falls into a diatonic semitone the key leaves
@@ -332,6 +334,8 @@ declare function imitate(lead: readonly NoteEvent[], opts: ImitationOptions): No
 declare const FILL_TYPES: readonly ["snareRoll", "tomDescend", "tomAscend", "snareTomCombo", "simpleCrash", "linearFill", "ghostToAccent", "bdSnareAlternate", "hiHatChoke", "tomShuffle", "breakdownFill", "flamsAndDrags", "halfTimeFill"];
 /** The thirteen fill archetypes for section transitions. */
 type FillType = (typeof FILL_TYPES)[number];
+/** The bases a fill stroke's velocity is read against, in declaration order. */
+declare const FILL_VELOCITY_BASES: readonly ["fill", "accent"];
 /**
  * How loud one stroke of a fill is.
  *
@@ -342,7 +346,7 @@ type FillType = (typeof FILL_TYPES)[number];
  * arithmetic at every beat line falls back in the middle of itself.
  */
 type FillVelocity = {
-    base: 'fill' | 'accent';
+    base: (typeof FILL_VELOCITY_BASES)[number];
     /** Factor on the base, for a crescendo or a ghosted stroke. */
     scale?: number;
     /** Fixed offset in MIDI velocity, for a stroke a little above or below. */
@@ -651,7 +655,11 @@ type ClassifiedMelodyTone = {
  * predecessor and successor has no figure to belong to and stays structural, so
  * the first and last notes of a phrase are always structural.
  *
- * @param melody The melody, in ascending onset order.
+ * The notes are read in onset order, ties by pitch, whatever order they are
+ * listed in. A note of zero length sounds nothing: it is structural and is no
+ * other note's neighbour.
+ *
+ * @param melody The melody, in any order.
  * @param ts Time signature used to weight metric accents.
  * @returns One classification per input note, in input order.
  * @example
@@ -687,7 +695,9 @@ declare function classifyMelodyTones(melody: readonly NoteEvent[], ts: MeterLike
  * the grid.
  *
  * With `placement.transposeSearch` the melody is moved into the key it is
- * harmonized in, and `transposeSemitones` reports how far; with
+ * harmonized in, and `transposeSemitones` reports how far: the shifts that
+ * leave the fewest beats of the melody outside the key are kept, and the
+ * harmonization cost and the register choose among them; with
  * `placement.octaveSearch` it is moved by octaves into a comfortable register,
  * which leaves the key and the chords untouched. Both may be set, and the
  * reported shift is their sum.
@@ -717,4 +727,82 @@ declare function classifyMelodyTones(melody: readonly NoteEvent[], ts: MeterLike
  */
 declare function harmonizeMelody(opts: HarmonizeOptions): HarmonizeResult;
 
-export { Articulation, BASS_LICKS, type BassLick, ChordLike, ChordSegment, type ClassifiedMelodyTone, DRUM_KIT, DRUM_PATTERNS, DrumHit, type DrumPattern, type DrumPatternOptions, type DrumStroke, DrumStyle, type DrumVocabulary, DrumVoice, FILL_ARCHETYPES, FILL_TYPES, type FillArchetype, type FillStroke, type FillType, type FillVelocity, GenerationContextInput, Genre, GridEvent, GrooveFeel, HarmonizeOptions, HarmonizeResult, type ImitationAnswer, type ImitationOptions, IntervalLike, KICK_FIGURES, KICK_STEPS, KeyLike, type KickFigure, type KickPattern, type KickSlot, type LickMaterial, type LickNote, Limb, MAX_DIFFICULTY, MIN_DIFFICULTY, type MelodyToneRole, MeterLike, NoteEvent, PercussionProfile, type PlaceLicksOptions, Section, StringedProfile, Vocabulary, classifyMelodyTones, harmonizeMelody, imitate, isDrumPattern, isFillArchetype, isLickMaterial, placeDrumPattern, placeLicks, sustainsShift, sustainsStrokes };
+/**
+ * Reading a {@link CompositionPlan}'s harmony as a chord timeline.
+ *
+ * Kept apart from the plan types so the public reader can validate its plan
+ * without the types module importing the validator that imports it.
+ */
+
+/**
+ * Read a plan's harmony as a chord timeline.
+ *
+ * The one way a generator or an evaluator reads chords out of a plan: each
+ * entry in `plan.harmony` is resolved against its key and placed at its own
+ * beat, so the timeline this returns always agrees with the plan it was built
+ * from.
+ *
+ * @param plan The plan to read harmony from.
+ * @returns A chord timeline spanning `plan.span`.
+ * @throws {InvalidInputError} If the plan is not a valid composition plan.
+ * @example
+ * ```ts
+ * import { planTimeline, resolveKey } from '@libraz/libcantus';
+ * const plan = {
+ *   planVersion: 1, seed: 0, algorithmVersion: 1,
+ *   keys: [resolveKey('C major')], meters: [{ startBeat: 0, ts: { numerator: 4, denominator: 4 } }],
+ *   span: { startBeat: 0, endBeat: 4, bars: 1 }, sections: [], phrases: [],
+ *   harmony: [{ startBeat: 0, endBeat: 4, key: 0, roman: 'I' }], motifs: [],
+ *   rhythm: { onsetLevels: [1, 0, 0, 0, 0, 0], interOnsetShares: new Array(17).fill(0).fill(1, 8, 9), syncopation: 0 },
+ * };
+ * planTimeline(plan).at(0); // the I chord in C major
+ * ```
+ * @category Composition
+ */
+declare function planTimeline(plan: CompositionPlan): ChordTimeline;
+
+/**
+ * Boundary validation for {@link CompositionPlan}: a caller can hand this a
+ * value restored from JSON, a config file, or a plugin host, and every field
+ * is checked before a generator or evaluator reads it. A violation names the
+ * path to the offending field, so a malformed document is diagnosed at the
+ * field that is wrong rather than wherever the first bad read happens to land.
+ */
+
+/**
+ * Reject a value that is not a {@link CompositionPlan}.
+ *
+ * A plan is the shape a caller's stored JSON, a config file, or a plugin host
+ * most plausibly hands back malformed: a missing field, a distribution that no
+ * longer sums to 1, an index a later edit left dangling, a numeral no reader
+ * can parse, a derivation that points at itself or at a later motif. Every
+ * field is checked before a generator or evaluator reads it, and a violation
+ * names the path to the field that is wrong.
+ *
+ * @param value The value to check.
+ * @param name What the value is, for the error message.
+ * @returns The same plan.
+ * @throws {InvalidInputError} If the value is not a valid composition plan.
+ * @example
+ * ```ts
+ * import { assertCompositionPlan } from '@libraz/libcantus';
+ * import { resolveKey } from '@libraz/libcantus';
+ * const plan = {
+ *   planVersion: 1, seed: 0, algorithmVersion: 1,
+ *   keys: [resolveKey('C major')],
+ *   meters: [{ startBeat: 0, ts: { numerator: 4, denominator: 4 } }],
+ *   span: { startBeat: 0, endBeat: 4, bars: 1 },
+ *   sections: [{ label: 'A', startBeat: 0, endBeat: 4 }],
+ *   phrases: [],
+ *   harmony: [{ startBeat: 0, endBeat: 4, key: 0, roman: 'I' }],
+ *   motifs: [],
+ *   rhythm: { onsetLevels: [1, 0, 0, 0, 0, 0], interOnsetShares: new Array(17).fill(0).fill(1, 8, 9), syncopation: 0 },
+ * };
+ * assertCompositionPlan(plan); // the plan, unchanged
+ * ```
+ * @category Composition
+ */
+declare function assertCompositionPlan(value: unknown, name?: string): CompositionPlan;
+
+export { Articulation, BASS_LICKS, ChordLike, ChordSegment, ChordTimeline, CompositionPlan, DRUM_KIT, DRUM_PATTERNS, DrumHit, DrumStyle, DrumVoice, FILL_ARCHETYPES, FILL_TYPES, GenerationContextInput, Genre, GridEvent, GrooveFeel, HarmonizeOptions, HarmonizeResult, IntervalLike, KICK_FIGURES, KICK_STEPS, KeyLike, Limb, MAX_DIFFICULTY, MIN_DIFFICULTY, MeterLike, NoteEvent, PercussionProfile, Section, StringedProfile, Vocabulary, assertCompositionPlan, classifyMelodyTones, harmonizeMelody, imitate, isDrumPattern, isFillArchetype, isLickMaterial, placeDrumPattern, placeLicks, planTimeline, sustainsShift, sustainsStrokes };
+export type { BassLick, ClassifiedMelodyTone, DrumPattern, DrumPatternOptions, DrumStroke, DrumVocabulary, FillArchetype, FillStroke, FillType, FillVelocity, ImitationAnswer, ImitationOptions, KickFigure, KickPattern, KickSlot, LickMaterial, LickNote, MelodyToneRole, PlaceLicksOptions };

package/dist/generate/index.js

@@ -4,6 +4,7 @@ import {
   BASS_STYLES,
   BEAT_STEPS,
   BORROWED_DEGREES,
+  COMPOSITION_PLAN_VERSION,
   DRUM_KIT,
   DRUM_NOTES,
   DRUM_PATTERNS,
@@ -18,18 +19,22 @@ import {
   PROVENANCE_BASES,
   STEP_BEATS,
   applyGrooveTemplate,
+  assertCompositionPlan,
   assertVocabulary,
   classifyMelodyTones,
   deform,
+  deriveCompositionPlan,
   developMotif,
   double,
   doubleTime,
   drumVoiceOf,
+  evaluateComposition,
   extractGrooveTemplate,
   fitsQuery,
   generateBassLine,
   generateCounterMelody,
   generateDrums,
+  generateMelody,
   generateMotif,
   generateProgression,
   generateRhythm,
@@ -52,6 +57,7 @@ import {
   pickVocabulary,
   placeDrumPattern,
   placeLicks,
+  planTimeline,
   progressions,
   progressionsByStyle,
   resolveContext,
@@ -66,19 +72,20 @@ import {
   transformMotif,
   vocabularyOfKind,
   withinCeiling
-} from "../chunk-Q6LFSAKV.js";
-import "../chunk-H2KJHBW4.js";
-import "../chunk-7KG3RTYS.js";
-import "../chunk-PUKJP2Z5.js";
-import "../chunk-NB25P3EH.js";
-import "../chunk-RFIBF2RR.js";
-import "../chunk-AGOVW7U6.js";
+} from "../chunk-FK3DGAIZ.js";
+import "../chunk-FJFULJZE.js";
+import "../chunk-VL5NXVCN.js";
+import "../chunk-TXFWSU5D.js";
+import "../chunk-2G5MCGYU.js";
+import "../chunk-H7FVMBUC.js";
+import "../chunk-YYVXRV3V.js";
 export {
   BAR_STEPS,
   BASS_LICKS,
   BASS_STYLES,
   BEAT_STEPS,
   BORROWED_DEGREES,
+  COMPOSITION_PLAN_VERSION,
   DRUM_KIT,
   DRUM_NOTES,
   DRUM_PATTERNS,
@@ -93,18 +100,22 @@ export {
   PROVENANCE_BASES,
   STEP_BEATS,
   applyGrooveTemplate,
+  assertCompositionPlan,
   assertVocabulary,
   classifyMelodyTones,
   deform,
+  deriveCompositionPlan,
   developMotif,
   double,
   doubleTime,
   drumVoiceOf,
+  evaluateComposition,
   extractGrooveTemplate,
   fitsQuery,
   generateBassLine,
   generateCounterMelody,
   generateDrums,
+  generateMelody,
   generateMotif,
   generateProgression,
   generateRhythm,
@@ -127,6 +138,7 @@ export {
   pickVocabulary,
   placeDrumPattern,
   placeLicks,
+  planTimeline,
   progressions,
   progressionsByStyle,
   resolveContext,

package/dist/{index-CL4b4gUQ.d.ts → index-5VJgKz_Q.d.cts}

@@ -1,4 +1,4 @@
-import { P as ParseResult } from './index-Cy15oTvh.js';
+import { P as ParseResult } from './index-C9MYbuKS.cjs';
 
 /**
  * Meter arithmetic shared by the meter module and the validation guards.
@@ -87,6 +87,9 @@ type MeterChange = {
  * lays its bar lines from beat 0 whatever beat the first entry is written at, so
  * a map opening at the pickup it covers numbers its bars exactly as the bare
  * signature does. Every later entry starts a bar at the beat it takes effect.
+ * Bars are numbered so that the bar containing beat 0 is bar 0, so a pickup
+ * written as an entry of its own before a change at beat 0 is bar -1 all the
+ * same.
  *
  * Pass the whole piece with its map rather than one call per meter span: a
  * split call cannot see a voice move or a key region that crosses the change.
@@ -507,4 +510,5 @@ declare function isStrongBeat(beatInQuarters: number, meter: MeterLike): boolean
  */
 declare function tuplet(totalBeats: number, count: number): number[];
 
-export { type BarPosition as B, type MeterChange as M, type TimeSignature as T, type MeterData as a, type MeterLike as b, type MeterMap as c, barIndexAt as d, barPositionToBeat as e, barPositionToPulse as f, barStartBeat as g, beatToBarPosition as h, beatsPerBar as i, beatsPerBarAt as j, formatBarPosition as k, formatTimeSignature as l, isCompound as m, isStrongBeat as n, meterAt as o, metricWeight as p, parseTimeSignature as q, pulseBeats as r, pulsesPerBar as s, resolveMeters as t, toMeterData as u, tryParseTimeSignature as v, tuplet as w };
+export { barIndexAt as d, barPositionToBeat as e, barPositionToPulse as f, barStartBeat as g, beatToBarPosition as h, beatsPerBar as i, beatsPerBarAt as j, formatBarPosition as k, formatTimeSignature as l, isCompound as m, isStrongBeat as n, meterAt as o, metricWeight as p, parseTimeSignature as q, pulseBeats as r, pulsesPerBar as s, resolveMeters as t, toMeterData as u, tryParseTimeSignature as v, tuplet as w };
+export type { BarPosition as B, MeterChange as M, TimeSignature as T, MeterData as a, MeterLike as b, MeterMap as c };

package/dist/{index-B9QLziDe.d.cts → index-BLuDesVG.d.ts}

@@ -1,6 +1,6 @@
-import { e as KeyScale, i as NoteLike, j as NoteNameOptions, P as ParseResult, g as Note, b as IntervalLike, S as SpelledInterval } from './index-Cy15oTvh.cjs';
-import { n as ResolvedKey, K as KeyLike, c as ChordLike, b as Chord, r as SpelledKeyLike } from './coerce-DRERzdve.cjs';
-import { r as ScaleName, u as WorldScaleName, s as ScaleNameInput } from './masks-pADfTOiD.cjs';
+import { e as KeyScale, i as NoteLike, j as NoteNameOptions, P as ParseResult, g as Note, b as IntervalLike, S as SpelledInterval } from './index-C9MYbuKS.js';
+import { n as ResolvedKey, K as KeyLike, c as ChordLike, b as Chord, r as SpelledKeyLike } from './coerce-CUhHc3Tu.js';
+import { r as ScaleName, u as WorldScaleName, s as ScaleNameInput } from './masks-tycmkrgs.js';
 
 /**
  * Which of the two modes a key signature is read in.
@@ -416,10 +416,12 @@ declare function chordScales(chord: ChordLike): ChordScaleMatch[];
 /**
  * Which use an avoid note is judged for: sounding it, or passing through it.
  *
- * `'harmonic'` is the Berklee-style rule in full — a tone that must not be
+ * `'harmonic'` is the Berklee-style rule — a tone that must not be
  * sounded against the chord. `'melodic'` keeps only what a line cannot pass
  * through either, which is the semitone above the root; every other clash
- * resolves as the line moves on.
+ * resolves as the line moves on. Over a chord that sounds a dominant seventh
+ * the semitone above the root is the flat ninth, a tension under either use
+ * whichever scale supplies it; the flat thirteenth stays a harmonic avoid note.
  *
  * @category Scales
  */
@@ -488,8 +490,8 @@ type AvailableTensionsOptions = {
  *
  * A tension's availability also depends on what the chord is doing. Pass
  * `resolvesTo` to say which chord this one resolves to: a dominant seventh
- * resolving down a fifth to a minor tonic takes its flat ninth, sharp ninth and
- * flat thirteenth, which read on their own would each be an avoid note. Only
+ * resolving down a fifth to a minor tonic takes its sharp ninth and flat
+ * thirteenth as well as the flat ninth every dominant takes. Only
  * scale tones are ever added, so the result stays within the scale.
  *
  * @param chord The chord providing the chord tones, as a chord symbol, chord
@@ -505,7 +507,7 @@ type AvailableTensionsOptions = {
  * import { makeChord, availableTensions } from '@libraz/libcantus';
  * availableTensions(makeChord(0, 'maj7'), 'ionian'); // [2, 9] — color tones over Cmaj7
  * availableTensions(makeChord(7, 'dom7'), 'phrygianDominant', { resolvesTo: makeChord(0, 'min') });
- * // [3, 8] — the b13 and b9 the resolution to C minor makes available
+ * // [3, 8] — the b9, and the b13 the resolution to C minor makes available
  * ```
  *
  * @category Scales
@@ -865,8 +867,10 @@ type StyledVoicingOptions = {
  * {@link VoicingStyle} then transforms the stack, and the result is returned as
  * ascending MIDI pitches (index 0 = lowest).
  *
- * A drop voicing lowers one voice below the rest, so that voice is its bass —
- * which is what tells the drop-2 voicings of one chord apart. When the chord
+ * A drop voicing lowers one voice by an octave. On a stack spanning no more than
+ * an octave above that voice it becomes the bass — which is what tells the
+ * drop-2 voicings of one chord apart; on a wider stack (an eleventh or
+ * thirteenth chord) it can land inside the stack. When the chord
  * names a bass tone of its own, the close stack is therefore rotated so the
  * style drops that tone, and the result is the drop voicing whose bass is the
  * tone asked for; the named bass is not lowered under an already dropped voice
@@ -882,7 +886,8 @@ type StyledVoicingOptions = {
  *   plain chord data, or a `Chord`.
  * @param opts Styled voicing options; defaults to a close voicing at octave 4.
  * @returns MIDI pitches, ascending, one per retained voice.
- * @throws If the voicing would not fit inside MIDI 0..127 at the given octave.
+ * @throws If the voicing would not fit inside MIDI 0..127 at the given octave,
+ *   or `style` is not a {@link VoicingStyle}.
  * @example
  * ```ts
  * import { voiceChordStyled } from '@libraz/libcantus';
@@ -967,7 +972,8 @@ type SpeciesOptions = {
  * @returns Every violation found, in the order the exercise commits them; an
  *   empty array for a clean exercise.
  * @throws If the species is not one of the five, either voice is empty, a note
- *   carries no octave, or the fifth species is given without durations.
+ *   carries no octave, the durations are not an array of finite numbers, or the
+ *   fifth species is given without durations.
  * @example
  * ```ts
  * import { checkSpecies, majorKey, parseNote } from '@libraz/libcantus';
@@ -1329,4 +1335,5 @@ declare function toSoundingPitch(note: NoteLike, instrument: TransposingInstrume
  */
 declare function toWrittenPitch(note: NoteLike, instrument: TransposingInstrument): Note;
 
-export { type AvailableTensionsOptions as A, instrumentTransposition as B, type ChordScaleMatch as C, isSignatureKey as D, keyFromFifths as E, keySignatureFifths as F, parseChordSymbol as G, scaleMatchesChord as H, scaleSystemOf as I, scalesForChanges as J, type KeyMode as K, spellVoicing as L, supportsFunctionalHarmony as M, toSoundingPitch as N, toWrittenPitch as O, type PartWritingOptions as P, transposeChordSymbol as Q, tryParseChordSymbol as R, SATB_RANGES as S, TRANSPOSING_INSTRUMENTS as T, voiceChord as U, type VoiceIndependenceOptions as V, voiceChordStyled as W, voiceIndependence as X, voiceProgression as Y, type AvoidNoteUse as a, type AvoidNotesOptions as b, type ChordScaleReportEntry as c, type ChordSymbolOptions as d, type PartWritingViolation as e, type PartWritingViolationKind as f, SCALE_SYSTEMS as g, type ScaleChoice as h, type ScaleSystem as i, type Species as j, type SpeciesOptions as k, type SpelledVoicing as l, type StyledVoicingOptions as m, type TransposingInstrument as n, type TransposingInstrumentName as o, type VoiceIndependenceReport as p, type VoiceRange as q, type VoicingOptions as r, type VoicingStyle as s, availableTensions as t, avoidNotes as u, checkPartWriting as v, checkSpecies as w, chordScaleReport as x, chordScales as y, formatChordSymbol as z };
+export { instrumentTransposition as B, isSignatureKey as D, keyFromFifths as E, keySignatureFifths as F, parseChordSymbol as G, scaleMatchesChord as H, scaleSystemOf as I, scalesForChanges as J, spellVoicing as L, supportsFunctionalHarmony as M, toSoundingPitch as N, toWrittenPitch as O, transposeChordSymbol as Q, tryParseChordSymbol as R, SATB_RANGES as S, TRANSPOSING_INSTRUMENTS as T, voiceChord as U, voiceChordStyled as W, voiceIndependence as X, voiceProgression as Y, SCALE_SYSTEMS as g, availableTensions as t, avoidNotes as u, checkPartWriting as v, checkSpecies as w, chordScaleReport as x, chordScales as y, formatChordSymbol as z };
+export type { AvailableTensionsOptions as A, ChordScaleMatch as C, KeyMode as K, PartWritingOptions as P, VoiceIndependenceOptions as V, AvoidNoteUse as a, AvoidNotesOptions as b, ChordScaleReportEntry as c, ChordSymbolOptions as d, PartWritingViolation as e, PartWritingViolationKind as f, ScaleChoice as h, ScaleSystem as i, Species as j, SpeciesOptions as k, SpelledVoicing as l, StyledVoicingOptions as m, TransposingInstrument as n, TransposingInstrumentName as o, VoiceIndependenceReport as p, VoiceRange as q, VoicingOptions as r, VoicingStyle as s };

package/dist/{index-BHIUyjhZ.d.ts → index-BV6APVa6.d.cts}

@@ -1,6 +1,6 @@
-import { e as KeyScale, i as NoteLike, j as NoteNameOptions, P as ParseResult, g as Note, b as IntervalLike, S as SpelledInterval } from './index-Cy15oTvh.js';
-import { n as ResolvedKey, K as KeyLike, c as ChordLike, b as Chord, r as SpelledKeyLike } from './coerce-DP0vYu-x.js';
-import { r as ScaleName, u as WorldScaleName, s as ScaleNameInput } from './masks-Cc7-MzzY.js';
+import { e as KeyScale, i as NoteLike, j as NoteNameOptions, P as ParseResult, g as Note, b as IntervalLike, S as SpelledInterval } from './index-C9MYbuKS.cjs';
+import { n as ResolvedKey, K as KeyLike, c as ChordLike, b as Chord, r as SpelledKeyLike } from './coerce-Ytt2Eiq9.cjs';
+import { r as ScaleName, u as WorldScaleName, s as ScaleNameInput } from './masks-BnzXnBj0.cjs';
 
 /**
  * Which of the two modes a key signature is read in.
@@ -416,10 +416,12 @@ declare function chordScales(chord: ChordLike): ChordScaleMatch[];
 /**
  * Which use an avoid note is judged for: sounding it, or passing through it.
  *
- * `'harmonic'` is the Berklee-style rule in full — a tone that must not be
+ * `'harmonic'` is the Berklee-style rule — a tone that must not be
  * sounded against the chord. `'melodic'` keeps only what a line cannot pass
  * through either, which is the semitone above the root; every other clash
- * resolves as the line moves on.
+ * resolves as the line moves on. Over a chord that sounds a dominant seventh
+ * the semitone above the root is the flat ninth, a tension under either use
+ * whichever scale supplies it; the flat thirteenth stays a harmonic avoid note.
  *
  * @category Scales
  */
@@ -488,8 +490,8 @@ type AvailableTensionsOptions = {
  *
  * A tension's availability also depends on what the chord is doing. Pass
  * `resolvesTo` to say which chord this one resolves to: a dominant seventh
- * resolving down a fifth to a minor tonic takes its flat ninth, sharp ninth and
- * flat thirteenth, which read on their own would each be an avoid note. Only
+ * resolving down a fifth to a minor tonic takes its sharp ninth and flat
+ * thirteenth as well as the flat ninth every dominant takes. Only
  * scale tones are ever added, so the result stays within the scale.
  *
  * @param chord The chord providing the chord tones, as a chord symbol, chord
@@ -505,7 +507,7 @@ type AvailableTensionsOptions = {
  * import { makeChord, availableTensions } from '@libraz/libcantus';
  * availableTensions(makeChord(0, 'maj7'), 'ionian'); // [2, 9] — color tones over Cmaj7
  * availableTensions(makeChord(7, 'dom7'), 'phrygianDominant', { resolvesTo: makeChord(0, 'min') });
- * // [3, 8] — the b13 and b9 the resolution to C minor makes available
+ * // [3, 8] — the b9, and the b13 the resolution to C minor makes available
  * ```
  *
  * @category Scales
@@ -865,8 +867,10 @@ type StyledVoicingOptions = {
  * {@link VoicingStyle} then transforms the stack, and the result is returned as
  * ascending MIDI pitches (index 0 = lowest).
  *
- * A drop voicing lowers one voice below the rest, so that voice is its bass —
- * which is what tells the drop-2 voicings of one chord apart. When the chord
+ * A drop voicing lowers one voice by an octave. On a stack spanning no more than
+ * an octave above that voice it becomes the bass — which is what tells the
+ * drop-2 voicings of one chord apart; on a wider stack (an eleventh or
+ * thirteenth chord) it can land inside the stack. When the chord
  * names a bass tone of its own, the close stack is therefore rotated so the
  * style drops that tone, and the result is the drop voicing whose bass is the
  * tone asked for; the named bass is not lowered under an already dropped voice
@@ -882,7 +886,8 @@ type StyledVoicingOptions = {
  *   plain chord data, or a `Chord`.
  * @param opts Styled voicing options; defaults to a close voicing at octave 4.
  * @returns MIDI pitches, ascending, one per retained voice.
- * @throws If the voicing would not fit inside MIDI 0..127 at the given octave.
+ * @throws If the voicing would not fit inside MIDI 0..127 at the given octave,
+ *   or `style` is not a {@link VoicingStyle}.
  * @example
  * ```ts
  * import { voiceChordStyled } from '@libraz/libcantus';
@@ -967,7 +972,8 @@ type SpeciesOptions = {
  * @returns Every violation found, in the order the exercise commits them; an
  *   empty array for a clean exercise.
  * @throws If the species is not one of the five, either voice is empty, a note
- *   carries no octave, or the fifth species is given without durations.
+ *   carries no octave, the durations are not an array of finite numbers, or the
+ *   fifth species is given without durations.
  * @example
  * ```ts
  * import { checkSpecies, majorKey, parseNote } from '@libraz/libcantus';
@@ -1329,4 +1335,5 @@ declare function toSoundingPitch(note: NoteLike, instrument: TransposingInstrume
  */
 declare function toWrittenPitch(note: NoteLike, instrument: TransposingInstrument): Note;
 
-export { type AvailableTensionsOptions as A, instrumentTransposition as B, type ChordScaleMatch as C, isSignatureKey as D, keyFromFifths as E, keySignatureFifths as F, parseChordSymbol as G, scaleMatchesChord as H, scaleSystemOf as I, scalesForChanges as J, type KeyMode as K, spellVoicing as L, supportsFunctionalHarmony as M, toSoundingPitch as N, toWrittenPitch as O, type PartWritingOptions as P, transposeChordSymbol as Q, tryParseChordSymbol as R, SATB_RANGES as S, TRANSPOSING_INSTRUMENTS as T, voiceChord as U, type VoiceIndependenceOptions as V, voiceChordStyled as W, voiceIndependence as X, voiceProgression as Y, type AvoidNoteUse as a, type AvoidNotesOptions as b, type ChordScaleReportEntry as c, type ChordSymbolOptions as d, type PartWritingViolation as e, type PartWritingViolationKind as f, SCALE_SYSTEMS as g, type ScaleChoice as h, type ScaleSystem as i, type Species as j, type SpeciesOptions as k, type SpelledVoicing as l, type StyledVoicingOptions as m, type TransposingInstrument as n, type TransposingInstrumentName as o, type VoiceIndependenceReport as p, type VoiceRange as q, type VoicingOptions as r, type VoicingStyle as s, availableTensions as t, avoidNotes as u, checkPartWriting as v, checkSpecies as w, chordScaleReport as x, chordScales as y, formatChordSymbol as z };
+export { instrumentTransposition as B, isSignatureKey as D, keyFromFifths as E, keySignatureFifths as F, parseChordSymbol as G, scaleMatchesChord as H, scaleSystemOf as I, scalesForChanges as J, spellVoicing as L, supportsFunctionalHarmony as M, toSoundingPitch as N, toWrittenPitch as O, transposeChordSymbol as Q, tryParseChordSymbol as R, SATB_RANGES as S, TRANSPOSING_INSTRUMENTS as T, voiceChord as U, voiceChordStyled as W, voiceIndependence as X, voiceProgression as Y, SCALE_SYSTEMS as g, availableTensions as t, avoidNotes as u, checkPartWriting as v, checkSpecies as w, chordScaleReport as x, chordScales as y, formatChordSymbol as z };
+export type { AvailableTensionsOptions as A, ChordScaleMatch as C, KeyMode as K, PartWritingOptions as P, VoiceIndependenceOptions as V, AvoidNoteUse as a, AvoidNotesOptions as b, ChordScaleReportEntry as c, ChordSymbolOptions as d, PartWritingViolation as e, PartWritingViolationKind as f, ScaleChoice as h, ScaleSystem as i, Species as j, SpeciesOptions as k, SpelledVoicing as l, StyledVoicingOptions as m, TransposingInstrument as n, TransposingInstrumentName as o, VoiceIndependenceReport as p, VoiceRange as q, VoicingOptions as r, VoicingStyle as s };

package/dist/{index-BMweUlm5.d.cts → index-Bf0Sv8a9.d.ts}

@@ -1,4 +1,4 @@
-import { P as ParseResult } from './index-Cy15oTvh.cjs';
+import { P as ParseResult } from './index-C9MYbuKS.js';
 
 /**
  * Meter arithmetic shared by the meter module and the validation guards.
@@ -87,6 +87,9 @@ type MeterChange = {
  * lays its bar lines from beat 0 whatever beat the first entry is written at, so
  * a map opening at the pickup it covers numbers its bars exactly as the bare
  * signature does. Every later entry starts a bar at the beat it takes effect.
+ * Bars are numbered so that the bar containing beat 0 is bar 0, so a pickup
+ * written as an entry of its own before a change at beat 0 is bar -1 all the
+ * same.
  *
  * Pass the whole piece with its map rather than one call per meter span: a
  * split call cannot see a voice move or a key region that crosses the change.
@@ -507,4 +510,5 @@ declare function isStrongBeat(beatInQuarters: number, meter: MeterLike): boolean
  */
 declare function tuplet(totalBeats: number, count: number): number[];
 
-export { type BarPosition as B, type MeterChange as M, type TimeSignature as T, type MeterData as a, type MeterLike as b, type MeterMap as c, barIndexAt as d, barPositionToBeat as e, barPositionToPulse as f, barStartBeat as g, beatToBarPosition as h, beatsPerBar as i, beatsPerBarAt as j, formatBarPosition as k, formatTimeSignature as l, isCompound as m, isStrongBeat as n, meterAt as o, metricWeight as p, parseTimeSignature as q, pulseBeats as r, pulsesPerBar as s, resolveMeters as t, toMeterData as u, tryParseTimeSignature as v, tuplet as w };
+export { barIndexAt as d, barPositionToBeat as e, barPositionToPulse as f, barStartBeat as g, beatToBarPosition as h, beatsPerBar as i, beatsPerBarAt as j, formatBarPosition as k, formatTimeSignature as l, isCompound as m, isStrongBeat as n, meterAt as o, metricWeight as p, parseTimeSignature as q, pulseBeats as r, pulsesPerBar as s, resolveMeters as t, toMeterData as u, tryParseTimeSignature as v, tuplet as w };
+export type { BarPosition as B, MeterChange as M, TimeSignature as T, MeterData as a, MeterLike as b, MeterMap as c };

package/dist/{index-Dw2DP7vm.d.ts → index-BkT21EMv.d.cts}

@@ -1,4 +1,4 @@
-import { i as ChordToneRole, c as ChordLike } from './coerce-DP0vYu-x.js';
+import { i as ChordToneRole, c as ChordLike } from './coerce-Ytt2Eiq9.cjs';
 
 /**
  * Harmonic role a pitch plays within a chord.
@@ -60,4 +60,5 @@ type VoicedRole = {
  */
 declare function roleOf(pitch: number, chord: ChordLike, chordId?: number): VoicedRole;
 
-export { type HarmonyRole as H, type LockLevel as L, type VoicedRole as V, roleOf as r };
+export { roleOf as r };
+export type { HarmonyRole as H, LockLevel as L, VoicedRole as V };

package/dist/{index-BL5N2Oyz.d.cts → index-C7KCaTRz.d.ts}

@@ -1,4 +1,4 @@
-import { i as ChordToneRole, c as ChordLike } from './coerce-DRERzdve.cjs';
+import { i as ChordToneRole, c as ChordLike } from './coerce-CUhHc3Tu.js';
 
 /**
  * Harmonic role a pitch plays within a chord.
@@ -60,4 +60,5 @@ type VoicedRole = {
  */
 declare function roleOf(pitch: number, chord: ChordLike, chordId?: number): VoicedRole;
 
-export { type HarmonyRole as H, type LockLevel as L, type VoicedRole as V, roleOf as r };
+export { roleOf as r };
+export type { HarmonyRole as H, LockLevel as L, VoicedRole as V };

package/dist/{index-Cy15oTvh.d.ts → index-C9MYbuKS.d.cts}

@@ -781,12 +781,15 @@ declare function transposeByInterval(given: NoteLike, named: IntervalLike): Note
  * The spelled interval from one note to another.
  *
  * When both notes carry octaves, the interval reflects their full signed
- * distance (so `C4 -> C5` is a perfect octave). When either lacks an octave the
- * interval is measured within a single ascending octave from `a` to `b`.
+ * distance (so `C4 -> C5` is a perfect octave). When neither carries an octave
+ * the interval is measured within a single octave from `a` to `b`, normally
+ * ascending; a chromatic step down on one letter, such as `C -> Cb`, descends
+ * (`-A1`). Exactly one octave-bearing note has no defined answer and throws.
  *
  * @param a The lower/first note.
  * @param b The upper/second note.
  * @returns The diatonic number, quality, and semitone span.
+ * @throws If exactly one of the notes carries an octave.
  * @example
  * ```ts
  * import { spelledInterval, parseNote } from '@libraz/libcantus';
@@ -797,4 +800,5 @@ declare function transposeByInterval(given: NoteLike, named: IntervalLike): Note
  */
 declare function spelledInterval(a: Note, b: Note): SpelledInterval;
 
-export { ARTICULATIONS as A, BudgetExceededError as B, toNoteData as C, toSpelledInterval as D, transposeByInterval as E, transposeNote as F, tryParseInterval as G, tryParseKeyName as H, type IntervalData as I, tryParseNote as J, type KeyName as K, type LibcantusError as L, NoSolutionError as N, type ParseResult as P, type SpelledInterval as S, type Articulation as a, type IntervalLike as b, type IntervalQualityLabel as c, InvalidInputError as d, type KeyScale as e, type LibcantusErrorCode as f, type Note as g, type NoteEvent as h, type NoteLike as i, type NoteNameOptions as j, type NoteNameSystem as k, detectNoteNameSystem as l, diatonicLetterOf as m, formatKeyName as n, formatNote as o, intervalSemitones as p, isLibcantusError as q, midiToNote as r, naturalPitchClassOf as s, noteToMidi as t, noteToPitchClass as u, parseInterval as v, parseKeyName as w, parseNote as x, pitchClassOf as y, spelledInterval as z };
+export { ARTICULATIONS as A, BudgetExceededError as B, toNoteData as C, toSpelledInterval as D, transposeByInterval as E, transposeNote as F, tryParseInterval as G, tryParseKeyName as H, tryParseNote as J, NoSolutionError as N, InvalidInputError as d, detectNoteNameSystem as l, diatonicLetterOf as m, formatKeyName as n, formatNote as o, intervalSemitones as p, isLibcantusError as q, midiToNote as r, naturalPitchClassOf as s, noteToMidi as t, noteToPitchClass as u, parseInterval as v, parseKeyName as w, parseNote as x, pitchClassOf as y, spelledInterval as z };
+export type { IntervalData as I, KeyName as K, LibcantusError as L, ParseResult as P, SpelledInterval as S, Articulation as a, IntervalLike as b, IntervalQualityLabel as c, KeyScale as e, LibcantusErrorCode as f, Note as g, NoteEvent as h, NoteLike as i, NoteNameOptions as j, NoteNameSystem as k };

package/dist/{index-Cy15oTvh.d.cts → index-C9MYbuKS.d.ts}

@@ -781,12 +781,15 @@ declare function transposeByInterval(given: NoteLike, named: IntervalLike): Note
  * The spelled interval from one note to another.
  *
  * When both notes carry octaves, the interval reflects their full signed
- * distance (so `C4 -> C5` is a perfect octave). When either lacks an octave the
- * interval is measured within a single ascending octave from `a` to `b`.
+ * distance (so `C4 -> C5` is a perfect octave). When neither carries an octave
+ * the interval is measured within a single octave from `a` to `b`, normally
+ * ascending; a chromatic step down on one letter, such as `C -> Cb`, descends
+ * (`-A1`). Exactly one octave-bearing note has no defined answer and throws.
  *
  * @param a The lower/first note.
  * @param b The upper/second note.
  * @returns The diatonic number, quality, and semitone span.
+ * @throws If exactly one of the notes carries an octave.
  * @example
  * ```ts
  * import { spelledInterval, parseNote } from '@libraz/libcantus';
@@ -797,4 +800,5 @@ declare function transposeByInterval(given: NoteLike, named: IntervalLike): Note
  */
 declare function spelledInterval(a: Note, b: Note): SpelledInterval;
 
-export { ARTICULATIONS as A, BudgetExceededError as B, toNoteData as C, toSpelledInterval as D, transposeByInterval as E, transposeNote as F, tryParseInterval as G, tryParseKeyName as H, type IntervalData as I, tryParseNote as J, type KeyName as K, type LibcantusError as L, NoSolutionError as N, type ParseResult as P, type SpelledInterval as S, type Articulation as a, type IntervalLike as b, type IntervalQualityLabel as c, InvalidInputError as d, type KeyScale as e, type LibcantusErrorCode as f, type Note as g, type NoteEvent as h, type NoteLike as i, type NoteNameOptions as j, type NoteNameSystem as k, detectNoteNameSystem as l, diatonicLetterOf as m, formatKeyName as n, formatNote as o, intervalSemitones as p, isLibcantusError as q, midiToNote as r, naturalPitchClassOf as s, noteToMidi as t, noteToPitchClass as u, parseInterval as v, parseKeyName as w, parseNote as x, pitchClassOf as y, spelledInterval as z };
+export { ARTICULATIONS as A, BudgetExceededError as B, toNoteData as C, toSpelledInterval as D, transposeByInterval as E, transposeNote as F, tryParseInterval as G, tryParseKeyName as H, tryParseNote as J, NoSolutionError as N, InvalidInputError as d, detectNoteNameSystem as l, diatonicLetterOf as m, formatKeyName as n, formatNote as o, intervalSemitones as p, isLibcantusError as q, midiToNote as r, naturalPitchClassOf as s, noteToMidi as t, noteToPitchClass as u, parseInterval as v, parseKeyName as w, parseNote as x, pitchClassOf as y, spelledInterval as z };
+export type { IntervalData as I, KeyName as K, LibcantusError as L, ParseResult as P, SpelledInterval as S, Articulation as a, IntervalLike as b, IntervalQualityLabel as c, KeyScale as e, LibcantusErrorCode as f, Note as g, NoteEvent as h, NoteLike as i, NoteNameOptions as j, NoteNameSystem as k };