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 @@
|
||||
/**
|
||||
* 全局契约的**最小安装**(副作用模块:import 即生效)。
|
||||
*
|
||||
* ## 为什么它得单独存在,不能写进 host.ts
|
||||
*
|
||||
* 插件的入口脚本在**模块求值的那一刻**就调用了 `window.FunjiaPlugin.register()`
|
||||
* —— 也就是 `src/index.ts` 只要被 import,注册就已经发生完了。而预览宿主
|
||||
* (ctx、扩展点注册表、界面)是之后才建起来的。如果契约安装晚于插件源码求值,
|
||||
* 就会看到那句熟悉的报错:
|
||||
*
|
||||
* > 找不到 window.FunjiaPlugin:本脚本必须由宿主页面加载
|
||||
*
|
||||
* 而真正的原因只是**顺序**。ESM 的求值顺序是「按 import 声明顺序、深度优先」,
|
||||
* 所以只要让本模块排在插件源码前面就够了:
|
||||
*
|
||||
* ```ts
|
||||
* import "./contract"; // ① 先求值:契约就位
|
||||
* import plugin from "../src/index"; // ② 后求值:register 落进队列,不会落空
|
||||
* ```
|
||||
*
|
||||
* 这与宿主里的顺序问题同源:宿主也是「先 `installHostGlobals()`,再装载插件」。
|
||||
*
|
||||
* ## 它只装「谁来接」的部分
|
||||
*
|
||||
* 队列 + `window.vue` + `window.funjiaui` 兜底 + `window.FunjiaHost` 骨架。
|
||||
* 真正的 ctx、扩展点注册表、回收逻辑在 `host.ts` 里,由预览界面驱动。
|
||||
* 这样拆开还有一个好处:`window.FunjiaHost` 是个**稳定的对象引用**,
|
||||
* 插件在求值时就算把它存起来了,后面 `host.ts` 补充实现(`Object.assign` 到同一个
|
||||
* 对象上)它也能看到 —— 而不是拿着一个过期的空壳。
|
||||
*/
|
||||
|
||||
import * as Vue from "vue";
|
||||
import { createFunjiauiFallback } from "./shims/funjiaui";
|
||||
|
||||
/** 宿主版本。带 `-preview` 后缀是刻意的:插件若据此分支,日志里能一眼看出环境 */
|
||||
export const HOST_VERSION = "1.0.0-preview";
|
||||
|
||||
/** 宿主标识,对应真实宿主的 `funjia-plugin-host` */
|
||||
export const HOST_NAME = "funjia-plugin-host-preview";
|
||||
|
||||
/** 插件自注册时提交的形状(与宿主 `loader.ts` 的注册队列一致) */
|
||||
export interface PendingRegistration {
|
||||
manifest: { id?: string; [key: string]: any };
|
||||
module: any;
|
||||
}
|
||||
|
||||
/**
|
||||
* 自注册队列。
|
||||
*
|
||||
* 用队列而不是「立即认领」,是因为真实宿主也这么做:脚本可能在宿主还没准备好
|
||||
* 元数据(来自仓库索引)时就把自己注册进来了。预览沿用同一套语义,
|
||||
* 免得出现「预览里能认领、宿主里认领不到」的差异。
|
||||
*/
|
||||
export const pendingRegistrations: PendingRegistration[] = [];
|
||||
|
||||
/** `window.FunjiaHost` 的骨架。**引用要稳定** —— host.ts 会往这个对象上补实现 */
|
||||
export const hostInfo: Record<string, any> = {
|
||||
name: HOST_NAME,
|
||||
version: HOST_VERSION,
|
||||
http: {
|
||||
// 先给一个「明说没接上」的实现。host.ts 会换成真的请求层
|
||||
// (真发请求、带鉴权头、401 统一处理 —— 见 host.ts 的 send)
|
||||
get: async () => ({ code: 0, msg: "preview: 尚未接入请求层", data: null }),
|
||||
post: async () => ({ code: 0, msg: "preview: 尚未接入请求层", data: null }),
|
||||
put: async () => ({ code: 0, msg: "preview: 尚未接入请求层", data: null }),
|
||||
del: async () => ({ code: 0, msg: "preview: 尚未接入请求层", data: null }),
|
||||
},
|
||||
getViewModel: () => undefined,
|
||||
// 骨架里先给个「没人登录」。host.ts 会覆盖成读真实会话的那两个
|
||||
getUser: () => null,
|
||||
isLoggedIn: () => false,
|
||||
stats: () => ({}),
|
||||
};
|
||||
|
||||
const w = window as any;
|
||||
|
||||
// window.vue:**必须是预览页自己那一份 Vue**。IIFE 插件从全局取它,
|
||||
// 取到的就是渲染这个页面的同一个实例 —— 这正是「同实例」的保证。
|
||||
w.vue = Vue;
|
||||
|
||||
// window.funjiaui:桩(见 shims/funjiaui.ts)。Proxy 能兜住任意名字
|
||||
w.funjiaui = createFunjiauiFallback();
|
||||
|
||||
w.FunjiaHost = hostInfo;
|
||||
|
||||
w.FunjiaPlugin = {
|
||||
register(input: PendingRegistration) {
|
||||
pendingRegistrations.push(input);
|
||||
},
|
||||
};
|
||||
|
||||
console.info(
|
||||
`[preview] %c全局契约已安装%c:window.vue / window.funjiaui(桩) / window.FunjiaHost / window.FunjiaPlugin(版本 ${HOST_VERSION})`,
|
||||
"color:#3b82f6;font-weight:bold",
|
||||
"color:inherit"
|
||||
);
|
||||
Reference in New Issue
Block a user