RubyGems - head_music - Versions diffs - 9.0.1 → 11.0.0 - Mend

head_music 9.0.1 → 11.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (102) hide show

checksums.yaml +4 -4
data/.github/workflows/ci.yml +9 -3
data/CHANGELOG.md +18 -0
data/CLAUDE.md +35 -15
data/Gemfile +7 -1
data/Gemfile.lock +91 -3
data/README.md +18 -0
data/Rakefile +7 -2
data/head_music.gemspec +1 -1
data/lib/head_music/analysis/dyad.rb +229 -0
data/lib/head_music/analysis/melodic_interval.rb +1 -1
data/lib/head_music/analysis/pitch_class_set.rb +111 -14
data/lib/head_music/analysis/{pitch_set.rb → pitch_collection.rb} +11 -5
data/lib/head_music/analysis/sonority.rb +50 -12
data/lib/head_music/content/staff.rb +1 -1
data/lib/head_music/content/voice.rb +1 -1
data/lib/head_music/instruments/alternate_tuning.rb +102 -0
data/lib/head_music/instruments/alternate_tunings.yml +78 -0
data/lib/head_music/instruments/instrument.rb +251 -82
data/lib/head_music/instruments/instrument_configuration.rb +66 -0
data/lib/head_music/instruments/instrument_configuration_option.rb +38 -0
data/lib/head_music/instruments/instrument_configurations.yml +288 -0
data/lib/head_music/instruments/instrument_families.yml +77 -0
data/lib/head_music/instruments/instrument_family.rb +3 -4
data/lib/head_music/instruments/instruments.yml +795 -965
data/lib/head_music/instruments/playing_technique.rb +75 -0
data/lib/head_music/instruments/playing_techniques.yml +826 -0
data/lib/head_music/instruments/score_order.rb +2 -5
data/lib/head_music/instruments/staff.rb +61 -1
data/lib/head_music/instruments/staff_scheme.rb +6 -4
data/lib/head_music/instruments/stringing.rb +115 -0
data/lib/head_music/instruments/stringing_course.rb +58 -0
data/lib/head_music/instruments/stringings.yml +168 -0
data/lib/head_music/instruments/variant.rb +0 -1
data/lib/head_music/locales/de.yml +23 -0
data/lib/head_music/locales/en.yml +100 -0
data/lib/head_music/locales/es.yml +23 -0
data/lib/head_music/locales/fr.yml +23 -0
data/lib/head_music/locales/it.yml +23 -0
data/lib/head_music/locales/ru.yml +23 -0
data/lib/head_music/{rudiment → notation}/musical_symbol.rb +3 -3
data/lib/head_music/notation/staff_mapping.rb +70 -0
data/lib/head_music/notation/staff_position.rb +62 -0
data/lib/head_music/notation.rb +7 -0
data/lib/head_music/rudiment/alteration.rb +17 -47
data/lib/head_music/rudiment/alterations.yml +32 -0
data/lib/head_music/rudiment/chromatic_interval.rb +1 -1
data/lib/head_music/rudiment/clef.rb +1 -1
data/lib/head_music/rudiment/consonance.rb +14 -13
data/lib/head_music/rudiment/key_signature.rb +0 -26
data/lib/head_music/rudiment/rhythmic_unit/parser.rb +2 -2
data/lib/head_music/rudiment/rhythmic_value/parser.rb +1 -1
data/lib/head_music/rudiment/rhythmic_value.rb +1 -1
data/lib/head_music/rudiment/spelling.rb +3 -0
data/lib/head_music/rudiment/tempo.rb +1 -1
data/lib/head_music/rudiment/tuning/just_intonation.rb +0 -39
data/lib/head_music/rudiment/tuning/meantone.rb +0 -39
data/lib/head_music/rudiment/tuning/pythagorean.rb +0 -39
data/lib/head_music/rudiment/tuning.rb +20 -0
data/lib/head_music/style/guidelines/consonant_climax.rb +2 -2
data/lib/head_music/style/modern_tradition.rb +8 -11
data/lib/head_music/style/tradition.rb +1 -1
data/lib/head_music/time/clock_position.rb +84 -0
data/lib/head_music/time/conductor.rb +264 -0
data/lib/head_music/time/meter_event.rb +37 -0
data/lib/head_music/time/meter_map.rb +173 -0
data/lib/head_music/time/musical_position.rb +188 -0
data/lib/head_music/time/smpte_timecode.rb +164 -0
data/lib/head_music/time/tempo_event.rb +40 -0
data/lib/head_music/time/tempo_map.rb +187 -0
data/lib/head_music/time.rb +32 -0
data/lib/head_music/utilities/case.rb +27 -0
data/lib/head_music/utilities/hash_key.rb +1 -1
data/lib/head_music/version.rb +1 -1
data/lib/head_music.rb +41 -13
data/user_stories/active/string-pitches.md +41 -0
data/user_stories/backlog/notation-style.md +183 -0
data/user_stories/{todo → backlog}/organizing-content.md +9 -1
data/user_stories/done/consonance-dissonance-classification.md +117 -0
data/user_stories/{todo → done}/dyad-analysis.md +4 -6
data/user_stories/done/expand-playing-techniques.md +38 -0
data/user_stories/{active → done}/handle-time.rb +5 -19
data/user_stories/done/instrument-architecture.md +238 -0
data/user_stories/done/move-musical-symbol-to-notation.md +161 -0
data/user_stories/done/move-staff-mapping-to-notation.md +158 -0
data/user_stories/done/move-staff-position-to-notation.md +141 -0
data/user_stories/done/notation-module-foundation.md +102 -0
data/user_stories/done/percussion_set.md +260 -0
data/user_stories/{todo → done}/pitch-class-set-analysis.md +0 -40
data/user_stories/done/sonority-identification.md +37 -0
data/user_stories/epics/notation-module.md +135 -0
data/user_stories/{todo → visioning}/agentic-daw.md +0 -1
metadata +55 -20
data/check_instrument_consistency.rb +0 -0
data/lib/head_music/instruments/instrument_type.rb +0 -188
data/test_translations.rb +0 -15
data/user_stories/todo/consonance-dissonance-classification.md +0 -57
data/user_stories/todo/material-and-scores.md +0 -10
data/user_stories/todo/percussion_set.md +0 -1
data/user_stories/todo/pitch-set-classification.md +0 -72
data/user_stories/todo/sonority-identification.md +0 -67
/data/user_stories/{active → done}/handle-time.md +0 -0

data/lib/head_music/instruments/playing_techniques.yml ADDED Viewed

@@ -0,0 +1,826 @@
+playing_techniques:
+  bisbigliando:
+    scopes:
+      - common
+    origin: italian
+    meaning: whispering
+    notations:
+      - bisbigliando
+      - bisbigl.
+      - bisbig.
+      - bis.
+  con_sordino:
+    scopes:
+      - common
+    origin: italian
+    meaning: with mute
+    notations:
+      - con sordino
+      - con sord.
+      - mute
+      - muted
+      - with mute
+  laissez_vibrer:
+    scopes:
+      - common
+    origin: french
+    meaning: let ring
+    notations:
+      - laissez vibrer
+      - l.v.
+  legato:
+    scopes:
+      - common
+    origin: italian
+    meaning: tied
+    notations:
+      - legato
+      - leg.
+  marcato:
+    scopes:
+      - common
+    origin: italian
+    meaning: marked
+    notations:
+      - marcato
+      - marc.
+  modo_ordinario:
+    scopes:
+      - common
+    origin: italian
+    meaning: ordinary manner
+    notations:
+      - modo ordinario
+      - modo ord.
+  multiphonic:
+    scopes:
+      - common
+    origin: english
+    meaning: multiple simultaneous pitches
+  naturale:
+    scopes:
+      - common
+    origin: italian
+    meaning: natural
+    notations:
+      - naturale
+      - nat.
+  non_laissez_vibrer:
+    scopes:
+      - common
+    origin: french
+    meaning: do not let ring
+    notations:
+      - non l.v.
+  non_vibrato:
+    scopes:
+      - common
+    origin: italian
+    meaning: without vibrato
+    notations:
+      - non vibrato
+      - non vib.
+  open:
+    scopes:
+      - common
+      - strings
+      - brass
+      - winds
+      - guitar
+      - keyboard
+    origin: english
+    meaning: open string, unstopped, or unmuted
+    notations:
+      - open
+      - aperto
+      - "○"
+      - "o"
+  ordinario:
+    scopes:
+      - common
+    origin: italian
+    meaning: ordinary
+    notations:
+      - ordinario
+      - ord.
+  poco_vibrato:
+    scopes:
+      - common
+    origin: italian
+    meaning: little vibrato
+    notations:
+      - poco vibrato
+      - poco vib.
+  senza_sordino:
+    scopes:
+      - common
+    origin: italian
+    meaning: without mute
+    notations:
+      - senza sordino
+      - senza sord.
+      - mute off
+      - without mute
+  senza_vibrato:
+    scopes:
+      - common
+    origin: italian
+    meaning: without vibrato
+    notations:
+      - senza vibrato
+      - senza vib.
+  alla_chitarra:
+    scopes:
+      - strings
+    origin: italian
+    meaning: in the style of guitar
+    notations:
+      - alla chitarra
+  arco:
+    scopes:
+      - strings
+    origin: italian
+    meaning: with the bow
+    notations:
+      - arco
+  au_talon:
+    scopes:
+      - strings
+    origin: french
+    meaning: at the frog of the bow
+    notations:
+      - au talon
+      - a.t.
+  col_legno:
+    scopes:
+      - strings
+    origin: italian
+    meaning: with the wood of the bow
+    notations:
+      - col legno
+      - c.l.
+  col_legno_battuto:
+    scopes:
+      - strings
+    origin: italian
+    meaning: striking with the wood of the bow
+    notations:
+      - col legno battuto
+      - c.l.b.
+  col_legno_tratto:
+    scopes:
+      - strings
+    origin: italian
+    meaning: drawing with the wood of the bow
+    notations:
+      - col legno tratto
+      - c.l.t.
+  detache:
+    scopes:
+      - strings
+    origin: french
+    meaning: detached bow strokes
+    notations:
+      - détaché
+      - detache
+  flautando:
+    scopes:
+      - strings
+    origin: italian
+    meaning: flute-like tone near fingerboard
+    notations:
+      - flautando
+      - flaut.
+  artificial_harmonic:
+    scopes:
+      - guitar
+      - strings
+    origin: english
+    meaning: harmonic produced by touching string while plucking
+    notations:
+      - artificial harmonic
+      - A.H.
+      - AH
+  natural_harmonic:
+    scopes:
+      - guitar
+      - strings
+    origin: english
+    meaning: harmonic at natural node point
+    notations:
+      - natural harmonic
+      - N.H.
+      - NH
+  harmonic:
+    scopes:
+      - strings
+      - winds
+      - guitar
+    origin: english
+    meaning: harmonic tone
+    notations:
+      - harmonic
+      - harm.
+      - "○"
+  barre:
+    scopes:
+      - guitar
+    origin: french
+    meaning: finger laid flat across strings
+    notations:
+      - barré
+      - barre
+      - C
+  half_barre:
+    scopes:
+      - guitar
+    origin: french
+    meaning: partial barre across some strings
+    notations:
+      - half barré
+      - half barre
+      - ½C
+  palm_mute:
+    scopes:
+      - guitar
+    origin: english
+    meaning: muting strings with palm
+    notations:
+      - palm mute
+      - P.M.
+  jete:
+    scopes:
+      - strings
+    origin: french
+    meaning: thrown bouncing bow stroke
+    notations:
+      - jeté
+      - jete
+  martele:
+    scopes:
+      - strings
+    origin: french
+    meaning: hammered bow stroke
+    notations:
+      - martelé
+      - martele
+      - mart.
+  martellato:
+    scopes:
+      - strings
+    origin: italian
+    meaning: hammered
+    notations:
+      - martellato
+  pizzicato:
+    scopes:
+      - strings
+    origin: italian
+    meaning: plucked
+    notations:
+      - pizzicato
+      - pizz.
+  punta_d_arco:
+    scopes:
+      - strings
+    origin: italian
+    meaning: at the tip of the bow
+    notations:
+      - punta d'arco
+      - p.d.a.
+      - a.s.t.
+  saltando:
+    scopes:
+      - strings
+    origin: italian
+    meaning: bouncing bow stroke
+    notations:
+      - saltando
+      - salt.
+  spiccato:
+    scopes:
+      - strings
+    origin: italian
+    meaning: controlled bouncing bow stroke
+    notations:
+      - spiccato
+      - spicc.
+  sul_ponticello:
+    scopes:
+      - strings
+    origin: italian
+    meaning: near the bridge
+    notations:
+      - sul ponticello
+      - sul pont.
+      - s.p.
+      - p.s.t.
+  sul_tasto:
+    scopes:
+      - strings
+    origin: italian
+    meaning: over the fingerboard
+    notations:
+      - sul tasto
+      - s.t.
+  vibrato:
+    scopes:
+      - common
+    origin: italian
+    meaning: vibrating
+    notations:
+      - vibrato
+      - vib.
+  # Percussion techniques
+  stick:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: play with stick
+  pedal:
+    scopes:
+      - pitched_percussion
+      - keyboard
+    origin: english
+    meaning: use sustain pedal
+    notations:
+      - pedal
+      - ped.
+      - Ped.
+  sostenuto_pedal:
+    scopes:
+      - keyboard
+    origin: italian
+    meaning: use sostenuto pedal
+    notations:
+      - sostenuto
+      - sost.
+      - Sost.
+  una_corda:
+    scopes:
+      - keyboard
+    origin: italian
+    meaning: use soft pedal
+    notations:
+      - una corda
+      - u.c.
+  tre_corde:
+    scopes:
+      - keyboard
+    origin: italian
+    meaning: release soft pedal
+    notations:
+      - tre corde
+      - t.c.
+  half_pedal:
+    scopes:
+      - keyboard
+    origin: english
+    meaning: depress pedal halfway
+    notations:
+      - half pedal
+      - "½"
+  quarter_pedal:
+    scopes:
+      - keyboard
+    origin: english
+    meaning: depress pedal one quarter
+    notations:
+      - quarter pedal
+      - "¼"
+  three_quarter_pedal:
+    scopes:
+      - keyboard
+    origin: english
+    meaning: depress pedal three quarters
+    notations:
+      - three quarter pedal
+      - "¾"
+  mano_destra:
+    scopes:
+      - keyboard
+    origin: italian
+    meaning: right hand
+    notations:
+      - mano destra
+      - m.d.
+      - R.H.
+  mano_sinistra:
+    scopes:
+      - keyboard
+    origin: italian
+    meaning: left hand
+    notations:
+      - mano sinistra
+      - m.s.
+      - L.H.
+  sopra:
+    scopes:
+      - keyboard
+    origin: italian
+    meaning: above, hand crosses over
+  sotto:
+    scopes:
+      - keyboard
+    origin: italian
+    meaning: below, hand crosses under
+  mallet:
+    scopes:
+      - unpitched_percussion
+      - pitched_percussion
+    origin: english
+    meaning: play with mallet
+    notations:
+      - mallet
+      - mallets
+  hand:
+    scopes:
+      - unpitched_percussion
+      - pitched_percussion
+    origin: english
+    meaning: play with hand
+    notations:
+      - hand
+      - hands
+  brush:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: play with brushes
+    notations:
+      - brush
+      - brushes
+  rim_shot:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: strike rim and head simultaneously
+    notations:
+      - rim shot
+      - rimshot
+  cross_stick:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: stick laid across head, striking rim
+    notations:
+      - cross stick
+      - cross-stick
+      - side stick
+      - x-stick
+  open_percussion:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: open hi-hat or undamped
+    notations:
+      - open
+      - "o"
+      - "○"
+  closed:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: closed hi-hat or damped
+    notations:
+      - closed
+      - "+"
+  damped:
+    scopes:
+      - unpitched_percussion
+      - pitched_percussion
+    origin: english
+    meaning: mute or stop vibration
+    notations:
+      - damped
+      - damp
+  let_ring:
+    scopes:
+      - unpitched_percussion
+      - pitched_percussion
+    origin: english
+    meaning: allow to resonate
+    notations:
+      - let ring
+      - l.r.
+  choked:
+    scopes:
+      - unpitched_percussion
+      - pitched_percussion
+    origin: english
+    meaning: stop sound abruptly
+    notations:
+      - choked
+      - choke
+  bow:
+    scopes:
+      - strings
+      - pitched_percussion
+    origin: english
+    meaning: play with bow
+    notations:
+      - bow
+      - bowed
+      - arco
+  bell:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: strike bell of cymbal
+  left_hand:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: play with left hand
+    notations:
+      - left
+      - L
+  right_hand:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: play with right hand
+    notations:
+      - right
+      - R
+  center:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: strike at center of head or cymbal
+  edge:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: strike at edge of head or cymbal
+  muffled:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: dampened tone
+  snares_on:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: engage snare wires
+  snares_off:
+    scopes:
+      - unpitched_percussion
+    origin: english
+    meaning: disengage snare wires
+  motor_on:
+    scopes:
+      - pitched_percussion
+    origin: english
+    meaning: engage vibraphone motor
+  motor_off:
+    scopes:
+      - pitched_percussion
+    origin: english
+    meaning: disengage vibraphone motor
+  dead_stroke:
+    scopes:
+      - pitched_percussion
+    origin: english
+    meaning: mallet left on surface after striking
+    notations:
+      - dead stroke
+      - dead
+  # Choral/Vocal techniques
+  con_bocca_chiusa:
+    scopes:
+      - vocal
+    origin: italian
+    meaning: with closed mouth, humming
+    notations:
+      - con bocca chiusa
+      - bocca chiusa
+      - humming
+  # Brass techniques
+  bucket_mute:
+    scopes:
+      - brass
+    origin: english
+    meaning: mute with soft, mellow tone
+  cuivre:
+    scopes:
+      - brass
+    origin: french
+    meaning: brassy, forced tone
+    notations:
+      - cuivré
+      - cuivre
+  cup_mute:
+    scopes:
+      - brass
+    origin: english
+    meaning: mute with covered bell
+  harmon_mute:
+    scopes:
+      - brass
+    origin: english
+    meaning: wah-wah mute
+    notations:
+      - harmon mute
+      - harmon
+  harmon_mute_stem_in:
+    scopes:
+      - brass
+    origin: english
+    meaning: harmon mute with stem inserted
+    notations:
+      - harmon mute stem in
+      - stem in
+  harmon_mute_stem_out:
+    scopes:
+      - brass
+    origin: english
+    meaning: harmon mute with stem removed
+    notations:
+      - harmon mute stem out
+      - stem out
+  plunger_mute:
+    scopes:
+      - brass
+    origin: english
+    meaning: plunger used as mute
+    notations:
+      - plunger mute
+      - plunger
+  stopped:
+    scopes:
+      - brass
+    origin: english
+    meaning: hand stopping the bell
+    notations:
+      - stopped
+      - "+"
+  straight_mute:
+    scopes:
+      - brass
+    origin: english
+    meaning: standard conical mute
+  # Wind techniques
+  aeolian:
+    scopes:
+      - winds
+    origin: english
+    meaning: breathy tone without pitch
+    notations:
+      - aeolian
+      - aeolian sound
+  air:
+    scopes:
+      - winds
+    origin: english
+    meaning: air sound without tone
+    notations:
+      - air
+  flutter_tongue:
+    scopes:
+      - winds
+    origin: english
+    meaning: rapid tongue tremolo
+    notations:
+      - flutter tongue
+      - flutter
+      - flt.
+      - flz.
+      - f.t.
+  frullato:
+    scopes:
+      - winds
+    origin: italian
+    meaning: flutter tongue
+    notations:
+      - frullato
+      - frull.
+  key_clicks:
+    scopes:
+      - winds
+    origin: english
+    meaning: percussive sound from keys
+    notations:
+      - key clicks
+      - key click
+  slap_tongue:
+    scopes:
+      - winds
+    origin: english
+    meaning: percussive tonguing technique
+    notations:
+      - slap-tongue
+      - slap tongue
+      - slap
+  whistle_tone:
+    scopes:
+      - winds
+    origin: english
+    meaning: high harmonic whistle sound
+    notations:
+      - whistle tone
+      - whistle tones
+  # Harp techniques
+  pres_de_la_table:
+    scopes:
+      - harp
+    origin: french
+    meaning: near the soundboard
+    notations:
+      - près de la table
+      - p.d.l.t.