@difizen/mana-core/es/keyboard/keyboard-layout-service.d.ts

import type { Event } from '@difizen/mana-common';
import { Emitter } from '@difizen/mana-common';
import type { NativeKeyboardLayout } from './keyboard-protocol';
import { KeyboardLayoutProvider, KeyboardLayoutChangeNotifier, KeyValidator } from './keyboard-protocol';
import { KeyCode, Key } from './keys';
export type KeyboardLayout = {
    /**
     * Mapping of standard US keyboard keys to the actual key codes to use.
     * See `KeyboardLayoutService.getCharacterIndex` for the index computation.
     */
    readonly key2KeyCode: KeyCode[];
    /**
     * Mapping of KeyboardEvent codes to the characters shown on the user's keyboard
     * for the respective keys.
     */
    readonly code2Character: Record<string, string>;
};
export declare class KeyboardLayoutService {
    protected readonly layoutProvider: KeyboardLayoutProvider;
    protected readonly layoutChangeNotifier: KeyboardLayoutChangeNotifier;
    protected readonly keyValidator?: KeyValidator | undefined;
    constructor(layoutProvider: KeyboardLayoutProvider, layoutChangeNotifier: KeyboardLayoutChangeNotifier, keyValidator?: KeyValidator);
    private currentLayout?;
    protected updateLayout(newLayout: NativeKeyboardLayout): KeyboardLayout;
    protected keyboardLayoutChanged: Emitter<KeyboardLayout>;
    get onKeyboardLayoutChanged(): Event<KeyboardLayout>;
    initialize(): Promise<void>;
    /**
     * Resolve a KeyCode of a keybinding using the current keyboard layout.
     * If no keyboard layout has been detected or the layout does not contain the
     * key used in the KeyCode, the KeyCode is returned unchanged.
     */
    resolveKeyCode(inCode: KeyCode): KeyCode;
    /**
     * Return the character shown on the user's keyboard for the given key.
     * Use this to determine UI representations of keybindings.
     */
    getKeyboardCharacter(key: Key): string;
    /**
     * Called when a KeyboardEvent is processed by the KeybindingRegistry.
     * The KeyValidator may trigger a keyboard layout change.
     */
    validateKeyCode(keyCode: KeyCode): void;
    protected transformKeyCode(inCode: KeyCode, mappedCode: KeyCode, keyNeedsShift: boolean): KeyCode | undefined;
    protected transformNativeLayout(nativeLayout: NativeKeyboardLayout): KeyboardLayout;
    protected shouldIncludeKey(code: string): boolean;
    private addKeyMapping;
    private addWindowsKeyMapping;
    protected getCharacterIndex(key: Key, shift?: boolean): number;
}
//# sourceMappingURL=keyboard-layout-service.d.ts.map