نقشهٔ بسته‌ها

pantoken یک مونورپو از بسته‌های کوچک و تک‌منظوره است که در «باکت»ها گروه‌بندی شده‌اند. بسته‌ای را نصب کنید که با کار شما سازگار است، یا بستهٔ یکپارچهٔ pantoken را نصب کرده و از زیرمسیرهای آن وارد کنید (برای مثال pantoken/css, pantoken/react, pantoken/tailwind).

هسته

مدل مشترک و مبدلِ پایه‌ای که سایر موارد روی آن ساخته می‌شوند.

Package	What it does
@pantoken/model	تایپ‌های TypeScript بدون وابستگی: شکل Token و قرارداد افزونه.
@pantoken/core	رزولوشن توکن‌ها و آیکون‌های upstream به IR کاننیکال، و رندر CSS.
@pantoken/tokens	IR رزولوشده به‌صورت JSON ایستا، به‌ازای هر تم، به‌علاوهٔ سورس خام Tokens Studio.
@pantoken/utils	حل‌کنندهٔ توکن، regexهای ارجاع، کمکی‌های حالت و رنگ، بررسی‌های drift، و emit‌کننده‌های token→utility-class.
@pantoken/plugin-kit	ساخت و ترکیب پلاگین‌های pantoken با definePlugin.
@pantoken/cli	pantoken generate <target> — تولید سورس‌های بومی و پلتفرم.

فرمت‌ها

تبدیل توکن‌ها به یک فرمت فایل.

Package	Output
@pantoken/css	CSS نوع‌دار با @property و آیکون‌های data-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.

رندرها

ادغام با فریم‌ورک‌ها و ابزارها.

Package	For
@pantoken/react	هوک‌های React, <Icon>, و یک ارائه‌دهندهٔ توکن.
@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	یک override تنظیمات Sass و پوشش CSS برای Foundation.
@pantoken/docusaurus, @pantoken/vitepress	تم‌ها برای Docusaurus و VitePress.
@pantoken/mintlify	یک تم Mintlify docs.json (رنگ‌ها + پس‌زمینه).
@pantoken/storybook	یک تم Storybook.
@pantoken/pendo	CSS سراسری به‌سبک Instructure برای راهنماهای Pendo.

باندلرها

ادغام با ابزارهای ساخت.

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 یا API خودشان.

Package	Output
@pantoken/swift	سورس Swift به‌علاوهٔ یک stub برای SwiftPM.
@pantoken/android	منابع XML اندروید.
@pantoken/compose	Jetpack Compose Kotlin.
@pantoken/flutter	Flutter Dart.
@pantoken/rust	constهای Rust برای مثال برای egui یا iced.
@pantoken/wordpress	یک theme.json قالب بلاک وردپرس.
@pantoken/vanilla	یک variables.json برای Vanilla Forums.
@pantoken/drupal	دارایی‌های تم Drupal.
@pantoken/hugo, @pantoken/jekyll	داده‌های سایت برای Hugo و Jekyll.
@pantoken/email	مقادیر مناسب برای نمایش درون‌خطی در ایمیل HTML.

طراحی

برای ابزارهای طراحی.

Package	Output
@pantoken/figma	یک payload برای Figma Variables.
@pantoken/swatches	سواچ‌های رنگ (ASE, GPL, Sketch) به‌علاوهٔ صفحهٔ نمونهٔ SVG قابل‌نمایش.

پلاگین‌ها

تبدیلات اختیاری که خروجی توکن یا CSS را گسترش می‌دهند. ببینید Plugins.

Package	What it adds
@pantoken/plugin-stacking	عمق‌های z-index نام‌گذاری‌شده به‌صورت توکن‌های --instui-stacking-*.
@pantoken/plugin-visual-debug	حاشیهٔ خط‌کشِ debugِ طرح‌بندی -with-visual-debug.
@pantoken/plugin-simple-icons	آیکون‌های برند از simple-icons.
@pantoken/plugin-logos	لوگوهای محصولات Instructure به‌صورت SVG، data URI و توکن‌های تصویری.
@pantoken/plugin-prune-custom-props	یک پلاگین PostCSS که custom propertyهای استفاده‌نشده را حذف می‌کند.

ابزارها

زیرساخت ساخت، مستندسازی و دمو برای خودِ مونورپو. بیشتر آن داخلی است، اما قطعات مستقل‌اند، پس اینجا مستندسازی شده‌اند و بعضی‌ها جداگانه به npm منتشر می‌شوند.

Package	What it does
@pantoken/aggregate	تولید بشکهٔ یکپارچهٔ pantoken و exports از وابستگی‌های آن.
@pantoken/validate-generated	دروازهٔ drift: بررسی می‌کند که هر stylesheet تولیدشده با IR توکن‌ها رزولوشن شود.
@pantoken/demo	رانر دمو زندهٔ خود میزبانی‌شده: یک مشخصهٔ @demo را به iframe رزولوشن می‌کند و HTML/CSS/JS خام هم‌مبدأ، با تم توکن را رندر می‌کند.
@cssdoc/core (external)	یک استخراج‌کنندهٔ مستندات CSS عمومی (TSDoc برای CSS): کامنت‌های doc و AST CSS را به مدلی تبدیل می‌کند که docs به‌عنوان مرجع CSS API منتشر می‌کنند. در یک مخزن جداگانه زندگی می‌کند؛ از طریق link dependency مصرف می‌شود.

@pantoken/validate-generated یک اسکریپت یک‌بار-اجرا است (توسط pnpm run ready فراخوانی می‌شود)، بنابراین صفحهٔ API ندارد؛ سایرین صفحهٔ API دارند.

هوش مصنوعی

دارایی‌های راه‌اندازی AI مناسب مصرف‌کننده. این‌ها برای پروژه‌هایی هستند که از pantoken استفاده می‌کنند، نه برای توسعهٔ خود pantoken.

• @pantoken/ai AGENTS.md, llms.txt و قوانین دستیار/ویرایشگر (Cursor, Copilot, Windsurf, Claude Code) را در یک مخزن مصرف‌کننده نصب می‌کند.

پلاگین‌های توسعه‌دهنده

پلاگین‌هایی که برای ابزارهایی که با آن‌ها کار می‌کنیم می‌نویسیم، بر اساس میزبان گروه‌بندی شده‌اند. این‌ها مستقل و قابل انتشار هستند.

Package	Plugs into
@pantoken/typedoc-plugin-demo	TypeDoc: یک تگ بلوک @demo <provider>:<ref> را به یک fence دموی قابل جاسازی تبدیل می‌کند.
@pantoken/vite-workspace-orchestrator	Vite: بسته‌های workspace upstream را (و وابستگانشان) هنگام تغییر سورس دوباره می‌سازد.