Skip to content

O mapa de pacotes

pantoken é um monorepo de pacotes pequenos e com propósito único agrupados em buckets. Instale o que se encaixa na sua tarefa, ou instale o pacote unificado pantoken e importe de seus subpaths (por exemplo pantoken/css, pantoken/react, pantoken/tailwind).

Núcleo

O modelo compartilhado e o transformador sobre o qual todo o resto é construído.

PackageO que faz
@pantoken/modelTipos TypeScript sem dependências: a forma Token e o contrato de plugin.
@pantoken/coreResolve os tokens e ícones upstream para a IR canônica e renderiza CSS.
@pantoken/tokensA IR resolvida embutida como JSON estático, por tema, mais a fonte bruta do Tokens Studio.
@pantoken/utilsO resolvedor de tokens, regexes de referência, helpers de case e cor, verificações de drift e os emissores token→classe-de-utilidade.
@pantoken/plugin-kitConstruir e compor plugins pantoken com definePlugin.
@pantoken/clipantoken generate <target> — emite código nativo e fonte por plataforma.

Formatos

Transforma os tokens em um formato de arquivo.

PackageSaída
@pantoken/cssCSS tipado por @property com light-dark() e ícones em data-URI.
@pantoken/scssVariáveis SCSS, resolvidas para um único modo.
@pantoken/lessVariáveis Less.
@pantoken/stylusVariáveis Stylus.
@pantoken/dtcgUm documento W3C Design Tokens (DTCG).
@pantoken/tokensA IR como JavaScript e JSON (também listada em Núcleo).
@pantoken/iconsUma visão ergonômica sobre os tokens de ícone.
@pantoken/icon-fontUma fonte de ícones web (TTF, WOFF2) mais seu CSS.
@pantoken/componentsUma biblioteca CSS de componentes com aparência InstUI (botão, alerta, tabela e mais) além de um reset base com anel de foco, estilização de prose, utilitários transversais e as fontes da marca. Veja Components.

Renderers

Integrações com frameworks e ferramentas.

PackagePara
@pantoken/reactHooks React, <Icon> e um provedor de tokens.
@pantoken/vue, @pantoken/svelte, @pantoken/angularO web component, conectado a cada framework.
@pantoken/react-nativeObjetos de token amigáveis ao StyleSheet (sem variáveis CSS).
@pantoken/web-components<instui-icon> e primitivos estilizados, agnóstico a frameworks.
@pantoken/astroConfiguração de tokens para sites Astro.
@pantoken/react-markdown, @pantoken/rehypeTokens de ícone e paletas em Markdown.
@pantoken/markdown-itUm plugin markdown-it para códigos de ícones e amostras de cores.
@pantoken/css-in-jsUm tema tipado para styled-components e Emotion.
@pantoken/muiUm tema para Material UI.
@pantoken/bootstrap, @pantoken/shadcnPontes de variáveis CSS para Bootstrap e shadcn/ui.
@pantoken/foundationUma sobreposição de CSS e override de configurações Sass para Foundation.
@pantoken/docusaurus, @pantoken/vitepressTemas para Docusaurus e VitePress.
@pantoken/mintlifyUm tema Mintlify docs.json (cores + background).
@pantoken/storybookUm tema para Storybook.
@pantoken/pendoCSS global com estilo Instructure para guias Pendo.

Bundlers

Integrações com ferramentas de build.

PackagePara
@pantoken/viteUm plugin Vite com módulos virtuais e injeção de CSS.
@pantoken/nextwithPantoken para Next.js transpilePackages.
@pantoken/webpackUm plugin webpack.
@pantoken/postcssA at-rule @pantoken;.
@pantoken/tailwindUm preset Tailwind.
@pantoken/pandaUm preset Panda CSS.

Plataformas

Alvos nativos e geradores de site, emitidos pelo CLI ou por suas próprias APIs.

PackageSaída
@pantoken/swiftCódigo Swift mais um stub de manifesto SwiftPM.
@pantoken/androidRecursos XML para Android.
@pantoken/composeJetpack Compose Kotlin.
@pantoken/flutterFlutter Dart.
@pantoken/rustConsts Rust para egui ou iced.
@pantoken/wordpressUm theme.json de tema WordPress.
@pantoken/vanillaUm variables.json do Vanilla Forums.
@pantoken/drupalAssets de tema Drupal.
@pantoken/hugo, @pantoken/jekyllDados de site para Hugo e Jekyll.
@pantoken/emailValores amigáveis para uso inline em e-mail HTML.

Design

Para ferramentas de design.

PackageSaída
@pantoken/figmaUm payload de Figma Variables.
@pantoken/swatchesPaletas de cores (ASE, GPL, Sketch) além de uma folha de espécime SVG visualizável.

Plugins

Transformações opcionais que estendem o token ou a saída CSS. Veja Plugins.

PackageO que adiciona
@pantoken/plugin-stackingProfundidades z-index nomeadas como tokens --instui-stacking-*.
@pantoken/plugin-visual-debugO contorno de depuração de layout -with-visual-debug.
@pantoken/plugin-simple-iconsÍcones de marca do simple-icons.
@pantoken/plugin-logosLogos de produtos Instructure como SVGs, data URIs e tokens de imagem.
@pantoken/plugin-prune-custom-propsUm plugin PostCSS que remove propriedades customizadas não utilizadas.

Ferramentas

Infraestrutura de build, docs e demo para o próprio monorepo. A maior parte é interna, mas as peças são auto-contidas, então documentamos aqui e algumas são publicadas no npm separadamente.

PackageO que faz
@pantoken/aggregateGera o pacote unificado pantoken barrel e exports a partir de suas dependências.
@pantoken/validate-generatedO gate de drift: verifica se cada stylesheet gerada resolve contra a IR de tokens.
@pantoken/demoO runner de live-demo self-hosted: resolve uma spec @demo para um iframe e renderiza HTML/CSS/JS bare same-origin, temado por tokens.
@cssdoc/core (external)Um extrator genérico de documentação CSS (TSDoc, para CSS): analisa comentários TSDoc + AST de CSS em um modelo que a docs emite como referência da API CSS. Vive em um repositório próprio; consumido via dependência linkada.

@pantoken/validate-generated é um script executado uma vez (invocado por pnpm run ready), então não tem página de API; as demais têm.

AI

Ativos de configuração de IA voltados ao consumidor. Estes são para projetos que usam pantoken, não para desenvolver o próprio pantoken.

  • @pantoken/ai instala AGENTS.md, llms.txt e regras de assistente/editor (Cursor, Copilot, Windsurf, Claude Code) em um repositório consumidor.

Dev plugins

Plugins que autoramos para as ferramentas com as quais trabalhamos, agrupados por host. São independentes e publicáveis.

PackagePlug-in em
@pantoken/typedoc-plugin-demoTypeDoc: transforma uma tag de bloco @demo <provider>:<ref> em uma cerca de demo embutível.
@pantoken/vite-workspace-orchestratorVite: reconstrói pacotes upstream do workspace (e dependentes) quando suas fontes mudam.