webloom-framework 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -1,449 +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, m as PluginStateKind, n as RemoteServiceReference, o as RemoteServiceMessageCodec, p as PluginUnitState, q as RemoteServiceBridge, r as RemoteServiceProxy, s as PluginHost, L as LifecycleDisposeResult, C as CreatePluginHostOptions, M as MessageBus, t as LifecycleScope, u as LifecycleScopeIdentity, v as PermissionLease, S as ScopedTaskScheduler, w as CreateUpgradeGateOptions, U as UpgradeGate, x as RemoteServiceHandshake, y as RemoteServiceSnapshot } from './createPluginHost-ChJNBTsX.js';
-export { z as CapabilityRegistry, A as ContextExtensionInput, B as ContributionAdapter, D as ContributionAdapterInput, E as ContributionHandle, F as DispatchOptions, G as EventHandler, H as HandlerOptions, I as HostListener, J as LIFECYCLE_ERROR_TEXT, K as LifecycleCleanup, N as LifecycleCleanupIssue, O as LifecycleCleanupPhase, Q as LifecycleDisposeOptions, T as LifecycleResourceHandle, V as LifecycleResourceSnapshot, W as LifecycleScopeKind, X as LifecycleScopeRevokedError, Y as LifecycleScopeState, Z as Message, _ as MessageBusSnapshot, $ as MessageHandler, a0 as MessageMode, a1 as OwnedResourceDefinition, a2 as PermissionDeniedError, a3 as PermissionLeaseBinding, a4 as PermissionLeaseBindingExpectation, a5 as PermissionLeaseRevokedError, a6 as PermissionPolicyInput, a7 as PermissionPolicyResult, a8 as PluginAttributes, a9 as PluginConfigStore, aa as PluginContext, ab as PluginIntentCommand, ac as PluginIntentCommandResult, ad as PluginIntentController, ae as PluginIntentCoordinator, af as PluginIntentSnapshot, ag as PluginIntentSubmissionResult, ah as PluginLifecycleState, ai as PluginStartupMode, aj as PluginState, ak as PluginTeardown, al as PluginUnitGraph, am as PublishOptions, an as RESOURCE_OWNER, ao as RESOURCE_REGISTRY_CAPABILITY, ap as RUNTIME_MESSAGE_BUS, aq as RemoteServiceBridgeState, ar as RemoteServiceCallContext, as as RemoteServiceLookup, at as RemoteServiceMessageKind, au as RemoteServicePortControlMessage, av as RemoteServiceSnapshotResult, aw as RemoteServiceTransport, ax as RemoteServiceUnavailableError, 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-ChJNBTsX.js';
-import { R as RemoteServicePortCallMessage } from './resourceRegistry-MNM1c7od.js';
-export { C as CreateMessagePortServiceTransportOptions, a as CreatePluginIntentControllerOptions, b as CreateResourceScopeOptions, c as CreateServiceBridgeOptions, d as RemoteServicePortCancelMessage, e as RemoteServicePortErrorMessage, f as RemoteServicePortResponseMessage, g as RemoteServicePortResultMessage, h as ResourceScopeOptions, i as RuntimeUnitImplementation, j as createLifecycleScope, k as createMessageBus, l as createMessagePortServiceTransport, m as createPluginIntentController, n as createRemoteServiceBridge, o as createResourceRegistry, p as createResourceScope, q as createRuntimeUnitImplementationRegistry, r as createServiceBridge, s as registerOwnedResource } from './resourceRegistry-MNM1c7od.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-Cb2a1_KD.js';
+export { C as CreateWindowAppOptions, a as createWindowApp } from './windowRuntime-B6Ue8jso.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>;
-}
-/**
- * 声明一个插件。
- *
- * 该函数不创建 Host，也不启动 setup；真正的启动边界由
- * 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 id: string;
+    /** 展示名称。 */
+    readonly name?: string;
+    /** 诊断描述。 */
+    readonly description?: string;
+    /** 本插件声明提供的能力。 */
+    readonly provides?: TProvides;
+    /** 本插件声明消费的能力。 */
+    readonly dependencies?: TDependencies;
+    /** 默认执行 Runtime。 */
+    readonly runtime?: RuntimeKind;
+    /** 多 unit 装配时的稳定 unit id。 */
     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[];
-
-declare const RUNTIME_PROTOCOL_VERSION = "webloom.runtime.v1";
-declare const RUNTIME_HELLO_TYPE = "webloom.runtime.hello";
-declare const RUNTIME_SNAPSHOT_TYPE = "webloom.runtime.snapshot";
-declare const RUNTIME_RESYNC_TYPE = "webloom.runtime.resync";
-declare const RUNTIME_ERROR_TYPE = "webloom.runtime.error";
-interface RuntimeHelloMessage {
-    type: typeof RUNTIME_HELLO_TYPE;
-    protocolVersion: string;
-    connectionId: string;
-    runtimeId: string;
-}
-interface RuntimeResyncMessage {
-    type: typeof RUNTIME_RESYNC_TYPE;
-    connectionId: string;
-}
-interface RuntimeErrorMessage {
-    type: typeof RUNTIME_ERROR_TYPE;
-    protocolVersion: string;
-    code: "runtime.protocol_mismatch" | "runtime.initialization_failed" | "runtime.invalid_connection";
-    message: string;
-    pluginId?: string;
-    unitId?: string;
-    phase?: string;
-}
-interface RuntimeSnapshot {
-    type: typeof RUNTIME_SNAPSHOT_TYPE;
-    protocolVersion: string;
-    runtimeId: string;
-    runtimeKind: RuntimeKind;
-    runtimeInstanceId: string;
-    connectionId: string;
-    snapshotRevision: number;
-    baseline: boolean;
-    state: "starting" | "ready" | "stopping" | "failed" | "disposed";
-    units: readonly RuntimeSnapshotUnit[];
-    services: readonly RemoteServiceReference[];
-}
-interface RuntimeSnapshotUnit {
-    pluginId: string;
-    unitId: string;
-    runtime: RuntimeKind;
-    instanceId?: string;
-    state: PluginStateKind;
-}
-declare function createRuntimeMessageCodec(): RemoteServiceMessageCodec;
-declare function isRuntimeHello(input: unknown): input is RuntimeHelloMessage;
-declare function isRuntimeResync(input: unknown): input is RuntimeResyncMessage;
-declare function isRuntimeSnapshot(input: unknown): input is RuntimeSnapshot;
-declare function isRuntimeError(input: unknown): input is RuntimeErrorMessage;
-/** 将 Host 的 PluginUnitState 映射成不会泄露领域配置的运行时快照。 */
-declare function unitSnapshotFromState(state: PluginUnitState, runtime: RuntimeKind): RuntimeSnapshotUnit;
-
-type RuntimeAppState = "starting" | "ready" | "stopping" | "failed" | "disposed" | "connecting" | "disconnected";
-interface RuntimeStatusSnapshot {
-    runtimeId: string;
-    runtimeKind: RuntimeKind;
-    runtimeInstanceId: string;
-    state: RuntimeAppState;
-    snapshotRevision: number;
-    connectionId?: string;
-    units: readonly RuntimeSnapshotUnit[];
-    services: readonly RemoteServiceReference[];
-    error?: string;
-}
-type RuntimeStatusListener = (snapshot: RuntimeStatusSnapshot) => void;
-interface WindowApp {
-    readonly runtimeKind: "window-main";
-    readonly runtimeId: string;
-    readonly runtimeInstanceId: string;
-    /** 已由 createWindowApp 装配并注册完成的本地 Host。 */
-    readonly host: PluginHost;
-    state(): RuntimeStatusSnapshot;
-    /** 获取当前本地 capability；停止或销毁后同步抛错。 */
-    capability<T>(capabilityId: string): T;
-    subscribe(listener: RuntimeStatusListener): () => void;
-    dispose(reason?: string): Promise<LifecycleDisposeResult>;
-}
-interface RuntimeHandle {
-    readonly runtimeKind: "shared-worker";
-    readonly runtimeId: string;
-    /** 当前连接绑定的 Worker 启动身份；未握手时为 undefined。 */
-    readonly runtimeInstanceId?: string;
-    /** 当前物理连接身份；未握手时为 undefined。 */
-    readonly connectionId?: string;
-    /** 当前连接已校验的服务桥；不暴露原始 MessagePort。 */
-    readonly serviceBridge: RemoteServiceBridge;
-    state(): RuntimeStatusSnapshot;
-    ready(): Promise<void>;
-    capability<T = unknown>(capabilityId: string, options?: {
-        contractVersion?: string;
-    }): RemoteServiceProxy & {
-        readonly serviceType?: T;
-    };
-    subscribe(listener: RuntimeStatusListener): () => void;
-    dispose(reason?: string): Promise<void>;
-}
-/** 跨 realm 初始化失败；不把 required 插件错误包装成成功状态。 */
-interface RuntimeInitializationErrorDetails {
-    pluginId?: string;
-    unitId?: string;
-    phase: "validate" | "register" | "startup" | "snapshot" | "handshake";
-    error: string;
-}
-declare class RuntimeInitializationError extends Error {
-    readonly code: "runtime.initialization_failed";
-    readonly details: RuntimeInitializationErrorDetails;
-    constructor(details: RuntimeInitializationErrorDetails);
-}
-declare class RuntimeUnavailableError extends Error {
-    readonly code: "runtime.unavailable";
-    constructor(message?: 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>;
 }
-
-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"> {
-    /** SharedWorker 的逻辑稳定标识。 */
-    id: string;
-    /** 只在 SharedWorker realm 执行的插件定义。 */
-    plugins: readonly RuntimePluginDefinition[];
-    /** 测试 fixture 可注入结构等价的 SharedWorkerGlobalScope。 */
-    globalScope?: SharedWorkerScopeLike;
-    /**
-     * 复用已有领域 Worker 入口的 onconnect 装配。回调只负责安装领域协议
-     * listener；WebLoom 仍在同一端口上安装自己的 Runtime listener，不会创建
-     * 第二个 Worker 或第二条物理连接。
-     */
-    onPortConnect?: (event: {
-        ports: MessagePort[];
-    }) => void;
-}
-interface SharedWorkerApp {
-    readonly runtimeKind: "shared-worker";
-    readonly runtimeId: string;
-    readonly runtimeInstanceId: string;
-    ready(): Promise<void>;
-    /** 重新按当前外部身份/意图对账运行单元；不会创建第二个 Worker。 */
-    reconcile(): Promise<void>;
-    state(): RuntimeStatusSnapshot;
-    subscribe(listener: RuntimeStatusListener): () => void;
-    dispose(reason?: string): Promise<LifecycleDisposeResult>;
-}
-/** 在当前 SharedWorkerGlobalScope 中安装唯一的 Worker Runtime。 */
-declare function startSharedWorkerApp(options: StartSharedWorkerAppOptions): SharedWorkerApp;
-
-interface SharedWorkerLike {
-    readonly port: MessagePort;
-    onerror?: (event: Event) => void;
-    /** 浏览器 SharedWorker 的错误事件；测试 fake 可省略。 */
-    addEventListener?(type: "error", listener: (event: Event) => void): void;
-    removeEventListener?(type: "error", listener: (event: Event) => void): void;
-}
-type SharedWorkerFactory = (url: string | URL, options: {
-    type: "module";
-    name?: string;
-}) => SharedWorkerLike;
 /**
- * 供仍需在同一物理连接上承载产品 RPC 的装配层使用。
- *
- * 普通调用方不需要这个接缝；它们只使用 RuntimeHandle 的状态和
- * serviceBridge。已有大量领域 RPC 的应用迁移时可以先把
- * Runtime 握手与旧 RPC 复用同一 MessagePort，再逐步把领域调用收敛到
- * capability service，而不会偷偷创建第二个 SharedWorker 连接。
+ * 声明一个插件。它不会创建 Host，也不会运行 setup；Runtime 装配边界
+ * createWindowApp()/startSharedWorkerApp() 才会执行实现。
  */
-interface SharedWorkerConnectionContext {
-    readonly worker: SharedWorkerLike;
-    readonly port: MessagePort;
-    readonly connectionId: string;
-}
-interface ConnectSharedWorkerOptions {
-    /** Worker 入口的逻辑 Runtime 标识。 */
-    id: string;
-    /** module SharedWorker URL；默认直接传给 new SharedWorker。 */
-    url: string | URL;
-    /** 可选的浏览器 SharedWorker name；不传时由 URL 参与实例隔离。 */
-    name?: string;
-    /** 断线后是否建立新连接；旧代理仍永久失效。默认为 true。 */
-    autoReconnect?: boolean;
-    /** 自动重连等待毫秒数。 */
-    reconnectDelayMs?: number;
-    /** 首个 runtime snapshot 到达前的握手超时；默认 10000ms。 */
-    handshakeTimeoutMs?: number;
-    /** 测试 fixture 使用；生产默认使用 globalThis.SharedWorker。 */
-    workerFactory?: SharedWorkerFactory;
-    /**
-     * 每次建立实际物理连接时调用一次；自动重连会再次调用。
-     * 回调可以在同一端口上安装产品协议，但不得替换 Runtime 的消息
-     * 监听器，也不得把旧端口保存为可重用连接。
-     */
-    onConnection?: (context: SharedWorkerConnectionContext) => void | Promise<void>;
-}
-/**
- * 从 Window 连接真实 module SharedWorker。
- *
- * Promise 只在首个完整 baseline 快照到达后成功；调用方得到的代理均绑定
- * 当前 connection/runtime/provider/revision，断线或重启不会静默换绑旧代理。
- */
-declare function connectSharedWorker(options: ConnectSharedWorkerOptions): Promise<RuntimeHandle>;
-
-/** 创建绑定到指定插件实例的 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 MessagePortServiceCallInput {
-    /** 传输层生成的调用包；业务 handler 不得把 callId 当业务幂等键。 */
-    message: RemoteServicePortCallMessage;
-    /** 调用方撤销或端点失效时自动终止的信号。 */
-    signal: AbortSignal;
-}
-interface CreateMessagePortServiceProviderOptions {
-    /** 与页面服务桥配对的专用双工端口。 */
-    port: MessagePort;
-    /** 本端产生的握手身份。 */
-    handshake: RemoteServiceHandshake;
-    /** 初始必须是完整基线快照。 */
-    snapshot: RemoteServiceSnapshot;
-    /** 具体服务分派；这里不自动重放调用。 */
-    handleCall(input: MessagePortServiceCallInput): Promise<unknown>;
-    /** dispose 时是否关闭本端端口；默认关闭。 */
-    closeOnDispose?: boolean;
-    /** wire 消息 codec；默认使用 webloom.remote-service.*。 */
-    codec?: RemoteServiceMessageCodec;
-}
-interface MessagePortServiceProvider {
-    /** 发布同一连接上的下一份连续目录快照。 */
-    publishSnapshot(snapshot: RemoteServiceSnapshot): void;
-    /** 同步通知消费者撤销当前代理；调用仍由 handler 自己做最终校验。 */
-    invalidate(reason?: string): void;
-    /** 发送断线控制消息并关闭端点。 */
-    disconnect(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 ConnectSharedWorkerOptions, type CreateMessagePortServiceProviderOptions, type CreatePermissionLeaseOptions, CreatePluginHostOptions, type CreateScopedRegistryFacadeOptions, type CreateScopedTaskSchedulerOptions, CreateUpgradeGateOptions, type CreateWindowAppOptions, type DefinePluginOptions, LifecycleDisposeResult, LifecycleScope, LifecycleScopeIdentity, type MaterializedPluginDefinition, MessageBus, type MessagePortServiceCallInput, type MessagePortServiceProvider, PermissionLease, PluginConfig, PluginContextExtension, PluginContribution, type PluginDefinition, PluginDependency, PluginGraph, type PluginGraphDiagnostic, PluginGraphValidationError, PluginHost, PluginManifest, PluginManifestInput, PluginMeta, PluginPermission, PluginReverseDep, PluginSetup, PluginStateKind, PluginUnitState, RUNTIME_ERROR_TYPE, RUNTIME_HELLO_TYPE, RUNTIME_PROTOCOL_VERSION, RUNTIME_RESYNC_TYPE, RUNTIME_SNAPSHOT_TYPE, RemoteServiceBridge, RemoteServiceHandshake, RemoteServiceMessageCodec, RemoteServicePortCallMessage, RemoteServiceProxy, RemoteServiceReference, RemoteServiceSnapshot, type RuntimeAppState, RuntimeDependency, type RuntimeErrorMessage, type RuntimeHandle, type RuntimeHelloMessage, RuntimeInitializationError, type RuntimeInitializationErrorDetails, RuntimeKind, type RuntimePluginDefinition, type RuntimeResyncMessage, type RuntimeSnapshot, type RuntimeSnapshotUnit, type RuntimeStatusListener, type RuntimeStatusSnapshot, RuntimeUnavailableError, RuntimeUnitDescriptorInput, type ScopedRegistryRegistration, ScopedTaskScheduler, type SharedWorkerApp, type SharedWorkerConnectionContext, type SharedWorkerFactory, type SharedWorkerLike, type SharedWorkerScopeLike, type StartSharedWorkerAppOptions, UpgradeGate, type ValidatePluginGraphOptions, type VerifyPermissionLeaseOptions, type WindowApp, buildPluginGraph, connectSharedWorker, createMessagePortServiceProvider, createPermissionLease, createRuntimeMessageCodec, createScopedMessageBus, createScopedRegistryFacade, createScopedTaskScheduler, createUpgradeGate, createWindowApp, definePlugin, dependenciesOfManifest, isRuntimeError, isRuntimeHello, isRuntimeResync, isRuntimeSnapshot, materializePluginDefinition, materializePluginDefinitions, providesOfManifest, reverseDependentsOf, startSharedWorkerApp, unitSnapshotFromState, validatePluginGraph, validateRuntimeUnitDependencyContracts, verifyPermissionLease };
+export { Capability, CapabilityDependency, type DefinePluginOptions, PluginConfig, PluginContextExtension, PluginContribution, PluginDefinition, PluginPermission, PluginSetup, RuntimeKind, definePlugin };