Text.js: فریمورک React برای اپهایی که تو کنسول مرورگر اجرا میشن
خلاصهٔ کاملتر
Text.js یه فریمورک Reactه برای ساختن اپهایی که بهجای DOM، داخل کنسول مرورگر رندر میشن. یعنی کاربر صفحه رو باز میکنه، DevTools رو باز میکنه و رابط کاربری رو اونجا میبینه. تو README پروژه اومده که برای اجرا به Bun 1.2+ یا Node.js 22+ و یکی از مرورگرهای Chrome، Edge، Firefox یا Safari نسخهی دسکتاپ نیاز داری.
نوشتن کامپوننت خیلی شبیه React معمولیه. فقط بهجای تگهای HTML از کامپوننتهای Box و Text استفاده میکنی و ورودی کیبورد رو با hook useInput میگیری. مثال خود پروژه یه شمارندهست که با کلیدهای بالا و پایین عوض میشه:
useInput((e) => {
if (e.key === "up") setCount((c) => c + 1);
if (e.key === "down") setCount((c) => c - 1);
});موتور رندرش جالبه: هر فریم با Yoga (یعنی همون موتور layout شبیه flexbox که React Native هم ازش استفاده میکنه) چیده میشه. بعد خونهها با run-length encoding فشرده میشن و به spanهای %c تبدیل میشن. %c قابلیتیه که اجازه میده متن کنسول رو CSS بدی. آخرش کل فریم با یه console.log نوشته میشه. اگه هیچ خونهای تغییر نکرده باشه، اصلاً چیزی لاگ نمیشه، یعنی کنسول بیدلیل پر نمیشه.
پروژه به چند پکیج تقسیم شده: @textjs/app برای App Router و CLI به اسم text، @textjs/react برای reconciler و hookها، @textjs/core برای cell buffer و درایور کنسول، و @textjs/font برای رندر فونتهای FIGlet (همون حروف بزرگ ASCII). یه create-text-app برای ساختن پروژه و یه پلاگین ESLint هم هست. کنارش یه افزونهی VS Code با پیشنمایش زنده و یه افزونهی Chrome DevTools با درخت کامپوننت، فریماینسپکتور و تایملاین داره. یه پل به اسم @textjs/opencode هم برای وصل شدن به سرور OpenCode ارائه شده.
نکات کلیدی:
- Text.js کامپوننتهای React رو داخل کنسول مرورگر رندر میکنه، نه DOM.
- به Bun 1.2+ یا Node.js 22+ و مرورگر دسکتاپ نیاز داره.
- layout با Yoga انجام میشه و هر فریم فقط با یه console.log نوشته میشه.
- فریم بدون تغییر هیچ لاگی تولید نمیکنه.
- افزونهی VS Code و Chrome DevTools هم داره و لایسنسش MITه.




