@libraz/libcantus 1.1.0 → 1.3.0

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   spellLine
-} from "./chunk-57WB2EDF.js";
+} from "./chunk-ZBUROTJQ.js";
 import "./chunk-QYQQ5J6E.js";
 import {
   Arrangement,
@@ -20,25 +20,20 @@ import {
   Timeline,
   Tuning,
   Voicing
-} from "./chunk-DKICR7AN.js";
+} from "./chunk-IPEF6NWB.js";
 import {
   analyzeArrangement,
   analyzePolyphony,
-  compareMelodies,
+  analyzeReference,
+  compareReferences,
   createArrangementSession,
-  extractMotifs,
   hypermeter,
-  melodicContour,
-  melodicSimilarity,
-  motifFromNotes,
   phrasesFromTimeline,
-  reduceProgression,
-  relateMotifs,
   sectionsFromNotes,
   structuralCadences,
   tensionCurve,
   tensionCurveFrom
-} from "./chunk-HSY2VQXZ.js";
+} from "./chunk-MLBPXA4Z.js";
 import {
   JUST_RATIOS,
   NOTE_VALUES,
@@ -63,13 +58,14 @@ import {
   stepsOfCents,
   tempoAt,
   ticksToBeats
-} from "./chunk-HOHFYGKW.js";
+} from "./chunk-UMWZ4ZET.js";
 import {
   BAR_STEPS,
   BASS_LICKS,
   BASS_STYLES,
   BEAT_STEPS,
   BORROWED_DEGREES,
+  COMPOSITION_PLAN_VERSION,
   DRUM_KIT,
   DRUM_NOTES,
   DRUM_PATTERNS,
@@ -84,18 +80,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,
@@ -118,6 +118,7 @@ import {
   pickVocabulary,
   placeDrumPattern,
   placeLicks,
+  planTimeline,
   progressions,
   progressionsByStyle,
   resolveContext,
@@ -132,12 +133,21 @@ import {
   transformMotif,
   vocabularyOfKind,
   withinCeiling
-} from "./chunk-R5VUXQMP.js";
+} from "./chunk-CPMB7P75.js";
 import {
+  CADENCE_TYPES,
+  HARMONIC_FUNCTIONS,
+  MELODIC_CONTOUR_SHAPES,
   MODAL_SCALE_NAMES,
+  MOTIF_RELATION_KINDS,
+  REDUCTION_LEVELS,
+  REFERENCE_PROFILE_VERSION,
+  RHYTHM_IOI_BINS,
   analyzeChord,
+  analyzeRhythm,
   analyzeVoice,
   assertChordTimeline,
+  assertReferenceProfile,
   augmentedSixthChord,
   augmentedSixthFromPitchClasses,
   augmentedSixthKind,
@@ -145,6 +155,7 @@ import {
   chordTimelineFromChords,
   chordTimelineFromNotes,
   chordToRoman,
+  compareMelodies,
   detectCadence,
   detectCadences,
   detectChord,
@@ -154,19 +165,26 @@ import {
   detectKeyFromNotes,
   detectModulations,
   explainRoman,
+  extractMotifs,
   functionOf,
   isBorrowedChord,
   isDiatonic,
   isMinorKey,
   keyTimelineFromNotes,
+  melodicContour,
+  melodicSimilarity,
+  motifFromNotes,
+  motifGraph,
   pivotChords,
   prevailingKeyOf,
+  reduceProgression,
+  relateMotifs,
   romanToChord,
   secondaryDominant,
   secondaryDominantOf,
   spellAugmentedSixth,
   toVoiceNotes
-} from "./chunk-VLE5R7PF.js";
+} from "./chunk-GNVN4PPJ.js";
 import {
   ALGORITHM_VERSION,
   BASS_4_STRING,
@@ -187,10 +205,10 @@ import {
   resolveAlgorithmVersion,
   toInstrumentProfile,
   toStringedProfile
-} from "./chunk-X6RJAHII.js";
+} from "./chunk-7KG3RTYS.js";
 import {
   createNoteEventIndex
-} from "./chunk-7GOKQJTQ.js";
+} from "./chunk-PUKJP2Z5.js";
 import "./chunk-K6OZXIR6.js";
 import {
   SATB_RANGES,
@@ -209,7 +227,7 @@ import {
   voiceChordStyled,
   voiceLeadingCost,
   voiceProgression
-} from "./chunk-AWEMD747.js";
+} from "./chunk-M5RYMAFI.js";
 import {
   availableTensions,
   avoidNotes,
@@ -218,7 +236,7 @@ import {
   roleOf,
   scaleMatchesChord,
   scalesForChanges
-} from "./chunk-H66ARFU5.js";
+} from "./chunk-NB25P3EH.js";
 import {
   ALTERED_MASK,
   BLUES_MASK,
@@ -335,7 +353,7 @@ import {
   tryResolveKeyName,
   variantOfMask,
   voiceIndependence
-} from "./chunk-FPBZFNCD.js";
+} from "./chunk-RFIBF2RR.js";
 import {
   ARTICULATIONS,
   BudgetExceededError,
@@ -404,7 +422,7 @@ import {
   tryParseNote,
   tryParseTimeSignature,
   tuplet
-} from "./chunk-PQL7E5F6.js";
+} from "./chunk-AGOVW7U6.js";
 export {
   ALGORITHM_VERSION,
   ALTERED_MASK,
@@ -419,7 +437,9 @@ export {
   BLUES_MASK,
   BORROWED_DEGREES,
   BudgetExceededError,
+  CADENCE_TYPES,
   CHROMATIC_MASK,
+  COMPOSITION_PLAN_VERSION,
   Chord,
   Composer,
   ConsonanceClass,
@@ -435,6 +455,7 @@ export {
   GENRES,
   GUITAR_DROP_D,
   GUITAR_STANDARD,
+  HARMONIC_FUNCTIONS,
   HARMONIC_MINOR_MASK,
   Instrument,
   Interval,
@@ -452,6 +473,7 @@ export {
   MAJOR_PENTATONIC_MASK,
   MARWA_MASK,
   MAX_DIFFICULTY,
+  MELODIC_CONTOUR_SHAPES,
   MELODIC_MINOR_MASK,
   MINOR_PENTATONIC_MASK,
   MIN_ALGORITHM_VERSION,
@@ -460,6 +482,7 @@ export {
   MIXOLYDIAN_MASK,
   MIYAKO_BUSHI_MASK,
   MODAL_SCALE_NAMES,
+  MOTIF_RELATION_KINDS,
   Meter,
   Motif,
   NAMED_SCALES,
@@ -477,6 +500,9 @@ export {
   PROVENANCE_BASES,
   PURVI_MASK,
   Progression,
+  REDUCTION_LEVELS,
+  REFERENCE_PROFILE_VERSION,
+  RHYTHM_IOI_BINS,
   RITSU_MASK,
   RYUKYU_MASK,
   ReasonFlag,
@@ -498,9 +524,12 @@ export {
   analyzeArrangement,
   analyzeChord,
   analyzePolyphony,
+  analyzeReference,
+  analyzeRhythm,
   analyzeVoice,
   applyGrooveTemplate,
   assertChordTimeline,
+  assertCompositionPlan,
   assertDegree,
   assertFiniteNumber,
   assertFiniteSemitones,
@@ -515,6 +544,7 @@ export {
   assertOneOf,
   assertPositiveInt,
   assertRange,
+  assertReferenceProfile,
   assertTimeSignature,
   assertVocabulary,
   augmentedSixthChord,
@@ -560,6 +590,7 @@ export {
   classifyMelodyTones,
   classifySpelledInterval,
   compareMelodies,
+  compareReferences,
   createArrangementSession,
   createNoteEventIndex,
   createPositionalRng,
@@ -573,6 +604,7 @@ export {
   createsVoiceCrossing,
   createsVoiceOverlap,
   deform,
+  deriveCompositionPlan,
   deriveSeed,
   detectCadence,
   detectCadences,
@@ -598,6 +630,7 @@ export {
   edo,
   enharmonicKeyOf,
   enumerateSafePitches,
+  evaluateComposition,
   evaluateSafety,
   exceedsSpacing,
   explainRoman,
@@ -618,6 +651,7 @@ export {
   generateBassLine,
   generateCounterMelody,
   generateDrums,
+  generateMelody,
   generateMotif,
   generateProgression,
   generateRhythm,
@@ -666,6 +700,7 @@ export {
   minorKey,
   modalInterchangePalette,
   motifFromNotes,
+  motifGraph,
   motifToNoteEvents,
   namedScaleMask,
   naturalPitchClassOf,
@@ -693,6 +728,7 @@ export {
   pivotChords,
   placeDrumPattern,
   placeLicks,
+  planTimeline,
   playability,
   prevailingKeyOf,
   profileWeights,

package/dist/{masks-O73Rhj5d.d.ts → masks-Cc7-MzzY.d.ts}

@@ -1,4 +1,4 @@
-import { k as KeyVariant } from './coerce-wwdELNYS.js';
+import { k as KeyVariant } from './coerce-DP0vYu-x.js';
 
 /**
  * Build a 12-bit mode mask from a list of semitone offsets above the root.

package/dist/{masks-C8TWLFIi.d.cts → masks-pADfTOiD.d.cts}

@@ -1,4 +1,4 @@
-import { k as KeyVariant } from './coerce-CJlgULrQ.cjs';
+import { k as KeyVariant } from './coerce-DRERzdve.cjs';
 
 /**
  * Build a 12-bit mode mask from a list of semitone offsets above the root.

package/dist/model/index.cjs

@@ -16,23 +16,23 @@
 
 
 
-var _chunkGDKE6RQWcjs = require('../chunk-GDKE6RQW.cjs');
-require('../chunk-XVMJO3QF.cjs');
-require('../chunk-5JJ6EHEZ.cjs');
-require('../chunk-5KW7DNCJ.cjs');
-require('../chunk-Q6R3QAZD.cjs');
-require('../chunk-J772DL3B.cjs');
-require('../chunk-TT6PKMPR.cjs');
-require('../chunk-RVS4G4MR.cjs');
-require('../chunk-R7B5N2JK.cjs');
+var _chunk4R2LWV7Ecjs = require('../chunk-4R2LWV7E.cjs');
+require('../chunk-YFA7X2F6.cjs');
+require('../chunk-NM7UAMC3.cjs');
+require('../chunk-B2PW6EHN.cjs');
+require('../chunk-IFZDWIKM.cjs');
+require('../chunk-CGBADIO5.cjs');
+require('../chunk-35NBV2FT.cjs');
+require('../chunk-76ZBTRG2.cjs');
+require('../chunk-PM4XJE2Y.cjs');
 
 
-var _chunkYPB3A3EYcjs = require('../chunk-YPB3A3EY.cjs');
+var _chunk3R3QVKY5cjs = require('../chunk-3R3QVKY5.cjs');
 
 
 
 
-var _chunkXKSO2V5Icjs = require('../chunk-XKSO2V5I.cjs');
+var _chunkS5BKZZGMcjs = require('../chunk-S5BKZZGM.cjs');
 
 
 
@@ -55,5 +55,5 @@ var _chunkXKSO2V5Icjs = require('../chunk-XKSO2V5I.cjs');
 
 
 
-exports.Arrangement = _chunkGDKE6RQWcjs.Arrangement; exports.BudgetExceededError = _chunkXKSO2V5Icjs.BudgetExceededError; exports.Chord = _chunkGDKE6RQWcjs.Chord; exports.Composer = _chunkGDKE6RQWcjs.Composer; exports.Duration = _chunkGDKE6RQWcjs.Duration; exports.Instrument = _chunkGDKE6RQWcjs.Instrument; exports.Interval = _chunkGDKE6RQWcjs.Interval; exports.InvalidInputError = _chunkXKSO2V5Icjs.InvalidInputError; exports.Key = _chunkGDKE6RQWcjs.Key; exports.Meter = _chunkGDKE6RQWcjs.Meter; exports.Motif = _chunkGDKE6RQWcjs.Motif; exports.NoSolutionError = _chunkXKSO2V5Icjs.NoSolutionError; exports.Note = _chunkGDKE6RQWcjs.Note; exports.NoteSafety = _chunkYPB3A3EYcjs.NoteSafety; exports.Progression = _chunkGDKE6RQWcjs.Progression; exports.Rhythm = _chunkGDKE6RQWcjs.Rhythm; exports.Score = _chunkGDKE6RQWcjs.Score; exports.Tempo = _chunkGDKE6RQWcjs.Tempo; exports.Timeline = _chunkGDKE6RQWcjs.Timeline; exports.Tuning = _chunkGDKE6RQWcjs.Tuning; exports.Voicing = _chunkGDKE6RQWcjs.Voicing;
+exports.Arrangement = _chunk4R2LWV7Ecjs.Arrangement; exports.BudgetExceededError = _chunkS5BKZZGMcjs.BudgetExceededError; exports.Chord = _chunk4R2LWV7Ecjs.Chord; exports.Composer = _chunk4R2LWV7Ecjs.Composer; exports.Duration = _chunk4R2LWV7Ecjs.Duration; exports.Instrument = _chunk4R2LWV7Ecjs.Instrument; exports.Interval = _chunk4R2LWV7Ecjs.Interval; exports.InvalidInputError = _chunkS5BKZZGMcjs.InvalidInputError; exports.Key = _chunk4R2LWV7Ecjs.Key; exports.Meter = _chunk4R2LWV7Ecjs.Meter; exports.Motif = _chunk4R2LWV7Ecjs.Motif; exports.NoSolutionError = _chunkS5BKZZGMcjs.NoSolutionError; exports.Note = _chunk4R2LWV7Ecjs.Note; exports.NoteSafety = _chunk3R3QVKY5cjs.NoteSafety; exports.Progression = _chunk4R2LWV7Ecjs.Progression; exports.Rhythm = _chunk4R2LWV7Ecjs.Rhythm; exports.Score = _chunk4R2LWV7Ecjs.Score; exports.Tempo = _chunk4R2LWV7Ecjs.Tempo; exports.Timeline = _chunk4R2LWV7Ecjs.Timeline; exports.Tuning = _chunk4R2LWV7Ecjs.Tuning; exports.Voicing = _chunk4R2LWV7Ecjs.Voicing;
 //# sourceMappingURL=index.cjs.map

package/dist/model/index.d.cts

@@ -1,23 +1,23 @@
-import { R as ReduceProgressionOptions, u as ReducedChord, D as DetectChordOptions, C as ChordMatch, g as DetectKeyOptions, K as KeyMatch, d as AugmentedSixthKind, s as PhraseOptions, P as Phrase, S as StructuralCadence, h as FormSectionOptions, F as FormSection, i as HypermeterOptions, H as Hypermeter, E as ExtractMotifsOptions, o as MotifData, j as MelodicContour, c as ArrangementTrack, a as ArrangementOptions, A as ArrangementAnalysis, e as Conflict, y as TrackEdit, T as TensionPoint, q as MotifRelation } from '../index-DTsKaPaC.cjs';
-export { b as ArrangementSession, f as ContourDirection, k as MelodicContourShape, n as ModalScaleName, p as MotifOccurrence, r as MotifRelationKind, t as PhraseSignal, v as ReductionBasis, w as ReductionLevel, x as TrackAnalysis, z as TrackRole } from '../index-DTsKaPaC.cjs';
-import { k as KeyRegion, f as ChordTimelineOptions, C as CadenceHit, l as KeyTimelineOptions, h as ChordToRomanOptions, e as ChordTimeline, H as HarmonicFunction, A as AnalyzeChordOptions, D as DetectCadenceOptions, c as ChordAnalysis, b as CadenceResult, E as ExplainRomanOptions, m as RomanExplanation, B as BorrowedSource, a as AnalyzedNote, I as IdentifiedVoiceNote } from '../index-B3WCj_Hm.cjs';
-export { d as ChordSegmentation, g as ChordTimelineResult, K as KeyContext, i as KeyProfileName, j as KeyProfilePair, P as PivotChord, R as RejectedCandidate, S as SuspensionFigure, T as TheoryLabel, V as VoiceNote } from '../index-B3WCj_Hm.cjs';
+import { D as DetectChordOptions, C as ChordMatch, g as DetectKeyOptions, K as KeyMatch, d as AugmentedSixthKind, k as PhraseOptions, P as Phrase, S as StructuralCadence, h as HypermeterOptions, H as Hypermeter, R as ReferenceProfileOptions, c as ArrangementTrack, a as ArrangementOptions, A as ArrangementAnalysis, e as Conflict, n as TrackEdit, T as TensionPoint } from '../profile-CQMEqdH9.cjs';
+export { b as ArrangementSession, f as ConflictPartner, j as ModalScaleName, l as PhraseSignal, m as TrackAnalysis, o as TrackRole } from '../profile-CQMEqdH9.cjs';
+import { r as KeyRegion, i as ChordTimelineOptions, U as ReduceProgressionOptions, V as ReducedChord, c as CadenceHit, s as KeyTimelineOptions, k as ChordToRomanOptions, h as ChordTimeline, o as HarmonicFunction, A as AnalyzeChordOptions, D as DetectCadenceOptions, f as ChordAnalysis, d as CadenceResult, E as ExplainRomanOptions, a9 as RomanExplanation, b as BorrowedSource, n as FormSectionOptions, F as FormSection, m as ExtractMotifsOptions, x as MotifData, u as MelodicContour, a5 as ReferenceProfile, a8 as RhythmAnalysisOptions, a7 as RhythmAnalysis, J as MotifGraphOptions, y as MotifGraph, a as AnalyzedNote, I as IdentifiedVoiceNote, N as MotifRelation } from '../types-D-XgxGvp.cjs';
+export { B as BarPositionProfile, e as CadenceType, g as ChordSegmentation, j as ChordTimelineResult, l as ContourDirection, K as KeyContext, p as KeyProfileName, q as KeyProfilePair, v as MelodicContourShape, z as MotifGraphEdge, G as MotifGraphNode, L as MotifOccurrence, O as MotifRelationKind, P as MotifRelationSummary, Q as PivotChord, W as ReductionBasis, 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, a6 as RejectedCandidate, aa as SuspensionFigure, ab as TheoryLabel, ac as VoiceNote } from '../types-D-XgxGvp.cjs';
 import { c as IntervalQualityLabel, I as IntervalData, P as ParseResult, S as SpelledInterval, g as Note$1, j as NoteNameOptions, b as IntervalLike, h as NoteEvent, i as NoteLike, e as KeyScale, a as Articulation } from '../index-Cy15oTvh.cjs';
 export { B as BudgetExceededError, d as InvalidInputError, L as LibcantusError, N as NoSolutionError, k as NoteNameSystem } from '../index-Cy15oTvh.cjs';
-import { K as KeyLike, e as ChordSegment, g as ChordSpan, b as Chord$1, d as ChordQuality, h as ChordSpec, i as ChordToneRole, n as ResolvedKey, k as KeyVariant, j as KeyRelation, c as ChordLike, q as SpelledKeyLike, o as SafetyQuery, E as EvaluateSafetyOptions, p as SafetyResult } from '../coerce-CJlgULrQ.cjs';
-export { A as Alteration, a as AlteredDegree, C as ChordBase, f as ChordSeventh, N as NoteSafety, l as PitchSpelling, m as ProfileWeights, S as SafetyProfile, r as SpelledKeyScale, V as VoiceSnapshot } from '../coerce-CJlgULrQ.cjs';
+import { K as KeyLike, e as ChordSegment, g as ChordSpan, b as Chord$1, d as ChordQuality, h as ChordSpec, i as ChordToneRole, n as ResolvedKey, k as KeyVariant, j as KeyRelation, c as ChordLike, r as SpelledKeyLike, p as SafetyQuery, E as EvaluateSafetyOptions, q as SafetyResult } from '../coerce-DRERzdve.cjs';
+export { A as Alteration, a as AlteredDegree, C as ChordBase, f as ChordSeventh, N as NoteSafety, l as PitchSpelling, m as ProfileWeights, S as SafetyPartner, o as SafetyProfile, s as SpelledKeyScale, V as VoiceSnapshot } from '../coerce-DRERzdve.cjs';
 import { j as TuningTable, i as TempoMap, g as PlayabilityReport, b as NoteEventIndexOptions, a as NoteEventIndex, d as NoteValue, k as Tuplet, D as DurationData, S as SpelledDuration } from '../index-cHvbYgJI.cjs';
 export { I as IndexedNoteEvent, c as NotePlacement, O as OnsetTieBreak, P as PlayabilityIssue, e as PlayabilityIssueType, f as PlayabilityLayer, h as TempoEvent } from '../index-cHvbYgJI.cjs';
 import { b as InstrumentProfileLike, d as PositionalRng, I as InstrumentProfile, e as StringFingering } from '../positional-DMZer-FM.cjs';
 export { a as InstrumentProfileCommon, c as Limb, P as PercussionProfile, S as SeedPath, f as StringedProfile, V as ValidatedPercussionProfile, g as ValidatedProfile, h as ValidatedStringedProfile } from '../positional-DMZer-FM.cjs';
-import { c as MeterMap, b as MeterLike, B as BarPosition, T as TimeSignature } from '../index-D_hzxD8w.cjs';
-export { M as MeterChange } from '../index-D_hzxD8w.cjs';
-import { s as ScaleNameInput, r as ScaleName } from '../masks-C8TWLFIi.cjs';
-import { n as TransposingInstrument, r as VoicingOptions, h as ScaleChoice, d as ChordSymbolOptions, m as StyledVoicingOptions, C as ChordScaleMatch, c as ChordScaleReportEntry, A as AvailableTensionsOptions, b as AvoidNotesOptions, K as KeyMode, i as ScaleSystem, q as VoiceRange, P as PartWritingOptions, e as PartWritingViolation, j as Species, k as SpeciesOptions, V as VoiceIndependenceOptions, p as VoiceIndependenceReport } from '../index-BaoKVVhE.cjs';
-export { a as AvoidNoteUse, f as PartWritingViolationKind, o as TransposingInstrumentName, s as VoicingStyle } from '../index-BaoKVVhE.cjs';
-import { a2 as SubstitutionType, a0 as SubstituteOptions, a1 as Substitution, g as BorrowedChord, z as HumanizeOptions, L as OrnamentOptions, w as GrooveTemplate, d as BassLineOptions, C as Complexity, a4 as Vocabulary, T as ProgressionOptions, o as DrumsOptions, e as BassSegment, h as CounterMelodyOptions, H as HarmonizeOptions, p as GenerationContext, A as MotifCell, F as MotifContour, q as GenerationContextInput, I as MotifNote, K as MotifTransform, Y as RhythmEvent, Z as RhythmOptions } from '../index-BzLNkmA7.cjs';
-export { f as BassStyle, l as DrumRole, E as EuclideanKick, r as Genre, s as GridEvent, t as GrooveFeel, u as GrooveSlot, v as GrooveStyle, x as HarmonizePlacement, M as MelodyNote, N as OrnamentStyle, Q as ProgFunction, R as ProgStyle, S as ProgressionDegree, U as ProgressionPreset, V as Provenance, W as ProvenanceBasis, $ as Section } from '../index-BzLNkmA7.cjs';
-import '../index-CBCP84rv.cjs';
+import { c as MeterMap, b as MeterLike, B as BarPosition, T as TimeSignature } from '../index-BMweUlm5.cjs';
+export { M as MeterChange } from '../index-BMweUlm5.cjs';
+import { s as ScaleNameInput, r as ScaleName } from '../masks-pADfTOiD.cjs';
+import { n as TransposingInstrument, r as VoicingOptions, h as ScaleChoice, d as ChordSymbolOptions, m as StyledVoicingOptions, C as ChordScaleMatch, c as ChordScaleReportEntry, A as AvailableTensionsOptions, b as AvoidNotesOptions, K as KeyMode, i as ScaleSystem, q as VoiceRange, P as PartWritingOptions, e as PartWritingViolation, j as Species, k as SpeciesOptions, V as VoiceIndependenceOptions, p as VoiceIndependenceReport } from '../index-B9QLziDe.cjs';
+export { a as AvoidNoteUse, f as PartWritingViolationKind, o as TransposingInstrumentName, s as VoicingStyle } from '../index-B9QLziDe.cjs';
+import { af as SubstitutionType, ad as SubstituteOptions, ae as Substitution, g as BorrowedChord, L as HumanizeOptions, U as OrnamentOptions, H as GrooveTemplate, j as CompositionPlan, u as EvaluateCompositionOptions, i as CompositionEvaluation, d as BassLineOptions, h as Complexity, ah as Vocabulary, a4 as ProgressionOptions, t as DrumsOptions, e as BassSegment, m as CounterMelodyOptions, I as HarmonizeOptions, k as CompositionPlanOptions, N as MelodyOptions, v as GenerationContext, O as MotifCell, P as MotifContour, w as GenerationContextInput, Q as MotifNote, S as MotifTransform, a9 as RhythmEvent, aa as RhythmOptions } from '../index-CY-3NVfy.cjs';
+export { f as BassStyle, l as CompositionViolation, q as DrumRole, E as EuclideanKick, x as Genre, y as GridEvent, z as GrooveFeel, A as GrooveSlot, F as GrooveStyle, J as HarmonizePlacement, M as MelodyNote, V as OrnamentStyle, 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, a5 as ProgressionPreset, a6 as Provenance, a7 as ProvenanceBasis, ac as Section } from '../index-CY-3NVfy.cjs';
+import '../index-BL5N2Oyz.cjs';
 
 /**
  * An immutable spelled interval value: a diatonic number, a quality label, and
@@ -3236,6 +3236,113 @@ declare class Score {
      * answered for; {@link Score.voices} is what reads the polyphony as polyphony.
      */
     contour(): MelodicContour;
+    /**
+     * The score's structural fingerprint: form, phrase shape, harmonic function
+     * and rhythm, and how its motifs derive from one another.
+     *
+     * The harmony is the score's own kept chord analysis, read once whether this
+     * is asked before or after {@link Score.timeline} — unless `opts.timeline`
+     * gives the harmony directly, in which case the reading runs fresh through
+     * {@link analyzeReference} rather than the harmony this score already holds.
+     * The meter, the key and the span are the score's own and are not on offer
+     * here: a caller wanting another meter reads through {@link
+     * Score.withMeters}, and one wanting another key or span calls {@link
+     * analyzeReference} directly.
+     *
+     * Asked with no options, the answer is kept and a copy of it handed back, as
+     * {@link Score.timeline} keeps its own reading; asked with options, the
+     * answer is read afresh and not kept.
+     *
+     * @param opts The harmony, the melody, and the budget; see {@link
+     *   ReferenceProfileOptions}. Meter, key and span are the score's own.
+     * @returns The profile.
+     * @example
+     * ```ts
+     * import { Score } from '@libraz/libcantus';
+     * const triad = (pitches: number[], startBeat: number) =>
+     *   pitches.map((pitch) => ({ pitch, startBeat, durationBeat: 4 }));
+     * const score = Score.of(
+     *   [
+     *     ...triad([60, 64, 67], 0),
+     *     ...triad([65, 69, 72], 4),
+     *     ...triad([67, 71, 74], 8),
+     *     ...triad([60, 64, 67], 12),
+     *   ],
+     *   { key: 'C major' },
+     * );
+     * score.reference().harmony.chords.map((chord) => chord.roman); // ['I', 'IV', 'V', 'I']
+     * ```
+     */
+    reference(opts?: Omit<ReferenceProfileOptions, 'ts' | 'meters' | 'key' | 'totalBeats'>): ReferenceProfile;
+    /**
+     * The onset placement of the score's melodic line.
+     *
+     * A melody is one line, so a score holding several is read as its top voice,
+     * as {@link Score.motifs} and {@link Score.contour} are.
+     *
+     * @param opts The span's end and the budget; see {@link
+     *   RhythmAnalysisOptions}. The meter is the score's own.
+     * @returns The rhythm reading.
+     * @example
+     * ```ts
+     * import { Score } from '@libraz/libcantus';
+     * const score = Score.of([
+     *   { pitch: 60, startBeat: 0, durationBeat: 1 },
+     *   { pitch: 62, startBeat: 1, durationBeat: 1 },
+     *   { pitch: 64, startBeat: 2, durationBeat: 1 },
+     *   { pitch: 65, startBeat: 3, durationBeat: 1 },
+     * ]);
+     * score.rhythm().onsetDensity; // 4
+     * ```
+     */
+    rhythm(opts?: Omit<RhythmAnalysisOptions, 'ts' | 'meters'>): RhythmAnalysis;
+    /**
+     * How the score's motifs derive from one another: which statement grew out
+     * of which, and by what transformation.
+     *
+     * {@link Score.motifs} finds the cells; this reads across their occurrences
+     * and names, for every statement after the first, the earlier one it most
+     * plausibly grew out of. A melody is one line, so a score holding several is
+     * read as its top voice, as {@link Score.motifs} is.
+     *
+     * @param opts Cell-length bounds and the recurrence threshold {@link
+     *   Score.motifs} takes, plus the variation threshold and the budget; see
+     *   {@link MotifGraphOptions} and {@link ExtractMotifsOptions}.
+     * @returns The derivation forest.
+     * @example
+     * ```ts
+     * import { Score } from '@libraz/libcantus';
+     * const score = Score.of([
+     *   { pitch: 60, startBeat: 0, durationBeat: 1 },
+     *   { pitch: 62, startBeat: 1, durationBeat: 1 },
+     *   { pitch: 64, startBeat: 2, durationBeat: 1 },
+     *   { pitch: 60, startBeat: 3, durationBeat: 1 },
+     *   { pitch: 62, startBeat: 4, durationBeat: 1 },
+     *   { pitch: 64, startBeat: 5, durationBeat: 1 },
+     * ]);
+     * score.motifGraph().edges.length; // 1
+     * ```
+     */
+    motifGraph(opts?: MotifGraphOptions & ExtractMotifsOptions): MotifGraph;
+    /**
+     * How this score, read as a melody, keeps to a composition plan.
+     *
+     * @param plan The plan the melody was written for.
+     * @param opts The budget; see {@link EvaluateCompositionOptions}.
+     * @returns The violations found and the fit reading; see {@link
+     *   evaluateComposition}.
+     * @example
+     * ```ts
+     * import { Composer, Score } from '@libraz/libcantus';
+     * const notes = [60, 62, 64, 65, 67, 65, 64, 62, 60, 62, 64, 65, 67, 65, 64, 60].map(
+     *   (pitch, startBeat) => ({ pitch, startBeat, durationBeat: 1 }),
+     * );
+     * const composer = Composer.of({ key: 'C major', seed: 5 });
+     * const plan = composer.plan(Score.of(notes, { key: 'C major' }).reference());
+     * composer.melody(plan).evaluate(plan).violations.some((v) => v.severity === 'error'); // false
+     * ```
+     */
+    evaluate(plan: CompositionPlan, opts?: EvaluateCompositionOptions): CompositionEvaluation;
     /**
      * Each note's role in the harmony sounding under it.
      *
@@ -3577,6 +3684,47 @@ declare class Arrangement {
      *   found under it.
      */
     timeline(): Timeline;
+    /**
+     * The arrangement's structural fingerprint: form, phrase shape, harmonic
+     * function and rhythm, and how its melody's motifs derive from one another.
+     *
+     * The harmony reads the arrangement's own session analysis directly — the
+     * tracks `settings.harmonyTracks` names, or else every track but the
+     * percussion ones — so the harmony is never inferred a second time. The
+     * melody is the notes of the tracks played with `role: 'melody'`, joined in
+     * the order the tracks were given; an arrangement naming none reads the top
+     * line of the harmony notes instead, as {@link analyzeReference} does
+     * without a `melody` option. Meter, key, harmony and melody are the
+     * arrangement's own and are not on offer here: a caller wanting others calls
+     * {@link analyzeReference} directly, with the same notes {@link
+     * Arrangement.tracks} hands out.
+     *
+     * @param opts The budget; see {@link ReferenceProfileOptions}.
+     * @returns The profile.
+     * @example
+     * ```ts
+     * import { Arrangement } from '@libraz/libcantus';
+     * const triad = (pitches: number[], startBeat: number) =>
+     *   pitches.map((pitch) => ({ pitch, startBeat, durationBeat: 4 }));
+     * const arrangement = Arrangement.of(
+     *   [
+     *     {
+     *       name: 'lead',
+     *       role: 'melody',
+     *       notes: [
+     *         ...triad([60, 64, 67], 0),
+     *         ...triad([65, 69, 72], 4),
+     *         ...triad([67, 71, 74], 8),
+     *         ...triad([60, 64, 67], 12),
+     *       ],
+     *     },
+     *   ],
+     *   { key: 'C major' },
+     * );
+     * arrangement.reference().harmony.chords.map((chord) => chord.roman); // ['I', 'IV', 'V', 'I']
+     * ```
+     */
+    reference(opts?: Omit<ReferenceProfileOptions, 'ts' | 'meters' | 'key' | 'melody' | 'timeline' | 'totalBeats'>): ReferenceProfile;
     /**
      * Whether another arrangement holds the same tracks under the same settings.
      *
@@ -3844,6 +3992,54 @@ declare class Composer {
      * ```
      */
     harmonize(melody: Score, opts?: Omit<HarmonizeOptions, 'melody' | 'key' | 'ts' | 'ctx'>): HarmonizedMelody;
+    /**
+     * A composition plan derived from a reference profile.
+     *
+     * The composer's key is the plan's home key unless `opts.key` names another,
+     * and its seed and algorithm version are the ones the plan records, so the
+     * plan is written under the same recipe as the composer's other parts.
+     *
+     * @param reference The reference profile to derive from.
+     * @param opts Everything {@link deriveCompositionPlan} takes but the context,
+     *   which is the composer's.
+     * @returns The plan.
+     * @throws If the composer draws from a caller-held `rng`: a plan records its
+     *   seed, and a source cannot be written into it.
+     * @example
+     * ```ts
+     * import { Composer, Score } from '@libraz/libcantus';
+     * const notes = [60, 62, 64, 65, 67, 65, 64, 62, 60, 62, 64, 65, 67, 65, 64, 60].map(
+     *   (pitch, startBeat) => ({ pitch, startBeat, durationBeat: 1 }),
+     * );
+     * const reference = Score.of(notes, { key: 'C major' }).reference();
+     * const plan = Composer.of({ key: 'D major', seed: 5 }).plan(reference);
+     * plan.seed; // 5
+     * plan.keys[0].scale.rootPc; // 2
+     * ```
+     */
+    plan(reference: ReferenceProfile, opts?: Omit<CompositionPlanOptions, 'ctx'>): CompositionPlan;
+    /**
+     * A melody written to a composition plan.
+     *
+     * The plan is the reproduction recipe, so its seed and algorithm version are
+     * the ones the melody is drawn under, not the composer's. The score is read
+     * in the plan's meter and home key, at the composer's tempo.
+     *
+     * @param plan The plan to follow.
+     * @param opts The budget; see {@link MelodyOptions}.
+     * @returns The melody, as a score.
+     * @example
+     * ```ts
+     * import { Composer, Score } from '@libraz/libcantus';
+     * const notes = [60, 62, 64, 65, 67, 65, 64, 62, 60, 62, 64, 65, 67, 65, 64, 60].map(
+     *   (pitch, startBeat) => ({ pitch, startBeat, durationBeat: 1 }),
+     * );
+     * const composer = Composer.of({ key: 'C major', seed: 5 });
+     * const plan = composer.plan(Score.of(notes, { key: 'C major' }).reference());
+     * composer.melody(plan).notes.length > 0; // true
+     * ```
+     */
+    melody(plan: CompositionPlan, opts?: Omit<MelodyOptions, 'ctx'>): Score;
     /**
      * Whether another composer holds the same settings.
      *
@@ -5672,7 +5868,8 @@ declare class Voicing {
      * @param pitch The candidate MIDI pitch.
      * @param query The candidate's harmonic and voice-leading context.
      * @param opts Set `suggestions: false` to skip the search for safe
-     *   replacements when the verdict is not safe.
+     *   replacements when the verdict is not safe, and `partners: true` to learn
+     *   which voice of this voicing, by index, raised each pairwise flag.
      * @returns The verdict, reason bitmask, and optional resolution guidance.
      * @throws If the profile is unknown, a value names no chord or key, or a
      *   pitch is not a MIDI pitch in 0..127.
@@ -5749,4 +5946,4 @@ declare class Voicing {
     toString(): string;
 }
 
-export { AnalyzeChordOptions, AnalyzedNote, Arrangement, ArrangementAnalysis, type ArrangementData, ArrangementOptions, type ArrangementSettings, type ArrangementSetup, type ArrangementTensionOptions, ArrangementTrack, Articulation, AugmentedSixthKind, AvailableTensionsOptions, AvoidNotesOptions, BarPosition, BassLineOptions, type BassLineSettings, BassSegment, BorrowedChord, BorrowedSource, CadenceHit, CadenceResult, Chord, ChordAnalysis, Chord$1 as ChordData, ChordLike, ChordMatch, ChordQuality, ChordScaleMatch, ChordScaleReportEntry, ChordSegment, ChordSpan, ChordSpec, ChordSymbolOptions, ChordTimeline, ChordTimelineOptions, ChordToRomanOptions, ChordToneRole, Complexity, Composer, type ComposerOptions, Conflict, CounterMelodyOptions, type CounterMelodySettings, DetectCadenceOptions, DetectChordOptions, DetectKeyOptions, type DetectedKeyMatch, DrumsOptions, Duration, DurationData, EvaluateSafetyOptions, ExplainRomanOptions, ExtractMotifsOptions, FormSection, FormSectionOptions, GenerationContext, GenerationContextInput, GrooveTemplate, HarmonicFunction, HarmonizeOptions, type HarmonizedMelody, HumanizeOptions, Hypermeter, HypermeterOptions, IdentifiedVoiceNote, Instrument, InstrumentProfile, InstrumentProfileLike, Interval, IntervalData, IntervalLike, IntervalQualityLabel, Key, type KeyData, KeyLike, KeyMatch, KeyMode, KeyRegion, KeyRelation, KeyScale, KeyTimelineOptions, KeyVariant, MelodicContour, Meter, MeterLike, MeterMap, Motif, MotifCell, MotifContour, MotifData, type MotifGenerateOptions, MotifNote, MotifRelation, MotifTransform, Note, Note$1 as NoteData, NoteEvent, NoteEventIndex, NoteEventIndexOptions, NoteLike, NoteNameOptions, NoteValue, OrnamentOptions, ParseResult, PartWritingOptions, PartWritingViolation, Phrase, PhraseOptions, PlayabilityReport, PositionalRng, Progression, type ProgressionData, ProgressionOptions, ReduceProgressionOptions, ReducedChord, ResolvedKey, Rhythm, type RhythmData, type RhythmDeformOptions, RhythmEvent, RhythmOptions, RomanExplanation, SafetyQuery, SafetyResult, ScaleChoice, ScaleName, ScaleNameInput, ScaleSystem, Score, type ScoreData, type ScoreOptions, Species, SpeciesOptions, SpelledDuration, SpelledInterval, SpelledKeyLike, StringFingering, StructuralCadence, StyledVoicingOptions, SubstituteOptions, Substitution, SubstitutionType, Tempo, type TempoData, TempoMap, TensionPoint, TimeSignature, Timeline, type TimelineData, type TimelineRoman, TrackEdit, TransposingInstrument, Tuning, TuningTable, Tuplet, Vocabulary, VoiceIndependenceOptions, VoiceIndependenceReport, VoiceRange, Voicing, type VoicingData, type VoicingIndependenceOptions, VoicingOptions, type VoicingSafetyQuery };
+export { AnalyzeChordOptions, AnalyzedNote, Arrangement, ArrangementAnalysis, type ArrangementData, ArrangementOptions, type ArrangementSettings, type ArrangementSetup, type ArrangementTensionOptions, ArrangementTrack, Articulation, AugmentedSixthKind, AvailableTensionsOptions, AvoidNotesOptions, BarPosition, BassLineOptions, type BassLineSettings, BassSegment, BorrowedChord, BorrowedSource, CadenceHit, CadenceResult, Chord, ChordAnalysis, Chord$1 as ChordData, ChordLike, ChordMatch, ChordQuality, ChordScaleMatch, ChordScaleReportEntry, ChordSegment, ChordSpan, ChordSpec, ChordSymbolOptions, ChordTimeline, ChordTimelineOptions, ChordToRomanOptions, ChordToneRole, Complexity, Composer, type ComposerOptions, CompositionEvaluation, CompositionPlan, CompositionPlanOptions, Conflict, CounterMelodyOptions, type CounterMelodySettings, DetectCadenceOptions, DetectChordOptions, DetectKeyOptions, type DetectedKeyMatch, DrumsOptions, Duration, DurationData, EvaluateCompositionOptions, EvaluateSafetyOptions, ExplainRomanOptions, ExtractMotifsOptions, FormSection, FormSectionOptions, GenerationContext, GenerationContextInput, GrooveTemplate, HarmonicFunction, HarmonizeOptions, type HarmonizedMelody, HumanizeOptions, Hypermeter, HypermeterOptions, IdentifiedVoiceNote, Instrument, InstrumentProfile, InstrumentProfileLike, Interval, IntervalData, IntervalLike, IntervalQualityLabel, Key, type KeyData, KeyLike, KeyMatch, KeyMode, KeyRegion, KeyRelation, KeyScale, KeyTimelineOptions, KeyVariant, MelodicContour, MelodyOptions, Meter, MeterLike, MeterMap, Motif, MotifCell, MotifContour, MotifData, type MotifGenerateOptions, MotifGraph, MotifGraphOptions, MotifNote, MotifRelation, MotifTransform, Note, Note$1 as NoteData, NoteEvent, NoteEventIndex, NoteEventIndexOptions, NoteLike, NoteNameOptions, NoteValue, OrnamentOptions, ParseResult, PartWritingOptions, PartWritingViolation, Phrase, PhraseOptions, PlayabilityReport, PositionalRng, Progression, type ProgressionData, ProgressionOptions, ReduceProgressionOptions, ReducedChord, ReferenceProfile, ReferenceProfileOptions, ResolvedKey, Rhythm, RhythmAnalysis, RhythmAnalysisOptions, type RhythmData, type RhythmDeformOptions, RhythmEvent, RhythmOptions, RomanExplanation, SafetyQuery, SafetyResult, ScaleChoice, ScaleName, ScaleNameInput, ScaleSystem, Score, type ScoreData, type ScoreOptions, Species, SpeciesOptions, SpelledDuration, SpelledInterval, SpelledKeyLike, StringFingering, StructuralCadence, StyledVoicingOptions, SubstituteOptions, Substitution, SubstitutionType, Tempo, type TempoData, TempoMap, TensionPoint, TimeSignature, Timeline, type TimelineData, type TimelineRoman, TrackEdit, TransposingInstrument, Tuning, TuningTable, Tuplet, Vocabulary, VoiceIndependenceOptions, VoiceIndependenceReport, VoiceRange, Voicing, type VoicingData, type VoicingIndependenceOptions, VoicingOptions, type VoicingSafetyQuery };