@dxos/plugin-testing 0.8.4-main.9be5663bfe → 0.8.4-main.abd8ff62ef

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-testing",
-  "version": "0.8.4-main.9be5663bfe",
+  "version": "0.8.4-main.abd8ff62ef",
   "description": "Plugin testing utils",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -13,6 +13,7 @@
   "sideEffects": true,
   "type": "module",
   "imports": {
+    "#plugin": "./src/StorybookPlugin.ts",
     "#capabilities": "./src/capabilities/index.ts",
     "#components": "./src/components/index.ts",
     "#meta": "./src/meta.ts",
@@ -24,6 +25,12 @@
       "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs"
+    },
+    "./harness": {
+      "source": "./src/harness.ts",
+      "types": "./dist/types/src/harness.d.ts",
+      "browser": "./dist/lib/browser/harness.mjs",
+      "node": "./dist/lib/node-esm/harness.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -34,15 +41,15 @@
   "dependencies": {
     "@effect-atom/atom": "^0.5.1",
     "@effect-atom/atom-react": "^0.5.0",
-    "@dxos/app-framework": "0.8.4-main.9be5663bfe",
-    "@dxos/app-toolkit": "0.8.4-main.9be5663bfe",
-    "@dxos/operation": "0.8.4-main.9be5663bfe",
-    "@dxos/plugin-settings": "0.8.4-main.9be5663bfe",
-    "@dxos/plugin-graph": "0.8.4-main.9be5663bfe",
-    "@dxos/plugin-theme": "0.8.4-main.9be5663bfe",
-    "@dxos/util": "0.8.4-main.9be5663bfe",
-    "@dxos/react-ui-mosaic": "0.8.4-main.9be5663bfe",
-    "@dxos/plugin-attention": "0.8.4-main.9be5663bfe"
+    "@dxos/app-framework": "0.8.4-main.abd8ff62ef",
+    "@dxos/app-toolkit": "0.8.4-main.abd8ff62ef",
+    "@dxos/compute": "0.8.4-main.abd8ff62ef",
+    "@dxos/plugin-attention": "0.8.4-main.abd8ff62ef",
+    "@dxos/plugin-graph": "0.8.4-main.abd8ff62ef",
+    "@dxos/plugin-settings": "0.8.4-main.abd8ff62ef",
+    "@dxos/plugin-theme": "0.8.4-main.abd8ff62ef",
+    "@dxos/util": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-ui-mosaic": "0.8.4-main.abd8ff62ef"
   },
   "devDependencies": {
     "@types/react": "~19.2.7",
@@ -50,16 +57,16 @@
     "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "^7.1.11",
-    "@dxos/react-ui": "0.8.4-main.9be5663bfe",
-    "@dxos/ui-theme": "0.8.4-main.9be5663bfe"
+    "vite": "^8.0.10",
+    "@dxos/react-ui": "0.8.4-main.abd8ff62ef",
+    "@dxos/ui-theme": "0.8.4-main.abd8ff62ef"
   },
   "peerDependencies": {
     "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.8.4-main.9be5663bfe",
-    "@dxos/ui-theme": "0.8.4-main.9be5663bfe"
+    "@dxos/react-ui": "0.8.4-main.abd8ff62ef",
+    "@dxos/ui-theme": "0.8.4-main.abd8ff62ef"
   },
   "publishConfig": {
     "access": "public"

package/src/StorybookPlugin.ts

@@ -32,8 +32,10 @@ export const StorybookPlugin = Plugin.define<StorybookPluginOptions>(meta).pipe(
   Plugin.addModule(({ initialState }) => ({
     id: Capability.getModuleTag(State),
     activatesOn: ActivationEvents.Startup,
-    activatesAfter: [AppActivationEvents.LayoutReady],
+    firesAfterActivation: [AppActivationEvents.LayoutReady],
     activate: () => State({ initialState }),
   })),
   Plugin.make,
 );
+
+export default StorybookPlugin;

package/src/capabilities/index.ts

@@ -3,7 +3,7 @@
 //
 
 import { Capability } from '@dxos/app-framework';
-import { OperationHandlerSet } from '@dxos/operation';
+import { OperationHandlerSet } from '@dxos/compute';
 
 export const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(
   'OperationHandler',

package/src/capabilities/operation-handler.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
-import type { OperationHandlerSet } from '@dxos/operation';
+import type { OperationHandlerSet } from '@dxos/compute';
 
 import { TestingOperationHandlerSet } from '#operations';
 

package/src/components/Layout/Layout.tsx

@@ -7,6 +7,7 @@ import React, { type PropsWithChildren, useCallback, useContext, useEffect, useR
 
 import { Surface, useCapability } from '@dxos/app-framework/ui';
 import { type LayoutOperation } from '@dxos/app-toolkit';
+import { AppSurface } from '@dxos/app-toolkit/ui';
 import {
   AlertDialog,
   Button,
@@ -153,7 +154,7 @@ export const Layout = ({ children }: PropsWithChildren<{}>) => {
             >
               {layout.dialogBlockAlign === 'end' ? (
                 <Surface.Surface
-                  role='dialog'
+                  type={AppSurface.Dialog}
                   data={layout.dialogContent}
                   limit={1}
                   fallback={ErrorFallback}
@@ -165,7 +166,12 @@ export const Layout = ({ children }: PropsWithChildren<{}>) => {
                   classNames={layout.dialogOverlayClasses}
                   style={layout.dialogOverlayStyle}
                 >
-                  <Surface.Surface role='dialog' data={layout.dialogContent} limit={1} fallback={ErrorFallback} />
+                  <Surface.Surface
+                    type={AppSurface.Dialog}
+                    data={layout.dialogContent}
+                    limit={1}
+                    fallback={ErrorFallback}
+                  />
                 </DialogOverlay>
               )}
             </DialogRoot>
@@ -192,11 +198,11 @@ export const Layout = ({ children }: PropsWithChildren<{}>) => {
                         )}
                         <Card.CloseIconButton onClick={handleClose} />
                       </Card.Toolbar>
-                      <Surface.Surface role='card--content' data={layout.popoverContent} limit={1} />
+                      <Surface.Surface type={AppSurface.Card} data={layout.popoverContent} limit={1} />
                     </Card.Root>
                   )}
                   {layout.popoverKind === 'base' && (
-                    <Surface.Surface role='popover' data={layout.popoverContent} limit={1} />
+                    <Surface.Surface type={AppSurface.Popover} data={layout.popoverContent} limit={1} />
                   )}
                 </Popover.Viewport>
                 <Popover.Arrow />

package/src/harness.ts

@@ -0,0 +1,52 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { OperationPlugin, type Plugin, RuntimePlugin } from '@dxos/app-framework';
+import { createTestApp, type TestAppOptions, type TestHarness } from '@dxos/app-framework/testing';
+import { AttentionPlugin } from '@dxos/plugin-attention';
+import { GraphPlugin } from '@dxos/plugin-graph';
+import { SettingsPlugin } from '@dxos/plugin-settings';
+
+export type ComposerTestAppOptions = Omit<TestAppOptions, 'plugins'> & {
+  /** Plugins to register in addition to the Composer core plugins. */
+  plugins?: Plugin.Plugin[];
+  /**
+   * Whether to include `ThemePlugin` in the core plugin set.
+   * Defaults to `false` — `ThemePlugin` requires a browser DOM and breaks Node-only tests.
+   * Set to `true` (with jsdom/happy-dom) when rendering React surfaces.
+   */
+  theme?: boolean;
+};
+
+/**
+ * Headless core plugins for the test harness — the subset of `corePlugins()`
+ * that can be activated without a browser DOM.
+ */
+const headlessCorePlugins = (): Plugin.Plugin[] => [
+  AttentionPlugin(),
+  GraphPlugin(),
+  OperationPlugin(),
+  RuntimePlugin(),
+  SettingsPlugin(),
+];
+
+/**
+ * Creates a TestHarness pre-loaded with the Composer core plugins
+ * (Attention, Graph, Operation, Runtime, Settings, optionally Theme).
+ *
+ * For a ClientPlugin-backed harness, pass `ClientPlugin({ ... })` via `plugins`.
+ */
+export const createComposerTestApp = async (opts: ComposerTestAppOptions = {}): Promise<TestHarness> => {
+  const { plugins = [], theme = false, ...rest } = opts;
+  const core = headlessCorePlugins();
+  if (theme) {
+    const { ThemePlugin } = await import('@dxos/plugin-theme');
+    const { defaultTx } = await import('@dxos/ui-theme');
+    core.push(ThemePlugin({ tx: defaultTx }));
+  }
+  return createTestApp({
+    ...rest,
+    plugins: [...core, ...plugins],
+  });
+};

package/src/index.ts

@@ -2,7 +2,12 @@
 // Copyright 2023 DXOS.org
 //
 
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from './meta';
+
 export * from './core';
 export * from './meta';
 
-export * from './StorybookPlugin';
+export const StorybookPlugin = Plugin.lazy(meta, () => import('#plugin'));
+export type { StorybookPluginOptions } from '#plugin';

package/src/operations/add-toast.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 import { updateState } from './update-state';
 

package/src/operations/close.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 const handler: Operation.WithHandler<typeof LayoutOperation.Close> = LayoutOperation.Close.pipe(
   Operation.withHandler(() => Effect.void),

package/src/operations/index.ts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import { OperationHandlerSet } from '@dxos/operation';
+import { OperationHandlerSet } from '@dxos/compute';
 
 export const TestingOperationHandlerSet = OperationHandlerSet.lazy(
   () => import('./add-toast'),

package/src/operations/open.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 const handler: Operation.WithHandler<typeof LayoutOperation.Open> = LayoutOperation.Open.pipe(
   Operation.withHandler(

package/src/operations/scroll-into-view.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 const handler: Operation.WithHandler<typeof LayoutOperation.ScrollIntoView> = LayoutOperation.ScrollIntoView.pipe(
   Operation.withHandler(() => Effect.void),

package/src/operations/set-layout-mode.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 const handler: Operation.WithHandler<typeof LayoutOperation.SetLayoutMode> = LayoutOperation.SetLayoutMode.pipe(
   Operation.withHandler(() => Effect.void),

package/src/operations/switch-workspace.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 import { updateState } from './update-state';
 

package/src/operations/update-complementary.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 import { updateState } from './update-state';
 

package/src/operations/update-dialog.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 import { updateState } from './update-state';
 

package/src/operations/update-popover.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 import { type LayoutStateProps } from '../types';
 import { updateState } from './update-state';

package/src/operations/update-sidebar.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 import { updateState } from './update-state';