@opentui/core/lib/keybinding.internal.d.ts

OpenTUI is a TypeScript library on a native Zig core for building terminal user interfaces (TUIs)

export interface KeyBindingLike {
    name: string;
    ctrl?: boolean;
    shift?: boolean;
    meta?: boolean;
    super?: boolean;
}
export interface KeyBinding<Action extends string = string> extends KeyBindingLike {
    action: Action;
}
export interface KeyBindingLookup extends KeyBindingLike {
    baseCode?: number;
}
export type KeyAliasMap = Record<string, string>;
export declare const defaultKeyAliases: KeyAliasMap;
export declare function mergeKeyAliases(defaults: KeyAliasMap, custom: KeyAliasMap): KeyAliasMap;
export declare function mergeKeyBindings<Action extends string>(defaults: KeyBinding<Action>[], custom: KeyBinding<Action>[]): KeyBinding<Action>[];
export declare function getKeyBindingKey(binding: KeyBindingLike): string;
export declare function getKeyBindingKeys(binding: KeyBindingLookup): string[];
export declare function getKeyBindingAction<Action extends string>(map: Map<string, Action>, binding: KeyBindingLookup): Action | undefined;
export declare function matchesKeyBinding(binding: KeyBindingLookup, match: KeyBindingLike): boolean;
export declare function buildKeyBindingsMap<Action extends string>(bindings: KeyBinding<Action>[], aliasMap?: KeyAliasMap): Map<string, Action>;
/**
 * Converts a key binding to a human-readable string representation
 * @param binding The key binding to stringify
 * @returns A string like "ctrl+shift+y" or just "escape"
 * @example
 * keyBindingToString({ name: "y", ctrl: true, shift: true }) // "ctrl+shift+y"
 * keyBindingToString({ name: "escape" }) // "escape"
 * keyBindingToString({ name: "c", ctrl: true }) // "ctrl+c"
 * keyBindingToString({ name: "s", super: true }) // "super+s"
 */
export declare function keyBindingToString<Action extends string>(binding: KeyBinding<Action>): string;