‏TanStack Hotkeys؛ شورتکات کیبورد جدی‌تر

TanStack کتابخونهٔ تازه‌ش، Hotkeys، رو تو مرحلهٔ alpha معرفی کرده. حرف اصلی صفحهٔ معرفی اینه که هر شورتکات چیزی بیشتر از یه keydown listener لازم داره: Hotkeys ورودی کیبورد رو تبدیل می‌کنه به یه command system تایپ‌دار — یعنی هر شورتکات به یه دستور تعریف‌شده با تایپ مشخص وصله، نه به یه هندلر رهای وسط کد.

هستهٔ ماجرا scope هست، چیزی که تیم TanStack بهش می‌گه «آدرس شورتکات». یه کلید می‌تونه به‌صورت global یه معنی بده، داخل ادیتور یه معنی کاملاً دیگه، و وقتی کاربر داره تو یه input تایپ می‌کنه اصلاً هیچ کاری نکنه. Hotkeys این context رو صریح می‌کنه، پس دیگه لازم نیست خودت شرط بذاری که «اگه فوکوس رو فلان المنته، بی‌خیال شو».

گرامر ژست‌ها هم فراتر از chord ساده‌ست. chord یعنی چند کلید با هم یه دستور می‌شن (مثل Mod+Shift+P برای command palette)، sequence یعنی کلیدهای پشت‌سرهم یه زبان دستوری کوچیک می‌سازن (اول G بعد D، شبیه Vim)، و held key یعنی مدت نگه‌داشتن کلید بخشی از ژسته (مثلاً Space برای حدود ۴۰۰ میلی‌ثانیه). رها کردن کلید و کلیدهایی که موقع حرکت pointer فعال می‌مونن هم پشتیبانی می‌شن.

بخش جالب برای اپ‌های واقعی، سپردن شورتکات به خود کاربره. تو صفحهٔ معرفی اومده که binding رو باید مثل دادهٔ کاربر دید: ژست رو ضبط می‌کنی، به یه تعریف قابل‌حمل نرمال می‌شه (Mod+Shift+P)، برای پلتفرم فعلی فرمت می‌شه (روی مک ⌘⇧P) و بعد همه‌جا — منو و cheat sheet — همون شکل نمایش داده می‌شه. تداخل‌ها، کلیدهای رزروشدهٔ مرورگر و فیلتر ورودی‌ها هم پیدا و نشون داده می‌شن به‌جای اینکه تبدیل به رفتار مرموز بشن.

فعلاً برچسب alpha روشه، پس API می‌تونه عوض بشه. شمارنده‌های همون صفحه ۶.۶ میلیون دانلود کل و حدود ۵۹۴ هزار دانلود هفتگی رو برای مجموعهٔ پکیج‌های TanStack روی npm نشون می‌ده و مخزن Hotkeys روی GitHub ۶۶۴ ستاره داره — یعنی خود کتابخونه هنوز خیلی نوپاست.

نکات کلیدی:

• Hotkeys الان تو مرحلهٔ alpha هست، پس API هنوز می‌تونه تغییر کنه
• scope تعیین می‌کنه یه کلید تو کدوم بستر (global، ادیتور، داخل input) کار کنه
• پشتیبانی از chord، sequence شبیه Vim، نگه‌داشتن کلید و رهاکردن کلید
• مسیر binding چهار قدمه: record، normalize به Mod+Shift+P، نمایش پلتفرم‌محور مثل ⌘⇧P، و publish تو منو و cheat sheet
• تشخیص conflict و کلیدهای رزروشدهٔ مرورگر به‌جای شکست بی‌صدا، شفاف گزارش می‌شه
• مخزن Hotkeys ۶۶۴ ستارهٔ GitHub داره و کل پکیج‌های TanStack هفته‌ای حدود ۵۹۴ هزار دانلود دارن