@dxos/app-framework 0.8.4-main.a4bbb77 → 0.8.4-main.abd8ff62ef

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,IAIzB,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,IAIzB,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

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../../../src/testing/harness.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAMxD,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAK/C,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/G,MAAM,MAAM,cAAc,GAAG;IAC3B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACzB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sEAAsE;IACtE,WAAW,CAAC,EAAE,eAAe,CAAC,eAAe,EAAE,CAAC;IAChD;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC,iBAAiB,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAErC,yEAAyE;IACzE,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,sEAAsE;IACtE,KAAK,CAAC,KAAK,EAAE,eAAe,CAAC,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzE,oGAAoG;IACpG,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,oEAAoE;IACpE,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAClD,kFAAkF;IAClF,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjG,4DAA4D;IAC5D,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,eAAe,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1G,mFAAmF;IACnF,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7G,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC,gDAAgD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,6EAA6E;IAC7E,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAID;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,SAAgB,cAAc,KAAG,OAAO,CAAC,WAAW,CAgD7E,CAAC"}

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

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

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

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

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

@@ -0,0 +1,27 @@
+import { type RenderOptions, type RenderResult } from '@testing-library/react';
+import { type FC, type PropsWithChildren, type ReactNode } from 'react';
+import { type TestHarness } from './harness';
+export type HarnessRenderOptions = Omit<RenderOptions, 'wrapper'> & {
+    /** Additional providers to wrap around the harness tree (applied innermost first). */
+    reactContexts?: FC<PropsWithChildren>[];
+};
+/**
+ * Renders `ui` wrapped in the same provider tree as `useApp` plus every contributed
+ * `Capabilities.ReactContext`.
+ */
+export declare const render: (harness: TestHarness, ui: ReactNode, options?: HarnessRenderOptions) => RenderResult;
+export type RenderSurfaceProps = {
+    role: string;
+    data?: unknown;
+    limit?: number;
+    fallback?: FC<{
+        error: Error;
+        data?: any;
+    }>;
+    placeholder?: ReactNode;
+};
+/**
+ * Renders a `Surface` with the given role/data inside the harness provider tree.
+ */
+export declare const renderSurface: (harness: TestHarness, props: RenderSurfaceProps, options?: HarnessRenderOptions) => RenderResult;
+//# sourceMappingURL=react.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../../src/testing/react.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACpG,OAAc,EAAE,KAAK,EAAE,EAAY,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AASzF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG;IAClE,sFAAsF;IACtF,aAAa,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;CACzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,MAAM,YAAa,WAAW,MAAM,SAAS,YAAY,oBAAoB,KAAG,YAQ5F,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,EAAE,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,YACf,WAAW,SACb,kBAAkB,YACf,oBAAoB,KAC7B,YAOF,CAAC"}

package/dist/types/src/testing/react.test.d.ts

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

package/dist/types/src/testing/react.test.d.ts.map

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

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

@@ -0,0 +1,8 @@
+import * as Layer from 'effect/Layer';
+import { Plugin } from '../core';
+/**
+ * Creates a Plugin.Service layer from a list of plugins.
+ * This is primarily used for testing.
+ */
+export declare const fromPlugins: (plugins: Plugin.Plugin[]) => Layer.Layer<Plugin.Service, Error, never>;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/testing/service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAKtC,OAAO,EAAE,MAAM,EAAiB,MAAM,SAAS,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,WAAW,YAAa,MAAM,CAAC,MAAM,EAAE,8CAmCjD,CAAC"}

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

@@ -1,16 +1,17 @@
-import { type Decorator } from '@storybook/react';
+import { type Decorator, type StoryContext } from '@storybook/react';
 import { type MaybeProvider } from '@dxos/util';
-import { type UseAppOptions } from '../components';
-import { type ActivationEvent, type AnyCapability, type PluginContext } from '../core';
+import { type ActivationEvent, Capability, type CapabilityManager } from '../core';
+import { type UseAppOptions } from '../ui';
 export type WithPluginManagerOptions = UseAppOptions & {
     /** @deprecated */
-    capabilities?: MaybeProvider<AnyCapability[], PluginContext>;
+    capabilities?: MaybeProvider<Capability.Any[], CapabilityManager.CapabilityManager>;
     /** @deprecated */
-    fireEvents?: (ActivationEvent | string)[];
+    fireEvents?: (ActivationEvent.ActivationEvent | string)[];
 };
+export type WithPluginManagerInitializer<Args = void> = WithPluginManagerOptions | ((context: StoryContext<Args>) => WithPluginManagerOptions);
 /**
  * Wraps a story with a plugin manager.
  * NOTE: This builds up and tears down the plugin manager on every render.
  */
-export declare const withPluginManager: (options?: WithPluginManagerOptions) => Decorator;
+export declare const withPluginManager: <Args>(init?: WithPluginManagerInitializer<Args>) => Decorator;
 //# sourceMappingURL=withPluginManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"withPluginManager.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,eAAe,CAAC;AAC3D,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAKnB,MAAM,SAAS,CAAC;AA+BjB,MAAM,MAAM,wBAAwB,GAAG,aAAa,GAAG;IACrD,kBAAkB;IAClB,YAAY,CAAC,EAAE,aAAa,CAAC,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC;IAC7D,kBAAkB;IAClB,UAAU,CAAC,EAAE,CAAC,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAS,wBAA6B,KAAG,SA+B1E,CAAC"}
+{"version":3,"file":"withPluginManager.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrE,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,KAAK,eAAe,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAyB,MAAM,SAAS,CAAC;AAC1G,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,OAAO,CAAC;AAsCnD,MAAM,MAAM,wBAAwB,GAAG,aAAa,GAAG;IACrD,kBAAkB;IAClB,YAAY,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IACpF,kBAAkB;IAClB,UAAU,CAAC,EAAE,CAAC,eAAe,CAAC,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,4BAA4B,CAAC,IAAI,GAAG,IAAI,IAChD,wBAAwB,GACxB,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,wBAAwB,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,IAAI,SAAS,4BAA4B,CAAC,IAAI,CAAC,KAAQ,SAuCxF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"withPluginManager.stories.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAoB1B,QAAA,MAAM,IAAI;;;;CAkB2B,CAAC;AAEtC,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC"}
+{"version":3,"file":"withPluginManager.stories.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAmB1B,QAAA,MAAM,IAAI;;;;CAkB2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC"}

package/dist/types/src/ui/components/App/App.d.ts

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

package/dist/types/src/ui/components/App/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/App/App.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA4C,MAAM,OAAO,CAAC;AAIjE,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,aAAa,EAA+B,MAAM,aAAa,CAAC;AAElH,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,UAAU,CAAC,GAAG;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAIF,eAAO,MAAM,GAAG,mEAAoE,QAAQ,6BAgD3F,CAAC"}

package/dist/types/src/ui/components/App/App.stories.d.ts

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

package/dist/types/src/ui/components/App/App.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/App/App.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAoB,MAAM,OAAO,CAAC;AAKzC,OAAO,EAAc,MAAM,EAAE,MAAM,eAAe,CAAC;AAuCnD,KAAK,iBAAiB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;CAAE,CAAC;AAkBvD,QAAA,MAAM,IAAI;;0BAhByB,iBAAiB;;;QAqBhD,MAAM;;CAEM,CAAC;eAEF,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAIvB,CAAC"}

package/dist/types/src/ui/components/App/index.d.ts

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

package/dist/types/src/ui/components/App/index.d.ts.map

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

package/dist/types/src/ui/components/Placeholder/Placeholder.d.ts

@@ -0,0 +1,64 @@
+import React, { type ReactNode } from 'react';
+import { type PlaceholderProps as PlaceholderSlotProps } from '../../hooks';
+declare global {
+    interface Window {
+        /**
+         * Driver injected by `@dxos/app-framework/vite-plugin`'s `bootLoaderPlugin`.
+         * Declared here so the {@link Placeholder} can dismiss the native-DOM
+         * loader once the React placeholder commits without each host having to
+         * re-declare the type.
+         */
+        __bootLoader?: {
+            status: (payload: {
+                event?: string;
+                module?: string;
+                humanized: string;
+                /**
+                 * Optional `(index/total)` tick. When present, the loader replaces the
+                 * current line in place ("Loading plugins (12/80)") instead of
+                 * appending a new entry — keeps the visible log compact during long
+                 * counted phases like plugin chunk-loading or module activation.
+                 */
+                range?: {
+                    index: number;
+                    total: number;
+                };
+            }) => void;
+            progress: (fraction?: number) => void;
+            dismiss: () => void;
+        };
+    }
+}
+export type PlaceholderComponentProps = PlaceholderSlotProps & {
+    /**
+     * Brand mark rendered while the React tree settles. Pass either a static
+     * `ReactNode` (the framework wraps it in a sizing/animation div) or a
+     * render function that receives the precomputed `className` so the host
+     * can apply it directly to its logo (e.g. an SVG that accepts `className`
+     * — `composer-app` passes `(p) => <Composer {...p} />` from `@dxos/brand`).
+     */
+    logo?: ReactNode | ((props: {
+        className: string;
+    }) => ReactNode);
+};
+/**
+ * React placeholder. The native-DOM boot loader is the visible UI through
+ * stages 0 (Loading) and 1 (FadeIn): we render `null` until `stage >= 2`
+ * (FadeOut) and instead feed activation progress + status into the still-
+ * alive boot loader. At stage 2 the loader dismisses and the React mark
+ * appears for the cross-fade to the real shell:
+ *
+ *   - composer-app fills `0 → 50%` from `getPlugins`'s per-chunk counter.
+ *   - this component fills `50 → 100%` from `useApp`'s
+ *     `startupProgress.progress` (`activated / total` modules) and pushes
+ *     the per-module status text to the loader's status line.
+ *   - at `stage >= 2` the boot loader is dismissed and the React mark
+ *     starts its `FadeOut → Done` shrink-and-fade.
+ *
+ * Stage progression (driven by `useApp`):
+ *   - `0` — Loading: native-DOM boot loader visible. Placeholder renders nothing.
+ *   - `1` — FadeIn: same — boot loader still owns the screen.
+ *   - `2` — FadeOut: boot loader dismissed, React mark visible at full opacity then shrinks.
+ */
+export declare const Placeholder: ({ stage, progress, logo }: PlaceholderComponentProps) => React.JSX.Element | null;
+//# sourceMappingURL=Placeholder.d.ts.map

package/dist/types/src/ui/components/Placeholder/Placeholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Placeholder.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Placeholder/Placeholder.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAsC,MAAM,OAAO,CAAC;AAKlF,OAAO,EAAE,KAAK,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE5E,OAAO,CAAC,MAAM,CAAC,CAAC;IACd,UAAU,MAAM;QACd;;;;;WAKG;QACH,YAAY,CAAC,EAAE;YACb,MAAM,EAAE,CAAC,OAAO,EAAE;gBAChB,KAAK,CAAC,EAAE,MAAM,CAAC;gBACf,MAAM,CAAC,EAAE,MAAM,CAAC;gBAChB,SAAS,EAAE,MAAM,CAAC;gBAClB;;;;;mBAKG;gBACH,KAAK,CAAC,EAAE;oBAAE,KAAK,EAAE,MAAM,CAAC;oBAAC,KAAK,EAAE,MAAM,CAAA;iBAAE,CAAC;aAC1C,KAAK,IAAI,CAAC;YACX,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;YACtC,OAAO,EAAE,MAAM,IAAI,CAAC;SACrB,CAAC;KACH;CACF;AAED,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,GAAG;IAC7D;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAC,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,8BAAmC,yBAAyB,6BAsFnF,CAAC"}

package/dist/types/src/ui/components/Placeholder/Placeholder.stories.d.ts

@@ -0,0 +1,19 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+/**
+ * The story renders the brand-agnostic `Placeholder` from `@dxos/app-framework/ui`
+ * with the Composer brand icon as its `logo`, so the storybook mirrors what
+ * composer-app actually mounts in production. The render function form lets
+ * the SVG accept the placeholder's animation `className` directly.
+ */
+declare const meta: {
+    title: string;
+    component: ({ stage, progress, logo }: import("./Placeholder").PlaceholderComponentProps) => React.JSX.Element | null;
+    render: () => React.JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+    tags: string[];
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+//# sourceMappingURL=Placeholder.stories.d.ts.map

package/dist/types/src/ui/components/Placeholder/Placeholder.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Placeholder.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Placeholder/Placeholder.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA8B,MAAM,OAAO,CAAC;AASnD;;;;;GAKG;AACH,QAAA,MAAM,IAAI;;;;;;CAwC0B,CAAC;eAEtB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAUrB,CAAC"}

package/dist/types/src/ui/components/Placeholder/index.d.ts

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

package/dist/types/src/ui/components/Placeholder/index.d.ts.map

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

package/dist/types/src/{playground/playground.stories.d.ts → ui/components/PluginManager/PluginManagerContext.stories.d.ts}

@@ -4,8 +4,10 @@ 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 Playground: Story;
-//# sourceMappingURL=playground.stories.d.ts.map
+export declare const Default: StoryObj<typeof meta>;
+//# sourceMappingURL=PluginManagerContext.stories.d.ts.map