Layout Editor ZMK

Propósito e intenção do usuário: Esta ferramenta resolve o problema de projetar, validar e exportar layouts de teclado para o firmware ZMK. Destina-se a engenheiros de firmware, designers de hardware e fabricantes de teclados que planejam a montagem da matriz e mapping por camada. Os usuários fornecem board_rows, board_cols, layers e restrições de footprint, posicionam teclas em uma grade e atribuem keycodes por camada. A ferramenta garante viabilidade antes da prototipagem e gera exportações prontas para integração no processo de build. Suporta planejamento multi-camadas e fornece saídas revisáveis._br_Lógica central e recursos: O núcleo é um motor de layout baseado em grade com definição de grade, posicionamento de teclas por camada e validação de mapping. Funcionalidades opcionais incluem integração com biblioteca de footprint, sugestões automáticas de posicionamento e importação/exportação em massa de configurações. Regras exigem um mapeamento único por célula por camada, validam limites, detectam conflitos entre camadas e relatam colocaçõess não viáveis. Gera mapas por camada e uma configuração consolidada compatível com fluxos YAML/JSON do ZMK._br_Entradas e Saídas: Entradas incluem board_rows (int), board_cols (int), layers (int), footprint (string). Saídas incluem mapeamentos por camada, configuração consolidada e relatórios de validação que destacam conflitos, lacunas e problemas de fronteira. Exportações seguem as convenções ZMK e estão prontas para integração de firmware._br_Algoritmos e Cálculos: mapeia coordenadas de grade para linhas/colunas da matriz, calcula índices por camada e formata dados em representações compatíveis com ZMK. Usa lógica padrão de matriz de teclado e suporta layouts não uniformes através de placeholders._br_Erros e Casos Limite: Reporta entradas inválidas, entradas ausentes, duplicatas, posições fora de faixa e indisponibilidade da biblioteca footprint com mensagens acionáveis. Comportamento com falha rápida guia para etapas corretivas._br_Indústria/Localização: Conformidade com convenções de teclado ANSI US por padrão; mapeamentos de camada específicos de localização e documentação para layouts regionais. Unidades são células de grade; nenhuma suposição de hardware local além dos padrões de keycode._br_Suposições & Exclusões: Assume acesso a uma biblioteca de footprints válida e saídas compatíveis com firmware; exclui UI, testes de hardware ou alvos de firmware não-ZMK. Não cobre tolerâncias de fabricação ou designs de teclados não baseados em grade.