@libraz/libcantus 0.9.4 → 0.9.5

package/dist/model/index.d.cts

@@ -1,11 +1,11 @@
-import { a as DetectKeyOptions, D as DetectChordOptions, C as ChordMatch } from '../index-BtXT6UQ0.cjs';
-import { H as HarmonicFunction, a as ChordAnalysis, C as Cadence, B as BorrowedSource } from '../function-DNugAOrt.cjs';
+import { b as KeyVariant, a as DetectKeyOptions, K as KeyMatch, D as DetectChordOptions, C as ChordMatch } from '../index-alrRninU.cjs';
+import { b as ChordToRomanOptions, H as HarmonicFunction, a as ChordAnalysis, C as Cadence, B as BorrowedSource } from '../function-CxixTB02.cjs';
+import { I as IntervalQualityLabel, S as SpelledInterval, N as Note$1 } from '../index-tR9jTn26.cjs';
 import { K as KeyScale } from '../types-BN6_Q9Kl.cjs';
-import { a as ChordQuality, c as ChordSpan, C as Chord$1 } from '../index-y_ak9_Hi.cjs';
-export { P as PitchSpelling } from '../index-y_ak9_Hi.cjs';
-import { I as IntervalQualityLabel, S as SpelledInterval, N as Note$1 } from '../index-OG65ocOr.cjs';
-import { r as VoicingOptions, q as StyledVoicingOptions, a as ChordScaleMatch, p as ScaleNameInput } from '../styled-DJbkJQfj.cjs';
-export { o as ScaleName, V as VoiceRange, s as VoicingStyle } from '../styled-DJbkJQfj.cjs';
+import { a as ChordQuality, c as ChordSpan, C as Chord$1 } from '../index-oTQbYYIs.cjs';
+export { P as PitchSpelling } from '../index-oTQbYYIs.cjs';
+import { p as ScaleNameInput, r as VoicingOptions, n as ScaleChoice, q as StyledVoicingOptions, a as ChordScaleMatch } from '../styled-Crv6SA4S.cjs';
+export { o as ScaleName, V as VoiceRange, s as VoicingStyle } from '../styled-Crv6SA4S.cjs';
 
 /**
  * An immutable spelled interval value: a diatonic number, a quality label, and
@@ -259,6 +259,10 @@ declare class Note {
     toString(): string;
 }
 
+/** A detected key paired with the score and scale form that produced it. */
+type DetectedKeyMatch = Omit<KeyMatch, 'key'> & {
+    key: Key;
+};
 /**
  * An immutable key/scale: a `KeyScale` (root pitch class plus mode mask) paired
  * with a spelled tonic that anchors letter-name spelling. Acts as the factory
@@ -278,8 +282,9 @@ declare class Key {
      *
      * @param scale The key/scale; its root is normalized to a pitch class.
      * @param tonic The spelled tonic anchoring letter-name spelling.
+     * @param variant Optional detected scale form retained for display.
      */
-    constructor(scale: KeyScale, tonic: Note);
+    constructor(scale: KeyScale, tonic: Note, variant?: KeyVariant);
     /**
      * A major key.
      *
@@ -308,7 +313,7 @@ declare class Key {
      * @returns The key.
      * @throws If the name is not a known scale.
      */
-    static named(name: string, root: string | number): Key;
+    static named(name: ScaleNameInput, root: string | number): Key;
     /**
      * Wrap an existing `KeyScale`, synthesizing a spelled tonic when none is
      * given.
@@ -344,6 +349,14 @@ declare class Key {
      * @returns Ranked keys (may be empty).
      */
     static detect(pitches: readonly number[], opts?: DetectKeyOptions): Key[];
+    /**
+     * Identify keys while retaining each candidate's score, fit, and scale form.
+     *
+     * @param pitches MIDI pitches or bare pitch classes.
+     * @param opts How to weigh the input; see {@link DetectKeyOptions}.
+     * @returns Ranked key matches (may be empty).
+     */
+    static detectMatches(pitches: readonly number[], opts?: DetectKeyOptions): DetectedKeyMatch[];
     /**
      * The single best key interpretation of a pitch set.
      *
@@ -375,6 +388,8 @@ declare class Key {
     get rootPc(): number;
     /** Whether the scale has a minor third and no major third. */
     get isMinor(): boolean;
+    /** The detected scale form, when this key came from key detection. */
+    get variant(): KeyVariant | undefined;
     /**
      * The scale's pitch classes in ascending scale-degree order (degree 0 first).
      *
@@ -481,8 +496,7 @@ declare class Key {
     };
     /**
      * The key's tonic and mode, so a template literal or a log line reads as the
-     * key. Only the major/minor distinction is named, since a mask does not carry
-     * a scale name.
+     * key. Detected harmonic and melodic minor keys retain their scale form.
      *
      * @returns The name, e.g. `'C major'` or `'A minor'`.
      */
@@ -600,10 +614,11 @@ declare class Progression {
      * The Roman numeral of each chord in a key.
      *
      * @param key Key to analyze in; falls back to the carried context.
+     * @param opts Applied-numeral rendering options.
      * @returns One numeral per chord.
      * @throws If no key is given and none is carried.
      */
-    roman(key?: Key): string[];
+    roman(key?: Key, opts?: ChordToRomanOptions): string[];
     /**
      * The harmonic function of each chord in a key.
      *
@@ -619,13 +634,20 @@ declare class Progression {
      * progression has fewer than two chords.
      *
      * @param key Key to analyze in; falls back to the carried context.
+     * @param opts Applied-numeral rendering options.
      * @returns Per-chord analyses and the closing cadence.
      * @throws If no key is given and none is carried.
      */
-    analyze(key?: Key): {
+    analyze(key?: Key, opts?: ChordToRomanOptions): {
         chords: ChordAnalysis[];
         cadence: Cadence;
     };
+    /**
+     * Choose one compatible scale for every chord, favoring smooth changes.
+     *
+     * @returns One scale choice per chord in this progression.
+     */
+    scales(): ScaleChoice[];
     /**
      * The plain progression data, for JSON serialization.
      *
@@ -657,6 +679,14 @@ declare class Progression {
      * @returns The symbols in order, e.g. `'C Am F G'`.
      */
     toString(): string;
+    /**
+     * 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)`.
+     *
+     * @returns The chord data sequence and the carried key, if any.
+     */
     toJSON(): {
         chords: Chord$1[];
         key: {
@@ -807,10 +837,11 @@ declare class Chord {
      * The chord's Roman numeral in a key.
      *
      * @param key Key to analyze in; falls back to the carried context.
+     * @param opts Applied-numeral rendering options.
      * @returns The Roman numeral string.
      * @throws If no key is given and none is carried.
      */
-    roman(key?: Key): string;
+    roman(key?: Key, opts?: ChordToRomanOptions): string;
     /**
      * The chord's harmonic function (tonic / subdominant / dominant) in a key.
      *
@@ -823,10 +854,11 @@ declare class Chord {
      * Full functional analysis: function, borrowing, and Roman numeral.
      *
      * @param key Key to analyze in; falls back to the carried context.
+     * @param opts Applied-numeral rendering options.
      * @returns The chord analysis.
      * @throws If no key is given and none is carried.
      */
-    analyze(key?: Key): ChordAnalysis;
+    analyze(key?: Key, opts?: ChordToRomanOptions): ChordAnalysis;
     /**
      * Whether the chord is borrowed from the parallel mode (modal interchange).
      *
@@ -986,4 +1018,4 @@ declare class Chord {
     toString(): string;
 }
 
-export { BorrowedSource, Cadence, Chord, ChordAnalysis, Chord$1 as ChordData, ChordMatch, ChordQuality, ChordScaleMatch, ChordSpan, DetectChordOptions, DetectKeyOptions, HarmonicFunction, Interval, IntervalQualityLabel, Key, KeyScale, Note, Note$1 as NoteData, Progression, ScaleNameInput, SpelledInterval, StyledVoicingOptions, VoicingOptions };
+export { BorrowedSource, Cadence, Chord, ChordAnalysis, Chord$1 as ChordData, ChordMatch, ChordQuality, ChordScaleMatch, ChordSpan, ChordToRomanOptions, DetectChordOptions, DetectKeyOptions, type DetectedKeyMatch, HarmonicFunction, Interval, IntervalQualityLabel, Key, KeyMatch, KeyScale, KeyVariant, Note, Note$1 as NoteData, Progression, ScaleChoice, ScaleNameInput, SpelledInterval, StyledVoicingOptions, VoicingOptions };

package/dist/model/index.d.ts

@@ -1,11 +1,11 @@
-import { a as DetectKeyOptions, D as DetectChordOptions, C as ChordMatch } from '../index-70p168VM.js';
-import { H as HarmonicFunction, a as ChordAnalysis, C as Cadence, B as BorrowedSource } from '../function-BtiZb9i9.js';
+import { b as KeyVariant, a as DetectKeyOptions, K as KeyMatch, D as DetectChordOptions, C as ChordMatch } from '../index-CAN7v-kw.js';
+import { b as ChordToRomanOptions, H as HarmonicFunction, a as ChordAnalysis, C as Cadence, B as BorrowedSource } from '../function-DTCt675z.js';
+import { I as IntervalQualityLabel, S as SpelledInterval, N as Note$1 } from '../index-tR9jTn26.js';
 import { K as KeyScale } from '../types-BN6_Q9Kl.js';
-import { a as ChordQuality, c as ChordSpan, C as Chord$1 } from '../index-C83mZI1P.js';
-export { P as PitchSpelling } from '../index-C83mZI1P.js';
-import { I as IntervalQualityLabel, S as SpelledInterval, N as Note$1 } from '../index-OG65ocOr.js';
-import { r as VoicingOptions, q as StyledVoicingOptions, a as ChordScaleMatch, p as ScaleNameInput } from '../styled-DIRkk9Uz.js';
-export { o as ScaleName, V as VoiceRange, s as VoicingStyle } from '../styled-DIRkk9Uz.js';
+import { a as ChordQuality, c as ChordSpan, C as Chord$1 } from '../index-COw1Ky9g.js';
+export { P as PitchSpelling } from '../index-COw1Ky9g.js';
+import { p as ScaleNameInput, r as VoicingOptions, n as ScaleChoice, q as StyledVoicingOptions, a as ChordScaleMatch } from '../styled-Bl0ZK28h.js';
+export { o as ScaleName, V as VoiceRange, s as VoicingStyle } from '../styled-Bl0ZK28h.js';
 
 /**
  * An immutable spelled interval value: a diatonic number, a quality label, and
@@ -259,6 +259,10 @@ declare class Note {
     toString(): string;
 }
 
+/** A detected key paired with the score and scale form that produced it. */
+type DetectedKeyMatch = Omit<KeyMatch, 'key'> & {
+    key: Key;
+};
 /**
  * An immutable key/scale: a `KeyScale` (root pitch class plus mode mask) paired
  * with a spelled tonic that anchors letter-name spelling. Acts as the factory
@@ -278,8 +282,9 @@ declare class Key {
      *
      * @param scale The key/scale; its root is normalized to a pitch class.
      * @param tonic The spelled tonic anchoring letter-name spelling.
+     * @param variant Optional detected scale form retained for display.
      */
-    constructor(scale: KeyScale, tonic: Note);
+    constructor(scale: KeyScale, tonic: Note, variant?: KeyVariant);
     /**
      * A major key.
      *
@@ -308,7 +313,7 @@ declare class Key {
      * @returns The key.
      * @throws If the name is not a known scale.
      */
-    static named(name: string, root: string | number): Key;
+    static named(name: ScaleNameInput, root: string | number): Key;
     /**
      * Wrap an existing `KeyScale`, synthesizing a spelled tonic when none is
      * given.
@@ -344,6 +349,14 @@ declare class Key {
      * @returns Ranked keys (may be empty).
      */
     static detect(pitches: readonly number[], opts?: DetectKeyOptions): Key[];
+    /**
+     * Identify keys while retaining each candidate's score, fit, and scale form.
+     *
+     * @param pitches MIDI pitches or bare pitch classes.
+     * @param opts How to weigh the input; see {@link DetectKeyOptions}.
+     * @returns Ranked key matches (may be empty).
+     */
+    static detectMatches(pitches: readonly number[], opts?: DetectKeyOptions): DetectedKeyMatch[];
     /**
      * The single best key interpretation of a pitch set.
      *
@@ -375,6 +388,8 @@ declare class Key {
     get rootPc(): number;
     /** Whether the scale has a minor third and no major third. */
     get isMinor(): boolean;
+    /** The detected scale form, when this key came from key detection. */
+    get variant(): KeyVariant | undefined;
     /**
      * The scale's pitch classes in ascending scale-degree order (degree 0 first).
      *
@@ -481,8 +496,7 @@ declare class Key {
     };
     /**
      * The key's tonic and mode, so a template literal or a log line reads as the
-     * key. Only the major/minor distinction is named, since a mask does not carry
-     * a scale name.
+     * key. Detected harmonic and melodic minor keys retain their scale form.
      *
      * @returns The name, e.g. `'C major'` or `'A minor'`.
      */
@@ -600,10 +614,11 @@ declare class Progression {
      * The Roman numeral of each chord in a key.
      *
      * @param key Key to analyze in; falls back to the carried context.
+     * @param opts Applied-numeral rendering options.
      * @returns One numeral per chord.
      * @throws If no key is given and none is carried.
      */
-    roman(key?: Key): string[];
+    roman(key?: Key, opts?: ChordToRomanOptions): string[];
     /**
      * The harmonic function of each chord in a key.
      *
@@ -619,13 +634,20 @@ declare class Progression {
      * progression has fewer than two chords.
      *
      * @param key Key to analyze in; falls back to the carried context.
+     * @param opts Applied-numeral rendering options.
      * @returns Per-chord analyses and the closing cadence.
      * @throws If no key is given and none is carried.
      */
-    analyze(key?: Key): {
+    analyze(key?: Key, opts?: ChordToRomanOptions): {
         chords: ChordAnalysis[];
         cadence: Cadence;
     };
+    /**
+     * Choose one compatible scale for every chord, favoring smooth changes.
+     *
+     * @returns One scale choice per chord in this progression.
+     */
+    scales(): ScaleChoice[];
     /**
      * The plain progression data, for JSON serialization.
      *
@@ -657,6 +679,14 @@ declare class Progression {
      * @returns The symbols in order, e.g. `'C Am F G'`.
      */
     toString(): string;
+    /**
+     * 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)`.
+     *
+     * @returns The chord data sequence and the carried key, if any.
+     */
     toJSON(): {
         chords: Chord$1[];
         key: {
@@ -807,10 +837,11 @@ declare class Chord {
      * The chord's Roman numeral in a key.
      *
      * @param key Key to analyze in; falls back to the carried context.
+     * @param opts Applied-numeral rendering options.
      * @returns The Roman numeral string.
      * @throws If no key is given and none is carried.
      */
-    roman(key?: Key): string;
+    roman(key?: Key, opts?: ChordToRomanOptions): string;
     /**
      * The chord's harmonic function (tonic / subdominant / dominant) in a key.
      *
@@ -823,10 +854,11 @@ declare class Chord {
      * Full functional analysis: function, borrowing, and Roman numeral.
      *
      * @param key Key to analyze in; falls back to the carried context.
+     * @param opts Applied-numeral rendering options.
      * @returns The chord analysis.
      * @throws If no key is given and none is carried.
      */
-    analyze(key?: Key): ChordAnalysis;
+    analyze(key?: Key, opts?: ChordToRomanOptions): ChordAnalysis;
     /**
      * Whether the chord is borrowed from the parallel mode (modal interchange).
      *
@@ -986,4 +1018,4 @@ declare class Chord {
     toString(): string;
 }
 
-export { BorrowedSource, Cadence, Chord, ChordAnalysis, Chord$1 as ChordData, ChordMatch, ChordQuality, ChordScaleMatch, ChordSpan, DetectChordOptions, DetectKeyOptions, HarmonicFunction, Interval, IntervalQualityLabel, Key, KeyScale, Note, Note$1 as NoteData, Progression, ScaleNameInput, SpelledInterval, StyledVoicingOptions, VoicingOptions };
+export { BorrowedSource, Cadence, Chord, ChordAnalysis, Chord$1 as ChordData, ChordMatch, ChordQuality, ChordScaleMatch, ChordSpan, ChordToRomanOptions, DetectChordOptions, DetectKeyOptions, type DetectedKeyMatch, HarmonicFunction, Interval, IntervalQualityLabel, Key, KeyMatch, KeyScale, KeyVariant, Note, Note$1 as NoteData, Progression, ScaleChoice, ScaleNameInput, SpelledInterval, StyledVoicingOptions, VoicingOptions };

package/dist/model/index.js

@@ -4,12 +4,12 @@ import {
   Key,
   Note,
   Progression
-} from "../chunk-EHVEBWM5.js";
-import "../chunk-GQSGS2N4.js";
-import "../chunk-KMHOICIY.js";
-import "../chunk-RK35RIN7.js";
-import "../chunk-D2FAJBYL.js";
-import "../chunk-XEBG3G53.js";
+} from "../chunk-3KX76RLG.js";
+import "../chunk-7JEP3MFY.js";
+import "../chunk-NNB67XA2.js";
+import "../chunk-7EONYVI5.js";
+import "../chunk-KBTTEX7Q.js";
+import "../chunk-R2VVFAIN.js";
 export {
   Chord,
   Interval,

package/dist/{styled-DIRkk9Uz.d.ts → styled-Bl0ZK28h.d.ts}

@@ -1,6 +1,14 @@
-import { C as Chord } from './index-C83mZI1P.js';
+import { C as Chord } from './index-COw1Ky9g.js';
 import { K as KeyScale } from './types-BN6_Q9Kl.js';
 
+/**
+ * Build a 12-bit mode mask from a list of semitone offsets above the root.
+ *
+ * Bit 0 (the root) is always set, enforcing the `KeyScale` invariant that the
+ * root is a scale tone even when the offset list omits 0.
+ *
+ * @category Scales
+ */
 declare function maskFromOffsets(offsets: readonly number[]): number;
 /**
  * Mode mask for the major (Ionian) scale: offsets {0, 2, 4, 5, 7, 9, 11}.
@@ -239,8 +247,8 @@ type ChordScaleMatch = {
  * conventional chord-scale relationship. Every entry of {@link NAMED_SCALES}
  * whose pitch-class set is a superset of the chord's is returned once per
  * distinct pitch-class set (aliased masks such as major/ionian report only the
- * modal name), ranked by fewest extra scale tones beyond the chord, then by
- * scale size (heptatonic before larger scales), then by conventional
+ * modal name), ranked by fewest extra scale tones beyond the chord and then by
+ * conventional
  * preference. For bare triads and smaller chords, heptatonic scales rank before
  * pentatonics and other sizes: a pentatonic adds no modal color over a triad,
  * so the seven-note modes are the more useful answer. The chromatic scale is
@@ -391,6 +399,15 @@ type VoicingOptions = {
      * @defaultValue 12
      */
     maxSpacing?: number;
+    /**
+     * Maximum candidate voicings evaluated for one chord.
+     *
+     * Raise this for large voicings when exact optimum matters more than bounded
+     * search time.
+     *
+     * @defaultValue 4000
+     */
+    maxCandidates?: number;
     /**
      * Maximum number of chords {@link voiceProgression} will voice. The search
      * per chord is bounded internally, so the cost of a progression is linear in
@@ -407,6 +424,12 @@ type VoicingOptions = {
      * voice-leading distance alone.
      */
     key?: KeyScale;
+    /**
+     * The chord that produced the current voicing passed to {@link nextVoicing}.
+     * When supplied, chordal-seventh resolution is scored exactly as it is by
+     * {@link voiceProgression}.
+     */
+    previousChord?: Chord;
 };
 /**
  * Realize a single chord as one MIDI pitch per voice, ascending (index 0 =
@@ -429,6 +452,20 @@ type VoicingOptions = {
  * @category Voicing & Counterpoint
  */
 declare function voiceChord(chord: Chord, opts?: VoicingOptions): number[];
+/**
+ * Voice a chord progression with smooth, bounded SATB-style leading.
+ *
+ * Each chord is chosen from a deterministic candidate set, minimizing motion
+ * while penalizing counterpoint violations. A supplied key additionally
+ * resolves leading tones and chordal sevenths.
+ *
+ * @param chords The chords to voice in order.
+ * @param opts Voicing options; defaults to four voices in {@link SATB_RANGES}.
+ * @returns One ascending MIDI voicing per chord.
+ * @throws {@link NoSolutionError} with the failing chord index when a chord
+ *   cannot fit the requested ranges.
+ * @category Voicing & Counterpoint
+ */
 declare function voiceProgression(chords: readonly Chord[], opts?: VoicingOptions): number[][];
 
 /**

package/dist/{styled-DJbkJQfj.d.cts → styled-Crv6SA4S.d.cts}

@@ -1,6 +1,14 @@
-import { C as Chord } from './index-y_ak9_Hi.cjs';
+import { C as Chord } from './index-oTQbYYIs.cjs';
 import { K as KeyScale } from './types-BN6_Q9Kl.cjs';
 
+/**
+ * Build a 12-bit mode mask from a list of semitone offsets above the root.
+ *
+ * Bit 0 (the root) is always set, enforcing the `KeyScale` invariant that the
+ * root is a scale tone even when the offset list omits 0.
+ *
+ * @category Scales
+ */
 declare function maskFromOffsets(offsets: readonly number[]): number;
 /**
  * Mode mask for the major (Ionian) scale: offsets {0, 2, 4, 5, 7, 9, 11}.
@@ -239,8 +247,8 @@ type ChordScaleMatch = {
  * conventional chord-scale relationship. Every entry of {@link NAMED_SCALES}
  * whose pitch-class set is a superset of the chord's is returned once per
  * distinct pitch-class set (aliased masks such as major/ionian report only the
- * modal name), ranked by fewest extra scale tones beyond the chord, then by
- * scale size (heptatonic before larger scales), then by conventional
+ * modal name), ranked by fewest extra scale tones beyond the chord and then by
+ * conventional
  * preference. For bare triads and smaller chords, heptatonic scales rank before
  * pentatonics and other sizes: a pentatonic adds no modal color over a triad,
  * so the seven-note modes are the more useful answer. The chromatic scale is
@@ -391,6 +399,15 @@ type VoicingOptions = {
      * @defaultValue 12
      */
     maxSpacing?: number;
+    /**
+     * Maximum candidate voicings evaluated for one chord.
+     *
+     * Raise this for large voicings when exact optimum matters more than bounded
+     * search time.
+     *
+     * @defaultValue 4000
+     */
+    maxCandidates?: number;
     /**
      * Maximum number of chords {@link voiceProgression} will voice. The search
      * per chord is bounded internally, so the cost of a progression is linear in
@@ -407,6 +424,12 @@ type VoicingOptions = {
      * voice-leading distance alone.
      */
     key?: KeyScale;
+    /**
+     * The chord that produced the current voicing passed to {@link nextVoicing}.
+     * When supplied, chordal-seventh resolution is scored exactly as it is by
+     * {@link voiceProgression}.
+     */
+    previousChord?: Chord;
 };
 /**
  * Realize a single chord as one MIDI pitch per voice, ascending (index 0 =
@@ -429,6 +452,20 @@ type VoicingOptions = {
  * @category Voicing & Counterpoint
  */
 declare function voiceChord(chord: Chord, opts?: VoicingOptions): number[];
+/**
+ * Voice a chord progression with smooth, bounded SATB-style leading.
+ *
+ * Each chord is chosen from a deterministic candidate set, minimizing motion
+ * while penalizing counterpoint violations. A supplied key additionally
+ * resolves leading tones and chordal sevenths.
+ *
+ * @param chords The chords to voice in order.
+ * @param opts Voicing options; defaults to four voices in {@link SATB_RANGES}.
+ * @returns One ascending MIDI voicing per chord.
+ * @throws {@link NoSolutionError} with the failing chord index when a chord
+ *   cannot fit the requested ranges.
+ * @category Voicing & Counterpoint
+ */
 declare function voiceProgression(chords: readonly Chord[], opts?: VoicingOptions): number[][];
 
 /**

package/dist/theory/index.cjs

@@ -1,13 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-T64C7ZD7.cjs');
 
 
-var _chunkFCANXBATcjs = require('../chunk-FCANXBAT.cjs');
+var _chunkYFJXS3AUcjs = require('../chunk-YFJXS3AU.cjs');
 
 
 
 
 
-var _chunkQ6OP4U43cjs = require('../chunk-Q6OP4U43.cjs');
+var _chunkWFDXOLUBcjs = require('../chunk-WFDXOLUB.cjs');
 
 
 
@@ -31,7 +31,7 @@ var _chunkQ6OP4U43cjs = require('../chunk-Q6OP4U43.cjs');
 
 
 
-var _chunkLW53AHQUcjs = require('../chunk-LW53AHQU.cjs');
+var _chunkOL3IHHSJcjs = require('../chunk-OL3IHHSJ.cjs');
 
 
 
@@ -86,8 +86,8 @@ var _chunkLW53AHQUcjs = require('../chunk-LW53AHQU.cjs');
 
 
 
-var _chunkFNDWXRRIcjs = require('../chunk-FNDWXRRI.cjs');
-require('../chunk-7MGZ7D62.cjs');
+var _chunkBSLTLGM3cjs = require('../chunk-BSLTLGM3.cjs');
+require('../chunk-PI3UXRWK.cjs');
 
 
 
@@ -169,5 +169,5 @@ require('../chunk-7MGZ7D62.cjs');
 
 
 
-exports.ALTERED_MASK = _chunkFNDWXRRIcjs.ALTERED_MASK; exports.BLUES_MASK = _chunkFNDWXRRIcjs.BLUES_MASK; exports.CHROMATIC_MASK = _chunkFNDWXRRIcjs.CHROMATIC_MASK; exports.DORIAN_MASK = _chunkFNDWXRRIcjs.DORIAN_MASK; exports.HARMONIC_MINOR_MASK = _chunkFNDWXRRIcjs.HARMONIC_MINOR_MASK; exports.LOCRIAN_MASK = _chunkFNDWXRRIcjs.LOCRIAN_MASK; exports.LOCRIAN_NATURAL2_MASK = _chunkFNDWXRRIcjs.LOCRIAN_NATURAL2_MASK; exports.LYDIAN_DOMINANT_MASK = _chunkFNDWXRRIcjs.LYDIAN_DOMINANT_MASK; exports.LYDIAN_MASK = _chunkFNDWXRRIcjs.LYDIAN_MASK; exports.MAJOR_MASK = _chunkFNDWXRRIcjs.MAJOR_MASK; exports.MAJOR_PENTATONIC_MASK = _chunkFNDWXRRIcjs.MAJOR_PENTATONIC_MASK; exports.MELODIC_MINOR_MASK = _chunkFNDWXRRIcjs.MELODIC_MINOR_MASK; exports.MINOR_PENTATONIC_MASK = _chunkFNDWXRRIcjs.MINOR_PENTATONIC_MASK; exports.MIXOLYDIAN_B13_MASK = _chunkFNDWXRRIcjs.MIXOLYDIAN_B13_MASK; exports.MIXOLYDIAN_MASK = _chunkFNDWXRRIcjs.MIXOLYDIAN_MASK; exports.NAMED_SCALES = _chunkFNDWXRRIcjs.NAMED_SCALES; exports.NATURAL_MINOR_MASK = _chunkFNDWXRRIcjs.NATURAL_MINOR_MASK; exports.NoteSafety = _chunkQ6OP4U43cjs.NoteSafety; exports.OCTATONIC_HALF_WHOLE_MASK = _chunkFNDWXRRIcjs.OCTATONIC_HALF_WHOLE_MASK; exports.OCTATONIC_WHOLE_HALF_MASK = _chunkFNDWXRRIcjs.OCTATONIC_WHOLE_HALF_MASK; exports.PHRYGIAN_DOMINANT_MASK = _chunkFNDWXRRIcjs.PHRYGIAN_DOMINANT_MASK; exports.PHRYGIAN_MASK = _chunkFNDWXRRIcjs.PHRYGIAN_MASK; exports.ReasonFlag = _chunkQ6OP4U43cjs.ReasonFlag; exports.SATB_RANGES = _chunkLW53AHQUcjs.SATB_RANGES; exports.WHOLE_TONE_MASK = _chunkFNDWXRRIcjs.WHOLE_TONE_MASK; exports.availableTensions = _chunkLW53AHQUcjs.availableTensions; exports.avoidNotes = _chunkLW53AHQUcjs.avoidNotes; exports.chordFromDegree = _chunkFNDWXRRIcjs.chordFromDegree; exports.chordPitchClasses = _chunkFNDWXRRIcjs.chordPitchClasses; exports.chordQualities = _chunkFNDWXRRIcjs.chordQualities; exports.chordScaleReport = _chunkLW53AHQUcjs.chordScaleReport; exports.chordScales = _chunkLW53AHQUcjs.chordScales; exports.chordToneRole = _chunkFNDWXRRIcjs.chordToneRole; exports.createsHiddenParallelPerfect = _chunkFNDWXRRIcjs.createsHiddenParallelPerfect; exports.createsParallelOctave = _chunkFNDWXRRIcjs.createsParallelOctave; exports.createsParallelPerfect = _chunkFNDWXRRIcjs.createsParallelPerfect; exports.createsParallelUnison = _chunkFNDWXRRIcjs.createsParallelUnison; exports.createsVerticalDissonance = _chunkFNDWXRRIcjs.createsVerticalDissonance; exports.createsVoiceCrossing = _chunkFNDWXRRIcjs.createsVoiceCrossing; exports.createsVoiceOverlap = _chunkFNDWXRRIcjs.createsVoiceOverlap; exports.diatonicPitchClasses = _chunkFNDWXRRIcjs.diatonicPitchClasses; exports.diatonicSeventh = _chunkFNDWXRRIcjs.diatonicSeventh; exports.diatonicTriad = _chunkFNDWXRRIcjs.diatonicTriad; exports.enumerateSafePitches = _chunkQ6OP4U43cjs.enumerateSafePitches; exports.evaluateSafety = _chunkQ6OP4U43cjs.evaluateSafety; exports.exceedsSpacing = _chunkFNDWXRRIcjs.exceedsSpacing; exports.formatChordSymbol = _chunkLW53AHQUcjs.formatChordSymbol; exports.intervalAboveRoot = _chunkFNDWXRRIcjs.intervalAboveRoot; exports.isChordMember = _chunkFNDWXRRIcjs.isChordMember; exports.isForbiddenMelodicLeap = _chunkFNDWXRRIcjs.isForbiddenMelodicLeap; exports.isLeadingToneResolution = _chunkFNDWXRRIcjs.isLeadingToneResolution; exports.isScaleTone = _chunkFNDWXRRIcjs.isScaleTone; exports.majorKey = _chunkFNDWXRRIcjs.majorKey; exports.makeChord = _chunkFNDWXRRIcjs.makeChord; exports.maskFromOffsets = _chunkFNDWXRRIcjs.maskFromOffsets; exports.minorKey = _chunkFNDWXRRIcjs.minorKey; exports.namedScaleMask = _chunkFNDWXRRIcjs.namedScaleMask; exports.nearestScaleTone = _chunkFNDWXRRIcjs.nearestScaleTone; exports.nextVoicing = _chunkLW53AHQUcjs.nextVoicing; exports.noteNames = _chunkLW53AHQUcjs.noteNames; exports.parseChordSymbol = _chunkLW53AHQUcjs.parseChordSymbol; exports.pitchToScaleDegree = _chunkFNDWXRRIcjs.pitchToScaleDegree; exports.requireScaleMask = _chunkFNDWXRRIcjs.requireScaleMask; exports.roleOf = _chunkFCANXBATcjs.roleOf; exports.scaleByName = _chunkFNDWXRRIcjs.scaleByName; exports.scaleMatchesChord = _chunkLW53AHQUcjs.scaleMatchesChord; exports.scaleTonesInDegreeOrder = _chunkFNDWXRRIcjs.scaleTonesInDegreeOrder; exports.scalesForChanges = _chunkLW53AHQUcjs.scalesForChanges; exports.spellChord = _chunkLW53AHQUcjs.spellChord; exports.spellChordFromRoot = _chunkLW53AHQUcjs.spellChordFromRoot; exports.spellPitch = _chunkLW53AHQUcjs.spellPitch; exports.spellPitchClass = _chunkLW53AHQUcjs.spellPitchClass; exports.spellPitchClasses = _chunkLW53AHQUcjs.spellPitchClasses; exports.spellScale = _chunkLW53AHQUcjs.spellScale; exports.transposeChord = _chunkFNDWXRRIcjs.transposeChord; exports.transposeChordSymbol = _chunkLW53AHQUcjs.transposeChordSymbol; exports.voiceChord = _chunkLW53AHQUcjs.voiceChord; exports.voiceChordStyled = _chunkLW53AHQUcjs.voiceChordStyled; exports.voiceLeadingCost = _chunkLW53AHQUcjs.voiceLeadingCost; exports.voiceProgression = _chunkLW53AHQUcjs.voiceProgression;
+exports.ALTERED_MASK = _chunkBSLTLGM3cjs.ALTERED_MASK; exports.BLUES_MASK = _chunkBSLTLGM3cjs.BLUES_MASK; exports.CHROMATIC_MASK = _chunkBSLTLGM3cjs.CHROMATIC_MASK; exports.DORIAN_MASK = _chunkBSLTLGM3cjs.DORIAN_MASK; exports.HARMONIC_MINOR_MASK = _chunkBSLTLGM3cjs.HARMONIC_MINOR_MASK; exports.LOCRIAN_MASK = _chunkBSLTLGM3cjs.LOCRIAN_MASK; exports.LOCRIAN_NATURAL2_MASK = _chunkBSLTLGM3cjs.LOCRIAN_NATURAL2_MASK; exports.LYDIAN_DOMINANT_MASK = _chunkBSLTLGM3cjs.LYDIAN_DOMINANT_MASK; exports.LYDIAN_MASK = _chunkBSLTLGM3cjs.LYDIAN_MASK; exports.MAJOR_MASK = _chunkBSLTLGM3cjs.MAJOR_MASK; exports.MAJOR_PENTATONIC_MASK = _chunkBSLTLGM3cjs.MAJOR_PENTATONIC_MASK; exports.MELODIC_MINOR_MASK = _chunkBSLTLGM3cjs.MELODIC_MINOR_MASK; exports.MINOR_PENTATONIC_MASK = _chunkBSLTLGM3cjs.MINOR_PENTATONIC_MASK; exports.MIXOLYDIAN_B13_MASK = _chunkBSLTLGM3cjs.MIXOLYDIAN_B13_MASK; exports.MIXOLYDIAN_MASK = _chunkBSLTLGM3cjs.MIXOLYDIAN_MASK; exports.NAMED_SCALES = _chunkBSLTLGM3cjs.NAMED_SCALES; exports.NATURAL_MINOR_MASK = _chunkBSLTLGM3cjs.NATURAL_MINOR_MASK; exports.NoteSafety = _chunkWFDXOLUBcjs.NoteSafety; exports.OCTATONIC_HALF_WHOLE_MASK = _chunkBSLTLGM3cjs.OCTATONIC_HALF_WHOLE_MASK; exports.OCTATONIC_WHOLE_HALF_MASK = _chunkBSLTLGM3cjs.OCTATONIC_WHOLE_HALF_MASK; exports.PHRYGIAN_DOMINANT_MASK = _chunkBSLTLGM3cjs.PHRYGIAN_DOMINANT_MASK; exports.PHRYGIAN_MASK = _chunkBSLTLGM3cjs.PHRYGIAN_MASK; exports.ReasonFlag = _chunkWFDXOLUBcjs.ReasonFlag; exports.SATB_RANGES = _chunkOL3IHHSJcjs.SATB_RANGES; exports.WHOLE_TONE_MASK = _chunkBSLTLGM3cjs.WHOLE_TONE_MASK; exports.availableTensions = _chunkOL3IHHSJcjs.availableTensions; exports.avoidNotes = _chunkOL3IHHSJcjs.avoidNotes; exports.chordFromDegree = _chunkBSLTLGM3cjs.chordFromDegree; exports.chordPitchClasses = _chunkBSLTLGM3cjs.chordPitchClasses; exports.chordQualities = _chunkBSLTLGM3cjs.chordQualities; exports.chordScaleReport = _chunkOL3IHHSJcjs.chordScaleReport; exports.chordScales = _chunkOL3IHHSJcjs.chordScales; exports.chordToneRole = _chunkBSLTLGM3cjs.chordToneRole; exports.createsHiddenParallelPerfect = _chunkBSLTLGM3cjs.createsHiddenParallelPerfect; exports.createsParallelOctave = _chunkBSLTLGM3cjs.createsParallelOctave; exports.createsParallelPerfect = _chunkBSLTLGM3cjs.createsParallelPerfect; exports.createsParallelUnison = _chunkBSLTLGM3cjs.createsParallelUnison; exports.createsVerticalDissonance = _chunkBSLTLGM3cjs.createsVerticalDissonance; exports.createsVoiceCrossing = _chunkBSLTLGM3cjs.createsVoiceCrossing; exports.createsVoiceOverlap = _chunkBSLTLGM3cjs.createsVoiceOverlap; exports.diatonicPitchClasses = _chunkBSLTLGM3cjs.diatonicPitchClasses; exports.diatonicSeventh = _chunkBSLTLGM3cjs.diatonicSeventh; exports.diatonicTriad = _chunkBSLTLGM3cjs.diatonicTriad; exports.enumerateSafePitches = _chunkWFDXOLUBcjs.enumerateSafePitches; exports.evaluateSafety = _chunkWFDXOLUBcjs.evaluateSafety; exports.exceedsSpacing = _chunkBSLTLGM3cjs.exceedsSpacing; exports.formatChordSymbol = _chunkOL3IHHSJcjs.formatChordSymbol; exports.intervalAboveRoot = _chunkBSLTLGM3cjs.intervalAboveRoot; exports.isChordMember = _chunkBSLTLGM3cjs.isChordMember; exports.isForbiddenMelodicLeap = _chunkBSLTLGM3cjs.isForbiddenMelodicLeap; exports.isLeadingToneResolution = _chunkBSLTLGM3cjs.isLeadingToneResolution; exports.isScaleTone = _chunkBSLTLGM3cjs.isScaleTone; exports.majorKey = _chunkBSLTLGM3cjs.majorKey; exports.makeChord = _chunkBSLTLGM3cjs.makeChord; exports.maskFromOffsets = _chunkBSLTLGM3cjs.maskFromOffsets; exports.minorKey = _chunkBSLTLGM3cjs.minorKey; exports.namedScaleMask = _chunkBSLTLGM3cjs.namedScaleMask; exports.nearestScaleTone = _chunkBSLTLGM3cjs.nearestScaleTone; exports.nextVoicing = _chunkOL3IHHSJcjs.nextVoicing; exports.noteNames = _chunkOL3IHHSJcjs.noteNames; exports.parseChordSymbol = _chunkOL3IHHSJcjs.parseChordSymbol; exports.pitchToScaleDegree = _chunkBSLTLGM3cjs.pitchToScaleDegree; exports.requireScaleMask = _chunkBSLTLGM3cjs.requireScaleMask; exports.roleOf = _chunkYFJXS3AUcjs.roleOf; exports.scaleByName = _chunkBSLTLGM3cjs.scaleByName; exports.scaleMatchesChord = _chunkOL3IHHSJcjs.scaleMatchesChord; exports.scaleTonesInDegreeOrder = _chunkBSLTLGM3cjs.scaleTonesInDegreeOrder; exports.scalesForChanges = _chunkOL3IHHSJcjs.scalesForChanges; exports.spellChord = _chunkOL3IHHSJcjs.spellChord; exports.spellChordFromRoot = _chunkOL3IHHSJcjs.spellChordFromRoot; exports.spellPitch = _chunkOL3IHHSJcjs.spellPitch; exports.spellPitchClass = _chunkOL3IHHSJcjs.spellPitchClass; exports.spellPitchClasses = _chunkOL3IHHSJcjs.spellPitchClasses; exports.spellScale = _chunkOL3IHHSJcjs.spellScale; exports.transposeChord = _chunkBSLTLGM3cjs.transposeChord; exports.transposeChordSymbol = _chunkOL3IHHSJcjs.transposeChordSymbol; exports.voiceChord = _chunkOL3IHHSJcjs.voiceChord; exports.voiceChordStyled = _chunkOL3IHHSJcjs.voiceChordStyled; exports.voiceLeadingCost = _chunkOL3IHHSJcjs.voiceLeadingCost; exports.voiceProgression = _chunkOL3IHHSJcjs.voiceProgression;
 //# sourceMappingURL=index.cjs.map

package/dist/theory/index.d.cts

@@ -1,11 +1,11 @@
-import { N as Note } from '../index-OG65ocOr.cjs';
+import { N as Note } from '../index-tR9jTn26.cjs';
 import { K as KeyScale } from '../types-BN6_Q9Kl.cjs';
-import { C as Chord } from '../index-y_ak9_Hi.cjs';
-export { a as ChordQuality, b as ChordSegment, c as ChordSpan, d as ChordToneRole, P as PitchSpelling, e as chordFromDegree, f as chordPitchClasses, g as chordQualities, h as chordToneRole, i as diatonicSeventh, j as diatonicTriad, k as intervalAboveRoot, l as isChordMember, m as makeChord, t as transposeChord } from '../index-y_ak9_Hi.cjs';
-import { p as ScaleNameInput, r as VoicingOptions } from '../styled-DJbkJQfj.cjs';
-export { A as ALTERED_MASK, B as BLUES_MASK, C as CHROMATIC_MASK, a as ChordScaleMatch, b as ChordScaleReportEntry, D as DORIAN_MASK, H as HARMONIC_MINOR_MASK, L as LOCRIAN_MASK, c as LOCRIAN_NATURAL2_MASK, d as LYDIAN_DOMINANT_MASK, e as LYDIAN_MASK, M as MAJOR_MASK, f as MAJOR_PENTATONIC_MASK, g as MELODIC_MINOR_MASK, h as MINOR_PENTATONIC_MASK, i as MIXOLYDIAN_B13_MASK, j as MIXOLYDIAN_MASK, N as NAMED_SCALES, k as NATURAL_MINOR_MASK, O as OCTATONIC_HALF_WHOLE_MASK, l as OCTATONIC_WHOLE_HALF_MASK, P as PHRYGIAN_DOMINANT_MASK, m as PHRYGIAN_MASK, S as SATB_RANGES, n as ScaleChoice, o as ScaleName, q as StyledVoicingOptions, V as VoiceRange, s as VoicingStyle, W as WHOLE_TONE_MASK, t as availableTensions, u as avoidNotes, v as chordScaleReport, w as chordScales, x as maskFromOffsets, y as namedScaleMask, z as requireScaleMask, E as scaleMatchesChord, F as scalesForChanges, G as voiceChord, I as voiceChordStyled, J as voiceProgression } from '../styled-DJbkJQfj.cjs';
-export { H as HarmonyRole, L as LockLevel, V as VoicedRole, r as roleOf } from '../index-D6b6na69.cjs';
-export { E as EvaluateSafetyOptions, N as NoteSafety, R as ReasonFlag, S as SafetyProfile, a as SafetyQuery, b as SafetyResult, V as VoiceSnapshot, e as enumerateSafePitches, c as evaluateSafety } from '../index-tJhkmQgE.cjs';
+import { C as Chord } from '../index-oTQbYYIs.cjs';
+export { a as ChordQuality, b as ChordSegment, c as ChordSpan, d as ChordToneRole, P as PitchSpelling, e as chordFromDegree, f as chordPitchClasses, g as chordQualities, h as chordToneRole, i as diatonicSeventh, j as diatonicTriad, k as intervalAboveRoot, l as isChordMember, m as makeChord, t as transposeChord } from '../index-oTQbYYIs.cjs';
+import { p as ScaleNameInput, r as VoicingOptions } from '../styled-Crv6SA4S.cjs';
+export { A as ALTERED_MASK, B as BLUES_MASK, C as CHROMATIC_MASK, a as ChordScaleMatch, b as ChordScaleReportEntry, D as DORIAN_MASK, H as HARMONIC_MINOR_MASK, L as LOCRIAN_MASK, c as LOCRIAN_NATURAL2_MASK, d as LYDIAN_DOMINANT_MASK, e as LYDIAN_MASK, M as MAJOR_MASK, f as MAJOR_PENTATONIC_MASK, g as MELODIC_MINOR_MASK, h as MINOR_PENTATONIC_MASK, i as MIXOLYDIAN_B13_MASK, j as MIXOLYDIAN_MASK, N as NAMED_SCALES, k as NATURAL_MINOR_MASK, O as OCTATONIC_HALF_WHOLE_MASK, l as OCTATONIC_WHOLE_HALF_MASK, P as PHRYGIAN_DOMINANT_MASK, m as PHRYGIAN_MASK, S as SATB_RANGES, n as ScaleChoice, o as ScaleName, q as StyledVoicingOptions, V as VoiceRange, s as VoicingStyle, W as WHOLE_TONE_MASK, t as availableTensions, u as avoidNotes, v as chordScaleReport, w as chordScales, x as maskFromOffsets, y as namedScaleMask, z as requireScaleMask, E as scaleMatchesChord, F as scalesForChanges, G as voiceChord, I as voiceChordStyled, J as voiceProgression } from '../styled-Crv6SA4S.cjs';
+export { H as HarmonyRole, L as LockLevel, V as VoicedRole, r as roleOf } from '../index-x2vcsduE.cjs';
+export { E as EvaluateSafetyOptions, N as NoteSafety, R as ReasonFlag, S as SafetyProfile, a as SafetyQuery, b as SafetyResult, V as VoiceSnapshot, e as enumerateSafePitches, c as evaluateSafety } from '../index-B2Ulxxpo.cjs';
 
 /**
  * Test whether a pitch belongs to the scale.
@@ -319,8 +319,8 @@ declare function spellPitchClasses(pcs: number[], tonic: Note, key: KeyScale): N
 /**
  * Spell chord tones from an already chosen root spelling.
  *
- * This is exported for the model layer's inversion support; the package
- * barrels intentionally expose the key-aware {@link spellChord} entry point.
+ * This is public for callers that already know the desired root spelling;
+ * {@link spellChord} instead derives that spelling from the chord and key.
  */
 declare function spellChordFromRoot(chord: Chord, root: Note): Note[];
 /**

package/dist/theory/index.d.ts

@@ -1,11 +1,11 @@
-import { N as Note } from '../index-OG65ocOr.js';
+import { N as Note } from '../index-tR9jTn26.js';
 import { K as KeyScale } from '../types-BN6_Q9Kl.js';
-import { C as Chord } from '../index-C83mZI1P.js';
-export { a as ChordQuality, b as ChordSegment, c as ChordSpan, d as ChordToneRole, P as PitchSpelling, e as chordFromDegree, f as chordPitchClasses, g as chordQualities, h as chordToneRole, i as diatonicSeventh, j as diatonicTriad, k as intervalAboveRoot, l as isChordMember, m as makeChord, t as transposeChord } from '../index-C83mZI1P.js';
-import { p as ScaleNameInput, r as VoicingOptions } from '../styled-DIRkk9Uz.js';
-export { A as ALTERED_MASK, B as BLUES_MASK, C as CHROMATIC_MASK, a as ChordScaleMatch, b as ChordScaleReportEntry, D as DORIAN_MASK, H as HARMONIC_MINOR_MASK, L as LOCRIAN_MASK, c as LOCRIAN_NATURAL2_MASK, d as LYDIAN_DOMINANT_MASK, e as LYDIAN_MASK, M as MAJOR_MASK, f as MAJOR_PENTATONIC_MASK, g as MELODIC_MINOR_MASK, h as MINOR_PENTATONIC_MASK, i as MIXOLYDIAN_B13_MASK, j as MIXOLYDIAN_MASK, N as NAMED_SCALES, k as NATURAL_MINOR_MASK, O as OCTATONIC_HALF_WHOLE_MASK, l as OCTATONIC_WHOLE_HALF_MASK, P as PHRYGIAN_DOMINANT_MASK, m as PHRYGIAN_MASK, S as SATB_RANGES, n as ScaleChoice, o as ScaleName, q as StyledVoicingOptions, V as VoiceRange, s as VoicingStyle, W as WHOLE_TONE_MASK, t as availableTensions, u as avoidNotes, v as chordScaleReport, w as chordScales, x as maskFromOffsets, y as namedScaleMask, z as requireScaleMask, E as scaleMatchesChord, F as scalesForChanges, G as voiceChord, I as voiceChordStyled, J as voiceProgression } from '../styled-DIRkk9Uz.js';
-export { H as HarmonyRole, L as LockLevel, V as VoicedRole, r as roleOf } from '../index-tSQh-xwY.js';
-export { E as EvaluateSafetyOptions, N as NoteSafety, R as ReasonFlag, S as SafetyProfile, a as SafetyQuery, b as SafetyResult, V as VoiceSnapshot, e as enumerateSafePitches, c as evaluateSafety } from '../index-6VR8-kit.js';
+import { C as Chord } from '../index-COw1Ky9g.js';
+export { a as ChordQuality, b as ChordSegment, c as ChordSpan, d as ChordToneRole, P as PitchSpelling, e as chordFromDegree, f as chordPitchClasses, g as chordQualities, h as chordToneRole, i as diatonicSeventh, j as diatonicTriad, k as intervalAboveRoot, l as isChordMember, m as makeChord, t as transposeChord } from '../index-COw1Ky9g.js';
+import { p as ScaleNameInput, r as VoicingOptions } from '../styled-Bl0ZK28h.js';
+export { A as ALTERED_MASK, B as BLUES_MASK, C as CHROMATIC_MASK, a as ChordScaleMatch, b as ChordScaleReportEntry, D as DORIAN_MASK, H as HARMONIC_MINOR_MASK, L as LOCRIAN_MASK, c as LOCRIAN_NATURAL2_MASK, d as LYDIAN_DOMINANT_MASK, e as LYDIAN_MASK, M as MAJOR_MASK, f as MAJOR_PENTATONIC_MASK, g as MELODIC_MINOR_MASK, h as MINOR_PENTATONIC_MASK, i as MIXOLYDIAN_B13_MASK, j as MIXOLYDIAN_MASK, N as NAMED_SCALES, k as NATURAL_MINOR_MASK, O as OCTATONIC_HALF_WHOLE_MASK, l as OCTATONIC_WHOLE_HALF_MASK, P as PHRYGIAN_DOMINANT_MASK, m as PHRYGIAN_MASK, S as SATB_RANGES, n as ScaleChoice, o as ScaleName, q as StyledVoicingOptions, V as VoiceRange, s as VoicingStyle, W as WHOLE_TONE_MASK, t as availableTensions, u as avoidNotes, v as chordScaleReport, w as chordScales, x as maskFromOffsets, y as namedScaleMask, z as requireScaleMask, E as scaleMatchesChord, F as scalesForChanges, G as voiceChord, I as voiceChordStyled, J as voiceProgression } from '../styled-Bl0ZK28h.js';
+export { H as HarmonyRole, L as LockLevel, V as VoicedRole, r as roleOf } from '../index-Cfx8xgH0.js';
+export { E as EvaluateSafetyOptions, N as NoteSafety, R as ReasonFlag, S as SafetyProfile, a as SafetyQuery, b as SafetyResult, V as VoiceSnapshot, e as enumerateSafePitches, c as evaluateSafety } from '../index-BuaB-ypt.js';
 
 /**
  * Test whether a pitch belongs to the scale.
@@ -319,8 +319,8 @@ declare function spellPitchClasses(pcs: number[], tonic: Note, key: KeyScale): N
 /**
  * Spell chord tones from an already chosen root spelling.
  *
- * This is exported for the model layer's inversion support; the package
- * barrels intentionally expose the key-aware {@link spellChord} entry point.
+ * This is public for callers that already know the desired root spelling;
+ * {@link spellChord} instead derives that spelling from the chord and key.
  */
 declare function spellChordFromRoot(chord: Chord, root: Note): Note[];
 /**