feat(ui-kit): add NgDocHotkeyDirective for binding shortcuts

libs/ui-kit/directives/hotkey/hotkey.directive.ts

@@ -0,0 +1,48 @@
+import {DOCUMENT} from '@angular/common';
+import {Directive, EventEmitter, Inject, Input, NgZone, Output} from '@angular/core';
+import {isKeyboardEvent, objectKeys} from '@ng-doc/core';
+import {ngDocZoneOptimize} from '@ng-doc/ui-kit/observables';
+import {UntilDestroy, untilDestroyed} from '@ngneat/until-destroy';
+import {Document} from 'postcss';
+import {fromEvent, Observable} from 'rxjs';
+import {filter, share} from 'rxjs/operators';
+
+const KEYUP_EVENT: Observable<Event> = fromEvent(document, 'keyup').pipe(share());
+
+@Directive({
+	selector: '[ngDocHotkey]',
+})
+@UntilDestroy()
+export class NgDocHotkeyDirective {
+	@Input('ngDocHotkey')
+	hotkey?: Partial<KeyboardEvent>;
+
+	@Output('ngDocHotkey')
+	callback: EventEmitter<void> = new EventEmitter<void>();
+
+	constructor(
+		@Inject(DOCUMENT)
+		private readonly document: Document,
+		private readonly ngZone: NgZone,
+	) {
+		KEYUP_EVENT.pipe(
+			filter(isKeyboardEvent),
+			filter((event: KeyboardEvent) =>
+				objectKeys(this.hotkey ?? {}).every(
+					(key: keyof KeyboardEvent) => this.hotkey && this.hotkey[key] === event[key],
+				),
+			),
+			filter((event: KeyboardEvent) => {
+				if (event.target instanceof HTMLElement) {
+					return !['input', 'textarea', 'select'].includes(event.target.tagName.toLowerCase());
+				}
+				return true;
+			}),
+			ngDocZoneOptimize(this.ngZone),
+			untilDestroyed(this),
+		).subscribe((event: KeyboardEvent) => {
+			event.preventDefault();
+			this.callback.emit();
+		});
+	}
+}

libs/ui-kit/directives/hotkey/hotkey.module.ts

@@ -0,0 +1,9 @@
+import {NgModule} from '@angular/core';
+
+import {NgDocHotkeyDirective} from './hotkey.directive';
+
+@NgModule({
+	declarations: [NgDocHotkeyDirective],
+	exports: [NgDocHotkeyDirective],
+})
+export class NgDocHotkeyModule {}

libs/ui-kit/directives/hotkey/index.ts

@@ -0,0 +1,2 @@
+export * from './hotkey.directive';
+export * from './hotkey.module';

libs/ui-kit/directives/hotkey/ng-package.json

@@ -0,0 +1,5 @@
+{
+	"lib": {
+		"entryFile": "index.ts"
+	}
+}

libs/ui-kit/directives/index.ts

@@ -6,6 +6,7 @@ export * from '@ng-doc/ui-kit/directives/dropdown-origin';
 export * from '@ng-doc/ui-kit/directives/event-switcher';
 export * from '@ng-doc/ui-kit/directives/focus-catcher';
 export * from '@ng-doc/ui-kit/directives/focusable';
+export * from '@ng-doc/ui-kit/directives/hotkey';
 export * from '@ng-doc/ui-kit/directives/input-number';
 export * from '@ng-doc/ui-kit/directives/input-string';
 export * from '@ng-doc/ui-kit/directives/let';