{"_id":"@0x1js/tailwind-handler","_rev":"2-200c53d13b90329ef1021594f82bcdf4","name":"@0x1js/tailwind-handler","dist-tags":{"latest":"0.0.2"},"versions":{"0.0.1":{"name":"@0x1js/tailwind-handler","version":"0.0.1","keywords":["tailwind","css","bun","performance","build-tools","0x1","caching","fast","framework"],"author":{"name":"0x1 Framework","email":"team@0x1.onl"},"license":"MIT","_id":"@0x1js/tailwind-handler@0.0.1","maintainers":[{"name":"triex","email":"hi@triex.dev"}],"homepage":"https://0x1.onl/docs/tailwind-handler","bugs":{"url":"https://github.com/0x1-tools/0x1-framework/issues"},"0x1":{"bunVersion":"1.2.6+","cacheEnabled":true,"experimental":true,"buildOptimized":true,"incrementalProcessing":true},"dist":{"shasum":"cc90f3528a9f25ae5c4544ce5235c539241e3de8","tarball":"https://registry.npmjs.org/@0x1js/tailwind-handler/-/tailwind-handler-0.0.1.tgz","fileCount":3,"integrity":"sha512-QMLJAUO3xtU56CRVZL+/EP4gA5Y9qfqHS8rv0a6J7SGMr77YtFYAk8QVxiD+TXfOLW5zMPqqYh0ZFjFZGYVf0w==","signatures":[{"sig":"MEQCIG7CRv9bbpdjQKUNXZmmCTAmNFkC15XpkROhvYPq1xy6AiBWNwtbWT7qyz2CCSNv1V1H7pt6XOpzHZRDIEHeKRuM8Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27399},"main":"./dist/TailwindHandler.js","type":"module","types":"./dist/TailwindHandler.d.ts","engines":{"bun":">=1.2.6"},"exports":{".":{"types":"./dist/TailwindHandler.d.ts","import":"./dist/TailwindHandler.js"}},"funding":{"url":"https://github.com/sponsors/0x1-tools","type":"github"},"gitHead":"bb661d045e7bf8bdc5108a52dac466ca8364867c","scripts":{"dev":"bun build ./TailwindHandler.ts --outdir=dist --target=bun --format=esm --watch","test":"bun test","build":"bun build ./TailwindHandler.ts --outdir=dist --target=bun --format=esm --minify","check":"bun check TailwindHandler.ts","clean":"rm -rf dist","prepublishOnly":"bun run build"},"_npmUser":{"name":"triex","email":"hi@triex.dev"},"repository":{"url":"git+https://github.com/0x1-tools/0x1-framework.git","type":"git","directory":"packages/tailwind-handler"},"_npmVersion":"10.8.2","description":"Lightning-fast Tailwind CSS processor achieving <50ms builds through intelligent caching and incremental processing. Built for Bun 1.2+ with native performance optimizations.","directories":{},"performance":{"cached":"<5ms","target":"<50ms","improvement":"98% faster than TailwindCSS v4"},"_nodeVersion":"18.20.8","dependencies":{},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.3.0"},"peerDependencies":{"bun":">=1.2.6"},"_npmOperationalInternal":{"tmp":"tmp/tailwind-handler_0.0.1_1749471220215_0.6592362598966137","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@0x1js/tailwind-handler","version":"0.0.2","description":"Lightning-fast Tailwind CSS processor achieving <50ms builds through intelligent caching and incremental processing. Built for Bun 1.2+ with native performance optimizations.","type":"module","main":"./dist/TailwindHandler.js","types":"./dist/TailwindHandler.d.ts","exports":{".":{"import":"./dist/TailwindHandler.js","types":"./dist/TailwindHandler.d.ts"}},"scripts":{"build":"bun build ./TailwindHandler.ts --outdir=dist --target=bun --format=esm --minify","dev":"bun build ./TailwindHandler.ts --outdir=dist --target=bun --format=esm --watch","test":"bun test","prepublishOnly":"bun run build","clean":"rm -rf dist","check":"bun check TailwindHandler.ts"},"keywords":["tailwind","css","bun","performance","build-tools","0x1","caching","fast","framework"],"author":{"name":"0x1 Framework","email":"team@0x1.onl"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/0x1-tools/0x1-framework.git","directory":"packages/tailwind-handler"},"homepage":"https://0x1.onl/docs/tailwind-handler","bugs":{"url":"https://github.com/0x1-tools/0x1-framework/issues"},"engines":{"bun":">=1.2.6"},"peerDependencies":{"bun":">=1.2.6"},"dependencies":{},"devDependencies":{"@types/bun":"latest","typescript":"^5.3.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"funding":{"type":"github","url":"https://github.com/sponsors/0x1-tools"},"performance":{"target":"<50ms","cached":"<5ms","improvement":"98% faster than TailwindCSS v4"},"0x1":{"experimental":true,"buildOptimized":true,"bunVersion":"1.2.6+","cacheEnabled":true,"incrementalProcessing":true},"_id":"@0x1js/tailwind-handler@0.0.2","gitHead":"bb661d045e7bf8bdc5108a52dac466ca8364867c","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-JEZ7yhf8OvYJPBjyky77pHiFsgMRiibFxYs1oZqu17EwBJHVaXPKN70orTAhxKRxmqytRP7AYNzC2MdmbFuhKQ==","shasum":"e567f7e096b15bcd39dfc8086dc169bb3c2d8d24","tarball":"https://registry.npmjs.org/@0x1js/tailwind-handler/-/tailwind-handler-0.0.2.tgz","fileCount":4,"unpackedSize":20626,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCID/L0wF5Q62ceOrTnEYsoIvPt3OHmtAlSy+VQsI3PfpdAiEA4YLgYPnF8fKNckP/YbJStC6CxLUKWfrGS2czSQ7qWhI="}]},"_npmUser":{"name":"triex","email":"hi@triex.dev"},"directories":{},"maintainers":[{"name":"triex","email":"hi@triex.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tailwind-handler_0.0.2_1749479040016_0.6325925953861466"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-09T12:13:40.112Z","modified":"2025-06-09T14:24:00.438Z","0.0.1":"2025-06-09T12:13:40.382Z","0.0.2":"2025-06-09T14:24:00.200Z"},"bugs":{"url":"https://github.com/0x1-tools/0x1-framework/issues"},"author":{"name":"0x1 Framework","email":"team@0x1.onl"},"license":"MIT","homepage":"https://0x1.onl/docs/tailwind-handler","keywords":["tailwind","css","bun","performance","build-tools","0x1","caching","fast","framework"],"repository":{"type":"git","url":"git+https://github.com/0x1-tools/0x1-framework.git","directory":"packages/tailwind-handler"},"description":"Lightning-fast Tailwind CSS processor achieving <50ms builds through intelligent caching and incremental processing. Built for Bun 1.2+ with native performance optimizations.","maintainers":[{"name":"triex","email":"hi@triex.dev"}],"readme":"# @0x1js/tailwind-handler\n\n🚀 **Intelligent Tailwind CSS Processor** - Automatically detects and processes your project's Tailwind CSS through your installed packages.\n\n## ✨ Features\n\n- **🔍 Automatic Discovery**: Finds your CSS files in standard locations\n- **⚡ Smart Processing**: Processes through your installed Tailwind packages  \n- **🎯 Version Aware**: Supports both Tailwind v3 and v4\n- **🔄 Multi-Strategy**: Multiple fallback approaches for reliability\n- **📦 Zero Config**: Works out of the box with standard project setups\n- **🌙 Future-Proof**: Compatible with current and future Tailwind versions\n\n## 📦 Installation\n\n```bash\nbun add @0x1js/tailwind-handler\n```\n\n## 🚀 Quick Start\n\n```typescript\nimport { processTailwindFast } from '@0x1js/tailwind-handler';\n\n// Automatically finds and processes your project's CSS\nconst result = await processTailwindFast('./my-project', {\n  outputPath: 'dist/styles.css',\n  config: {\n    content: ['src/**/*.{js,ts,jsx,tsx}']\n  }\n});\n\nconsole.log(`✅ Generated: ${result.css.length} bytes`);\nconsole.log(`⚡ Processing time: ${result.processingTime}ms`);\n```\n\n## 🔧 How It Works\n\n### 1. **File Discovery**\nAutomatically scans for CSS files in common locations:\n```\napp/globals.css          # Next.js/0x1 style\nsrc/app/globals.css      # Nested structure  \nstyles/globals.css       # Traditional\ncss/main.css            # Standard\n```\n\n### 2. **Directive Detection**  \nRecognizes Tailwind directives:\n- `@import \"tailwindcss\"` (v4)\n- `@tailwind base|components|utilities` (v3)\n- `@layer` and `@apply` directives\n\n### 3. **Smart Processing**\nProcesses through your installed Tailwind packages via PostCSS\n\n### 4. **Graceful Fallback**\nProvides essential CSS if processing fails\n\n## 🎯 Project Setup\n\n### Tailwind v4 Projects\n\n```bash\n# Install dependencies\nbun add tailwindcss@^4.0.0 @tailwindcss/postcss postcss\n\n# Create CSS file (app/globals.css)\n@import \"tailwindcss\";\n\n# Create PostCSS config (postcss.config.js)\nexport default {\n  plugins: {\n    '@tailwindcss/postcss': {},\n    autoprefixer: {},\n  },\n};\n```\n\n### Tailwind v3 Projects\n\n```bash\n# Install dependencies  \nbun add -d tailwindcss@^3.0.0 postcss autoprefixer\n\n# Create CSS file (styles/globals.css)\n@tailwind base;\n@tailwind components;\n@tailwind utilities;\n```\n\n## 🔍 Advanced Usage\n\n### Manual Handler Creation\n\n```typescript\nimport { TailwindHandler } from '@0x1js/tailwind-handler';\n\nconst handler = new TailwindHandler('./project', {\n  content: ['src/**/*.{js,ts,jsx,tsx}'],\n  outputPath: 'dist/styles.css'\n});\n\nconst result = await handler.process();\n```\n\n### Debug Mode\n\n```typescript\n// Enable detailed logging\nprocess.env.DEBUG = '@0x1js/tailwind-handler';\n\n// Shows processing steps:\n// [TailwindHandler] Found CSS file: app/globals.css (16490 bytes)  \n// [TailwindHandler] CSS contains Tailwind directives, processing...\n// [TailwindHandler] Processing with Tailwind v4\n// [TailwindHandler] PostCSS processing complete: 85342 bytes\n```\n\n## 🎨 Framework Integration\n\n### 0x1 Framework\n```typescript\n// Automatic integration - no setup required\n// Uses 0x1-enhanced CSS processor\n```\n\n### Build Scripts\n```typescript\nimport { processTailwindFast } from '@0x1js/tailwind-handler';\n\nexport async function buildCSS() {\n  const result = await processTailwindFast(process.cwd(), {\n    outputPath: 'dist/styles.css',\n    config: { content: ['src/**/*.{js,ts,jsx,tsx}'] }\n  });\n  \n  console.log(`✅ CSS built in ${result.processingTime}ms`);\n}\n```\n\n## 🛠️ Troubleshooting\n\n**No CSS generated?**\n- Ensure Tailwind packages are installed\n- Check CSS file contains proper directives\n- Enable debug mode for detailed logs\n\n**Processing failed?**\n- Verify PostCSS config for v4 projects\n- Check content paths in configuration\n- Ensure CSS syntax is valid\n\n**Wrong version detected?**\n- Check package.json dependencies\n- Ensure consistent Tailwind version usage\n\n## 📊 API Reference\n\n### `processTailwindFast(projectPath, options)`\n\n**Parameters:**\n- `projectPath`: Project root directory\n- `options.outputPath`: CSS output file path\n- `options.config.content`: File patterns to scan for classes\n\n**Returns:**\n```typescript\n{\n  success: boolean;\n  css: string;\n  processingTime: number;\n  fromCache: boolean;\n}\n```\n\n### `TailwindHandler` Class\n\n```typescript\n// Constructor\nnew TailwindHandler(projectPath: string, config: TailwindConfig)\n\n// Main method\nasync process(): Promise<{\n  css: string;\n  fromCache: boolean;\n  processingTime: number;\n}>\n\n// Configuration\ninterface TailwindConfig {\n  content: string[];\n  outputPath?: string;\n}\n```\n\n## 🌟 Best Practices\n\n1. **Standard Locations**: Place CSS in `app/globals.css` or `styles/globals.css`\n2. **Proper Dependencies**: Install Tailwind packages in your project\n3. **Accurate Content**: Specify correct file patterns for optimal output\n4. **PostCSS Config**: Include for v4 projects\n5. **Debug Logging**: Use when troubleshooting issues\n\n## 📝 License\n\nMIT © 0x1 Framework\n\n---\n\n**Reliable Tailwind CSS processing for modern web projects** ","readmeFilename":"README.md"}