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:
2026-10-03 23:48:32 +08:00
parent 1896d1032b
commit ef41d98838
43 changed files with 8835 additions and 0 deletions
+96
View File
@@ -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 } : {}),
},
},
},
});