اعلان نسخهٔ جدید (NewVersionPrompt)

معرفی

وقتی محصول می‌فهمد نسخهٔ تازه‌تری روی سرور منتشر شده (مثلاً با پرسیدن دوره‌ایِ نسخه)، NewVersionPrompt همین را به کاربر می‌گوید: یک سطح کوچک شناور پایینِ وسط صفحه، با همان ظاهر خنثی toast، یک دکمهٔ اصلی «به‌روزرسانی» و دکمهٔ بستن.

چه زمانی استفاده کنیم:

• نسخهٔ تازه‌تری از برنامه منتشر شده و کاربر باید صفحه را دوباره بارگذاری کند

چه زمانی استفاده نکنیم:

• برای معرفی تغییرات نسخه — از WhatsNew استفاده کنید
• برای پیام موقتِ نتیجهٔ یک کار — از sonner استفاده کنید
• Callout آبی یا Banner بالای صفحه برای همین پیام ممنوع است

زمین بازی

استفاده

'use client'
import { NewVersionPrompt } from '@partodata/ui'

export function NewVersionBanner() {
  const available = useNewVersionAvailable() // سیگنالِ خودِ محصول
  return <NewVersionPrompt open={available} />
}

رفتار

• onReload اختیاری است؛ پیش‌فرض window.location.reload().
• دکمهٔ بستن اعلان را پنهان می‌کند و onDismiss (اگر داده شده) را صدا می‌زند.
• ناحیهٔ زنده با role="status" و aria-live="polite" است: صفحه‌خوان پیام را بی‌آنکه کار کاربر را قطع کند می‌خواند.
• جهت از locale (یا زبان صفحه) می‌آید و در فارسی راست‌به‌چپ است.
• انیمیشن ورود فقط با motion-safe اجرا می‌شود و برای کاربرِ «کاهش حرکت» حذف است.