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
+1 -1
View File
@@ -1,7 +1,7 @@
{
"id": "funjia.print-tag",
"name": "标签打印",
"version": "1.0.2",
"version": "1.0.3",
"kind": "iife",
"artifact": "PrintTagBundle.iife.js",
"style": "PrintTagBundle.css",