webloom-framework 0.4.2 → 0.4.3

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { ak as Capability, al as CapabilityDependency, am as PluginContribution, an as PluginConfig, ao as PluginContextExtension, R as RuntimeKind, e as PluginPermission, ap as PluginSetup, aq as PluginDefinition } from './runtimeTypes-CleHMFaq.js';
-export { ar as AppLike, as as CapabilityBridge, at as CapabilityClient, C as CapabilityDescriptor, au as CapabilityKind, l as CapabilityPeer, h as CreateUpgradeGateOptions, av as DefineLocalCapabilityOptions, aw as DefineRpcCapabilityOptions, ax as DefineStreamCapabilityOptions, ay as DispatchOptions, az as EventHandler, aA as FrameworkErrorCode, aB as FrameworkErrorContext, aC as FrameworkErrorPhase, aD as HandlerCallContext, aE as HandlerOptions, aF as HandlerOrigin, aG as HostListener, aH as ItemOf, aI as LIFECYCLE_ERROR_TEXT, aJ as LifecycleCleanup, aK as LifecycleCleanupIssue, aL as LifecycleCleanupPhase, aM as LifecycleDisposeOptions, aN as LifecycleDisposeResult, aO as LifecycleResourceHandle, aP as LifecycleResourceSnapshot, f as LifecycleScope, L as LifecycleScopeIdentity, aQ as LifecycleScopeKind, aR as LifecycleScopeRevokedError, aS as LifecycleScopeState, aT as LocalCapability, aU as LocalServiceOf, aV as Message, aW as MessageBus, aX as MessageBusSnapshot, aY as MessageHandler, aZ as MessageMode, a_ as OwnedResourceDefinition, a$ as PeerCapabilityDependency, b0 as PeerScopeView, b1 as PermissionDeniedError, g as PermissionLease, b2 as PermissionLeaseBinding, b3 as PermissionLeaseBindingExpectation, b4 as PermissionLeaseRevokedError, b5 as PluginAttributes, b6 as PluginContext, a as PluginGraph, b7 as PluginIntentCommand, b8 as PluginIntentCommandResult, b9 as PluginIntentController, ba as PluginIntentCoordinator, bb as PluginIntentSnapshot, bc as PluginIntentSubmissionResult, bd as PluginLifecycleState, P as PluginManifest, be as PluginManifestInput, c as PluginReverseDep, bf as PluginStartupMode, bg as PluginState, bh as PluginStateKind, bi as PluginTeardown, bj as PluginUnitGraph, bk as PluginUnitState, bl as PublishOptions, bm as RESOURCE_OWNER, bn as RESOURCE_REGISTRY, bo as RUNTIME_MESSAGE_BUS, bp as RemoteCapability, bq as RequestOf, br as RequestOptions, bs as ResourceContext, bt as ResourceDefinition, bu as ResourceKey, bv as ResourceRegistry, bw as ResourceSnapshot, bx as ResourceStatus, by as ResponseOf, bz as RpcCallOptions, bA as RpcCapability, bB as RpcCapabilityBase, bC as RpcClient, bD as RpcHandler, bE as RpcTransferDescriptor, bF as RuntimeCapabilityDependency, m as RuntimeDrainResult, k as RuntimeEndpointBinding, bG as RuntimeEndpointState, o as RuntimeHandle, bH as RuntimeInitializationError, bI as RuntimeLimits, bJ as RuntimeServiceSnapshot, bK as RuntimeSnapshot, bL as RuntimeStatusListener, bM as RuntimeStatusSnapshot, bN as RuntimeUnavailableError, b as RuntimeUnitDependency, bO as RuntimeUnitDependencyInput, d as RuntimeUnitDescriptor, bP as RuntimeUnitDescriptorInput, bQ as RuntimeUnitImplementationRegistry, bR as SCOPED_TASK_SCHEDULER_CAPABILITY, bS as ScopedTaskDefinition, S as ScopedTaskScheduler, bT as ScopedTaskSnapshot, j as ServiceReference, bU as SnapshotApplyResult, bV as StartupCapabilityErrorDetails, bW as StartupPluginErrorDetails, bX as StreamCapability, bY as StreamCapabilityBase, bZ as StreamClient, b_ as StreamHandler, b$ as StreamSubscribeOptions, c0 as StreamSubscription, c1 as StreamTransferDescriptor, c2 as TransferExtractor, c3 as UpgradeDrainResult, U as UpgradeGate, c4 as UpgradeGateRejectedError, c5 as UpgradeGateState, c6 as UpgradeHandshake, c7 as UpgradeHandshakeResult, c8 as UpgradeIoLease, c9 as UpgradeMode, ca as UpgradeSession, cb as ValueParser, cc as WebLoomError, W as WindowApp, cd as assertCapability, ce as capabilityDescriptor, cf as capabilityKey, cg as defineCapability, ch as isCapability, ci as isCapabilityDescriptor, cj as lifecycleErrorText } from './runtimeTypes-CleHMFaq.js';
-export { A as ActivePeerSnapshot, l as ConnectSharedWorkerOptions, P as PeerController, d as PeerExposureOptions, e as PeerLifecycleEvent, c as RuntimePluginDefinition, S as SharedWorkerApp, m as SharedWorkerLike, h as StartSharedWorkerAppOptions, n as connectSharedWorker, j as createLifecycleScope, k as createResourceScope, s as startSharedWorkerApp } from './sharedWorkerHost-BNMUW-8v.js';
-export { C as CreateWindowAppOptions, a as createWindowApp } from './windowRuntime-BGl_jfbK.js';
-export { c as createMessageBus } from './messageBus-BDtkjs6y.js';
+import { N as Capability, O as CapabilityDependency, Q as PluginContribution, T as PluginConfig, V as PluginContextExtension, R as RuntimeKind, e as PluginPermission, X as PluginSetup, Y as PluginDefinition } from './runtimeTypes-50LVQs0h.js';
+export { Z as AppLike, _ as CapabilityBridge, $ as CapabilityClient, C as CapabilityDescriptor, a0 as CapabilityKind, k as CapabilityPeer, h as CreateUpgradeGateOptions, a1 as DefineLocalCapabilityOptions, a2 as DefineRpcCapabilityOptions, a3 as DefineStreamCapabilityOptions, a4 as DispatchOptions, a5 as EventHandler, a6 as FrameworkErrorCode, a7 as FrameworkErrorContext, a8 as FrameworkErrorPhase, a9 as HandlerCallContext, aa as HandlerOptions, ab as HandlerOrigin, ac as HostListener, ad as ItemOf, ae as LIFECYCLE_ERROR_TEXT, af as LifecycleCleanup, ag as LifecycleCleanupIssue, ah as LifecycleCleanupPhase, ai as LifecycleDisposeOptions, aj as LifecycleDisposeResult, ak as LifecycleResourceHandle, al as LifecycleResourceSnapshot, f as LifecycleScope, L as LifecycleScopeIdentity, am as LifecycleScopeKind, an as LifecycleScopeRevokedError, ao as LifecycleScopeState, ap as LocalCapability, aq as LocalServiceOf, ar as Message, as as MessageBus, at as MessageBusSnapshot, au as MessageHandler, av as MessageMode, aw as OwnedResourceDefinition, ax as PeerCapabilityDependency, ay as PeerScopeView, az as PermissionDeniedError, g as PermissionLease, aA as PermissionLeaseBinding, aB as PermissionLeaseBindingExpectation, aC as PermissionLeaseRevokedError, aD as PluginAttributes, aE as PluginContext, a as PluginGraph, aF as PluginIntentCommand, aG as PluginIntentCommandResult, aH as PluginIntentController, aI as PluginIntentCoordinator, aJ as PluginIntentSnapshot, aK as PluginIntentSubmissionResult, aL as PluginLifecycleState, P as PluginManifest, aM as PluginManifestInput, c as PluginReverseDep, aN as PluginStartupMode, aO as PluginState, aP as PluginStateKind, aQ as PluginTeardown, aR as PluginUnitGraph, aS as PluginUnitState, aT as PublishOptions, aU as RESOURCE_OWNER, aV as RESOURCE_REGISTRY, aW as RUNTIME_MESSAGE_BUS, aX as RemoteCapability, aY as RequestOf, aZ as RequestOptions, a_ as ResourceContext, a$ as ResourceDefinition, b0 as ResourceKey, b1 as ResourceRegistry, b2 as ResourceSnapshot, b3 as ResourceStatus, b4 as ResponseOf, b5 as RpcCallOptions, b6 as RpcCapability, b7 as RpcCapabilityBase, b8 as RpcClient, b9 as RpcHandler, ba as RpcTransferDescriptor, bb as RuntimeCapabilityDependency, l as RuntimeDrainResult, j as RuntimeEndpointBinding, bc as RuntimeEndpointState, n as RuntimeHandle, bd as RuntimeInitializationError, be as RuntimeLimits, bf as RuntimeServiceSnapshot, bg as RuntimeSnapshot, bh as RuntimeStatusListener, bi as RuntimeStatusSnapshot, bj as RuntimeUnavailableError, b as RuntimeUnitDependency, bk as RuntimeUnitDependencyInput, d as RuntimeUnitDescriptor, bl as RuntimeUnitDescriptorInput, bm as RuntimeUnitImplementationRegistry, bn as SCOPED_TASK_SCHEDULER_CAPABILITY, bo as ScopedTaskDefinition, S as ScopedTaskScheduler, bp as ScopedTaskSnapshot, i as ServiceReference, bq as SnapshotApplyResult, br as StartupCapabilityErrorDetails, bs as StartupPluginErrorDetails, bt as StreamCapability, bu as StreamCapabilityBase, bv as StreamClient, bw as StreamHandler, bx as StreamSubscribeOptions, by as StreamSubscription, bz as StreamTransferDescriptor, bA as TransferExtractor, bB as UpgradeDrainResult, U as UpgradeGate, bC as UpgradeGateRejectedError, bD as UpgradeGateState, bE as UpgradeHandshake, bF as UpgradeHandshakeResult, bG as UpgradeIoLease, bH as UpgradeMode, bI as UpgradeSession, bJ as ValueParser, bK as WebLoomError, W as WindowApp, bL as assertCapability, bM as capabilityDescriptor, bN as capabilityKey, bO as defineCapability, bP as isCapability, bQ as isCapabilityDescriptor, bR as lifecycleErrorText } from './runtimeTypes-50LVQs0h.js';
+export { q as ConnectSharedWorkerOptions, P as PeerController, d as PeerExposureOptions, f as RuntimeLockError, g as RuntimeLockFailureCode, h as RuntimeLockHandle, i as RuntimeLockManagerLike, j as RuntimeLockMessages, k as RuntimeLockOptions, c as RuntimePluginDefinition, S as SharedWorkerApp, r as SharedWorkerLike, m as StartSharedWorkerAppOptions, W as WEBLOOM_RUNTIME_LOCK_PREFIX, s as connectSharedWorker, o as createLifecycleScope, p as createResourceScope, t as startSharedWorkerApp } from './sharedWorkerHost-DikS18hA.js';
+export { C as CreateWindowAppOptions, a as createWindowApp } from './windowRuntime-e1Tn6SnN.js';
+export { c as createMessageBus } from './messageBus-DigYfj74.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> {

package/dist/index.js

@@ -1,7 +1,7 @@
-export { startSharedWorkerApp } from './chunk-RRNUE457.js';
-export { connectSharedWorker } from './chunk-XVD7ALPV.js';
-import { capabilityDescriptor } from './chunk-CKML74MG.js';
-export { LIFECYCLE_ERROR_TEXT, LifecycleScopeRevokedError, PermissionDeniedError, PermissionLeaseRevokedError, RESOURCE_OWNER, RESOURCE_REGISTRY, RuntimeInitializationError, RuntimeUnavailableError, SCOPED_TASK_SCHEDULER_CAPABILITY, UpgradeGateRejectedError, WebLoomError, assertCapability, capabilityDescriptor, capabilityKey, createLifecycleScope, createMessageBus, createResourceScope, createWindowApp, defineCapability, isCapability, isCapabilityDescriptor, lifecycleErrorText } from './chunk-CKML74MG.js';
+export { startSharedWorkerApp } from './chunk-UZAO6ORB.js';
+export { RuntimeLockError, WEBLOOM_RUNTIME_LOCK_PREFIX, connectSharedWorker } from './chunk-YIIDRFHK.js';
+import { capabilityDescriptor } from './chunk-ZP5QYTXX.js';
+export { LIFECYCLE_ERROR_TEXT, LifecycleScopeRevokedError, PermissionDeniedError, PermissionLeaseRevokedError, RESOURCE_OWNER, RESOURCE_REGISTRY, RuntimeInitializationError, RuntimeUnavailableError, SCOPED_TASK_SCHEDULER_CAPABILITY, UpgradeGateRejectedError, WebLoomError, assertCapability, capabilityDescriptor, capabilityKey, createLifecycleScope, createMessageBus, createResourceScope, createWindowApp, defineCapability, isCapability, isCapabilityDescriptor, lifecycleErrorText } from './chunk-ZP5QYTXX.js';
 
 // src/contracts/messageBus.ts
 var RUNTIME_MESSAGE_BUS = "webloom.messageBus";

package/dist/{messageBus-BDtkjs6y.d.ts → messageBus-DigYfj74.d.ts}

@@ -1,4 +1,4 @@
-import { aW as MessageBus } from './runtimeTypes-CleHMFaq.js';
+import { as as MessageBus } from './runtimeTypes-50LVQs0h.js';
 
 declare function createMessageBus(): MessageBus;
 

package/dist/messagePortServiceTransport-B9-24RK6.d.ts

@@ -0,0 +1,355 @@
+import { X as PluginSetup, N as Capability, bm as RuntimeUnitImplementationRegistry, aJ as PluginIntentSnapshot, aH as PluginIntentController, b1 as ResourceRegistry, a$ as ResourceDefinition, bg as RuntimeSnapshot, j as RuntimeEndpointBinding, R as RuntimeKind, aP as PluginStateKind, bc as RuntimeEndpointState, l as RuntimeDrainResult, _ as CapabilityBridge } from './runtimeTypes-50LVQs0h.js';
+import { R as ReceivePortLedger, a as RuntimeLimitsInput, b as RuntimeBudget } from './sharedWorkerHost-DikS18hA.js';
+
+interface RuntimeUnitImplementation {
+    /** 产品标识。 */
+    pluginId: string;
+    /** 稳定运行单元标识。 */
+    unitId: string;
+    /** 当前环境的可执行入口。 */
+    setup: PluginSetup;
+    /** 当前 realm 的 typed capability 定义。 */
+    capabilities?: readonly Capability[];
+}
+/** 创建一个拒绝重复注册、按产品和单元查找实现的运行时注册表。 */
+declare function createRuntimeUnitImplementationRegistry(implementations?: readonly RuntimeUnitImplementation[]): RuntimeUnitImplementationRegistry & {
+    register(implementation: RuntimeUnitImplementation): void;
+    unregister(pluginId: string, unitId: string): void;
+};
+
+interface CreatePluginIntentControllerOptions {
+    /** 当前控制面启动身份；Worker 重启时应传入新值。 */
+    authorityInstanceId?: string;
+    /** Worker 恢复后读取的平台意图。 */
+    initial?: Partial<PluginIntentSnapshot>;
+    /** 将候选快照原子写入平台存储；缺省表示内存控制面（测试用）。 */
+    persist?: (snapshot: PluginIntentSnapshot) => Promise<void>;
+    /** 有界去重记录数量，避免 commandId 永久增长。 */
+    maxCommandRecords?: number;
+}
+/** 创建单一控制面上的插件意图控制器。 */
+declare function createPluginIntentController(options?: CreatePluginIntentControllerOptions): PluginIntentController;
+
+/**
+ * 资源注册表实现
+ *
+ * 设计缘由：管理资源定义的注册和查询，支持 owner-aware 生命周期。
+ * 重复 id 抛错，disable 时可回收。
+ */
+
+/** 资源注册表实现 */
+declare function createResourceRegistry(): ResourceRegistry;
+/** Internal runtime hook; deliberately absent from ResourceRegistry's public type. */
+declare function registerOwnedResource(registry: ResourceRegistry, ownerId: string, definition: ResourceDefinition<any, any>): void;
+
+declare const RUNTIME_PROTOCOL_VERSION: "webloom.runtime.v1";
+declare const RUNTIME_SNAPSHOT_TYPE: "webloom.runtime.v1.snapshot";
+declare const RUNTIME_ERROR_TYPE: "webloom.runtime.v1.runtime-error";
+declare const RUNTIME_CALL_TYPE: "webloom.runtime.v1.call";
+declare const RUNTIME_RESULT_TYPE: "webloom.runtime.v1.result";
+declare const RUNTIME_ERROR_MESSAGE_TYPE: "webloom.runtime.v1.error";
+declare const RUNTIME_CANCEL_TYPE: "webloom.runtime.v1.cancel";
+declare const RUNTIME_NEXT_TYPE: "webloom.runtime.v1.next";
+declare const RUNTIME_CREDIT_TYPE: "webloom.runtime.v1.credit";
+declare const RUNTIME_CLOSE_TYPE: "webloom.runtime.v1.close";
+declare const RUNTIME_CLOSE_ACK_TYPE: "webloom.runtime.v1.close-ack";
+/** 每条 Runtime wire 消息所属的框架 endpoint 身份。 */
+type RuntimeSessionBinding = RuntimeEndpointBinding;
+interface RuntimeSnapshotUnit {
+    /** 插件标识。 */
+    readonly pluginId: string;
+    /** 单元标识。 */
+    readonly unitId: string;
+    /** Runtime。 */
+    readonly runtime: RuntimeKind;
+    /** 实例标识。 */
+    readonly instanceId?: string;
+    /** 状态。 */
+    readonly state: PluginStateKind;
+}
+type RuntimeSnapshotMessage = RuntimeSnapshot & {
+    readonly type: typeof RUNTIME_SNAPSHOT_TYPE;
+    readonly binding?: RuntimeSessionBinding;
+};
+interface RuntimeErrorMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_ERROR_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 发送此错误的物理 endpoint 绑定。 */
+    readonly binding?: RuntimeSessionBinding;
+    /** 结构化错误码。 */
+    readonly code: string;
+    /** 脱敏消息。 */
+    readonly message: string;
+    /** 失败阶段。 */
+    readonly phase: "validate" | "wait" | "dispatch" | "execute" | "receive" | "dispose";
+    /** 可选插件标识。 */
+    readonly pluginId?: string;
+    /** 可选单元标识。 */
+    readonly unitId?: string;
+}
+interface RuntimeCallMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_CALL_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 发起调用的物理 endpoint 绑定。 */
+    readonly binding?: RuntimeSessionBinding;
+    /** 方向内唯一 call id。 */
+    readonly callId: string;
+    /** capability 标识。 */
+    readonly capabilityId: string;
+    /** 契约版本。 */
+    readonly contractVersion: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** 调用模式。 */
+    readonly mode: "unary" | "stream";
+    /** 本次派发的剩余预算。 */
+    readonly timeoutMs: number;
+    /** 已 parser 验证的请求。 */
+    readonly request: unknown;
+    /** 产品操作标识。 */
+    readonly operationId?: string;
+    /** 领域授权标识。 */
+    readonly grantId?: string;
+    /** stream 初始 credit。 */
+    readonly initialCredit?: number;
+}
+interface RuntimeUnaryResultMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_RESULT_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 发送结果的物理 endpoint 绑定。 */
+    readonly binding?: RuntimeSessionBinding;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** unary 结果。 */
+    readonly result: unknown;
+}
+interface RuntimeStreamReadyMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_RESULT_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 发送结果的物理 endpoint 绑定。 */
+    readonly binding?: RuntimeSessionBinding;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** stream 建立确认。 */
+    readonly streamReady: true;
+}
+interface RuntimeStreamDoneMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_RESULT_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 发送结果的物理 endpoint 绑定。 */
+    readonly binding?: RuntimeSessionBinding;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** stream 正常结束。 */
+    readonly done: true;
+}
+type RuntimeResultMessage = RuntimeUnaryResultMessage | RuntimeStreamReadyMessage | RuntimeStreamDoneMessage;
+interface RuntimeErrorResponseMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_ERROR_MESSAGE_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 发送错误响应的物理 endpoint 绑定。 */
+    readonly binding?: RuntimeSessionBinding;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** 结构化错误。 */
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+        readonly phase: RuntimeErrorMessage["phase"];
+        readonly details?: Readonly<Record<string, unknown>>;
+    };
+}
+interface RuntimeCancelMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_CANCEL_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 发送取消的物理 endpoint 绑定。 */
+    readonly binding?: RuntimeSessionBinding;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+}
+interface RuntimeNextMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_NEXT_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 发送 stream item 的物理 endpoint 绑定。 */
+    readonly binding?: RuntimeSessionBinding;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** 连续序号。 */
+    readonly sequence: number;
+    /** parser 验证的 item。 */
+    readonly item: unknown;
+}
+interface RuntimeCreditMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_CREDIT_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 发送 credit 的物理 endpoint 绑定。 */
+    readonly binding?: RuntimeSessionBinding;
+    /** call id。 */
+    readonly callId: string;
+    /** exposure 身份。 */
+    readonly serviceInstanceId: string;
+    /** 新增 credit。 */
+    readonly count: number;
+}
+/** 请求对端先同步 fence、再等待真实执行排空。 */
+interface RuntimeCloseMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_CLOSE_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 发起关闭的物理 endpoint 绑定。 */
+    readonly binding?: RuntimeSessionBinding;
+    /** 对端 drain 的最大等待时间。 */
+    readonly timeoutMs?: number;
+}
+/** 对端完成或超时 drain 后返回的关闭确认。 */
+interface RuntimeCloseAckMessage {
+    /** 消息类型。 */
+    readonly type: typeof RUNTIME_CLOSE_ACK_TYPE;
+    /** 协议版本。 */
+    readonly protocolVersion: typeof RUNTIME_PROTOCOL_VERSION;
+    /** 发送确认的物理 endpoint 绑定。 */
+    readonly binding: RuntimeSessionBinding;
+    /** 确认对应的发起方 binding，防止旧 close-ack 误配新 session。 */
+    readonly acknowledgedBinding: RuntimeSessionBinding;
+    /** 对端本次 drain 的结果。 */
+    readonly drained: boolean;
+    /** 是否达到 bounded deadline。 */
+    readonly timedOut: boolean;
+    /** deadline 到达时仍存活的执行槽数量。 */
+    readonly pendingExecutions: number;
+}
+type RuntimeWireMessage = RuntimeSnapshotMessage | RuntimeErrorMessage | RuntimeCallMessage | RuntimeResultMessage | RuntimeErrorResponseMessage | RuntimeCancelMessage | RuntimeNextMessage | RuntimeCreditMessage | RuntimeCloseMessage | RuntimeCloseAckMessage;
+interface RuntimeMessageCodec {
+    /** 严格验证并冻结 v4 message。 */
+    encode(message: RuntimeWireMessage): RuntimeWireMessage;
+    /** 严格解析 v4 message；旧协议直接拒绝。 */
+    decode(value: unknown): RuntimeWireMessage;
+}
+declare function createRuntimeMessageCodec(): RuntimeMessageCodec;
+declare function isRuntimeSnapshot(value: RuntimeWireMessage): value is RuntimeSnapshotMessage;
+
+/** 一个需要等待真实执行槽结束的框架参与者。 */
+interface RuntimeDrainParticipant {
+    /** 等待该参与者自己的真实执行槽结束。 */
+    readonly drain: () => Promise<void>;
+    /** deadline 到达时报告仍未结束的真实执行槽数量。 */
+    readonly pending: () => number;
+}
+interface RuntimeEndpointSession {
+    /** 本端由框架生成、不可复用的 endpoint 身份。 */
+    readonly binding: RuntimeEndpointBinding;
+    /** 已由对端首条合法框架消息建立的身份；尚未建立时为空。 */
+    readonly remoteBinding?: RuntimeEndpointBinding;
+    /** active -> closing -> closed。 */
+    readonly state: RuntimeEndpointState;
+    /** 最近一次同步关闭原因；只用于本地诊断。 */
+    readonly closeReason?: string;
+    /** 本端允许的最大 drain 时间；远端只能进一步收紧，不能扩大。 */
+    readonly maxDrainTimeoutMs: number;
+    /** 精确比较并建立对端 binding；不接受后续替换。 */
+    acceptRemoteBinding(binding: unknown): boolean;
+    /** 同步停止准入、触发撤权和 abort；幂等。 */
+    beginClose(reason?: string): void;
+    /** 等待全部参与者排空，始终受 bounded deadline 限制。 */
+    drain(timeoutMs?: number): Promise<RuntimeDrainResult>;
+    /** 物理 transport 即将关闭时标记终态；幂等。 */
+    close(): void;
+    /** 注册同步关闭回调。 */
+    onBeginClose(listener: (reason: string) => void): () => void;
+    /** 注册物理关闭回调。 */
+    onClosed(listener: () => void): () => void;
+    /** 注册一个真实执行排空参与者。 */
+    registerDrainParticipant(participant: RuntimeDrainParticipant): () => void;
+}
+
+interface RuntimeReceiveMetadata {
+    /** 本次 MessageEvent 实际携带的业务 MessagePort；仅 transport 本地使用。 */
+    readonly ports?: readonly MessagePort[];
+    /** 由物理 endpoint transport 创建的一次性接收资源账本。 */
+    readonly ledger?: ReceivePortLedger;
+    /** 物理 endpoint 已完成一次 codec decode。 */
+    readonly decoded?: boolean;
+}
+interface RuntimeTransport {
+    /** 发送已验证 v4 message；transfer 由契约 extractor 提供。 */
+    send(message: RuntimeWireMessage, transfer?: readonly Transferable[]): void;
+    /** 订阅接收 message 及本次事件的本地 transfer 元数据。 */
+    subscribe(listener: (message: RuntimeWireMessage, metadata?: RuntimeReceiveMetadata) => void): () => void;
+    /** 关闭本端传输。 */
+    close?(): void;
+    /** 物理 endpoint 对 decode/接收账本错误的统一通知。 */
+    subscribeError?(listener: (error: unknown, metadata?: RuntimeReceiveMetadata) => void): () => void;
+}
+interface CreateCapabilityBridgeOptions {
+    /** 底层双向 transport。 */
+    readonly transport: RuntimeTransport;
+    /** 预期的对端 Runtime 类型。 */
+    readonly remoteRuntimeKind?: RuntimeKind;
+    /** 预期的对端逻辑 Runtime id。 */
+    readonly remoteRuntimeId?: string;
+    /** 默认调用预算。 */
+    readonly defaultCallTimeoutMs?: number;
+    /** 可信 Runtime/advanced 装配提供的预算；只能收紧 v4 默认值。 */
+    readonly limits?: RuntimeLimitsInput;
+    /** 可选的 Runtime 方向共享计数器。 */
+    readonly budget?: RuntimeBudget;
+    /** 当前物理 endpoint 的框架 binding；省略时由 bridge 生成。 */
+    readonly binding?: RuntimeEndpointBinding;
+    /** 与反向 provider 共用的 endpoint session。 */
+    readonly session?: RuntimeEndpointSession;
+    /** 关闭握手默认 drain deadline。 */
+    readonly drainTimeoutMs?: number;
+}
+/** 创建按 peer 绑定、可撤销且支持 typed stream 的 bridge。 */
+declare function createCapabilityBridge(options: CreateCapabilityBridgeOptions): CapabilityBridge & {
+    readonly pendingCallCount: number;
+    readonly activeStreamCount: number;
+    readonly retainedPayloadBytes: number;
+};
+/** 内部 typed transfer 校验 helper；不接受 call 级临时 transfer 数组。 */
+declare function validateTransferables(value: unknown, transfer: readonly Transferable[] | undefined, limits?: RuntimeLimitsInput): readonly Transferable[];
+
+interface MessagePortLike {
+    addEventListener(type: "message" | "messageerror", listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: "message" | "messageerror", listener: (event: MessageEvent) => void): void;
+    postMessage(message: unknown, transfer?: readonly Transferable[]): void;
+    start?(): void;
+    close?(): void;
+}
+/** 将一个真实 MessagePort 绑定为双向 v4 transport。 */
+declare function createMessagePortRuntimeTransport(port: MessagePortLike, options?: {
+    readonly limits?: RuntimeLimitsInput;
+}): RuntimeTransport;
+
+export { type RuntimeSnapshotUnit as A, type RuntimeStreamDoneMessage as B, type CreateCapabilityBridgeOptions as C, type RuntimeStreamReadyMessage as D, type RuntimeUnaryResultMessage as E, type RuntimeUnitImplementation as F, type RuntimeWireMessage as G, createCapabilityBridge as H, createMessagePortRuntimeTransport as I, createPluginIntentController as J, createResourceRegistry as K, createRuntimeMessageCodec as L, type MessagePortLike as M, createRuntimeUnitImplementationRegistry as N, isRuntimeSnapshot as O, registerOwnedResource as P, validateTransferables as Q, type RuntimeCallMessage as R, type RuntimeTransport as a, type RuntimeEndpointSession as b, type CreatePluginIntentControllerOptions as c, RUNTIME_CALL_TYPE as d, RUNTIME_CANCEL_TYPE as e, RUNTIME_CLOSE_ACK_TYPE as f, RUNTIME_CLOSE_TYPE as g, RUNTIME_CREDIT_TYPE as h, RUNTIME_ERROR_MESSAGE_TYPE as i, RUNTIME_ERROR_TYPE as j, RUNTIME_NEXT_TYPE as k, RUNTIME_PROTOCOL_VERSION as l, RUNTIME_RESULT_TYPE as m, RUNTIME_SNAPSHOT_TYPE as n, type RuntimeCancelMessage as o, type RuntimeCloseAckMessage as p, type RuntimeCloseMessage as q, type RuntimeCreditMessage as r, type RuntimeErrorMessage as s, type RuntimeErrorResponseMessage as t, type RuntimeMessageCodec as u, type RuntimeNextMessage as v, type RuntimeReceiveMetadata as w, type RuntimeResultMessage as x, type RuntimeSessionBinding as y, type RuntimeSnapshotMessage as z };

package/dist/react.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { W as WindowApp, o as RuntimeHandle, ak as Capability, at as CapabilityClient, ar as AppLike, bg as PluginState, a as PluginGraph, c as PluginReverseDep, bc as PluginIntentSubmissionResult, P as PluginManifest, C as CapabilityDescriptor, n as ResourceStoreApi, bw as ResourceSnapshot } from './runtimeTypes-CleHMFaq.js';
+import { W as WindowApp, n as RuntimeHandle, N as Capability, $ as CapabilityClient, Z as AppLike, aO as PluginState, a as PluginGraph, c as PluginReverseDep, aK as PluginIntentSubmissionResult, P as PluginManifest, C as CapabilityDescriptor, m as ResourceStoreApi, b2 as ResourceSnapshot } from './runtimeTypes-50LVQs0h.js';
 
 type WebLoomApp = WindowApp | RuntimeHandle;
 declare const WebLoomContext: react.Context<WebLoomApp | undefined>;

package/dist/react.js

@@ -1,4 +1,4 @@
-import { hostForWindowApp } from './chunk-CKML74MG.js';
+import { hostForWindowApp } from './chunk-ZP5QYTXX.js';
 import { createContext, useContext, useCallback, useSyncExternalStore, useMemo, useRef } from 'react';
 import { jsx } from 'react/jsx-runtime';