musa-dsl 0.30.2 → 0.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46593c12b7c6a2d9174c26a523395a0a5232761893d8421b8c6f3805d6c78073
-  data.tar.gz: 9d299fff075bced81094b0db3e6c9ded3bcd0cc77d92720fbd3158bee1897cf5
+  metadata.gz: 603ecc3ddd2b6bcead498e08a747035df5ff2c2e87e4f527c66c48d5631ab435
+  data.tar.gz: 37dde89a2c5ff9dda9691ff245fa06b4e870475fb7320ef10bca5ef0a7a84ed2
 SHA512:
-  metadata.gz: 48853c7eb338546219b24985b93690cc5051f37df4288e0d53711ab16afa45beb0be8fc60f87a5605d2187b2bd3bf3bc49dfef3eaba903965f3c29b6f5fdb93b
-  data.tar.gz: 32e28f2f7a897d3f025d3eda37ba4558b609fa1b8d44b0645ce3361bed7ea865798cbb9c8ad90feff473c84fc43a6aedee307058b2ca8148691ee667e601dc44
+  metadata.gz: 8b1bd0544fd6b6fe611718809e50422e3accf376e88da0832e7b22b7f5b279eb52d9cab2fe3c3f75d2e996e17f0c1a604a2e56676249c946dae533988db8a54c
+  data.tar.gz: 4c4dbcbfb7243f751205f275eaba483e8d29ce3ca5f59e600a1b8be9d1687c0815572916415b4dfbb0ac14ae7f2bbaec3ee610af2922fe8ab9de42e4ab3a04b2

data/.gitignore

@@ -9,4 +9,6 @@ Gemfile.lock
 bin
 *.mindnode
 test.musicxml
-
+doc
+.yardoc
+*.backup

data/.version

@@ -0,0 +1,6 @@
+# Configuración de versión para musa-dsl
+GEM_NAME="musa-dsl"
+MODULE_NAME="Musa"
+VERSION_FILE="lib/musa-dsl/version.rb"
+GEMSPEC_FILE="musa-dsl.gemspec"
+TEST_COMMAND="bundle exec rspec"

data/.yardopts

@@ -0,0 +1,7 @@
+--markup markdown
+--title "Musa-DSL API"
+--readme README.md
+--no-private
+--embed-mixins
+lib/**/*.rb
+

data/README.md

@@ -1,12 +1,233 @@
 # Musa-DSL
 
-Work in progress.
+[![Ruby Version](https://img.shields.io/badge/ruby-3.4.7-red.svg)](https://www.ruby-lang.org/)
+[![License](https://img.shields.io/badge/license-LGPL--3.0--or--later-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0.html)
 
-A programming language DSL based on Ruby for sonic and musical composition. 
-Emphasizes the creation of complex temporal structures independently of the audio rendering engine.
+A Ruby framework and DSL for algorithmic sound and musical thinking and composition.
 
-Some works can be listened on [yeste.studio](https://soundcloud.com/yeste-studio) Soundcloud.
+## Description
 
----
+Musa-DSL is a programming language DSL (Domain-Specific Language) based on Ruby designed for sonic and musical composition. It emphasizes the creation of complex temporal structures independently of the audio rendering engine, providing composers and developers with powerful tools for algorithmic composition, generative music, and musical notation.
 
-Coded on [Jetbrains RubyMine IDE](https://www.jetbrains.com/?from=Musa-DSL). Thanks a lot for your support letting me use an Open Source project free license! 
+**Who is it for?**
+
+- Composers exploring algorithmic composition
+- Musicians interested in generative music systems
+- Developers building music applications
+- Researchers in computational musicology
+- Live coders and interactive music performers
+
+## Key Features
+
+- **Advanced Sequencer** - Precise temporal control for complex polyrhythmic and polytemporal structures
+- **Transport & Timing** - Multiple clock sources (internal, MIDI, external) with microsecond precision
+- **Audio Engine Independent** - Works with any MIDI-capable, OSC-capable or any other output hardware or software system
+- **Series-Based Composition** - Flexible sequence generators for pitches, rhythms, dynamics, and any musical parameter
+- **Generative Tools** - Markov chains, combinatorial variations (Variatio), rule-based production systems (Rules), formal grammars (GenerativeGrammar), and genetic algorithms (Darwin)
+- **Matrix Operations** - Mathematical transformations for musical structures
+- **Scale System** - Comprehensive support for scales, tuning systems, and chord structures
+- **Neumalang Notation** - Intuitive text-based and customizable musical (or sound) notation
+- **Transcription System** - Convert musical gestures to MIDI and MusicXML with ornament transcription expansion
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'musa-dsl'
+```
+
+Or install directly:
+
+```bash
+gem install musa-dsl
+```
+
+**Requirements:**
+- Ruby ~> 3.4
+
+## Quick Start
+
+A complete working example with multiple interacting voice lines, demonstrating sequencer DSL, timing control, and shared state.
+
+**📖 [Complete Quick Start Guide](docs/getting-started/quick-start.md)**
+
+## Tutorial
+
+Detailed tutorial showing the Neuma notation system for composing melodies with grade-based notation.
+
+**📖 [Complete Tutorial](docs/getting-started/tutorial.md)**
+
+## System Architecture
+
+MusaDSL is a comprehensive ecosystem consisting of a core framework (musa-dsl) and associated projects for communication, development, and integration.
+
+### MusaDSL Ecosystem
+
+**Core Framework:**
+- [**musa-dsl**](https://github.com/javier-sy/musa-dsl) - Main DSL framework for algorithmic composition and musical thinking
+
+**MIDI Communication Stack:**
+- [**midi-events**](https://github.com/javier-sy/midi-events) - Low-level MIDI event definitions and protocols
+- [**midi-parser**](https://github.com/javier-sy/midi-parser) - MIDI file parsing and analysis
+- [**midi-communications**](https://github.com/javier-sy/midi-communications) - Cross-platform MIDI I/O abstraction layer
+- [**midi-communications-macos**](https://github.com/javier-sy/midi-communications-macos) - macOS-specific MIDI native implementation
+
+**Live Coding Environment (MusaLCE):**
+- [**musalce-server**](https://github.com/javier-sy/musalce-server) - Live coding evaluation server with hot-reload capabilities
+- [**MusaLCEClientForVSCode**](https://github.com/javier-sy/MusaLCEClientForVSCode) - Visual Studio Code extension for live coding
+- [**MusaLCEClientForAtom**](https://github.com/javier-sy/MusaLCEClientForAtom) - Atom editor plugin for live coding
+- [**MusaLCEforBitwig**](https://github.com/javier-sy/MusaLCEforBitwig) - Bitwig Studio integration for live coding
+- [**MusaLCEforLive**](https://github.com/javier-sy/MusaLCEforLive) - Ableton Live integration for live coding
+
+### musa-dsl Internal Architecture
+
+The musa-dsl framework is organized in modular layers:
+
+#### 1. Foundation Layer
+- **core-ext** - Ruby core extensions (refinements for enhanced syntax)
+- **logger** - Structured logging system with severity levels
+
+#### 2. Temporal & Scheduling Layer
+- **sequencer** - Event scheduling engine with microsecond precision
+  - Tick-based (quantized) and tickless (continuous) timing modes
+  - Series playback with automatic duration management
+  - Support for polyrhythms and polytemporal structures
+- **transport** - High-level playback control with clock synchronization
+  - BPM management and tempo changes
+  - Start/stop/pause/continue controls
+  - Multiple clock source support (internal, MIDI, external)
+
+#### 3. Notation & Parsing Layer
+- **neumas** - Text-based musical notation system
+- **neumalang** - Parser and interpreter for neuma notation with DSL support
+
+#### 4. Generation & Transformation Layer
+- **series** - Lazy sequence generators with functional operations
+  - Map, filter, transpose, repeat, and combination operations
+  - Infinite and finite series support
+- **generative** - Algorithmic composition tools
+  - **Markov chains**: Probabilistic sequence generation
+  - **Variatio**: Cartesian product parameter variations
+  - **Rules**: L-system-like production systems with growth/pruning
+  - **GenerativeGrammar**: Formal grammar-based generation
+  - **Darwin**: Genetic algorithms for evolutionary composition
+- **matrix** - Matrix operations for musical gestures
+  - Matrix-to-P (point sequence) conversion
+  - Gesture condensation and transformation
+
+#### 5. Output & Communication Layer
+- **transcription** - Musical event transformation system
+  - Ornament expansion (trills, mordents, turns)
+  - GDV to MIDI/MusicXML conversion
+  - Dynamic articulation rendering
+- **musicxml** - MusicXML score generation
+  - Multi-part score creation
+  - Notation directives (dynamics, tempo, articulations)
+  - Standard MusicXML 3.0 output
+- **midi** - MIDI voice management
+  - Polyphonic voice allocation
+  - Channel management
+  - Note-on/note-off scheduling
+
+#### 6. Musical Knowledge Layer
+- **music** - Scales, tuning systems, intervals, and chord structures
+  - Equal temperament and just intonation support
+  - Modal scales (major, minor, chromatic, etc.)
+  - Chord definitions and harmonic analysis
+- **datasets** - Musical data structures (GDV, PDV, Score)
+  - GDV (Grade-Duration-Velocity): Scale-relative representation
+  - PDV (Pitch-Duration-Velocity): Absolute pitch representation
+  - Score: Timeline-based multi-track composition structure
+
+#### 7. Development & Interaction Layer
+- **repl** - Interactive Read-Eval-Print Loop for live composition
+
+## Core Subsystems
+
+### MIDI - Voice Management & Recording
+
+Polyphonic voice management for MIDI output with automatic note tracking, and MIDI input recording with precise timestamping.
+
+**📖 [Complete Documentation](docs/subsystems/midi.md)**
+
+### Sequencer - Temporal Engine
+
+Event scheduling engine with musical time (bars/beats), precise tick-based timing, and DSL for temporal composition.
+
+**📖 [Complete Documentation](docs/subsystems/sequencer.md)**
+
+### Transport - Timing & Clocks
+
+Comprehensive timing infrastructure connecting clock sources to the sequencer. Supports multiple clock types (TimerClock, InputMidiClock, ExternalTickClock, DummyClock) and manages playback lifecycle with precise timing control.
+
+**📖 [Complete Transport Documentation](docs/subsystems/transport.md)**
+
+
+### Series - Sequence Generators
+
+Lazy functional sequence generators with map/filter operations, numeric generators, buffering, quantization, and timed merging.
+
+**📖 [Complete Documentation](docs/subsystems/series.md)**
+
+### Neumas & Neumalang - Musical Notation
+
+Compact text-based musical notation system with parser for converting notation to structured musical data.
+
+**📖 [Complete Documentation](docs/subsystems/neumas.md)**
+
+### Datasets - Sonic Data Structures
+
+Type-safe musical event representations (GDV, PDV, PS, P, V) with conversions, validation, Score container, and advanced queries.
+
+**📖 [Complete Documentation](docs/subsystems/datasets.md)**
+
+### Matrix - Sonic Gesture Conversion
+
+Convert matrix representations to point sequences for sequencer playback, treating sonic gestures as geometric objects.
+
+**📖 [Complete Documentation](docs/subsystems/matrix.md)**
+
+### Transcription - MIDI & MusicXML Output
+
+Convert between representations with ornament expansion for MIDI or preservation as notation symbols for MusicXML.
+
+**📖 [Complete Documentation](docs/subsystems/transcription.md)**
+
+### Music - Scales & Chords
+
+Comprehensive scale and chord systems with equal temperament, custom tunings, chord navigation, and extensible definitions.
+
+**📖 [Complete Documentation](docs/subsystems/music.md)**
+
+### Generative - Algorithmic Composition
+
+Algorithmic composition tools: Markov chains, Variatio, Rules (L-systems), GenerativeGrammar, and Darwin (genetic algorithms).
+
+**📖 [Complete Documentation](docs/subsystems/generative.md)**
+
+### MusicXML Builder - Music Notation Export
+
+Comprehensive MusicXML score generation with hierarchical structure, multiple voices, articulations, and dynamics.
+
+**📖 [Complete Documentation](docs/subsystems/musicxml-builder.md)**
+
+### REPL - Live Coding Infrastructure
+
+TCP-based server for live coding with MusaLCE clients (VSCode, Atom, Bitwig, Live), real-time code evaluation and error handling.
+
+**📖 [Complete Documentation](docs/subsystems/repl.md)**
+
+### Core Extensions - Advanced Metaprogramming
+
+Ruby refinements and metaprogramming utilities: Arrayfy, Hashify, ExplodeRanges, DeepCopy, DynamicProxy, AttributeBuilder, Logger.
+
+**📖 [Complete Documentation](docs/subsystems/core-extensions.md)**
+
+## Author
+
+* [Javier Sánchez Yeste](https://github.com/javier-sy)
+
+## License
+
+[Musa-DSL](https://github.com/javier-sy/musa-dsl) Copyright (c) 2016-2025 [Javier Sánchez Yeste](https://yeste.studio), licensed under LGPL 3.0 License

data/docs/README.md

@@ -0,0 +1,83 @@
+# Musa DSL Documentation
+
+Complete documentation for the Musa DSL framework for algorithmic sound and musical composition.
+
+## 📚 Documentation Structure
+
+### Getting Started
+- **[Installation](../README.md#installation)** - Set up Musa DSL
+- **[Quick Start](../README.md#quick-start)** - 5-minute introduction
+- **[Not So Quick Start](../README.md#not-so-quick-start)** - Comprehensive tutorial
+
+### Core Subsystems
+
+Detailed documentation for each Musa DSL subsystem:
+
+| Subsystem | Description | Documentation |
+|-----------|-------------|---------------|
+| **MIDI** | Voice management & recording | [midi.md](subsystems/midi.md) |
+| **Sequencer** | Temporal engine | [sequencer.md](subsystems/sequencer.md) |
+| **Transport** | Timing & clocks | [subsystems/transport.md](subsystems/transport.md) |
+| **Series** | Sequence generators | [series.md](subsystems/series.md) |
+| **Neumas** | Musical notation | [neumas.md](subsystems/neumas.md) |
+| **Datasets** | Sonic data structures | [datasets.md](subsystems/datasets.md) |
+| **Matrix** | Sonic gesture conversion | [matrix.md](subsystems/matrix.md) |
+| **Transcription** | MIDI & MusicXML output | [transcription.md](subsystems/transcription.md) |
+| **Music** | Scales & chords | [music.md](subsystems/music.md) |
+| **Generative** | Algorithmic composition | [generative.md](subsystems/generative.md) |
+| **MusicXML Builder** | Music notation export | [musicxml-builder.md](subsystems/musicxml-builder.md) |
+
+### Advanced Topics
+
+For users extending the DSL or integrating deeply:
+
+| Topic | Description | Documentation |
+|-------|-------------|---------------|
+| **REPL** | Live coding infrastructure | [repl.md](subsystems/repl.md) |
+| **Core Extensions** | Metaprogramming utilities | [core-extensions.md](subsystems/core-extensions.md) |
+
+## 🎯 Learning Paths
+
+### New to Musa DSL?
+1. Start with [Quick Start](../README.md#quick-start)
+2. Read [System Architecture](../README.md#system-architecture)
+3. Explore subsystems in this order:
+   - [MIDI](subsystems/midi.md) - Output basics
+   - [Sequencer](subsystems/sequencer.md) - Temporal control
+   - [Series](subsystems/series.md) - Sequence generation
+   - [Datasets](subsystems/datasets.md) - Data structures
+
+### Want to Compose?
+1. Learn [Neumas](subsystems/neumas.md) notation
+2. Explore [Music](subsystems/music.md) (scales & chords)
+3. Try [Generative](subsystems/generative.md) algorithms
+4. Use [MusicXML Builder](subsystems/musicxml-builder.md) for scores
+
+### Live Coding?
+1. Set up [REPL](subsystems/repl.md)
+2. Configure MusaLCE client (VSCode/Atom/Bitwig/Live)
+3. Learn [Sequencer](subsystems/sequencer.md) DSL
+4. Explore [Transport](subsystems/transport.md) for timing
+
+### Extending the DSL?
+1. Understand [Core Extensions](subsystems/core-extensions.md)
+2. Study [Datasets](subsystems/datasets.md) extensibility
+3. Review existing subsystem implementations
+4. Check YARD documentation for API details
+
+## 📖 Additional Resources
+
+- **Main README**: [../README.md](../README.md)
+- **API Reference**: [api-reference.md](api-reference.md) - Complete class/method documentation (RubyDoc.info)
+- **Examples**: See examples/ directory in repository
+- **Source Code**: lib/musa-dsl/
+
+## 🔗 External Links
+
+- **GitHub Repository**: https://github.com/javier-sy/musa-dsl
+- **RubyGems**: https://rubygems.org/gems/musa-dsl
+- **Community**: See [Contributing](../README.md#contributing)
+
+---
+
+**Navigation**: [← Back to Main README](../README.md) | [↑ Top](#musa-dsl-documentation)

data/docs/api-reference.md

@@ -0,0 +1,86 @@
+# API Reference
+
+Complete class and method documentation generated from inline YARD comments.
+
+## Online Documentation
+
+**Official API documentation is hosted on RubyDoc.info:**
+
+🔗 **[https://rubydoc.info/gems/musa-dsl](https://rubydoc.info/gems/musa-dsl)**
+
+This documentation is automatically generated and updated with each gem release.
+
+## Key Modules
+
+### Foundation
+- [Musa::Extension](https://rubydoc.info/gems/musa-dsl/Musa/Extension) - Ruby refinements and metaprogramming
+- [Musa::Logger](https://rubydoc.info/gems/musa-dsl/Musa/Logger) - Structured logging
+
+### Temporal & Scheduling
+- [Musa::Sequencer](https://rubydoc.info/gems/musa-dsl/Musa/Sequencer) - Event scheduling engine
+- [Musa::Transport](https://rubydoc.info/gems/musa-dsl/Musa/Transport) - Playback lifecycle
+- [Musa::Clock](https://rubydoc.info/gems/musa-dsl/Musa/Clock) - Timing sources
+
+### Notation & Parsing
+- [Musa::Neumas](https://rubydoc.info/gems/musa-dsl/Musa/Neumas) - Musical notation
+- [Musa::Neumalang](https://rubydoc.info/gems/musa-dsl/Musa/Neumalang) - Notation parser
+
+### Generation & Transformation
+- [Musa::Series](https://rubydoc.info/gems/musa-dsl/Musa/Series) - Sequence generators
+- [Musa::Generative](https://rubydoc.info/gems/musa-dsl/Musa/Generative) - Algorithmic composition
+- [Musa::Matrix](https://rubydoc.info/gems/musa-dsl/Musa/Matrix) - Gesture conversion
+
+### Output & Communication
+- [Musa::Transcription](https://rubydoc.info/gems/musa-dsl/Musa/Transcription) - Event transformation
+- [Musa::MusicXML::Builder](https://rubydoc.info/gems/musa-dsl/Musa/MusicXML/Builder) - Score generation
+- [Musa::MIDIVoices](https://rubydoc.info/gems/musa-dsl/Musa/MIDIVoices) - Voice management
+- [Musa::MIDIRecorder](https://rubydoc.info/gems/musa-dsl/Musa/MIDIRecorder) - MIDI recording
+
+### Musical Knowledge
+- [Musa::Scales](https://rubydoc.info/gems/musa-dsl/Musa/Scales) - Scale systems
+- [Musa::Chords](https://rubydoc.info/gems/musa-dsl/Musa/Chords) - Chord structures
+- [Musa::Datasets](https://rubydoc.info/gems/musa-dsl/Musa/Datasets) - Data structures
+
+### Development
+- [Musa::REPL](https://rubydoc.info/gems/musa-dsl/Musa/REPL) - Live coding server
+
+## Generating Documentation Locally
+
+If you want to generate the API documentation locally:
+
+### Install YARD
+
+```bash
+gem install yard
+```
+
+### Generate Documentation
+
+```bash
+cd /path/to/musa-dsl
+yard doc
+```
+
+This creates documentation in the `doc/` directory (not versioned in git).
+
+### Browse Documentation
+
+```bash
+yard server
+```
+
+Then open http://localhost:8808 in your browser.
+
+## Documentation Coverage
+
+Check which code is documented:
+
+```bash
+yard stats --list-undoc
+```
+
+## See Also
+
+- **Conceptual Documentation**: [subsystems/](subsystems/) - Guides and tutorials for each subsystem
+- **Getting Started**: [getting-started/](getting-started/) - Quick start and tutorials
+- **Main Documentation**: [README.md](README.md) - Documentation hub

data/docs/getting-started/quick-start.md

@@ -0,0 +1,93 @@
+# Quick Start
+
+Here's a complete example showcasing the sequencer DSL with multiple melodic lines that interact with each other:
+
+```ruby
+require 'musa-dsl'
+require 'midi-communications'
+
+# Include all Musa DSL components
+include Musa::All
+
+# Setup MIDI output
+output = MIDICommunications::Output.gets  # Interactively select output
+
+# Create clock and transport with sequencer
+# 4 beats per bar, 24 ticks per beat
+clock = TimerClock.new(bpm: 120, ticks_per_beat: 24)
+transport = Transport.new(clock, 4, 24)
+
+# Create scale for our composition
+scale = Scales.et12[440.0].major[60]  # C major starting at middle C
+
+# Setup three MIDI voices on different channels
+voices = MIDIVoices.new(
+  sequencer: transport.sequencer,
+  output: output,
+  channels: [0, 1, 2]  # Channels for beat, melody, and harmony
+)
+beat_voice = voices.voices[0]
+melody_voice = voices.voices[1]
+harmony_voice = voices.voices[2]
+
+# Shared state: current melody note (so harmony can follow)
+current_melody_note = nil
+
+# Program the sequencer using DSL
+transport.sequencer.with do
+  # Line 1: Beat every 4 bars (for 32 bars total)
+  at 1 do
+    every 4, duration: 32 do
+      beat_voice.note pitch: 36, velocity: 100, duration: 1/8r  # Kick drum
+    end
+  end
+
+  # Line 2: Ascending melody (bars 1-16) then descending (bars 17-32)
+  at 1 do
+    # Ascending: move from grade 0 to grade 14 over 16 bars
+    move(from: 0, to: 14, duration: 16, every: 1/4r) do |grade|
+      pitch = scale[grade.round].pitch
+      current_melody_note = grade.round  # Share with harmony line
+      melody_voice.note pitch: pitch, velocity: 80, duration: 1/8r
+    end
+  end
+
+  at 17 do
+    # Descending: move from grade 14 to grade 0 over 16 bars
+    move(from: 14, to: 0, duration: 16, every: 1/4r) do |grade|
+      pitch = scale[grade.round].pitch
+      current_melody_note = grade.round  # Share with harmony line
+      melody_voice.note pitch: pitch, velocity: 80, duration: 1/8r
+    end
+  end
+
+  # Line 3: Harmony playing 3rd or 5th every 2 bars (for 32 bars total)
+  at 1 do
+    use_third = true  # Alternate between 3rd and 5th
+
+    every 2, duration: 32 do
+      if current_melody_note
+        # Calculate harmony: 3rd is +2 grades, 5th is +4 grades
+        harmony_grade = current_melody_note + (use_third ? 2 : 4)
+        harmony_pitch = scale[harmony_grade].pitch
+
+        # Play long note (whole note duration)
+        harmony_voice.note pitch: harmony_pitch, velocity: 70, duration: 1
+
+        # Alternate for next time
+        use_third = !use_third
+      end
+    end
+  end
+end
+
+# Start playback
+transport.start
+```
+
+This example demonstrates:
+- **Multiple independent voice lines** scheduled in the sequencer
+- **`move` function** to smoothly animate pitch values over time
+- **`every` for repeating events** at regular intervals
+- **Shared state between voices** (harmony follows melody)
+- **Precise timing control** with bars and beats

data/docs/getting-started/tutorial.md

@@ -0,0 +1,58 @@
+# Tutorial: Not So Quick Start
+
+Here's a more detailed example showing the Neuma notation system:
+
+```ruby
+require 'musa-dsl'
+require 'midi-communications'
+
+# Include all Musa DSL components
+include Musa::All
+
+using Musa::Extension::Neumas
+
+# Create a decoder with a major scale
+scale = Scales.et12[440.0].major[60]
+decoder = Decoders::NeumaDecoder.new(
+  scale,
+  base_duration: 1r  # Base duration for explicit duration values
+)
+
+# Define a melody using neuma notation with duration and velocity
+# Format: (grade duration velocity)
+# Durations: 1/4 = quarter, 1/2 = half, 1 = whole
+# Velocities: pp, p, mp, mf, f, ff
+melody = "(0 1/4 p) (+2 1/4 mp) (+2 1/4 mf) (-1 1/2 f) " \
+         "(0 1/4 mf) (+4 1/4 mp) (+5 1/2 f) (+7 1/4 ff) " \
+         "(+5 1/4 f) (+4 1/4 mf) (+2 1/4 mp) (0 1 p)"
+
+# Decode to GDV (Grade-Duration-Velocity) events
+gdv_notes = Neumalang.parse(melody, decode_with: decoder)
+
+# Convert GDV to PDV (Pitch-Duration-Velocity) for playback
+pdv_notes = gdv_notes.map { |note| note.to_pdv(scale) }
+
+# Setup MIDI output and sequencer
+output = MIDICommunications::Output.gets  # Interactively select output
+
+# Create clock and transport with sequencer
+clock = TimerClock.new(bpm: 120, ticks_per_beat: 24)
+transport = Transport.new(clock, 4, 24)
+
+# Setup MIDI voices for output
+voices = MIDIVoices.new(
+  sequencer: transport.sequencer,
+  output: output,
+  channels: [0]
+)
+voice = voices.voices.first
+
+# Play notes using sequencer (automatically manages timing)
+sequencer = transport.sequencer
+sequencer.play(pdv_notes) do |note|
+  voice.note pitch: note[:pitch], velocity: note[:velocity], duration: note[:duration]
+end
+
+# Start playback
+transport.start
+```