README and bumped version

This commit is contained in:
Ben
2025-08-17 16:27:02 +02:00
parent f3902d671f
commit 093a812b01
2 changed files with 34 additions and 1 deletions

33
README.md Normal file
View File

@@ -0,0 +1,33 @@
# hyperf-keybinds
Quickly handle keyboard shortcuts and sequences in your app.
## Install
```bash
npm install hyperf-keybinds
```
## Quick Start
```ts
import { createKeyHandler, KeybindEventTypes, ModifierKey } from 'hyperf-keybinds';
// Define a command
const commands = [
{ command: [{ key: 'KeyS', modifiers: [ModifierKey.Control] }], callback: () => console.log('Ctrl+S!') },
{ command: [{ key: 'KeyA', modifiers: []}, { key: 'KeyS', modifiers: []}], callback: () => console.log('a - s!')}
];
// Create handler and emitter
const { handler, emitter } = createKeyHandler(commands);
// Attach to window
window.addEventListener('keydown', handler);
// Listen to events
emitter.on(e => console.log(e.type));
```
Now Ctrl+S triggers your callback and emits events.
Pressing a then s triggers a separate callback.

View File

@@ -1,6 +1,6 @@
{
"name": "hyperf-keybinds",
"version": "0.1.0",
"version": "0.1.1",
"description": "",
"main": "dist/index.js",