Карта пакетов

pantoken — это монорепозиторий небольших, одноцельных пакетов, сгруппированных по корзинам. Установите тот, который подходит для вашей задачи, или установите единый пакет pantoken и импортируйте из его подпутей (например pantoken/css, pantoken/react, pantoken/tailwind).

Ядро

Общая модель и трансформер, на котором строится всё остальное.

Пакет	Что делает
@pantoken/model	Типы TypeScript без зависимостей: форма Token и контракт плагина.
@pantoken/core	Разрешает upstream токены и иконки в канонический IR и рендерит CSS.
@pantoken/tokens	Разрешённый IR, поставляемый как статический JSON по теме, плюс исходник Tokens Studio.
@pantoken/utils	Разрешатель токенов, regex-ы ссылок, помощники для регистра и цветов, проверки дрейфа и эмиттеры token→utility-class.
@pantoken/plugin-kit	Сборка и компоновка плагинов pantoken с definePlugin.
@pantoken/cli	pantoken generate <target> — эмитирует нативные и платформенные исходники.

Форматы

Преобразуют токены в файл формата.

Пакет	Выход
@pantoken/css	CSS, типизированный под @property с light-dark() и иконками в 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 (button, alert, table и др.) плюс базовый reset с focus ring, стилизацией prose, кросс-утилитами и фирменными шрифтами. См. Components.

Рендереры

Интеграции с фреймворками и инструментами.

Пакет	Для
@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	Типобезопасная тема для 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-гайдов.

Бандлеры

Интеграции с инструментами сборки.

Пакет	Для
@pantoken/vite	Плагин для Vite с виртуальными модулями и инъекцией CSS.
@pantoken/next	withPantoken для Next.js transpilePackages.
@pantoken/webpack	Плагин для webpack.
@pantoken/postcss	Ат-правило @pantoken;.
@pantoken/tailwind	Пресет для Tailwind.
@pantoken/panda	Пресет для Panda CSS.

Платформы

Нативные цели и генераторы сайтов, эмитируемые CLI или их собственным API.

Пакет	Выход
@pantoken/swift	Swift-исходники плюс заготовка SwiftPM.
@pantoken/android	Ресурсы Android XML.
@pantoken/compose	Jetpack Compose на Kotlin.
@pantoken/flutter	Flutter на Dart.
@pantoken/rust	Rust-константы для egui или iced.
@pantoken/wordpress	Тема блоков WordPress theme.json.
@pantoken/vanilla	Данные для Vanilla Forums variables.json.
@pantoken/drupal	Ассеты темы Drupal.
@pantoken/hugo, @pantoken/jekyll	Данные сайтов для Hugo и Jekyll.
@pantoken/email	Значения, пригодные для inline в HTML-письмах.

Дизайн

Для инструментов дизайна.

Пакет	Выход
@pantoken/figma	Пейлоад Figma Variables.
@pantoken/swatches	Цветовые образцы (ASE, GPL, Sketch) плюс обозримый SVG-образец.

Плагины

Опциональные преобразования, расширяющие вывод токенов или CSS. См. Plugins.

Пакет	Что добавляет
@pantoken/plugin-stacking	Именованные глубины z-index как токены --instui-stacking-*.
@pantoken/plugin-visual-debug	Отладочную обводку макета -with-visual-debug.
@pantoken/plugin-simple-icons	Брендовые иконки из simple-icons.
@pantoken/plugin-logos	Логотипы продуктов Instructure в виде SVG, data URI и image-токенов.
@pantoken/plugin-prune-custom-props	PostCSS-плагин, удаляющий неиспользуемые custom properties.

Инструменты

Инфраструктура сборки, доков и демо для самого монорепозитория. Большая часть внутреняя, но части автономны и описаны здесь; некоторые публикуются в npm отдельно.

Пакет	Что делает
@pantoken/aggregate	Генерирует единый баррель пакета pantoken и exports из его зависимостей.
@pantoken/validate-generated	Ворота дрейфа: проверяет, что каждая сгенерированная таблица стилей разрешается относительно IR токенов.
@pantoken/demo	Самохостящийся раннер демо: разрешает спецификацию @demo в iframe и рендерит голый HTML/CSS/JS same-origin, тематизированный токенами.
@cssdoc/core (внешний)	Общий извлекатель документации CSS (TSDoc, для CSS): парсит doc-комментарии + AST CSS в модель, которую доки эмитируют как справочник CSS API. Живёт в отдельном репозитории; потребляется как link-зависимость.

@pantoken/validate-generated — это скрипт однократного запуска (вызывается pnpm run ready), поэтому у него нет страницы API; у остальных страницы есть.

AI

Пользовательские AI-ассеты. Предназначены для проектов, использующих pantoken, а не для разработки pantoken.

• @pantoken/ai устанавливает AGENTS.md, llms.txt и правила ассистента/редактора (Cursor, Copilot, Windsurf, Claude Code) в репозитории потребителя.

Dev-плагины

Плагины, которые пишутся для инструментов, с которыми мы работаем, сгруппированные по хосту. Они автономны и публикуемы.

Пакет	Встраивается в
@pantoken/typedoc-plugin-demo	TypeDoc: превращает блок-тег @demo <provider>:<ref> в встраиваемый демо-fence.
@pantoken/vite-workspace-orchestrator	Vite: перестраивает upstream workspace пакеты (и зависимые) при изменении их исходников.