"use client"; import { isTypingTarget } from "@suphark/ui/lib/keyboard"; import { useEffect, useRef, useSyncExternalStore } from "react"; /** * คีย์ลัดของแอป — `useHotkeys("n", handler, { label })` ลงทะเบียนตอน mount ถอดตอน unmount * รูปแบบคีย์: ตัวเดียว `"n"`, `"/"`, `"?"` · มีตัวปรับ `"mod+k"` (mod = ⌘ บน Mac, Ctrl ที่อื่น), `"shift+n"`, `"alt+s"` * · ลำดับ `"g i"` (กด g แล้ว i ภายใน 1 วินาที) * ไม่ทำงานขณะพิมพ์ในช่อง (input/textarea/select/contenteditable) เว้นแต่ `allowInInput` * คีย์ตัวอักษรเดี่ยว (ไม่มี mod/ctrl/alt) ปิดทั้งแอปได้ด้วย `setSingleKeyHotkeys(false)` (WCAG 2.1.4) — `ShortcutsDialog` มีสวิตช์ให้ */ export interface HotkeyOptions { /** ชื่อคำสั่งใน `ShortcutsDialog` (ไม่ส่ง = ไม่แสดงในรายการ) */ label?: string; /** หัวกลุ่มใน `ShortcutsDialog` */ group?: string; enabled?: boolean; /** ทำงานแม้โฟกัสอยู่ในช่องพิมพ์ (เช่น mod+k, mod+s) */ allowInInput?: boolean; /** เรียก preventDefault ให้ (ค่าเริ่มต้น true) */ preventDefault?: boolean; } export interface RegisteredHotkey { id: number; keys: string; label?: string; group?: string; } // ---- ทะเบียนกลาง (ให้ ShortcutsDialog อ่าน) ---- let nextId = 1; let registry: RegisteredHotkey[] = []; const listeners = new Set<() => void>(); const emit = () => { for (const l of listeners) l(); }; const subscribe = (l: () => void) => { listeners.add(l); return () => listeners.delete(l); }; const SINGLE_KEY_STORAGE = "ui:hotkeys:single-key"; let singleKeyEnabled: boolean | null = null; const readSingleKey = () => { if (singleKeyEnabled !== null) return singleKeyEnabled; try { singleKeyEnabled = localStorage.getItem(SINGLE_KEY_STORAGE) !== "off"; } catch { singleKeyEnabled = true; } return singleKeyEnabled; }; /** เปิด/ปิดคีย์ลัดตัวอักษรเดี่ยวทั้งแอป (จำใน localStorage) */ export function setSingleKeyHotkeys(enabled: boolean) { singleKeyEnabled = enabled; try { localStorage.setItem(SINGLE_KEY_STORAGE, enabled ? "on" : "off"); } catch {} emit(); } /** คีย์ลัดที่ลงทะเบียนอยู่ (มี label) + สถานะคีย์ตัวอักษรเดี่ยว — อัปเดตเองเมื่อมีการเปลี่ยน */ export function useRegisteredHotkeys() { const list = useSyncExternalStore( subscribe, () => registry, () => registry, ); const single = useSyncExternalStore(subscribe, readSingleKey, () => true); return { hotkeys: list.filter((h) => h.label), singleKeyEnabled: single }; } export const isMac = () => typeof navigator !== "undefined" && /Mac|iPhone|iPad|iPod/.test(navigator.platform || navigator.userAgent); interface Chord { key: string; mod: boolean; ctrl: boolean; shift: boolean; alt: boolean; } function parseChord(chord: string): Chord { const parts = chord .toLowerCase() .split("+") .map((p) => p.trim()) .filter(Boolean); const key = parts[parts.length - 1] ?? ""; return { key: key === "space" ? " " : key, mod: parts.includes("mod") || parts.includes("meta") || parts.includes("cmd"), ctrl: parts.includes("ctrl"), shift: parts.includes("shift"), alt: parts.includes("alt"), }; } // แป้นที่ไม่ใช่ตัวอักษร → ตัวอักษรของแป้นเดียวกันบนแป้นอังกฤษ (ตาม event.code) const CODE_KEYS: Record = { Slash: "/", Period: ".", Comma: ",", Minus: "-", Equal: "=", BracketLeft: "[", BracketRight: "]", Semicolon: ";", Quote: "'", Backquote: "`", Backslash: "\\", }; /** * คีย์ของเหตุการณ์ — แป้นไทย (เกษมณี) กด N ได้ `event.key === "ื"` ปุ่มลัด "n" จึงไม่ทำงาน * ตัวอักษรที่ไม่ใช่ ASCII ใช้แป้นจริงจาก `event.code` (KeyN → "n", Digit1 → "1", Slash → "/") * ใช้กับปุ่มลัดที่เขียนเองนอก `useHotkeys` ด้วย (Ctrl+B ของ sidebar, X/Ctrl+A ของ SortableList) — รับ event ของ DOM หรือ React */ export function hotkeyKeyOf(event: { key: string; code?: string }) { const key = event.key.toLowerCase(); if (key.length !== 1 || /^[ -~]$/.test(key)) return key; const code = event.code ?? ""; if (/^Key[A-Z]$/.test(code)) return code.slice(3).toLowerCase(); if (/^Digit\d$/.test(code)) return code.slice(5); return CODE_KEYS[code] ?? key; } function matches(chord: Chord, event: KeyboardEvent) { const key = hotkeyKeyOf(event); if (key !== chord.key) return false; const modPressed = isMac() ? event.metaKey : event.ctrlKey; if (chord.mod !== modPressed) return false; if (!chord.mod && chord.ctrl !== event.ctrlKey) return false; if (chord.alt !== event.altKey) return false; // "?" "/" ฯลฯ บางแป้นต้องกด shift — ไม่บังคับ shift ถ้าไม่ได้ระบุและคีย์ไม่ใช่ตัวอักษร if (chord.shift && !event.shiftKey) return false; if (!chord.shift && event.shiftKey && /^[a-z0-9]$/.test(chord.key)) return false; return true; } // ปุ่มลัดตัวเดียว (เช่น "n") ห้ามทำงานทะลุ dialog/เมนู/ทัวร์ที่เปิดอยู่ — ไปเปิดฟอร์มซ้อนข้างหลัง const inOverlay = (target: EventTarget | null) => target instanceof Element && target.closest('[role="dialog"], [role="alertdialog"], [role="menu"], [aria-modal="true"]') !== null; export function useHotkeys( keys: string, handler: (event: KeyboardEvent) => void, options: HotkeyOptions = {}, ) { const { label, group, enabled = true, allowInInput = false, preventDefault = true } = options; const handlerRef = useRef(handler); handlerRef.current = handler; useEffect(() => { if (!enabled) return; const entry: RegisteredHotkey = { id: nextId++, keys, label, group }; registry = [...registry, entry]; emit(); const sequence = keys.trim().split(/\s+/).map(parseChord); const singleKey = sequence.every((c) => !c.mod && !c.ctrl && !c.alt); let step = 0; let timer: ReturnType | null = null; const reset = () => { step = 0; if (timer) clearTimeout(timer); timer = null; }; const onKeyDown = (event: KeyboardEvent) => { if (event.defaultPrevented || event.isComposing) return; if (!allowInInput && isTypingTarget(event.target)) return; if (singleKey && !readSingleKey()) return; // ปุ่มลัดตัวเดียว: ไม่ทำงานใน overlay และไม่รัวตอนกดค้าง if (singleKey && !allowInInput && (event.repeat || inOverlay(event.target))) return; const chord = sequence[step]; if (!chord) return reset(); if (!matches(chord, event)) { // พลาดกลางลำดับ: ลองเริ่มใหม่จากคีย์นี้ if (step > 0) { reset(); if (sequence[0] && matches(sequence[0], event)) step = 1; } return; } step += 1; if (step < sequence.length) { if (timer) clearTimeout(timer); timer = setTimeout(reset, 1000); return; } reset(); if (preventDefault) event.preventDefault(); handlerRef.current(event); }; window.addEventListener("keydown", onKeyDown); return () => { window.removeEventListener("keydown", onKeyDown); reset(); registry = registry.filter((h) => h.id !== entry.id); emit(); }; }, [keys, label, group, enabled, allowInInput, preventDefault]); } /** แสดงคีย์เป็นข้อความตามแพลตฟอร์ม: "mod+k" → ["⌘", "K"] (Mac) / ["Ctrl", "K"] */ export function formatHotkey(keys: string): string[][] { const mac = isMac(); return keys .trim() .split(/\s+/) .map((chord) => chord.split("+").map((p) => { const k = p.trim().toLowerCase(); if (k === "mod" || k === "meta" || k === "cmd") return mac ? "⌘" : "Ctrl"; if (k === "ctrl") return mac ? "⌃" : "Ctrl"; if (k === "shift") return mac ? "⇧" : "Shift"; if (k === "alt") return mac ? "⌥" : "Alt"; if (k === "space") return "Space"; if (k === "escape" || k === "esc") return "Esc"; return k.length === 1 ? k.toUpperCase() : k[0]?.toUpperCase() + k.slice(1); }), ); }