@dxos/plugin-help 0.8.4-main.3eb6e50203 → 0.8.4-main.3fbcb4aa9b

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-help",
-  "version": "0.8.4-main.3eb6e50203",
+  "version": "0.8.4-main.3fbcb4aa9b",
   "description": "Help plugin.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -12,34 +12,71 @@
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
-  "exports": {
-    ".": {
-      "source": "./src/index.ts",
-      "types": "./dist/types/src/index.d.ts",
-      "browser": "./dist/lib/browser/index.mjs"
+  "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": {
+    "#containers": {
+      "source": "./src/containers/index.ts",
+      "types": "./dist/types/src/containers/index.d.ts",
+      "default": "./dist/lib/neutral/containers/index.mjs"
+    },
+    "#hooks": {
+      "source": "./src/hooks/index.ts",
+      "types": "./dist/types/src/hooks/index.d.ts",
+      "default": "./dist/lib/neutral/hooks/index.mjs"
+    },
+    "#meta": {
       "source": "./src/meta.ts",
       "types": "./dist/types/src/meta.d.ts",
-      "browser": "./dist/lib/browser/meta.mjs"
+      "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/HelpPlugin.tsx",
+      "types": "./dist/types/src/HelpPlugin.d.ts",
+      "default": "./dist/lib/neutral/HelpPlugin.mjs"
     },
-    "./types": {
+    "#translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
+    },
+    "#types": {
       "source": "./src/types/index.ts",
       "types": "./dist/types/src/types/index.d.ts",
-      "browser": "./dist/lib/browser/types/index.mjs"
+      "default": "./dist/lib/neutral/types/index.mjs"
     }
   },
-  "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "meta": [
-        "dist/types/src/meta.d.ts"
-      ],
-      "types": [
-        "dist/types/src/types/index.d.ts"
-      ]
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/types/src/index.d.ts",
+      "default": "./dist/lib/neutral/index.mjs"
+    },
+    "./plugin": {
+      "source": "./src/plugin.ts",
+      "types": "./dist/types/src/plugin.d.ts",
+      "default": "./dist/lib/neutral/plugin.mjs"
+    },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
     }
   },
+  "types": "dist/types/src/index.d.ts",
   "files": [
     "dist",
     "src"
@@ -48,45 +85,45 @@
     "@effect-atom/atom": "^0.5.1",
     "@fluentui/react-tabster": "9.26.11",
     "react-joyride": "^2.7.2",
-    "@dxos/app-graph": "0.8.4-main.3eb6e50203",
-    "@dxos/app-framework": "0.8.4-main.3eb6e50203",
-    "@dxos/app-toolkit": "0.8.4-main.3eb6e50203",
-    "@dxos/debug": "0.8.4-main.3eb6e50203",
-    "@dxos/echo": "0.8.4-main.3eb6e50203",
-    "@dxos/effect": "0.8.4-main.3eb6e50203",
-    "@dxos/operation": "0.8.4-main.3eb6e50203",
-    "@dxos/plugin-client": "0.8.4-main.3eb6e50203",
-    "@dxos/keyboard": "0.8.4-main.3eb6e50203",
-    "@dxos/plugin-space": "0.8.4-main.3eb6e50203",
-    "@dxos/react-client": "0.8.4-main.3eb6e50203",
-    "@dxos/plugin-graph": "0.8.4-main.3eb6e50203",
-    "@dxos/util": "0.8.4-main.3eb6e50203"
+    "@dxos/app-framework": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/app-graph": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/compute": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/app-toolkit": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/echo": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/debug": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/effect": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/plugin-client": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/keyboard": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/plugin-graph": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/plugin-space": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/react-client": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/util": "0.8.4-main.3fbcb4aa9b"
   },
   "devDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
     "@effect/platform": "0.94.4",
     "@types/react": "~19.2.7",
     "@types/react-dom": "~19.2.3",
-    "effect": "3.19.16",
+    "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
     "react-floater": "0.7.9",
     "type-fest": "4.10.1",
-    "vite": "7.1.9",
-    "@dxos/plugin-testing": "0.8.4-main.3eb6e50203",
-    "@dxos/random": "0.8.4-main.3eb6e50203",
-    "@dxos/ui-theme": "0.8.4-main.3eb6e50203",
-    "@dxos/react-ui": "0.8.4-main.3eb6e50203",
-    "@dxos/storybook-utils": "0.8.4-main.3eb6e50203"
+    "vite": "^8.0.10",
+    "@dxos/plugin-testing": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/random": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/react-ui": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/storybook-utils": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/ui-theme": "0.8.4-main.3fbcb4aa9b"
   },
   "peerDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
     "@effect/platform": "0.94.4",
-    "effect": "3.19.16",
+    "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.8.4-main.3eb6e50203",
-    "@dxos/ui-theme": "0.8.4-main.3eb6e50203"
+    "@dxos/react-ui": "0.8.4-main.3fbcb4aa9b",
+    "@dxos/ui-theme": "0.8.4-main.3fbcb4aa9b"
   },
   "publishConfig": {
     "access": "public"

package/src/HelpPlugin.test.ts

@@ -0,0 +1,30 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { ActivationEvents } from '@dxos/app-framework';
+import { createComposerTestApp } from '@dxos/plugin-testing/harness';
+
+import { HelpPlugin } from '#plugin';
+
+import { meta } from './meta';
+
+const moduleId = (name: string) => `${meta.id}.module.${name}`;
+
+describe('HelpPlugin', () => {
+  test('modules activate on the expected events', async ({ expect }) => {
+    await using harness = await createComposerTestApp({
+      plugins: [HelpPlugin({})],
+    });
+
+    expect(harness.manager.getActive()).toEqual(
+      expect.arrayContaining([moduleId('AppGraphBuilder'), moduleId('ReactSurface')]),
+    );
+
+    // Operation handlers are not loaded on startup — SetupOperationHandler fires lazily when an operation is invoked.
+    await harness.fire(ActivationEvents.SetupOperationHandler);
+    expect(harness.manager.getActive()).toContain(moduleId('OperationHandler'));
+  });
+});

package/src/HelpPlugin.tsx

@@ -5,16 +5,16 @@
 import { ActivationEvents, Plugin } from '@dxos/app-framework';
 import { AppPlugin } from '@dxos/app-toolkit';
 
-import { AppGraphBuilder, HelpState, OperationResolver, ReactRoot, ReactSurface } from './capabilities';
-import { meta } from './meta';
-import { translations } from './translations';
-import { type Step } from './types';
+import { AppGraphBuilder, HelpState, OperationHandler, ReactRoot, ReactSurface } from '#capabilities';
+import { meta } from '#meta';
+import { translations } from '#translations';
+import { type Step } from '#types';
 
 export type HelpPluginOptions = { steps?: Step[] };
 
 export const HelpPlugin = Plugin.define<HelpPluginOptions>(meta).pipe(
   AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
-  AppPlugin.addOperationResolverModule({ activate: OperationResolver }),
+  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
   AppPlugin.addSurfaceModule({ activate: ReactSurface }),
   AppPlugin.addTranslationsModule({ translations }),
   Plugin.addModule({
@@ -28,3 +28,5 @@ export const HelpPlugin = Plugin.define<HelpPluginOptions>(meta).pipe(
   })),
   Plugin.make,
 );
+
+export default HelpPlugin;

package/src/capabilities/{app-graph-builder/app-graph-builder.ts → app-graph-builder.ts}

@@ -5,29 +5,30 @@
 import * as Effect from 'effect/Effect';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
-import { GraphBuilder, NodeMatcher } from '@dxos/app-graph';
+import { GraphBuilder, Node, NodeMatcher } from '@dxos/app-graph';
 import { AppCapabilities, LayoutOperation } from '@dxos/app-toolkit';
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
-import { SHORTCUTS_DIALOG } from '../../components';
-import { meta } from '../../meta';
-import { HelpCapabilities, HelpOperation } from '../../types';
+import { meta } from '#meta';
+import { HelpCapabilities, HelpOperation } from '#types';
+
+import { SHORTCUTS_DIALOG } from '../constants';
 
 export default Capability.makeModule(
   Effect.fnUntraced(function* () {
     const extensions = yield* GraphBuilder.createExtension({
-      id: meta.id,
+      id: 'root',
       match: NodeMatcher.whenRoot,
       actions: () =>
         Effect.succeed([
-          {
+          Node.makeAction({
             id: HelpOperation.Start.meta.key,
             data: Effect.fnUntraced(function* () {
               yield* Capabilities.updateAtomValue(HelpCapabilities.State, (s) => ({ ...s, showHints: true }));
               yield* Operation.invoke(HelpOperation.Start);
             }),
             properties: {
-              label: ['open help tour', { ns: meta.id }],
+              label: ['open-help-tour.message', { ns: meta.id }],
               icon: 'ph--info--regular',
               keyBinding: {
                 macos: 'shift+meta+/',
@@ -36,24 +37,23 @@ export default Capability.makeModule(
               },
               testId: 'helpPlugin.openHelp',
             },
-          },
-          {
-            id: `${meta.id}/open-shortcuts`,
+          }),
+          Node.makeAction({
+            id: 'open-shortcuts',
             data: Effect.fnUntraced(function* () {
               yield* Capabilities.updateAtomValue(HelpCapabilities.State, (s) => ({ ...s, showHints: true }));
               yield* Operation.invoke(LayoutOperation.UpdateDialog, {
                 subject: SHORTCUTS_DIALOG,
-                blockAlign: 'center',
               });
             }),
             properties: {
-              label: ['open shortcuts label', { ns: meta.id }],
+              label: ['open-shortcuts.label', { ns: meta.id }],
               icon: 'ph--keyboard--regular',
               keyBinding: {
                 macos: 'meta+ctrl+/',
               },
             },
-          },
+          }),
         ]),
     });
 

package/src/capabilities/index.ts

@@ -2,8 +2,14 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './app-graph-builder';
-export * from './operation-resolver';
-export * from './react-root';
-export * from './react-surface';
-export * from './state';
+import { Capability } from '@dxos/app-framework';
+import { OperationHandlerSet } from '@dxos/compute';
+
+export const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));
+export const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(
+  'OperationHandler',
+  () => import('./operation-handler'),
+);
+export const ReactRoot = Capability.lazy('ReactRoot', () => import('./react-root'));
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));
+export const HelpState = Capability.lazy('HelpState', () => import('./state'));

package/src/capabilities/operation-handler.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import type { OperationHandlerSet } from '@dxos/compute';
+
+import { HelpOperationHandlerSet } from '#operations';
+
+export default Capability.makeModule<OperationHandlerSet.OperationHandlerSet>(
+  Effect.fnUntraced(function* () {
+    return Capability.contributes(Capabilities.OperationHandler, HelpOperationHandlerSet);
+  }),
+);

package/src/capabilities/{react-root/react-root.tsx → react-root.tsx}

@@ -8,9 +8,9 @@ import React from 'react';
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { useAtomCapabilityState } from '@dxos/app-framework/ui';
 
-import { WelcomeTour } from '../../components';
-import { meta } from '../../meta';
-import { HelpCapabilities, type Step } from '../../types';
+import { WelcomeTour } from '#components';
+import { meta } from '#meta';
+import { HelpCapabilities, type Step } from '#types';
 
 export default Capability.makeModule(
   Effect.fnUntraced(function* (steps?: Step[]) {

package/src/capabilities/{react-surface/react-surface.tsx → react-surface.tsx}

@@ -7,27 +7,28 @@ import React from 'react';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { Surface } from '@dxos/app-framework/ui';
+import { AppSurface } from '@dxos/app-toolkit/ui';
 
-import { SHORTCUTS_DIALOG, ShortcutsDialogContent, ShortcutsHints, ShortcutsList } from '../../components';
-import { meta } from '../../meta';
+import { ShortcutsDialogContent, ShortcutsHints, ShortcutsList } from '#containers';
+
+import { SHORTCUTS_DIALOG } from '../constants';
 
 export default Capability.makeModule(() =>
   Effect.succeed(
     Capability.contributes(Capabilities.ReactSurface, [
       Surface.create({
-        id: `${meta.id}/hints`,
+        id: 'hints',
         role: 'hints',
         component: () => <ShortcutsHints />,
       }),
       Surface.create({
-        id: `${meta.id}/keyshortcuts`,
+        id: 'keyshortcuts',
         role: 'keyshortcuts',
         component: () => <ShortcutsList />,
       }),
       Surface.create({
         id: SHORTCUTS_DIALOG,
-        role: 'dialog',
-        filter: (data): data is { component: string } => data.component === SHORTCUTS_DIALOG,
+        filter: AppSurface.component(AppSurface.Dialog, SHORTCUTS_DIALOG),
         component: () => <ShortcutsDialogContent />,
       }),
     ]),

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

@@ -7,8 +7,8 @@ import * as Effect from 'effect/Effect';
 import { Capability } from '@dxos/app-framework';
 import { createKvsStore } from '@dxos/effect';
 
-import { meta } from '../../meta';
-import { HelpCapabilities } from '../../types';
+import { meta } from '#meta';
+import { HelpCapabilities } from '#types';
 
 export default Capability.makeModule(() =>
   Effect.sync(() => {

package/src/components/Shortcuts/ShortcutsHints.tsx

@@ -13,7 +13,7 @@ import { Key } from './Key';
 const Shortcut = ({ binding }: { binding: KeyBinding }) => {
   const { t } = useTranslation(osTranslations);
   return (
-    <div role='none' className='flex items-center gap-2 whitespace-nowrap'>
+    <div className='flex items-center gap-2 whitespace-nowrap'>
       <Key binding={binding.shortcut} />
       <span className='text-sm'>{toLocalizedString(binding.data, t)}</span>
     </div>
@@ -27,7 +27,7 @@ export const ShortcutsHints = ({ onClose }: { onClose?: () => void }) => {
   const hints = bindings.filter((binding) => defaults.includes(binding.shortcut));
 
   return (
-    <div role='none' className='flex overflow-hidden pli-2 gap-4'>
+    <div className='flex overflow-hidden px-2 gap-4'>
       {hints.map((binding) => (
         <Shortcut key={binding.shortcut} binding={binding} />
       ))}

package/src/components/Shortcuts/ShortcutsList.tsx

@@ -8,7 +8,7 @@ import { Keyboard } from '@dxos/keyboard';
 import { toLocalizedString, useTranslation } from '@dxos/react-ui';
 import { mx } from '@dxos/ui-theme';
 
-import { meta } from '../../meta';
+import { meta } from '#meta';
 
 import { Key } from './Key';
 
@@ -22,11 +22,11 @@ export const ShortcutsList = () => {
   });
 
   return (
-    <dl className={mx('is-fit grid grid-cols-[min-content_minmax(12rem,1fr)] gap-2 mlb-4 text-subdued select-none')}>
+    <dl className={mx('w-fit grid grid-cols-[min-content_minmax(12rem,1fr)] gap-2 my-4 text-subdued select-none')}>
       {bindings.map((binding, i) => (
         <Fragment key={i}>
           <Key binding={binding.shortcut} />
-          <span role='definition' className='mis-4' aria-labelledby={binding.shortcut}>
+          <span role='definition' className='ms-4' aria-labelledby={binding.shortcut}>
             {toLocalizedString(binding.data, t)}
           </span>
         </Fragment>

package/src/components/Shortcuts/ShortcutsSection.tsx

@@ -4,13 +4,11 @@
 
 import React from 'react';
 
-import { descriptionText } from '@dxos/ui-theme';
-
 import { ShortcutsList } from './ShortcutsList';
 
 export const ShortcutsSection = () => {
   return (
-    <section className={descriptionText}>
+    <section className='text-description'>
       <ShortcutsList />
     </section>
   );

package/src/components/Shortcuts/index.ts

@@ -2,7 +2,6 @@
 // Copyright 2023 DXOS.org
 //
 
-export * from './ShortcutsDialog';
 export * from './ShortcutsHints';
 export * from './ShortcutsList';
 export * from './ShortcutsSection';

package/src/components/Shortcuts/styles.ts

@@ -5,6 +5,6 @@
 import { mx } from '@dxos/ui-theme';
 
 export const shortcutKey = mx(
-  'inline-flex min-is-[24px] bs-[24px] pli-0.5 justify-center items-center text-xs',
-  'rounded bg-neutral-100 dark:bg-neutral-900',
+  'inline-flex min-w-[24px] h-[24px] px-0.5 justify-center items-center text-xs',
+  'rounded-sm bg-neutral-100 dark:bg-neutral-900',
 );

package/src/components/Tooltip/Tooltip.tsx

@@ -38,7 +38,7 @@ export const Tooltip = forwardRef<HTMLDivElement, TooltipRenderProps>(
 
     return (
       <div
-        className='flex flex-col is-[15rem] min-bs-[10rem] overflow-hidden rounded-md shadow-xl bg-accentSurface text-accentSurfaceText'
+        className='flex flex-col w-[15rem] min-h-[10rem] overflow-hidden rounded-md shadow-xl bg-accent-surface text-accent-surface-text'
         role='tooltip'
         data-testid='helpPlugin.tooltip'
         data-step={index + 1}
@@ -46,7 +46,7 @@ export const Tooltip = forwardRef<HTMLDivElement, TooltipRenderProps>(
         ref={forwardedRef}
       >
         <div className='flex p-2'>
-          <h2 className='grow pli-2 plb-1 text-lg font-medium text-accentSurfaceText'>{title}</h2>
+          <h2 className='grow px-2 py-1 text-lg font-medium text-accent-surface-text'>{title}</h2>
           <IconButton
             density='fine'
             icon='ph--x--bold'
@@ -58,7 +58,7 @@ export const Tooltip = forwardRef<HTMLDivElement, TooltipRenderProps>(
             data-testid='helpPlugin.tooltip.close'
           />
         </div>
-        <div className='flex grow pli-4 mlb-2'>{content}</div>
+        <div className='flex grow px-4 my-2'>{content}</div>
         <div className='flex p-2 items-center justify-between' {...arrowNavigationAttrs}>
           {
             <IconButton
@@ -78,7 +78,7 @@ export const Tooltip = forwardRef<HTMLDivElement, TooltipRenderProps>(
                   key={i}
                   icon={index === i ? 'ph--circle--fill' : 'ph--circle--regular'}
                   size={2}
-                  classNames='mli-1 cursor-pointer'
+                  classNames='mx-1 cursor-pointer'
                 />
               ))}
             </div>

package/src/components/WelcomeTour/WelcomeTour.stories.tsx

@@ -7,24 +7,24 @@ import React, { useState } from 'react';
 
 import { withPluginManager } from '@dxos/app-framework/testing';
 import { StorybookPlugin } from '@dxos/plugin-testing';
-import { faker } from '@dxos/random';
+import { random } from '@dxos/random';
 import { Button, Icon } from '@dxos/react-ui';
 import { withTheme } from '@dxos/react-ui/testing';
 
-import { useHelp } from '../../hooks';
+import { useHelp } from '#hooks';
 
 import { WelcomeTour, type WelcomeTourProps } from './WelcomeTour';
 
 const App = () => {
   const { running, start } = useHelp();
-  const [items, setItems] = useState(() => Array.from({ length: 5 }).map(() => faker.lorem.sentence()));
+  const [items, setItems] = useState(() => Array.from({ length: 5 }).map(() => random.lorem.sentence()));
   const handleAdd = () => {
-    setItems((items) => [...items, faker.lorem.sentence()]);
+    setItems((items) => [...items, random.lorem.sentence()]);
   };
 
   return (
-    <div className='flex flex-col bs-full p-4 space-y-8'>
-      <div className='flex items-center gap-2 plb-2'>
+    <div className='flex flex-col h-full p-4 space-y-8'>
+      <div className='flex items-center gap-2 py-2'>
         <Button data-joyride='basic/1' onClick={() => start()}>
           Start
         </Button>
@@ -41,13 +41,13 @@ const App = () => {
           ))}
         </ul>
       </div>
-      <div className='flex items-center gap-2 plb-2'>
+      <div className='flex items-center gap-2 py-2'>
         <Button data-joyride='basic/3' onClick={handleAdd}>
           Add
         </Button>
       </div>
       <div className='flex grow' />
-      <div className='flex items-center plb-2'>
+      <div className='flex items-center py-2'>
         <div className='grow' />
         <Icon icon='ph--circle--regular' data-joyride='basic/4' />
         <Icon icon='ph--circle--regular' />
@@ -76,25 +76,25 @@ export const Default: StoryObj<typeof WelcomeTour> = {
       {
         target: '[data-joyride="basic/1"]',
         title: 'plugins/Step 1',
-        content: faker.lorem.paragraph(),
+        content: random.lorem.paragraph(),
         disableBeacon: true,
         placement: 'right',
       },
       {
         target: '[data-joyride="basic/2"]',
         title: 'plugins/Step 2',
-        content: faker.lorem.paragraph(),
+        content: random.lorem.paragraph(),
       },
       {
         target: '[data-joyride="basic/3"]',
         title: 'plugins/Step 3',
-        content: faker.lorem.paragraph(),
+        content: random.lorem.paragraph(),
         placement: 'right',
       },
       {
         target: '[data-joyride="basic/4"]',
         title: 'plugins/Step 4',
-        content: faker.lorem.paragraph(),
+        content: random.lorem.paragraph(),
         placement: 'top-end',
       },
     ],
@@ -105,7 +105,7 @@ export const Default: StoryObj<typeof WelcomeTour> = {
  * IMPORTANT: Run in separate tab.
  */
 const meta = {
-  title: 'plugins/plugin-help/WelcomeTour',
+  title: 'plugins/plugin-help/components/WelcomeTour',
   component: WelcomeTour,
   render: DefaultStory,
   decorators: [

package/src/components/WelcomeTour/WelcomeTour.tsx

@@ -9,7 +9,8 @@ import { usePluginManager } from '@dxos/app-framework/ui';
 import { useLayout } from '@dxos/app-toolkit/ui';
 import { useAsyncEffect } from '@dxos/react-ui';
 
-import { HelpContext, type Step } from '../../types';
+import { HelpContext, type Step } from '#types';
+
 import { Tooltip, floaterProps } from '../Tooltip';
 
 const addStepClass = (target: string | HTMLElement) => {
@@ -162,6 +163,7 @@ export const WelcomeTour = ({ steps: initialSteps, running: runningProp, onRunni
         callback={callback}
         floaterProps={floaterProps}
         tooltipComponent={Tooltip}
+        spotlightPadding={0}
       />
     </HelpContext.Provider>
   );

package/src/constants.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { meta } from '#meta';
+
+export const SHORTCUTS_DIALOG = `${meta.id}.ShortcutsDialog`;