A csomagtérkép
A pantoken kisméretű, egyetlen célt szolgáló csomagok monorepója, kategóriákba csoportosítva. Telepítsd azt, amelyik illik a feladatodhoz, vagy telepítsd az egységes pantoken csomagot, és importálj annak alútvonalaiból (például pantoken/css, pantoken/react, pantoken/tailwind).
Core
A megosztott modell és a transzformátor, amelyre minden más épül.
| Csomag | Mit csinál |
|---|---|
@pantoken/model | Függőségmentes TypeScript típusok: a Token struktúra és a plugin-szerződés. |
@pantoken/core | Feloldja a forrás (upstream) tokeneket és ikonokat a kanonikus IR-be, és CSS-t renderel. |
@pantoken/tokens | A feloldott IR statikus JSON-ként szállítva, témánként, valamint a nyers Tokens Studio forrás. |
@pantoken/utils | A tokenfeloldó, referencia-regexek, kis-/nagybetű és szín segédfunkciók, drift-ellenőrzések és a token→utility-osztály kibocsátók. |
@pantoken/plugin-kit | pantoken pluginok készítése és összeállítása a definePlugin segítségével. |
@pantoken/cli | pantoken generate <target> — natív és platform forráskód generálása. |
Formátumok
Alakítsd a tokeneket fájlformátummá.
| Csomag | Kimenet |
|---|---|
@pantoken/css | @property-típusú CSS light-dark()-vel és data-URI ikonokkal. |
@pantoken/scss | SCSS változók, egyetlen módra feloldva. |
@pantoken/less | Less változók. |
@pantoken/stylus | Stylus változók. |
@pantoken/dtcg | Egy W3C Design Tokens (DTCG) dokumentum. |
@pantoken/tokens | Az IR JavaScript és JSON formátumban (a Core alatt is szerepel). |
@pantoken/icons | Ergonomikus nézet az ikontokenekhez. |
@pantoken/icon-font | Egy ikon webbetűtípus (TTF, WOFF2) és a hozzá tartozó CSS. |
@pantoken/components | Egy InstUI-megjelenésű CSS komponenskönyvtár (gomb, alert, táblázat és egyebek), valamint egy alap reset fókuszgyűrűvel, szövegstílusokkal, átfogó segédeszközökkel és a márka betűtípusaival. Lásd: Komponensek. |
Rendererek
Keretrendszer- és eszközintegrációk.
| Csomag | Rendeltetés |
|---|---|
@pantoken/react | React hookok, <Icon>, és egy token provider. |
@pantoken/vue, @pantoken/svelte, @pantoken/angular | A webes komponens, az egyes keretrendszerekbe bekötve. |
@pantoken/react-native | StyleSheet-barát tokenobjektumok (CSS változók nélkül). |
@pantoken/web-components | <instui-icon> és stílusozott primitívek, keretrendszer-függetlenül. |
@pantoken/astro | Token-beállítás Astro webhelyekhez. |
@pantoken/react-markdown, @pantoken/rehype | Ikontokenek és színminták Markdownban. |
@pantoken/markdown-it | Egy markdown-it plugin ikonkódokhoz és színmintákhoz. |
@pantoken/css-in-js | Típusbiztos téma a styled-components-hez és az Emotionhöz. |
@pantoken/mui | Material UI téma. |
@pantoken/bootstrap, @pantoken/shadcn | CSS-változó hidak Bootstraphez és shadcn/ui-hoz. |
@pantoken/foundation | Sass beállítás-felülbírálás és CSS overlay a Foundationhöz. |
@pantoken/docusaurus, @pantoken/vitepress | Témák Docusaurushoz és VitePresshez. |
@pantoken/mintlify | Mintlify docs.json téma (színek + háttér). |
@pantoken/storybook | Storybook téma. |
@pantoken/pendo | Instructure-stílusú globális CSS a Pendo útmutatókhoz. |
Bundlerek
Build-eszköz integrációk.
| Csomag | Rendeltetés |
|---|---|
@pantoken/vite | Vite plugin virtuális modulokkal és CSS-injektálással. |
@pantoken/next | withPantoken a Next.js transpilePackages-hoz. |
@pantoken/webpack | Webpack plugin. |
@pantoken/postcss | A @pantoken; at-szabály. |
@pantoken/tailwind | Tailwind preset. |
@pantoken/panda | Panda CSS preset. |
Platformok
Natív és oldalgenerátor célplatformok, amelyeket a CLI vagy a saját API-juk bocsát ki.
| Csomag | Kimenet |
|---|---|
@pantoken/swift | Swift forráskód plusz egy SwiftPM jegyzékfájl csonk. |
@pantoken/android | Android XML erőforrások. |
@pantoken/compose | Jetpack Compose Kotlin. |
@pantoken/flutter | Flutter Dart. |
@pantoken/rust | Rust konstansok egui-hoz vagy iced-hez. |
@pantoken/wordpress | WordPress blokktéma theme.json. |
@pantoken/vanilla | Vanilla Forums variables.json. |
@pantoken/drupal | Drupal téma assetek. |
@pantoken/hugo, @pantoken/jekyll | Hugo és Jekyll webhelyadatok. |
@pantoken/email | Inline-barát értékek HTML e-mailekhez. |
Design
Dizájneszközökhöz.
| Csomag | Kimenet |
|---|---|
@pantoken/figma | Figma Variables adatcsomag. |
@pantoken/swatches | Színminták (ASE, GPL, Sketch) és egy megtekinthető SVG mintalap. |
Pluginok
Opcionális transzformációk, amelyek kibővítik a token- vagy CSS-kimenetet. Lásd: Plugins.
| Csomag | Mit ad hozzá |
|---|---|
@pantoken/plugin-stacking | Elnevezett z-index mélységek --instui-stacking-* tokenekként. |
@pantoken/plugin-visual-debug | A -with-visual-debug elrendezés-hibakereső körvonal. |
@pantoken/plugin-simple-icons | Márkaikonok a simple-icons-ból. |
@pantoken/plugin-logos | Instructure terméklogók SVG-ként, data URI-ként és képtokenként. |
@pantoken/plugin-prune-custom-props | Egy PostCSS plugin, amely eldobja a nem használt egyéni tulajdonságokat. |
Eszközök
Build-, dokumentációs és demóinfrastruktúra magához a monorepóhoz. A legtöbb belső használatú, de az elemek önállóak, ezért itt dokumentáljuk őket, és néhány önállóan is megjelenik az npm-en.
| Csomag | Mit csinál |
|---|---|
@pantoken/aggregate | Legenerálja az egységes pantoken csomag barreljét és a(z) exports-t a függőségeiből. |
@pantoken/validate-generated | A drift kapu: ellenőrzi, hogy minden generált stíluslap feloldható-e a token IR alapján. |
@pantoken/demo | A saját üzemeltetésű élő demó futtató: felold egy @demo specifikációt egy iframe-be, és tiszta HTML/CSS/JS-t renderel azonos eredettel (same-origin), token-témázva. |
@cssdoc/core (external) | Egy általános CSS-dokumentáció kivonatoló (TSDoc, CSS-hez): elemzi a doc-kommentárokat + a CSS AST-ot egy olyan modellbe, amelyet a dokumentáció CSS API-referenciaként bocsát ki. Saját repójában él; link függőségként van felhasználva. |
A(z) @pantoken/validate-generated egy egyszer futtatandó script (amelyet a(z) pnpm run ready hív meg), így nincs API-oldala; a többinek viszont van.
AI
Felhasználók számára készült AI-beállítási kellékek (assets). Ezek olyan projektekhez valók, amelyek a pantokent használják, nem pedig magának a pantokennek a fejlesztéséhez.
@pantoken/aitelepíti a(z)AGENTS.md,llms.txtelemeket és az asszisztens-/szerkesztőszabályokat (Cursor, Copilot, Windsurf, Claude Code) a felhasználói repóba.
Fejlesztői pluginok
Olyan pluginok, amelyeket az általunk használt eszközökhöz készítünk, host szerint csoportosítva. Önállóak és közzétehetők.
| Csomag | Ide épül be |
|---|---|
@pantoken/typedoc-plugin-demo | TypeDoc: a(z) @demo <provider>:<ref> blokkcímkét beágyazható demó blokká alakítja át. |
@pantoken/vite-workspace-orchestrator | Vite: újraépíti a felsőbb szintű workspace csomagokat (és a függőségeket), amikor megváltozik a forrásuk. |