@dxos/app-framework 0.3.6 → 0.3.7-main.0bad7ea

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,EAAE,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAExD;;;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;KAClB,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,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,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"}
+{"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;QAEH,aAAa,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;KAC/B,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,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,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;IAvE3C;;;;;;OAMG;QACC,MAAM;IAEV;;;;OAIG;;IAIH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CA0CiD,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,yFAKhB,CAAC;CACH"}

package/dist/types/src/plugins/SurfacePlugin/Surface.d.ts

@@ -1,10 +1,10 @@
-import { type FC } from 'react';
+import React, { type FC, type PropsWithChildren } from 'react';
 import { ErrorBoundary } from './ErrorBoundary';
 /**
  * Direction determines how multiple components are laid out.
  */
 export type Direction = 'inline' | 'inline-reverse' | 'block' | 'block-reverse';
-export type SurfaceProps = {
+export type SurfaceProps = PropsWithChildren<{
     /**
      * Role defines how the data should be rendered.
      */
@@ -40,9 +40,14 @@ export type SurfaceProps = {
      * 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;
+}>;
 /**
  * A surface is a named region of the screen that can be populated by plugins.
  */
-export declare const Surface: ({ role, name, fallback, ...rest }: SurfaceProps) => JSX.Element;
+export declare const Surface: React.ForwardRefExoticComponent<Pick<SurfaceProps, string | number> & React.RefAttributes<HTMLElement>>;
 //# sourceMappingURL=Surface.d.ts.map

package/dist/types/src/plugins/SurfacePlugin/Surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/Surface.tsx"],"names":[],"mappings":"AAIA,OAAc,EAAE,KAAK,EAAE,EAA0C,MAAM,OAAO,CAAC;AAG/E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,gBAAgB,GAAG,OAAO,GAAG,eAAe,CAAC;AAEhF,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAEnE;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IAE9C;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAEzB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,sCAA8C,YAAY,gBAgB7E,CAAC"}
+{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/Surface.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAc,KAAK,EAAE,EAA+C,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAGxH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,gBAAgB,GAAG,OAAO,GAAG,eAAe,CAAC;AAEhF,MAAM,MAAM,YAAY,GAAG,iBAAiB,CAAC;IAC3C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAEnE;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IAE9C;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAEzB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO,yGAkBnB,CAAC"}

package/dist/types/src/plugins/SurfacePlugin/SurfaceRootContext.d.ts

@@ -1,13 +1,19 @@
-import { type Provider, type ReactNode } from 'react';
+import { type Provider, type ReactNode, type ForwardedRef } from 'react';
+import { type SurfaceProps } from './Surface';
+type WithRequiredProperty<Type, Key extends keyof Type> = Type & {
+    [Property in Key]-?: Type[Property];
+};
+type SurfaceComponentProps = WithRequiredProperty<SurfaceProps, 'data'>;
 /**
  * Function which resolves a Surface.
  *
  * If a null value is returned, the rendering is deferred to other plugins.
  */
-export type SurfaceComponent = (data: Record<string, unknown>, role?: string) => ReactNode;
+export type SurfaceComponent = (props: SurfaceComponentProps, forwardedRef: ForwardedRef<HTMLElement>) => ReactNode;
 export type SurfaceRootContext = {
     components: Record<string, SurfaceComponent>;
 };
 export declare const useSurface: () => SurfaceRootContext;
 export declare const SurfaceProvider: Provider<SurfaceRootContext>;
+export {};
 //# sourceMappingURL=SurfaceRootContext.d.ts.map

package/dist/types/src/plugins/SurfacePlugin/SurfaceRootContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SurfaceRootContext.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/SurfaceRootContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAA2C,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE/F;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,SAAS,CAAC;AAE3F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C,CAAC;AAIF,eAAO,MAAM,UAAU,0BAAuC,CAAC;AAE/D,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,kBAAkB,CAA+B,CAAC"}
+{"version":3,"file":"SurfaceRootContext.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/SurfaceRootContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAA2C,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAElH,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,KAAK,oBAAoB,CAAC,IAAI,EAAE,GAAG,SAAS,MAAM,IAAI,IAAI,IAAI,GAAG;KAC9D,QAAQ,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;CACpC,CAAC;AAEF,KAAK,qBAAqB,GAAG,oBAAoB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,CAAC,WAAW,CAAC,KAAK,SAAS,CAAC;AAEpH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C,CAAC;AAIF,eAAO,MAAM,UAAU,0BAAuC,CAAC;AAE/D,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,kBAAkB,CAA+B,CAAC"}

package/dist/types/src/plugins/SurfacePlugin/index.d.ts

@@ -1,5 +1,5 @@
+export * from './provides';
 export * from './ErrorBoundary';
 export * from './Surface';
-export * from './SurfacePlugin';
 export * from './SurfaceRootContext';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/plugins/SurfacePlugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/index.ts"],"names":[],"mappings":"AAIA,cAAc,YAAY,CAAC;AAE3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC"}

package/dist/types/src/plugins/SurfacePlugin/meta.d.ts

@@ -0,0 +1,5 @@
+declare const SurfaceMeta: {
+    id: string;
+};
+export default SurfaceMeta;
+//# sourceMappingURL=meta.d.ts.map

package/dist/types/src/plugins/SurfacePlugin/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/meta.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,WAAW;;CAEhB,CAAC;AAEF,eAAe,WAAW,CAAC"}

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

@@ -0,0 +1,8 @@
+import { type SurfacePluginProvides } from './provides';
+import type { PluginDefinition } from '../PluginHost';
+/**
+ * Provides a registry of surface components.
+ */
+declare const SurfacePlugin: () => PluginDefinition<SurfacePluginProvides>;
+export default SurfacePlugin;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/plugin.tsx"],"names":[],"mappings":"AASA,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD;;GAEG;AACH,QAAA,MAAM,aAAa,QAAO,iBAAiB,qBAAqB,CAiB/D,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/types/src/plugins/SurfacePlugin/{SurfacePlugin.d.ts → provides.d.ts}

@@ -1,5 +1,5 @@
 import { type SurfaceComponent, type SurfaceRootContext } from './SurfaceRootContext';
-import type { Plugin, PluginDefinition } from '../PluginHost';
+import { type Plugin } from '../PluginHost';
 export type SurfaceProvides = {
     surface: {
         /**
@@ -13,8 +13,4 @@ export type SurfacePluginProvides = {
 };
 export declare const parseRootSurfacePlugin: (plugin?: Plugin) => Plugin<SurfacePluginProvides> | undefined;
 export declare const parseSurfacePlugin: (plugin?: Plugin) => Plugin<SurfaceProvides> | undefined;
-/**
- * Provides a registry of surface components.
- */
-export declare const SurfacePlugin: () => PluginDefinition<SurfacePluginProvides>;
-//# sourceMappingURL=SurfacePlugin.d.ts.map
+//# sourceMappingURL=provides.d.ts.map

package/dist/types/src/plugins/SurfacePlugin/provides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provides.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/provides.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE;QACP;;WAEG;QACH,SAAS,EAAE,gBAAgB,CAAC;KAC7B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,kBAAkB,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,sBAAsB,YAAa,MAAM,8CACkD,CAAC;AAEzG,eAAO,MAAM,kBAAkB,YAAa,MAAM,wCAC+C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/app-framework",
-  "version": "0.3.6",
+  "version": "0.3.7-main.0bad7ea",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -12,14 +12,16 @@
   },
   "types": "dist/types/src/index.d.ts",
   "dependencies": {
+    "@phosphor-icons/react": "^2.0.5",
     "@preact/signals-react": "^1.3.6",
     "deepsignal": "1.4.0-shallow.0",
     "zod": "^3.19.1",
-    "@dxos/async": "0.3.6",
-    "@dxos/app-graph": "0.3.6",
-    "@dxos/debug": "0.3.6",
-    "@dxos/log": "0.3.6",
-    "@dxos/invariant": "0.3.6"
+    "@dxos/app-graph": "0.3.7-main.0bad7ea",
+    "@dxos/async": "0.3.7-main.0bad7ea",
+    "@dxos/debug": "0.3.7-main.0bad7ea",
+    "@dxos/invariant": "0.3.7-main.0bad7ea",
+    "@dxos/local-storage": "0.3.7-main.0bad7ea",
+    "@dxos/log": "0.3.7-main.0bad7ea"
   },
   "devDependencies": {
     "@types/react": "^18.0.21",

package/src/App.tsx

@@ -6,28 +6,46 @@ import React from 'react';
 
 import { invariant } from '@dxos/invariant';
 
-import { type BootstrapPluginsParams, PluginHost, SurfacePlugin, IntentPlugin } from './plugins';
+import { type BootstrapPluginsParams, PluginHost, Plugin } from './plugins';
+import IntentMeta from './plugins/IntentPlugin/meta';
+import SurfaceMeta from './plugins/SurfacePlugin/meta';
 
 /**
  * Expected usage is for this to be the entrypoint of the application.
  * Initializes plugins and renders the root components.
  *
  * @example
+ * const order = [LayoutMeta, MyPluginMeta];
+ * const plugins = {
+ *  [LayoutMeta.id]: Plugin.lazy(() => import('./plugins/LayoutPlugin/plugin')),
+ *  [MyPluginMeta.id]: Plugin.lazy(() => import('./plugins/MyPlugin/plugin')),
+ * };
+ * const core = [LayoutMeta.id];
+ * const default = [MyPluginMeta.id];
  * const fallback = <div>Initializing Plugins...</div>;
- * const App = createApp({ plugins, fallback });
+ * const App = createApp({ order, plugins, core, default, fallback });
  * createRoot(document.getElementById('root')!).render(
  *   <StrictMode>
  *     <App />
  *   </StrictMode>,
  * );
  *
- * @param params.plugins List of plugin definitions to initialize.
+ * @param params.order Total ordering of plugins.
+ * @param params.plugins All plugins available to the application.
+ * @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.fallback Fallback component to render while plugins are initializing.
  */
-export const createApp = ({ plugins, fallback }: BootstrapPluginsParams) => {
+export const createApp = ({ order, plugins, core = [], ...params }: BootstrapPluginsParams) => {
   const host = PluginHost({
-    plugins: [SurfacePlugin(), IntentPlugin(), ...plugins],
-    fallback,
+    order: [SurfaceMeta, IntentMeta, ...order],
+    plugins: {
+      ...plugins,
+      [SurfaceMeta.id]: Plugin.lazy(() => import('./plugins/SurfacePlugin/plugin')),
+      [IntentMeta.id]: Plugin.lazy(() => import('./plugins/IntentPlugin/plugin')),
+    },
+    core: [SurfaceMeta.id, IntentMeta.id, ...core],
+    ...params,
   });
 
   invariant(host.provides?.context);

package/src/plugins/IntentPlugin/index.ts

@@ -3,5 +3,6 @@
 //
 
 export * from './intent';
+export * from './provides';
+
 export * from './IntentContext';
-export * from './IntentPlugin';

package/src/plugins/IntentPlugin/meta.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+const IntentMeta = {
+  id: 'dxos.org/plugin/intent',
+};
+
+export default IntentMeta;

package/src/plugins/IntentPlugin/{IntentPlugin.tsx → plugin.tsx}

@@ -6,37 +6,21 @@ import { deepSignal } from 'deepsignal/react';
 import React from 'react';
 
 import { type IntentContext, IntentProvider } from './IntentContext';
-import { type Intent } from './intent';
-import { type PluginDefinition, type Plugin } from '../PluginHost';
+import type { Intent } from './intent';
+import IntentMeta from './meta';
+import { type IntentPluginProvides, type IntentResolverProvides, parseIntentResolverPlugin } from './provides';
+import type { PluginDefinition } from '../PluginHost';
 import { filterPlugins, findPlugin } from '../helpers';
 
-export type IntentResolverProvides = {
-  intent: {
-    resolver: (intent: Intent, plugins: Plugin[]) => any;
-  };
-};
-
-export type IntentPluginProvides = {
-  intent: IntentContext;
-};
-
-export const parseIntentPlugin = (plugin: Plugin) =>
-  (plugin.provides as any).intent?.dispatch ? (plugin as Plugin<IntentPluginProvides>) : undefined;
-
-export const parseIntentResolverPlugin = (plugin: Plugin) =>
-  (plugin.provides as any).intent?.resolver ? (plugin as Plugin<IntentResolverProvides>) : undefined;
-
 /**
  * Allows plugins to register intent handlers and routes sent intents to the appropriate plugin.
  * Inspired by https://developer.android.com/reference/android/content/Intent.
  */
-export const IntentPlugin = (): PluginDefinition<IntentPluginProvides> => {
+const IntentPlugin = (): PluginDefinition<IntentPluginProvides> => {
   const state = deepSignal<IntentContext>({ dispatch: async () => {} });
 
   return {
-    meta: {
-      id: 'dxos.org/plugin/intent',
-    },
+    meta: IntentMeta,
     ready: async (plugins) => {
       // Dispatch intent to associated plugin.
       const dispatch = async (intent: Intent) => {
@@ -70,3 +54,5 @@ export const IntentPlugin = (): PluginDefinition<IntentPluginProvides> => {
     },
   };
 };
+
+export default IntentPlugin;

package/src/plugins/IntentPlugin/provides.ts

@@ -0,0 +1,23 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { type IntentContext } from './IntentContext';
+import { type Intent } from './intent';
+import { type Plugin } from '../PluginHost';
+
+export type IntentResolverProvides = {
+  intent: {
+    resolver: (intent: Intent, plugins: Plugin[]) => any;
+  };
+};
+
+export type IntentPluginProvides = {
+  intent: IntentContext;
+};
+
+export const parseIntentPlugin = (plugin: Plugin) =>
+  (plugin.provides as any).intent?.dispatch ? (plugin as Plugin<IntentPluginProvides>) : undefined;
+
+export const parseIntentResolverPlugin = (plugin: Plugin) =>
+  (plugin.provides as any).intent?.resolver ? (plugin as Plugin<IntentResolverProvides>) : undefined;

package/src/plugins/PluginHost/PluginContext.tsx

@@ -4,21 +4,52 @@
 
 import { type Context, type Provider, createContext, useContext } from 'react';
 
-import { type Plugin, type PluginDefinition } from './plugin';
+import { type Plugin } from './plugin';
 import { findPlugin, resolvePlugin } from '../helpers';
 
 export type PluginContext = {
+  /**
+   * All plugins are ready.
+   */
   ready: boolean;
-  initializing: PluginDefinition[];
-  loading: PluginDefinition[];
+
+  /**
+   * Ids of plugins which are enabled on this device.
+   */
+  enabled: string[];
+
+  /**
+   * Initialized and ready plugins.
+   */
   plugins: Plugin[];
+
+  /**
+   * All available plugins.
+   */
+  available: Plugin['meta'][];
+
+  /**
+   * Mark plugin as enabled.
+   *
+   * Requires reload to take effect.
+   */
+  enablePlugin: (id: string) => void;
+
+  /**
+   * Mark plugin as disabled.
+   *
+   * Requires reload to take effect.
+   */
+  disablePlugin: (id: string) => void;
 };
 
 const PluginContext: Context<PluginContext> = createContext<PluginContext>({
   ready: false,
-  initializing: [],
-  loading: [],
+  enabled: [],
   plugins: [],
+  available: [],
+  enablePlugin: () => {},
+  disablePlugin: () => {},
 });
 
 /**

package/src/plugins/PluginHost/PluginHost.tsx

@@ -2,17 +2,21 @@
 // Copyright 2023 DXOS.org
 //
 
-import { deepSignal, shallow } from 'deepsignal/react';
+import { shallow } from 'deepsignal/react';
 import React, { useEffect, type FC, type PropsWithChildren, type ReactNode } from 'react';
 
+import { LocalStorageStore } from '@dxos/local-storage';
 import { log } from '@dxos/log';
 
 import { type PluginContext, PluginProvider } from './PluginContext';
 import { type Plugin, type PluginDefinition, type PluginProvides } from './plugin';
 
 export type BootstrapPluginsParams = {
-  plugins: PluginDefinition[];
-  fallback?: ReactNode | FC<Omit<PluginContext, 'ready'>>;
+  order: PluginDefinition['meta'][];
+  plugins: Record<string, () => Promise<PluginDefinition>>;
+  core?: string[];
+  defaults?: string[];
+  fallback?: ReactNode;
 };
 
 export type PluginHostProvides = {
@@ -22,72 +26,96 @@ export type PluginHostProvides = {
 export const parsePluginHost = (plugin: Plugin) =>
   (plugin.provides as PluginHostProvides).plugins ? (plugin as Plugin<PluginHostProvides>) : undefined;
 
+const PLUGIN_HOST = 'dxos.org/plugin/host';
+
 /**
  * Bootstraps an application by initializing plugins and rendering root components.
  */
 export const PluginHost = ({
+  order,
   plugins: definitions,
-  fallback,
+  core = order.map(({ id }) => id),
+  defaults = [],
+  fallback = null,
 }: BootstrapPluginsParams): PluginDefinition<PluginHostProvides> => {
-  const state = deepSignal<PluginContext>({ ready: false, initializing: [], loading: [], plugins: [] });
+  const state = new LocalStorageStore<PluginContext>(PLUGIN_HOST, {
+    ready: false,
+    enabled: [...defaults],
+    plugins: [],
+    available: order.filter(({ id }) => !core.includes(id)),
+    enablePlugin: (id: string) => {
+      state.values.enabled = [...state.values.enabled, id];
+    },
+    disablePlugin: (id: string) => {
+      state.values.enabled = state.values.enabled.filter((enabled) => enabled !== id);
+    },
+  });
+
+  state.prop(state.values.$enabled!, 'enabled', LocalStorageStore.json);
 
   return {
     meta: {
-      id: 'dxos.org/plugin/host',
+      id: PLUGIN_HOST,
+      name: 'Plugin host',
     },
     provides: {
-      plugins: state,
-      context: ({ children }) => <PluginProvider value={state}>{children}</PluginProvider>,
+      plugins: state.values,
+      context: ({ children }) => <PluginProvider value={state.values}>{children}</PluginProvider>,
       root: () => {
         useEffect(() => {
-          log('initializing plugins', { definitions });
+          log('initializing plugins', { enabled: state.values.enabled });
           const timeout = setTimeout(async () => {
-            state.initializing = shallow(definitions);
+            const enabledIds = [...core, ...state.values.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(
-              definitions.map(async (definition) => {
+              enabled.map(async (definition) => {
                 const plugin = await initializePlugin(definition).catch((err) => {
                   console.error('Failed to initialize plugin:', definition.meta.id, err);
                   return undefined;
                 });
-                state.initializing = shallow(state.initializing.filter((plugin) => plugin !== definition));
                 return plugin;
               }),
             ).then((plugins) => plugins.filter((plugin): plugin is Plugin => Boolean(plugin)));
-
             log('plugins initialized', { plugins });
-            state.loading = shallow(definitions);
+
             await Promise.all(
-              definitions.map(async (pluginDefinition) => {
+              enabled.map(async (pluginDefinition) => {
                 await pluginDefinition.ready?.(plugins);
-                state.loading = shallow(state.loading.filter((plugin) => plugin !== pluginDefinition));
               }),
             );
-
             log('plugins ready', { plugins });
-            state.plugins = shallow(plugins);
-            state.ready = true;
+
+            state.values.plugins = shallow(plugins);
+            state.values.ready = true;
           });
 
           return () => {
             clearTimeout(timeout);
-            state.ready = false;
-            void Promise.all(definitions.map((definition) => definition.unload?.()));
+            state.values.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 (!state.ready) {
-          if (typeof fallback === 'function') {
-            const FallbackComponent = fallback;
-            return (
-              <FallbackComponent initializing={state.initializing} loading={state.loading} plugins={state.plugins} />
-            );
-          }
-          return <>{fallback ?? null}</>;
+        if (!state.values.ready) {
+          return <>{fallback}</>;
         }
 
-        const ComposedContext = composeContext(state.plugins);
+        const ComposedContext = composeContext(state.values.plugins);
 
-        return <ComposedContext>{rootComponents(state.plugins)}</ComposedContext>;
+        return <ComposedContext>{rootComponents(state.values.plugins)}</ComposedContext>;
       },
     },
   };
@@ -131,70 +159,3 @@ const compose = (contexts: FC<PropsWithChildren>[]) => {
     </Acc>
   ));
 };
-// export const PluginHost = ({ plugins: definitions, fallback }: BootstrapPluginsParams): PluginDefinition => {
-//   // const state = deepSignal<PluginContext>({ ready: false, initializing: [], loading: [], plugins: [] });
-
-//   return {
-//     meta: {
-//       id: 'dxos.org/plugin/host',
-//     },
-//     provides: {
-//       // plugins: state,
-//       // context: ({ children }) => <PluginProvider value={state}>{children}</PluginProvider>,
-//       root: () => {
-//         const [plugins, setPlugins] = useState<Plugin[]>();
-//         const [initializing, setInitializing] = useState<PluginDefinition[]>([]);
-//         const [loading, setLoading] = useState<PluginDefinition[]>([]);
-//         useEffect(() => {
-//           log('initializing plugins', { definitions });
-//           const timeout = setTimeout(async () => {
-//             setInitializing(definitions);
-//             const plugins = await Promise.all(
-//               definitions.map(async (definition) => {
-//                 const plugin = await initializePlugin(definition).catch((err) => {
-//                   console.error('Failed to initialize plugin:', definition.meta.id, err);
-//                   return undefined;
-//                 });
-//                 setInitializing((initializing) => initializing.filter((plugin) => plugin !== definition));
-//                 return plugin;
-//               }),
-//             ).then((plugins) => plugins.filter((plugin): plugin is Plugin => Boolean(plugin)));
-
-//             log('plugins initialized', { plugins });
-//             setLoading(definitions);
-//             await Promise.all(
-//               definitions.map(async (pluginDefinition) => {
-//                 await pluginDefinition.ready?.(plugins);
-//                 setLoading((loading) => loading.filter((plugin) => plugin !== pluginDefinition));
-//               }),
-//             );
-
-//             log('plugins ready', { plugins });
-//             setPlugins(plugins);
-//           });
-
-//           return () => {
-//             clearTimeout(timeout);
-//             void Promise.all(definitions.map((definition) => definition.unload?.()));
-//           };
-//         }, []);
-
-//         if (!plugins) {
-//           if (typeof fallback === 'function') {
-//             const FallbackComponent = fallback;
-//             return <FallbackComponent initializing={initializing} loading={loading} />;
-//           }
-//           return <>{fallback ?? null}</>;
-//         }
-
-//         const ComposedContext = composeContext(plugins);
-
-//         return (
-//           <PluginProvider value={{ plugins, initializing, loading, ready: true }}>
-//             <ComposedContext>{rootComponents(plugins)}</ComposedContext>
-//           </PluginProvider>
-//         );
-//       },
-//     },
-//   };
-// };

package/src/plugins/PluginHost/plugin.ts

@@ -2,7 +2,8 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type FC, type PropsWithChildren } from 'react';
+import type { IconProps } from '@phosphor-icons/react';
+import type { FC, PropsWithChildren } from 'react';
 
 /**
  * Capabilities provided by a plugin.
@@ -42,6 +43,22 @@ export type Plugin<TProvides = {}> = {
      */
     // TODO(wittjosiah): How should these be managed?
     shortId?: string;
+
+    /**
+     * Human readable name.
+     */
+    name?: string;
+
+    /**
+     * Short description of plugin functionality.
+     */
+    description?: string;
+
+    /**
+     * Component to render icon for the plugin when displayed in a list.
+     */
+    // TODO(wittjosiah): Convert to `icon` and make serializable.
+    iconComponent?: FC<IconProps>;
   };
 
   /**
@@ -80,3 +97,16 @@ 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 {
+  export const lazy = <T>(p: LazyPlugin<T>, props?: T) => {
+    return () =>
+      p().then(({ default: definition }) => {
+        return definition(props as T);
+      });
+  };
+}