webloom-framework 0.3.0 → 0.4.0

package/dist/sharedWorkerHost-Cb2a1_KD.d.ts

@@ -0,0 +1,190 @@
+import { ak as LifecycleScopeKind, L as LifecycleScopeIdentity, f as LifecycleScope, ah as LifecycleDisposeResult, bb as RuntimeLimits, P as PluginManifest, T as PluginSetup, K as Capability, l as RuntimeHandle, Y as CapabilityBridge, W as WindowApp, aV as RemoteCapability, j as CapabilityPeer, Z as CapabilityClient, a7 as HandlerCallContext, bf as RuntimeStatusSnapshot, be as RuntimeStatusListener, t as HostInspection, s as CreatePluginHostOptions } from './runtimeTypes-DquUCHz-.js';
+
+interface CreateResourceScopeOptions {
+    /** 可选固定作用域标识；生产代码通常省略，让实现生成不可复用 ID。 */
+    scopeId?: string;
+    /** 运行实例标识；省略时与 scopeId 同源生成。 */
+    instanceId?: string;
+    /** 作用域类型。 */
+    kind: LifecycleScopeKind;
+    /** 绑定插件和宿主只读属性。 */
+    metadata?: Omit<Partial<LifecycleScopeIdentity>, "scopeId" | "instanceId" | "kind">;
+    /** 测试或宿主诊断使用的状态变更回调。 */
+    onChange?: (scope: LifecycleScope) => void;
+    /** 子作用域生成最终清理结果后的内部通知；用于更新父级登记。 */
+    onDisposeResult?: (result: LifecycleDisposeResult) => void;
+}
+/**
+ * 创建一个可嵌套的生命周期作用域。
+ *
+ * `createResourceScope` 是 `createLifecycleScope` 的同义入口，方便不同
+ * 模块按“作用域”或“资源”语义调用；两者不代表两套实现。
+ */
+declare function createLifecycleScope(options: CreateResourceScopeOptions): LifecycleScope;
+/** 语义别名：资源管理代码通常以 ResourceScope 称呼同一原语。 */
+declare const createResourceScope: typeof createLifecycleScope;
+type ResourceScopeOptions = CreateResourceScopeOptions;
+
+type RuntimeLimitsInput = Partial<RuntimeLimits>;
+/** Runtime execution slot 释放时等待调度的回调。 */
+type RuntimeExecutionWaiter = () => void;
+/** 一个 Runtime/方向共享的原子配额计数器；仅由 transport 装配层持有。 */
+interface RuntimeBudget {
+    readonly limits: RuntimeLimits;
+    pendingCalls: number;
+    activeStreams: number;
+    executionSlots: number;
+    retainedPayloadBytes: number;
+    /** 以 FIFO 顺序登记一个等待全局 execution slot 的 transport 队列。 */
+    registerExecutionWaiter(waiter: RuntimeExecutionWaiter): () => void;
+    /** 释放一个全局 execution slot，并公平唤醒一个等待者。 */
+    releaseExecutionSlot(): void;
+}
+/** 对接收端已有的 MessageEvent.ports 建立一次性关闭账本。 */
+interface ReceivePortLedger {
+    /** 本次消息实际收到的 raw ports。 */
+    readonly ports: readonly MessagePort[];
+    /** raw 账本是否通过数量、类型和去重检查。 */
+    readonly valid: boolean;
+    /** 将所有端口的关闭责任移交业务调用者。 */
+    handoff(): void;
+    /** 关闭尚未移交的端口；幂等。 */
+    closeUndelivered(): void;
+}
+
+/** 可传给 Runtime 的 v4 插件定义；没有旧 manifest 字段或兼容签名。 */
+type RuntimePluginDefinition = {
+    /** 静态 manifest。 */
+    readonly manifest: PluginManifest;
+    /** 当前 realm 的 setup 实现。 */
+    readonly setup: PluginSetup;
+    /** 当前 realm 的 typed capability 定义表。 */
+    readonly capabilities?: readonly Capability[];
+    /** 多 unit 定义中的实现目标。 */
+    readonly unitId?: string;
+};
+
+interface SharedWorkerLike {
+    /** SharedWorker 主端口。 */
+    readonly port: MessagePort;
+    /** Worker error callback。 */
+    onerror?: (event: Event) => void;
+    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;
+    credentials?: RequestCredentials;
+}) => SharedWorkerLike;
+interface SharedWorkerClientExposure {
+    /** 已完成本地初始化的 WindowApp。 */
+    readonly app: WindowApp;
+    /** 明确暴露给 Worker 的 RPC/stream capability。 */
+    readonly expose?: readonly RemoteCapability[];
+}
+interface ConnectSharedWorkerOptions {
+    /** Worker Runtime 逻辑标识。 */
+    readonly id: string;
+    /** Worker 构建 URL。 */
+    readonly url: string | URL;
+    /** SharedWorker name。 */
+    readonly name?: string;
+    /** 请求 credentials。 */
+    readonly credentials?: RequestCredentials;
+    /** 默认 call 预算。 */
+    readonly defaultCallTimeoutMs?: number;
+    /** 可信 transport 配额；只能使用默认值或收紧。 */
+    readonly limits?: RuntimeLimitsInput;
+    /** 可选的页面反向能力。 */
+    readonly client?: SharedWorkerClientExposure;
+}
+/** 同步创建 RuntimeHandle；ready 由 state/capability Promise 观察。 */
+declare function connectSharedWorker(options: ConnectSharedWorkerOptions): RuntimeHandle;
+/** testing 入口才允许注入可控 Worker 工厂。 */
+declare function connectSharedWorkerForTesting(options: ConnectSharedWorkerOptions, workerFactory: SharedWorkerFactory): RuntimeHandle;
+/** advanced 装配层取得连接 bridge；普通 RuntimeHandle 不暴露该实现细节。 */
+declare function bridgeForRuntimeHandle(handle: RuntimeHandle): CapabilityBridge;
+
+interface SharedWorkerScopeLike {
+    /** SharedWorker 连接事件。 */
+    onconnect: ((event: {
+        ports: MessagePort[];
+    }) => void) | null;
+}
+interface PeerExposureOptions {
+    /** 领域授权标识。 */
+    readonly grantId?: string;
+    /** 授权修订。 */
+    readonly authorizationRevision?: number;
+    /** 无环公开属性。 */
+    readonly attributes?: Readonly<Record<string, unknown>>;
+    /** 领域授权检查。 */
+    readonly authorize?: (context: HandlerCallContext, request: unknown) => boolean | Promise<boolean>;
+    /** 领域 Scope。 */
+    readonly scope?: LifecycleScope;
+}
+interface PeerController {
+    /** peer 标识。 */
+    readonly peerId: string;
+    /** 已观察到的页面 Runtime 实例；首个页面快照前为空。 */
+    readonly runtimeInstanceId?: string;
+    /** 对端 Window Runtime 类型。 */
+    readonly runtime: "window-main";
+    /** peer 子作用域。 */
+    readonly scope: LifecycleScope;
+    /** 传给普通 handler 的最小 PeerView。 */
+    readonly view: CapabilityPeer;
+    /** 获取页面暴露的 typed remote capability。 */
+    capability<C extends RemoteCapability>(capability: C): CapabilityClient<C>;
+    /** 暴露 Worker 已注册的 capability。 */
+    expose<C extends RemoteCapability>(capability: C, options?: PeerExposureOptions): {
+        revoke(): void;
+    };
+    /** 原子暴露一组 capability；任一项非法时不得部分开放。 */
+    exposeGroup(entries: readonly {
+        readonly capability: RemoteCapability;
+        readonly options?: PeerExposureOptions;
+    }[]): {
+        revoke(): void;
+    };
+    /** 断开此 peer，不影响其它页面。 */
+    disconnect(reason?: string): void;
+    /** peer 诊断。 */
+    inspect(): Readonly<Record<string, unknown>>;
+}
+interface StartSharedWorkerAppOptions extends Omit<CreatePluginHostOptions, "runtime" | "runtimeUnitImplementationRegistry" | "runtimeId" | "runtimeInstanceId"> {
+    /** Worker Runtime 逻辑标识。 */
+    readonly id: string;
+    /** Worker realm 的插件定义。 */
+    readonly plugins: readonly RuntimePluginDefinition[];
+    /** 对每个新 peer 顶层暴露的能力。 */
+    readonly expose?: readonly RemoteCapability[];
+    /** 同步配置 peer 级策略。 */
+    readonly configurePeer?: (peer: PeerController) => void;
+    /** configurePeer 可管理的显式 capability allowlist；未设置时不开放动态能力。 */
+    readonly peerExposureAllowlist?: readonly RemoteCapability[];
+    /** 可信 transport 配额；只能使用默认值或收紧。 */
+    readonly limits?: RuntimeLimitsInput;
+}
+interface StartSharedWorkerAppForTestingOptions extends StartSharedWorkerAppOptions {
+    /** testing 入口注入的 SharedWorkerGlobalScope 替身。 */
+    readonly globalScope: SharedWorkerScopeLike;
+}
+interface SharedWorkerApp {
+    readonly runtimeKind: "shared-worker";
+    readonly runtimeId: string;
+    readonly runtimeInstanceId: string;
+    ready(): Promise<void>;
+    reconcile(): Promise<void>;
+    state(): RuntimeStatusSnapshot;
+    subscribe(listener: RuntimeStatusListener): () => void;
+    inspect(): HostInspection;
+    dispose(reason?: string): Promise<LifecycleDisposeResult>;
+}
+/** 生产入口：只从真实 SharedWorkerGlobalScope 获取连接事件。 */
+declare function startSharedWorkerApp(options: StartSharedWorkerAppOptions): SharedWorkerApp;
+/** testing/advanced harness 入口；生产包的 startSharedWorkerApp 不接受 scope 注入。 */
+declare function startSharedWorkerAppForTesting(options: StartSharedWorkerAppForTestingOptions): SharedWorkerApp;
+
+export { type CreateResourceScopeOptions as C, type PeerController as P, type ReceivePortLedger as R, type SharedWorkerApp as S, type RuntimeLimitsInput as a, type RuntimeBudget as b, type RuntimePluginDefinition as c, type PeerExposureOptions as d, type ResourceScopeOptions as e, type StartSharedWorkerAppForTestingOptions as f, type StartSharedWorkerAppOptions as g, bridgeForRuntimeHandle as h, createLifecycleScope as i, createResourceScope as j, type ConnectSharedWorkerOptions as k, type SharedWorkerLike as l, connectSharedWorker as m, type SharedWorkerFactory as n, type SharedWorkerScopeLike as o, connectSharedWorkerForTesting as p, startSharedWorkerAppForTesting as q, startSharedWorkerApp as s };

package/dist/testing.d.ts

@@ -1,23 +1,24 @@
-import { ao as RemoteServiceCallContext, C as CreatePluginHostOptions, m as PluginHost, ax as RemoteServiceTransport } from './createPluginHost-BVsUCDKN.js';
-export { t as CapabilityRegistry, u as ContextExtensionInput, v as ContributionAdapter, w as ContributionAdapterInput, x as ContributionHandle, a0 as PermissionPolicyInput, a1 as PermissionPolicyResult, a3 as PluginConfigStore, aG as RuntimeUnitAttributesInput, aH as RuntimeUnitAvailabilityInput, aM as RuntimeUnitParentScopeInput, aN as RuntimeUnitSnapshot, aR as StartupCapabilityError, aT as StartupPluginError, b1 as createCapabilityRegistry, b2 as createInMemoryPluginConfigStore, b3 as createPluginHost, b5 as createResourceStore } from './createPluginHost-BVsUCDKN.js';
-export { c as CreateMessagePortServiceTransportOptions, d as CreatePluginIntentControllerOptions, e as CreateResourceScopeOptions, f as CreateServiceBridgeOptions, M as MessagePortServiceCallInput, j as RemoteServicePortCallMessage, k as RemoteServicePortCancelMessage, l as RemoteServicePortErrorMessage, m as RemoteServicePortResponseMessage, n as RemoteServicePortResultMessage, o as ResourceScopeOptions, w as RuntimeUnitImplementation, P as SharedWorkerFactory, Q as connectSharedWorkerForTesting, z as createLifecycleScope, A as createMessageBus, B as createMessagePortServiceTransport, D as createPluginIntentController, E as createResourceRegistry, F as createResourceScope, H as createRuntimeUnitImplementationRegistry, I as createServiceBridge } from './resourceRegistry-BFnjmeGE.js';
+import { s as CreatePluginHostOptions, x as PluginHost } from './runtimeTypes-DquUCHz-.js';
+export { m as CapabilityRegistration, n as CapabilityRegistry, o as ContextExtensionInput, p as ContributionAdapter, q as ContributionAdapterInput, r as ContributionHandle, H as HostCapabilityRegistration, t as HostInspection, u as PermissionPolicyInput, v as PermissionPolicyResult, w as PluginConfigStore, y as RuntimeUnitAttributesInput, z as RuntimeUnitAvailabilityInput, A as RuntimeUnitParentScopeInput, B as RuntimeUnitSnapshot, D as StartupCapabilityError, E as StartupPluginError, F as createCapabilityRegistry, G as createInMemoryPluginConfigStore, I as createPluginHost, bP as createResourceStore, J as invokeCapabilityHandler } from './runtimeTypes-DquUCHz-.js';
+import { z as RuntimeWireMessage, a as RuntimeTransport } from './messagePortServiceTransport-B0FyJr43.js';
+export { C as CreateCapabilityBridgeOptions, b as CreatePluginIntentControllerOptions, M as MessagePortLike, r as RuntimeReceiveMetadata, y as RuntimeUnitImplementation, A as createCapabilityBridge, B as createMessagePortRuntimeTransport, D as createPluginIntentController, E as createResourceRegistry, G as createRuntimeUnitImplementationRegistry, J as validateTransferables } from './messagePortServiceTransport-B0FyJr43.js';
+export { C as CreateResourceScopeOptions, e as ResourceScopeOptions, n as SharedWorkerFactory, o as SharedWorkerScopeLike, f as StartSharedWorkerAppForTestingOptions, p as connectSharedWorkerForTesting, i as createLifecycleScope, j as createResourceScope, q as startSharedWorkerAppForTesting } from './sharedWorkerHost-Cb2a1_KD.js';
+export { c as createMessageBus } from './messageBus-CtrwkjrO.js';
 
-interface FakeTransportCall {
-    /** 调用请求体。 */
-    request: unknown;
-    /** Host 已绑定的调用上下文。 */
-    context: RemoteServiceCallContext;
+/** 可观察的 transport 发送记录。 */
+interface FakeTransportMessage {
+    /** 已验证的 v4 message。 */
+    readonly message: RuntimeWireMessage;
+    /** transfer 资源。 */
+    readonly transfer: readonly Transferable[];
 }
-interface CreateFakeTransportOptions {
-    /** 假服务返回值；缺省返回 undefined。 */
-    handle?: (request: unknown, context: RemoteServiceCallContext) => unknown | Promise<unknown>;
-}
-/** 创建可观察的假服务传输；每次 call 都记录 request 和 context。 */
-declare function createFakeRemoteServiceTransport(options?: CreateFakeTransportOptions): RemoteServiceTransport & {
-    readonly calls: readonly FakeTransportCall[];
+/** 创建内存双向 transport；两侧可通过 emit 注入真实 wire message。 */
+declare function createFakeRuntimeTransport(): RuntimeTransport & {
+    readonly sent: readonly FakeTransportMessage[];
+    emit(message: RuntimeWireMessage, ports?: readonly MessagePort[]): void;
     reset(): void;
 };
-/** 创建测试 Host；默认关闭任何领域装配，只保留通用核心。 */
+/** 创建测试 Host；生产 Host 的 parser/lifecycle 路径保持不变。 */
 declare function createFakePluginHost(options?: CreatePluginHostOptions): PluginHost;
 
-export { type CreateFakeTransportOptions, CreatePluginHostOptions, type FakeTransportCall, PluginHost, createFakePluginHost, createFakeRemoteServiceTransport };
+export { CreatePluginHostOptions, type FakeTransportMessage, PluginHost, RuntimeTransport, createFakePluginHost, createFakeRuntimeTransport };

package/dist/testing.js

@@ -1,27 +1,35 @@
-import { createPluginHost } from './chunk-76BGPI6M.js';
-export { StartupCapabilityError, StartupPluginError, connectSharedWorkerForTesting, createCapabilityRegistry, createInMemoryPluginConfigStore, createLifecycleScope, createMessageBus, createMessagePortServiceTransport, createPluginHost, createPluginIntentController, createResourceRegistry, createResourceScope, createResourceStore, createRuntimeUnitImplementationRegistry, createServiceBridge } from './chunk-76BGPI6M.js';
+export { startSharedWorkerAppForTesting } from './chunk-YOIH6H36.js';
+export { createPluginIntentController } from './chunk-4DSINPZD.js';
+export { connectSharedWorkerForTesting, createCapabilityBridge, createMessagePortRuntimeTransport, validateTransferables } from './chunk-RAQOFUZY.js';
+import { createPluginHost } from './chunk-JHJZIO2H.js';
+export { StartupCapabilityError, StartupPluginError, createCapabilityRegistry, createInMemoryPluginConfigStore, createLifecycleScope, createMessageBus, createPluginHost, createResourceRegistry, createResourceScope, createResourceStore, createRuntimeUnitImplementationRegistry, invokeCapabilityHandler } from './chunk-JHJZIO2H.js';
 
 // src/testing/fakes.ts
-function createFakeRemoteServiceTransport(options = {}) {
-  const calls = [];
+function createFakeRuntimeTransport() {
+  const sent = [];
+  const listeners = /* @__PURE__ */ new Set();
   return {
-    calls,
-    reset() {
-      calls.length = 0;
+    sent,
+    send(message, transfer = []) {
+      sent.push({ message, transfer: [...transfer] });
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
     },
-    async call(request, context) {
-      calls.push({ request, context });
-      return await options.handle?.(request, context);
+    emit(message, ports = []) {
+      const metadata = { ports: Object.freeze([...ports]) };
+      for (const listener of [...listeners]) listener(message, metadata);
+    },
+    reset() {
+      sent.length = 0;
     }
   };
 }
 function createFakePluginHost(options = {}) {
-  return createPluginHost({
-    ...options,
-    initialPluginConfig: options.initialPluginConfig ?? {}
-  });
+  return createPluginHost({ ...options, initialPluginConfig: options.initialPluginConfig ?? {} });
 }
 
-export { createFakePluginHost, createFakeRemoteServiceTransport };
+export { createFakePluginHost, createFakeRuntimeTransport };
 //# sourceMappingURL=testing.js.map
 //# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/testing/fakes.ts"],"names":[],"mappings":";;;;AAyBO,SAAS,gCAAA,CACd,OAAA,GAAsC,EAAC,EACmD;AAC1F,EAAA,MAAM,QAA6B,EAAC;AACpC,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA,KAAA,GAAQ;AAAE,MAAA,KAAA,CAAM,MAAA,GAAS,CAAA;AAAA,IAAG,CAAA;AAAA,IAC5B,MAAM,IAAA,CAAwB,OAAA,EAAmB,OAAA,EAAqD;AACpG,MAAA,KAAA,CAAM,IAAA,CAAK,EAAE,OAAA,EAAS,OAAA,EAAS,CAAA;AAC/B,MAAA,OAAO,MAAM,OAAA,CAAQ,MAAA,GAAS,OAAA,EAAS,OAAO,CAAA;AAAA,IAChD;AAAA,GACF;AACF;AAGO,SAAS,oBAAA,CAAqB,OAAA,GAAmC,EAAC,EAAe;AACtF,EAAA,OAAO,gBAAA,CAAiB;AAAA,IACtB,GAAG,OAAA;AAAA,IACH,mBAAA,EAAqB,OAAA,CAAQ,mBAAA,IAAuB;AAAC,GACtD,CAAA;AACH","file":"testing.js","sourcesContent":["// WebLoom 测试辅助：只提供通用假实现，不携带产品语义。\n\nimport type {\n  RemoteServiceCallContext,\n  RemoteServiceTransport,\n} from \"../contracts/lifecycle.js\";\nimport {\n  createPluginHost,\n  type CreatePluginHostOptions,\n  type PluginHost,\n} from \"../host/createPluginHost.js\";\n\nexport interface FakeTransportCall {\n  /** 调用请求体。 */\n  request: unknown;\n  /** Host 已绑定的调用上下文。 */\n  context: RemoteServiceCallContext;\n}\n\nexport interface CreateFakeTransportOptions {\n  /** 假服务返回值；缺省返回 undefined。 */\n  handle?: (request: unknown, context: RemoteServiceCallContext) => unknown | Promise<unknown>;\n}\n\n/** 创建可观察的假服务传输；每次 call 都记录 request 和 context。 */\nexport function createFakeRemoteServiceTransport(\n  options: CreateFakeTransportOptions = {},\n): RemoteServiceTransport & { readonly calls: readonly FakeTransportCall[]; reset(): void } {\n  const calls: FakeTransportCall[] = [];\n  return {\n    calls,\n    reset() { calls.length = 0; },\n    async call<TRequest, TResult>(request: TRequest, context: RemoteServiceCallContext): Promise<TResult> {\n      calls.push({ request, context });\n      return await options.handle?.(request, context) as TResult;\n    },\n  };\n}\n\n/** 创建测试 Host；默认关闭任何领域装配，只保留通用核心。 */\nexport function createFakePluginHost(options: CreatePluginHostOptions = {}): PluginHost {\n  return createPluginHost({\n    ...options,\n    initialPluginConfig: options.initialPluginConfig ?? {},\n  });\n}\n"]}
+{"version":3,"sources":["../src/testing/fakes.ts"],"names":[],"mappings":";;;;;;;AAeO,SAAS,0BAAA,GAId;AACA,EAAA,MAAM,OAA+B,EAAC;AACtC,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAA8E;AACpG,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,IAAA,CAAK,OAAA,EAAS,QAAA,GAAW,EAAC,EAAG;AAAE,MAAA,IAAA,CAAK,IAAA,CAAK,EAAE,OAAA,EAAS,QAAA,EAAU,CAAC,GAAG,QAAQ,GAAG,CAAA;AAAA,IAAG,CAAA;AAAA,IAChF,UAAU,QAAA,EAAU;AAAE,MAAA,SAAA,CAAU,IAAI,QAAQ,CAAA;AAAG,MAAA,OAAO,MAAM,SAAA,CAAU,MAAA,CAAO,QAAQ,CAAA;AAAA,IAAG,CAAA;AAAA,IACxF,IAAA,CAAK,OAAA,EAAS,KAAA,GAAQ,EAAC,EAAG;AAAE,MAAA,MAAM,QAAA,GAAmC,EAAE,KAAA,EAAO,MAAA,CAAO,OAAO,CAAC,GAAG,KAAK,CAAC,CAAA,EAAE;AAAG,MAAA,KAAA,MAAW,YAAY,CAAC,GAAG,SAAS,CAAA,EAAG,QAAA,CAAS,SAAS,QAAQ,CAAA;AAAA,IAAG,CAAA;AAAA,IAC/K,KAAA,GAAQ;AAAE,MAAA,IAAA,CAAK,MAAA,GAAS,CAAA;AAAA,IAAG;AAAA,GAC7B;AACF;AAGO,SAAS,oBAAA,CAAqB,OAAA,GAAmC,EAAC,EAAe;AACtF,EAAA,OAAO,gBAAA,CAAiB,EAAE,GAAG,OAAA,EAAS,qBAAqB,OAAA,CAAQ,mBAAA,IAAuB,EAAC,EAAG,CAAA;AAChG","file":"testing.js","sourcesContent":["// WebLoom 测试辅助：不注入产品授权或绕过生产 parser。\n\nimport type { RuntimeReceiveMetadata, RuntimeTransport } from \"../transport/serviceBridge.js\";\nimport type { RuntimeWireMessage } from \"../runtime/runtimeProtocol.js\";\nimport { createPluginHost, type CreatePluginHostOptions, type PluginHost } from \"../host/createPluginHost.js\";\n\n/** 可观察的 transport 发送记录。 */\nexport interface FakeTransportMessage {\n  /** 已验证的 v4 message。 */\n  readonly message: RuntimeWireMessage;\n  /** transfer 资源。 */\n  readonly transfer: readonly Transferable[];\n}\n\n/** 创建内存双向 transport；两侧可通过 emit 注入真实 wire message。 */\nexport function createFakeRuntimeTransport(): RuntimeTransport & {\n  readonly sent: readonly FakeTransportMessage[];\n  emit(message: RuntimeWireMessage, ports?: readonly MessagePort[]): void;\n  reset(): void;\n} {\n  const sent: FakeTransportMessage[] = [];\n  const listeners = new Set<(message: RuntimeWireMessage, metadata?: RuntimeReceiveMetadata) => void>();\n  return {\n    sent,\n    send(message, transfer = []) { sent.push({ message, transfer: [...transfer] }); },\n    subscribe(listener) { listeners.add(listener); return () => listeners.delete(listener); },\n    emit(message, ports = []) { const metadata: RuntimeReceiveMetadata = { ports: Object.freeze([...ports]) }; for (const listener of [...listeners]) listener(message, metadata); },\n    reset() { sent.length = 0; },\n  };\n}\n\n/** 创建测试 Host；生产 Host 的 parser/lifecycle 路径保持不变。 */\nexport function createFakePluginHost(options: CreatePluginHostOptions = {}): PluginHost {\n  return createPluginHost({ ...options, initialPluginConfig: options.initialPluginConfig ?? {} });\n}\n"]}

package/dist/windowRuntime-B6Ue8jso.d.ts

@@ -0,0 +1,23 @@
+import { s as CreatePluginHostOptions, x as PluginHost, W as WindowApp } from './runtimeTypes-DquUCHz-.js';
+import { c as RuntimePluginDefinition } from './sharedWorkerHost-Cb2a1_KD.js';
+
+interface CreateWindowAppOptions extends Omit<CreatePluginHostOptions, "runtime" | "runtimeUnitImplementationRegistry" | "runtimeInstanceId" | "runtimeId" | "capabilityBridge"> {
+    /** Window Runtime 逻辑标识。 */
+    readonly id?: string;
+    /** 当前 Window realm 的插件定义。 */
+    readonly plugins: readonly RuntimePluginDefinition[];
+}
+interface CreateWindowAppFromHostOptions extends Omit<CreatePluginHostOptions, "runtime" | "runtimeUnitImplementationRegistry" | "capabilityBridge"> {
+    /** Window Runtime 逻辑标识。 */
+    readonly id?: string;
+    /** 已创建且所有权转移给 App 的 v4 Host。 */
+    readonly host: PluginHost;
+}
+/** 创建当前 Window 的 v4 Runtime；本地插件启动完成后 resolve。 */
+declare function createWindowApp(options: CreateWindowAppOptions): Promise<WindowApp>;
+/** advanced：接管一个现有 v4 Host，不复制 Host。 */
+declare function createWindowAppFromHost(options: CreateWindowAppFromHostOptions): Promise<WindowApp>;
+/** advanced 装配层查询 App 所拥有的 Host。 */
+declare function hostForWindowApp(app: WindowApp): PluginHost;
+
+export { type CreateWindowAppOptions as C, createWindowApp as a, createWindowAppFromHost as c, hostForWindowApp as h };