@dxos/app-framework 0.7.4 → 0.7.5-main.499c70c

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

@@ -1,21 +1,8 @@
-import { type Provider } from 'react';
-import type { UnsubscribeCallback } from '@dxos/async';
-import type { Intent, IntentDispatcher, IntentResolver, IntentResult } from './intent';
-export type IntentExecution = {
-    intent: Intent;
-    result: IntentResult;
-};
-export type IntentContext = {
-    dispatch: IntentDispatcher;
-    undo: () => Promise<IntentResult | void>;
-    history: IntentExecution[][];
-    registerResolver: (pluginId: string, resolver: IntentResolver) => UnsubscribeCallback;
-};
-/**
- * @deprecated Prefer granular hooks.
- */
-export declare const useIntent: () => IntentContext;
-export declare const useIntentDispatcher: () => IntentDispatcher;
-export declare const useIntentResolver: (plugin: string, resolver: IntentResolver) => void;
-export declare const IntentProvider: Provider<IntentContext>;
+import { type Context, type Provider } from 'react';
+import { type AnyIntentResolver, type IntentContext } from './intent-dispatcher';
+declare const IntentContext: Context<IntentContext | undefined>;
+export declare const useIntentDispatcher: () => Pick<IntentContext, "dispatch" | "dispatchPromise">;
+export declare const useIntentResolver: (pluginId: string, resolver: AnyIntentResolver) => void;
+export declare const IntentProvider: Provider<IntentContext | undefined>;
+export {};
 //# sourceMappingURL=IntentContext.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"IntentContext.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/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;AAEjF,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,aAAc,MAAM,YAAY,iBAAiB,SAK9E,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,GAAG,SAAS,CAA0B,CAAC"}

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

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

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

@@ -1,5 +1,6 @@
 import { IntentPlugin } from './IntentPlugin';
 export * from './intent';
+export * from './intent-dispatcher';
 export * from './provides';
 export * from './IntentContext';
 export default IntentPlugin;

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

@@ -1 +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"}
+{"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,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAE3B,cAAc,iBAAiB,CAAC;AAEhC,eAAe,YAAY,CAAC"}

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

@@ -0,0 +1,107 @@
+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';
+/**
+ * The return value of an intent effect.
+ */
+export type IntentEffectResult<Fields extends IntentParams> = {
+    /**
+     * The output of the action that was performed.
+     *
+     * If the intent is apart of a chain of intents, the data will be passed to the next intent.
+     */
+    data?: IntentResultData<Fields>;
+    /**
+     * If provided, the action will be undoable.
+     */
+    undoable?: {
+        /**
+         * Message to display to the user when indicating that the action can be undone.
+         */
+        message: Label;
+        /**
+         * Will be merged with the original intent data when firing the undo intent.
+         */
+        data?: Partial<IntentData<Fields>>;
+    };
+    /**
+     * 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.
+     */
+    error?: Error;
+    /**
+     * Other intent chains to be triggered.
+     */
+    intents?: AnyIntentChain[];
+};
+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.
+ */
+export type IntentEffectDefinition<Fields extends IntentParams> = (data: IntentData<Fields>, undo: boolean) => MaybePromise<IntentEffectResult<Fields> | void> | Effect.Effect<IntentEffectResult<Fields> | void>;
+/**
+ * Intent resolver to match intents to their effects.
+ */
+export type IntentResolver<Tag extends string, Fields extends IntentParams> = {
+    action: Tag;
+    disposition?: IntentDisposition;
+    filter?: (data: IntentData<Fields>) => boolean;
+    effect: IntentEffectDefinition<Fields>;
+};
+export type AnyIntentResolver = IntentResolver<any, any>;
+/**
+ * Creates an intent resolver to match intents to their effects.
+ * @param schema Schema of the intent. Must be a tagged class with input and output schemas.
+ * @param effect Effect to be performed when the intent is resolved.
+ * @param params.disposition Determines the priority of the resolver when multiple are resolved.
+ * @param params.filter Optional filter to determine if the resolver should be used.
+ */
+export declare const createResolver: <Tag extends string, Fields extends IntentParams>(schema: IntentSchema<Tag, Fields>, effect: IntentEffectDefinition<Fields>, params?: Pick<IntentResolver<Tag, Fields>, "disposition" | "filter">) => IntentResolver<Tag, Fields>;
+/**
+ * Invokes intents and returns the result.
+ */
+export type PromiseIntentDispatcher = <Fields extends IntentParams>(intent: IntentChain<any, any, any, Fields>) => Promise<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>;
+/**
+ * Invokes the most recent undoable intent with undo flags.
+ */
+export type PromiseIntentUndo = () => Promise<IntentDispatcherResult<any> | undefined>;
+/**
+ * Creates an effect which undoes the last intent.
+ */
+export type IntentUndo = () => Effect.Effect<IntentDispatcherResult<any> | undefined, Error>;
+export type IntentContext = {
+    dispatch: IntentDispatcher;
+    dispatchPromise: PromiseIntentDispatcher;
+    undo: IntentUndo;
+    undoPromise: PromiseIntentUndo;
+    registerResolver: (id: string, resolver: AnyIntentResolver) => () => void;
+};
+/**
+ * Sets of an intent dispatcher.
+ *
+ * @param resolvers An array of available intent resolvers.
+ * @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 }?: {
+    executionLimit?: number | undefined;
+    historyLimit?: number | undefined;
+}) => IntentContext;
+//# sourceMappingURL=intent-dispatcher.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=intent-dispatcher.test.d.ts.map

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

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

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

@@ -1,81 +1,88 @@
-import type { MaybePromise } from '@dxos/util';
-import type { Plugin } from '../plugin-host';
-/**
- * Type of data returned from an intent.
- */
-export type IntentData<T extends Record<string, any> = Record<string, any>> = T & {
-    /**
-     * The data from the result of the previous intent.
-     */
-    result?: any;
+import { S } from '@dxos/echo-schema';
+export type IntentParams = {
+    readonly input: S.Schema.All;
+    readonly output: S.Schema.All;
 };
+export type IntentData<Fields extends IntentParams> = S.Schema.Type<S.Struct<Fields>> extends {
+    readonly input: any;
+} ? S.Schema.Type<S.Struct<Fields>>['input'] : any;
+export type IntentResultData<Fields extends IntentParams> = S.Schema.Type<S.Struct<Fields>> extends {
+    readonly output: any;
+} ? S.Schema.Type<S.Struct<Fields>>['output'] : any;
+export type IntentSchema<Tag extends string, Fields extends IntentParams> = S.TaggedClass<any, Tag, Fields>;
 /**
  * An intent is an abstract description of an operation to be performed.
  * Intents allow actions to be performed across plugins.
  */
-export type Intent = {
+export type Intent<Tag extends string, Fields extends IntentParams> = {
+    _schema: IntentSchema<Tag, Fields>;
+    /**
+     * The action to perform.
+     */
+    action: Tag;
+    /**
+     * Any data needed to perform the desired action.
+     */
+    data: IntentData<Fields>;
     /**
      * Plugin ID.
      * If specified, the intent will be sent explicitly to the plugin.
      * 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;
-    /**
-     * The action to perform.
-     */
-    action: string;
     /**
      * Whether or not the intent is being undone.
      */
     undo?: boolean;
-    /**
-     * Any data needed to perform the desired action.
-     */
-    data?: IntentData;
 };
-export type IntentResult = {
-    /**
-     * The output of the action that was performed.
-     *
-     * If the intent is apart of a chain of intents, the data will be passed to the next intent.
-     */
-    data?: any;
-    /**
-     * If provided, the action will be undoable.
-     */
-    undoable?: {
-        /**
-         * Message to display to the user when indicating that the action can be undone.
-         */
-        message: string;
-        /**
-         * Will be merged with the original intent data when firing the undo intent.
-         */
-        data?: IntentData;
-    };
-    /**
-     * 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.
-     */
-    error?: Error;
-    /**
-     * Other intent chains to be triggered.
-     */
-    intents?: Intent[][];
+export type AnyIntent = Intent<any, any>;
+/**
+ * Chain of intents to be executed together.
+ * The result of each intent is merged into the next intent's input data.
+ */
+export type IntentChain<FirstTag extends string, LastTag extends string, FirstFields extends IntentParams, LastFields extends IntentParams> = {
+    first: Intent<FirstTag, FirstFields>;
+    last: Intent<LastTag, LastFields>;
+    all: AnyIntent[];
 };
+export type AnyIntentChain = IntentChain<any, any, any, any>;
 /**
- * Trigger one or more intents to be sent.
- * If multiple intents are specified, the result of each will be merged with the data to the next.
- *
- * @returns The result of the last intent.
+ * Creates a typed intent.
+ * @param schema Schema of the intent. Must be a tagged class with input and output schemas.
+ * @param data Data fulfilling the input schema of the intent.
+ * @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 type IntentDispatcher = (intent: Intent | Intent[]) => Promise<IntentResult | void>;
+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>;
 /**
- * Resolves an intent that was dispatched.
- * If the intent is not handled, nothing should be returned.
+ * Chain two intents together.
  *
- * @returns The result of the intent.
+ * NOTE: Chaining of intents depends on the data inputs and outputs being structs.
  */
-export type IntentResolver = (intent: Intent, plugins: Plugin[]) => MaybePromise<IntentResult | void>;
+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 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/plugins/plugin-intent/intent.d.ts.map

@@ -1 +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;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG;IAChF;;OAEG;IAEH,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;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC"}
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-intent/intent.ts"],"names":[],"mappings":"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"}

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

@@ -1,3 +1,4 @@
+export declare const INTENT_PLUGIN = "dxos.org/plugin/intent";
 declare const IntentMeta: {
     id: string;
 };

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

@@ -1 +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"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-intent/meta.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,2BAA2B,CAAC;AAEtD,QAAA,MAAM,UAAU;;CAEf,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -1,9 +1,10 @@
-import { type IntentContext } from './IntentContext';
-import { type IntentResolver } from './intent';
-import { type Plugin } from '../plugin-host';
+import { type IntentContext, type AnyIntentResolver } from './intent-dispatcher';
+import { type HostContext, type Plugin } from '../plugin-host';
+type Context = HostContext & IntentContext;
+export type ResolverDefinitions = AnyIntentResolver | AnyIntentResolver[] | ResolverDefinitions[];
 export type IntentResolverProvides = {
     intent: {
-        resolver: IntentResolver;
+        resolvers: (context: Context) => ResolverDefinitions;
     };
 };
 export type IntentPluginProvides = {
@@ -11,10 +12,5 @@ export type IntentPluginProvides = {
 };
 export declare const parseIntentPlugin: (plugin: Plugin) => Plugin<IntentPluginProvides> | undefined;
 export declare const parseIntentResolverPlugin: (plugin: Plugin) => Plugin<IntentResolverProvides> | undefined;
-export declare enum IntentAction {
-    /**
-     * Fired after an intent is dispatched if the intent is undoable.
-     */
-    SHOW_UNDO = "dxos.org/plugin/intent/action/show-undo"
-}
+export {};
 //# sourceMappingURL=provides.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"provides.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-intent/provides.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE/D,KAAK,OAAO,GAAG,WAAW,GAAG,aAAa,CAAC;AAE3C,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,mBAAmB,EAAE,CAAC;AAElG,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,mBAAmB,CAAC;KACtD,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,+CAC6C,CAAC"}

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

@@ -1,3 +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> = {
@@ -7,7 +8,19 @@ 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"
+export declare const SETTINGS_PLUGIN = "dxos.org/plugin/settings";
+export declare const SETTINGS_ACTION = "dxos.org/plugin/settings/action";
+export declare namespace SettingsAction {
+    const Open_base: S.TaggedClass<Open, "dxos.org/plugin/settings/action/open", {
+        readonly _tag: S.tag<"dxos.org/plugin/settings/action/open">;
+    } & {
+        input: S.Struct<{
+            plugin: S.optional<typeof S.String>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class Open extends Open_base {
+    }
+    export {};
 }
 //# sourceMappingURL=provides.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"provides.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-settings/provides.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,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;AAEF,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/plugins/plugin-surface/Surface.d.ts

@@ -1,62 +1,7 @@
-import React, { type PropsWithChildren, type ReactNode } from 'react';
-import { ErrorBoundary } from './ErrorBoundary';
-/**
- * Direction determines how multiple components are laid out.
- */
-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.
-     */
-    role?: string;
-    /**
-     * Names allow nested surfaces to be specified in the parent context, similar to a slot.
-     * Defaults to the value of `role` if not specified.
-     */
-    name?: string;
-    /**
-     * The data to be rendered by the surface.
-     */
-    data?: Record<string, unknown>;
-    /**
-     * Configure nested surfaces (indexed by the surface's `name`).
-     */
-    surfaces?: Record<string, Pick<SurfaceProps, 'data' | 'surfaces'>>;
-    /**
-     * If specified, the Surface will be wrapped in an error boundary.
-     * The fallback component will be rendered if an error occurs.
-     */
-    fallback?: ErrorBoundary['props']['fallback'];
-    /**
-     * If specified, the Surface will be wrapped in a suspense boundary.
-     * The placeholder component will be rendered while the surface component is loading.
-     */
-    placeholder?: ReactNode;
-    /**
-     * If more than one component is resolved, the limit determines how many are rendered.
-     */
-    limit?: number | undefined;
-    /**
-     * If more than one component is resolved, the direction determines how they are laid out.
-     * 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;
-}>;
+import React from 'react';
+import { type SurfaceProps } from './SurfaceContext';
 /**
  * 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>>>;
-export declare const useSurface: () => SurfaceProps;
 //# sourceMappingURL=Surface.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-surface/Surface.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAgE,MAAM,OAAO,CAAC;AAKrF,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,kBAAkB,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,OAAO,0HA+CnB,CAAC"}

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

@@ -0,0 +1,85 @@
+import { type JSX, type ForwardedRef, type PropsWithChildren, type ReactNode } from 'react';
+import { type GuardedType, type MakeOptional } from '@dxos/util';
+import { type ErrorBoundary } from './ErrorBoundary';
+/**
+ * SurfaceProps are the props that are passed to the Surface component.
+ */
+export type SurfaceProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<{
+    /**
+     * If specified, the Surface will be wrapped in an error boundary.
+     * The fallback component will be rendered if an error occurs.
+     */
+    fallback?: ErrorBoundary['props']['fallback'];
+    /**
+     * If specified, the Surface will be wrapped in a suspense boundary.
+     * The placeholder component will be rendered while the surface component is loading.
+     */
+    placeholder?: ReactNode;
+}> & MakeOptional<CoreSurfaceProps<T>, 'id' | 'data'> & {
+    /**
+     * 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;
+};
+type CoreSurfaceProps<T extends Record<string, any> = Record<string, unknown>> = {
+    /**
+     * ID for debugging.
+     */
+    id: string;
+    /**
+     * Role defines how the data should be rendered.
+     */
+    role: string;
+    /**
+     * The data to be rendered by the surface.
+     */
+    data: T;
+    /**
+     * If more than one component is resolved, the limit determines how many are rendered.
+     */
+    limit?: number | undefined;
+};
+type SurfaceComponentProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<CoreSurfaceProps<T> & {
+    [key: string]: unknown;
+}>;
+/**
+ * React component used to render a surface once is has matched.
+ */
+export type SurfaceComponent<T extends Record<string, any> = Record<string, unknown>> = (props: SurfaceComponentProps<T>, forwardedRef: ForwardedRef<HTMLElement>) => JSX.Element | null;
+/**
+ * Determines the priority of the surface when multiple components are resolved.
+ *
+ * - `static` - The component is rendered in the order it was resolved.
+ * - `hoist` - The component is rendered before `static` components.
+ * - `fallback` - The component is rendered after `static` components.
+ */
+export type SurfaceDisposition = 'static' | 'hoist' | 'fallback';
+/**
+ * Definition of when a SurfaceComponent should be rendered.
+ */
+export type SurfaceDefinition<T extends Record<string, any> = any> = {
+    id: string;
+    role: string | string[];
+    disposition?: SurfaceDisposition;
+    filter?: (data: Record<string, unknown>) => data is T;
+    component: SurfaceComponent<GuardedType<SurfaceDefinition<T>['filter']>>;
+};
+export declare const createSurface: <T extends Record<string, any> = any>(definition: SurfaceDefinition<T>) => SurfaceDefinition<T>;
+/**
+ * Surface debug info.
+ * NOTE: Short-term measure to track perf issues.
+ */
+export type DebugInfo = {
+    id: string;
+    created: number;
+    renderCount: number;
+} & Pick<SurfaceProps, 'role'>;
+export type SurfaceContextValue = {
+    surfaces: Record<string, SurfaceDefinition>;
+    debugInfo?: Map<string, DebugInfo>;
+};
+export declare const useSurfaceRoot: () => SurfaceContextValue;
+export declare const SurfaceProvider: import("react").Provider<SurfaceContextValue | undefined>;
+export {};
+//# sourceMappingURL=SurfaceContext.d.ts.map

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

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

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

@@ -1 +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"}
+{"version":3,"file":"SurfacePlugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/plugin-surface/SurfacePlugin.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAsB,KAAK,qBAAqB,EAA2B,MAAM,YAAY,CAAC;AAErG,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,aAAa,QAAO,gBAAgB,CAAC,qBAAqB,CAgBtE,CAAC"}

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

@@ -3,6 +3,6 @@ export * from './helpers';
 export * from './provides';
 export * from './ErrorBoundary';
 export * from './Surface';
-export * from './SurfaceRootContext';
+export * from './SurfaceContext';
 export default SurfacePlugin;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,kBAAkB,CAAC;AAEjC,eAAe,aAAa,CAAC"}

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

@@ -1,15 +1,16 @@
-import { type SurfaceComponent, type SurfaceRootContext } from './SurfaceRootContext';
-import { type Plugin } from '../plugin-host';
+import { type SurfaceDefinition, type SurfaceContextValue } from './SurfaceContext';
+import { type HostContext, type Plugin } from '../plugin-host';
+export type SurfaceDefinitions = SurfaceDefinition | SurfaceDefinition[] | SurfaceDefinitions[];
 export type SurfaceProvides = {
     surface: {
         /**
          * Used by the `Surface` resolver to find a component to render.
          */
-        component: SurfaceComponent;
+        definitions: (context: HostContext) => SurfaceDefinitions;
     };
 };
 export type SurfacePluginProvides = {
-    surface: SurfaceRootContext;
+    surface: SurfaceContextValue;
 };
 export declare const parseRootSurfacePlugin: (plugin?: Plugin) => Plugin<SurfacePluginProvides> | undefined;
 export declare const parseSurfacePlugin: (plugin?: Plugin) => Plugin<SurfaceProvides> | undefined;