@dxos/app-framework 0.7.5-main.9cb18ac → 0.7.5-main.9d2a38b

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

@@ -0,0 +1 @@
+{"version":3,"file":"IntentContext.d.ts","sourceRoot":"","sources":["../../../../src/plugin-intent/IntentContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAA6B,KAAK,QAAQ,EAAa,MAAM,OAAO,CAAC;AAK1F,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIjF,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"}

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

@@ -0,0 +1,2 @@
+export declare const IntentPlugin: () => import("../core").Plugin;
+//# sourceMappingURL=IntentPlugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IntentPlugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin-intent/IntentPlugin.tsx"],"names":[],"mappings":"AAkBA,eAAO,MAAM,YAAY,gCAyCrB,CAAC"}

package/dist/types/src/plugin-intent/actions.d.ts

@@ -0,0 +1,23 @@
+import { S } from '@dxos/echo-schema';
+export declare const INTENT_PLUGIN = "dxos.org/plugin/intent";
+export declare const INTENT_ACTION = "dxos.org/plugin/intent/action";
+export declare namespace IntentAction {
+    const ShowUndo_base: S.TaggedClass<ShowUndo, "dxos.org/plugin/intent/action/show-undo", {
+        readonly _tag: S.tag<"dxos.org/plugin/intent/action/show-undo">;
+    } & {
+        input: S.Struct<{
+            message: S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
+                ns: typeof S.String;
+                count: S.optional<typeof S.Number>;
+            }>>]>>]>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    /**
+     * Fired after an intent is dispatched if the intent is undoable.
+     */
+    export class ShowUndo extends ShowUndo_base {
+    }
+    export {};
+}
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../src/plugin-intent/actions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAItC,eAAO,MAAM,aAAa,2BAA2B,CAAC;AACtD,eAAO,MAAM,aAAa,kCAA4B,CAAC;AAEvD,yBAAiB,YAAY,CAAC;;;;;;;;;;;;IAC5B;;OAEG;IACH,MAAM,OAAO,QAAS,SAAQ,aAK5B;KAAG;;CACN"}

package/dist/types/src/plugin-intent/errors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * NOTE: Messages should be sentences (Start with a capital letter and end with a period).
+ * Errors can optionally include a JSON context object.
+ */
+export declare class BaseError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, any> | undefined;
+    constructor(code: string, message?: string, context?: Record<string, any> | undefined);
+}
+export declare class NoResolversError extends BaseError {
+    constructor(action: string);
+}
+export declare class CycleDetectedError extends BaseError {
+    constructor(context?: Record<string, any>);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/plugin-intent/errors.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAEhC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;gBAF7B,IAAI,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,EACP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAA;CAQzC;AAED,qBAAa,gBAAiB,SAAQ,SAAS;gBACjC,MAAM,EAAE,MAAM;CAG3B;AAED,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAO1C"}

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

@@ -0,0 +1,6 @@
+export * from './actions';
+export * from './intent';
+export * from './intent-dispatcher';
+export * from './IntentContext';
+export * from './IntentPlugin';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugin-intent/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

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

@@ -1,6 +1,7 @@
 import { Effect } from 'effect';
-import { type MaybePromise } from '@dxos/util';
-import { type AnyIntentChain, type IntentChain, type IntentData, type IntentParams, type IntentResultData, type IntentSchema, type Label } from './intent';
+import { type Simplify } from 'effect/Types';
+import { type MaybePromise, type Disposition } from '@dxos/util';
+import { type AnyIntentChain, type Intent, type IntentChain, type IntentData, type IntentParams, type IntentResultData, type IntentSchema, type Label } from './intent';
 /**
  * The return value of an intent effect.
  */
@@ -28,6 +29,8 @@ export type IntentEffectResult<Fields extends IntentParams> = {
      * An error that occurred while performing the action.
      *
      * If the intent is apart of a chain of intents and an error occurs, the chain will be aborted.
+     *
+     * Return caught error instead of throwing to trigger other intent to be triggered prior to returning the error.
      */
     error?: Error;
     /**
@@ -40,14 +43,6 @@ export type AnyIntentEffectResult = IntentEffectResult<any>;
  * The result of an intent dispatcher.
  */
 export type IntentDispatcherResult<Fields extends IntentParams> = Pick<IntentEffectResult<Fields>, 'data' | 'error'>;
-/**
- * Determines the priority of the effect when multiple intent resolvers are matched.
- *
- * - `static` - The effect is selected in the order it was resolved.
- * - `hoist` - The effect is selected before `static` effects.
- * - `fallback` - The effect is selected after `static` effects.
- */
-export type IntentDisposition = 'static' | 'hoist' | 'fallback';
 /**
  * The implementation of an intent effect.
  */
@@ -55,12 +50,12 @@ export type IntentEffectDefinition<Fields extends IntentParams> = (data: IntentD
 /**
  * Intent resolver to match intents to their effects.
  */
-export type IntentResolver<Tag extends string, Fields extends IntentParams> = {
+export type IntentResolver<Tag extends string, Fields extends IntentParams> = Readonly<{
     action: Tag;
-    disposition?: IntentDisposition;
+    disposition?: Disposition;
     filter?: (data: IntentData<Fields>) => boolean;
     effect: IntentEffectDefinition<Fields>;
-};
+}>;
 export type AnyIntentResolver = IntentResolver<any, any>;
 /**
  * Creates an intent resolver to match intents to their effects.
@@ -73,25 +68,28 @@ export declare const createResolver: <Tag extends string, Fields extends IntentP
 /**
  * Invokes intents and returns the result.
  */
-export type PromiseIntentDispatcher = <Fields extends IntentParams>(intent: IntentChain<any, any, any, Fields>) => Promise<IntentDispatcherResult<Fields>>;
+export type PromiseIntentDispatcher = <Fields extends IntentParams>(intent: IntentChain<any, any, any, Fields>) => Promise<Simplify<IntentDispatcherResult<Fields>>>;
 /**
  * Creates an effect for intents.
  */
-export type IntentDispatcher = <Fields extends IntentParams>(intent: IntentChain<any, any, any, Fields>, depth?: number) => Effect.Effect<IntentDispatcherResult<Fields>, Error>;
+export type IntentDispatcher = <Fields extends IntentParams>(intent: IntentChain<any, any, any, Fields>, depth?: number) => Effect.Effect<Simplify<Required<IntentDispatcherResult<Fields>>['data']>, Error>;
+type IntentResult<Tag extends string, Fields extends IntentParams> = IntentEffectResult<Fields> & {
+    _intent: Intent<Tag, Fields>;
+};
+export type AnyIntentResult = IntentResult<any, any>;
 /**
  * Invokes the most recent undoable intent with undo flags.
  */
-export type PromiseIntentUndo = () => Promise<IntentDispatcherResult<any> | undefined>;
+export type PromiseIntentUndo = () => Promise<IntentDispatcherResult<any>>;
 /**
  * Creates an effect which undoes the last intent.
  */
-export type IntentUndo = () => Effect.Effect<IntentDispatcherResult<any> | undefined, Error>;
+export type IntentUndo = () => Effect.Effect<any, Error>;
 export type IntentContext = {
     dispatch: IntentDispatcher;
     dispatchPromise: PromiseIntentDispatcher;
     undo: IntentUndo;
     undoPromise: PromiseIntentUndo;
-    registerResolver: (id: string, resolver: AnyIntentResolver) => () => void;
 };
 /**
  * Sets of an intent dispatcher.
@@ -100,8 +98,9 @@ export type IntentContext = {
  * @param params.historyLimit The maximum number of intent results to keep in history.
  * @param params.executionLimit The maximum recursion depth of intent chains.
  */
-export declare const createDispatcher: (resolvers: Record<string, AnyIntentResolver[]>, { executionLimit, historyLimit }?: {
+export declare const createDispatcher: (getResolvers: (module?: string) => AnyIntentResolver[], { executionLimit, historyLimit }?: {
     executionLimit?: number | undefined;
     historyLimit?: number | undefined;
 }) => IntentContext;
+export {};
 //# sourceMappingURL=intent-dispatcher.d.ts.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent-dispatcher.test.d.ts","sourceRoot":"","sources":["../../../../src/plugin-intent/intent-dispatcher.test.ts"],"names":[],"mappings":""}

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

@@ -25,11 +25,11 @@ export type Intent<Tag extends string, Fields extends IntentParams> = {
      */
     data: IntentData<Fields>;
     /**
-     * Plugin ID.
-     * If specified, the intent will be sent explicitly to the plugin.
+     * Module ID.
+     * If specified, the intent will be sent explicitly to the plugin module.
      * Otherwise, the intent will be sent to all plugins, in order and the first to resolve a non-null value will be used.
      */
-    plugin?: string;
+    module?: string;
     /**
      * Whether or not the intent is being undone.
      */
@@ -53,36 +53,16 @@ export type AnyIntentChain = IntentChain<any, any, any, any>;
  * @param params.plugin Optional plugin ID to send the intent to.
  * @param params.undo Optional flag to indicate that the intent is being undone. Generally not set manually.
  */
-export declare const createIntent: <Tag extends string, Fields extends IntentParams>(schema: IntentSchema<Tag, Fields>, data?: IntentData<Fields>, params?: Pick<AnyIntent, "plugin" | "undo">) => IntentChain<Tag, Tag, Fields, Fields>;
+export declare const createIntent: <Tag extends string, Fields extends IntentParams>(schema: IntentSchema<Tag, Fields>, data?: IntentData<Fields>, params?: Pick<AnyIntent, "module" | "undo">) => IntentChain<Tag, Tag, Fields, Fields>;
 /**
  * Chain two intents together.
  *
  * NOTE: Chaining of intents depends on the data inputs and outputs being structs.
  */
-export declare const chain: <FirstTag extends string, NextTag extends string, FirstFields extends IntentParams, LastFields extends IntentParams, NextFields extends IntentParams>(schema: IntentSchema<NextTag, NextFields>, data?: Omit<IntentData<NextFields>, keyof IntentResultData<LastFields>>, params?: Pick<AnyIntent, "plugin" | "undo">) => (intent: IntentChain<FirstTag, any, FirstFields, LastFields>) => IntentChain<FirstTag, NextTag, FirstFields, NextFields>;
+export declare const chain: <FirstTag extends string, NextTag extends string, FirstFields extends IntentParams, LastFields extends IntentParams, NextFields extends IntentParams>(schema: IntentSchema<NextTag, NextFields>, data?: Omit<IntentData<NextFields>, keyof IntentResultData<LastFields>>, params?: Pick<AnyIntent, "module" | "undo">) => (intent: IntentChain<FirstTag, any, FirstFields, LastFields>) => IntentChain<FirstTag, NextTag, FirstFields, NextFields>;
 export declare const Label: S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
     ns: typeof S.String;
     count: S.optional<typeof S.Number>;
 }>>]>>]>;
 export type Label = S.Schema.Type<typeof Label>;
-export declare const INTENT_ACTION = "dxos.org/plugin/intent/action";
-export declare namespace IntentAction {
-    const ShowUndo_base: S.TaggedClass<ShowUndo, "dxos.org/plugin/intent/action/show-undo", {
-        readonly _tag: S.tag<"dxos.org/plugin/intent/action/show-undo">;
-    } & {
-        input: S.Struct<{
-            message: S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
-                ns: typeof S.String;
-                count: S.optional<typeof S.Number>;
-            }>>]>>]>;
-        }>;
-        output: typeof S.Void;
-    }>;
-    /**
-     * Fired after an intent is dispatched if the intent is undoable.
-     */
-    export class ShowUndo extends ShowUndo_base {
-    }
-    export {};
-}
 //# sourceMappingURL=intent.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export declare const SettingsPlugin: () => import("../core").Plugin;
+//# sourceMappingURL=SettingsPlugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsPlugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/SettingsPlugin.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,cAAc,gCAkBvB,CAAC"}

package/dist/types/src/{plugins/plugin-settings/provides.d.ts → plugin-settings/actions.d.ts}

@@ -1,13 +1,4 @@
 import { S } from '@dxos/echo-schema';
-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 const SETTINGS_PLUGIN = "dxos.org/plugin/settings";
 export declare const SETTINGS_ACTION = "dxos.org/plugin/settings/action";
 export declare namespace SettingsAction {
@@ -23,4 +14,4 @@ export declare namespace SettingsAction {
     }
     export {};
 }
-//# sourceMappingURL=provides.d.ts.map
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/actions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAC1D,eAAO,MAAM,eAAe,oCAA8B,CAAC;AAE3D,yBAAiB,cAAc,CAAC;;;;;;;;;IAC9B,MAAM,OAAO,IAAK,SAAQ,SAKxB;KAAG;;CACN"}

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

@@ -0,0 +1,3 @@
+export * from './actions';
+export * from './SettingsPlugin';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}

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

@@ -0,0 +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"}

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

@@ -0,0 +1,10 @@
+import { type PluginManager } from '../core';
+/**
+ * Get the plugin manager.
+ */
+export declare const usePluginManager: () => PluginManager;
+/**
+ * Context provider for a plugin manager.
+ */
+export declare const PluginManagerProvider: import("react").Provider<PluginManager | undefined>;
+//# sourceMappingURL=PluginManagerProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginManagerProvider.d.ts","sourceRoot":"","sources":["../../../../src/react/PluginManagerProvider.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,aACkD,CAAC;AAEvF;;GAEG;AACH,eAAO,MAAM,qBAAqB,qDAAgC,CAAC"}

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

@@ -0,0 +1,12 @@
+import React from 'react';
+import { type SurfaceProps } from '../common';
+import { type PluginsContext } 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;
+/**
+ * A surface is a named region of the screen that can be populated by plugins.
+ */
+export declare const Surface: React.MemoExoticComponent<React.ForwardRefExoticComponent<Omit<SurfaceProps, "ref"> & React.RefAttributes<HTMLElement>>>;
+//# sourceMappingURL=Surface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../src/react/Surface.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA8C,MAAM,OAAO,CAAC;AAOnE,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAgB9C;;GAEG;AACH,eAAO,MAAM,kBAAkB,YAAa,cAAc,kBAAkB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,YAI9G,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,0HA+BnB,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './ErrorBoundary';
+export * from './PluginManagerProvider';
+export * from './Surface';
+export * from './useCapabilities';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,13 @@
+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[];
+/**
+ * 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;
+//# sourceMappingURL=useCapabilities.d.ts.map

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

@@ -0,0 +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,QAQ9D,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"}

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

@@ -0,0 +1,2 @@
+export * from './withPluginManager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC"}

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

@@ -0,0 +1,10 @@
+import { type Decorator } from '@storybook/react';
+import { type CreateAppOptions } from '../App';
+import { type AnyCapability } from '../core';
+/**
+ * Wraps a story with a plugin manager.
+ */
+export declare const withPluginManager: ({ capabilities, plugins, core, ...options }?: CreateAppOptions & {
+    capabilities?: AnyCapability[];
+}) => Decorator;
+//# sourceMappingURL=withPluginManager.d.ts.map

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

@@ -0,0 +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,EAAE,KAAK,aAAa,EAA0D,MAAM,SAAS,CAAC;AAErG;;GAEG;AACH,eAAO,MAAM,iBAAiB,iDAK3B,gBAAgB,GAAG;IAAE,YAAY,CAAC,EAAE,aAAa,EAAE,CAAA;CAAE,KAAQ,SAqC/D,CAAC"}

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

@@ -0,0 +1,5 @@
+import { type Meta } from '@dxos/storybook-utils';
+declare const meta: Meta;
+export default meta;
+export declare const Default: {};
+//# sourceMappingURL=withPluginManager.stories.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/tsconfig.tsbuildinfo

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/app-framework",
-  "version": "0.7.5-main.9cb18ac",
+  "version": "0.7.5-main.9d2a38b",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -12,11 +12,20 @@
       "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs",
       "node": "./dist/lib/node-esm/index.mjs"
+    },
+    "./testing": {
+      "types": "./dist/types/src/testing/index.d.ts",
+      "browser": "./dist/lib/browser/testing/index.mjs",
+      "node": "./dist/lib/node-esm/testing/index.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
   "typesVersions": {
-    "*": {}
+    "*": {
+      "./testing": [
+        "dist/types/src/testing/index.d.ts"
+      ]
+    }
   },
   "dependencies": {
     "@effect/schema": "^0.75.5",
@@ -24,22 +33,26 @@
     "@preact/signals-core": "^1.6.0",
     "effect": "^3.12.1",
     "zod": "^3.22.4",
-    "@dxos/app-graph": "0.7.5-main.9cb18ac",
-    "@dxos/async": "0.7.5-main.9cb18ac",
-    "@dxos/client-protocol": "0.7.5-main.9cb18ac",
-    "@dxos/context": "0.7.5-main.9cb18ac",
-    "@dxos/debug": "0.7.5-main.9cb18ac",
-    "@dxos/invariant": "0.7.5-main.9cb18ac",
-    "@dxos/echo-schema": "0.7.5-main.9cb18ac",
-    "@dxos/live-object": "0.7.5-main.9cb18ac",
-    "@dxos/local-storage": "0.7.5-main.9cb18ac",
-    "@dxos/react-hooks": "0.7.5-main.9cb18ac",
-    "@dxos/log": "0.7.5-main.9cb18ac",
-    "@dxos/util": "0.7.5-main.9cb18ac"
+    "@dxos/async": "0.7.5-main.9d2a38b",
+    "@dxos/app-graph": "0.7.5-main.9d2a38b",
+    "@dxos/client-protocol": "0.7.5-main.9d2a38b",
+    "@dxos/context": "0.7.5-main.9d2a38b",
+    "@dxos/debug": "0.7.5-main.9d2a38b",
+    "@dxos/echo-schema": "0.7.5-main.9d2a38b",
+    "@dxos/live-object": "0.7.5-main.9d2a38b",
+    "@dxos/invariant": "0.7.5-main.9d2a38b",
+    "@dxos/local-storage": "0.7.5-main.9d2a38b",
+    "@dxos/react-hooks": "0.7.5-main.9d2a38b",
+    "@dxos/storybook-utils": "0.7.5-main.9d2a38b",
+    "@dxos/util": "0.7.5-main.9d2a38b",
+    "@dxos/log": "0.7.5-main.9d2a38b"
   },
   "devDependencies": {
     "@types/react": "~18.2.0",
-    "react": "~18.2.0"
+    "react": "~18.2.0",
+    "@dxos/echo-signals": "0.7.5-main.9d2a38b",
+    "@dxos/react-ui": "0.7.5-main.9d2a38b",
+    "@dxos/react-ui-syntax-highlighter": "0.7.5-main.9d2a38b"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.1.5",

package/project.json

@@ -11,7 +11,8 @@
     "compile": {
       "options": {
         "entryPoints": [
-          "{projectRoot}/src/index.ts"
+          "{projectRoot}/src/index.ts",
+          "{projectRoot}/src/testing/index.ts"
         ]
       }
     },