@dxos/app-framework 0.7.4 → 0.7.5-labs.071a3e2

package/src/react/useCapabilities.ts

@@ -0,0 +1,40 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { computed } from '@preact/signals-core';
+import { useMemo } from 'react';
+
+import { usePluginManager } from './PluginManagerProvider';
+import { type InterfaceDef } from '../core';
+
+/**
+ * Hook to request capabilities from the plugin context.
+ * @returns An array of capabilities.
+ */
+export const useCapabilities = <T, U extends T = T>(
+  interfaceDef: InterfaceDef<T>,
+  filter?: (capability: T, moduleId: string) => capability is U,
+) => {
+  const manager = usePluginManager();
+  const signal = useMemo(
+    () => computed(() => manager.context.requestCapabilities(interfaceDef, filter)),
+    [interfaceDef],
+  );
+
+  return signal.value;
+};
+
+/**
+ * Hook to request a capability from the plugin context.
+ * @returns The capability.
+ * @throws If no capability is found.
+ */
+export const useCapability = <T, U extends T = T>(
+  interfaceDef: InterfaceDef<T>,
+  filter?: (capability: T, moduleId: string) => capability is U,
+) => {
+  const manager = usePluginManager();
+  const signal = useMemo(() => computed(() => manager.context.requestCapability(interfaceDef, filter)), [interfaceDef]);
+  return signal.value;
+};

package/src/react/useIntentResolver.ts

@@ -0,0 +1,22 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { useEffect } from 'react';
+
+import { Capabilities } from '../common';
+import { type AnyIntentResolver } from '../plugin-intent';
+import { usePluginManager } from '../react';
+
+export const useIntentResolver = (module: string, resolver: AnyIntentResolver) => {
+  const manager = usePluginManager();
+  useEffect(() => {
+    manager.context.contributeCapability({
+      module,
+      interface: Capabilities.IntentResolver,
+      implementation: resolver,
+    });
+
+    return () => manager.context.removeCapability(Capabilities.IntentResolver, resolver);
+  }, [module, resolver]);
+};

package/src/testing/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export * from './withPluginManager';

package/src/testing/withPluginManager.stories.tsx

@@ -0,0 +1,47 @@
+//
+// Copyright 2025 DXOS.org
+
+//
+
+import React from 'react';
+
+import { withTheme, type Meta } from '@dxos/storybook-utils';
+
+import { withPluginManager } from './withPluginManager';
+import { Capabilities, createSurface } from '../common';
+import { contributes } from '../core';
+import { Surface } from '../react';
+
+const Render = () => {
+  console.log('Render');
+  return (
+    <div>
+      <div>Hello</div>
+      <Surface role='main' />
+    </div>
+  );
+};
+
+const meta: Meta = {
+  title: 'sdk/app-framework/withPluginManager',
+  render: Render,
+  decorators: [
+    withTheme,
+    withPluginManager({
+      capabilities: [
+        contributes(
+          Capabilities.ReactSurface,
+          createSurface({
+            id: 'test',
+            role: 'main',
+            component: ({ role }) => <span>{JSON.stringify({ role })}</span>,
+          }),
+        ),
+      ],
+    }),
+  ],
+};
+
+export default meta;
+
+export const Default = {};

package/src/testing/withPluginManager.tsx

@@ -0,0 +1,75 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type Decorator } from '@storybook/react';
+import React, { useEffect } from 'react';
+
+import { raise } from '@dxos/debug';
+
+import { createApp, type CreateAppOptions } from '../App';
+import { Capabilities, Events } from '../common';
+import { type AnyCapability, contributes, defineModule, definePlugin, PluginManager } from '../core';
+
+/**
+ * @internal
+ */
+export const setupPluginManager = ({
+  capabilities,
+  plugins = [],
+  core = plugins.map(({ meta }) => meta.id),
+  ...options
+}: CreateAppOptions & { capabilities?: AnyCapability[] } = {}) => {
+  const pluginManager = new PluginManager({
+    pluginLoader: () => raise(new Error('Not implemented')),
+    plugins: [StoryPlugin(), ...plugins],
+    core: [STORY_PLUGIN, ...core],
+    ...options,
+  });
+
+  if (capabilities) {
+    capabilities.forEach((capability) => {
+      pluginManager.context.contributeCapability({
+        interface: capability.interface,
+        implementation: capability.implementation,
+        module: 'story',
+      });
+    });
+  }
+
+  return pluginManager;
+};
+
+/**
+ * Wraps a story with a plugin manager.
+ */
+export const withPluginManager = (options: CreateAppOptions & { capabilities?: AnyCapability[] } = {}): Decorator => {
+  const pluginManager = setupPluginManager(options);
+  const App = createApp({ pluginManager });
+
+  return (Story, context) => {
+    useEffect(() => {
+      const capability = contributes(Capabilities.ReactRoot, {
+        id: context.id,
+        root: () => <Story />,
+      });
+
+      pluginManager.context.contributeCapability({
+        ...capability,
+        module: 'dxos.org/app-framework/withPluginManager',
+      });
+
+      return () => pluginManager.context.removeCapability(capability.interface, capability.implementation);
+    }, []);
+
+    return <App />;
+  };
+};
+
+// No-op plugin to ensure there exists at least one plugin for the startup event.
+// This is necessary because `createApp` expects the startup event to complete before the app is ready.
+const STORY_PLUGIN = 'dxos.org/app-framework/story';
+const StoryPlugin = () =>
+  definePlugin({ id: STORY_PLUGIN }, [
+    defineModule({ id: STORY_PLUGIN, activatesOn: Events.Startup, activate: () => [] }),
+  ]);

package/src/worker.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// Entrypoint for using plugins in workers runtimes (e.g. Cloudflare Workers, etc.)
+// Excludes all frontend code & dependencies (e.g. localStorage, React, etc.)
+
+export * from './core';
+// NOTE: Common includes browser capabilities but they are types only.
+export * from './common';
+export * from './plugin-intent';

package/tsconfig.json

@@ -8,7 +8,7 @@
       "ESNext"
     ],
     "module": "ESNext",
-    "outDir": "dist"
+    "outDir": "./dist/types"
   },
   "exclude": [
     "/node_modules/"
@@ -16,7 +16,59 @@
   "include": [
     "src"
   ],
-  "references": [],
+  "references": [
+    {
+      "path": "../../common/async"
+    },
+    {
+      "path": "../../common/debug"
+    },
+    {
+      "path": "../../common/invariant"
+    },
+    {
+      "path": "../../common/local-storage"
+    },
+    {
+      "path": "../../common/log"
+    },
+    {
+      "path": "../../common/random"
+    },
+    {
+      "path": "../../common/storybook-utils"
+    },
+    {
+      "path": "../../common/util"
+    },
+    {
+      "path": "../../core/echo/echo-schema"
+    },
+    {
+      "path": "../../core/echo/echo-signals"
+    },
+    {
+      "path": "../../core/echo/live-object"
+    },
+    {
+      "path": "../../experimental/artifact"
+    },
+    {
+      "path": "../../ui/primitives/react-hooks"
+    },
+    {
+      "path": "../../ui/react-ui"
+    },
+    {
+      "path": "../../ui/react-ui-syntax-highlighter"
+    },
+    {
+      "path": "../app-graph"
+    },
+    {
+      "path": "../client-protocol"
+    }
+  ],
   "ts-node": {
     "compilerOptions": {
       "module": "CommonJS"

package/dist/lib/browser/chunk-3E7RY3CE.mjs

@@ -1,72 +0,0 @@
-// packages/sdk/app-framework/src/plugins/helpers.ts
-import { Context } from "@dxos/context";
-import { raise } from "@dxos/debug";
-import { invariant } from "@dxos/invariant";
-var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/app-framework/src/plugins/helpers.ts";
-var findPlugin = (plugins, id) => {
-  return plugins.find((plugin) => plugin.meta.id === id || typeof plugin.meta.shortId === "string" && plugin.meta.shortId === id);
-};
-var getPlugin = (plugins, id) => {
-  return findPlugin(plugins, id) ?? raise(new Error(`Plugin not found: ${id}`));
-};
-var filterPlugins = (plugins, predicate) => plugins.map((plugin) => predicate(plugin)).filter((plugin) => !!plugin);
-var resolvePlugin = (plugins, predicate) => filterPlugins(plugins, predicate)[0];
-var PluginContext = class {
-  constructor() {
-    // TODO(burdon): Use Resource (@dima)?
-    this.ctx = new Context(void 0, {
-      F: __dxlog_file,
-      L: 50
-    });
-  }
-  init(plugins) {
-    this._plugins = plugins;
-  }
-  getPlugin(id) {
-    invariant(this._plugins, void 0, {
-      F: __dxlog_file,
-      L: 59,
-      S: this,
-      A: [
-        "this._plugins",
-        ""
-      ]
-    });
-    return getPlugin(this._plugins, id);
-  }
-  resolvePlugin(resolver, required = false) {
-    invariant(this._plugins, "context not initialized", {
-      F: __dxlog_file,
-      L: 65,
-      S: this,
-      A: [
-        "this._plugins",
-        "'context not initialized'"
-      ]
-    });
-    const plugin = resolvePlugin(this._plugins, resolver);
-    if (required && !plugin) {
-      throw new Error("Plugin not found.");
-    }
-    return plugin;
-  }
-  onDispose(cb) {
-    this.ctx.onDispose(cb);
-  }
-  dispose() {
-    void this.ctx.dispose();
-  }
-};
-var definePlugin = (cb) => {
-  const context = new PluginContext();
-  return () => cb(context);
-};
-
-export {
-  findPlugin,
-  getPlugin,
-  filterPlugins,
-  resolvePlugin,
-  definePlugin
-};
-//# sourceMappingURL=chunk-3E7RY3CE.mjs.map

package/dist/lib/browser/chunk-3E7RY3CE.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/helpers.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Context, type DisposeCallback } from '@dxos/context';\nimport { raise } from '@dxos/debug';\nimport { invariant } from '@dxos/invariant';\n\nimport { type Plugin, type PluginDefinition } from './plugin-host';\n\n/**\n * Resolvers allow different instances of plugins to provide a particular capability.\n */\nexport type PluginResolver<T> = (plugin: Plugin) => Plugin<T> | undefined;\n\n/**\n * Find a plugin by ID.\n */\nexport const findPlugin = <T>(plugins: Plugin[], id: string): Plugin<T> | undefined => {\n  return plugins.find(\n    (plugin) => plugin.meta.id === id || (typeof plugin.meta.shortId === 'string' && plugin.meta.shortId === id),\n  ) as Plugin<T>;\n};\n\n/**\n * Find a plugin by ID, or raise an error if not found.\n */\nexport const getPlugin = <T>(plugins: Plugin[], id: string): Plugin<T> => {\n  return findPlugin(plugins, id) ?? raise(new Error(`Plugin not found: ${id}`));\n};\n\n/**\n * Filter a list of plugins to only those that match a predicate.\n */\nexport const filterPlugins = <T>(plugins: Plugin[], predicate: PluginResolver<T>): Plugin<T>[] =>\n  plugins.map((plugin) => predicate(plugin)).filter((plugin): plugin is Plugin<T> => !!plugin);\n\n/**\n * Resolves a plugin by predicate.\n *\n * @example\n * import { parseIntentPlugin, resolvePlugin } from '@dxos/app-framework';\n * const intentPlugin = resolvePlugin(plugins, parseIntentPlugin);\n */\nexport const resolvePlugin = <T>(plugins: Plugin[], predicate: PluginResolver<T>): Plugin<T> | undefined =>\n  filterPlugins(plugins, predicate)[0];\n\nclass PluginContext {\n  // TODO(burdon): Use Resource (@dima)?\n  public readonly ctx = new Context();\n\n  private _plugins?: Plugin[];\n\n  init(plugins: Plugin[]) {\n    this._plugins = plugins;\n  }\n\n  getPlugin<T>(id: string): Plugin<T> {\n    invariant(this._plugins);\n    return getPlugin(this._plugins, id);\n  }\n\n  resolvePlugin<T>(resolver: PluginResolver<T>): Plugin<T>;\n  resolvePlugin<T>(resolver: PluginResolver<T>, required = false): Plugin<T> | undefined {\n    invariant(this._plugins, 'context not initialized');\n    const plugin = resolvePlugin(this._plugins, resolver);\n    if (required && !plugin) {\n      // TODO(burdon): Resolver should have a name.\n      throw new Error('Plugin not found.');\n    }\n\n    return plugin;\n  }\n\n  onDispose(cb: DisposeCallback) {\n    this.ctx.onDispose(cb);\n  }\n\n  dispose() {\n    void this.ctx.dispose();\n  }\n}\n\n/**\n * Plugin helper with dependency injection and life-cycle support.\n */\nexport const definePlugin = <Provides>(\n  cb: (context: PluginContext) => PluginDefinition<Provides>,\n): (() => PluginDefinition<Provides>) => {\n  const context = new PluginContext();\n  return () => cb(context);\n};\n"],
-  "mappings": ";AAIA,SAASA,eAAqC;AAC9C,SAASC,aAAa;AACtB,SAASC,iBAAiB;;AAYnB,IAAMC,aAAa,CAAIC,SAAmBC,OAAAA;AAC/C,SAAOD,QAAQE,KACb,CAACC,WAAWA,OAAOC,KAAKH,OAAOA,MAAO,OAAOE,OAAOC,KAAKC,YAAY,YAAYF,OAAOC,KAAKC,YAAYJ,EAAAA;AAE7G;AAKO,IAAMK,YAAY,CAAIN,SAAmBC,OAAAA;AAC9C,SAAOF,WAAWC,SAASC,EAAAA,KAAOJ,MAAM,IAAIU,MAAM,qBAAqBN,EAAAA,EAAI,CAAA;AAC7E;AAKO,IAAMO,gBAAgB,CAAIR,SAAmBS,cAClDT,QAAQU,IAAI,CAACP,WAAWM,UAAUN,MAAAA,CAAAA,EAASQ,OAAO,CAACR,WAAgC,CAAC,CAACA,MAAAA;AAShF,IAAMS,gBAAgB,CAAIZ,SAAmBS,cAClDD,cAAcR,SAASS,SAAAA,EAAW,CAAA;AAEpC,IAAMI,gBAAN,MAAMA;EAAN;AAEkBC;eAAM,IAAIlB,QAAAA,QAAAA;;;;;EAI1BmB,KAAKf,SAAmB;AACtB,SAAKgB,WAAWhB;EAClB;EAEAM,UAAaL,IAAuB;AAClCH,cAAU,KAAKkB,UAAQ,QAAA;;;;;;;;;AACvB,WAAOV,UAAU,KAAKU,UAAUf,EAAAA;EAClC;EAGAW,cAAiBK,UAA6BC,WAAW,OAA8B;AACrFpB,cAAU,KAAKkB,UAAU,2BAAA;;;;;;;;;AACzB,UAAMb,SAASS,cAAc,KAAKI,UAAUC,QAAAA;AAC5C,QAAIC,YAAY,CAACf,QAAQ;AAEvB,YAAM,IAAII,MAAM,mBAAA;IAClB;AAEA,WAAOJ;EACT;EAEAgB,UAAUC,IAAqB;AAC7B,SAAKN,IAAIK,UAAUC,EAAAA;EACrB;EAEAC,UAAU;AACR,SAAK,KAAKP,IAAIO,QAAO;EACvB;AACF;AAKO,IAAMC,eAAe,CAC1BF,OAAAA;AAEA,QAAMG,UAAU,IAAIV,cAAAA;AACpB,SAAO,MAAMO,GAAGG,OAAAA;AAClB;",
-  "names": ["Context", "raise", "invariant", "findPlugin", "plugins", "id", "find", "plugin", "meta", "shortId", "getPlugin", "Error", "filterPlugins", "predicate", "map", "filter", "resolvePlugin", "PluginContext", "ctx", "init", "_plugins", "resolver", "required", "onDispose", "cb", "dispose", "definePlugin", "context"]
-}

package/dist/lib/browser/chunk-653Y45CL.mjs

@@ -1,41 +0,0 @@
-// packages/sdk/app-framework/src/plugins/plugin-settings/SettingsPlugin.tsx
-import { RootSettingsStore } from "@dxos/local-storage";
-
-// packages/sdk/app-framework/src/plugins/plugin-settings/meta.ts
-var SettingsMeta = {
-  id: "dxos.org/plugin/settings"
-};
-var meta_default = SettingsMeta;
-
-// packages/sdk/app-framework/src/plugins/plugin-settings/SettingsPlugin.tsx
-var SettingsPlugin = () => {
-  const settingsStore = new RootSettingsStore();
-  return {
-    meta: meta_default,
-    provides: {
-      settingsStore
-    }
-  };
-};
-
-// packages/sdk/app-framework/src/plugins/plugin-settings/provides.ts
-var parseSettingsPlugin = (plugin) => {
-  return typeof plugin.provides.settingsStore === "object" ? plugin : void 0;
-};
-var SETTINGS_PLUGIN = "dxos.org/plugin/settings";
-var SETTINGS_ACTION = `${SETTINGS_PLUGIN}/action`;
-var SettingsAction;
-(function(SettingsAction2) {
-  SettingsAction2[SettingsAction2["OPEN"] = `${SETTINGS_ACTION}/open`] = "OPEN";
-})(SettingsAction || (SettingsAction = {}));
-
-// packages/sdk/app-framework/src/plugins/plugin-settings/index.ts
-var plugin_settings_default = SettingsPlugin;
-
-export {
-  meta_default,
-  parseSettingsPlugin,
-  SettingsAction,
-  plugin_settings_default
-};
-//# sourceMappingURL=chunk-653Y45CL.mjs.map

package/dist/lib/browser/chunk-653Y45CL.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/plugin-settings/SettingsPlugin.tsx", "../../../src/plugins/plugin-settings/meta.ts", "../../../src/plugins/plugin-settings/provides.ts", "../../../src/plugins/plugin-settings/index.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { RootSettingsStore } from '@dxos/local-storage';\n\nimport SettingsMeta from './meta';\nimport { type SettingsPluginProvides } from './provides';\nimport { type PluginDefinition } from '../plugin-host';\n\nexport const SettingsPlugin = (): PluginDefinition<SettingsPluginProvides> => {\n  // Global settings singleton.\n  // TODO(burdon): Make settings storage extensible so that other plugins can decide the persistence of them.\n  const settingsStore = new RootSettingsStore();\n\n  return {\n    meta: SettingsMeta,\n    provides: {\n      settingsStore,\n    },\n  };\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nconst SettingsMeta = {\n  id: 'dxos.org/plugin/settings',\n};\n\nexport default SettingsMeta;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type SettingsStoreFactory, type SettingsValue } from '@dxos/local-storage';\n\nimport { type Plugin } from '../plugin-host';\n\nexport type SettingsProvides<T extends SettingsValue> = {\n  settings: T;\n};\n\nexport type SettingsPluginProvides = {\n  settingsStore: SettingsStoreFactory;\n};\n\nexport const parseSettingsPlugin = (plugin: Plugin) => {\n  return typeof (plugin.provides as any).settingsStore === 'object'\n    ? (plugin as Plugin<SettingsPluginProvides>)\n    : undefined;\n};\n\nconst SETTINGS_PLUGIN = 'dxos.org/plugin/settings';\n\nconst SETTINGS_ACTION = `${SETTINGS_PLUGIN}/action`;\n\nexport enum SettingsAction {\n  OPEN = `${SETTINGS_ACTION}/open`,\n}\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { SettingsPlugin } from './SettingsPlugin';\n\nexport * from './provides';\n\nexport default SettingsPlugin;\n"],
-  "mappings": ";AAIA,SAASA,yBAAyB;;;ACAlC,IAAMC,eAAe;EACnBC,IAAI;AACN;AAEA,IAAA,eAAeD;;;ADER,IAAME,iBAAiB,MAAA;AAG5B,QAAMC,gBAAgB,IAAIC,kBAAAA;AAE1B,SAAO;IACLC,MAAMC;IACNC,UAAU;MACRJ;IACF;EACF;AACF;;;AELO,IAAMK,sBAAsB,CAACC,WAAAA;AAClC,SAAO,OAAQA,OAAOC,SAAiBC,kBAAkB,WACpDF,SACDG;AACN;AAEA,IAAMC,kBAAkB;AAExB,IAAMC,kBAAkB,GAAGD,eAAAA;;UAEfE,iBAAAA;4CACH,GAAGD,eAAAA,OAAsB,IAAA;GADtBC,mBAAAA,iBAAAA,CAAAA,EAAAA;;;AClBZ,IAAA,0BAAeC;",
-  "names": ["RootSettingsStore", "SettingsMeta", "id", "SettingsPlugin", "settingsStore", "RootSettingsStore", "meta", "SettingsMeta", "provides", "parseSettingsPlugin", "plugin", "provides", "settingsStore", "undefined", "SETTINGS_PLUGIN", "SETTINGS_ACTION", "SettingsAction", "SettingsPlugin"]
-}

package/dist/lib/browser/chunk-FRXJ25VI.mjs

@@ -1,214 +0,0 @@
-import {
-  filterPlugins
-} from "./chunk-3E7RY3CE.mjs";
-
-// packages/sdk/app-framework/src/plugins/plugin-surface/SurfacePlugin.tsx
-import React from "react";
-import { create } from "@dxos/live-object";
-
-// packages/sdk/app-framework/src/plugins/plugin-surface/SurfaceRootContext.tsx
-import { createContext, useContext } from "react";
-import { raise } from "@dxos/debug";
-var SurfaceRootContext = /* @__PURE__ */ createContext(void 0);
-var useSurfaceRoot = () => useContext(SurfaceRootContext) ?? raise(new Error("Missing SurfaceRootContext"));
-var SurfaceProvider = SurfaceRootContext.Provider;
-
-// packages/sdk/app-framework/src/plugins/plugin-surface/meta.ts
-var SurfaceMeta = {
-  id: "dxos.org/plugin/surface"
-};
-var meta_default = SurfaceMeta;
-
-// packages/sdk/app-framework/src/plugins/plugin-surface/provides.ts
-var parseRootSurfacePlugin = (plugin) => plugin?.provides?.surface?.components ? plugin : void 0;
-var parseSurfacePlugin = (plugin) => plugin?.provides?.surface?.component ? plugin : void 0;
-
-// packages/sdk/app-framework/src/plugins/plugin-surface/SurfacePlugin.tsx
-var SurfacePlugin = () => {
-  const state = create({
-    components: {},
-    debugInfo: /* @__PURE__ */ new Map()
-  });
-  return {
-    meta: meta_default,
-    ready: async (plugins) => {
-      state.components = filterPlugins(plugins, parseSurfacePlugin).reduce((acc, plugin) => {
-        return {
-          ...acc,
-          [plugin.meta.id]: plugin.provides.surface.component
-        };
-      }, {});
-    },
-    provides: {
-      surface: state,
-      context: ({ children }) => /* @__PURE__ */ React.createElement(SurfaceProvider, {
-        value: state
-      }, children)
-    }
-  };
-};
-
-// packages/sdk/app-framework/src/plugins/plugin-surface/helpers.ts
-var isObject = (data) => !!data && typeof data === "object";
-
-// packages/sdk/app-framework/src/plugins/plugin-surface/ErrorBoundary.tsx
-import React2, { Component } from "react";
-var ErrorBoundary = class extends Component {
-  constructor(props) {
-    super(props);
-    this.state = {
-      error: void 0
-    };
-  }
-  static getDerivedStateFromError(error) {
-    return {
-      error
-    };
-  }
-  componentDidUpdate(prevProps) {
-    if (prevProps.data !== this.props.data) {
-      this.resetError();
-    }
-  }
-  render() {
-    if (this.state.error) {
-      return /* @__PURE__ */ React2.createElement(this.props.fallback, {
-        data: this.props.data,
-        error: this.state.error,
-        reset: this.resetError
-      });
-    }
-    return this.props.children;
-  }
-  resetError() {
-    this.setState({
-      error: void 0
-    });
-  }
-};
-
-// packages/sdk/app-framework/src/plugins/plugin-surface/Surface.tsx
-import React3, { Fragment, Suspense, createContext as createContext2, forwardRef, isValidElement, memo, useContext as useContext2, useEffect, useState } from "react";
-import { raise as raise2 } from "@dxos/debug";
-import { log } from "@dxos/log";
-var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/app-framework/src/plugins/plugin-surface/Surface.tsx";
-var count = 0;
-var Surface = /* @__PURE__ */ memo(/* @__PURE__ */ forwardRef(({ id: _id, role, name = role, fallback, placeholder, ...rest }, forwardedRef) => {
-  const props = {
-    role,
-    name,
-    fallback,
-    ...rest
-  };
-  const { debugInfo } = useSurfaceRoot();
-  const [id] = useState(() => _id ?? `surface-${++count}`);
-  useEffect(() => {
-    debugInfo?.set(id, {
-      id,
-      created: Date.now(),
-      name,
-      role,
-      renderCount: 0
-    });
-    return () => {
-      debugInfo?.delete(id);
-    };
-  }, [
-    id
-  ]);
-  if (debugInfo?.get(id)) {
-    debugInfo.get(id).renderCount++;
-  }
-  const context = useContext2(SurfaceContext);
-  const data = props.data ?? (name && context?.surfaces?.[name]?.data || {});
-  const resolver = /* @__PURE__ */ React3.createElement(SurfaceResolver, {
-    ...props,
-    id,
-    ref: forwardedRef
-  });
-  const suspense = placeholder ? /* @__PURE__ */ React3.createElement(Suspense, {
-    fallback: placeholder
-  }, resolver) : resolver;
-  return fallback ? /* @__PURE__ */ React3.createElement(ErrorBoundary, {
-    data,
-    fallback
-  }, suspense) : suspense;
-}));
-var SurfaceContext = /* @__PURE__ */ createContext2(void 0);
-var useSurface = () => useContext2(SurfaceContext) ?? raise2(new Error("Surface context not found"));
-var SurfaceResolver = /* @__PURE__ */ forwardRef((props, forwardedRef) => {
-  const { components } = useSurfaceRoot();
-  const parent = useContext2(SurfaceContext);
-  const nodes = resolveNodes(components, props, parent, forwardedRef);
-  const currentContext = {
-    ...props,
-    surfaces: {
-      ...props.name && parent?.surfaces?.[props.name]?.surfaces || {},
-      ...props.surfaces
-    }
-  };
-  return /* @__PURE__ */ React3.createElement(SurfaceContext.Provider, {
-    value: currentContext
-  }, nodes);
-});
-var resolveNodes = (components, props, context, forwardedRef) => {
-  const data = {
-    ...props.name && context?.surfaces?.[props.name]?.data || {},
-    ...props.data
-  };
-  const candidates = Object.entries(components).map(([key, component]) => {
-    const result = component({
-      ...props,
-      data
-    }, forwardedRef);
-    if (!result || typeof result !== "object") {
-      return void 0;
-    }
-    if ("node" in result) {
-      return [
-        key,
-        result
-      ];
-    } else if (/* @__PURE__ */ isValidElement(result)) {
-      return [
-        key,
-        {
-          node: result
-        }
-      ];
-    } else {
-      log.warn("invalid result", {
-        result
-      }, {
-        F: __dxlog_file,
-        L: 183,
-        S: void 0,
-        C: (f, a) => f(...a)
-      });
-      return void 0;
-    }
-  }).filter((result) => Boolean(result)).sort(([, { disposition: a = "default" }], [, { disposition: b = "default" }]) => {
-    return a === b ? 0 : a === "hoist" || b === "fallback" ? -1 : b === "hoist" || a === "fallback" ? 1 : 0;
-  });
-  const nodes = candidates.map(([key, result]) => /* @__PURE__ */ React3.createElement(Fragment, {
-    key
-  }, result.node));
-  return props.limit ? nodes.slice(0, props.limit) : nodes;
-};
-
-// packages/sdk/app-framework/src/plugins/plugin-surface/index.ts
-var plugin_surface_default = SurfacePlugin;
-
-export {
-  useSurfaceRoot,
-  SurfaceProvider,
-  meta_default,
-  parseRootSurfacePlugin,
-  parseSurfacePlugin,
-  isObject,
-  ErrorBoundary,
-  Surface,
-  useSurface,
-  plugin_surface_default
-};
-//# sourceMappingURL=chunk-FRXJ25VI.mjs.map