@dxos/app-framework 0.8.4-main.72ec0f3 → 0.8.4-main.74a063c4e0

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

@@ -1,25 +1,78 @@
 import {
   useApp
-} from "../chunk-VFUKEZIN.mjs";
+} from "../chunk-WPE6AL7I.mjs";
+import "../chunk-TGX63LTL.mjs";
+import "../chunk-T3Y4AEKX.mjs";
 import {
-  Capabilities,
-  Events,
-  PluginManager,
-  contributes,
-  defineModule,
-  definePlugin
-} from "../chunk-WPW5VVAX.mjs";
+  capabilities_exports
+} from "../chunk-JKWMHZP6.mjs";
+import {
+  activation_events_exports
+} from "../chunk-I34GF4NG.mjs";
+import "../chunk-RFSO3JRG.mjs";
+import "../chunk-LVJW5EFU.mjs";
+import {
+  plugin_manager_exports
+} from "../chunk-GX4TUNM6.mjs";
+import "../chunk-QSXYHXCE.mjs";
+import {
+  plugin_exports
+} from "../chunk-FU4GAFUQ.mjs";
+import {
+  capability_exports
+} from "../chunk-2CKCJ6PN.mjs";
+import "../chunk-J5LGTIGS.mjs";
+
+// src/testing/service.ts
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+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* () {
+  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}`"
+      ]
+    });
+    return plugin;
+  });
+  const manager = plugin_manager_exports.make({
+    pluginLoader,
+    plugins,
+    core: plugins.map((plugin) => plugin.meta.id)
+  });
+  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"
+  });
+  yield* manager.activate(activation_events_exports.Startup);
+  return manager;
+}));
 
 // src/testing/withPluginManager.tsx
-import React, { useEffect, useMemo } from "react";
+import * as Effect2 from "effect/Effect";
+import React, { useEffect, useState } from "react";
 import { raise } from "@dxos/debug";
+import { runAndForwardErrors } 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 } = {}) => {
-  const pluginManager = new PluginManager({
+  const pluginManager = plugin_manager_exports.make({
     pluginLoader: () => raise(new Error("Not implemented")),
     plugins: [
-      StoryPlugin(),
+      StoryPlugin,
       ...plugins
     ],
     core: [
@@ -29,8 +82,8 @@ var setupPluginManager = ({ capabilities, plugins = [], core = plugins.map(({ me
     ...options
   });
   if (capabilities) {
-    getProviderValue(capabilities, pluginManager.context).forEach((capability) => {
-      pluginManager.context.contributeCapability({
+    getProviderValue(capabilities, pluginManager.capabilities).forEach((capability) => {
+      pluginManager.capabilities.contribute({
         interface: capability.interface,
         implementation: capability.implementation,
         module: "story"
@@ -41,49 +94,64 @@ var setupPluginManager = ({ capabilities, plugins = [], core = plugins.map(({ me
 };
 var withPluginManager = (init = {}) => {
   return (Story, context) => {
+    const storyId = context.id;
     const options = typeof init === "function" ? init(context) : init;
-    const pluginManager = useMemo(() => setupPluginManager(options), [
-      init
-    ]);
+    const [managerState, setManagerState] = useState();
     useEffect(() => {
-      const capability = contributes(Capabilities.ReactRoot, {
-        id: context.id,
+      const pluginManager = setupPluginManager(options);
+      const capability = capability_exports.contributes(capabilities_exports.ReactRoot, {
+        id: storyId,
         root: () => /* @__PURE__ */ React.createElement(Story, null)
       });
-      pluginManager.context.contributeCapability({
+      pluginManager.capabilities.contribute({
         ...capability,
-        module: "dxos.org/app-framework/withPluginManager"
+        module: "org.dxos.app-framework.with-plugin-manager"
+      });
+      setManagerState({
+        pluginManager,
+        setupEvents: options.setupEvents,
+        fireEvents: options.fireEvents,
+        storyId
       });
       return () => {
-        pluginManager.context.removeCapability(capability.interface, capability.implementation);
+        pluginManager.capabilities.remove(capability.interface, capability.implementation);
+        void runAndForwardErrors(pluginManager.shutdown());
       };
     }, [
-      pluginManager,
-      context
-    ]);
-    useAsyncEffect(async () => {
-      await Promise.all(options.fireEvents?.map((event) => pluginManager.activate(event)) ?? []);
-    }, [
-      pluginManager
+      storyId,
+      init
     ]);
-    const App = useApp({
-      pluginManager
-    });
-    return /* @__PURE__ */ React.createElement(App, null);
+    if (!managerState || managerState.storyId !== storyId) {
+      return /* @__PURE__ */ React.createElement(React.Fragment, null);
+    }
+    return /* @__PURE__ */ React.createElement(WithPluginManagerApp, managerState);
   };
 };
+var WithPluginManagerApp = ({ fireEvents, pluginManager, setupEvents, storyId }) => {
+  useAsyncEffect(async () => {
+    await Promise.all(fireEvents?.map((event) => pluginManager.activate(event)) ?? []);
+  }, [
+    fireEvents,
+    pluginManager,
+    storyId
+  ]);
+  const App = useApp({
+    pluginManager,
+    setupEvents
+  });
+  return /* @__PURE__ */ React.createElement(App, null);
+};
 var storyMeta = {
-  id: "dxos.org/app-framework/story",
+  id: "org.dxos.app-framework.story",
   name: "Story"
 };
-var StoryPlugin = definePlugin(storyMeta, () => [
-  defineModule({
-    id: storyMeta.id,
-    activatesOn: Events.Startup,
-    activate: () => []
-  })
-]);
+var StoryPlugin = plugin_exports.define(storyMeta).pipe(plugin_exports.addModule({
+  id: "Story",
+  activatesOn: activation_events_exports.Startup,
+  activate: () => Effect2.succeed([])
+}), plugin_exports.make)();
 export {
+  fromPlugins,
   setupPluginManager,
   withPluginManager
 };

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../../src/testing/withPluginManager.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Decorator, type StoryContext } from '@storybook/react';\nimport React, { useEffect, useMemo } from 'react';\n\nimport { raise } from '@dxos/debug';\nimport { useAsyncEffect } from '@dxos/react-hooks';\nimport { type MaybeProvider, getProviderValue } from '@dxos/util';\n\nimport { Capabilities, Events } from '../common';\nimport {\n  type ActivationEvent,\n  type AnyCapability,\n  type PluginContext,\n  PluginManager,\n  contributes,\n  defineModule,\n  definePlugin,\n} from '../core';\nimport { type UseAppOptions, useApp } from '../react';\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 = new PluginManager({\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.context).forEach((capability) => {\n      pluginManager.context.contributeCapability({\n        interface: capability.interface,\n        implementation: capability.implementation,\n        module: 'story',\n      });\n    });\n  }\n\n  return pluginManager;\n};\n\nexport type WithPluginManagerOptions = UseAppOptions & {\n  /** @deprecated */\n  capabilities?: MaybeProvider<AnyCapability[], PluginContext>;\n  /** @deprecated */\n  fireEvents?: (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 options = typeof init === 'function' ? init(context as any) : init;\n    const pluginManager = useMemo(() => setupPluginManager(options), [init]);\n\n    // Set-up root capability.\n    useEffect(() => {\n      const capability = contributes(Capabilities.ReactRoot, {\n        id: context.id,\n        root: () => <Story />,\n      });\n\n      pluginManager.context.contributeCapability({\n        ...capability,\n        module: 'dxos.org/app-framework/withPluginManager',\n      });\n\n      return () => {\n        pluginManager.context.removeCapability(capability.interface, capability.implementation);\n      };\n    }, [pluginManager, context]);\n\n    // Fire events.\n    useAsyncEffect(async () => {\n      await Promise.all(options.fireEvents?.map((event) => pluginManager.activate(event)) ?? []);\n    }, [pluginManager]);\n\n    // Create app.\n    const App = useApp({ pluginManager });\n\n    return <App />;\n  };\n};\n\nconst storyMeta = {\n  id: 'dxos.org/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 = definePlugin(storyMeta, () => [\n  defineModule({ id: storyMeta.id, activatesOn: Events.Startup, activate: () => [] }),\n]);\n"],
-  "mappings": ";;;;;;;;;;;;;AAKA,OAAOA,SAASC,WAAWC,eAAe;AAE1C,SAASC,aAAa;AACtB,SAASC,sBAAsB;AAC/B,SAA6BC,wBAAwB;AAiB9C,IAAMC,qBAAqB,CAAC,EACjCC,cACAC,UAAU,CAAA,GACVC,OAAOD,QAAQE,IAAI,CAAC,EAAEC,KAAI,MAAOA,KAAKC,EAAE,GACxC,GAAGC,QAAAA,IAC+D,CAAC,MAAC;AACpE,QAAMC,gBAAgB,IAAIC,cAAc;IACtCC,cAAc,MAAMC,MAAM,IAAIC,MAAM,iBAAA,CAAA;IACpCV,SAAS;MAACW,YAAAA;SAAkBX;;IAC5BC,MAAM;MAACU,YAAYR,KAAKC;SAAOH;;IAC/B,GAAGI;EACL,CAAA;AAEA,MAAIN,cAAc;AAChBa,qBAAiBb,cAAcO,cAAcO,OAAO,EAAEC,QAAQ,CAACC,eAAAA;AAC7DT,oBAAcO,QAAQG,qBAAqB;QACzCC,WAAWF,WAAWE;QACtBC,gBAAgBH,WAAWG;QAC3BC,QAAQ;MACV,CAAA;IACF,CAAA;EACF;AAEA,SAAOb;AACT;AAiBO,IAAMc,oBAAoB,CAAQC,OAA2C,CAAC,MAAC;AACpF,SAAO,CAACC,OAAOT,YAAAA;AACb,UAAMR,UAAU,OAAOgB,SAAS,aAAaA,KAAKR,OAAAA,IAAkBQ;AACpE,UAAMf,gBAAgBiB,QAAQ,MAAMzB,mBAAmBO,OAAAA,GAAU;MAACgB;KAAK;AAGvEG,cAAU,MAAA;AACR,YAAMT,aAAaU,YAAYC,aAAaC,WAAW;QACrDvB,IAAIS,QAAQT;QACZwB,MAAM,MAAM,sBAAA,cAACN,OAAAA,IAAAA;MACf,CAAA;AAEAhB,oBAAcO,QAAQG,qBAAqB;QACzC,GAAGD;QACHI,QAAQ;MACV,CAAA;AAEA,aAAO,MAAA;AACLb,sBAAcO,QAAQgB,iBAAiBd,WAAWE,WAAWF,WAAWG,cAAc;MACxF;IACF,GAAG;MAACZ;MAAeO;KAAQ;AAG3BiB,mBAAe,YAAA;AACb,YAAMC,QAAQC,IAAI3B,QAAQ4B,YAAY/B,IAAI,CAACgC,UAAU5B,cAAc6B,SAASD,KAAAA,CAAAA,KAAW,CAAA,CAAE;IAC3F,GAAG;MAAC5B;KAAc;AAGlB,UAAM8B,MAAMC,OAAO;MAAE/B;IAAc,CAAA;AAEnC,WAAO,sBAAA,cAAC8B,KAAAA,IAAAA;EACV;AACF;AAEA,IAAME,YAAY;EAChBlC,IAAI;EACJmC,MAAM;AACR;AAIA,IAAM5B,cAAc6B,aAAaF,WAAW,MAAM;EAChDG,aAAa;IAAErC,IAAIkC,UAAUlC;IAAIsC,aAAaC,OAAOC;IAAST,UAAU,MAAM,CAAA;EAAG,CAAA;CAClF;",
-  "names": ["React", "useEffect", "useMemo", "raise", "useAsyncEffect", "getProviderValue", "setupPluginManager", "capabilities", "plugins", "core", "map", "meta", "id", "options", "pluginManager", "PluginManager", "pluginLoader", "raise", "Error", "StoryPlugin", "getProviderValue", "context", "forEach", "capability", "contributeCapability", "interface", "implementation", "module", "withPluginManager", "init", "Story", "useMemo", "useEffect", "contributes", "Capabilities", "ReactRoot", "root", "removeCapability", "useAsyncEffect", "Promise", "all", "fireEvents", "event", "activate", "App", "useApp", "storyMeta", "name", "definePlugin", "defineModule", "activatesOn", "Events", "Startup"]
+  "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"]
 }

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

@@ -0,0 +1,44 @@
+import {
+  App,
+  LoadingState,
+  PluginManagerProvider,
+  Surface,
+  useApp,
+  useAtomCapability,
+  useAtomCapabilityState,
+  useCapabilities,
+  useCapability,
+  useLoading,
+  useOperationInvoker,
+  usePluginManager,
+  useSettingsState,
+  useSurface
+} from "../chunk-WPE6AL7I.mjs";
+import "../chunk-TGX63LTL.mjs";
+import "../chunk-T3Y4AEKX.mjs";
+import "../chunk-JKWMHZP6.mjs";
+import "../chunk-I34GF4NG.mjs";
+import "../chunk-RFSO3JRG.mjs";
+import "../chunk-LVJW5EFU.mjs";
+import "../chunk-GX4TUNM6.mjs";
+import "../chunk-QSXYHXCE.mjs";
+import "../chunk-FU4GAFUQ.mjs";
+import "../chunk-2CKCJ6PN.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  App,
+  LoadingState,
+  PluginManagerProvider,
+  Surface,
+  useApp,
+  useAtomCapability,
+  useAtomCapabilityState,
+  useCapabilities,
+  useCapability,
+  useLoading,
+  useOperationInvoker,
+  usePluginManager,
+  useSettingsState,
+  useSurface
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/lib/node-esm/capability-AWBEMRYR.mjs

@@ -0,0 +1,39 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import "./chunk-VKHGNEDB.mjs";
+import {
+  capabilities_exports
+} from "./chunk-G3RTFSNG.mjs";
+import {
+  activation_events_exports
+} from "./chunk-WZCSOX5Q.mjs";
+import "./chunk-EL3R25OQ.mjs";
+import "./chunk-4A3ZCMI3.mjs";
+import "./chunk-BCEOLX47.mjs";
+import "./chunk-ZZ7CKK6W.mjs";
+import {
+  plugin_exports
+} from "./chunk-ULUEXB7Q.mjs";
+import {
+  capability_exports
+} from "./chunk-42KBWDE4.mjs";
+import "./chunk-HSLMI22Q.mjs";
+
+// src/plugin-runtime/capability.ts
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as ManagedRuntime from "effect/ManagedRuntime";
+var capability_default = capability_exports.makeModule(Effect.fnUntraced(function* () {
+  const capabilityManager = yield* capability_exports.Service;
+  const pluginManager = yield* plugin_exports.Service;
+  yield* plugin_exports.activate(activation_events_exports.SetupLayer);
+  const layers = yield* capability_exports.getAll(capabilities_exports.Layer);
+  const capabilityServiceLayer = Layer.succeed(capability_exports.Service, capabilityManager);
+  const pluginServiceLayer = Layer.succeed(plugin_exports.Service, pluginManager);
+  const composedLayer = layers.length > 0 ? Layer.mergeAll(capabilityServiceLayer, pluginServiceLayer, ...layers) : Layer.mergeAll(capabilityServiceLayer, pluginServiceLayer);
+  const runtime = ManagedRuntime.make(composedLayer);
+  return capability_exports.contributes(capabilities_exports.ManagedRuntime, runtime);
+}));
+export {
+  capability_default as default
+};
+//# sourceMappingURL=capability-AWBEMRYR.mjs.map

package/dist/lib/node-esm/capability-AWBEMRYR.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugin-runtime/capability.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\nimport * as ManagedRuntime from 'effect/ManagedRuntime';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { Capability, Plugin } from '../core';\n\n//\n// Capability Module\n//\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Get the CapabilityManager to create a layer for it.\n    const capabilityManager = yield* Capability.Service;\n\n    // Get the PluginManager to create a layer for it.\n    const pluginManager = yield* Plugin.Service;\n\n    // Trigger setup event so plugins can contribute their layers.\n    yield* Plugin.activate(ActivationEvents.SetupLayer);\n\n    // Gather all contributed layers.\n    const layers = yield* Capability.getAll(Capabilities.Layer);\n\n    // Create layers that provide Capability.Service and Plugin.Service.\n    const capabilityServiceLayer = Layer.succeed(Capability.Service, capabilityManager);\n    const pluginServiceLayer = Layer.succeed(Plugin.Service, pluginManager);\n\n    // Merge all layers including service layers.\n    // Layer.mergeAll requires a tuple type, so we use a cast for dynamic arrays.\n    const composedLayer =\n      layers.length > 0\n        ? (Layer.mergeAll as (...args: Layer.Layer<any, any, any>[]) => Layer.Layer<any, any, never>)(\n            capabilityServiceLayer,\n            pluginServiceLayer,\n            ...layers,\n          )\n        : (Layer.mergeAll as (...args: Layer.Layer<any, any, any>[]) => Layer.Layer<any, any, never>)(\n            capabilityServiceLayer,\n            pluginServiceLayer,\n          );\n\n    // Create the managed runtime from the composed layer.\n    const runtime = ManagedRuntime.make(composedLayer) as Capabilities.ManagedRuntime;\n\n    return Capability.contributes(Capabilities.ManagedRuntime, runtime);\n  }),\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAIA,YAAYA,YAAY;AACxB,YAAYC,WAAW;AACvB,YAAYC,oBAAoB;AAShC,IAAA,qBAAeC,mBAAWC,WACjBC,kBAAW,aAAA;AAEhB,QAAMC,oBAAoB,OAAOH,mBAAWI;AAG5C,QAAMC,gBAAgB,OAAOC,eAAOF;AAGpC,SAAOE,eAAOC,SAASC,0BAAiBC,UAAU;AAGlD,QAAMC,SAAS,OAAOV,mBAAWW,OAAOC,qBAAaC,KAAK;AAG1D,QAAMC,yBAA+BC,cAAQf,mBAAWI,SAASD,iBAAAA;AACjE,QAAMa,qBAA2BD,cAAQT,eAAOF,SAASC,aAAAA;AAIzD,QAAMY,gBACJP,OAAOQ,SAAS,IACLC,eACLL,wBACAE,oBAAAA,GACGN,MAAAA,IAEES,eACLL,wBACAE,kBAAAA;AAIR,QAAMI,UAAyBC,oBAAKJ,aAAAA;AAEpC,SAAOjB,mBAAWsB,YAAYV,qBAAaW,gBAAgBH,OAAAA;AAC7D,CAAA,CAAA;",
+  "names": ["Effect", "Layer", "ManagedRuntime", "Capability", "makeModule", "fnUntraced", "capabilityManager", "Service", "pluginManager", "Plugin", "activate", "ActivationEvents", "SetupLayer", "layers", "getAll", "Capabilities", "Layer", "capabilityServiceLayer", "succeed", "pluginServiceLayer", "composedLayer", "length", "mergeAll", "runtime", "make", "contributes", "ManagedRuntime"]
+}

package/dist/lib/node-esm/capability-WFEG6CIZ.mjs

@@ -0,0 +1,36 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  make,
+  make2
+} from "./chunk-URWHJQT2.mjs";
+import "./chunk-VKHGNEDB.mjs";
+import {
+  capabilities_exports
+} from "./chunk-G3RTFSNG.mjs";
+import "./chunk-WZCSOX5Q.mjs";
+import "./chunk-EL3R25OQ.mjs";
+import "./chunk-4A3ZCMI3.mjs";
+import "./chunk-BCEOLX47.mjs";
+import "./chunk-ZZ7CKK6W.mjs";
+import "./chunk-ULUEXB7Q.mjs";
+import {
+  capability_exports
+} from "./chunk-42KBWDE4.mjs";
+import "./chunk-HSLMI22Q.mjs";
+
+// src/plugin-operation/history/capability.ts
+import * as Effect from "effect/Effect";
+var capability_default = capability_exports.makeModule(Effect.fnUntraced(function* () {
+  const capabilities = yield* capability_exports.Service;
+  const undoRegistry = make(() => capabilities.getAll(capabilities_exports.UndoMapping).flat());
+  const invoker = yield* capability_exports.get(capabilities_exports.OperationInvoker);
+  const historyTracker = make2(invoker, undoRegistry);
+  return [
+    capability_exports.contributes(capabilities_exports.UndoRegistry, undoRegistry),
+    capability_exports.contributes(capabilities_exports.HistoryTracker, historyTracker)
+  ];
+}));
+export {
+  capability_default as default
+};
+//# sourceMappingURL=capability-WFEG6CIZ.mjs.map

package/dist/lib/node-esm/capability-WFEG6CIZ.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugin-operation/history/capability.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { type OperationInvoker } from '@dxos/operation';\n\nimport { Capabilities } from '../../common';\nimport { Capability } from '../../core';\nimport * as HistoryTracker from './history-tracker';\nimport * as UndoRegistry from './undo-registry';\n\n//\n// Capability Module - contributes both UndoRegistry and HistoryTracker.\n//\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Get the context for synchronous access in callbacks.\n    const capabilities = yield* Capability.Service;\n\n    // Create UndoRegistry.\n    const undoRegistry = UndoRegistry.make(() => capabilities.getAll(Capabilities.UndoMapping).flat());\n\n    // Create HistoryTracker (depends on UndoRegistry and OperationInvoker).\n    const invoker = yield* Capability.get(Capabilities.OperationInvoker);\n    // Cast to internal type - the factory always returns OperationInvokerInternal.\n    const historyTracker = HistoryTracker.make(invoker as OperationInvoker.OperationInvokerInternal, undoRegistry);\n\n    return [\n      Capability.contributes(Capabilities.UndoRegistry, undoRegistry),\n      Capability.contributes(Capabilities.HistoryTracker, historyTracker),\n    ];\n  }),\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAIA,YAAYA,YAAY;AAaxB,IAAA,qBAAeC,mBAAWC,WACjBC,kBAAW,aAAA;AAEhB,QAAMC,eAAe,OAAOH,mBAAWI;AAGvC,QAAMC,eAA4BC,KAAK,MAAMH,aAAaI,OAAOC,qBAAaC,WAAW,EAAEC,KAAI,CAAA;AAG/F,QAAMC,UAAU,OAAOX,mBAAWY,IAAIJ,qBAAaK,gBAAgB;AAEnE,QAAMC,iBAAgCR,MAAKK,SAAsDN,YAAAA;AAEjG,SAAO;IACLL,mBAAWe,YAAYP,qBAAaQ,cAAcX,YAAAA;IAClDL,mBAAWe,YAAYP,qBAAaS,gBAAgBH,cAAAA;;AAExD,CAAA,CAAA;",
+  "names": ["Effect", "Capability", "makeModule", "fnUntraced", "capabilities", "Service", "undoRegistry", "make", "getAll", "Capabilities", "UndoMapping", "flat", "invoker", "get", "OperationInvoker", "historyTracker", "contributes", "UndoRegistry", "HistoryTracker"]
+}

package/dist/lib/node-esm/chunk-42KBWDE4.mjs

@@ -0,0 +1,80 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  __export
+} from "./chunk-HSLMI22Q.mjs";
+
+// src/core/capability.ts
+var capability_exports = {};
+__export(capability_exports, {
+  ModuleTag: () => ModuleTag,
+  Service: () => Service,
+  atom: () => atom,
+  atomByModule: () => atomByModule,
+  contributes: () => contributes,
+  get: () => get,
+  getAll: () => getAll,
+  getModuleTag: () => getModuleTag,
+  lazy: () => lazy,
+  make: () => make,
+  makeModule: () => makeModule,
+  waitFor: () => waitFor
+});
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+var Service = class extends Context.Tag("@dxos/app-framework/CapabilityManager")() {
+};
+var get = (interfaceDef) => Effect.flatMap(Service, (manager) => Effect.try({
+  try: () => manager.get(interfaceDef),
+  catch: (error) => error instanceof Error ? error : new Error(String(error))
+}));
+var getAll = (interfaceDef) => Effect.map(Service, (manager) => manager.getAll(interfaceDef));
+var waitFor = (interfaceDef) => Effect.flatMap(Service, (manager) => manager.waitFor(interfaceDef));
+var atom = (interfaceDef) => Effect.map(Service, (manager) => manager.atom(interfaceDef));
+var atomByModule = (interfaceDef) => Effect.map(Service, (manager) => manager.atomByModule(interfaceDef));
+var ModuleTag = /* @__PURE__ */ Symbol.for("@dxos/app-framework/ModuleTag");
+var make = (identifier) => {
+  return {
+    identifier
+  };
+};
+var contributes = (interfaceDef, implementation, deactivate) => {
+  return {
+    interface: interfaceDef,
+    implementation,
+    deactivate
+  };
+};
+var lazy = (name, c) => {
+  const lazyFn = (props) => Effect.gen(function* () {
+    const { default: getCapability } = yield* Effect.promise(() => c());
+    const result = yield* getCapability(props);
+    const normalized = result == null ? [] : Array.isArray(result) ? Array.from(result) : [
+      result
+    ];
+    return normalized;
+  });
+  return Object.assign(lazyFn, {
+    [ModuleTag]: name
+  });
+};
+var getModuleTag = (capability) => {
+  return capability && typeof capability === "function" && ModuleTag in capability ? String(capability[ModuleTag]) : void 0;
+};
+var makeModule = (fn) => fn;
+
+export {
+  Service,
+  get,
+  getAll,
+  waitFor,
+  atom,
+  atomByModule,
+  ModuleTag,
+  make,
+  contributes,
+  lazy,
+  getModuleTag,
+  makeModule,
+  capability_exports
+};
+//# sourceMappingURL=chunk-42KBWDE4.mjs.map

package/dist/lib/node-esm/chunk-42KBWDE4.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/capability.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom } from '@effect-atom/atom-react';\nimport * as Context from 'effect/Context';\nimport * as Effect from 'effect/Effect';\n\nimport type * as CapabilityManager from './capability-manager';\nimport type * as Plugin from './plugin';\n\n//\n// Capability Service Layer\n//\n\n/**\n * Effect Context.Tag for accessing CapabilityManager via the Effect layer system.\n * This allows capability modules to access the capability manager without having it passed as an argument.\n */\nexport class Service extends Context.Tag('@dxos/app-framework/CapabilityManager')<\n  Service,\n  CapabilityManager.CapabilityManager\n>() {}\n\n/**\n * Get a single capability from the capability manager.\n * @param interfaceDef The interface definition of the capability.\n * @returns The capability implementation.\n * @throws If no capability is found.\n */\n// TODO(wittjosiah): Add custom tagged errors (Data.TaggedError) for app-framework to enable\n//   type-safe error handling with Effect. Consider CapabilityNotFoundError, ModuleActivationError, etc.\nexport const get = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T, Error, Service> =>\n  Effect.flatMap(Service, (manager) =>\n    Effect.try({\n      try: () => manager.get(interfaceDef),\n      catch: (error) => (error instanceof Error ? error : new Error(String(error))),\n    }),\n  );\n\n/**\n * Get all capabilities from the capability manager for a given interface.\n * @param interfaceDef The interface definition of the capability.\n * @returns An array of capability implementations.\n */\nexport const getAll = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T[], never, Service> =>\n  Effect.map(Service, (manager) => manager.getAll(interfaceDef));\n\n/**\n * Wait for a capability to be available.\n * @param interfaceDef The interface definition of the capability.\n * @returns The capability implementation once available.\n */\nexport const waitFor = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T, Error, Service> =>\n  Effect.flatMap(Service, (manager) => manager.waitFor(interfaceDef));\n\n/**\n * Get the Atom reference to capabilities for reactive access.\n * @param interfaceDef The interface definition of the capability.\n * @returns An Atom containing the array of capability implementations.\n */\nexport const atom = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<Atom.Atom<T[]>, never, Service> =>\n  Effect.map(Service, (manager) => manager.atom(interfaceDef));\n\n/**\n * Get capabilities grouped by the module that contributed them.\n * @param interfaceDef The interface definition of the capability.\n * @returns An Atom containing a record from module ID to capability implementations.\n */\nexport const atomByModule = <T>(\n  interfaceDef: InterfaceDef<T>,\n): Effect.Effect<Atom.Atom<Record<string, T[]>>, never, Service> =>\n  Effect.map(Service, (manager) => manager.atomByModule(interfaceDef));\n\nconst InterfaceDefTypeId: unique symbol = Symbol.for('InterfaceDefTypeId');\n\n/**\n * Symbol used to tag lazy capability functions with their module ID.\n */\nexport const ModuleTag: unique symbol = Symbol.for('@dxos/app-framework/ModuleTag');\n\n/**\n * The interface definition of a capability.\n */\nexport type InterfaceDef<T> = {\n  [InterfaceDefTypeId]: T;\n  identifier: string;\n};\n\nexport namespace InterfaceDef {\n  export type Implementation<I extends InterfaceDef<any>> = I extends InterfaceDef<infer T> ? T : never;\n}\n\n/**\n * Helper to define the interface of a capability.\n */\nexport const make = <T>(identifier: string) => {\n  return { identifier } as InterfaceDef<T>;\n};\n\n/**\n * A unique string identifier with a Typescript type associated with it.\n * When a capability is contributed to the application an implementation of the interface is provided.\n */\nexport type Capability<T> = {\n  /**\n   * The interface definition of the capability.\n   */\n  readonly interface: InterfaceDef<T>;\n\n  /**\n   * The implementation of the capability.\n   */\n  readonly implementation: T;\n\n  /**\n   * Called when the capability is deactivated.\n   */\n  readonly deactivate?: () => Effect.Effect<void, Error>;\n};\n\nexport type Any = Capability<any>;\n\n/**\n * Union type representing all valid return types for a capability module.\n * Supports single capabilities, arrays, and tuples of different capability types.\n */\nexport type ModuleReturn = void | Any | Any[] | readonly Any[] | [Any, ...Any[]] | readonly [Any, ...Any[]];\n\n/**\n * Helper to define the implementation of a capability.\n */\n// TODO(dmaretskyi): Make the return type non-generic so capabilities are non-discernable.\nexport const contributes = <I extends InterfaceDef<any>>(\n  interfaceDef: I,\n  implementation: Capability<InterfaceDef.Implementation<I>>['implementation'],\n  deactivate?: Capability<InterfaceDef.Implementation<I>>['deactivate'],\n): Capability<I> => {\n  return {\n    interface: interfaceDef,\n    implementation,\n    deactivate,\n  } satisfies Capability<I>;\n};\n\ntype LoadCapability<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{\n  default: (props: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;\n}>;\ntype LoadCapabilities<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{\n  default: (props: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;\n}>;\n\ntype NormalizeReturn<R> = R extends readonly (infer A)[]\n  ? A[]\n  : R extends (infer A)[]\n    ? A[]\n    : R extends Any\n      ? [R]\n      : Any[];\n\nexport type LazyCapability<Props = void, Capabilities extends ModuleReturn = ModuleReturn, E extends Error = Error> = (\n  props: Props,\n) => Effect.Effect<NormalizeReturn<Capabilities>, E, Service | Plugin.Service | never>;\n\n/**\n * Helper to define a lazily loaded implementation of a capability.\n * Supports single capabilities, arrays, and tuples of different capability types.\n * @param name The export name (e.g., 'AppGraphBuilder') - used to auto-compute module IDs.\n * @param loader The lazy loader function.\n * @returns A lazy capability function with ModuleTag symbol attached.\n */\nexport const lazy = <T = void, R extends ModuleReturn = ModuleReturn>(\n  name: string,\n  c: LoadCapability<T, R> | LoadCapabilities<T, R>,\n): LazyCapability<T, R> => {\n  const lazyFn: LazyCapability<T, R> = (props: T) =>\n    Effect.gen(function* () {\n      const { default: getCapability } = yield* Effect.promise(() => c());\n      const result = yield* getCapability(props);\n      const normalized = result == null ? [] : Array.isArray(result) ? Array.from(result) : [result];\n      return normalized as NormalizeReturn<R>;\n    });\n\n  return Object.assign(lazyFn, { [ModuleTag]: name });\n};\n\n/**\n * Gets the module tag (export name) from a lazy capability function.\n * @param capability The lazy capability function.\n * @returns The module tag if present, undefined otherwise.\n */\n// TODO(wittjosiah): Stricter type for capability.\nexport const getModuleTag = (capability: unknown): string | undefined => {\n  return capability && typeof capability === 'function' && ModuleTag in capability\n    ? String(capability[ModuleTag])\n    : undefined;\n};\n\n/**\n * Helper to define a capability module with explicit typing.\n * Wraps the default export function to provide better type inference and make the pattern explicit.\n *\n * This helper provides explicit typing for the module activation function,\n * making it clear that the function should:\n * - Access CapabilityManager via the Effect layer system (Capability.get, Capability.getAll, etc.)\n * - Return a capability, array of capabilities, or tuple of different capability types (sync or async)\n *\n * Supports returning multiple capabilities of different types as a tuple, which will be normalized\n * to an array at runtime for compatibility with the plugin system.\n *\n * @example\n * ```ts\n * // Module without options - single capability\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* () {\n *     const client = yield* Capability.get(ClientCapabilities.Client);\n *     return contributes(Capabilities.SettingsStore, store);\n *   })\n * );\n *\n * // Module with multiple capabilities\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* () {\n *     return [\n *       contributes(Capabilities.SettingsStore, store),\n *       contributes(Capabilities.Translations, translations),\n *     ];\n *   })\n * );\n *\n * // Module with required options (context accessed via layer)\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* (props: { observability: boolean }) {\n *     const invoker = yield* Capability.get(Capabilities.OperationInvoker);\n *     return contributes(Capabilities.IntentResolver, ...);\n *   })\n * );\n * ```\n */\nexport const makeModule = <\n  TProps = void,\n  TReturn extends ModuleReturn = ModuleReturn,\n  E extends Error = Error,\n  R extends Service | Plugin.Service | never = Service,\n>(\n  fn: (props: TProps) => Effect.Effect<TReturn, E, R>,\n): ((props: TProps) => Effect.Effect<TReturn, E, R>) => fn;\n"],
+  "mappings": ";;;;;;AAAA;;;;;;;;;;;;;;;AAKA,YAAYA,aAAa;AACzB,YAAYC,YAAY;AAajB,IAAMC,UAAN,cAA8BC,YAAI,uCAAA,EAAA,EAAA;AAGpC;AAUE,IAAMC,MAAM,CAAIC,iBACdC,eAAQJ,SAAS,CAACK,YAChBC,WAAI;EACTA,KAAK,MAAMD,QAAQH,IAAIC,YAAAA;EACvBI,OAAO,CAACC,UAAWA,iBAAiBC,QAAQD,QAAQ,IAAIC,MAAMC,OAAOF,KAAAA,CAAAA;AACvE,CAAA,CAAA;AAQG,IAAMG,SAAS,CAAIR,iBACjBS,WAAIZ,SAAS,CAACK,YAAYA,QAAQM,OAAOR,YAAAA,CAAAA;AAO3C,IAAMU,UAAU,CAAIV,iBAClBC,eAAQJ,SAAS,CAACK,YAAYA,QAAQQ,QAAQV,YAAAA,CAAAA;AAOhD,IAAMW,OAAO,CAAIX,iBACfS,WAAIZ,SAAS,CAACK,YAAYA,QAAQS,KAAKX,YAAAA,CAAAA;AAOzC,IAAMY,eAAe,CAC1BZ,iBAEOS,WAAIZ,SAAS,CAACK,YAAYA,QAAQU,aAAaZ,YAAAA,CAAAA;AAOjD,IAAMa,YAA2BC,uBAAOC,IAAI,+BAAA;AAiB5C,IAAMC,OAAO,CAAIC,eAAAA;AACtB,SAAO;IAAEA;EAAW;AACtB;AAmCO,IAAMC,cAAc,CACzBC,cACAC,gBACAC,eAAAA;AAEA,SAAO;IACLC,WAAWH;IACXC;IACAC;EACF;AACF;AA4BO,IAAME,OAAO,CAClBC,MACAC,MAAAA;AAEA,QAAMC,SAA+B,CAACC,UAC7BC,WAAI,aAAA;AACT,UAAM,EAAEC,SAASC,cAAa,IAAK,OAAcC,eAAQ,MAAMN,EAAAA,CAAAA;AAC/D,UAAMO,SAAS,OAAOF,cAAcH,KAAAA;AACpC,UAAMM,aAAaD,UAAU,OAAO,CAAA,IAAKE,MAAMC,QAAQH,MAAAA,IAAUE,MAAME,KAAKJ,MAAAA,IAAU;MAACA;;AACvF,WAAOC;EACT,CAAA;AAEF,SAAOI,OAAOC,OAAOZ,QAAQ;IAAE,CAACb,SAAAA,GAAYW;EAAK,CAAA;AACnD;AAQO,IAAMe,eAAe,CAACC,eAAAA;AAC3B,SAAOA,cAAc,OAAOA,eAAe,cAAc3B,aAAa2B,aAClEC,OAAOD,WAAW3B,SAAAA,CAAU,IAC5B6B;AACN;AA2CO,IAAMC,aAAa,CAMxBC,OACsDA;",
+  "names": ["Context", "Effect", "Service", "Tag", "get", "interfaceDef", "flatMap", "manager", "try", "catch", "error", "Error", "String", "getAll", "map", "waitFor", "atom", "atomByModule", "ModuleTag", "Symbol", "for", "make", "identifier", "contributes", "interfaceDef", "implementation", "deactivate", "interface", "lazy", "name", "c", "lazyFn", "props", "gen", "default", "getCapability", "promise", "result", "normalized", "Array", "isArray", "from", "Object", "assign", "getModuleTag", "capability", "String", "undefined", "makeModule", "fn"]
+}