@barocss/server 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 jinho park(cyberuls@gmail.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,280 @@
+# @barocss/server
+
+[![npm version](https://img.shields.io/npm/v/@barocss/server.svg)](https://www.npmjs.com/package/@barocss/server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+
+**Server Runtime** - Server-side CSS generation and processing
+
+@barocss/server provides server-side utilities for parsing Tailwind classes and generating CSS without browser-specific features. Perfect for SSR, static site generation, and server-side CSS processing.
+
+## ✨ Key Features
+
+- **🚀 Server-Side CSS Generation** - Generate CSS on the server without browser APIs
+- **⚡ Batch Processing** - Process multiple classes efficiently
+- **📱 SSR Support** - Perfect for server-side rendering scenarios
+- **🎯 Static Generation** - Generate CSS for static sites and build processes
+- **🌐 Node.js Optimized** - Designed specifically for Node.js environments
+
+## 🚀 Quick Start
+
+### NPM Installation
+
+```bash
+# npm
+npm install @barocss/server
+
+# pnpm
+pnpm add @barocss/server
+
+# yarn
+yarn add @barocss/server
+```
+
+### Basic Usage
+
+```typescript
+import { ServerRuntime } from '@barocss/server';
+
+// Initialize server runtime
+const runtime = new ServerRuntime();
+
+// Generate CSS for a single class
+const css = runtime.generateCss('bg-blue-500 text-white p-4');
+console.log(css);
+// Output: .bg-blue-500 { background-color: #3b82f6; }
+//         .text-white { color: #ffffff; }
+//         .p-4 { padding: 1rem; }
+```
+
+### Batch Processing
+
+```typescript
+import { ServerRuntime } from '@barocss/server';
+
+const runtime = new ServerRuntime();
+
+// Process multiple classes at once
+const classes = [
+  'bg-blue-500',
+  'text-white',
+  'p-4',
+  'rounded-lg',
+  'shadow-md'
+];
+
+const results = runtime.generateCssForClasses(classes);
+results.forEach(({ className, css }) => {
+  console.log(`${className}: ${css}`);
+});
+```
+
+## 🎯 How It Works
+
+The server runtime provides server-side CSS generation:
+
+1. **Class Parsing** - Parses Tailwind classes using @barocss/kit
+2. **CSS Generation** - Generates CSS rules without browser dependencies
+3. **Batch Processing** - Efficiently processes multiple classes
+4. **Static Output** - Returns CSS strings ready for server use
+
+```typescript
+import { ServerRuntime } from '@barocss/server';
+
+const runtime = new ServerRuntime();
+
+// Parse and generate CSS
+const css = runtime.generateCss('bg-red-500 hover:bg-red-600 text-white p-4');
+
+// Result:
+// .bg-red-500 { background-color: #ef4444; }
+// .hover\:bg-red-600:hover { background-color: #dc2626; }
+// .text-white { color: #ffffff; }
+// .p-4 { padding: 1rem; }
+```
+
+## 🛠️ Usage Examples
+
+### Basic Server Usage
+
+```typescript
+import { ServerRuntime } from '@barocss/server';
+
+const runtime = new ServerRuntime({
+  theme: {
+    extend: {
+      colors: {
+        'brand': {
+          500: '#0ea5e9',
+          600: '#0284c7'
+        }
+      }
+    }
+  }
+});
+
+// Generate CSS for specific classes
+const css = runtime.generateCss('bg-brand-500 text-white p-4');
+console.log(css);
+```
+
+### Processing Multiple Classes
+
+```typescript
+import { ServerRuntime } from '@barocss/server';
+
+const runtime = new ServerRuntime();
+
+// Process a list of classes
+const classes = [
+  'bg-blue-500',
+  'text-white',
+  'p-4',
+  'rounded-lg',
+  'shadow-md'
+];
+
+const results = runtime.generateCssForClasses(classes);
+results.forEach(({ className, css }) => {
+  console.log(`${className}: ${css}`);
+});
+```
+
+## 🔧 Configuration
+
+### Server Runtime Options
+
+```typescript
+import { ServerRuntime } from '@barocss/server';
+
+const runtime = new ServerRuntime({
+  theme: {
+    extend: {
+      colors: {
+        'brand': {
+          50: '#f0f9ff',
+          500: '#0ea5e9',
+          900: '#0c4a6e',
+        }
+      },
+      spacing: {
+        '18': '4.5rem',
+        '88': '22rem',
+      }
+    }
+  },
+  darkMode: 'class',
+  cssVarPrefix: '--baro-'
+});
+```
+
+### Custom Theme Functions
+
+```typescript
+const runtime = new ServerRuntime({
+  theme: {
+    spacing: (theme) => ({
+      ...theme('spacing'),
+      '18': '4.5rem',
+      '88': '22rem',
+    }),
+    colors: (theme) => ({
+      ...theme('colors'),
+      'brand': {
+        500: '#0ea5e9',
+        600: '#0284c7'
+      }
+    })
+  }
+});
+```
+
+## 🌐 API Reference
+
+### ServerRuntime
+
+```typescript
+class ServerRuntime {
+  constructor(config?: Config)
+  
+  // Parse a class name and return its AST
+  parseClass(className: string): AstNode[]
+  
+  // Generate CSS for a single class
+  generateCss(className: string): string
+  
+  // Generate CSS for multiple classes
+  generateCssForClasses(classes: string[]): Array<{
+    className: string;
+    css: string;
+  }>
+}
+```
+
+### Usage Examples
+
+```typescript
+import { ServerRuntime } from '@barocss/server';
+
+const runtime = new ServerRuntime();
+
+// Parse class to AST
+const ast = runtime.parseClass('bg-blue-500 hover:bg-blue-600');
+console.log(ast);
+
+// Generate CSS for single class
+const css = runtime.generateCss('bg-blue-500 text-white p-4');
+console.log(css);
+
+// Generate CSS for multiple classes
+const results = runtime.generateCssForClasses([
+  'bg-blue-500',
+  'text-white',
+  'p-4'
+]);
+console.log(results);
+```
+
+## 🚀 Performance Features
+
+- **Batch Processing** - Efficiently processes multiple classes
+- **Memory Optimization** - Optimized for server environments
+- **Static Generation** - Perfect for build-time CSS generation
+- **No Browser Dependencies** - Runs entirely in Node.js
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](../../CONTRIBUTING.md) for details.
+
+### Development
+
+```bash
+# Clone repository
+git clone https://github.com/easylogic/barocss.git
+cd barocss
+
+# Install dependencies
+pnpm install
+
+# Start development server
+pnpm dev
+
+# Run tests
+pnpm test
+
+# Build packages
+pnpm build
+```
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](../../LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- **Tailwind CSS** - For the amazing utility-first approach and JIT inspiration
+- **UnoCSS** - For ideas around on-demand, utility-first generation at runtime
+
+---
+
+**@barocss/server** - Server-side CSS generation and processing.

package/dist/index.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("@barocss/kit");class n{constructor(e={}){this.context=s.createContext(e)}parseClass(e){return s.parseClassToAst(e,this.context)}generateCss(e){return s.generateCssRules(e,this.context)[0].css}generateCssForClasses(e){return e.map(t=>({className:t,css:this.generateCss(t)}))}}exports.ServerRuntime=n;

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { Config } from '@barocss/kit';
+/**
+ * Server-side runtime for Barocss
+ *
+ * This provides server-side utilities for parsing classes and generating CSS
+ * without browser-specific features like DOM manipulation or MutationObserver.
+ */
+export declare class ServerRuntime {
+    private context;
+    constructor(config?: Config);
+    /**
+     * Parse a class name and return its AST
+     */
+    parseClass(className: string): import('@barocss/kit').AstNode[];
+    /**
+     * Generate CSS for a class name
+     */
+    generateCss(className: string): string;
+    /**
+     * Parse multiple classes and return their CSS
+     */
+    generateCssForClasses(classes: string[]): {
+        className: string;
+        css: string;
+    }[];
+}

package/dist/index.es.js

@@ -0,0 +1,30 @@
+import { createContext as r, parseClassToAst as n, generateCssRules as o } from "@barocss/kit";
+class u {
+  constructor(s = {}) {
+    this.context = r(s);
+  }
+  /**
+   * Parse a class name and return its AST
+   */
+  parseClass(s) {
+    return n(s, this.context);
+  }
+  /**
+   * Generate CSS for a class name
+   */
+  generateCss(s) {
+    return o(s, this.context)[0].css;
+  }
+  /**
+   * Parse multiple classes and return their CSS
+   */
+  generateCssForClasses(s) {
+    return s.map((e) => ({
+      className: e,
+      css: this.generateCss(e)
+    }));
+  }
+}
+export {
+  u as ServerRuntime
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@barocss/server",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.cjs.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.cjs.js"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "jsdom": "^26.1.0",
+    "@barocss/kit": "0.0.2"
+  },
+  "devDependencies": {
+    "vite": "^7.1.3",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "vite build",
+    "build:library": "pnpm run build",
+    "test:watch": "vitest",
+    "//test": "vitest run",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src/**/*.ts"
+  },
+  "module": "./dist/index.es.js"
+}