@dxos/app-framework 0.8.4-main.8360d9e660 → 0.8.4-main.8baae0fced

package/dist/lib/browser/process-manager-capability-JIWLN7SU.mjs

@@ -0,0 +1,89 @@
+import "./chunk-KFDF7KR3.mjs";
+import {
+  capabilities_exports
+} from "./chunk-5AHASNDW.mjs";
+import {
+  activation_events_exports
+} from "./chunk-5GY3YOEL.mjs";
+import "./chunk-FO3IYSLV.mjs";
+import "./chunk-KLHQNYJ2.mjs";
+import "./chunk-VJ5PFAWC.mjs";
+import "./chunk-66IXTIVK.mjs";
+import {
+  plugin_exports
+} from "./chunk-SLX73WRZ.mjs";
+import {
+  capability_exports
+} from "./chunk-IW44C7UL.mjs";
+import "./chunk-J5LGTIGS.mjs";
+
+// src/plugin-process-manager/process-manager-capability.ts
+import { Registry } from "@effect-atom/atom";
+import * as KeyValueStore from "@effect/platform/KeyValueStore";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as ManagedRuntime from "effect/ManagedRuntime";
+import { LayerSpec, OperationHandlerSet, Process, ServiceResolver, Trace } from "@dxos/compute";
+import { LayerStack, ProcessManager } from "@dxos/compute-runtime";
+import { invariant } from "@dxos/invariant";
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/plugin-process-manager/process-manager-capability.ts";
+var process_manager_capability_default = capability_exports.makeModule(Effect.fnUntraced(function* () {
+  const capabilityManager = yield* capability_exports.Service;
+  const pluginManager = yield* plugin_exports.Service;
+  const atomRegistry = yield* capability_exports.get(capabilities_exports.AtomRegistry);
+  yield* plugin_exports.activate(activation_events_exports.SetupProcessManager);
+  const layerSpecs = yield* capability_exports.getAll(capabilities_exports.LayerSpec);
+  const traceSinkFactories = yield* capability_exports.getAll(capabilities_exports.TraceSink);
+  let processManagerHolder;
+  const ambientLayerSpec = LayerSpec.make({
+    affinity: "application",
+    requires: [],
+    provides: [
+      capability_exports.Service,
+      plugin_exports.Service,
+      Registry.AtomRegistry,
+      ProcessManager.ProcessManagerService
+    ]
+  }, () => Layer.mergeAll(Layer.succeed(capability_exports.Service, capabilityManager), Layer.succeed(plugin_exports.Service, pluginManager), Layer.succeed(Registry.AtomRegistry, atomRegistry), Layer.effect(ProcessManager.ProcessManagerService, Effect.sync(() => {
+    invariant(processManagerHolder, "ProcessManagerService accessed before the process-manager runtime was initialised", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 65, S: this, A: ["processManagerHolder", "'ProcessManagerService accessed before the process-manager runtime was initialised'"] });
+    return processManagerHolder;
+  }))));
+  const layerStack = new LayerStack.LayerStack({
+    layers: [
+      ambientLayerSpec,
+      ...layerSpecs
+    ]
+  });
+  const serviceResolver = layerStack.getServiceResolver();
+  const handlerSet = OperationHandlerSet.reactive(atomRegistry, capabilityManager.atom(capabilities_exports.OperationHandler));
+  const traceSinks = traceSinkFactories.map((factory) => factory({
+    resolver: serviceResolver
+  }));
+  const mergedTraceSink = Trace.mergeSinks(traceSinks);
+  const baseLayer = Layer.mergeAll(Layer.succeed(capability_exports.Service, capabilityManager), Layer.succeed(plugin_exports.Service, pluginManager), Layer.succeed(Registry.AtomRegistry, atomRegistry), Layer.succeed(ServiceResolver.ServiceResolver, serviceResolver), OperationHandlerSet.provide(handlerSet), KeyValueStore.layerMemory, Layer.succeed(Trace.TraceSink, mergedTraceSink));
+  const processManagerLayer = ProcessManager.layer({
+    runtimeName: Trace.CommonRuntimeName.local
+  }).pipe(Layer.provide(baseLayer));
+  const operationInvokerLayer = ProcessManager.ProcessOperationInvoker.layer.pipe(Layer.provide(Layer.mergeAll(processManagerLayer, baseLayer)));
+  const runtimeLayer = Layer.mergeAll(baseLayer, processManagerLayer, operationInvokerLayer);
+  const managedRuntime = ManagedRuntime.make(runtimeLayer);
+  const processManagerRuntime = {
+    runPromise: (effect2, options) => managedRuntime.runPromise(effect2, options),
+    runPromiseExit: (effect2, options) => managedRuntime.runPromiseExit(effect2, options),
+    runFork: (effect2, options) => managedRuntime.runFork(effect2, options),
+    runSync: (effect2) => managedRuntime.runSync(effect2)
+  };
+  const processMonitor = managedRuntime.runSync(Effect.flatMap(Process.ProcessMonitorService, Effect.succeed));
+  processManagerHolder = managedRuntime.runSync(Effect.flatMap(ProcessManager.ProcessManagerService, Effect.succeed));
+  const operationInvoker = managedRuntime.runSync(Effect.flatMap(ProcessManager.ProcessOperationInvoker.Service, Effect.succeed));
+  return [
+    capability_exports.contributes(capabilities_exports.ProcessManagerRuntime, processManagerRuntime),
+    capability_exports.contributes(capabilities_exports.ServiceResolver, serviceResolver),
+    capability_exports.contributes(capabilities_exports.ProcessMonitor, processMonitor),
+    capability_exports.contributes(capabilities_exports.OperationInvoker, operationInvoker)
+  ];
+}));
+export {
+  process_manager_capability_default as default
+};
+//# sourceMappingURL=process-manager-capability-JIWLN7SU.mjs.map

package/dist/lib/browser/process-manager-capability-JIWLN7SU.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugin-process-manager/process-manager-capability.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Registry } from '@effect-atom/atom';\nimport * as KeyValueStore from '@effect/platform/KeyValueStore';\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\nimport * as ManagedRuntime from 'effect/ManagedRuntime';\n\nimport { LayerSpec, OperationHandlerSet, Process, ServiceResolver, Trace } from '@dxos/compute';\nimport { LayerStack, ProcessManager } from '@dxos/compute-runtime';\nimport { invariant } from '@dxos/invariant';\n// Explicit import so the emitted `.d.ts` references the package via its public\n// alias instead of a relative `node_modules` path (TS2883).\nimport { OperationInvoker } from '@dxos/operation';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { Capability, Plugin } from '../core';\n\n//\n// Capability Module\n//\n// Hosts the {@link ProcessManager} runtime for the plugin system.\n//\n// Workflow:\n// 1. Activates {@link ActivationEvents.SetupProcessManager} so plugins can\n//    contribute {@link Capabilities.LayerSpec} entries and\n//    {@link Capabilities.OperationHandler} sets.\n// 2. Collects all contributed {@link LayerSpec.LayerSpec}s and builds a\n//    {@link LayerStack} whose {@link ServiceResolver} drives process-scoped\n//    service resolution.\n// 3. Wires a reactive {@link OperationHandlerSet} that tracks\n//    {@link Capabilities.OperationHandler} contributions and invalidates its\n//    cached merge when new handlers register.\n// 4. Composes the fixed runtime requirements (capability/plugin managers,\n//    service resolver, operation invoker, process manager) into a single\n//    {@link Layer} and builds a {@link ManagedRuntime} from it.\n// 5. Exposes a disposable-less wrapper as {@link Capabilities.ProcessManagerRuntime}\n//    (the plugin system manages its lifecycle).\n//\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const capabilityManager = yield* Capability.Service;\n    const pluginManager = yield* Plugin.Service;\n    const atomRegistry = yield* Capability.get(Capabilities.AtomRegistry);\n\n    yield* Plugin.activate(ActivationEvents.SetupProcessManager);\n\n    const layerSpecs = yield* Capability.getAll(Capabilities.LayerSpec);\n    const traceSinkFactories = yield* Capability.getAll(Capabilities.TraceSink);\n\n    // Forward reference to `ProcessManager.ProcessManagerService`. The runtime\n    // that owns the manager depends transitively on `ServiceResolver` (which is\n    // built from the `LayerStack` below), so we cannot materialise it before\n    // the stack exists. Instead we publish the manager into this holder as\n    // soon as the runtime is built, and the ambient layer reads it lazily via\n    // `Layer.effect` — slice init only runs once a process actually triggers\n    // service resolution, by which point the holder is populated.\n    let processManagerHolder: ProcessManager.Manager | undefined;\n\n    // Expose the foundational app-framework services through the LayerStack so\n    // that operations declaring `services: [Capability.Service]` (and friends)\n    // can resolve them via the ServiceResolver. Without this, only consumers\n    // sitting on the same ManagedRuntime layer graph can see them — process\n    // executions go through ServiceResolver.resolveAll and would fail.\n    const ambientLayerSpec = LayerSpec.make(\n      {\n        affinity: 'application',\n        requires: [],\n        provides: [Capability.Service, Plugin.Service, Registry.AtomRegistry, ProcessManager.ProcessManagerService],\n      },\n      () =>\n        Layer.mergeAll(\n          Layer.succeed(Capability.Service, capabilityManager),\n          Layer.succeed(Plugin.Service, pluginManager),\n          Layer.succeed(Registry.AtomRegistry, atomRegistry),\n          Layer.effect(\n            ProcessManager.ProcessManagerService,\n            Effect.sync(() => {\n              invariant(\n                processManagerHolder,\n                'ProcessManagerService accessed before the process-manager runtime was initialised',\n              );\n              return processManagerHolder;\n            }),\n          ),\n        ),\n    );\n\n    const layerStack = new LayerStack.LayerStack({ layers: [ambientLayerSpec, ...layerSpecs] });\n    const serviceResolver = layerStack.getServiceResolver();\n\n    const handlerSet = OperationHandlerSet.reactive(\n      atomRegistry,\n      capabilityManager.atom(Capabilities.OperationHandler),\n    );\n\n    const traceSinks = traceSinkFactories.map((factory) => factory({ resolver: serviceResolver }));\n    const mergedTraceSink = Trace.mergeSinks(traceSinks);\n\n    // Base services required by ProcessManager and the operation invoker.\n    // Sensible defaults are provided here; plugins that want alternative\n    // implementations (e.g. persistent KV store, real tracing) can contribute\n    // their own LayerSpec entries against the ServiceResolver.\n    const baseLayer = Layer.mergeAll(\n      Layer.succeed(Capability.Service, capabilityManager),\n      Layer.succeed(Plugin.Service, pluginManager),\n      Layer.succeed(Registry.AtomRegistry, atomRegistry),\n      Layer.succeed(ServiceResolver.ServiceResolver, serviceResolver),\n      OperationHandlerSet.provide(handlerSet),\n      KeyValueStore.layerMemory,\n      Layer.succeed(Trace.TraceSink, mergedTraceSink),\n    );\n\n    const processManagerLayer = ProcessManager.layer({ runtimeName: Trace.CommonRuntimeName.local }).pipe(\n      Layer.provide(baseLayer),\n    );\n    const operationInvokerLayer = ProcessManager.ProcessOperationInvoker.layer.pipe(\n      Layer.provide(Layer.mergeAll(processManagerLayer, baseLayer)),\n    );\n\n    const runtimeLayer = Layer.mergeAll(baseLayer, processManagerLayer, operationInvokerLayer);\n\n    const managedRuntime = ManagedRuntime.make(runtimeLayer as Layer.Layer<any, any, never>);\n\n    // TODO(dmaretskyi): Capability modules don't currently expose a teardown\n    // hook (`makeModule` only allows `Service | Plugin.Service` in the effect's\n    // requirements, ruling out `Effect.addFinalizer`). Once the plugin\n    // framework grows a shutdown lifecycle, dispose `managedRuntime` and then\n    // call `layerStack.destroy()` to tear down keep-alive slices.\n\n    const processManagerRuntime: Capabilities.ProcessManagerRuntime = {\n      runPromise: (effect, options) => managedRuntime.runPromise(effect as Effect.Effect<any, any, any>, options),\n      runPromiseExit: (effect, options) =>\n        managedRuntime.runPromiseExit(effect as Effect.Effect<any, any, any>, options),\n      runFork: (effect, options) => managedRuntime.runFork(effect as Effect.Effect<any, any, any>, options),\n      runSync: (effect) => managedRuntime.runSync(effect as Effect.Effect<any, any, any>),\n    };\n\n    // Eagerly extract the process monitor. Safe because it does not require a\n    // fresh scope and is a stable reference for the lifetime of the runtime.\n    const processMonitor = managedRuntime.runSync(\n      Effect.flatMap(Process.ProcessMonitorService, Effect.succeed) as Effect.Effect<Process.Monitor, never, never>,\n    );\n\n    // Publish the manager into the ambient-layer holder so that\n    // `ProcessManager.ProcessManagerService` becomes resolvable through the\n    // LayerStack alongside the other framework-supplied services.\n    processManagerHolder = managedRuntime.runSync(\n      Effect.flatMap(ProcessManager.ProcessManagerService, Effect.succeed) as Effect.Effect<\n        ProcessManager.Manager,\n        never,\n        never\n      >,\n    );\n\n    // Eagerly extract the operation invoker built by ProcessOperationInvoker.layer.\n    // Pulled via the ProcessOperationInvoker tag so the contributed value carries\n    // the full OperationInvoker interface (`invocations`, `pendingFollowups`,\n    // `awaitFollowups`, `_invokeCore`) that HistoryTracker requires.\n    const operationInvoker: OperationInvoker.OperationInvoker = managedRuntime.runSync(\n      Effect.flatMap(ProcessManager.ProcessOperationInvoker.Service, Effect.succeed) as unknown as Effect.Effect<\n        OperationInvoker.OperationInvoker,\n        never,\n        never\n      >,\n    );\n\n    return [\n      Capability.contributes(Capabilities.ProcessManagerRuntime, processManagerRuntime),\n      Capability.contributes(Capabilities.ServiceResolver, serviceResolver),\n      Capability.contributes(Capabilities.ProcessMonitor, processMonitor),\n      Capability.contributes(Capabilities.OperationInvoker, operationInvoker),\n    ];\n  }),\n);\n"],
+  "mappings": "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",
+  "names": ["Registry", "KeyValueStore", "Effect", "Layer", "ManagedRuntime", "LayerSpec", "OperationHandlerSet", "Process", "ServiceResolver", "Trace", "LayerStack", "ProcessManager", "invariant", "pluginManager", "Service", "atomRegistry", "Capability", "Capabilities", "ActivationEvents", "layerSpecs", "getAll", "traceSinkFactories", "requires", "provides", "Plugin", "Registry", "AtomRegistry", "ProcessManager", "Layer", "processManagerHolder", "layerStack", "layers", "ambientLayerSpec", "traceSinks", "factory", "serviceResolver", "mergedTraceSink", "runtimeName", "CommonRuntimeName", "pipe", "baseLayer", "operationInvokerLayer", "runtimeLayer", "mergeAll", "managedRuntime", "ManagedRuntime", "runPromiseExit", "options", "runFork", "effect", "runSync", "contributes", "ProcessManagerRuntime", "processManagerRuntime", "ProcessMonitor", "processMonitor", "OperationInvoker", "operationInvoker"]
+}

package/dist/lib/browser/testing/index.mjs

@@ -1,50 +1,178 @@
 import {
   useApp
-} from "../chunk-7AL6SKIV.mjs";
-import "../chunk-TGX63LTL.mjs";
-import "../chunk-TIEBZMTF.mjs";
+} from "../chunk-UVTGHZQF.mjs";
+import "../chunk-QLML5QFJ.mjs";
+import "../chunk-FJ4765WW.mjs";
+import "../chunk-KFDF7KR3.mjs";
 import {
   capabilities_exports
-} from "../chunk-WEBSGU5L.mjs";
+} from "../chunk-5AHASNDW.mjs";
 import {
   activation_events_exports
-} from "../chunk-M5IC326L.mjs";
-import "../chunk-YAFEA4GV.mjs";
+} from "../chunk-5GY3YOEL.mjs";
+import "../chunk-FO3IYSLV.mjs";
+import "../chunk-KLHQNYJ2.mjs";
 import {
   plugin_manager_exports
-} from "../chunk-3VXJONTI.mjs";
-import "../chunk-272IPLHQ.mjs";
+} from "../chunk-VJ5PFAWC.mjs";
+import {
+  activation_event_exports
+} from "../chunk-66IXTIVK.mjs";
 import {
   plugin_exports
-} from "../chunk-GH3M2LIW.mjs";
+} from "../chunk-SLX73WRZ.mjs";
 import {
   capability_exports
-} from "../chunk-YNFPIQGB.mjs";
+} from "../chunk-IW44C7UL.mjs";
 import "../chunk-J5LGTIGS.mjs";
 
-// src/testing/service.ts
+// src/testing/harness.ts
+import * as Duration from "effect/Duration";
 import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
+import * as PubSub from "effect/PubSub";
+import * as Queue from "effect/Queue";
+import { runAndForwardErrors } from "@dxos/effect";
 import { invariant } from "@dxos/invariant";
-var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/testing/service.ts";
-var fromPlugins = (plugins) => Layer.effect(plugin_exports.Service, Effect.gen(function* () {
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/testing/harness.ts";
+var DEFAULT_TIMEOUT_MS = 5e3;
+var createTestApp = async (opts) => {
+  const { plugins, enabled = plugins.filter(({ meta }) => !meta.tags?.includes("system")).map((plugin) => plugin.meta.id), setupEvents = [], autoStart = true, registerFrameworkCapabilities = true } = opts;
   const pluginLoader = (id) => Effect.sync(() => {
     const plugin = plugins.find((plugin2) => plugin2.meta.id === id);
-    invariant(plugin, `Plugin not found: ${id}`, {
-      F: __dxlog_file,
-      L: 26,
-      S: this,
-      A: [
-        "plugin",
-        "`Plugin not found: ${id}`"
-      ]
+    invariant(plugin, `Plugin not found: ${id}`, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 26, S: void 0, A: ["plugin", "`Plugin not found: ${id}`"] });
+    return {
+      plugin
+    };
+  });
+  const manager = plugin_manager_exports.make({
+    pluginLoader,
+    plugins,
+    enabled
+  });
+  if (registerFrameworkCapabilities) {
+    manager.capabilities.contribute({
+      interface: capabilities_exports.PluginManager,
+      implementation: manager,
+      module: "org.dxos.app-framework.plugin-manager"
+    });
+    manager.capabilities.contribute({
+      interface: capabilities_exports.AtomRegistry,
+      implementation: manager.registry,
+      module: "org.dxos.app-framework.atom-registry"
+    });
+  }
+  if (autoStart) {
+    try {
+      await runAndForwardErrors(Effect.all([
+        ...setupEvents.map((event) => manager.activate(event)),
+        manager.activate(activation_events_exports.SetupReactSurface),
+        manager.activate(activation_events_exports.Startup)
+      ]));
+    } catch (err) {
+      await runAndForwardErrors(manager.shutdown()).catch(() => void 0);
+      throw err;
+    }
+  }
+  return new TestHarnessImpl(manager);
+};
+var TestHarnessImpl = class {
+  manager;
+  constructor(manager) {
+    this.manager = manager;
+  }
+  get capabilities() {
+    return this.manager.capabilities;
+  }
+  get registry() {
+    return this.manager.registry;
+  }
+  fire(event) {
+    return runAndForwardErrors(this.manager.activate(event));
+  }
+  reset(event) {
+    return runAndForwardErrors(this.manager.reset(event));
+  }
+  get(iface) {
+    return this.manager.capabilities.get(iface);
+  }
+  getAll(iface) {
+    return this.manager.capabilities.getAll(iface);
+  }
+  waitForCapability(iface, opts) {
+    const timeout = opts?.timeout ?? DEFAULT_TIMEOUT_MS;
+    return runAndForwardErrors(this.manager.capabilities.waitFor(iface).pipe(Effect.timeoutFail({
+      duration: Duration.millis(timeout),
+      onTimeout: () => timeoutError(iface.identifier)
+    })));
+  }
+  waitForEvent(event, opts) {
+    const key = typeof event === "string" ? event : activation_event_exports.eventKey(event);
+    const timeout = opts?.timeout ?? DEFAULT_TIMEOUT_MS;
+    const program = Effect.gen(this, function* () {
+      const queue = yield* PubSub.subscribe(this.manager.activation);
+      if (this.manager.getEventsFired().includes(key)) {
+        return;
+      }
+      while (true) {
+        const message = yield* Queue.take(queue);
+        if (message.event === key && message.state === "activated") {
+          return;
+        }
+      }
+    }).pipe(Effect.scoped, Effect.timeoutFail({
+      duration: Duration.millis(timeout),
+      onTimeout: () => timeoutError(key)
+    }));
+    return runAndForwardErrors(program);
+  }
+  async invoke(op, ...args) {
+    const invoker = await this.waitForCapability(capabilities_exports.OperationInvoker);
+    const result = await invoker.invokePromise(op, ...args);
+    if (result.error) {
+      throw result.error;
+    }
+    return result.data;
+  }
+  async runPromise(effect2, options) {
+    const runtime = await this.waitForCapability(capabilities_exports.ProcessManagerRuntime, {
+      timeout: options?.timeout
     });
-    return plugin;
+    return runtime.runPromise(effect2, options?.signal ? {
+      signal: options.signal
+    } : void 0);
+  }
+  enable(id) {
+    return runAndForwardErrors(this.manager.enable(id));
+  }
+  disable(id) {
+    return runAndForwardErrors(this.manager.disable(id));
+  }
+  async dispose() {
+    await runAndForwardErrors(this.manager.shutdown());
+  }
+  [Symbol.asyncDispose]() {
+    return this.dispose();
+  }
+};
+var timeoutError = (id) => new Error(`Timed out waiting for ${id}`);
+
+// src/testing/service.ts
+import * as Effect2 from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { invariant as invariant2 } from "@dxos/invariant";
+var __dxlog_file2 = "/__w/dxos/dxos/packages/sdk/app-framework/src/testing/service.ts";
+var fromPlugins = (plugins) => Layer.effect(plugin_exports.Service, Effect2.gen(function* () {
+  const pluginLoader = (id) => Effect2.sync(() => {
+    const plugin = plugins.find((plugin2) => plugin2.meta.id === id);
+    invariant2(plugin, `Plugin not found: ${id}`, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 16, S: this, A: ["plugin", "`Plugin not found: ${id}`"] });
+    return {
+      plugin
+    };
   });
   const manager = plugin_manager_exports.make({
     pluginLoader,
     plugins,
-    core: plugins.map((plugin) => plugin.meta.id)
+    enabled: plugins.map((plugin) => plugin.meta.id)
   });
   manager.capabilities.contribute({
     interface: capabilities_exports.PluginManager,
@@ -61,23 +189,21 @@ var fromPlugins = (plugins) => Layer.effect(plugin_exports.Service, Effect.gen(f
 }));
 
 // src/testing/withPluginManager.tsx
-import * as Effect2 from "effect/Effect";
+import * as Effect3 from "effect/Effect";
 import React, { useEffect, useState } from "react";
 import { raise } from "@dxos/debug";
-import { runAndForwardErrors } from "@dxos/effect";
+import { runAndForwardErrors as runAndForwardErrors2 } from "@dxos/effect";
 import { useAsyncEffect } from "@dxos/react-hooks";
 import { getProviderValue } from "@dxos/util";
-var setupPluginManager = ({ capabilities, plugins = [], core = plugins.map(({ meta }) => meta.id), ...options } = {}) => {
+var setupPluginManager = ({ capabilities, plugins = [], ...options } = {}) => {
+  const enabled = plugins.filter(({ meta }) => !meta.tags?.includes("system")).map(({ meta }) => meta.id);
   const pluginManager = plugin_manager_exports.make({
     pluginLoader: () => raise(new Error("Not implemented")),
     plugins: [
       StoryPlugin,
       ...plugins
     ],
-    core: [
-      StoryPlugin.meta.id,
-      ...core
-    ],
+    enabled,
     ...options
   });
   if (capabilities) {
@@ -114,7 +240,7 @@ var withPluginManager = (init = {}) => {
       });
       return () => {
         pluginManager.capabilities.remove(capability.interface, capability.implementation);
-        void runAndForwardErrors(pluginManager.shutdown());
+        void runAndForwardErrors2(pluginManager.shutdown());
       };
     }, [
       storyId,
@@ -142,14 +268,18 @@ var WithPluginManagerApp = ({ fireEvents, pluginManager, setupEvents, storyId })
 };
 var storyMeta = {
   id: "org.dxos.app-framework.story",
-  name: "Story"
+  name: "Story",
+  tags: [
+    "system"
+  ]
 };
 var StoryPlugin = plugin_exports.define(storyMeta).pipe(plugin_exports.addModule({
   id: "Story",
   activatesOn: activation_events_exports.Startup,
-  activate: () => Effect2.succeed([])
+  activate: () => Effect3.succeed([])
 }), plugin_exports.make)();
 export {
+  createTestApp,
   fromPlugins,
   setupPluginManager,
   withPluginManager

package/dist/lib/browser/testing/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../../src/testing/service.ts", "../../../../src/testing/withPluginManager.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { Plugin, PluginManager } from '../core';\n\n/**\n * Creates a Plugin.Service layer from a list of plugins.\n * This is primarily used for testing.\n */\nexport const fromPlugins = (plugins: Plugin.Plugin[]) =>\n  Layer.effect(\n    Plugin.Service,\n    Effect.gen(function* () {\n      // TODO(wittjosiah): Try to dedupe logic between here, createCliApp and useApp.\n\n      const pluginLoader = (id: string) =>\n        Effect.sync(() => {\n          const plugin = plugins.find((plugin) => plugin.meta.id === id);\n          invariant(plugin, `Plugin not found: ${id}`);\n          return plugin;\n        });\n\n      const manager = PluginManager.make({\n        pluginLoader,\n        plugins,\n        core: plugins.map((plugin) => plugin.meta.id),\n      });\n\n      manager.capabilities.contribute({\n        interface: Capabilities.PluginManager,\n        implementation: manager,\n        module: 'org.dxos.app-framework.plugin-manager',\n      });\n\n      manager.capabilities.contribute({\n        interface: Capabilities.AtomRegistry,\n        implementation: manager.registry,\n        module: 'org.dxos.app-framework.atom-registry',\n      });\n\n      yield* manager.activate(ActivationEvents.Startup);\n\n      return manager;\n    }),\n  );\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Decorator, type StoryContext } from '@storybook/react';\nimport * as Effect from 'effect/Effect';\nimport React, { useEffect, useState } from 'react';\n\nimport { raise } from '@dxos/debug';\nimport { runAndForwardErrors } from '@dxos/effect';\nimport { useAsyncEffect } from '@dxos/react-hooks';\nimport { type MaybeProvider, getProviderValue } from '@dxos/util';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { type ActivationEvent, Capability, type CapabilityManager, Plugin, PluginManager } from '../core';\nimport { type UseAppOptions, useApp } from '../ui';\n\n/**\n * @internal\n */\nexport const setupPluginManager = ({\n  capabilities,\n  plugins = [],\n  core = plugins.map(({ meta }) => meta.id),\n  ...options\n}: UseAppOptions & Pick<WithPluginManagerOptions, 'capabilities'> = {}) => {\n  const pluginManager = PluginManager.make({\n    pluginLoader: () => raise(new Error('Not implemented')),\n    plugins: [StoryPlugin, ...plugins],\n    core: [StoryPlugin.meta.id, ...core],\n    ...options,\n  });\n\n  if (capabilities) {\n    getProviderValue(capabilities, pluginManager.capabilities).forEach((capability) => {\n      pluginManager.capabilities.contribute({\n        interface: capability.interface,\n        implementation: capability.implementation,\n        module: 'story',\n      });\n    });\n  }\n\n  return pluginManager;\n};\n\ntype ManagedPluginManagerState = {\n  fireEvents?: (ActivationEvent.ActivationEvent | string)[];\n  pluginManager: PluginManager.PluginManager;\n  setupEvents?: ActivationEvent.ActivationEvent[];\n  storyId: string;\n};\n\nexport type WithPluginManagerOptions = UseAppOptions & {\n  /** @deprecated */\n  capabilities?: MaybeProvider<Capability.Any[], CapabilityManager.CapabilityManager>;\n  /** @deprecated */\n  fireEvents?: (ActivationEvent.ActivationEvent | string)[];\n};\n\nexport type WithPluginManagerInitializer<Args = void> =\n  | WithPluginManagerOptions\n  | ((context: StoryContext<Args>) => WithPluginManagerOptions);\n\n/**\n * Wraps a story with a plugin manager.\n * NOTE: This builds up and tears down the plugin manager on every render.\n */\nexport const withPluginManager = <Args,>(init: WithPluginManagerInitializer<Args> = {}): Decorator => {\n  return (Story, context) => {\n    const storyId = context.id;\n    const options = typeof init === 'function' ? init(context as any) : init;\n    const [managerState, setManagerState] = useState<ManagedPluginManagerState>();\n\n    // Storybook replaces the full context object often, so key manager ownership by story id.\n    useEffect(() => {\n      const pluginManager = setupPluginManager(options);\n\n      const capability = Capability.contributes(Capabilities.ReactRoot, {\n        id: storyId,\n        root: () => <Story />,\n      });\n\n      pluginManager.capabilities.contribute({\n        ...capability,\n        module: 'org.dxos.app-framework.with-plugin-manager',\n      });\n\n      setManagerState({\n        pluginManager,\n        setupEvents: options.setupEvents,\n        fireEvents: options.fireEvents,\n        storyId,\n      });\n\n      return () => {\n        pluginManager.capabilities.remove(capability.interface, capability.implementation);\n        void runAndForwardErrors(pluginManager.shutdown());\n      };\n    }, [storyId, init]);\n\n    // Avoid mounting useApp with a stale manager from the previous story.\n    if (!managerState || managerState.storyId !== storyId) {\n      return <></>;\n    }\n\n    return <WithPluginManagerApp {...managerState} />;\n  };\n};\n\nconst WithPluginManagerApp = ({ fireEvents, pluginManager, setupEvents, storyId }: ManagedPluginManagerState) => {\n  // Fire deprecated events only after the effect-owned manager for this story exists.\n  useAsyncEffect(async () => {\n    await Promise.all(fireEvents?.map((event) => pluginManager.activate(event)) ?? []);\n  }, [fireEvents, pluginManager, storyId]);\n\n  const App = useApp({ pluginManager, setupEvents });\n\n  return <App />;\n};\n\nconst storyMeta = {\n  id: 'org.dxos.app-framework.story',\n  name: 'Story',\n};\n\n// No-op plugin to ensure there exists at least one plugin for the startup event.\n// This is necessary because `createApp` expects the startup event to complete before the app is ready.\nconst StoryPlugin = Plugin.define(storyMeta).pipe(\n  Plugin.addModule({\n    id: 'Story',\n    activatesOn: ActivationEvents.Startup,\n    activate: () => Effect.succeed([]),\n  }),\n  Plugin.make,\n)();\n"],
-  "mappings": "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",
-  "names": ["Effect", "Layer", "invariant", "fromPlugins", "plugins", "effect", "Plugin", "Service", "gen", "pluginLoader", "id", "sync", "plugin", "find", "meta", "invariant", "manager", "PluginManager", "make", "core", "map", "capabilities", "contribute", "interface", "Capabilities", "implementation", "module", "AtomRegistry", "registry", "activate", "ActivationEvents", "Startup", "Effect", "React", "useEffect", "useState", "raise", "runAndForwardErrors", "useAsyncEffect", "getProviderValue", "setupPluginManager", "capabilities", "plugins", "core", "map", "meta", "id", "options", "pluginManager", "PluginManager", "make", "pluginLoader", "raise", "Error", "StoryPlugin", "getProviderValue", "forEach", "capability", "contribute", "interface", "implementation", "module", "withPluginManager", "init", "Story", "context", "storyId", "managerState", "setManagerState", "useState", "useEffect", "Capability", "contributes", "Capabilities", "ReactRoot", "root", "setupEvents", "fireEvents", "remove", "runAndForwardErrors", "shutdown", "WithPluginManagerApp", "useAsyncEffect", "Promise", "all", "event", "activate", "App", "useApp", "storyMeta", "name", "Plugin", "define", "pipe", "addModule", "activatesOn", "ActivationEvents", "Startup", "succeed"]
+  "sources": ["../../../../src/testing/harness.ts", "../../../../src/testing/service.ts", "../../../../src/testing/withPluginManager.tsx"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport { type Registry } from '@effect-atom/atom-react';\nimport * as Duration from 'effect/Duration';\nimport * as Effect from 'effect/Effect';\nimport * as PubSub from 'effect/PubSub';\nimport * as Queue from 'effect/Queue';\n\nimport { type Operation } from '@dxos/compute';\nimport { runAndForwardErrors } from '@dxos/effect';\nimport { invariant } from '@dxos/invariant';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { ActivationEvent, type Capability, type CapabilityManager, type Plugin, PluginManager } from '../core';\n\nexport type TestAppOptions = {\n  /**\n   * Plugins to register. Plugins whose `meta.tags` includes `'system'` are treated as core\n   * (force-enabled). For test convenience, plugins without a `'system'` tag are enabled by\n   * default unless `enabled` is provided.\n   */\n  plugins: Plugin.Plugin[];\n  /** Plugin ids that are enabled by default in addition to core. Defaults to all non-system plugin ids. */\n  enabled?: string[];\n  /** Additional activation events fired alongside SetupReactSurface. */\n  setupEvents?: ActivationEvent.ActivationEvent[];\n  /**\n   * Whether to automatically fire SetupReactSurface + Startup during setup.\n   * Defaults to true.\n   */\n  autoStart?: boolean;\n  /**\n   * Whether to register the PluginManager + AtomRegistry framework capabilities.\n   * Defaults to true.\n   */\n  registerFrameworkCapabilities?: boolean;\n};\n\n/**\n * A running plugin manager plus helpers for driving it in tests.\n */\nexport interface TestHarness {\n  readonly manager: PluginManager.PluginManager;\n  readonly capabilities: CapabilityManager.CapabilityManager;\n  readonly registry: Registry.Registry;\n\n  /** Activate the given event. Equivalent to `manager.activate(event)`. */\n  fire(event: ActivationEvent.ActivationEvent | string): Promise<boolean>;\n  /** Re-activate all modules that were activated by the given event. */\n  reset(event: ActivationEvent.ActivationEvent | string): Promise<boolean>;\n\n  /** Returns the first contributed capability for the given interface. Throws if none are present. */\n  get<T>(iface: Capability.InterfaceDef<T>): T;\n  /** Returns all contributed capabilities for the given interface. */\n  getAll<T>(iface: Capability.InterfaceDef<T>): T[];\n  /** Waits until at least one capability is contributed for the given interface. */\n  waitForCapability<T>(iface: Capability.InterfaceDef<T>, opts?: { timeout?: number }): Promise<T>;\n  /** Waits until the given activation event has completed. */\n  waitForEvent(event: ActivationEvent.ActivationEvent | string, opts?: { timeout?: number }): Promise<void>;\n\n  /** Invokes an operation through the `Capabilities.OperationInvoker` capability. */\n  invoke<I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I] : [input: I]): Promise<O>;\n\n  /**\n   * Waits for `Capabilities.ProcessManagerRuntime` and runs the given effect on it.\n   * Convenience around `waitForCapability(ProcessManagerRuntime).runPromise(effect)`.\n   */\n  runPromise<A, E>(\n    effect: Effect.Effect<A, E, Capabilities.ProcessManagerRuntimeServices>,\n    options?: { readonly timeout?: number; readonly signal?: AbortSignal },\n  ): Promise<A>;\n\n  enable(id: string): Promise<boolean>;\n  disable(id: string): Promise<boolean>;\n\n  /** Shuts down the underlying plugin manager. */\n  dispose(): Promise<void>;\n\n  /** Async-disposable support so tests can use `await using harness = ...`. */\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nconst DEFAULT_TIMEOUT_MS = 5_000;\n\n/**\n * Creates a TestHarness with the same bootstrap sequence that `useApp` performs,\n * minus the React provider tree.\n *\n * For Node-only tests, this is enough to fire activation events, read\n * capabilities, and invoke operations.\n *\n * For React tests, pass the returned harness to `render` or `renderSurface`\n * from `@dxos/app-framework/testing-react`.\n */\nexport const createTestApp = async (opts: TestAppOptions): Promise<TestHarness> => {\n  const {\n    plugins,\n    enabled = plugins.filter(({ meta }) => !meta.tags?.includes('system')).map((plugin) => plugin.meta.id),\n    setupEvents = [],\n    autoStart = true,\n    registerFrameworkCapabilities = true,\n  } = opts;\n\n  const pluginLoader = (id: string) =>\n    Effect.sync(() => {\n      const plugin = plugins.find((plugin) => plugin.meta.id === id);\n      invariant(plugin, `Plugin not found: ${id}`);\n      return { plugin };\n    });\n\n  const manager = PluginManager.make({ pluginLoader, plugins, enabled });\n\n  if (registerFrameworkCapabilities) {\n    manager.capabilities.contribute({\n      interface: Capabilities.PluginManager,\n      implementation: manager,\n      module: 'org.dxos.app-framework.plugin-manager',\n    });\n    manager.capabilities.contribute({\n      interface: Capabilities.AtomRegistry,\n      implementation: manager.registry,\n      module: 'org.dxos.app-framework.atom-registry',\n    });\n  }\n\n  if (autoStart) {\n    try {\n      await runAndForwardErrors(\n        Effect.all([\n          ...setupEvents.map((event) => manager.activate(event)),\n          manager.activate(ActivationEvents.SetupReactSurface),\n          manager.activate(ActivationEvents.Startup),\n        ]),\n      );\n    } catch (err) {\n      await runAndForwardErrors(manager.shutdown()).catch(() => undefined);\n      throw err;\n    }\n  }\n\n  return new TestHarnessImpl(manager);\n};\n\nclass TestHarnessImpl implements TestHarness {\n  constructor(readonly manager: PluginManager.PluginManager) {}\n\n  get capabilities(): CapabilityManager.CapabilityManager {\n    return this.manager.capabilities;\n  }\n\n  get registry(): Registry.Registry {\n    return this.manager.registry;\n  }\n\n  fire(event: ActivationEvent.ActivationEvent | string): Promise<boolean> {\n    return runAndForwardErrors(this.manager.activate(event));\n  }\n\n  reset(event: ActivationEvent.ActivationEvent | string): Promise<boolean> {\n    return runAndForwardErrors(this.manager.reset(event));\n  }\n\n  get<T>(iface: Capability.InterfaceDef<T>): T {\n    return this.manager.capabilities.get(iface);\n  }\n\n  getAll<T>(iface: Capability.InterfaceDef<T>): T[] {\n    return this.manager.capabilities.getAll(iface);\n  }\n\n  waitForCapability<T>(iface: Capability.InterfaceDef<T>, opts?: { timeout?: number }): Promise<T> {\n    const timeout = opts?.timeout ?? DEFAULT_TIMEOUT_MS;\n    return runAndForwardErrors(\n      this.manager.capabilities.waitFor(iface).pipe(\n        Effect.timeoutFail({\n          duration: Duration.millis(timeout),\n          onTimeout: () => timeoutError(iface.identifier),\n        }),\n      ),\n    );\n  }\n\n  waitForEvent(event: ActivationEvent.ActivationEvent | string, opts?: { timeout?: number }): Promise<void> {\n    const key = typeof event === 'string' ? event : ActivationEvent.eventKey(event);\n    const timeout = opts?.timeout ?? DEFAULT_TIMEOUT_MS;\n\n    const program = Effect.gen(this, function* () {\n      const queue = yield* PubSub.subscribe(this.manager.activation);\n      // Re-check after subscribing to avoid a race where the event fires\n      // between the caller invoking this and the subscription being installed.\n      if (this.manager.getEventsFired().includes(key)) {\n        return;\n      }\n      while (true) {\n        const message = yield* Queue.take(queue);\n        if (message.event === key && message.state === 'activated') {\n          return;\n        }\n      }\n    }).pipe(\n      Effect.scoped,\n      Effect.timeoutFail({\n        duration: Duration.millis(timeout),\n        onTimeout: () => timeoutError(key),\n      }),\n    );\n\n    return runAndForwardErrors(program);\n  }\n\n  async invoke<I, O>(op: Operation.Definition<I, O>, ...args: [input?: I]): Promise<O> {\n    const invoker = await this.waitForCapability(Capabilities.OperationInvoker);\n    const result = await invoker.invokePromise(op as any, ...(args as [any]));\n    if (result.error) {\n      throw result.error;\n    }\n    return result.data as O;\n  }\n\n  async runPromise<A, E>(\n    effect: Effect.Effect<A, E, Capabilities.ProcessManagerRuntimeServices>,\n    options?: { readonly timeout?: number; readonly signal?: AbortSignal },\n  ): Promise<A> {\n    const runtime = await this.waitForCapability(Capabilities.ProcessManagerRuntime, { timeout: options?.timeout });\n    return runtime.runPromise(effect, options?.signal ? { signal: options.signal } : undefined);\n  }\n\n  enable(id: string): Promise<boolean> {\n    return runAndForwardErrors(this.manager.enable(id));\n  }\n\n  disable(id: string): Promise<boolean> {\n    return runAndForwardErrors(this.manager.disable(id));\n  }\n\n  async dispose(): Promise<void> {\n    await runAndForwardErrors(this.manager.shutdown());\n  }\n\n  [Symbol.asyncDispose](): Promise<void> {\n    return this.dispose();\n  }\n}\n\nconst timeoutError = (id: string) => new Error(`Timed out waiting for ${id}`);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { Plugin, PluginManager } from '../core';\n\n/**\n * Creates a Plugin.Service layer from a list of plugins.\n * This is primarily used for testing.\n */\nexport const fromPlugins = (plugins: Plugin.Plugin[]) =>\n  Layer.effect(\n    Plugin.Service,\n    Effect.gen(function* () {\n      // TODO(wittjosiah): Try to dedupe logic between here, createCliApp and useApp.\n\n      const pluginLoader = (id: string) =>\n        Effect.sync(() => {\n          const plugin = plugins.find((plugin) => plugin.meta.id === id);\n          invariant(plugin, `Plugin not found: ${id}`);\n          return { plugin };\n        });\n\n      const manager = PluginManager.make({\n        pluginLoader,\n        plugins,\n        enabled: plugins.map((plugin) => plugin.meta.id),\n      });\n\n      manager.capabilities.contribute({\n        interface: Capabilities.PluginManager,\n        implementation: manager,\n        module: 'org.dxos.app-framework.plugin-manager',\n      });\n\n      manager.capabilities.contribute({\n        interface: Capabilities.AtomRegistry,\n        implementation: manager.registry,\n        module: 'org.dxos.app-framework.atom-registry',\n      });\n\n      yield* manager.activate(ActivationEvents.Startup);\n\n      return manager;\n    }),\n  );\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Decorator, type StoryContext } from '@storybook/react';\nimport * as Effect from 'effect/Effect';\nimport React, { useEffect, useState } from 'react';\n\nimport { raise } from '@dxos/debug';\nimport { runAndForwardErrors } from '@dxos/effect';\nimport { useAsyncEffect } from '@dxos/react-hooks';\nimport { type MaybeProvider, getProviderValue } from '@dxos/util';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { type ActivationEvent, Capability, type CapabilityManager, Plugin, PluginManager } from '../core';\nimport { type UseAppOptions, useApp } from '../ui';\n\n/**\n * @internal\n */\nexport const setupPluginManager = ({\n  capabilities,\n  plugins = [],\n  ...options\n}: UseAppOptions & Pick<WithPluginManagerOptions, 'capabilities'> = {}) => {\n  // Auto-enable every non-system plugin so stories don't have to spell out\n  // enablement. System-tagged plugins are force-enabled by the manager.\n  const enabled = plugins.filter(({ meta }) => !meta.tags?.includes('system')).map(({ meta }) => meta.id);\n  const pluginManager = PluginManager.make({\n    pluginLoader: () => raise(new Error('Not implemented')),\n    plugins: [StoryPlugin, ...plugins],\n    enabled,\n    ...options,\n  });\n\n  if (capabilities) {\n    getProviderValue(capabilities, pluginManager.capabilities).forEach((capability) => {\n      pluginManager.capabilities.contribute({\n        interface: capability.interface,\n        implementation: capability.implementation,\n        module: 'story',\n      });\n    });\n  }\n\n  return pluginManager;\n};\n\ntype ManagedPluginManagerState = {\n  fireEvents?: (ActivationEvent.ActivationEvent | string)[];\n  pluginManager: PluginManager.PluginManager;\n  setupEvents?: ActivationEvent.ActivationEvent[];\n  storyId: string;\n};\n\nexport type WithPluginManagerOptions = UseAppOptions & {\n  /** @deprecated */\n  capabilities?: MaybeProvider<Capability.Any[], CapabilityManager.CapabilityManager>;\n  /** @deprecated */\n  fireEvents?: (ActivationEvent.ActivationEvent | string)[];\n};\n\nexport type WithPluginManagerInitializer<Args = void> =\n  | WithPluginManagerOptions\n  | ((context: StoryContext<Args>) => WithPluginManagerOptions);\n\n/**\n * Wraps a story with a plugin manager.\n * NOTE: This builds up and tears down the plugin manager on every render.\n */\nexport const withPluginManager = <Args,>(init: WithPluginManagerInitializer<Args> = {}): Decorator => {\n  return (Story, context) => {\n    const storyId = context.id;\n    const options = typeof init === 'function' ? init(context as any) : init;\n    const [managerState, setManagerState] = useState<ManagedPluginManagerState>();\n\n    // Storybook replaces the full context object often, so key manager ownership by story id.\n    useEffect(() => {\n      const pluginManager = setupPluginManager(options);\n      const capability = Capability.contributes(Capabilities.ReactRoot, {\n        id: storyId,\n        root: () => <Story />,\n      });\n\n      pluginManager.capabilities.contribute({\n        ...capability,\n        module: 'org.dxos.app-framework.with-plugin-manager',\n      });\n\n      setManagerState({\n        pluginManager,\n        setupEvents: options.setupEvents,\n        fireEvents: options.fireEvents,\n        storyId,\n      });\n\n      return () => {\n        pluginManager.capabilities.remove(capability.interface, capability.implementation);\n        void runAndForwardErrors(pluginManager.shutdown());\n      };\n    }, [storyId, init]);\n\n    // Avoid mounting useApp with a stale manager from the previous story.\n    if (!managerState || managerState.storyId !== storyId) {\n      return <></>;\n    }\n\n    return <WithPluginManagerApp {...managerState} />;\n  };\n};\n\nconst WithPluginManagerApp = ({ fireEvents, pluginManager, setupEvents, storyId }: ManagedPluginManagerState) => {\n  // Fire deprecated events only after the effect-owned manager for this story exists.\n  useAsyncEffect(async () => {\n    await Promise.all(fireEvents?.map((event) => pluginManager.activate(event)) ?? []);\n  }, [fireEvents, pluginManager, storyId]);\n\n  const App = useApp({ pluginManager, setupEvents });\n  return <App />;\n};\n\nconst storyMeta = {\n  id: 'org.dxos.app-framework.story',\n  name: 'Story',\n  tags: ['system'],\n};\n\n// No-op plugin to ensure there exists at least one plugin for the startup event.\n// This is necessary because `createApp` expects the startup event to complete before the app is ready.\nconst StoryPlugin = Plugin.define(storyMeta).pipe(\n  Plugin.addModule({\n    id: 'Story',\n    activatesOn: ActivationEvents.Startup,\n    activate: () => Effect.succeed([]),\n  }),\n  Plugin.make,\n)();\n"],
+  "mappings": "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",
+  "names": ["Duration", "Effect", "PubSub", "Queue", "runAndForwardErrors", "invariant", "DEFAULT_TIMEOUT_MS", "pluginLoader", "Effect", "sync", "plugin", "plugins", "meta", "id", "manager", "enabled", "registerFrameworkCapabilities", "PluginManager", "implementation", "module", "capabilities", "registry", "autoStart", "runAndForwardErrors", "ActivationEvents", "activate", "Startup", "err", "TestHarnessImpl", "fire", "reset", "iface", "getAll", "waitForCapability", "duration", "Duration", "timeout", "onTimeout", "timeoutError", "identifier", "waitForEvent", "opts", "program", "queue", "subscribe", "message", "key", "invoke", "result", "invoker", "error", "data", "runPromise", "effect", "options", "runtime", "undefined", "enable", "disable", "dispose", "Symbol", "asyncDispose", "Effect", "Layer", "invariant", "__dxlog_file", "pluginLoader", "id", "plugin", "manager", "plugins", "enabled", "capabilities", "contribute", "implementation", "module", "registry", "Effect", "React", "useEffect", "useState", "raise", "runAndForwardErrors", "useAsyncEffect", "getProviderValue", "setupPluginManager", "capabilities", "plugins", "options", "enabled", "filter", "meta", "tags", "includes", "map", "id", "pluginManager", "PluginManager", "make", "pluginLoader", "raise", "Error", "StoryPlugin", "getProviderValue", "forEach", "capability", "contribute", "interface", "implementation", "module", "withPluginManager", "init", "Story", "context", "storyId", "managerState", "setManagerState", "useState", "useEffect", "Capability", "contributes", "Capabilities", "ReactRoot", "root", "setupEvents", "fireEvents", "remove", "runAndForwardErrors", "shutdown", "WithPluginManagerApp", "useAsyncEffect", "Promise", "all", "event", "activate", "App", "useApp", "storyMeta", "name", "Plugin", "define", "pipe", "addModule", "activatesOn", "ActivationEvents", "Startup", "succeed"]
 }

package/dist/lib/browser/testing/react.mjs

@@ -0,0 +1,78 @@
+import {
+  PluginManagerProvider,
+  SurfaceComponent,
+  topologicalSort
+} from "../chunk-QLML5QFJ.mjs";
+import {
+  PluginManagerContext
+} from "../chunk-FJ4765WW.mjs";
+import "../chunk-KFDF7KR3.mjs";
+import {
+  capabilities_exports
+} from "../chunk-5AHASNDW.mjs";
+import "../chunk-5GY3YOEL.mjs";
+import "../chunk-FO3IYSLV.mjs";
+import "../chunk-KLHQNYJ2.mjs";
+import "../chunk-VJ5PFAWC.mjs";
+import "../chunk-66IXTIVK.mjs";
+import "../chunk-SLX73WRZ.mjs";
+import "../chunk-IW44C7UL.mjs";
+import "../chunk-J5LGTIGS.mjs";
+
+// src/testing/react.tsx
+import { RegistryContext } from "@effect-atom/atom-react";
+import { render as rtlRender } from "@testing-library/react";
+import React, { Fragment } from "react";
+import { ContextProtocolProvider } from "@dxos/web-context-react";
+var render = (harness, ui, options) => {
+  const { reactContexts = [], ...rest } = options ?? {};
+  const Wrapper = ({ children }) => /* @__PURE__ */ React.createElement(HarnessProviders, {
+    harness,
+    extra: reactContexts
+  }, children);
+  return rtlRender(/* @__PURE__ */ React.createElement(React.Fragment, null, ui), {
+    ...rest,
+    wrapper: Wrapper
+  });
+};
+var renderSurface = (harness, props, options) => {
+  const { role, data, limit, fallback, placeholder } = props;
+  return render(harness, /* @__PURE__ */ React.createElement(SurfaceComponent, {
+    role,
+    data,
+    limit,
+    fallback,
+    placeholder
+  }), options);
+};
+var HarnessProviders = ({ harness, extra, children }) => {
+  const contributed = harness.getAll(capabilities_exports.ReactContext);
+  const ContributedContext = composeContexts(contributed);
+  const ExtraContext = composeExtra(extra);
+  return /* @__PURE__ */ React.createElement(PluginManagerProvider, {
+    value: harness.manager
+  }, /* @__PURE__ */ React.createElement(ContextProtocolProvider, {
+    value: harness.manager,
+    context: PluginManagerContext
+  }, /* @__PURE__ */ React.createElement(RegistryContext.Provider, {
+    value: harness.registry
+  }, /* @__PURE__ */ React.createElement(ContributedContext, null, /* @__PURE__ */ React.createElement(ExtraContext, null, children)))));
+};
+var composeContexts = (contexts) => {
+  if (contexts.length === 0) {
+    return Passthrough;
+  }
+  return topologicalSort(contexts).map(({ context }) => context).reduce((Acc, Next) => ({ children }) => /* @__PURE__ */ React.createElement(Acc, null, /* @__PURE__ */ React.createElement(Next, null, children)));
+};
+var composeExtra = (contexts) => {
+  if (contexts.length === 0) {
+    return Passthrough;
+  }
+  return contexts.reduce((Acc, Next) => ({ children }) => /* @__PURE__ */ React.createElement(Next, null, /* @__PURE__ */ React.createElement(Acc, null, children)), Passthrough);
+};
+var Passthrough = ({ children }) => /* @__PURE__ */ React.createElement(Fragment, null, children);
+export {
+  render,
+  renderSurface
+};
+//# sourceMappingURL=react.mjs.map

package/dist/lib/browser/testing/react.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/testing/react.tsx"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport { RegistryContext } from '@effect-atom/atom-react';\nimport { render as rtlRender, type RenderOptions, type RenderResult } from '@testing-library/react';\nimport React, { type FC, Fragment, type PropsWithChildren, type ReactNode } from 'react';\n\nimport { ContextProtocolProvider } from '@dxos/web-context-react';\n\nimport { Capabilities } from '../common';\nimport { PluginManagerContext } from '../context';\nimport { topologicalSort } from '../helpers';\nimport { PluginManagerProvider } from '../ui/components/PluginManager/PluginManagerProvider';\nimport { SurfaceComponent } from '../ui/components/Surface/SurfaceComponent';\nimport { type TestHarness } from './harness';\n\nexport type HarnessRenderOptions = Omit<RenderOptions, 'wrapper'> & {\n  /** Additional providers to wrap around the harness tree (applied innermost first). */\n  reactContexts?: FC<PropsWithChildren>[];\n};\n\n/**\n * Renders `ui` wrapped in the same provider tree as `useApp` plus every contributed\n * `Capabilities.ReactContext`.\n */\nexport const render = (harness: TestHarness, ui: ReactNode, options?: HarnessRenderOptions): RenderResult => {\n  const { reactContexts = [], ...rest } = options ?? {};\n  const Wrapper = ({ children }: PropsWithChildren) => (\n    <HarnessProviders harness={harness} extra={reactContexts}>\n      {children}\n    </HarnessProviders>\n  );\n  return rtlRender(<>{ui}</>, { ...rest, wrapper: Wrapper });\n};\n\nexport type RenderSurfaceProps = {\n  role: string;\n  data?: unknown;\n  limit?: number;\n  fallback?: FC<{ error: Error; data?: any }>;\n  placeholder?: ReactNode;\n};\n\n/**\n * Renders a `Surface` with the given role/data inside the harness provider tree.\n */\nexport const renderSurface = (\n  harness: TestHarness,\n  props: RenderSurfaceProps,\n  options?: HarnessRenderOptions,\n): RenderResult => {\n  const { role, data, limit, fallback, placeholder } = props;\n  return render(\n    harness,\n    <SurfaceComponent role={role} data={data as any} limit={limit} fallback={fallback} placeholder={placeholder} />,\n    options,\n  );\n};\n\ntype HarnessProvidersProps = PropsWithChildren<{\n  harness: TestHarness;\n  extra: FC<PropsWithChildren>[];\n}>;\n\nconst HarnessProviders = ({ harness, extra, children }: HarnessProvidersProps) => {\n  const contributed = harness.getAll(Capabilities.ReactContext);\n  const ContributedContext = composeContexts(contributed);\n  const ExtraContext = composeExtra(extra);\n  return (\n    <PluginManagerProvider value={harness.manager}>\n      <ContextProtocolProvider value={harness.manager} context={PluginManagerContext}>\n        <RegistryContext.Provider value={harness.registry}>\n          <ContributedContext>\n            <ExtraContext>{children}</ExtraContext>\n          </ContributedContext>\n        </RegistryContext.Provider>\n      </ContextProtocolProvider>\n    </PluginManagerProvider>\n  );\n};\n\nconst composeContexts = (contexts: Capabilities.ReactContext[]): FC<PropsWithChildren> => {\n  if (contexts.length === 0) {\n    return Passthrough;\n  }\n  return topologicalSort(contexts)\n    .map(({ context }) => context)\n    .reduce((Acc, Next) => ({ children }: PropsWithChildren) => (\n      <Acc>\n        <Next>{children}</Next>\n      </Acc>\n    ));\n};\n\n// Composes in innermost-first order: the first context in the array wraps\n// `children` directly; subsequent contexts wrap the accumulator.\nconst composeExtra = (contexts: FC<PropsWithChildren>[]): FC<PropsWithChildren> => {\n  if (contexts.length === 0) {\n    return Passthrough;\n  }\n  return contexts.reduce<FC<PropsWithChildren>>(\n    (Acc, Next) =>\n      ({ children }: PropsWithChildren) => (\n        <Next>\n          <Acc>{children}</Acc>\n        </Next>\n      ),\n    Passthrough,\n  );\n};\n\nconst Passthrough: FC<PropsWithChildren> = ({ children }) => <Fragment>{children}</Fragment>;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;AAIA,SAASA,uBAAuB;AAChC,SAASC,UAAUC,iBAAwD;AAC3E,OAAOC,SAAkBC,gBAAwD;AAEjF,SAASC,+BAA+B;AAkBjC,IAAMC,SAAS,CAACC,SAAsBC,IAAeC,YAAAA;AAC1D,QAAM,EAAEC,gBAAgB,CAAA,GAAI,GAAGC,KAAAA,IAASF,WAAW,CAAC;AACpD,QAAMG,UAAU,CAAC,EAAEC,SAAQ,MACzB,sBAAA,cAACC,kBAAAA;IAAiBP;IAAkBQ,OAAOL;KACxCG,QAAAA;AAGL,SAAOG,UAAU,sBAAA,cAAA,MAAA,UAAA,MAAGR,EAAAA,GAAQ;IAAE,GAAGG;IAAMM,SAASL;EAAQ,CAAA;AAC1D;AAaO,IAAMM,gBAAgB,CAC3BX,SACAY,OACAV,YAAAA;AAEA,QAAM,EAAEW,MAAMC,MAAMC,OAAOC,UAAUC,YAAW,IAAKL;AACrD,SAAOb,OACLC,SACA,sBAAA,cAACkB,kBAAAA;IAAiBL;IAAYC;IAAmBC;IAAcC;IAAoBC;MACnFf,OAAAA;AAEJ;AAOA,IAAMK,mBAAmB,CAAC,EAAEP,SAASQ,OAAOF,SAAQ,MAAyB;AAC3E,QAAMa,cAAcnB,QAAQoB,OAAOC,qBAAaC,YAAY;AAC5D,QAAMC,qBAAqBC,gBAAgBL,WAAAA;AAC3C,QAAMM,eAAeC,aAAalB,KAAAA;AAClC,SACE,sBAAA,cAACmB,uBAAAA;IAAsBC,OAAO5B,QAAQ6B;KACpC,sBAAA,cAACC,yBAAAA;IAAwBF,OAAO5B,QAAQ6B;IAASE,SAASC;KACxD,sBAAA,cAACC,gBAAgBC,UAAQ;IAACN,OAAO5B,QAAQmC;KACvC,sBAAA,cAACZ,oBAAAA,MACC,sBAAA,cAACE,cAAAA,MAAcnB,QAAAA,CAAAA,CAAAA,CAAAA,CAAAA;AAM3B;AAEA,IAAMkB,kBAAkB,CAACY,aAAAA;AACvB,MAAIA,SAASC,WAAW,GAAG;AACzB,WAAOC;EACT;AACA,SAAOC,gBAAgBH,QAAAA,EACpBI,IAAI,CAAC,EAAET,QAAO,MAAOA,OAAAA,EACrBU,OAAO,CAACC,KAAKC,SAAS,CAAC,EAAErC,SAAQ,MAChC,sBAAA,cAACoC,KAAAA,MACC,sBAAA,cAACC,MAAAA,MAAMrC,QAAAA,CAAAA,CAAAA;AAGf;AAIA,IAAMoB,eAAe,CAACU,aAAAA;AACpB,MAAIA,SAASC,WAAW,GAAG;AACzB,WAAOC;EACT;AACA,SAAOF,SAASK,OACd,CAACC,KAAKC,SACJ,CAAC,EAAErC,SAAQ,MACT,sBAAA,cAACqC,MAAAA,MACC,sBAAA,cAACD,KAAAA,MAAKpC,QAAAA,CAAAA,GAGZgC,WAAAA;AAEJ;AAEA,IAAMA,cAAqC,CAAC,EAAEhC,SAAQ,MAAO,sBAAA,cAACsC,UAAAA,MAAUtC,QAAAA;",
+  "names": ["RegistryContext", "render", "rtlRender", "React", "Fragment", "ContextProtocolProvider", "render", "harness", "ui", "options", "reactContexts", "rest", "Wrapper", "children", "HarnessProviders", "extra", "rtlRender", "wrapper", "renderSurface", "props", "role", "data", "limit", "fallback", "placeholder", "SurfaceComponent", "contributed", "getAll", "Capabilities", "ReactContext", "ContributedContext", "composeContexts", "ExtraContext", "composeExtra", "PluginManagerProvider", "value", "manager", "ContextProtocolProvider", "context", "PluginManagerContext", "RegistryContext", "Provider", "registry", "contexts", "length", "Passthrough", "topologicalSort", "map", "reduce", "Acc", "Next", "Fragment"]
+}