Layout Editor ZMK

Propósito e intención del usuario: Esta herramienta resuelve el diseño, validación y exportación de layouts de teclado para el firmware ZMK. Se dirige a ingenieros de firmware, diseñadores de hardware y constructores de teclados que planifican el cableado de la matriz y mappings por capa. Los usuarios proporcionan board_rows, board_cols, layers y restricciones de footprint, luego ubican teclas en una cuadrícula y asignan keycodes por capa. La herramienta garantiza factibilidad antes del prototipado y genera exports listos para la integración en el proceso de construcción. Soporta planificación multicapas y genera salidas revisables.
Lógica central y funciones: El núcleo es un motor de diseño basado en cuadrícula con definiciones de malla, colocación de teclas en múltiples capas y validación de mappings. Las funciones opcionales incluyen integración con biblioteca de footprint, sugerencias automáticas de colocación y importación/exportación masiva de configuraciones. Las reglas exigen una única asignación por celda por capa, validan límites, detectan conflictos entre capas y reportan colocaciones no realizables. Genera mapas por capa y una configuración consolidada compatible con flujos YAML/JSON de ZMK.
Entradas y salidas: Las entradas incluyen board_rows (int), board_cols (int), layers (int), footprint (string). Las salidas incluyen mapas por capa, una configuración consolidada y informes de validación que resaltan conflictos, huecos y problemas de borde. Exportaciones cumplen con las convenciones ZMK y están listas para integración de firmware.
Algoritmos y cálculos: Mapea coordenadas de la cuadrícula a filas/columnas de la matriz, calcula índices por capa y formatea datos en representaciones compatibles con ZMK. Utiliza lógica de matriz de teclado estándar y soporta diseños no uniformes mediante marcadores de posición.
Errores y casos límite: Reporta entradas inválidas, entradas faltantes, duplicados, posiciones fuera de rango y falta de biblioteca footprint con mensajes accionables. Comportamiento de fallo rápido guía a los pasos correctivos.
Industria/Localización: Cumple con convenciones de teclado ANSI US por defecto; mapeos de capa específicos de localización y documentación para diseños regionales. Unidades son celdas de la cuadrícula; sin suposiciones de hardware locales más allá de estándares de keycode.
Supuestos y exclusiones: Supone acceso a una biblioteca de footprints válida y salidas compatibles con firmware; excluye UI, pruebas de hardware o destinaciones de firmware no-ZMK. No cubre tolerancias de manufactura ni diseños de teclados que no sigan la cuadrícula.