Files
print-tag-system/plugin/preview/contract.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.1 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.
/**
* 全局契约的**最小安装**(副作用模块: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"
);