/** * 「插件从哪来」的两种模式。 * * | 模式 | 插件来源 | 回答的问题 | 快慢 | * | ---- | -------- | ---------- | ---- | * | `source` | `src/index.ts` 的静态 import | 我写的东西长什么样、逻辑对不对 | 改完即见(Vite 热更新) | * | `artifact` | `dist/` 里的真实产物 | **交给宿主的那几个字节**能不能跑 | 要先 `npm run build` | * * 之所以两个都要,是因为它们会分别失败在不同的地方: * * - 源码模式跑得通、产物模式跑不通 → 问题在**构建配置**(`external` 没生效、 * 产物名不对、`output.globals` 映射错了、样式没抽出来); * - 两个都跑通、宿主里不跑 → 问题在**仓库与装载链路**(路径、`checksum`、 * import map、`activation` 与 `contributes` 不匹配)。 * * 这条分界线能省掉大量「到底哪一步坏了我」的排查时间,所以别只用一个模式。 */ import type { PluginModule } from "../src/sdk"; import { pendingRegistrations } from "./contract"; /** `plugin.config.json` 的形状(只声明预览用得上的字段) */ export interface PluginConfig { id: string; name: string; version: string; kind: "iife" | "esm"; artifact: string; style?: string; globalKey?: string; activation?: string; [key: string]: any; } export interface LoadedPlugin { module: PluginModule; /** 装载过程中的说明,会写进预览的日志台 —— 让「怎么装载的」可见 */ notes: string[]; } export interface PreviewLoader { mode: "source" | "artifact"; /** 顶栏徽标上的短标签 */ label: string; /** 一句话说明这个模式在验什么 */ hint: string; /** * 点「重新装载」时是不是该刷新页面。 * * 源码模式:模块已经求值过(自注册被消费、模块内状态也变了),重新装载 * 最可靠的方式是刷新页面 —— 预览页启动很快,刷新几乎无感。 * 产物模式:重新拉一次产物即可,不必刷新。 */ reloadPageOnRerun: boolean; getModule(): Promise; } /* ------------------------------------------------------------ 工具 */ /** * 用 `