Layout Editor ZMK

Syfte och användaravsikt: Detta verktyg löser problemet med att designa, validera och exportera tangentbordslayouter för ZMK-firmware. Det riktar sig till firmwareingenjörer, hårdvarudesigners och tangentbordstillverkare som planerar matrisens cabling och per-lager mappingar. Användarna tillhandahåller board_rows, board_cols, layers och footprint-begränsningar, placerar tangenter på ett rutnät och tilldelar keycodes per lager. Verktyget säkerställer genomförbarhet före prototypning och genererar firmware-klara exporter som direkt kan integreras i byggprocessen. Stöd för flera lager och revisionvänliga utdata.
Huvudlogik & funktioner: Kernan är en rutnätsbaserad layouthämtare med krav: rutndefinition, multi-layer tangentplacering och validering av mappingar. Valfria funktioner inkluderar footprint-biblioteksintegration, automatiska placeringsförslag och massimport/-export av konfigurationer. Regler kräver en enda mappning per cell per lager, verifierar gränser, upptäcker kors-lager-konflikter och meddelar oförverkliga placeringar. Genererar per-lager kartor och en samlad konfiguration som passar ZMK YAML- och JSON-flöden.
Indata & utdata: Indata innefattar board_rows (int), board_cols (int), layers (int), footprint (string). Utdata innefattar per-lager keymaps, en sammanställd konfiguration och valideringsrapporter som lyfter fram konflikter, luckor och kantproblem. Exporter följer ZMK-konventioner och är klara för firmwareintegration.
Algoritmer & Beräkningar: Kartlägger rutnätskoordinater till matristrader/ kolumner, beräknar per-lagers index och formaterar data till ZMK-kompatibla representationer. Använder standard tangent-matrislogik och stöder icke-uniforma layouter via platshållare.
Fel & Kantfall: Rapportera ogiltiga indataområden, saknade inputs, dubbletter, positionsfel utanför gränsen och otillgängliga footprint-bibliotek med handlingsbara meddelanden. Snabbfel-beteende leder användaren till korrigerande åtgärder.
Bransch/Region & Lokalisering: Standard ANSI US-layout som utgångspunkt; lokala lager-mappningar och dokumentation för regionala layouter. Enheterna är rutnätsceller; inga lokala hårdvaruantaganden utöver keycode-standards.
Antaganden & Exclusions: Antyder tillgång till ett giltigt footprint-bibliotek och firmware-kompatibla utdata; utesluter UI-specifika detaljer, maskinvarutestning eller icke-ZMK-firmwaremål. Exkluderar tillverknings-toleranser eller icke-grid tangentbord.