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

package/dist/types/src/core/url-loader.d.ts

@@ -0,0 +1,127 @@
+import * as Effect from 'effect/Effect';
+import { BaseError } from '@dxos/errors';
+import * as Plugin from './plugin';
+import * as PluginAssetCache from './plugin-asset-cache';
+declare const RemotePluginLoadError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "RemotePluginLoadError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "RemotePluginLoadError";
+    };
+    isError(error: unknown): error is Error;
+    name: "RemotePluginLoadError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "RemotePluginLoadError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "RemotePluginLoadError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * Tagged error for any failure during remote plugin loading. Construction sites
+ * set `context.locator` and `context.reason` (one of `'invalid-locator' |
+ * 'manifest-error' | 'cache-error' | 'import-failed' | 'meta-missing' |
+ * 'meta-mismatch' | 'duplicate-id'`) so handlers can route on the failure mode.
+ */
+export declare class RemotePluginLoadError extends RemotePluginLoadError_base {
+}
+/**
+ * Abstraction over key-value storage (defaults to localStorage).
+ */
+export type Storage = {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+};
+/**
+ * Options for configuring the URL loader.
+ */
+export type Options = {
+    storage?: Storage;
+    key?: string;
+    /**
+     * Per-platform offline asset cache. Defaults to a no-op cache (no offline support).
+     */
+    cache?: PluginAssetCache.Cache;
+};
+/**
+ * Options for the preload entry point. Adds an optional progress hook so hosts
+ * can drive a boot-loader counter (`Loading plugins (3/12)…`) as remote plugin
+ * manifests resolve. Resolution order is *not* deterministic — each entry races
+ * its own network fetch — so callers should treat `loaded` as a count, not an
+ * index. Failures are still swallowed; `loaded` advances on both success and
+ * recoverable failure so the counter always reaches `total`.
+ */
+export type PreloadOptions = Options & {
+    onPluginLoaded?: (loaded: number, total: number) => void;
+};
+/**
+ * Persisted record of a remote plugin that has been loaded previously.
+ *
+ * `url` is the URL of the plugin manifest (`plugin.json`), not the entry module.
+ */
+export type RemotePluginEntry = {
+    id: string;
+    url: string;
+    /** Installed version string, e.g. `v1.0.0`. Populated after install from a community catalog entry. */
+    version?: string;
+};
+/**
+ * Returns true when the URL's hostname is the local host (localhost, 127.0.0.1, or ::1).
+ */
+export declare const isLocalUrl: (locator: string) => boolean;
+/**
+ * Returns the list of remote plugin entries previously persisted by {@link make}.
+ * Useful for UI code that needs to know which loaded plugins were installed from a URL
+ * (e.g. to surface a tag on remote or localhost-hosted plugins).
+ */
+export declare const getRemoteEntries: (options?: Options) => readonly RemotePluginEntry[];
+/**
+ * Updates the persisted installed version for an already-stored remote plugin entry.
+ * Does nothing if the plugin has not been persisted yet.
+ */
+export declare const setInstalledVersion: (id: string, version: string, options?: Options) => void;
+/**
+ * Returns the installed version string for the given plugin id, or `undefined` if
+ * the plugin was installed without version tracking (legacy install) or is not found.
+ */
+export declare const getInstalledVersion: (id: string, options?: Options) => string | undefined;
+/**
+ * Preloads previously persisted remote plugins from storage. Per-entry failures
+ * are logged and swallowed — the returned effect always succeeds with whichever
+ * plugins loaded cleanly, so a single bad entry can't block the host's startup.
+ */
+export declare const preload: (options?: PreloadOptions) => Effect.Effect<Plugin.Plugin[], never>;
+/**
+ * Creates a plugin loader that resolves built-in plugins by ID or loads remote plugins from URLs.
+ *
+ * Remote URLs must point at a plugin manifest (`plugin.json`). The loader fetches the manifest,
+ * eagerly persists every declared asset via the configured `PluginAssetCache`, then dynamic-imports
+ * the entry module.
+ */
+export declare const make: (builtinPlugins: Plugin.Plugin[], options?: Options) => (locator: string) => Effect.Effect<{
+    plugin: Plugin.Plugin;
+    dev?: boolean;
+}, RemotePluginLoadError>;
+/**
+ * Removes a previously installed remote plugin: drops the persisted entry, evicts cached
+ * assets, and removes any stylesheet `<link>` tags that {@link loadFromManifest} appended.
+ *
+ * Cache eviction failures are logged and swallowed — the persisted entry has already been
+ * dropped so the user-visible state is consistent regardless of whether the platform
+ * cache cooperated.
+ */
+export declare const uninstall: (pluginId: string, options?: Options) => Effect.Effect<void, never>;
+export {};
+//# sourceMappingURL=url-loader.d.ts.map

package/dist/types/src/core/url-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-loader.d.ts","sourceRoot":"","sources":["../../../../src/core/url-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,gBAAgB,MAAM,sBAAsB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKzD;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,0BAAyE;CAAG;AAEvH;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC;CAChC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG;IACrC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,uGAAuG;IACvG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAkDF;;GAEG;AACH,eAAO,MAAM,UAAU,YAAa,MAAM,KAAG,OAQ5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAAa,OAAO,KAAQ,SAAS,iBAAiB,EAIlF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,OAAQ,MAAM,WAAW,MAAM,YAAW,OAAO,KAAQ,IAcxF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,OAAQ,MAAM,YAAW,OAAO,KAAQ,MAAM,GAAG,SAIhF,CAAC;AA2GF;;;;GAIG;AACH,eAAO,MAAM,OAAO,aAAa,cAAc,KAAQ,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,CA2CvF,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,mBAAoB,MAAM,CAAC,MAAM,EAAE,YAAW,OAAO,eAKnD,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,qBAAqB,CA0BxG,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,aAAc,MAAM,YAAW,OAAO,KAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAczF,CAAC"}

package/dist/types/src/core/url-loader.test.d.ts

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

package/dist/types/src/core/url-loader.test.d.ts.map

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

package/dist/types/src/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/helpers.ts"],"names":[],"mappings":"AAIA,KAAK,cAAc,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,cAAc,EAAE,OAAO,CAAC,EAAE,KAAG,CAAC,EA+BvE,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/helpers.ts"],"names":[],"mappings":"AAIA,KAAK,cAAc,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,cAAc,SAAS,CAAC,EAAE,KAAG,CAAC,EA+BvE,CAAC"}

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

@@ -1,7 +1,6 @@
-export * from './App';
 export * from './common';
+export * from './context';
 export * from './core';
-export * from './plugin-intent';
-export * from './plugin-settings';
-export * from './react';
+export * from './plugin-operation';
+export * from './plugin-runtime';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,7 @@
+import * as Effect from 'effect/Effect';
+import { Capability } from '../../core';
+import * as HistoryTracker from './history-tracker';
+import * as UndoRegistry from './undo-registry';
+declare const _default: (props: void) => Effect.Effect<[Capability.Capability<Capability.InterfaceDef<UndoRegistry.UndoRegistry>>, Capability.Capability<Capability.InterfaceDef<HistoryTracker.HistoryTracker>>], Error, Capability.Service>;
+export default _default;
+//# sourceMappingURL=capability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-operation/history/capability.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,32 @@
+import { BaseError } from '@dxos/errors';
+declare const EmptyHistoryError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "EmptyHistoryError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "EmptyHistoryError";
+    };
+    isError(error: unknown): error is Error;
+    name: "EmptyHistoryError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "EmptyHistoryError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "EmptyHistoryError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare class EmptyHistoryError extends EmptyHistoryError_base {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-operation/history/errors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEzC,qBAAa,iBAAkB,SAAQ,sBAAuE;CAAG"}

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

@@ -0,0 +1,18 @@
+import * as Effect from 'effect/Effect';
+import { OperationInvoker } from '@dxos/operation';
+import type { UndoRegistry } from './undo-registry';
+/**
+ * HistoryTracker interface - tracks operation history and provides undo.
+ */
+export interface HistoryTracker {
+    undo: () => Effect.Effect<void, Error>;
+    undoPromise: () => Promise<{
+        error?: Error;
+    }>;
+    canUndo: () => boolean;
+}
+/**
+ * Creates a HistoryTracker that subscribes to invocation events and provides undo.
+ */
+export declare const make: (invoker: OperationInvoker.OperationInvokerInternal, undoRegistry: UndoRegistry) => HistoryTracker;
+//# sourceMappingURL=history-tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history-tracker.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-operation/history/history-tracker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvC,WAAW,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,OAAO,CAAC;CACxB;AAMD;;GAEG;AACH,eAAO,MAAM,IAAI,YACN,gBAAgB,CAAC,wBAAwB,gBACpC,YAAY,KACzB,cAqFF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,6 @@
+export * from './errors';
+export * from './types';
+export * as UndoMapping from './undo-mapping';
+export * as UndoRegistry from './undo-registry';
+export * as HistoryTracker from './history-tracker';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-operation/history/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { Operation } from '@dxos/compute';
+/**
+ * History entry stored by HistoryTracker.
+ */
+export type HistoryEntry = {
+    operation: Operation.Definition<any, any>;
+    input: any;
+    output: any;
+    inverse: Operation.Definition<any, any>;
+    inverseInput: any;
+    timestamp: number;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-operation/history/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1C,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxC,YAAY,EAAE,GAAG,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC"}

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

@@ -0,0 +1,101 @@
+import type { Operation } from '@dxos/compute';
+/**
+ * Label type for translatable text (canonical definition in @dxos/app-toolkit).
+ */
+type Label = string | [string, {
+    ns: string;
+    count?: number;
+    defaultValue?: string;
+}];
+/**
+ * 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: '@dxos/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: '@dxos/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;
+export {};
+//# 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":"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"}

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

@@ -0,0 +1,23 @@
+import type { Operation } from '@dxos/compute';
+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,eAAe,CAAC;AAE/C,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,gBAAiB,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) => Effect.Effect<Capability.Capability<Capability.InterfaceDef<OperationInvoker.OperationInvoker>>, Error, Plugin.Service | Capability.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;AAGxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC"}

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,IAKzB,CAAC"}

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

@@ -0,0 +1,59 @@
+import * as Effect from 'effect/Effect';
+import { Operation } from '@dxos/compute';
+import { OperationInvoker } from '@dxos/operation';
+export declare const Compute: Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly value: number;
+}, never>;
+export declare const HalveCompute: Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly value: number;
+}, never>;
+export declare const ToString: Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly string: string;
+}, never>;
+export declare const Add: Operation.Definition<readonly [number, number], number, never>;
+export declare const SideEffect: Operation.Definition<void, void, never>;
+export declare const computeHandler: Operation.WithHandler<Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly value: number;
+}, never>>;
+export declare const halveComputeHandler: Operation.WithHandler<Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly value: number;
+}, never>>;
+export declare const toStringHandler: Operation.WithHandler<Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly string: string;
+}, never>>;
+export declare const addHandler: Operation.WithHandler<Operation.Definition<readonly [number, number], number, never>>;
+export declare const sideEffectHandler: Operation.WithHandler<Operation.Definition<void, void, never>>;
+/**
+ * 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;AAMxC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMnD,eAAO,MAAM,OAAO;;;;SAIlB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;SAIvB,CAAC;AAEH,eAAO,MAAM,QAAQ;;;;SAInB,CAAC;AAEH,eAAO,MAAM,GAAG,gEAId,CAAC;AAEH,eAAO,MAAM,UAAU,yCAIrB,CAAC;AAMH,eAAO,MAAM,cAAc;;;;UAK1B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;UAE/B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;UAE3B,CAAC;AAEF,eAAO,MAAM,UAAU,uFAA0E,CAAC;AAElG,eAAO,MAAM,iBAAiB,gEAAqE,CAAC;AAMpG;;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,YAAa,gBAAgB,CAAC,gBAAgB,KAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAoD1G,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,SAAS,cAAe,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;AAK7C,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 { Capabilities } from '../common';
+import { Capability, Plugin } from '../core';
+declare const _default: (props: void) => Effect.Effect<Capability.Capability<Capability.InterfaceDef<Capabilities.ManagedRuntime>>, Error, Plugin.Service | Capability.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,EAAoB,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC"}

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,IAKzB,CAAC"}

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

@@ -0,0 +1,67 @@
+import { type Registry } from '@effect-atom/atom-react';
+import { type Operation } from '@dxos/compute';
+import { ActivationEvent, type Capability, type CapabilityManager, type Plugin, PluginManager } from '../core';
+export type TestAppOptions = {
+    /** Plugins to register. */
+    plugins: Plugin.Plugin[];
+    /** Plugin ids that are always enabled. Defaults to all provided plugin ids. */
+    core?: string[];
+    /** Plugin ids that are enabled by default in addition to core. */
+    enabled?: string[];
+    /** Additional activation events fired alongside SetupReactSurface. */
+    setupEvents?: ActivationEvent.ActivationEvent[];
+    /**
+     * Whether to automatically fire SetupReactSurface + Startup during setup.
+     * Defaults to true.
+     */
+    autoStart?: boolean;
+    /**
+     * Whether to register the PluginManager + AtomRegistry framework capabilities.
+     * Defaults to true.
+     */
+    registerFrameworkCapabilities?: boolean;
+};
+/**
+ * A running plugin manager plus helpers for driving it in tests.
+ */
+export interface TestHarness {
+    readonly manager: PluginManager.PluginManager;
+    readonly capabilities: CapabilityManager.CapabilityManager;
+    readonly registry: Registry.Registry;
+    /** Activate the given event. Equivalent to `manager.activate(event)`. */
+    fire(event: ActivationEvent.ActivationEvent | string): Promise<boolean>;
+    /** Re-activate all modules that were activated by the given event. */
+    reset(event: ActivationEvent.ActivationEvent | string): Promise<boolean>;
+    /** Returns the first contributed capability for the given interface. Throws if none are present. */
+    get<T>(iface: Capability.InterfaceDef<T>): T;
+    /** Returns all contributed capabilities for the given interface. */
+    getAll<T>(iface: Capability.InterfaceDef<T>): T[];
+    /** Waits until at least one capability is contributed for the given interface. */
+    waitForCapability<T>(iface: Capability.InterfaceDef<T>, opts?: {
+        timeout?: number;
+    }): Promise<T>;
+    /** Waits until the given activation event has completed. */
+    waitForEvent(event: ActivationEvent.ActivationEvent | string, opts?: {
+        timeout?: number;
+    }): Promise<void>;
+    /** Invokes an operation through the `Capabilities.OperationInvoker` capability. */
+    invoke<I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I] : [input: I]): Promise<O>;
+    enable(id: string): Promise<boolean>;
+    disable(id: string): Promise<boolean>;
+    /** Shuts down the underlying plugin manager. */
+    dispose(): Promise<void>;
+    /** Async-disposable support so tests can use `await using harness = ...`. */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Creates a TestHarness with the same bootstrap sequence that `useApp` performs,
+ * minus the React provider tree.
+ *
+ * For Node-only tests, this is enough to fire activation events, read
+ * capabilities, and invoke operations.
+ *
+ * For React tests, pass the returned harness to `render` or `renderSurface`
+ * from `@dxos/app-framework/testing-react`.
+ */
+export declare const createTestApp: (opts: TestAppOptions) => Promise<TestHarness>;
+//# sourceMappingURL=harness.d.ts.map