Skip to content

A csomagtérkép

A pantoken egy monorepo, amely apró, egy célra szolgáló csomagokból áll, csoportokba rendezve. Telepítsd azt, amelyik a feladatodhoz illik, vagy telepítsd az egyesített pantoken csomagot, és importálj annak alútvonalaiból (például pantoken/css, pantoken/react, pantoken/tailwind).

Mag

A közös modell és a transzformer, amelyre minden más épül.

CsomagMit csinál
@pantoken/modelFüggőség nélküli TypeScript típusok: a Token alakja és a plugin-szerződés.
@pantoken/coreA feljebb lévő tokeneket és ikonokat feloldja a kanonikus IR-be, és CSS-t renderel.
@pantoken/tokensA feloldott IR statikus JSON-ként csomagolva, témánként, valamint a nyers Tokens Studio forrás.
@pantoken/utilsA token-feloldó, hivatkozási reguláris kifejezések, kis- és nagybetűs, valamint színsegédek, drift-ellenőrzések és a token→segédosztály-kibocsátók.
@pantoken/plugin-kitPantoken pluginok építése és összeállítása definePlugin segítségével.
@pantoken/clipantoken generate <target> — natív és platformforrás kibocsátása.

Formátumok

Alakítsd át a tokeneket egy fájlformátumra.

CsomagKimenet
@pantoken/css@property-típusos CSS light-dark() és data-URI ikonokkal.
@pantoken/scssSCSS változók, egyetlen módra feloldva.
@pantoken/lessLess változók.
@pantoken/stylusStylus változók.
@pantoken/dtcgEgy W3C Design Tokens (DTCG) dokumentum.
@pantoken/tokensAz IR JavaScriptként és JSON-ként (a Mag alatt is szerepel).
@pantoken/iconsEgy ergonomikus nézet az ikon-tokenek felett.
@pantoken/icon-fontEgy ikon webfont (TTF, WOFF2) a hozzá tartozó CSS-sel.
@pantoken/componentsEgy InstUI-megjelenésű CSS komponenskönyvtár (button, alert, table és mások), valamint egy alap reset fókuszgyűrűvel, prose-stílussal, keresztmetszeti segédosztályokkal és a márka betűtípusokkal. Lásd: Komponensek.

Renderelők

Keretrendszer- és eszközintegrációk.

CsomagMihez
@pantoken/reactReact hookok, <Icon> és egy token-provider.
@pantoken/vue, @pantoken/svelte, @pantoken/angularA webkomponens, minden keretrendszerhez bekötve.
@pantoken/react-nativeStyleSheet-barát token-objektumok (CSS változók nélkül).
@pantoken/web-components<instui-icon> és stílusozott primitívek, keretrendszer-független.
@pantoken/astroToken-beállítás Astro oldalakhoz.
@pantoken/react-markdown, @pantoken/rehypeIkon-tokenek és színminták Markdownban.
@pantoken/markdown-itEgy markdown-it plugin ikonkódokhoz és színmintákhoz.
@pantoken/css-in-jsEgy típusbiztos téma styled-componentshez és Emotionhöz.
@pantoken/muiEgy Material UI téma.
@pantoken/bootstrap, @pantoken/shadcnCSS-változó hidak Bootstraphoz és shadcn/ui-hoz.
@pantoken/foundationSass-beállítás felülírás és CSS-réteg a Foundationhöz.
@pantoken/docusaurus, @pantoken/vitepressTémák Docusaurushoz és VitePresshez.
@pantoken/mintlifyEgy Mintlify docs.json téma (színek + háttér).
@pantoken/storybookEgy Storybook téma.
@pantoken/pendoInstructure-stílusú globális CSS Pendo útmutatókhoz.

Bundler-ek

Build-eszköz integrációk.

CsomagMihez
@pantoken/viteEgy Vite plugin virtuális modulokkal és CSS-injekcióval.
@pantoken/nextwithPantoken Next.js transpilePackages számára.
@pantoken/webpackEgy webpack plugin.
@pantoken/postcssA @pantoken; at-szabály.
@pantoken/tailwindEgy Tailwind preset.
@pantoken/pandaEgy Panda CSS preset.

Platformok

Natív és oldalgenerátor célok, amelyeket a CLI vagy a saját API-juk bocsát ki.

CsomagKimenet
@pantoken/swiftSwift forrás egy SwiftPM manifest-csonkkal.
@pantoken/androidAndroid XML erőforrások.
@pantoken/composeJetpack Compose Kotlin.
@pantoken/flutterFlutter Dart.
@pantoken/rustRust constok egui-hoz vagy iced-hez.
@pantoken/wordpressEgy WordPress blokk-téma theme.json.
@pantoken/vanillaEgy Vanilla Forums variables.json.
@pantoken/drupalDrupal téma-eszközök.
@pantoken/hugo, @pantoken/jekyllHugo és Jekyll oldal-adatok.
@pantoken/emailInline-barát értékek HTML e-mailhez.

Design

Tervezőeszközökhöz.

CsomagKimenet
@pantoken/figmaEgy Figma Variables payload.
@pantoken/swatchesSzínminták (ASE, GPL, Sketch), valamint egy megtekinthető SVG mintalap.

Pluginok

Opcionális transzformációk, amelyek kiterjesztik a token- vagy CSS-kimenetet. Lásd: Pluginok.

CsomagMit ad hozzá
@pantoken/plugin-stackingElnevezett z-index mélységek tokenként + .instui-stack-* osztályok.
@pantoken/plugin-visual-debugA -with-visual-debug elrendezés-hibakereső körvonal.
@pantoken/plugin-simple-iconsMárkaikonok a simple-icons csomagból.
@pantoken/plugin-logosInstructure termék-logók SVG-ként, data URI-ként és képi tokenként.
@pantoken/plugin-prune-custom-propsEgy PostCSS plugin, amely eltávolítja a nem használt egyéni tulajdonságokat.

Eszközök

Build-, dokumentációs és demó-infrastruktúra magához a monorepohoz. A legtöbb belső használatra van, de a darabok önállóak, így itt dokumentáljuk őket, és néhány önmagában is elérhető az npm-en.

CsomagMit csinál
@pantoken/aggregateGenerálja az egyesített pantoken csomag-barrelt és exports a függőségeiből.
@pantoken/validate-generatedA drift-kapu: ellenőrzi, hogy minden generált stíluslap feloldódik a token IR-hez képest.
@pantoken/demoA saját üzemeltetésű élő-demó futtató: feloldja a @demo specifikációt egy iframe-be, és nyers HTML/CSS/JS-t renderel same-origin módon, token-témával.
@cssdoc/core (külső)Egy általános CSS-dokumentáció-kinyerő (TSDoc, de CSS-hez): a doc-kommenteket + a CSS AST-t egy modellbe elemzi, amelyet a dokumentáció CSS API-referenciaként bocsát ki. Saját repóban él; link-függőségen keresztül használjuk.

A @pantoken/validate-generated egy egyszer futó szkript (a pnpm run ready hívja meg), így nincs API-oldala; a többinek van.

Dev pluginok

Pluginok, amelyeket az általunk használt eszközökhöz írunk, host szerint csoportosítva. Önállóak és publikálhatók.

CsomagMihez csatlakozik
@pantoken/typedoc-plugin-demoTypeDoc: egy @demo <provider>:<ref> blokk-taget beágyazható demó-kerítéssé alakít.
@pantoken/vite-workspace-orchestratorVite: újraépíti a feljebb lévő workspace-csomagokat (és a rájuk épülőket), amikor a forrásuk megváltozik.