@dxos/app-framework 0.8.2-staging.7ac8446 → 0.8.2

package/dist/types/src/plugin-settings/app-graph-builder.d.ts

@@ -1,197 +1,4 @@
-import { type Node } from '@dxos/app-graph';
-import { type PluginsContext } from '../core';
-declare const _default: (context: PluginsContext) => import("..").Capability<Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | (Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | (Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | (Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | (Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | (Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | (Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | (Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | (Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | (Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | (Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | (Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}> | Readonly<{
-    id: string;
-    position: import("@dxos/util").Position;
-    resolver?: import("@dxos/app-graph").ResolverExtension;
-    connector?: import("@dxos/app-graph").ConnectorExtension;
-    relation?: import("@dxos/app-graph").Relation;
-    type?: string;
-    filter?: (node: Node) => boolean;
-}>[] | /*elided*/ any)[])[])[])[])[])[])[])[])[])[])[]>;
+import { type PluginContext } from '../core';
+declare const _default: (context: PluginContext) => import("..").Capability<import("@dxos/app-graph").BuilderExtensions>;
 export default _default;
 //# sourceMappingURL=app-graph-builder.d.ts.map

package/dist/types/src/plugin-settings/app-graph-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-graph-builder.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/app-graph-builder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAM7D,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;kCAGnD,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAvC,wBA4GK"}
+{"version":3,"file":"app-graph-builder.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/app-graph-builder.ts"],"names":[],"mappings":"AAaA,OAAO,EAAgC,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;yBAG3D,SAAS,aAAa;AAAtC,wBA4IK"}

package/dist/types/src/plugin-settings/store.d.ts

@@ -1,5 +1,5 @@
 import { RootSettingsStore } from '@dxos/local-storage';
-import { type PluginsContext } from '../core';
-declare const _default: (context: PluginsContext) => import("..").Capability<RootSettingsStore>;
+import { type PluginContext } from '../core';
+declare const _default: (context: PluginContext) => import("..").Capability<RootSettingsStore>;
 export default _default;
 //# sourceMappingURL=store.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/store.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;kCAElC,cAAc;AAAvC,wBAkBE"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;yBAE1C,SAAS,aAAa;AAAtC,wBAuBE"}

package/dist/types/src/react/ErrorBoundary.d.ts

@@ -24,7 +24,7 @@ export declare class ErrorBoundary extends Component<Props, State> {
         error: Error;
     };
     componentDidUpdate(prevProps: Props): void;
-    render(): string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;
+    render(): string | number | boolean | React.JSX.Element | Iterable<React.ReactNode> | null | undefined;
     private resetError;
 }
 export {};

package/dist/types/src/react/ErrorBoundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../src/react/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"}
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../src/react/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,GAAG;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE;IAItD,kBAAkB,CAAC,SAAS,EAAE,KAAK,GAAG,IAAI;IAM1C,MAAM,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS;IAQ/G,OAAO,CAAC,UAAU;CAGnB"}

package/dist/types/src/react/IntentContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IntentContext.d.ts","sourceRoot":"","sources":["../../../../src/react/IntentContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAA6B,KAAK,QAAQ,EAAa,MAAM,OAAO,CAAC;AAO1F,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9E,QAAA,MAAM,aAAa,EAAE,OAAO,CAAC,aAAa,GAAG,SAAS,CAAuD,CAAC;AAE9G,eAAO,MAAM,mBAAmB,QAAO,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,iBAAiB,CAGxF,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,MAAM,YAAY,iBAAiB,SAW5E,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,GAAG,SAAS,CAA0B,CAAC"}
+{"version":3,"file":"IntentContext.d.ts","sourceRoot":"","sources":["../../../../src/react/IntentContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAA6B,KAAK,QAAQ,EAAa,MAAM,OAAO,CAAC;AAO1F,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9E,QAAA,MAAM,aAAa,EAAE,OAAO,CAAC,aAAa,GAAG,SAAS,CAAuD,CAAC;AAE9G,eAAO,MAAM,mBAAmB,QAAO,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,iBAAiB,CAGxF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,UAAU,iBAAiB,SAW5E,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,GAAG,SAAS,CAA0B,CAAC"}

package/dist/types/src/react/Surface.d.ts

@@ -1,10 +1,10 @@
 import React from 'react';
 import { type SurfaceProps } from '../common';
-import { type PluginsContext } from '../core';
+import { type PluginContext } from '../core';
 /**
  * @returns `true` if there is a contributed surface which matches the specified role & data, `false` otherwise.
  */
-export declare const isSurfaceAvailable: (context: PluginsContext, { role, data }: Pick<SurfaceProps, "role" | "data">) => boolean;
+export declare const isSurfaceAvailable: (context: PluginContext, { role, data }: Pick<SurfaceProps, "role" | "data">) => boolean;
 /**
  * A surface is a named region of the screen that can be populated by plugins.
  */

package/dist/types/src/react/Surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../src/react/Surface.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAwD,MAAM,OAAO,CAAC;AAO7E,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAqB9C;;GAEG;AACH,eAAO,MAAM,kBAAkB,YAAa,cAAc,kBAAkB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,YAI9G,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,0HA6BnB,CAAC"}
+{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../src/react/Surface.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAwD,MAAM,OAAO,CAAC;AAO7E,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAqB7C;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,aAAa,EAAE,gBAAgB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,YAI7G,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,0HA6BnB,CAAC"}

package/dist/types/src/react/useCapabilities.d.ts

@@ -3,11 +3,11 @@ import { type InterfaceDef } from '../core';
  * Hook to request capabilities from the plugin context.
  * @returns An array of capabilities.
  */
-export declare const useCapabilities: <T, U extends T = T>(interfaceDef: InterfaceDef<T>, filter?: (capability: T, moduleId: string) => capability is U) => U[];
+export declare const useCapabilities: <T>(interfaceDef: InterfaceDef<T>) => T[];
 /**
  * Hook to request a capability from the plugin context.
  * @returns The capability.
  * @throws If no capability is found.
  */
-export declare const useCapability: <T, U extends T = T>(interfaceDef: InterfaceDef<T>, filter?: (capability: T, moduleId: string) => capability is U) => U;
+export declare const useCapability: <T>(interfaceDef: InterfaceDef<T>) => T;
 //# sourceMappingURL=useCapabilities.d.ts.map

package/dist/types/src/react/useCapabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCapabilities.d.ts","sourceRoot":"","sources":["../../../../src/react/useCapabilities.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,CAAC,SAAS,CAAC,oBAC9B,YAAY,CAAC,CAAC,CAAC,WACpB,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,UAAU,IAAI,CAAC,QAS9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,SAAS,CAAC,oBAC5B,YAAY,CAAC,CAAC,CAAC,WACpB,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,UAAU,IAAI,CAAC,MAK9D,CAAC"}
+{"version":3,"file":"useCapabilities.d.ts","sourceRoot":"","sources":["../../../../src/react/useCapabilities.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,cAAc,YAAY,CAAC,CAAC,CAAC,QAG/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,cAAc,YAAY,CAAC,CAAC,CAAC,MAI7D,CAAC"}

package/dist/types/src/react/useIntentResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useIntentResolver.d.ts","sourceRoot":"","sources":["../../../../src/react/useIntentResolver.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,iBAAiB,WAAY,MAAM,YAAY,iBAAiB,SAW5E,CAAC"}
+{"version":3,"file":"useIntentResolver.d.ts","sourceRoot":"","sources":["../../../../src/react/useIntentResolver.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,UAAU,iBAAiB,SAW5E,CAAC"}

package/dist/types/src/testing/withPluginManager.d.ts

@@ -1,12 +1,16 @@
 import { type Decorator } from '@storybook/react';
 import { type CreateAppOptions } from '../App';
-import { type ActivationEvent, type AnyCapability } from '../core';
+import { type ActivationEvent, type AnyCapability, type PluginContext } from '../core';
+export type Provider<C, R> = (context: C) => R;
+export type ProviderOrValue<C, R> = Provider<C, R> | R;
+export declare const getValue: <C, R>(providerOrValue: ProviderOrValue<C, R>, context: C) => R;
 export type WithPluginManagerOptions = CreateAppOptions & {
-    capabilities?: AnyCapability[];
+    capabilities?: ProviderOrValue<PluginContext, AnyCapability[]>;
     fireEvents?: (ActivationEvent | string)[];
 };
 /**
  * Wraps a story with a plugin manager.
+ * NOTE: This builds up and tears down the plugin manager on every render.
  */
 export declare const withPluginManager: (options?: WithPluginManagerOptions) => Decorator;
 //# sourceMappingURL=withPluginManager.d.ts.map

package/dist/types/src/testing/withPluginManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withPluginManager.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1D,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAKnB,MAAM,SAAS,CAAC;AA+BjB,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,GAAG;IACxD,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,aAAa,wBAAwB,KAAQ,SAyB1E,CAAC"}
+{"version":3,"file":"withPluginManager.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD,OAAO,EAAU,KAAK,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAEvD,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,aAAa,EAElB,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAGjB,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;AAC/C,MAAM,MAAM,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;AACvD,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,EAAE,iBAAiB,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,KAAG,CAEnF,CAAC;AA+BF,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,GAAG;IACxD,YAAY,CAAC,EAAE,eAAe,CAAC,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC;IAC/D,UAAU,CAAC,EAAE,CAAC,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAS,wBAA6B,KAAG,SAmC1E,CAAC"}

package/dist/types/src/testing/withPluginManager.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withPluginManager.stories.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.stories.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAiB7D,QAAA,MAAM,IAAI,EAAE,IAkBX,CAAC;AAEF,eAAe,IAAI,CAAC;AAEpB,eAAO,MAAM,OAAO,IAAK,CAAC"}
+{"version":3,"file":"withPluginManager.stories.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.stories.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAiB7D,QAAA,MAAM,IAAI,EAAE,IAkBX,CAAC;AAEF,eAAe,IAAI,CAAC;AAEpB,eAAO,MAAM,OAAO,IAAK,CAAC"}

package/dist/types/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"version":"5.7.3"}
+{"version":"5.8.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/app-framework",
-  "version": "0.8.2-staging.7ac8446",
+  "version": "0.8.2",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -37,36 +37,47 @@
     }
   },
   "dependencies": {
-    "@preact/signals-core": "^1.6.0",
-    "@dxos/app-graph": "0.8.2-staging.7ac8446",
-    "@dxos/async": "0.8.2-staging.7ac8446",
-    "@dxos/debug": "0.8.2-staging.7ac8446",
-    "@dxos/artifact": "0.8.2-staging.7ac8446",
-    "@dxos/client-protocol": "0.8.2-staging.7ac8446",
-    "@dxos/invariant": "0.8.2-staging.7ac8446",
-    "@dxos/live-object": "0.8.2-staging.7ac8446",
-    "@dxos/local-storage": "0.8.2-staging.7ac8446",
-    "@dxos/log": "0.8.2-staging.7ac8446",
-    "@dxos/util": "0.8.2-staging.7ac8446",
-    "@dxos/react-hooks": "0.8.2-staging.7ac8446"
+    "@preact/signals-core": "^1.9.0",
+    "@dxos/ai": "0.8.2",
+    "@dxos/app-graph": "0.8.2",
+    "@dxos/async": "0.8.2",
+    "@dxos/artifact": "0.8.2",
+    "@dxos/client-protocol": "0.8.2",
+    "@dxos/debug": "0.8.2",
+    "@dxos/echo-schema": "0.8.2",
+    "@dxos/invariant": "0.8.2",
+    "@dxos/keys": "0.8.2",
+    "@dxos/local-storage": "0.8.2",
+    "@dxos/live-object": "0.8.2",
+    "@dxos/log": "0.8.2",
+    "@dxos/react-hooks": "0.8.2",
+    "@dxos/util": "0.8.2",
+    "@dxos/schema": "0.8.2"
   },
   "devDependencies": {
+    "@effect-rx/rx-react": "^0.34.1",
+    "@effect/platform": "0.80.12",
     "@phosphor-icons/react": "^2.1.5",
     "@types/react": "~18.2.0",
-    "effect": "3.13.3",
+    "effect": "3.14.21",
     "react": "~18.2.0",
-    "@dxos/echo-schema": "0.8.2-staging.7ac8446",
-    "@dxos/echo-signals": "0.8.2-staging.7ac8446",
-    "@dxos/random": "0.8.2-staging.7ac8446",
-    "@dxos/react-ui": "0.8.2-staging.7ac8446",
-    "@dxos/react-ui-syntax-highlighter": "0.8.2-staging.7ac8446",
-    "@dxos/storybook-utils": "0.8.2-staging.7ac8446"
+    "typedoc": "0.28.1",
+    "@dxos/echo-signals": "0.8.2",
+    "@dxos/random": "0.8.2",
+    "@dxos/react-ui-syntax-highlighter": "0.8.2",
+    "@dxos/react-ui": "0.8.2",
+    "@dxos/storybook-utils": "0.8.2"
   },
   "peerDependencies": {
-    "effect": "3.13.3",
+    "@effect-rx/rx-react": "^0.34.1",
+    "@effect/platform": "0.80.12",
+    "effect": "^3.13.3",
     "react": "~18.2.0"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "typedoc": "typedoc --out typedoc"
   }
 }

package/project.json

@@ -19,7 +19,8 @@
     },
     "lint": {},
     "pack": {},
-    "test": {}
+    "test": {},
+    "typedoc": {}
   },
   "implicitDependencies": [
     "esbuild"

package/src/App.tsx

@@ -2,11 +2,13 @@
 // Copyright 2025 DXOS.org
 //
 
+import { RegistryContext } from '@effect-rx/rx-react';
 import { effect } from '@preact/signals-core';
-import React, { useEffect, useState, type FC, type PropsWithChildren } from 'react';
+import React, { useCallback, useEffect, useMemo, useState, type FC, type PropsWithChildren } from 'react';
 
 import { invariant } from '@dxos/invariant';
-import { create } from '@dxos/live-object';
+import { live } from '@dxos/live-object';
+import { useDefaultValue } from '@dxos/react-hooks';
 
 import { Capabilities, Events } from './common';
 import { PluginManager, type PluginManagerOptions, type Plugin } from './core';
@@ -24,6 +26,7 @@ export type CreateAppOptions = {
   placeholder?: FC<{ stage: number }>;
   fallback?: ErrorBoundary['props']['fallback'];
   cacheEnabled?: boolean;
+  safeMode?: boolean;
 };
 
 /**
@@ -49,64 +52,111 @@ export type CreateAppOptions = {
  * @param params.placeholder Placeholder component to render during startup.
  * @param params.fallback Fallback component to render if an error occurs during startup.
  * @param params.cacheEnabled Whether to cache enabled plugins in localStorage.
+ * @param params.safeMode Whether to enable safe mode, which disables optional plugins.
  */
-export const createApp = ({
+export const useApp = ({
   pluginManager,
   pluginLoader: _pluginLoader,
-  plugins = [],
-  core = plugins.map(({ meta }) => meta.id),
-  defaults = [],
+  plugins: _plugins,
+  core: _core,
+  defaults: _defaults,
   placeholder,
   fallback = DefaultFallback,
   cacheEnabled = false,
+  safeMode = false,
 }: CreateAppOptions) => {
+  const plugins = useDefaultValue(_plugins, () => []);
+  const core = useDefaultValue(_core, () => plugins.map(({ meta }) => meta.id));
+  const defaults = useDefaultValue(_defaults, () => []);
+
   // TODO(wittjosiah): Provide a custom plugin loader which supports loading via url.
-  const pluginLoader =
-    _pluginLoader ??
-    ((id: string) => {
-      const plugin = plugins.find((plugin) => plugin.meta.id === id);
-      invariant(plugin, `Plugin not found: ${id}`);
-      return plugin;
+  const pluginLoader = useMemo(
+    () =>
+      _pluginLoader ??
+      ((id: string) => {
+        const plugin = plugins.find((plugin) => plugin.meta.id === id);
+        invariant(plugin, `Plugin not found: ${id}`);
+        return plugin;
+      }),
+    [_pluginLoader, plugins],
+  );
+
+  const state = useMemo(() => live({ ready: false, error: null }), []);
+  const cached: string[] = useMemo(() => JSON.parse(localStorage.getItem(ENABLED_KEY) ?? '[]'), []);
+  const enabled = useMemo(
+    () => (safeMode ? [] : cacheEnabled && cached.length > 0 ? cached : defaults),
+    [safeMode, cacheEnabled, cached, defaults],
+  );
+  const manager = useMemo(
+    () => pluginManager ?? new PluginManager({ pluginLoader, plugins, core, enabled }),
+    [pluginManager, pluginLoader, plugins, core, enabled],
+  );
+
+  useEffect(() => {
+    return manager.activation.on(({ event, state: _state, error }) => {
+      // Once the app is ready the first time, don't show the fallback again.
+      if (!state.ready && event === Events.Startup.id) {
+        state.ready = _state === 'activated';
+      }
+
+      if (error && !state.ready && !state.error) {
+        state.error = error;
+      }
     });
+  }, [manager, state]);
 
-  const state = create({ ready: false, error: null });
-  const cached: string[] = JSON.parse(localStorage.getItem(ENABLED_KEY) ?? '[]');
-  const enabled = cacheEnabled && cached.length > 0 ? cached : defaults;
-  const manager = pluginManager ?? new PluginManager({ pluginLoader, plugins, core, enabled });
+  useEffect(() => {
+    effect(() => {
+      cacheEnabled && localStorage.setItem(ENABLED_KEY, JSON.stringify(manager.enabled));
+    });
+  }, [cacheEnabled, manager]);
 
-  manager.activation.on(({ event, state: _state, error }) => {
-    // Once the app is ready the first time, don't show the fallback again.
-    if (!state.ready && event === Events.Startup.id) {
-      state.ready = _state === 'activated';
-    }
+  useEffect(() => {
+    manager.context.contributeCapability({
+      interface: Capabilities.PluginManager,
+      implementation: manager,
+      module: 'dxos.org/app-framework/plugin-manager',
+    });
 
-    if (error && !state.ready && !state.error) {
-      state.error = error;
-    }
-  });
-
-  effect(() => {
-    cacheEnabled && localStorage.setItem(ENABLED_KEY, JSON.stringify(manager.enabled));
-  });
-
-  manager.context.contributeCapability({
-    interface: Capabilities.PluginManager,
-    implementation: manager,
-    module: 'dxos.org/app-framework/plugin-manager',
-  });
-
-  setupDevtools(manager);
-
-  // TODO(wittjosiah): Factor out such that this could be called per surface role when attempting to render.
-  void manager.activate(Events.SetupReactSurface);
-  void manager.activate(Events.Startup);
-
-  return () => (
-    <ErrorBoundary fallback={fallback}>
-      <PluginManagerProvider value={manager}>
-        <App placeholder={placeholder} state={state} />
-      </PluginManagerProvider>
-    </ErrorBoundary>
+    manager.context.contributeCapability({
+      interface: Capabilities.RxRegistry,
+      implementation: manager.registry,
+      module: 'dxos.org/app-framework/rx-registry',
+    });
+
+    return () => {
+      manager.context.removeCapability(Capabilities.PluginManager, manager);
+      manager.context.removeCapability(Capabilities.RxRegistry, manager.registry);
+    };
+  }, [manager]);
+
+  useEffect(() => {
+    setupDevtools(manager);
+  }, [manager]);
+
+  useEffect(() => {
+    const timeout = setTimeout(async () => {
+      await Promise.all([
+        // TODO(wittjosiah): Factor out such that this could be called per surface role when attempting to render.
+        manager.activate(Events.SetupReactSurface),
+        manager.activate(Events.Startup),
+      ]);
+    });
+
+    return () => clearTimeout(timeout);
+  }, [manager]);
+
+  return useCallback(
+    () => (
+      <ErrorBoundary fallback={fallback}>
+        <PluginManagerProvider value={manager}>
+          <RegistryContext.Provider value={manager.registry}>
+            <App placeholder={placeholder} state={state} />
+          </RegistryContext.Provider>
+        </PluginManagerProvider>
+      </ErrorBoundary>
+    ),
+    [fallback, manager, placeholder, state],
   );
 };