‏آنالوگ ۲.۵: چندزبانی، کامپایل سریع و محتوای سلسله‌مراتبی

AnalogJS که یه فریم‌ورک meta برای انگولار محسوب می‌شه، نسخه ۲.۵ خودش رو منتشر کرده و این بار چند تا قابلیت مهم و کاربردی با خودش آورده.

اول از همه بریم سراغ پشتیبانی از چندزبانی در زمان اجرا (Runtime i18n). تا قبل از این، مدیریت زبان‌های مختلف در انگولار یعنی چند بیلد جداگانه برای هر زبان. اما آنالوگ ۲.۵ این مشکل رو حل کرده؛ با یه بیلد واحد می‌شه تمام زبان‌های موردنظر رو پشتیبانی کرد. این قابلیت روی سیستم $localize خود انگولار بنا شده.

تشخیص زبان فعال هم هوشمندانه طراحی شده. در سمت سرور، آنالوگ از پیشوند URL (مثل /fr/about) یا هدر Accept-Language مرورگر زبان رو تشخیص می‌ده. در سمت کلاینت هم از آدرس فعلی صفحه استفاده می‌کنه. برای تغییر زبان هم یه helper کوچیک به اسم injectSwitchLocale وجود داره که با یه خط کد کاربر رو به نسخه زبانی دیگه‌ای از همون صفحه منتقل می‌کنه.

قابلیت بعدی حالت کامپایل سریع (Fast Compilation Mode) هست. با فعال کردن گزینه fastCompile، آنالوگ از یه pipeline کامپایل بومی Vite در کنار پارسر OXC استفاده می‌کنه. نتیجه؟ سرعت بالاتر در شروع اولیه (cold start) و بروزرسانی سریع‌تر در حین توسعه (HMR). این حالت مخصوصاً برای پروژه‌های محتوامحور و تست نویسی خیلی به کار میاد، چون type checking رو می‌شه به یه پروسه جداگانه سپرد.

سومین بهبود مهم مربوط به محتوای سلسله‌مراتبی (Hierarchical Content) هست. قبلاً content resolver های آنالوگ فقط پوشه‌های سطح اول رو می‌فهمیدن. الان می‌شه ساختار دایرکتوری‌های تودرتو داشت، مثلاً برای یه سایت مستندات که چند سطح زیرشاخه داره. یه گزینه جدید به اسم recursive هم اضافه شده که prerendering رو برای تمام فایل‌های محتوای موجود در زیرشاخه‌ها به صورت خودکار انجام می‌ده.

برای مسیریابی هم یه catch-all route می‌شه تعریف کرد که slug های با اسلش (مثل docs/getting-started/welcome) رو درست مدیریت کنه. هر فایل محتوا حالا یه فیلد relativePath داره که موقع transform کردن مسیرها خیلی کمک‌کننده‌ست.

علاوه بر اینا، آنالوگ ۲.۵ یه راهنمای جامع برای ادغام با سرویس‌های هوش مصنوعی هم اضافه کرده. این راهنما نشون می‌ده چطور می‌شه LLM provider ها رو به API route های آنالوگ وصل کرد، response های streaming داشت و کلیدهای API رو سمت سرور نگه داشت.

برای آپدیت به نسخه ۲.۵ می‌شه از ng update یا در پروژه‌های Nx از nx migrate استفاده کرد.

نکات کلیدی:

• پشتیبانی از i18n در زمان اجرا با یه بیلد واحد برای همه زبان‌ها
• تشخیص خودکار زبان از URL یا هدر مرورگر
• حالت fastCompile برای کامپایل سریع‌تر با استفاده از OXC
• پشتیبانی از محتوای تودرتو و prerendering بازگشتی
• راهنمای جدید برای اتصال به سرویس‌های هوش مصنوعی