@dxos/app-framework 0.6.13-main.548ca8d → 0.6.13-staging.1e988a3

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

@@ -1,3 +1,4 @@
+import type { IconProps } from '@phosphor-icons/react';
 import type { FC, PropsWithChildren } from 'react';
 /**
  * Capabilities provided by a plugin.
@@ -10,48 +11,52 @@ 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: PluginMeta;
+    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;
+    };
     /**
      * Capabilities provided by the plugin.
      */
@@ -84,6 +89,47 @@ 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,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"}
+{"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"}

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":"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"}
+{"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"}

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,6 +80,17 @@ 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.13-main.548ca8d",
+  "version": "0.6.13-staging.1e988a3",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -10,8 +10,7 @@
     ".": {
       "browser": "./dist/lib/browser/index.mjs",
       "node": {
-        "require": "./dist/lib/node/index.cjs",
-        "default": "./dist/lib/node-esm/index.mjs"
+        "default": "./dist/lib/node/index.cjs"
       },
       "types": "./dist/types/src/index.d.ts"
     }
@@ -21,26 +20,24 @@
     "*": {}
   },
   "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.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"
+    "@dxos/app-graph": "0.6.13-staging.1e988a3",
+    "@dxos/async": "0.6.13-staging.1e988a3",
+    "@dxos/client-protocol": "0.6.13-staging.1e988a3",
+    "@dxos/debug": "0.6.13-staging.1e988a3",
+    "@dxos/echo-schema": "0.6.13-staging.1e988a3",
+    "@dxos/local-storage": "0.6.13-staging.1e988a3",
+    "@dxos/invariant": "0.6.13-staging.1e988a3",
+    "@dxos/log": "0.6.13-staging.1e988a3",
+    "@dxos/util": "0.6.13-staging.1e988a3"
   },
   "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,10 +16,15 @@
       }
     },
     "lint": {},
-    "test": {}
+    "test": {
+      "options": {
+        "ciEnvironments": [
+          "nodejs"
+        ]
+      }
+    }
   },
   "implicitDependencies": [
-    "esbuild",
-    "node-std"
+    "test"
   ]
 }

package/src/App.tsx

@@ -15,7 +15,7 @@ import SurfaceMeta from './plugins/SurfacePlugin/meta';
  * Initializes plugins and renders the root components.
  *
  * @example
- * const meta = [LayoutMeta, MyPluginMeta];
+ * const order = [LayoutMeta, MyPluginMeta];
  * const plugins = {
  *  [LayoutMeta.id]: Plugin.lazy(() => import('./plugins/LayoutPlugin/plugin')),
  *  [MyPluginMeta.id]: Plugin.lazy(() => import('./plugins/MyPlugin/plugin')),
@@ -30,29 +30,28 @@ 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.defaults Default plugins are enabled by default but can be disabled by the user.
+ * @param params.default 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 = ({ meta, plugins, core, ...params }: BootstrapPluginsParams) => {
+export const createApp = ({ order, plugins, core = order.map(({ id }) => id), ...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);
-  const { context: Context, root: Root } = host.provides;
-  invariant(Context);
-  invariant(Root);
+  invariant(host.provides?.context);
+  invariant(host.provides?.root);
+  const Context = host.provides.context;
+  const Root = host.provides.root;
 
   return () => (
     <Context>

package/src/plugins/PluginHost/PluginContext.tsx

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

package/src/plugins/PluginHost/PluginHost.tsx

@@ -2,20 +2,19 @@
 // Copyright 2023 DXOS.org
 //
 
-import React, { type ReactNode } from 'react';
+import React, { type JSX, type FC, type PropsWithChildren, type ReactNode, useEffect, useState } 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 PluginMeta } from './plugin';
+import { type Plugin, type PluginDefinition, type PluginProvides } from './plugin';
 import { ErrorBoundary } from '../SurfacePlugin';
 
 export type BootstrapPluginsParams = {
+  order: PluginDefinition['meta'][];
   plugins: Record<string, () => Promise<PluginDefinition>>;
-  // Ordered list of plugins.
-  meta: PluginMeta[];
-  core: string[];
+  core?: string[];
   defaults?: string[];
   fallback?: ErrorBoundary['props']['fallback'];
   placeholder?: ReactNode;
@@ -34,9 +33,9 @@ const PLUGIN_HOST = 'dxos.org/plugin/host';
  * Bootstraps an application by initializing plugins and rendering root components.
  */
 export const PluginHost = ({
-  plugins,
-  meta,
-  core,
+  order,
+  plugins: definitions,
+  core = [],
   defaults = [],
   fallback = DefaultFallback,
   placeholder = null,
@@ -46,7 +45,7 @@ export const PluginHost = ({
     core,
     enabled: [...defaults],
     plugins: [],
-    available: meta.filter(({ id }) => !core.includes(id)),
+    available: order.filter(({ id }) => !core.includes(id)),
     setPlugin: (id: string, enabled: boolean) => {
       if (enabled) {
         state.values.enabled.push(id);
@@ -57,7 +56,6 @@ export const PluginHost = ({
     },
   });
 
-  // Register and load values.
   state.prop({ key: 'enabled', type: LocalStorageStore.json<string[]>() });
 
   return {
@@ -67,13 +65,11 @@ export const PluginHost = ({
     },
     provides: {
       plugins: state.values,
-      context: ({ children }) => {
-        return <PluginProvider value={state.values}>{children}</PluginProvider>;
-      },
+      context: ({ children }) => <PluginProvider value={state.values}>{children}</PluginProvider>,
       root: () => {
         return (
           <ErrorBoundary fallback={fallback}>
-            <PluginContainer plugins={plugins} core={core} state={state.values} placeholder={placeholder} />
+            <Root order={order} core={core} definitions={definitions} state={state.values} placeholder={placeholder} />
           </ErrorBoundary>
         );
       },
@@ -81,9 +77,6 @@ export const PluginHost = ({
   };
 };
 
-/**
- * Fallback does not use tailwind or theme.
- */
 const DefaultFallback = ({ error }: { error: Error }) => {
   return (
     <div style={{ padding: '1rem' }}>
@@ -93,3 +86,113 @@ 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,10 +2,11 @@
 // 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';