خريطة الحزم

pantoken هو مستودع أحادي (monorepo) يضم حزمًا صغيرة ذات غرض واحد مجمعة في دلاء. ثبّت الحزمة التي تتناسب مع مهمتك، أو ثبّت الحزمة الموحدة pantoken واستورد من المسارات الفرعية الخاصة بها (على سبيل المثال pantoken/css, pantoken/react, pantoken/tailwind).

النواة

النموذج المشترك والمحوّل الذي يبني عليه كل شيء آخر.

Package	What it does
@pantoken/model	أنواع TypeScript بدون اعتمادات: شكل Token وعقدة الإضافات.
@pantoken/core	يحلّل الرموز والأيقونات من المصدر إلى IR القانوني، ويُصدِر CSS.
@pantoken/tokens	IR المحلول مبوَّب كـ JSON ثابت، لكل سمة، بالإضافة إلى مصدر Tokens Studio الخام.
@pantoken/utils	محلّل الرموز، تعابير Regex للمرجع، مساعدات للحالة والألوان، فحوصات الانحراف، ومصدّرات token→utility-class.
@pantoken/plugin-kit	بناء وتركيب إضافات pantoken باستخدام definePlugin.
@pantoken/cli	pantoken generate <target> — يُصدِر مصدرًا أصليًا ومنصّات.

الصيغ

تحويل الرموز إلى صيغة ملف.

Package	Output
@pantoken/css	CSS معنون بنوع @property مع light-dark() وأيقونات بيانات-URI.
@pantoken/scss	متغيرات SCSS، محلولة إلى وضع واحد.
@pantoken/less	متغيرات Less.
@pantoken/stylus	متغيرات Stylus.
@pantoken/dtcg	مستند W3C Design Tokens (DTCG).
@pantoken/tokens	IR كـ JavaScript و JSON (مذكور أيضًا تحت النواة).
@pantoken/icons	عرض مريح على رموز الأيقونات.
@pantoken/icon-font	خط أيقونات للويب (TTF, WOFF2) بالإضافة إلى CSS الخاص به.
@pantoken/components	مكتبة مكونات CSS بمظهر InstUI (زر، تنبيه، جدول، والمزيد) بالإضافة إلى إعادة تعيين أساسية مع حلقة تركيز، تنسيق prose، أدوات عرض عرضية، وخطوط العلامة التجارية. انظر Components.

العارضون (Renderers)

تكاملات الأطر والأدوات.

Package	For
@pantoken/react	هوكات React، <Icon>، وموفر رموز (token provider).
@pantoken/vue, @pantoken/svelte, @pantoken/angular	المكوّن الويب، مُوصَّل في كل إطار عمل.
@pantoken/react-native	كائنات رموز صديقة لـ StyleSheet (بدون متغيرات CSS).
@pantoken/web-components	<instui-icon> وأوليات منمّقة، مستقلة عن الإطار.
@pantoken/astro	إعداد الرموز لمواقع Astro.
@pantoken/react-markdown, @pantoken/rehype	رموز الأيقونات وعينات الألوان في Markdown.
@pantoken/markdown-it	مكوّن إضافي لmarkdown-it لرموز الأيقونات وعينات الألوان.
@pantoken/css-in-js	موضوع نوعي (type-safe) لـ styled-components و Emotion.
@pantoken/mui	موضوع لـ Material UI.
@pantoken/bootstrap, @pantoken/shadcn	جسور متغيرة CSS لـ Bootstrap و shadcn/ui.
@pantoken/foundation	تجاوز إعدادات Sass وتراكب CSS لـ Foundation.
@pantoken/docusaurus, @pantoken/vitepress	سمات لـ Docusaurus و VitePress.
@pantoken/mintlify	سمة Mintlify docs.json (ألوان + خلفية).
@pantoken/storybook	سمة Storybook.
@pantoken/pendo	CSS عام ذو طراز Instructure لأدلة Pendo.

البندلرز (Bundlers)

تكاملات أدوات البناء.

Package	For
@pantoken/vite	إضافة Vite مع وحدات افتراضية وحقن CSS.
@pantoken/next	withPantoken لـ Next.js transpilePackages.
@pantoken/webpack	إضافة webpack.
@pantoken/postcss	قاعدة at-rule @pantoken;.
@pantoken/tailwind	إعداد مسبق (preset) لـ Tailwind.
@pantoken/panda	إعداد مسبق (preset) لـ Panda CSS.

المنصات

أهداف أصلية ومولِّدة مواقع، يتم إصدارها عبر CLI أو واجهة برمجة التطبيقات الخاصة بها.

Package	Output
@pantoken/swift	مصدر Swift بالإضافة إلى مسودّة ملف SwiftPM.
@pantoken/android	موارد XML لنظام Android.
@pantoken/compose	Jetpack Compose Kotlin.
@pantoken/flutter	Flutter Dart.
@pantoken/rust	ثوابت Rust لـ egui أو iced.
@pantoken/wordpress	قالب WordPress theme.json.
@pantoken/vanilla	منتدى Vanilla variables.json.
@pantoken/drupal	أصول موضوع Drupal.
@pantoken/hugo, @pantoken/jekyll	بيانات مواقع Hugo و Jekyll.
@pantoken/email	قيم ملائمة للإدراج في بريد HTML.

التصميم

لأدوات التصميم.

Package	Output
@pantoken/figma	حمولة متغيرات Figma.
@pantoken/swatches	عيّنات ألوان (ASE, GPL, Sketch) بالإضافة إلى ورقة عيّنات SVG قابلة للعرض.

الإضافات (Plugins)

تحويلات اختيارية توسّع مخرجات الرموز أو CSS. انظر Plugins.

Package	What it adds
@pantoken/plugin-stacking	أعماق z-index مسمّاة كـ توكنات --instui-stacking-*.
@pantoken/plugin-visual-debug	حدّة تصحيح تخطيط -with-visual-debug.
@pantoken/plugin-simple-icons	رموز العلامات التجارية من simple-icons.
@pantoken/plugin-logos	شعارات منتجات Instructure كـ SVGs، بيانات URIs، وتوكنات صور.
@pantoken/plugin-prune-custom-props	إضافة PostCSS تحذف الخصائص المخصصة غير المستخدمة.

الأدوات

بنية البناء، التوثيق، والبنية التحتية للعروض التوضيحية للمستودع نفسه. معظمها داخلي، لكن القطع معزولة بذاتها، لذا نوثّقها هنا وبعضها يُنشر إلى npm بمفرده.

Package	What it does
@pantoken/aggregate	يولّد حزمة البندولات الموحدة pantoken و exports من تبعياتها.
@pantoken/validate-generated	بوابة الانحراف: تتحقق أن كل ورقة أنماط مولّدة تحلّ مقابل IR للرموز.
@pantoken/demo	مشغّل العرض التوضيحي المستضاف ذاتيًا: يحلّ @demo spec إلى إطار iframe ويُعرض HTML/CSS/JS عاري بنفس الأصل، بموضوع الرموز.
@cssdoc/core (external)	مستخرج توثيق CSS عامًا (TSDoc، للـ CSS): يحلل تعليقات التوثيق + شجرة تحليل CSS إلى نموذج تصدره المستندات كمرجع API لـ CSS. يعيش في مستودع خاص به؛ يُستهلك عبر تبعية رابط.

@pantoken/validate-generated هو سكربت يُشغل مرة واحدة (يتم استدعاؤه بواسطة pnpm run ready), لذا ليس له صفحة API ؛ أما الباقون فلهم صفحات.

الذكاء الاصطناعي

أصول إعدادات الذكاء الاصطناعي الموجهة للمستهلك. هذه للمشروعات التي تستخدم pantoken، وليست لتطوير pantoken نفسه.

• @pantoken/ai يثبت AGENTS.md, llms.txt, و قواعد المساعد/المحرر (Cursor, Copilot, Windsurf, Claude Code) في مستودع المستهلك.

الإضافات التطويرية (Dev plugins)

إضافات نؤلفها للأدوات التي نبني بها، مجمّعة حسب المستضيف. هي قائمة بذاتها وقابلة للنشر.

Package	Plugs into
@pantoken/typedoc-plugin-demo	TypeDoc: يحوّل وسم @demo <provider>:<ref> إلى سياج عرض توضيحي قابل للتضمين.
@pantoken/vite-workspace-orchestrator	Vite: يعيد بناء حزم مساحة العمل upstream (والتابعين لها) عند تغيّر مصدرها.