@dxos/plugin-help 0.8.4-main.b97322e → 0.8.4-main.c4373fc

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-help",
-  "version": "0.8.4-main.b97322e",
+  "version": "0.8.4-main.c4373fc",
   "description": "Help plugin.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -10,14 +10,17 @@
   "type": "module",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs"
     },
     "./meta": {
+      "source": "./src/meta.ts",
       "types": "./dist/types/src/meta.d.ts",
       "browser": "./dist/lib/browser/meta.mjs"
     },
     "./types": {
+      "source": "./src/types/index.ts",
       "types": "./dist/types/src/types/index.d.ts",
       "browser": "./dist/lib/browser/types/index.mjs"
     }
@@ -41,43 +44,43 @@
     "@fluentui/react-tabster": "^9.24.2",
     "@preact-signals/safe-react": "^0.9.0",
     "react-joyride": "^2.7.2",
-    "@dxos/app-framework": "0.8.4-main.b97322e",
-    "@dxos/app-graph": "0.8.4-main.b97322e",
-    "@dxos/debug": "0.8.4-main.b97322e",
-    "@dxos/echo-schema": "0.8.4-main.b97322e",
-    "@dxos/echo": "0.8.4-main.b97322e",
-    "@dxos/keyboard": "0.8.4-main.b97322e",
-    "@dxos/live-object": "0.8.4-main.b97322e",
-    "@dxos/local-storage": "0.8.4-main.b97322e",
-    "@dxos/plugin-graph": "0.8.4-main.b97322e",
-    "@dxos/plugin-client": "0.8.4-main.b97322e",
-    "@dxos/plugin-space": "0.8.4-main.b97322e",
-    "@dxos/react-client": "0.8.4-main.b97322e"
+    "@dxos/debug": "0.8.4-main.c4373fc",
+    "@dxos/app-framework": "0.8.4-main.c4373fc",
+    "@dxos/app-graph": "0.8.4-main.c4373fc",
+    "@dxos/echo": "0.8.4-main.c4373fc",
+    "@dxos/keyboard": "0.8.4-main.c4373fc",
+    "@dxos/live-object": "0.8.4-main.c4373fc",
+    "@dxos/local-storage": "0.8.4-main.c4373fc",
+    "@dxos/plugin-client": "0.8.4-main.c4373fc",
+    "@dxos/plugin-space": "0.8.4-main.c4373fc",
+    "@dxos/react-client": "0.8.4-main.c4373fc",
+    "@dxos/plugin-graph": "0.8.4-main.c4373fc"
   },
   "devDependencies": {
-    "@effect-rx/rx-react": "0.38.0",
-    "@effect/platform": "0.89.0",
-    "@types/react": "~18.2.0",
-    "@types/react-dom": "~18.2.0",
-    "effect": "3.17.0",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
+    "@effect-rx/rx-react": "0.42.4",
+    "@effect/platform": "0.92.1",
+    "@types/react": "~19.2.2",
+    "@types/react-dom": "~19.2.1",
+    "effect": "3.18.3",
+    "react": "~19.2.0",
+    "react-dom": "~19.2.0",
     "react-floater": "0.7.9",
     "type-fest": "4.10.1",
-    "vite": "5.4.7",
-    "@dxos/random": "0.8.4-main.b97322e",
-    "@dxos/react-ui": "0.8.4-main.b97322e",
-    "@dxos/react-ui-theme": "0.8.4-main.b97322e",
-    "@dxos/storybook-utils": "0.8.4-main.b97322e"
+    "vite": "7.1.9",
+    "@dxos/plugin-storybook-layout": "0.8.4-main.c4373fc",
+    "@dxos/random": "0.8.4-main.c4373fc",
+    "@dxos/react-ui-theme": "0.8.4-main.c4373fc",
+    "@dxos/storybook-utils": "0.8.4-main.c4373fc",
+    "@dxos/react-ui": "0.8.4-main.c4373fc"
   },
   "peerDependencies": {
     "@effect-rx/rx-react": "^0.34.1",
     "@effect/platform": "^0.80.12",
     "effect": "^3.13.3",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.4-main.b97322e",
-    "@dxos/react-ui-theme": "0.8.4-main.b97322e"
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@dxos/react-ui": "0.8.4-main.c4373fc",
+    "@dxos/react-ui-theme": "0.8.4-main.c4373fc"
   },
   "publishConfig": {
     "access": "public"

package/src/HelpPlugin.tsx

@@ -2,56 +2,54 @@
 // Copyright 2023 DXOS.org
 //
 
-import { createResolver, defineModule, definePlugin, Events, contributes, Capabilities } from '@dxos/app-framework';
+import { Capabilities, Events, contributes, createResolver, defineModule, definePlugin } from '@dxos/app-framework';
 
-import { AppGraphBuilder, HelpState, ReactRoot, ReactSurface } from './capabilities';
-import { HelpCapabilities } from './capabilities/capabilities';
+import { AppGraphBuilder, HelpCapabilities, HelpState, ReactRoot, ReactSurface } from './capabilities';
 import { meta } from './meta';
 import { translations } from './translations';
-import { type Step, HelpAction } from './types';
+import { HelpAction, type Step } from './types';
 
 export type HelpPluginOptions = { steps?: Step[] };
 
-export const HelpPlugin = ({ steps = [] }: HelpPluginOptions) =>
-  definePlugin(meta, [
-    defineModule({
-      id: `${meta.id}/module/state`,
-      activatesOn: Events.Startup,
-      activate: HelpState,
-    }),
-    defineModule({
-      id: `${meta.id}/module/translations`,
-      activatesOn: Events.SetupTranslations,
-      activate: () => contributes(Capabilities.Translations, translations),
-    }),
-    defineModule({
-      id: `${meta.id}/module/react-root`,
-      activatesOn: Events.Startup,
-      activate: () => ReactRoot(steps),
-    }),
-    defineModule({
-      id: `${meta.id}/module/react-surface`,
-      activatesOn: Events.SetupReactSurface,
-      activate: ReactSurface,
-    }),
-    defineModule({
-      id: `${meta.id}/module/intent-resolver`,
-      activatesOn: Events.SetupIntentResolver,
-      activate: (context) =>
-        contributes(
-          Capabilities.IntentResolver,
-          createResolver({
-            intent: HelpAction.Start,
-            resolve: () => {
-              const state = context.getCapability(HelpCapabilities.MutableState);
-              state.running = true;
-            },
-          }),
-        ),
-    }),
-    defineModule({
-      id: `${meta.id}/module/app-graph-builder`,
-      activatesOn: Events.SetupAppGraph,
-      activate: AppGraphBuilder,
-    }),
-  ]);
+export const HelpPlugin = definePlugin<HelpPluginOptions>(meta, ({ steps = [] }) => [
+  defineModule({
+    id: `${meta.id}/module/state`,
+    activatesOn: Events.Startup,
+    activate: HelpState,
+  }),
+  defineModule({
+    id: `${meta.id}/module/translations`,
+    activatesOn: Events.SetupTranslations,
+    activate: () => contributes(Capabilities.Translations, translations),
+  }),
+  defineModule({
+    id: `${meta.id}/module/react-root`,
+    activatesOn: Events.Startup,
+    activate: () => ReactRoot(steps),
+  }),
+  defineModule({
+    id: `${meta.id}/module/react-surface`,
+    activatesOn: Events.SetupReactSurface,
+    activate: ReactSurface,
+  }),
+  defineModule({
+    id: `${meta.id}/module/intent-resolver`,
+    activatesOn: Events.SetupIntentResolver,
+    activate: (context) =>
+      contributes(
+        Capabilities.IntentResolver,
+        createResolver({
+          intent: HelpAction.Start,
+          resolve: () => {
+            const state = context.getCapability(HelpCapabilities.MutableState);
+            state.running = true;
+          },
+        }),
+      ),
+  }),
+  defineModule({
+    id: `${meta.id}/module/app-graph-builder`,
+    activatesOn: Events.SetupAppGraph,
+    activate: AppGraphBuilder,
+  }),
+]);

package/src/capabilities/app-graph-builder.ts

@@ -3,24 +3,26 @@
 //
 
 import { Rx } from '@effect-rx/rx-react';
-import { Option, pipe } from 'effect';
+import * as Function from 'effect/Function';
+import * as Option from 'effect/Option';
 
-import { Capabilities, contributes, createIntent, LayoutAction, type PluginContext } from '@dxos/app-framework';
+import { Capabilities, LayoutAction, type PluginContext, contributes, createIntent } from '@dxos/app-framework';
 import { createExtension } from '@dxos/app-graph';
 
-import { HelpCapabilities } from './capabilities';
 import { SHORTCUTS_DIALOG } from '../components';
-import { HELP_PLUGIN } from '../meta';
+import { meta } from '../meta';
 import { HelpAction } from '../types';
 
+import { HelpCapabilities } from './capabilities';
+
 export default (context: PluginContext) =>
   contributes(
     Capabilities.AppGraphBuilder,
     createExtension({
-      id: HELP_PLUGIN,
+      id: meta.id,
       actions: (node) =>
         Rx.make((get) =>
-          pipe(
+          Function.pipe(
             get(node),
             Option.flatMap((node) => (node.id === 'root' ? Option.some(node) : Option.none())),
             Option.map(() => [
@@ -33,7 +35,7 @@ export default (context: PluginContext) =>
                   await dispatch(createIntent(HelpAction.Start));
                 },
                 properties: {
-                  label: ['open help tour', { ns: HELP_PLUGIN }],
+                  label: ['open help tour', { ns: meta.id }],
                   icon: 'ph--info--regular',
                   keyBinding: {
                     macos: 'shift+meta+/',
@@ -45,7 +47,7 @@ export default (context: PluginContext) =>
                 },
               },
               {
-                id: 'dxos.org/plugin/help/open-shortcuts',
+                id: `${meta.id}/open-shortcuts`,
                 data: async () => {
                   const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
                   const state = context.getCapability(HelpCapabilities.MutableState);
@@ -61,7 +63,7 @@ export default (context: PluginContext) =>
                   );
                 },
                 properties: {
-                  label: ['open shortcuts label', { ns: HELP_PLUGIN }],
+                  label: ['open shortcuts label', { ns: meta.id }],
                   icon: 'ph--keyboard--regular',
                   keyBinding: {
                     macos: 'meta+ctrl+/',

package/src/capabilities/capabilities.ts

@@ -4,10 +4,10 @@
 
 import { defineCapability } from '@dxos/app-framework';
 
-import { HELP_PLUGIN } from '../meta';
+import { meta } from '../meta';
 
 export namespace HelpCapabilities {
   export type State = { running: boolean; showHints: boolean; showWelcome: boolean };
-  export const State = defineCapability<Readonly<State>>(`${HELP_PLUGIN}/capability/state`);
-  export const MutableState = defineCapability<State>(`${HELP_PLUGIN}/capability/state`);
+  export const State = defineCapability<Readonly<State>>(`${meta.id}/capability/state`);
+  export const MutableState = defineCapability<State>(`${meta.id}/capability/state`);
 }

package/src/capabilities/react-root.tsx

@@ -6,14 +6,15 @@ import React from 'react';
 
 import { Capabilities, contributes, useCapability } from '@dxos/app-framework';
 
-import { HelpCapabilities } from './capabilities';
 import { WelcomeTour } from '../components';
-import { HELP_PLUGIN } from '../meta';
+import { meta } from '../meta';
 import { type Step } from '../types';
 
+import { HelpCapabilities } from './capabilities';
+
 export default (steps: Step[]) =>
   contributes(Capabilities.ReactRoot, {
-    id: HELP_PLUGIN,
+    id: meta.id,
     root: () => {
       const state = useCapability(HelpCapabilities.MutableState);
       return (

package/src/capabilities/react-surface.tsx

@@ -7,17 +7,17 @@ import React from 'react';
 import { Capabilities, contributes, createSurface } from '@dxos/app-framework';
 
 import { SHORTCUTS_DIALOG, ShortcutsDialogContent, ShortcutsHints, ShortcutsList } from '../components';
-import { HELP_PLUGIN } from '../meta';
+import { meta } from '../meta';
 
 export default () =>
   contributes(Capabilities.ReactSurface, [
     createSurface({
-      id: `${HELP_PLUGIN}/hints`,
+      id: `${meta.id}/hints`,
       role: 'hints',
       component: () => <ShortcutsHints />,
     }),
     createSurface({
-      id: `${HELP_PLUGIN}/keyshortcuts`,
+      id: `${meta.id}/keyshortcuts`,
       role: 'keyshortcuts',
       component: () => <ShortcutsList />,
     }),

package/src/capabilities/state.ts

@@ -5,11 +5,12 @@
 import { contributes } from '@dxos/app-framework';
 import { LocalStorageStore } from '@dxos/local-storage';
 
+import { meta } from '../meta';
+
 import { HelpCapabilities } from './capabilities';
-import { HELP_PLUGIN } from '../meta';
 
 export default () => {
-  const state = new LocalStorageStore<HelpCapabilities.State>(HELP_PLUGIN, {
+  const state = new LocalStorageStore<HelpCapabilities.State>(meta.id, {
     running: false,
     showHints: true,
     showWelcome: true,

package/src/components/Shortcuts/ShortcutsDialog.tsx

@@ -6,13 +6,14 @@ import React from 'react';
 
 import { Button, Dialog, Icon, useTranslation } from '@dxos/react-ui';
 
+import { meta } from '../../meta';
+
 import { ShortcutsList } from './ShortcutsList';
-import { HELP_PLUGIN } from '../../meta';
 
-export const SHORTCUTS_DIALOG = `${HELP_PLUGIN}/ShortcutsDialog`;
+export const SHORTCUTS_DIALOG = `${meta.id}/ShortcutsDialog`;
 
 export const ShortcutsDialogContent = () => {
-  const { t } = useTranslation(HELP_PLUGIN);
+  const { t } = useTranslation(meta.id);
 
   return (
     <Dialog.Content classNames='p-0 bs-content max-bs-full md:max-is-[25rem] overflow-hidden'>

package/src/components/Shortcuts/ShortcutsList.tsx

@@ -8,11 +8,12 @@ import { Keyboard } from '@dxos/keyboard';
 import { toLocalizedString, useTranslation } from '@dxos/react-ui';
 import { mx } from '@dxos/react-ui-theme';
 
+import { meta } from '../../meta';
+
 import { Key } from './Key';
-import { HELP_PLUGIN } from '../../meta';
 
 export const ShortcutsList = () => {
-  const { t } = useTranslation(HELP_PLUGIN);
+  const { t } = useTranslation(meta.id);
   const bindings = Keyboard.singleton.getBindings();
 
   // TODO(burdon): Get shortcuts from TextEditor.

package/src/components/Tooltip/Tooltip.tsx

@@ -7,7 +7,7 @@ import React, { forwardRef } from 'react';
 // TODO(thure): This needed to be imported in the package.json specifically to pacify TS2742. See if this is resolved with typescript@5.5.x.
 // eslint-disable-next-line unused-imports/no-unused-imports
 import _floater from 'react-floater';
-import { type TooltipRenderProps, type Props } from 'react-joyride';
+import { type Props, type TooltipRenderProps } from 'react-joyride';
 // TODO(thure): This needed to be imported in the package.json specifically to pacify TS2742. See if this is resolved with typescript@5.5.x.
 // eslint-disable-next-line unused-imports/no-unused-imports
 import _typefest from 'type-fest';

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

@@ -2,18 +2,19 @@
 // Copyright 2023 DXOS.org
 //
 
-import '@dxos-theme';
-
 import { type Meta, type StoryObj } from '@storybook/react-vite';
 import React, { useState } from 'react';
 
+import { withPluginManager } from '@dxos/app-framework/testing';
+import { StorybookLayoutPlugin } from '@dxos/plugin-storybook-layout';
 import { faker } from '@dxos/random';
 import { Button, Icon } from '@dxos/react-ui';
-import { withTheme } from '@dxos/storybook-utils';
+import { withTheme } from '@dxos/react-ui/testing';
 
-import { WelcomeTour, type WelcomeTourProps } from './WelcomeTour';
 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()));
@@ -103,11 +104,12 @@ export const Default: StoryObj<typeof WelcomeTour> = {
 /**
  * IMPORTANT: Run in separate tab.
  */
-const meta: Meta<typeof WelcomeTour> = {
+const meta = {
   title: 'plugins/plugin-help/WelcomeTour',
   component: WelcomeTour,
   render: DefaultStory,
-  decorators: [withTheme],
-};
+  // TODO(wittjosiah): Try to write story which does not depend on plugin manager.
+  decorators: [withTheme, withPluginManager({ plugins: [StorybookLayoutPlugin({})] })],
+} satisfies Meta<typeof WelcomeTour>;
 
 export default meta;

package/src/components/WelcomeTour/WelcomeTour.tsx

@@ -2,13 +2,14 @@
 // Copyright 2023 DXOS.org
 //
 
-import React, { useState, useEffect } from 'react';
+import React, { useState } from 'react';
 import Joyride, { ACTIONS, EVENTS } from 'react-joyride';
 
-import { usePluginManager, useLayout } from '@dxos/app-framework';
+import { useLayout, usePluginManager } from '@dxos/app-framework';
+import { useAsyncEffect } from '@dxos/react-ui';
 
-import { type Step, HelpContext } from '../../types';
-import { floaterProps, Tooltip } from '../Tooltip';
+import { HelpContext, type Step } from '../../types';
+import { Tooltip, floaterProps } from '../Tooltip';
 
 const addStepClass = (target: string | HTMLElement) => {
   const element = typeof target === 'string' ? document.querySelector(target) : target;
@@ -93,20 +94,16 @@ export const WelcomeTour = ({ steps: initialSteps, running: runningProp, onRunni
     }
   };
 
-  useEffect(() => {
-    const timeout = setTimeout(async () => {
-      if (runningProp) {
-        // This handles the case when the target is not yet in the document.
-        // If the target is not in the document, when the joyride is turned on, it will not show the tooltip.
-        await waitForTarget(steps[stepIndex]);
-        setStepIndex(0);
-        setRunning(true);
-      } else if (typeof runningProp !== 'undefined') {
-        setRunning(false);
-      }
-    });
-
-    return () => clearTimeout(timeout);
+  useAsyncEffect(async () => {
+    if (runningProp) {
+      // This handles the case when the target is not yet in the document.
+      // If the target is not in the document, when the joyride is turned on, it will not show the tooltip.
+      await waitForTarget(steps[stepIndex]);
+      setStepIndex(0);
+      setRunning(true);
+    } else if (typeof runningProp !== 'undefined') {
+      setRunning(false);
+    }
   }, [runningProp]);
 
   // https://docs.react-joyride.com/callback

package/src/meta.ts

@@ -4,11 +4,8 @@
 
 import { type PluginMeta } from '@dxos/app-framework';
 
-// TODO(burdon): Rename Guide? Help?
-export const HELP_PLUGIN = 'dxos.org/plugin/help';
-
 export const meta: PluginMeta = {
-  id: HELP_PLUGIN,
+  id: 'dxos.org/plugin/help',
   name: 'Help',
   icon: 'ph--info--regular',
 };

package/src/types/schema.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Schema } from 'effect';
+import * as Schema from 'effect/Schema';
 import { type Context, createContext } from 'react';
 import { type Step as BaseStep } from 'react-joyride';
 

package/dist/lib/browser/app-graph-builder-BYCMEBNG.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/capabilities/app-graph-builder.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Rx } from '@effect-rx/rx-react';\nimport { Option, pipe } from 'effect';\n\nimport { Capabilities, contributes, createIntent, LayoutAction, type PluginContext } from '@dxos/app-framework';\nimport { createExtension } from '@dxos/app-graph';\n\nimport { HelpCapabilities } from './capabilities';\nimport { SHORTCUTS_DIALOG } from '../components';\nimport { HELP_PLUGIN } from '../meta';\nimport { HelpAction } from '../types';\n\nexport default (context: PluginContext) =>\n  contributes(\n    Capabilities.AppGraphBuilder,\n    createExtension({\n      id: HELP_PLUGIN,\n      actions: (node) =>\n        Rx.make((get) =>\n          pipe(\n            get(node),\n            Option.flatMap((node) => (node.id === 'root' ? Option.some(node) : Option.none())),\n            Option.map(() => [\n              {\n                id: HelpAction.Start._tag,\n                data: async () => {\n                  const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);\n                  const state = context.getCapability(HelpCapabilities.MutableState);\n                  state.showHints = true;\n                  await dispatch(createIntent(HelpAction.Start));\n                },\n                properties: {\n                  label: ['open help tour', { ns: HELP_PLUGIN }],\n                  icon: 'ph--info--regular',\n                  keyBinding: {\n                    macos: 'shift+meta+/',\n                    // TODO(wittjosiah): Test on windows to see if it behaves the same as linux.\n                    windows: 'shift+ctrl+/',\n                    linux: 'shift+ctrl+?',\n                  },\n                  testId: 'helpPlugin.openHelp',\n                },\n              },\n              {\n                id: 'dxos.org/plugin/help/open-shortcuts',\n                data: async () => {\n                  const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);\n                  const state = context.getCapability(HelpCapabilities.MutableState);\n                  state.showHints = true;\n                  await dispatch(\n                    createIntent(LayoutAction.UpdateDialog, {\n                      part: 'dialog',\n                      subject: SHORTCUTS_DIALOG,\n                      options: {\n                        blockAlign: 'center',\n                      },\n                    }),\n                  );\n                },\n                properties: {\n                  label: ['open shortcuts label', { ns: HELP_PLUGIN }],\n                  icon: 'ph--keyboard--regular',\n                  keyBinding: {\n                    macos: 'meta+ctrl+/',\n                  },\n                },\n              },\n            ]),\n            Option.getOrElse(() => []),\n          ),\n        ),\n    }),\n  );\n"],
-  "mappings": ";;;;;;;;;;;;;;AAIA,SAASA,UAAU;AACnB,SAASC,QAAQC,YAAY;AAE7B,SAASC,cAAcC,aAAaC,cAAcC,oBAAwC;AAC1F,SAASC,uBAAuB;AAOhC,IAAA,4BAAe,CAACC,YACdC,YACEC,aAAaC,iBACbC,gBAAgB;EACdC,IAAIC;EACJC,SAAS,CAACC,SACRC,GAAGC,KAAK,CAACC,QACPC,KACED,IAAIH,IAAAA,GACJK,OAAOC,QAAQ,CAACN,UAAUA,MAAKH,OAAO,SAASQ,OAAOE,KAAKP,KAAAA,IAAQK,OAAOG,KAAI,CAAA,GAC9EH,OAAOI,IAAI,MAAM;IACf;MACEZ,IAAIa,WAAWC,MAAMC;MACrBC,MAAM,YAAA;AACJ,cAAM,EAAEC,iBAAiBC,SAAQ,IAAKvB,QAAQwB,cAActB,aAAauB,gBAAgB;AACzF,cAAMC,QAAQ1B,QAAQwB,cAAcG,iBAAiBC,YAAY;AACjEF,cAAMG,YAAY;AAClB,cAAMN,SAASO,aAAaZ,WAAWC,KAAK,CAAA;MAC9C;MACAY,YAAY;QACVC,OAAO;UAAC;UAAkB;YAAEC,IAAI3B;UAAY;;QAC5C4B,MAAM;QACNC,YAAY;UACVC,OAAO;;UAEPC,SAAS;UACTC,OAAO;QACT;QACAC,QAAQ;MACV;IACF;IACA;MACElC,IAAI;MACJgB,MAAM,YAAA;AACJ,cAAM,EAAEC,iBAAiBC,SAAQ,IAAKvB,QAAQwB,cAActB,aAAauB,gBAAgB;AACzF,cAAMC,QAAQ1B,QAAQwB,cAAcG,iBAAiBC,YAAY;AACjEF,cAAMG,YAAY;AAClB,cAAMN,SACJO,aAAaU,aAAaC,cAAc;UACtCC,MAAM;UACNC,SAASC;UACTC,SAAS;YACPC,YAAY;UACd;QACF,CAAA,CAAA;MAEJ;MACAf,YAAY;QACVC,OAAO;UAAC;UAAwB;YAAEC,IAAI3B;UAAY;;QAClD4B,MAAM;QACNC,YAAY;UACVC,OAAO;QACT;MACF;IACF;GACD,GACDvB,OAAOkC,UAAU,MAAM,CAAA,CAAE,CAAA,CAAA;AAGjC,CAAA,CAAA;",
-  "names": ["Rx", "Option", "pipe", "Capabilities", "contributes", "createIntent", "LayoutAction", "createExtension", "context", "contributes", "Capabilities", "AppGraphBuilder", "createExtension", "id", "HELP_PLUGIN", "actions", "node", "Rx", "make", "get", "pipe", "Option", "flatMap", "some", "none", "map", "HelpAction", "Start", "_tag", "data", "dispatchPromise", "dispatch", "getCapability", "IntentDispatcher", "state", "HelpCapabilities", "MutableState", "showHints", "createIntent", "properties", "label", "ns", "icon", "keyBinding", "macos", "windows", "linux", "testId", "LayoutAction", "UpdateDialog", "part", "subject", "SHORTCUTS_DIALOG", "options", "blockAlign", "getOrElse"]
-}

package/dist/lib/browser/chunk-3Y4CMOZP.mjs

@@ -1,13 +0,0 @@
-// src/meta.ts
-var HELP_PLUGIN = "dxos.org/plugin/help";
-var meta = {
-  id: HELP_PLUGIN,
-  name: "Help",
-  icon: "ph--info--regular"
-};
-
-export {
-  HELP_PLUGIN,
-  meta
-};
-//# sourceMappingURL=chunk-3Y4CMOZP.mjs.map

package/dist/lib/browser/chunk-3Y4CMOZP.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/meta.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type PluginMeta } from '@dxos/app-framework';\n\n// TODO(burdon): Rename Guide? Help?\nexport const HELP_PLUGIN = 'dxos.org/plugin/help';\n\nexport const meta: PluginMeta = {\n  id: HELP_PLUGIN,\n  name: 'Help',\n  icon: 'ph--info--regular',\n};\n"],
-  "mappings": ";AAOO,IAAMA,cAAc;AAEpB,IAAMC,OAAmB;EAC9BC,IAAIF;EACJG,MAAM;EACNC,MAAM;AACR;",
-  "names": ["HELP_PLUGIN", "meta", "id", "name", "icon"]
-}

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/types/schema.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Schema } from 'effect';\nimport { type Context, createContext } from 'react';\nimport { type Step as BaseStep } from 'react-joyride';\n\nimport { type PluginContext } from '@dxos/app-framework';\n\nimport { meta } from '../meta';\n\nexport type Step = BaseStep & {\n  before?: (context: PluginContext) => void;\n};\n\nexport type HelpContextType = {\n  running: boolean;\n  steps: Step[];\n  setSteps: (steps: Step[]) => void;\n  setIndex: (index: number) => void;\n  start: () => void;\n  stop: () => void;\n};\n\nexport const HelpContext: Context<HelpContextType> = createContext<HelpContextType>({\n  running: false,\n  steps: [],\n  setSteps: () => {},\n  setIndex: () => {},\n  start: () => {},\n  stop: () => {},\n});\n\nexport namespace HelpAction {\n  export class Start extends Schema.TaggedClass<Start>()(`${meta.id}/action/start`, {\n    input: Schema.Void,\n    output: Schema.Void,\n  }) {}\n}\n"],
-  "mappings": ";;;;;AAIA,SAASA,cAAc;AACvB,SAAuBC,qBAAqB;AAoBrC,IAAMC,cAAwCC,cAA+B;EAClFC,SAAS;EACTC,OAAO,CAAA;EACPC,UAAU,MAAA;EAAO;EACjBC,UAAU,MAAA;EAAO;EACjBC,OAAO,MAAA;EAAO;EACdC,MAAM,MAAA;EAAO;AACf,CAAA;UAEiBC,aAAAA;EACR,MAAMC,cAAcC,OAAOC,YAAW,EAAU,GAAGC,KAAKC,EAAE,iBAAiB;IAChFC,OAAOJ,OAAOK;IACdC,QAAQN,OAAOK;EACjB,CAAA,EAAA;EAAI;cAHSN,QAAAA;AAIf,GALiBD,eAAAA,aAAAA,CAAAA,EAAAA;;",
-  "names": ["Schema", "createContext", "HelpContext", "createContext", "running", "steps", "setSteps", "setIndex", "start", "stop", "HelpAction", "Start", "Schema", "TaggedClass", "meta", "id", "input", "Void", "output"]
-}

package/dist/lib/browser/chunk-LDRUZNSN.mjs

@@ -1,16 +0,0 @@
-import {
-  HELP_PLUGIN
-} from "./chunk-3Y4CMOZP.mjs";
-
-// src/capabilities/capabilities.ts
-import { defineCapability } from "@dxos/app-framework";
-(function(HelpCapabilities2) {
-  HelpCapabilities2.State = defineCapability(`${HELP_PLUGIN}/capability/state`);
-  HelpCapabilities2.MutableState = defineCapability(`${HELP_PLUGIN}/capability/state`);
-})(HelpCapabilities || (HelpCapabilities = {}));
-var HelpCapabilities;
-
-export {
-  HelpCapabilities
-};
-//# sourceMappingURL=chunk-LDRUZNSN.mjs.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/capabilities/capabilities.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { defineCapability } from '@dxos/app-framework';\n\nimport { HELP_PLUGIN } from '../meta';\n\nexport namespace HelpCapabilities {\n  export type State = { running: boolean; showHints: boolean; showWelcome: boolean };\n  export const State = defineCapability<Readonly<State>>(`${HELP_PLUGIN}/capability/state`);\n  export const MutableState = defineCapability<State>(`${HELP_PLUGIN}/capability/state`);\n}\n"],
-  "mappings": ";;;;;AAIA,SAASA,wBAAwB;UAIhBC,mBAAAA;oBAEFC,QAAQC,iBAAkC,GAAGC,WAAAA,mBAA8B;oBAC3EC,eAAeF,iBAAwB,GAAGC,WAAAA,mBAA8B;AACvF,GAJiBH,qBAAAA,mBAAAA,CAAAA,EAAAA;;",
-  "names": ["defineCapability", "HelpCapabilities", "State", "defineCapability", "HELP_PLUGIN", "MutableState"]
-}