Layout Editor ZMK

מטרת הכלי: פתרון לבעיית תכנון, אימות וייצוא תצורות מקלדת עבור firmware ZMK. הכלי מכוון למהנדסי firmware, מעצבי חומרה ובוני מקלדות שמתכננים את חיווט המטריצה ואת המיפוי לפי שכבות. המשתמשים מזינים board_rows, board_cols, layers והגבלות footprint, ממקמים מקשים על רשת ומקצים keycodes לכל שכבה. הכלי יוודא את האפשרות לפני prototyping ויצור ייצוא המוכן לשילוב בתהליך הבנייה. תומך בתכנון מרבי שכבות ומספק פלטים נוחים revision.
הליבה והמאפיינים: המנוע הוא מערכת תכנון מבוססת רשת עם הגדרות רשת, מיקום מקשים רב-שכבתי ואימות מיפוי. תכונות אופציונליות כוללות אינטגרציה עם ספריית footprint, הצעות מיתוג אוטומטיות וייבוא/ייצוא כמותי של תצורות. כללים מחייבים מיפוי יחיד לכל תא לכל שכבה, מאמתים גבולות, מזהים סכסוך בין שכבות ומציינים מיקומים לא מעשיים. ייצור מפה לכל שכבה ותצורה משולבת התואמת לזרימות ZMK YAML/JSON.
כניסות ויציאות: הכניסות כוללות board_rows (int), board_cols (int), layers (int), footprint (string). היציאות כוללות מפות לכל שכבה, תצורה מאוחדת ודוחות אימות המדגישים סכסוכים, חוסרים ובעיות גבול. ייצוא עומד בכל הקונבנציות ZMK ומוכן לאינטגרציה לפורמוואר.
אלגוריתמים וחישובים: ממפים קואורדינטות רשת לשורות/עמודות של המטריצה, מחלקים אינדים לכל שכבה ומעצבים את הנתונים לייצוגי ZMK תואמים. משתמשים בלוגיקה של מטריצת מקשים סטנדרטית ותומכים בתצורות לא אחידות באמצעות placeholders.
שגיאות ומקרי קצה: מדווחים על קלטים לא תקינים, קלטים חסרים, כפילויות, מיקומים חריגים ואי זמינות ספריית footprint עם הודעות שניתן לפעול על פיהן. התנהגות תקלה מהירה מכוונת לשלב התיקונים.
תעשייה/מקומיות: תואם את ההסכמות ANSI US כברירת מחדל; מפות שכבות מקומיות ודוקומנטציה עבור תצורות אזוריות. היחידות הן תאי רשת; אין הנחות חומרה מקומיות מעבר לסטנדרדים של keycode.
הנחות וההדמיות: מניח גישה לספריית footprint תקפה ותוצרים תואמי firmware; לא כולל UI ותצוגה חומרתית או יעדי firmware שאינם ZMK. אין לקמול על tolerances לייצור או עיצובים שאינם תצוגה-גריד.