@hyacine/vite 0.0.1

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@hyacine/vite",
+  "version": "0.0.1",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./src/virtual-modules.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "bunx --bun oxlint --type-aware --type-check . --fix",
+    "format": "bunx oxfmt ."
+  },
+  "dependencies": {
+    "@hyacine/core": "workspace:*",
+    "@hyacine/helper": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "vite": "^7.3.1"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0"
+  }
+}

package/src/hyacine-plugin.ts

@@ -0,0 +1,187 @@
+import type { Plugin as VitePlugin } from "vite";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import type { HyacinePluginSystemConfig } from "@hyacine/core";
+import type { PluginManifest, RuntimeOnlyEntry } from "@hyacine/core";
+import {
+  CONFIG_FILE_NAMES,
+  collectRuntimeOnlyEntries,
+  findConfigFilePath,
+  generateTempRuntimeFile,
+  getPluginManifests,
+} from "@hyacine/helper";
+
+// 虚拟模块 ID 常量
+const RUNTIME_VIRTUAL_ID = "virtual:hyacine/runtime";
+const RUNTIME_RESOLVED_ID = "\0virtual:hyacine/runtime";
+
+/**
+ * 读取插件配置文件
+ * 支持 hyacine.plugin.ts 和 hyacine.plugin.mjs
+ * @param rootPath 项目根目录路径
+ * @param bypassCache 是否绕过模块缓存（开发模式 HMR 时使用）
+ */
+async function loadPluginConfig(
+  rootPath: string,
+  bypassCache = false,
+): Promise<HyacinePluginSystemConfig | null> {
+  const configPath = findConfigFilePath(rootPath);
+
+  if (!configPath) {
+    console.warn("[hyacine-vite] 未找到插件配置文件 (hyacine.plugin.ts 或 .mjs)");
+    return null;
+  }
+
+  try {
+    // 使用原生动态导入加载配置文件
+    let configUrl = pathToFileURL(configPath).href;
+    if (bypassCache) {
+      configUrl = `${configUrl}?t=${Date.now()}`;
+    }
+    const configModule = await import(/* @vite-ignore */ configUrl);
+
+    const moduleAsRecord = configModule as Record<string, unknown>;
+    const config = moduleAsRecord.default as HyacinePluginSystemConfig;
+
+    if (!config || !config.plugins) {
+      console.warn("[hyacine-vite] 配置文件格式无效，缺少 plugins 字段");
+      return null;
+    }
+
+    return config;
+  } catch (error) {
+    console.error("[hyacine-vite] 加载配置文件失败:", error);
+    return null;
+  }
+}
+
+/**
+ * 收集所有 runtime-only 类型的 entry，并对非 runtime-only entry 发出警告
+ */
+function getRuntimeOnlyEntries(manifests: PluginManifest[]): RuntimeOnlyEntry[] {
+  // 检查非 runtime-only entries 并发出警告
+  for (const manifest of manifests) {
+    for (const entry of manifest.entry) {
+      if (entry.type !== "runtime-only") {
+        console.warn(
+          `[hyacine-vite] 警告: 插件 "${manifest.name}" 包含非 Runtime-Only Entry (type: "${entry.type}", name: "${entry.name}")，Vite 集成仅支持 Runtime-Only 插件，该 Entry 将被忽略`,
+        );
+      }
+    }
+  }
+
+  return collectRuntimeOnlyEntries(manifests);
+}
+
+export interface HyacineVitePluginOptions {
+  /**
+   * 项目根目录路径
+   * 如果未提供，将使用 process.cwd()
+   */
+  root?: string;
+}
+
+/**
+ * Hyacine 插件系统 Vite 集成
+ * 仅支持 Runtime-Only 插件
+ */
+export default function hyacineVitePlugin(options: HyacineVitePluginOptions = {}): VitePlugin {
+  const rootPath = options.root ?? process.cwd();
+  const configFiles = CONFIG_FILE_NAMES;
+
+  // 缓存配置和 manifests
+  let cachedConfig: HyacinePluginSystemConfig | null = null;
+  let cachedManifests: PluginManifest[] | null = null;
+
+  return {
+    name: "vite-plugin-hyacine",
+    enforce: "pre",
+
+    async configResolved() {
+      // 在 Vite 配置解析后加载插件配置
+      const pluginConfig = await loadPluginConfig(rootPath, false);
+      if (pluginConfig) {
+        cachedConfig = pluginConfig;
+        cachedManifests = getPluginManifests(pluginConfig);
+
+        // 检查是否有非 runtime-only entries 并发出警告
+        getRuntimeOnlyEntries(cachedManifests);
+
+        console.info(`[hyacine-vite] 已加载 ${cachedManifests.length} 个插件`);
+      }
+    },
+
+    resolveId(id: string) {
+      if (id === RUNTIME_VIRTUAL_ID) {
+        return RUNTIME_RESOLVED_ID;
+      }
+      return null;
+    },
+
+    load(id: string) {
+      if (id !== RUNTIME_RESOLVED_ID) {
+        return null;
+      }
+
+      if (!cachedConfig || !cachedManifests) {
+        return null;
+      }
+
+      const runtimeEntries = getRuntimeOnlyEntries(cachedManifests);
+      return generateTempRuntimeFile(runtimeEntries, cachedConfig.injectPoints);
+    },
+
+    configureServer(server: any) {
+      // 监听配置文件变化
+      for (const fileName of configFiles) {
+        const configPath = join(rootPath, fileName);
+        if (existsSync(configPath)) {
+          server.watcher.add(configPath);
+        }
+      }
+
+      server.watcher.on("change", async (filePath: string) => {
+        const isPluginConfig = configFiles.some((name) => filePath.endsWith(name));
+
+        if (isPluginConfig) {
+          console.info("[hyacine-vite] 检测到配置变化，重新加载插件配置...");
+
+          try {
+            // 重新加载配置（绕过缓存）
+            const config = await loadPluginConfig(rootPath, true);
+            if (config) {
+              // 更新缓存
+              cachedConfig = config;
+              cachedManifests = getPluginManifests(config);
+
+              // 使虚拟模块失效
+              const mod = server.moduleGraph.getModuleById(RUNTIME_RESOLVED_ID);
+              if (mod) {
+                server.moduleGraph.invalidateModule(mod);
+              }
+
+              // 触发完整页面重载（HMR）
+              server.ws.send({
+                type: "full-reload",
+                path: "*",
+              });
+
+              console.info("[hyacine-vite] 配置已重新加载，页面即将刷新");
+            }
+          } catch (error) {
+            console.error(
+              `[hyacine-vite] 重新加载失败: ${error instanceof Error ? error.message : String(error)}`,
+            );
+          }
+        }
+      });
+    },
+
+    buildStart() {
+      if (!cachedConfig || !cachedManifests) {
+        console.warn("[hyacine-vite] 未找到有效的插件配置");
+      }
+    },
+  };
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { default as hyacineVitePlugin } from "./hyacine-plugin";
+export type { HyacineVitePluginOptions } from "./hyacine-plugin";

package/src/virtual-modules.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 虚拟模块类型声明
+ * Hyacine 插件系统 - Vite 集成
+ */
+
+declare module "virtual:hyacine/runtime" {
+  // runtime 虚拟模块不导出任何内容
+  // 它的作用是在入口文件中初始化所有 runtime-only 插件
+}