/** * 插件构建配置(一个工程 = 一个插件)。 * * ## 唯一的真源是 `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, type Plugin } 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", }; /* ------------------------------------------------------------------ * * 让产物「自带样式」 * ------------------------------------------------------------------ */ /** 注入器的哨兵注释:重复构建时先按它把旧的剥掉,避免 watch 下越叠越多 */ const INJECTOR_SENTINEL = "/* funjia:self-inject-styles */"; /** * 把抽出来的 CSS 内联进 JS,脚本一加载就把样式注入文档。 * * ## 为什么必须这么做 * * 仓库契约里 `style` 是**独立字段**:消费方要自己读它、注入 ``。文档写清楚了, * 官方参考消费方(`repo-consumer.html`)也照做了 —— 但**第三方很容易只取 `entry`**, * 于是插件能跑、页面却是白板(所有布局都靠 CSS,样式没了等于不可用)。 * 实测过:只用 `entry` 时文档里插件样式表数量是 0,`.pt-panel` 的宽度从 356px * 变成撑满的 1368px。 * * 一个「交付物」不该依赖消费方记得做第二步。所以产物自带样式: * * - 保留 `style` 字段与那个 CSS 文件**不变** —— 按文档注入的宿主照常工作, * 也便于审计;CSP 禁止内联样式时,那条路是唯一出路。 * - 同时在 JS 里挂一个注入器兜底。两处都生效时**不会重复注入**:注入器会先看 * 文档里有没有本插件的 `