@libraz/libcantus 1.1.0 → 1.3.0

package/README.md

@@ -35,6 +35,10 @@ Composer.of({ key: chords.key, bpm: 120, seed: 1 }).bass(chords, { style: 'walki
 
 Chord boundaries are searched for rather than assumed, and so is the key, so a piece that modulates is not read against the key it started in. Answers carry their evidence: a chord analysis, a cadence and a Roman numeral each come with a `rationale` and the readings they turned down, and where the input cannot settle a question the field comes back `null` rather than a plausible guess.
 
+Another piece is read the same way and measured against the first dimension by dimension — form, harmony, motif derivation, rhythm — never folded into one score: `analyzeReference` compresses a piece into a portable profile, and `compareReferences` reads two of them against each other.
+
+That same profile doubles as a target for new material: `deriveCompositionPlan` turns it into a `CompositionPlan` — form, harmony and a motif derivation forest stated as instructions a generator can follow exactly — and `generateMelody` writes a melody to it, with `evaluateComposition` reading the result back against the plan. See [Generating from a reference](https://github.com/libraz/libcantus/blob/main/docs/en/generation.md#generating-from-a-reference).
+
 ## Use cases
 
 | Use case | What it does | Worked guide |

package/README_ja.md

@@ -35,6 +35,10 @@ Composer.of({ key: chords.key, bpm: 120, seed: 1 }).bass(chords, { style: 'walki
 
 コードの境界は決め打ちせずに探索し、キーも同様に探します。転調する曲を、冒頭のキーのまま読み続けることはありません。答えには根拠が伴います。コード分析・終止・ローマ数字はいずれも `rationale` と、退けた候補を併せて返し、入力だけでは決まらない項目は、もっともらしい推測ではなく `null` を返します。
 
+もう1曲も同じように読み取り、フォーム・和声・モチーフの派生・リズムを次元ごとに比較できます。単一のスコアにまとめることはありません。`analyzeReference` が曲を持ち運び可能なプロファイルに圧縮し、`compareReferences` がその2つを突き合わせます。
+
+そのプロファイルは、新しい素材を書くための目標にもなります。`deriveCompositionPlan` はプロファイルを `CompositionPlan` に変換します。フォーム・和声・モチーフの派生の森を、ジェネレータがそのまま辿れる指示として持つ値です。`generateMelody` はその計画に沿って旋律を書き、`evaluateComposition` は結果を計画に照らして読み返します。[リファレンスからの生成](https://github.com/libraz/libcantus/blob/main/docs/ja/generation.md#リファレンスからの生成)を参照してください。
+
 ## ユースケース
 
 | ユースケース | 内容 | 実例のガイド |

package/dist/analyze/index.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkQCXYKSZScjs = require('../chunk-QCXYKSZS.cjs');
+var _chunkPWC4CRWTcjs = require('../chunk-PWC4CRWT.cjs');
 
 
 
@@ -13,12 +13,12 @@ var _chunkQCXYKSZScjs = require('../chunk-QCXYKSZS.cjs');
 
 
 
+var _chunkYFA7X2F6cjs = require('../chunk-YFA7X2F6.cjs');
 
 
 
 
 
-var _chunkXVMJO3QFcjs = require('../chunk-XVMJO3QF.cjs');
 
 
 
@@ -52,12 +52,8 @@ var _chunkXVMJO3QFcjs = require('../chunk-XVMJO3QF.cjs');
 
 
 
-var _chunkQ6R3QAZDcjs = require('../chunk-Q6R3QAZD.cjs');
-require('../chunk-TT6PKMPR.cjs');
 
 
-var _chunkYPB3A3EYcjs = require('../chunk-YPB3A3EY.cjs');
-require('../chunk-XKSO2V5I.cjs');
 
 
 
@@ -68,8 +64,12 @@ require('../chunk-XKSO2V5I.cjs');
 
 
 
+var _chunkIFZDWIKMcjs = require('../chunk-IFZDWIKM.cjs');
+require('../chunk-35NBV2FT.cjs');
 
 
+var _chunk3R3QVKY5cjs = require('../chunk-3R3QVKY5.cjs');
+require('../chunk-S5BKZZGM.cjs');
 
 
 
@@ -109,5 +109,29 @@ require('../chunk-XKSO2V5I.cjs');
 
 
 
-exports.MODAL_SCALE_NAMES = _chunkQ6R3QAZDcjs.MODAL_SCALE_NAMES; exports.NoteSafety = _chunkYPB3A3EYcjs.NoteSafety; exports.analyzeArrangement = _chunkXVMJO3QFcjs.analyzeArrangement; exports.analyzeChord = _chunkQ6R3QAZDcjs.analyzeChord; exports.analyzePolyphony = _chunkXVMJO3QFcjs.analyzePolyphony; exports.analyzeVoice = _chunkQ6R3QAZDcjs.analyzeVoice; exports.assertChordTimeline = _chunkQ6R3QAZDcjs.assertChordTimeline; exports.augmentedSixthChord = _chunkQ6R3QAZDcjs.augmentedSixthChord; exports.augmentedSixthFromPitchClasses = _chunkQ6R3QAZDcjs.augmentedSixthFromPitchClasses; exports.augmentedSixthKind = _chunkQ6R3QAZDcjs.augmentedSixthKind; exports.borrowedSource = _chunkQ6R3QAZDcjs.borrowedSource; exports.chordTimelineFromChords = _chunkQ6R3QAZDcjs.chordTimelineFromChords; exports.chordTimelineFromNotes = _chunkQ6R3QAZDcjs.chordTimelineFromNotes; exports.chordToRoman = _chunkQ6R3QAZDcjs.chordToRoman; exports.compareMelodies = _chunkXVMJO3QFcjs.compareMelodies; exports.createArrangementSession = _chunkXVMJO3QFcjs.createArrangementSession; exports.detectCadence = _chunkQ6R3QAZDcjs.detectCadence; exports.detectCadences = _chunkQ6R3QAZDcjs.detectCadences; exports.detectChord = _chunkQ6R3QAZDcjs.detectChord; exports.detectChordBest = _chunkQ6R3QAZDcjs.detectChordBest; exports.detectKey = _chunkQ6R3QAZDcjs.detectKey; exports.detectKeyBest = _chunkQ6R3QAZDcjs.detectKeyBest; exports.detectKeyFromNotes = _chunkQ6R3QAZDcjs.detectKeyFromNotes; exports.detectModulations = _chunkQ6R3QAZDcjs.detectModulations; exports.explainRoman = _chunkQ6R3QAZDcjs.explainRoman; exports.extractMotifs = _chunkXVMJO3QFcjs.extractMotifs; exports.functionOf = _chunkQ6R3QAZDcjs.functionOf; exports.hypermeter = _chunkXVMJO3QFcjs.hypermeter; exports.isBorrowedChord = _chunkQ6R3QAZDcjs.isBorrowedChord; exports.isDiatonic = _chunkQ6R3QAZDcjs.isDiatonic; exports.isMinorKey = _chunkQ6R3QAZDcjs.isMinorKey; exports.keyTimelineFromNotes = _chunkQ6R3QAZDcjs.keyTimelineFromNotes; exports.melodicContour = _chunkXVMJO3QFcjs.melodicContour; exports.melodicSimilarity = _chunkXVMJO3QFcjs.melodicSimilarity; exports.motifFromNotes = _chunkXVMJO3QFcjs.motifFromNotes; exports.phrasesFromTimeline = _chunkXVMJO3QFcjs.phrasesFromTimeline; exports.pivotChords = _chunkQ6R3QAZDcjs.pivotChords; exports.prevailingKeyOf = _chunkQ6R3QAZDcjs.prevailingKeyOf; exports.reduceProgression = _chunkXVMJO3QFcjs.reduceProgression; exports.relateMotifs = _chunkXVMJO3QFcjs.relateMotifs; exports.romanToChord = _chunkQ6R3QAZDcjs.romanToChord; exports.secondaryDominant = _chunkQ6R3QAZDcjs.secondaryDominant; exports.secondaryDominantOf = _chunkQ6R3QAZDcjs.secondaryDominantOf; exports.sectionsFromNotes = _chunkXVMJO3QFcjs.sectionsFromNotes; exports.spellAugmentedSixth = _chunkQ6R3QAZDcjs.spellAugmentedSixth; exports.spellLine = _chunkQCXYKSZScjs.spellLine; exports.structuralCadences = _chunkXVMJO3QFcjs.structuralCadences; exports.tensionCurve = _chunkXVMJO3QFcjs.tensionCurve; exports.tensionCurveFrom = _chunkXVMJO3QFcjs.tensionCurveFrom; exports.toVoiceNotes = _chunkQ6R3QAZDcjs.toVoiceNotes;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.CADENCE_TYPES = _chunkIFZDWIKMcjs.CADENCE_TYPES; exports.HARMONIC_FUNCTIONS = _chunkIFZDWIKMcjs.HARMONIC_FUNCTIONS; exports.MELODIC_CONTOUR_SHAPES = _chunkIFZDWIKMcjs.MELODIC_CONTOUR_SHAPES; exports.MODAL_SCALE_NAMES = _chunkIFZDWIKMcjs.MODAL_SCALE_NAMES; exports.MOTIF_RELATION_KINDS = _chunkIFZDWIKMcjs.MOTIF_RELATION_KINDS; exports.NoteSafety = _chunk3R3QVKY5cjs.NoteSafety; exports.REDUCTION_LEVELS = _chunkIFZDWIKMcjs.REDUCTION_LEVELS; exports.REFERENCE_PROFILE_VERSION = _chunkIFZDWIKMcjs.REFERENCE_PROFILE_VERSION; exports.RHYTHM_IOI_BINS = _chunkIFZDWIKMcjs.RHYTHM_IOI_BINS; exports.analyzeArrangement = _chunkYFA7X2F6cjs.analyzeArrangement; exports.analyzeChord = _chunkIFZDWIKMcjs.analyzeChord; exports.analyzePolyphony = _chunkYFA7X2F6cjs.analyzePolyphony; exports.analyzeReference = _chunkYFA7X2F6cjs.analyzeReference; exports.analyzeRhythm = _chunkIFZDWIKMcjs.analyzeRhythm; exports.analyzeVoice = _chunkIFZDWIKMcjs.analyzeVoice; exports.assertChordTimeline = _chunkIFZDWIKMcjs.assertChordTimeline; exports.assertReferenceProfile = _chunkIFZDWIKMcjs.assertReferenceProfile; exports.augmentedSixthChord = _chunkIFZDWIKMcjs.augmentedSixthChord; exports.augmentedSixthFromPitchClasses = _chunkIFZDWIKMcjs.augmentedSixthFromPitchClasses; exports.augmentedSixthKind = _chunkIFZDWIKMcjs.augmentedSixthKind; exports.borrowedSource = _chunkIFZDWIKMcjs.borrowedSource; exports.chordTimelineFromChords = _chunkIFZDWIKMcjs.chordTimelineFromChords; exports.chordTimelineFromNotes = _chunkIFZDWIKMcjs.chordTimelineFromNotes; exports.chordToRoman = _chunkIFZDWIKMcjs.chordToRoman; exports.compareMelodies = _chunkIFZDWIKMcjs.compareMelodies; exports.compareReferences = _chunkYFA7X2F6cjs.compareReferences; exports.createArrangementSession = _chunkYFA7X2F6cjs.createArrangementSession; exports.detectCadence = _chunkIFZDWIKMcjs.detectCadence; exports.detectCadences = _chunkIFZDWIKMcjs.detectCadences; exports.detectChord = _chunkIFZDWIKMcjs.detectChord; exports.detectChordBest = _chunkIFZDWIKMcjs.detectChordBest; exports.detectKey = _chunkIFZDWIKMcjs.detectKey; exports.detectKeyBest = _chunkIFZDWIKMcjs.detectKeyBest; exports.detectKeyFromNotes = _chunkIFZDWIKMcjs.detectKeyFromNotes; exports.detectModulations = _chunkIFZDWIKMcjs.detectModulations; exports.explainRoman = _chunkIFZDWIKMcjs.explainRoman; exports.extractMotifs = _chunkIFZDWIKMcjs.extractMotifs; exports.functionOf = _chunkIFZDWIKMcjs.functionOf; exports.hypermeter = _chunkYFA7X2F6cjs.hypermeter; exports.isBorrowedChord = _chunkIFZDWIKMcjs.isBorrowedChord; exports.isDiatonic = _chunkIFZDWIKMcjs.isDiatonic; exports.isMinorKey = _chunkIFZDWIKMcjs.isMinorKey; exports.keyTimelineFromNotes = _chunkIFZDWIKMcjs.keyTimelineFromNotes; exports.melodicContour = _chunkIFZDWIKMcjs.melodicContour; exports.melodicSimilarity = _chunkIFZDWIKMcjs.melodicSimilarity; exports.motifFromNotes = _chunkIFZDWIKMcjs.motifFromNotes; exports.motifGraph = _chunkIFZDWIKMcjs.motifGraph; exports.phrasesFromTimeline = _chunkYFA7X2F6cjs.phrasesFromTimeline; exports.pivotChords = _chunkIFZDWIKMcjs.pivotChords; exports.prevailingKeyOf = _chunkIFZDWIKMcjs.prevailingKeyOf; exports.reduceProgression = _chunkIFZDWIKMcjs.reduceProgression; exports.relateMotifs = _chunkIFZDWIKMcjs.relateMotifs; exports.romanToChord = _chunkIFZDWIKMcjs.romanToChord; exports.secondaryDominant = _chunkIFZDWIKMcjs.secondaryDominant; exports.secondaryDominantOf = _chunkIFZDWIKMcjs.secondaryDominantOf; exports.sectionsFromNotes = _chunkYFA7X2F6cjs.sectionsFromNotes; exports.spellAugmentedSixth = _chunkIFZDWIKMcjs.spellAugmentedSixth; exports.spellLine = _chunkPWC4CRWTcjs.spellLine; exports.structuralCadences = _chunkYFA7X2F6cjs.structuralCadences; exports.tensionCurve = _chunkYFA7X2F6cjs.tensionCurve; exports.tensionCurveFrom = _chunkYFA7X2F6cjs.tensionCurveFrom; exports.toVoiceNotes = _chunkIFZDWIKMcjs.toVoiceNotes;
 //# sourceMappingURL=index.cjs.map

package/dist/analyze/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/libcantus/libcantus/dist/analyze/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,+/FAAC","file":"/home/runner/work/libcantus/libcantus/dist/analyze/index.cjs"}
+{"version":3,"sources":["/home/runner/work/libcantus/libcantus/dist/analyze/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,ixHAAC","file":"/home/runner/work/libcantus/libcantus/dist/analyze/index.cjs"}

package/dist/analyze/index.d.cts

@@ -1,13 +1,12 @@
 import { i as NoteLike, h as NoteEvent, g as Note } from '../index-Cy15oTvh.cjs';
 export { a as Articulation, I as IntervalData, c as IntervalQualityLabel, e as KeyScale, S as SpelledInterval } from '../index-Cy15oTvh.cjs';
-export { M as MeterChange, b as MeterLike, c as MeterMap, T as TimeSignature } from '../index-D_hzxD8w.cjs';
-import { q as SpelledKeyLike } from '../coerce-CJlgULrQ.cjs';
-export { b as ChordData, c as ChordLike, d as ChordQuality, e as ChordSegment, g as ChordSpan, i as ChordToneRole, K as KeyLike, j as KeyRelation, k as KeyVariant, N as NoteSafety, l as PitchSpelling, n as ResolvedKey, S as SafetyProfile, r as SpelledKeyScale, V as VoiceSnapshot } from '../coerce-CJlgULrQ.cjs';
-export { r as ScaleName } from '../masks-C8TWLFIi.cjs';
-import { e as ChordTimeline } from '../index-B3WCj_Hm.cjs';
-export { A as AnalyzeChordOptions, a as AnalyzedNote, B as BorrowedSource, C as CadenceHit, b as CadenceResult, c as ChordAnalysis, d as ChordSegmentation, f as ChordTimelineOptions, g as ChordTimelineResult, h as ChordToRomanOptions, D as DetectCadenceOptions, E as ExplainRomanOptions, H as HarmonicFunction, I as IdentifiedVoiceNote, K as KeyContext, i as KeyProfileName, j as KeyProfilePair, k as KeyRegion, l as KeyTimelineOptions, P as PivotChord, R as RejectedCandidate, m as RomanExplanation, S as SuspensionFigure, T as TheoryLabel, V as VoiceNote, n as analyzeChord, o as analyzeVoice, p as assertChordTimeline, q as borrowedSource, r as chordTimelineFromChords, s as chordTimelineFromNotes, t as chordToRoman, u as detectCadence, v as detectCadences, w as detectModulations, x as explainRoman, y as functionOf, z as isBorrowedChord, F as isDiatonic, G as isMinorKey, J as keyTimelineFromNotes, L as pivotChords, M as prevailingKeyOf, N as romanToChord, O as secondaryDominant, Q as secondaryDominantOf, U as toVoiceNotes } from '../index-B3WCj_Hm.cjs';
-import { l as MelodicPhrase } from '../index-DTsKaPaC.cjs';
-export { A as ArrangementAnalysis, a as ArrangementOptions, b as ArrangementSession, c as ArrangementTrack, d as AugmentedSixthKind, C as ChordMatch, e as Conflict, f as ContourDirection, D as DetectChordOptions, g as DetectKeyOptions, E as ExtractMotifsOptions, F as FormSection, h as FormSectionOptions, H as Hypermeter, i as HypermeterOptions, K as KeyMatch, M as MODAL_SCALE_NAMES, j as MelodicContour, k as MelodicContourShape, m as ModalCandidate, n as ModalScaleName, o as MotifData, p as MotifOccurrence, q as MotifRelation, r as MotifRelationKind, P as Phrase, s as PhraseOptions, t as PhraseSignal, R as ReduceProgressionOptions, u as ReducedChord, v as ReductionBasis, w as ReductionLevel, S as StructuralCadence, T as TensionPoint, x as TrackAnalysis, y as TrackEdit, z as TrackRole, B as analyzeArrangement, G as analyzePolyphony, I as augmentedSixthChord, J as augmentedSixthFromPitchClasses, L as augmentedSixthKind, N as createArrangementSession, O as detectChord, Q as detectChordBest, U as detectKey, V as detectKeyBest, W as detectKeyFromNotes, X as extractMotifs, Y as hypermeter, Z as melodicContour, _ as motifFromNotes, $ as phrasesFromTimeline, a0 as reduceProgression, a1 as relateMotifs, a2 as sectionsFromNotes, a3 as spellAugmentedSixth, a4 as structuralCadences, a5 as tensionCurve, a6 as tensionCurveFrom } from '../index-DTsKaPaC.cjs';
+export { M as MeterChange, b as MeterLike, c as MeterMap, T as TimeSignature } from '../index-BMweUlm5.cjs';
+import { r as SpelledKeyLike } from '../coerce-DRERzdve.cjs';
+export { b as ChordData, c as ChordLike, d as ChordQuality, e as ChordSegment, g as ChordSpan, i as ChordToneRole, K as KeyLike, j as KeyRelation, k as KeyVariant, N as NoteSafety, l as PitchSpelling, n as ResolvedKey, o as SafetyProfile, s as SpelledKeyScale, V as VoiceSnapshot } from '../coerce-DRERzdve.cjs';
+export { r as ScaleName } from '../masks-pADfTOiD.cjs';
+import { w as MelodicPhrase, a5 as ReferenceProfile, h as ChordTimeline } from '../types-D-XgxGvp.cjs';
+export { A as AnalyzeChordOptions, a as AnalyzedNote, B as BarPositionProfile, b as BorrowedSource, C as CADENCE_TYPES, c as CadenceHit, d as CadenceResult, e as CadenceType, f as ChordAnalysis, g as ChordSegmentation, i as ChordTimelineOptions, j as ChordTimelineResult, k as ChordToRomanOptions, l as ContourDirection, D as DetectCadenceOptions, E as ExplainRomanOptions, m as ExtractMotifsOptions, F as FormSection, n as FormSectionOptions, H as HARMONIC_FUNCTIONS, o as HarmonicFunction, I as IdentifiedVoiceNote, K as KeyContext, p as KeyProfileName, q as KeyProfilePair, r as KeyRegion, s as KeyTimelineOptions, M as MELODIC_CONTOUR_SHAPES, t as MOTIF_RELATION_KINDS, u as MelodicContour, v as MelodicContourShape, x as MotifData, y as MotifGraph, z as MotifGraphEdge, G as MotifGraphNode, J as MotifGraphOptions, L as MotifOccurrence, N as MotifRelation, O as MotifRelationKind, P as MotifRelationSummary, Q as PivotChord, R as REDUCTION_LEVELS, S as REFERENCE_PROFILE_VERSION, T as RHYTHM_IOI_BINS, U as ReduceProgressionOptions, V as ReducedChord, 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, a7 as RhythmAnalysis, a8 as RhythmAnalysisOptions, a9 as RomanExplanation, aa as SuspensionFigure, ab as TheoryLabel, ac as VoiceNote, ad as analyzeChord, ae as analyzeRhythm, af as analyzeVoice, ag as assertChordTimeline, ah as borrowedSource, ai as chordTimelineFromChords, aj as chordTimelineFromNotes, ak as chordToRoman, al as detectCadence, am as detectCadences, an as detectModulations, ao as explainRoman, ap as extractMotifs, aq as functionOf, ar as isBorrowedChord, as as isDiatonic, at as isMinorKey, au as keyTimelineFromNotes, av as melodicContour, aw as motifFromNotes, ax as motifGraph, ay as pivotChords, az as prevailingKeyOf, aA as reduceProgression, aB as relateMotifs, aC as romanToChord, aD as secondaryDominant, aE as secondaryDominantOf, aF as sectionsFromNotes, aG as toVoiceNotes } from '../types-D-XgxGvp.cjs';
+export { A as ArrangementAnalysis, a as ArrangementOptions, b as ArrangementSession, c as ArrangementTrack, d as AugmentedSixthKind, C as ChordMatch, e as Conflict, f as ConflictPartner, D as DetectChordOptions, g as DetectKeyOptions, H as Hypermeter, h as HypermeterOptions, K as KeyMatch, M as MODAL_SCALE_NAMES, i as ModalCandidate, j as ModalScaleName, P as Phrase, k as PhraseOptions, l as PhraseSignal, R as ReferenceProfileOptions, S as StructuralCadence, T as TensionPoint, m as TrackAnalysis, n as TrackEdit, o as TrackRole, p as analyzeArrangement, q as analyzePolyphony, r as analyzeReference, s as augmentedSixthChord, t as augmentedSixthFromPitchClasses, u as augmentedSixthKind, v as createArrangementSession, w as detectChord, x as detectChordBest, y as detectKey, z as detectKeyBest, B as detectKeyFromNotes, E as hypermeter, F as phrasesFromTimeline, G as spellAugmentedSixth, I as structuralCadences, J as tensionCurve, L as tensionCurveFrom } from '../profile-CQMEqdH9.cjs';
 
 /**
  * How alike two phrases are, when they stand in no named relation.
@@ -95,6 +94,153 @@ declare function compareMelodies(a: MelodicPhrase, b: MelodicPhrase): MelodicCom
  */
 declare function melodicSimilarity(a: MelodicPhrase, b: MelodicPhrase): number;
 
+/**
+ * Comparing two {@link ReferenceProfile}s dimension by dimension.
+ *
+ * The answer is never folded into one number: each field names the aspect it
+ * measures, so "a different song built the same way" reads as high structural
+ * fields beside a low surface one. Only `melody.surfaceSimilarity` reads the
+ * motifs' intervals; every other field is invariant under transposition, tempo
+ * and a change of motif intervals.
+ */
+
+/**
+ * Options for {@link compareReferences}.
+ *
+ * @category Arrangement & Analysis
+ */
+type ReferenceComparisonOptions = {
+    /**
+     * Upper bound on the cells of the progression alignment.
+     *
+     * @defaultValue {@link DEFAULT_GENERATION_BUDGET}
+     */
+    budget?: number;
+};
+/**
+ * How alike two profiled pieces are, one field per aspect.
+ *
+ * Every value is in [0, 1] and symmetric in the two profiles. A value is
+ * `null` when neither profile has anything to measure it on, and 0 when only
+ * one does.
+ *
+ * @category Arrangement & Analysis
+ */
+type ReferenceComparison = {
+    /** Formal layout. */
+    form: {
+        /** Likeness of the section-label sequences. */
+        sectionSequenceSimilarity: number | null;
+        /** Likeness of the phrase-length sequences. */
+        phraseLengthSimilarity: number | null;
+    };
+    /** Harmony. */
+    harmony: {
+        /** Likeness of the structural Roman-numeral progressions. */
+        progressionSimilarity: number | null;
+        /** Likeness of how long each harmonic function is held. */
+        functionSimilarity: number | null;
+        /** Likeness of the phrase-by-phrase cadence sequences. */
+        cadenceSimilarity: number | null;
+        /** Likeness of the key plans, read relative to each piece's first key. */
+        keyPlanSimilarity: number | null;
+        /** Likeness of where in the bar the chords change. */
+        harmonicRhythmOnsetSimilarity: number | null;
+        /** Likeness of how often the chords change. */
+        harmonicRhythmDensitySimilarity: number | null;
+    };
+    /** Melody. */
+    melody: {
+        /** Likeness of the motifs' interval content: the one field that reads the surface. */
+        surfaceSimilarity: number | null;
+        /** Likeness of how the motifs derive from one another. */
+        motifStructureSimilarity: number | null;
+        /** Likeness of the phrases' melodic outlines, each scaled by its own range. */
+        contourSimilarity: number | null;
+        /** Likeness of the phrases' registers, each relative to its piece's melodic mean. */
+        registerSimilarity: number | null;
+    };
+    /** Melodic rhythm. */
+    rhythm: {
+        /** Likeness of where in the bar the melody's onsets fall. */
+        onsetSimilarity: number | null;
+        /** Likeness of the melodies' onsets per bar. */
+        densitySimilarity: number | null;
+        /** Likeness of the melodies' inter-onset-interval distributions. */
+        durationSimilarity: number | null;
+        /** Likeness of the melodies' syncopation. */
+        syncopationSimilarity: number | null;
+    };
+    /** The two most and the two least alike fields, by name. */
+    rationale: string;
+};
+/**
+ * Compare two profiled pieces aspect by aspect: form, harmony, melody and
+ * melodic rhythm.
+ *
+ * Sequences — sections, phrase lengths, cadences, key plans, structural
+ * chords, phrase contours and registers — are aligned by a graded edit
+ * distance; distributions — harmonic function, onset placement, inter-onset
+ * intervals, motif derivations — by histogram intersection. The surface field
+ * compares the motifs' interval cells, so a transposition of the same piece
+ * reads 1 on every field. No aggregate is returned: which aspects agree is the
+ * answer.
+ *
+ * @param a The first profile.
+ * @param b The second profile.
+ * @param opts The work budget.
+ * @returns One likeness per aspect, and a rationale naming the extremes.
+ * @throws {InvalidInputError} If either profile or the options cannot be read.
+ * @throws {BudgetExceededError} If the progression alignment would exceed the budget.
+ * @category Arrangement & Analysis
+ */
+declare function compareReferences(a: ReferenceProfile, b: ReferenceProfile, opts?: ReferenceComparisonOptions): ReferenceComparison;
+
+/**
+ * Boundary validation for {@link ReferenceProfile}: a caller can hand this a
+ * value restored from JSON, a config file, or a plugin host, and every field
+ * is checked before anything downstream 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 ReferenceProfile}.
+ *
+ * A profile 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. Every field is checked before {@link compareReferences} or
+ * a caller's own code 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 profile.
+ * @throws {InvalidInputError} If the value is not a valid reference profile.
+ * @example
+ * ```ts
+ * import { assertReferenceProfile } from '@libraz/libcantus';
+ * const emptyRhythm = {
+ *   startBeat: 0, endBeat: 0, bars: 0, onsets: 0, onsetDensity: 0,
+ *   barOnsets: [], onsetLevels: [0, 0, 0, 0, 0, 0], barPositions: [],
+ *   interOnsetShares: new Array(17).fill(0), restRatio: 0, syncopation: 0,
+ *   offGridRatio: 0, rationale: 'nothing sounds',
+ * };
+ * const profile = {
+ *   profileVersion: 1,
+ *   span: { startBeat: 0, endBeat: 0, bars: 0 },
+ *   meters: [{ startBeat: 0, ts: { numerator: 4, denominator: 4 } }],
+ *   form: { hypermeter: { groupBars: 1, confidence: 0 }, sections: [], phrases: [] },
+ *   harmony: { keys: [], chords: [], rhythm: emptyRhythm },
+ *   melody: { register: null, shape: null, motifs: [], graph: { nodes: [], edges: [] }, rhythm: emptyRhythm },
+ * };
+ * assertReferenceProfile(profile); // the profile, unchanged
+ * ```
+ * @category Arrangement & Analysis
+ */
+declare function assertReferenceProfile(value: unknown, name?: string): ReferenceProfile;
+
 /**
  * Line spelling: name every note of a melodic line in one pass.
  *
@@ -190,4 +336,4 @@ type SpellLineOptions = {
  */
 declare function spellLine(notes: readonly NoteEvent[], timeline: ChordTimeline | null, key: SpelledKeyLike, opts?: SpellLineOptions): Note[];
 
-export { ChordTimeline, type MelodicComparison, MelodicPhrase, Note as NoteData, NoteEvent, NoteLike, type SpellLineOptions, SpelledKeyLike, compareMelodies, melodicSimilarity, spellLine };
+export { ChordTimeline, type MelodicComparison, MelodicPhrase, Note as NoteData, NoteEvent, NoteLike, type ReferenceComparison, type ReferenceComparisonOptions, ReferenceProfile, type SpellLineOptions, SpelledKeyLike, assertReferenceProfile, compareMelodies, compareReferences, melodicSimilarity, spellLine };

package/dist/analyze/index.d.ts

@@ -1,13 +1,12 @@
 import { i as NoteLike, h as NoteEvent, g as Note } from '../index-Cy15oTvh.js';
 export { a as Articulation, I as IntervalData, c as IntervalQualityLabel, e as KeyScale, S as SpelledInterval } from '../index-Cy15oTvh.js';
-export { M as MeterChange, b as MeterLike, c as MeterMap, T as TimeSignature } from '../index-Ci3xyows.js';
-import { q as SpelledKeyLike } from '../coerce-wwdELNYS.js';
-export { b as ChordData, c as ChordLike, d as ChordQuality, e as ChordSegment, g as ChordSpan, i as ChordToneRole, K as KeyLike, j as KeyRelation, k as KeyVariant, N as NoteSafety, l as PitchSpelling, n as ResolvedKey, S as SafetyProfile, r as SpelledKeyScale, V as VoiceSnapshot } from '../coerce-wwdELNYS.js';
-export { r as ScaleName } from '../masks-O73Rhj5d.js';
-import { e as ChordTimeline } from '../index-BpWOhkkE.js';
-export { A as AnalyzeChordOptions, a as AnalyzedNote, B as BorrowedSource, C as CadenceHit, b as CadenceResult, c as ChordAnalysis, d as ChordSegmentation, f as ChordTimelineOptions, g as ChordTimelineResult, h as ChordToRomanOptions, D as DetectCadenceOptions, E as ExplainRomanOptions, H as HarmonicFunction, I as IdentifiedVoiceNote, K as KeyContext, i as KeyProfileName, j as KeyProfilePair, k as KeyRegion, l as KeyTimelineOptions, P as PivotChord, R as RejectedCandidate, m as RomanExplanation, S as SuspensionFigure, T as TheoryLabel, V as VoiceNote, n as analyzeChord, o as analyzeVoice, p as assertChordTimeline, q as borrowedSource, r as chordTimelineFromChords, s as chordTimelineFromNotes, t as chordToRoman, u as detectCadence, v as detectCadences, w as detectModulations, x as explainRoman, y as functionOf, z as isBorrowedChord, F as isDiatonic, G as isMinorKey, J as keyTimelineFromNotes, L as pivotChords, M as prevailingKeyOf, N as romanToChord, O as secondaryDominant, Q as secondaryDominantOf, U as toVoiceNotes } from '../index-BpWOhkkE.js';
-import { l as MelodicPhrase } from '../index-BUtIf2go.js';
-export { A as ArrangementAnalysis, a as ArrangementOptions, b as ArrangementSession, c as ArrangementTrack, d as AugmentedSixthKind, C as ChordMatch, e as Conflict, f as ContourDirection, D as DetectChordOptions, g as DetectKeyOptions, E as ExtractMotifsOptions, F as FormSection, h as FormSectionOptions, H as Hypermeter, i as HypermeterOptions, K as KeyMatch, M as MODAL_SCALE_NAMES, j as MelodicContour, k as MelodicContourShape, m as ModalCandidate, n as ModalScaleName, o as MotifData, p as MotifOccurrence, q as MotifRelation, r as MotifRelationKind, P as Phrase, s as PhraseOptions, t as PhraseSignal, R as ReduceProgressionOptions, u as ReducedChord, v as ReductionBasis, w as ReductionLevel, S as StructuralCadence, T as TensionPoint, x as TrackAnalysis, y as TrackEdit, z as TrackRole, B as analyzeArrangement, G as analyzePolyphony, I as augmentedSixthChord, J as augmentedSixthFromPitchClasses, L as augmentedSixthKind, N as createArrangementSession, O as detectChord, Q as detectChordBest, U as detectKey, V as detectKeyBest, W as detectKeyFromNotes, X as extractMotifs, Y as hypermeter, Z as melodicContour, _ as motifFromNotes, $ as phrasesFromTimeline, a0 as reduceProgression, a1 as relateMotifs, a2 as sectionsFromNotes, a3 as spellAugmentedSixth, a4 as structuralCadences, a5 as tensionCurve, a6 as tensionCurveFrom } from '../index-BUtIf2go.js';
+export { M as MeterChange, b as MeterLike, c as MeterMap, T as TimeSignature } from '../index-CL4b4gUQ.js';
+import { r as SpelledKeyLike } from '../coerce-DP0vYu-x.js';
+export { b as ChordData, c as ChordLike, d as ChordQuality, e as ChordSegment, g as ChordSpan, i as ChordToneRole, K as KeyLike, j as KeyRelation, k as KeyVariant, N as NoteSafety, l as PitchSpelling, n as ResolvedKey, o as SafetyProfile, s as SpelledKeyScale, V as VoiceSnapshot } from '../coerce-DP0vYu-x.js';
+export { r as ScaleName } from '../masks-Cc7-MzzY.js';
+import { w as MelodicPhrase, a5 as ReferenceProfile, h as ChordTimeline } from '../types-Dh7C064C.js';
+export { A as AnalyzeChordOptions, a as AnalyzedNote, B as BarPositionProfile, b as BorrowedSource, C as CADENCE_TYPES, c as CadenceHit, d as CadenceResult, e as CadenceType, f as ChordAnalysis, g as ChordSegmentation, i as ChordTimelineOptions, j as ChordTimelineResult, k as ChordToRomanOptions, l as ContourDirection, D as DetectCadenceOptions, E as ExplainRomanOptions, m as ExtractMotifsOptions, F as FormSection, n as FormSectionOptions, H as HARMONIC_FUNCTIONS, o as HarmonicFunction, I as IdentifiedVoiceNote, K as KeyContext, p as KeyProfileName, q as KeyProfilePair, r as KeyRegion, s as KeyTimelineOptions, M as MELODIC_CONTOUR_SHAPES, t as MOTIF_RELATION_KINDS, u as MelodicContour, v as MelodicContourShape, x as MotifData, y as MotifGraph, z as MotifGraphEdge, G as MotifGraphNode, J as MotifGraphOptions, L as MotifOccurrence, N as MotifRelation, O as MotifRelationKind, P as MotifRelationSummary, Q as PivotChord, R as REDUCTION_LEVELS, S as REFERENCE_PROFILE_VERSION, T as RHYTHM_IOI_BINS, U as ReduceProgressionOptions, V as ReducedChord, 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, a7 as RhythmAnalysis, a8 as RhythmAnalysisOptions, a9 as RomanExplanation, aa as SuspensionFigure, ab as TheoryLabel, ac as VoiceNote, ad as analyzeChord, ae as analyzeRhythm, af as analyzeVoice, ag as assertChordTimeline, ah as borrowedSource, ai as chordTimelineFromChords, aj as chordTimelineFromNotes, ak as chordToRoman, al as detectCadence, am as detectCadences, an as detectModulations, ao as explainRoman, ap as extractMotifs, aq as functionOf, ar as isBorrowedChord, as as isDiatonic, at as isMinorKey, au as keyTimelineFromNotes, av as melodicContour, aw as motifFromNotes, ax as motifGraph, ay as pivotChords, az as prevailingKeyOf, aA as reduceProgression, aB as relateMotifs, aC as romanToChord, aD as secondaryDominant, aE as secondaryDominantOf, aF as sectionsFromNotes, aG as toVoiceNotes } from '../types-Dh7C064C.js';
+export { A as ArrangementAnalysis, a as ArrangementOptions, b as ArrangementSession, c as ArrangementTrack, d as AugmentedSixthKind, C as ChordMatch, e as Conflict, f as ConflictPartner, D as DetectChordOptions, g as DetectKeyOptions, H as Hypermeter, h as HypermeterOptions, K as KeyMatch, M as MODAL_SCALE_NAMES, i as ModalCandidate, j as ModalScaleName, P as Phrase, k as PhraseOptions, l as PhraseSignal, R as ReferenceProfileOptions, S as StructuralCadence, T as TensionPoint, m as TrackAnalysis, n as TrackEdit, o as TrackRole, p as analyzeArrangement, q as analyzePolyphony, r as analyzeReference, s as augmentedSixthChord, t as augmentedSixthFromPitchClasses, u as augmentedSixthKind, v as createArrangementSession, w as detectChord, x as detectChordBest, y as detectKey, z as detectKeyBest, B as detectKeyFromNotes, E as hypermeter, F as phrasesFromTimeline, G as spellAugmentedSixth, I as structuralCadences, J as tensionCurve, L as tensionCurveFrom } from '../profile-DLdlIpS9.js';
 
 /**
  * How alike two phrases are, when they stand in no named relation.
@@ -95,6 +94,153 @@ declare function compareMelodies(a: MelodicPhrase, b: MelodicPhrase): MelodicCom
  */
 declare function melodicSimilarity(a: MelodicPhrase, b: MelodicPhrase): number;
 
+/**
+ * Comparing two {@link ReferenceProfile}s dimension by dimension.
+ *
+ * The answer is never folded into one number: each field names the aspect it
+ * measures, so "a different song built the same way" reads as high structural
+ * fields beside a low surface one. Only `melody.surfaceSimilarity` reads the
+ * motifs' intervals; every other field is invariant under transposition, tempo
+ * and a change of motif intervals.
+ */
+
+/**
+ * Options for {@link compareReferences}.
+ *
+ * @category Arrangement & Analysis
+ */
+type ReferenceComparisonOptions = {
+    /**
+     * Upper bound on the cells of the progression alignment.
+     *
+     * @defaultValue {@link DEFAULT_GENERATION_BUDGET}
+     */
+    budget?: number;
+};
+/**
+ * How alike two profiled pieces are, one field per aspect.
+ *
+ * Every value is in [0, 1] and symmetric in the two profiles. A value is
+ * `null` when neither profile has anything to measure it on, and 0 when only
+ * one does.
+ *
+ * @category Arrangement & Analysis
+ */
+type ReferenceComparison = {
+    /** Formal layout. */
+    form: {
+        /** Likeness of the section-label sequences. */
+        sectionSequenceSimilarity: number | null;
+        /** Likeness of the phrase-length sequences. */
+        phraseLengthSimilarity: number | null;
+    };
+    /** Harmony. */
+    harmony: {
+        /** Likeness of the structural Roman-numeral progressions. */
+        progressionSimilarity: number | null;
+        /** Likeness of how long each harmonic function is held. */
+        functionSimilarity: number | null;
+        /** Likeness of the phrase-by-phrase cadence sequences. */
+        cadenceSimilarity: number | null;
+        /** Likeness of the key plans, read relative to each piece's first key. */
+        keyPlanSimilarity: number | null;
+        /** Likeness of where in the bar the chords change. */
+        harmonicRhythmOnsetSimilarity: number | null;
+        /** Likeness of how often the chords change. */
+        harmonicRhythmDensitySimilarity: number | null;
+    };
+    /** Melody. */
+    melody: {
+        /** Likeness of the motifs' interval content: the one field that reads the surface. */
+        surfaceSimilarity: number | null;
+        /** Likeness of how the motifs derive from one another. */
+        motifStructureSimilarity: number | null;
+        /** Likeness of the phrases' melodic outlines, each scaled by its own range. */
+        contourSimilarity: number | null;
+        /** Likeness of the phrases' registers, each relative to its piece's melodic mean. */
+        registerSimilarity: number | null;
+    };
+    /** Melodic rhythm. */
+    rhythm: {
+        /** Likeness of where in the bar the melody's onsets fall. */
+        onsetSimilarity: number | null;
+        /** Likeness of the melodies' onsets per bar. */
+        densitySimilarity: number | null;
+        /** Likeness of the melodies' inter-onset-interval distributions. */
+        durationSimilarity: number | null;
+        /** Likeness of the melodies' syncopation. */
+        syncopationSimilarity: number | null;
+    };
+    /** The two most and the two least alike fields, by name. */
+    rationale: string;
+};
+/**
+ * Compare two profiled pieces aspect by aspect: form, harmony, melody and
+ * melodic rhythm.
+ *
+ * Sequences — sections, phrase lengths, cadences, key plans, structural
+ * chords, phrase contours and registers — are aligned by a graded edit
+ * distance; distributions — harmonic function, onset placement, inter-onset
+ * intervals, motif derivations — by histogram intersection. The surface field
+ * compares the motifs' interval cells, so a transposition of the same piece
+ * reads 1 on every field. No aggregate is returned: which aspects agree is the
+ * answer.
+ *
+ * @param a The first profile.
+ * @param b The second profile.
+ * @param opts The work budget.
+ * @returns One likeness per aspect, and a rationale naming the extremes.
+ * @throws {InvalidInputError} If either profile or the options cannot be read.
+ * @throws {BudgetExceededError} If the progression alignment would exceed the budget.
+ * @category Arrangement & Analysis
+ */
+declare function compareReferences(a: ReferenceProfile, b: ReferenceProfile, opts?: ReferenceComparisonOptions): ReferenceComparison;
+
+/**
+ * Boundary validation for {@link ReferenceProfile}: a caller can hand this a
+ * value restored from JSON, a config file, or a plugin host, and every field
+ * is checked before anything downstream 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 ReferenceProfile}.
+ *
+ * A profile 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. Every field is checked before {@link compareReferences} or
+ * a caller's own code 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 profile.
+ * @throws {InvalidInputError} If the value is not a valid reference profile.
+ * @example
+ * ```ts
+ * import { assertReferenceProfile } from '@libraz/libcantus';
+ * const emptyRhythm = {
+ *   startBeat: 0, endBeat: 0, bars: 0, onsets: 0, onsetDensity: 0,
+ *   barOnsets: [], onsetLevels: [0, 0, 0, 0, 0, 0], barPositions: [],
+ *   interOnsetShares: new Array(17).fill(0), restRatio: 0, syncopation: 0,
+ *   offGridRatio: 0, rationale: 'nothing sounds',
+ * };
+ * const profile = {
+ *   profileVersion: 1,
+ *   span: { startBeat: 0, endBeat: 0, bars: 0 },
+ *   meters: [{ startBeat: 0, ts: { numerator: 4, denominator: 4 } }],
+ *   form: { hypermeter: { groupBars: 1, confidence: 0 }, sections: [], phrases: [] },
+ *   harmony: { keys: [], chords: [], rhythm: emptyRhythm },
+ *   melody: { register: null, shape: null, motifs: [], graph: { nodes: [], edges: [] }, rhythm: emptyRhythm },
+ * };
+ * assertReferenceProfile(profile); // the profile, unchanged
+ * ```
+ * @category Arrangement & Analysis
+ */
+declare function assertReferenceProfile(value: unknown, name?: string): ReferenceProfile;
+
 /**
  * Line spelling: name every note of a melodic line in one pass.
  *
@@ -190,4 +336,4 @@ type SpellLineOptions = {
  */
 declare function spellLine(notes: readonly NoteEvent[], timeline: ChordTimeline | null, key: SpelledKeyLike, opts?: SpellLineOptions): Note[];
 
-export { ChordTimeline, type MelodicComparison, MelodicPhrase, Note as NoteData, NoteEvent, NoteLike, type SpellLineOptions, SpelledKeyLike, compareMelodies, melodicSimilarity, spellLine };
+export { ChordTimeline, type MelodicComparison, MelodicPhrase, Note as NoteData, NoteEvent, NoteLike, type ReferenceComparison, type ReferenceComparisonOptions, ReferenceProfile, type SpellLineOptions, SpelledKeyLike, assertReferenceProfile, compareMelodies, compareReferences, melodicSimilarity, spellLine };

package/dist/analyze/index.js

@@ -1,29 +1,33 @@
 import {
   spellLine
-} from "../chunk-57WB2EDF.js";
+} from "../chunk-ZBUROTJQ.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 {
+  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,
@@ -31,6 +35,7 @@ import {
   chordTimelineFromChords,
   chordTimelineFromNotes,
   chordToRoman,
+  compareMelodies,
   detectCadence,
   detectCadences,
   detectChord,
@@ -40,32 +45,49 @@ 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";
-import "../chunk-7GOKQJTQ.js";
+} from "../chunk-GNVN4PPJ.js";
+import "../chunk-PUKJP2Z5.js";
 import {
   NoteSafety
-} from "../chunk-FPBZFNCD.js";
-import "../chunk-PQL7E5F6.js";
+} from "../chunk-RFIBF2RR.js";
+import "../chunk-AGOVW7U6.js";
 export {
+  CADENCE_TYPES,
+  HARMONIC_FUNCTIONS,
+  MELODIC_CONTOUR_SHAPES,
   MODAL_SCALE_NAMES,
+  MOTIF_RELATION_KINDS,
   NoteSafety,
+  REDUCTION_LEVELS,
+  REFERENCE_PROFILE_VERSION,
+  RHYTHM_IOI_BINS,
   analyzeArrangement,
   analyzeChord,
   analyzePolyphony,
+  analyzeReference,
+  analyzeRhythm,
   analyzeVoice,
   assertChordTimeline,
+  assertReferenceProfile,
   augmentedSixthChord,
   augmentedSixthFromPitchClasses,
   augmentedSixthKind,
@@ -74,6 +96,7 @@ export {
   chordTimelineFromNotes,
   chordToRoman,
   compareMelodies,
+  compareReferences,
   createArrangementSession,
   detectCadence,
   detectCadences,
@@ -94,6 +117,7 @@ export {
   melodicContour,
   melodicSimilarity,
   motifFromNotes,
+  motifGraph,
   phrasesFromTimeline,
   pivotChords,
   prevailingKeyOf,