@libraz/libcantus 1.3.0 → 1.4.0

package/dist/model/index.d.cts

@@ -1,23 +1,23 @@
-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, 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-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';
+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-BJd1XkPB.cjs';
+export { b as ArrangementSession, f as ConflictPartner, j as ModalScaleName, l as PhraseSignal, m as TrackAnalysis, o as TrackRole } from '../profile-BJd1XkPB.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-_ofpb2be.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-_ofpb2be.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-C9MYbuKS.cjs';
+export { B as BudgetExceededError, d as InvalidInputError, L as LibcantusError, N as NoSolutionError, k as NoteNameSystem } from '../index-C9MYbuKS.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-Ytt2Eiq9.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-Ytt2Eiq9.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-pQihL4z7.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-pQihL4z7.cjs';
+import { b as InstrumentProfileLike, d as PositionalRng, I as InstrumentProfile, e as StringFingering } from '../positional-CscpxtlE.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-CscpxtlE.cjs';
+import { c as MeterMap, b as MeterLike, B as BarPosition, T as TimeSignature } from '../index-5VJgKz_Q.cjs';
+export { M as MeterChange } from '../index-5VJgKz_Q.cjs';
+import { s as ScaleNameInput, r as ScaleName } from '../masks-BnzXnBj0.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-BV6APVa6.cjs';
+export { a as AvoidNoteUse, f as PartWritingViolationKind, o as TransposingInstrumentName, s as VoicingStyle } from '../index-BV6APVa6.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-DVInzCDS.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-DVInzCDS.cjs';
+import '../index-BkT21EMv.cjs';
 
 /**
  * An immutable spelled interval value: a diatonic number, a quality label, and
@@ -160,6 +160,9 @@ declare class Interval {
     /**
      * Whether the interval is consonant.
      *
+     * The spelling decides, not the span: a diminished fourth is a dissonance
+     * though it sounds like a major third.
+     *
      * @param twoVoice When true, the perfect fourth counts as a dissonance,
      *   matching two-voice counterpoint.
      * @returns True if the interval is consonant in that context.
@@ -609,8 +612,9 @@ declare class Timeline {
      *
      * @param data The segments and the span they cover; copied, never retained.
      * @throws If the span, a segment, or a key region carries a number it cannot
-     *   hold — a beat that is not finite, a mode mask that names no scale — or if
-     *   the confidences do not run one per segment.
+     *   hold — a beat that is not finite, a mode mask that names no scale — if
+     *   the segments or the key regions are not disjoint, in beat order and of
+     *   positive length, or if the confidences do not run one per segment.
      */
     constructor(data: TimelineData);
     /**
@@ -619,7 +623,8 @@ declare class Timeline {
      * @param spans The chords with their onsets, in any order.
      * @param totalBeats Where the last chord stops sounding.
      * @param key The key the chords are read in, when it is already known. It
-     *   becomes the one key region under the whole span; without it the timeline
+     *   becomes the one key region from the first chord to the end of the span;
+     *   without it, or without a chord for it to be in force over, the timeline
      *   carries no key, and the members that need one say so.
      * @returns The timeline.
      */
@@ -844,6 +849,12 @@ declare class Timeline {
 type ProgressionData = {
     chords: Chord$1[];
     key: KeyData | undefined;
+    /**
+     * Each chord's own key by position, null for a chord without one. Written
+     * only when the progression carries no key and some chord does; read only
+     * when `key` is absent, since a progression key reaches every chord.
+     */
+    chordKeys?: (KeyData | null)[];
 };
 /**
  * An immutable ordered sequence of chords, optionally carrying a {@link Key}
@@ -907,10 +918,12 @@ declare class Progression {
      */
     static fromSpans(spans: readonly ChordSpan[], key?: KeyLike): Progression;
     /**
-     * Rebuild a progression from its {@link Progression.toJSON} output.
+     * Rebuild a progression from its {@link Progression.toJSON} output, with the
+     * carried key or, without one, each chord's own key.
      *
-     * @param data The serialized chords and key.
+     * @param data The serialized chords and keys.
      * @returns The progression.
+     * @throws If `chordKeys` does not hold one entry per chord.
      */
     static fromJSON(data: ProgressionData): Progression;
     /**
@@ -1284,10 +1297,12 @@ declare class Progression {
     /**
      * The plain progression data, for JSON serialization.
      *
-     * Private class fields do not serialize, so this preserves both the chord
-     * data and any carried key in `JSON.stringify(progression)`.
+     * Private class fields do not serialize, so this preserves the chord data,
+     * any carried key, and — for a progression with no key of its own — each
+     * chord's own key in `JSON.stringify(progression)`.
      *
-     * @returns The chord data sequence and the carried key, if any.
+     * @returns The chord data sequence, the carried key, if any, and the
+     *   per-chord keys when they are what spells the chords.
      */
     toJSON(): ProgressionData;
 }
@@ -2225,7 +2240,7 @@ declare class Key {
     get scaleName(): ScaleName | undefined;
     /** A copy of the underlying plain key data. */
     get data(): KeyData;
-    /** The detected scale form, when this key came from key detection. */
+    /** The scale form this key stands in: natural, harmonic or melodic, read from the mask unless named. */
     get variant(): KeyVariant;
     /**
      * The scale's pitch classes.
@@ -2516,7 +2531,7 @@ declare class Key {
      *
      * Unlike {@link Key.transpose}, which picks a letter from the semitone count,
      * the interval's diatonic number decides the tonic's letter: G# minor down an
-     * augmented fourth is D minor, while down a diminished fifth it is Dbb minor.
+     * augmented fourth is D minor, while down a diminished fifth it is C## minor.
      * The mode mask is unchanged, so the scale keeps its shape.
      *
      * @param interval The interval to apply, as a name (`'A4'`, `'-A4'`), plain
@@ -2790,12 +2805,11 @@ declare class Key {
      *
      * Private class fields do not serialize, so an explicit `toJSON` keeps
      * `JSON.stringify(key)` from collapsing to `{}`. The result pairs the
-     * `KeyScale` with the spelled tonic and, for a detected harmonic or melodic
-     * minor, the scale form — everything {@link Key.fromJSON} needs to rebuild a
-     * key that reads and prints as this one.
+     * `KeyScale` with the spelled tonic and the scale form — everything
+     * {@link Key.fromJSON} needs to rebuild a key that reads and prints as this
+     * one.
      *
-     * @returns The key/scale, its spelled tonic, and its scale form when it has
-     *   one.
+     * @returns The key/scale, its spelled tonic, and its scale form.
      */
     toJSON(): KeyData;
     /**
@@ -3033,9 +3047,8 @@ declare class Score {
     /**
      * The notes pushed off the grid the way a player would.
      *
-     * The metric accents are read from the score's opening signature, since
-     * {@link HumanizeOptions} names one signature rather than a map; pass `ts`
-     * to read a later stretch of a score that changes meter.
+     * The metric accents are read against the score's meter map, exactly as
+     * {@link humanize} reads that map; pass `ts` to read against another meter.
      *
      * @param opts Jitter amounts, accent depth and the seed; see
      *   {@link HumanizeOptions}.
@@ -3045,8 +3058,8 @@ declare class Score {
     /**
      * The notes with ornaments added.
      *
-     * Strong positions are read from the score's opening signature, since
-     * {@link OrnamentOptions} names one signature rather than a map.
+     * Strong positions are read against the score's meter map, exactly as
+     * {@link ornament} reads that map.
      *
      * @param opts The ornament style, how much is decorated, and the seed; see
      *   {@link OrnamentOptions}.
@@ -3056,9 +3069,9 @@ declare class Score {
     /**
      * The notes placed on a groove template's slots.
      *
-     * The template's per-bar grid is laid out against the score's opening
-     * signature, which is the signature the template must have been extracted
-     * under; a template carrying a different one is refused rather than drifting.
+     * The template's per-bar grid is laid out against the score's meter map,
+     * exactly as {@link applyGrooveTemplate} reads that map; a template extracted
+     * under another meter is refused rather than drifting.
      *
      * @param template The groove template, from `extractGrooveTemplate`.
      * @returns The score with the template's feel imposed.
@@ -3072,8 +3085,8 @@ declare class Score {
      * slot by slot for how far ahead of or behind the grid it sits and how hard
      * it is struck, and the reading is handed back as a template. Only the
      * subdivision is named, because the score already holds the meter the grid is
-     * laid out against — its opening signature, which is the one the template
-     * records and the one an apply-time meter is checked against.
+     * laid out against — its meter map, read exactly as
+     * {@link extractGrooveTemplate} reads that map.
      *
      * @param subdivision Grid steps per quarter-note beat; a sixteenth-note grid
      *   by default, which is where swing, push and drag are audible.
@@ -3202,8 +3215,9 @@ declare class Score {
      *
      * A melody is one line, so a score holding several is read as its top voice:
      * notes struck together are one event and the highest of them stands for it.
-     * A piano part read whole therefore answers for the voice a listener follows
-     * rather than for a line assembled from the insides of its chords. Split the
+     * A block-chord part read whole therefore answers for its top voice rather
+     * than for a line assembled from the insides of its chords; a lower note
+     * struck while a higher one still sounds stays in the line, though. Split the
      * score into lines first to have each of them answered for.
      *
      * @param opts Cell-length bounds and the recurrence threshold; see
@@ -5946,4 +5960,5 @@ 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, 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 };
+export { AnalyzeChordOptions, AnalyzedNote, Arrangement, ArrangementAnalysis, ArrangementOptions, ArrangementTrack, Articulation, AugmentedSixthKind, AvailableTensionsOptions, AvoidNotesOptions, BarPosition, BassLineOptions, 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, CompositionEvaluation, CompositionPlan, CompositionPlanOptions, Conflict, CounterMelodyOptions, DetectCadenceOptions, DetectChordOptions, DetectKeyOptions, DrumsOptions, Duration, DurationData, EvaluateCompositionOptions, EvaluateSafetyOptions, ExplainRomanOptions, ExtractMotifsOptions, FormSection, FormSectionOptions, GenerationContext, GenerationContextInput, GrooveTemplate, HarmonicFunction, HarmonizeOptions, HumanizeOptions, Hypermeter, HypermeterOptions, IdentifiedVoiceNote, Instrument, InstrumentProfile, InstrumentProfileLike, Interval, IntervalData, IntervalLike, IntervalQualityLabel, Key, KeyLike, KeyMatch, KeyMode, KeyRegion, KeyRelation, KeyScale, KeyTimelineOptions, KeyVariant, MelodicContour, MelodyOptions, Meter, MeterLike, MeterMap, Motif, MotifCell, MotifContour, MotifData, 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, ProgressionOptions, ReduceProgressionOptions, ReducedChord, ReferenceProfile, ReferenceProfileOptions, ResolvedKey, Rhythm, RhythmAnalysis, RhythmAnalysisOptions, RhythmEvent, RhythmOptions, RomanExplanation, SafetyQuery, SafetyResult, ScaleChoice, ScaleName, ScaleNameInput, ScaleSystem, Score, Species, SpeciesOptions, SpelledDuration, SpelledInterval, SpelledKeyLike, StringFingering, StructuralCadence, StyledVoicingOptions, SubstituteOptions, Substitution, SubstitutionType, Tempo, TempoMap, TensionPoint, TimeSignature, Timeline, TrackEdit, TransposingInstrument, Tuning, TuningTable, Tuplet, Vocabulary, VoiceIndependenceOptions, VoiceIndependenceReport, VoiceRange, Voicing, VoicingOptions };
+export type { ArrangementData, ArrangementSettings, ArrangementSetup, ArrangementTensionOptions, BassLineSettings, ComposerOptions, CounterMelodySettings, DetectedKeyMatch, HarmonizedMelody, KeyData, MotifGenerateOptions, ProgressionData, RhythmData, RhythmDeformOptions, ScoreData, ScoreOptions, TempoData, TimelineData, TimelineRoman, VoicingData, VoicingIndependenceOptions, VoicingSafetyQuery };

package/dist/model/index.d.ts

@@ -1,23 +1,23 @@
-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-DLdlIpS9.js';
-export { b as ArrangementSession, f as ConflictPartner, j as ModalScaleName, l as PhraseSignal, m as TrackAnalysis, o as TrackRole } from '../profile-DLdlIpS9.js';
-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-Dh7C064C.js';
-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-Dh7C064C.js';
-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.js';
-export { B as BudgetExceededError, d as InvalidInputError, L as LibcantusError, N as NoSolutionError, k as NoteNameSystem } from '../index-Cy15oTvh.js';
-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-DP0vYu-x.js';
-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-DP0vYu-x.js';
-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-9eoQs2C1.js';
-export { I as IndexedNoteEvent, c as NotePlacement, O as OnsetTieBreak, P as PlayabilityIssue, e as PlayabilityIssueType, f as PlayabilityLayer, h as TempoEvent } from '../index-9eoQs2C1.js';
-import { b as InstrumentProfileLike, d as PositionalRng, I as InstrumentProfile, e as StringFingering } from '../positional-DJgs6ltD.js';
-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-DJgs6ltD.js';
-import { c as MeterMap, b as MeterLike, B as BarPosition, T as TimeSignature } from '../index-CL4b4gUQ.js';
-export { M as MeterChange } from '../index-CL4b4gUQ.js';
-import { s as ScaleNameInput, r as ScaleName } from '../masks-Cc7-MzzY.js';
-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-BHIUyjhZ.js';
-export { a as AvoidNoteUse, f as PartWritingViolationKind, o as TransposingInstrumentName, s as VoicingStyle } from '../index-BHIUyjhZ.js';
-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-zaZdmnU4.js';
-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-zaZdmnU4.js';
-import '../index-Dw2DP7vm.js';
+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-B4WqcM4H.js';
+export { b as ArrangementSession, f as ConflictPartner, j as ModalScaleName, l as PhraseSignal, m as TrackAnalysis, o as TrackRole } from '../profile-B4WqcM4H.js';
+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-7mGFwvMm.js';
+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-7mGFwvMm.js';
+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-C9MYbuKS.js';
+export { B as BudgetExceededError, d as InvalidInputError, L as LibcantusError, N as NoSolutionError, k as NoteNameSystem } from '../index-C9MYbuKS.js';
+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-CUhHc3Tu.js';
+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-CUhHc3Tu.js';
+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-Dg-SAfhz.js';
+export { I as IndexedNoteEvent, c as NotePlacement, O as OnsetTieBreak, P as PlayabilityIssue, e as PlayabilityIssueType, f as PlayabilityLayer, h as TempoEvent } from '../index-Dg-SAfhz.js';
+import { b as InstrumentProfileLike, d as PositionalRng, I as InstrumentProfile, e as StringFingering } from '../positional-DLnfUgqG.js';
+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-DLnfUgqG.js';
+import { c as MeterMap, b as MeterLike, B as BarPosition, T as TimeSignature } from '../index-Bf0Sv8a9.js';
+export { M as MeterChange } from '../index-Bf0Sv8a9.js';
+import { s as ScaleNameInput, r as ScaleName } from '../masks-tycmkrgs.js';
+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-BLuDesVG.js';
+export { a as AvoidNoteUse, f as PartWritingViolationKind, o as TransposingInstrumentName, s as VoicingStyle } from '../index-BLuDesVG.js';
+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-jgeug9EA.js';
+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-jgeug9EA.js';
+import '../index-C7KCaTRz.js';
 
 /**
  * An immutable spelled interval value: a diatonic number, a quality label, and
@@ -160,6 +160,9 @@ declare class Interval {
     /**
      * Whether the interval is consonant.
      *
+     * The spelling decides, not the span: a diminished fourth is a dissonance
+     * though it sounds like a major third.
+     *
      * @param twoVoice When true, the perfect fourth counts as a dissonance,
      *   matching two-voice counterpoint.
      * @returns True if the interval is consonant in that context.
@@ -609,8 +612,9 @@ declare class Timeline {
      *
      * @param data The segments and the span they cover; copied, never retained.
      * @throws If the span, a segment, or a key region carries a number it cannot
-     *   hold — a beat that is not finite, a mode mask that names no scale — or if
-     *   the confidences do not run one per segment.
+     *   hold — a beat that is not finite, a mode mask that names no scale — if
+     *   the segments or the key regions are not disjoint, in beat order and of
+     *   positive length, or if the confidences do not run one per segment.
      */
     constructor(data: TimelineData);
     /**
@@ -619,7 +623,8 @@ declare class Timeline {
      * @param spans The chords with their onsets, in any order.
      * @param totalBeats Where the last chord stops sounding.
      * @param key The key the chords are read in, when it is already known. It
-     *   becomes the one key region under the whole span; without it the timeline
+     *   becomes the one key region from the first chord to the end of the span;
+     *   without it, or without a chord for it to be in force over, the timeline
      *   carries no key, and the members that need one say so.
      * @returns The timeline.
      */
@@ -844,6 +849,12 @@ declare class Timeline {
 type ProgressionData = {
     chords: Chord$1[];
     key: KeyData | undefined;
+    /**
+     * Each chord's own key by position, null for a chord without one. Written
+     * only when the progression carries no key and some chord does; read only
+     * when `key` is absent, since a progression key reaches every chord.
+     */
+    chordKeys?: (KeyData | null)[];
 };
 /**
  * An immutable ordered sequence of chords, optionally carrying a {@link Key}
@@ -907,10 +918,12 @@ declare class Progression {
      */
     static fromSpans(spans: readonly ChordSpan[], key?: KeyLike): Progression;
     /**
-     * Rebuild a progression from its {@link Progression.toJSON} output.
+     * Rebuild a progression from its {@link Progression.toJSON} output, with the
+     * carried key or, without one, each chord's own key.
      *
-     * @param data The serialized chords and key.
+     * @param data The serialized chords and keys.
      * @returns The progression.
+     * @throws If `chordKeys` does not hold one entry per chord.
      */
     static fromJSON(data: ProgressionData): Progression;
     /**
@@ -1284,10 +1297,12 @@ declare class Progression {
     /**
      * The plain progression data, for JSON serialization.
      *
-     * Private class fields do not serialize, so this preserves both the chord
-     * data and any carried key in `JSON.stringify(progression)`.
+     * Private class fields do not serialize, so this preserves the chord data,
+     * any carried key, and — for a progression with no key of its own — each
+     * chord's own key in `JSON.stringify(progression)`.
      *
-     * @returns The chord data sequence and the carried key, if any.
+     * @returns The chord data sequence, the carried key, if any, and the
+     *   per-chord keys when they are what spells the chords.
      */
     toJSON(): ProgressionData;
 }
@@ -2225,7 +2240,7 @@ declare class Key {
     get scaleName(): ScaleName | undefined;
     /** A copy of the underlying plain key data. */
     get data(): KeyData;
-    /** The detected scale form, when this key came from key detection. */
+    /** The scale form this key stands in: natural, harmonic or melodic, read from the mask unless named. */
     get variant(): KeyVariant;
     /**
      * The scale's pitch classes.
@@ -2516,7 +2531,7 @@ declare class Key {
      *
      * Unlike {@link Key.transpose}, which picks a letter from the semitone count,
      * the interval's diatonic number decides the tonic's letter: G# minor down an
-     * augmented fourth is D minor, while down a diminished fifth it is Dbb minor.
+     * augmented fourth is D minor, while down a diminished fifth it is C## minor.
      * The mode mask is unchanged, so the scale keeps its shape.
      *
      * @param interval The interval to apply, as a name (`'A4'`, `'-A4'`), plain
@@ -2790,12 +2805,11 @@ declare class Key {
      *
      * Private class fields do not serialize, so an explicit `toJSON` keeps
      * `JSON.stringify(key)` from collapsing to `{}`. The result pairs the
-     * `KeyScale` with the spelled tonic and, for a detected harmonic or melodic
-     * minor, the scale form — everything {@link Key.fromJSON} needs to rebuild a
-     * key that reads and prints as this one.
+     * `KeyScale` with the spelled tonic and the scale form — everything
+     * {@link Key.fromJSON} needs to rebuild a key that reads and prints as this
+     * one.
      *
-     * @returns The key/scale, its spelled tonic, and its scale form when it has
-     *   one.
+     * @returns The key/scale, its spelled tonic, and its scale form.
      */
     toJSON(): KeyData;
     /**
@@ -3033,9 +3047,8 @@ declare class Score {
     /**
      * The notes pushed off the grid the way a player would.
      *
-     * The metric accents are read from the score's opening signature, since
-     * {@link HumanizeOptions} names one signature rather than a map; pass `ts`
-     * to read a later stretch of a score that changes meter.
+     * The metric accents are read against the score's meter map, exactly as
+     * {@link humanize} reads that map; pass `ts` to read against another meter.
      *
      * @param opts Jitter amounts, accent depth and the seed; see
      *   {@link HumanizeOptions}.
@@ -3045,8 +3058,8 @@ declare class Score {
     /**
      * The notes with ornaments added.
      *
-     * Strong positions are read from the score's opening signature, since
-     * {@link OrnamentOptions} names one signature rather than a map.
+     * Strong positions are read against the score's meter map, exactly as
+     * {@link ornament} reads that map.
      *
      * @param opts The ornament style, how much is decorated, and the seed; see
      *   {@link OrnamentOptions}.
@@ -3056,9 +3069,9 @@ declare class Score {
     /**
      * The notes placed on a groove template's slots.
      *
-     * The template's per-bar grid is laid out against the score's opening
-     * signature, which is the signature the template must have been extracted
-     * under; a template carrying a different one is refused rather than drifting.
+     * The template's per-bar grid is laid out against the score's meter map,
+     * exactly as {@link applyGrooveTemplate} reads that map; a template extracted
+     * under another meter is refused rather than drifting.
      *
      * @param template The groove template, from `extractGrooveTemplate`.
      * @returns The score with the template's feel imposed.
@@ -3072,8 +3085,8 @@ declare class Score {
      * slot by slot for how far ahead of or behind the grid it sits and how hard
      * it is struck, and the reading is handed back as a template. Only the
      * subdivision is named, because the score already holds the meter the grid is
-     * laid out against — its opening signature, which is the one the template
-     * records and the one an apply-time meter is checked against.
+     * laid out against — its meter map, read exactly as
+     * {@link extractGrooveTemplate} reads that map.
      *
      * @param subdivision Grid steps per quarter-note beat; a sixteenth-note grid
      *   by default, which is where swing, push and drag are audible.
@@ -3202,8 +3215,9 @@ declare class Score {
      *
      * A melody is one line, so a score holding several is read as its top voice:
      * notes struck together are one event and the highest of them stands for it.
-     * A piano part read whole therefore answers for the voice a listener follows
-     * rather than for a line assembled from the insides of its chords. Split the
+     * A block-chord part read whole therefore answers for its top voice rather
+     * than for a line assembled from the insides of its chords; a lower note
+     * struck while a higher one still sounds stays in the line, though. Split the
      * score into lines first to have each of them answered for.
      *
      * @param opts Cell-length bounds and the recurrence threshold; see
@@ -5946,4 +5960,5 @@ 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, 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 };
+export { AnalyzeChordOptions, AnalyzedNote, Arrangement, ArrangementAnalysis, ArrangementOptions, ArrangementTrack, Articulation, AugmentedSixthKind, AvailableTensionsOptions, AvoidNotesOptions, BarPosition, BassLineOptions, 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, CompositionEvaluation, CompositionPlan, CompositionPlanOptions, Conflict, CounterMelodyOptions, DetectCadenceOptions, DetectChordOptions, DetectKeyOptions, DrumsOptions, Duration, DurationData, EvaluateCompositionOptions, EvaluateSafetyOptions, ExplainRomanOptions, ExtractMotifsOptions, FormSection, FormSectionOptions, GenerationContext, GenerationContextInput, GrooveTemplate, HarmonicFunction, HarmonizeOptions, HumanizeOptions, Hypermeter, HypermeterOptions, IdentifiedVoiceNote, Instrument, InstrumentProfile, InstrumentProfileLike, Interval, IntervalData, IntervalLike, IntervalQualityLabel, Key, KeyLike, KeyMatch, KeyMode, KeyRegion, KeyRelation, KeyScale, KeyTimelineOptions, KeyVariant, MelodicContour, MelodyOptions, Meter, MeterLike, MeterMap, Motif, MotifCell, MotifContour, MotifData, 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, ProgressionOptions, ReduceProgressionOptions, ReducedChord, ReferenceProfile, ReferenceProfileOptions, ResolvedKey, Rhythm, RhythmAnalysis, RhythmAnalysisOptions, RhythmEvent, RhythmOptions, RomanExplanation, SafetyQuery, SafetyResult, ScaleChoice, ScaleName, ScaleNameInput, ScaleSystem, Score, Species, SpeciesOptions, SpelledDuration, SpelledInterval, SpelledKeyLike, StringFingering, StructuralCadence, StyledVoicingOptions, SubstituteOptions, Substitution, SubstitutionType, Tempo, TempoMap, TensionPoint, TimeSignature, Timeline, TrackEdit, TransposingInstrument, Tuning, TuningTable, Tuplet, Vocabulary, VoiceIndependenceOptions, VoiceIndependenceReport, VoiceRange, Voicing, VoicingOptions };
+export type { ArrangementData, ArrangementSettings, ArrangementSetup, ArrangementTensionOptions, BassLineSettings, ComposerOptions, CounterMelodySettings, DetectedKeyMatch, HarmonizedMelody, KeyData, MotifGenerateOptions, ProgressionData, RhythmData, RhythmDeformOptions, ScoreData, ScoreOptions, TempoData, TimelineData, TimelineRoman, VoicingData, VoicingIndependenceOptions, VoicingSafetyQuery };

package/dist/model/index.js

@@ -16,23 +16,23 @@ import {
   Timeline,
   Tuning,
   Voicing
-} from "../chunk-IPEF6NWB.js";
-import "../chunk-MLBPXA4Z.js";
-import "../chunk-UMWZ4ZET.js";
-import "../chunk-CPMB7P75.js";
-import "../chunk-GNVN4PPJ.js";
-import "../chunk-7KG3RTYS.js";
-import "../chunk-PUKJP2Z5.js";
-import "../chunk-M5RYMAFI.js";
-import "../chunk-NB25P3EH.js";
+} from "../chunk-5MWRBYAT.js";
+import "../chunk-UTE5A36R.js";
+import "../chunk-7NQ6AL3H.js";
+import "../chunk-FK3DGAIZ.js";
+import "../chunk-FJFULJZE.js";
+import "../chunk-VL5NXVCN.js";
+import "../chunk-TXFWSU5D.js";
+import "../chunk-ZLNSH4UL.js";
+import "../chunk-2G5MCGYU.js";
 import {
   NoteSafety
-} from "../chunk-RFIBF2RR.js";
+} from "../chunk-H7FVMBUC.js";
 import {
   BudgetExceededError,
   InvalidInputError,
   NoSolutionError
-} from "../chunk-AGOVW7U6.js";
+} from "../chunk-YYVXRV3V.js";
 export {
   Arrangement,
   BudgetExceededError,

package/dist/{positional-DJgs6ltD.d.ts → positional-CscpxtlE.d.cts}

@@ -1,4 +1,4 @@
-import { a as Articulation } from './index-Cy15oTvh.js';
+import { a as Articulation } from './index-C9MYbuKS.cjs';
 
 /**
  * Every limb a percussionist strikes with, in declaration order.
@@ -361,4 +361,5 @@ declare function createPositionalRng(seed: number): PositionalRng;
  */
 declare function includeAt(rng: PositionalRng, complexity: number, ...path: SeedPath): boolean;
 
-export { type InstrumentProfile as I, LIMBS as L, type PercussionProfile as P, type SeedPath as S, type ValidatedPercussionProfile as V, type InstrumentProfileCommon as a, type InstrumentProfileLike as b, type Limb as c, type PositionalRng as d, type StringFingering as e, type StringedProfile as f, type ValidatedProfile as g, type ValidatedStringedProfile as h, canSound as i, createPositionalRng as j, deriveSeed as k, fingeringsFor as l, foldIntoRange as m, includeAt as n, instrumentRange as o, toStringedProfile as p, toInstrumentProfile as t };
+export { LIMBS as L, canSound as i, createPositionalRng as j, deriveSeed as k, fingeringsFor as l, foldIntoRange as m, includeAt as n, instrumentRange as o, toStringedProfile as p, toInstrumentProfile as t };
+export type { InstrumentProfile as I, PercussionProfile as P, SeedPath as S, ValidatedPercussionProfile as V, InstrumentProfileCommon as a, InstrumentProfileLike as b, Limb as c, PositionalRng as d, StringFingering as e, StringedProfile as f, ValidatedProfile as g, ValidatedStringedProfile as h };

package/dist/{positional-DMZer-FM.d.cts → positional-DLnfUgqG.d.ts}

@@ -1,4 +1,4 @@
-import { a as Articulation } from './index-Cy15oTvh.cjs';
+import { a as Articulation } from './index-C9MYbuKS.js';
 
 /**
  * Every limb a percussionist strikes with, in declaration order.
@@ -361,4 +361,5 @@ declare function createPositionalRng(seed: number): PositionalRng;
  */
 declare function includeAt(rng: PositionalRng, complexity: number, ...path: SeedPath): boolean;
 
-export { type InstrumentProfile as I, LIMBS as L, type PercussionProfile as P, type SeedPath as S, type ValidatedPercussionProfile as V, type InstrumentProfileCommon as a, type InstrumentProfileLike as b, type Limb as c, type PositionalRng as d, type StringFingering as e, type StringedProfile as f, type ValidatedProfile as g, type ValidatedStringedProfile as h, canSound as i, createPositionalRng as j, deriveSeed as k, fingeringsFor as l, foldIntoRange as m, includeAt as n, instrumentRange as o, toStringedProfile as p, toInstrumentProfile as t };
+export { LIMBS as L, canSound as i, createPositionalRng as j, deriveSeed as k, fingeringsFor as l, foldIntoRange as m, includeAt as n, instrumentRange as o, toStringedProfile as p, toInstrumentProfile as t };
+export type { InstrumentProfile as I, PercussionProfile as P, SeedPath as S, ValidatedPercussionProfile as V, InstrumentProfileCommon as a, InstrumentProfileLike as b, Limb as c, PositionalRng as d, StringFingering as e, StringedProfile as f, ValidatedProfile as g, ValidatedStringedProfile as h };