> ## Documentation Index
> Fetch the complete documentation index at: https://songbird.studiocollective.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# songbird-theory

# songbird-theory

Music theory primitives — scales, chords, progressions, note parsing.

## What it owns

* Scale and chord representations and the database of named scales/tunings.
* Note name ↔ MIDI number conversions.
* Progression and sequencing helpers built on top of scales.

## Public API

* `Chord`, `Scale`, `Progression`, `ScaleDatabase`, `ScaleDefinition`.
* `note_from_number`, `midi_from_note_name`, `midi_from_chord_name`.

## How it fits

Pure-data crate. Used by `songbird-composition`. No workspace deps; serde only.

## Tests

`cargo test -p songbird-theory`.