پرش به محتوای اصلی
پرش به محتوای مقاله

«اجبار به TypeScript»؛ شرطِ حذف کامل شکاف‌های منطقی در Toolcrib

·۱۲ شهریور ۱۴۰۵۳ دقیقه مطالعه
چرا به «طبقه معماری» برای ویب‌کدینگ نیاز داریم: بررسی ۳ اپلیکیشن ساخته‌شده با Claude
چرا به «طبقه معماری» برای ویب‌کدینگ نیاز داریم: بررسی ۳ اپلیکیشن ساخته‌شده با Claude
اشتراک‌گذاری
واقعاً چه چیز جدید است؟

جایگزینی پکیج‌های npm با متد Vendoring سورس‌کد برای افزایش قابلیت مشاهده و سرعت اصلاح باگ توسط AI؛ این اولین بار است که یک کتابخانه UI به‌طور صریح برای «خوانایی توسط مدل» و نه «راحتی توسعه‌دهنده» طراحی شده است.

تصور کنید یک برنامه‌نویس React هستید که از هوش مصنوعی برای ساخت سریع رابط کاربری استفاده می‌کند، اما هر بار باید ساعت‌ها وقت صرف اصلاح لایه‌های z-index یا رفع خطاهای دسترسی‌پذیری کند. Toolcrib آمده است تا این بحران «کدنویسی بر اساس حس» (Vibe Coding) را با ایجاد یک کفِ معماری سخت‌گیرانه حل کند که دستیارهای هوش مصنوعی اجازه ندارند از آن پایین‌تر بروند. این رویکرد در واقع پاسخی به این چالش است که چگونه دموهای Vibecoding را با استفاده از یک استک پنج‌لایه به محصولاتی عملیاتی تبدیل کنیم.

به گزارش یک حسابرسی جامع در ۲ سپتامبر ۲۰۲۶، مدل‌های هوش مصنوعی اگرچه می‌توانند اپلیکیشن‌های کاربردی بسازند، اما بدون وجود یک چارچوب ساختاری، به‌شدت در مدیریت لایه‌بندی عناصر و استانداردهای دسترسی‌پذیری شکست می‌خورند. این موضوع تأییدی بر این واقعیت است که کدهای تولیدشده توسط هوش مصنوعی در غیاب زیرساخت معماری به‌سرعت فرو می‌پاشند. همان‌طور که در تحلیل قبلی ما درباره‌ی استفاده از عامل‌ها در محیط‌های بومی مرور کردیم، صنعت اکنون از «پرامپت‌نویسی ساده» به سمت ایجاد «محدودیت‌های محیطی سخت» برای هوش مصنوعی حرکت می‌کند.

برای اکثر توسعه‌دهندگان، این تغییر شبیه جابه‌جایی از یک بوم نقاشی خالی به یک مجموعه لگو است؛ هوش مصنوعی هنوز هم ممکن است تصمیمات طراحی بدی بگیرد، اما دیگر نمی‌تواند فراموش کند که یک پنجره مودال (Modal) چگونه باید رفتار کند یا یک فرم چگونه باید داده‌ها را اعتبارسنجی نماید.

کفِ معماری

بر اساس گزارش وب‌سایت dev.to، سیستم Toolcrib این کفِ ساختاری را از طریق ۶۸ کامپوننتِ تایپ‌شده و یک گذرگاه رویداد سراسری به نام aiBus پیاده می‌کند. این سیستم با ادغام Radix UI و react-aria-components شرکت ادوبی، تضمین می‌کند که ناوبری با کیبورد و مدیریت فوکوس به‌طور خودکار انجام شود.

چرا به «طبقه معماری» برای ویب‌کدینگ نیاز داریم: بررسی ۳ اپلیکیشن ساخته‌شده با Claude

این زیرساخت برای جلوگیری از توهم (Hallucination) — شبیه دوستی که با اطمینان خاطره‌ای را اشتباه تعریف می‌کند — تضمین‌های مشخصی ارائه می‌دهد:

  • حذف Prop-Drilling: استفاده از زیرکامپوننت‌های slot و aiBus برای اجرای رویدادها (مثل اعلان‌ها) از هر جای اپلیکیشن، بدون نیاز به پاس دادن متوالی ویژگی‌ها.
  • ایمنی سخت‌گیرانه تایپ: هرگونه ویژگی (Prop) اشتباه باعث شکست در زمان کامپایل می‌شود، نه ارسال کد خراب به محیط تولید.
  • دسترسی‌پذیری خودکار: پالت‌های رنگی توسط یک موتور HSV تولید و از طریق خط لوله‌ی axe-core و Playwright در محیط CI تایید می‌شوند.
  • فرم‌های اعتبارسنج شده: موتور فرم Zod خروجی‌ها را مجبور به اعتبارسنجی می‌کند تا رشته‌های خام باعث شکست کدهای پایین‌دستی نشوند.

آزمایش در دنیای واقعی

برای سنجش این ادعاها، سه اپلیکیشن PWA که کاملاً توسط هوش مصنوعی ساخته شده‌اند مورد ارزیابی قرار گرفتند:

  • Demo Harness: یک ویترین کامپوننت با پوشش ۱۰۰ درصدی Toolcrib که طی ۲۵ روز به‌روزرسانی شد.
  • Feed Farmer: یک خوانشگر RSS که در ۸۸ درصد فایل‌های آن از این کتابخانه استفاده شده و در ۳ روز ساخته شده است.
  • Founder's Desk: یک داشبورد مالی با پوشش ۵۰ درصدی که در یک جلسه کاری و تنها با ۲ کامیت تکمیل شد.

با وجود این پیشرفت‌ها، این حسابرسی دو نقطه شکست بحرانی را شناسایی کرد. در پروژه Feed Farmer، چون در پرامپت به‌طور صریح دستور استفاده از TypeScript داده نشده بود، هوش مصنوعی به پیش‌فرض جاوااسکریپت ساده برگشت و تمام مزایای ایمنی تایپ کتابخانه را از بین برد. این یعنی هوش مصنوعی منطق محیطی را به‌طور خودکار اعمال نمی‌کند و توسعه‌دهنده باید در ابتدای کار، TypeScript را اجبار کند.

در اپلیکیشن Founder's Desk نیز یک کرش در زمان اجرا رخ داد؛ در حالی که طرحواره Zod داده را عدد می‌دید، وضعیت فرم به‌اشتباه یک رشته متنی خام را پاس داد و متد .toFixed(2) باعث توقف برنامه شد.

یک تصمیم معماری متمایز در Toolcrib این است که سورس‌کد را مستقیماً در مخزن پروژه قرار می‌دهد (Vendor) و از پکیج‌های npm استفاده نمی‌کند. این کار به دستیارهای هوش مصنوعی اجازه می‌دهد کد محلی را بخوانند و باگ‌ها را فوراً وصل کنند، هرچند توسعه‌دهنده باید برای به‌روزرسانی‌ها دستور toolcrib merge را دستی اجرا کند.

این چرخش نشان می‌دهد آینده توسعه با AI، نه در پرامپت‌های بهتر، بلکه در «کتابخانه‌های حفاظتی» (Guardrail Libraries) است. با انتقال منطق از پرامپت به کد، بار شناختی مدل زبانی بزرگ (LLM) — مثل کتابخانه‌داری که میلیاردها صفحه را خوانده و حالا با همان لحن جواب می‌دهد — کاهش می‌یابد.

برای کسانی که پروژه‌های جدید React را شروع می‌کنند، موازنه روشن است: شما انعطاف‌پذیری یک فریم‌ورک بالغ را فدای سیستمی می‌کنید که برای تحلیل و خودترمیمی توسط هوش مصنوعی بهینه شده است.

گام بعدی شما

  • اگر از Cursor یا GitHub Copilot استفاده می‌کنید، سعی کنید محدودیت‌های ساختاری (مانند Zod) را در لایه کد تعریف کنید، نه فقط در پرامپت.
  • بررسی کنید آیا کتابخانه‌های UI فعلی شما اجازه دسترسی مستقیم مدل به سورس‌کد را می‌دهند یا پشت لایه‌های npm پنهان شده‌اند.
  • در پروژه‌های AI-first، استفاده از TypeScript را به عنوان یک دستور سیستمی (System Prompt) اجباری کنید.

اما تأثیر این رویکرد بر سرعت استنتاج مدل‌ها در مقیاس بزرگ هنوز ناشناخته است — به تحلیل ما درباره‌ی بهینه‌سازی هزینه استنتاج مراجعه کنید.

چرا این موضوع مهم است؟

این رویکرد با تکیه بر اعتبار استانداردهای Radix و Zod، ریسک تولید کدهای غیرقابل دسترس یا ناپایدار را کاهش می‌دهد. این تغییر باعث می‌شود توسعه‌دهندگان کمتر بر روی اصلاحات تکراری متمرکز شوند و بیشتر بر منطق تجاری محصول تمرکز کنند.

تأثیر برای ایران

برای توسعه‌دهندگان ایرانی که در پروژه‌های فریلنسری با ددلاین‌های کوتاه فعالیت می‌کنند، این ابزار سرعت تحویل محصول را بالا می‌برد، هرچند دسترسی به برخی ابزارهای CI برای تایید دسترسی‌پذیری ممکن است با محدودیت‌های تحریمی روبرو باشد.

·نگاه ما
تحریریه دات‌هوش

انتقال «حفاظ‌ها» از لایه دستورالعمل (Prompt) به لایه زیرساخت (Codebase) یک تغییر پارادایم است. این رویکرد پذیرفته است که مدل‌های زبانی هرگز به‌طور کامل قابل اعتماد نیستند و تنها راه مهار توهمات، ایجاد محیط‌هایی است که در آن اشتباه کردن از نظر فنی غیرممکن باشد. در واقع، Toolcrib به جای آموزش مدل، محیط را برای مدل «ضدگلوله» می‌کند.

منابع

این گزارش با خط‌لولهٔ خودکار دات‌هوش از منابع معتبر جهانی تدوین و زیر نظر تحریریه منتشر شده است. روش کار ما

گفتگو

پنج‌شنبه‌های هوش‌محور

بسته‌ی هفتگی دات‌هوش

۵ خبر، ۲ ابزار، ۱ پرامپت در هر شماره. به‌زودی راه‌اندازی می‌شود — هر پنج‌شنبه صبح.

خبر کلیدی
ابزار کاربردی
پرامپت حرفه‌ای
تحلیل پژوهش
به‌زودی
زاویه‌ی ایرانی
به‌زودی
تمرین این هفته
به‌زودی

راهنماهای دات‌هوش

راهنماهای کاربردیِ دات‌هوش برای کار با هوش مصنوعی — از همین‌جا شروع کنید:

دات‌هوش

راهنمای فارسی هوش مصنوعی — با نگاه به ایران

اخبار روزانه، معرفی ابزارها و مدل‌ها، و آموزشِ کار با هوش مصنوعی؛ همیشه با این پرسش که از ایران چه چیزی کار می‌کند و چه چیزی نه.