@dxos/app-framework 0.6.13 → 0.6.14-main.2b6a0f3

package/src/plugins/PluginHost/PluginHost.tsx

@@ -2,19 +2,20 @@
 // Copyright 2023 DXOS.org
 //
 
-import React, { type JSX, type FC, type PropsWithChildren, type ReactNode, useEffect, useState } from 'react';
+import React, { type ReactNode } from 'react';
 
 import { LocalStorageStore } from '@dxos/local-storage';
-import { log } from '@dxos/log';
 
+import { PluginContainer } from './PluginContainer';
 import { type PluginContext, PluginProvider } from './PluginContext';
-import { type Plugin, type PluginDefinition, type PluginProvides } from './plugin';
+import { type Plugin, type PluginDefinition, type PluginMeta } from './plugin';
 import { ErrorBoundary } from '../SurfacePlugin';
 
 export type BootstrapPluginsParams = {
-  order: PluginDefinition['meta'][];
   plugins: Record<string, () => Promise<PluginDefinition>>;
-  core?: string[];
+  // Ordered list of plugins.
+  meta: PluginMeta[];
+  core: string[];
   defaults?: string[];
   fallback?: ErrorBoundary['props']['fallback'];
   placeholder?: ReactNode;
@@ -33,9 +34,9 @@ const PLUGIN_HOST = 'dxos.org/plugin/host';
  * Bootstraps an application by initializing plugins and rendering root components.
  */
 export const PluginHost = ({
-  order,
-  plugins: definitions,
-  core = [],
+  plugins,
+  meta,
+  core,
   defaults = [],
   fallback = DefaultFallback,
   placeholder = null,
@@ -45,7 +46,7 @@ export const PluginHost = ({
     core,
     enabled: [...defaults],
     plugins: [],
-    available: order.filter(({ id }) => !core.includes(id)),
+    available: meta.filter(({ id }) => !core.includes(id)),
     setPlugin: (id: string, enabled: boolean) => {
       if (enabled) {
         state.values.enabled.push(id);
@@ -56,6 +57,7 @@ export const PluginHost = ({
     },
   });
 
+  // Register and load values.
   state.prop({ key: 'enabled', type: LocalStorageStore.json<string[]>() });
 
   return {
@@ -65,11 +67,13 @@ export const PluginHost = ({
     },
     provides: {
       plugins: state.values,
-      context: ({ children }) => <PluginProvider value={state.values}>{children}</PluginProvider>,
+      context: ({ children }) => {
+        return <PluginProvider value={state.values}>{children}</PluginProvider>;
+      },
       root: () => {
         return (
           <ErrorBoundary fallback={fallback}>
-            <Root order={order} core={core} definitions={definitions} state={state.values} placeholder={placeholder} />
+            <PluginContainer plugins={plugins} core={core} state={state.values} placeholder={placeholder} />
           </ErrorBoundary>
         );
       },
@@ -77,6 +81,9 @@ export const PluginHost = ({
   };
 };
 
+/**
+ * Fallback does not use tailwind or theme.
+ */
 const DefaultFallback = ({ error }: { error: Error }) => {
   return (
     <div style={{ padding: '1rem' }}>
@@ -86,113 +93,3 @@ const DefaultFallback = ({ error }: { error: Error }) => {
     </div>
   );
 };
-
-type RootProps = {
-  order: PluginDefinition['meta'][];
-  state: PluginContext;
-  definitions: Record<string, () => Promise<PluginDefinition>>;
-  core: string[];
-  placeholder: ReactNode;
-};
-
-const Root = ({ order, core: corePluginIds, definitions, state, placeholder }: RootProps) => {
-  const [error, setError] = useState<unknown>();
-
-  useEffect(() => {
-    log('initializing plugins', { enabled: state.enabled });
-    const timeout = setTimeout(async () => {
-      try {
-        const enabledIds = [...corePluginIds, ...state.enabled].sort((a, b) => {
-          const indexA = order.findIndex(({ id }) => id === a);
-          const indexB = order.findIndex(({ id }) => id === b);
-          return indexA - indexB;
-        });
-
-        const enabled = await Promise.all(
-          enabledIds
-            .map((id) => definitions[id])
-            // If local storage indicates a plugin is enabled, but it is not available, ignore it.
-            .filter((definition): definition is () => Promise<PluginDefinition> => Boolean(definition))
-            .map((definition) => definition()),
-        );
-
-        const plugins = await Promise.all(
-          enabled.map(async (definition) => {
-            const plugin = await initializePlugin(definition).catch((err) => {
-              log.error('Failed to initialize plugin:', { id: definition.meta.id, err });
-              return undefined;
-            });
-            return plugin;
-          }),
-        ).then((plugins) => plugins.filter((plugin): plugin is Plugin => Boolean(plugin)));
-        log('plugins initialized', { plugins });
-
-        await Promise.all(enabled.map((pluginDefinition) => pluginDefinition.ready?.(plugins)));
-        log('plugins ready', { plugins });
-
-        state.plugins = plugins;
-        state.ready = true;
-      } catch (err) {
-        setError(err);
-      }
-    });
-
-    return () => {
-      clearTimeout(timeout);
-      state.ready = false;
-      // TODO(wittjosiah): Does this ever need to be called prior to having dynamic plugins?
-      // void Promise.all(enabled.map((definition) => definition.unload?.()));
-    };
-  }, []);
-
-  if (error) {
-    throw error;
-  }
-
-  if (!state.ready) {
-    return <>{placeholder}</>;
-  }
-
-  const ComposedContext = composeContext(state.plugins);
-
-  return <ComposedContext>{rootComponents(state.plugins)}</ComposedContext>;
-};
-
-/**
- * Resolve a `PluginDefinition` into a fully initialized `Plugin`.
- */
-export const initializePlugin = async <T, U>(pluginDefinition: PluginDefinition<T, U>): Promise<Plugin<T & U>> => {
-  const provides = await pluginDefinition.initialize?.();
-  return {
-    ...pluginDefinition,
-    provides: {
-      ...pluginDefinition.provides,
-      ...provides,
-    } as PluginProvides<T & U>,
-  };
-};
-
-const rootComponents = (plugins: Plugin[]) => {
-  return plugins
-    .map((plugin) => {
-      const Component = plugin.provides.root;
-      if (Component) {
-        return <Component key={plugin.meta.id} />;
-      } else {
-        return null;
-      }
-    })
-    .filter((node): node is JSX.Element => Boolean(node));
-};
-
-const composeContext = (plugins: Plugin[]) => {
-  return compose(plugins.map((p) => p.provides.context!).filter(Boolean));
-};
-
-const compose = (contexts: FC<PropsWithChildren>[]) => {
-  return [...contexts].reduce((Acc, Next) => ({ children }) => (
-    <Acc>
-      <Next>{children}</Next>
-    </Acc>
-  ));
-};

package/src/plugins/PluginHost/plugin.test.ts

@@ -2,11 +2,10 @@
 // Copyright 2023 DXOS.org
 //
 
-import { expect } from 'chai';
 import { type FC } from 'react';
+import { describe, expect, test } from 'vitest';
 
 import { log } from '@dxos/log';
-import { describe, test } from '@dxos/test';
 
 import { type Plugin } from './plugin';
 

package/src/plugins/PluginHost/plugin.ts

@@ -2,7 +2,6 @@
 // Copyright 2023 DXOS.org
 //
 
-import type { IconProps } from '@phosphor-icons/react';
 import type { FC, PropsWithChildren } from 'react';
 
 /**
@@ -21,60 +20,56 @@ export type PluginProvides<TProvides> = TProvides & {
   root?: FC<PropsWithChildren>;
 };
 
+export type PluginMeta = {
+  /**
+   * Globally unique ID.
+   *
+   * Expected to be in the form of a valid URL.
+   *
+   * @example dxos.org/plugin/example
+   */
+  id: string;
+
+  /**
+   * Short ID for use in URLs.
+   *
+   * NOTE: This is especially experimental and likely to change.
+   */
+  // TODO(wittjosiah): How should these be managed?
+  shortId?: string;
+
+  /**
+   * Human-readable name.
+   */
+  name?: string;
+
+  /**
+   * Short description of plugin functionality.
+   */
+  description?: string;
+
+  /**
+   * URL of home page.
+   */
+  homePage?: string;
+
+  /**
+   * Tags to help categorize the plugin.
+   */
+  tags?: string[];
+
+  /**
+   * A grep-able symbol string which can be resolved to an icon asset by @ch-ui/icons, via @ch-ui/vite-plugin-icons.
+   */
+  icon?: string;
+};
+
 /**
  * A unit of containment of modular functionality that can be provided to an application.
  * Plugins provide things like components, state, actions, etc. to the application.
  */
 export type Plugin<TProvides = {}> = {
-  meta: {
-    /**
-     * Globally unique ID.
-     *
-     * Expected to be in the form of a valid URL.
-     *
-     * @example dxos.org/plugin/example
-     */
-    id: string;
-
-    /**
-     * Short ID for use in URLs.
-     *
-     * NOTE: This is especially experimental and likely to change.
-     */
-    // TODO(wittjosiah): How should these be managed?
-    shortId?: string;
-
-    /**
-     * Human-readable name.
-     */
-    name?: string;
-
-    /**
-     * Short description of plugin functionality.
-     */
-    description?: string;
-
-    /**
-     * URL of home page.
-     */
-    homePage?: string;
-
-    /**
-     * Tags to help categorize the plugin.
-     */
-    tags?: string[];
-
-    /**
-     * Component to render icon for the plugin when displayed in a list.
-     * @deprecated
-     */
-    iconComponent?: FC<IconProps>;
-
-    /**
-     * A grep-able symbol string which can be resolved to an icon asset by @ch-ui/icons, via @ch-ui/vite-plugin-icons.
-     */
-    iconSymbol?: string;
-  };
+  meta: PluginMeta;
 
   /**
    * Capabilities provided by the plugin.
@@ -114,8 +109,6 @@ export type PluginDefinition<TProvides = {}, TInitializeProvides = {}> = Omit<Pl
   unload?: () => Promise<void>;
 };
 
-export const pluginMeta = (meta: Plugin['meta']) => meta;
-
 type LazyPlugin<T> = () => Promise<{ default: (props: T) => PluginDefinition }>;
 
 export namespace Plugin {

package/src/plugins/SurfacePlugin/Surface.tsx

@@ -3,15 +3,19 @@
 //
 
 import React, {
-  forwardRef,
-  type ReactNode,
   Fragment,
   type ForwardedRef,
   type PropsWithChildren,
-  isValidElement,
+  type ReactNode,
   Suspense,
+  createContext,
+  forwardRef,
+  isValidElement,
+  memo,
+  useContext,
+  useEffect,
+  useState,
 } from 'react';
-import { createContext, useContext } from 'react';
 
 import { raise } from '@dxos/debug';
 
@@ -81,9 +85,23 @@ export type SurfaceProps = PropsWithChildren<{
 /**
  * A surface is a named region of the screen that can be populated by plugins.
  */
-export const Surface = forwardRef<HTMLElement, SurfaceProps>(
-  ({ role, name = role, fallback, placeholder, ...rest }, forwardedRef) => {
+export const Surface = memo(
+  forwardRef<HTMLElement, SurfaceProps>(({ role, name = role, fallback, placeholder, ...rest }, forwardedRef) => {
     const props = { role, name, fallback, ...rest };
+    const { debugInfo } = useSurfaceRoot();
+
+    // Track debug info.
+    const [id] = useState<string>(Math.random().toString(36).slice(2));
+    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 = useContext(SurfaceContext);
     const data = props.data ?? ((name && context?.surfaces?.[name]?.data) || {});
 
@@ -97,10 +115,10 @@ export const Surface = forwardRef<HTMLElement, SurfaceProps>(
     ) : (
       suspense
     );
-  },
+  }),
 );
 
-const SurfaceContext = createContext<SurfaceProps | null>(null);
+const SurfaceContext = createContext<SurfaceProps | undefined>(undefined);
 
 export const useSurface = (): SurfaceProps =>
   useContext(SurfaceContext) ?? raise(new Error('Surface context not found'));
@@ -120,10 +138,13 @@ const SurfaceResolver = forwardRef<HTMLElement, SurfaceProps>((props, forwardedR
   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 | null,
+  context: SurfaceProps | undefined,
   forwardedRef: ForwardedRef<HTMLElement>,
 ): ReactNode[] => {
   const data = {
@@ -144,7 +165,6 @@ const resolveNodes = (
     .sort(([, a], [, b]) => {
       const aDisposition = a.disposition ?? 'default';
       const bDisposition = b.disposition ?? 'default';
-
       if (aDisposition === bDisposition) {
         return 0;
       } else if (aDisposition === 'hoist' || bDisposition === 'fallback') {

package/src/plugins/SurfacePlugin/SurfaceRootContext.tsx

@@ -2,7 +2,9 @@
 // Copyright 2023 DXOS.org
 //
 
-import { createContext, useContext, type Context, type JSX, type Provider, type ForwardedRef } from 'react';
+import { createContext, useContext, type JSX, type ForwardedRef } from 'react';
+
+import { raise } from '@dxos/debug';
 
 import { type SurfaceProps } from './Surface';
 
@@ -18,6 +20,16 @@ type SurfaceComponentProps = WithRequiredProperty<SurfaceProps, 'data'>;
  */
 export type SurfaceDisposition = 'hoist' | 'fallback';
 
+/**
+ * Surface debug info.
+ * NOTE: Short-term measure to track perf issues.
+ */
+export type DebugInfo = {
+  id: string;
+  created: number;
+  renderCount: number;
+} & Pick<SurfaceProps, 'role' | 'name'>;
+
 export type SurfaceResult = {
   node: JSX.Element;
   disposition?: SurfaceDisposition;
@@ -35,10 +47,15 @@ export type SurfaceComponent = (
 
 export type SurfaceRootContext = {
   components: Record<string, SurfaceComponent>;
+
+  /**
+   * Debug info.
+   */
+  debugInfo?: Map<string, DebugInfo>;
 };
 
-const SurfaceRootContext: Context<SurfaceRootContext> = createContext<SurfaceRootContext>({ components: {} });
+const SurfaceRootContext = createContext<SurfaceRootContext | undefined>(undefined);
 
-export const useSurfaceRoot = () => useContext(SurfaceRootContext);
+export const useSurfaceRoot = () => useContext(SurfaceRootContext) ?? raise(new Error('Missing SurfaceRootContext'));
 
-export const SurfaceProvider: Provider<SurfaceRootContext> = SurfaceRootContext.Provider;
+export const SurfaceProvider = SurfaceRootContext.Provider;

package/src/plugins/SurfacePlugin/plugin.tsx

@@ -9,14 +9,14 @@ import { create } from '@dxos/echo-schema';
 import { SurfaceProvider, type SurfaceRootContext } from './SurfaceRootContext';
 import SurfaceMeta from './meta';
 import { parseSurfacePlugin, type SurfacePluginProvides } from './provides';
-import type { PluginDefinition } from '../PluginHost';
+import { type PluginDefinition } from '../PluginHost';
 import { filterPlugins } from '../helpers';
 
 /**
  * Provides a registry of surface components.
  */
 const SurfacePlugin = (): PluginDefinition<SurfacePluginProvides> => {
-  const state = create<SurfaceRootContext>({ components: {} });
+  const state = create<SurfaceRootContext>({ components: {}, debugInfo: new Map() });
 
   return {
     meta: SurfaceMeta,

package/src/plugins/common/navigation.ts

@@ -2,10 +2,9 @@
 // Copyright 2024 DXOS.org
 //
 
+import { Schema as S } from '@effect/schema';
 import { z } from 'zod';
 
-import { S } from '@dxos/echo-schema';
-
 import type { IntentData } from '../IntentPlugin';
 import type { Plugin } from '../PluginHost';
 
@@ -19,7 +18,6 @@ export const SLUG_COLLECTION_INDICATOR = '';
 const LayoutEntrySchema = S.mutable(S.Struct({ id: S.String, path: S.optional(S.String) }));
 export type LayoutEntry = S.Schema.Type<typeof LayoutEntrySchema>;
 
-// TODO(Zan): Consider making solo it's own part. It's not really a function of the 'main' part?
 // TODO(Zan): Consider renaming the 'main' part to 'deck' part now that we are throwing out the old layout plugin.
 // TODO(Zan): Extend to all strings?
 const LayoutPartSchema = S.Union(
@@ -31,7 +29,9 @@ const LayoutPartSchema = S.Union(
 );
 export type LayoutPart = S.Schema.Type<typeof LayoutPartSchema>;
 
-const LayoutPartsSchema = S.partial(S.mutable(S.Record(LayoutPartSchema, S.mutable(S.Array(LayoutEntrySchema)))));
+const LayoutPartsSchema = S.partial(
+  S.mutable(S.Record({ key: LayoutPartSchema, value: S.mutable(S.Array(LayoutEntrySchema)) })),
+);
 export type LayoutParts = S.Schema.Type<typeof LayoutPartsSchema>;
 
 const LayoutCoordinateSchema = S.mutable(S.Struct({ part: LayoutPartSchema, entryId: S.String }));
@@ -52,14 +52,6 @@ export type ActiveParts = z.infer<typeof ActiveParts>;
 // TODO(burdon): Where should this go?
 export type LayoutContainerProps<T> = T & { role?: string; coordinate?: LayoutCoordinate };
 
-/**
- * Basic state provided by a navigation plugin.
- */
-export const Attention = z.object({
-  attended: z.set(z.string()).optional().describe('Ids of items which have focus.'),
-});
-export type Attention = z.infer<typeof Attention>;
-
 /**
  * Provides for a plugin that can manage the app navigation.
  */

package/tsconfig.json

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

package/vitest.config.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { defineConfig, mergeConfig } from 'vitest/config';
+
+import { baseConfig } from '../../../vitest.shared';
+
+export default mergeConfig(baseConfig({ cwd: __dirname }), defineConfig({}));

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/SurfacePlugin/provides.ts", "../../../src/plugins/SurfacePlugin/SurfaceRootContext.tsx", "../../../src/plugins/SurfacePlugin/meta.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type SurfaceComponent, type SurfaceRootContext } from './SurfaceRootContext';\nimport { type Plugin } from '../PluginHost';\n\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\nimport { createContext, useContext, type Context, type JSX, type Provider, type ForwardedRef } from 'react';\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\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\nconst SurfaceRootContext: Context<SurfaceRootContext> = createContext<SurfaceRootContext>({ components: {} });\n\nexport const useSurfaceRoot = () => useContext(SurfaceRootContext);\n\nexport const SurfaceProvider: Provider<SurfaceRootContext> = SurfaceRootContext.Provider;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nconst SurfaceMeta = {\n  id: 'dxos.org/plugin/surface',\n};\n\nexport default SurfaceMeta;\n"],
-  "mappings": ";AAoBO,IAAMA,yBAAyB,CAACC,WACpCA,QAAQC,UAAkBC,SAASC,aAAcH,SAA2CI;AAExF,IAAMC,qBAAqB,CAACL,WAChCA,QAAQC,UAAkBC,SAASI,YAAaN,SAAqCI;;;ACpBxF,SAASG,eAAeC,kBAA4E;AAmCpG,IAAMC,qBAAkDC,8BAAkC;EAAEC,YAAY,CAAC;AAAE,CAAA;AAEpG,IAAMC,iBAAiB,MAAMC,WAAWJ,kBAAAA;AAExC,IAAMK,kBAAgDL,mBAAmBM;;;ACvChF,IAAMC,cAAc;EAClBC,IAAI;AACN;AAEA,IAAA,eAAeD;",
-  "names": ["parseRootSurfacePlugin", "plugin", "provides", "surface", "components", "undefined", "parseSurfacePlugin", "component", "createContext", "useContext", "SurfaceRootContext", "createContext", "components", "useSurfaceRoot", "useContext", "SurfaceProvider", "Provider", "SurfaceMeta", "id"]
-}

package/dist/lib/browser/plugin-K3KCPCTJ.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/SurfacePlugin/plugin.tsx"],
-  "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 type { PluginDefinition } from '../PluginHost';\nimport { filterPlugins } from '../helpers';\n\n/**\n * Provides a registry of surface components.\n */\nconst SurfacePlugin = (): PluginDefinition<SurfacePluginProvides> => {\n  const state = create<SurfaceRootContext>({ components: {} });\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\nexport default SurfacePlugin;\n"],
-  "mappings": ";;;;;;;;;;AAIA,OAAOA,WAAW;AAElB,SAASC,cAAc;AAWvB,IAAMC,gBAAgB,MAAA;AACpB,QAAMC,QAAQC,OAA2B;IAAEC,YAAY,CAAC;EAAE,CAAA;AAE1D,SAAO;IACLC,MAAMC;IACNC,OAAO,OAAOC,YAAAA;AACZN,YAAME,aAAaK,cAAcD,SAASE,kBAAAA,EAAoBC,OAAO,CAACC,KAAKC,WAAAA;AACzE,eAAO;UAAE,GAAGD;UAAK,CAACC,OAAOR,KAAKS,EAAE,GAAGD,OAAOE,SAASC,QAAQC;QAAU;MACvE,GAAG,CAAC,CAAA;IACN;IACAF,UAAU;MACRC,SAASd;MACTgB,SAAS,CAAC,EAAEC,SAAQ,MAAO,sBAAA,cAACC,iBAAAA;QAAgBC,OAAOnB;SAAQiB,QAAAA;IAC7D;EACF;AACF;AAEA,IAAA,iBAAelB;",
-  "names": ["React", "create", "SurfacePlugin", "state", "create", "components", "meta", "SurfaceMeta", "ready", "plugins", "filterPlugins", "parseSurfacePlugin", "reduce", "acc", "plugin", "id", "provides", "surface", "component", "context", "children", "SurfaceProvider", "value"]
-}

package/dist/lib/node/chunk-P5GRB4XF.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/SurfacePlugin/provides.ts", "../../../src/plugins/SurfacePlugin/SurfaceRootContext.tsx", "../../../src/plugins/SurfacePlugin/meta.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type SurfaceComponent, type SurfaceRootContext } from './SurfaceRootContext';\nimport { type Plugin } from '../PluginHost';\n\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\nimport { createContext, useContext, type Context, type JSX, type Provider, type ForwardedRef } from 'react';\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\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\nconst SurfaceRootContext: Context<SurfaceRootContext> = createContext<SurfaceRootContext>({ components: {} });\n\nexport const useSurfaceRoot = () => useContext(SurfaceRootContext);\n\nexport const SurfaceProvider: Provider<SurfaceRootContext> = SurfaceRootContext.Provider;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nconst SurfaceMeta = {\n  id: 'dxos.org/plugin/surface',\n};\n\nexport default SurfaceMeta;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;ACIA,mBAAoG;ADgB7F,IAAMA,yBAAyB,CAACC,WACpCA,QAAQC,UAAkBC,SAASC,aAAcH,SAA2CI;AAExF,IAAMC,qBAAqB,CAACL,WAChCA,QAAQC,UAAkBC,SAASI,YAAaN,SAAqCI;ACexF,IAAMG,qBAAkDC,gDAAkC;EAAEL,YAAY,CAAC;AAAE,CAAA;AAEpG,IAAMM,iBAAiB,UAAMC,yBAAWH,kBAAAA;AAExC,IAAMI,kBAAgDJ,mBAAmBK;ACvChF,IAAMC,cAAc;EAClBC,IAAI;AACN;AAEA,IAAA,eAAeD;",
-  "names": ["parseRootSurfacePlugin", "plugin", "provides", "surface", "components", "undefined", "parseSurfacePlugin", "component", "SurfaceRootContext", "createContext", "useSurfaceRoot", "useContext", "SurfaceProvider", "Provider", "SurfaceMeta", "id"]
-}

package/dist/lib/node/plugin-RUJ5PEXB.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/SurfacePlugin/plugin.tsx"],
-  "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 type { PluginDefinition } from '../PluginHost';\nimport { filterPlugins } from '../helpers';\n\n/**\n * Provides a registry of surface components.\n */\nconst SurfacePlugin = (): PluginDefinition<SurfacePluginProvides> => {\n  const state = create<SurfaceRootContext>({ components: {} });\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\nexport default SurfacePlugin;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,mBAAkB;AAElB,yBAAuB;AAWvB,IAAMA,gBAAgB,MAAA;AACpB,QAAMC,YAAQC,2BAA2B;IAAEC,YAAY,CAAC;EAAE,CAAA;AAE1D,SAAO;IACLC,MAAMC;IACNC,OAAO,OAAOC,YAAAA;AACZN,YAAME,iBAAaK,qCAAcD,SAASE,wCAAAA,EAAoBC,OAAO,CAACC,KAAKC,WAAAA;AACzE,eAAO;UAAE,GAAGD;UAAK,CAACC,OAAOR,KAAKS,EAAE,GAAGD,OAAOE,SAASC,QAAQC;QAAU;MACvE,GAAG,CAAC,CAAA;IACN;IACAF,UAAU;MACRC,SAASd;MACTgB,SAAS,CAAC,EAAEC,SAAQ,MAAO,6BAAAC,QAAA,cAACC,uCAAAA;QAAgBC,OAAOpB;SAAQiB,QAAAA;IAC7D;EACF;AACF;AAEA,IAAA,iBAAelB;",
-  "names": ["SurfacePlugin", "state", "create", "components", "meta", "SurfaceMeta", "ready", "plugins", "filterPlugins", "parseSurfacePlugin", "reduce", "acc", "plugin", "id", "provides", "surface", "component", "context", "children", "React", "SurfaceProvider", "value"]
-}