Extension API 参考
本参考从当前源码的公共 TypeScript 声明自动生成,每次官网构建都会更新。签名中的 ? 表示可选成员;返回 () => void 的注册方法提供注销函数。React、Cordis 等外部类型遵循其各自的包定义。
UI 组件与图标从 @woohaa3/ui 或批准的 JS 子路径具名导入;宿主函数、Context 与业务能力从 @woohaa3/frontend/extension-api 导入。扩展的 UI CSS 由宿主供给,扩展不得导入样式或私有路径。旧 SDK UI 导出保留同实例兼容。宿主服务通过插件 Context 注入。服务是否存在取决于当前 scope 和提供它的插件,声明 inject 后再访问。
import { defineExtensionPlugin } from "@woohaa3/frontend/extension-api";
export const plugin = defineExtensionPlugin(ctx => { const dispose = ctx.slots.register("canvas.overlay", { id: "example-overlay", owner: "example", render: () => null }); ctx.effect(() => dispose);}, { name: "example", inject: ["slots"] });canvas.node-template 注册创建入口;复合资产的渲染还需要 ctx.compositeAssets.register()。Slots、渲染适配器与后端定义是独立的注册协议。
后端宿主与画布内容端口从 @woohaa3/contracts 导入,通过扩展声明的工厂接入;@woohaa3/provider-sdk 仅供本机宿主的 Provider 扩展使用。「签名关联类型」解释参数与返回值,不代表这些类型都可以从前端 SDK 单独导入。