Parse overtones with 3 overtones (default: root, P5, M3)

Parse key (overtone count not used for keys)

Parse fundamentals with 3 overtones (default)

Parse tuning with 3 overtones (default: root, P5, M3 — the distinct pitch classes of the playable tapped-harmonic domain)

Resolve roots with special options "key" and "tones".

This function allows root selection to be derived from other filter values: * "key": Use the same pitch classes as the key filter produces * "tones": Use the key-filtered overtones (effective upper structure) * Other values: Parsed via parseFunds as normal

Arguments: * overtoneFilter: The overtones/tuning filter string * keyFilter: The key filter string * rootsFilter: The roots filter string (may be "key" or "tones")

Examples: resolveRoots "E A D G" "#" "key" -> G major scale degrees [0,2,4,6,7,9,11] resolveRoots "E A D G" "#" "tones" -> key-filtered overtones from E A D G resolveRoots "E A D G" "#" "C G" -> [0, 7]

Parse overtones from a String (Tidal-friendly) Example: overtones "E A D G" -> bass tuning overtones

Parse key from a String (Tidal-friendly) Example: key "#" -> G major, key "bb" -> Bb major

Parse fundamentals from a String (Tidal-friendly) Example: funds "E F# G" -> [4, 6, 7]

Parse tuning from a String (Tidal-friendly)

Check if a string is a wildcard (Tidal-friendly)

Filter a pitch class set by overtones/tuning filter

Filter a pitch class set by key

Filter root candidates by roots filter

Check if a filter string is a wildcard (matches everything)

Check if a pitch class set matches the overtones filter

Check if a pitch class set matches the key filter

Check if a root pitch class matches the roots filter

Concrete direction action resolved for a single generation step. When active, the bass/root at the next step is forced to the Nth note above (Rise) or below (Fall) in the allowed set, with mod-12 wrapping. Step size 1 = closest note, 2 = skip one, etc.

Parsed specification for a rise/fall direction token. Resolved per step at generation time to a concrete BassDirection (or Nothing when the optional ? flag causes the direction to be skipped for that step).

Whether a parsed direction rises or falls.

How to pick a step size from bdsChoices at each generation step.

Extract a bass-direction spec from a roots filter string. Returns the first token that parses as a direction; Nothing otherwise.

Examples: parseBassDirectionSpec "* fall" -- Just (fixed Fall 1) parseBassDirectionSpec "* rise1" -- Just (fixed Rise 1) -- alias for "rise" parseBassDirectionSpec "* rise3" -- Just (fixed Rise 3) parseBassDirectionSpec "* fall2?" -- Just (fixed Fall 2, optional) parseBassDirectionSpec "* fall<3 2 1>" -- Just (rotate Fall [3,2,1]) parseBassDirectionSpec "* rise<1,2>" -- Just (random Rise [1,2]) parseBassDirectionSpec "* rise<1 2,3>?" -- Just (random Rise [1,2,3], optional) parseBassDirectionSpec "C E G" -- Nothing

Strip the direction token from a roots filter string, leaving only the pitch set specification for normal parsing.

Examples: stripDirectionToken "* fall" == "*" stripDirectionToken "0# rise1" == "0#" stripDirectionToken "0# rise?" == "0#" stripDirectionToken "C E G fall<2,3>" == "C E G" stripDirectionToken "C E G" == "C E G"

Find the closest pitch class above. Equivalent to nthAbove 1.

Find the closest pitch class below. Equivalent to nthBelow 1.

Find the Nth pitch class ABOVE the current one in the allowed set, sorted by ascending circular distance. Step 1 = closest, 2 = skip one, etc. When N exceeds the set size, wraps around using modular indexing. If the set has only the current note, returns it (pedal).

Examples (with C major = {0,2,4,5,7,9,11}): nthAbove 1 7 cMaj == 9 (G → A, closest) nthAbove 3 0 cMaj == 5 (C → F, 3rd above) nthAbove 1 11 cMaj == 0 (B → C, wraps mod-12) nthAbove 1 0 {0} == 0 (pedal)

Find the Nth pitch class BELOW the current one in the allowed set, sorted by ascending circular distance downward. Step 1 = closest, etc. When N exceeds the set size, wraps around using modular indexing. If the set has only the current note, returns it (pedal).

Examples (with C major = {0,2,4,5,7,9,11}): nthBelow 1 7 cMaj == 5 (G → F, closest) nthBelow 3 7 cMaj == 2 (G → D, 3rd below) nthBelow 1 0 cMaj == 11 (C → B, wraps mod-12) nthBelow 1 5 {5} == 5 (pedal)

Parse an overtones filter with full notation support. This is the most general parser, combining tuning notation with individual pitches. Supports removal with - prefix: "C E -E'" removes E pitch from (C ∪ E) overtones

Parse a key filter string.

Formats: * Note name: C, Bb, F → single pitch class * Numbered key sig: "0#" = C major, "1#" = G major, "2b" = Bb major * Wildcard: "*" * Removal: "1b -G" (F major minus G), "* -C'" (all minus C)

Parse fundamentals (root notes) filter.

Formats: * Note names: "E F# G" → individual pitches [4,6,7] * Numbered key sig: "1b" = F major roots, "2#" = D major roots * Wildcard: "*" * Removal: "C G -G" (C and G minus G), "* -E -A" (all except E,A)

Parse a tuning string into pitch class set (overtones of fundamentals).

Examples: * "E A D G" → overtones of E, A, D, G (bass tuning) * C → overtones of C * "*" → all pitch classes

Partition input tokens into positive and negative (those prefixed with -) Returns (positive tokens, negative tokens with - prefix stripped)

Convert a key specification to pitch classes

Map note names to pitch classes Handles: c, c#, db, d, d#, eb, e, f, f#, gb, g, g#, ab, a, a#, bb, b Also: b# = c, cb = b, etc.

Parse a tuning string preserving string names for overtone annotation. Case is preserved for string identification (uppercase = lower octave, lowercase = higher octave per thesis convention).

Examples: "E A D G" → [(E,4), (A,9), (D,2), (G,7)] "E A e G B" → [(E,4), (A,9), ("e",4), (G,7), (B,11)] "*" → [] (wildcard has no named strings)