Shepherd 16: دیگه هیچ وابستگیای نداره
خلاصهٔ کاملتر
تیم Shepherd نسخهٔ shepherd.js 16.0.0 و react-shepherd 8.0.0 رو منتشر کرده. Shepherd یه کتابخونهٔ جاوااسکریپتیه برای ساختن تور راهنما، یعنی پنجرههای کوچیکی که مرحله به مرحله کنار بخشهای صفحه ظاهر میشن و به کاربر توضیح میدن چی کجاست. هر دو نسخه major هستن، پس تغییرات ناسازگار دارن و قبل از آپگرید باید چکشون کنید.
بزرگترین تغییر اینه که پروژه همهٔ وابستگیهاشو حذف کرده. تا قبل از این، Shepherd برای حساب کردن جای tooltip کنار المنت هدف از Floating UI کمک میگرفت. حالا یه positioning engine داخلی نوشتن، یعنی کدی که خودش تعیین میکنه پنجره دقیقاً کجای صفحه نشون داده بشه. نتیجهش اینه که حجم کتابخونه ۳۷ درصد کمتر شده و یه پکیج کمتر تو پروژهتون دارید. تو همین تغییر، مستنداتی هم مخصوص agentهای هوش مصنوعی اضافه شده.
react-shepherd هم حالا با tsdown بیلد میشه که خودش جزو تغییرات ناسازگار حساب شده. tsdown یه ابزار بیلد برای کتابخونههای TypeScript هست. تستهای پروژه هم دیگه به Floating UI وابسته نیستن.
کلی باگ هم رفع شده. روی موبایل، پوشش ناقص overlay موقع pinch-zoom، اسکرول لمسی داخل مرحلهها، focus نامرئی دیالوگ و از دست رفتن focus روی input موقع جابهجا شدن tooltip درست شدن. چند تا race condition هم تو چرخهٔ عمر تور، داخل beforeShowPromise و start و confirmCancel حل شده. یعنی اگه کاربر سریع بین مرحلهها بره یا تور رو لغو کنه، وضعیت تور قاطی نمیشه.
حالت modal هم چند تا اصلاح گرفته: محاسبهٔ offset داخل iframe حالا درست سر پنجرهای که overlay توش رندر میشه متوقف میشه، overflow: hidden بهعنوان برش در نظر گرفته میشه، المنتهای inline و display: contents نادیده گرفته میشن، و highlight دیگه بیدلیل توسط المنتهای ریشه بریده نمیشه.
نکات کلیدی:
- shepherd.js به 16.0.0 و react-shepherd به 8.0.0 رسیدن و هر دو major هستن
- وابستگی به Floating UI حذف شده و موتور جایگذاری داخلی جاش اومده
- حجم کتابخونه ۳۷ درصد کمتر شده
- react-shepherd حالا با tsdown بیلد میشه
- race conditionهای beforeShowPromise، start و confirmCancel رفع شدن
- چند باگ موبایل مثل pinch-zoom و از دست رفتن focus روی input درست شدن




