Skip to content

سازگاری ​

این صفحه منابع Instructure UI را ثبت می‌کند که این ساخت pantoken از آن‌ها استفاده می‌کند و مصرف‌کنندگانشان را مشخص می‌کند. نسخه‌های هدف جداگانه‌اند: فقط نسخه‌های تأییدشده اعلام می‌شوند و نسخه‌های جدیدتر از آخرین نسخهٔ تأییدشده باید بازبینی شوند. با vp run sync:compatibility آن را دوباره تولید کنید؛ بررسی gate:compatibility در صورت مغایرت شکست می‌خورد.

منابع بالادستی ​

توکن‌های طراحی، آیکون‌های سفارشی Instructure و فهرست Lucide، IR توکنِ حل‌شده‌ای را فراهم می‌کنند که همهٔ بسته‌ها از آن استفاده می‌کنند. بسته‌های React مربوط به @instructure/ui-* فقط توسط @pantoken/react-markdown استفاده می‌شوند.

بستهفراهم‌شده برایبازهنسخهٔ حل‌شده
@instructure/instructure-design-tokenstoken-irgithub:instructure/instructure-design-tokens#v2.1.0v2.1.0@c7f0deea242d
@instructure/ui-iconsicons^11.7.1011.7.10
lucideicons^1.75.01.75.0
@instructure/ui-headinginstui-react^11.7.1011.7.10
@instructure/ui-textinstui-react^11.7.1011.7.10
@instructure/ui-linkinstui-react^11.7.1011.7.10
@instructure/ui-listinstui-react^11.7.1011.7.10
@instructure/ui-tableinstui-react^11.7.1011.7.10
@instructure/ui-viewinstui-react^11.7.1011.7.10
@instructure/ui-imginstui-react^11.7.1011.7.10
@instructure/ui-alertsinstui-react^11.7.1011.7.10

مصرف‌کنندگان ​

بستهمسیرتحت نظارتِهدفقالب فعلینسخه‌های میزبان
@pantoken/nextbundlers/nexttoken-irNext.jsساخت Production که Instructure UI 11.7.10 را با React 19.3.0 ترجمه و رندر می‌کنداز 16.0.0 تا 16.4.6 (تأییدشده)
@pantoken/pandabundlers/pandatoken-irPanda CSSاستخراج ابزارهای توکن Panda از preset پنتوکناز 1.12.1 تا 2.5.0 (تأییدشده)
@pantoken/postcssbundlers/postcsstoken-irPostCSS—از 8.0.0 تا 8.5.32 (تأییدشده)
@pantoken/tailwindbundlers/tailwindtoken-irTailwind CSS—از 4.0.17 تا 4.3.5 (تأییدشده)
@pantoken/vitebundlers/vitetoken-irVite—از 8.0.0 تا 8.3.8 (تأییدشده)
@pantoken/webpackbundlers/webpacktoken-irwebpackدارایی CSS توکنِ تولیدشده در ساختاز 5.61.0 تا 5.112.2 (تأییدشده)
@pantoken/androidplatforms/androidtoken-irمنابع Androidرنگ‌ها، ابعاد و VectorDrawable تولیدشده با ابزارهای ساخت Android کامپایل و پیوند می‌شونداز API 35 / build-tools 35.0.0 تا API 35 / build-tools 35.0.0 (تأییدشده)
@pantoken/canvas-theme-editorplatforms/canvas-theme-editortoken-irویرایشگر تم Canvas—هنوز تأیید نشده
@pantoken/composeplatforms/composetoken-irJetpack Composeشیء توکن Color و Dp تولیدشده در ماژول کتابخانهٔ Android کامپایل می‌شوداز Kotlin 2.1.10 / Compose UI 1.8.2 / Android API 35 تا Kotlin 2.1.10 / Compose UI 1.8.2 / Android API 35 (تأییدشده)
@pantoken/drupalplatforms/drupaltoken-irتم‌های Drupalهستهٔ Drupal تم تولیدشده را شناسایی می‌کند؛ InfoParser و Symfony YAML فراداده را می‌پذیرنداز 10.6.18 تا 11.4.12 (تأییدشده)
@pantoken/emailplatforms/emailtoken-irایمیل HTML—هنوز تأیید نشده
@pantoken/flutterplatforms/fluttertoken-irFlutter—هنوز تأیید نشده
@pantoken/hugoplatforms/hugotoken-irHugoHugo Pipes شیوه‌نامهٔ توکن پنتوکن را می‌سازداز 0.165.0 تا 0.165.0 (تأییدشده)
@pantoken/jekyllplatforms/jekylltoken-irJekyllJekyll بخش Sass تولیدشده را به CSS سایت می‌سازداز 3.9.4 تا 4.4.1 (تأییدشده)
@pantoken/rustplatforms/rusttoken-irچارچوب‌های GUI زبان Rustدسترسی‌دهنده‌های Color32 تولیدشده برای egui و ثابت‌های Color در iced_core با ابزارهای Rust کامپایل می‌شونداز 1.95.0 تا 1.95.0 (تأییدشده)
@pantoken/swiftplatforms/swifttoken-irSwift iOSماژول UIKit SwiftPM، بررسی زمان اجرا برای توکن و Icons.xcassets کامپایل‌شدهمحیط آزمایش‌شده: Xcode 27.0 (27A266a), Swift 6.4, iOS Simulator SDK/runtime 27.0, iPhone 18 Pro, arm64 iOS 15 deployment target. زمان اجرا فقط روی iOS Simulator 27.0 آزمایش شده است؛ این موضوع حداقل نسخهٔ زمان اجرای iOS 15 را اثبات نمی‌کند. ادعایی دربارهٔ watchOS یا tvOS مطرح نمی‌شود.
@pantoken/vanillaplatforms/vanillatoken-irVanilla Forums—هنوز تأیید نشده
@pantoken/wordpressplatforms/wordpresstoken-irتم‌های بلوکی WordPresstheme.json v3از 6.6 تا 7.1.4 (تأییدشده)
@pantoken/angularrenderers/angulartoken-irAngularکامپایل قالب CUSTOM_ELEMENTS_SCHEMA (Angular 16.2.12 / TS 5.1.6؛ Angular 22.2.0، 22.2.1 و 22.2.2 / TS 6.0.3)از 22.2.0 تا 22.2.5 (تأییدشده)
@pantoken/astrorenderers/astrotoken-irAstro / Starlightصفحهٔ ساخته‌شدهٔ Starlight با شیوه‌نامهٔ توکن تزریق‌شده (Astro 5 و 7)از 0.35.0 تا 0.42.6 (تأییدشده)
@pantoken/bootstraprenderers/bootstraptoken-irBootstrapمتغیرهای CSS: بدنه و دکمهٔ اصلیاز 5.2.0 تا 5.3.9 (تأییدشده)
@pantoken/css-in-jsrenderers/css-in-jstoken-irCSS-in-JS با EmotionThemeProvider در SSR متغیر توکن پنتوکن را تولید می‌کنداز 11.14.0 تا 11.14.0 (تأییدشده)
@pantoken/docusaurusrenderers/docusaurustoken-irtheme-classic در Docusaurusپل متغیرهای CSS مربوط به Infima: رنگ اصلی و پس‌زمینهاز 3.0.0 تا 3.10.2 (تأییدشده)
@pantoken/foundationrenderers/foundationtoken-irFoundation for Sitesتنظیمات Sass مشخص + لایهٔ CSS مبتنی بر متغیرهااز 6.1.2 تا 6.9.0 (تأییدشده)
@pantoken/markdown-itrenderers/markdown-ittoken-irmarkdown-it—از 14.0.0 تا 15.0.3 (تأییدشده)
@pantoken/mintlifyrenderers/mintlifytoken-irdocs.json در MintlifyCLI رسمی، رنگ‌های تولیدشده و پیکربندی تم پس‌زمینه را اعتبارسنجی می‌کنداز 4.0.1555 تا 4.0.1614 (تأییدشده)
@pantoken/muirenderers/muitoken-irMaterial UIپالت‌های مشخص createTheme (MUI 5، 6، 7، 9)از 7.0.0 تا 9.5.0 (تأییدشده)
@pantoken/pendorenderers/pendotoken-irPendo—هنوز تأیید نشده
@pantoken/reactrenderers/reacttoken-irReactعنصر سفارشی Icon رندرشده در SSR و جایگزین توکناز 19.3.0 تا 19.3.1 (تأییدشده)
@pantoken/react-markdownrenderers/react-markdowninstui-reactreact-markdownسرصفحه، آیکون و نمونه‌رنگ InstUI رندرشده در SSR با React 19.3.0از 9.1.0 تا 10.1.0 (تأییدشده)
@pantoken/react-nativerenderers/react-nativetoken-irReact Native—هنوز تأیید نشده
@pantoken/rehyperenderers/rehypetoken-irrehypeHAST + SVG خاماز 13.0.0 تا 13.0.2 (تأییدشده)
@pantoken/shadcnrenderers/shadcntoken-irمتغیرهای CSS در shadcn/uiTailwind 4.3.3 نام مستعار تم اصلی پنتوکن را کامپایل می‌کنداز 4.3.3 تا 4.3.5 (تأییدشده)
@pantoken/storybookrenderers/storybooktoken-irتم‌سازی Storybookسازندهٔ ThemeVars در Storybook تم‌های روشن و تیرهٔ پنتوکن را می‌پذیرداز 8.6.14 تا 8.6.19 (تأییدشده)
@pantoken/svelterenderers/sveltetoken-irSvelteکامپوننت action آیکون کامپایل می‌شود و در Svelte 4 و 5 در SSR رندر می‌شوداز 4.2.20 تا 5.57.3 (تأییدشده)
@pantoken/tinymcerenderers/tinymcetoken-irTinyMCE PluginManagerثبت افزونهٔ پنتوکن و مقداردهی اولیهٔ callbackاز 8.9.2 تا 8.10.2 (تأییدشده)
@pantoken/vitepressrenderers/vitepresstoken-irVitePressCSS سایت ساخته‌شده شامل پل برند اصلی پنتوکن استاز 1.6.4 تا 1.6.4 (تأییدشده)
@pantoken/vuerenderers/vuetoken-irVueنصب افزونه، پیکربندی عناصر سفارشی و خروجی SSRاز 3.0.0 تا 3.5.45 (تأییدشده)
@pantoken/web-componentsrenderers/web-componentstoken-irWeb Componentsثبت عنصر سفارشی و خروجی سایه‌ای دکمهمحیط آزمایش‌شده: Node 26.10.0 with happy-dom 20.14.5. رندر و رفتار تعاملی در مرورگر واقعی تأیید نشده‌اند.

بازبینی نسخه‌های هدف ​

گردش‌کار هفتگی نسخه‌های هدف، برای نسخه‌های پایدار جدید WordPress و اکوسیستم‌هایی که peer صریح npm دارند، یک issue بازبینی ایجاد می‌کند. برای هدف‌های دیگر، نگه‌دارندگان هر هفته یادداشت‌های انتشار رسمی پلتفرم را بررسی می‌کنند و به‌صورت دستی issue بازبینی باز می‌کنند؛ نبودن issue به این معنی نیست که نسخهٔ جدید پشتیبانی می‌شود. برای گسترش یک ادعا:

  1. طرح‌وارهٔ خروجی یا تغییرات یکپارچه‌سازی نسخه و adapter این جدول را بررسی کنید.
  2. فرمان سازگاری adapter را با نسخهٔ پیشنهادی اجرا کنید؛ برای نمونه vp run @pantoken/postcss#check:compatibility -- 8.5.29. فرمان پیش‌فرض همهٔ ورودی‌های testedVersions را از این رجیستری می‌خواند؛ محیط‌های جفت‌شده پرچم‌های همراه خود را می‌پذیرند.
  3. برای گزینه‌هایی که از فید شناسایی شده‌اند، از vp run downstream:test استفاده کنید؛ تلاش‌های ناموفق در scripts/release/downstream-compatibility.json نگه داشته می‌شوند. پس از بازبینی موفق، برای به‌روزرسانی ادعا vp run downstream:bless --package @pantoken/name --version x.y.z را اجرا کنید.
  4. بررسی یک میزبان واقعی، کامپایلر یا ابزار ساخت را روی حداقل نسخه و نسخهٔ جدید اجرا کنید. در صورت نیاز، قالب خروجی فعلی را نگاشت کنید؛ emitterهای موازی برای قالب‌های قدیمی اضافه نکنید.
  5. فقط پس از موفقیت بررسی‌ها، scripts/release/target-compatibility.json را به‌روزرسانی کنید؛ سپس vp run sync:compatibility را اجرا کنید، مستندات API انگلیسی را دوباره تولید کنید و یک changeset اضافه کنید. نسخه‌های جدیدتر تا زمان ادغام تغییر بازبینی‌شده در انتظار می‌مانند. مستندات محلی‌سازی‌شده جداگانه مدیریت می‌شوند.

منسوخ‌شدن‌ها ​

توکن‌هایی که در بالادست حذف شده‌اند اما pantoken همچنان به‌عنوان لایهٔ سازگاری عرضه می‌کند. هرکدام تا زمان پذیرفته‌شدن نسخهٔ جزئی بالادستیِ Removed in فعال می‌مانند؛ سپس لایهٔ سازگاری حذف و یک نسخهٔ جزئی برای مصرف‌کننده منتشر می‌شود. لایهٔ سازگاری یا به یک توکن Replacement ارجاع می‌دهد یا آخرین مقدار شناخته‌شدهٔ آن را ثابت نگه می‌دارد.

توکنمنسوخ‌شده درحذف‌شده درجایگزین
--instui-component-side-nav-bar-new-insitution-logo-gapui@11.7.7ui@11.8.0--instui-component-side-nav-bar-new-institution-logo-gap
--instui-component-side-nav-bar-new-insitution-logo-paddingui@11.7.7ui@11.8.0--instui-component-side-nav-bar-new-institution-logo-padding
--instui-icon-angryui@11.7.6ui@11.8.0مقدار ثابت‌شده
--instui-icon-annoyedui@11.7.6ui@11.8.0مقدار ثابت‌شده
--instui-icon-frownui@11.7.6ui@11.8.0مقدار ثابت‌شده
--instui-icon-historyui@11.7.6ui@11.8.0--instui-icon-rotate-ccw-clock
--instui-icon-laughui@11.7.6ui@11.8.0مقدار ثابت‌شده
--instui-icon-mehui@11.7.6ui@11.8.0مقدار ثابت‌شده
--instui-icon-podcastui@11.7.6ui@11.8.0مقدار ثابت‌شده
--instui-icon-smileui@11.7.6ui@11.8.0مقدار ثابت‌شده
--instui-icon-smile-plusui@11.7.6ui@11.8.0مقدار ثابت‌شده
--instui-icon-trash-2ui@11.7.6ui@11.8.0مقدار ثابت‌شده

آخرین به‌روزرسانی: