feat(plugin): 产物自带样式 —— 第三方只取 entry 也能正常显示

第三方系统装完后样式全丢。复现出来的根因是产物形态:CSS 被抽成独立文件,
仓库契约要求消费方自己读 `style` 并注入 <link>(文档写了、官方参考消费方也照做了),
但第三方很容易只取 `entry`:插件能跑、页面却是白板(布局全靠 CSS)。
实测:只取 entry 时文档里插件样式表数量 0,.pt-panel 宽度从 356px 变成撑满的 1368px。

改法:vite.config.ts 新增 selfInjectStyles() 插件,在 generateBundle 阶段
把抽出的 CSS 内联进 JS,脚本一加载就注入 <style data-funjia-plugin=…>。

- 保留 style 字段与 CSS 文件不变:按文档注入的宿主照常工作;CSP 禁止内联样式时
  那条路仍是唯一出路。
- 不重复注入:先检测有没有本插件的 <style data-funjia-plugin=…>,
  或 href 指向本样式文件的 <link>,有就跳过。
- 走 generateBundle 而非「写完盘再改」:后者注入发生在 vite 打印体积之后,
  日志 98KB / 索引 109KB 对不上账。
- 拿不到 CSS 资源时 this.warn 显式报出,不静默少注入。
- verify.mjs 加断言盯着它(产物必须含注入器)。

验证:第三方最小消费方 4 项断言全过;宿主路径 4 项全过(CSS 恰好一份、无重复注入);
对已发布产物跑 13 项打印断言全过。产物已发布为 funjia.print-tag@1.0.3。

注意:本工程从此不再等同于 funjia-plugin-starter 的默认产物形态 ——
其他插件若也会被第三方接入,值得把这套 self-inject 搬过去。
This commit is contained in:
2026-10-04 01:32:14 +08:00
parent a049492864
commit 21d293775d
4 changed files with 151 additions and 4 deletions
+24
View File
@@ -29,6 +29,9 @@ import { fileURLToPath } from "node:url";
const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
/** 与 vite.config.ts 里 selfInjectStyles() 用的哨兵注释保持一致 */
const INJECTOR_SENTINEL = "/* funjia:self-inject-styles */";
/* ------------------------------------------------------------------ 输出 */
let errors = 0;
@@ -290,6 +293,27 @@ if (!existsSync(distDir)) {
// 否则宿主会去注入一个 404 的样式表。
warn(`dist/${cfg.style} 不存在,但配置里声明了 style —— 页面若无 <style> 请去掉该字段`);
}
/*
* 产物必须**自带样式**(把 CSS 内联进 JS 并自动注入)。
*
* 索引里的 `style` 是独立字段,要消费方自己读、自己注入 —— 文档写清楚了,
* 官方参考消费方也照做了,但第三方很容易只取 `entry`:插件能跑、页面却是白板。
* 实测过那种状态:文档里插件样式表数量 0,`.pt-panel` 宽度从 356px 变成撑满。
*
* 所以「JS 里有没有那段注入器」是必须守住的不变量,不是可选优化。
*/
if (artifactPath && existsSync(artifactPath)) {
const text = readFileSync(artifactPath, "utf8");
if (text.includes(INJECTOR_SENTINEL)) {
ok("产物自带样式(含 self-inject 注入器)");
} else {
bad(
"产物里没有样式注入器 —— 消费方只取 entry(漏注入 style)时页面会完全没样式。\n" +
" 检查 vite.config.ts 的 selfInjectStyles() 是否还在 plugins 里。"
);
}
}
}
/* ---------------- external 是否真的生效 ---------------- */