@dxos/app-framework 0.6.13 → 0.6.14-main.1366248

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

@@ -0,0 +1,72 @@
+// 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

@@ -0,0 +1,7 @@
+{
+  "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

@@ -0,0 +1,41 @@
+// 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

@@ -0,0 +1,7 @@
+{
+  "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/{plugin-MM66VRCO.mjs → chunk-CDLQO5K2.mjs}

@@ -1,24 +1,60 @@
-import {
-  IntentAction,
-  IntentProvider,
-  meta_default,
-  parseIntentResolverPlugin
-} from "./chunk-J45KR4DI.mjs";
 import {
   filterPlugins,
   findPlugin
-} from "./chunk-S5CI6EUQ.mjs";
+} from "./chunk-3E7RY3CE.mjs";
 
-// packages/sdk/app-framework/src/plugins/IntentPlugin/plugin.tsx
+// packages/sdk/app-framework/src/plugins/plugin-intent/IntentPlugin.tsx
 import React from "react";
 import { create } from "@dxos/echo-schema";
 import { log } from "@dxos/log";
 
-// packages/sdk/app-framework/src/plugins/IntentPlugin/helpers.ts
+// packages/sdk/app-framework/src/plugins/plugin-intent/IntentContext.tsx
+import { createContext, useContext } from "react";
+import { useEffect } from "react";
+var IntentContext = /* @__PURE__ */ createContext({
+  dispatch: async () => ({}),
+  undo: async () => ({}),
+  history: [],
+  registerResolver: () => () => {
+  }
+});
+var useIntent = () => useContext(IntentContext);
+var useIntentDispatcher = () => {
+  const { dispatch } = useIntent();
+  return dispatch;
+};
+var useIntentResolver = (plugin, resolver) => {
+  const { registerResolver } = useIntent();
+  useEffect(() => {
+    return registerResolver(plugin, resolver);
+  }, [
+    plugin,
+    resolver
+  ]);
+};
+var IntentProvider = IntentContext.Provider;
+
+// packages/sdk/app-framework/src/plugins/plugin-intent/helpers.ts
 var isUndoable = (chain) => chain.length > 0 && chain.every(({ result }) => result.undoable);
 
-// packages/sdk/app-framework/src/plugins/IntentPlugin/plugin.tsx
-var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/app-framework/src/plugins/IntentPlugin/plugin.tsx";
+// packages/sdk/app-framework/src/plugins/plugin-intent/meta.ts
+var IntentMeta = {
+  id: "dxos.org/plugin/intent"
+};
+var meta_default = IntentMeta;
+
+// packages/sdk/app-framework/src/plugins/plugin-intent/provides.ts
+var parseIntentPlugin = (plugin) => plugin.provides.intent?.dispatch ? plugin : void 0;
+var parseIntentResolverPlugin = (plugin) => plugin.provides.intent?.resolver ? plugin : void 0;
+var INTENT_PLUGIN = "dxos.org/plugin/intent";
+var INTENT_ACTION = `${INTENT_PLUGIN}/action`;
+var IntentAction;
+(function(IntentAction2) {
+  IntentAction2[IntentAction2["SHOW_UNDO"] = `${INTENT_ACTION}/show-undo`] = "SHOW_UNDO";
+})(IntentAction || (IntentAction = {}));
+
+// packages/sdk/app-framework/src/plugins/plugin-intent/IntentPlugin.tsx
+var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/app-framework/src/plugins/plugin-intent/IntentPlugin.tsx";
 var EXECUTION_LIMIT = 1e3;
 var HISTORY_LIMIT = 100;
 var IntentPlugin = () => {
@@ -46,15 +82,14 @@ var IntentPlugin = () => {
         if (intent.plugin) {
           for (const entry of dynamicResolvers) {
             if (entry.plugin === intent.plugin) {
-              const result2 = await entry.resolver(intent, plugins);
-              if (result2) {
-                return result2;
+              const result = await entry.resolver(intent, plugins);
+              if (result) {
+                return result;
               }
             }
           }
           const plugin = findPlugin(plugins, intent.plugin);
-          const result = plugin?.provides.intent.resolver(intent, plugins);
-          return result;
+          return plugin?.provides.intent.resolver(intent, plugins);
         }
         for (const entry of dynamicResolvers) {
           const result = await entry.resolver(intent, plugins);
@@ -71,7 +106,7 @@ var IntentPlugin = () => {
         if (import.meta?.env?.DEV) {
           log.warn("No plugin found to handle intent", intent, {
             F: __dxlog_file,
-            L: 79,
+            L: 78,
             S: void 0,
             C: (f, a) => f(...a)
           });
@@ -160,8 +195,19 @@ var IntentPlugin = () => {
     }
   };
 };
-var plugin_default = IntentPlugin;
+
+// packages/sdk/app-framework/src/plugins/plugin-intent/index.ts
+var plugin_intent_default = IntentPlugin;
+
 export {
-  plugin_default as default
+  useIntent,
+  useIntentDispatcher,
+  useIntentResolver,
+  IntentProvider,
+  meta_default,
+  parseIntentPlugin,
+  parseIntentResolverPlugin,
+  IntentAction,
+  plugin_intent_default
 };
-//# sourceMappingURL=plugin-MM66VRCO.mjs.map
+//# sourceMappingURL=chunk-CDLQO5K2.mjs.map

package/dist/lib/browser/chunk-CDLQO5K2.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugins/plugin-intent/IntentPlugin.tsx", "../../../src/plugins/plugin-intent/IntentContext.tsx", "../../../src/plugins/plugin-intent/helpers.ts", "../../../src/plugins/plugin-intent/meta.ts", "../../../src/plugins/plugin-intent/provides.ts", "../../../src/plugins/plugin-intent/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { create } from '@dxos/echo-schema';\nimport { log } from '@dxos/log';\n\nimport { type IntentContext, IntentProvider, type IntentExecution } from './IntentContext';\nimport { isUndoable } from './helpers';\nimport type { Intent, IntentResolver } from './intent';\nimport IntentMeta from './meta';\nimport {\n  type IntentPluginProvides,\n  type IntentResolverProvides,\n  parseIntentResolverPlugin,\n  IntentAction,\n} from './provides';\nimport { filterPlugins, findPlugin } from '../helpers';\nimport { type PluginDefinition } from '../plugin-host';\n\nconst EXECUTION_LIMIT = 1000;\nconst HISTORY_LIMIT = 100;\n\n/**\n * Allows plugins to register intent handlers and routes sent intents to the appropriate plugin.\n * Inspired by https://developer.android.com/reference/android/content/Intent.\n */\nexport const IntentPlugin = (): PluginDefinition<IntentPluginProvides> => {\n  const state = create<IntentContext>({\n    dispatch: async () => ({}),\n    undo: async () => ({}),\n    history: [],\n    registerResolver: () => () => {},\n  });\n\n  const dynamicResolvers = new Set<{ plugin: string; resolver: IntentResolver }>();\n\n  return {\n    meta: IntentMeta,\n    ready: async (plugins) => {\n      // Dispatch intent to associated plugin.\n      const dispatch = async (intent: Intent) => {\n        log('dispatch', { action: intent.action, intent });\n        if (intent.plugin) {\n          for (const entry of dynamicResolvers) {\n            if (entry.plugin === intent.plugin) {\n              const result = await entry.resolver(intent, plugins);\n              if (result) {\n                return result;\n              }\n            }\n          }\n\n          const plugin = findPlugin<IntentResolverProvides>(plugins, intent.plugin);\n          return plugin?.provides.intent.resolver(intent, plugins);\n        }\n\n        for (const entry of dynamicResolvers) {\n          const result = await entry.resolver(intent, plugins);\n          if (result) {\n            return result;\n          }\n        }\n\n        // Return resolved value from first plugin that handles the intent.\n        for (const plugin of filterPlugins(plugins, parseIntentResolverPlugin)) {\n          const result = await plugin.provides.intent.resolver(intent, plugins);\n          if (result) {\n            return result;\n          }\n        }\n\n        // https://vitejs.dev/guide/env-and-mode#env-variables\n        // TODO(wittjosiah): How to handle this more generically?\n        if (import.meta?.env?.DEV) {\n          log.warn('No plugin found to handle intent', intent);\n        }\n      };\n\n      // Sequentially dispatch array of invents.\n      const dispatchChain = async (intentOrArray: Intent | Intent[], depth = 0) => {\n        if (depth > EXECUTION_LIMIT) {\n          return {\n            error: new Error(\n              `Intent execution limit exceeded (${EXECUTION_LIMIT} iterations). This is likely due to an infinite loop within intent resolvers.`,\n            ),\n          };\n        }\n\n        const executionResults: IntentExecution[] = [];\n        const chain = Array.isArray(intentOrArray) ? intentOrArray : [intentOrArray];\n        for (const intent of chain) {\n          const { result: prevResult } = executionResults.at(-1) ?? {};\n          const data = intent.data ? { result: prevResult?.data, ...intent.data } : prevResult?.data;\n          const result = await dispatch({ ...intent, data });\n\n          if (!result || result?.error) {\n            break;\n          }\n\n          executionResults.push({ intent, result });\n\n          // TODO(wittjosiah): How does undo work with returned intents?\n          result?.intents?.forEach((intents) => {\n            void dispatchChain(intents, depth + 1);\n          });\n        }\n\n        state.history.push(executionResults);\n        if (state.history.length > HISTORY_LIMIT) {\n          state.history.splice(0, state.history.length - HISTORY_LIMIT);\n        }\n\n        if (isUndoable(executionResults)) {\n          void dispatch({ action: IntentAction.SHOW_UNDO, data: { results: executionResults } });\n        }\n\n        return executionResults.at(-1)?.result;\n      };\n\n      const undo = async () => {\n        const last = state.history.findLastIndex(isUndoable);\n        const chain =\n          last !== -1 &&\n          state.history[last]?.map(({ intent, result }): Intent => {\n            const data = result.undoable?.data ? { ...intent.data, ...result.undoable.data } : intent.data;\n            return { ...intent, data, undo: true };\n          });\n        if (chain) {\n          const result = await dispatchChain(chain);\n          state.history = state.history.filter((_, index) => index !== last);\n          return result;\n        }\n      };\n\n      state.dispatch = dispatchChain;\n      state.undo = undo;\n      state.registerResolver = (plugin, resolver) => {\n        const entry = { plugin, resolver };\n        dynamicResolvers.add(entry);\n        return () => dynamicResolvers.delete(entry);\n      };\n    },\n    provides: {\n      intent: state,\n      context: ({ children }) => <IntentProvider value={state}>{children}</IntentProvider>,\n    },\n  };\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Context, createContext, useContext, type Provider } from 'react';\nimport { useEffect } from 'react';\n\nimport type { UnsubscribeCallback } from '@dxos/async';\n\nimport type { Intent, IntentDispatcher, IntentResolver, IntentResult } from './intent';\n\nexport type IntentExecution = {\n  intent: Intent;\n  result: IntentResult;\n};\n\nexport type IntentContext = {\n  dispatch: IntentDispatcher;\n  undo: () => Promise<IntentResult | void>;\n  history: IntentExecution[][];\n  registerResolver: (pluginId: string, resolver: IntentResolver) => UnsubscribeCallback;\n};\n\nconst IntentContext: Context<IntentContext> = createContext<IntentContext>({\n  dispatch: async () => ({}),\n  undo: async () => ({}),\n  history: [],\n  registerResolver: () => () => {},\n});\n\n/**\n * @deprecated Prefer granular hooks.\n */\n// TODO(burdon): Remove. Use useIntentDispatcher.\nexport const useIntent = () => useContext(IntentContext);\n\nexport const useIntentDispatcher = (): IntentDispatcher => {\n  const { dispatch } = useIntent();\n  return dispatch;\n};\n\nexport const useIntentResolver = (plugin: string, resolver: IntentResolver) => {\n  const { registerResolver } = useIntent();\n  useEffect(() => {\n    return registerResolver(plugin, resolver);\n  }, [plugin, resolver]);\n};\n\nexport const IntentProvider: Provider<IntentContext> = IntentContext.Provider;\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type IntentExecution } from './IntentContext';\n\n/**\n * Check if the chain of intents is undoable.\n */\nexport const isUndoable = (chain: IntentExecution[]): boolean =>\n  chain.length > 0 && chain.every(({ result }) => result.undoable);\n", "//\n// Copyright 2023 DXOS.org\n//\n\nconst IntentMeta = {\n  id: 'dxos.org/plugin/intent',\n};\n\nexport default IntentMeta;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type IntentContext } from './IntentContext';\nimport { type IntentResolver } from './intent';\nimport { type Plugin } from '../plugin-host';\n\nexport type IntentResolverProvides = {\n  intent: {\n    resolver: IntentResolver;\n  };\n};\n\nexport type IntentPluginProvides = {\n  intent: IntentContext;\n};\n\nexport const parseIntentPlugin = (plugin: Plugin) =>\n  (plugin.provides as any).intent?.dispatch ? (plugin as Plugin<IntentPluginProvides>) : undefined;\n\nexport const parseIntentResolverPlugin = (plugin: Plugin) =>\n  (plugin.provides as any).intent?.resolver ? (plugin as Plugin<IntentResolverProvides>) : undefined;\n\n//\n// Intents\n//\n\nconst INTENT_PLUGIN = 'dxos.org/plugin/intent';\n\nconst INTENT_ACTION = `${INTENT_PLUGIN}/action`;\n\nexport enum IntentAction {\n  /**\n   * Fired after an intent is dispatched if the intent is undoable.\n   */\n  SHOW_UNDO = `${INTENT_ACTION}/show-undo`,\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { IntentPlugin } from './IntentPlugin';\n\nexport * from './intent';\nexport * from './provides';\n\nexport * from './IntentContext';\n\nexport default IntentPlugin;\n"],
+  "mappings": "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",
+  "names": ["React", "create", "log", "createContext", "useContext", "useEffect", "IntentContext", "createContext", "dispatch", "undo", "history", "registerResolver", "useIntent", "useContext", "useIntentDispatcher", "useIntentResolver", "plugin", "resolver", "useEffect", "IntentProvider", "Provider", "isUndoable", "chain", "length", "every", "result", "undoable", "IntentMeta", "id", "parseIntentPlugin", "plugin", "provides", "intent", "dispatch", "undefined", "parseIntentResolverPlugin", "resolver", "INTENT_PLUGIN", "INTENT_ACTION", "IntentAction", "EXECUTION_LIMIT", "HISTORY_LIMIT", "IntentPlugin", "state", "create", "dispatch", "undo", "history", "registerResolver", "dynamicResolvers", "Set", "meta", "IntentMeta", "ready", "plugins", "intent", "log", "action", "plugin", "entry", "result", "resolver", "findPlugin", "provides", "filterPlugins", "parseIntentResolverPlugin", "env", "DEV", "warn", "dispatchChain", "intentOrArray", "depth", "error", "Error", "executionResults", "chain", "Array", "isArray", "prevResult", "at", "data", "push", "intents", "forEach", "length", "splice", "isUndoable", "IntentAction", "SHOW_UNDO", "results", "last", "findLastIndex", "map", "undoable", "filter", "_", "index", "add", "delete", "context", "children", "IntentProvider", "value", "IntentPlugin"]
+}

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

@@ -0,0 +1,214 @@
+import {
+  filterPlugins
+} from "./chunk-3E7RY3CE.mjs";
+
+// packages/sdk/app-framework/src/plugins/plugin-surface/SurfacePlugin.tsx
+import React from "react";
+import { create } from "@dxos/echo-schema";
+
+// 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-EQTQGGE6.mjs.map

package/dist/lib/browser/chunk-EQTQGGE6.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugins/plugin-surface/SurfacePlugin.tsx", "../../../src/plugins/plugin-surface/SurfaceRootContext.tsx", "../../../src/plugins/plugin-surface/meta.ts", "../../../src/plugins/plugin-surface/provides.ts", "../../../src/plugins/plugin-surface/helpers.ts", "../../../src/plugins/plugin-surface/ErrorBoundary.tsx", "../../../src/plugins/plugin-surface/Surface.tsx", "../../../src/plugins/plugin-surface/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { create } from '@dxos/echo-schema';\n\nimport { SurfaceProvider, type SurfaceRootContext } from './SurfaceRootContext';\nimport SurfaceMeta from './meta';\nimport { parseSurfacePlugin, type SurfacePluginProvides } from './provides';\nimport { filterPlugins } from '../helpers';\nimport { type PluginDefinition } from '../plugin-host';\n\n/**\n * Provides a registry of surface components.\n */\nexport const SurfacePlugin = (): PluginDefinition<SurfacePluginProvides> => {\n  const state = create<SurfaceRootContext>({ components: {}, debugInfo: new Map() });\n\n  return {\n    meta: SurfaceMeta,\n    ready: async (plugins) => {\n      state.components = filterPlugins(plugins, parseSurfacePlugin).reduce((acc, plugin) => {\n        return { ...acc, [plugin.meta.id]: plugin.provides.surface.component };\n      }, {});\n    },\n    provides: {\n      surface: state,\n      context: ({ children }) => <SurfaceProvider value={state}>{children}</SurfaceProvider>,\n    },\n  };\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { createContext, useContext, type JSX, type ForwardedRef } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { type SurfaceProps } from './Surface';\n\n// TODO(wittjosiah): Factor out.\ntype WithRequiredProperty<Type, Key extends keyof Type> = Type & {\n  [Property in Key]-?: Type[Property];\n};\n\ntype SurfaceComponentProps = WithRequiredProperty<SurfaceProps, 'data'>;\n\n/**\n * Determines the priority of the surface when multiple components are resolved.\n */\nexport type SurfaceDisposition = 'hoist' | 'fallback';\n\n/**\n * Surface debug info.\n * NOTE: Short-term measure to track perf issues.\n */\nexport type DebugInfo = {\n  id: string;\n  created: number;\n  renderCount: number;\n} & Pick<SurfaceProps, 'role' | 'name'>;\n\nexport type SurfaceResult = {\n  node: JSX.Element;\n  disposition?: SurfaceDisposition;\n};\n\n/**\n * Function which resolves a Surface.\n *\n * If a null value is returned, the rendering is deferred to other plugins.\n */\nexport type SurfaceComponent = (\n  props: SurfaceComponentProps,\n  forwardedRef: ForwardedRef<HTMLElement>,\n) => JSX.Element | SurfaceResult | null;\n\nexport type SurfaceRootContext = {\n  components: Record<string, SurfaceComponent>;\n\n  /**\n   * Debug info.\n   */\n  debugInfo?: Map<string, DebugInfo>;\n};\n\nconst SurfaceRootContext = createContext<SurfaceRootContext | undefined>(undefined);\n\nexport const useSurfaceRoot = () => useContext(SurfaceRootContext) ?? raise(new Error('Missing SurfaceRootContext'));\n\nexport const SurfaceProvider = SurfaceRootContext.Provider;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nconst SurfaceMeta = {\n  id: 'dxos.org/plugin/surface',\n};\n\nexport default SurfaceMeta;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type SurfaceComponent, type SurfaceRootContext } from './SurfaceRootContext';\nimport { type Plugin } from '../plugin-host';\n\n// TODO(burdon): Predicate based providers?\nexport type SurfaceProvides = {\n  surface: {\n    /**\n     * Used by the `Surface` resolver to find a component to render.\n     */\n    component: SurfaceComponent;\n  };\n};\n\nexport type SurfacePluginProvides = {\n  surface: SurfaceRootContext;\n};\n\nexport const parseRootSurfacePlugin = (plugin?: Plugin) =>\n  (plugin?.provides as any)?.surface?.components ? (plugin as Plugin<SurfacePluginProvides>) : undefined;\n\nexport const parseSurfacePlugin = (plugin?: Plugin) =>\n  (plugin?.provides as any)?.surface?.component ? (plugin as Plugin<SurfaceProvides>) : undefined;\n", "//\n// Copyright 2023 DXOS.org\n//\n\n/**\n * Checks if the given data is an object and not null.\n *\n * Useful inside surface component resolvers as a type guard.\n *\n * @example\n * ```ts\n *  const old =\n *    data.content &&\n *      typeof data.content === 'object' &&\n *      'id' in data.content &&\n *      typeof data.content.id === 'string';\n *\n *  // becomes\n *  const new = isObject(data.content) && typeof data.content.id === 'string';\n * ```\n */\nexport const isObject = (data: unknown): data is { [key: string]: unknown } => !!data && typeof data === 'object';\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { Component, type FC, type PropsWithChildren } from 'react';\n\ntype Props = PropsWithChildren<{ data?: any; fallback: FC<{ data?: any; error: Error; reset: () => void }> }>;\ntype State = { error: Error | undefined };\n\n/**\n * Surface error boundary.\n *\n * For basic usage prefer providing a fallback component to `Surface`.\n *\n * For more information on error boundaries, see:\n * https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary\n */\nexport class ErrorBoundary extends Component<Props, State> {\n  constructor(props: Props) {\n    super(props);\n    this.state = { error: undefined };\n  }\n\n  static getDerivedStateFromError(error: Error) {\n    return { error };\n  }\n\n  override componentDidUpdate(prevProps: Props): void {\n    if (prevProps.data !== this.props.data) {\n      this.resetError();\n    }\n  }\n\n  override render() {\n    if (this.state.error) {\n      return <this.props.fallback data={this.props.data} error={this.state.error} reset={this.resetError} />;\n    }\n\n    return this.props.children;\n  }\n\n  private resetError() {\n    this.setState({ error: undefined });\n  }\n}\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport React, {\n  Fragment,\n  type ForwardedRef,\n  type PropsWithChildren,\n  type ReactNode,\n  Suspense,\n  createContext,\n  forwardRef,\n  isValidElement,\n  memo,\n  useContext,\n  useEffect,\n  useState,\n} from 'react';\n\nimport { raise } from '@dxos/debug';\nimport { log } from '@dxos/log';\n\nimport { ErrorBoundary } from './ErrorBoundary';\nimport { type SurfaceComponent, type SurfaceResult, useSurfaceRoot } from './SurfaceRootContext';\n\n/**\n * Direction determines how multiple components are laid out.\n */\nexport type Direction = 'inline' | 'inline-reverse' | 'block' | 'block-reverse';\n\n/**\n * SurfaceProps are the props that are passed to the Surface component.\n */\nexport type SurfaceProps = PropsWithChildren<{\n  /**\n   * Optional ID for debugging.\n   */\n  id?: string;\n\n  /**\n   * Role defines how the data should be rendered.\n   */\n  role?: string;\n\n  /**\n   * Names allow nested surfaces to be specified in the parent context, similar to a slot.\n   * Defaults to the value of `role` if not specified.\n   */\n  name?: string;\n\n  /**\n   * The data to be rendered by the surface.\n   */\n  data?: Record<string, unknown>;\n\n  /**\n   * Configure nested surfaces (indexed by the surface's `name`).\n   */\n  surfaces?: Record<string, Pick<SurfaceProps, 'data' | 'surfaces'>>;\n\n  /**\n   * If specified, the Surface will be wrapped in an error boundary.\n   * The fallback component will be rendered if an error occurs.\n   */\n  fallback?: ErrorBoundary['props']['fallback'];\n\n  /**\n   * If specified, the Surface will be wrapped in a suspense boundary.\n   * The placeholder component will be rendered while the surface component is loading.\n   */\n  placeholder?: ReactNode;\n\n  /**\n   * If more than one component is resolved, the limit determines how many are rendered.\n   */\n  limit?: number | undefined;\n\n  /**\n   * If more than one component is resolved, the direction determines how they are laid out.\n   * NOTE: This is not yet implemented.\n   */\n  direction?: Direction;\n\n  /**\n   * Additional props to pass to the component.\n   * These props are not used by Surface itself but may be used by components which resolve the surface.\n   */\n  [key: string]: unknown;\n}>;\n\nlet count = 0;\n\n/**\n * A surface is a named region of the screen that can be populated by plugins.\n */\nexport const Surface = memo(\n  forwardRef<HTMLElement, SurfaceProps>(\n    ({ id: _id, role, name = role, fallback, placeholder, ...rest }, forwardedRef) => {\n      const props = { role, name, fallback, ...rest };\n      const { debugInfo } = useSurfaceRoot();\n\n      // Track debug info.\n      const [id] = useState<string>(() => _id ?? `surface-${++count}`);\n      useEffect(() => {\n        debugInfo?.set(id, { id, created: Date.now(), name, role, renderCount: 0 });\n        return () => {\n          debugInfo?.delete(id);\n        };\n      }, [id]);\n\n      if (debugInfo?.get(id)) {\n        debugInfo.get(id)!.renderCount++;\n      }\n\n      const context = useContext(SurfaceContext);\n      const data = props.data ?? ((name && context?.surfaces?.[name]?.data) || {});\n\n      const resolver = <SurfaceResolver {...props} id={id} ref={forwardedRef} />;\n      const suspense = placeholder ? <Suspense fallback={placeholder}>{resolver}</Suspense> : resolver;\n\n      return fallback ? (\n        <ErrorBoundary data={data} fallback={fallback}>\n          {suspense}\n        </ErrorBoundary>\n      ) : (\n        suspense\n      );\n    },\n  ),\n);\n\nconst SurfaceContext = createContext<SurfaceProps | undefined>(undefined);\n\nexport const useSurface = (): SurfaceProps =>\n  useContext(SurfaceContext) ?? raise(new Error('Surface context not found'));\n\n/**\n * Root surface component.\n */\nconst SurfaceResolver = forwardRef<HTMLElement, SurfaceProps>((props, forwardedRef) => {\n  const { components } = useSurfaceRoot();\n  const parent = useContext(SurfaceContext);\n  const nodes = resolveNodes(components, props, parent, forwardedRef);\n  const currentContext: SurfaceProps = {\n    ...props,\n    surfaces: {\n      ...((props.name && parent?.surfaces?.[props.name]?.surfaces) || {}),\n      ...props.surfaces,\n    },\n  };\n\n  return <SurfaceContext.Provider value={currentContext}>{nodes}</SurfaceContext.Provider>;\n});\n\n/**\n * Resolve surface nodes from across all component.\n */\nconst resolveNodes = (\n  components: Record<string, SurfaceComponent>,\n  props: SurfaceProps,\n  context: SurfaceProps | undefined,\n  forwardedRef: ForwardedRef<HTMLElement>,\n): ReactNode[] => {\n  const data = {\n    ...((props.name && context?.surfaces?.[props.name]?.data) || {}),\n    ...props.data,\n  };\n\n  const candidates = Object.entries(components)\n    .map(([key, component]): [string, SurfaceResult] | undefined => {\n      // TODO(burdon): Avoid variable return types in plugin contract.\n      const result = component({ ...props, data }, forwardedRef);\n      if (!result || typeof result !== 'object') {\n        return undefined;\n      }\n\n      // Normalize tuple.\n      if ('node' in result) {\n        return [key, result];\n      } else if (isValidElement(result)) {\n        return [key, { node: result }];\n      } else {\n        log.warn('invalid result', { result });\n        return undefined;\n      }\n    })\n    .filter((result): result is [string, SurfaceResult] => Boolean(result))\n    .sort(([, { disposition: a = 'default' }], [, { disposition: b = 'default' }]) => {\n      return a === b ? 0 : a === 'hoist' || b === 'fallback' ? -1 : b === 'hoist' || a === 'fallback' ? 1 : 0;\n    });\n\n  // TODO(burdon): Does this prematurely process the node?\n  const nodes = candidates.map(([key, result]) => <Fragment key={key}>{result.node}</Fragment>);\n  return props.limit ? nodes.slice(0, props.limit) : nodes;\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { SurfacePlugin } from './SurfacePlugin';\n\nexport * from './helpers';\nexport * from './provides';\n\nexport * from './ErrorBoundary';\nexport * from './Surface';\nexport * from './SurfaceRootContext';\n\nexport default SurfacePlugin;\n"],
+  "mappings": "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",
+  "names": ["React", "create", "createContext", "useContext", "raise", "SurfaceRootContext", "createContext", "undefined", "useSurfaceRoot", "useContext", "raise", "Error", "SurfaceProvider", "Provider", "SurfaceMeta", "id", "parseRootSurfacePlugin", "plugin", "provides", "surface", "components", "undefined", "parseSurfacePlugin", "component", "SurfacePlugin", "state", "create", "components", "debugInfo", "Map", "meta", "SurfaceMeta", "ready", "plugins", "filterPlugins", "parseSurfacePlugin", "reduce", "acc", "plugin", "id", "provides", "surface", "component", "context", "children", "SurfaceProvider", "value", "isObject", "data", "React", "Component", "ErrorBoundary", "Component", "constructor", "props", "state", "error", "undefined", "getDerivedStateFromError", "componentDidUpdate", "prevProps", "data", "resetError", "render", "React", "this", "fallback", "reset", "children", "setState", "React", "Fragment", "Suspense", "createContext", "forwardRef", "isValidElement", "memo", "useContext", "useEffect", "useState", "raise", "log", "count", "Surface", "memo", "forwardRef", "id", "_id", "role", "name", "fallback", "placeholder", "rest", "forwardedRef", "props", "debugInfo", "useSurfaceRoot", "useState", "useEffect", "set", "created", "Date", "now", "renderCount", "delete", "get", "context", "useContext", "SurfaceContext", "data", "surfaces", "resolver", "React", "SurfaceResolver", "ref", "suspense", "Suspense", "ErrorBoundary", "createContext", "undefined", "useSurface", "raise", "Error", "components", "parent", "nodes", "resolveNodes", "currentContext", "Provider", "value", "candidates", "Object", "entries", "map", "key", "component", "result", "isValidElement", "node", "log", "warn", "filter", "Boolean", "sort", "disposition", "a", "b", "Fragment", "limit", "slice", "SurfacePlugin"]
+}