@kernel.chat/kbot 3.48.0 → 3.50.0

package/dist/tools/music-theory.d.ts

@@ -0,0 +1,175 @@
+export interface MidiNote {
+    pitch: number;
+    start: number;
+    duration: number;
+    velocity: number;
+}
+export declare const SCALES: Record<string, number[]>;
+export declare const CHORDS: Record<string, number[]>;
+/**
+ * Convert a note name to MIDI number.
+ * Accepts: "C4", "F#3", "Bb5", "Eb2", etc.
+ * Uses scientific pitch notation where C4 = 60 (middle C).
+ */
+export declare function noteNameToMidi(name: string): number;
+/**
+ * Convert MIDI number to note name.
+ * Returns sharps by default. Pass `preferFlats: true` for flat names.
+ */
+export declare function midiToNoteName(midi: number, preferFlats?: boolean): string;
+/**
+ * Convert MIDI number to frequency in Hz (A4 = 440 Hz).
+ */
+export declare function midiToFrequency(midi: number): number;
+/**
+ * Convert frequency in Hz to the nearest MIDI number.
+ */
+export declare function frequencyToMidi(freq: number): number;
+/**
+ * Parse a chord symbol string into MIDI note numbers.
+ *
+ * @param symbol - e.g. "Cmaj7", "F#m7", "Bb7", "Dadd9", "G7#9"
+ * @param octave - root octave (default 4)
+ * @returns Array of MIDI note numbers
+ *
+ * Examples:
+ *   parseChordSymbol("Cmaj7")  → [60, 64, 67, 71]
+ *   parseChordSymbol("F#m7")   → [66, 69, 73, 76]
+ *   parseChordSymbol("Bb7")    → [58, 62, 65, 68]
+ */
+export declare function parseChordSymbol(symbol: string, octave?: number): number[];
+/**
+ * Parse a Roman numeral chord notation.
+ *
+ * @param numeral - e.g. "I", "ii", "V7", "bVII", "iv", "#IV", "viidim7"
+ * @param key - e.g. "C", "F#", "Bb"
+ * @param scale - scale name (default "major")
+ * @returns Object with root MIDI number, quality name, and MIDI notes
+ *
+ * Conventions:
+ *   - Uppercase = major, lowercase = minor
+ *   - "dim" suffix = diminished, "aug" = augmented
+ *   - "7" = dominant 7th (on uppercase) or minor 7th (on lowercase)
+ *   - "maj7" = major 7th
+ *   - "b" prefix = lowered a half step, "#" prefix = raised a half step
+ */
+export declare function parseRomanNumeral(numeral: string, key: string, scale?: string): {
+    root: number;
+    quality: string;
+    notes: number[];
+};
+/**
+ * Parse a chord progression string into arrays of MIDI notes.
+ *
+ * Accepts two formats:
+ *   1. Roman numerals: "I vi IV V"
+ *   2. Chord symbols: "Cmaj7 Am7 Fmaj7 G7"
+ *
+ * @param progression - space-separated chord tokens
+ * @param key - key root note (e.g. "C", "F#")
+ * @param scale - scale name (default "major")
+ * @param octave - root octave for chord symbols (default 4)
+ * @returns Array of MIDI note arrays, one per chord
+ */
+export declare function parseProgression(progression: string, key: string, scale?: string, octave?: number): number[][];
+/**
+ * Apply a voicing to a set of MIDI notes.
+ *
+ * @param notes - Input chord tones (root position, ascending)
+ * @param voicing - Voicing strategy
+ * @returns Re-voiced MIDI notes
+ *
+ * Voicings:
+ *   - close: stack notes in ascending order within one octave
+ *   - open: drop the second note from bottom down an octave
+ *   - drop2: drop the second note from the top down an octave
+ *   - drop3: drop the third note from the top down an octave
+ *   - spread: distribute notes across 2-3 octaves
+ *   - shell: root + 3rd (or sus) + 7th only
+ */
+export declare function voiceChord(notes: number[], voicing: 'close' | 'open' | 'drop2' | 'drop3' | 'spread' | 'shell'): number[];
+/**
+ * Arpeggiate a chord into a sequence of MidiNote events.
+ *
+ * @param notes - MIDI note numbers to arpeggiate
+ * @param pattern - Direction pattern
+ * @param divisions - Number of notes to generate
+ * @param durationBeats - Total duration in beats
+ * @returns Array of MidiNote events
+ */
+export declare function arpeggiate(notes: number[], pattern: 'up' | 'down' | 'updown' | 'random', divisions: number, durationBeats: number): MidiNote[];
+export declare const NAMED_PROGRESSIONS: Record<string, {
+    name: string;
+    numerals: string;
+    description: string;
+}>;
+export declare const RHYTHM_PATTERNS: Record<string, number[]>;
+/**
+ * Snap a MIDI note to the nearest note in the given scale and key.
+ *
+ * @param note - MIDI note number to quantize
+ * @param key - Root pitch class (0-11) or note name
+ * @param scale - Scale name from SCALES
+ * @returns Nearest MIDI note in the scale
+ */
+export declare function quantizeToScale(note: number, key: number | string, scale: string): number;
+/**
+ * Detect the most likely key and scale for a set of MIDI notes.
+ * Uses the Krumhansl-Schmuckler key-finding algorithm (simplified).
+ *
+ * @param notes - Array of MIDI note numbers
+ * @returns Best-fit key, scale, and confidence (0-1)
+ */
+export declare function detectKey(notes: number[]): {
+    key: string;
+    scale: string;
+    confidence: number;
+};
+export declare const GM_DRUMS: Record<string, number>;
+export declare const GENRE_DRUM_PATTERNS: Record<string, {
+    bpm: [number, number];
+    pattern: Record<string, number[]>;
+}>;
+/**
+ * Get scale note names for a given key and scale.
+ * Useful for display and reference.
+ */
+export declare function getScaleNotes(key: string, scale: string, octave?: number): {
+    names: string[];
+    midi: number[];
+};
+/**
+ * Transpose an array of MIDI notes by a given number of semitones.
+ */
+export declare function transpose(notes: number[], semitones: number): number[];
+/**
+ * Invert a chord (rotate the lowest note up an octave).
+ * @param notes - MIDI notes (sorted ascending)
+ * @param inversion - Number of inversions (1 = first, 2 = second, etc.)
+ */
+export declare function invertChord(notes: number[], inversion: number): number[];
+/**
+ * Calculate the interval name between two MIDI notes.
+ */
+export declare function intervalName(semitones: number): string;
+/**
+ * Get the available scale names.
+ */
+export declare function listScales(): string[];
+/**
+ * Get the available chord quality names.
+ */
+export declare function listChords(): string[];
+/**
+ * Get the available named progressions.
+ */
+export declare function listProgressions(): string[];
+/**
+ * Get the available drum pattern genres.
+ */
+export declare function listDrumPatterns(): string[];
+/**
+ * Get the available rhythm patterns.
+ */
+export declare function listRhythmPatterns(): string[];
+//# sourceMappingURL=music-theory.d.ts.map

package/dist/tools/music-theory.d.ts.map

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