Skip to content

Léarscáil an phacáiste

Is monorepo é pantoken de phacáistí beaga aon-úsáide atá grúpáilte i mbucáidí. Suiteáil an ceann a oireann do do thasc, nó suiteáil an pacáiste comhtháite pantoken agus iompórtáil óna fho-phasáistí (mar shampla pantoken/css, pantoken/react, pantoken/tailwind).

Lár

An tsamhail roinnte agus an t-aistriúchán ar a bhforbraíonn gach rud eile.

PacáisteCad a dhéanann sé
@pantoken/modelCineálacha TypeScript gan spleáchas: foirm Token agus conradh an chlóisín (plugin).
@pantoken/coreRéitíonn na ticéid agus na siombailí upstream isteach sa IR caighdeánach, agus déanann sé CSS a ghiniúint.
@pantoken/tokensAn IR réitithe a sholáthraítear mar JSON statach, in aghaidh téama, chomh maith leis an bhfoinse Tokens Studio bhunúsach.
@pantoken/utilsAn réititheoir token, nathanna rialacha tagartha, cúnamh do chás agus dath, seiceálacha drifte, agus an chruthú token→rannóg-úsaide.
@pantoken/plugin-kitTóg agus comhlánaigh breiseáin pantoken le definePlugin.
@pantoken/clipantoken generate <target> — astaítear foinse dúchais agus ardán.

Formáidí

Casann na ticéid isteach i bhformáid comhaid.

PacáisteAschur
@pantoken/cssCSS dathaithe de réir @property le light-dark() agus siombailí data-URI.
@pantoken/scssAthróg SCSS, réitithe go mód aonair.
@pantoken/lessAthróg Less.
@pantoken/stylusAthróg Stylus.
@pantoken/dtcgDoiciméad W3C Design Tokens (DTCG).
@pantoken/tokensAn IR mar JavaScript agus JSON (liostaithe freisin faoi Lár).
@pantoken/iconsAmharc éifeachtach thar na ticéid íocón.
@pantoken/icon-fontCló gréasáin íocón (TTF, WOFF2) lena CSS.
@pantoken/componentsLeabharlann chomhpháirteanna CSS le cuma InstUI (cnaipe, rabhaidh, tábla, agus níos mó) chomh maith le socrú bun-reset le fáinne fócas, stíliú próise, uirlisí tras-gannta, agus na clónna branda. Féach Comhpháirteanna.

Rianálaithe (Renderers)

Comhtháthú le haistrithe agus uirlisí.

PacáisteChuige
@pantoken/reactGreamáin React (hooks), <Icon>, agus soláthraí ticéid.
@pantoken/vue, @pantoken/svelte, @pantoken/angularAn chomhpháirt ghréasáin, ceangailte le gach fráma oibre.
@pantoken/react-nativeOjetoí ticéid réidh do StyleSheet (gan athróga CSS).
@pantoken/web-components<instui-icon> agus praimréidí stíleáilte, neamhspleách ar fráma oibre.
@pantoken/astroSocrú ticéad do shuímh Astro.
@pantoken/react-markdown, @pantoken/rehypeTicéid íocón agus swatches i Markdown.
@pantoken/markdown-itBreiseán markdown-it do chód íocón agus scáileáin datha.
@pantoken/css-in-jsTéama sábháilte cineál do styled-components agus Emotion.
@pantoken/muiTéama Material UI.
@pantoken/bootstrap, @pantoken/shadcnDroichid athróga CSS do Bootstrap agus shadcn/ui.
@pantoken/foundationSainroghnóireacht Sass agus cúntóir CSS do Foundation.
@pantoken/docusaurus, @pantoken/vitepressTéamaí do Docusaurus agus VitePress.
@pantoken/mintlifyTéama Mintlify docs.json (dathanna + cúlra).
@pantoken/storybookTéama Storybook.
@pantoken/pendoCSS domhanda i stíl Instructure do threoracha Pendo.

Pacáistí tógála (Bundlers)

Comhtháthú uirlis tógála.

PacáisteChuige
@pantoken/viteBreiseán Vite le modúil fíorúil agus instealladh CSS.
@pantoken/nextwithPantoken do Next.js transpilePackages.
@pantoken/webpackBreiseán webpack.
@pantoken/postcssAn r-leagan @pantoken;.
@pantoken/tailwindRéamhshocrú Tailwind.
@pantoken/pandaRéamhshocrú Panda CSS.

Ardáin

Spriocanna dúchais agus gineadóirí suíomh, a astaítear ag an CLI nó a bhfuil a n-API féin acu.

PacáisteAschur
@pantoken/swiftFoinse Swift agus stob manifest SwiftPM.
@pantoken/androidAcmhainní XML Android.
@pantoken/composeJetpack Compose Kotlin.
@pantoken/flutterFlutter Dart.
@pantoken/rustConsts Rust do egui nó iced.
@pantoken/wordpressBloc-théama WordPress theme.json.
@pantoken/vanillaSonraí do Vanilla Forums variables.json.
@pantoken/drupalAcmhainní téama Drupal.
@pantoken/hugo, @pantoken/jekyllSonraí suíomh do Hugo agus Jekyll.
@pantoken/emailLuachanna inléite go hin-líne d’uimhir ríomhphoist HTML.

Dearadh

Do uirlisí dearaidh.

PacáisteAschur
@pantoken/figmaPacáiste Figma Variables.
@pantoken/swatchesSwatches dathanna (ASE, GPL, Sketch) chomh maith le bileog sampla SVG inléite.

Breiseáin

Aistrithe roghnach a leathnaíonn aschur na ticéid nó an CSS. Féach Breiseáin.

PacáisteCad a chuireann sé leis
@pantoken/plugin-stackingDoimhneachtaí z-index ainmniúla mar thicéid --instui-stacking-*.
@pantoken/plugin-visual-debugAn struchtúr -with-visual-debug chun leagan amach a dhíghlaoú (layout-debugging).
@pantoken/plugin-simple-iconsÍocóin branda ó simple-icons.
@pantoken/plugin-logosLógónna táirgí Instructure mar SVGanna, data URIs, agus ticéid íomhá.
@pantoken/plugin-prune-custom-propsBreiseán PostCSS a thiteann airíonna sainmhínithe neamhúsáidte.

Uirlisí

Tógáil, doiciméid, agus bonneagar samplach don monorepo féin. Tá an chuid is mó inmheánach, ach tá na codanna féin-choimeádta, mar sin déanaimid cur síos orthu anseo agus seolfar cuid acu chuig npm ar a gcéin.

PacáisteCad a dhéanann sé
@pantoken/aggregateGineann an t-armáil pacáiste comhtháite pantoken agus exports óna spleáchais.
@pantoken/validate-generatedAn geata drifte: sheiceálann sé gach stíleáil ginte go réitíonn sí i gcoinne IR na dticéad.
@pantoken/demoRithéir léiriúcháin bheo féin-óstaithe: réitíonn sonra specs @demo go iframe agus déanann sé HTML/CSS/JS bhunúsach a rindreáil ar an gcineáil chéanna, téamaite le ticéid.
@cssdoc/core (ardáin seachtrach)Eisitheoir doiciméadúcháin CSS ginearálta (TSDoc, do CSS): dhéanann sé tráchtanna doiciméadaithe agus an AST CSS a pharsáil isteach i samhail a astaítear mar Thagairt API CSS don doiciméad. Tá cónaí ina fhothréimhse féin; tomhas é trí spleáchas nascáilte.

Is script rith-amach é @pantoken/validate-generated (glaoite ag pnpm run ready), mar sin níl leathanach API aige; tá na cinn eile ann.

AI

Sochraidí socrú AI atá dírithe ar an gcustaiméir. Tá siad seo do thionscadail a úsáideann pantoken, ní do fhorbairt pantoken féin.

  • @pantoken/ai suiteálann AGENTS.md, llms.txt, agus rialacha cúntóra/eagarthóra (Cursor, Copilot, Windsurf, Claude Code) i stórpáipéar tomhaltóra.

Breiseáin forbartha (Dev plugins)

Breiseáin a scríobhaimid do na huirlisí a thógann muid, grúpáilte de réir óstach. Tá siad neamhspleách agus foilsithe.

PacáisteCuireadh isteach i
@pantoken/typedoc-plugin-demoTypeDoc: casann sé stíle tag-block @demo <provider>:<ref> ina phaisín dDemo atá ionchlannaithe.
@pantoken/vite-workspace-orchestratorVite: atógann sé pacáistí upstream an oibre-spás (agus a spleáchais) nuair a athraíonn a bhfoinse.