key-correction

แปลงข้อความที่พิมพ์ผิดภาษาเพราะลืมสลับคีย์บอร์ด — พิมพ์ไทยตอนคีย์บอร์ดเป็นอังกฤษ (หรือกลับกัน) แล้วได้ตัวอักษรมั่วๆ ไลบรารีนี้แปลงกลับให้ถูกภาษา โดยอิงตำแหน่งปุ่มจริงของคีย์บอร์ดเลย์เอาต์เกษมณี (Kedmanee)

l;ylfu  →  สวัสดี
สวัสดี  →  l;ylfu

ติดตั้ง

npm install key-correction
# หรือ
bun add key-correction

การใช้งาน

import { KeyCorrection } from 'key-correction'

KeyCorrection('l;ylfu', 'TH') // "สวัสดี"
KeyCorrection('สวัสดี', 'EN') // "l;ylfu"

รองรับทั้ง ESM และ CommonJS:

// ESM
import { KeyCorrection } from 'key-correction'

// CommonJS
const { KeyCorrection } = require('key-correction')

API

KeyCorrection(text: string, to: 'EN' | 'TH'): string

แปลงข้อความ text ไปตามเลย์เอาต์เป้าหมาย to

| พารามิเตอร์ | ชนิด | คำอธิบาย | | --- | --- | --- | | text | string | ข้อความที่ต้องการแปลง | | to | 'EN' \| 'TH' | แปลงเป็นภาษาอังกฤษ ('EN') หรือภาษาไทย ('TH') |

คืนค่าเป็นข้อความที่แปลงแล้ว ตัวอักษรที่ไม่มีอยู่ในตารางคีย์บอร์ด (เช่น ตัวเลขไทย, อีโมจิ, อักขระภาษาอื่น) จะถูกปล่อยผ่านตามเดิมโดยไม่แปลง

หลักการทำงาน

ไลบรารีนี้จับคู่อักขระตาม ตำแหน่งปุ่มจริง บนคีย์บอร์ดเกษมณี (อ้างอิงตาราง Microsoft KBDTH0) ครอบคลุมทั้งปุ่มปกติและปุ่มกด Shift รวม 94 คู่ตัวอักษร ไม่ใช่การเรียงตามตัวอักษร a-z จึงแปลงได้ถูกต้องตรงกับสิ่งที่คีย์บอร์ดจริงจะพิมพ์ออกมา

Requirements

Node.js >= 22

License

MIT © TiwPhiraphan