feat: 新增 plugin/ 插件化形态(funjia.print-tag)+ 可选 SN 条码/二维码
把本工程的标签排版能力改造成 FunjiaUI 远端插件,放进 plugin/ 子目录, 与原独立 Web 版并存(两者功能一致,模板/版面/打印行为逐项对齐)。 - 入口从 createApp().mount() 改为 activate(ctx) + ctx.addRoute,注册 1 菜单 / 1 路由 / 2 命令 - 11 个模板的渲染收敛成 SpecTag,差异集中到 templates/registry.ts(字段/选项/默认值原样保留) - 店铺名 / 电话从写死改为可配置,记忆在插件私有存储 - 内置二维码图片改为打包 data URL —— 远端插件没有自己的 public/ - 去掉 @headlessui/vue(换原生 select)与 Tailwind,样式类名统一 pt- 前缀避免污染宿主 - 可选接入宿主 api::sn-code:按 SN 生成真 Code 128 条码与可扫二维码; 关闭时(默认)完全保持原静态二维码行为。领码优先贴到已排版的格子,不够才新建 - 新增 commands: print-tag:issue-sn / print-tag:render-svg(后者纯本地出图,供其它插件复用) - code128.ts 实现真 Code 128 Set B(含校验位);二维码走 qrcode-generator(真 QR) - 自带本地预览器(preview/mock-api.ts 补了 /api/sn-codes mock)与 deploy / verify 脚本 - verify.mjs 修掉一处误报:源码边界判据改为「解析后是否逃出工程根」, 而不是「说明符是否以 .. 开头」(后者会把 src/components/X.vue → ../codes 误判为越界) 已发布到插件仓库:funjia.print-tag@1.0.0
This commit is contained in:
@@ -0,0 +1,96 @@
|
||||
/**
|
||||
* 插件构建配置(一个工程 = 一个插件)。
|
||||
*
|
||||
* ## 唯一的真源是 `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 <name> = …`)。
|
||||
*
|
||||
* - 走 `window.<globalKey>` 通道的插件:必须与 `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 字段,形状应为 "<Name>.iife.js" 或 "<Name>.es.js"。'
|
||||
);
|
||||
}
|
||||
|
||||
/** 与宿主 `installHostGlobals()` 挂的全局严格对应 */
|
||||
const HOST_GLOBALS: Record<string, string> = {
|
||||
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 } : {}),
|
||||
},
|
||||
},
|
||||
},
|
||||
});
|
||||
Reference in New Issue
Block a user