@dxos/app-framework 0.8.4-main.b97322e → 0.8.4-main.bc674ce

package/dist/types/src/plugin-operation/history/undo-mapping.d.ts

@@ -0,0 +1,93 @@
+import type { Operation } from '@dxos/operation';
+import type { Label } from '../../common/translations';
+/**
+ * Extract the input type from an OperationDefinition.
+ */
+export type InputOf<T> = T extends Operation.Definition<infer I, any> ? I : never;
+/**
+ * Extract the output type from an OperationDefinition.
+ */
+export type OutputOf<T> = T extends Operation.Definition<any, infer O> ? O : never;
+/**
+ * Message provider for undo toast.
+ * Can be a static Label or a function that derives the message from input/output.
+ */
+export type MessageProvider<Op extends Operation.Definition<any, any>> = Label | ((input: InputOf<Op>, output: OutputOf<Op>) => Label);
+/**
+ * Undo mapping that links a forward operation to its inverse.
+ * Type parameters ensure deriveContext has correctly typed arguments.
+ *
+ * @template Op - The forward operation definition type.
+ * @template Inv - The inverse operation definition type.
+ */
+export interface UndoMapping<Op extends Operation.Definition<any, any> = Operation.Definition<any, any>, Inv extends Operation.Definition<any, any> = Operation.Definition<any, any>> {
+    /** The forward operation. */
+    readonly operation: Op;
+    /** The inverse operation to invoke for undo. */
+    readonly inverse: Inv;
+    /**
+     * Derives the input for the inverse operation from the forward operation's input and output.
+     * @param input - The input that was passed to the forward operation.
+     * @param output - The output that was returned by the forward operation.
+     * @returns The input to pass to the inverse operation, or undefined to indicate the operation is not undoable.
+     */
+    readonly deriveContext: (input: InputOf<Op>, output: OutputOf<Op>) => InputOf<Inv> | undefined;
+    /**
+     * Optional message to show in the undo toast.
+     * Can be a static Label or a function that derives the message from input/output.
+     */
+    readonly message?: MessageProvider<Op>;
+}
+/**
+ * Props for creating an UndoMapping.
+ */
+export interface UndoMappingProps<Op extends Operation.Definition<any, any>, Inv extends Operation.Definition<any, any>> {
+    /** The forward operation. */
+    operation: Op;
+    /** The inverse operation to invoke for undo. */
+    inverse: Inv;
+    /**
+     * Derives the input for the inverse operation from the forward operation's input and output.
+     * Return undefined to indicate the operation is not undoable.
+     */
+    deriveContext: (input: InputOf<Op>, output: OutputOf<Op>) => InputOf<Inv> | undefined;
+    /**
+     * Optional message to show in the undo toast.
+     * Can be a static Label or a function that derives the message from input/output.
+     */
+    message?: MessageProvider<Op>;
+}
+/**
+ * Creates a type-safe undo mapping.
+ *
+ * @example
+ * ```ts
+ * // Static message
+ * const mapping = UndoMapping.make({
+ *   operation: DeleteThread,
+ *   inverse: RestoreThread,
+ *   deriveContext: (input, output) => ({
+ *     thread: output.thread,
+ *     anchor: output.anchor,
+ *   }),
+ *   message: ['thread deleted label', { ns: 'plugin-thread' }],
+ * });
+ *
+ * // Dynamic message based on input/output
+ * const mapping = UndoMapping.make({
+ *   operation: RemoveObjects,
+ *   inverse: RestoreObjects,
+ *   deriveContext: (_input, output) => output,
+ *   message: (input, _output) =>
+ *     input.objects.length === 1
+ *       ? ['object deleted label', { ns: getTypename(input.objects[0]) }]
+ *       : ['objects deleted label', { ns: 'plugin-space' }],
+ * });
+ * ```
+ */
+export declare const make: <Op extends Operation.Definition<any, any>, Inv extends Operation.Definition<any, any>>(props: UndoMappingProps<Op, Inv>) => UndoMapping<Op, Inv>;
+/**
+ * Resolves a message provider to a Label.
+ */
+export declare const resolveMessage: <Op extends Operation.Definition<any, any>>(message: MessageProvider<Op> | undefined, input: InputOf<Op>, output: OutputOf<Op>) => Label | undefined;
+//# sourceMappingURL=undo-mapping.d.ts.map

package/dist/types/src/plugin-operation/history/undo-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-mapping.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-operation/history/undo-mapping.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEnF;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,EAAE,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,IACjE,KAAK,GACL,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,WAAW,CAC1B,EAAE,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAC1E,GAAG,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC;IAE3E,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC;IAEvB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;IAEtB;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAE/F;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAC/B,EAAE,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EACzC,GAAG,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC;IAE1C,6BAA6B;IAC7B,SAAS,EAAE,EAAE,CAAC;IAEd,gDAAgD;IAChD,OAAO,EAAE,GAAG,CAAC;IAEb;;;OAGG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAEtF;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,IAAI,GAAI,EAAE,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EACxG,OAAO,gBAAgB,CAAC,EAAE,EAAE,GAAG,CAAC,KAC/B,WAAW,CAAC,EAAE,EAAE,GAAG,CAAU,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,EAAE,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EACtE,SAAS,eAAe,CAAC,EAAE,CAAC,GAAG,SAAS,EACxC,OAAO,OAAO,CAAC,EAAE,CAAC,EAClB,QAAQ,QAAQ,CAAC,EAAE,CAAC,KACnB,KAAK,GAAG,SAQV,CAAC"}

package/dist/types/src/plugin-operation/history/undo-registry.d.ts

@@ -0,0 +1,23 @@
+import type { Operation } from '@dxos/operation';
+import type * as UndoMapping from './undo-mapping';
+/**
+ * Lookup result from UndoRegistry.
+ */
+export type UndoMappingResult = {
+    inverse: Operation.Definition<any, any>;
+    /** Returns undefined to indicate the operation is not undoable. */
+    deriveContext: (input: any, output: any) => any | undefined;
+    /** Message provider - may be a static Label or a function. */
+    message?: UndoMapping.MessageProvider<Operation.Definition<any, any>>;
+};
+/**
+ * UndoRegistry interface - looks up inverse operations.
+ */
+export interface UndoRegistry {
+    lookup: (operation: Operation.Definition<any, any>) => UndoMappingResult | undefined;
+}
+/**
+ * Creates an UndoRegistry that looks up inverse operations.
+ */
+export declare const make: (getMappings: () => UndoMapping.UndoMapping[]) => UndoRegistry;
+//# sourceMappingURL=undo-registry.d.ts.map

package/dist/types/src/plugin-operation/history/undo-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-registry.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-operation/history/undo-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAMnD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxC,mEAAmE;IACnE,aAAa,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,SAAS,CAAC;IAC5D,8DAA8D;IAC9D,OAAO,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;CACvE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,iBAAiB,GAAG,SAAS,CAAC;CACtF;AAMD;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,aAAa,MAAM,WAAW,CAAC,WAAW,EAAE,KAAG,YAgBnE,CAAC"}

package/dist/types/src/plugin-operation/history/undo-registry.test.d.ts

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

package/dist/types/src/plugin-operation/history/undo-registry.test.d.ts.map

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

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

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

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

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

package/dist/types/src/plugin-operation/invoker-capability.d.ts

@@ -0,0 +1,6 @@
+import * as Effect from 'effect/Effect';
+import { OperationInvoker } from '@dxos/operation';
+import { Capability, Plugin } from '../core';
+declare const _default: (props?: void | undefined) => Effect.Effect<Capability.Capability<Capability.InterfaceDef<OperationInvoker.OperationInvoker>>, never, Capability.Service | Plugin.Service>;
+export default _default;
+//# sourceMappingURL=invoker-capability.d.ts.map

package/dist/types/src/plugin-operation/invoker-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoker-capability.d.ts","sourceRoot":"","sources":["../../../../src/plugin-operation/invoker-capability.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;;AAM7C,wBAwBE"}

package/dist/types/src/plugin-operation/meta.d.ts

@@ -0,0 +1,3 @@
+import { type Plugin } from '../core';
+export declare const meta: Plugin.Meta;
+//# sourceMappingURL=meta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../../src/plugin-operation/meta.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,IAIzB,CAAC"}

package/dist/types/src/plugin-operation/testing.d.ts

@@ -0,0 +1,109 @@
+import * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+import { Operation, type OperationInvoker, OperationResolver } from '@dxos/operation';
+export declare const Compute: Omit<{
+    readonly schema: {
+        readonly input: Schema.Struct<{
+            value: typeof Schema.Number;
+        }>;
+        readonly output: Schema.Struct<{
+            value: typeof Schema.Number;
+        }>;
+    };
+    readonly meta: {
+        readonly key: "test.compute";
+    };
+}, "executionMode"> & import("effect/Pipeable").Pipeable & {
+    readonly executionMode: "sync" | "async";
+};
+export declare const HalveCompute: Omit<{
+    readonly schema: {
+        readonly input: Schema.Struct<{
+            value: typeof Schema.Number;
+        }>;
+        readonly output: Schema.Struct<{
+            value: typeof Schema.Number;
+        }>;
+    };
+    readonly meta: {
+        readonly key: "test.halve-compute";
+    };
+}, "executionMode"> & import("effect/Pipeable").Pipeable & {
+    readonly executionMode: "sync" | "async";
+};
+export declare const ToString: Omit<{
+    readonly schema: {
+        readonly input: Schema.Struct<{
+            value: typeof Schema.Number;
+        }>;
+        readonly output: Schema.Struct<{
+            string: typeof Schema.String;
+        }>;
+    };
+    readonly meta: {
+        readonly key: "test.to-string";
+    };
+}, "executionMode"> & import("effect/Pipeable").Pipeable & {
+    readonly executionMode: "sync" | "async";
+};
+export declare const Add: Omit<{
+    readonly schema: {
+        readonly input: Schema.Tuple2<typeof Schema.Number, typeof Schema.Number>;
+        readonly output: typeof Schema.Number;
+    };
+    readonly meta: {
+        readonly key: "test.add";
+    };
+}, "executionMode"> & import("effect/Pipeable").Pipeable & {
+    readonly executionMode: "sync" | "async";
+};
+export declare const SideEffect: Omit<{
+    readonly schema: {
+        readonly input: typeof Schema.Void;
+        readonly output: typeof Schema.Void;
+    };
+    readonly meta: {
+        readonly key: "test.side-effect";
+    };
+}, "executionMode"> & import("effect/Pipeable").Pipeable & {
+    readonly executionMode: "sync" | "async";
+};
+export declare const computeHandler: OperationResolver.OperationResolver<{
+    readonly value: number;
+}, {
+    readonly value: number;
+}, never, Operation.Service>;
+export declare const halveComputeHandler: OperationResolver.OperationResolver<{
+    readonly value: number;
+}, {
+    readonly value: number;
+}, never, Operation.Service>;
+export declare const toStringHandler: OperationResolver.OperationResolver<{
+    readonly value: number;
+}, {
+    readonly string: string;
+}, never, Operation.Service>;
+export declare const addHandler: OperationResolver.OperationResolver<readonly [number, number], number, never, Operation.Service>;
+export declare const sideEffectHandler: OperationResolver.OperationResolver<void, void, never, Operation.Service>;
+/**
+ * Event collector for testing - provides deterministic event collection using Effect primitives.
+ */
+export interface EventCollector {
+    /** All collected events. */
+    readonly events: OperationInvoker.InvocationEvent[];
+    /** Wait until N events have been collected. */
+    waitForEvents: (count: number) => Effect.Effect<void>;
+    /** Clean up the subscription fiber. */
+    dispose: Effect.Effect<void>;
+}
+/**
+ * Creates an event collector that subscribes to invoker events.
+ * Uses Effect primitives for synchronization.
+ */
+export declare const createEventCollector: (invoker: OperationInvoker.OperationInvoker) => Effect.Effect<EventCollector>;
+/**
+ * Waits until a condition is true, yielding to the JS event loop between checks.
+ * Uses setImmediate to allow other async work to complete.
+ */
+export declare const waitUntil: (condition: () => boolean) => Effect.Effect<void>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/types/src/plugin-operation/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../../src/plugin-operation/testing.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAMtF,eAAO,MAAM,OAAO;;;;;;;;;;;;;;CAMlB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAMvB,CAAC;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;CAMnB,CAAC;AAEH,eAAO,MAAM,GAAG;;;;;;;;;;CAMd,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;CAMrB,CAAC;AAMH,eAAO,MAAM,cAAc;;;;4BAOzB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;4BAG9B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;4BAG1B,CAAC;AAEH,eAAO,MAAM,UAAU,kGAGrB,CAAC;AAEH,eAAO,MAAM,iBAAiB,2EAG5B,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,eAAe,EAAE,CAAC;IACpD,+CAA+C;IAC/C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtD,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,gBAAgB,CAAC,gBAAgB,KAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAoD1G,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,WAAW,MAAM,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAKnE,CAAC"}

package/dist/types/src/plugin-runtime/RuntimePlugin.d.ts

@@ -0,0 +1,3 @@
+import { Plugin } from '../core';
+export declare const RuntimePlugin: Plugin.PluginFactory<void>;
+//# sourceMappingURL=RuntimePlugin.d.ts.map

package/dist/types/src/plugin-runtime/RuntimePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimePlugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin-runtime/RuntimePlugin.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,MAAM,EAAE,MAAM,SAAS,CAAC;AAM7C,eAAO,MAAM,aAAa,4BAQzB,CAAC"}

package/dist/types/src/plugin-runtime/capability.d.ts

@@ -0,0 +1,6 @@
+import * as Effect from 'effect/Effect';
+import * as Common from '../common';
+import { Capability, Plugin } from '../core';
+declare const _default: (props?: void | undefined) => Effect.Effect<Capability.Capability<Capability.InterfaceDef<Common.Capability.ManagedRuntime>>, Error, Capability.Service | Plugin.Service>;
+export default _default;
+//# sourceMappingURL=capability.d.ts.map

package/dist/types/src/plugin-runtime/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../../src/plugin-runtime/capability.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,KAAK,MAAM,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;;AAM7C,wBAqCE"}

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

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

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

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

package/dist/types/src/plugin-runtime/meta.d.ts

@@ -0,0 +1,3 @@
+import { type Plugin } from '../core';
+export declare const meta: Plugin.Meta;
+//# sourceMappingURL=meta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../../src/plugin-runtime/meta.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,IAIzB,CAAC"}

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

@@ -1,2 +1,3 @@
-export declare const SettingsPlugin: () => import("..").Plugin;
+import { Plugin } from '../core';
+export declare const SettingsPlugin: Plugin.PluginFactory<void>;
 //# sourceMappingURL=SettingsPlugin.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SettingsPlugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/SettingsPlugin.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,cAAc,2BAwBvB,CAAC"}
+{"version":3,"file":"SettingsPlugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/SettingsPlugin.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,MAAM,EAAE,MAAM,SAAS,CAAC;AAQ7C,eAAO,MAAM,cAAc,4BAK1B,CAAC"}

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

@@ -1,11 +1,10 @@
-import { Schema } from 'effect';
-export declare const SETTINGS_PLUGIN = "dxos.org/plugin/settings";
-export declare const SETTINGS_ACTION = "dxos.org/plugin/settings/action";
+import * as Schema from 'effect/Schema';
+import { Capability } from '../core';
 export declare const SETTINGS_ID = "!dxos:settings";
 export declare const SETTINGS_KEY = "settings";
 export declare namespace SettingsAction {
-    const Open_base: Schema.TaggedClass<Open, "dxos.org/plugin/settings/action/open", {
-        readonly _tag: Schema.tag<"dxos.org/plugin/settings/action/open">;
+    const Open_base: Schema.TaggedClass<Open, `${string}/open`, {
+        readonly _tag: Schema.tag<`${string}/open`>;
     } & {
         input: Schema.Struct<{
             plugin: Schema.optional<typeof Schema.String>;
@@ -14,8 +13,8 @@ export declare namespace SettingsAction {
     }>;
     export class Open extends Open_base {
     }
-    const OpenPluginRegistry_base: Schema.TaggedClass<OpenPluginRegistry, "dxos.org/plugin/settings/action/open-plugin-registry", {
-        readonly _tag: Schema.tag<"dxos.org/plugin/settings/action/open-plugin-registry">;
+    const OpenPluginRegistry_base: Schema.TaggedClass<OpenPluginRegistry, `${string}/open-plugin-registry`, {
+        readonly _tag: Schema.tag<`${string}/open-plugin-registry`>;
     } & {
         input: typeof Schema.Void;
         output: typeof Schema.Void;
@@ -24,4 +23,39 @@ export declare namespace SettingsAction {
     }
     export {};
 }
+/**
+ * Operations for the Settings plugin.
+ */
+export declare namespace SettingsOperation {
+    const Open: Omit<{
+        readonly meta: {
+            readonly key: `${string}/open`;
+            readonly name: "Open Settings";
+            readonly description: "Open the settings panel.";
+        };
+        readonly services: readonly [typeof Capability.Service];
+        readonly schema: {
+            readonly input: Schema.Struct<{
+                plugin: Schema.optional<Schema.SchemaClass<string, string, never>>;
+            }>;
+            readonly output: typeof Schema.Void;
+        };
+    }, "executionMode"> & import("effect/Pipeable").Pipeable & {
+        readonly executionMode: "sync" | "async";
+    };
+    const OpenPluginRegistry: Omit<{
+        readonly meta: {
+            readonly key: `${string}/open-plugin-registry`;
+            readonly name: "Open Plugin Registry";
+            readonly description: "Open the plugin registry.";
+        };
+        readonly services: readonly [typeof Capability.Service];
+        readonly schema: {
+            readonly input: typeof Schema.Void;
+            readonly output: typeof Schema.Void;
+        };
+    }, "executionMode"> & import("effect/Pipeable").Pipeable & {
+        readonly executionMode: "sync" | "async";
+    };
+}
 //# sourceMappingURL=actions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/actions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAC1D,eAAO,MAAM,eAAe,oCAA8B,CAAC;AAG3D,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAC5C,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC,yBAAiB,cAAc,CAAC;;;;;;;;;IAC9B,MAAM,OAAO,IAAK,SAAQ,SAKxB;KAAG;;;;;;;IAEL,MAAM,OAAO,kBAAmB,SAAQ,uBAMvC;KAAG;;CACL"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/actions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKrC,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAC5C,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC,yBAAiB,cAAc,CAAC;;;;;;;;;IAC9B,MAAM,OAAO,IAAK,SAAQ,SAKxB;KAAG;;;;;;;IAEL,MAAM,OAAO,kBAAmB,SAAQ,uBAGtC;KAAG;;CACN;AAID;;GAEG;AACH,yBAAiB,iBAAiB,CAAC;IAC1B,MAAM,IAAI;;;;;;;;;;;;;;;KAaf,CAAC;IAEI,MAAM,kBAAkB;;;;;;;;;;;;;KAW7B,CAAC;CACJ"}

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

@@ -1,4 +1,6 @@
-import { type PluginContext } from '../core';
-declare const _default: (context: PluginContext) => import("..").Capability<import("@dxos/app-graph").BuilderExtensions>;
+import * as Effect from 'effect/Effect';
+import { GraphBuilder } from '@dxos/app-graph';
+import { Capability } from '../core';
+declare const _default: (props?: void | undefined) => Effect.Effect<Capability.Capability<Capability.InterfaceDef<GraphBuilder.BuilderExtensions>>, never, Capability.Service>;
 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":"AAaA,OAAO,EAAgC,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;yBAG3D,SAAS,aAAa;AAAtC,wBA4IK"}
+{"version":3,"file":"app-graph-builder.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/app-graph-builder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,YAAY,EAAe,MAAM,iBAAiB,CAAC;AAK5D,OAAO,EAAE,UAAU,EAAe,MAAM,SAAS,CAAC;;AAKlD,wBA2HE"}

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

@@ -0,0 +1,3 @@
+import { type Plugin } from '@dxos/app-framework';
+export declare const meta: Plugin.Meta;
+//# sourceMappingURL=meta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/meta.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,IAGzB,CAAC"}

package/dist/types/src/plugin-settings/operation-resolver.d.ts

@@ -0,0 +1,6 @@
+import * as Effect from 'effect/Effect';
+import * as Common from '../common';
+import { Capability } from '../core';
+declare const _default: (props?: void | undefined) => Effect.Effect<Capability.Capability<Capability.InterfaceDef<Common.Capability.OperationResolver[]>>, never, never>;
+export default _default;
+//# sourceMappingURL=operation-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operation-resolver.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/operation-resolver.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,KAAK,MAAM,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;;AAIrC,wBAyCE"}

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

@@ -1,6 +1,7 @@
+import { meta } from './meta';
 export declare const translations: [{
     readonly 'en-US': {
-        readonly "dxos.org/plugin/settings": {
+        readonly [meta.id]: {
             readonly 'open settings label': "Open settings";
             readonly 'app settings label': "Settings";
             readonly 'custom plugins label': "Plugins";

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

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/translations.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY;;;;;;;;EAUM,CAAC"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../../src/plugin-settings/translations.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,eAAO,MAAM,YAAY;;QAGnB,SAAA,CAAC,IAAI,CAAC,EAAE,CAAC;;;;UAIR;;EAGwB,CAAC"}

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

@@ -0,0 +1,8 @@
+import React from 'react';
+import { type UseAppOptions } from './useApp';
+export type AppProps = Pick<UseAppOptions, 'placeholder' | 'debounce'> & {
+    ready: boolean;
+    error: unknown;
+};
+export declare const App: ({ placeholder: Placeholder, ready, error, debounce }: AppProps) => React.JSX.Element | null;
+//# sourceMappingURL=App.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../../src/react/App.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAiC,MAAM,OAAO,CAAC;AAKtD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAI9C,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,UAAU,CAAC,GAAG;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,sDAAsD,QAAQ,6BA2BjF,CAAC"}

package/dist/types/src/react/App.stories.d.ts

@@ -0,0 +1,14 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+declare const meta: {
+    title: string;
+    render: () => React.JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+//# sourceMappingURL=App.stories.d.ts.map

package/dist/types/src/react/App.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.stories.d.ts","sourceRoot":"","sources":["../../../../src/react/App.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,MAAM,OAAO,CAAC;AA2C1B,QAAA,MAAM,IAAI;;;;;;;CAOM,CAAC;AAEjB,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC"}

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

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * NOTE: Default fallback should not use tailwind or theme.
+ */
+export declare const DefaultFallback: ({ error }: {
+    error: Error;
+}) => React.JSX.Element;
+//# sourceMappingURL=DefaultFallback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultFallback.d.ts","sourceRoot":"","sources":["../../../../src/react/DefaultFallback.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,sBAgB1D,CAAC"}

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

@@ -1,30 +1,29 @@
-import React, { Component, type FC, type PropsWithChildren } from 'react';
-type Props = PropsWithChildren<{
+import { Component, type FC, type PropsWithChildren, type ReactNode } from 'react';
+type State = {
+    error: Error | undefined;
+};
+export type ErrorBoundaryProps = PropsWithChildren<{
     data?: any;
-    fallback: FC<{
+    fallback?: FC<{
         data?: any;
         error: Error;
-        reset: () => void;
     }>;
 }>;
-type State = {
-    error: Error | undefined;
-};
 /**
  * Surface error boundary.
- *
  * For basic usage prefer providing a fallback component to `Surface`.
  *
- * For more information on error boundaries, see:
- * https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary
+ * Ref: https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary
  */
-export declare class ErrorBoundary extends Component<Props, State> {
-    constructor(props: Props);
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, State> {
     static getDerivedStateFromError(error: Error): {
         error: Error;
     };
-    componentDidUpdate(prevProps: Props): void;
-    render(): string | number | boolean | React.JSX.Element | Iterable<React.ReactNode> | null | undefined;
+    state: {
+        error: undefined;
+    };
+    componentDidUpdate(prevProps: ErrorBoundaryProps): void;
+    render(): ReactNode;
     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,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"}
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../src/react/ErrorBoundary.tsx"],"names":[],"mappings":"AAIA,OAAc,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1F,KAAK,KAAK,GAAG;IACX,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;IACjD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,EAAE,CAAC;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAC7C,CAAC,CAAC;AAEH;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,KAAK,CAAC;IACrE,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE;IAItD,KAAK;;MAAwB;IAE7B,kBAAkB,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAMvD,MAAM,IAAI,SAAS;IAS5B,OAAO,CAAC,UAAU;CAGnB"}

package/dist/types/src/react/PluginManagerContext.stories.d.ts

@@ -0,0 +1,13 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+declare const meta: {
+    title: string;
+    render: () => React.JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;
+export declare const Default: StoryObj<typeof meta>;
+//# sourceMappingURL=PluginManagerContext.stories.d.ts.map

package/dist/types/src/react/PluginManagerContext.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginManagerContext.stories.d.ts","sourceRoot":"","sources":["../../../../src/react/PluginManagerContext.stories.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAuC,MAAM,OAAO,CAAC;AAqK5D,QAAA,MAAM,IAAI;;;;;;;CAOM,CAAC;AAEjB,eAAe,IAAI,CAAC;AAEpB,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAM,CAAC"}

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

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

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

@@ -1 +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"}
+{"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,aAAa,CAAC,aACoC,CAAC;AAEvF;;GAEG;AACH,eAAO,MAAM,qBAAqB,mEAAgC,CAAC"}

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

@@ -1,12 +1,14 @@
-import React from 'react';
-import { type SurfaceProps } from '../common';
-import { type PluginContext } from '../core';
+import { type NamedExoticComponent, type RefAttributes } from 'react';
+import * as Common from '../common';
+import { type CapabilityManager } from '../core';
+export type SurfaceContext = Pick<Common.SurfaceProps, 'id' | 'role' | 'data'>;
+export declare const useSurface: () => SurfaceContext;
 /**
- * @returns `true` if there is a contributed surface which matches the specified role & data, `false` otherwise.
+ * A surface is a named region of the screen that can be populated by plugins.
  */
-export declare const isSurfaceAvailable: (context: PluginContext, { role, data }: Pick<SurfaceProps, "role" | "data">) => boolean;
+export declare const Surface: NamedExoticComponent<Common.SurfaceProps & RefAttributes<HTMLElement>>;
 /**
- * A surface is a named region of the screen that can be populated by plugins.
+ * @returns `true` if there is a contributed surface which matches the specified role & data, `false` otherwise.
  */
-export declare const Surface: React.MemoExoticComponent<React.ForwardRefExoticComponent<Omit<SurfaceProps, "ref"> & React.RefAttributes<HTMLElement>>>;
+export declare const isSurfaceAvailable: (capabilityManager: CapabilityManager.CapabilityManager, { role, data }: Pick<Common.SurfaceProps, "role" | "data">) => boolean;
 //# sourceMappingURL=Surface.d.ts.map