@dxos/app-framework 0.8.4-main.a4bbb77 → 0.8.4-main.abd8ff62ef

package/dist/lib/node-esm/chunk-Q7XBFII4.mjs

@@ -0,0 +1,908 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  eventKey,
+  getEvents,
+  isAllOf
+} from "./chunk-XOCUANHO.mjs";
+import {
+  Service as Service2,
+  isLazy,
+  resolveLazy
+} from "./chunk-HTBJU5FX.mjs";
+import {
+  Service
+} from "./chunk-SDJ4B2LU.mjs";
+import {
+  __export
+} from "./chunk-HSLMI22Q.mjs";
+
+// src/core/plugin-manager.ts
+var plugin_manager_exports = {};
+__export(plugin_manager_exports, {
+  ManagerTypeId: () => ManagerTypeId,
+  PluginInitializationError: () => PluginInitializationError,
+  isManager: () => isManager,
+  make: () => make5
+});
+import { Atom as Atom2, Registry } from "@effect-atom/atom-react";
+import * as Array from "effect/Array";
+import * as Cause from "effect/Cause";
+import * as Deferred2 from "effect/Deferred";
+import * as Duration from "effect/Duration";
+import * as Effect2 from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Function from "effect/Function";
+import * as HashSet from "effect/HashSet";
+import * as PubSub from "effect/PubSub";
+import * as Ref from "effect/Ref";
+import { runAndForwardErrors } from "@dxos/effect";
+import { Performance } from "@dxos/effect";
+import { BaseError } from "@dxos/errors";
+import { log as log2 } from "@dxos/log";
+
+// src/core/capability-manager.ts
+var capability_manager_exports = {};
+__export(capability_manager_exports, {
+  make: () => make2
+});
+import { Atom } from "@effect-atom/atom-react";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import { invariant } from "@dxos/invariant";
+import { log } from "@dxos/log";
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/capability-manager.ts";
+var CapabilityManagerImpl = class {
+  _registry;
+  _capabilityEntries = Atom.family(() => {
+    return Atom.make([]).pipe(Atom.keepAlive);
+  });
+  _capabilities = Atom.family((id) => {
+    return Atom.make((get2) => {
+      const current = get2(this._capabilityEntries(id));
+      return current.map((c) => c.implementation);
+    }).pipe(Atom.keepAlive);
+  });
+  _capabilitiesByModule = Atom.family((id) => {
+    return Atom.make((get2) => {
+      const entries = get2(this._capabilityEntries(id));
+      const result = {};
+      for (const entry of entries) {
+        (result[entry.moduleId] ??= []).push(entry.implementation);
+      }
+      return result;
+    }).pipe(Atom.keepAlive);
+  });
+  _capability = Atom.family((id) => {
+    return Atom.make((get2) => {
+      const current = get2(this._capabilities(id));
+      invariant(current.length > 0, `No capability found for ${id}`, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 35, S: this, A: ["current.length > 0", "`No capability found for ${id}`"] });
+      return current[0];
+    });
+  });
+  constructor({ registry }) {
+    this._registry = registry;
+  }
+  contribute({ module: moduleId, interface: interfaceDef, implementation }) {
+    const current = this._registry.get(this._capabilityEntries(interfaceDef.identifier));
+    const isDuplicate = current.some((c) => c.moduleId === moduleId && c.implementation === implementation);
+    if (isDuplicate) {
+      log("capability already contributed, skipping", {
+        id: interfaceDef.identifier,
+        moduleId
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 46, S: this });
+      return;
+    }
+    const entry = {
+      moduleId,
+      implementation
+    };
+    this._registry.set(this._capabilityEntries(interfaceDef.identifier), [
+      ...current,
+      entry
+    ]);
+    log("capability contributed", {
+      id: interfaceDef.identifier,
+      moduleId,
+      count: current.length
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 60, S: this });
+  }
+  remove(interfaceDef, implementation) {
+    const current = this._registry.get(this._capabilityEntries(interfaceDef.identifier));
+    if (current.length === 0) {
+      return;
+    }
+    const next = current.filter((c) => c.implementation !== implementation);
+    if (next.length !== current.length) {
+      this._registry.set(this._capabilityEntries(interfaceDef.identifier), next);
+      log("capability removed", {
+        id: interfaceDef.identifier,
+        count: current.length
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 74, S: this });
+    } else {
+      log.warn("capability not removed", {
+        id: interfaceDef.identifier
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 79, S: this });
+    }
+  }
+  atom(interfaceDef) {
+    return this._capabilities(interfaceDef.identifier);
+  }
+  getAll(interfaceDef) {
+    return this._registry.get(this.atom(interfaceDef));
+  }
+  get(interfaceDef) {
+    const capabilities = this.getAll(interfaceDef);
+    invariant(capabilities.length > 0, `No capability found for ${interfaceDef.identifier}`, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 93, S: this, A: ["capabilities.length > 0", "`No capability found for ${interfaceDef.identifier}`"] });
+    return capabilities[0];
+  }
+  waitFor(interfaceDef) {
+    return Effect.gen(this, function* () {
+      const [capability] = this.getAll(interfaceDef);
+      if (capability) {
+        return capability;
+      }
+      const deferred = yield* Deferred.make();
+      const cancel = this._registry.subscribe(this.atom(interfaceDef), (capabilities) => {
+        if (capabilities.length > 0) {
+          Effect.runSync(Deferred.succeed(deferred, capabilities[0]));
+        }
+      });
+      const result = yield* Deferred.await(deferred);
+      cancel();
+      return result;
+    });
+  }
+  atomByModule(interfaceDef) {
+    return this._capabilitiesByModule(interfaceDef.identifier);
+  }
+};
+var make2 = (options) => new CapabilityManagerImpl(options);
+
+// src/core/plugin-manager.ts
+var __dxlog_file2 = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/plugin-manager.ts";
+var PluginInitializationError = class extends BaseError.extend("PluginInitializationError", "Plugin manager initialization failed") {
+};
+var ManagerTypeId = /* @__PURE__ */ Symbol.for("@dxos/app-framework/Manager");
+var isManager = (value) => {
+  return typeof value === "object" && value !== null && ManagerTypeId in value;
+};
+var ManagerImpl = class {
+  [ManagerTypeId] = ManagerTypeId;
+  activation = Effect2.runSync(PubSub.unbounded());
+  capabilities;
+  registry;
+  _pluginsAtom;
+  _coreAtom;
+  _enabledAtom;
+  _modulesAtom;
+  _activeAtom;
+  _eventsFiredAtom;
+  _pendingResetAtom;
+  _pluginLoader;
+  _onRemove;
+  _capabilities = /* @__PURE__ */ new Map();
+  _moduleMemoMap = /* @__PURE__ */ new Map();
+  _moduleSemaphores = /* @__PURE__ */ new Map();
+  // Coalesces concurrent `_resolveLazyPlugin` calls per plugin id. Without
+  // this, two callers entering `enable(id)` before the swap completes would
+  // each invoke `mod.default(options)` and produce distinct module objects,
+  // defeating `_addModule`'s reference-equality dedupe and racing the
+  // `_pluginsAtom` swap.
+  _resolvingPlugins = /* @__PURE__ */ new Map();
+  _activatingEvents = Effect2.runSync(Ref.make([]));
+  _activatingModules = Effect2.runSync(Ref.make([]));
+  _inFlightFibers = Effect2.runSync(Ref.make([]));
+  _shutdownSemaphore = Effect2.runSync(Effect2.makeSemaphore(1));
+  _shuttingDown = Effect2.runSync(Ref.make(false));
+  // Tracks the constructor-launched core/enabled `enable()` calls so that
+  // `activate` can wait for module registration before dispatching events.
+  // Lazy plugins make `enable` asynchronous (a dynamic `import()` happens
+  // inside it), so without this synchronization an `activate` triggered
+  // immediately after `make` could fire on an empty module set. Failures
+  // are wrapped in `PluginInitializationError` so awaiters get a tagged
+  // error rather than the wide `Error` produced by the underlying chain.
+  _initialization = Effect2.runSync(Deferred2.make());
+  constructor({ pluginLoader, plugins = [], core = plugins.map(({ meta }) => meta.id), enabled = [], registry, onRemove }) {
+    this.registry = registry ?? Registry.make();
+    this.capabilities = make2({
+      registry: this.registry
+    });
+    this._pluginLoader = pluginLoader;
+    this._onRemove = onRemove;
+    this._pluginsAtom = Atom2.make(plugins).pipe(Atom2.keepAlive);
+    this._coreAtom = Atom2.make(core).pipe(Atom2.keepAlive);
+    this._enabledAtom = Atom2.make(enabled).pipe(Atom2.keepAlive);
+    this._modulesAtom = Atom2.make([]).pipe(Atom2.keepAlive);
+    this._activeAtom = Atom2.make([]).pipe(Atom2.keepAlive);
+    this._eventsFiredAtom = Atom2.make([]).pipe(Atom2.keepAlive);
+    this._pendingResetAtom = Atom2.make([]).pipe(Atom2.keepAlive);
+    plugins.forEach((plugin) => this._addPlugin(plugin));
+    const initialIds = [
+      .../* @__PURE__ */ new Set([
+        ...core,
+        ...enabled
+      ])
+    ];
+    void Effect2.all(initialIds.map((id) => this.enable(id))).pipe(Effect2.mapError((cause) => new PluginInitializationError({
+      cause
+    })), Effect2.tap(() => Deferred2.succeed(this._initialization, void 0)), Effect2.tapErrorCause((cause) => Deferred2.failCause(this._initialization, cause))).pipe(runAndForwardErrors);
+  }
+  get plugins() {
+    return this._pluginsAtom;
+  }
+  get core() {
+    return this._coreAtom;
+  }
+  /**
+  * Ids of plugins that are currently enabled.
+  */
+  get enabled() {
+    return this._enabledAtom;
+  }
+  /**
+  * Modules of plugins which are currently enabled.
+  */
+  get modules() {
+    return this._modulesAtom;
+  }
+  /**
+  * Ids of modules which are currently active.
+  */
+  get active() {
+    return this._activeAtom;
+  }
+  /**
+  * Ids of events which have been fired.
+  */
+  get eventsFired() {
+    return this._eventsFiredAtom;
+  }
+  /**
+  * Ids of modules which are pending reset.
+  */
+  get pendingReset() {
+    return this._pendingResetAtom;
+  }
+  getPlugins() {
+    return this._get(this._pluginsAtom);
+  }
+  getCore() {
+    return this._get(this._coreAtom);
+  }
+  getEnabled() {
+    return this._get(this._enabledAtom);
+  }
+  getModules() {
+    return this._get(this._modulesAtom);
+  }
+  getActive() {
+    return this._get(this._activeAtom);
+  }
+  getEventsFired() {
+    return this._get(this._eventsFiredAtom);
+  }
+  getPendingReset() {
+    return this._get(this._pendingResetAtom);
+  }
+  /**
+  * Adds a plugin to the manager via the plugin loader.
+  * The plugin is registered but not enabled; call `enable` separately to activate it.
+  * @param id The id of the plugin.
+  */
+  add(id) {
+    return Effect2.gen(this, function* () {
+      log2("add plugin", {
+        id
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 165, S: this });
+      const plugin = yield* this._pluginLoader(id);
+      this._addPlugin(plugin);
+      return plugin;
+    });
+  }
+  /**
+  * Enables a plugin.
+  * @param id The id of the plugin.
+  */
+  enable(id) {
+    return Effect2.gen(this, function* () {
+      log2("enable plugin", {
+        id
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 178, S: this });
+      const stub = this._getPlugin(id);
+      if (!stub) {
+        return false;
+      }
+      const plugin = yield* this._resolveLazyPlugin(stub);
+      this._update(this._enabledAtom, (enabled) => enabled.includes(id) ? enabled : [
+        ...enabled,
+        id
+      ]);
+      plugin.modules.forEach((module) => {
+        this._addModule(module);
+        this._setPendingResetByModule(module);
+      });
+      log2("pending reset", {
+        events: [
+          ...this.getPendingReset()
+        ]
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 194, S: this });
+      yield* Effect2.all(this.getPendingReset().map((event) => this.activate(event)), {
+        concurrency: "unbounded"
+      });
+      return true;
+    });
+  }
+  /**
+  * Resolves a lazy plugin stub (returned by {@link Plugin.lazy}) to its
+  * loaded form and swaps it into `_pluginsAtom`. Returns the input unchanged
+  * when the plugin is already resolved, so callers can `yield*` this
+  * unconditionally. The lazy stub carries `meta` synchronously but its
+  * `modules` list is empty until the loader resolves; the swap ensures
+  * subsequent enable/disable operations see the resolved plugin.
+  *
+  * Concurrent calls for the same id are coalesced via `_resolvingPlugins`:
+  * the first caller starts the resolution, every subsequent caller awaits
+  * the same `Deferred`. On failure we publish a `lazy:<id>` error message
+  * and skip the atom swap so the failure is observable to the activation
+  * subscriber and a retry can be attempted.
+  */
+  _resolveLazyPlugin(plugin) {
+    return Effect2.gen(this, function* () {
+      if (!isLazy(plugin)) {
+        return plugin;
+      }
+      const id = plugin.meta.id;
+      const existing = this._resolvingPlugins.get(id);
+      if (existing) {
+        return yield* Deferred2.await(existing);
+      }
+      const deferred = yield* Deferred2.make();
+      this._resolvingPlugins.set(id, deferred);
+      return yield* Effect2.gen(this, function* () {
+        log2("resolving lazy plugin", {
+          id
+        }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 231, S: this });
+        yield* PubSub.publish(this.activation, {
+          event: "",
+          state: "activating",
+          module: `lazy:${id}`
+        });
+        const resolvedPlugin = yield* resolveLazy(plugin);
+        this._update(this._pluginsAtom, (plugins) => plugins.map((p) => p.meta.id === id ? resolvedPlugin : p));
+        yield* PubSub.publish(this.activation, {
+          event: "",
+          state: "activated",
+          module: `lazy:${id}`
+        });
+        return resolvedPlugin;
+      }).pipe(Effect2.tapError((error) => PubSub.publish(this.activation, {
+        event: "",
+        state: "error",
+        module: `lazy:${id}`,
+        error
+      })), Effect2.tap((value) => Deferred2.succeed(deferred, value)), Effect2.tapErrorCause((cause) => Deferred2.failCause(deferred, cause)), Effect2.ensuring(Effect2.sync(() => this._resolvingPlugins.delete(id))));
+    });
+  }
+  /**
+  * Removes a plugin from the manager.
+  * @param id The id of the plugin.
+  */
+  remove(id) {
+    return Effect2.gen(this, function* () {
+      log2("remove plugin", {
+        id
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 260, S: this });
+      const disabled = yield* this.disable(id);
+      if (!disabled) {
+        return false;
+      }
+      this._removePlugin(id);
+      if (this._onRemove) {
+        this._runForkedFiber(this._onRemove(id).pipe(Effect2.tapError((error) => Effect2.sync(() => log2.warn("plugin remove hook failed", {
+          id,
+          error
+        }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 269, S: this }))), Effect2.ignore));
+      }
+      return true;
+    });
+  }
+  /**
+  * Disables a plugin.
+  * @param id The id of the plugin.
+  */
+  disable(id) {
+    return Effect2.gen(this, function* () {
+      log2("disable plugin", {
+        id
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 282, S: this });
+      if (this._get(this._coreAtom).includes(id)) {
+        return false;
+      }
+      const plugin = this._getPlugin(id);
+      if (!plugin) {
+        return false;
+      }
+      const enabledIndex = this._get(this._enabledAtom).findIndex((enabled) => enabled === id);
+      if (enabledIndex !== -1) {
+        this._update(this._enabledAtom, (enabled) => enabled.filter((item) => item !== id));
+        yield* this.deactivate(id);
+        plugin.modules.forEach((module) => {
+          this._removeModule(module.id);
+        });
+      }
+      return true;
+    });
+  }
+  /**
+  * Activates plugins based on the activation event.
+  * @param event The activation event.
+  * @returns Whether the activation was successful.
+  */
+  activate(event, params) {
+    const key = typeof event === "string" ? event : eventKey(event);
+    return Effect2.gen(this, function* () {
+      if (yield* this._isShuttingDown()) {
+        log2("skipping activation during shutdown", {
+          key,
+          ...params
+        }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 311, S: this });
+        return false;
+      }
+      yield* Deferred2.await(this._initialization);
+      return yield* Effect2.withFiberRuntime((fiber) => this._activateEvent(key, params, fiber).pipe(together(Effect2.sleep(Duration.seconds(15)).pipe(Effect2.andThen(Effect2.sync(() => log2.warn("event activation is taking a long time", {
+        event: key
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 322, S: this }))))), Performance.addTrackEntry({
+        name: typeof event === "string" ? event : eventKey(event),
+        devtools: {
+          dataType: "track-entry",
+          track: "Event Activation",
+          trackGroup: "Composer",
+          color: "primary"
+        }
+      })));
+    });
+  }
+  /**
+  * Deactivates all of the modules for a plugin.
+  * @param id The id of the plugin.
+  * @returns Whether the deactivation was successful.
+  */
+  deactivate(id) {
+    return Effect2.gen(this, function* () {
+      const plugin = this._getPlugin(id);
+      if (!plugin) {
+        return false;
+      }
+      const modules = plugin.modules;
+      const results = yield* Effect2.all(modules.map((module) => this._deactivateModule(module)), {
+        concurrency: "unbounded"
+      });
+      return results.every((result) => result);
+    });
+  }
+  /**
+  * Re-activates the modules that were activated by the event.
+  * @param event The activation event.
+  * @returns Whether the reset was successful.
+  */
+  reset(event) {
+    return Effect2.gen(this, function* () {
+      const key = typeof event === "string" ? event : eventKey(event);
+      log2("reset", {
+        key
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 359, S: this });
+      const modules = this._getActiveModulesByEvent(key);
+      const results = yield* Effect2.all(modules.map((module) => this._deactivateModule(module)), {
+        concurrency: "unbounded"
+      });
+      if (results.every((result) => result)) {
+        return yield* this.activate(key);
+      } else {
+        return false;
+      }
+    });
+  }
+  shutdown() {
+    return this._shutdownSemaphore.withPermits(1)(Effect2.gen(this, function* () {
+      yield* Ref.set(this._shuttingDown, true);
+      log2("shutdown", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 376, S: this });
+      yield* this._interruptInFlightActivations();
+      const activeIds = [
+        ...this._get(this._activeAtom)
+      ].reverse();
+      const allModules = this._get(this._modulesAtom);
+      const modulesToDeactivate = activeIds.map((id) => allModules.find((module) => module.id === id)).filter((module) => module != null);
+      for (const module of modulesToDeactivate) {
+        yield* this._deactivateModule(module);
+      }
+      this._set(this._eventsFiredAtom, []);
+      this._set(this._pendingResetAtom, []);
+      this._moduleMemoMap.clear();
+      yield* Ref.set(this._activatingEvents, []);
+      yield* Ref.set(this._activatingModules, []);
+      log2("shutdown complete", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 391, S: this });
+      return true;
+    }).pipe(Effect2.ensuring(Ref.set(this._shuttingDown, false))));
+  }
+  //
+  // State helpers
+  //
+  _get(atom) {
+    return this.registry.get(atom);
+  }
+  _set(atom, value) {
+    this.registry.set(atom, value);
+  }
+  _update(atom, updater) {
+    this._set(atom, updater(this._get(atom)));
+  }
+  _isShuttingDown() {
+    return Ref.get(this._shuttingDown);
+  }
+  _getPlugin(id) {
+    return this._get(this._pluginsAtom).find((plugin) => plugin.meta.id === id);
+  }
+  _getActiveModules() {
+    const active = this._get(this._activeAtom);
+    return this._get(this._modulesAtom).filter((module) => active.includes(module.id));
+  }
+  _getInactiveModules() {
+    const active = this._get(this._activeAtom);
+    return this._get(this._modulesAtom).filter((module) => !active.includes(module.id));
+  }
+  _getActiveModulesByEvent(key) {
+    return this._getActiveModules().filter((module) => getEvents(module.activatesOn).map(eventKey).includes(key));
+  }
+  _getInactiveModulesByEvent(key) {
+    return this._getInactiveModules().filter((module) => getEvents(module.activatesOn).map(eventKey).includes(key));
+  }
+  _setPendingResetByModule(module) {
+    const activationEvents = getEvents(module.activatesOn).map(eventKey).filter((key) => this._get(this._eventsFiredAtom).includes(key));
+    const pendingReset = Array.fromIterable(new Set(activationEvents)).filter((event) => {
+      const pending = this._get(this._pendingResetAtom);
+      return !pending.includes(event);
+    });
+    if (pendingReset.length > 0) {
+      log2("pending reset", {
+        events: pendingReset
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 434, S: this });
+      this._update(this._pendingResetAtom, (current) => [
+        ...current,
+        ...pendingReset
+      ]);
+    }
+  }
+  _clearPendingReset(key) {
+    const pendingIndex = this._get(this._pendingResetAtom).findIndex((event) => event === key);
+    if (pendingIndex !== -1) {
+      this._update(this._pendingResetAtom, (pending) => pending.filter((event) => event !== key));
+    }
+  }
+  //
+  // Fiber helpers
+  //
+  _interruptInFlightActivations() {
+    return Effect2.gen(this, function* () {
+      const inFlightFibers = yield* Ref.get(this._inFlightFibers);
+      yield* Effect2.forEach(inFlightFibers, (fiber) => Fiber.interrupt(fiber), {
+        concurrency: "unbounded"
+      });
+    });
+  }
+  _trackFiber(ref, fiber) {
+    return Ref.update(ref, (fibers) => [
+      ...fibers,
+      fiber
+    ]);
+  }
+  _untrackFiber(ref, fiber) {
+    return Ref.update(ref, (fibers) => fibers.filter((trackedFiber) => trackedFiber !== fiber));
+  }
+  /**
+  * Spawns an effect on the default runtime and registers the resulting fiber in
+  * `_inFlightFibers` so {@link shutdown} can interrupt it. Used from sync entry
+  * points like {@link remove} where there is no enclosing Effect to fork from;
+  * inside an Effect chain prefer the existing track/await/untrack pattern.
+  */
+  _runForkedFiber(effect) {
+    const fiber = Effect2.runFork(effect);
+    Effect2.runSync(this._trackFiber(this._inFlightFibers, fiber));
+    Effect2.runFork(Fiber.await(fiber).pipe(Effect2.andThen(() => this._untrackFiber(this._inFlightFibers, fiber))));
+  }
+  //
+  // Registration helpers
+  //
+  _addPlugin(plugin) {
+    log2("add plugin", {
+      id: plugin.meta.id
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 483, S: this });
+    this._update(this._pluginsAtom, (plugins) => plugins.includes(plugin) ? plugins : [
+      ...plugins,
+      plugin
+    ]);
+  }
+  _removePlugin(id) {
+    log2("remove plugin", {
+      id
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 493, S: this });
+    this._update(this._pluginsAtom, (plugins) => plugins.filter((plugin) => plugin.meta.id !== id));
+  }
+  _addModule(module) {
+    log2("add module", {
+      id: module.id
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 499, S: this });
+    this._update(this._modulesAtom, (modules) => modules.includes(module) ? modules : [
+      ...modules,
+      module
+    ]);
+  }
+  _removeModule(id) {
+    log2("remove module", {
+      id
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 509, S: this });
+    this._update(this._modulesAtom, (modules) => modules.filter((module) => module.id !== id));
+  }
+  //
+  // Activation helpers
+  //
+  _activateEvent(key, params, fiber) {
+    return Effect2.gen(this, function* () {
+      yield* this._trackFiber(this._inFlightFibers, fiber);
+      log2("activating", {
+        key,
+        ...params
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 520, S: this });
+      yield* Ref.update(this._activatingEvents, (activating) => Array.append(activating, key));
+      this._clearPendingReset(key);
+      const activatingEvents = yield* this._activatingEvents;
+      const activatingModules = yield* this._activatingModules;
+      const modules = this._getModulesForActivation(key, activatingEvents, activatingModules);
+      if (modules.length === 0) {
+        log2("no modules to activate", {
+          key
+        }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 530, S: this });
+        if (!this._get(this._eventsFiredAtom).includes(key)) {
+          this._update(this._eventsFiredAtom, (events) => [
+            ...events,
+            key
+          ]);
+        }
+        return false;
+      }
+      return yield* this._activateModulesForEvent(key, modules, activatingEvents);
+    }).pipe(Effect2.ensuring(Effect2.all([
+      this._untrackFiber(this._inFlightFibers, fiber),
+      Ref.update(this._activatingEvents, (activating) => Array.filter(activating, (event) => event !== key))
+    ])));
+  }
+  _activateModulesForEvent(key, modules, activatingEvents) {
+    const activatingModuleIds = modules.map((module) => module.id);
+    return Effect2.gen(this, function* () {
+      yield* Ref.update(this._activatingModules, (activating) => Array.appendAll(activating, activatingModuleIds));
+      log2("activating modules", {
+        key,
+        modules: activatingModuleIds
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 551, S: this });
+      performance.mark(`event:${key}:start`);
+      yield* PubSub.publish(this.activation, {
+        event: key,
+        state: "activating"
+      });
+      yield* this._activateRelatedEvents(key, this._getBeforeEvents(modules, activatingEvents), "before");
+      const capabilities = yield* this._loadCapabilitiesForModules(key, modules);
+      yield* this._contributeCapabilitiesForModules(modules, capabilities);
+      yield* this._activateRelatedEvents(key, this._getAfterEvents(modules, activatingEvents), "after");
+      if (!this._get(this._eventsFiredAtom).includes(key)) {
+        this._update(this._eventsFiredAtom, (events) => [
+          ...events,
+          key
+        ]);
+      }
+      performance.mark(`event:${key}:end`);
+      performance.measure(`event:${key}`, `event:${key}:start`, `event:${key}:end`);
+      yield* PubSub.publish(this.activation, {
+        event: key,
+        state: "activated"
+      });
+      log2("activated", {
+        key
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 576, S: this });
+      return true;
+    }).pipe(Effect2.ensuring(Ref.update(this._activatingModules, (activating) => Array.filter(activating, (module) => !activatingModuleIds.includes(module)))));
+  }
+  _getModulesForActivation(key, activatingEvents, activatingModules) {
+    return this._getInactiveModulesByEvent(key).filter((module) => {
+      const allOf = isAllOf(module.activatesOn);
+      if (!allOf) {
+        return true;
+      }
+      const events = getEvents(module.activatesOn).filter((event) => eventKey(event) !== key);
+      return events.every((event) => this._get(this._eventsFiredAtom).includes(eventKey(event)) || activatingEvents.includes(eventKey(event))) && !activatingModules.includes(module.id);
+    });
+  }
+  _getBeforeEvents(modules, activatingEvents) {
+    return Function.pipe(modules, Array.flatMap((module) => module.firesBeforeActivation ?? []), HashSet.fromIterable, HashSet.toValues, Array.filter((event) => !activatingEvents.includes(eventKey(event))));
+  }
+  _getAfterEvents(modules, activatingEvents) {
+    return Function.pipe(modules, Array.flatMap((module) => module.firesAfterActivation ?? []), HashSet.fromIterable, HashSet.toValues, Array.filter((event) => !activatingEvents.includes(eventKey(event))));
+  }
+  _activateRelatedEvents(key, events, phase) {
+    const logLabel = phase === "before" ? "firesBeforeActivation" : "firesAfterActivation";
+    const eventKey2 = phase === "before" ? "beforeEvents" : "afterEvents";
+    return Function.pipe(events, Array.map((event) => this.activate(event, phase === "before" ? {
+      before: key
+    } : {
+      after: key
+    })), Effect2.allWith({
+      concurrency: "unbounded"
+    }), together(Effect2.sleep(Duration.seconds(10)).pipe(Effect2.andThen(Effect2.sync(() => log2.warn(`${logLabel} is taking a long time`, {
+      event: key,
+      [eventKey2]: events.map(eventKey)
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 609, S: this }))))), Effect2.asVoid);
+  }
+  //
+  // Module lifecycle helpers
+  //
+  _loadCapabilitiesForModules(key, modules) {
+    return Function.pipe(modules, Array.map((mod) => this._loadModule(mod, key)), Effect2.allWith({
+      concurrency: "unbounded"
+    }), Effect2.catchAll((error) => {
+      return Effect2.gen(this, function* () {
+        yield* PubSub.publish(this.activation, {
+          event: key,
+          state: "error",
+          error
+        });
+        return yield* Effect2.fail(error);
+      });
+    }));
+  }
+  _contributeCapabilitiesForModules(modules, capabilities) {
+    return Function.pipe(
+      modules,
+      Array.zip(capabilities),
+      Array.map(([module, capabilitySet]) => this._contributeCapabilities(module, capabilitySet)),
+      Effect2.all,
+      Effect2.asVoid
+    );
+  }
+  _getModuleSemaphore(moduleId) {
+    let semaphore = this._moduleSemaphores.get(moduleId);
+    if (!semaphore) {
+      semaphore = Effect2.runSync(Effect2.makeSemaphore(1));
+      this._moduleSemaphores.set(moduleId, semaphore);
+    }
+    return semaphore;
+  }
+  // `parentEvent` is the activation event that first triggered this module
+  // load — included in `activating`/`activated` PubSub messages so subscribers
+  // (e.g. the boot loader's status listener) can associate a module with its
+  // triggering event in the trace. The same module may be referenced by
+  // multiple events, but module loads are memoized via `_moduleMemoMap`, so
+  // only the first event to need it will appear here; later events await the
+  // cached deferred without re-publishing.
+  _loadModule = (module, parentEvent) => Effect2.gen(this, function* () {
+    const semaphore = this._getModuleSemaphore(module.id);
+    const deferredToAwait = yield* Effect2.gen(this, function* () {
+      const existing = this._moduleMemoMap.get(module.id);
+      if (existing) {
+        return existing;
+      }
+      const deferred = yield* Deferred2.make();
+      this._moduleMemoMap.set(module.id, deferred);
+      const loadEffect = Effect2.gen(this, function* () {
+        log2("loading module", {
+          module: module.id,
+          parentEvent
+        }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 667, S: this });
+        performance.mark(`module:${module.id}:start`);
+        yield* PubSub.publish(this.activation, {
+          event: parentEvent,
+          state: "activating",
+          module: module.id
+        });
+        const [duration, capabilities] = yield* module.activate().pipe(Effect2.provideService(Service, this.capabilities), Effect2.provideService(Service2, this), Effect2.timed);
+        const normalized = capabilities == null ? [] : Array.isArray(capabilities) ? capabilities : [
+          capabilities
+        ];
+        const elapsed = Duration.toMillis(duration);
+        performance.mark(`module:${module.id}:end`);
+        performance.measure(`module:${module.id}`, `module:${module.id}:start`, `module:${module.id}:end`);
+        yield* PubSub.publish(this.activation, {
+          event: parentEvent,
+          state: "activated",
+          module: module.id
+        });
+        log2("loaded module", {
+          module: module.id,
+          parentEvent,
+          elapsed,
+          failed: false
+        }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 689, S: this });
+        return normalized;
+      }).pipe(Effect2.withSpan("PluginManager._loadModule"), together(Effect2.sleep(Duration.seconds(10)).pipe(Effect2.andThen(Effect2.sync(() => log2.warn(`module is taking a long time to activate`, {
+        module: module.id
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 696, S: this }))))), Performance.addTrackEntry({
+        name: module.id,
+        devtools: {
+          dataType: "track-entry",
+          track: "Module Activation",
+          trackGroup: "Composer",
+          color: "primary"
+        }
+      }));
+      const fiber = yield* Effect2.forkDaemon(loadEffect.pipe(Effect2.tap((result) => Deferred2.succeed(deferred, result)), Effect2.catchAllCause((cause) => {
+        const error = Cause.squash(cause);
+        log2.error("module failed to activate", {
+          module: module.id,
+          error: error instanceof Error ? error.message : String(error),
+          stack: error instanceof Error ? error.stack : void 0,
+          isDefect: !Cause.isFailure(cause)
+        }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 710, S: this });
+        return Deferred2.fail(deferred, error instanceof Error ? error : new Error(String(error)));
+      })));
+      yield* this._trackFiber(this._inFlightFibers, fiber);
+      yield* Effect2.forkDaemon(Fiber.await(fiber).pipe(Effect2.andThen(() => this._untrackFiber(this._inFlightFibers, fiber))));
+      return deferred;
+    }).pipe(semaphore.withPermits(1));
+    return yield* Deferred2.await(deferredToAwait);
+  });
+  _contributeCapabilities(module, capabilities) {
+    return Effect2.gen(this, function* () {
+      capabilities.forEach((capability) => {
+        this.capabilities.contribute({
+          module: module.id,
+          ...capability
+        });
+      });
+      this._update(this._activeAtom, (active) => [
+        ...active,
+        module.id
+      ]);
+      this._capabilities.set(module.id, capabilities);
+    });
+  }
+  _deactivateModule(module) {
+    return Effect2.gen(this, function* () {
+      const id = module.id;
+      log2("deactivating", {
+        id
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 743, S: this });
+      this._moduleMemoMap.delete(id);
+      const capabilities = this._capabilities.get(id);
+      if (capabilities) {
+        for (const capability of capabilities) {
+          this.capabilities.remove(capability.interface, capability.implementation);
+          const program = capability.deactivate?.() ?? Effect2.succeed(void 0);
+          yield* program;
+        }
+        this._capabilities.delete(id);
+      }
+      const activeIndex = this._get(this._activeAtom).findIndex((event) => event === id);
+      if (activeIndex !== -1) {
+        this._update(this._activeAtom, (active) => active.filter((event) => event !== id));
+      }
+      log2("deactivated", {
+        id
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 760, S: this });
+      return true;
+    });
+  }
+};
+var make5 = (options) => new ManagerImpl(options);
+var together = (togetherEffect) => (effect) => Effect2.gen(function* () {
+  const togetherFiber = yield* Effect2.fork(togetherEffect);
+  const result = yield* effect;
+  yield* Fiber.interrupt(togetherFiber);
+  return result;
+});
+
+export {
+  capability_manager_exports,
+  PluginInitializationError,
+  ManagerTypeId,
+  isManager,
+  make5 as make,
+  plugin_manager_exports
+};
+//# sourceMappingURL=chunk-Q7XBFII4.mjs.map