@dxos/plugin-testing 0.8.4-main.7996785055 → 0.8.4-main.8baae0fced

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-testing",
-  "version": "0.8.4-main.7996785055",
+  "version": "0.8.4-main.8baae0fced",
   "description": "Plugin testing utils",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,15 +8,57 @@
     "type": "git",
     "url": "https://github.com/dxos/dxos"
   },
-  "license": "MIT",
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
+  "imports": {
+    "#capabilities": {
+      "source": "./src/capabilities/index.ts",
+      "types": "./dist/types/src/capabilities/index.d.ts",
+      "default": "./dist/lib/neutral/capabilities/index.mjs"
+    },
+    "#components": {
+      "source": "./src/components/index.ts",
+      "types": "./dist/types/src/components/index.d.ts",
+      "default": "./dist/lib/neutral/components/index.mjs"
+    },
+    "#meta": {
+      "source": "./src/meta.ts",
+      "types": "./dist/types/src/meta.d.ts",
+      "default": "./dist/lib/neutral/meta.mjs"
+    },
+    "#operations": {
+      "source": "./src/operations/index.ts",
+      "types": "./dist/types/src/operations/index.d.ts",
+      "default": "./dist/lib/neutral/operations/index.mjs"
+    },
+    "#plugin": {
+      "source": "./src/StorybookPlugin.ts",
+      "types": "./dist/types/src/StorybookPlugin.d.ts",
+      "default": "./dist/lib/neutral/StorybookPlugin.mjs"
+    },
+    "#types": {
+      "source": "./src/types/index.ts",
+      "types": "./dist/types/src/types/index.d.ts",
+      "default": "./dist/lib/neutral/types/index.mjs"
+    }
+  },
   "exports": {
     ".": {
       "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
-      "browser": "./dist/lib/browser/index.mjs"
+      "default": "./dist/lib/neutral/index.mjs"
+    },
+    "./harness": {
+      "source": "./src/harness.ts",
+      "types": "./dist/types/src/harness.d.ts",
+      "default": "./dist/lib/neutral/harness.mjs"
+    },
+    "./plugin": {
+      "source": "./src/plugin.ts",
+      "types": "./dist/types/src/plugin.d.ts",
+      "default": "./dist/lib/neutral/plugin.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -27,15 +69,16 @@
   "dependencies": {
     "@effect-atom/atom": "^0.5.1",
     "@effect-atom/atom-react": "^0.5.0",
-    "@dxos/app-framework": "0.8.4-main.7996785055",
-    "@dxos/operation": "0.8.4-main.7996785055",
-    "@dxos/plugin-attention": "0.8.4-main.7996785055",
-    "@dxos/plugin-graph": "0.8.4-main.7996785055",
-    "@dxos/plugin-settings": "0.8.4-main.7996785055",
-    "@dxos/app-toolkit": "0.8.4-main.7996785055",
-    "@dxos/plugin-theme": "0.8.4-main.7996785055",
-    "@dxos/react-ui-mosaic": "0.8.4-main.7996785055",
-    "@dxos/util": "0.8.4-main.7996785055"
+    "@dxos/app-toolkit": "0.8.4-main.8baae0fced",
+    "@dxos/log": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-attention": "0.8.4-main.8baae0fced",
+    "@dxos/compute": "0.8.4-main.8baae0fced",
+    "@dxos/app-framework": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-graph": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-theme": "0.8.4-main.8baae0fced",
+    "@dxos/util": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui-mosaic": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-settings": "0.8.4-main.8baae0fced"
   },
   "devDependencies": {
     "@types/react": "~19.2.7",
@@ -43,16 +86,16 @@
     "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "^7.1.11",
-    "@dxos/ui-theme": "0.8.4-main.7996785055",
-    "@dxos/react-ui": "0.8.4-main.7996785055"
+    "vite": "^8.0.13",
+    "@dxos/react-ui": "0.8.4-main.8baae0fced",
+    "@dxos/ui-theme": "0.8.4-main.8baae0fced"
   },
   "peerDependencies": {
     "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.8.4-main.7996785055",
-    "@dxos/ui-theme": "0.8.4-main.7996785055"
+    "@dxos/react-ui": "0.8.4-main.8baae0fced",
+    "@dxos/ui-theme": "0.8.4-main.8baae0fced"
   },
   "publishConfig": {
     "access": "public"

package/src/StorybookPlugin.ts

@@ -7,13 +7,13 @@ import * as Effect from 'effect/Effect';
 import { ActivationEvents, Capabilities, Capability, Plugin } from '@dxos/app-framework';
 import { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';
 
-import { OperationHandler, State } from './capabilities';
-import { Layout } from './components';
-import { meta } from './meta';
-import { type LayoutStateProps } from './types';
+import { OperationHandler, State } from '#capabilities';
+import { Layout } from '#components';
+import { meta } from '#meta';
+import { StorybookCapabilities } from '#types';
 
 export type StorybookPluginOptions = {
-  initialState?: Partial<LayoutStateProps>;
+  initialState?: Partial<StorybookCapabilities.LayoutStateProps>;
 };
 
 export const StorybookPlugin = Plugin.define<StorybookPluginOptions>(meta).pipe(
@@ -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

@@ -2,5 +2,11 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './operation-handler';
-export * from './state';
+import { Capability } from '@dxos/app-framework';
+import { OperationHandlerSet } from '@dxos/compute';
+
+export const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(
+  'OperationHandler',
+  () => import('./operation-handler'),
+);
+export const State = Capability.lazy('State', () => import('./state'));

package/src/capabilities/{operation-handler/operation-handler.ts → operation-handler.ts}

@@ -5,9 +5,9 @@
 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';
+import { TestingOperationHandlerSet } from '#operations';
 
 export default Capability.makeModule<OperationHandlerSet.OperationHandlerSet>(
   Effect.fnUntraced(function* () {

package/src/capabilities/{state/state.tsx → state.tsx}

@@ -8,9 +8,9 @@ import * as Effect from 'effect/Effect';
 import { Capability } from '@dxos/app-framework';
 import { AppCapabilities } from '@dxos/app-toolkit';
 
-import { LayoutState, type LayoutStateProps } from '../../types';
+import { StorybookCapabilities } from '#types';
 
-const defaultState: LayoutStateProps = {
+const defaultState: StorybookCapabilities.LayoutStateProps = {
   sidebarState: 'closed',
   complementarySidebarState: 'closed',
   dialogOpen: false,
@@ -19,9 +19,9 @@ const defaultState: LayoutStateProps = {
 };
 
 export default Capability.makeModule(
-  Effect.fnUntraced(function* (props?: { initialState?: Partial<LayoutStateProps> }) {
+  Effect.fnUntraced(function* (props?: { initialState?: Partial<StorybookCapabilities.LayoutStateProps> }) {
     const { initialState } = props ?? {};
-    const stateAtom = Atom.make<LayoutStateProps>({ ...defaultState, ...initialState });
+    const stateAtom = Atom.make<StorybookCapabilities.LayoutStateProps>({ ...defaultState, ...initialState });
 
     const layoutAtom = Atom.make((get): AppCapabilities.Layout => {
       const state = get(stateAtom);
@@ -37,6 +37,9 @@ export default Capability.makeModule(
       };
     });
 
-    return [Capability.contributes(LayoutState, stateAtom), Capability.contributes(AppCapabilities.Layout, layoutAtom)];
+    return [
+      Capability.contributes(StorybookCapabilities.LayoutState, stateAtom),
+      Capability.contributes(AppCapabilities.Layout, layoutAtom),
+    ];
   }),
 );

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,
@@ -23,8 +24,8 @@ import { Card } from '@dxos/react-ui';
 import { Mosaic } from '@dxos/react-ui-mosaic';
 import { descriptionMessage, mx } from '@dxos/ui-theme';
 
-import { meta } from '../../meta';
-import { LayoutState, type LayoutStateProps } from '../../types';
+import { meta } from '#meta';
+import { StorybookCapabilities } from '#types';
 
 const debounce_delay = 100;
 
@@ -70,14 +71,14 @@ export const Layout = ({ children }: PropsWithChildren<{}>) => {
   const { t } = useTranslation(meta.id);
   const trigger = useRef<HTMLButtonElement | null>(null);
   const registry = useContext(RegistryContext);
-  const stateAtom = useCapability(LayoutState);
+  const stateAtom = useCapability(StorybookCapabilities.LayoutState);
   const layout = useAtomValue(stateAtom);
   const [iter, setIter] = useState(0);
   const [open, setOpen] = useState(false);
   const debounceRef = useRef<NodeJS.Timeout | null>(null);
 
   const updateState = useCallback(
-    (updates: Partial<LayoutStateProps>) => {
+    (updates: Partial<StorybookCapabilities.LayoutStateProps>) => {
       const current = registry.get(stateAtom);
       registry.set(stateAtom, { ...current, ...updates });
     },
@@ -134,7 +135,7 @@ export const Layout = ({ children }: PropsWithChildren<{}>) => {
 
   return (
     <Toast.Provider>
-      <div role='none' className='fixed inset-0 flex overflow-hidden'>
+      <div className='fixed inset-0 flex overflow-hidden'>
         <Mosaic.Root>
           <Popover.Root open={open}>
             <Main.Root
@@ -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 />
@@ -223,7 +229,7 @@ export const ErrorFallback = ({ error }: { error?: Error }) => {
       className={mx('overflow-auto p-8 dx-attention-surface grid place-items-center')}
     >
       <p className={mx(descriptionMessage, 'break-words rounded-md p-8', errorString.length < 256 && 'text-lg')}>
-        {error ? errorString : t('error fallback message')}
+        {error ? errorString : t('error-fallback.message')}
       </p>
     </div>
   );

package/src/core.ts

@@ -2,11 +2,24 @@
 // Copyright 2025 DXOS.org
 //
 
-import { OperationPlugin, type Plugin, RuntimePlugin } from '@dxos/app-framework';
-import { AttentionPlugin } from '@dxos/plugin-attention';
-import { GraphPlugin } from '@dxos/plugin-graph';
-import { SettingsPlugin } from '@dxos/plugin-settings';
-import { ThemePlugin } from '@dxos/plugin-theme';
+import { type Plugin, ProcessManagerPlugin } from '@dxos/app-framework';
+// `/testing` entrypoints re-export the plugin eagerly (without `Plugin.lazy`).
+// The default `.` and `/plugin` exports wrap each plugin in a lazy stub
+// (`() => import('./XPlugin')`), which webkit cannot reliably resolve under
+// vite-dev: the dynamic-import promise can settle with a partially-evaluated
+// namespace, throwing `ReferenceError: Cannot access 'default' before
+// initialization` from the loader's `mod.default` access. Storybook runs
+// inside `storybook dev` (vite-dev) and is currently the only host that hits
+// this. Production hosts (composer-app via `vite preview`) keep using the
+// lazy `.` exports and their associated code splitting.
+//
+// Use these `/testing` entrypoints from any storybook `withPluginManager`
+// setup. The single-line `export * from './XPlugin'` re-exports avoid the
+// dynamic-import path entirely — see e.g. `plugin-attention/src/testing.ts`.
+import { AttentionPlugin } from '@dxos/plugin-attention/testing';
+import { GraphPlugin } from '@dxos/plugin-graph/testing';
+import { SettingsPlugin } from '@dxos/plugin-settings/testing';
+import { ThemePlugin } from '@dxos/plugin-theme/testing';
 import { defaultTx } from '@dxos/ui-theme';
 
 /**
@@ -17,8 +30,7 @@ import { defaultTx } from '@dxos/ui-theme';
 export const corePlugins = (): Plugin.Plugin[] => [
   AttentionPlugin(),
   GraphPlugin(),
-  OperationPlugin(),
-  RuntimePlugin(),
+  ProcessManagerPlugin(),
   SettingsPlugin(),
   ThemePlugin({ tx: defaultTx }),
 ];

package/src/harness.ts

@@ -0,0 +1,51 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { type Plugin, ProcessManagerPlugin } from '@dxos/app-framework';
+import { createTestApp, type TestAppOptions, type TestHarness } from '@dxos/app-framework/testing';
+import { AttentionPlugin } from '@dxos/plugin-attention/testing';
+import { GraphPlugin } from '@dxos/plugin-graph/testing';
+import { SettingsPlugin } from '@dxos/plugin-settings/testing';
+
+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(),
+  ProcessManagerPlugin(),
+  SettingsPlugin(),
+];
+
+/**
+ * Creates a TestHarness pre-loaded with the Composer core plugins
+ * (Attention, Graph, ProcessManager, 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/testing');
+    const { defaultTx } = await import('@dxos/ui-theme');
+    core.push(ThemePlugin({ tx: defaultTx }));
+  }
+  return createTestApp({
+    ...rest,
+    plugins: [...core, ...plugins],
+  });
+};

package/src/index.ts

@@ -4,5 +4,11 @@
 
 export * from './core';
 export * from './meta';
+export * from './types';
 
+// `@dxos/plugin-testing` is a testing-only package, so `StorybookPlugin` is
+// exported eagerly from the `.` entrypoint (no `Plugin.lazy` indirection).
+// Storybook on webkit + vite-dev cannot reliably resolve the lazy form's
+// dynamic `import()` — see `./core.ts` for the underlying chunk-init issue
+// — and there is no production code-splitting benefit to recover here.
 export * from './StorybookPlugin';

package/src/meta.ts

@@ -8,6 +8,7 @@ import { trim } from '@dxos/util';
 export const meta: Plugin.Meta = {
   id: 'org.dxos.plugin.storybook-layout',
   name: 'Storybook',
+  author: 'DXOS',
   description: trim`
     Development layout optimized for Storybook component testing and documentation.
     Provides specialized views for component development and design system exploration.

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,10 +5,16 @@
 import * as Effect from 'effect/Effect';
 
 import { LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
+import { log } from '@dxos/log';
 
 const handler: Operation.WithHandler<typeof LayoutOperation.Open> = LayoutOperation.Open.pipe(
-  Operation.withHandler(() => Effect.void),
+  Operation.withHandler(
+    Effect.fnUntraced(function* (input) {
+      log('LayoutOperation.Open handler start');
+      return input.subject;
+    }),
+  ),
 );
 
 export default handler;

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,9 +5,9 @@
 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 { StorybookCapabilities } from '../types';
 import { updateState } from './update-state';
 
 const handler: Operation.WithHandler<typeof LayoutOperation.UpdatePopover> = LayoutOperation.UpdatePopover.pipe(
@@ -15,7 +15,7 @@ const handler: Operation.WithHandler<typeof LayoutOperation.UpdatePopover> = Lay
     Effect.fnUntraced(function* (input) {
       const { subject, state, side, kind, props } = input;
       yield* updateState(() => {
-        const base: Partial<LayoutStateProps> = {
+        const base: Partial<StorybookCapabilities.LayoutStateProps> = {
           popoverKind: kind ?? 'base',
           popoverTitle: kind === 'card' ? input.title : undefined,
           popoverContent:

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';
 

package/src/operations/update-state.ts

@@ -6,12 +6,14 @@ import * as Effect from 'effect/Effect';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 
-import { LayoutState, type LayoutStateProps } from '../types';
+import { StorybookCapabilities } from '../types';
 
-export const updateState = (fn: (state: LayoutStateProps) => Partial<LayoutStateProps>) =>
+export const updateState = (
+  fn: (state: StorybookCapabilities.LayoutStateProps) => Partial<StorybookCapabilities.LayoutStateProps>,
+) =>
   Effect.gen(function* () {
     const registry = yield* Capability.get(Capabilities.AtomRegistry);
-    const stateAtom = yield* Capability.get(LayoutState);
+    const stateAtom = yield* Capability.get(StorybookCapabilities.LayoutState);
     const current = registry.get(stateAtom);
     registry.set(stateAtom, { ...current, ...fn(current) });
   });

package/src/plugin.ts

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

package/src/types/{capabilities.ts → StorybookCapabilities.ts}

@@ -2,13 +2,15 @@
 // Copyright 2025 DXOS.org
 //
 
+// @import-as-namespace
+
 import { type Atom } from '@effect-atom/atom-react';
 
 import { Capability } from '@dxos/app-framework';
 import { type LayoutOperation } from '@dxos/app-toolkit';
 import { type Label } from '@dxos/react-ui';
 
-import { meta } from '../meta';
+import { meta } from '#meta';
 
 export type LayoutStateProps = {
   sidebarState?: 'expanded' | 'collapsed' | 'closed';

package/src/types/index.ts

@@ -2,4 +2,4 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './capabilities';
+export * as StorybookCapabilities from './StorybookCapabilities';

package/dist/lib/browser/add-toast-M6ZVP2PQ.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/operations/add-toast.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { LayoutOperation } from '@dxos/app-toolkit';\nimport { Operation } from '@dxos/operation';\n\nimport { updateState } from './update-state';\n\nconst handler: Operation.WithHandler<typeof LayoutOperation.AddToast> = LayoutOperation.AddToast.pipe(\n  Operation.withHandler(\n    Effect.fnUntraced(function* (input) {\n      yield* updateState((state) => ({\n        toasts: [...state.toasts, input as LayoutOperation.Toast],\n      }));\n    }),\n  ),\n);\n\nexport default handler;\n"],
-  "mappings": ";;;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,uBAAuB;AAChC,SAASC,iBAAiB;AAI1B,IAAMC,UAAkEC,gBAAgBC,SAASC,KAC/FC,UAAUC,YACDC,kBAAW,WAAWC,OAAK;AAChC,SAAOC,YAAY,CAACC,WAAW;IAC7BC,QAAQ;SAAID,MAAMC;MAAQH;;EAC5B,EAAA;AACF,CAAA,CAAA,CAAA;AAIJ,IAAA,oBAAeP;",
-  "names": ["Effect", "LayoutOperation", "Operation", "handler", "LayoutOperation", "AddToast", "pipe", "Operation", "withHandler", "fnUntraced", "input", "updateState", "state", "toasts"]
-}

package/dist/lib/browser/chunk-F2MMDTKN.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/meta.ts", "../../../src/types/capabilities.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Plugin } from '@dxos/app-framework';\nimport { trim } from '@dxos/util';\n\nexport const meta: Plugin.Meta = {\n  id: 'org.dxos.plugin.storybook-layout',\n  name: 'Storybook',\n  description: trim`\n    Development layout optimized for Storybook component testing and documentation.\n    Provides specialized views for component development and design system exploration.\n  `,\n  source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-testing',\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom } from '@effect-atom/atom-react';\n\nimport { Capability } from '@dxos/app-framework';\nimport { type LayoutOperation } from '@dxos/app-toolkit';\nimport { type Label } from '@dxos/react-ui';\n\nimport { meta } from '../meta';\n\nexport type LayoutStateProps = {\n  sidebarState?: 'expanded' | 'collapsed' | 'closed';\n  complementarySidebarState?: 'expanded' | 'collapsed' | 'closed';\n\n  dialogOpen: boolean;\n  dialogType?: 'default' | 'alert';\n  dialogBlockAlign?: 'start' | 'center' | 'end';\n  dialogOverlayClasses?: string;\n  dialogOverlayStyle?: Record<string, any>;\n  /** Data to be passed to the dialog Surface. */\n  dialogContent?: any;\n\n  popoverOpen?: boolean;\n  popoverSide?: 'top' | 'right' | 'bottom' | 'left';\n  popoverVariant?: 'virtual' | 'react';\n  popoverAnchor?: HTMLButtonElement;\n  popoverAnchorId?: string;\n  popoverKind?: 'base' | 'card';\n  popoverTitle?: Label;\n  popoverContent?: any;\n\n  toasts: LayoutOperation.Toast[];\n\n  workspace: string;\n};\n\nexport const LayoutState = Capability.make<Atom.Writable<LayoutStateProps>>(`${meta.id}.state`);\n"],
-  "mappings": ";AAKA,SAASA,YAAY;AAEd,IAAMC,OAAoB;EAC/BC,IAAI;EACJC,MAAM;EACNC,aAAaC;;;;EAIbC,QAAQ;AACV;;;ACTA,SAASC,kBAAkB;AAgCpB,IAAMC,cAAcC,WAAWC,KAAsC,GAAGC,KAAKC,EAAE,QAAQ;",
-  "names": ["trim", "meta", "id", "name", "description", "trim", "source", "Capability", "LayoutState", "Capability", "make", "meta", "id"]
-}

package/dist/lib/browser/chunk-M4TYMLOE.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/operations/update-state.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\n\nimport { LayoutState, type LayoutStateProps } from '../types';\n\nexport const updateState = (fn: (state: LayoutStateProps) => Partial<LayoutStateProps>) =>\n  Effect.gen(function* () {\n    const registry = yield* Capability.get(Capabilities.AtomRegistry);\n    const stateAtom = yield* Capability.get(LayoutState);\n    const current = registry.get(stateAtom);\n    registry.set(stateAtom, { ...current, ...fn(current) });\n  });\n"],
-  "mappings": ";;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,cAAcC,kBAAkB;AAIlC,IAAMC,cAAc,CAACC,OACnBC,WAAI,aAAA;AACT,QAAMC,WAAW,OAAOC,WAAWC,IAAIC,aAAaC,YAAY;AAChE,QAAMC,YAAY,OAAOJ,WAAWC,IAAII,WAAAA;AACxC,QAAMC,UAAUP,SAASE,IAAIG,SAAAA;AAC7BL,WAASQ,IAAIH,WAAW;IAAE,GAAGE;IAAS,GAAGT,GAAGS,OAAAA;EAAS,CAAA;AACvD,CAAA;",
-  "names": ["Effect", "Capabilities", "Capability", "updateState", "fn", "gen", "registry", "Capability", "get", "Capabilities", "AtomRegistry", "stateAtom", "LayoutState", "current", "set"]
-}