La mappa dei pacchetti

pantoken è un monorepo di piccoli pacchetti a scopo singolo raggruppati in bucket. Installa quello che si adatta al tuo compito, oppure installa il pacchetto unificato pantoken e importa dai suoi sotto-percorsi (ad esempio pantoken/css, pantoken/react, pantoken/tailwind).

Core

Il modello condiviso e il trasformatore su cui si costruisce tutto il resto.

Package	Cosa fa
@pantoken/model	Tipi TypeScript senza dipendenze: la forma Token e il contratto del plugin.
@pantoken/core	Risolve i token e le icone upstream nell'IR canonico e genera CSS.
@pantoken/tokens	L'IR risolto fornito come JSON statico, per tema, più la sorgente raw di Tokens Studio.
@pantoken/utils	Il risolutore di token, le regex per riferimenti, helper per case e colori, controlli di drift e gli emitter token→utility-class.
@pantoken/plugin-kit	Costruisci e componi plugin pantoken con definePlugin.
@pantoken/cli	pantoken generate <target> — emette sorgenti native e per piattaforma.

Formati

Trasforma i token in un formato di file.

Package	Output
@pantoken/css	CSS tipizzato @property con light-dark() e icone in data-URI.
@pantoken/scss	Variabili SCSS, risolte in una singola modalità.
@pantoken/less	Variabili Less.
@pantoken/stylus	Variabili Stylus.
@pantoken/dtcg	Un documento W3C Design Tokens (DTCG).
@pantoken/tokens	L'IR come JavaScript e JSON (anche elencato nella sezione Core).
@pantoken/icons	Una vista ergonomica sui token delle icone.
@pantoken/icon-font	Un web font di icone (TTF, WOFF2) più il suo CSS.
@pantoken/components	Una libreria di componenti CSS con aspetto InstUI (button, alert, table e altro) più un reset base con focus ring, stile per prose, utility cross-cutting e i font del brand. Vedi Components.

Renderer

Integrazioni per framework e strumenti.

Package	Per
@pantoken/react	Hook React, <Icon>, e un provider di token.
@pantoken/vue, @pantoken/svelte, @pantoken/angular	Il web component, collegato a ciascun framework.
@pantoken/react-native	Oggetti token adatti a StyleSheet (senza variabili CSS).
@pantoken/web-components	<instui-icon> e primitive stilizzate, agnostiche rispetto al framework.
@pantoken/astro	Setup dei token per siti Astro.
@pantoken/react-markdown, @pantoken/rehype	Token delle icone e campioni colore in Markdown.
@pantoken/markdown-it	Un plugin markdown-it per codici di icone e campioni colore.
@pantoken/css-in-js	Un tema type-safe per styled-components ed Emotion.
@pantoken/mui	Un tema per Material UI.
@pantoken/bootstrap, @pantoken/shadcn	Bridge di variabili CSS per Bootstrap e shadcn/ui.
@pantoken/foundation	Un override di impostazioni Sass e un overlay CSS per Foundation.
@pantoken/docusaurus, @pantoken/vitepress	Temi per Docusaurus e VitePress.
@pantoken/mintlify	Un tema Mintlify docs.json (colori + sfondo).
@pantoken/storybook	Un tema per Storybook.
@pantoken/pendo	CSS globale in stile Instructure per le guide Pendo.

Bundler

Integrazioni per tool di build.

Package	Per
@pantoken/vite	Un plugin Vite con moduli virtuali e injection CSS.
@pantoken/next	withPantoken per Next.js transpilePackages.
@pantoken/webpack	Un plugin per webpack.
@pantoken/postcss	L'at-rule @pantoken;.
@pantoken/tailwind	Un preset per Tailwind.
@pantoken/panda	Un preset per Panda CSS.

Piattaforme

Target nativi e per generatori di siti, emessi dalla CLI o dalla loro API.

Package	Output
@pantoken/swift	Sorgenti Swift più uno stub di manifest SwiftPM.
@pantoken/android	Risorse XML per Android.
@pantoken/compose	Jetpack Compose in Kotlin.
@pantoken/flutter	Flutter in Dart.
@pantoken/rust	const Rust per egui o iced.
@pantoken/wordpress	Un theme.json per tema WordPress.
@pantoken/vanilla	Un variables.json per Vanilla Forums.
@pantoken/drupal	Asset per tema Drupal.
@pantoken/hugo, @pantoken/jekyll	Dati per siti Hugo e Jekyll.
@pantoken/email	Valori adatti a email HTML inline.

Design

Per gli strumenti di design.

Package	Output
@pantoken/figma	Un payload Figma Variables.
@pantoken/swatches	Campioni colore (ASE, GPL, Sketch) più un foglio esemplificativo SVG visualizzabile.

Plugin

Trasformazioni opzionali che estendono l'output dei token o del CSS. Vedi Plugins.

Package	Cosa aggiunge
@pantoken/plugin-stacking	Profondità z-index nominate come token --instui-stacking-*.
@pantoken/plugin-visual-debug	L'outline di debug del layout -with-visual-debug.
@pantoken/plugin-simple-icons	Icone di brand da simple-icons.
@pantoken/plugin-logos	Loghi dei prodotti Instructure come SVG, data URI e token immagine.
@pantoken/plugin-prune-custom-props	Un plugin PostCSS che elimina le proprietà custom non usate.

Strumenti

Infrastruttura di build, docs e demo per il monorepo stesso. La maggior parte è interna, ma i pezzi sono autonomi, quindi li documentiamo qui e alcuni vengono pubblicati su npm separatamente.

Package	Cosa fa
@pantoken/aggregate	Genera il pacchetto unificato pantoken barrel e exports dalle sue dipendenze.
@pantoken/validate-generated	La gate di drift: verifica che ogni stylesheet generato si risolva contro l'IR dei token.
@pantoken/demo	Il runner demo self-hosted: risolve una spec @demo in un iframe e rende HTML/CSS/JS bare same-origin, a tema token.
@cssdoc/core (esterno)	Un estrattore generico di documentazione CSS (TSDoc, per CSS): parsifica i doc-comment e l'AST CSS in un modello che i docs emettono come riferimento API CSS. Risiede in un proprio repo; consumato come dipendenza linkata.

@pantoken/validate-generated è uno script run-once (invocato da pnpm run ready), quindi non ha pagina API; gli altri sì.

AI

Asset di setup AI orientati al consumatore. Questi sono per progetti che usano pantoken, non per sviluppare pantoken stesso.

• @pantoken/ai installa AGENTS.md, llms.txt e regole per assistant/editor (Cursor, Copilot, Windsurf, Claude Code) in un repository consumatore.

Dev plugin

Plugin che sviluppiamo per gli strumenti con cui lavoriamo, raggruppati per host. Sono standalone e pubblicabili.

Package	Si integra con
@pantoken/typedoc-plugin-demo	TypeDoc: trasforma un tag di blocco @demo <provider>:<ref> in una fence demo incorporabile.
@pantoken/vite-workspace-orchestrator	Vite: ricostruisce i pacchetti upstream del workspace (e i dipendenti) quando la loro sorgente cambia.