@dxos/app-framework 0.7.4 → 0.7.5-main.499c70c

package/src/plugins/plugin-surface/Surface.tsx

@@ -2,107 +2,27 @@
 // Copyright 2022 DXOS.org
 //
 
-import React, {
-  Fragment,
-  type ForwardedRef,
-  type PropsWithChildren,
-  type ReactNode,
-  Suspense,
-  createContext,
-  forwardRef,
-  isValidElement,
-  memo,
-  useContext,
-  useEffect,
-  useState,
-} from 'react';
+import React, { Suspense, forwardRef, memo, useEffect, useId, useMemo } from 'react';
 
-import { raise } from '@dxos/debug';
-import { log } from '@dxos/log';
+import { useDefaultValue } from '@dxos/react-hooks';
 
 import { ErrorBoundary } from './ErrorBoundary';
-import { type SurfaceComponent, type SurfaceResult, useSurfaceRoot } from './SurfaceRootContext';
-
-/**
- * Direction determines how multiple components are laid out.
- */
-export type Direction = 'inline' | 'inline-reverse' | 'block' | 'block-reverse';
-
-/**
- * SurfaceProps are the props that are passed to the Surface component.
- */
-export type SurfaceProps = PropsWithChildren<{
-  /**
-   * Optional ID for debugging.
-   */
-  id?: string;
-
-  /**
-   * Role defines how the data should be rendered.
-   */
-  role?: string;
-
-  /**
-   * Names allow nested surfaces to be specified in the parent context, similar to a slot.
-   * Defaults to the value of `role` if not specified.
-   */
-  name?: string;
-
-  /**
-   * The data to be rendered by the surface.
-   */
-  data?: Record<string, unknown>;
-
-  /**
-   * Configure nested surfaces (indexed by the surface's `name`).
-   */
-  surfaces?: Record<string, Pick<SurfaceProps, 'data' | 'surfaces'>>;
-
-  /**
-   * If specified, the Surface will be wrapped in an error boundary.
-   * The fallback component will be rendered if an error occurs.
-   */
-  fallback?: ErrorBoundary['props']['fallback'];
-
-  /**
-   * If specified, the Surface will be wrapped in a suspense boundary.
-   * The placeholder component will be rendered while the surface component is loading.
-   */
-  placeholder?: ReactNode;
-
-  /**
-   * If more than one component is resolved, the limit determines how many are rendered.
-   */
-  limit?: number | undefined;
-
-  /**
-   * If more than one component is resolved, the direction determines how they are laid out.
-   * NOTE: This is not yet implemented.
-   */
-  direction?: Direction;
-
-  /**
-   * Additional props to pass to the component.
-   * These props are not used by Surface itself but may be used by components which resolve the surface.
-   */
-  [key: string]: unknown;
-}>;
-
-let count = 0;
+import { type SurfaceProps, useSurfaceRoot } from './SurfaceContext';
 
 /**
  * A surface is a named region of the screen that can be populated by plugins.
  */
 export const Surface = memo(
   forwardRef<HTMLElement, SurfaceProps>(
-    ({ id: _id, role, name = role, fallback, placeholder, ...rest }, forwardedRef) => {
-      const props = { role, name, fallback, ...rest };
-      const { debugInfo } = useSurfaceRoot();
+    ({ id: _id, role, data: _data, limit, fallback, placeholder, ...rest }, forwardedRef) => {
+      const { surfaces, debugInfo } = useSurfaceRoot();
+      const data = useDefaultValue(_data, () => ({}));
 
       // Track debug info.
-      const [id] = useState<string>(() => _id ?? `surface-${++count}`);
+      const reactId = useId();
+      const id = _id ?? reactId;
       useEffect(() => {
-        debugInfo?.set(id, { id, created: Date.now(), name, role, renderCount: 0 });
+        debugInfo?.set(id, { id, created: Date.now(), role, renderCount: 0 });
         return () => {
           debugInfo?.delete(id);
         };
@@ -112,11 +32,23 @@ export const Surface = memo(
         debugInfo.get(id)!.renderCount++;
       }
 
-      const context = useContext(SurfaceContext);
-      const data = props.data ?? ((name && context?.surfaces?.[name]?.data) || {});
+      const candidates = useMemo(() => {
+        const definitions = Object.values(surfaces)
+          .filter((definition) =>
+            Array.isArray(definition.role) ? definition.role.includes(role) : definition.role === role,
+          )
+          .filter(({ filter }) => (filter ? filter(data) : true))
+          .toSorted(({ disposition: a = 'static' }, { disposition: b = 'static' }) => {
+            return a === b ? 0 : a === 'hoist' || b === 'fallback' ? -1 : b === 'hoist' || a === 'fallback' ? 1 : 0;
+          });
+        return limit ? definitions.slice(0, limit) : definitions;
+      }, [surfaces, role, data, limit]);
 
-      const resolver = <SurfaceResolver {...props} id={id} ref={forwardedRef} />;
-      const suspense = placeholder ? <Suspense fallback={placeholder}>{resolver}</Suspense> : resolver;
+      const nodes = candidates.map(({ component: Component, id }) => (
+        <Component ref={forwardedRef} key={id} id={id} role={role} data={data} limit={limit} {...rest} />
+      ));
+
+      const suspense = placeholder ? <Suspense fallback={placeholder}>{nodes}</Suspense> : nodes;
 
       return fallback ? (
         <ErrorBoundary data={data} fallback={fallback}>
@@ -128,68 +60,3 @@ export const Surface = memo(
     },
   ),
 );
-
-const SurfaceContext = createContext<SurfaceProps | undefined>(undefined);
-
-export const useSurface = (): SurfaceProps =>
-  useContext(SurfaceContext) ?? raise(new Error('Surface context not found'));
-
-/**
- * Root surface component.
- */
-const SurfaceResolver = forwardRef<HTMLElement, SurfaceProps>((props, forwardedRef) => {
-  const { components } = useSurfaceRoot();
-  const parent = useContext(SurfaceContext);
-  const nodes = resolveNodes(components, props, parent, forwardedRef);
-  const currentContext: SurfaceProps = {
-    ...props,
-    surfaces: {
-      ...((props.name && parent?.surfaces?.[props.name]?.surfaces) || {}),
-      ...props.surfaces,
-    },
-  };
-
-  return <SurfaceContext.Provider value={currentContext}>{nodes}</SurfaceContext.Provider>;
-});
-
-/**
- * Resolve surface nodes from across all component.
- */
-const resolveNodes = (
-  components: Record<string, SurfaceComponent>,
-  props: SurfaceProps,
-  context: SurfaceProps | undefined,
-  forwardedRef: ForwardedRef<HTMLElement>,
-): ReactNode[] => {
-  const data = {
-    ...((props.name && context?.surfaces?.[props.name]?.data) || {}),
-    ...props.data,
-  };
-
-  const candidates = Object.entries(components)
-    .map(([key, component]): [string, SurfaceResult] | undefined => {
-      // TODO(burdon): Avoid variable return types in plugin contract.
-      const result = component({ ...props, data }, forwardedRef);
-      if (!result || typeof result !== 'object') {
-        return undefined;
-      }
-
-      // Normalize tuple.
-      if ('node' in result) {
-        return [key, result];
-      } else if (isValidElement(result)) {
-        return [key, { node: result }];
-      } else {
-        log.warn('invalid result', { result });
-        return undefined;
-      }
-    })
-    .filter((result): result is [string, SurfaceResult] => Boolean(result))
-    .sort(([, { disposition: a = 'default' }], [, { disposition: b = 'default' }]) => {
-      return a === b ? 0 : a === 'hoist' || b === 'fallback' ? -1 : b === 'hoist' || a === 'fallback' ? 1 : 0;
-    });
-
-  // TODO(burdon): Does this prematurely process the node?
-  const nodes = candidates.map(([key, result]) => <Fragment key={key}>{result.node}</Fragment>);
-  return props.limit ? nodes.slice(0, props.limit) : nodes;
-};

package/src/plugins/plugin-surface/SurfaceContext.ts

@@ -0,0 +1,112 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { createContext, useContext, type JSX, type ForwardedRef, type PropsWithChildren, type ReactNode } from 'react';
+
+import { raise } from '@dxos/debug';
+import { type GuardedType, type MakeOptional } from '@dxos/util';
+
+import { type ErrorBoundary } from './ErrorBoundary';
+
+/**
+ * SurfaceProps are the props that are passed to the Surface component.
+ */
+export type SurfaceProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<{
+  /**
+   * If specified, the Surface will be wrapped in an error boundary.
+   * The fallback component will be rendered if an error occurs.
+   */
+  fallback?: ErrorBoundary['props']['fallback'];
+
+  /**
+   * If specified, the Surface will be wrapped in a suspense boundary.
+   * The placeholder component will be rendered while the surface component is loading.
+   */
+  placeholder?: ReactNode;
+}> &
+  MakeOptional<CoreSurfaceProps<T>, 'id' | 'data'> & {
+    /**
+     * Additional props to pass to the component.
+     * These props are not used by Surface itself but may be used by components which resolve the surface.
+     */
+    [key: string]: unknown;
+  };
+
+// NOTE: If `[key: string]: unknown` is included in shared types, when re-used other fields become unknown as well.
+type CoreSurfaceProps<T extends Record<string, any> = Record<string, unknown>> = {
+  /**
+   * ID for debugging.
+   */
+  id: string;
+
+  /**
+   * Role defines how the data should be rendered.
+   */
+  role: string;
+
+  /**
+   * The data to be rendered by the surface.
+   */
+  data: T;
+
+  /**
+   * If more than one component is resolved, the limit determines how many are rendered.
+   */
+  limit?: number | undefined;
+};
+
+type SurfaceComponentProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<
+  CoreSurfaceProps<T> & { [key: string]: unknown }
+>;
+
+/**
+ * React component used to render a surface once is has matched.
+ */
+export type SurfaceComponent<T extends Record<string, any> = Record<string, unknown>> = (
+  props: SurfaceComponentProps<T>,
+  forwardedRef: ForwardedRef<HTMLElement>,
+) => JSX.Element | null;
+
+/**
+ * Determines the priority of the surface when multiple components are resolved.
+ *
+ * - `static` - The component is rendered in the order it was resolved.
+ * - `hoist` - The component is rendered before `static` components.
+ * - `fallback` - The component is rendered after `static` components.
+ */
+export type SurfaceDisposition = 'static' | 'hoist' | 'fallback';
+
+/**
+ * Definition of when a SurfaceComponent should be rendered.
+ */
+export type SurfaceDefinition<T extends Record<string, any> = any> = {
+  id: string;
+  role: string | string[];
+  disposition?: SurfaceDisposition;
+  filter?: (data: Record<string, unknown>) => data is T;
+  component: SurfaceComponent<GuardedType<SurfaceDefinition<T>['filter']>>;
+};
+
+export const createSurface = <T extends Record<string, any> = any>(definition: SurfaceDefinition<T>) => definition;
+
+/**
+ * Surface debug info.
+ * NOTE: Short-term measure to track perf issues.
+ */
+export type DebugInfo = {
+  id: string;
+  created: number;
+  renderCount: number;
+} & Pick<SurfaceProps, 'role'>;
+
+export type SurfaceContextValue = {
+  surfaces: Record<string, SurfaceDefinition>;
+  debugInfo?: Map<string, DebugInfo>;
+};
+
+const SurfaceContext = createContext<SurfaceContextValue | undefined>(undefined);
+
+export const useSurfaceRoot = () => useContext(SurfaceContext) ?? raise(new Error('Missing SurfaceContext'));
+
+export const SurfaceProvider = SurfaceContext.Provider;

package/src/plugins/plugin-surface/SurfacePlugin.tsx

@@ -6,9 +6,9 @@ import React from 'react';
 
 import { create } from '@dxos/live-object';
 
-import { SurfaceProvider, type SurfaceRootContext } from './SurfaceRootContext';
+import { SurfaceProvider, type SurfaceContextValue } from './SurfaceContext';
 import SurfaceMeta from './meta';
-import { parseSurfacePlugin, type SurfacePluginProvides } from './provides';
+import { parseSurfacePlugin, type SurfacePluginProvides, type SurfaceDefinitions } from './provides';
 import { filterPlugins } from '../helpers';
 import { type PluginDefinition } from '../plugin-host';
 
@@ -16,14 +16,15 @@ import { type PluginDefinition } from '../plugin-host';
  * Provides a registry of surface components.
  */
 export const SurfacePlugin = (): PluginDefinition<SurfacePluginProvides> => {
-  const state = create<SurfaceRootContext>({ components: {}, debugInfo: new Map() });
+  const state = create<SurfaceContextValue>({ surfaces: {}, debugInfo: new Map() });
 
   return {
     meta: SurfaceMeta,
-    ready: async (plugins) => {
-      state.components = filterPlugins(plugins, parseSurfacePlugin).reduce((acc, plugin) => {
-        return { ...acc, [plugin.meta.id]: plugin.provides.surface.component };
-      }, {});
+    ready: async (context) => {
+      state.surfaces = filterPlugins(context.plugins, parseSurfacePlugin).reduce(
+        (acc, plugin) => reduceSurfaces(plugin.provides.surface.definitions(context), acc),
+        {},
+      );
     },
     provides: {
       surface: state,
@@ -31,3 +32,14 @@ export const SurfacePlugin = (): PluginDefinition<SurfacePluginProvides> => {
     },
   };
 };
+
+const reduceSurfaces = (
+  definitions: SurfaceDefinitions,
+  surfaces: SurfaceContextValue['surfaces'] = {},
+): SurfaceContextValue['surfaces'] => {
+  if (Array.isArray(definitions)) {
+    return definitions.reduce((acc, definition) => reduceSurfaces(definition, acc), surfaces);
+  }
+
+  return { ...surfaces, [definitions.id]: definitions };
+};

package/src/plugins/plugin-surface/index.ts

@@ -9,6 +9,6 @@ export * from './provides';
 
 export * from './ErrorBoundary';
 export * from './Surface';
-export * from './SurfaceRootContext';
+export * from './SurfaceContext';
 
 export default SurfacePlugin;

package/src/plugins/plugin-surface/provides.ts

@@ -2,25 +2,26 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type SurfaceComponent, type SurfaceRootContext } from './SurfaceRootContext';
-import { type Plugin } from '../plugin-host';
+import { type SurfaceDefinition, type SurfaceContextValue } from './SurfaceContext';
+import { type HostContext, type Plugin } from '../plugin-host';
+
+export type SurfaceDefinitions = SurfaceDefinition | SurfaceDefinition[] | SurfaceDefinitions[];
 
-// TODO(burdon): Predicate based providers?
 export type SurfaceProvides = {
   surface: {
     /**
      * Used by the `Surface` resolver to find a component to render.
      */
-    component: SurfaceComponent;
+    definitions: (context: HostContext) => SurfaceDefinitions;
   };
 };
 
 export type SurfacePluginProvides = {
-  surface: SurfaceRootContext;
+  surface: SurfaceContextValue;
 };
 
 export const parseRootSurfacePlugin = (plugin?: Plugin) =>
-  (plugin?.provides as any)?.surface?.components ? (plugin as Plugin<SurfacePluginProvides>) : undefined;
+  (plugin?.provides as any)?.surface?.surfaces ? (plugin as Plugin<SurfacePluginProvides>) : undefined;
 
 export const parseSurfacePlugin = (plugin?: Plugin) =>
-  (plugin?.provides as any)?.surface?.component ? (plugin as Plugin<SurfaceProvides>) : undefined;
+  (plugin?.provides as any)?.surface?.definitions ? (plugin as Plugin<SurfaceProvides>) : undefined;

package/tsconfig.json

@@ -16,7 +16,44 @@
   "include": [
     "src"
   ],
-  "references": [],
+  "references": [
+    {
+      "path": "../../common/async"
+    },
+    {
+      "path": "../../common/context"
+    },
+    {
+      "path": "../../common/debug"
+    },
+    {
+      "path": "../../common/invariant"
+    },
+    {
+      "path": "../../common/local-storage"
+    },
+    {
+      "path": "../../common/log"
+    },
+    {
+      "path": "../../common/util"
+    },
+    {
+      "path": "../../core/echo/echo-schema"
+    },
+    {
+      "path": "../../core/echo/live-object"
+    },
+    {
+      "path": "../../ui/primitives/react-hooks"
+    },
+    {
+      "path": "../app-graph"
+    },
+    {
+      "path": "../client-protocol"
+    }
+  ],
   "ts-node": {
     "compilerOptions": {
       "module": "CommonJS"

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