TanStack Hotkeys transforma teclado em sistema de comandos

O que é TanStack Hotkeys

TanStack Hotkeys é uma biblioteca em fase alpha do ecossistema TanStack que transforma entrada de teclado em um sistema de comandos tipado. A proposta vai além de um simples listener de keydown: oferece escopos, sequências, teclas mantidas pressionadas, gravação de atalhos, detecção de conflitos e exibição consciente da plataforma.

Escopos de comando

A biblioteca parte do princípio de que a mesma tecla pode ter significados diferentes conforme o contexto. Um atalho pode funcionar globalmente, ter outro comportamento dentro de um editor e ser bloqueado enquanto o usuário digita em um campo de texto. Os escopos tornam esse contexto explícito, com três níveis ilustrados na documentação: global (comandos de ajuda, navegação e ações gerais do aplicativo), workspace (comandos válidos apenas dentro de um projeto específico) e modal (escopo temporário com prioridade máxima enquanto um diálogo está aberto).

Gramática de gestos

Além dos acordes tradicionais (múltiplas teclas pressionadas simultaneamente para um comando), a biblioteca suporta sequências ordenadas ao estilo Vim (como pressionar G e depois D para formar uma linguagem de comandos), ações de pressionar e manter (onde a duração do pressionamento faz parte do gesto) e teclas que permanecem ativas enquanto o ponteiro se move.

Bindings personalizados

A biblioteca trata atalhos como dados do usuário. O fluxo proposto é: gravar um gesto bruto a partir de um evento de teclado, normalizá-lo em uma definição portável (por exemplo, Mod+Shift+P), formatá-lo para exibição na plataforma atual (⌘⇧P no macOS) e publicá-lo em menus e folhas de referência. Conflitos, teclas reservadas do navegador e filtragem de entrada ficam visíveis em vez de se tornarem comportamentos misteriosos.

Números e status

A página registra 7,3 milhões de downloads totais, 574.682 downloads semanais e 674 estrelas no GitHub. A biblioteca está em versão alpha, com suporte apenas para React. O projeto é mantido com apoio de parceiros e patrocinadores.