ranuts

کتابخانه‌ای از ابزارها برای سمت کاربر و برای Node، که به‌شکل نقاط ورودیِ مستقل و tree-shaking‌پذیر منتشر می‌شود. از همان زیرمسیری وارد کنید که چیز موردنیازتان در آن است، بقیه هرگز به باندل شما نمی‌رسد. همه‌چیز TypeScript است و هر خروجی از روی سورس مستند می‌شود.

• npm: ranuts · سورس: packages/ranuts

npm install ranuts

import { debounce } from 'ranuts/utils';

نقاط ورودی

import	چه دارد	محیط اجرا
ranuts	بسته ریشه: سطحِ utils به‌همراه visual	مرورگر + Node
ranuts/utils	DOM/BOM، رشته، شیء، عدد، رنگ، زمان، ذخیره‌سازی …	مرورگر + Node*
ranuts/node	سرور HTTP، مسیریاب، WebSocket، fs، استریم‌ها، میان‌افزار	فقط Node
ranuts/visual	موتور رسم دوبعدی (Canvas / WebGL / WebGPU)	فقط مرورگر
ranuts/i18n	موتور ترجمه: واژه‌نامه‌های تخت، تعویض در زمان اجرا	مرورگر + Node
ranuts/sw	راهبردهای کش و نیمهٔ ورکرِ قرارداد پیش‌کش	سرویس‌ورکر
ranuts/vnode	DOM مجازی به سبک Snabbdom	مرورگر
ranuts/stream	تحلیل SSE، تاکردن جریان مدل، بودجه توکن	مرورگر + Node
ranuts/conversation	گزارش رویدادها ← گره‌های گفت‌وگوی قابل رسم	مرورگر + Node

* دامنه ranuts/utils گسترده است: بیشترش رو به مرورگر دارد، اما کمک‌کننده‌های خالص همه‌جا کار می‌کنند. ranuts/node را در کد مرورگر وارد نکنید. fs / http / child_process را با خود می‌آورد.

چه چیزهایی در آن هست

تابعی: debounce · throttle · once / singleFlight · QuestQueue · withTimeout / deferred · compose

داده: cloneDeep · isEqual · merge · filterObj · قالب‌بندی و تحلیل عدد · تبدیل و آمیختن رنگ

متن: md5 · truncate · detectLanguage · resolveLocale · segmentByRanges · paginate · escapeHtml

مرورگر: ذخیره‌سازی · IndexedDB · کلاینت ورکر · پل postMessage · پیش‌واکشی · تشخیص دستگاه · کارایی · ZIP · ضبط صدا · گفتار به متن

هوش مصنوعی و گفت‌وگو: stream · conversation · i18n

رسم: موتور دوبعدی · DOM مجازی · کمک‌کننده‌های canvas · tween

Node: سرور HTTP و مسیریاب · کار با فایل · نوع‌های MIME

این‌ها گزیده‌اند. مرجع API همه خروجی‌ها را با امضا و توضیحشان دارد و چون از روی سورس تولید می‌شود نمی‌تواند از واقعیت فاصله بگیرد.

بعد کجا برویم

اگر می‌خواهید…	این را بخوانید
بدانید تابعی هست یا نه و امضایش چیست	مرجع API
میان دو ابزار شبیه به هم یکی را برگزینید	انتخاب ابزار
بر پایه دسته‌بندی مرور کنید	فهرست ابزارها
پاسخ استریم‌شده یک مدل را رسم کنید	stream ← conversation
رابط کاربری روی آن بسازید	ranui

هر دو بسته یک CLAUDE.md را درون تاربال npm همراه دارند: راهنمای آغازین برای عامل‌های کدنویس، که بی‌نیاز از شبکه مستقیم از node_modules خواندنی است.