/** * 全局契约的**最小安装**(副作用模块: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 = { 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" );