ranuts
کتابخانه‌ای از ابزارها برای سمت کاربر و برای Node، که به‌شکل نقاط ورودیِ مستقل و tree-shakingپذیر منتشر می‌شود. از همان زیرمسیری وارد کنید که چیز موردنیازتان در آن است، بقیه هرگز به باندل شما نمی‌رسد. همه‌چیز TypeScript است و هر خروجی از روی سورس مستند می‌شود.
- npm:
ranuts· سورس:packages/ranuts
npm install ranutsimport { 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 خواندنی است.