Astrobook: محیط سبک برای توسعهٔ کامپوننتهای UI
خلاصهٔ کاملتر
Astrobook یه پروژهٔ متنبازه که خودش رو «playground مینیمال برای کامپوننتهای UI» معرفی میکنه. یعنی یه صفحهٔ جدا که توش هر کامپوننت رو با حالتهای مختلفش میبینی و تست میکنی، شبیه کاری که Storybook میکنه. نکتهٔ اصلیش اینه که روی Astro ساخته شده و چند فریمورک رو همزمان پشتیبانی میکنه: React، Vue، Preact، Svelte، Solid، Lit و Astro.
راهاندازیش سادهست: پکیج astrobook رو کنار integration فریمورکت (مثلاً @astrojs/react) نصب میکنی و توی astro.config.mjs به لیست integrations اضافهش میکنی. بعد Astrobook همهٔ فایلهای .stories.ts و .stories.tsx و پسوندهای مشابه رو پیدا میکنه.
فرمت storyها با بخش محدودی از Component Story Format v3 سازگاره، یعنی همون فرمتی که Storybook برای تعریف حالتهای هر کامپوننت استفاده میکنه. هر فایل یه default export داره که کامپوننت رو مشخص میکنه، و چند named export که هر کدوم یه حالت با args متفاوته:
export default {
component: Button,
}
export const PrimaryButton = {
args: { variant: 'primary' } satisfies ButtonProps,
}از decoratorها هم پشتیبانی میکنه، یعنی کامپوننتهایی که دور story پیچیده میشن، مثلاً برای اضافه کردن یه border. محدودیتش اینه که فعلاً decoratorها فقط برای تغییر ظاهر هستن و نمیتونن context یا رفتار سمت کلاینت کامپوننت رو عوض کنن، چون Astro اونها رو به HTML تبدیل میکنه و به مرورگر میفرسته. یه قابلیت کوچیک هم داره به اسم single-story hoisting: اگه تنها story یه فایل هماسم خودش باشه، توی منو بهجای Button/Button فقط Button نشون داده میشه.
تنظیمات زیادی هم داره: directory برای مشخص کردن پوشهای که storyها توشن، subpath برای وقتی که میخوای Astrobook رو داخل یه پروژهٔ Astro موجود زیر یه مسیر مثل /playground بیاری، css و head برای استایلها و تگهای سفارشی، و home یا homeContent برای عوض کردن صفحهٔ اصلی. میشه هم با چک کردن process.env.NODE_ENV فقط توی محیط development فعالش کرد تا توی build نهایی نیاد.
نکات کلیدی:
- Astrobook از React، Vue، Preact، Svelte، Solid، Lit و Astro پشتیبانی میکنه.
- با زیرمجموعهای از Component Story Format v3 در Storybook سازگاره و args و decorators رو قبول میکنه.
- decoratorها فعلاً فقط ظاهر رو تغییر میدن و به context یا رفتار کلاینت دسترسی ندارن.
- با گزینهٔ subpath میشه اون رو داخل یه پروژهٔ Astro موجود اضافه کرد.
- با شرط روی NODE_ENV میشه فقط توی development فعالش کرد.




