@dxos/app-framework 0.6.13 → 0.6.14-main.1366248

package/dist/types/src/plugins/{PluginHost → plugin-host}/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,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;
+    /**
+     * URL of source code.
+     */
+    source?: 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 +88,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/plugin-host/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-host/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,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;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/plugin-host/plugin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-host/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/plugin-intent/IntentContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentContext.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-intent/IntentContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAA2C,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEvF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACzC,OAAO,EAAE,eAAe,EAAE,EAAE,CAAC;IAC7B,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,mBAAmB,CAAC;CACvF,CAAC;AASF;;GAEG;AAEH,eAAO,MAAM,SAAS,qBAAkC,CAAC;AAEzD,eAAO,MAAM,mBAAmB,QAAO,gBAGtC,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,MAAM,YAAY,cAAc,SAKzE,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,CAA0B,CAAC"}

package/dist/types/src/plugins/{IntentPlugin/plugin.d.ts → plugin-intent/IntentPlugin.d.ts}

@@ -1,9 +1,8 @@
 import { type IntentPluginProvides } from './provides';
-import type { PluginDefinition } from '../PluginHost';
+import { type PluginDefinition } from '../plugin-host';
 /**
  * Allows plugins to register intent handlers and routes sent intents to the appropriate plugin.
  * Inspired by https://developer.android.com/reference/android/content/Intent.
  */
-declare const IntentPlugin: () => PluginDefinition<IntentPluginProvides>;
-export default IntentPlugin;
-//# sourceMappingURL=plugin.d.ts.map
+export declare const IntentPlugin: () => PluginDefinition<IntentPluginProvides>;
+//# sourceMappingURL=IntentPlugin.d.ts.map

package/dist/types/src/plugins/plugin-intent/IntentPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentPlugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-intent/IntentPlugin.tsx"],"names":[],"mappings":"AAaA,OAAO,EACL,KAAK,oBAAoB,EAI1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAKvD;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,gBAAgB,CAAC,oBAAoB,CAyHpE,CAAC"}

package/dist/types/src/plugins/plugin-intent/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-intent/helpers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,UAAU,UAAW,eAAe,EAAE,KAAG,OACY,CAAC"}

package/dist/types/src/plugins/plugin-intent/index.d.ts

@@ -0,0 +1,6 @@
+import { IntentPlugin } from './IntentPlugin';
+export * from './intent';
+export * from './provides';
+export * from './IntentContext';
+export default IntentPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/plugins/plugin-intent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-intent/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAE3B,cAAc,iBAAiB,CAAC;AAEhC,eAAe,YAAY,CAAC"}

package/dist/types/src/plugins/{IntentPlugin → plugin-intent}/intent.d.ts

@@ -1,5 +1,5 @@
 import type { MaybePromise } from '@dxos/util';
-import type { Plugin } from '../PluginHost';
+import type { Plugin } from '../plugin-host';
 export type IntentData<T extends Record<string, any> = Record<string, any>> = T & {
     /**
      * The data from the result of the previous intent.

package/dist/types/src/plugins/plugin-intent/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-intent/intent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG;IAChF;;OAEG;IACH,MAAM,CAAC,EAAE,GAAG,CAAC;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IAEH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,GAAG,CAAC;IAEX;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,IAAI,CAAC,EAAE,UAAU,CAAC;KACnB,CAAC;IAEF;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC"}

package/dist/types/src/plugins/plugin-intent/meta.d.ts.map

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

package/dist/types/src/plugins/{IntentPlugin → plugin-intent}/provides.d.ts

@@ -1,6 +1,6 @@
 import { type IntentContext } from './IntentContext';
 import { type IntentResolver } from './intent';
-import { type Plugin } from '../PluginHost';
+import { type Plugin } from '../plugin-host';
 export type IntentResolverProvides = {
     intent: {
         resolver: IntentResolver;
@@ -15,6 +15,6 @@ export declare enum IntentAction {
     /**
      * Fired after an intent is dispatched if the intent is undoable.
      */
-    SHOW_UNDO = "dxos.org/plugin/intent/show-undo"
+    SHOW_UNDO = "dxos.org/plugin/intent/action/show-undo"
 }
 //# sourceMappingURL=provides.d.ts.map

package/dist/types/src/plugins/plugin-intent/provides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provides.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-intent/provides.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE;QACN,QAAQ,EAAE,cAAc,CAAC;KAC1B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,MAAM,6CACkD,CAAC;AAEnG,eAAO,MAAM,yBAAyB,WAAY,MAAM,+CAC4C,CAAC;AAUrG,oBAAY,YAAY;IACtB;;OAEG;IACH,SAAS,4CAA+B;CACzC"}

package/dist/types/src/plugins/plugin-settings/SettingsPlugin.d.ts

@@ -0,0 +1,4 @@
+import { type SettingsPluginProvides } from './provides';
+import { type PluginDefinition } from '../plugin-host';
+export declare const SettingsPlugin: () => PluginDefinition<SettingsPluginProvides>;
+//# sourceMappingURL=SettingsPlugin.d.ts.map

package/dist/types/src/plugins/plugin-settings/SettingsPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsPlugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-settings/SettingsPlugin.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,eAAO,MAAM,cAAc,QAAO,gBAAgB,CAAC,sBAAsB,CAWxE,CAAC"}

package/dist/types/src/plugins/plugin-settings/index.d.ts

@@ -0,0 +1,4 @@
+import { SettingsPlugin } from './SettingsPlugin';
+export * from './provides';
+export default SettingsPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/plugins/plugin-settings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-settings/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,cAAc,YAAY,CAAC;AAE3B,eAAe,cAAc,CAAC"}

package/dist/types/src/plugins/plugin-settings/meta.d.ts

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

package/dist/types/src/plugins/plugin-settings/meta.d.ts.map

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

package/dist/types/src/plugins/plugin-settings/provides.d.ts

@@ -0,0 +1,13 @@
+import { type SettingsStoreFactory, type SettingsValue } from '@dxos/local-storage';
+import { type Plugin } from '../plugin-host';
+export type SettingsProvides<T extends SettingsValue> = {
+    settings: T;
+};
+export type SettingsPluginProvides = {
+    settingsStore: SettingsStoreFactory;
+};
+export declare const parseSettingsPlugin: (plugin: Plugin) => Plugin<SettingsPluginProvides> | undefined;
+export declare enum SettingsAction {
+    OPEN = "dxos.org/plugin/settings/action/open"
+}
+//# sourceMappingURL=provides.d.ts.map

package/dist/types/src/plugins/plugin-settings/provides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provides.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-settings/provides.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpF,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,aAAa,IAAI;IACtD,QAAQ,EAAE,CAAC,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,oBAAoB,CAAC;CACrC,CAAC;AAEF,eAAO,MAAM,mBAAmB,WAAY,MAAM,+CAIjD,CAAC;AAMF,oBAAY,cAAc;IACxB,IAAI,yCAA4B;CACjC"}

package/dist/types/src/plugins/plugin-surface/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-surface/ErrorBoundary.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE1E,KAAK,KAAK,GAAG,iBAAiB,CAAC;IAAE,IAAI,CAAC,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,EAAE,CAAC;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAC9G,KAAK,KAAK,GAAG;IAAE,KAAK,EAAE,KAAK,GAAG,SAAS,CAAA;CAAE,CAAC;AAE1C;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;gBAC5C,KAAK,EAAE,KAAK;IAKxB,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK;;;IAInC,kBAAkB,CAAC,SAAS,EAAE,KAAK,GAAG,IAAI;IAM1C,MAAM;IAQf,OAAO,CAAC,UAAU;CAGnB"}

package/dist/types/src/plugins/{SurfacePlugin → plugin-surface}/Surface.d.ts

@@ -1,4 +1,4 @@
-import React, { type ReactNode, type PropsWithChildren } from 'react';
+import React, { type PropsWithChildren, type ReactNode } from 'react';
 import { ErrorBoundary } from './ErrorBoundary';
 /**
  * Direction determines how multiple components are laid out.
@@ -8,6 +8,10 @@ export type Direction = 'inline' | 'inline-reverse' | 'block' | 'block-reverse';
  * SurfaceProps are the props that are passed to the Surface component.
  */
 export type SurfaceProps = PropsWithChildren<{
+    /**
+     * Optional ID for debugging.
+     */
+    id?: string;
     /**
      * Role defines how the data should be rendered.
      */
@@ -53,6 +57,6 @@ export type SurfaceProps = PropsWithChildren<{
 /**
  * A surface is a named region of the screen that can be populated by plugins.
  */
-export declare const Surface: React.ForwardRefExoticComponent<Omit<SurfaceProps, "ref"> & React.RefAttributes<HTMLElement>>;
+export declare const Surface: React.MemoExoticComponent<React.ForwardRefExoticComponent<Omit<SurfaceProps, "ref"> & React.RefAttributes<HTMLElement>>>;
 export declare const useSurface: () => SurfaceProps;
 //# sourceMappingURL=Surface.d.ts.map

package/dist/types/src/plugins/plugin-surface/Surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-surface/Surface.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAGZ,KAAK,iBAAiB,EACtB,KAAK,SAAS,EASf,MAAM,OAAO,CAAC;AAKf,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,gBAAgB,GAAG,OAAO,GAAG,eAAe,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,CAAC;IAC3C;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;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;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB;;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;AAIH;;GAEG;AACH,eAAO,MAAM,OAAO,0HAkCnB,CAAC;AAIF,eAAO,MAAM,UAAU,QAAO,YAC+C,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"SurfacePlugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-surface/SurfacePlugin.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,aAAa,QAAO,gBAAgB,CAAC,qBAAqB,CAetE,CAAC"}

package/dist/types/src/plugins/{SurfacePlugin → plugin-surface}/SurfaceRootContext.d.ts

@@ -1,4 +1,4 @@
-import { type JSX, type Provider, type ForwardedRef } from 'react';
+import { type JSX, type ForwardedRef } from 'react';
 import { type SurfaceProps } from './Surface';
 type WithRequiredProperty<Type, Key extends keyof Type> = Type & {
     [Property in Key]-?: Type[Property];
@@ -8,6 +8,15 @@ type SurfaceComponentProps = WithRequiredProperty<SurfaceProps, 'data'>;
  * Determines the priority of the surface when multiple components are resolved.
  */
 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;
@@ -20,8 +29,12 @@ export type SurfaceResult = {
 export type SurfaceComponent = (props: SurfaceComponentProps, forwardedRef: ForwardedRef<HTMLElement>) => JSX.Element | SurfaceResult | null;
 export type SurfaceRootContext = {
     components: Record<string, SurfaceComponent>;
+    /**
+     * Debug info.
+     */
+    debugInfo?: Map<string, DebugInfo>;
 };
 export declare const useSurfaceRoot: () => SurfaceRootContext;
-export declare const SurfaceProvider: Provider<SurfaceRootContext>;
+export declare const SurfaceProvider: import("react").Provider<SurfaceRootContext | undefined>;
 export {};
 //# sourceMappingURL=SurfaceRootContext.d.ts.map

package/dist/types/src/plugins/plugin-surface/SurfaceRootContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurfaceRootContext.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-surface/SurfaceRootContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAA6B,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAI/E,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;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAExC,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,qBAAqB,EAC5B,YAAY,EAAE,YAAY,CAAC,WAAW,CAAC,KACpC,GAAG,CAAC,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC;AAExC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE7C;;OAEG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACpC,CAAC;AAIF,eAAO,MAAM,cAAc,0BAAyF,CAAC;AAErH,eAAO,MAAM,eAAe,0DAA8B,CAAC"}

package/dist/types/src/plugins/plugin-surface/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-surface/helpers.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ,SAAU,OAAO,KAAG,IAAI,IAAI;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAwC,CAAC"}

package/dist/types/src/plugins/{SurfacePlugin → plugin-surface}/index.d.ts

@@ -1,6 +1,8 @@
+import { SurfacePlugin } from './SurfacePlugin';
 export * from './helpers';
 export * from './provides';
 export * from './ErrorBoundary';
 export * from './Surface';
 export * from './SurfaceRootContext';
+export default SurfacePlugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/plugins/plugin-surface/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-surface/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAE3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AAErC,eAAe,aAAa,CAAC"}

package/dist/types/src/plugins/plugin-surface/meta.d.ts.map

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

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

@@ -1,5 +1,5 @@
 import { type SurfaceComponent, type SurfaceRootContext } from './SurfaceRootContext';
-import { type Plugin } from '../PluginHost';
+import { type Plugin } from '../plugin-host';
 export type SurfaceProvides = {
     surface: {
         /**

package/dist/types/src/plugins/plugin-surface/provides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provides.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-surface/provides.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C,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,18 +1,17 @@
 {
   "name": "@dxos/app-framework",
-  "version": "0.6.13",
+  "version": "0.6.14-main.1366248",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
   "license": "MIT",
   "author": "DXOS.org",
+  "sideEffects": true,
   "exports": {
     ".": {
+      "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs",
-      "node": {
-        "default": "./dist/lib/node/index.cjs"
-      },
-      "types": "./dist/types/src/index.d.ts"
+      "node": "./dist/lib/node-esm/index.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -20,24 +19,27 @@
     "*": {}
   },
   "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",
-    "@dxos/async": "0.6.13",
-    "@dxos/client-protocol": "0.6.13",
-    "@dxos/debug": "0.6.13",
-    "@dxos/local-storage": "0.6.13",
-    "@dxos/echo-schema": "0.6.13",
-    "@dxos/invariant": "0.6.13",
-    "@dxos/log": "0.6.13",
-    "@dxos/util": "0.6.13"
+    "@dxos/app-graph": "0.6.14-main.1366248",
+    "@dxos/async": "0.6.14-main.1366248",
+    "@dxos/debug": "0.6.14-main.1366248",
+    "@dxos/client-protocol": "0.6.14-main.1366248",
+    "@dxos/context": "0.6.14-main.1366248",
+    "@dxos/invariant": "0.6.14-main.1366248",
+    "@dxos/echo-schema": "0.6.14-main.1366248",
+    "@dxos/local-storage": "0.6.14-main.1366248",
+    "@dxos/log": "0.6.14-main.1366248",
+    "@dxos/util": "0.6.14-main.1366248"
   },
   "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

@@ -6,16 +6,17 @@ import React from 'react';
 
 import { invariant } from '@dxos/invariant';
 
-import { type BootstrapPluginsParams, Plugin, PluginHost } from './plugins';
-import IntentMeta from './plugins/IntentPlugin/meta';
-import SurfaceMeta from './plugins/SurfacePlugin/meta';
+import { type HostPluginParams, Plugin, HostPlugin } from './plugins';
+import IntentMeta from './plugins/plugin-intent/meta';
+import SettingsMeta from './plugins/plugin-settings/meta';
+import SurfaceMeta from './plugins/plugin-surface/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 meta = [LayoutMeta, MyPluginMeta];
  * const plugins = {
  *  [LayoutMeta.id]: Plugin.lazy(() => import('./plugins/LayoutPlugin/plugin')),
  *  [MyPluginMeta.id]: Plugin.lazy(() => import('./plugins/MyPlugin/plugin')),
@@ -30,28 +31,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) => {
-  const host = PluginHost({
-    order: [SurfaceMeta, IntentMeta, ...order],
+export const createApp = ({ meta, plugins, core, ...params }: HostPluginParams) => {
+  const hostPlugin = HostPlugin({
     plugins: {
       ...plugins,
-      [SurfaceMeta.id]: Plugin.lazy(() => import('./plugins/SurfacePlugin/plugin')),
-      [IntentMeta.id]: Plugin.lazy(() => import('./plugins/IntentPlugin/plugin')),
+      [IntentMeta.id]: Plugin.lazy(() => import('./plugins/plugin-intent')),
+      [SettingsMeta.id]: Plugin.lazy(() => import('./plugins/plugin-settings')),
+      [SurfaceMeta.id]: Plugin.lazy(() => import('./plugins/plugin-surface')),
     },
-    core: [SurfaceMeta.id, IntentMeta.id, ...core],
+    meta: [IntentMeta, SettingsMeta, SurfaceMeta, ...meta],
+    core: [IntentMeta.id, SettingsMeta.id, SurfaceMeta.id, ...core],
     ...params,
   });
 
-  invariant(host.provides?.context);
-  invariant(host.provides?.root);
-  const Context = host.provides.context;
-  const Root = host.provides.root;
+  invariant(hostPlugin.provides);
+  const { context: Context, root: Root } = hostPlugin.provides;
+  invariant(Context);
+  invariant(Root);
 
   return () => (
     <Context>

package/src/plugins/common/file.ts

@@ -4,7 +4,7 @@
 
 import { type Space } from '@dxos/client-protocol';
 
-import { type Plugin } from '../PluginHost';
+import { type Plugin } from '../plugin-host';
 
 // TODO(burdon): See Accept attribute (uses MIME types).
 // E.g., 'image/*': ['.jpg', '.jpeg', '.png', '.gif'],

package/src/plugins/common/graph.ts

@@ -5,7 +5,7 @@
 import type { Graph, GraphBuilder, Node } from '@dxos/app-graph';
 import { type MaybePromise } from '@dxos/util';
 
-import type { Plugin } from '../PluginHost';
+import type { Plugin } from '../plugin-host';
 
 // TODO(wittjosiah): Factor out.
 export type SerializedNode = {

package/src/plugins/common/index.ts

@@ -7,5 +7,4 @@ export * from './graph';
 export * from './layout';
 export * from './metadata';
 export * from './navigation';
-export * from './settings';
 export * from './translations';

package/src/plugins/common/layout.ts

@@ -4,8 +4,8 @@
 
 import { z } from 'zod';
 
-import { type IntentData } from '../IntentPlugin';
-import type { Plugin } from '../PluginHost';
+import { type Plugin } from '../plugin-host';
+import { type IntentData } from '../plugin-intent';
 
 //
 // Provides
@@ -90,7 +90,10 @@ export const parseLayoutPlugin = (plugin: Plugin) => {
 // Intents
 //
 
-const LAYOUT_ACTION = 'dxos.org/plugin/layout';
+const LAYOUT_PLUGIN = 'dxos.org/plugin/layout';
+
+const LAYOUT_ACTION = `${LAYOUT_PLUGIN}/action`;
+
 export enum LayoutAction {
   SET_LAYOUT = `${LAYOUT_ACTION}/set-layout`,
   SET_LAYOUT_MODE = `${LAYOUT_ACTION}/set-layout-mode`,

package/src/plugins/common/metadata.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type Plugin } from '../PluginHost';
+import { type Plugin } from '../plugin-host';
 
 export type Metadata = Record<string, any>;