@musodojo/music-theory-data 32.0.0 → 34.0.0

package/script/src/data/chords/mod.js

@@ -1,7 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.lowerCaseRomanNumerals = exports.upperCaseRomanNumerals = exports.melodicMinorSeventhChords = exports.melodicMinorTriads = exports.harmonicMinorSeventhChords = exports.harmonicMinorTriads = exports.diatonicSeventhChords = exports.diatonicTriads = exports.chordQualityRomanRenderings = exports.chordQualityNoteCollectionKeys = exports.chordQualities = exports.seventhChordQualities = exports.triadChordQualities = void 0;
+exports.lowerCaseRomanNumerals = exports.upperCaseRomanNumerals = exports.melodicMinorSeventhChords = exports.melodicMinorTriads = exports.harmonicMinorSeventhChords = exports.harmonicMinorTriads = exports.diatonicSeventhChords = exports.diatonicTriads = exports.chordQualityRomanRenderings = exports.chordCollectionSymbolRenderings = exports.chordQualityNoteCollectionKeys = exports.chordQualityChordCollectionKeys = exports.chordQualities = exports.seventhChordQualities = exports.triadChordQualities = void 0;
 exports.getChordQualityNoteCollectionKey = getChordQualityNoteCollectionKey;
+exports.getChordQualityChordCollectionKey = getChordQualityChordCollectionKey;
+exports.getChordCollectionSymbolRendering = getChordCollectionSymbolRendering;
+exports.getChordCollectionChordSuffix = getChordCollectionChordSuffix;
+exports.getChordCollectionRomanSuffix = getChordCollectionRomanSuffix;
 const _triadChordQualities = ["M", "m", "°", "+"];
 const _seventhChordQualities = [
     "M7",
@@ -47,6 +51,55 @@ const _chordQualityNoteCollectionKeys = {
     "+M7": "augmentedMajor7",
     "M7♯5": "augmentedMajor7",
 };
+const _chordCollectionSymbolRenderings = {
+    major: { chordSuffix: "M", romanSuffix: "", numeralCase: "upper" },
+    major6: { chordSuffix: "6", romanSuffix: "6", numeralCase: "upper" },
+    major7: { chordSuffix: "M7", romanSuffix: "M7", numeralCase: "upper" },
+    major9: { chordSuffix: "M9", romanSuffix: "M9", numeralCase: "upper" },
+    majorAdd9: {
+        chordSuffix: "add9",
+        romanSuffix: "add9",
+        numeralCase: "upper",
+    },
+    major6Add9: { chordSuffix: "6/9", romanSuffix: "6/9", numeralCase: "upper" },
+    minor: { chordSuffix: "m", romanSuffix: "", numeralCase: "lower" },
+    minor6: { chordSuffix: "m6", romanSuffix: "m6", numeralCase: "lower" },
+    minor7: { chordSuffix: "m7", romanSuffix: "m7", numeralCase: "lower" },
+    minorMajor7: {
+        chordSuffix: "m(M7)",
+        romanSuffix: "M7",
+        numeralCase: "lower",
+    },
+    minor9: { chordSuffix: "m9", romanSuffix: "m9", numeralCase: "lower" },
+    minorAdd9: {
+        chordSuffix: "m(add9)",
+        romanSuffix: "m(add9)",
+        numeralCase: "lower",
+    },
+    minor6Add9: {
+        chordSuffix: "m6/9",
+        romanSuffix: "m6/9",
+        numeralCase: "lower",
+    },
+    dominant7: { chordSuffix: "7", romanSuffix: "7", numeralCase: "upper" },
+    dominant9: { chordSuffix: "9", romanSuffix: "9", numeralCase: "upper" },
+    dominant11: { chordSuffix: "11", romanSuffix: "11", numeralCase: "upper" },
+    dominant13: { chordSuffix: "13", romanSuffix: "13", numeralCase: "upper" },
+    diminishedTriad: { chordSuffix: "°", romanSuffix: "°", numeralCase: "lower" },
+    diminished7: { chordSuffix: "°7", romanSuffix: "°7", numeralCase: "lower" },
+    halfDiminished7: {
+        chordSuffix: "ø7",
+        romanSuffix: "ø7",
+        numeralCase: "lower",
+    },
+    augmentedTriad: { chordSuffix: "+", romanSuffix: "+", numeralCase: "upper" },
+    augmented7: { chordSuffix: "+7", romanSuffix: "+7", numeralCase: "upper" },
+    augmentedMajor7: {
+        chordSuffix: "+M7",
+        romanSuffix: "+M7",
+        numeralCase: "upper",
+    },
+};
 /** The complete set of supported triad chord qualities. */
 exports.triadChordQualities = _triadChordQualities;
 /** The complete set of supported seventh chord qualities. */
@@ -56,8 +109,12 @@ exports.chordQualities = [
     ...exports.triadChordQualities,
     ...exports.seventhChordQualities,
 ];
+/** Chord collection keys for every supported chord quality. */
+exports.chordQualityChordCollectionKeys = _chordQualityNoteCollectionKeys;
 /** Note-collection keys for every supported chord quality. */
-exports.chordQualityNoteCollectionKeys = _chordQualityNoteCollectionKeys;
+exports.chordQualityNoteCollectionKeys = exports.chordQualityChordCollectionKeys;
+/** Symbol rendering metadata for every built-in chord collection. */
+exports.chordCollectionSymbolRenderings = _chordCollectionSymbolRenderings;
 /** Roman numeral rendering metadata for each supported chord quality. */
 exports.chordQualityRomanRenderings = new Map([
     ["M", { numeralCase: "upper", suffix: "" }],
@@ -142,3 +199,19 @@ exports.lowerCaseRomanNumerals = _lowerCaseRomanNumerals;
 function getChordQualityNoteCollectionKey(quality) {
     return exports.chordQualityNoteCollectionKeys[quality];
 }
+/** Returns the chord-collection key that describes the notes in a chord quality. */
+function getChordQualityChordCollectionKey(quality) {
+    return exports.chordQualityChordCollectionKeys[quality];
+}
+/** Returns symbol rendering metadata for a chord collection. */
+function getChordCollectionSymbolRendering(chordCollectionKey) {
+    return exports.chordCollectionSymbolRenderings[chordCollectionKey];
+}
+/** Returns the chord-symbol suffix for a chord collection. */
+function getChordCollectionChordSuffix(chordCollectionKey) {
+    return getChordCollectionSymbolRendering(chordCollectionKey).chordSuffix;
+}
+/** Returns the roman-symbol suffix for a chord collection. */
+function getChordCollectionRomanSuffix(chordCollectionKey) {
+    return getChordCollectionSymbolRendering(chordCollectionKey).romanSuffix;
+}

package/script/src/data/labels/mod.d.ts

@@ -1,3 +1,4 @@
 export * from "./note-label-collections.js";
 export * from "./note-labels.js";
+export * from "./solfege.js";
 //# sourceMappingURL=mod.d.ts.map

package/script/src/data/labels/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/mod.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/mod.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}

package/script/src/data/labels/mod.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./note-label-collections.js"), exports);
 __exportStar(require("./note-labels.js"), exports);
+__exportStar(require("./solfege.js"), exports);

package/script/src/data/labels/note-label-collections.d.ts

@@ -45,34 +45,10 @@ declare const _noteLabelCollections: {
         readonly mode: "relative";
         readonly labels: readonly ["1", "♯1", "9", "♯9", "3", "11", "♯11", "5", "♯5", "13", "♯13", "7"];
     };
-    readonly fixedDoFlat: {
-        readonly name: "Solfege Fixed Do Flat Notes";
-        readonly shortName: "Fixed Do Flat";
-        readonly mode: "absolute";
-        readonly labels: readonly ["do", "re♭", "re", "mi♭", "mi", "fa", "sol♭", "sol", "la♭", "la", "si♭", "si"];
-    };
-    readonly fixedDoSharp: {
-        readonly name: "Solfege Fixed Do Sharp Notes";
-        readonly shortName: "Fixed Do Sharp";
-        readonly mode: "absolute";
-        readonly labels: readonly ["do", "do♯", "re", "re♯", "mi", "fa", "fa♯", "sol", "sol♯", "la", "la♯", "si"];
-    };
-    readonly movableDo: {
-        readonly name: "Solfege Movable Do Notes";
-        readonly shortName: "Movable Do";
-        readonly mode: "relative";
-        readonly labels: readonly ["do", "ra", "re", "me", "mi", "fa", "fi", "sol", "le", "la", "te", "ti"];
-    };
-    readonly movableLa: {
-        readonly name: "Solfege Movable La Notes";
-        readonly shortName: "Movable La";
-        readonly mode: "relative";
-        readonly labels: readonly ["la", "te", "ti", "do", "di", "re", "re", "mi", "fa", "fi", "sol", "si"];
-    };
 };
 /** A union string of valid keys to lookup different note label collections. */
 export type NoteLabelCollectionKey = keyof typeof _noteLabelCollections;
-/** A dictionary holding arrays mapping integer semitones into note/solfege names for varied contexts. */
+/** A dictionary holding arrays mapping integer semitones into note and interval labels for varied contexts. */
 export declare const noteLabelCollections: Record<NoteLabelCollectionKey, NoteLabelCollection>;
 export {};
 //# sourceMappingURL=note-label-collections.d.ts.map

package/script/src/data/labels/note-label-collections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"note-label-collections.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/note-label-collections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAErE,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;AAEpD,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoJjB,CAAC;AAEX,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAExE,yGAAyG;AACzG,eAAO,MAAM,oBAAoB,EAAE,MAAM,CACvC,sBAAsB,EACtB,mBAAmB,CACI,CAAC"}
+{"version":3,"file":"note-label-collections.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/note-label-collections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAErE,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;AAEpD,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoEjB,CAAC;AAEX,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAExE,+GAA+G;AAC/G,eAAO,MAAM,oBAAoB,EAAE,MAAM,CACvC,sBAAsB,EACtB,mBAAmB,CACI,CAAC"}

package/script/src/data/labels/note-label-collections.js

@@ -64,82 +64,6 @@ const _noteLabelCollections = {
             "7",
         ],
     },
-    fixedDoFlat: {
-        name: "Solfege Fixed Do Flat Notes",
-        shortName: "Fixed Do Flat",
-        mode: "absolute",
-        labels: [
-            "do",
-            "re♭",
-            "re",
-            "mi♭",
-            "mi",
-            "fa",
-            "sol♭",
-            "sol",
-            "la♭",
-            "la",
-            "si♭",
-            "si",
-        ],
-    },
-    fixedDoSharp: {
-        name: "Solfege Fixed Do Sharp Notes",
-        shortName: "Fixed Do Sharp",
-        mode: "absolute",
-        labels: [
-            "do",
-            "do♯",
-            "re",
-            "re♯",
-            "mi",
-            "fa",
-            "fa♯",
-            "sol",
-            "sol♯",
-            "la",
-            "la♯",
-            "si",
-        ],
-    },
-    movableDo: {
-        name: "Solfege Movable Do Notes",
-        shortName: "Movable Do",
-        mode: "relative",
-        labels: [
-            "do",
-            "ra",
-            "re",
-            "me",
-            "mi",
-            "fa",
-            "fi",
-            "sol",
-            "le",
-            "la",
-            "te",
-            "ti",
-        ],
-    },
-    movableLa: {
-        name: "Solfege Movable La Notes",
-        shortName: "Movable La",
-        mode: "relative",
-        labels: [
-            "la",
-            "te",
-            "ti",
-            "do",
-            "di",
-            "re",
-            "re",
-            "mi",
-            "fa",
-            "fi",
-            "sol",
-            "si",
-        ],
-    },
 };
-/** A dictionary holding arrays mapping integer semitones into note/solfege names for varied contexts. */
+/** A dictionary holding arrays mapping integer semitones into note and interval labels for varied contexts. */
 exports.noteLabelCollections = _noteLabelCollections;

package/script/src/data/labels/note-labels.d.ts

@@ -91,7 +91,7 @@ declare const _simpleIntervalToIntegerMap: {
     readonly "\u266F8": 13;
     readonly "\uD834\uDD2A8": 14;
 };
-/** A fully qualified simple (single octave) interval string, including an optional accidental symbol (e.g., "M3", "b7"). */
+/** A fully qualified simple (single octave) interval string, including an optional accidental symbol (e.g., "3", "♯4", "♭7"). */
 export type SimpleInterval = keyof typeof _simpleIntervalToIntegerMap;
 /** A numeric string representing the numerical span of a compound interval (e.g. "9", "13"). */
 export type CompoundIntervalNumber = "9" | "10" | "11" | "12" | "13" | "14" | "15";

package/script/src/data/labels/note-labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"note-labels.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/note-labels.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"note-labels.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/note-labels.ts"],"names":[],"mappings":"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"}

package/script/src/data/labels/solfege.d.ts

@@ -0,0 +1,33 @@
+import type { Interval, NoteLetter, NoteName, SimpleInterval } from "./note-labels.js";
+export type FixedDoSeventhSyllable = "si" | "ti";
+export type FixedDoAccidentalPolicy = "omitAccidentals" | "symbolAccidentals";
+export interface FixedDoSyllableOptions {
+    readonly seventhSyllable?: FixedDoSeventhSyllable;
+    readonly accidentalPolicy?: FixedDoAccidentalPolicy;
+}
+export type FixedDoBaseSyllable = "do" | "re" | "mi" | "fa" | "sol" | "la" | FixedDoSeventhSyllable;
+export type MovableDoSyllable = "do" | "di" | "ra" | "re" | "ri" | "me" | "ma" | "mi" | "fa" | "fi" | "se" | "sol" | "si" | "le" | "lo" | "la" | "li" | "te" | "ta" | "ti";
+export interface MovableDoSyllableEntry {
+    readonly syllable: MovableDoSyllable;
+    readonly aliases?: readonly MovableDoSyllable[];
+    readonly note?: string;
+}
+export type MovableDoSystem = "doBased" | "laBasedMinor";
+export interface SolfegeSystemMetadata {
+    readonly name: string;
+    readonly shortName: string;
+    readonly description: string;
+}
+export type SolfegeSystemKey = "fixedDo" | MovableDoSystem;
+export declare const solfegeSystemMetadata: Readonly<Record<SolfegeSystemKey, SolfegeSystemMetadata>>;
+export declare const defaultFixedDoSyllableOptions: Required<FixedDoSyllableOptions>;
+export declare const fixedDoNoteLetterToSyllableMaps: Readonly<Record<FixedDoSeventhSyllable, ReadonlyMap<NoteLetter, FixedDoBaseSyllable>>>;
+export declare function getFixedDoSyllableForNoteName(noteName: NoteName, options?: FixedDoSyllableOptions): string;
+export declare function getFixedDoSyllablesForNoteNames(noteNames: readonly NoteName[], options?: FixedDoSyllableOptions): string[];
+export declare const movableDoIntervalToSyllableMap: ReadonlyMap<SimpleInterval, MovableDoSyllableEntry>;
+export declare const movableLaBasedMinorIntervalToSyllableMap: ReadonlyMap<SimpleInterval, MovableDoSyllableEntry>;
+export declare const movableDoIntervalSyllableMaps: Readonly<Record<MovableDoSystem, ReadonlyMap<SimpleInterval, MovableDoSyllableEntry>>>;
+export declare function getMovableDoSyllableEntryForInterval(interval: Interval, system?: MovableDoSystem): MovableDoSyllableEntry | undefined;
+export declare function getMovableDoSyllableForInterval(interval: Interval, system?: MovableDoSystem): MovableDoSyllable | undefined;
+export declare function getMovableDoSyllablesForIntervals(intervals: readonly Interval[], system?: MovableDoSystem): (MovableDoSyllable | undefined)[];
+//# sourceMappingURL=solfege.d.ts.map

package/script/src/data/labels/solfege.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solfege.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/solfege.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,cAAc,EACf,MAAM,kBAAkB,CAAC;AAG1B,MAAM,MAAM,sBAAsB,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,MAAM,MAAM,uBAAuB,GAC/B,iBAAiB,GACjB,mBAAmB,CAAC;AAExB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAC;IAClD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;CACrD;AAED,MAAM,MAAM,mBAAmB,GAC3B,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,sBAAsB,CAAC;AAE3B,MAAM,MAAM,iBAAiB,GACzB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAET,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,cAAc,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,eAAe,CAAC;AAE3D,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAoBhD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,sBAAsB,CAG1E,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CACpD,MAAM,CAAC,sBAAsB,EAAE,WAAW,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAoB7E,CAAC;AAwCF,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAgBR;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,sBAA2B,GACnC,MAAM,EAAE,CAIV;AAED,eAAO,MAAM,8BAA8B,EAAE,WAAW,CACtD,cAAc,EACd,sBAAsB,CAwCtB,CAAC;AAEH,eAAO,MAAM,wCAAwC,EAAE,WAAW,CAChE,cAAc,EACd,sBAAsB,CA4BtB,CAAC;AAEH,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAClD,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,cAAc,EAAE,sBAAsB,CAAC,CAAC,CAI7E,CAAC;AAEF,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,QAAQ,EAClB,MAAM,GAAE,eAA2B,GAClC,sBAAsB,GAAG,SAAS,CAQpC;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,QAAQ,EAClB,MAAM,GAAE,eAA2B,GAClC,iBAAiB,GAAG,SAAS,CAE/B;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,MAAM,GAAE,eAA2B,GAClC,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,CAInC"}

package/script/src/data/labels/solfege.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.movableDoIntervalSyllableMaps = exports.movableLaBasedMinorIntervalToSyllableMap = exports.movableDoIntervalToSyllableMap = exports.fixedDoNoteLetterToSyllableMaps = exports.defaultFixedDoSyllableOptions = exports.solfegeSystemMetadata = void 0;
+exports.getFixedDoSyllableForNoteName = getFixedDoSyllableForNoteName;
+exports.getFixedDoSyllablesForNoteNames = getFixedDoSyllablesForNoteNames;
+exports.getMovableDoSyllableEntryForInterval = getMovableDoSyllableEntryForInterval;
+exports.getMovableDoSyllableForInterval = getMovableDoSyllableForInterval;
+exports.getMovableDoSyllablesForIntervals = getMovableDoSyllablesForIntervals;
+const note_labels_js_1 = require("./note-labels.js");
+exports.solfegeSystemMetadata = {
+    fixedDo: {
+        name: "Fixed Do",
+        shortName: "Fixed Do",
+        description: "Names notes by letter with do for C, re for D, mi for E, fa for F, sol for G, la for A, and si or ti for B.",
+    },
+    doBased: {
+        name: "Movable Do",
+        shortName: "Movable Do",
+        description: "Names intervals relative to the tonic, with do as the tonic in both major and minor contexts.",
+    },
+    laBasedMinor: {
+        name: "Movable La-Based Minor",
+        shortName: "Movable La",
+        description: "Names intervals relative to a minor tonic treated as la, a convention common in some choral and teaching contexts.",
+    },
+};
+exports.defaultFixedDoSyllableOptions = {
+    seventhSyllable: "si",
+    accidentalPolicy: "omitAccidentals",
+};
+exports.fixedDoNoteLetterToSyllableMaps = {
+    si: new Map([
+        ["C", "do"],
+        ["D", "re"],
+        ["E", "mi"],
+        ["F", "fa"],
+        ["G", "sol"],
+        ["A", "la"],
+        ["B", "si"],
+    ]),
+    ti: new Map([
+        ["C", "do"],
+        ["D", "re"],
+        ["E", "mi"],
+        ["F", "fa"],
+        ["G", "sol"],
+        ["A", "la"],
+        ["B", "ti"],
+    ]),
+};
+const SIMPLE_INTERVAL_NUMBER_REGEX = /\d+$/;
+function getNoteLetterFromNoteName(noteName) {
+    return noteName.charAt(0);
+}
+function getAccidentalSymbolsFromNoteName(noteName) {
+    return noteName.slice(1);
+}
+function getFixedDoOptions(options) {
+    return {
+        ...exports.defaultFixedDoSyllableOptions,
+        ...options,
+    };
+}
+function isSimpleIntervalValue(interval) {
+    const match = interval.match(SIMPLE_INTERVAL_NUMBER_REGEX);
+    return match !== null && Number(match[0]) <= 8;
+}
+function getSimpleIntervalForMovableDo(interval) {
+    const compoundAsSimple = note_labels_js_1.compoundToSimpleIntervalMap.get(interval);
+    if (compoundAsSimple !== undefined) {
+        return compoundAsSimple;
+    }
+    return isSimpleIntervalValue(interval) ? interval : undefined;
+}
+function getFixedDoSyllableForNoteName(noteName, options = {}) {
+    const { seventhSyllable, accidentalPolicy } = getFixedDoOptions(options);
+    const noteLetter = getNoteLetterFromNoteName(noteName);
+    const baseSyllable = exports.fixedDoNoteLetterToSyllableMaps[seventhSyllable].get(noteLetter);
+    if (baseSyllable === undefined) {
+        return "";
+    }
+    if (accidentalPolicy === "omitAccidentals") {
+        return baseSyllable;
+    }
+    return baseSyllable + getAccidentalSymbolsFromNoteName(noteName);
+}
+function getFixedDoSyllablesForNoteNames(noteNames, options = {}) {
+    return noteNames.map((noteName) => getFixedDoSyllableForNoteName(noteName, options));
+}
+exports.movableDoIntervalToSyllableMap = new Map([
+    ["♭1", { syllable: "ti", note: "Contextual lowered tonic." }],
+    ["♮1", { syllable: "do" }],
+    ["1", { syllable: "do" }],
+    ["♯1", { syllable: "di" }],
+    ["♭2", { syllable: "ra" }],
+    ["♮2", { syllable: "re" }],
+    ["2", { syllable: "re" }],
+    ["♯2", { syllable: "ri" }],
+    ["♭3", { syllable: "me", aliases: ["ma"] }],
+    ["♮3", { syllable: "mi" }],
+    ["3", { syllable: "mi" }],
+    ["♭4", { syllable: "mi", note: "Contextual lowered fourth." }],
+    ["♮4", { syllable: "fa" }],
+    ["4", { syllable: "fa" }],
+    ["♯4", { syllable: "fi" }],
+    ["♭5", { syllable: "se" }],
+    ["♮5", { syllable: "sol" }],
+    ["5", { syllable: "sol" }],
+    ["♯5", { syllable: "si" }],
+    ["♭6", { syllable: "le", aliases: ["lo"] }],
+    ["♮6", { syllable: "la" }],
+    ["6", { syllable: "la" }],
+    ["♯6", { syllable: "li" }],
+    [
+        "𝄫7",
+        {
+            syllable: "la",
+            note: "Common do-based minor handling for a diminished seventh above the tonic.",
+        },
+    ],
+    ["♭7", { syllable: "te", aliases: ["ta"] }],
+    ["♮7", { syllable: "ti" }],
+    ["7", { syllable: "ti" }],
+    ["♭8", { syllable: "ti", note: "Contextual lowered octave." }],
+    ["♮8", { syllable: "do" }],
+    ["8", { syllable: "do" }],
+    ["♯8", { syllable: "di", note: "Contextual raised octave." }],
+]);
+exports.movableLaBasedMinorIntervalToSyllableMap = new Map([
+    ["♭1", { syllable: "le", aliases: ["lo"] }],
+    ["♮1", { syllable: "la" }],
+    ["1", { syllable: "la" }],
+    ["♯1", { syllable: "li" }],
+    ["♭2", { syllable: "te", aliases: ["ta"] }],
+    ["♮2", { syllable: "ti" }],
+    ["2", { syllable: "ti" }],
+    ["♭3", { syllable: "do" }],
+    ["♮3", { syllable: "di" }],
+    ["3", { syllable: "di" }],
+    ["♭4", { syllable: "ra" }],
+    ["♮4", { syllable: "re" }],
+    ["4", { syllable: "re" }],
+    ["♯4", { syllable: "ri" }],
+    ["♭5", { syllable: "me", aliases: ["ma"] }],
+    ["♮5", { syllable: "mi" }],
+    ["5", { syllable: "mi" }],
+    ["♭6", { syllable: "fa" }],
+    ["♮6", { syllable: "fi" }],
+    ["6", { syllable: "fi" }],
+    ["𝄫7", { syllable: "se" }],
+    ["♭7", { syllable: "sol" }],
+    ["♮7", { syllable: "si" }],
+    ["7", { syllable: "si" }],
+    ["♮8", { syllable: "la" }],
+    ["8", { syllable: "la" }],
+]);
+exports.movableDoIntervalSyllableMaps = {
+    doBased: exports.movableDoIntervalToSyllableMap,
+    laBasedMinor: exports.movableLaBasedMinorIntervalToSyllableMap,
+};
+function getMovableDoSyllableEntryForInterval(interval, system = "doBased") {
+    const simpleInterval = getSimpleIntervalForMovableDo(interval);
+    if (simpleInterval === undefined) {
+        return undefined;
+    }
+    return exports.movableDoIntervalSyllableMaps[system].get(simpleInterval);
+}
+function getMovableDoSyllableForInterval(interval, system = "doBased") {
+    return getMovableDoSyllableEntryForInterval(interval, system)?.syllable;
+}
+function getMovableDoSyllablesForIntervals(intervals, system = "doBased") {
+    return intervals.map((interval) => getMovableDoSyllableForInterval(interval, system));
+}

package/script/src/data/note-collections/mod.d.ts

@@ -1,3 +1,9 @@
+import { majorVariants } from "./major-variants.js";
+import { minorVariants } from "./minor-variants.js";
+import { type _dominantVariants } from "./dominant-variants.js";
+import { type _diminishedVariants } from "./diminished-variants.js";
+import { augmentedVariants } from "./augmented-variants.js";
+import { otherNoteCollections } from "./other-collections.js";
 export { diatonicModes } from "./diatonic-modes.js";
 export { pentatonicVariants } from "./pentatonic-variants.js";
 export { majorVariants } from "./major-variants.js";
@@ -72,6 +78,15 @@ export declare const noteCollections: {
 };
 /** A strictly typed generic string representing any key corresponding to a NoteCollection loaded in `noteCollections`. */
 export type NoteCollectionKey = keyof typeof noteCollections;
+type NoteCollectionKeysWithCategory<TCollections extends Record<string, {
+    readonly category: string;
+}>, TCategory extends string> = {
+    [K in keyof TCollections]: TCollections[K] extends {
+        readonly category: TCategory;
+    } ? K : never;
+}[keyof TCollections];
+/** A strictly typed key for any built-in note collection categorized as a chord. */
+export type ChordCollectionKey = NoteCollectionKeysWithCategory<typeof majorVariants, "chord"> | NoteCollectionKeysWithCategory<typeof minorVariants, "chord"> | NoteCollectionKeysWithCategory<typeof _dominantVariants, "chord"> | NoteCollectionKeysWithCategory<typeof _diminishedVariants, "chord"> | NoteCollectionKeysWithCategory<typeof augmentedVariants, "chord"> | NoteCollectionKeysWithCategory<typeof otherNoteCollections, "chord">;
 /** An organized, grouped dictionary splitting note collections into theoretical categories (e.g. Diatonic Modes, Major Variants). */
 export declare const groupedNoteCollections: {
     readonly diatonicModes: Record<"ionian" | "dorian" | "phrygian" | "lydian" | "mixolydian" | "aeolian" | "locrian", import("../../mod.js").ModalScaleCollection>;

package/script/src/data/note-collections/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/note-collections/mod.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,oIAAoI;AACpI,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWlB,CAAC;AAEX,0HAA0H;AAC1H,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE7D,qIAAqI;AACrI,eAAO,MAAM,sBAAsB;;;;;;;;;;;CAWzB,CAAC;AAEX,0GAA0G;AAC1G,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAEzE,sHAAsH;AACtH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAC/C,sBAAsB,EACtB;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAkDO,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/note-collections/mod.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,oIAAoI;AACpI,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWlB,CAAC;AAEX,0HAA0H;AAC1H,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE7D,KAAK,8BAA8B,CACjC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EAClE,SAAS,SAAS,MAAM,IACtB;KACD,CAAC,IAAI,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,SAAS;QACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;KAC9B,GAAG,CAAC,GACD,KAAK;CACV,CAAC,MAAM,YAAY,CAAC,CAAC;AAEtB,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,GAC1B,8BAA8B,CAAC,OAAO,aAAa,EAAE,OAAO,CAAC,GAC7D,8BAA8B,CAAC,OAAO,aAAa,EAAE,OAAO,CAAC,GAC7D,8BAA8B,CAAC,OAAO,iBAAiB,EAAE,OAAO,CAAC,GACjE,8BAA8B,CAAC,OAAO,mBAAmB,EAAE,OAAO,CAAC,GACnE,8BAA8B,CAAC,OAAO,iBAAiB,EAAE,OAAO,CAAC,GACjE,8BAA8B,CAAC,OAAO,oBAAoB,EAAE,OAAO,CAAC,CAAC;AAEzE,qIAAqI;AACrI,eAAO,MAAM,sBAAsB;;;;;;;;;;;CAWzB,CAAC;AAEX,0GAA0G;AAC1G,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAEzE,sHAAsH;AACtH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAC/C,sBAAsB,EACtB;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAkDO,CAAC"}

package/script/src/utils/chord-progressions.d.ts

@@ -1,21 +1,38 @@
 import { type ChordProgressionKey } from "../data/chord-progressions/mod.js";
-import type { ChordProgression } from "../types/chord-progressions";
+import type { ChordProgression, ChordProgressionAnalysisRomanSymbol, ChordProgressionCategoryKey, ChordProgressionChord, ChordProgressionRomanSymbol } from "../types/chord-progressions";
 import type { RootNote } from "../data/labels/note-labels.js";
-import type { NoteCollectionKey } from "../data/note-collections/mod.js";
+import type { ChordCollectionKey } from "../data/note-collections/mod.js";
 /** A resolved chord in a progression, including its root and note-collection key. */
 export interface ChordProgressionChordReference {
     readonly rootNote: RootNote;
     readonly chordName: string;
-    readonly noteCollectionKey: NoteCollectionKey;
+    readonly noteCollectionKey: ChordCollectionKey;
 }
 /** Returns whether a string is one of the built-in chord progression keys. */
 export declare function isValidChordProgressionKey(key: string): key is ChordProgressionKey;
+/** Returns the direct tonic-relative Roman symbol for a progression chord. */
+export declare function getChordProgressionChordDirectRomanSymbol(chord: ChordProgressionChord): ChordProgressionRomanSymbol;
 /** Returns the spelled chord names for a progression in the requested root. */
 export declare function getChordProgressionChordNames(rootNote: RootNote, progressionOrKey: ChordProgression | ChordProgressionKey): string[];
-/** Returns the roman symbols authored for a chord progression. */
-export declare function getChordProgressionRomanSymbols(progressionOrKey: ChordProgression | ChordProgressionKey): string[];
+/**
+ * Returns direct tonic-relative Roman symbols derived from each chord's
+ * `degree` and `chordCollectionKey`.
+ */
+export declare function getChordProgressionDirectRomanSymbols(progressionOrKey: ChordProgression | ChordProgressionKey): ChordProgressionRomanSymbol[];
+/**
+ * Returns Roman symbols suitable for theory display, preferring optional
+ * harmonic-function analysis labels when present.
+ */
+export declare function getChordProgressionRomanSymbols(progressionOrKey: ChordProgression | ChordProgressionKey): ChordProgressionAnalysisRomanSymbol[];
+/**
+ * Returns Roman symbols suitable for display, preferring optional
+ * harmonic-function analysis labels when present.
+ */
+export declare function getChordProgressionDisplayRomanSymbols(progressionOrKey: ChordProgression | ChordProgressionKey): ChordProgressionAnalysisRomanSymbol[];
 /** Returns all built-in chord progression keys with the requested total bar count. */
 export declare function getChordProgressionKeysForTotalBars(totalBars: number): ChordProgressionKey[];
+/** Returns all built-in chord progression keys in the requested musical category. */
+export declare function getChordProgressionKeysForCategory(category: ChordProgressionCategoryKey): ChordProgressionKey[];
 /** Returns each distinct chord name in a progression, preserving first-seen order. */
 export declare function getChordProgressionUniqueChordNames(rootNote: RootNote, progressionOrKey: ChordProgression | ChordProgressionKey): string[];
 /**

package/script/src/utils/chord-progressions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chord-progressions.d.ts","sourceRoot":"","sources":["../../../src/src/utils/chord-progressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAMzE,qFAAqF;AACrF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;CAC/C;AASD,8EAA8E;AAC9E,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,GACV,GAAG,IAAI,mBAAmB,CAE5B;AA2CD,+EAA+E;AAC/E,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,MAAM,EAAE,CAYV;AAED,kEAAkE;AAClE,wBAAgB,+BAA+B,CAC7C,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,MAAM,EAAE,CAKV;AAED,sFAAsF;AACtF,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,MAAM,GAChB,mBAAmB,EAAE,CAKvB;AAED,sFAAsF;AACtF,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,MAAM,EAAE,CAIV;AAED;;;;;;GAMG;AACH,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,8BAA8B,EAAE,CAKlC;AAED;;;GAGG;AACH,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,8BAA8B,EAAE,CAkBlC;AAED;;;;;GAKG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,8BAA8B,EAAE,EAAE,CAiDpC;AAED;;;;;GAKG;AACH,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,8BAA8B,EAAE,CAKlC;AAED,6EAA6E;AAC7E,wBAAgB,sCAAsC,CACpD,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,MAAM,CAQR"}
+{"version":3,"file":"chord-progressions.d.ts","sourceRoot":"","sources":["../../../src/src/utils/chord-progressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EAEzB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EACV,gBAAgB,EAChB,mCAAmC,EACnC,2BAA2B,EAC3B,qBAAqB,EAErB,2BAA2B,EAC5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAO1E,qFAAqF;AACrF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;CAChD;AAWD,8EAA8E;AAC9E,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,GACV,GAAG,IAAI,mBAAmB,CAE5B;AA8DD,8EAA8E;AAC9E,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,qBAAqB,GAC3B,2BAA2B,CA0B7B;AAED,+EAA+E;AAC/E,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,MAAM,EAAE,CAYV;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,CACnD,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,2BAA2B,EAAE,CAO/B;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,mCAAmC,EAAE,CASvC;AAED;;;GAGG;AACH,wBAAgB,sCAAsC,CACpD,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,mCAAmC,EAAE,CAEvC;AAED,sFAAsF;AACtF,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,MAAM,GAChB,mBAAmB,EAAE,CAKvB;AAED,qFAAqF;AACrF,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,2BAA2B,GACpC,mBAAmB,EAAE,CAKvB;AAED,sFAAsF;AACtF,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,MAAM,EAAE,CAIV;AAED;;;;;;GAMG;AACH,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,8BAA8B,EAAE,CAKlC;AAED;;;GAGG;AACH,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,8BAA8B,EAAE,CAkBlC;AAED;;;;;GAKG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,8BAA8B,EAAE,EAAE,CAiDpC;AAED;;;;;GAKG;AACH,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,8BAA8B,EAAE,CAKlC;AAED,6EAA6E;AAC7E,wBAAgB,sCAAsC,CACpD,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,MAAM,CAQR"}