mcp-tailwindcss 1.0.0

package/README.md

@@ -0,0 +1,419 @@
+# MCP Tailwind CSS Context
+
+<div align="center">
+
+![Tailwind CSS](https://img.shields.io/badge/Tailwind%20CSS-v4.1-06B6D4?style=for-the-badge&logo=tailwindcss&logoColor=white)
+![MCP](https://img.shields.io/badge/MCP-Compatible-5B5BD6?style=for-the-badge)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178C6?style=for-the-badge&logo=typescript&logoColor=white)
+
+**Servidor MCP (Model Context Protocol) para fornecer contexto completo da biblioteca Tailwind CSS**
+
+[Instalação](#instalação) • [Ferramentas](#ferramentas-disponíveis) • [Frameworks](#integração-com-frameworks) • [v3 vs v4](#tailwind-v3-vs-v4)
+
+</div>
+
+---
+
+## 📋 Sobre
+
+Este servidor MCP fornece acesso completo ao código-fonte do **Tailwind CSS** (repositório oficial `tailwindlabs/tailwindcss`), permitindo que assistentes de IA como Claude e GitHub Copilot tenham contexto profundo sobre:
+
+- ✅ Configuração e Theme Variables
+- ✅ Utilities e Plugins
+- ✅ Integração com frameworks (Vite, Next.js, Nuxt, Astro, etc.)
+- ✅ Diferenças entre Tailwind v3 e v4
+- ✅ AST parsing para tipos TypeScript
+- ✅ Auto-download e atualização do repositório oficial
+
+---
+
+## 🚀 Instalação
+
+### Via NPM (recomendado)
+
+```bash
+npm install -g mcp-tailwindcss
+```
+
+### Configuração no Claude Desktop
+
+Adicione ao seu arquivo `claude_desktop_config.json`:
+
+**Windows:**
+```json
+{
+  "mcpServers": {
+    "tailwindcss": {
+      "command": "npx",
+      "args": ["-y", "mcp-tailwindcss"]
+    }
+  }
+}
+```
+
+**macOS/Linux:**
+```json
+{
+  "mcpServers": {
+    "tailwindcss": {
+      "command": "npx",
+      "args": ["-y", "mcp-tailwindcss"]
+    }
+  }
+}
+```
+
+### Configuração no VS Code (GitHub Copilot)
+
+Adicione ao seu `settings.json`:
+
+```json
+{
+  "github.copilot.chat.mcpServers": {
+    "tailwindcss": {
+      "command": "npx",
+      "args": ["-y", "mcp-tailwindcss"]
+    }
+  }
+}
+```
+
+---
+
+## 🛠️ Ferramentas Disponíveis
+
+### 📁 Exploração de Código
+
+| Ferramenta | Descrição |
+|------------|-----------|
+| `tailwind_estrutura` | Lista a estrutura de arquivos do Tailwind CSS (`packages/tailwindcss/src`) |
+| `tailwind_ler_arquivo` | Lê o conteúdo de um arquivo específico do Tailwind |
+
+### 🔍 Análise de Tipos (AST)
+
+| Ferramenta | Descrição |
+|------------|-----------|
+| `tailwind_extrair_tipos` | Extrai interfaces, types, enums, funções via AST |
+| `tailwind_buscar_tipo` | Busca definição de tipo específico pelo nome |
+| `tailwind_buscar_fuzzy` | Busca aproximada quando não sabe o nome exato |
+| `tailwind_listar_exports` | Lista todos os exports públicos agrupados |
+| `tailwind_categorias` | Lista declarações por categoria específica |
+| `tailwind_constantes` | Lista constantes e variáveis exportadas |
+| `tailwind_hierarquia` | Mostra hierarquia de herança de um tipo |
+| `tailwind_estatisticas` | Estatísticas detalhadas da biblioteca |
+| `tailwind_dependencias` | Analisa dependências entre módulos |
+| `tailwind_enums` | Lista todas as enumerações com valores |
+| `tailwind_interfaces` | Lista interfaces com propriedades/métodos |
+| `tailwind_funcoes` | Lista funções exportadas com assinaturas |
+
+### 🔄 Atualizações
+
+| Ferramenta | Descrição |
+|------------|-----------|
+| `tailwind_check_updates` | Verifica se há atualizações disponíveis |
+| `tailwind_update` | Atualiza o repositório local |
+| `tailwind_status` | Status atual do repositório (commit SHA, etc.) |
+
+### 🎯 Integrações
+
+| Ferramenta | Descrição |
+|------------|-----------|
+| `tailwind_integracoes` | Guias de integração com frameworks |
+
+---
+
+## 🎨 Integração com Frameworks
+
+O MCP fornece guias completos para integrar Tailwind CSS com os principais frameworks:
+
+### Vite (Tailwind v4)
+
+```bash
+npm install tailwindcss @tailwindcss/vite
+```
+
+```javascript
+// vite.config.js
+import tailwindcss from '@tailwindcss/vite'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [tailwindcss()]
+})
+```
+
+```css
+/* app.css */
+@import "tailwindcss";
+```
+
+### Next.js (Tailwind v4)
+
+```bash
+npm install tailwindcss @tailwindcss/postcss postcss
+```
+
+```javascript
+// postcss.config.mjs
+export default {
+  plugins: {
+    '@tailwindcss/postcss': {}
+  }
+}
+```
+
+### PostCSS (Universal)
+
+```bash
+npm install tailwindcss @tailwindcss/postcss postcss
+```
+
+```javascript
+// postcss.config.js
+export default {
+  plugins: {
+    '@tailwindcss/postcss': {}
+  }
+}
+```
+
+### CLI
+
+```bash
+npm install tailwindcss @tailwindcss/cli
+npx @tailwindcss/cli -i input.css -o output.css --watch
+```
+
+---
+
+## ⚡ Tailwind v3 vs v4
+
+### Principais Diferenças
+
+| Aspecto | Tailwind v3 | Tailwind v4 |
+|---------|-------------|-------------|
+| **Configuração** | `tailwind.config.js` | CSS-first com `@theme` |
+| **Instalação Vite** | Plugin PostCSS | `@tailwindcss/vite` nativo |
+| **Theme** | JavaScript object | CSS Variables (`--color-*`) |
+| **Import** | `@tailwind base/components/utilities` | `@import "tailwindcss"` |
+| **Cores** | HEX/RGB | oklch() por padrão |
+
+### Tailwind v4 - Nova Sintaxe CSS
+
+```css
+@import "tailwindcss";
+
+@theme {
+  /* Cores customizadas */
+  --color-brand: oklch(0.72 0.11 221.19);
+  
+  /* Breakpoints */
+  --breakpoint-3xl: 120rem;
+  
+  /* Fontes */
+  --font-display: "Satoshi", sans-serif;
+  
+  /* Espaçamento base */
+  --spacing: 0.25rem;
+}
+```
+
+### Theme Variable Namespaces (v4)
+
+| Namespace | Utilities Geradas |
+|-----------|-------------------|
+| `--color-*` | `bg-*`, `text-*`, `border-*`, `fill-*` |
+| `--font-*` | `font-*` |
+| `--text-*` | `text-xs`, `text-sm`, `text-lg`, etc. |
+| `--spacing-*` | `p-*`, `m-*`, `gap-*`, `w-*`, `h-*` |
+| `--radius-*` | `rounded-*` |
+| `--shadow-*` | `shadow-*` |
+| `--breakpoint-*` | `sm:`, `md:`, `lg:`, `xl:` |
+| `--animate-*` | `animate-*` |
+
+### Tailwind v3 - Configuração JavaScript
+
+```javascript
+// tailwind.config.js (v3)
+module.exports = {
+  content: ['./src/**/*.{js,jsx,ts,tsx}'],
+  theme: {
+    extend: {
+      colors: {
+        brand: '#06B6D4',
+      },
+      fontFamily: {
+        display: ['Satoshi', 'sans-serif'],
+      },
+    },
+  },
+  plugins: [],
+}
+```
+
+```css
+/* styles.css (v3) */
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+```
+
+---
+
+## 📚 Exemplos de Uso
+
+### Buscar configuração de cores
+
+```
+Use tailwind_buscar_tipo com nome "Theme" para ver a estrutura de tema
+```
+
+### Explorar utilities disponíveis
+
+```
+Use tailwind_extrair_tipos com apenas_kind "function" para ver todas as funções utilitárias
+```
+
+### Verificar integração com Next.js
+
+```
+Use tailwind_integracoes com framework "next" para ver o passo a passo
+```
+
+### Ver estrutura do projeto
+
+```
+Use tailwind_estrutura para explorar a organização do código-fonte
+```
+
+---
+
+## 🔧 Variáveis de Ambiente
+
+| Variável | Descrição | Padrão |
+|----------|-----------|--------|
+| `TAILWIND_SRC_PATH` | Caminho customizado para o código-fonte | Auto-detectado |
+
+---
+
+## 📁 Estrutura do Repositório
+
+O MCP baixa automaticamente o repositório oficial do Tailwind CSS na primeira execução:
+
+```
+~/.mcp-tailwindcss/
+└── tailwindcss/
+    ├── packages/
+    │   └── tailwindcss/
+    │       └── src/           <- Código-fonte principal
+    │           ├── index.ts
+    │           ├── theme.css
+    │           ├── preflight.css
+    │           ├── utilities.css
+    │           ├── compat/
+    │           ├── utils/
+    │           └── ...
+    ├── crates/                 <- Engine Oxide (Rust)
+    └── integrations/           <- Testes de integração
+```
+
+---
+
+## 🎯 Utilities Reference (v4)
+
+### Layout
+- `container`, `columns-*`
+- `break-after-*`, `break-before-*`, `break-inside-*`
+- `box-decoration-*`, `box-sizing-*`
+- `block`, `inline-block`, `inline`, `flex`, `inline-flex`, `grid`, `inline-grid`
+- `flow-root`, `contents`, `hidden`
+
+### Flexbox & Grid
+- `flex-*`, `flex-row`, `flex-col`, `flex-wrap`, `flex-nowrap`
+- `grid-cols-*`, `grid-rows-*`, `gap-*`
+- `justify-*`, `items-*`, `content-*`
+- `place-*`, `self-*`
+
+### Spacing
+- `p-*`, `px-*`, `py-*`, `pt-*`, `pr-*`, `pb-*`, `pl-*`
+- `m-*`, `mx-*`, `my-*`, `mt-*`, `mr-*`, `mb-*`, `ml-*`
+- `space-x-*`, `space-y-*`
+
+### Sizing
+- `w-*`, `min-w-*`, `max-w-*`
+- `h-*`, `min-h-*`, `max-h-*`
+- `size-*`
+
+### Typography
+- `font-*`, `text-*`, `tracking-*`, `leading-*`
+- `text-left`, `text-center`, `text-right`, `text-justify`
+- `underline`, `line-through`, `no-underline`
+- `uppercase`, `lowercase`, `capitalize`, `normal-case`
+
+### Backgrounds
+- `bg-*`, `bg-gradient-*`
+- `from-*`, `via-*`, `to-*`
+- `bg-cover`, `bg-contain`, `bg-center`, `bg-repeat`, `bg-no-repeat`
+
+### Borders
+- `border`, `border-*`, `rounded-*`
+- `ring-*`, `outline-*`
+- `divide-*`
+
+### Effects
+- `shadow-*`, `drop-shadow-*`
+- `opacity-*`
+- `mix-blend-*`, `bg-blend-*`
+
+### Filters
+- `blur-*`, `brightness-*`, `contrast-*`
+- `grayscale`, `hue-rotate-*`, `invert`, `saturate-*`, `sepia`
+- `backdrop-*`
+
+### Transitions & Animation
+- `transition`, `transition-*`
+- `duration-*`, `ease-*`, `delay-*`
+- `animate-*`
+
+### Transforms
+- `scale-*`, `rotate-*`, `translate-*`, `skew-*`
+- `origin-*`
+
+### Interactivity
+- `cursor-*`, `pointer-events-*`
+- `resize`, `resize-x`, `resize-y`, `resize-none`
+- `select-*`, `touch-*`, `scroll-*`
+
+---
+
+## 🤝 Contribuindo
+
+1. Fork o repositório
+2. Crie sua branch: `git checkout -b feature/nova-funcionalidade`
+3. Commit suas mudanças: `git commit -m 'feat: adiciona nova funcionalidade'`
+4. Push para a branch: `git push origin feature/nova-funcionalidade`
+5. Abra um Pull Request
+
+---
+
+## 📄 Licença
+
+MIT © Joseph
+
+---
+
+## 🔗 Links Úteis
+
+- [Tailwind CSS Documentation](https://tailwindcss.com/docs)
+- [Tailwind CSS GitHub](https://github.com/tailwindlabs/tailwindcss)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [Tailwind v4 Upgrade Guide](https://tailwindcss.com/docs/upgrade-guide)
+- [Theme Variables Reference](https://tailwindcss.com/docs/theme)
+
+---
+
+<div align="center">
+
+**Feito com 💙 para a comunidade Tailwind CSS**
+
+</div>

package/dist/ast-parser.d.ts

@@ -0,0 +1,106 @@
+export type ExtractedKind = 'interface' | 'type' | 'enum' | 'function' | 'class' | 'variable' | 'namespace' | 're-export';
+export interface PropertyInfo {
+    name: string;
+    type: string;
+    optional: boolean;
+    readonly: boolean;
+    docs?: string;
+    isMethod: boolean;
+    isCallSignature: boolean;
+    isIndexSignature: boolean;
+    parameters?: string[];
+    returnType?: string;
+}
+export interface TypeParameter {
+    name: string;
+    constraint?: string;
+    default?: string;
+}
+export interface ExtractedType {
+    name: string;
+    kind: ExtractedKind;
+    exported: boolean;
+    file: string;
+    module: string;
+    signature: string;
+    fullSignature?: string;
+    properties?: PropertyInfo[];
+    methods?: PropertyInfo[];
+    members?: string[];
+    typeParameters?: TypeParameter[];
+    extends?: string[];
+    implements?: string[];
+    docs?: string;
+    value?: string;
+    reExportSource?: string;
+    lineNumber?: number;
+}
+export interface ModuleStatistics {
+    module: string;
+    interfaces: number;
+    types: number;
+    enums: number;
+    functions: number;
+    classes: number;
+    variables: number;
+    namespaces: number;
+    reExports: number;
+    total: number;
+}
+export interface LibraryStatistics {
+    totalDeclarations: number;
+    byKind: Record<ExtractedKind, number>;
+    byModule: ModuleStatistics[];
+    topInterfaces: string[];
+    topTypes: string[];
+    topFunctions: string[];
+}
+export interface DependencyInfo {
+    module: string;
+    imports: string[];
+    exports: string[];
+    reExportsFrom: string[];
+}
+export declare class AstParser {
+    private project;
+    private tailwindSrcPath;
+    private cachedTypes;
+    constructor(tailwindSrcPath: string);
+    private getModuleName;
+    private getRelativePath;
+    addSourceFiles(patterns: string[]): void;
+    extractFromFile(filePath: string): ExtractedType[];
+    extractAllTypes(): ExtractedType[];
+    private extractTypes;
+    private extractTypeParameters;
+    private extractInterface;
+    private extractTypeAlias;
+    private extractEnum;
+    private extractFunction;
+    private extractClass;
+    private extractVariable;
+    private extractNamespace;
+    private extractReExport;
+    private simplifyType;
+    private getJsDocs;
+    searchType(typeName: string): ExtractedType | undefined;
+    fuzzySearch(query: string, maxResults?: number): ExtractedType[];
+    getTypesFromModule(moduleName: string): ExtractedType[];
+    getTypesByKind(kind: ExtractedKind): ExtractedType[];
+    getStatistics(): LibraryStatistics;
+    getTypeHierarchy(typeName: string): {
+        type: ExtractedType;
+        parents: string[];
+        children: string[];
+    } | null;
+    analyzeDependencies(): DependencyInfo[];
+    getVariables(): ExtractedType[];
+    getConstants(): ExtractedType[];
+    getNamespaces(): ExtractedType[];
+    getInterfaces(): ExtractedType[];
+    getEnums(): ExtractedType[];
+    getFunctions(): ExtractedType[];
+    getClasses(): ExtractedType[];
+    getTypes(): ExtractedType[];
+}
+//# sourceMappingURL=ast-parser.d.ts.map

package/dist/ast-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-parser.d.ts","sourceRoot":"","sources":["../src/ast-parser.ts"],"names":[],"mappings":"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"}