css2class 2.0.0

package/src/docs/DocsServer.js

@@ -0,0 +1,179 @@
+const { spawn } = require('child_process');
+const fs = require('fs');
+const net = require('net');
+const path = require('path');
+
+/**
+ * VitePress 文档服务器管理器
+ */
+class DocsServer {
+  constructor(eventBus) {
+    this.eventBus = eventBus;
+    this.process = null;
+    this.port = null;
+    this.host = null;
+    this.docsDir = path.join(__dirname, '../../docs');
+  }
+
+  /**
+   * 获取可用端口
+   * @param {number} startPort - 起始端口
+   * @returns {Promise<number>}
+   */
+  async getAvailablePort(startPort = 5173) {
+    return new Promise((resolve, reject) => {
+      const server = net.createServer();
+
+      server.listen(startPort, () => {
+        const port = server.address().port;
+        server.close(() => {
+          resolve(port);
+        });
+      });
+
+      server.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+          // 端口被占用，尝试下一个端口
+          try {
+            server.close(() => {});
+          } catch (_) {}
+          this.getAvailablePort(startPort + 1)
+            .then(resolve)
+            .catch(reject);
+        } else {
+          try {
+            server.close(() => {});
+          } catch (_) {}
+          reject(err);
+        }
+      });
+    });
+  }
+
+  /**
+   * 启动 VitePress 开发服务器
+   * @param {Object} options - 启动选项
+   * @param {number} options.port - 端口号（默认自动寻找）
+   * @param {string} options.host - 主机地址（默认 127.0.0.1）
+   * @returns {Promise<{port: number, url: string}>}
+   */
+  async start(options = {}) {
+    if (this.process) {
+      throw new Error('Docs server is already running');
+    }
+
+    const { port: requestedPort = 5173, host = '127.0.0.1' } = options;
+
+    // 获取可用端口
+    this.port = await this.getAvailablePort(requestedPort);
+    this.host = host;
+
+    // 查找 VitePress CLI 脚本
+    const vitepressPath = path.join(__dirname, '../../node_modules/vitepress/bin/vitepress.js');
+
+    // 检查 VitePress 是否已安装
+    if (!fs.existsSync(vitepressPath)) {
+      throw new Error(
+        'VitePress is not installed. Please run: npm install --save-dev vitepress'
+      );
+    }
+
+    // 启动 VitePress dev server
+    const args = [
+      vitepressPath,
+      'dev',
+      this.docsDir,
+      '--port',
+      String(this.port),
+      '--host',
+      host
+    ];
+
+    const cwd = path.join(__dirname, '../..');
+
+    this.process = spawn(process.execPath, args, {
+      stdio: 'inherit',
+      cwd,
+      env: { ...process.env },
+    });
+
+    this.process.on('error', (error) => {
+      this.eventBus?.emit('docs:server:error', { error: error.message });
+    });
+
+    this.process.on('exit', (code) => {
+      this.process = null;
+      this.eventBus?.emit('docs:server:exited', { code });
+    });
+
+    const url = `http://${host}:${this.port}`;
+
+    // VitePress dev server 启动需要一点时间；这里做一个轻量延迟，避免立刻打开浏览器时失败
+    await new Promise((resolve) => setTimeout(resolve, 1200));
+
+    this.eventBus?.emit('docs:server:started', { port: this.port, host: this.host, url });
+
+    return { port: this.port, url };
+  }
+
+  /**
+   * 停止文档服务器
+   */
+  async stop() {
+    if (!this.process) {
+      return;
+    }
+
+    return new Promise((resolve) => {
+      const timeout = setTimeout(() => {
+        if (this.process) {
+          try {
+            this.process.kill('SIGKILL');
+          } catch (_) {}
+        }
+        resolve();
+      }, 5000);
+
+      this.process.on('exit', () => {
+        this.process = null;
+        this.eventBus?.emit('docs:server:stopped');
+        clearTimeout(timeout);
+        resolve();
+      });
+
+      // 发送终止信号
+      if (process.platform === 'win32') {
+        // Windows 使用 taskkill
+        spawn('taskkill', ['/pid', this.process.pid, '/F', '/T'], {
+          stdio: 'ignore',
+        });
+      } else {
+        // Unix-like 系统使用 kill
+        try {
+          this.process.kill('SIGTERM');
+        } catch (_) {}
+      }
+    });
+  }
+
+  /**
+   * 检查服务器是否运行中
+   * @returns {boolean}
+   */
+  isRunning() {
+    return this.process !== null && this.process.exitCode === null;
+  }
+
+  /**
+   * 获取服务器 URL
+   * @returns {string|null}
+   */
+  getUrl() {
+    if (!this.port || !this.host) {
+      return null;
+    }
+    return `http://${this.host}:${this.port}`;
+  }
+}
+
+module.exports = DocsServer;

package/src/example.js

@@ -0,0 +1,106 @@
+// Class2CSS 模块化版本使用示例
+const Class2CSS = require('./index');
+
+async function example() {
+  try {
+    // 创建 Class2CSS 实例
+    const class2css = new Class2CSS({
+      configPath: './class2css.config.js',
+      cacheSize: 1000,
+      logger: {
+        level: 'info',
+        enableDebug: true,
+        enableTimestamp: true,
+      },
+    });
+
+    // 获取事件总线进行监听
+    const eventBus = class2css.getEventBus();
+
+    // 监听重要事件
+    eventBus.on('class2css:started', () => {
+      console.log('Class2CSS started successfully!');
+    });
+
+    eventBus.on('parser:completed', (stats) => {
+      // console.log(`Parsing completed: ${stats.totalCount} classes found`);
+    });
+
+    eventBus.on('generator:dynamic:completed', (stats) => {
+      console.log(`Dynamic CSS generated: ${stats.generatedCount} classes`);
+    });
+
+    // 启动 Class2CSS
+    await class2css.start();
+
+    // 获取状态信息
+    const status = class2css.getStatus();
+    console.log('Class2CSS Status:', JSON.stringify(status, null, 2));
+
+    // 模拟文件变更处理
+    await class2css.handleFileChange('./example.html');
+
+    // 获取模块进行高级操作
+    const modules = class2css.getModules();
+
+    // 示例：直接使用解析器
+    const htmlContent = '<div class="w-100 h-50 bg-red text-white">Hello World</div>';
+    const parseResult = modules.classParser.parseClassOptimized(htmlContent);
+    console.log('Parse result:', parseResult);
+
+    // 示例：直接使用生成器
+    const generateResult = modules.dynamicClassGenerator.getClassList(parseResult.classArr);
+    console.log('Generated CSS length:', generateResult.cssStr.length);
+
+    // 停止 Class2CSS
+    class2css.stop();
+  } catch (error) {
+    console.error('Example failed:', error);
+  }
+}
+
+// 高级用法示例
+function advancedExample() {
+  const class2css = new Class2CSS();
+  const modules = class2css.getModules();
+
+  // 直接使用各个模块
+  const { logger, importantParser, regexCompiler } = modules;
+
+  // 测试 Important 标识
+  const testClasses = ['w-100', '!w-100', 'w-100_i', 'w-100-important'];
+  const importantResults = importantParser.batchProcessImportant(testClasses);
+  console.log('Important test results:', importantResults);
+
+  // 测试正则表达式
+  const regexStats = regexCompiler.getRegexStats();
+  console.log('Regex stats:', regexStats);
+
+  // 设置日志级别
+  logger.setLevel('debug');
+  logger.setDebugMode(true);
+
+  // 监听特定事件
+  const eventBus = class2css.getEventBus();
+  eventBus.on('important:detected', (data) => {
+    console.log('Important flag detected:', data);
+  });
+
+  eventBus.on('parser:static:found', (data) => {
+    console.log('Static class found:', data);
+  });
+}
+
+// 运行示例
+if (require.main === module) {
+  console.log('Running Class2CSS module example...');
+  example()
+    .then(() => {
+      console.log('Example completed');
+    })
+    .catch((error) => {
+      console.error('Example error:', error);
+    });
+}
+
+module.exports = { example, advancedExample };