@dxos/app-framework 0.8.4-main.422d1c7879 → 0.8.4-main.4f23b4e393

package/dist/lib/node-esm/{chunk-WZ6DHQER.mjs → chunk-DRZKO5UZ.mjs}

@@ -3,19 +3,19 @@ import {
   PluginManagerProvider,
   topologicalSort,
   usePluginManager
-} from "./chunk-JPWVIQ5I.mjs";
+} from "./chunk-V24UWT36.mjs";
 import {
   PluginManagerContext
-} from "./chunk-FKE4Z3D6.mjs";
+} from "./chunk-37Z53PXZ.mjs";
 import {
   capabilities_exports
-} from "./chunk-G3RTFSNG.mjs";
+} from "./chunk-WFSRZKBP.mjs";
 import {
   activation_events_exports
-} from "./chunk-WZCSOX5Q.mjs";
+} from "./chunk-6XW6LET6.mjs";
 import {
   plugin_manager_exports
-} from "./chunk-7PJ5OKRB.mjs";
+} from "./chunk-MUVUQC3G.mjs";
 
 // src/ui/components/App/App.tsx
 import React2, { useEffect as useEffect3 } from "react";
@@ -35,23 +35,17 @@ import { useAsyncEffect, useDefaultValue } from "@dxos/react-hooks";
 import { ContextProtocolProvider } from "@dxos/web-context-react";
 var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/ui/hooks/useApp.tsx";
 var ENABLED_KEY = "org.dxos.app-framework.enabled";
-var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, plugins: pluginsProp, core: coreProp, defaults: defaultsProp, setupEvents: setupEventsProp, placeholder, fallback = ErrorFallback, cacheEnabled = false, safeMode = false, debounce = 0, timeout = 3e4 }) => {
+var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, onPluginRemove, pluginRegistryProvider, plugins: pluginsProp, core: coreProp, defaults: defaultsProp, setupEvents: setupEventsProp, placeholder, fallback = ErrorFallback, cacheEnabled = false, safeMode = false, debounce = 0, timeout = 3e4 }) => {
   const plugins = useDefaultValue(pluginsProp, () => []);
   const core = useDefaultValue(coreProp, () => plugins.map(({ meta }) => meta.id));
   const defaults = useDefaultValue(defaultsProp, () => []);
   const setupEvents = useDefaultValue(setupEventsProp, () => []);
   const pluginLoader = useMemo(() => pluginLoaderProp ?? ((id) => Effect.sync(() => {
     const plugin = plugins.find((plugin2) => plugin2.meta.id === id);
-    invariant(plugin, `Plugin not found: ${id}`, {
-      F: __dxlog_file,
-      L: 111,
-      S: void 0,
-      A: [
-        "plugin",
-        "`Plugin not found: ${id}`"
-      ]
-    });
-    return plugin;
+    invariant(plugin, `Plugin not found: ${id}`, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 52, S: void 0, A: ["plugin", "`Plugin not found: ${id}`"] });
+    return {
+      plugin
+    };
   })), [
     pluginLoaderProp,
     plugins
@@ -78,23 +72,22 @@ var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, plugins: pluginsP
       pluginLoader,
       plugins,
       core,
-      enabled
+      enabled,
+      onRemove: onPluginRemove,
+      pluginRegistryProvider
     });
     log("useApp: useMemo created/reused manager", {
       provided: !!pluginManager
-    }, {
-      F: __dxlog_file,
-      L: 135,
-      S: void 0,
-      C: (f, a) => f(...a)
-    });
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 87, S: void 0 });
     return mgr;
   }, [
     pluginManager,
     pluginLoader,
     plugins,
     core,
-    enabled
+    enabled,
+    onPluginRemove,
+    pluginRegistryProvider
   ]);
   useEffect(() => {
     if (!cacheEnabled) {
@@ -113,12 +106,7 @@ var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, plugins: pluginsP
     manager
   ]);
   useAsyncEffect(async () => {
-    log("useApp: effect mount", void 0, {
-      F: __dxlog_file,
-      L: 153,
-      S: void 0,
-      C: (f, a) => f(...a)
-    });
+    log("useApp: effect mount", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 117, S: void 0 });
     manager.capabilities.contribute({
       interface: capabilities_exports.PluginManager,
       implementation: manager,
@@ -132,7 +120,7 @@ var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, plugins: pluginsP
     const fiber = Effect.gen(function* () {
       const queue = yield* PubSub.subscribe(manager.activation);
       const listener = yield* Effect.forkDaemon(Queue.take(queue).pipe(Effect.tap(({ event, state, module, error: error$ }) => Effect.sync(() => {
-        if (event === activation_events_exports.Startup.id && state === "activated") {
+        if (event === activation_events_exports.Startup.id && state === "activated" && !module) {
           clearTimeout(timeoutId);
           setReady(true);
           readyRef.current = true;
@@ -142,15 +130,36 @@ var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, plugins: pluginsP
           }
           return;
         }
+        if (module && state === "activating" && !readyRef.current) {
+          setStartupProgress((current) => ({
+            ...current,
+            // `event` here is the activation event that first
+            // triggered this module load (plumbed through
+            // `_loadCapabilitiesForModules` → `_loadModule`).
+            // Falsy/empty falls back to undefined so consumers can
+            // tell "no parent context" from "parent context: <X>".
+            event: event || void 0,
+            module,
+            humanizedName: humanizeModuleId(module)
+          }));
+        }
         if (module && state === "activated" && !readyRef.current) {
           const active = manager.getActive();
           const total = manager.getModules().length;
-          setStartupProgress({
+          setStartupProgress((current) => ({
+            ...current,
             activated: active.length,
             total,
-            progress: total > 0 ? active.length / total : 0,
-            status: humanizeModuleId(module)
-          });
+            progress: total > 0 ? active.length / total : 0
+          }));
+        }
+        if (event && !module && state === "activating" && !readyRef.current) {
+          setStartupProgress((current) => ({
+            ...current,
+            event,
+            module: void 0,
+            humanizedName: humanizeEventKey(event)
+          }));
         }
         if (error$ && !readyRef.current) {
           setError(error$);
@@ -170,23 +179,13 @@ var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, plugins: pluginsP
           eventsFired: manager.getEventsFired(),
           activeModules: manager.getActive(),
           pendingReset: manager.getPendingReset()
-        }, {
-          F: __dxlog_file,
-          L: 223,
-          S: void 0,
-          C: (f, a) => f(...a)
-        });
+        }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 224, S: void 0 });
         void runAndForwardErrors(Fiber.interrupt(fiber));
         setError(new Error(`Startup timed out after ${timeout}ms`));
       }
     }, timeout);
     return () => {
-      log("useApp: effect cleanup", void 0, {
-        F: __dxlog_file,
-        L: 234,
-        S: void 0,
-        C: (f, a) => f(...a)
-      });
+      log("useApp: effect cleanup", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 234, S: void 0 });
       clearTimeout(timeoutId);
       void runAndForwardErrors(Fiber.interrupt(fiber));
       if (!isExternalManager) {
@@ -196,6 +195,8 @@ var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, plugins: pluginsP
   }, [
     manager
   ]);
+  const progressRef = useRef(startupProgress);
+  progressRef.current = startupProgress;
   return useCallback(() => /* @__PURE__ */ React.createElement(ErrorBoundary, {
     name: "app",
     FallbackComponent: fallback
@@ -211,7 +212,7 @@ var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, plugins: pluginsP
     ready,
     error,
     debounce,
-    progress: startupProgress
+    progress: progressRef.current
   }))))), [
     fallback,
     manager,
@@ -225,13 +226,24 @@ var setupDevtools = (manager) => {
   globalThis.composer.manager = manager;
 };
 var humanizeModuleId = (moduleId) => {
-  const pluginMatch = moduleId.match(/\.plugin\.([^.]+)\./);
-  if (pluginMatch) {
-    const name = pluginMatch[1];
-    return name.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  const match = moduleId.match(/\.plugin\.([^.]+)\.module\.(.+)$/);
+  if (!match) {
+    const parts = moduleId.split(".");
+    return parts[parts.length - 1];
+  }
+  const [, pluginSlug, moduleName] = match;
+  const pluginLabel = pluginSlug.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  const moduleLabel = moduleName.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2").toLowerCase();
+  if (moduleLabel === pluginSlug) {
+    return pluginLabel;
   }
-  const parts = moduleId.split(".");
-  return parts[parts.length - 1];
+  return `${pluginLabel}: ${moduleLabel}`;
+};
+var humanizeEventKey = (eventKey) => {
+  const id = eventKey.split(":")[0];
+  const match = id.match(/\.event\.(.+)$/);
+  const slug = match ? match[1] : id.split(".").pop() ?? id;
+  return slug.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 };
 
 // src/ui/hooks/useCapabilities.ts
@@ -245,15 +257,7 @@ var useCapabilities = (interfaceDef) => {
 };
 var useCapability = (interfaceDef) => {
   const capabilities = useCapabilities(interfaceDef);
-  invariant2(capabilities.length > 0, `No capability found for ${interfaceDef.identifier}`, {
-    F: __dxlog_file2,
-    L: 30,
-    S: void 0,
-    A: [
-      "capabilities.length > 0",
-      "`No capability found for ${interfaceDef.identifier}`"
-    ]
-  });
+  invariant2(capabilities.length > 0, `No capability found for ${interfaceDef.identifier}`, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 22, S: void 0, A: ["capabilities.length > 0", "`No capability found for ${interfaceDef.identifier}`"] });
   return capabilities[0];
 };
 var useAtomCapability = (atomCapability) => {
@@ -278,7 +282,7 @@ var useAtomCapabilityState = (atomCapability) => {
 var useOperationInvoker = () => useCapability(capabilities_exports.OperationInvoker);
 
 // src/ui/hooks/useLoading.tsx
-import { useEffect as useEffect2, useState as useState2 } from "react";
+import { useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
 var LoadingState = /* @__PURE__ */ (function(LoadingState2) {
   LoadingState2[LoadingState2["Loading"] = 0] = "Loading";
   LoadingState2[LoadingState2["FadeIn"] = 1] = "FadeIn";
@@ -288,23 +292,25 @@ var LoadingState = /* @__PURE__ */ (function(LoadingState2) {
 })({});
 var useLoading = (ready, debounce = 0) => {
   const [stage, setStage] = useState2(0);
+  const readyRef = useRef2(ready);
+  readyRef.current = ready;
   useEffect2(() => {
     if (!debounce) {
       return;
     }
     const i = setInterval(() => {
       setStage((stage2) => {
+        const isReady = readyRef.current;
         switch (stage2) {
           case 0: {
-            if (!ready) {
+            if (!isReady) {
               return 1;
-            } else {
-              clearInterval(i);
-              return 3;
             }
+            clearInterval(i);
+            return 3;
           }
           case 1: {
-            if (ready) {
+            if (isReady) {
               return 2;
             }
             break;
@@ -347,15 +353,19 @@ var useSettingsState = (atom) => {
 
 // src/ui/components/App/App.tsx
 var FIRST_INTERACTIVE_MARK = "app-framework:first-interactive";
-var App = ({ placeholder: Placeholder, ready, error, debounce, progress }) => {
+var App = ({ placeholder: Placeholder2, ready, error, debounce, progress }) => {
   const reactContexts = useCapabilities(capabilities_exports.ReactContext);
   const reactRoots = useCapabilities(capabilities_exports.ReactRoot);
   const stage = useLoading(ready, debounce);
   const placeholderDismissed = stage >= LoadingState.Done;
   useEffect3(() => {
-    if (placeholderDismissed && performance.getEntriesByName(FIRST_INTERACTIVE_MARK).length === 0) {
+    if (!placeholderDismissed) {
+      return;
+    }
+    if (performance.getEntriesByName(FIRST_INTERACTIVE_MARK).length === 0) {
       performance.mark(FIRST_INTERACTIVE_MARK);
     }
+    window.__bootLoader?.dismiss?.();
   }, [
     placeholderDismissed
   ]);
@@ -363,10 +373,10 @@ var App = ({ placeholder: Placeholder, ready, error, debounce, progress }) => {
     throw error;
   }
   if (!placeholderDismissed) {
-    if (!Placeholder) {
+    if (!Placeholder2) {
       return null;
     }
-    return /* @__PURE__ */ React2.createElement(Placeholder, {
+    return /* @__PURE__ */ React2.createElement(Placeholder2, {
       stage,
       progress
     });
@@ -383,6 +393,67 @@ var composeContexts = (contexts) => {
   return topologicalSort(contexts).map(({ context }) => context).reduce((Acc, Next) => ({ children }) => /* @__PURE__ */ React2.createElement(Acc, null, /* @__PURE__ */ React2.createElement(Next, null, children)));
 };
 
+// src/ui/components/Placeholder/Placeholder.tsx
+import React3, { useEffect as useEffect4, useLayoutEffect, useRef as useRef3 } from "react";
+import { ThemeProvider } from "@dxos/react-ui";
+import { defaultTx, mx } from "@dxos/ui-theme";
+var Placeholder = ({ stage = 1, progress, logo }) => {
+  if (location.search === "?throw") {
+    throw new Error("Test error");
+  }
+  useEffect4(() => {
+    if (stage >= 2) {
+      return;
+    }
+    const fraction = progress?.progress ?? 0;
+    window.__bootLoader?.progress(0.5 + fraction * 0.5);
+    if (progress?.humanizedName) {
+      window.__bootLoader?.status({
+        event: progress.event,
+        module: progress.module,
+        humanized: `Activating ${progress.humanizedName}`
+      });
+    }
+  }, [
+    stage,
+    progress?.progress,
+    progress?.event,
+    progress?.module,
+    progress?.humanizedName
+  ]);
+  useLayoutEffect(() => {
+    if (stage >= 2) {
+      window.__bootLoader?.dismiss();
+    }
+  }, [
+    stage
+  ]);
+  const stageRef = useRef3(stage);
+  stageRef.current = stage;
+  useEffect4(() => {
+    return () => {
+      if (stageRef.current >= 3) {
+        window.__bootLoader?.dismiss();
+      }
+    };
+  }, []);
+  if (stage < 2) {
+    return null;
+  }
+  const logoClassName = mx("h-[300px] w-[300px] scale-600 transition-all duration-500 ease-in-out filter grayscale opacity-0", stage >= 1 && "scale-100 grayscale-0 opacity-70", stage >= 2 && "scale-50 opacity-0");
+  return /* @__PURE__ */ React3.createElement(ThemeProvider, {
+    tx: defaultTx
+  }, /* @__PURE__ */ React3.createElement("div", {
+    className: "relative dx-container h-dvh flex flex-col"
+  }, /* @__PURE__ */ React3.createElement("div", {
+    className: "flex flex-col grow justify-center items-center"
+  }, typeof logo === "function" ? logo({
+    className: logoClassName
+  }) : logo ? /* @__PURE__ */ React3.createElement("div", {
+    className: logoClassName
+  }, logo) : null)));
+};
+
 export {
   useApp,
   useCapabilities,
@@ -393,6 +464,7 @@ export {
   LoadingState,
   useLoading,
   useSettingsState,
-  App
+  App,
+  Placeholder
 };
-//# sourceMappingURL=chunk-WZ6DHQER.mjs.map
+//# sourceMappingURL=chunk-DRZKO5UZ.mjs.map

package/dist/lib/node-esm/chunk-DRZKO5UZ.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ui/components/App/App.tsx", "../../../src/ui/hooks/useApp.tsx", "../../../src/ui/hooks/useCapabilities.ts", "../../../src/ui/hooks/useLoading.tsx", "../../../src/ui/hooks/useSettingsState.ts", "../../../src/ui/components/Placeholder/Placeholder.tsx"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { type PropsWithChildren, useEffect } from 'react';\n\nimport { Capabilities } from '../../../common';\nimport { topologicalSort } from '../../../helpers';\nimport { LoadingState, type StartupProgress, type UseAppOptions, useCapabilities, useLoading } from '../../hooks';\n\nexport type AppProps = Pick<UseAppOptions, 'placeholder' | 'debounce'> & {\n  ready: boolean;\n  error: unknown;\n  progress?: StartupProgress;\n};\n\nconst FIRST_INTERACTIVE_MARK = 'app-framework:first-interactive';\n\nexport const App = ({ placeholder: Placeholder, ready, error, debounce, progress }: AppProps) => {\n  const reactContexts = useCapabilities(Capabilities.ReactContext);\n  const reactRoots = useCapabilities(Capabilities.ReactRoot);\n  const stage = useLoading(ready, debounce);\n  const placeholderDismissed = stage >= LoadingState.Done;\n\n  // Emit a once-per-app `app-framework:first-interactive` mark the first time\n  // the placeholder is dismissed and the real app shell renders. Closes the\n  // gap between `Startup` activated and the first interactive paint.\n  //\n  // Also dismisses the native-DOM boot loader from\n  // `@dxos/app-framework/vite-plugin` here — the framework owns the\n  // handoff-complete signal, so dismissing in `App` covers both hosts that\n  // wire in a `Placeholder` (which may have its own dismiss path) and hosts\n  // that don't (the loader would otherwise sit forever as a `z-index: 10`\n  // overlay covering the rendered shell).\n  useEffect(() => {\n    if (!placeholderDismissed) {\n      return;\n    }\n    if (performance.getEntriesByName(FIRST_INTERACTIVE_MARK).length === 0) {\n      performance.mark(FIRST_INTERACTIVE_MARK);\n    }\n    (window as { __bootLoader?: { dismiss?: () => void } }).__bootLoader?.dismiss?.();\n  }, [placeholderDismissed]);\n\n  if (error) {\n    // This triggers the error boundary to provide UI feedback for the startup error.\n    throw error;\n  }\n\n  // TODO(wittjosiah): Consider using Suspense instead.\n  if (!placeholderDismissed) {\n    if (!Placeholder) {\n      return null;\n    }\n\n    return <Placeholder stage={stage} progress={progress} />;\n  }\n\n  const ComposedContext = composeContexts(reactContexts);\n  return (\n    <ComposedContext>\n      {reactRoots.map(({ id, root: Component }) => (\n        <Component key={id} />\n      ))}\n    </ComposedContext>\n  );\n};\n\nconst composeContexts = (contexts: Capabilities.ReactContext[]) => {\n  if (contexts.length === 0) {\n    return ({ children }: PropsWithChildren) => <>{children}</>;\n  }\n\n  return topologicalSort(contexts)\n    .map(({ context }) => context)\n    .reduce((Acc, Next) => ({ children }) => (\n      <Acc>\n        <Next>{children}</Next>\n      </Acc>\n    ));\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { RegistryContext } from '@effect-atom/atom-react';\nimport * as Effect from 'effect/Effect';\nimport * as Fiber from 'effect/Fiber';\nimport * as PubSub from 'effect/PubSub';\nimport * as Queue from 'effect/Queue';\nimport React, { type FC, useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { runAndForwardErrors } from '@dxos/effect';\nimport { invariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\nimport { ErrorBoundary, ErrorFallback, type FallbackProps } from '@dxos/react-error-boundary';\nimport { useAsyncEffect, useDefaultValue } from '@dxos/react-hooks';\nimport { ContextProtocolProvider } from '@dxos/web-context-react';\n\nimport { ActivationEvents, Capabilities } from '../../common';\nimport { PluginManagerContext } from '../../context';\nimport { type ActivationEvent, type Plugin, PluginManager } from '../../core';\nimport { App, PluginManagerProvider } from '../components';\n\nconst ENABLED_KEY = 'org.dxos.app-framework.enabled';\n\nexport type StartupProgress = {\n  /** Number of modules that have been activated. */\n  activated: number;\n  /** Total number of modules registered. */\n  total: number;\n  /** Fractional progress (0-1). */\n  progress: number;\n  /**\n   * Raw activation event key (e.g. `org.dxos.app-framework.event.startup`).\n   * Set on event-level transitions, *and* on module-level transitions where\n   * it carries the parent activation event that first triggered the\n   * module's load (plumbed through `_loadCapabilitiesForModules` →\n   * `_loadModule`). Consumers can use this either as the primary id (when\n   * {@link module} is absent) or as an extra \"context\" field alongside\n   * {@link module}.\n   */\n  event?: string;\n  /**\n   * Raw module id (e.g. `org.dxos.plugin.observability.module.ReactSurface`)\n   * when the in-flight activation is module-level. When present,\n   * {@link event} may also be set, identifying the parent activation that\n   * triggered this module's load.\n   */\n  module?: string;\n  /**\n   * Pre-humanized label for the currently surfaced transition (module\n   * label if {@link module} is set, otherwise the event label), supplied\n   * for consumers that want a sensible default. Hosts that prefer to\n   * render their own label can read the raw {@link event}/{@link module}\n   * fields and ignore this — the framework leaves the policy choice\n   * (which transitions to surface, how to format them, whether to drop\n   * sub-modules entirely) to the host's `Placeholder`.\n   */\n  humanizedName?: string;\n};\n\nexport type PlaceholderProps = {\n  stage?: number;\n  progress?: StartupProgress;\n};\n\nexport type UseAppOptions = {\n  pluginManager?: PluginManager.PluginManager;\n  pluginLoader?: PluginManager.ManagerOptions['pluginLoader'];\n  onPluginRemove?: PluginManager.ManagerOptions['onRemove'];\n  pluginRegistryProvider?: PluginManager.ManagerOptions['pluginRegistryProvider'];\n  plugins?: Plugin.Plugin[];\n  core?: string[];\n  defaults?: string[];\n  /**\n   * Additional activation events to fire before startup.\n   * These are fired alongside SetupReactSurface before the Startup event.\n   */\n  setupEvents?: ActivationEvent.ActivationEvent[];\n  cacheEnabled?: boolean;\n  safeMode?: boolean;\n  debounce?: number;\n  timeout?: number;\n  fallback?: FC<FallbackProps>;\n  placeholder?: FC<PlaceholderProps>;\n};\n\n/**\n * Expected usage is for this to be the entrypoint of the application.\n * Initializes plugins and renders the root components.\n *\n * @example\n * const plugins = [LayoutPlugin(), MyPlugin()];\n * const core = [LayoutPluginId];\n * const default = [MyPluginId];\n * const fallback = <div>Initializing Plugins...</div>;\n * const App = useApp({ plugins, core, default, fallback });\n * createRoot(document.getElementById('root')!).render(\n *   <StrictMode>\n *     <App />\n *   </StrictMode>,\n * );\n *\n * @param params.pluginLoader A function which loads new plugins.\n * @param params.plugins All plugins available to the application.\n * @param params.core Core plugins which will always be enabled.\n * @param params.defaults Default plugins are enabled by default but can be disabled by the user.\n * @param params.cacheEnabled Whether to cache enabled plugins in localStorage.\n * @param params.safeMode Whether to enable safe mode, which disables optional plugins.\n * @param params.fallback Fallback component to render if an error occurs during startup.\n * @param params.placeholder Placeholder component to render during startup.\n */\nexport const useApp = ({\n  pluginManager,\n  pluginLoader: pluginLoaderProp,\n  onPluginRemove,\n  pluginRegistryProvider,\n  plugins: pluginsProp,\n  core: coreProp,\n  defaults: defaultsProp,\n  setupEvents: setupEventsProp,\n  placeholder,\n  fallback = ErrorFallback,\n  cacheEnabled = false,\n  safeMode = false,\n  debounce = 0,\n  timeout = 30_000,\n}: UseAppOptions) => {\n  const plugins = useDefaultValue(pluginsProp, () => []);\n  const core = useDefaultValue(coreProp, () => plugins.map(({ meta }) => meta.id));\n  const defaults = useDefaultValue(defaultsProp, () => []);\n  const setupEvents = useDefaultValue(setupEventsProp, () => []);\n\n  const pluginLoader = useMemo(\n    () =>\n      pluginLoaderProp ??\n      ((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    [pluginLoaderProp, plugins],\n  );\n\n  const readyRef = useRef(false);\n  const [ready, setReady] = useState(false);\n  const errorRef = useRef<unknown>(null);\n  const [error, setError] = useState<unknown>(null);\n  const [startupProgress, setStartupProgress] = useState<StartupProgress>({\n    activated: 0,\n    total: 0,\n    progress: 0,\n  });\n  // TODO(wittjosiah): Migrate to Atom.kvs for isomorphic storage.\n  const cached: string[] = useMemo(() => JSON.parse(localStorage.getItem(ENABLED_KEY) ?? '[]'), []);\n  const enabled = useMemo(\n    () => (safeMode ? [] : cacheEnabled && cached.length > 0 ? cached : defaults),\n    [safeMode, cacheEnabled, cached, defaults],\n  );\n  const isExternalManager = !!pluginManager;\n  const manager = useMemo(() => {\n    const mgr =\n      pluginManager ??\n      PluginManager.make({\n        pluginLoader,\n        plugins,\n        core,\n        enabled,\n        onRemove: onPluginRemove,\n        pluginRegistryProvider,\n      });\n    log('useApp: useMemo created/reused manager', { provided: !!pluginManager });\n    return mgr;\n  }, [pluginManager, pluginLoader, plugins, core, enabled, onPluginRemove, pluginRegistryProvider]);\n\n  useEffect(() => {\n    if (!cacheEnabled) {\n      return;\n    }\n    return manager.registry.subscribe(manager.enabled, (value) => {\n      localStorage.setItem(ENABLED_KEY, JSON.stringify(value));\n    });\n  }, [cacheEnabled, manager]);\n\n  useEffect(() => {\n    setupDevtools(manager);\n  }, [manager]);\n\n  useAsyncEffect(async () => {\n    log('useApp: effect mount');\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    const fiber = Effect.gen(function* () {\n      const queue = yield* PubSub.subscribe(manager.activation);\n      const listener = yield* Effect.forkDaemon(\n        Queue.take(queue).pipe(\n          Effect.tap(({ event, state, module, error: error$ }) =>\n            Effect.sync(() => {\n              // Event-level Startup activated (no `module` field) fires once,\n              // after every module triggered by Startup has finished. Module\n              // activations now also carry their parent event id (so the trace\n              // can attribute a module to its triggering event), which means\n              // each module activated under Startup publishes\n              // `{ event: 'startup', state: 'activated', module: <id> }`. Without\n              // the `!module` guard the listener would mark the app ready on\n              // the *first* such module rather than waiting for the event-level\n              // completion — leaving downstream capabilities (operation-invoker,\n              // app-graph, …) un-registered when the placeholder dismisses.\n              if (event === ActivationEvents.Startup.id && state === 'activated' && !module) {\n                clearTimeout(timeoutId);\n                setReady(true);\n                readyRef.current = true;\n                // Trigger startup profiler dump if available.\n                (globalThis as any).composer?.profiler?.dump();\n                // Notify any host observability layer that startup completed.\n                // A `CustomEvent` keeps this generic — app-framework doesn't\n                // import a provider, and consumers can capture the startup\n                // summary without us picking one.\n                if (typeof window !== 'undefined') {\n                  window.dispatchEvent(new CustomEvent('app-framework:startup-activated'));\n                }\n                return;\n              }\n              // `activating` is the start-of-load signal. Surface the raw\n              // `module` (or `event`) plus a pre-humanized label so the\n              // host placeholder can decide what to render — show\n              // everything, suppress noisy sub-modules, group by plugin,\n              // or apply its own formatting. We intentionally do NOT touch\n              // these fields on `activated`: pairing the two would cause\n              // back-to-back identical updates to the host's effect, which\n              // the boot loader treats as a re-trigger because\n              // `progress.progress` moved. Leaving the label alone on\n              // completion keeps it accurate (\"now activating X\") until\n              // the next module starts.\n              if (module && state === 'activating' && !readyRef.current) {\n                setStartupProgress((current) => ({\n                  ...current,\n                  // `event` here is the activation event that first\n                  // triggered this module load (plumbed through\n                  // `_loadCapabilitiesForModules` → `_loadModule`).\n                  // Falsy/empty falls back to undefined so consumers can\n                  // tell \"no parent context\" from \"parent context: <X>\".\n                  event: event || undefined,\n                  module,\n                  humanizedName: humanizeModuleId(module),\n                }));\n              }\n              // Update the activation count when a module commits. The\n              // ring's fraction comes from this; `event`/`module`/\n              // `humanizedName` were set by the matching `activating`\n              // message above and are left alone so the count can advance\n              // without re-firing the host's status callback.\n              if (module && state === 'activated' && !readyRef.current) {\n                const active = manager.getActive();\n                const total = manager.getModules().length;\n                setStartupProgress((current) => ({\n                  ...current,\n                  activated: active.length,\n                  total,\n                  progress: total > 0 ? active.length / total : 0,\n                }));\n              }\n              // Event-level `activating` (no `module`) — fired at the start\n              // of `_activateModulesForEvent` and recursively for each\n              // before/after event. Surfaces a label during the gap before\n              // the first module-level message lands; subsequent module\n              // updates immediately overwrite this with a more specific\n              // label.\n              if (event && !module && state === 'activating' && !readyRef.current) {\n                setStartupProgress((current) => ({\n                  ...current,\n                  event,\n                  module: undefined,\n                  humanizedName: humanizeEventKey(event),\n                }));\n              }\n              if (error$ && !readyRef.current) {\n                setError(error$);\n                errorRef.current = error$;\n              }\n            }),\n          ),\n          Effect.forever,\n        ),\n      );\n\n      yield* Effect.all([\n        ...setupEvents.map((event) => manager.activate(event)),\n        manager.activate(ActivationEvents.SetupReactSurface),\n        manager.activate(ActivationEvents.Startup),\n      ]);\n\n      return yield* Fiber.join(listener);\n    }).pipe(Effect.scoped, Effect.runFork);\n\n    // Set up a timeout for startup.\n    const timeoutId = setTimeout(() => {\n      if (!readyRef.current && !errorRef.current) {\n        log.warn('startup timeout diagnostic', {\n          eventsFired: manager.getEventsFired(),\n          activeModules: manager.getActive(),\n          pendingReset: manager.getPendingReset(),\n        });\n        void runAndForwardErrors(Fiber.interrupt(fiber));\n        setError(new Error(`Startup timed out after ${timeout}ms`));\n      }\n    }, timeout);\n\n    return () => {\n      log('useApp: effect cleanup');\n      clearTimeout(timeoutId);\n      void runAndForwardErrors(Fiber.interrupt(fiber));\n      if (!isExternalManager) {\n        void runAndForwardErrors(manager.shutdown());\n      }\n    };\n  }, [manager]);\n\n  const progressRef = useRef(startupProgress);\n  progressRef.current = startupProgress;\n\n  return useCallback(\n    () => (\n      <ErrorBoundary name='app' FallbackComponent={fallback}>\n        <PluginManagerProvider value={manager}>\n          <ContextProtocolProvider value={manager} context={PluginManagerContext}>\n            <RegistryContext.Provider value={manager.registry}>\n              <App\n                placeholder={placeholder}\n                ready={ready}\n                error={error}\n                debounce={debounce}\n                progress={progressRef.current}\n              />\n            </RegistryContext.Provider>\n          </ContextProtocolProvider>\n        </PluginManagerProvider>\n      </ErrorBoundary>\n    ),\n    [fallback, manager, placeholder, ready, error],\n  );\n};\n\nconst setupDevtools = (manager: PluginManager.PluginManager) => {\n  (globalThis as any).composer ??= {};\n  (globalThis as any).composer.manager = manager;\n};\n\n/**\n * Extracts a human-readable label from a module ID.\n *\n * Module IDs follow `org.dxos.plugin.<plugin-slug>.module.<module-name>`,\n * where `<plugin-slug>` is kebab-case and `<module-name>` is either an\n * explicit string (often kebab-case, e.g. `'observability'`, `'namespace'`)\n * or a capability tag in PascalCase from `Capability.getModuleTag(...)`\n * (e.g. `'ReactSurface'`, `'AppGraphBuilder'`). The output is\n * `\"Title Case Plugin: kebab-module\"` so the visible status names both the\n * plugin and the aspect being activated, helping disambiguate the multiple\n * modules a plugin contributes.\n *\n * Examples:\n *   - \"org.dxos.plugin.markdown.module.ReactSurface\" → \"Markdown: react-surface\"\n *   - \"org.dxos.plugin.observability.module.AppGraphBuilder\" → \"Observability: app-graph-builder\"\n *   - \"org.dxos.plugin.observability.module.observability\" → \"Observability\"\n *     (the module name matches the plugin slug — collapsed to avoid\n *     \"Observability: observability\" noise.)\n */\nconst humanizeModuleId = (moduleId: string): string => {\n  const match = moduleId.match(/\\.plugin\\.([^.]+)\\.module\\.(.+)$/);\n  if (!match) {\n    // Fallback: use the last segment.\n    const parts = moduleId.split('.');\n    return parts[parts.length - 1];\n  }\n  const [, pluginSlug, moduleName] = match;\n  const pluginLabel = pluginSlug\n    .split('-')\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(' ');\n  // Normalise the module name to kebab-case so PascalCase capability tags\n  // (\"ReactSurface\") read consistently with explicit kebab IDs\n  // (\"operation-handler\"). The two-step substitution handles consecutive\n  // uppercase runs (`URLLoader` → `url-loader`) without splitting them\n  // mid-acronym.\n  const moduleLabel = moduleName\n    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2')\n    .toLowerCase();\n  // Capability modules whose name matches the plugin slug (e.g. the\n  // observability plugin's `observability` capability module) would render\n  // as \"Observability: observability\" — drop the redundant suffix.\n  if (moduleLabel === pluginSlug) {\n    return pluginLabel;\n  }\n  return `${pluginLabel}: ${moduleLabel}`;\n};\n\n/**\n * Extracts a human-readable label from an activation event key.\n * E.g., \"org.dxos.app-framework.event.setup-react-surface\" → \"Setup React Surface\".\n */\nconst humanizeEventKey = (eventKey: string): string => {\n  // Strip a leading specifier (composite key form: \"<id>:<specifier>\").\n  const id = eventKey.split(':')[0];\n  // Match the trailing segment after `.event.`.\n  const match = id.match(/\\.event\\.(.+)$/);\n  const slug = match ? match[1] : (id.split('.').pop() ?? id);\n  return slug\n    .split('-')\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(' ');\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom, useAtomValue } from '@effect-atom/atom-react';\nimport { useCallback } from 'react';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { Capabilities } from '../../common';\nimport { type Capability } from '../../core';\nimport { usePluginManager } from '../components';\n\n/**\n * Hook to request capabilities from the plugin context.\n * @returns An array of capabilities.\n */\nexport const useCapabilities = <T>(interfaceDef: Capability.InterfaceDef<T>) => {\n  const manager = usePluginManager();\n  return useAtomValue(manager.capabilities.atom(interfaceDef));\n};\n\n/**\n * Hook to request a capability from the plugin context.\n * @returns The capability.\n * @throws If no capability is found.\n */\nexport const useCapability = <T>(interfaceDef: Capability.InterfaceDef<T>) => {\n  const capabilities = useCapabilities(interfaceDef);\n  invariant(capabilities.length > 0, `No capability found for ${interfaceDef.identifier}`);\n  return capabilities[0];\n};\n\n/**\n * Hook to get the current value of an atom capability.\n * Automatically subscribes to changes.\n * @example const settings = useAtomCapability(ThreadCapabilities.Settings);\n */\nexport const useAtomCapability = <T>(atomCapability: Capability.InterfaceDef<Atom.Atom<T>>): T => {\n  const atom = useCapability(atomCapability);\n  return useAtomValue(atom);\n};\n\n/**\n * Hook to get value and updater for an atom capability.\n * Returns [currentValue, updateFn] similar to useState.\n * @example const [settings, updateSettings] = useAtomCapabilityState(ThreadCapabilities.Settings);\n */\nexport const useAtomCapabilityState = <T>(\n  atomCapability: Capability.InterfaceDef<Atom.Writable<T>>,\n): [T, (fn: (current: T) => T) => void] => {\n  const registry = useCapability(Capabilities.AtomRegistry);\n  const atom = useCapability(atomCapability);\n  const value = useAtomValue(atom);\n  const update = useCallback(\n    (fn: (current: T) => T) => {\n      registry.set(atom, fn(registry.get(atom)));\n    },\n    [registry, atom],\n  );\n  return [value, update];\n};\n\n/**\n * Hook to get the operation invoker capability.\n */\nexport const useOperationInvoker = (): Capabilities.OperationInvoker => useCapability(Capabilities.OperationInvoker);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useEffect, useRef, useState } from 'react';\n\nexport enum LoadingState {\n  Loading = 0,\n  FadeIn = 1,\n  FadeOut = 2,\n  Done = 3,\n}\n\n/**\n * To avoid \"flashing\" the placeholder, we wait a period of time before starting the loading animation.\n * If loading completes during this time the placehoder is not shown, otherwise is it displayed for a minimum period of time.\n *\n * States:\n * 0: Loading   - Wait for a period of time before starting the loading animation.\n * 1: Fade-in   - Display a loading animation.\n * 2: Fade-out  - Fade out the loading animation.\n * 3: Done      - Remove the placeholder.\n */\nexport const useLoading = (ready: boolean, debounce = 0) => {\n  const [stage, setStage] = useState<LoadingState>(LoadingState.Loading);\n  // Mirror `ready` into a ref so the interval's `setStage` callback can read\n  // the latest value without depending on the effect re-running. The pure\n  // closure-capture pattern (with `ready` in deps) sticks the FSM at\n  // `FadeIn` whenever HMR doesn't propagate the dep change end-to-end —\n  // a ref sidesteps that entirely and fires the read on every tick.\n  const readyRef = useRef(ready);\n  readyRef.current = ready;\n\n  useEffect(() => {\n    if (!debounce) {\n      return;\n    }\n\n    const i = setInterval(() => {\n      setStage((stage) => {\n        const isReady = readyRef.current;\n        switch (stage) {\n          case LoadingState.Loading: {\n            if (!isReady) {\n              return LoadingState.FadeIn;\n            }\n            clearInterval(i);\n            return LoadingState.Done;\n          }\n\n          case LoadingState.FadeIn: {\n            if (isReady) {\n              return LoadingState.FadeOut;\n            }\n            break;\n          }\n\n          case LoadingState.FadeOut: {\n            clearInterval(i);\n            return LoadingState.Done;\n          }\n        }\n\n        return stage;\n      });\n    }, debounce);\n\n    return () => clearInterval(i);\n  }, [debounce]);\n\n  if (!debounce) {\n    return ready ? LoadingState.Done : LoadingState.Loading;\n  }\n\n  return stage;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom, RegistryContext, useAtomValue } from '@effect-atom/atom-react';\nimport { useCallback, useContext } from 'react';\n\n/**\n * Hook to read and update a settings atom.\n * Returns the current value and an update function.\n */\nexport const useSettingsState = <T>(\n  atom: Atom.Writable<T>,\n): { settings: T; updateSettings: (fn: (current: T) => T) => void } => {\n  const registry = useContext(RegistryContext);\n  const settings = useAtomValue(atom);\n\n  const updateSettings = useCallback(\n    (fn: (current: T) => T) => {\n      registry.set(atom, fn(registry.get(atom)));\n    },\n    [registry, atom],\n  );\n\n  return { settings, updateSettings };\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { type ReactNode, useEffect, useLayoutEffect, useRef } from 'react';\n\nimport { ThemeProvider } from '@dxos/react-ui';\nimport { defaultTx, mx } from '@dxos/ui-theme';\n\nimport { type PlaceholderProps as PlaceholderSlotProps } from '../../hooks';\n\ndeclare global {\n  interface Window {\n    /**\n     * Driver injected by `@dxos/app-framework/vite-plugin`'s `bootLoaderPlugin`.\n     * Declared here so the {@link Placeholder} can dismiss the native-DOM\n     * loader once the React placeholder commits without each host having to\n     * re-declare the type.\n     */\n    __bootLoader?: {\n      status: (payload: {\n        event?: string;\n        module?: string;\n        humanized: string;\n        /**\n         * Optional `(index/total)` tick. When present, the loader replaces the\n         * current line in place (\"Loading plugins (12/80)\") instead of\n         * appending a new entry — keeps the visible log compact during long\n         * counted phases like plugin chunk-loading or module activation.\n         */\n        range?: { index: number; total: number };\n      }) => void;\n      progress: (fraction?: number) => void;\n      dismiss: () => void;\n    };\n  }\n}\n\nexport type PlaceholderComponentProps = PlaceholderSlotProps & {\n  /**\n   * Brand mark rendered while the React tree settles. Pass either a static\n   * `ReactNode` (the framework wraps it in a sizing/animation div) or a\n   * render function that receives the precomputed `className` so the host\n   * can apply it directly to its logo (e.g. an SVG that accepts `className`\n   * — `composer-app` passes `(p) => <Composer {...p} />` from `@dxos/brand`).\n   */\n  logo?: ReactNode | ((props: { className: string }) => ReactNode);\n};\n\n/**\n * React placeholder. The native-DOM boot loader is the visible UI through\n * stages 0 (Loading) and 1 (FadeIn): we render `null` until `stage >= 2`\n * (FadeOut) and instead feed activation progress + status into the still-\n * alive boot loader. At stage 2 the loader dismisses and the React mark\n * appears for the cross-fade to the real shell:\n *\n *   - composer-app fills `0 → 50%` from `getPlugins`'s per-chunk counter.\n *   - this component fills `50 → 100%` from `useApp`'s\n *     `startupProgress.progress` (`activated / total` modules) and pushes\n *     the per-module status text to the loader's status line.\n *   - at `stage >= 2` the boot loader is dismissed and the React mark\n *     starts its `FadeOut → Done` shrink-and-fade.\n *\n * Stage progression (driven by `useApp`):\n *   - `0` — Loading: native-DOM boot loader visible. Placeholder renders nothing.\n *   - `1` — FadeIn: same — boot loader still owns the screen.\n *   - `2` — FadeOut: boot loader dismissed, React mark visible at full opacity then shrinks.\n */\nexport const Placeholder = ({ stage = 1, progress, logo }: PlaceholderComponentProps) => {\n  // Used in tests to exercise the error boundary & reset dialog.\n  if (location.search === '?throw') {\n    throw new Error('Test error');\n  }\n\n  // Phase B: feed activation progress + status to the still-visible boot\n  // loader. Maps `[0, 1]` activation → `[0.5, 1]` of the ring; forwards\n  // the raw activation source (`event` / `module`) plus the pre-humanised\n  // label to `__bootLoader.status` so the loader gets to decide how to\n  // render and trace each transition (current default policy: \"Activating\n  // <humanizedName>\"; trace mode and timings track the structured fields).\n  // No-op once the loader has been dismissed (its `status()` early-returns\n  // when the boot DOM is gone). Skipping `stage >= 2` lets the dismissal\n  // run uncontended.\n  useEffect(() => {\n    if (stage >= 2) {\n      return;\n    }\n    const fraction = progress?.progress ?? 0;\n    window.__bootLoader?.progress(0.5 + fraction * 0.5);\n    if (progress?.humanizedName) {\n      window.__bootLoader?.status({\n        event: progress.event,\n        module: progress.module,\n        humanized: `Activating ${progress.humanizedName}`,\n      });\n    }\n  }, [stage, progress?.progress, progress?.event, progress?.module, progress?.humanizedName]);\n\n  // Hand off from the native-DOM boot loader once the placeholder starts\n  // fading out — keeping the loader visible through `stage 0` and `stage 1`\n  // means the ring stays the visible source of truth for activation\n  // progress. `useLayoutEffect` runs before the next paint so the loader\n  // DOM is removed in the same frame the cross-fade begins.\n  useLayoutEffect(() => {\n    if (stage >= 2) {\n      window.__bootLoader?.dismiss();\n    }\n  }, [stage]);\n\n  // Backstop for the fast-load path where `useLoading` can skip straight\n  // from stage 0 to `Done` (ready=true at the first debounce tick) — the\n  // stage-driven effect above never sees `stage >= 2`, so dismiss on\n  // unmount instead. The `stageRef` guard is what keeps StrictMode's\n  // synthetic mount → cleanup → remount cycle from prematurely dismissing\n  // the loader: the synthetic cleanup runs while `stageRef.current === 0`,\n  // skips the dismiss, and the real unmount (later, at stage `Done`)\n  // performs it.\n  const stageRef = useRef(stage);\n  stageRef.current = stage;\n  useEffect(() => {\n    return () => {\n      if (stageRef.current >= 3 /* Done */) {\n        window.__bootLoader?.dismiss();\n      }\n    };\n  }, []);\n\n  // Defer rendering anything until the FadeOut stage. The boot loader owns\n  // the screen during stages 0 and 1, so any DOM we render here would just\n  // sit invisibly behind it — and rendering null avoids paint cost during\n  // the longest part of the loading sequence (plugin activation).\n  if (stage < 2) {\n    return null;\n  }\n\n  const logoClassName = mx(\n    'h-[300px] w-[300px] scale-600 transition-all duration-500 ease-in-out filter grayscale opacity-0',\n    stage >= 1 && 'scale-100 grayscale-0 opacity-70',\n    stage >= 2 && 'scale-50 opacity-0',\n  );\n\n  return (\n    <ThemeProvider tx={defaultTx}>\n      <div className='relative dx-container h-dvh flex flex-col'>\n        <div className='flex flex-col grow justify-center items-center'>\n          {typeof logo === 'function' ? (\n            logo({ className: logoClassName })\n          ) : logo ? (\n            <div className={logoClassName}>{logo}</div>\n          ) : null}\n        </div>\n      </div>\n    </ThemeProvider>\n  );\n};\n"],
+  "mappings": "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",
+  "names": ["React", "useEffect", "RegistryContext", "Effect", "Fiber", "PubSub", "Queue", "React", "useCallback", "useEffect", "useMemo", "useRef", "useState", "runAndForwardErrors", "invariant", "log", "ErrorBoundary", "ErrorFallback", "useAsyncEffect", "useDefaultValue", "ContextProtocolProvider", "ENABLED_KEY", "core", "useDefaultValue", "id", "defaults", "defaultsProp", "setupEvents", "setupEventsProp", "pluginLoader", "pluginLoaderProp", "plugin", "find", "meta", "invariant", "plugins", "errorRef", "useRef", "error", "setError", "useState", "startupProgress", "setStartupProgress", "activated", "total", "progress", "safeMode", "cacheEnabled", "cached", "pluginManager", "enabled", "onRemove", "pluginRegistryProvider", "mgr", "onPluginRemove", "useEffect", "manager", "useAsyncEffect", "capabilities", "contribute", "interface", "Capabilities", "PluginManager", "implementation", "module", "registry", "fiber", "forkDaemon", "setReady", "readyRef", "current", "globalThis", "humanizedName", "humanizeModuleId", "length", "active", "event", "error$", "Effect", "forever", "activate", "ActivationEvents", "Startup", "join", "listener", "pipe", "timeoutId", "eventsFired", "getEventsFired", "activeModules", "pendingReset", "getPendingReset", "runAndForwardErrors", "Fiber", "Error", "timeout", "clearTimeout", "interrupt", "isExternalManager", "shutdown", "progressRef", "name", "FallbackComponent", "fallback", "value", "ContextProtocolProvider", "PluginManagerContext", "App", "placeholder", "ready", "debounce", "composer", "match", "parts", "pluginSlug", "moduleName", "pluginLabel", "split", "map", "word", "useAtomValue", "useCallback", "invariant", "__dxlog_file", "useAtomValue", "capabilities", "interfaceDef", "invariant", "atom", "useCapability", "atomCapability", "value", "update", "fn", "registry", "set", "useCallback", "useEffect", "useRef", "useState", "LoadingState", "useLoading", "ready", "debounce", "stage", "setStage", "readyRef", "current", "i", "setInterval", "isReady", "clearInterval", "RegistryContext", "useAtomValue", "useCallback", "useContext", "useSettingsState", "atom", "registry", "settings", "updateSettings", "fn", "set", "get", "FIRST_INTERACTIVE_MARK", "App", "placeholder", "Placeholder", "ready", "error", "debounce", "progress", "reactContexts", "useCapabilities", "Capabilities", "ReactContext", "reactRoots", "ReactRoot", "stage", "useLoading", "placeholderDismissed", "LoadingState", "Done", "useEffect", "performance", "getEntriesByName", "length", "mark", "window", "__bootLoader", "dismiss", "React", "ComposedContext", "composeContexts", "map", "id", "root", "Component", "key", "contexts", "children", "topologicalSort", "context", "reduce", "Acc", "Next", "React", "useEffect", "useLayoutEffect", "useRef", "ThemeProvider", "defaultTx", "mx", "Placeholder", "stage", "progress", "logo", "location", "search", "Error", "fraction", "window", "__bootLoader", "humanizedName", "status", "event", "module", "humanized", "dismiss", "stageRef", "current", "logoClassName", "tx", "div", "className"]
+}

package/dist/lib/node-esm/{chunk-HI3YBICQ.mjs → chunk-HTBJU5FX.mjs}

@@ -1,7 +1,7 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 import {
   getModuleTag
-} from "./chunk-42KBWDE4.mjs";
+} from "./chunk-SDJ4B2LU.mjs";
 import {
   __export
 } from "./chunk-HSLMI22Q.mjs";
@@ -9,22 +9,27 @@ import {
 // src/core/plugin.ts
 var plugin_exports = {};
 __export(plugin_exports, {
+  LazyPluginError: () => LazyPluginError,
   PluginModuleTypeId: () => PluginModuleTypeId,
   PluginTypeId: () => PluginTypeId,
   Service: () => Service,
   activate: () => activate,
   addModule: () => addModule,
   define: () => define,
+  isLazy: () => isLazy,
   isPlugin: () => isPlugin,
   isPluginModule: () => isPluginModule,
+  lazy: () => lazy,
   make: () => make,
   reset: () => reset,
+  resolveLazy: () => resolveLazy,
   shutdown: () => shutdown
 });
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import * as Pipeable from "effect/Pipeable";
+import { BaseError } from "@dxos/errors";
 import { invariant } from "@dxos/invariant";
 var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/plugin.ts";
 var Service = class extends Context.Tag("@dxos/app-framework/PluginManager")() {
@@ -103,15 +108,7 @@ var resolveModule = (meta, module, options) => {
   const id = Option.fromNullable(moduleOptions.id).pipe(Option.match({
     onNone: () => {
       const exportName = getModuleTag(moduleOptions.activate);
-      invariant(exportName, `Plugin module missing name. Plugin: ${meta.id}`, {
-        F: __dxlog_file,
-        L: 330,
-        S: void 0,
-        A: [
-          "exportName",
-          "`Plugin module missing name. Plugin: ${meta.id}`"
-        ]
-      });
+      invariant(exportName, `Plugin module missing name. Plugin: ${meta.id}`, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 131, S: void 0, A: ["exportName", "`Plugin module missing name. Plugin: ${meta.id}`"] });
       return computeModuleId(meta.id, exportName);
     },
     onSome: (id2) => computeModuleId(meta.id, id2)
@@ -131,6 +128,70 @@ function make(builder) {
     meta
   });
 }
+var LazyTag = /* @__PURE__ */ Symbol.for("@dxos/app-framework/Plugin/Lazy");
+var lazy = (meta, loader) => {
+  const factory = (options) => {
+    const stub = new PluginImpl(meta, []);
+    Object.defineProperty(stub, LazyTag, {
+      value: {
+        loader,
+        options
+      },
+      enumerable: false
+    });
+    return stub;
+  };
+  return Object.assign(factory, {
+    meta
+  });
+};
+var isLazy = (plugin) => LazyTag in plugin;
+var LazyPluginError = class extends BaseError.extend("LazyPluginError", "Failed to resolve lazy plugin") {
+};
+var resolveLazy = (plugin) => Effect.gen(function* () {
+  if (!isLazy(plugin)) {
+    return plugin;
+  }
+  const id = plugin.meta.id;
+  const { loader, options } = plugin[LazyTag];
+  const mod = yield* Effect.tryPromise({
+    try: loader,
+    catch: (error) => new LazyPluginError({
+      context: {
+        id,
+        reason: "load-failed"
+      },
+      cause: error
+    })
+  });
+  if (!mod || typeof mod.default !== "function") {
+    return yield* Effect.fail(new LazyPluginError({
+      context: {
+        id,
+        reason: "missing-default"
+      }
+    }));
+  }
+  const result = mod.default(options);
+  if (!isPlugin(result)) {
+    return yield* Effect.fail(new LazyPluginError({
+      context: {
+        id,
+        reason: "invalid-plugin"
+      }
+    }));
+  }
+  if (result.meta.id !== id) {
+    return yield* Effect.fail(new LazyPluginError({
+      context: {
+        id,
+        reason: "meta-mismatch",
+        returnedId: result.meta.id
+      }
+    }));
+  }
+  return result;
+});
 
 export {
   Service,
@@ -144,6 +205,10 @@ export {
   define,
   addModule,
   make,
+  lazy,
+  isLazy,
+  LazyPluginError,
+  resolveLazy,
   plugin_exports
 };
-//# sourceMappingURL=chunk-HI3YBICQ.mjs.map
+//# sourceMappingURL=chunk-HTBJU5FX.mjs.map