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:
@@ -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 是否真的生效 ---------------- */
|
||||
|
||||
Reference in New Issue
Block a user