@dxos/app-framework 0.6.12 → 0.6.13-main.548ca8d

package/dist/types/src/plugins/PluginHost/plugin.d.ts

@@ -1,4 +1,3 @@
-import type { IconProps } from '@phosphor-icons/react';
 import type { FC, PropsWithChildren } from 'react';
 /**
  * Capabilities provided by a plugin.
@@ -11,52 +10,48 @@ export type PluginProvides<TProvides> = TProvides & {
     context?: FC<PropsWithChildren>;
     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.
+     */
+    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.
-         */
-        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.
      */
@@ -89,47 +84,6 @@ export type PluginDefinition<TProvides = {}, TInitializeProvides = {}> = Omit<Pl
      */
     unload?: () => Promise<void>;
 };
-export declare const pluginMeta: (meta: Plugin["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.
-     */
-    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;
-};
 type LazyPlugin<T> = () => Promise<{
     default: (props: T) => PluginDefinition;
 }>;

package/dist/types/src/plugins/PluginHost/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/PluginHost/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,SAAS,IAAI,SAAS,GAAG;IAClD;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;IAKhC,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,SAAS,GAAG,EAAE,IAAI;IACnC,IAAI,EAAE;QACJ;;;;;;WAMG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;;;WAIG;QAEH,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAEhB;;;WAGG;QACH,aAAa,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;QAE9B;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,SAAS,GAAG,EAAE,EAAE,mBAAmB,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG;IAClG;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;IAEzC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvE;;;;;OAKG;IAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,UAAU,SAAU,MAAM,CAAC,MAAM,CAAC;IAvF3C;;;;;;OAMG;QACC,MAAM;IAEV;;;;OAIG;cAEO,MAAM;IAEhB;;OAEG;WACI,MAAM;IAEb;;OAEG;kBACW,MAAM;IAEpB;;OAEG;eACQ,MAAM;IAEjB;;OAEG;WACI,MAAM,EAAE;IAEf;;;OAGG;oBACa,EAAE,CAAC,SAAS,CAAC;IAE7B;;OAEG;iBACU,MAAM;CAyCiC,CAAC;AAEzD,KAAK,UAAU,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,gBAAgB,CAAA;CAAE,CAAC,CAAC;AAEhF,yBAAiB,MAAM,CAAC;IACf,MAAM,IAAI,GAAI,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,4CAKlD,CAAC;CACH"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/PluginHost/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,SAAS,IAAI,SAAS,GAAG;IAClD;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;IAKhC,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IAEH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,SAAS,GAAG,EAAE,IAAI;IACnC,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,SAAS,GAAG,EAAE,EAAE,mBAAmB,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG;IAClG;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;IAEzC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvE;;;;;OAKG;IAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,KAAK,UAAU,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,gBAAgB,CAAA;CAAE,CAAC,CAAC;AAEhF,yBAAiB,MAAM,CAAC;IACf,MAAM,IAAI,GAAI,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,4CAKlD,CAAC;CACH"}

package/dist/types/src/plugins/PluginHost/plugin.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/PluginHost/plugin.test.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAQhC,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,KAAK,YAAY,CAAC,CAAC,IAAI;IACrB,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,EAAE,CAAC,CAAC;CACT,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAG,YAAY,CAAC,CAAC,CAAoB,CAAC;AAE3F,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;CAChC,CAAC;AAEF,qBAAa,UAAU;IACrB,QAAQ,CAAC,WAAW,mBAA0B;gBAClC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAIrC,YAAY,GAAI,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,KAAG,CAAC,GAAG,SAAS,CAAkC;CACvF;AAYD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,GAAG,SAAS,KAAK,IAAI,CAAC;CACxC;AAED,eAAO,MAAM,SAAS,EAAE,SAAS,CAAC,SAAS,CAAwB,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,CAAC,UAAU,CAAyB,CAAC;AAGvE,MAAM,MAAM,OAAO,GAAG,EAAE,CAAC;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;CAAE,CAAC,CAAC;AAE1F,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,OAAO,CAAmB,CAAC"}
+{"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/PluginHost/plugin.test.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAQhC,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,KAAK,YAAY,CAAC,CAAC,IAAI;IACrB,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,EAAE,CAAC,CAAC;CACT,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAG,YAAY,CAAC,CAAC,CAAoB,CAAC;AAE3F,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;CAChC,CAAC;AAEF,qBAAa,UAAU;IACrB,QAAQ,CAAC,WAAW,mBAA0B;gBAClC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAIrC,YAAY,GAAI,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,KAAG,CAAC,GAAG,SAAS,CAAkC;CACvF;AAYD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,GAAG,SAAS,KAAK,IAAI,CAAC;CACxC;AAED,eAAO,MAAM,SAAS,EAAE,SAAS,CAAC,SAAS,CAAwB,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,CAAC,UAAU,CAAyB,CAAC;AAGvE,MAAM,MAAM,OAAO,GAAG,EAAE,CAAC;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;CAAE,CAAC,CAAC;AAE1F,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,OAAO,CAAmB,CAAC"}

package/dist/types/src/plugins/common/navigation.d.ts

@@ -1,5 +1,5 @@
+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';
 export declare const SLUG_LIST_SEPARATOR = "+";
@@ -80,17 +80,6 @@ export type LayoutContainerProps<T> = T & {
     role?: string;
     coordinate?: LayoutCoordinate;
 };
-/**
- * Basic state provided by a navigation plugin.
- */
-export declare const Attention: z.ZodObject<{
-    attended: z.ZodOptional<z.ZodSet<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    attended?: Set<string> | undefined;
-}, {
-    attended?: Set<string> | undefined;
-}>;
-export type Attention = z.infer<typeof Attention>;
 /**
  * Provides for a plugin that can manage the app navigation.
  */

package/dist/types/src/plugins/common/navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/common/navigation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/common/navigation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/app-framework",
-  "version": "0.6.12",
+  "version": "0.6.13-main.548ca8d",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -10,7 +10,8 @@
     ".": {
       "browser": "./dist/lib/browser/index.mjs",
       "node": {
-        "default": "./dist/lib/node/index.cjs"
+        "require": "./dist/lib/node/index.cjs",
+        "default": "./dist/lib/node-esm/index.mjs"
       },
       "types": "./dist/types/src/index.d.ts"
     }
@@ -20,24 +21,26 @@
     "*": {}
   },
   "dependencies": {
+    "@effect/schema": "^0.75.1",
     "@phosphor-icons/react": "^2.1.5",
     "@preact/signals-core": "^1.6.0",
     "zod": "^3.22.4",
-    "@dxos/app-graph": "0.6.12",
-    "@dxos/async": "0.6.12",
-    "@dxos/debug": "0.6.12",
-    "@dxos/client-protocol": "0.6.12",
-    "@dxos/echo-schema": "0.6.12",
-    "@dxos/local-storage": "0.6.12",
-    "@dxos/log": "0.6.12",
-    "@dxos/util": "0.6.12",
-    "@dxos/invariant": "0.6.12"
+    "@dxos/app-graph": "0.6.13-main.548ca8d",
+    "@dxos/async": "0.6.13-main.548ca8d",
+    "@dxos/client-protocol": "0.6.13-main.548ca8d",
+    "@dxos/echo-schema": "0.6.13-main.548ca8d",
+    "@dxos/invariant": "0.6.13-main.548ca8d",
+    "@dxos/debug": "0.6.13-main.548ca8d",
+    "@dxos/log": "0.6.13-main.548ca8d",
+    "@dxos/util": "0.6.13-main.548ca8d",
+    "@dxos/local-storage": "0.6.13-main.548ca8d"
   },
   "devDependencies": {
     "@types/react": "~18.2.0",
     "react": "~18.2.0"
   },
   "peerDependencies": {
+    "@phosphor-icons/react": "^2.1.5",
     "react": "~18.2.0"
   },
   "publishConfig": {

package/project.json

@@ -16,15 +16,10 @@
       }
     },
     "lint": {},
-    "test": {
-      "options": {
-        "ciEnvironments": [
-          "nodejs"
-        ]
-      }
-    }
+    "test": {}
   },
   "implicitDependencies": [
-    "test"
+    "esbuild",
+    "node-std"
   ]
 }

package/src/App.tsx

@@ -15,7 +15,7 @@ import SurfaceMeta from './plugins/SurfacePlugin/meta';
  * Initializes plugins and renders the root components.
  *
  * @example
- * const order = [LayoutMeta, MyPluginMeta];
+ * const meta = [LayoutMeta, MyPluginMeta];
  * const plugins = {
  *  [LayoutMeta.id]: Plugin.lazy(() => import('./plugins/LayoutPlugin/plugin')),
  *  [MyPluginMeta.id]: Plugin.lazy(() => import('./plugins/MyPlugin/plugin')),
@@ -30,28 +30,29 @@ import SurfaceMeta from './plugins/SurfacePlugin/meta';
  *   </StrictMode>,
  * );
  *
- * @param params.order Total ordering of plugins.
  * @param params.plugins All plugins available to the application.
+ * @param params.meta All plugin metadata.
  * @param params.core Core plugins which will always be enabled.
- * @param params.default Default plugins are enabled by default but can be disabled by the user.
+ * @param params.defaults Default plugins are enabled by default but can be disabled by the user.
  * @param params.fallback Fallback component to render while plugins are initializing.
  */
-export const createApp = ({ order, plugins, core = order.map(({ id }) => id), ...params }: BootstrapPluginsParams) => {
+export const createApp = ({ meta, plugins, core, ...params }: BootstrapPluginsParams) => {
   const host = PluginHost({
-    order: [SurfaceMeta, IntentMeta, ...order],
     plugins: {
       ...plugins,
       [SurfaceMeta.id]: Plugin.lazy(() => import('./plugins/SurfacePlugin/plugin')),
       [IntentMeta.id]: Plugin.lazy(() => import('./plugins/IntentPlugin/plugin')),
     },
+    // TODO(burdon): Why not include in core?
+    meta: [SurfaceMeta, IntentMeta, ...meta],
     core: [SurfaceMeta.id, IntentMeta.id, ...core],
     ...params,
   });
 
-  invariant(host.provides?.context);
-  invariant(host.provides?.root);
-  const Context = host.provides.context;
-  const Root = host.provides.root;
+  invariant(host.provides);
+  const { context: Context, root: Root } = host.provides;
+  invariant(Context);
+  invariant(Root);
 
   return () => (
     <Context>

package/src/plugins/PluginHost/PluginContainer.tsx

@@ -0,0 +1,120 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import React, { type JSX, type FC, type PropsWithChildren, type ReactNode, useEffect, useState } from 'react';
+
+import { log } from '@dxos/log';
+
+import { type PluginContext } from './PluginContext';
+import { type BootstrapPluginsParams } from './PluginHost';
+import { type Plugin, type PluginDefinition, type PluginProvides } from './plugin';
+
+export type PluginContainerProps = Pick<BootstrapPluginsParams, 'core'> & {
+  plugins: Record<string, () => Promise<PluginDefinition>>;
+  state: PluginContext;
+  placeholder: ReactNode;
+};
+
+/**
+ * Root component initializes plugins.
+ */
+export const PluginContainer = ({ plugins: definitions, core, state, placeholder }: PluginContainerProps) => {
+  const [error, setError] = useState<unknown>();
+
+  useEffect(() => {
+    log('initializing plugins', { enabled: state.enabled });
+    const t = setTimeout(async () => {
+      try {
+        const enabledIds = [...core, ...state.enabled];
+        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 });
+            });
+
+            log('initialized', { plugin: definition.meta.id });
+            return plugin;
+          }),
+        );
+
+        const initialized = plugins.filter((plugin): plugin is Plugin => Boolean(plugin));
+        log('plugins initialized', { plugins: initialized });
+
+        await Promise.all(enabled.map((plugin) => plugin.ready?.(initialized)));
+        log('plugins ready', { plugins: initialized });
+
+        state.plugins = initialized;
+        state.ready = true;
+      } catch (err) {
+        setError(err);
+      }
+    });
+
+    return () => {
+      clearTimeout(t);
+      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`.
+ */
+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/PluginContext.tsx

@@ -2,11 +2,12 @@
 // Copyright 2024 DXOS.org
 //
 
-import { type Context, type Provider, createContext, useContext, useMemo } from 'react';
+import { createContext, useContext, useMemo } from 'react';
 
+import { raise } from '@dxos/debug';
 import { nonNullable } from '@dxos/util';
 
-import { type Plugin } from './plugin';
+import { type Plugin, type PluginMeta } from './plugin';
 import { findPlugin, resolvePlugin } from '../helpers';
 
 export type PluginContext = {
@@ -32,9 +33,9 @@ export type PluginContext = {
 
   /**
    * All available plugins.
+   * NOTE: This is metadata rather than just ids because it includes plugins which have not been fully loaded yet.
    */
-  // This is metadata rather then just ids because it includes plugins which have not been fully loaded yet.
-  available: Plugin['meta'][];
+  available: PluginMeta[];
 
   /**
    * Mark plugin as enabled.
@@ -43,19 +44,12 @@ export type PluginContext = {
   setPlugin: (id: string, enabled: boolean) => void;
 };
 
-const PluginContext: Context<PluginContext> = createContext<PluginContext>({
-  ready: false,
-  core: [],
-  enabled: [],
-  plugins: [],
-  available: [],
-  setPlugin: () => {},
-});
+const PluginContext = createContext<PluginContext | undefined>(undefined);
 
 /**
  * Get all plugins.
  */
-export const usePlugins = (): PluginContext => useContext(PluginContext);
+export const usePlugins = (): PluginContext => useContext(PluginContext) ?? raise(new Error('Missing PluginContext'));
 
 /**
  * Get a plugin by ID.
@@ -81,4 +75,4 @@ export const useResolvePlugins = <T,>(predicate: (plugin: Plugin) => Plugin<T> |
   return useMemo(() => plugins.map(predicate).filter(nonNullable), [plugins, predicate]);
 };
 
-export const PluginProvider: Provider<PluginContext> = PluginContext.Provider;
+export const PluginProvider = PluginContext.Provider;