Plugin: Key Handler

KeyHandlerPlugin (id 'key-handler', the same id as the kit base and the music player’s subclass) is nomercy-video-player’s desktop keyboard-binding set, a subclass of the kit’s KeyHandlerPlugin (scope resolution, cooldown, input-field awareness, bind/unbind/replace) that adds every video-specific binding as its own small, individually-overridable group method. TvKeyHandlerPlugin subclasses this one for remote-control input; Recipe: Customizing Keyboard Shortcuts covers extending or replacing bindings on either.

Options

Same KeyHandlerOptions the kit plugin accepts, scope, bindings, extend, when, cooldownMs, disableMediaControls, see Plugin: Key Handler (core) for the full table. This subclass adds no new option fields, only more default groups.

Default bindings

Rules & restrictions

• Every group above is its own protected method (addPlaybackKeys, addVolumeKeys, addFullscreenKeys, and so on), called from addDefaults(). Overriding one group in a subclass leaves the rest untouched.
• disableControls on VideoPlayerConfig short-circuits addDefaults() entirely, no group runs, only bindings your own use() override adds exist.
• disableMediaControls (also on VideoPlayerConfig) only gates the hardware MediaX bindings and the MediaTrackNext/Previous pair, it does not touch Space, arrows, or any letter-key binding.
• shift+? is bound as 'shift+?', not '?', because on standard keyboards pressing ? sends key='?' with shiftKey=true; the kit’s combo canonicalizer folds modifier state into the key string, so binding the literal '?' would never match the real event.

How to extend it

import nmplayer from '@nomercy-entertainment/nomercy-video-player';
import { KeyHandlerPlugin } from '@nomercy-entertainment/nomercy-video-player';

const player = nmplayer('player');

class MyKeyHandler extends KeyHandlerPlugin {
  protected override addFullscreenKeys(): void {
    this.bind('f', () => { void this.player.toggleFullscreen(); });
    // F11 and Escape from the default binding intentionally dropped.
  }
}

player.addPlugin(MyKeyHandler);

See Recipe: Customizing Keyboard Shortcuts for the full range of options, from one runtime bind() call up to overriding addDefaults() entirely.

Next steps

• Plugin: TV Key Handler: the remote-control subclass built on this one.