@dxos/app-framework 0.8.4-main.b97322e → 0.8.4-main.c4373fc

package/dist/lib/node-esm/{chunk-73HGSHKE.mjs → chunk-AHCD4UYO.mjs}

@@ -3,7 +3,7 @@ import {
   Capabilities,
   Events,
   PluginManager
-} from "./chunk-ZEZ4FVEU.mjs";
+} from "./chunk-7DNZQ6H2.mjs";
 
 // src/react/PluginManagerProvider.ts
 import { createContext, useContext } from "react";
@@ -24,7 +24,7 @@ var useCapability = (interfaceDef) => {
   const capabilities = useCapabilities(interfaceDef);
   invariant(capabilities.length > 0, `No capability found for ${interfaceDef.identifier}`, {
     F: __dxlog_file,
-    L: 28,
+    L: 29,
     S: void 0,
     A: [
       "capabilities.length > 0",
@@ -40,14 +40,22 @@ var useAppGraph = () => useCapability(Capabilities.AppGraph);
 var useLayout = () => useCapability(Capabilities.Layout);
 
 // src/react/ErrorBoundary.tsx
+import { useSignals as _useSignals } from "@preact-signals/safe-react/tracking";
 import React, { Component } from "react";
-var ErrorBoundary = class extends Component {
-  constructor(props) {
-    super(props);
-    this.state = {
-      error: void 0
-    };
+function _define_property(obj, key, value) {
+  if (key in obj) {
+    Object.defineProperty(obj, key, {
+      value,
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  } else {
+    obj[key] = value;
   }
+  return obj;
+}
+var ErrorBoundary = class extends Component {
   static getDerivedStateFromError(error) {
     return {
       error
@@ -60,10 +68,10 @@ var ErrorBoundary = class extends Component {
   }
   render() {
     if (this.state.error) {
-      return /* @__PURE__ */ React.createElement(this.props.fallback, {
+      const Fallback = this.props.fallback ?? DefaultFallback;
+      return /* @__PURE__ */ React.createElement(Fallback, {
         data: this.props.data,
-        error: this.state.error,
-        reset: this.resetError
+        error: this.state.error
       });
     }
     return this.props.children;
@@ -73,11 +81,30 @@ var ErrorBoundary = class extends Component {
       error: void 0
     });
   }
+  constructor(...args) {
+    super(...args), _define_property(this, "state", {
+      error: void 0
+    });
+  }
+};
+var DefaultFallback = ({ data, error }) => {
+  var _effect = _useSignals();
+  try {
+    return /* @__PURE__ */ React.createElement("div", {
+      className: "flex flex-col gap-2 overflow-hidden border border-red-500 rounded-sm"
+    }, /* @__PURE__ */ React.createElement("h1", {
+      className: "p-2"
+    }, "ERROR: ", error.message), /* @__PURE__ */ React.createElement("pre", {
+      className: "p-2 overflow-y-auto text-sm text-subdued"
+    }, JSON.stringify(data, null, 2)));
+  } finally {
+    _effect.f();
+  }
 };
 
 // src/react/Surface.tsx
-import { useSignals as _useSignals } from "@preact-signals/safe-react/tracking";
-import React2, { memo, forwardRef, Suspense, useMemo, Fragment } from "react";
+import { useSignals as _useSignals2 } from "@preact-signals/safe-react/tracking";
+import React2, { Fragment, Suspense, forwardRef, memo, useMemo } from "react";
 import { useDefaultValue } from "@dxos/react-hooks";
 import { byPosition } from "@dxos/util";
 var DEFAULT_PLACEHOLDER = /* @__PURE__ */ React2.createElement(Fragment, null);
@@ -99,7 +126,7 @@ var isSurfaceAvailable = (context, { role, data }) => {
   return candidates.length > 0;
 };
 var Surface = /* @__PURE__ */ memo(/* @__PURE__ */ forwardRef(({ id: _id, role, data: _data, limit, fallback, placeholder = DEFAULT_PLACEHOLDER, ...rest }, forwardedRef) => {
-  var _effect = _useSignals();
+  var _effect = _useSignals2();
   try {
     const surfaces = useSurfaces();
     const data = useDefaultValue(_data, () => ({}));
@@ -147,14 +174,17 @@ var useIntentResolver = (module, resolver) => {
   ]);
 };
 
-// src/App.tsx
-import { useSignals as _useSignals2 } from "@preact-signals/safe-react/tracking";
+// src/components/useApp.tsx
 import { RegistryContext } from "@effect-rx/rx-react";
 import { effect } from "@preact/signals-core";
-import React3, { useCallback, useEffect as useEffect2, useMemo as useMemo2, useState } from "react";
+import React5, { useCallback, useEffect as useEffect3, useMemo as useMemo2 } from "react";
 import { invariant as invariant2 } from "@dxos/invariant";
 import { live } from "@dxos/live-object";
-import { useDefaultValue as useDefaultValue2 } from "@dxos/react-hooks";
+import { useAsyncEffect, useDefaultValue as useDefaultValue2 } from "@dxos/react-hooks";
+
+// src/components/App.tsx
+import { useSignals as _useSignals3 } from "@preact-signals/safe-react/tracking";
+import React3 from "react";
 
 // src/helpers.ts
 var topologicalSort = (nodes) => {
@@ -187,10 +217,125 @@ var topologicalSort = (nodes) => {
   return allDependencies.map((id) => nodes.find((node) => node.id === id)).filter((node) => node !== void 0);
 };
 
-// src/App.tsx
-var __dxlog_file2 = "/__w/dxos/dxos/packages/sdk/app-framework/src/App.tsx";
+// src/components/useLoading.tsx
+import { useEffect as useEffect2, useState } from "react";
+var LoadingState = /* @__PURE__ */ (function(LoadingState2) {
+  LoadingState2[LoadingState2["Loading"] = 0] = "Loading";
+  LoadingState2[LoadingState2["FadeIn"] = 1] = "FadeIn";
+  LoadingState2[LoadingState2["FadeOut"] = 2] = "FadeOut";
+  LoadingState2[LoadingState2["Done"] = 3] = "Done";
+  return LoadingState2;
+})({});
+var useLoading = (state, debounce = 0) => {
+  const [stage, setStage] = useState(0);
+  useEffect2(() => {
+    if (!debounce) {
+      return;
+    }
+    const i = setInterval(() => {
+      setStage((stage2) => {
+        switch (stage2) {
+          case 0: {
+            if (!state.ready) {
+              return 1;
+            } else {
+              clearInterval(i);
+              return 3;
+            }
+          }
+          case 1: {
+            if (state.ready) {
+              return 2;
+            }
+            break;
+          }
+          case 2: {
+            clearInterval(i);
+            return 3;
+          }
+        }
+        return stage2;
+      });
+    }, debounce);
+    return () => clearInterval(i);
+  }, [
+    debounce
+  ]);
+  if (!debounce) {
+    return state.ready ? 3 : 0;
+  }
+  return stage;
+};
+
+// src/components/App.tsx
+var App = ({ placeholder: Placeholder, state, debounce }) => {
+  var _effect = _useSignals3();
+  try {
+    const reactContexts = useCapabilities(Capabilities.ReactContext);
+    const reactRoots = useCapabilities(Capabilities.ReactRoot);
+    const stage = useLoading(state, debounce);
+    if (state.error) {
+      throw state.error;
+    }
+    if (stage < LoadingState.Done) {
+      if (!Placeholder) {
+        return null;
+      }
+      return /* @__PURE__ */ React3.createElement(Placeholder, {
+        stage
+      });
+    }
+    const ComposedContext = composeContexts(reactContexts);
+    return /* @__PURE__ */ React3.createElement(ComposedContext, null, reactRoots.map(({ id, root: Component2 }) => /* @__PURE__ */ React3.createElement(Component2, {
+      key: id
+    })));
+  } finally {
+    _effect.f();
+  }
+};
+var composeContexts = (contexts) => {
+  if (contexts.length === 0) {
+    return ({ children }) => /* @__PURE__ */ React3.createElement(React3.Fragment, null, children);
+  }
+  return topologicalSort(contexts).map(({ context }) => context).reduce((Acc, Next) => ({ children }) => /* @__PURE__ */ React3.createElement(Acc, null, /* @__PURE__ */ React3.createElement(Next, null, children)));
+};
+
+// src/components/DefaultFallback.tsx
+import { useSignals as _useSignals4 } from "@preact-signals/safe-react/tracking";
+import React4 from "react";
+var DefaultFallback2 = ({ error }) => {
+  var _effect = _useSignals4();
+  try {
+    return /* @__PURE__ */ React4.createElement("div", {
+      style: {
+        margin: "1rem",
+        padding: "1rem",
+        overflow: "hidden",
+        border: "4px solid teal",
+        borderRadius: "1rem"
+      }
+    }, /* @__PURE__ */ React4.createElement("h1", {
+      style: {
+        margin: "0.5rem 0",
+        fontSize: "1.2rem"
+      }
+    }, "[ERROR]: ", error.message), /* @__PURE__ */ React4.createElement("pre", {
+      style: {
+        overflow: "auto",
+        fontSize: "1rem",
+        whiteSpace: "pre-wrap",
+        color: "#888888"
+      }
+    }, error.stack));
+  } finally {
+    _effect.f();
+  }
+};
+
+// src/components/useApp.tsx
+var __dxlog_file2 = "/__w/dxos/dxos/packages/sdk/app-framework/src/components/useApp.tsx";
 var ENABLED_KEY = "dxos.org/app-framework/enabled";
-var useApp = ({ pluginManager, pluginLoader: _pluginLoader, plugins: _plugins, core: _core, defaults: _defaults, placeholder, fallback = DefaultFallback, cacheEnabled = false, safeMode = false }) => {
+var useApp = ({ pluginManager, pluginLoader: _pluginLoader, plugins: _plugins, core: _core, defaults: _defaults, placeholder, fallback = DefaultFallback2, cacheEnabled = false, safeMode = false, debounce = 0 }) => {
   const plugins = useDefaultValue2(_plugins, () => []);
   const core = useDefaultValue2(_core, () => plugins.map(({ meta }) => meta.id));
   const defaults = useDefaultValue2(_defaults, () => []);
@@ -198,7 +343,7 @@ var useApp = ({ pluginManager, pluginLoader: _pluginLoader, plugins: _plugins, c
     const plugin = plugins.find((plugin2) => plugin2.meta.id === id);
     invariant2(plugin, `Plugin not found: ${id}`, {
       F: __dxlog_file2,
-      L: 78,
+      L: 82,
       S: void 0,
       A: [
         "plugin",
@@ -233,7 +378,7 @@ var useApp = ({ pluginManager, pluginLoader: _pluginLoader, plugins: _plugins, c
     core,
     enabled
   ]);
-  useEffect2(() => {
+  useEffect3(() => {
     return manager.activation.on(({ event, state: _state, error }) => {
       if (!state.ready && event === Events.Startup.id) {
         state.ready = _state === "activated";
@@ -246,7 +391,7 @@ var useApp = ({ pluginManager, pluginLoader: _pluginLoader, plugins: _plugins, c
     manager,
     state
   ]);
-  useEffect2(() => {
+  useEffect3(() => {
     effect(() => {
       cacheEnabled && localStorage.setItem(ENABLED_KEY, JSON.stringify(manager.enabled));
     });
@@ -254,7 +399,12 @@ var useApp = ({ pluginManager, pluginLoader: _pluginLoader, plugins: _plugins, c
     cacheEnabled,
     manager
   ]);
-  useEffect2(() => {
+  useEffect3(() => {
+    setupDevtools(manager);
+  }, [
+    manager
+  ]);
+  useAsyncEffect(async () => {
     manager.context.contributeCapability({
       interface: Capabilities.PluginManager,
       implementation: manager,
@@ -265,6 +415,11 @@ var useApp = ({ pluginManager, pluginLoader: _pluginLoader, plugins: _plugins, c
       implementation: manager.registry,
       module: "dxos.org/app-framework/rx-registry"
     });
+    await Promise.all([
+      // TODO(wittjosiah): Factor out such that this could be called per surface role when attempting to render.
+      manager.activate(Events.SetupReactSurface),
+      manager.activate(Events.Startup)
+    ]);
     return () => {
       manager.context.removeCapability(Capabilities.PluginManager, manager);
       manager.context.removeCapability(Capabilities.RxRegistry, manager.registry);
@@ -272,32 +427,16 @@ var useApp = ({ pluginManager, pluginLoader: _pluginLoader, plugins: _plugins, c
   }, [
     manager
   ]);
-  useEffect2(() => {
-    setupDevtools(manager);
-  }, [
-    manager
-  ]);
-  useEffect2(() => {
-    const timeout = setTimeout(async () => {
-      await Promise.all([
-        // TODO(wittjosiah): Factor out such that this could be called per surface role when attempting to render.
-        manager.activate(Events.SetupReactSurface),
-        manager.activate(Events.Startup)
-      ]);
-    });
-    return () => clearTimeout(timeout);
-  }, [
-    manager
-  ]);
-  return useCallback(() => /* @__PURE__ */ React3.createElement(ErrorBoundary, {
+  return useCallback(() => /* @__PURE__ */ React5.createElement(ErrorBoundary, {
     fallback
-  }, /* @__PURE__ */ React3.createElement(PluginManagerProvider, {
+  }, /* @__PURE__ */ React5.createElement(PluginManagerProvider, {
     value: manager
-  }, /* @__PURE__ */ React3.createElement(RegistryContext.Provider, {
+  }, /* @__PURE__ */ React5.createElement(RegistryContext.Provider, {
     value: manager.registry
-  }, /* @__PURE__ */ React3.createElement(App, {
+  }, /* @__PURE__ */ React5.createElement(App, {
     placeholder,
-    state
+    state,
+    debounce
   })))), [
     fallback,
     manager,
@@ -305,96 +444,9 @@ var useApp = ({ pluginManager, pluginLoader: _pluginLoader, plugins: _plugins, c
     state
   ]);
 };
-var DELAY_PLACEHOLDER = 2e3;
-var useLoading = (state) => {
-  const [stage, setStage] = useState(0);
-  useEffect2(() => {
-    const i = setInterval(() => {
-      setStage((tick) => {
-        switch (tick) {
-          case 0:
-            if (!state.ready) {
-              return 1;
-            } else {
-              clearInterval(i);
-              return 3;
-            }
-          case 1:
-            if (state.ready) {
-              return 2;
-            }
-            break;
-          case 2:
-            clearInterval(i);
-            return 3;
-        }
-        return tick;
-      });
-    }, DELAY_PLACEHOLDER);
-    return () => clearInterval(i);
-  }, []);
-  return stage;
-};
-var App = ({ placeholder: Placeholder, state }) => {
-  var _effect = _useSignals2();
-  try {
-    const reactContexts = useCapabilities(Capabilities.ReactContext);
-    const reactRoots = useCapabilities(Capabilities.ReactRoot);
-    const stage = useLoading(state);
-    if (state.error) {
-      throw state.error;
-    }
-    if (stage < 3) {
-      if (!Placeholder) {
-        return null;
-      }
-      return /* @__PURE__ */ React3.createElement(Placeholder, {
-        stage
-      });
-    }
-    const ComposedContext = composeContexts(reactContexts);
-    return /* @__PURE__ */ React3.createElement(ComposedContext, null, reactRoots.map(({ id, root: Component2 }) => /* @__PURE__ */ React3.createElement(Component2, {
-      key: id
-    })));
-  } finally {
-    _effect.f();
-  }
-};
-var DefaultFallback = ({ error }) => {
-  var _effect = _useSignals2();
-  try {
-    return /* @__PURE__ */ React3.createElement("div", {
-      style: {
-        margin: "0.5rem",
-        padding: "1rem",
-        overflow: "hidden",
-        border: "1px solid red"
-      }
-    }, /* @__PURE__ */ React3.createElement("h1", {
-      style: {
-        margin: "0.5rem 0",
-        fontSize: "1.2rem"
-      }
-    }, "[ERROR]: ", error.message), /* @__PURE__ */ React3.createElement("pre", {
-      style: {
-        overflow: "auto",
-        fontSize: "1rem",
-        whiteSpace: "pre-wrap",
-        color: "#888888"
-      }
-    }, error.stack));
-  } finally {
-    _effect.f();
-  }
-};
-var composeContexts = (contexts) => {
-  if (contexts.length === 0) {
-    return ({ children }) => /* @__PURE__ */ React3.createElement(React3.Fragment, null, children);
-  }
-  return topologicalSort(contexts).map(({ context }) => context).reduce((Acc, Next) => ({ children }) => /* @__PURE__ */ React3.createElement(Acc, null, /* @__PURE__ */ React3.createElement(Next, null, children)));
-};
 var setupDevtools = (manager) => {
-  globalThis.composer ??= {};
+  var _globalThis;
+  (_globalThis = globalThis).composer ?? (_globalThis.composer = {});
   globalThis.composer.manager = manager;
 };
 
@@ -413,4 +465,4 @@ export {
   useIntentResolver,
   useApp
 };
-//# sourceMappingURL=chunk-73HGSHKE.mjs.map
+//# sourceMappingURL=chunk-AHCD4UYO.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/react/PluginManagerProvider.ts", "../../../src/react/useCapabilities.ts", "../../../src/react/common.ts", "../../../src/react/ErrorBoundary.tsx", "../../../src/react/Surface.tsx", "../../../src/react/useIntentResolver.ts", "../../../src/components/useApp.tsx", "../../../src/components/App.tsx", "../../../src/helpers.ts", "../../../src/components/useLoading.tsx", "../../../src/components/DefaultFallback.tsx"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { createContext, useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { type PluginManager } from '../core';\n\nconst PluginManagerContext = createContext<PluginManager | undefined>(undefined);\n\n/**\n * Get the plugin manager.\n */\nexport const usePluginManager = (): PluginManager =>\n  useContext(PluginManagerContext) ?? raise(new Error('Missing PluginManagerContext'));\n\n/**\n * Context provider for a plugin manager.\n */\nexport const PluginManagerProvider = PluginManagerContext.Provider;\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useRxValue } from '@effect-rx/rx-react';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { type InterfaceDef } from '../core';\n\nimport { usePluginManager } from './PluginManagerProvider';\n\n/**\n * Hook to request capabilities from the plugin context.\n * @returns An array of capabilities.\n */\nexport const useCapabilities = <T>(interfaceDef: InterfaceDef<T>) => {\n  const manager = usePluginManager();\n  return useRxValue(manager.context.capabilities(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: 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// Copyright 2025 DXOS.org\n//\n\nimport { Capabilities } from '../common';\n\nimport { useCapability } from './useCapabilities';\n\nexport const useIntentDispatcher = () => useCapability(Capabilities.IntentDispatcher);\n\nexport const useAppGraph = () => useCapability(Capabilities.AppGraph);\n\nexport const useLayout = () => useCapability(Capabilities.Layout);\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { Component, type FC, type PropsWithChildren, type ReactNode } from 'react';\n\ntype State = {\n  error: Error | undefined;\n};\n\nexport type ErrorBoundaryProps = PropsWithChildren<{\n  data?: any;\n  fallback?: FC<{ data?: any; error: Error }>;\n}>;\n\n/**\n * Surface error boundary.\n * For basic usage prefer providing a fallback component to `Surface`.\n *\n * Ref: https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary\n */\nexport class ErrorBoundary extends Component<ErrorBoundaryProps, State> {\n  static getDerivedStateFromError(error: Error): { error: Error } {\n    return { error };\n  }\n\n  override state = { error: undefined };\n\n  override componentDidUpdate(prevProps: ErrorBoundaryProps): void {\n    if (prevProps.data !== this.props.data) {\n      this.resetError();\n    }\n  }\n\n  override render(): ReactNode {\n    if (this.state.error) {\n      const Fallback = this.props.fallback ?? DefaultFallback;\n      return <Fallback data={this.props.data} error={this.state.error} />;\n    }\n\n    return this.props.children;\n  }\n\n  private resetError(): void {\n    this.setState({ error: undefined });\n  }\n}\n\nconst DefaultFallback: NonNullable<ErrorBoundaryProps['fallback']> = ({ data, error }) => {\n  return (\n    <div className='flex flex-col gap-2 overflow-hidden border border-red-500 rounded-sm'>\n      <h1 className='p-2'>ERROR: {error.message}</h1>\n      <pre className='p-2 overflow-y-auto text-sm text-subdued'>{JSON.stringify(data, null, 2)}</pre>\n    </div>\n  );\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React, {\n  Fragment,\n  type NamedExoticComponent,\n  type RefAttributes,\n  Suspense,\n  forwardRef,\n  memo,\n  useMemo,\n} from 'react';\n\nimport { useDefaultValue } from '@dxos/react-hooks';\nimport { byPosition } from '@dxos/util';\n\nimport { Capabilities, type SurfaceDefinition, type SurfaceProps } from '../common';\nimport { type PluginContext } from '../core';\n\nimport { ErrorBoundary } from './ErrorBoundary';\nimport { useCapabilities } from './useCapabilities';\n\nconst DEFAULT_PLACEHOLDER = <Fragment />;\n\n/**\n * @internal\n */\nexport const useSurfaces = () => {\n  const surfaces = useCapabilities(Capabilities.ReactSurface);\n  return useMemo(() => surfaces.flat(), [surfaces]);\n};\n\nconst findCandidates = (surfaces: SurfaceDefinition[], { role, data }: Pick<SurfaceProps, 'role' | 'data'>) => {\n  return Object.values(surfaces)\n    .filter((definition) =>\n      Array.isArray(definition.role) ? definition.role.includes(role) : definition.role === role,\n    )\n    .filter(({ filter }) => (filter ? filter(data ?? {}) : true))\n    .toSorted(byPosition);\n};\n\n/**\n * @returns `true` if there is a contributed surface which matches the specified role & data, `false` otherwise.\n */\nexport const isSurfaceAvailable = (context: PluginContext, { role, data }: Pick<SurfaceProps, 'role' | 'data'>) => {\n  const surfaces = context.getCapabilities(Capabilities.ReactSurface);\n  const candidates = findCandidates(surfaces.flat(), { role, data });\n  return candidates.length > 0;\n};\n\n/**\n * A surface is a named region of the screen that can be populated by plugins.\n */\nexport const Surface: NamedExoticComponent<SurfaceProps & RefAttributes<HTMLElement>> = memo(\n  forwardRef(\n    ({ id: _id, role, data: _data, limit, fallback, placeholder = DEFAULT_PLACEHOLDER, ...rest }, forwardedRef) => {\n      // TODO(wittjosiah): This will make all surfaces depend on a single signal.\n      //   This isn't ideal because it means that any change to the data will cause all surfaces to re-render.\n      //   This effectively means that plugin modules which contribute surfaces need to all be activated at startup.\n      //   This should be fine for now because it's how it worked prior to capabilities api anyways.\n      //   In the future, it would be nice to be able to bucket the surface contributions by role.\n      const surfaces = useSurfaces();\n      const data = useDefaultValue(_data, () => ({}));\n\n      // NOTE: Memoizing the candidates makes the surface not re-render based on reactivity within data.\n      const definitions = findCandidates(surfaces, { role, data });\n      const candidates = limit ? definitions.slice(0, limit) : definitions;\n      const nodes = candidates.map(({ component: Component, id }) => (\n        <Component ref={forwardedRef} key={id} id={id} role={role} data={data} limit={limit} {...rest} />\n      ));\n\n      const suspense = <Suspense fallback={placeholder}>{nodes}</Suspense>;\n\n      return fallback ? (\n        <ErrorBoundary data={data} fallback={fallback}>\n          {suspense}\n        </ErrorBoundary>\n      ) : (\n        suspense\n      );\n    },\n  ),\n);\n\nSurface.displayName = 'Surface';\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { useEffect } from 'react';\n\nimport { Capabilities } from '../common';\nimport { type AnyIntentResolver } from '../plugin-intent';\nimport { usePluginManager } from '../react';\n\nexport const useIntentResolver = (module: string, resolver: AnyIntentResolver) => {\n  const manager = usePluginManager();\n  useEffect(() => {\n    manager.context.contributeCapability({\n      module,\n      interface: Capabilities.IntentResolver,\n      implementation: resolver,\n    });\n\n    return () => manager.context.removeCapability(Capabilities.IntentResolver, resolver);\n  }, [module, resolver]);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { RegistryContext } from '@effect-rx/rx-react';\nimport { effect } from '@preact/signals-core';\nimport React, { type FC, useCallback, useEffect, useMemo } from 'react';\n\nimport { invariant } from '@dxos/invariant';\nimport { live } from '@dxos/live-object';\nimport { useAsyncEffect, useDefaultValue } from '@dxos/react-hooks';\n\nimport { Capabilities, Events } from '../common';\nimport { type Plugin, PluginManager, type PluginManagerOptions } from '../core';\nimport { ErrorBoundary, PluginManagerProvider } from '../react';\n\nimport { App } from './App';\nimport { DefaultFallback } from './DefaultFallback';\n\nconst ENABLED_KEY = 'dxos.org/app-framework/enabled';\n\nexport type UseAppOptions = {\n  pluginManager?: PluginManager;\n  pluginLoader?: PluginManagerOptions['pluginLoader'];\n  plugins?: Plugin[];\n  core?: string[];\n  defaults?: string[];\n  placeholder?: FC<{ stage: number }>;\n  fallback?: ErrorBoundary['props']['fallback'];\n  cacheEnabled?: boolean;\n  safeMode?: boolean;\n  debounce?: number;\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.placeholder Placeholder component to render during startup.\n * @param params.fallback Fallback component to render if an error occurs during startup.\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 */\nexport const useApp = ({\n  pluginManager,\n  pluginLoader: _pluginLoader,\n  plugins: _plugins,\n  core: _core,\n  defaults: _defaults,\n  placeholder,\n  fallback = DefaultFallback,\n  cacheEnabled = false,\n  safeMode = false,\n  debounce = 0,\n}: UseAppOptions) => {\n  const plugins = useDefaultValue(_plugins, () => []);\n  const core = useDefaultValue(_core, () => plugins.map(({ meta }) => meta.id));\n  const defaults = useDefaultValue(_defaults, () => []);\n\n  // TODO(wittjosiah): Provide a custom plugin loader which supports loading via url.\n  const pluginLoader = useMemo(\n    () =>\n      _pluginLoader ??\n      ((id: string) => {\n        const plugin = plugins.find((plugin) => plugin.meta.id === id);\n        invariant(plugin, `Plugin not found: ${id}`);\n        return plugin;\n      }),\n    [_pluginLoader, plugins],\n  );\n\n  const state = useMemo(() => live({ ready: false, error: null }), []);\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 manager = useMemo(\n    () => pluginManager ?? new PluginManager({ pluginLoader, plugins, core, enabled }),\n    [pluginManager, pluginLoader, plugins, core, enabled],\n  );\n\n  useEffect(() => {\n    return manager.activation.on(({ event, state: _state, error }) => {\n      // Once the app is ready the first time, don't show the fallback again.\n      if (!state.ready && event === Events.Startup.id) {\n        state.ready = _state === 'activated';\n      }\n\n      if (error && !state.ready && !state.error) {\n        state.error = error;\n      }\n    });\n  }, [manager, state]);\n\n  useEffect(() => {\n    effect(() => {\n      cacheEnabled && localStorage.setItem(ENABLED_KEY, JSON.stringify(manager.enabled));\n    });\n  }, [cacheEnabled, manager]);\n\n  useEffect(() => {\n    setupDevtools(manager);\n  }, [manager]);\n\n  useAsyncEffect(async () => {\n    manager.context.contributeCapability({\n      interface: Capabilities.PluginManager,\n      implementation: manager,\n      module: 'dxos.org/app-framework/plugin-manager',\n    });\n\n    manager.context.contributeCapability({\n      interface: Capabilities.RxRegistry,\n      implementation: manager.registry,\n      module: 'dxos.org/app-framework/rx-registry',\n    });\n\n    await Promise.all([\n      // TODO(wittjosiah): Factor out such that this could be called per surface role when attempting to render.\n      manager.activate(Events.SetupReactSurface),\n      manager.activate(Events.Startup),\n    ]);\n\n    return () => {\n      manager.context.removeCapability(Capabilities.PluginManager, manager);\n      manager.context.removeCapability(Capabilities.RxRegistry, manager.registry);\n    };\n  }, [manager]);\n\n  return useCallback(\n    () => (\n      <ErrorBoundary fallback={fallback}>\n        <PluginManagerProvider value={manager}>\n          <RegistryContext.Provider value={manager.registry}>\n            <App placeholder={placeholder} state={state} debounce={debounce} />\n          </RegistryContext.Provider>\n        </PluginManagerProvider>\n      </ErrorBoundary>\n    ),\n    [fallback, manager, placeholder, state],\n  );\n};\n\nconst setupDevtools = (manager: PluginManager) => {\n  (globalThis as any).composer ??= {};\n  (globalThis as any).composer.manager = manager;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { type PropsWithChildren } from 'react';\n\nimport { Capabilities } from '../common';\nimport { topologicalSort } from '../helpers';\nimport { useCapabilities } from '../react';\n\nimport { type UseAppOptions } from './useApp';\nimport { LoadingState, useLoading } from './useLoading';\n\nexport type AppProps = Pick<UseAppOptions, 'placeholder' | 'debounce'> & {\n  state: { ready: boolean; error: unknown };\n};\n\nexport const App = ({ placeholder: Placeholder, state, debounce }: AppProps) => {\n  const reactContexts = useCapabilities(Capabilities.ReactContext);\n  const reactRoots = useCapabilities(Capabilities.ReactRoot);\n  const stage = useLoading(state, debounce);\n\n  if (state.error) {\n    // This triggers the error boundary to provide UI feedback for the startup error.\n    throw state.error;\n  }\n\n  // TODO(wittjosiah): Consider using Suspense instead.\n  if (stage < LoadingState.Done) {\n    if (!Placeholder) {\n      return null;\n    }\n\n    return <Placeholder stage={stage} />;\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\ntype DependencyNode = {\n  id: string;\n  dependsOn?: string[];\n};\n\n/**\n * Topologically sorts a list of nodes based on their dependencies.\n */\n// TODO(wittjosiah): Factor out?\nexport const topologicalSort = <T extends DependencyNode>(nodes: T[]): T[] => {\n  const getDependencies = (nodeId: string, seen = new Set<string>(), path = new Set<string>()): string[] => {\n    if (path.has(nodeId)) {\n      throw new Error(`Circular dependency detected involving ${nodeId}`);\n    }\n    if (seen.has(nodeId)) {\n      return [];\n    }\n\n    const node = nodes.find((n) => n.id === nodeId);\n    if (!node) {\n      throw new Error(`Node ${nodeId} not found but is listed as a dependency`);\n    }\n\n    const newPath = new Set([...path, nodeId]);\n    const newSeen = new Set([...seen, nodeId]);\n\n    const dependsOn = node.dependsOn ?? [];\n    return [...dependsOn.flatMap((depId) => getDependencies(depId, newSeen, newPath)), nodeId];\n  };\n\n  // Get all unique dependencies.\n  const allDependencies = nodes\n    .map((node) => node.id)\n    .flatMap((id) => getDependencies(id))\n    .filter((id, index, self) => self.indexOf(id) === index);\n\n  // Map back to original nodes\n  return allDependencies\n    .map((id) => nodes.find((node) => node.id === id))\n    .filter((node): node is T => node !== undefined);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useEffect, useState } from 'react';\n\nimport { type AppProps } from './App';\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 = (state: AppProps['state'], debounce = 0) => {\n  const [stage, setStage] = useState<LoadingState>(LoadingState.Loading);\n  useEffect(() => {\n    if (!debounce) {\n      return;\n    }\n\n    const i = setInterval(() => {\n      setStage((stage) => {\n        switch (stage) {\n          case LoadingState.Loading: {\n            if (!state.ready) {\n              return LoadingState.FadeIn;\n            } else {\n              clearInterval(i);\n              return LoadingState.Done;\n            }\n          }\n\n          case LoadingState.FadeIn: {\n            if (state.ready) {\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 state.ready ? LoadingState.Done : LoadingState.Loading;\n  }\n\n  return stage;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React from 'react';\n\n/**\n * NOTE: Default fallback should not use tailwind or theme.\n */\nexport const DefaultFallback = ({ error }: { error: Error }) => {\n  return (\n    <div\n      style={{\n        margin: '1rem',\n        padding: '1rem',\n        overflow: 'hidden',\n        border: '4px solid teal',\n        borderRadius: '1rem',\n      }}\n    >\n      {/* TODO(wittjosiah): Link to docs for replacing default. */}\n      <h1 style={{ margin: '0.5rem 0', fontSize: '1.2rem' }}>[ERROR]: {error.message}</h1>\n      <pre style={{ overflow: 'auto', fontSize: '1rem', whiteSpace: 'pre-wrap', color: '#888888' }}>{error.stack}</pre>\n    </div>\n  );\n};\n"],
+  "mappings": "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",
+  "names": ["createContext", "useContext", "raise", "PluginManagerContext", "createContext", "undefined", "usePluginManager", "useContext", "raise", "Error", "PluginManagerProvider", "Provider", "useRxValue", "invariant", "useCapabilities", "interfaceDef", "manager", "usePluginManager", "useRxValue", "context", "capabilities", "useCapability", "invariant", "length", "identifier", "useIntentDispatcher", "useCapability", "Capabilities", "IntentDispatcher", "useAppGraph", "AppGraph", "useLayout", "Layout", "React", "Component", "ErrorBoundary", "Component", "getDerivedStateFromError", "error", "componentDidUpdate", "prevProps", "data", "props", "resetError", "render", "state", "Fallback", "fallback", "DefaultFallback", "children", "setState", "undefined", "div", "className", "h1", "message", "pre", "JSON", "stringify", "React", "Fragment", "Suspense", "forwardRef", "memo", "useMemo", "useDefaultValue", "byPosition", "DEFAULT_PLACEHOLDER", "React", "Fragment", "useSurfaces", "surfaces", "useCapabilities", "Capabilities", "ReactSurface", "useMemo", "flat", "findCandidates", "role", "data", "Object", "values", "filter", "definition", "Array", "isArray", "includes", "toSorted", "byPosition", "isSurfaceAvailable", "context", "getCapabilities", "candidates", "length", "Surface", "memo", "forwardRef", "id", "_id", "_data", "limit", "fallback", "placeholder", "rest", "forwardedRef", "useDefaultValue", "definitions", "slice", "nodes", "map", "component", "Component", "ref", "key", "suspense", "Suspense", "ErrorBoundary", "displayName", "useEffect", "useIntentResolver", "module", "resolver", "manager", "usePluginManager", "useEffect", "context", "contributeCapability", "interface", "Capabilities", "IntentResolver", "implementation", "removeCapability", "RegistryContext", "effect", "React", "useCallback", "useEffect", "useMemo", "invariant", "live", "useAsyncEffect", "useDefaultValue", "React", "topologicalSort", "nodes", "getDependencies", "nodeId", "seen", "Set", "path", "has", "Error", "node", "find", "n", "id", "newPath", "newSeen", "dependsOn", "flatMap", "depId", "allDependencies", "map", "filter", "index", "self", "indexOf", "undefined", "useEffect", "useState", "LoadingState", "useLoading", "state", "debounce", "stage", "setStage", "useState", "useEffect", "i", "setInterval", "ready", "clearInterval", "App", "placeholder", "Placeholder", "state", "debounce", "reactContexts", "useCapabilities", "Capabilities", "ReactContext", "reactRoots", "ReactRoot", "stage", "useLoading", "error", "LoadingState", "Done", "React", "ComposedContext", "composeContexts", "map", "id", "root", "Component", "key", "contexts", "length", "children", "topologicalSort", "context", "reduce", "Acc", "Next", "React", "DefaultFallback", "error", "React", "div", "style", "margin", "padding", "overflow", "border", "borderRadius", "h1", "fontSize", "message", "pre", "whiteSpace", "color", "stack", "ENABLED_KEY", "useApp", "pluginManager", "pluginLoader", "_pluginLoader", "plugins", "_plugins", "core", "_core", "defaults", "_defaults", "placeholder", "fallback", "DefaultFallback", "cacheEnabled", "safeMode", "debounce", "useDefaultValue", "map", "meta", "id", "useMemo", "plugin", "find", "invariant", "state", "live", "ready", "error", "cached", "JSON", "parse", "localStorage", "getItem", "enabled", "length", "manager", "PluginManager", "useEffect", "activation", "on", "event", "_state", "Events", "Startup", "effect", "setItem", "stringify", "setupDevtools", "useAsyncEffect", "context", "contributeCapability", "interface", "Capabilities", "implementation", "module", "RxRegistry", "registry", "Promise", "all", "activate", "SetupReactSurface", "removeCapability", "useCallback", "React", "ErrorBoundary", "PluginManagerProvider", "value", "RegistryContext", "Provider", "App", "globalThis", "composer"]
+}

package/dist/lib/node-esm/{chunk-UMZQERLE.mjs → chunk-ZX63QUGE.mjs}

@@ -1,13 +1,17 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 
+// src/plugin-settings/meta.ts
+var meta = {
+  id: "dxos.org/plugin/settings",
+  name: "Settings"
+};
+
 // src/plugin-settings/actions.ts
-import { Schema } from "effect";
-var SETTINGS_PLUGIN = "dxos.org/plugin/settings";
-var SETTINGS_ACTION = `${SETTINGS_PLUGIN}/action`;
+import * as Schema from "effect/Schema";
 var SETTINGS_ID = "!dxos:settings";
 var SETTINGS_KEY = "settings";
 (function(SettingsAction2) {
-  class Open extends Schema.TaggedClass()(`${SETTINGS_ACTION}/open`, {
+  class Open extends Schema.TaggedClass()(`${meta.id}/open`, {
     input: Schema.Struct({
       plugin: Schema.optional(Schema.String)
     }),
@@ -15,7 +19,7 @@ var SETTINGS_KEY = "settings";
   }) {
   }
   SettingsAction2.Open = Open;
-  class OpenPluginRegistry extends Schema.TaggedClass()(`${SETTINGS_ACTION}/open-plugin-registry`, {
+  class OpenPluginRegistry extends Schema.TaggedClass()(`${meta.id}/open-plugin-registry`, {
     input: Schema.Void,
     output: Schema.Void
   }) {
@@ -25,10 +29,9 @@ var SETTINGS_KEY = "settings";
 var SettingsAction;
 
 export {
-  SETTINGS_PLUGIN,
-  SETTINGS_ACTION,
+  meta,
   SETTINGS_ID,
   SETTINGS_KEY,
   SettingsAction
 };
-//# sourceMappingURL=chunk-UMZQERLE.mjs.map
+//# sourceMappingURL=chunk-ZX63QUGE.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugin-settings/meta.ts", "../../../src/plugin-settings/actions.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type PluginMeta } from '@dxos/app-framework';\n\nexport const meta: PluginMeta = {\n  id: 'dxos.org/plugin/settings',\n  name: 'Settings',\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { meta } from './meta';\n\n// TODO(burdon): Document.\nexport const SETTINGS_ID = '!dxos:settings';\nexport const SETTINGS_KEY = 'settings';\n\nexport namespace SettingsAction {\n  export class Open extends Schema.TaggedClass<Open>()(`${meta.id}/open`, {\n    input: Schema.Struct({\n      plugin: Schema.optional(Schema.String),\n    }),\n    output: Schema.Void,\n  }) {}\n\n  export class OpenPluginRegistry extends Schema.TaggedClass<OpenPluginRegistry>()(`${meta.id}/open-plugin-registry`, {\n    input: Schema.Void,\n    output: Schema.Void,\n  }) {}\n}\n"],
+  "mappings": ";;;AAMO,IAAMA,OAAmB;EAC9BC,IAAI;EACJC,MAAM;AACR;;;ACLA,YAAYC,YAAY;AAKjB,IAAMC,cAAc;AACpB,IAAMC,eAAe;UAEXC,iBAAAA;EACR,MAAMC,aAAoBC,mBAAW,EAAS,GAAGC,KAAKC,EAAE,SAAS;IACtEC,OAAcC,cAAO;MACnBC,QAAeC,gBAAgBC,aAAM;IACvC,CAAA;IACAC,QAAeC;EACjB,CAAA,EAAA;EAAI;kBALSV,OAAAA;EAON,MAAMW,2BAAkCV,mBAAW,EAAuB,GAAGC,KAAKC,EAAE,yBAAyB;IAClHC,OAAcM;IACdD,QAAeC;EACjB,CAAA,EAAA;EAAI;kBAHSC,qBAAAA;AAIf,GAZiBZ,mBAAAA,iBAAAA,CAAAA,EAAAA;;",
+  "names": ["meta", "id", "name", "Schema", "SETTINGS_ID", "SETTINGS_KEY", "SettingsAction", "Open", "TaggedClass", "meta", "id", "input", "Struct", "plugin", "optional", "String", "output", "Void", "OpenPluginRegistry"]
+}