musa-dsl 0.40.0 → 0.41.0

data/lib/musa-dsl/music/scale_kinds/melodic_minor/dorian_b2_scale_kind.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Musa
+  module Scales
+    # Dorian b2 scale kind (second mode of melodic minor).
+    #
+    # DorianB2ScaleKind defines the Dorian b2 scale (also called Phrygian #6
+    # or Javanese scale), the second mode of the melodic minor scale.
+    # It combines the Phrygian's lowered second with the Dorian's raised sixth.
+    #
+    # ## Pitch Structure
+    #
+    # 7 diatonic degrees plus extended harmony:
+    #
+    # **Scale Degrees** (lowercase for minor quality):
+    #
+    # - **i** (tonic): Root (0 semitones)
+    # - **ii** (supertonic): Minor second (1 semitone) ← CHARACTERISTIC (b2)
+    # - **iii** (mediant): Minor third (3 semitones)
+    # - **iv** (subdominant): Perfect fourth (5 semitones)
+    # - **v** (dominant): Perfect fifth (7 semitones)
+    # - **vi** (submediant): Major sixth (9 semitones) ← CHARACTERISTIC (#6)
+    # - **vii** (subtonic): Minor seventh (10 semitones)
+    #
+    # ## Relationship to Other Modes
+    #
+    # - Dorian with lowered 2nd
+    # - Phrygian with raised 6th
+    # - 2nd mode of melodic minor
+    #
+    # ## Musical Character
+    #
+    # The Dorian b2 scale:
+    #
+    # - Exotic, Eastern quality
+    # - Minor with both Phrygian darkness and Dorian brightness
+    # - Used over sus4(b9) chords in jazz
+    # - Common in contemporary jazz and fusion
+    #
+    # ## Usage
+    #
+    #     d_dor_b2 = Scales[:et12][440.0][:dorian_b2][62]
+    #     d_dor_b2.tonic  # D (62)
+    #     d_dor_b2.ii     # Eb (63) - minor second
+    #     d_dor_b2.vi     # B (71) - major sixth
+    #
+    # @see ScaleKind Abstract base class
+    # @see DorianScaleKind Dorian mode
+    # @see PhrygianScaleKind Phrygian mode
+    # @see MelodicMinorScaleKind Parent melodic minor scale
+    class DorianB2ScaleKind < ScaleKind
+      @base_metadata = {
+        family: :melodic_minor_modes,
+        brightness: -2,
+        character: [:exotic, :phrygian_dorian],
+        parent: { scale: :minor_melodic, degree: 2 }
+      }.freeze
+
+      class << self
+        @@pitches =
+            [{ functions: %i[i _1 tonic first],
+               pitch: 0 },
+             { functions: %i[ii _2 supertonic second],
+               pitch: 1 },
+             { functions: %i[iii _3 mediant third],
+               pitch: 3 },
+             { functions: %i[iv _4 subdominant fourth],
+               pitch: 5 },
+             { functions: %i[v _5 dominant fifth],
+               pitch: 7 },
+             { functions: %i[vi _6 submediant sixth],
+               pitch: 9 },
+             { functions: %i[vii _7 subtonic seventh],
+               pitch: 10 },
+             { functions: %i[viii _8 eighth],
+               pitch: 12 },
+             { functions: %i[ix _9 ninth],
+               pitch: 12 + 1 },
+             { functions: %i[x _10 tenth],
+               pitch: 12 + 3 },
+             { functions: %i[xi _11 eleventh],
+               pitch: 12 + 5 },
+             { functions: %i[xii _12 twelfth],
+               pitch: 12 + 7 },
+             { functions: %i[xiii _13 thirteenth],
+               pitch: 12 + 9 }].freeze
+
+        def pitches
+          @@pitches
+        end
+
+        def grades
+          7
+        end
+
+        def id
+          :dorian_b2
+        end
+      end
+
+      EquallyTempered12ToneScaleSystem.register DorianB2ScaleKind
+    end
+  end
+end

data/lib/musa-dsl/music/scale_kinds/melodic_minor/locrian_sharp2_scale_kind.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Musa
+  module Scales
+    # Locrian #2 scale kind (sixth mode of melodic minor).
+    #
+    # LocrianSharp2ScaleKind defines the Locrian #2 scale (also called
+    # Aeolian b5 or Half-Diminished scale), the sixth mode of the
+    # melodic minor scale. It's the primary scale for half-diminished chords.
+    #
+    # ## Pitch Structure
+    #
+    # 7 diatonic degrees plus extended harmony:
+    #
+    # **Scale Degrees** (lowercase for diminished quality):
+    #
+    # - **i** (tonic): Root (0 semitones)
+    # - **ii** (supertonic): Major second (2 semitones) ← #2 vs Locrian
+    # - **iii** (mediant): Minor third (3 semitones)
+    # - **iv** (subdominant): Perfect fourth (5 semitones)
+    # - **v** (dominant): Diminished fifth (6 semitones) ← DIMINISHED
+    # - **vi** (submediant): Minor sixth (8 semitones)
+    # - **vii** (subtonic): Minor seventh (10 semitones)
+    #
+    # ## Relationship to Other Modes
+    #
+    # - Locrian with raised 2nd (natural 9)
+    # - Aeolian with lowered 5th
+    # - 6th mode of melodic minor
+    #
+    # ## Musical Character
+    #
+    # The Locrian #2 scale:
+    #
+    # - Primary scale for m7b5 (half-diminished) chords
+    # - More usable than pure Locrian (has natural 9)
+    # - Essential in jazz ii-V-I in minor keys
+    # - Dark but functional
+    #
+    # ## Usage
+    #
+    #     a_loc2 = Scales[:et12][440.0][:locrian_sharp2][69]
+    #     a_loc2.tonic  # A (69)
+    #     a_loc2.ii     # B (71) - major second (raised)
+    #     a_loc2.v      # Eb (75) - diminished fifth
+    #
+    # @see ScaleKind Abstract base class
+    # @see LocrianScaleKind Locrian mode (with minor 2nd)
+    # @see MelodicMinorScaleKind Parent melodic minor scale
+    class LocrianSharp2ScaleKind < ScaleKind
+      @base_metadata = {
+        family: :melodic_minor_modes,
+        brightness: -2,
+        character: [:half_diminished, :jazz],
+        parent: { scale: :minor_melodic, degree: 6 }
+      }.freeze
+
+      class << self
+        @@pitches =
+            [{ functions: %i[i _1 tonic first],
+               pitch: 0 },
+             { functions: %i[ii _2 supertonic second],
+               pitch: 2 },
+             { functions: %i[iii _3 mediant third],
+               pitch: 3 },
+             { functions: %i[iv _4 subdominant fourth],
+               pitch: 5 },
+             { functions: %i[v _5 dominant fifth],
+               pitch: 6 },
+             { functions: %i[vi _6 submediant sixth],
+               pitch: 8 },
+             { functions: %i[vii _7 subtonic seventh],
+               pitch: 10 },
+             { functions: %i[viii _8 eighth],
+               pitch: 12 },
+             { functions: %i[ix _9 ninth],
+               pitch: 12 + 2 },
+             { functions: %i[x _10 tenth],
+               pitch: 12 + 3 },
+             { functions: %i[xi _11 eleventh],
+               pitch: 12 + 5 },
+             { functions: %i[xii _12 twelfth],
+               pitch: 12 + 6 },
+             { functions: %i[xiii _13 thirteenth],
+               pitch: 12 + 8 }].freeze
+
+        def pitches
+          @@pitches
+        end
+
+        def grades
+          7
+        end
+
+        def id
+          :locrian_sharp2
+        end
+      end
+
+      EquallyTempered12ToneScaleSystem.register LocrianSharp2ScaleKind
+    end
+  end
+end

data/lib/musa-dsl/music/scale_kinds/melodic_minor/lydian_augmented_scale_kind.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Musa
+  module Scales
+    # Lydian augmented scale kind (third mode of melodic minor).
+    #
+    # LydianAugmentedScaleKind defines the Lydian augmented scale, the third
+    # mode of the melodic minor scale. It combines the Lydian's raised fourth
+    # with an augmented (raised) fifth.
+    #
+    # ## Pitch Structure
+    #
+    # 7 diatonic degrees plus extended harmony:
+    #
+    # **Scale Degrees** (uppercase for major quality):
+    #
+    # - **I** (tonic): Root (0 semitones)
+    # - **II** (supertonic): Major second (2 semitones)
+    # - **III** (mediant): Major third (4 semitones)
+    # - **IV** (subdominant): Augmented fourth (6 semitones) ← LYDIAN
+    # - **V** (dominant): Augmented fifth (8 semitones) ← AUGMENTED
+    # - **VI** (submediant): Major sixth (9 semitones)
+    # - **VII** (leading): Major seventh (11 semitones)
+    #
+    # ## Relationship to Other Modes
+    #
+    # - Lydian with augmented 5th
+    # - 3rd mode of melodic minor
+    # - Contains both #4 and #5
+    #
+    # ## Musical Character
+    #
+    # The Lydian augmented scale:
+    #
+    # - Extremely bright and ethereal
+    # - Used over maj7#5 and maj7#11 chords
+    # - Dreamy, floating quality
+    # - Common in contemporary jazz and film music
+    #
+    # ## Usage
+    #
+    #     eb_lyd_aug = Scales[:et12][440.0][:lydian_augmented][63]
+    #     eb_lyd_aug.tonic  # Eb (63)
+    #     eb_lyd_aug.IV     # A (69) - augmented fourth
+    #     eb_lyd_aug.V      # B (71) - augmented fifth
+    #
+    # @see ScaleKind Abstract base class
+    # @see LydianScaleKind Lydian mode
+    # @see MelodicMinorScaleKind Parent melodic minor scale
+    class LydianAugmentedScaleKind < ScaleKind
+      @base_metadata = {
+        family: :melodic_minor_modes,
+        brightness: 3,
+        character: [:very_bright, :augmented, :ethereal],
+        parent: { scale: :minor_melodic, degree: 3 }
+      }.freeze
+
+      class << self
+        @@pitches =
+            [{ functions: %i[I _1 tonic first],
+               pitch: 0 },
+             { functions: %i[II _2 supertonic second],
+               pitch: 2 },
+             { functions: %i[III _3 mediant third],
+               pitch: 4 },
+             { functions: %i[IV _4 subdominant fourth],
+               pitch: 6 },
+             { functions: %i[V _5 dominant fifth],
+               pitch: 8 },
+             { functions: %i[VI _6 submediant sixth],
+               pitch: 9 },
+             { functions: %i[VII _7 leading seventh],
+               pitch: 11 },
+             { functions: %i[VIII _8 eighth],
+               pitch: 12 },
+             { functions: %i[IX _9 ninth],
+               pitch: 12 + 2 },
+             { functions: %i[X _10 tenth],
+               pitch: 12 + 4 },
+             { functions: %i[XI _11 eleventh],
+               pitch: 12 + 6 },
+             { functions: %i[XII _12 twelfth],
+               pitch: 12 + 8 },
+             { functions: %i[XIII _13 thirteenth],
+               pitch: 12 + 9 }].freeze
+
+        def pitches
+          @@pitches
+        end
+
+        def grades
+          7
+        end
+
+        def id
+          :lydian_augmented
+        end
+      end
+
+      EquallyTempered12ToneScaleSystem.register LydianAugmentedScaleKind
+    end
+  end
+end

data/lib/musa-dsl/music/scale_kinds/melodic_minor/lydian_dominant_scale_kind.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module Musa
+  module Scales
+    # Lydian dominant scale kind (fourth mode of melodic minor).
+    #
+    # LydianDominantScaleKind defines the Lydian dominant scale (also called
+    # Lydian b7, Overtone scale, or Bartók scale), the fourth mode of the
+    # melodic minor scale. It combines the Lydian's raised fourth with a
+    # dominant seventh.
+    #
+    # ## Pitch Structure
+    #
+    # 7 diatonic degrees plus extended harmony:
+    #
+    # **Scale Degrees** (uppercase for major quality):
+    #
+    # - **I** (tonic): Root (0 semitones)
+    # - **II** (supertonic): Major second (2 semitones)
+    # - **III** (mediant): Major third (4 semitones)
+    # - **IV** (subdominant): Augmented fourth (6 semitones) ← LYDIAN (#4)
+    # - **V** (dominant): Perfect fifth (7 semitones)
+    # - **VI** (submediant): Major sixth (9 semitones)
+    # - **VII** (subtonic): Minor seventh (10 semitones) ← DOMINANT (b7)
+    #
+    # ## Relationship to Other Modes
+    #
+    # - Lydian with lowered 7th
+    # - Mixolydian with raised 4th
+    # - 4th mode of melodic minor
+    # - Matches the harmonic series closely
+    #
+    # ## Musical Character
+    #
+    # The Lydian dominant scale:
+    #
+    # - Bright but with dominant tension
+    # - Used over 7#11 chords
+    # - Common in jazz, Béla Bartók's music
+    # - Creates sophisticated dominant sound
+    #
+    # ## Usage
+    #
+    #     f_lyd_dom = Scales[:et12][440.0][:lydian_dominant][65]
+    #     f_lyd_dom.tonic  # F (65)
+    #     f_lyd_dom.IV     # B (71) - augmented fourth
+    #     f_lyd_dom.VII    # Eb (75) - minor seventh
+    #
+    # @see ScaleKind Abstract base class
+    # @see LydianScaleKind Lydian mode (with major 7th)
+    # @see MixolydianScaleKind Mixolydian mode (with perfect 4th)
+    # @see MelodicMinorScaleKind Parent melodic minor scale
+    class LydianDominantScaleKind < ScaleKind
+      @base_metadata = {
+        family: :melodic_minor_modes,
+        brightness: 1,
+        character: [:bright, :dominant, :fusion],
+        parent: { scale: :minor_melodic, degree: 4 }
+      }.freeze
+
+      class << self
+        @@pitches =
+            [{ functions: %i[I _1 tonic first],
+               pitch: 0 },
+             { functions: %i[II _2 supertonic second],
+               pitch: 2 },
+             { functions: %i[III _3 mediant third],
+               pitch: 4 },
+             { functions: %i[IV _4 subdominant fourth],
+               pitch: 6 },
+             { functions: %i[V _5 dominant fifth],
+               pitch: 7 },
+             { functions: %i[VI _6 submediant sixth],
+               pitch: 9 },
+             { functions: %i[VII _7 subtonic seventh],
+               pitch: 10 },
+             { functions: %i[VIII _8 eighth],
+               pitch: 12 },
+             { functions: %i[IX _9 ninth],
+               pitch: 12 + 2 },
+             { functions: %i[X _10 tenth],
+               pitch: 12 + 4 },
+             { functions: %i[XI _11 eleventh],
+               pitch: 12 + 6 },
+             { functions: %i[XII _12 twelfth],
+               pitch: 12 + 7 },
+             { functions: %i[XIII _13 thirteenth],
+               pitch: 12 + 9 }].freeze
+
+        def pitches
+          @@pitches
+        end
+
+        def grades
+          7
+        end
+
+        def id
+          :lydian_dominant
+        end
+      end
+
+      EquallyTempered12ToneScaleSystem.register LydianDominantScaleKind
+    end
+  end
+end

data/lib/musa-dsl/music/scale_kinds/melodic_minor/melodic_minor_scale_kind.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Musa
+  module Scales
+    # Melodic minor scale kind (ascending form).
+    #
+    # MelodicMinorScaleKind defines the melodic minor scale in its ascending
+    # form (also called jazz minor). It has a minor third but major sixth and
+    # seventh, creating a unique hybrid between minor and major qualities.
+    #
+    # ## Pitch Structure
+    #
+    # 7 diatonic degrees plus extended harmony:
+    #
+    # **Scale Degrees** (lowercase for minor quality):
+    #
+    # - **i** (tonic): Root (0 semitones)
+    # - **ii** (supertonic): Major second (2 semitones)
+    # - **iii** (mediant): Minor third (3 semitones) ← MINOR
+    # - **iv** (subdominant): Perfect fourth (5 semitones)
+    # - **v** (dominant): Perfect fifth (7 semitones)
+    # - **vi** (submediant): Major sixth (9 semitones) ← MAJOR
+    # - **vii** (leading): Major seventh (11 semitones) ← MAJOR
+    #
+    # ## Relationship to Other Scales
+    #
+    # - Minor third (like natural minor)
+    # - Major 6th and 7th (like major scale)
+    # - Parent scale for many jazz modes (Lydian Dominant, Altered, etc.)
+    #
+    # ## Musical Character
+    #
+    # The melodic minor scale:
+    #
+    # - Minor quality with major upper structure
+    # - Essential in jazz harmony
+    # - Less dark than harmonic minor (no augmented 2nd)
+    # - Smooth melodic contour
+    #
+    # ## Usage
+    #
+    #     c_mel_min = Scales[:et12][440.0][:minor_melodic][60]
+    #     c_mel_min.tonic    # C (60)
+    #     c_mel_min.mediant  # Eb (63) - minor third
+    #     c_mel_min.leading  # B (71) - major seventh
+    #
+    # @see ScaleKind Abstract base class
+    # @see MinorNaturalScaleKind Natural minor
+    # @see MinorHarmonicScaleKind Harmonic minor
+    # @see AlteredScaleKind Altered scale (7th mode of melodic minor)
+    class MelodicMinorScaleKind < ScaleKind
+      @base_metadata = {
+        family: :melodic_minor_modes,
+        brightness: -1,
+        character: [:minor, :ascending, :classical],
+        parent: nil
+      }.freeze
+
+      class << self
+        @@pitches =
+            [{ functions: %i[i _1 tonic first],
+               pitch: 0 },
+             { functions: %i[ii _2 supertonic second],
+               pitch: 2 },
+             { functions: %i[iii _3 mediant third],
+               pitch: 3 },
+             { functions: %i[iv _4 subdominant fourth],
+               pitch: 5 },
+             { functions: %i[v _5 dominant fifth],
+               pitch: 7 },
+             { functions: %i[vi _6 submediant sixth],
+               pitch: 9 },
+             { functions: %i[vii _7 leading seventh],
+               pitch: 11 },
+             { functions: %i[viii _8 eighth],
+               pitch: 12 },
+             { functions: %i[ix _9 ninth],
+               pitch: 12 + 2 },
+             { functions: %i[x _10 tenth],
+               pitch: 12 + 3 },
+             { functions: %i[xi _11 eleventh],
+               pitch: 12 + 5 },
+             { functions: %i[xii _12 twelfth],
+               pitch: 12 + 7 },
+             { functions: %i[xiii _13 thirteenth],
+               pitch: 12 + 9 }].freeze
+
+        def pitches
+          @@pitches
+        end
+
+        def grades
+          7
+        end
+
+        def id
+          :minor_melodic
+        end
+      end
+
+      EquallyTempered12ToneScaleSystem.register MelodicMinorScaleKind
+    end
+  end
+end

data/lib/musa-dsl/music/scale_kinds/melodic_minor/mixolydian_b6_scale_kind.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Musa
+  module Scales
+    # Mixolydian b6 scale kind (fifth mode of melodic minor).
+    #
+    # MixolydianB6ScaleKind defines the Mixolydian b6 scale (also called
+    # Melodic Major, Hindu scale, or Aeolian Dominant), the fifth mode of
+    # the melodic minor scale. It combines the Mixolydian's major quality
+    # with a minor sixth.
+    #
+    # ## Pitch Structure
+    #
+    # 7 diatonic degrees plus extended harmony:
+    #
+    # **Scale Degrees** (uppercase for major quality):
+    #
+    # - **I** (tonic): Root (0 semitones)
+    # - **II** (supertonic): Major second (2 semitones)
+    # - **III** (mediant): Major third (4 semitones)
+    # - **IV** (subdominant): Perfect fourth (5 semitones)
+    # - **V** (dominant): Perfect fifth (7 semitones)
+    # - **VI** (submediant): Minor sixth (8 semitones) ← CHARACTERISTIC (b6)
+    # - **VII** (subtonic): Minor seventh (10 semitones)
+    #
+    # ## Relationship to Other Modes
+    #
+    # - Mixolydian with lowered 6th
+    # - Major scale with b6 and b7
+    # - 5th mode of melodic minor
+    #
+    # ## Musical Character
+    #
+    # The Mixolydian b6 scale:
+    #
+    # - Melancholic major quality
+    # - Used over dominant 7th with b13 (V7b13)
+    # - Creates a beautiful tension in the upper structure
+    # - Common in jazz and contemporary music
+    #
+    # ## Usage
+    #
+    #     g_mix_b6 = Scales[:et12][440.0][:mixolydian_b6][67]
+    #     g_mix_b6.tonic  # G (67)
+    #     g_mix_b6.VI     # Eb (75) - minor sixth
+    #
+    # @see ScaleKind Abstract base class
+    # @see MixolydianScaleKind Mixolydian mode (with major 6th)
+    # @see MelodicMinorScaleKind Parent melodic minor scale
+    class MixolydianB6ScaleKind < ScaleKind
+      @base_metadata = {
+        family: :melodic_minor_modes,
+        brightness: 0,
+        character: [:hindu, :dominant, :melodic],
+        parent: { scale: :minor_melodic, degree: 5 }
+      }.freeze
+
+      class << self
+        @@pitches =
+            [{ functions: %i[I _1 tonic first],
+               pitch: 0 },
+             { functions: %i[II _2 supertonic second],
+               pitch: 2 },
+             { functions: %i[III _3 mediant third],
+               pitch: 4 },
+             { functions: %i[IV _4 subdominant fourth],
+               pitch: 5 },
+             { functions: %i[V _5 dominant fifth],
+               pitch: 7 },
+             { functions: %i[VI _6 submediant sixth],
+               pitch: 8 },
+             { functions: %i[VII _7 subtonic seventh],
+               pitch: 10 },
+             { functions: %i[VIII _8 eighth],
+               pitch: 12 },
+             { functions: %i[IX _9 ninth],
+               pitch: 12 + 2 },
+             { functions: %i[X _10 tenth],
+               pitch: 12 + 4 },
+             { functions: %i[XI _11 eleventh],
+               pitch: 12 + 5 },
+             { functions: %i[XII _12 twelfth],
+               pitch: 12 + 7 },
+             { functions: %i[XIII _13 thirteenth],
+               pitch: 12 + 8 }].freeze
+
+        def pitches
+          @@pitches
+        end
+
+        def grades
+          7
+        end
+
+        def id
+          :mixolydian_b6
+        end
+      end
+
+      EquallyTempered12ToneScaleSystem.register MixolydianB6ScaleKind
+    end
+  end
+end