@ikkin/plugin-unocss 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+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,407 @@
+# @ikkin/plugin-unocss
+
+[![npm version](https://badge.fury.io/js/@ikkin%2Fplugin-unocss.svg)](https://www.npmjs.com/package/@ikkin/plugin-unocss)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> UnoCSS plugin for Rsbuild with CLI pre-generation and automatic injection
+
+一个标准的 Rsbuild 插件，用于在项目中集成 UnoCSS，支持 CLI 预生成模式。
+
+## 特性
+
+✅ **CLI 预生成模式**: 扫描源文件并生成独立的 CSS 文件
+✅ **自动注入**: 通过 HTML 标签注入 CSS 链接，不污染源码
+✅ **Watch 模式**: 开发环境监听文件变化并自动重新生成 CSS
+✅ **浏览器自动刷新**: CSS 变化后自动刷新浏览器，无需手动刷新页面
+✅ **零配置**: 开箱即用，完全自动化
+✅ **类型安全**: 完整的 TypeScript 支持
+✅ **灵活配置**: 支持自定义监听目录和扫描模式
+✅ **开箱即用**: 内置 `globby` 和 `chokidar`，用户无需额外安装
+
+## 安装
+
+### 通过 NPM 安装（推荐）
+
+```bash
+# npm
+npm install @ikkin/plugin-unocss unocss
+
+# pnpm
+pnpm add @ikkin/plugin-unocss unocss
+
+# yarn
+yarn add @ikkin/plugin-unocss unocss
+```
+
+> **注意**: 插件已内置 `globby` 和 `chokidar`，你不需要额外安装这些依赖！
+
+### 本地开发
+
+如果你想在本地开发或修改插件：
+
+```bash
+# 在项目根目录
+pnpm install
+```
+
+## 使用方法
+
+### 1. 基础配置
+
+在 `rsbuild.config.ts` 中添加插件：
+
+```typescript
+import { defineConfig } from '@rsbuild/core';
+import { pluginReact } from '@rsbuild/plugin-react';
+import { pluginUnocss } from '@ikkin/plugin-unocss';
+
+export default defineConfig({
+  plugins: [
+    pluginReact(),
+    pluginUnocss(),
+  ],
+});
+```
+
+### 2. 创建 UnoCSS 配置文件
+
+在项目根目录创建 `uno.config.ts`：
+
+```typescript
+import { defineConfig, presetWind4 } from 'unocss';
+
+export default defineConfig({
+  content: {
+    filesystem: ['./src/**/*.{html,js,ts,jsx,tsx}', './index.html'],
+  },
+  presets: [presetWind4()],
+  shortcuts: {
+    'flex-center': 'flex items-center justify-center',
+  },
+});
+```
+
+### 3. 直接使用
+
+在组件中直接使用 UnoCSS 工具类：
+
+```tsx
+const App = () => {
+  return (
+    <div className="flex-center p-4 bg-blue-500 text-white">
+      Hello UnoCSS!
+    </div>
+  );
+};
+```
+
+## 工作原理
+
+### 构建流程
+
+1. **扫描文件**: 插件扫描配置的文件路径，提取所有使用的 UnoCSS 类名
+2. **生成 CSS**: 根据实际使用情况生成 CSS 文件
+   - **生产环境**: 生成带 hash 的文件名（如 `uno.a1b2c3d4.css`）
+   - **开发环境**: 生成固定文件名（`uno.css`）以支持热更新
+3. **自动注入**: 通过 HTML 标签注入 CSS 链接（不污染源码）
+   - **生产环境**: 复制 CSS 到 `dist/uno.[hash].css` 并在 HTML 中添加 `<link rel="stylesheet" href="/uno.[hash].css">`
+   - **开发环境**: 通过 dev server 中间件在 `/uno.css` 路径提供 CSS 文件
+4. **零配置**: 用户无需手动导入 CSS 文件
+
+### 为什么不污染源码？
+
+传统方案会修改 `src/index.tsx` 添加 import 语句，这样会：
+- ❌ 污染项目的源代码
+- ❌ 用户可能会误提交这个自动生成的导入
+- ❌ 代码审查时会看到不相关的修改
+
+本插件采用 HTML 注入方案：
+- ✅ 完全不修改源代码
+- ✅ 通过 HTML 标签自动注入 CSS 链接
+- ✅ 用户体验更加简洁
+
+### Watch 模式与自动刷新
+
+开发环境下的 watch 模式提供以下功能：
+
+1. **文件监听**: 监听指定目录（默认 `src`）下的文件变化
+2. **CSS 自动生成**: 文件添加、修改、删除时自动重新生成 CSS
+3. **浏览器自动刷新**: 使用 `devServer.sockWrite('static-changed', '/uno.css')` 触发浏览器 CSS 刷新
+4. **防抖机制**: 300ms 防抖，避免频繁重新生成
+
+这样你在开发时添加新组件或修改样式后，浏览器会立即显示最新的样式，无需手动刷新页面。
+
+### 输出路径
+
+默认情况下，生成的 CSS 文件位于：
+
+```
+plugins/generated/uno.css
+```
+
+你可以通过 `outputPath` 选项自定义输出路径：
+
+```typescript
+// 相对于项目根目录
+pluginUnocss({
+  outputPath: './src/styles/uno-generated.css',
+})
+```
+
+**路径解析规则**:
+- **以 `./` 前缀**: 相对于项目根目录（推荐，更明确）
+  - 例如：`./src/styles/uno.css` → `项目根目录/src/styles/uno.css`
+- **相对路径（不带 `./`）**: 相对于插件目录（更简洁）
+  - 例如：`generated/uno.css` → `plugins/generated/uno.css`
+- **绝对路径**: 直接使用绝对路径
+  - 例如：`/custom/path/uno.css` → `/custom/path/uno.css`
+- **未配置**: 默认相对于插件目录
+  - 默认：`plugins/generated/uno.css`
+
+**默认路径的好处**:
+- 在插件目录内，不会污染项目源码
+- 当插件作为 npm 包发布时，用户看不到生成的文件
+- 可以通过 `.gitignore` 忽略
+
+## 配置选项
+
+```typescript
+pluginUnocss({
+  // UnoCSS 配置文件路径或直接配置对象
+  unocssConfig: './uno.config.ts',
+
+  // 生成 CSS 的输出路径
+  // 以 `./` 开头：相对于项目根目录（推荐，更明确）
+  // 相对路径（不带 `./`）：相对于插件目录（更简洁）
+  // 绝对路径：使用绝对路径
+  // 未配置：默认相对于插件目录
+  outputPath: './generated/uno.css',
+
+  // 扫描的文件路径模式
+  contentPatterns: [
+    './src/**/*.{html,js,ts,jsx,tsx}',
+    './index.html',
+  ],
+
+  // 监听的目录路径（用于 watch 模式）
+  watchDirectory: 'src',
+
+  // 是否自动注入 CSS
+  autoInject: true,
+
+  // 是否启用 watch 模式
+  watch: true,
+
+  // 是否在文件名中添加 hash 值（仅生产环境）
+  enableHash: true,
+})
+```
+
+### 选项说明
+
+#### `unocssConfig`
+
+- **类型**: `string | UserConfig`
+- **默认值**: `'./uno.config.ts'`
+- **说明**: UnoCSS 配置文件路径（相对于项目根目录）或直接传入配置对象
+
+#### `outputPath`
+
+- **类型**: `string`
+- **默认值**: `'./generated/uno.css'`
+- **说明**: 生成的 CSS 文件输出路径
+- **路径解析规则**:
+  - 以 `./` 开头：相对于项目根目录（推荐，更明确）
+  - 相对路径（不带 `./`）：相对于插件目录（更简洁）
+  - 绝对路径：使用绝对路径
+  - 未配置：默认相对于插件目录
+
+**示例**:
+```typescript
+// 推荐用法：相对于项目根目录
+pluginUnocss({
+  outputPath: './src/styles/uno-generated.css',
+  // 生成到: 项目根目录/src/styles/uno-generated.css
+})
+
+// 相对于插件目录（更简洁）
+pluginUnocss({
+  outputPath: 'generated/uno.css',
+  // 生成到: plugins/generated/uno.css
+})
+
+// 使用绝对路径
+pluginUnocss({
+  outputPath: '/absolute/path/to/file.css',
+  // 生成到: /absolute/path/to/file.css
+})
+```
+
+#### `contentPatterns`
+
+- **类型**: `string[]`
+- **默认值**: `['./src/**/*.{html,js,ts,jsx,tsx}', './index.html']`
+- **说明**: 用于扫描 UnoCSS 类名的文件 glob 模式数组
+
+#### `watchDirectory`
+
+- **类型**: `string`
+- **默认值**: `'src'`
+- **说明**: Watch 模式下监听的目录路径（相对于项目根目录）
+- **示例**: 如果你的源代码在 `packages` 目录，可以设置为 `'packages'`
+
+#### `autoInject`
+
+- **类型**: `boolean`
+- **默认值**: `true`
+- **说明**: 是否自动在 HTML 中注入 CSS 链接标签
+
+#### `watch`
+
+- **类型**: `boolean`
+- **默认值**: `true`
+- **说明**: 是否在开发环境启用 watch 模式
+
+#### `enableHash`
+
+- **类型**: `boolean`
+- **默认值**: `true`
+- **说明**: 是否在文件名中添加 hash 值（仅生产环境）
+- **作用**:
+  - ✅ 浏览器缓存优化：CSS 变化时 hash 也变化，强制浏览器重新加载
+  - ✅ CDN 友好：可以设置长期缓存策略
+  - ✅ 版本管理：每个版本的 CSS 都有唯一文件名
+- **示例**:
+  - 启用：`uno.a1b2c3d4.css`
+  - 禁用：`uno.css`
+
+## 开发 vs 生产环境
+
+### 开发环境
+
+- ✅ 启动时生成 CSS
+- ✅ Watch 模式监听文件变化（需要 `chokidar`）
+- ✅ 文件添加、修改、删除时自动重新生成 CSS
+- ✅ 浏览器自动刷新 CSS（无需手动刷新页面）
+- ✅ 通过 dev server 中间件提供 CSS 文件
+
+### 生产环境
+
+- ✅ 构建前生成 CSS
+- ✅ CSS 文件名包含内容 hash（如 `uno.a1b2c3d4.css`）
+- ✅ CSS 复制到 `dist/uno.[hash].css`
+- ✅ 自动注入带 hash 的 CSS 链接到 HTML
+- ✅ 浏览器缓存优化：文件变化时 hash 自动更新
+
+## 高级用法
+
+### 自定义监听目录
+
+如果你的项目结构比较复杂，可以自定义监听的目录：
+
+```typescript
+// rsbuild.config.ts
+export default defineConfig({
+  plugins: [
+    pluginUnocss({
+      watchDirectory: 'packages',  // 监听 packages 目录
+      contentPatterns: [
+        './packages/**/*.{html,js,ts,jsx,tsx}',
+        './index.html',
+      ],
+    }),
+  ],
+});
+```
+
+### 直接传入 UnoCSS 配置
+
+也可以不使用配置文件，直接传入 UnoCSS 配置对象：
+
+```typescript
+import { presetWind4 } from 'unocss';
+
+export default defineConfig({
+  plugins: [
+    pluginUnocss({
+      unocssConfig: {
+        presets: [presetWind4()],
+        shortcuts: {
+          'flex-center': 'flex items-center justify-center',
+        },
+      },
+    }),
+  ],
+});
+```
+
+### 禁用自动注入
+
+如果你想手动控制 CSS 的导入，可以禁用自动注入：
+
+```typescript
+export default defineConfig({
+  plugins: [
+    pluginUnocss({
+      autoInject: false,  // 禁用自动注入
+    }),
+  ],
+});
+```
+
+然后手动在入口文件中导入生成的 CSS：
+
+```typescript
+// src/index.tsx
+import '../plugins/generated/uno.css';
+```
+
+## 注意事项
+
+1. **生成的文件不需要提交到 Git**
+   - `plugins/generated/` 目录已加入 `.gitignore`
+   - 每次构建时会自动重新生成
+
+2. **Watch 模式需要 `chokidar`**
+   - 如果未安装，watch 模式会自动跳过并显示警告
+   - 安装命令: `pnpm add -D chokidar`
+
+3. **CSS 自动注入**
+   - 生产环境：CSS 会被复制到 `dist/uno.css` 并自动注入到 HTML
+   - 开发环境：通过 dev server 中间件提供 CSS 文件
+   - 无需手动导入或修改源代码
+
+4. **纯 CSS 输出**
+   - 插件生成纯 CSS 文件，包含所有使用的工具类
+   - 不会注入虚拟 CSS 模块到构建流程
+   - 生成的 CSS 可被浏览器直接缓存
+
+5. **文件变化检测**
+   - Watch 模式会监听指定目录下的所有 `.html`、`.js`、`.ts`、`.jsx`、`.tsx` 文件
+   - 文件添加、修改、删除都会触发 CSS 重新生成
+   - 300ms 防抖机制避免频繁重新生成
+
+## 优势对比
+
+| 特性 | UnoCSS Plugin | PostCSS 方案 | CLI 手动方案 |
+|------|---------------|-------------|-------------|
+| 配置复杂度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ |
+| 开发体验 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
+| 生产优化 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
+| 自动化程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
+| CSS 可见性 | ✅ | ❌ | ✅ |
+| Watch 支持 | ✅ 自动 | ✅ | ⚠️ 需手动配置 |
+| 浏览器自动刷新 | ✅ | ✅ | ❌ |
+| 源码污染 | ❌ | ❌ | ⚠️ 可能 |
+| 灵活配置 | ✅ | ⚠️ | ⚠️ |
+
+## 许可证
+
+MIT
+
+## 相关链接
+
+- [UnoCSS 官方文档](https://unocss.dev/)
+- [Rsbuild 官方文档](https://rsbuild.rs/)
+- [插件 GitHub 仓库](https://github.com/yourusername/plugin-unocss)
+

package/dist/plugin-unocss.d.mts

@@ -0,0 +1,62 @@
+import { RsbuildPlugin } from '@rsbuild/core';
+import { UserConfig } from 'unocss';
+
+interface PluginUnocssOptions {
+    /** UnoCSS 配置文件路径或直接配置对象 (默认: './uno.config.ts') */
+    unocssConfig?: string | UserConfig;
+    /**
+     * 生成的 CSS 文件输出路径
+     *
+     * 路径解析规则:
+     *  - 以 './' 开头: 相对于项目根目录 (推荐)
+     *  - 相对路径: 相对于插件目录
+     *  - 绝对路径: 直接使用
+     *  - 未配置: 默认为 'generated/uno.css' 相对于插件目录
+     */
+    outputPath?: string;
+    /** 扫描的内容文件路径模式 (支持 glob 模式) */
+    contentPatterns?: string[];
+    /** 监听的目录路径 (用于开发环境的 watch 模式, 默认: 'src') */
+    watchDirectory?: string;
+    /** 是否自动在 HTML 中注入生成的 CSS link 标签 (默认: true) */
+    autoInject?: boolean;
+    /** 是否在开发环境启用文件监听模式 (默认: true) */
+    watch?: boolean;
+    /**
+     * 是否在生产环境为 CSS 文件名添加 content hash
+     *
+     * 启用后, 文件名格式为 'uno.[hash].css', hash 基于 CSS 内容生成 (默认: true)
+     */
+    enableHash?: boolean;
+}
+/**
+ * UnoCSS Plugin for Rsbuild
+ *
+ * 一个用于 Rsbuild 的 UnoCSS 插件,提供 CLI 预生成和自动注入功能.
+ *
+ * 特性:
+ * - 扫描项目文件并生成独立的 CSS 文件
+ * - 开发环境支持文件监听和热更新
+ * - 生产环境支持 CSS 文件名 hash
+ * - 自动在 HTML 中注入 CSS link 标签
+ *
+ * @param options - 插件配置选项
+ * @returns Rsbuild 插件实例
+ *
+ * @example
+ * ```ts
+ * import { pluginUnocss } from '@ikkin/plugin-unocss';
+ *
+ * export default {
+ *   plugins: [
+ *     pluginUnocss({
+ *       outputPath: './src/generated/uno.css',
+ *       enableHash: true,
+ *     })
+ *   ]
+ * };
+ * ```
+ */
+declare function pluginUnocss(options?: PluginUnocssOptions): RsbuildPlugin;
+
+export { type PluginUnocssOptions, pluginUnocss as default, pluginUnocss };

package/dist/plugin-unocss.d.ts

@@ -0,0 +1,62 @@
+import { RsbuildPlugin } from '@rsbuild/core';
+import { UserConfig } from 'unocss';
+
+interface PluginUnocssOptions {
+    /** UnoCSS 配置文件路径或直接配置对象 (默认: './uno.config.ts') */
+    unocssConfig?: string | UserConfig;
+    /**
+     * 生成的 CSS 文件输出路径
+     *
+     * 路径解析规则:
+     *  - 以 './' 开头: 相对于项目根目录 (推荐)
+     *  - 相对路径: 相对于插件目录
+     *  - 绝对路径: 直接使用
+     *  - 未配置: 默认为 'generated/uno.css' 相对于插件目录
+     */
+    outputPath?: string;
+    /** 扫描的内容文件路径模式 (支持 glob 模式) */
+    contentPatterns?: string[];
+    /** 监听的目录路径 (用于开发环境的 watch 模式, 默认: 'src') */
+    watchDirectory?: string;
+    /** 是否自动在 HTML 中注入生成的 CSS link 标签 (默认: true) */
+    autoInject?: boolean;
+    /** 是否在开发环境启用文件监听模式 (默认: true) */
+    watch?: boolean;
+    /**
+     * 是否在生产环境为 CSS 文件名添加 content hash
+     *
+     * 启用后, 文件名格式为 'uno.[hash].css', hash 基于 CSS 内容生成 (默认: true)
+     */
+    enableHash?: boolean;
+}
+/**
+ * UnoCSS Plugin for Rsbuild
+ *
+ * 一个用于 Rsbuild 的 UnoCSS 插件,提供 CLI 预生成和自动注入功能.
+ *
+ * 特性:
+ * - 扫描项目文件并生成独立的 CSS 文件
+ * - 开发环境支持文件监听和热更新
+ * - 生产环境支持 CSS 文件名 hash
+ * - 自动在 HTML 中注入 CSS link 标签
+ *
+ * @param options - 插件配置选项
+ * @returns Rsbuild 插件实例
+ *
+ * @example
+ * ```ts
+ * import { pluginUnocss } from '@ikkin/plugin-unocss';
+ *
+ * export default {
+ *   plugins: [
+ *     pluginUnocss({
+ *       outputPath: './src/generated/uno.css',
+ *       enableHash: true,
+ *     })
+ *   ]
+ * };
+ * ```
+ */
+declare function pluginUnocss(options?: PluginUnocssOptions): RsbuildPlugin;
+
+export { type PluginUnocssOptions, pluginUnocss as default, pluginUnocss };

package/dist/plugin-unocss.js

@@ -0,0 +1,255 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var fs = require('fs');
+var path = require('path');
+var url = require('url');
+var crypto = require('crypto');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
+var path__namespace = /*#__PURE__*/_interopNamespace(path);
+
+// plugin-unocss.ts
+var __filename$1 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('plugin-unocss.js', document.baseURI).href)));
+var __dirname$1 = path__namespace.dirname(__filename$1);
+function pluginUnocss(options = {}) {
+  const {
+    unocssConfig = "./uno.config.ts",
+    outputPath = "",
+    contentPatterns = [
+      "./src/**/*.{html,js,ts,jsx,tsx}",
+      "./index.html"
+    ],
+    watchDirectory = "src",
+    autoInject = true,
+    watch = true,
+    enableHash = true
+  } = options;
+  return {
+    name: "unocss",
+    setup(api) {
+      const rootContext = api.context.rootPath;
+      const pluginDir = __dirname$1;
+      let resolvedOutputPath;
+      if (!outputPath) {
+        resolvedOutputPath = path__namespace.resolve(pluginDir, "./generated/uno.css");
+      } else if (path__namespace.isAbsolute(outputPath)) {
+        resolvedOutputPath = outputPath;
+      } else if (outputPath.startsWith("./")) {
+        resolvedOutputPath = path__namespace.resolve(rootContext, outputPath);
+      } else {
+        resolvedOutputPath = path__namespace.resolve(pluginDir, outputPath);
+      }
+      let currentCssPath = resolvedOutputPath;
+      let devServerInstance = null;
+      const isProd = process.env.NODE_ENV === "production";
+      const loadConfig = async () => {
+        if (typeof unocssConfig === "string") {
+          const configPath = path__namespace.resolve(rootContext, unocssConfig);
+          try {
+            const configModule = await import(`file:///${configPath.replace(/\\/g, "/")}`);
+            return configModule.default || configModule;
+          } catch (err) {
+            console.warn(
+              `[UnoCSS Hybrid] Failed to load config from ${configPath}, using default config`
+            );
+            return {};
+          }
+        }
+        return unocssConfig;
+      };
+      const generateCSS = async () => {
+        console.log("[UnoCSS Hybrid] Generating CSS...");
+        try {
+          const config = await loadConfig();
+          const { globby } = await import('globby');
+          const files = await globby(contentPatterns, {
+            cwd: rootContext,
+            absolute: true
+          });
+          if (files.length === 0) {
+            console.warn("[UnoCSS Hybrid] No files found to scan");
+            return resolvedOutputPath;
+          }
+          console.log(`[UnoCSS Hybrid] Found ${files.length} files to scan`);
+          console.log(`[UnoCSS Hybrid] Files:`, files.map((f) => path__namespace.relative(rootContext, f)));
+          const { createGenerator } = await import('unocss');
+          const generator = await createGenerator(config);
+          const allContents = files.map((file) => {
+            const content = fs__namespace.readFileSync(file, "utf-8");
+            return content;
+          }).join("\n");
+          const result = await generator.generate(allContents);
+          if (!result.css || result.css.trim().length === 0) {
+            console.warn("[UnoCSS Hybrid] Generated CSS is empty");
+            return resolvedOutputPath;
+          }
+          let finalOutputPath;
+          if (isProd && enableHash) {
+            const distDir = path__namespace.join(rootContext, "dist");
+            const hash = crypto.createHash("md5").update(result.css).digest("hex").substring(0, 8);
+            finalOutputPath = path__namespace.join(distDir, `uno.${hash}.css`);
+            currentCssPath = finalOutputPath;
+          } else {
+            finalOutputPath = resolvedOutputPath;
+            currentCssPath = resolvedOutputPath;
+          }
+          const outputDir = path__namespace.dirname(finalOutputPath);
+          if (!fs__namespace.existsSync(outputDir)) {
+            fs__namespace.mkdirSync(outputDir, { recursive: true });
+          }
+          fs__namespace.writeFileSync(finalOutputPath, result.css);
+          const stats = fs__namespace.statSync(finalOutputPath);
+          console.log(
+            `[UnoCSS Hybrid] CSS generated: ${finalOutputPath} (${(stats.size / 1024).toFixed(2)} KB)`
+          );
+          return finalOutputPath;
+        } catch (err) {
+          console.error("[UnoCSS Hybrid] Failed to generate CSS:", err);
+          return resolvedOutputPath;
+        }
+      };
+      if (isProd) {
+        api.onBeforeBuild(async () => {
+          await generateCSS();
+        });
+      }
+      if (autoInject) {
+        api.modifyHTMLTags((tags) => {
+          let cssPath;
+          if (isProd && enableHash) {
+            const cssFileName = path__namespace.basename(currentCssPath);
+            cssPath = `/${cssFileName}`;
+          } else {
+            cssPath = "/uno.css";
+          }
+          tags.headTags.unshift({
+            tag: "link",
+            attrs: {
+              rel: "stylesheet",
+              href: cssPath
+            }
+          });
+          console.log(`[UnoCSS Hybrid] Auto-injected CSS link: ${cssPath}`);
+          return tags;
+        });
+      }
+      if (!isProd) {
+        api.modifyRsbuildConfig((config) => {
+          const existingSetupMiddlewares = config.dev?.setupMiddlewares;
+          const setupMiddlewaresArray = Array.isArray(existingSetupMiddlewares) ? existingSetupMiddlewares : existingSetupMiddlewares ? [existingSetupMiddlewares] : [];
+          return {
+            ...config,
+            dev: {
+              ...config.dev,
+              setupMiddlewares: [
+                ...setupMiddlewaresArray,
+                (middlewares, devServer) => {
+                  devServerInstance = devServer;
+                  middlewares.unshift(async (req, res, next) => {
+                    if (req.url === "/uno.css") {
+                      try {
+                        if (!fs__namespace.existsSync(resolvedOutputPath)) {
+                          res.statusCode = 404;
+                          res.setHeader("Content-Type", "text/plain; charset=utf-8");
+                          res.end("CSS file not found. Please restart the dev server to generate it.");
+                          console.warn("[UnoCSS Hybrid] CSS file not found at:", resolvedOutputPath);
+                          return;
+                        }
+                        res.setHeader("Content-Type", "text/css; charset=utf-8");
+                        res.setHeader("Cache-Control", "no-cache");
+                        const css = fs__namespace.readFileSync(resolvedOutputPath, "utf-8");
+                        res.end(css);
+                      } catch (err) {
+                        console.error("[UnoCSS Hybrid] Error serving CSS:", err);
+                        res.statusCode = 500;
+                        res.setHeader("Content-Type", "text/plain; charset=utf-8");
+                        res.end("Error loading CSS file. Check console for details.");
+                      }
+                    } else {
+                      next();
+                    }
+                  });
+                }
+              ]
+            }
+          };
+        });
+        api.onBeforeStartDevServer(async () => {
+          console.log("[UnoCSS Hybrid] Development mode: CLI generation enabled");
+          await generateCSS();
+        });
+        api.onAfterStartDevServer(async () => {
+          console.log("[UnoCSS Hybrid] Dev server started, CSS available at /uno.css");
+          if (watch) {
+            try {
+              const chokidar = await import('chokidar');
+              const watchDir = path__namespace.resolve(rootContext, watchDirectory);
+              const watcher = chokidar.watch(watchDir, {
+                ignored: /(^|[\/\\])\../,
+                // ignore dotfiles
+                ignoreInitial: true,
+                persistent: true
+              });
+              let regenerateTimer = null;
+              watcher.on("all", async (event, filePath) => {
+                const ext = path__namespace.extname(filePath);
+                const shouldWatch = [".html", ".js", ".ts", ".jsx", ".tsx"].includes(ext);
+                if (shouldWatch && (event === "change" || event === "add" || event === "unlink")) {
+                  console.log(`[UnoCSS Hybrid] File ${event}: ${path__namespace.relative(rootContext, filePath)}`);
+                  if (regenerateTimer) {
+                    clearTimeout(regenerateTimer);
+                  }
+                  regenerateTimer = setTimeout(async () => {
+                    console.log("[UnoCSS Hybrid] Regenerating CSS...");
+                    await generateCSS();
+                    console.log("[UnoCSS Hybrid] Refreshing CSS in browser...");
+                    devServerInstance?.sockWrite("static-changed", "/uno.css");
+                  }, 300);
+                }
+              });
+              console.log("[UnoCSS Hybrid] Watch mode: enabled");
+            } catch (err) {
+              console.warn("[UnoCSS Hybrid] Watch mode not available:", err.message);
+            }
+          }
+        });
+      }
+      api.onAfterBuild(() => {
+        if (isProd && fs__namespace.existsSync(currentCssPath)) {
+          const stats = fs__namespace.statSync(currentCssPath);
+          const fileName = path__namespace.basename(currentCssPath);
+          console.log(
+            `[UnoCSS Hybrid] Final CSS: ${fileName} (${(stats.size / 1024).toFixed(2)} KB)`
+          );
+        }
+      });
+    }
+  };
+}
+var plugin_unocss_default = pluginUnocss;
+
+exports.default = plugin_unocss_default;
+exports.pluginUnocss = pluginUnocss;
+//# sourceMappingURL=plugin-unocss.js.map
+//# sourceMappingURL=plugin-unocss.js.map

package/dist/plugin-unocss.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../plugin-unocss.ts"],"names":["__filename","fileURLToPath","__dirname","path","fs","createHash"],"mappings":"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","file":"plugin-unocss.js","sourcesContent":["import type { RsbuildPlugin } from '@rsbuild/core';\nimport type { UserConfig } from 'unocss';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { fileURLToPath } from 'url';\nimport { createHash } from 'crypto';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nexport interface PluginUnocssOptions {\n  /** UnoCSS 配置文件路径或直接配置对象 (默认: './uno.config.ts') */\n  unocssConfig?: string | UserConfig;\n\n  /**\n   * 生成的 CSS 文件输出路径\n   *\n   * 路径解析规则:\n   *  - 以 './' 开头: 相对于项目根目录 (推荐)\n   *  - 相对路径: 相对于插件目录\n   *  - 绝对路径: 直接使用\n   *  - 未配置: 默认为 'generated/uno.css' 相对于插件目录\n   */\n  outputPath?: string;\n\n  /** 扫描的内容文件路径模式 (支持 glob 模式) */\n  contentPatterns?: string[];\n\n  /** 监听的目录路径 (用于开发环境的 watch 模式, 默认: 'src') */\n  watchDirectory?: string;\n\n  /** 是否自动在 HTML 中注入生成的 CSS link 标签 (默认: true) */\n  autoInject?: boolean;\n\n  /** 是否在开发环境启用文件监听模式 (默认: true) */\n  watch?: boolean;\n\n  /**\n   * 是否在生产环境为 CSS 文件名添加 content hash\n   *\n   * 启用后, 文件名格式为 'uno.[hash].css', hash 基于 CSS 内容生成 (默认: true)\n   */\n  enableHash?: boolean;\n}\n\n/**\n * UnoCSS Plugin for Rsbuild\n *\n * 一个用于 Rsbuild 的 UnoCSS 插件,提供 CLI 预生成和自动注入功能.\n *\n * 特性:\n * - 扫描项目文件并生成独立的 CSS 文件\n * - 开发环境支持文件监听和热更新\n * - 生产环境支持 CSS 文件名 hash\n * - 自动在 HTML 中注入 CSS link 标签\n *\n * @param options - 插件配置选项\n * @returns Rsbuild 插件实例\n *\n * @example\n * ```ts\n * import { pluginUnocss } from '@ikkin/plugin-unocss';\n *\n * export default {\n *   plugins: [\n *     pluginUnocss({\n *       outputPath: './src/generated/uno.css',\n *       enableHash: true,\n *     })\n *   ]\n * };\n * ```\n */\nexport function pluginUnocss(\n  options: PluginUnocssOptions = {},\n): RsbuildPlugin {\n  const {\n    unocssConfig = './uno.config.ts',\n    outputPath = '',\n    contentPatterns = [\n      './src/**/*.{html,js,ts,jsx,tsx}',\n      './index.html',\n    ],\n    watchDirectory = 'src',\n    autoInject = true,\n    watch = true,\n    enableHash = true,\n  } = options;\n\n  return {\n    name: 'unocss',\n\n    setup(api) {\n      const rootContext = api.context.rootPath;\n\n      // 解析输出路径\n      const pluginDir = __dirname;\n      let resolvedOutputPath: string;\n\n      if (!outputPath) {\n        // 未配置：使用默认路径（相对于插件目录）\n        resolvedOutputPath = path.resolve(pluginDir, './generated/uno.css');\n      } else if (path.isAbsolute(outputPath)) {\n        // 绝对路径：直接使用\n        resolvedOutputPath = outputPath;\n      } else if (outputPath.startsWith('./')) {\n        // 以 ./ 开头：相对于项目根目录（推荐，更明确）\n        resolvedOutputPath = path.resolve(rootContext, outputPath);\n      } else {\n        // 相对路径（不带 ./）：相对于插件目录（更简洁）\n        resolvedOutputPath = path.resolve(pluginDir, outputPath);\n      }\n\n      // 用于保存当前生成的 CSS 文件路径（可能包含 hash）\n      let currentCssPath = resolvedOutputPath;\n\n      // 用于保存 dev server 实例，以便在文件变化时触发刷新\n      let devServerInstance: any = null;\n\n      // 通过环境变量判断是否是生产环境\n      const isProd = process.env.NODE_ENV === 'production';\n\n      // 读取 UnoCSS 配置\n      const loadConfig = async (): Promise<UserConfig> => {\n        if (typeof unocssConfig === 'string') {\n          const configPath = path.resolve(rootContext, unocssConfig);\n          try {\n            const configModule = await import(\n              `file:///${configPath.replace(/\\\\/g, '/')}`\n            );\n            return configModule.default || configModule;\n          } catch (err) {\n            console.warn(\n              `[UnoCSS Hybrid] Failed to load config from ${configPath}, using default config`,\n            );\n            return {};\n          }\n        }\n        return unocssConfig;\n      };\n\n      // 生成 UnoCSS CSS\n      const generateCSS = async (): Promise<string> => {\n        console.log('[UnoCSS Hybrid] Generating CSS...');\n\n        try {\n          const config = await loadConfig();\n\n          // 扫描文件\n          const { globby } = await import('globby');\n          const files = await globby(contentPatterns, {\n            cwd: rootContext,\n            absolute: true,\n          });\n\n          if (files.length === 0) {\n            console.warn('[UnoCSS Hybrid] No files found to scan');\n            return resolvedOutputPath;\n          }\n\n          console.log(`[UnoCSS Hybrid] Found ${files.length} files to scan`);\n          console.log(`[UnoCSS Hybrid] Files:`, files.map(f => path.relative(rootContext, f)));\n\n          // 使用 UnoCSS generator\n          const { createGenerator } = await import('unocss');\n          const generator = await createGenerator(config);\n\n          // 读取所有文件内容并生成\n          const allContents = files.map(file => {\n            const content = fs.readFileSync(file, 'utf-8');\n            return content;\n          }).join('\\n');\n\n          // 生成 CSS\n          const result = await generator.generate(allContents);\n\n          if (!result.css || result.css.trim().length === 0) {\n            console.warn('[UnoCSS Hybrid] Generated CSS is empty');\n            return resolvedOutputPath;\n          }\n\n          // 计算输出路径\n          let finalOutputPath: string;\n          if (isProd && enableHash) {\n            // 生产环境：直接生成到 dist 目录，文件名带 hash\n            const distDir = path.join(rootContext, 'dist');\n            const hash = createHash('md5').update(result.css).digest('hex').substring(0, 8);\n            finalOutputPath = path.join(distDir, `uno.${hash}.css`);\n            currentCssPath = finalOutputPath;\n          } else {\n            // 开发环境：生成到插件目录的 generated 子目录，文件名固定\n            finalOutputPath = resolvedOutputPath;\n            currentCssPath = resolvedOutputPath;\n          }\n\n          // 确保输出目录存在\n          const outputDir = path.dirname(finalOutputPath);\n          if (!fs.existsSync(outputDir)) {\n            fs.mkdirSync(outputDir, { recursive: true });\n          }\n\n          // 写入 CSS 文件\n          fs.writeFileSync(finalOutputPath, result.css);\n\n          const stats = fs.statSync(finalOutputPath);\n          console.log(\n            `[UnoCSS Hybrid] CSS generated: ${finalOutputPath} (${(stats.size / 1024).toFixed(2)} KB)`,\n          );\n\n          return finalOutputPath;\n        } catch (err) {\n          console.error('[UnoCSS Hybrid] Failed to generate CSS:', err);\n          return resolvedOutputPath;\n        }\n      };\n\n      // 生产环境：构建前生成 CSS\n      if (isProd) {\n        api.onBeforeBuild(async () => {\n          await generateCSS();\n        });\n      }\n\n      // 自动注入：通过修改 HTML 标签来注入 CSS（不污染源码）\n      if (autoInject) {\n        api.modifyHTMLTags((tags) => {\n          let cssPath: string;\n\n          if (isProd && enableHash) {\n            // 生产环境：使用带 hash 的文件名\n            const cssFileName = path.basename(currentCssPath);\n            cssPath = `/${cssFileName}`;\n          } else {\n            // 开发环境或未启用 hash：使用固定文件名\n            cssPath = '/uno.css';\n          }\n\n          tags.headTags.unshift({\n            tag: 'link',\n            attrs: {\n              rel: 'stylesheet',\n              href: cssPath,\n            },\n          });\n\n          console.log(`[UnoCSS Hybrid] Auto-injected CSS link: ${cssPath}`);\n          return tags;\n        });\n      }\n\n      // 开发环境：配置静态文件服务\n      if (!isProd) {\n        api.modifyRsbuildConfig((config) => {\n          const existingSetupMiddlewares = config.dev?.setupMiddlewares;\n          const setupMiddlewaresArray = Array.isArray(existingSetupMiddlewares)\n            ? existingSetupMiddlewares\n            : existingSetupMiddlewares\n              ? [existingSetupMiddlewares]\n              : [];\n\n          return {\n            ...config,\n            dev: {\n              ...config.dev,\n              setupMiddlewares: [\n                ...setupMiddlewaresArray,\n                (middlewares, devServer) => {\n                  // 保存 dev server 实例\n                  devServerInstance = devServer;\n\n                  // 添加自定义中间件来提供 CSS 文件\n                  middlewares.unshift(async (req, res, next) => {\n                    if (req.url === '/uno.css') {\n                      try {\n                        // 检查文件是否存在\n                        if (!fs.existsSync(resolvedOutputPath)) {\n                          res.statusCode = 404;\n                          res.setHeader('Content-Type', 'text/plain; charset=utf-8');\n                          res.end('CSS file not found. Please restart the dev server to generate it.');\n                          console.warn('[UnoCSS Hybrid] CSS file not found at:', resolvedOutputPath);\n                          return;\n                        }\n\n                        // 设置正确的 Content-Type 和缓存控制\n                        res.setHeader('Content-Type', 'text/css; charset=utf-8');\n                        res.setHeader('Cache-Control', 'no-cache');\n\n                        const css = fs.readFileSync(resolvedOutputPath, 'utf-8');\n                        res.end(css);\n                      } catch (err) {\n                        console.error('[UnoCSS Hybrid] Error serving CSS:', err);\n                        res.statusCode = 500;\n                        res.setHeader('Content-Type', 'text/plain; charset=utf-8');\n                        res.end('Error loading CSS file. Check console for details.');\n                      }\n                    } else {\n                      next();\n                    }\n                  });\n                },\n              ],\n            },\n          };\n        });\n\n        // 启动时生成 CSS\n        api.onBeforeStartDevServer(async () => {\n          console.log('[UnoCSS Hybrid] Development mode: CLI generation enabled');\n          await generateCSS();\n        });\n\n        // 合并启动后的操作\n        api.onAfterStartDevServer(async () => {\n          console.log('[UnoCSS Hybrid] Dev server started, CSS available at /uno.css');\n\n          // Watch 模式\n          if (watch) {\n            try {\n              // 动态导入 chokidar\n              const chokidar = await import('chokidar');\n\n              // 监听指定目录\n              const watchDir = path.resolve(rootContext, watchDirectory);\n\n              // 监听内容文件变化\n              const watcher = chokidar.watch(watchDir, {\n                ignored: /(^|[\\/\\\\])\\../, // ignore dotfiles\n                ignoreInitial: true,\n                persistent: true,\n              });\n\n              // 防抖：避免频繁重新生成\n              let regenerateTimer: NodeJS.Timeout | null = null;\n\n              watcher.on('all', async (event: string, filePath: string) => {\n                // 检查文件扩展名\n                const ext = path.extname(filePath);\n                const shouldWatch = ['.html', '.js', '.ts', '.jsx', '.tsx'].includes(ext);\n\n                // 监听文件添加、修改和删除\n                if (shouldWatch && (event === 'change' || event === 'add' || event === 'unlink')) {\n                  console.log(`[UnoCSS Hybrid] File ${event}: ${path.relative(rootContext, filePath)}`);\n\n                  if (regenerateTimer) {\n                    clearTimeout(regenerateTimer);\n                  }\n\n                  regenerateTimer = setTimeout(async () => {\n                    console.log('[UnoCSS Hybrid] Regenerating CSS...');\n                    await generateCSS();\n\n                    // 触发浏览器刷新 CSS\n                    console.log('[UnoCSS Hybrid] Refreshing CSS in browser...');\n                    devServerInstance?.sockWrite('static-changed', '/uno.css');\n                  }, 300);\n                }\n              });\n\n              console.log('[UnoCSS Hybrid] Watch mode: enabled');\n            } catch (err) {\n              console.warn('[UnoCSS Hybrid] Watch mode not available:', (err as Error).message);\n            }\n          }\n        });\n      }\n\n      // 构建完成后的日志\n      api.onAfterBuild(() => {\n        if (isProd && fs.existsSync(currentCssPath)) {\n          const stats = fs.statSync(currentCssPath);\n          const fileName = path.basename(currentCssPath);\n          console.log(\n            `[UnoCSS Hybrid] Final CSS: ${fileName} (${(stats.size / 1024).toFixed(2)} KB)`,\n          );\n        }\n      });\n    },\n  };\n}\n\nexport default pluginUnocss;\n"]}

package/dist/plugin-unocss.mjs

@@ -0,0 +1,228 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { createHash } from 'crypto';
+
+// plugin-unocss.ts
+var __filename$1 = fileURLToPath(import.meta.url);
+var __dirname$1 = path.dirname(__filename$1);
+function pluginUnocss(options = {}) {
+  const {
+    unocssConfig = "./uno.config.ts",
+    outputPath = "",
+    contentPatterns = [
+      "./src/**/*.{html,js,ts,jsx,tsx}",
+      "./index.html"
+    ],
+    watchDirectory = "src",
+    autoInject = true,
+    watch = true,
+    enableHash = true
+  } = options;
+  return {
+    name: "unocss",
+    setup(api) {
+      const rootContext = api.context.rootPath;
+      const pluginDir = __dirname$1;
+      let resolvedOutputPath;
+      if (!outputPath) {
+        resolvedOutputPath = path.resolve(pluginDir, "./generated/uno.css");
+      } else if (path.isAbsolute(outputPath)) {
+        resolvedOutputPath = outputPath;
+      } else if (outputPath.startsWith("./")) {
+        resolvedOutputPath = path.resolve(rootContext, outputPath);
+      } else {
+        resolvedOutputPath = path.resolve(pluginDir, outputPath);
+      }
+      let currentCssPath = resolvedOutputPath;
+      let devServerInstance = null;
+      const isProd = process.env.NODE_ENV === "production";
+      const loadConfig = async () => {
+        if (typeof unocssConfig === "string") {
+          const configPath = path.resolve(rootContext, unocssConfig);
+          try {
+            const configModule = await import(`file:///${configPath.replace(/\\/g, "/")}`);
+            return configModule.default || configModule;
+          } catch (err) {
+            console.warn(
+              `[UnoCSS Hybrid] Failed to load config from ${configPath}, using default config`
+            );
+            return {};
+          }
+        }
+        return unocssConfig;
+      };
+      const generateCSS = async () => {
+        console.log("[UnoCSS Hybrid] Generating CSS...");
+        try {
+          const config = await loadConfig();
+          const { globby } = await import('globby');
+          const files = await globby(contentPatterns, {
+            cwd: rootContext,
+            absolute: true
+          });
+          if (files.length === 0) {
+            console.warn("[UnoCSS Hybrid] No files found to scan");
+            return resolvedOutputPath;
+          }
+          console.log(`[UnoCSS Hybrid] Found ${files.length} files to scan`);
+          console.log(`[UnoCSS Hybrid] Files:`, files.map((f) => path.relative(rootContext, f)));
+          const { createGenerator } = await import('unocss');
+          const generator = await createGenerator(config);
+          const allContents = files.map((file) => {
+            const content = fs.readFileSync(file, "utf-8");
+            return content;
+          }).join("\n");
+          const result = await generator.generate(allContents);
+          if (!result.css || result.css.trim().length === 0) {
+            console.warn("[UnoCSS Hybrid] Generated CSS is empty");
+            return resolvedOutputPath;
+          }
+          let finalOutputPath;
+          if (isProd && enableHash) {
+            const distDir = path.join(rootContext, "dist");
+            const hash = createHash("md5").update(result.css).digest("hex").substring(0, 8);
+            finalOutputPath = path.join(distDir, `uno.${hash}.css`);
+            currentCssPath = finalOutputPath;
+          } else {
+            finalOutputPath = resolvedOutputPath;
+            currentCssPath = resolvedOutputPath;
+          }
+          const outputDir = path.dirname(finalOutputPath);
+          if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+          }
+          fs.writeFileSync(finalOutputPath, result.css);
+          const stats = fs.statSync(finalOutputPath);
+          console.log(
+            `[UnoCSS Hybrid] CSS generated: ${finalOutputPath} (${(stats.size / 1024).toFixed(2)} KB)`
+          );
+          return finalOutputPath;
+        } catch (err) {
+          console.error("[UnoCSS Hybrid] Failed to generate CSS:", err);
+          return resolvedOutputPath;
+        }
+      };
+      if (isProd) {
+        api.onBeforeBuild(async () => {
+          await generateCSS();
+        });
+      }
+      if (autoInject) {
+        api.modifyHTMLTags((tags) => {
+          let cssPath;
+          if (isProd && enableHash) {
+            const cssFileName = path.basename(currentCssPath);
+            cssPath = `/${cssFileName}`;
+          } else {
+            cssPath = "/uno.css";
+          }
+          tags.headTags.unshift({
+            tag: "link",
+            attrs: {
+              rel: "stylesheet",
+              href: cssPath
+            }
+          });
+          console.log(`[UnoCSS Hybrid] Auto-injected CSS link: ${cssPath}`);
+          return tags;
+        });
+      }
+      if (!isProd) {
+        api.modifyRsbuildConfig((config) => {
+          const existingSetupMiddlewares = config.dev?.setupMiddlewares;
+          const setupMiddlewaresArray = Array.isArray(existingSetupMiddlewares) ? existingSetupMiddlewares : existingSetupMiddlewares ? [existingSetupMiddlewares] : [];
+          return {
+            ...config,
+            dev: {
+              ...config.dev,
+              setupMiddlewares: [
+                ...setupMiddlewaresArray,
+                (middlewares, devServer) => {
+                  devServerInstance = devServer;
+                  middlewares.unshift(async (req, res, next) => {
+                    if (req.url === "/uno.css") {
+                      try {
+                        if (!fs.existsSync(resolvedOutputPath)) {
+                          res.statusCode = 404;
+                          res.setHeader("Content-Type", "text/plain; charset=utf-8");
+                          res.end("CSS file not found. Please restart the dev server to generate it.");
+                          console.warn("[UnoCSS Hybrid] CSS file not found at:", resolvedOutputPath);
+                          return;
+                        }
+                        res.setHeader("Content-Type", "text/css; charset=utf-8");
+                        res.setHeader("Cache-Control", "no-cache");
+                        const css = fs.readFileSync(resolvedOutputPath, "utf-8");
+                        res.end(css);
+                      } catch (err) {
+                        console.error("[UnoCSS Hybrid] Error serving CSS:", err);
+                        res.statusCode = 500;
+                        res.setHeader("Content-Type", "text/plain; charset=utf-8");
+                        res.end("Error loading CSS file. Check console for details.");
+                      }
+                    } else {
+                      next();
+                    }
+                  });
+                }
+              ]
+            }
+          };
+        });
+        api.onBeforeStartDevServer(async () => {
+          console.log("[UnoCSS Hybrid] Development mode: CLI generation enabled");
+          await generateCSS();
+        });
+        api.onAfterStartDevServer(async () => {
+          console.log("[UnoCSS Hybrid] Dev server started, CSS available at /uno.css");
+          if (watch) {
+            try {
+              const chokidar = await import('chokidar');
+              const watchDir = path.resolve(rootContext, watchDirectory);
+              const watcher = chokidar.watch(watchDir, {
+                ignored: /(^|[\/\\])\../,
+                // ignore dotfiles
+                ignoreInitial: true,
+                persistent: true
+              });
+              let regenerateTimer = null;
+              watcher.on("all", async (event, filePath) => {
+                const ext = path.extname(filePath);
+                const shouldWatch = [".html", ".js", ".ts", ".jsx", ".tsx"].includes(ext);
+                if (shouldWatch && (event === "change" || event === "add" || event === "unlink")) {
+                  console.log(`[UnoCSS Hybrid] File ${event}: ${path.relative(rootContext, filePath)}`);
+                  if (regenerateTimer) {
+                    clearTimeout(regenerateTimer);
+                  }
+                  regenerateTimer = setTimeout(async () => {
+                    console.log("[UnoCSS Hybrid] Regenerating CSS...");
+                    await generateCSS();
+                    console.log("[UnoCSS Hybrid] Refreshing CSS in browser...");
+                    devServerInstance?.sockWrite("static-changed", "/uno.css");
+                  }, 300);
+                }
+              });
+              console.log("[UnoCSS Hybrid] Watch mode: enabled");
+            } catch (err) {
+              console.warn("[UnoCSS Hybrid] Watch mode not available:", err.message);
+            }
+          }
+        });
+      }
+      api.onAfterBuild(() => {
+        if (isProd && fs.existsSync(currentCssPath)) {
+          const stats = fs.statSync(currentCssPath);
+          const fileName = path.basename(currentCssPath);
+          console.log(
+            `[UnoCSS Hybrid] Final CSS: ${fileName} (${(stats.size / 1024).toFixed(2)} KB)`
+          );
+        }
+      });
+    }
+  };
+}
+var plugin_unocss_default = pluginUnocss;
+
+export { plugin_unocss_default as default, pluginUnocss };
+//# sourceMappingURL=plugin-unocss.mjs.map
+//# sourceMappingURL=plugin-unocss.mjs.map

package/dist/plugin-unocss.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../plugin-unocss.ts"],"names":["__filename","__dirname"],"mappings":"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","file":"plugin-unocss.mjs","sourcesContent":["import type { RsbuildPlugin } from '@rsbuild/core';\nimport type { UserConfig } from 'unocss';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { fileURLToPath } from 'url';\nimport { createHash } from 'crypto';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nexport interface PluginUnocssOptions {\n  /** UnoCSS 配置文件路径或直接配置对象 (默认: './uno.config.ts') */\n  unocssConfig?: string | UserConfig;\n\n  /**\n   * 生成的 CSS 文件输出路径\n   *\n   * 路径解析规则:\n   *  - 以 './' 开头: 相对于项目根目录 (推荐)\n   *  - 相对路径: 相对于插件目录\n   *  - 绝对路径: 直接使用\n   *  - 未配置: 默认为 'generated/uno.css' 相对于插件目录\n   */\n  outputPath?: string;\n\n  /** 扫描的内容文件路径模式 (支持 glob 模式) */\n  contentPatterns?: string[];\n\n  /** 监听的目录路径 (用于开发环境的 watch 模式, 默认: 'src') */\n  watchDirectory?: string;\n\n  /** 是否自动在 HTML 中注入生成的 CSS link 标签 (默认: true) */\n  autoInject?: boolean;\n\n  /** 是否在开发环境启用文件监听模式 (默认: true) */\n  watch?: boolean;\n\n  /**\n   * 是否在生产环境为 CSS 文件名添加 content hash\n   *\n   * 启用后, 文件名格式为 'uno.[hash].css', hash 基于 CSS 内容生成 (默认: true)\n   */\n  enableHash?: boolean;\n}\n\n/**\n * UnoCSS Plugin for Rsbuild\n *\n * 一个用于 Rsbuild 的 UnoCSS 插件,提供 CLI 预生成和自动注入功能.\n *\n * 特性:\n * - 扫描项目文件并生成独立的 CSS 文件\n * - 开发环境支持文件监听和热更新\n * - 生产环境支持 CSS 文件名 hash\n * - 自动在 HTML 中注入 CSS link 标签\n *\n * @param options - 插件配置选项\n * @returns Rsbuild 插件实例\n *\n * @example\n * ```ts\n * import { pluginUnocss } from '@ikkin/plugin-unocss';\n *\n * export default {\n *   plugins: [\n *     pluginUnocss({\n *       outputPath: './src/generated/uno.css',\n *       enableHash: true,\n *     })\n *   ]\n * };\n * ```\n */\nexport function pluginUnocss(\n  options: PluginUnocssOptions = {},\n): RsbuildPlugin {\n  const {\n    unocssConfig = './uno.config.ts',\n    outputPath = '',\n    contentPatterns = [\n      './src/**/*.{html,js,ts,jsx,tsx}',\n      './index.html',\n    ],\n    watchDirectory = 'src',\n    autoInject = true,\n    watch = true,\n    enableHash = true,\n  } = options;\n\n  return {\n    name: 'unocss',\n\n    setup(api) {\n      const rootContext = api.context.rootPath;\n\n      // 解析输出路径\n      const pluginDir = __dirname;\n      let resolvedOutputPath: string;\n\n      if (!outputPath) {\n        // 未配置：使用默认路径（相对于插件目录）\n        resolvedOutputPath = path.resolve(pluginDir, './generated/uno.css');\n      } else if (path.isAbsolute(outputPath)) {\n        // 绝对路径：直接使用\n        resolvedOutputPath = outputPath;\n      } else if (outputPath.startsWith('./')) {\n        // 以 ./ 开头：相对于项目根目录（推荐，更明确）\n        resolvedOutputPath = path.resolve(rootContext, outputPath);\n      } else {\n        // 相对路径（不带 ./）：相对于插件目录（更简洁）\n        resolvedOutputPath = path.resolve(pluginDir, outputPath);\n      }\n\n      // 用于保存当前生成的 CSS 文件路径（可能包含 hash）\n      let currentCssPath = resolvedOutputPath;\n\n      // 用于保存 dev server 实例，以便在文件变化时触发刷新\n      let devServerInstance: any = null;\n\n      // 通过环境变量判断是否是生产环境\n      const isProd = process.env.NODE_ENV === 'production';\n\n      // 读取 UnoCSS 配置\n      const loadConfig = async (): Promise<UserConfig> => {\n        if (typeof unocssConfig === 'string') {\n          const configPath = path.resolve(rootContext, unocssConfig);\n          try {\n            const configModule = await import(\n              `file:///${configPath.replace(/\\\\/g, '/')}`\n            );\n            return configModule.default || configModule;\n          } catch (err) {\n            console.warn(\n              `[UnoCSS Hybrid] Failed to load config from ${configPath}, using default config`,\n            );\n            return {};\n          }\n        }\n        return unocssConfig;\n      };\n\n      // 生成 UnoCSS CSS\n      const generateCSS = async (): Promise<string> => {\n        console.log('[UnoCSS Hybrid] Generating CSS...');\n\n        try {\n          const config = await loadConfig();\n\n          // 扫描文件\n          const { globby } = await import('globby');\n          const files = await globby(contentPatterns, {\n            cwd: rootContext,\n            absolute: true,\n          });\n\n          if (files.length === 0) {\n            console.warn('[UnoCSS Hybrid] No files found to scan');\n            return resolvedOutputPath;\n          }\n\n          console.log(`[UnoCSS Hybrid] Found ${files.length} files to scan`);\n          console.log(`[UnoCSS Hybrid] Files:`, files.map(f => path.relative(rootContext, f)));\n\n          // 使用 UnoCSS generator\n          const { createGenerator } = await import('unocss');\n          const generator = await createGenerator(config);\n\n          // 读取所有文件内容并生成\n          const allContents = files.map(file => {\n            const content = fs.readFileSync(file, 'utf-8');\n            return content;\n          }).join('\\n');\n\n          // 生成 CSS\n          const result = await generator.generate(allContents);\n\n          if (!result.css || result.css.trim().length === 0) {\n            console.warn('[UnoCSS Hybrid] Generated CSS is empty');\n            return resolvedOutputPath;\n          }\n\n          // 计算输出路径\n          let finalOutputPath: string;\n          if (isProd && enableHash) {\n            // 生产环境：直接生成到 dist 目录，文件名带 hash\n            const distDir = path.join(rootContext, 'dist');\n            const hash = createHash('md5').update(result.css).digest('hex').substring(0, 8);\n            finalOutputPath = path.join(distDir, `uno.${hash}.css`);\n            currentCssPath = finalOutputPath;\n          } else {\n            // 开发环境：生成到插件目录的 generated 子目录，文件名固定\n            finalOutputPath = resolvedOutputPath;\n            currentCssPath = resolvedOutputPath;\n          }\n\n          // 确保输出目录存在\n          const outputDir = path.dirname(finalOutputPath);\n          if (!fs.existsSync(outputDir)) {\n            fs.mkdirSync(outputDir, { recursive: true });\n          }\n\n          // 写入 CSS 文件\n          fs.writeFileSync(finalOutputPath, result.css);\n\n          const stats = fs.statSync(finalOutputPath);\n          console.log(\n            `[UnoCSS Hybrid] CSS generated: ${finalOutputPath} (${(stats.size / 1024).toFixed(2)} KB)`,\n          );\n\n          return finalOutputPath;\n        } catch (err) {\n          console.error('[UnoCSS Hybrid] Failed to generate CSS:', err);\n          return resolvedOutputPath;\n        }\n      };\n\n      // 生产环境：构建前生成 CSS\n      if (isProd) {\n        api.onBeforeBuild(async () => {\n          await generateCSS();\n        });\n      }\n\n      // 自动注入：通过修改 HTML 标签来注入 CSS（不污染源码）\n      if (autoInject) {\n        api.modifyHTMLTags((tags) => {\n          let cssPath: string;\n\n          if (isProd && enableHash) {\n            // 生产环境：使用带 hash 的文件名\n            const cssFileName = path.basename(currentCssPath);\n            cssPath = `/${cssFileName}`;\n          } else {\n            // 开发环境或未启用 hash：使用固定文件名\n            cssPath = '/uno.css';\n          }\n\n          tags.headTags.unshift({\n            tag: 'link',\n            attrs: {\n              rel: 'stylesheet',\n              href: cssPath,\n            },\n          });\n\n          console.log(`[UnoCSS Hybrid] Auto-injected CSS link: ${cssPath}`);\n          return tags;\n        });\n      }\n\n      // 开发环境：配置静态文件服务\n      if (!isProd) {\n        api.modifyRsbuildConfig((config) => {\n          const existingSetupMiddlewares = config.dev?.setupMiddlewares;\n          const setupMiddlewaresArray = Array.isArray(existingSetupMiddlewares)\n            ? existingSetupMiddlewares\n            : existingSetupMiddlewares\n              ? [existingSetupMiddlewares]\n              : [];\n\n          return {\n            ...config,\n            dev: {\n              ...config.dev,\n              setupMiddlewares: [\n                ...setupMiddlewaresArray,\n                (middlewares, devServer) => {\n                  // 保存 dev server 实例\n                  devServerInstance = devServer;\n\n                  // 添加自定义中间件来提供 CSS 文件\n                  middlewares.unshift(async (req, res, next) => {\n                    if (req.url === '/uno.css') {\n                      try {\n                        // 检查文件是否存在\n                        if (!fs.existsSync(resolvedOutputPath)) {\n                          res.statusCode = 404;\n                          res.setHeader('Content-Type', 'text/plain; charset=utf-8');\n                          res.end('CSS file not found. Please restart the dev server to generate it.');\n                          console.warn('[UnoCSS Hybrid] CSS file not found at:', resolvedOutputPath);\n                          return;\n                        }\n\n                        // 设置正确的 Content-Type 和缓存控制\n                        res.setHeader('Content-Type', 'text/css; charset=utf-8');\n                        res.setHeader('Cache-Control', 'no-cache');\n\n                        const css = fs.readFileSync(resolvedOutputPath, 'utf-8');\n                        res.end(css);\n                      } catch (err) {\n                        console.error('[UnoCSS Hybrid] Error serving CSS:', err);\n                        res.statusCode = 500;\n                        res.setHeader('Content-Type', 'text/plain; charset=utf-8');\n                        res.end('Error loading CSS file. Check console for details.');\n                      }\n                    } else {\n                      next();\n                    }\n                  });\n                },\n              ],\n            },\n          };\n        });\n\n        // 启动时生成 CSS\n        api.onBeforeStartDevServer(async () => {\n          console.log('[UnoCSS Hybrid] Development mode: CLI generation enabled');\n          await generateCSS();\n        });\n\n        // 合并启动后的操作\n        api.onAfterStartDevServer(async () => {\n          console.log('[UnoCSS Hybrid] Dev server started, CSS available at /uno.css');\n\n          // Watch 模式\n          if (watch) {\n            try {\n              // 动态导入 chokidar\n              const chokidar = await import('chokidar');\n\n              // 监听指定目录\n              const watchDir = path.resolve(rootContext, watchDirectory);\n\n              // 监听内容文件变化\n              const watcher = chokidar.watch(watchDir, {\n                ignored: /(^|[\\/\\\\])\\../, // ignore dotfiles\n                ignoreInitial: true,\n                persistent: true,\n              });\n\n              // 防抖：避免频繁重新生成\n              let regenerateTimer: NodeJS.Timeout | null = null;\n\n              watcher.on('all', async (event: string, filePath: string) => {\n                // 检查文件扩展名\n                const ext = path.extname(filePath);\n                const shouldWatch = ['.html', '.js', '.ts', '.jsx', '.tsx'].includes(ext);\n\n                // 监听文件添加、修改和删除\n                if (shouldWatch && (event === 'change' || event === 'add' || event === 'unlink')) {\n                  console.log(`[UnoCSS Hybrid] File ${event}: ${path.relative(rootContext, filePath)}`);\n\n                  if (regenerateTimer) {\n                    clearTimeout(regenerateTimer);\n                  }\n\n                  regenerateTimer = setTimeout(async () => {\n                    console.log('[UnoCSS Hybrid] Regenerating CSS...');\n                    await generateCSS();\n\n                    // 触发浏览器刷新 CSS\n                    console.log('[UnoCSS Hybrid] Refreshing CSS in browser...');\n                    devServerInstance?.sockWrite('static-changed', '/uno.css');\n                  }, 300);\n                }\n              });\n\n              console.log('[UnoCSS Hybrid] Watch mode: enabled');\n            } catch (err) {\n              console.warn('[UnoCSS Hybrid] Watch mode not available:', (err as Error).message);\n            }\n          }\n        });\n      }\n\n      // 构建完成后的日志\n      api.onAfterBuild(() => {\n        if (isProd && fs.existsSync(currentCssPath)) {\n          const stats = fs.statSync(currentCssPath);\n          const fileName = path.basename(currentCssPath);\n          console.log(\n            `[UnoCSS Hybrid] Final CSS: ${fileName} (${(stats.size / 1024).toFixed(2)} KB)`,\n          );\n        }\n      });\n    },\n  };\n}\n\nexport default pluginUnocss;\n"]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@ikkin/plugin-unocss",
+  "version": "1.0.0",
+  "description": "UnoCSS plugin for Rsbuild with CLI pre-generation and automatic injection",
+  "main": "./dist/plugin-unocss.js",
+  "module": "./dist/plugin-unocss.mjs",
+  "types": "./dist/plugin-unocss.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/plugin-unocss.d.ts",
+      "import": "./dist/plugin-unocss.mjs",
+      "require": "./dist/plugin-unocss.js",
+      "default": "./dist/plugin-unocss.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "rsbuild",
+    "plugin",
+    "unocss",
+    "css",
+    "atomic-css",
+    "utility-class",
+    "windi-css",
+    "tailwind",
+    "cli",
+    "atomic-css-engine"
+  ],
+  "author": "ikkin <your.email@example.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ikkin/plugin-unocss.git"
+  },
+  "homepage": "https://github.com/ikkin/plugin-unocss#readme",
+  "bugs": {
+    "url": "https://github.com/ikkin/plugin-unocss/issues"
+  },
+  "sideEffects": false,
+  "peerDependencies": {
+    "@rsbuild/core": ">=1.0.0",
+    "unocss": ">=0.60.0"
+  },
+  "dependencies": {
+    "globby": "^14.0.0",
+    "chokidar": "^4.0.0"
+  },
+  "devDependencies": {
+    "@rsbuild/core": "^1.1.0",
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.6.0",
+    "unocss": "^66.6.0"
+  }
+}