From 25d7ddcd1bb03beadbae6ceb2354f1aab9b6e052 Mon Sep 17 00:00:00 2001
From: Jonathan Bernard <jonathan@jdbernard.com>
Date: Mon, 2 Jun 2025 16:21:22 -0500
Subject: [PATCH] Major refactor of internal note storage to better support
 transposition.

Refactor to store notes as key-agnostic scale degrees + alterations
(flat, sharp, etc.).

We now think of a pitch in different ways:
- *Note*: the 7 notes diatonic to C major. Notes capture the principle
  in western harmony of the common scales having seven distinct diatonic
  "notes" and allows us to do arithmetic with them (do up three scale
  degrees).
- *Pitch*: the 12 chromatic pitches, regardless key. Pitch allows us to
  assign unique names and ordinal values to each note of the chromatic
  scale, allowing us to do arithmetic with them.
- *SpelledPitch*: a unique spelling of one of the chromatic pitches
  (*Note* + alteration) allowing the stylistic choice to use
  different *Notes* to describe a single *Pitch*.
- *ScaleDegree*: a variant of *SpelledPitch* that uses the scale degree
  instead of the *Pitch* to store a pitch in a key-agnostic manner.

To illustrate, the difference, consider the flat-six in the key of Eb.
- *Note*: The 6th scale degree in Eb is C (1-E 2-F 3-G 4-A 5-B 6-C).
- *Pitch*: In the chromatic scale, ignoring the key, this is the *Pitch*
  called B.
- *SpelledPitch*: In the context of the key of Eb, because this is the
  *Note* C, we should spell this as Cb, not B. So the spelled pitch is
  *Note*(C), *Alteration*(flat).
- *ScaleDegree*: This captures the key-agnostic representation that we
  used in the begining: *Number*(6) and *Alteration*(flat)

With these four ways of representing a note, we can transpose any
pitches that follow western 12-tone harmony arbitrarily between keys
preserving the author's choice of chord function (remembering that this
is the b6 and not the #5, in our example).

Building on this new notational data model, the AST now uses the
*ScaleDegree* relative to the provided key as the internal
representation of a pitch. Formatting of a *ScaleDegree* always requires
the key in which it is being rendered. Transposition is now only a
matter or updating the current key.
---
 pco_chords.nimble                  |   2 +-
 src/pco_chordspkg/ast.nim          | 174 ++++----------------
 src/pco_chordspkg/cliconstants.nim |   2 +-
 src/pco_chordspkg/html.nim         |  91 ++++-------
 src/pco_chordspkg/notation         | Bin 0 -> 156568 bytes
 src/pco_chordspkg/notation.nim     | 245 +++++++++++++++++++++++++++++
 6 files changed, 301 insertions(+), 213 deletions(-)
 create mode 100755 src/pco_chordspkg/notation
 create mode 100644 src/pco_chordspkg/notation.nim

diff --git a/pco_chords.nimble b/pco_chords.nimble
index 2e58e32..b13a6ea 100644
--- a/pco_chords.nimble
+++ b/pco_chords.nimble
@@ -1,6 +1,6 @@
 # Package
 
-version       = "0.5.6"
+version       = "0.6.0"
 author        = "Jonathan Bernard"
 description   = "Chord chart formatter compatible with Planning Center Online"
 license       = "MIT"
diff --git a/src/pco_chordspkg/ast.nim b/src/pco_chordspkg/ast.nim
index f2dfdf2..8fbdb1c 100644
--- a/src/pco_chordspkg/ast.nim
+++ b/src/pco_chordspkg/ast.nim
@@ -1,10 +1,11 @@
 import std/[nre, strtabs, strutils]
+import ./notation
 import zero_functional
 
 type
   ChordChartMetadata* = object
     title*: string
-    key*: ChordChartChord
+    key*: Key
     optionalProps: StringTableRef
 
   ChordChart* = ref object
@@ -23,13 +24,11 @@ type
     ccnkRedefineKey,
     ccnkNone
 
-  ChordChartPitch* = enum Af, A, Bf, B, C, Df, D, Ef, E, F, Gf, G
-
   ChordChartChord* = object
     original*: Option[string]
-    rootPitch*: ChordChartPitch
+    root*: ScaleDegree
     flavor*: Option[string]
-    bassPitch*: Option[ChordChartPitch]
+    bass*: Option[ScaleDegree]
 
   ChordChartNode* = ref object
     case kind: ChordChartNodeKind
@@ -52,12 +51,12 @@ type
     of ccnkTransposeKey:
       transposeSteps*: int
     of ccnkRedefineKey:
-      newKey*: ChordChartPitch
+      newKey*: Key
     of ccnkNone: discard
 
   ParserContext = ref object
     lines: seq[string]
-    curKeyCenter: ChordChartPitch
+    curKey: Key
     curLineNum: int
     curSection: ChordChartNode
     unparsedLineParts: seq[string]
@@ -77,97 +76,6 @@ iterator pairs*(ccmd: ChordChartMetadata): tuple[key, value: string] =
 
 func kind*(ccn: ChordChartNode): ChordChartNodeKind = ccn.kind
 
-func `$`*(pitch: ChordChartPitch): string =
-  ["A♭", "A", "B♭", "B", "C", "D♭", "D", "E♭", "E", "F", "G♭", "G"][ord(pitch)]
-
-func renderPitchInKey*(
-    pitch: ChordChartPitch,
-    key: ChordChartPitch,
-    useSharps: Option[bool] = none[bool]()): string =
-
-  var scaleNames: array[(ord(high(ChordChartPitch)) + 1), string]
-  if useSharps.isNone:
-    # If we aren't told to use sharps or flats, we render the diatonic pitches
-    # according to standard theory (C# in the key of D, Db in the key of Ab)
-    # but we render non-diatonic notes with flats (prefer the b6 and b7 over
-    # the #5 and #6).
-    #
-    # TODO: In the future, we should also remember the scale degree of the
-    # chord when parsing. So, for example, in the key of D we would parse Bb as
-    # the b6 and A# as the #5. The pitch would be the same, but the scale
-    # degree would differ. This would allow us to preserve intentional choices
-    # in the chart when transposing.
-    scaleNames = case key
-    of C:
-      ["A♭", "A", "B♭", "B", "C", "D♭", "D", "E♭", "E", "F", "G♭", "G"]
-    of G:
-      ["A♭", "A", "B♭", "B", "C", "D♭", "D", "E♭", "E", "F", "F#", "G"]
-    of D:
-      ["A♭", "A", "B♭", "B", "C", "C#", "D", "E♭", "E", "F", "F#", "G"]
-    of A:
-      ["G#", "A", "B♭", "B", "C", "C#", "D", "E♭", "E", "F", "F#", "G"]
-    of E:
-      ["G#", "A", "B♭", "B", "C", "C#", "D", "D#", "E", "F", "F#", "G"]
-    of B:
-      ["G#", "A", "A#", "B", "C", "C#", "D", "D#", "E", "F", "F#", "G"]
-    of Gf:
-      ["A♭", "B𝄫", "B♭", "C♭", "D𝄫", "D♭", "E𝄫", "E♭", "F♭", "F", "G♭", "A𝄫"]
-    of Df:
-      ["A♭", "B𝄫", "B♭", "C♭", "C", "D♭", "E𝄫", "E♭", "F♭", "F", "G♭", "A𝄫"]
-    of Af:
-      ["A♭", "B𝄫", "B♭", "C♭", "C", "D♭", "E𝄫", "E♭", "F♭", "F", "G♭", "G"]
-    of Ef:
-      ["A♭", "B𝄫", "B♭", "C♭", "C", "D♭", "D", "E♭", "F♭", "F", "G♭", "G"]
-    of Bf:
-      ["A♭", "A", "B♭", "C♭", "C", "D♭", "D", "E♭", "F♭", "F", "G♭", "G"]
-    of F:
-      ["A♭", "A", "B♭", "C♭", "C", "D♭", "D", "E♭", "E", "F", "G♭", "G"]
-
-
-  elif useSharps.isSome and useSharps.get:
-    scaleNames = case key
-    of A, B, C, D, E, G:
-      ["G#", "A", "A#", "B", "C", "C#", "D", "D#", "E", "F", "F#", "G"]
-    of Af:
-      ["G#", "A", "A#", "B", "B#", "C#", "D", "D#", "E", "E#", "F#", "F𝄪"]
-    of Bf:
-      ["G#", "G𝄪", "A#", "B", "B#", "C#", "C𝄪", "D#", "E", "E#", "F#", "F𝄪"]
-    of Df:
-      ["G#", "A", "A#", "B", "B#", "C#", "D", "D#", "E", "E#", "F#", "G"]
-    of Ef:
-      ["G#", "A", "A#", "B", "B#", "C#", "C𝄪", "D#", "E", "E#", "F#", "F𝄪"]
-    of Gf:
-      ["G#", "A", "A#", "B", "C", "C#", "D", "D#", "E", "E#", "F#", "G"]
-    of F:
-      ["G#", "G𝄪", "A#", "B", "B#", "C#", "C𝄪", "D#", "D𝄪", "E#", "F#", "F𝄪"]
-
-  else: # !useSharps (useSharps.isSome and not useSharps.get)
-    scaleNames = case key
-    of C, Af, Bf, Df, Ef, F:
-      ["A♭", "A", "B♭", "B", "C", "D♭", "D", "E♭", "E", "F", "G♭", "G"]
-    of A:
-      ["A♭", "B𝄫", "B♭", "C♭", "C", "D♭", "E𝄫", "E♭", "F♭", "F", "G♭", "G"]
-    of B:
-      ["A♭", "A", "B♭", "C♭", "C", "D♭", "D", "E♭", "F♭", "F", "G♭", "G"]
-    of D:
-      ["A♭", "B𝄫", "B♭", "C♭", "C", "D♭", "E𝄫", "E♭", "F♭", "F", "G♭", "A𝄫"]
-    of E:
-      ["A♭", "B𝄫", "B♭", "C♭", "C", "D♭", "D", "E♭", "F♭", "F", "G♭", "G"]
-    of G:
-      ["A♭", "B𝄫", "B♭", "C♭", "D𝄫", "D♭", "E𝄫", "E♭", "F♭", "F", "G♭", "A𝄫"]
-    of Gf:
-      ["A♭", "A", "B♭", "C♭", "C", "D♭", "D", "E♭", "E", "F", "G♭", "G"]
-
-
-  return scaleNames[ord(pitch)]
-
-func `+`*(pitch: ChordChartPitch, steps: int): ChordChartPitch =
-  cast[ChordChartPitch]((ord(pitch) + steps) mod 12)
-
-func `-`*(a, b: ChordChartPitch): int =
-  result = ord(a) - ord(b)
-  if result < 0: result += 12
-
 func dump*(m: ChordChartMetadata, indent = ""): string =
   return indent & "Metadata\p" & join(m.pairs --> map(indent & "  " & it.key & ": " & it.value), "\p")
 
@@ -203,14 +111,14 @@ func dump*(ccn: ChordChartNode, indent = ""): string =
       let chord = ccn.chord.get
       result &= "["
       if chord.original.isSome and chord.flavor.isNone and
-         chord.bassPitch.isNone:
+         chord.bass.isNone:
         result &= chord.original.get
       else:
-        result &= $chord.rootPitch
+        result &= $chord.root
         if chord.flavor.isSome:
           result &= "_" & chord.flavor.get
-        if chord.bassPitch.isSome:
-          result &= "/" & $chord.bassPitch.get
+        if chord.bass.isSome:
+          result &= "/" & $chord.bass.get
       result &= "]"
 
     if ccn.word.isSome: result &= ccn.word.get
@@ -256,36 +164,7 @@ template addToCurSection(n: ChordChartNode): untyped =
   if ctx.curSection.kind == ccnkSection: ctx.curSection.sectionContents.add(n)
   else: result.add(n)
 
-proc parsePitch*(ctx: ParserContext, keyValue: string): ChordChartPitch =
-  let normK = keyValue.strip.toLower
-  case normK
-  of "gs", "gis", "g#", "ab", "a♭", "af", "aes": return ChordChartPitch.Af
-  of "g𝄪", "a", "a♮", "b𝄫": return ChordChartPitch.A
-  of "as", "ais", "a#", "bf", "bb", "b♭", "bes", "c𝄫": return ChordChartPitch.Bf
-  of "a𝄪", "b", "c♭", "cb", "ces", "cf": return ChordChartPitch.B
-  of "bs", "bis", "b#", "c", "d𝄫": return ChordChartPitch.C
-  of "b𝄪", "cs", "cis", "c#", "d♭", "df", "db", "des": return ChordChartPitch.Df
-  of "c𝄪", "d", "e𝄫": return ChordChartPitch.D
-  of "ds", "dis", "d#", "ef", "e♭", "eb", "ees", "f𝄫": return ChordChartPitch.Ef
-  of "d𝄪", "e", "f♭", "fes", "ff": return ChordChartPitch.E
-  of "es", "eis", "e#", "f", "g𝄫": return ChordChartPitch.F
-  of "e𝄪", "fs", "fis", "f#", "g♭", "gf", "gb", "ges": return ChordChartPitch.Gf
-  of "f𝄪", "g", "a𝄫": return ChordChartPitch.G
-  of "#7", "1", "𝄫2": return ctx.curKeyCenter
-  of "𝄪7", "#1", "b2", "♭2": return ctx.curKeyCenter + 1
-  of "𝄪1", "2", "𝄫3": return ctx.curKeyCenter + 2
-  of "#2", "b3", "♭3", "𝄫4": return ctx.curKeyCenter + 3
-  of "𝄪2", "3", "b4", "♭4": return ctx.curKeyCenter + 4
-  of "#3", "4", "𝄫5": return ctx.curKeyCenter + 5
-  of "𝄪3", "#4", "b5", "♭5": return ctx.curKeyCenter + 6
-  of "𝄪4", "5", "𝄫6": return ctx.curKeyCenter + 7
-  of "#5", "b6", "♭6": return ctx.curKeyCenter + 8
-  of "𝄪5", "6", "𝄫7": return ctx.curKeyCenter + 9
-  of "#6", "b7", "♭7", "𝄫1": return ctx.curKeyCenter + 10
-  of "7", "b1", "♭1": return ctx.curKeyCenter + 11
-  else: raise ctx.makeError(keyValue.strip & " is not a recognized key.")
-
-# see regexr.com/70nv1
+# see https://regexr.com/8f4ru
 let CHORD_REGEX =
   "([b#♭♮𝄫𝄪]?[A-G1-7][b#♭♮𝄫𝄪]?)" &               #      chord root
   "((min|maj|aug|dim|sus|6\\/9|[mM1-9#b♭♮𝄫𝄪Δ+oøoø°𝆩][0-9]?|\\([1-9#b♭]+\\))*)" &  # chord flavor/type
@@ -293,7 +172,8 @@ let CHORD_REGEX =
 let CHORD_PAT = re(CHORD_REGEX)
 
 proc parseChord*(
-    ctx: ParserContext, chordValue: string
+    ctx: ParserContext,
+    chordValue: string
   ): Option[ChordChartChord] =
 
   let m = chordValue.match(CHORD_PAT)
@@ -304,16 +184,16 @@ proc parseChord*(
         some(m.get.captures[1])
       else: none[string]()
 
-    let bassPitch =
+    let bass =
       if m.get.captures.contains(4) and m.get.captures[4].len > 0:
-        some(ctx.parsePitch(m.get.captures[4]))
-      else: none[ChordChartPitch]()
+        some(toScaleDegree(ctx.curKey, parseSpelledPitch(m.get.captures[4])))
+      else: none[ScaleDegree]()
 
     return some(ChordChartChord(
       original: some(chordValue),
-      rootPitch: ctx.parsePitch(m.get.captures[0]),
+      root: toScaleDegree(ctx.curKey, parseSpelledPitch(m.get.captures[0])),
       flavor: flavor,
-      bassPitch: bassPitch))
+      bass: bass))
 
 let METADATA_LINE_PAT = re"^([^:]+):(.*)$"
 let METADATA_END_PAT = re"^-+$"
@@ -321,7 +201,7 @@ proc parseMetadata(ctx: var ParserContext): ChordChartMetadata =
 
   var title = "MISSING"
   var optProps = newStringTable()
-  var songKey: Option[ChordChartChord]
+  var songKey: Option[Key]
 
   while ctx.curLineNum < ctx.lines.len:
     let line = ctx.nextLine
@@ -337,7 +217,12 @@ proc parseMetadata(ctx: var ParserContext): ChordChartMetadata =
     let value = m.get.captures[1].strip
     if key == "title": title = value
     elif key == "key":
-      songKey = ctx.parseChord(value)
+      let parts = value.split(" ", 1)
+      songKey = some(Key(
+        tonic: parseSpelledPitch(parts[0]),
+        mode:
+          if parts.len > 1: parseMode(parts[1])
+          else: Ionian))
       if songKey.isNone:
         raise ctx.makeError("unrecognized key: " & value)
     else: optProps[key] = value
@@ -499,14 +384,9 @@ proc parseBody(ctx: var ParserContext): seq[ChordChartNode] =
 
     m = line.match(REDEFINE_KEY_PAT)
     if m.isSome:
-      let newKeyInt = (
-          ord(ctx.curKeyCenter) +
-          parseInt(m.get.captures[0])
-        ) mod 12
-
       addToCurSection(ChordChartNode(
         kind: ccnkRedefineKey,
-        newKey: cast[ChordChartPitch](newKeyInt)))
+        newKey: ctx.curKey.transpose(parseInt(m.get.captures[0]))))
       continue
 
     m = line.match(COL_BREAK_PAT)
@@ -548,7 +428,7 @@ proc parseChordChart*(s: string): ChordChart =
     unparsedLineParts: @[])
 
   let metadata = parseMetadata(parserCtx)
-  parserCtx.curKeyCenter = metadata.key.rootPitch
+  parserCtx.curKey = metadata.key
 
   result = ChordChart(
     rawContent: s,
diff --git a/src/pco_chordspkg/cliconstants.nim b/src/pco_chordspkg/cliconstants.nim
index ae2cdb4..d56d722 100644
--- a/src/pco_chordspkg/cliconstants.nim
+++ b/src/pco_chordspkg/cliconstants.nim
@@ -1,4 +1,4 @@
-const PCO_CHORDS_VERSION* = "0.5.6"
+const PCO_CHORDS_VERSION* = "0.6.0"
 
 const USAGE* = """Usage:
   pco_chords [options]
diff --git a/src/pco_chordspkg/html.nim b/src/pco_chordspkg/html.nim
index 9a6e990..9062d84 100644
--- a/src/pco_chordspkg/html.nim
+++ b/src/pco_chordspkg/html.nim
@@ -1,13 +1,13 @@
 import std/[logging, options, os, strutils]
 import zero_functional
 
-import ./ast
+import ./[ast, notation]
 
 type
   FormatContext = ref object
     chart: ChordChart
-    currentKey: ChordChartPitch
-    sourceKey: ChordChartPitch
+    currentKey: Key
+    sourceKey: Key
     currentSection: ChordChartNode
     numberChart: bool
     transposeSteps: int
@@ -80,7 +80,7 @@ h3 .section-text {
   height: 1.2em;
 }
 
-.chord .flavor {
+.number-chart .chord .flavor {
   font-variant-position: super;
 }
 
@@ -175,7 +175,7 @@ h3 .section-text {
   height: 1.2em;
 }
 
-.chord .flavor {
+.number-chart .chord .flavor {
   font-variant-position: super;
 }
 
@@ -197,62 +197,23 @@ h3 .section-text {
 </style>
 """
 
-func scaleDegree(root: ChordChartPitch, p: ChordChartPitch): string =
-  let distance = p - root
-  case distance:
-  of 0: "1"
-  of 1: "♭2"
-  of 2: "2"
-  of 3: "♭3"
-  of 4: "3"
-  of 5: "4"
-  of 6: "♭5"
-  of 7: "5"
-  of 8: "♭6"
-  of 9: "6"
-  of 10: "♭7"
-  of 11: "7"
-  else: raise newException(Exception, "Impossible")
-
 func format(ctx: FormatContext, chord: ChordChartChord, useNumber = false): string =
   ##if not useNumber and chord.original.isSome: return chord.original.get
 
-  if useNumber:
-    result = "<span class=root>" &
-      ctx.currentKey.scaleDegree(chord.rootPitch) & "</span>"
+  result = "<span class=root>"
+  if useNumber: result &= $chord.root
+  else: result &= $ctx.currentKey.spellPitch(chord.root)
+  result &= "</span>"
 
-    if chord.flavor.isSome:
+  if chord.flavor.isSome:
       result &= "<span class=flavor>" & chord.flavor.get & "</span>"
 
-    if chord.bassPitch.isSome:
-      result &= "<span class=bass>/" &
-        ctx.currentKey.scaleDegree(chord.bassPitch.get) & "</span>"
+  if chord.bass.isSome:
+    result &= "<span class=bass>/"
+    if useNumber: result &= $chord.bass.get
+    else: result &= $ctx.currentKey.spellPitch(chord.bass.get)
+    result &= "</span>"
 
-  else:
-    result = "<span class=root>" &
-      renderPitchInKey(chord.rootPitch, ctx.currentKey) & "</span>"
-
-    if chord.flavor.isSome:
-      result &= "<span class=flavor>" & chord.flavor.get & "</span>"
-
-    if chord.bassPitch.isSome:
-      result &= "<span class=bass>/" &
-        renderPitchInKey(chord.bassPitch.get, ctx.currentKey) & "</span>"
-
-proc transpose(ctx: FormatContext, chord: ChordChartChord): ChordChartChord =
-  result = chord
-
-  let distance = ctx.currentKey - ctx.sourceKey
-  if distance != 0:
-    result = ChordChartChord(
-      original: none[string](),
-      rootPitch: chord.rootPitch + distance,
-      flavor:
-        if chord.flavor.isSome: some(chord.flavor.get)
-        else: none[string](),
-      bassPitch:
-        if chord.bassPitch.isSome: some(chord.bassPitch.get + distance)
-        else: none[ChordChartPitch]())
 
 func makeSongOrder(songOrder, indent: string): string =
   result = indent & "<section class=song-order>\p" &
@@ -298,7 +259,7 @@ proc toHtml(ctx: var FormatContext, node: ChordChartNode, indent: string): strin
 
     if node.chord.isSome:
       result &= "<span class=chord>" &
-        ctx.format(ctx.transpose(node.chord.get), ctx.numberChart) & "</span>"
+        ctx.format(node.chord.get, ctx.numberChart) & "</span>"
 
     result &= "<span class=lyric>"
     if node.word.isSome: result &= node.word.get
@@ -317,13 +278,13 @@ proc toHtml(ctx: var FormatContext, node: ChordChartNode, indent: string): strin
     result &= "</div><div class=page-contents>"
 
   of ccnkTransposeKey:
-    ctx.currentKey = ctx.currentKey + node.transposeSteps
+    ctx.currentKey = ctx.currentKey.transpose(node.transposeSteps)
     result &= indent & "<h4 class=note>Key Change: " & $ctx.currentKey & "</h4>"
 
   of ccnkRedefineKey:
     let oldKey = ctx.currentKey
-    ctx.sourceKey = node.newKey + ctx.transposeSteps
-    ctx.currentKey = ctx.sourceKey
+    ctx.sourceKey = node.newKey
+    ctx.currentKey = ctx.sourceKey.transpose(ctx.transposeSteps)
 
     if oldKey != ctx.currentKey:
       let headingVal = indent & "<h4 class=note>Key Change: " & $ctx.currentKey & "</h4>"
@@ -342,8 +303,8 @@ proc toHtml*(
 
   var ctx = FormatContext(
     chart: cc,
-    currentKey: cc.metadata.key.rootPitch + transpose,
-    sourceKey: cc.metadata.key.rootPitch,
+    currentKey: cc.metadata.key.transpose(transpose),
+    sourceKey: cc.metadata.key,
     currentSection: EMPTY_CHORD_CHART_NODE,
     numberChart: numberChart,
     transposeSteps: transpose)
@@ -368,17 +329,19 @@ proc toHtml*(
 
   result &= "  </head>\p"
 
+  var bodyClasses = newSeq[string]()
+  if numberChart: bodyClasses.add("number-chart")
   if cc.metadata.contains("columns") and cc.metadata["columns"] == "1":
-    result &= "  <body class='one-column'>"
-  else:
-    result &= "  <body class='two-column'>"
+    bodyClasses.add("one-column")
+  else: bodyClasses.add("two-column")
+  result &= "  <body class='" & bodyClasses.join(" ") & "'>"
 
   var indent = "      "
 
   # Title
   result &= indent & "<h1>" & cc.metadata.title & "</h1>\p"
 
-  var metadataPieces = @["Key: " & ctx.format(ctx.transpose(cc.metadata.key))]
+  var metadataPieces = @["Key: " & $ctx.currentKey]
   if cc.metadata.contains("time signature"):
     metadataPieces.add(cc.metadata["time signature"])
   if cc.metadata.contains("bpm"):
diff --git a/src/pco_chordspkg/notation b/src/pco_chordspkg/notation
new file mode 100755
index 0000000000000000000000000000000000000000..4236165f16ad44b870c4ba16e16920f788be1514
GIT binary patch
literal 156568
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%0Dcxh{Ret=M7ntk2SBV;!as4vS!bx
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%0DjPIM6<CpLThR;-L4hCgRjWGSkz<j6(`eI%tB()
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
ZK<1C@<!fYKx6#ku<gNN%g`jfk{15)DTqXbj

literal 0
HcmV?d00001

diff --git a/src/pco_chordspkg/notation.nim b/src/pco_chordspkg/notation.nim
new file mode 100644
index 0000000..597d933
--- /dev/null
+++ b/src/pco_chordspkg/notation.nim
@@ -0,0 +1,245 @@
+import std/[strutils, unicode]
+
+type
+  Note* {.pure.} = enum A, B, C, D, E, F, G
+  Pitch* = enum Af, A, Bf, B, C, Df, D, Ef, E, F, Gf, G
+
+  NoteAlteration* = enum
+    naDoubleFlat = -2, naFlat, naNatural, naSharp, naDoubleSharp
+
+  ScaleDegree* = object
+    number: int
+    alteration: NoteAlteration
+
+  SpelledPitch* = object
+    note: Note
+    alteration: NoteAlteration
+
+  Mode* = enum
+    Ionian = 0,
+    Dorian,
+    Phrygian,
+    Lydian,
+    Mixolydian,
+    Aeolian,
+    Locrian
+
+  Key* = object
+    tonic*: SpelledPitch
+    mode*: Mode
+
+const MajorIntervals = [0, 2, 4, 5, 7, 9, 11]
+
+
+func `+`*[T: Pitch or Note](val: T, steps: int): T =
+  cast[T]((ord(val) + steps) mod (ord(high(T)) + 1))
+
+
+func `-`*[T: Pitch or Note](val: T, steps: int): T =
+  var newOrd = (ord(val) - steps) mod (ord(high(T)) + 1)
+  if newOrd < 0: newOrd += 12
+  return cast[T](newOrd)
+
+
+func `-`*(a, b: Note): int =
+  result = ord(a) - ord(b)
+  if result < 0: result += 7
+
+
+func `-`*(a, b: Pitch): int =
+  result = ord(a) - ord(b)
+  if result < 0: result += 12
+
+
+func `$`*(pitch: Pitch): string =
+  ["A♭", "A", "B♭", "B", "C", "D♭", "D", "E♭", "E", "F", "G♭", "G"][ord(pitch)]
+
+
+func `$`*(sp: SpelledPitch): string =
+  case sp.alteration
+  of naDoubleFlat: return $sp.note & "𝄫"
+  of naFlat: return $sp.note & "♭"
+  of naNatural: return $sp.note
+  of naSharp: return $sp.note & "#"
+  of naDoubleSharp: return $sp.note & "𝄪"
+
+
+func `$`*(sd: ScaleDegree): string =
+  case sd.alteration
+  of naDoubleFlat: return "𝄫" & $sd.number
+  of naFlat: return "♭" & $sd.number
+  of naNatural: return $sd.number
+  of naSharp: return "#" & $sd.number
+  of naDoubleSharp: return "𝄪" & $sd.number
+
+
+func `$`*(k: Key): string =
+  result = $k.tonic
+  case k.mode
+  of Ionian: discard
+  of Dorian: result &= " Dorian"
+  of Phrygian: result &= " Phrygian"
+  of Lydian: result &= " Lydian"
+  of Mixolydian: result &= " Mixolydian"
+  of Aeolian: result &= " Minor"
+  of Locrian: result &= " Locrian"
+
+
+func chromaticDistanceFromTonic*(degree: ScaleDegree): int =
+  if degree.number < 1 or degree.number > 7:
+    raise newException(ValueError, "Invalid scale degree: " & $degree.number)
+
+  result = MajorIntervals[(degree.number - 1)] + ord(degree.alteration)
+
+
+func toPitch*(n: Note): Pitch =
+  cast[Pitch]((4 + MajorIntervals[(ord(n) + 5) mod 7]) mod 12)
+
+
+func toPitch*(sp: SpelledPitch): Pitch =
+  cast[Pitch]((ord(sp.note.toPitch) + ord(sp.alteration) + 12) mod 12)
+
+
+func toNote*(p: Pitch): Note =
+  case p
+  of Af, A: Note.A
+  of Bf, B: Note.B
+  of C: Note.C
+  of Df, D: Note.D
+  of Ef, E: Note.E
+  of F: Note.F
+  of Gf, G: Note.D
+
+
+func parseMode*(str: string): Mode =
+  case str.toLower.strip
+  of "ionian", "major", "": Ionian
+  of "dorian": Dorian
+  of "phrygian": Phrygian
+  of "lydian": Lydian
+  of "mixolydian": Mixolydian
+  of "aeolian", "minor": Aeolian
+  of "locrian": Locrian
+  else: raise newException(ValueError, "Unrecognized mode/scale: " & str)
+
+
+func parseSpelledPitch*(str: string): SpelledPitch =
+  try: result.note = parseEnum[Note]($str[0])
+  except:
+    raise newException(ValueError, str[0] & " is not a recognized pitch name.")
+
+  result.alteration =
+    case str[1..^1]
+    of "𝄫", "bb", "♭♭": naDoubleFlat
+    of "b", "♭", "f", "es": naFlat
+    of "", "♮": naNatural
+    of "s", "is", "#": naSharp
+    of "𝄪", "##": naDoubleSharp
+    else: raise newException(ValueError,
+      str[1..^1] & " is not a recognized accidental.")
+
+
+func parseScaleDegree*(str: string): ScaleDegree =
+  try: result.number = parseInt($str[0])
+  except:
+    raise newException(ValueError, str[0] & " is not a valid scale degree.")
+
+  result.alteration =
+    case str[0..^2]
+    of "𝄫", "bb", "♭♭": naDoubleFlat
+    of "b", "♭", "f", "es": naFlat
+    of "", "♮": naNatural
+    of "s", "is", "#": naSharp
+    of "𝄪", "##": naDoubleSharp
+    else: raise newException(ValueError,
+      str[0..^2] & " is not a recognized accidental.")
+
+
+func ionianPitch*(key: Key, degreeNumber: int): Pitch =
+  cast[Pitch]((ord(key.tonic.toPitch) + MajorIntervals[degreeNumber - 1]) mod 12)
+
+
+#[ TODO
+func spellPitch*(key: Key, p: Pitch): SpelledPitch =
+
+]#
+
+func toSpelledPitch*(p: Pitch): SpelledPitch =
+  SpelledPitch(
+    note: p.toNote,
+    alteration:
+      case p
+      of Af, Bf, Df, Ef, Gf: naFlat
+      else: naNatural)
+
+func spellPitch*(key: Key, sd: ScaleDegree): SpelledPitch =
+  result.note = key.tonic.note + (sd.number - 1)
+  let resultingPitch = ord(ionianPitch(key, sd.number)) + ord(sd.alteration)
+  result.alteration = cast[NoteAlteration](
+    resultingPitch - ord(result.note.toPitch))
+
+
+func toScaleDegree*(key: Key, sp: SpelledPitch): ScaleDegree =
+  result.number = sp.note - key.tonic.note + 1
+  result.alteration = cast[NoteAlteration](
+    ord(sp.toPitch) - ord(ionianPitch(key, result.number)))
+
+
+func transpose*(k: Key, steps: int): Key =
+  Key(
+    tonic: toSpelledPitch(k.tonic.toPitch + steps),
+    mode: k.mode)
+
+
+when isMainModule:
+  assert A + 1 == Bf
+  assert A + 12 == A
+  assert A - 1 == Af
+  assert A + 14 == B
+
+  assert C - A == 3
+  assert A - G == 2
+  assert G - A == 10
+
+  assert Note.D - Note.B == 2
+  assert Note.A - Note.C == 5
+  assert Note.C - Note.A == 2
+
+  assert chromaticDistanceFromTonic(ScaleDegree(number: 1, alteration: naNatural)) == 0
+  assert chromaticDistanceFromTonic(ScaleDegree(number: 5, alteration: naNatural)) == 7
+  assert chromaticDistanceFromTonic(ScaleDegree(number: 5, alteration: naDoubleFlat)) == 5
+  assert chromaticDistanceFromTonic(ScaleDegree(number: 7, alteration: naFlat)) == 10
+  assert chromaticDistanceFromTonic(ScaleDegree(number: 3, alteration: naDoubleSharp)) == 6
+
+  assert $SpelledPitch(note: Note.B, alteration: naFlat) == "B♭"
+
+  assert A == parseSpelledPitch("A").toPitch
+  assert B == parseSpelledPitch("B").toPitch
+  assert C == parseSpelledPitch("C").toPitch
+  assert D == parseSpelledPitch("D").toPitch
+  assert E == parseSpelledPitch("E").toPitch
+  assert F == parseSpelledPitch("F").toPitch
+  assert G == parseSpelledPitch("G").toPitch
+
+  assert Af == parseSpelledPitch("Ab").toPitch
+  assert G == parseSpelledPitch("Abb").toPitch
+  assert B == parseSpelledPitch("Cb").toPitch
+  assert Df == parseSpelledPitch("B##").toPitch
+
+  assert "3" == $toScaleDegree(
+    Key(tonic: parseSpelledPitch("B"), mode: Ionian),
+    parseSpelledPitch("D#"))
+
+  assert "1" == $toScaleDegree(
+    Key(tonic: parseSpelledPitch("Gb"), mode: Ionian),
+    parseSpelledPitch("Gb"))
+
+  assert parseSpelledPitch("Cb").toPitch == parseSpelledPitch("B").toPitch
+
+  assert "♭6" == $toScaleDegree(
+    Key(tonic: parseSpelledPitch("Eb"), mode: Ionian),
+    parseSpelledPitch("Cb"))
+
+  assert "#5" == $toScaleDegree(
+    Key(tonic: parseSpelledPitch("Eb"), mode: Ionian),
+    parseSpelledPitch("B"))