webloom-framework 0.3.0 → 0.4.1

package/dist/index.d.ts

@@ -1,264 +1,44 @@
-import { R as RuntimeKind, P as PluginManifest, a as PluginGraph, b as PluginDependency, c as PluginReverseDep, d as PluginContribution, e as PluginConfig, f as PluginContextExtension, g as PluginManifestInput, h as RuntimeUnitDescriptorInput, i as PluginSetup, j as RuntimeDependency, k as PluginPermission, l as PluginMeta, C as CreatePluginHostOptions, m as PluginHost, L as LifecycleDisposeResult, M as MessageBus, n as LifecycleScope, o as LifecycleScopeIdentity, p as PermissionLease, S as ScopedTaskScheduler, q as CreateUpgradeGateOptions, U as UpgradeGate, r as RemoteServiceReference, s as RemoteServiceMessageCodec } from './createPluginHost-BVsUCDKN.js';
-export { t as CapabilityRegistry, u as ContextExtensionInput, v as ContributionAdapter, w as ContributionAdapterInput, x as ContributionHandle, D as DispatchOptions, E as EventHandler, H as HandlerOptions, y as HostListener, z as LIFECYCLE_ERROR_TEXT, A as LifecycleCleanup, B as LifecycleCleanupIssue, F as LifecycleCleanupPhase, G as LifecycleDisposeOptions, I as LifecycleResourceHandle, J as LifecycleResourceSnapshot, K as LifecycleScopeKind, N as LifecycleScopeRevokedError, O as LifecycleScopeState, Q as Message, T as MessageBusSnapshot, V as MessageHandler, W as MessageMode, X as OwnedResourceDefinition, Y as PermissionDeniedError, Z as PermissionLeaseBinding, _ as PermissionLeaseBindingExpectation, $ as PermissionLeaseRevokedError, a0 as PermissionPolicyInput, a1 as PermissionPolicyResult, a2 as PluginAttributes, a3 as PluginConfigStore, a4 as PluginContext, a5 as PluginIntentCommand, a6 as PluginIntentCommandResult, a7 as PluginIntentController, a8 as PluginIntentCoordinator, a9 as PluginIntentSnapshot, aa as PluginIntentSubmissionResult, ab as PluginLifecycleState, ac as PluginStartupMode, ad as PluginState, ae as PluginStateKind, af as PluginTeardown, ag as PluginUnitGraph, ah as PluginUnitState, ai as PublishOptions, aj as RESOURCE_OWNER, ak as RESOURCE_REGISTRY_CAPABILITY, al as RUNTIME_MESSAGE_BUS, am as RemoteServiceBridge, an as RemoteServiceBridgeState, ao as RemoteServiceCallContext, ap as RemoteServiceCallOptions, aq as RemoteServiceError, ar as RemoteServiceErrorCode, as as RemoteServiceLookup, at as RemoteServiceMessageKind, au as RemoteServiceProxy, av as RemoteServiceSnapshot, aw as RemoteServiceSnapshotResult, ax as RemoteServiceTransport, ay as RequestOptions, az as ResourceContext, aA as ResourceDefinition, aB as ResourceKey, aC as ResourceRegistry, aD as ResourceSnapshot, aE as ResourceStatus, aF as ResourceStoreApi, aG as RuntimeUnitAttributesInput, aH as RuntimeUnitAvailabilityInput, aI as RuntimeUnitDependency, aJ as RuntimeUnitDependencyInput, aK as RuntimeUnitDescriptor, aL as RuntimeUnitImplementationRegistry, aM as RuntimeUnitParentScopeInput, aN as RuntimeUnitSnapshot, aO as SCOPED_TASK_SCHEDULER_CAPABILITY, aP as ScopedTaskDefinition, aQ as ScopedTaskSnapshot, aR as StartupCapabilityError, aS as StartupCapabilityErrorDetails, aT as StartupPluginError, aU as StartupPluginErrorDetails, aV as UpgradeDrainResult, aW as UpgradeGateRejectedError, aX as UpgradeGateState, aY as UpgradeHandshake, aZ as UpgradeHandshakeResult, a_ as UpgradeIoLease, a$ as UpgradeMode, b0 as UpgradeSession, b1 as createCapabilityRegistry, b2 as createInMemoryPluginConfigStore, b3 as createPluginHost, b4 as createRemoteServiceMessageCodec, b5 as createResourceStore, b6 as defineRuntimeUnitDependencies, b7 as defineRuntimeUnitProvidedContracts, b8 as lifecycleErrorText, b9 as runtimeCapabilityContractVersion } from './createPluginHost-BVsUCDKN.js';
-import { R as RuntimeHandle, W as WindowApp, a as RuntimeStatusSnapshot, b as RuntimeStatusListener, M as MessagePortServiceCallInput } from './resourceRegistry-BFnjmeGE.js';
-export { C as ConnectSharedWorkerOptions, c as CreateMessagePortServiceTransportOptions, d as CreatePluginIntentControllerOptions, e as CreateResourceScopeOptions, f as CreateServiceBridgeOptions, g as RUNTIME_ERROR_TYPE, h as RUNTIME_PROTOCOL_VERSION, i as RUNTIME_SNAPSHOT_TYPE, j as RemoteServicePortCallMessage, k as RemoteServicePortCancelMessage, l as RemoteServicePortErrorMessage, m as RemoteServicePortResponseMessage, n as RemoteServicePortResultMessage, o as ResourceScopeOptions, p as RuntimeAppState, q as RuntimeErrorMessage, r as RuntimeInitializationError, s as RuntimeInitializationErrorDetails, t as RuntimeSnapshot, u as RuntimeSnapshotUnit, v as RuntimeUnavailableError, w as RuntimeUnitImplementation, S as SharedWorkerConnectionContext, x as SharedWorkerLike, y as connectSharedWorker, z as createLifecycleScope, A as createMessageBus, B as createMessagePortServiceTransport, D as createPluginIntentController, E as createResourceRegistry, F as createResourceScope, G as createRuntimeMessageCodec, H as createRuntimeUnitImplementationRegistry, I as createServiceBridge, J as isRuntimeError, K as isRuntimeSnapshot, L as isRuntimeSnapshotProtocol, N as registerOwnedResource, O as unitSnapshotFromState } from './resourceRegistry-BFnjmeGE.js';
-
-interface BuildPluginGraphOptions {
-    /** 当前真正运行的插件；不传时使用 manifest.meta.defaultEnabled。 */
-    enabledPluginIds?: ReadonlySet<string>;
-    /** 当前 Host 的真实 Runtime；未选中的 Window/Worker 单元不会进入图。 */
-    runtime?: RuntimeKind;
-}
-interface ValidatePluginGraphOptions extends BuildPluginGraphOptions {
-    /** 平台内建 capability，不需要由某个 manifest 提供。 */
-    builtinCapabilities?: ReadonlySet<string>;
-    /** 允许多 Provider 的 capability；调用方必须有专门 Registry 选择语义。 */
-    multiProviderCapabilities?: ReadonlySet<string>;
-    /** Host 分批注册时允许 provider 尚未注册；真正装配前仍会进入 blocked。 */
-    allowMissingDependencies?: boolean;
-    /**
-     * 允许依赖当前图之外的另一个真实 Runtime；实际是否 ready 由运行时
-     * snapshot 和 RemoteServiceBridge 在 Host reconcile 时决定。
-     */
-    externalRuntimeDependencies?: boolean;
-}
-interface PluginGraphDiagnostic {
-    /** 稳定诊断码。 */
-    code: "plugin.duplicate_id" | "capability.duplicate_provider" | "plugin.missing_dependency" | "plugin.dependency_cycle" | "plugin.dependency_contract_invalid" | "plugin.dependency_contract_unavailable" | "plugin.runtime_invalid" | "plugin.runtime_declaration_at_product_level";
-    /** 相关插件或 capability。 */
-    ids: string[];
-    /** 中文诊断原因，供设置页直接显示或再做 i18n 映射。 */
-    message: string;
-}
-/** 依赖图不满足装配条件。 */
-declare class PluginGraphValidationError extends Error {
-    readonly code: "plugin.graph_invalid";
-    readonly diagnostics: readonly PluginGraphDiagnostic[];
-    constructor(diagnostics: readonly PluginGraphDiagnostic[]);
-}
-/**
- * 校验所有显式运行单元的跨环境依赖契约。
- *
- * 多运行单元产品的运行期声明必须全部位于对应 unit；产品级字段只给没有
- * `units` 的简单插件保留兼容性。此函数同时服务 TypeScript 以外导入的
- * manifest，避免运行时只依赖静态类型。
- */
-declare function validateRuntimeUnitDependencyContracts(manifests: readonly PluginManifest[]): PluginGraphDiagnostic[];
-/**
- * 返回当前执行环境的依赖；显式运行单元不会继承产品级依赖。
- * 只有没有 units 的简单插件才读取历史 product-level dependencies。
- */
-declare function dependenciesOfManifest(manifest: PluginManifest, runtime?: RuntimeKind): PluginDependency[];
-/** 返回当前执行环境提供的 capability；显式单元不会继承产品级摘要。 */
-declare function providesOfManifest(manifest: PluginManifest, runtime?: RuntimeKind): string[];
-/** 从 manifest 列表构造依赖、提供者和反向依赖。 */
-declare function buildPluginGraph(manifests: PluginManifest[], options?: BuildPluginGraphOptions): PluginGraph;
-/** 在任何 setup 前校验重复提供、缺失硬依赖和硬依赖环。 */
-declare function validatePluginGraph(manifests: readonly PluginManifest[], options?: ValidatePluginGraphOptions): PluginGraph;
-/** 查询当前启用的逆依赖者；禁用提供者时应按此集合先停止消费者。 */
-declare function reverseDependentsOf(graph: PluginGraph, pluginId: string, enabledSet: ReadonlySet<string>): PluginReverseDep[];
-
-interface DefinePluginOptions<TContribution = PluginContribution, TConfig extends PluginConfig = PluginConfig, TExtension extends PluginContextExtension = PluginContextExtension> {
+import { K as Capability, M as CapabilityDependency, N as PluginContribution, O as PluginConfig, Q as PluginContextExtension, R as RuntimeKind, e as PluginPermission, T as PluginSetup, V as PluginDefinition } from './runtimeTypes-DquUCHz-.js';
+export { X as AppLike, Y as CapabilityBridge, Z as CapabilityClient, C as CapabilityDescriptor, _ as CapabilityKind, j as CapabilityPeer, h as CreateUpgradeGateOptions, $ as DefineLocalCapabilityOptions, a0 as DefineRpcCapabilityOptions, a1 as DefineStreamCapabilityOptions, a2 as DispatchOptions, a3 as EventHandler, a4 as FrameworkErrorCode, a5 as FrameworkErrorContext, a6 as FrameworkErrorPhase, a7 as HandlerCallContext, a8 as HandlerOptions, a9 as HandlerOrigin, aa as HostListener, ab as ItemOf, ac as LIFECYCLE_ERROR_TEXT, ad as LifecycleCleanup, ae as LifecycleCleanupIssue, af as LifecycleCleanupPhase, ag as LifecycleDisposeOptions, ah as LifecycleDisposeResult, ai as LifecycleResourceHandle, aj as LifecycleResourceSnapshot, f as LifecycleScope, L as LifecycleScopeIdentity, ak as LifecycleScopeKind, al as LifecycleScopeRevokedError, am as LifecycleScopeState, an as LocalCapability, ao as LocalServiceOf, ap as Message, aq as MessageBus, ar as MessageBusSnapshot, as as MessageHandler, at as MessageMode, au as OwnedResourceDefinition, av as PeerCapabilityDependency, aw as PeerScopeView, ax as PermissionDeniedError, g as PermissionLease, ay as PermissionLeaseBinding, az as PermissionLeaseBindingExpectation, aA as PermissionLeaseRevokedError, aB as PluginAttributes, aC as PluginContext, a as PluginGraph, aD as PluginIntentCommand, aE as PluginIntentCommandResult, aF as PluginIntentController, aG as PluginIntentCoordinator, aH as PluginIntentSnapshot, aI as PluginIntentSubmissionResult, aJ as PluginLifecycleState, P as PluginManifest, aK as PluginManifestInput, c as PluginReverseDep, aL as PluginStartupMode, aM as PluginState, aN as PluginStateKind, aO as PluginTeardown, aP as PluginUnitGraph, aQ as PluginUnitState, aR as PublishOptions, aS as RESOURCE_OWNER, aT as RESOURCE_REGISTRY, aU as RUNTIME_MESSAGE_BUS, aV as RemoteCapability, aW as RequestOf, aX as RequestOptions, aY as ResourceContext, aZ as ResourceDefinition, a_ as ResourceKey, a$ as ResourceRegistry, b0 as ResourceSnapshot, b1 as ResourceStatus, b2 as ResponseOf, b3 as RpcCallOptions, b4 as RpcCapability, b5 as RpcCapabilityBase, b6 as RpcClient, b7 as RpcHandler, b8 as RpcTransferDescriptor, b9 as RuntimeCapabilityDependency, l as RuntimeHandle, ba as RuntimeInitializationError, bb as RuntimeLimits, bc as RuntimeServiceSnapshot, bd as RuntimeSnapshot, be as RuntimeStatusListener, bf as RuntimeStatusSnapshot, bg as RuntimeUnavailableError, b as RuntimeUnitDependency, bh as RuntimeUnitDependencyInput, d as RuntimeUnitDescriptor, bi as RuntimeUnitDescriptorInput, bj as RuntimeUnitImplementationRegistry, bk as SCOPED_TASK_SCHEDULER_CAPABILITY, bl as ScopedTaskDefinition, S as ScopedTaskScheduler, bm as ScopedTaskSnapshot, i as ServiceReference, bn as SnapshotApplyResult, bo as StartupCapabilityErrorDetails, bp as StartupPluginErrorDetails, bq as StreamCapability, br as StreamCapabilityBase, bs as StreamClient, bt as StreamHandler, bu as StreamSubscribeOptions, bv as StreamSubscription, bw as StreamTransferDescriptor, bx as TransferExtractor, by as UpgradeDrainResult, U as UpgradeGate, bz as UpgradeGateRejectedError, bA as UpgradeGateState, bB as UpgradeHandshake, bC as UpgradeHandshakeResult, bD as UpgradeIoLease, bE as UpgradeMode, bF as UpgradeSession, bG as ValueParser, bH as WebLoomError, W as WindowApp, bI as assertCapability, bJ as capabilityDescriptor, bK as capabilityKey, bL as defineCapability, bM as isCapability, bN as isCapabilityDescriptor, bO as lifecycleErrorText } from './runtimeTypes-DquUCHz-.js';
+export { k as ConnectSharedWorkerOptions, P as PeerController, d as PeerExposureOptions, c as RuntimePluginDefinition, S as SharedWorkerApp, l as SharedWorkerLike, g as StartSharedWorkerAppOptions, m as connectSharedWorker, i as createLifecycleScope, j as createResourceScope, s as startSharedWorkerApp } from './sharedWorkerHost-KI7TIGdX.js';
+export { C as CreateWindowAppOptions, a as createWindowApp } from './windowRuntime-BKkLPsAS.js';
+export { c as createMessageBus } from './messageBus-CtrwkjrO.js';
+
+/** 普通插件定义选项；插件声明只使用 typed capability 与单一启动策略。 */
+interface DefinePluginOptions<TProvides extends readonly Capability[] = readonly Capability[], TDependencies extends readonly CapabilityDependency[] = readonly CapabilityDependency[], TContribution = PluginContribution, TConfig extends PluginConfig = PluginConfig, TExtension extends PluginContextExtension = PluginContextExtension> {
     /** 全局稳定插件标识。 */
-    id: string;
-    /** 默认展示名称。 */
-    name?: string;
-    /** 可选诊断描述。 */
-    description?: string;
-    /** 普通插件的可执行实现；不会进入静态 descriptor。 */
-    setup: PluginSetup<TConfig, TExtension>;
-    /** 默认目标 Runtime；普通 Window 插件通常省略，由 App 注入。 */
-    runtime?: RuntimeKind;
-    /** 默认 unit id；省略时使用插件 id。 */
-    unitId?: string;
-    /** 插件依赖；helper 会为本地依赖补齐 v1 契约版本。 */
-    dependencies?: readonly (RuntimeDependency | PluginDependency)[];
-    /** 本单元提供的 capability。 */
-    provides?: readonly string[];
-    /** 跨 Runtime 时可显式覆盖 capability 契约版本。 */
-    providedContracts?: Readonly<Record<string, string>>;
-    /** 请求的权限集合。 */
-    permissions?: readonly PluginPermission[];
-    /** 单元只读配置。 */
-    config?: TConfig;
-    /** 产品贡献；不会被框架解释。 */
-    contribution?: TContribution;
-    /** 是否默认启用；默认为 true。 */
-    defaultEnabled?: boolean;
-    /** 是否允许控制面停用；默认为 true。 */
-    canDisable?: boolean;
-    /** required 插件在 App 初始启动时必须成功。 */
-    required?: boolean;
-    /** 显式启动模式；required=true 时不能覆盖为 optional。 */
-    startup?: "required" | "optional";
-    /** 仅用于兼容低层消费方的静态 meta 扩展；WebLoom 不解释分类字段。 */
-    meta?: Partial<PluginMeta>;
-}
-/** 静态 descriptor 与当前 realm 的实现函数分离。 */
-interface PluginDefinition<TContribution = PluginContribution, TConfig extends PluginConfig = PluginConfig, TExtension extends PluginContextExtension = PluginContextExtension> {
-    readonly manifest: PluginManifestInput<TContribution, TConfig, TExtension>;
-    readonly descriptor: RuntimeUnitDescriptorInput<TContribution, TConfig>;
-    readonly setup: PluginSetup<TConfig, TExtension>;
+    readonly id: string;
+    /** 展示名称。 */
+    readonly name?: string;
+    /** 诊断描述。 */
+    readonly description?: string;
+    /** 本插件声明提供的能力。 */
+    readonly provides?: TProvides;
+    /** 本插件声明消费的能力。 */
+    readonly dependencies?: TDependencies;
+    /** 默认执行 Runtime。 */
+    readonly runtime?: RuntimeKind;
+    /** 多 unit 装配时的稳定 unit id。 */
+    readonly unitId?: string;
+    /** 申请权限。 */
+    readonly permissions?: readonly PluginPermission[];
+    /** 只读插件配置。 */
+    readonly config?: TConfig;
+    /** 领域贡献。 */
+    readonly contribution?: TContribution;
+    /** 唯一启动策略；默认为 optional。 */
+    readonly startup?: "required" | "optional";
+    /** 默认启用意图；required 时必须为 true。 */
+    readonly defaultEnabled?: boolean;
+    /** optional 插件默认为可停用；required 必须为 false。 */
+    readonly canDisable?: boolean;
+    /** 当前 realm 的插件实现。 */
+    readonly setup: PluginSetup<TProvides, TDependencies, TConfig, TExtension>;
 }
 /**
- * 声明一个插件。
- *
- * 该函数不创建 Host，也不启动 setup；真正的启动边界由
- * createWindowApp()/startSharedWorkerApp() 拥有。
+ * 声明一个插件。它不会创建 Host，也不会运行 setup；Runtime 装配边界
+ * createWindowApp()/startSharedWorkerApp() 才会执行实现。
  */
-declare function definePlugin<TContribution = PluginContribution, TConfig extends PluginConfig = PluginConfig, TExtension extends PluginContextExtension = PluginContextExtension>(options: DefinePluginOptions<TContribution, TConfig, TExtension>): PluginDefinition<TContribution, TConfig, TExtension>;
-
-type RuntimePluginDefinition = PluginDefinition<any, any, any> | {
-    readonly manifest: PluginManifest | PluginManifestInput;
-    readonly setup: PluginSetup<any, any>;
-    /** 多 unit manifest 中 setup 所实现的目标 unit；单一匹配 unit 可省略。 */
-    readonly unitId?: string;
-};
-interface MaterializedPluginDefinition {
-    readonly manifest: PluginManifest;
-    /** 当前 Runtime 中由 setup 实现的 unit。 */
-    readonly unitId: string;
-    readonly setup: PluginSetup;
-}
-/** 将作者定义绑定到真实 Runtime；不把 setup 复制进 manifest。 */
-declare function materializePluginDefinition(input: RuntimePluginDefinition, runtime: RuntimeKind): MaterializedPluginDefinition;
-declare function materializePluginDefinitions(inputs: readonly RuntimePluginDefinition[], runtime: RuntimeKind): MaterializedPluginDefinition[];
-
-interface CreateWindowAppOptions extends Omit<CreatePluginHostOptions, "runtime" | "runtimeUnitImplementationRegistry"> {
-    /** 逻辑 Runtime 标识；同一页面通常只创建一个 App。 */
-    id?: string;
-    /** 当前 Window 的插件定义；setup 只在当前 Window realm 执行。 */
-    plugins: readonly RuntimePluginDefinition[];
-    /**
-     * 供领域适配层接管分阶段注册时复用已经创建的 Window Host。
-     * 普通插件应省略该字段；传入后由调用方负责后续 register，App 仍负责
-     * Window Runtime 快照、远端投影和最终 dispose。
-     */
-    host?: PluginHost;
-    /** 可选的 SharedWorker Runtime；Window 单元只投影其状态，不创建 Worker 假实例。 */
-    remoteRuntime?: RuntimeHandle;
-}
-/** 创建当前 Window 的唯一 window-main Runtime。 */
-declare function createWindowApp(options: CreateWindowAppOptions): Promise<WindowApp>;
-
-interface SharedWorkerScopeLike {
-    onconnect: ((event: {
-        ports: MessagePort[];
-    }) => void) | null;
-}
-interface StartSharedWorkerAppOptions extends Omit<CreatePluginHostOptions, "runtime" | "runtimeUnitImplementationRegistry"> {
-    id: string;
-    plugins: readonly RuntimePluginDefinition[];
-    globalScope?: SharedWorkerScopeLike;
-    /** SWCF-009 完成前的临时领域端口装配接缝。 */
-    onPortConnect?: (event: {
-        ports: MessagePort[];
-    }) => void;
-}
-interface SharedWorkerApp {
-    readonly runtimeKind: "shared-worker";
-    readonly runtimeId: string;
-    readonly runtimeInstanceId: string;
-    ready(): Promise<void>;
-    reconcile(): Promise<void>;
-    state(): RuntimeStatusSnapshot;
-    subscribe(listener: RuntimeStatusListener): () => void;
-    dispose(reason?: string): Promise<LifecycleDisposeResult>;
-}
-/** 在当前 SharedWorkerGlobalScope 中安装唯一的 Worker Runtime。 */
-declare function startSharedWorkerApp(options: StartSharedWorkerAppOptions): SharedWorkerApp;
-
-/** 创建绑定到指定插件实例的 MessageBus 视图。 */
-declare function createScopedMessageBus(base: MessageBus, scope: LifecycleScope): MessageBus;
-
-interface CreatePermissionLeaseOptions {
-    /** 已由 Host 绑定的作用域身份；调用方不能从请求体自报。 */
-    identity: LifecycleScopeIdentity;
-    /** 插件 manifest 申请的权限。 */
-    requested?: readonly PluginPermission[];
-    /** 可信策略批准的权限。 */
-    approved?: readonly PluginPermission[];
-    /** 当前会话约束；存在时再与申请、批准求交集。 */
-    sessionConstraints?: readonly PluginPermission[];
-    /** 内置可信策略修订；策略变化后不能复用旧租约。 */
-    policyRevision?: number;
-    /** Connect 用户授权修订；内置插件可以省略。 */
-    grantRevision?: number;
-    /** Connect/外部授权的不可猜测授权标识；最终边界仍需查权威状态。 */
-    grantId?: string;
-    /** 可选作用域；撤权时自动撤销租约。 */
-    scope?: LifecycleScope;
-}
-/** 创建一个不可换绑的权限租约。 */
-declare function createPermissionLease(options: CreatePermissionLeaseOptions): PermissionLease;
-
-interface VerifyPermissionLeaseOptions {
-    /** 已由受信装配层创建的租约。 */
-    lease: PermissionLease;
-    /** 本次实际操作所需的最小权限。 */
-    permission: PluginPermission;
-    /** 从端口 / 当前会话权威取得的绑定值。 */
-    binding?: Parameters<PermissionLease["assertBinding"]>[0];
-}
-/** 在最终 RPC / I/O 边界执行一次 fail-closed 校验。 */
-declare function verifyPermissionLease(options: VerifyPermissionLeaseOptions): void;
-
-interface CreateScopedTaskSchedulerOptions {
-    /** 注册后是否先恢复运行一次；缺省为 false，由业务显式触发。 */
-    runOnRegister?: boolean;
-}
-/** 创建绑定到一个 lifecycle scope 的任务调度器。 */
-declare function createScopedTaskScheduler(scope: LifecycleScope, options?: CreateScopedTaskSchedulerOptions): ScopedTaskScheduler & {
-    dispose(): Promise<void>;
-};
-
-interface ScopedRegistryRegistration {
-    /** 注册方法名，例如 register / registerFeature。 */
-    method: string;
-    /** 从参数哪个位置读取带 id 的定义。 */
-    idArgument?: number;
-    /** 没有返回取消函数时使用的注销方法。 */
-    unregisterMethod?: string;
-    /** 注销方法的参数位置；默认使用 idArgument。 */
-    unregisterArgument?: number;
-    /** 含 ownerPluginId 参数的注册方法；由 Host 绑定当前插件身份。 */
-    bindPluginIdArgument?: number;
-    /** 定义对象中的 ownerPluginId 字段；存在时必须与当前插件一致。 */
-    ownerPluginIdProperty?: string;
-}
-interface CreateScopedRegistryFacadeOptions {
-    /** 日志和作用域资源中显示的注册表名。 */
-    name: string;
-    /** 注册方法规则；缺省只包装 register(item)。 */
-    registrations?: readonly ScopedRegistryRegistration[];
-}
-/** 创建一个只对当前插件实例开放的 Registry 视图。 */
-declare function createScopedRegistryFacade<T extends object>(target: T, scope: LifecycleScope, options: CreateScopedRegistryFacadeOptions): T;
-
-/** 创建一个绑定当前构建和接管世代的升级门禁。 */
-declare function createUpgradeGate(options: CreateUpgradeGateOptions): UpgradeGate;
-
-interface CreateMessagePortServiceProviderOptions {
-    /** 与页面服务桥配对的专用双工端口。 */
-    port: MessagePort;
-    /** Provider 的本地权威目录；不会采信客户端回传的完整 reference。 */
-    services?: () => readonly RemoteServiceReference[];
-    /** 具体服务分派；这里不自动重放调用。 */
-    handleCall(input: MessagePortServiceCallInput): Promise<unknown>;
-    /** dispose 时是否关闭本端端口；默认关闭。 */
-    closeOnDispose?: boolean;
-    /** wire 消息 codec；默认 webloom.remote-service.v2。 */
-    codec?: RemoteServiceMessageCodec;
-}
-interface MessagePortServiceProvider {
-    /** 替换 Provider 本地权威目录；不产生 wire 控制消息。 */
-    setServices(services: readonly RemoteServiceReference[]): void;
-    /** 同步停止新调用并 abort 当前 handler。 */
-    revoke(reason?: string): void;
-    /** 移除监听器并释放端口；不发送断开控制包。 */
-    dispose(): void;
-}
-/** 创建一条只服务于当前 MessagePort 的 Provider 端点。 */
-declare function createMessagePortServiceProvider(options: CreateMessagePortServiceProviderOptions): MessagePortServiceProvider;
+declare function definePlugin<TProvides extends readonly Capability[] = readonly Capability[], TDependencies extends readonly CapabilityDependency[] = readonly CapabilityDependency[], TContribution = PluginContribution, TConfig extends PluginConfig = PluginConfig, TExtension extends PluginContextExtension = PluginContextExtension>(options: DefinePluginOptions<TProvides, TDependencies, TContribution, TConfig, TExtension>): PluginDefinition<TProvides, TDependencies, TContribution, TConfig, TExtension>;
 
-export { type BuildPluginGraphOptions, type CreateMessagePortServiceProviderOptions, type CreatePermissionLeaseOptions, CreatePluginHostOptions, type CreateScopedRegistryFacadeOptions, type CreateScopedTaskSchedulerOptions, CreateUpgradeGateOptions, type CreateWindowAppOptions, type DefinePluginOptions, LifecycleDisposeResult, LifecycleScope, LifecycleScopeIdentity, type MaterializedPluginDefinition, MessageBus, MessagePortServiceCallInput, type MessagePortServiceProvider, PermissionLease, PluginConfig, PluginContextExtension, PluginContribution, type PluginDefinition, PluginDependency, PluginGraph, type PluginGraphDiagnostic, PluginGraphValidationError, PluginHost, PluginManifest, PluginManifestInput, PluginMeta, PluginPermission, PluginReverseDep, PluginSetup, RemoteServiceMessageCodec, RemoteServiceReference, RuntimeDependency, RuntimeHandle, RuntimeKind, type RuntimePluginDefinition, RuntimeStatusListener, RuntimeStatusSnapshot, RuntimeUnitDescriptorInput, type ScopedRegistryRegistration, ScopedTaskScheduler, type SharedWorkerApp, type SharedWorkerScopeLike, type StartSharedWorkerAppOptions, UpgradeGate, type ValidatePluginGraphOptions, type VerifyPermissionLeaseOptions, WindowApp, buildPluginGraph, createMessagePortServiceProvider, createPermissionLease, createScopedMessageBus, createScopedRegistryFacade, createScopedTaskScheduler, createUpgradeGate, createWindowApp, definePlugin, dependenciesOfManifest, materializePluginDefinition, materializePluginDefinitions, providesOfManifest, reverseDependentsOf, startSharedWorkerApp, validatePluginGraph, validateRuntimeUnitDependencyContracts, verifyPermissionLease };
+export { Capability, CapabilityDependency, type DefinePluginOptions, PluginConfig, PluginContextExtension, PluginContribution, PluginDefinition, PluginPermission, PluginSetup, RuntimeKind, definePlugin };