Files
print-tag-system/plugin/vite.config.ts
T
funjia ef41d98838 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
2026-10-03 23:48:32 +08:00

97 lines
4.0 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 插件构建配置(一个工程 = 一个插件)。
*
* ## 唯一的真源是 `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 } : {}),
},
},
},
});