feat: pass context to onNote() events

closes #14

README.md

@@ -201,6 +201,27 @@ myController = midi.input(3).channel(15)
 myController.onNote('c1', () => {
   osc().out()
 })
+
+// or listen to all notes:
+myController.onNote('*', ({ note, velocity, channel }) => {
+  osc().out()
+})
+```
+
+Or listen to any note:
+
+```js
+myController = midi.input(3).channel('*')
+
+scene1 = () => solid(1,0,0).out()
+scene2 = () => solid(0,1,0).out()
+
+myController.onNote('*', ({ note, velocity, channel }) => {
+  switch (note) {
+    case 36: { scene1(); break; }
+    case 37: { scene2(); break; }
+  }
+})
 ```
 
 ### Transforms

src/hydra-api/onNote.ts

@@ -1,12 +1,12 @@
 import state from '../state'
-import { ChannelArg, InputArg, NoteArg } from '../types'
+import { ChannelArg, InputArg, NoteArg, NoteEventContext } from '../types'
 import { getNoteId } from './note'
 
 export const onNote = (
   note: NoteArg,
   channel: ChannelArg,
   input: InputArg,
-  event: Function
+  event: (context: NoteEventContext) => void
 ) => {
   const noteId = getNoteId(note, channel, input)
   state.noteOnEvents.set(noteId, event)

src/midiAccess.ts

@@ -79,12 +79,12 @@ midiAccess.on(MidiAccess.TypeNoteOn, ({ data, channel, input }) => {
   const noteId = getMidiId(note, channel, input.id)
   playingNotes.set(noteId, velocity)
   envelopes.get(noteId)?.trigger()
-  noteOnEvents.get(noteId)?.()
+  noteOnEvents.get(noteId)?.({ note, velocity, channel })
 
   getMidiWildcards(note, channel, input.id).forEach(wildcard => {
     playingNotes.set(wildcard, velocity)
     envelopes.get(wildcard)?.trigger()
-    noteOnEvents.get(wildcard)?.()
+    noteOnEvents.get(wildcard)?.({ note, velocity, channel })
   })
 
   logMidiMessage({ input, type: 'on', channel, data })

src/state.ts

@@ -1,4 +1,4 @@
-import type { CCValues, Defaults } from './types'
+import type { CCValues, Defaults, NoteEventContext } from './types'
 
 const ccValues: CCValues = new Map(
   JSON.parse(sessionStorage.getItem('hydra-midi_ccValues') || '[]')
@@ -17,7 +17,7 @@ export default {
 
   playingNotes: new Map<string, number>(),
 
-  noteOnEvents: new Map<string, Function>(),
+  noteOnEvents: new Map<string, (context: NoteEventContext) => void>(),
 
   defaults: {
     channel: '*',

src/transforms/channel.ts

@@ -1,7 +1,7 @@
 import { cc } from '../hydra-api/cc'
 import { note } from '../hydra-api/note'
 import { onNote } from '../hydra-api/onNote'
-import { ChannelArg, InputArg, NoteArg } from '../types'
+import { ChannelArg, InputArg, NoteArg, NoteEventContext } from '../types'
 
 /**
  * Channel is chainable to `midi` and `input()` and provides a channel for all
@@ -16,6 +16,6 @@ export const channel = (channel: ChannelArg, input?: InputArg) => ({
   cc: (_index?: number, _channel?: ChannelArg, _input?: InputArg) =>
     cc(_index, _channel ?? channel, _input ?? input),
 
-  onNote: (_note: NoteArg, _event: Function) =>
+  onNote: (_note: NoteArg, _event: (context: NoteEventContext) => void) =>
     onNote(_note, channel, input ?? '*', _event),
 })

src/transforms/input.ts

@@ -1,5 +1,5 @@
 import { cc, note, onNote } from '../hydra-api'
-import { ChannelArg, InputArg, NoteArg } from '../types'
+import { ChannelArg, InputArg, NoteArg, NoteEventContext } from '../types'
 import { channel } from './channel'
 
 /**
@@ -15,7 +15,7 @@ export const input = (input: InputArg) => ({
   cc: (_index: number, _channel: ChannelArg, _input?: InputArg) =>
     cc(_index, _channel, _input ?? input),
 
-  onNote: (_note: NoteArg, _event: Function) =>
+  onNote: (_note: NoteArg, _event: (context: NoteEventContext) => void) =>
     onNote(_note, '*', input, _event),
 
   channel: (_channel: ChannelArg) => channel(_channel, input),

src/types.ts

@@ -23,6 +23,12 @@ export interface HydraContext {
   }
 }
 
+export interface NoteEventContext {
+  note: number
+  velocity: number
+  channel: number
+}
+
 export interface Defaults {
   input: InputArg
   channel: ChannelArg