@pierre/words: رندر سریع Markdown در حال استریم
خلاصهٔ کاملتر
تیم Pierre کتابخونهٔ @pierre/words رو بهصورت بتا معرفی کرده؛ یه رندرکنندهٔ streaming Markdown، یعنی ابزاری که متن Markdown رو همون موقع که داره تیکهتیکه میرسه نمایش میده و منتظر آخرین کلمه نمیمونه. این دقیقاً همون چیزیه که برای نشون دادن جواب مدلهای هوش مصنوعی لازمه. هستهٔ کتابخونه با WebAssembly Text نوشته شده، مستقیم HTML تولید میکنه و از GitHub Flavored Markdown پشتیبانی میکنه.
سازندهها میگن رندرکنندهٔ پایهٔ React این کتابخونه تو بنچمارک gzip حدود ۶۵ درصد از Streamdown کوچیکتره. بنچمارکها روی پنج سند مختلف، از جوابهای کوتاه AI تا مشخصات فنی طولانی، انجام شده. تو تست React، متن با تیکههای حداکثر ۲۵۶ کاراکتری داخل JSDOM پخش شده و تو مرورگر هم هر تیکه ۴۰ میلیثانیه بعد از قبلی رسیده. نتیجهها میانهٔ سه اجرای جدا روی Apple M4 Pro با Chromium 134 هستن و کد و دادههای خام بنچمارک هم منتشر شده تا هر کسی بتونه تکرارش کنه.
یه نکتهٔ منصفانه هم تو بخش حجم دانلود اومده: Words همهٔ ۱۵۲ زبان برنامهنویسی داخلیش رو یکجا داره، ولی Streamdown زبانها رو موقع نیاز لود میکنه. پس رو صفحههایی که زبان کمتری دارن، Streamdown کمتر از عدد کل دانلود میکنه. CSS هم جداست: ۱.۲ کیلوبایت برای Words و ۰.۴ کیلوبایت برای Streamdown.
استفاده تو React سادهست. کامپوننت Markdown متن رو میگیره و با isAnimating میفهمه هنوز استریم ادامه داره. گزینهٔ animated هم کاری میکنه متن تازه با fade وارد بشه، بدون اینکه متن قبلی جابهجا بشه، و تنظیم reduced-motion کاربر هم رعایت میشه:
<Markdown
isAnimating={isStreaming}
animated={{ animation: 'fadeIn', duration: 180 }}
lineNumbers={false}
>
{text}
</Markdown>برای رنگی کردن کد هم میشه @pierre/highlights رو با createHighlightsPlugin وصل کرد تا بلوکهای کد همون موقع که استریم میشن highlight بشن. زبانهای ناشناخته هم به متن ساده برمیگردن. علاوه بر این، کتابخونه آپدیتهای تدریجی و hookهایی برای دست بردن تو رندر HTML داره.
نکات کلیدی:
- @pierre/words با WebAssembly Text نوشته شده و فعلاً بتاست
- رندرکنندهٔ پایهٔ React حدود ۶۵ درصد از Streamdown 2.7.1 کوچیکتره (gzip)
- همهٔ ۱۵۲ زبان داخلی یکجا میان، در حالی که Streamdown زبانها رو موقع نیاز لود میکنه
- افکت fadeIn با مدت قابل تنظیم (مثلاً ۱۸۰ میلیثانیه) و احترام به reduced-motion
- syntax highlighting حین استریم با پکیج @pierre/highlights




