Bndr /ˈbaɪndɚ/ is a library designed to compose events from various user inputs and chain filters in a monadic manner, integrating them into a single event object. It accommodates input devices such as mice🖱️, styluses🖊️, touch inputs👆, keyboards⌨️, MIDI controllers🎹, and gamepads🎮. Developed and maintained by Baku Hashimoto.

Potential use cases for this library include:

- ⚡️ Associating user inputs with arbitrary triggers for VJing
- 🎨 Introducing manual operations in generative art.

To get a feel for how it works, please try out this demo.

Supported Parameters

- 👆 Pointer (mouse, stylus, touch)
- All parameters supported in PointerEvent. (pressure, tilt, multi-touch)
- ⌨️ Keyboard
- 🎹 MIDI
- CC and velocity
- 🎮 Gamepad
- Vendor-specific button name support: JoyCon, PS5 Controller

How to use

- Full API documentation

$3

``
npm install bndr-js
`

$3

`js
import {Bndr} from 'bndr-js'

Bndr.pointer().on(pressed =>
console.log('Pointer %s', pressed ? 'pressed' : 'released')
)

Bndr.pointer()
.position()
.lerp(vec2.lerp, 0.1)
.on(([x, y]) => console.log('Pointer moved: [%f, %f]', x, y))

Bndr.keyboard()
.hotkey('shift+c')
.on(() => console.log('Hotkey shift+c pressed'))

Bndr.keyboard()
.key('a')
.on(pressed => console.log(Key 'a' ${pressed ? 'pressed' : 'released'}))

Bndr.midi()
.note(0, 50)
.on(velocity => console.log('MIDI slider #50 moved: %d', velocity))

Bndr.gamepad()
.axis(0)
.on(([x, y]) => console.log('Gamepad axis #0 tilted: [%f, %f]', x, y))
``

License

This repository is published under an MIT License. See the included LICENSE file.