update docs with new JS Pitch and Map functions

Author: hex-mt

src/content/docs/js/map.mdx

@@ -173,6 +173,7 @@ constructor(
     fifth: number,
     referencePitch?: string,
     referenceFreq?: number
+    midiMap?: Map1D;
 );
 ```
 
@@ -241,11 +242,29 @@ T.toCents(m); // 400
 toRatio(m: Interval): number;
 ```
 
-returns the ratio of the passed `Interval` as a decimal number.
+Returns the ratio of the passed `Interval` as a decimal number.
 
 ```ts
 const T = TuningMap.fromEDO(31);
 
 let m = Interval.fromName("A6");
 T.toRatio(m); // 1.7489046221194973
 ```
+
+### `toMIDI`
+
+```ts
+toMIDI(p: Pitch): number;
+```
+
+Returns an ordered pitch numbering for the passed `Pitch` as an integer. Available in any EDO `TuningMap` created via `TuningMap.fromEDO`. For 12TET, this will be the ordinary MIDI value for a given `Pitch`, but for other EDO tunings it provides an ordered MIDI-equvalent mapping.
+
+```ts
+const T1 = TuningMap.fromEDO(12);
+const T2 = TuningMap.fromEDO(31);
+
+let p = SPN.toPitch("C4");
+
+T1.toMIDI(p); // 60
+T2.toMIDI(p); // 155
+```

src/content/docs/js/pitch.mdx

@@ -172,6 +172,22 @@ let p = SPN.toPitch("F4");
 p.octave; // 4
 ```
 
+### `intervalTo`
+
+```ts
+intervalTo(p: Pitch): Interval;
+```
+
+Returns the [`Interval`](/js/interval) from the current Pitch to another passed-in vector. Often a more convenient way to access [`Interval.between`](/js/interval/#intervalbetween)
+
+```ts
+let p = SPN.toPitch("C4");
+let q = SPN.toPitch("E4");
+
+let m = p.intervalTo(q); // m now holds a major third Interval
+let n = Interval.between(p, q); // equivalent
+```
+
 ### `stepsTo`
 
 ```ts
@@ -278,26 +294,53 @@ p = SPN.toPitch("Bbb4")
 p.alterationIn(context); // -2, Bbb is too flat for this context
 ```
 
-## Transformations
+### `highest`
 
-The following methods produce a new vector from the current `Pitch`. None of them mutate the original object.
+```ts
+highest(arr: Pitch[], T?: TuningMap): Pitch;
+```
 
-### `intervalTo`
+Returns the highest `Pitch` in a passed-in array. Uses an optional `TuningMap` to determine which `Pitch` is higher than the others; if no `TuningMap` is passed in, defaults to 12TET.
 
 ```ts
-intervalTo(p: Pitch): Interval;
+const pitchArray = ["C4", "F#4", "D4", "Bb4", "A#4", "G4"].map(p => SPN.toPitch(p));
+
+const highest = Pitch.highest(pitchArray); // highest holds Bb4
 ```
 
-Returns the [`Interval`](/js/interval) from the current Pitch to another passed-in vector. Often a more convenient way to access [`Interval.between`](/js/interval/#intervalbetween)
+### `lowest`
 
 ```ts
-let p = SPN.toPitch("C4");
-let q = SPN.toPitch("E4");
+lowest(arr: Pitch[], T?: TuningMap): Pitch;
+```
 
-let m = p.intervalTo(q); // m now holds a major third Interval
-let n = Interval.between(p, q); // equivalent
+Returns the lowest `Pitch` in a passed-in array. Uses an optional `TuningMap` to determine which `Pitch` is lower than the others; if no `TuningMap` is passed in, defaults to 12TET.
+
+```ts
+const pitchArray = ["C4", "F#4", "D4", "Bb4", "A#4", "G4"].map(p => SPN.toPitch(p));
+
+const lowest = Pitch.lowest(pitchArray); // lowest holds C4
 ```
 
+### `nearest`
+
+```ts
+nearest(arr: Pitch[], T?: TuningMap): Pitch;
+```
+
+Returns the nearest `Pitch` in a passed-in array to the calling `Pitch` instance. Uses an optional `TuningMap` to determine which `Pitch` is lower than the others; if no `TuningMap` is passed in, defaults to 12TET.
+
+```ts
+const pitchArray = ["C4", "F#4", "D4", "Bb4", "A#4", "G4"].map(p => SPN.toPitch(p));
+let p = SPN.toPitch("Eb4");
+
+const nearest = p.nearest(pitchArray); // nearest holds D4
+```
+
+## Transformations
+
+The following methods produce a new `Pitch` from the current `Pitch`. None of them mutate the original object.
+
 ### `transposeReal`
 
 ```ts