/** * 插件构建配置(一个工程 = 一个插件)。 * * ## 唯一的真源是 `plugin.config.json` * * 产物文件名、IIFE 全局名、格式(IIFE / ESM)全部从这里读 —— 不在这里写第二遍。 * 理由很实际:这几个值**必须**与「发布到仓库时那条 `repo.config.json` 条目」 * 完全一致(`artifact` 对不上 → 发布脚本找不到产物;`globalKey` 对不上 → * 脚本加载成功但宿主认领不到插件)。让它们只有一个来源,就不会对不上。 * * ## 依赖共享的规矩(别改,除非你知道后果) * * `vue` 与 `funjiaui` **必须 external**,由宿主提供: * * - IIFE:靠 `output.globals` 映射到 `window.vue` / `window.funjiaui`; * - ESM:`output.globals` 对 ESM 无效(rollup 会忽略),产物里保留裸说明符 * `from "vue"`,由宿主的 import map 解析;宿主还有一条不依赖 import map 的 * 兜底通道,所以你不需要为此做任何事。 * * 为什么必须共享 `vue`:插件与宿主各打一份 Vue,会导致**两份响应式系统互相不认**, * 症状是「页面渲染出来了、但完全点不动」。这是最容易踩、也最难看懂的一个坑。 * * 其它依赖(element-plus、lodash、图表库…)**不要 external**,让它们打进产物。 * 插件体积大一点没关系,宿主不必为了插件把整个组件库挂到全局。 */ import { defineConfig } from "vite"; import vue from "@vitejs/plugin-vue"; import { readFileSync } from "node:fs"; import { resolve } from "node:path"; const root = __dirname; const cfg = JSON.parse(readFileSync(resolve(root, "plugin.config.json"), "utf8")); const FORMAT = cfg.kind === "esm" ? "es" : "iife"; /** * IIFE 需要 `lib.name`(rollup 用它生成 `var = …`)。 * * - 走 `window.` 通道的插件:必须与 `globalKey` 一致; * - 走 `window.FunjiaPlugin.register()` 自注册通道的插件:这个名字不影响认领, * 但仍然要是合法标识符(rollup 会直接把它写进代码)。 */ const GLOBAL_NAME = cfg.globalKey || cfg.id.replace(/[^A-Za-z0-9_$]/g, "_"); if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(GLOBAL_NAME)) { throw new Error( `plugin.config.json 的 globalKey 不合法:${JSON.stringify(GLOBAL_NAME)}\n` + "它会被写进产物当全局变量名,必须以字母 / _ / $ 开头,其后只含字母、数字、_、$。" ); } if (!/^[A-Za-z0-9_.-]+\.(iife|es)\.js$/.test(cfg.artifact)) { throw new Error( `plugin.config.json 的 artifact 不合法:${JSON.stringify(cfg.artifact)}\n` + '它同时是产物文件名与仓库索引里的 artifact 字段,形状应为 ".iife.js" 或 ".es.js"。' ); } /** 与宿主 `installHostGlobals()` 挂的全局严格对应 */ const HOST_GLOBALS: Record = { vue: "vue", funjiaui: "funjiaui", }; export default defineConfig({ root, plugins: [vue()], build: { target: "es2015", outDir: resolve(root, "dist"), // 一个工程只有一个插件,可以放心清空 —— 避免上一版的陈旧产物被误发布 emptyOutDir: true, // 样式不拆成多份:宿主按 manifest.style 注入**一个**文件,拆了会漏注入 cssCodeSplit: false, sourcemap: false, lib: { entry: resolve(root, "src/index.ts"), name: GLOBAL_NAME, formats: [FORMAT], // 产物名直接取自 plugin.config.json —— 与仓库索引里的 artifact 天然一致 fileName: () => cfg.artifact, }, rollupOptions: { external: Object.keys(HOST_GLOBALS), output: { globals: HOST_GLOBALS, assetFileNames: cfg.style || `${GLOBAL_NAME}[extname]`, // ⚠️ 不能省:否则「导出被 rollup 判成 namespace」时, // 产物会变成 `window.X = { default: class {} }`,宿主拿到后 // **不报错、但页面渲染不出任何东西** —— 最难查的一类静默失败。 ...(FORMAT === "iife" ? { exports: "default" as const } : {}), }, }, }, });