@dxos/app-framework 0.8.4-main.d05539e30a → 0.8.4-main.d9fc60f731

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "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"]
+  "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 { DXN } from '@dxos/keys';\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 = Plugin.makeMeta({\n  key: DXN.make('org.dxos.appFramework.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", "DXN", "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", "Plugin", "makeMeta", "key", "DXN", "name", "define", "pipe", "addModule", "activatesOn", "ActivationEvents", "Startup", "succeed"]
 }

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

@@ -2,20 +2,20 @@ import {
   PluginManagerProvider,
   SurfaceComponent,
   topologicalSort
-} from "../chunk-QLML5QFJ.mjs";
+} from "../chunk-7MBI66M7.mjs";
 import {
   PluginManagerContext
 } from "../chunk-FJ4765WW.mjs";
-import "../chunk-KFDF7KR3.mjs";
+import "../chunk-Q2GLJTVV.mjs";
 import {
   capabilities_exports
-} from "../chunk-5AHASNDW.mjs";
+} from "../chunk-2ZIYRDAF.mjs";
 import "../chunk-5GY3YOEL.mjs";
 import "../chunk-FO3IYSLV.mjs";
-import "../chunk-KLHQNYJ2.mjs";
-import "../chunk-VJ5PFAWC.mjs";
+import "../chunk-KZUDO43J.mjs";
+import "../chunk-BMLCIFZW.mjs";
 import "../chunk-66IXTIVK.mjs";
-import "../chunk-SLX73WRZ.mjs";
+import "../chunk-DC3WRPBV.mjs";
 import "../chunk-IW44C7UL.mjs";
 import "../chunk-J5LGTIGS.mjs";
 

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

@@ -1,7 +1,6 @@
 import {
   App,
   LoadingState,
-  Placeholder,
   useApp,
   useAtomCapability,
   useAtomCapabilityState,
@@ -13,28 +12,27 @@ import {
   useSettingsState,
   useSpaceCallback,
   useSpaceService
-} from "../chunk-UVTGHZQF.mjs";
+} from "../chunk-VBG5F5UF.mjs";
 import {
   PluginManagerProvider,
   Surface,
   usePluginManager,
   useSurface
-} from "../chunk-QLML5QFJ.mjs";
+} from "../chunk-7MBI66M7.mjs";
 import "../chunk-FJ4765WW.mjs";
-import "../chunk-KFDF7KR3.mjs";
-import "../chunk-5AHASNDW.mjs";
+import "../chunk-Q2GLJTVV.mjs";
+import "../chunk-2ZIYRDAF.mjs";
 import "../chunk-5GY3YOEL.mjs";
 import "../chunk-FO3IYSLV.mjs";
-import "../chunk-KLHQNYJ2.mjs";
-import "../chunk-VJ5PFAWC.mjs";
+import "../chunk-KZUDO43J.mjs";
+import "../chunk-BMLCIFZW.mjs";
 import "../chunk-66IXTIVK.mjs";
-import "../chunk-SLX73WRZ.mjs";
+import "../chunk-DC3WRPBV.mjs";
 import "../chunk-IW44C7UL.mjs";
 import "../chunk-J5LGTIGS.mjs";
 export {
   App,
   LoadingState,
-  Placeholder,
   PluginManagerProvider,
   Surface,
   useApp,

package/dist/lib/node-esm/{capability-RLKFFLTB.mjs → capability-7TCQK7ZP.mjs}

@@ -2,17 +2,17 @@ import { createRequire } from 'node:module';const require = createRequire(import
 import {
   make,
   make2
-} from "./chunk-BYHYYJZH.mjs";
-import "./chunk-OUEMWPIW.mjs";
+} from "./chunk-KSH4OVMY.mjs";
+import "./chunk-FPW45EZH.mjs";
 import {
   capabilities_exports
-} from "./chunk-PW2VYGOS.mjs";
+} from "./chunk-QBUGLR4H.mjs";
 import "./chunk-KFZEB6BV.mjs";
 import "./chunk-WK7OIQKI.mjs";
-import "./chunk-42UNAKYO.mjs";
-import "./chunk-SFYCO3PT.mjs";
+import "./chunk-XGBUKRCK.mjs";
+import "./chunk-4BX2AE47.mjs";
 import "./chunk-XOCUANHO.mjs";
-import "./chunk-6S45OMUP.mjs";
+import "./chunk-XIGPWXCQ.mjs";
 import {
   capability_exports
 } from "./chunk-CTKEZHKF.mjs";
@@ -33,4 +33,4 @@ var capability_default = capability_exports.makeModule(Effect.fnUntraced(functio
 export {
   capability_default as default
 };
-//# sourceMappingURL=capability-RLKFFLTB.mjs.map
+//# sourceMappingURL=capability-7TCQK7ZP.mjs.map

package/dist/lib/node-esm/{chunk-SFYCO3PT.mjs → chunk-4BX2AE47.mjs}

@@ -10,7 +10,7 @@ import {
   Service as Service2,
   isLazy,
   resolveLazy
-} from "./chunk-6S45OMUP.mjs";
+} from "./chunk-XIGPWXCQ.mjs";
 import {
   Service
 } from "./chunk-CTKEZHKF.mjs";
@@ -56,6 +56,7 @@ import { log } from "@dxos/log";
 var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/capability-manager.ts";
 var CapabilityManagerImpl = class {
   _registry;
+  _registeredIdentifiers = /* @__PURE__ */ new Set();
   _capabilityEntries = Atom.family(() => {
     return Atom.make([]).pipe(Atom.keepAlive);
   });
@@ -78,7 +79,7 @@ var CapabilityManagerImpl = class {
   _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}`"] });
+      invariant(current.length > 0, `No capability found for ${id}`, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 36, S: this, A: ["current.length > 0", "`No capability found for ${id}`"] });
       return current[0];
     });
   });
@@ -92,7 +93,7 @@ var CapabilityManagerImpl = class {
       log("capability already contributed, skipping", {
         id: interfaceDef.identifier,
         moduleId
-      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 46, S: this });
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 47, S: this });
       return;
     }
     const entry = {
@@ -103,11 +104,12 @@ var CapabilityManagerImpl = class {
       ...current,
       entry
     ]);
+    this._registeredIdentifiers.add(interfaceDef.identifier);
     log("capability contributed", {
       id: interfaceDef.identifier,
       moduleId,
       count: current.length
-    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 60, S: this });
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 62, S: this });
   }
   remove(interfaceDef, implementation) {
     const current = this._registry.get(this._capabilityEntries(interfaceDef.identifier));
@@ -117,14 +119,17 @@ var CapabilityManagerImpl = class {
     const next = current.filter((c) => c.implementation !== implementation);
     if (next.length !== current.length) {
       this._registry.set(this._capabilityEntries(interfaceDef.identifier), next);
+      if (next.length === 0) {
+        this._registeredIdentifiers.delete(interfaceDef.identifier);
+      }
       log("capability removed", {
         id: interfaceDef.identifier,
         count: current.length
-      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 74, S: this });
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 79, S: this });
     } else {
       log.warn("capability not removed", {
         id: interfaceDef.identifier
-      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 79, S: this });
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 84, S: this });
     }
   }
   atom(interfaceDef) {
@@ -135,9 +140,20 @@ var CapabilityManagerImpl = class {
   }
   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}`"] });
+    if (capabilities.length === 0) {
+      log("capability not available", {
+        requested: interfaceDef.identifier,
+        registered: this.listRegisteredIdentifiers()
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 99, S: this });
+      invariant(capabilities.length > 0, `No capability found for ${interfaceDef.identifier}`, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 103, S: this, A: ["capabilities.length > 0", "`No capability found for ${interfaceDef.identifier}`"] });
+    }
     return capabilities[0];
   }
+  listRegisteredIdentifiers() {
+    return [
+      ...this._registeredIdentifiers
+    ].sort();
+  }
   waitFor(interfaceDef) {
     return Effect.gen(this, function* () {
       const [capability] = this.getAll(interfaceDef);
@@ -979,7 +995,7 @@ var ManagerImpl = class {
   * can iterate and tear down leaves first.
   */
   _collectDependents(id, opts) {
-    const direct = this._get(this._pluginsAtom).filter((plugin) => plugin.meta.dependsOn?.includes(id)).map((plugin) => plugin.meta.id);
+    const direct = this._get(this._pluginsAtom).filter((plugin) => plugin.meta.dependsOn?.some((dep) => dep === id)).map((plugin) => plugin.meta.id);
     if (!opts.transitive) {
       return opts.enabledOnly ? direct.filter((dependentId) => this._get(this._enabledAtom).includes(dependentId)) : direct;
     }
@@ -990,7 +1006,7 @@ var ManagerImpl = class {
         return;
       }
       visited.add(currentId);
-      const parents = this._get(this._pluginsAtom).filter((plugin) => plugin.meta.dependsOn?.includes(currentId)).map((plugin) => plugin.meta.id);
+      const parents = this._get(this._pluginsAtom).filter((plugin) => plugin.meta.dependsOn?.some((dep) => dep === currentId)).map((plugin) => plugin.meta.id);
       for (const parentId of parents) {
         visit(parentId);
         if (parentId !== id && !result.includes(parentId)) {
@@ -1183,8 +1199,8 @@ var ManagerImpl = class {
     const activatingModuleIds = modules.map((module) => module.id);
     return Effect3.gen(this, function* () {
       yield* Ref.update(this._activatingModules, (activating) => Array.appendAll(activating, activatingModuleIds));
-      log3("activating modules", {
-        key,
+      log3.info("activation wave", {
+        event: key,
         modules: activatingModuleIds
       }, { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 1024, S: this });
       performance.mark(`event:${key}:start`);
@@ -1355,12 +1371,17 @@ var ManagerImpl = class {
       }));
       const fiber = yield* Effect3.forkDaemon(loadEffect.pipe(Effect3.tap((result) => Deferred2.succeed(deferred, result)), Effect3.catchAllCause((cause) => {
         const error = Cause.squash(cause);
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const missingCapability = errorMessage.match(/No capability found for ([^\s\[]+)/)?.[1];
         log3.error("module failed to activate", {
           module: module.id,
-          error: error instanceof Error ? error.message : String(error),
+          parentEvent,
+          missingCapability,
+          registeredCapabilities: this.capabilities.listRegisteredIdentifiers(),
+          error: errorMessage,
           stack: error instanceof Error ? error.stack : void 0,
           isDefect: !Cause.isFailure(cause)
-        }, { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 1196, S: this });
+        }, { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 1198, S: this });
         const normalizedError = error instanceof Error ? error : new Error(String(error));
         const pluginId = this._getPluginIdForModule(module.id);
         if (pluginId !== void 0) {
@@ -1395,7 +1416,7 @@ var ManagerImpl = class {
       const id = module.id;
       log3("deactivating", {
         id
-      }, { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 1235, S: this });
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 1240, S: this });
       this._moduleMemoMap.delete(id);
       const capabilities = this._capabilities.get(id);
       if (capabilities) {
@@ -1412,7 +1433,7 @@ var ManagerImpl = class {
       }
       log3("deactivated", {
         id
-      }, { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 1252, S: this });
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 1257, S: this });
       return true;
     });
   }
@@ -1444,4 +1465,4 @@ export {
   make5 as make,
   plugin_manager_exports
 };
-//# sourceMappingURL=chunk-SFYCO3PT.mjs.map
+//# sourceMappingURL=chunk-4BX2AE47.mjs.map