@dxos/plugin-help 0.7.5-feature-compute.4d9d99a → 0.7.5-labs.071a3e2

package/dist/lib/browser/{app-graph-builder-G3FCDRBG.mjs → app-graph-builder-X4XWALX3.mjs}

@@ -1,6 +1,6 @@
 import {
   SHORTCUTS_DIALOG
-} from "./chunk-VNAN5GRY.mjs";
+} from "./chunk-C7PCVS5K.mjs";
 import {
   HelpAction
 } from "./chunk-24E4WRKH.mjs";
@@ -49,9 +49,12 @@ var app_graph_builder_default = (context) => contributes(Capabilities.AppGraphBu
         const { dispatchPromise: dispatch } = context.requestCapability(Capabilities.IntentDispatcher);
         const state = context.requestCapability(HelpCapabilities.MutableState);
         state.showHints = true;
-        await dispatch?.(createIntent(LayoutAction.SetLayout, {
-          element: "dialog",
-          component: SHORTCUTS_DIALOG
+        await dispatch(createIntent(LayoutAction.UpdateDialog, {
+          part: "dialog",
+          subject: SHORTCUTS_DIALOG,
+          options: {
+            blockAlign: "center"
+          }
         }));
       },
       properties: {
@@ -72,4 +75,4 @@ var app_graph_builder_default = (context) => contributes(Capabilities.AppGraphBu
 export {
   app_graph_builder_default as default
 };
-//# sourceMappingURL=app-graph-builder-G3FCDRBG.mjs.map
+//# sourceMappingURL=app-graph-builder-X4XWALX3.mjs.map

package/dist/lib/browser/{app-graph-builder-G3FCDRBG.mjs.map → app-graph-builder-X4XWALX3.mjs.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/capabilities/app-graph-builder.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capabilities, contributes, createIntent, LayoutAction, type PluginsContext } from '@dxos/app-framework';\nimport { createExtension, type Node } 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: PluginsContext) =>\n  contributes(\n    Capabilities.AppGraphBuilder,\n    createExtension({\n      id: HELP_PLUGIN,\n      filter: (node): node is Node<null> => node.id === 'root',\n      actions: () => [\n        {\n          id: HelpAction.Start._tag,\n          data: async () => {\n            const { dispatchPromise: dispatch } = context.requestCapability(Capabilities.IntentDispatcher);\n            const state = context.requestCapability(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.requestCapability(Capabilities.IntentDispatcher);\n            const state = context.requestCapability(HelpCapabilities.MutableState);\n            state.showHints = true;\n            await dispatch?.(createIntent(LayoutAction.SetLayout, { element: 'dialog', component: SHORTCUTS_DIALOG }));\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    }),\n  );\n"],
-  "mappings": ";;;;;;;;;;;;;;AAIA,SAASA,cAAcC,aAAaC,cAAcC,oBAAyC;AAC3F,SAASC,uBAAkC;AAO3C,IAAA,4BAAe,CAACC,YACdC,YACEC,aAAaC,iBACbC,gBAAgB;EACdC,IAAIC;EACJC,QAAQ,CAACC,SAA6BA,KAAKH,OAAO;EAClDI,SAAS,MAAM;IACb;MACEJ,IAAIK,WAAWC,MAAMC;MACrBC,MAAM,YAAA;AACJ,cAAM,EAAEC,iBAAiBC,SAAQ,IAAKf,QAAQgB,kBAAkBd,aAAae,gBAAgB;AAC7F,cAAMC,QAAQlB,QAAQgB,kBAAkBG,iBAAiBC,YAAY;AACrEF,cAAMG,YAAY;AAClB,cAAMN,SAASO,aAAaZ,WAAWC,KAAK,CAAA;MAC9C;MACAY,YAAY;QACVC,OAAO;UAAC;UAAkB;YAAEC,IAAInB;UAAY;;QAC5CoB,MAAM;QACNC,YAAY;UACVC,OAAO;;UAEPC,SAAS;UACTC,OAAO;QACT;QACAC,QAAQ;MACV;IACF;IACA;MACE1B,IAAI;MACJQ,MAAM,YAAA;AACJ,cAAM,EAAEC,iBAAiBC,SAAQ,IAAKf,QAAQgB,kBAAkBd,aAAae,gBAAgB;AAC7F,cAAMC,QAAQlB,QAAQgB,kBAAkBG,iBAAiBC,YAAY;AACrEF,cAAMG,YAAY;AAClB,cAAMN,WAAWO,aAAaU,aAAaC,WAAW;UAAEC,SAAS;UAAUC,WAAWC;QAAiB,CAAA,CAAA;MACzG;MACAb,YAAY;QACVC,OAAO;UAAC;UAAwB;YAAEC,IAAInB;UAAY;;QAClDoB,MAAM;QACNC,YAAY;UACVC,OAAO;QACT;MACF;IACF;;AAEJ,CAAA,CAAA;",
-  "names": ["Capabilities", "contributes", "createIntent", "LayoutAction", "createExtension", "context", "contributes", "Capabilities", "AppGraphBuilder", "createExtension", "id", "HELP_PLUGIN", "filter", "node", "actions", "HelpAction", "Start", "_tag", "data", "dispatchPromise", "dispatch", "requestCapability", "IntentDispatcher", "state", "HelpCapabilities", "MutableState", "showHints", "createIntent", "properties", "label", "ns", "icon", "keyBinding", "macos", "windows", "linux", "testId", "LayoutAction", "SetLayout", "element", "component", "SHORTCUTS_DIALOG"]
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capabilities, contributes, createIntent, LayoutAction, type PluginsContext } from '@dxos/app-framework';\nimport { createExtension, type Node } 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: PluginsContext) =>\n  contributes(\n    Capabilities.AppGraphBuilder,\n    createExtension({\n      id: HELP_PLUGIN,\n      filter: (node): node is Node<null> => node.id === 'root',\n      actions: () => [\n        {\n          id: HelpAction.Start._tag,\n          data: async () => {\n            const { dispatchPromise: dispatch } = context.requestCapability(Capabilities.IntentDispatcher);\n            const state = context.requestCapability(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.requestCapability(Capabilities.IntentDispatcher);\n            const state = context.requestCapability(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    }),\n  );\n"],
+  "mappings": ";;;;;;;;;;;;;;AAIA,SAASA,cAAcC,aAAaC,cAAcC,oBAAyC;AAC3F,SAASC,uBAAkC;AAO3C,IAAA,4BAAe,CAACC,YACdC,YACEC,aAAaC,iBACbC,gBAAgB;EACdC,IAAIC;EACJC,QAAQ,CAACC,SAA6BA,KAAKH,OAAO;EAClDI,SAAS,MAAM;IACb;MACEJ,IAAIK,WAAWC,MAAMC;MACrBC,MAAM,YAAA;AACJ,cAAM,EAAEC,iBAAiBC,SAAQ,IAAKf,QAAQgB,kBAAkBd,aAAae,gBAAgB;AAC7F,cAAMC,QAAQlB,QAAQgB,kBAAkBG,iBAAiBC,YAAY;AACrEF,cAAMG,YAAY;AAClB,cAAMN,SAASO,aAAaZ,WAAWC,KAAK,CAAA;MAC9C;MACAY,YAAY;QACVC,OAAO;UAAC;UAAkB;YAAEC,IAAInB;UAAY;;QAC5CoB,MAAM;QACNC,YAAY;UACVC,OAAO;;UAEPC,SAAS;UACTC,OAAO;QACT;QACAC,QAAQ;MACV;IACF;IACA;MACE1B,IAAI;MACJQ,MAAM,YAAA;AACJ,cAAM,EAAEC,iBAAiBC,SAAQ,IAAKf,QAAQgB,kBAAkBd,aAAae,gBAAgB;AAC7F,cAAMC,QAAQlB,QAAQgB,kBAAkBG,iBAAiBC,YAAY;AACrEF,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,IAAInB;UAAY;;QAClDoB,MAAM;QACNC,YAAY;UACVC,OAAO;QACT;MACF;IACF;;AAEJ,CAAA,CAAA;",
+  "names": ["Capabilities", "contributes", "createIntent", "LayoutAction", "createExtension", "context", "contributes", "Capabilities", "AppGraphBuilder", "createExtension", "id", "HELP_PLUGIN", "filter", "node", "actions", "HelpAction", "Start", "_tag", "data", "dispatchPromise", "dispatch", "requestCapability", "IntentDispatcher", "state", "HelpCapabilities", "MutableState", "showHints", "createIntent", "properties", "label", "ns", "icon", "keyBinding", "macos", "windows", "linux", "testId", "LayoutAction", "UpdateDialog", "part", "subject", "SHORTCUTS_DIALOG", "options", "blockAlign"]
 }

package/dist/lib/browser/{chunk-VNAN5GRY.mjs → chunk-C7PCVS5K.mjs}

@@ -5,12 +5,130 @@ import {
   HELP_PLUGIN
 } from "./chunk-76XWX6N3.mjs";
 
+// packages/plugins/plugin-help/src/components/Shortcuts/Key.tsx
+import React from "react";
+import { keySymbols } from "@dxos/keyboard";
+
+// packages/plugins/plugin-help/src/components/Shortcuts/styles.ts
+import { mx } from "@dxos/react-ui-theme";
+var 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");
+
+// packages/plugins/plugin-help/src/components/Shortcuts/Key.tsx
+var Key = ({ binding }) => {
+  return /* @__PURE__ */ React.createElement("span", {
+    role: "term",
+    className: "inline-flex gap-1",
+    "aria-label": binding,
+    id: binding
+  }, keySymbols(binding).map((c, i) => /* @__PURE__ */ React.createElement("span", {
+    key: i,
+    className: shortcutKey
+  }, c)));
+};
+
+// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsList.tsx
+import React2, { Fragment } from "react";
+import { Keyboard } from "@dxos/keyboard";
+import { toLocalizedString, useTranslation } from "@dxos/react-ui";
+import { mx as mx2 } from "@dxos/react-ui-theme";
+var ShortcutsList = () => {
+  const { t } = useTranslation(HELP_PLUGIN);
+  const bindings = Keyboard.singleton.getBindings();
+  bindings.sort((a, b) => {
+    return toLocalizedString(a.data, t)?.toLowerCase().localeCompare(toLocalizedString(b.data, t)?.toLowerCase());
+  });
+  return /* @__PURE__ */ React2.createElement("dl", {
+    className: mx2("is-fit grid grid-cols-[min-content_minmax(12rem,1fr)] gap-2 mlb-4 text-subdued")
+  }, bindings.map((binding, i) => /* @__PURE__ */ React2.createElement(Fragment, {
+    key: i
+  }, /* @__PURE__ */ React2.createElement(Key, {
+    binding: binding.shortcut
+  }), /* @__PURE__ */ React2.createElement("span", {
+    role: "definition",
+    className: "mis-4",
+    "aria-labelledby": binding.shortcut
+  }, toLocalizedString(binding.data, t)))));
+};
+
+// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsDialog.tsx
+import React3 from "react";
+import { Button, Dialog, Icon, useTranslation as useTranslation2 } from "@dxos/react-ui";
+var SHORTCUTS_DIALOG = `${HELP_PLUGIN}/ShortcutsDialog`;
+var ShortcutsDialogContent = () => {
+  const { t } = useTranslation2(HELP_PLUGIN);
+  return /* @__PURE__ */ React3.createElement(Dialog.Content, {
+    classNames: "p-0 bs-content max-bs-full md:max-is-[25rem] overflow-hidden"
+  }, /* @__PURE__ */ React3.createElement("div", {
+    role: "none",
+    className: "flex justify-between mbe-1 pbs-3 pis-2 pie-3 @md:pbs-4 @md:pis-4 @md:pie-5"
+  }, /* @__PURE__ */ React3.createElement(Dialog.Title, null, t("shortcuts dialog title")), /* @__PURE__ */ React3.createElement(Dialog.Close, {
+    asChild: true
+  }, /* @__PURE__ */ React3.createElement(Button, {
+    density: "fine",
+    variant: "ghost",
+    autoFocus: true
+  }, /* @__PURE__ */ React3.createElement(Icon, {
+    icon: "ph--x--regular",
+    size: 3
+  })))), /* @__PURE__ */ React3.createElement("div", {
+    className: "flex items-center justify-center"
+  }, /* @__PURE__ */ React3.createElement(ShortcutsList, null)));
+};
+
+// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsHints.tsx
+import React4 from "react";
+import { Keyboard as Keyboard2 } from "@dxos/keyboard";
+import { Button as Button2, Icon as Icon2, toLocalizedString as toLocalizedString2, useTranslation as useTranslation3 } from "@dxos/react-ui";
+var Shortcut = ({ binding }) => {
+  const { t } = useTranslation3("os");
+  return /* @__PURE__ */ React4.createElement("div", {
+    role: "none",
+    className: "flex items-center gap-2 whitespace-nowrap"
+  }, /* @__PURE__ */ React4.createElement(Key, {
+    binding: binding.shortcut
+  }), /* @__PURE__ */ React4.createElement("span", {
+    className: "text-sm"
+  }, toLocalizedString2(binding.data, t)));
+};
+var ShortcutsHints = ({ onClose }) => {
+  const defaults = [
+    "meta+k",
+    "meta+/",
+    "meta+,"
+  ];
+  const bindings = Keyboard2.singleton.getBindings();
+  const hints = bindings.filter((binding) => defaults.includes(binding.shortcut));
+  return /* @__PURE__ */ React4.createElement("div", {
+    role: "none",
+    className: "flex overflow-hidden px-2 gap-4"
+  }, hints.map((binding) => /* @__PURE__ */ React4.createElement(Shortcut, {
+    key: binding.shortcut,
+    binding
+  })), onClose && /* @__PURE__ */ React4.createElement(Button2, {
+    variant: "ghost",
+    classNames: "p-0 cursor-pointer",
+    onClick: onClose
+  }, /* @__PURE__ */ React4.createElement(Icon2, {
+    icon: "ph--x--regular",
+    size: 4
+  })));
+};
+
+// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsSection.tsx
+import React5 from "react";
+import { descriptionText } from "@dxos/react-ui-theme";
+var ShortcutsSection = () => {
+  return /* @__PURE__ */ React5.createElement("section", {
+    className: descriptionText
+  }, /* @__PURE__ */ React5.createElement(ShortcutsList, null));
+};
+
 // packages/plugins/plugin-help/src/components/Tooltip/Tooltip.tsx
 import { useArrowNavigationGroup, useFocusableGroup } from "@fluentui/react-tabster";
 import { CaretLeft, CaretRight, Circle, X } from "@phosphor-icons/react";
-import React, { forwardRef } from "react";
-import { Button } from "@dxos/react-ui";
-import { getSize, mx } from "@dxos/react-ui-theme";
+import React6, { forwardRef } from "react";
+import { Button as Button3 } from "@dxos/react-ui";
+import { getSize, mx as mx3 } from "@dxos/react-ui-theme";
 var floaterProps = {
   styles: {
     // Arrow color is set by joyride.
@@ -31,32 +149,32 @@ var Tooltip = /* @__PURE__ */ forwardRef(({ step: { title, content }, index, siz
   const trapFocus = useFocusableGroup({
     tabBehavior: "limited-trap-focus"
   });
-  return /* @__PURE__ */ React.createElement("div", {
+  return /* @__PURE__ */ React6.createElement("div", {
     className: "flex flex-col is-[15rem] min-bs-[10rem] overflow-hidden rounded-md shadow-xl bg-accentSurface text-inverse",
     role: "tooltip",
     "data-testid": "helpPlugin.tooltip",
     "data-step": index + 1,
     ...trapFocus,
     ref: forwardedRef
-  }, /* @__PURE__ */ React.createElement("div", {
+  }, /* @__PURE__ */ React6.createElement("div", {
     className: "flex p-2"
-  }, /* @__PURE__ */ React.createElement("h2", {
+  }, /* @__PURE__ */ React6.createElement("h2", {
     className: "grow pli-2 plb-1 text-lg font-medium text-inverse"
-  }, title), /* @__PURE__ */ React.createElement(Button, {
+  }, title), /* @__PURE__ */ React6.createElement(Button3, {
     density: "fine",
     variant: "primary",
     onClick: closeProps.onClick,
     title: closeProps["aria-label"],
     "data-testid": "helpPlugin.tooltip.close"
-  }, /* @__PURE__ */ React.createElement(X, {
+  }, /* @__PURE__ */ React6.createElement(X, {
     weight: "bold",
     className: getSize(4)
-  }))), /* @__PURE__ */ React.createElement("div", {
+  }))), /* @__PURE__ */ React6.createElement("div", {
     className: "flex grow pli-4 mlb-2"
-  }, content), /* @__PURE__ */ React.createElement("div", {
+  }, content), /* @__PURE__ */ React6.createElement("div", {
     className: "flex p-2 items-center justify-between",
     ...arrowGroup
-  }, /* @__PURE__ */ React.createElement(Button, {
+  }, /* @__PURE__ */ React6.createElement(Button3, {
     variant: "primary",
     onClick: backProps.onClick,
     title: backProps["aria-label"],
@@ -64,39 +182,39 @@ var Tooltip = /* @__PURE__ */ forwardRef(({ step: { title, content }, index, siz
       !(index > 0 && backProps) && "invisible"
     ],
     "data-testid": "helpPlugin.tooltip.back"
-  }, /* @__PURE__ */ React.createElement(CaretLeft, {
+  }, /* @__PURE__ */ React6.createElement(CaretLeft, {
     className: getSize(5)
-  })), /* @__PURE__ */ React.createElement("div", {
+  })), /* @__PURE__ */ React6.createElement("div", {
     className: "flex grow gap-2 justify-center"
-  }, /* @__PURE__ */ React.createElement("div", {
+  }, /* @__PURE__ */ React6.createElement("div", {
     className: "flex"
   }, Array.from({
     length: size
-  }).map((_, i) => /* @__PURE__ */ React.createElement(Circle, {
+  }).map((_, i) => /* @__PURE__ */ React6.createElement(Circle, {
     key: i,
     weight: index === i ? "fill" : "regular",
-    className: mx(getSize(2), "mli-1 cursor-pointer")
-  })))), isLastStep ? /* @__PURE__ */ React.createElement(Button, {
+    className: mx3(getSize(2), "mli-1 cursor-pointer")
+  })))), isLastStep ? /* @__PURE__ */ React6.createElement(Button3, {
     variant: "primary",
     onClick: closeProps.onClick,
     title: closeProps["aria-label"],
     autoFocus: true,
     "data-testid": "helpPlugin.tooltip.finish"
-  }, "Done") : /* @__PURE__ */ React.createElement(Button, {
+  }, "Done") : /* @__PURE__ */ React6.createElement(Button3, {
     variant: "primary",
     onClick: primaryProps.onClick,
     title: primaryProps["aria-label"],
     autoFocus: true,
     "data-testid": "helpPlugin.tooltip.next"
-  }, /* @__PURE__ */ React.createElement(CaretRight, {
+  }, /* @__PURE__ */ React6.createElement(CaretRight, {
     className: getSize(6)
   }))));
 });
 
-// packages/plugins/plugin-help/src/components/HelpContextProvider/HelpContextProvider.tsx
-import React2, { useState, useEffect } from "react";
+// packages/plugins/plugin-help/src/components/WelcomeTour/WelcomeTour.tsx
+import React7, { useState, useEffect } from "react";
 import Joyride, { ACTIONS, EVENTS } from "react-joyride";
-import { usePluginManager, useCapability, Capabilities } from "@dxos/app-framework";
+import { usePluginManager, useLayout } from "@dxos/app-framework";
 var addStepClass = (target) => {
   const element = typeof target === "string" ? document.querySelector(target) : target;
   if (element) {
@@ -138,9 +256,9 @@ var waitForTarget = async (step) => {
     });
   }
 };
-var HelpContextProvider = ({ children, steps: initialSteps, running: runningProp, onRunningChanged }) => {
+var WelcomeTour = ({ steps: initialSteps, running: runningProp, onRunningChanged }) => {
   const manager = usePluginManager();
-  const layout = useCapability(Capabilities.Layout);
+  const layout = useLayout();
   const [running, setRunning] = useState(!!runningProp && !!getTarget(initialSteps[0]));
   const [stepIndex, _setStepIndex] = useState(0);
   const [steps, setSteps] = useState(initialSteps);
@@ -207,7 +325,7 @@ var HelpContextProvider = ({ children, steps: initialSteps, running: runningProp
         break;
     }
   };
-  return /* @__PURE__ */ React2.createElement(HelpContext.Provider, {
+  return /* @__PURE__ */ React7.createElement(HelpContext.Provider, {
     value: {
       running: running && !paused,
       steps,
@@ -216,9 +334,9 @@ var HelpContextProvider = ({ children, steps: initialSteps, running: runningProp
       start: () => setRunningChanged(true),
       stop: () => setRunningChanged(false)
     }
-  }, /* @__PURE__ */ React2.createElement("style", null, `.joyride-target {
+  }, /* @__PURE__ */ React7.createElement("style", null, `.joyride-target {
           --controls-opacity: 1;
-        }`), /* @__PURE__ */ React2.createElement(Joyride, {
+        }`), /* @__PURE__ */ React7.createElement(Joyride, {
     continuous: true,
     steps,
     stepIndex,
@@ -226,136 +344,18 @@ var HelpContextProvider = ({ children, steps: initialSteps, running: runningProp
     callback,
     floaterProps,
     tooltipComponent: Tooltip
-  }), children);
-};
-
-// packages/plugins/plugin-help/src/components/Shortcuts/Key.tsx
-import React3 from "react";
-import { keySymbols } from "@dxos/keyboard";
-
-// packages/plugins/plugin-help/src/components/Shortcuts/styles.ts
-import { mx as mx2 } from "@dxos/react-ui-theme";
-var shortcutKey = mx2("inline-flex min-is-[24px] bs-[24px] pli-0.5 justify-center items-center text-xs", "rounded bg-neutral-100 dark:bg-neutral-900");
-
-// packages/plugins/plugin-help/src/components/Shortcuts/Key.tsx
-var Key = ({ binding }) => {
-  return /* @__PURE__ */ React3.createElement("span", {
-    role: "term",
-    className: "inline-flex gap-1",
-    "aria-label": binding,
-    id: binding
-  }, keySymbols(binding).map((c, i) => /* @__PURE__ */ React3.createElement("span", {
-    key: i,
-    className: shortcutKey
-  }, c)));
-};
-
-// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsList.tsx
-import React4, { Fragment } from "react";
-import { Keyboard } from "@dxos/keyboard";
-import { toLocalizedString, useTranslation } from "@dxos/react-ui";
-import { mx as mx3 } from "@dxos/react-ui-theme";
-var ShortcutsList = () => {
-  const { t } = useTranslation(HELP_PLUGIN);
-  const bindings = Keyboard.singleton.getBindings();
-  bindings.sort((a, b) => {
-    return toLocalizedString(a.data, t)?.toLowerCase().localeCompare(toLocalizedString(b.data, t)?.toLowerCase());
-  });
-  return /* @__PURE__ */ React4.createElement("dl", {
-    className: mx3("is-fit grid grid-cols-[min-content_minmax(12rem,1fr)] gap-2 mlb-4 text-subdued")
-  }, bindings.map((binding, i) => /* @__PURE__ */ React4.createElement(Fragment, {
-    key: i
-  }, /* @__PURE__ */ React4.createElement(Key, {
-    binding: binding.shortcut
-  }), /* @__PURE__ */ React4.createElement("span", {
-    role: "definition",
-    className: "mis-4",
-    "aria-labelledby": binding.shortcut
-  }, toLocalizedString(binding.data, t)))));
-};
-
-// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsDialog.tsx
-import React5 from "react";
-import { Button as Button2, Dialog, Icon, useTranslation as useTranslation2 } from "@dxos/react-ui";
-var SHORTCUTS_DIALOG = `${HELP_PLUGIN}/ShortcutsDialog`;
-var ShortcutsDialogContent = () => {
-  const { t } = useTranslation2(HELP_PLUGIN);
-  return /* @__PURE__ */ React5.createElement(Dialog.Content, {
-    classNames: "p-0 bs-content max-bs-full md:max-is-[25rem] overflow-hidden"
-  }, /* @__PURE__ */ React5.createElement("div", {
-    role: "none",
-    className: "flex justify-between mbe-1 pbs-3 pis-2 pie-3 @md:pbs-4 @md:pis-4 @md:pie-5"
-  }, /* @__PURE__ */ React5.createElement(Dialog.Title, null, t("shortcuts dialog title")), /* @__PURE__ */ React5.createElement(Dialog.Close, {
-    asChild: true
-  }, /* @__PURE__ */ React5.createElement(Button2, {
-    density: "fine",
-    variant: "ghost",
-    autoFocus: true
-  }, /* @__PURE__ */ React5.createElement(Icon, {
-    icon: "ph--x--regular",
-    size: 3
-  })))), /* @__PURE__ */ React5.createElement("div", {
-    className: "flex items-center justify-center"
-  }, /* @__PURE__ */ React5.createElement(ShortcutsList, null)));
-};
-
-// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsHints.tsx
-import React6 from "react";
-import { Keyboard as Keyboard2 } from "@dxos/keyboard";
-import { Button as Button3, Icon as Icon2, toLocalizedString as toLocalizedString2, useTranslation as useTranslation3 } from "@dxos/react-ui";
-var Shortcut = ({ binding }) => {
-  const { t } = useTranslation3("os");
-  return /* @__PURE__ */ React6.createElement("div", {
-    role: "none",
-    className: "flex items-center gap-2 whitespace-nowrap"
-  }, /* @__PURE__ */ React6.createElement(Key, {
-    binding: binding.shortcut
-  }), /* @__PURE__ */ React6.createElement("span", {
-    className: "text-sm"
-  }, toLocalizedString2(binding.data, t)));
-};
-var ShortcutsHints = ({ onClose }) => {
-  const defaults = [
-    "meta+k",
-    "meta+/",
-    "meta+,"
-  ];
-  const bindings = Keyboard2.singleton.getBindings();
-  const hints = bindings.filter((binding) => defaults.includes(binding.shortcut));
-  return /* @__PURE__ */ React6.createElement("div", {
-    role: "none",
-    className: "flex overflow-hidden px-2 gap-4"
-  }, hints.map((binding) => /* @__PURE__ */ React6.createElement(Shortcut, {
-    key: binding.shortcut,
-    binding
-  })), onClose && /* @__PURE__ */ React6.createElement(Button3, {
-    variant: "ghost",
-    classNames: "p-0 cursor-pointer",
-    onClick: onClose
-  }, /* @__PURE__ */ React6.createElement(Icon2, {
-    icon: "ph--x--regular",
-    size: 4
-  })));
-};
-
-// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsSection.tsx
-import React7 from "react";
-import { descriptionText } from "@dxos/react-ui-theme";
-var ShortcutsSection = () => {
-  return /* @__PURE__ */ React7.createElement("section", {
-    className: descriptionText
-  }, /* @__PURE__ */ React7.createElement(ShortcutsList, null));
+  }));
 };
 
 export {
-  floaterProps,
-  Tooltip,
-  HelpContextProvider,
   Key,
   ShortcutsList,
   SHORTCUTS_DIALOG,
   ShortcutsDialogContent,
   ShortcutsHints,
-  ShortcutsSection
+  ShortcutsSection,
+  floaterProps,
+  Tooltip,
+  WelcomeTour
 };
-//# sourceMappingURL=chunk-VNAN5GRY.mjs.map
+//# sourceMappingURL=chunk-C7PCVS5K.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/components/Shortcuts/Key.tsx", "../../../src/components/Shortcuts/styles.ts", "../../../src/components/Shortcuts/ShortcutsList.tsx", "../../../src/components/Shortcuts/ShortcutsDialog.tsx", "../../../src/components/Shortcuts/ShortcutsHints.tsx", "../../../src/components/Shortcuts/ShortcutsSection.tsx", "../../../src/components/Tooltip/Tooltip.tsx", "../../../src/components/WelcomeTour/WelcomeTour.tsx"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport React from 'react';\n\nimport { keySymbols } from '@dxos/keyboard';\n\nimport { shortcutKey } from './styles';\n\nexport const Key = ({ binding }: { binding: string }) => {\n  return (\n    <span role='term' className='inline-flex gap-1' aria-label={binding} id={binding}>\n      {keySymbols(binding).map((c, i) => (\n        <span key={i} className={shortcutKey}>\n          {c}\n        </span>\n      ))}\n    </span>\n  );\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { mx } from '@dxos/react-ui-theme';\n\nexport const shortcutKey = mx(\n  'inline-flex min-is-[24px] bs-[24px] pli-0.5 justify-center items-center text-xs',\n  'rounded bg-neutral-100 dark:bg-neutral-900',\n);\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport React, { Fragment } from 'react';\n\nimport { Keyboard } from '@dxos/keyboard';\nimport { toLocalizedString, useTranslation } from '@dxos/react-ui';\nimport { mx } from '@dxos/react-ui-theme';\n\nimport { Key } from './Key';\nimport { HELP_PLUGIN } from '../../meta';\n\nexport const ShortcutsList = () => {\n  const { t } = useTranslation(HELP_PLUGIN);\n  const bindings = Keyboard.singleton.getBindings();\n\n  // TODO(burdon): Get shortcuts from TextEditor.\n  bindings.sort((a, b) => {\n    return toLocalizedString(a.data, t)?.toLowerCase().localeCompare(toLocalizedString(b.data, t)?.toLowerCase());\n  });\n\n  return (\n    <dl className={mx('is-fit grid grid-cols-[min-content_minmax(12rem,1fr)] gap-2 mlb-4 text-subdued')}>\n      {bindings.map((binding, i) => (\n        <Fragment key={i}>\n          <Key binding={binding.shortcut} />\n          <span role='definition' className='mis-4' aria-labelledby={binding.shortcut}>\n            {toLocalizedString(binding.data, t)}\n          </span>\n        </Fragment>\n      ))}\n    </dl>\n  );\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Button, Dialog, Icon, useTranslation } from '@dxos/react-ui';\n\nimport { ShortcutsList } from './ShortcutsList';\nimport { HELP_PLUGIN } from '../../meta';\n\nexport const SHORTCUTS_DIALOG = `${HELP_PLUGIN}/ShortcutsDialog`;\n\nexport const ShortcutsDialogContent = () => {\n  const { t } = useTranslation(HELP_PLUGIN);\n\n  return (\n    <Dialog.Content classNames='p-0 bs-content max-bs-full md:max-is-[25rem] overflow-hidden'>\n      <div role='none' className='flex justify-between mbe-1 pbs-3 pis-2 pie-3 @md:pbs-4 @md:pis-4 @md:pie-5'>\n        <Dialog.Title>{t('shortcuts dialog title')}</Dialog.Title>\n\n        <Dialog.Close asChild>\n          <Button density='fine' variant='ghost' autoFocus>\n            <Icon icon='ph--x--regular' size={3} />\n          </Button>\n        </Dialog.Close>\n      </div>\n\n      <div className='flex items-center justify-center'>\n        <ShortcutsList />\n      </div>\n    </Dialog.Content>\n  );\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { type KeyBinding, Keyboard } from '@dxos/keyboard';\nimport { Button, Icon, toLocalizedString, useTranslation } from '@dxos/react-ui';\n\nimport { Key } from './Key';\n\nconst Shortcut = ({ binding }: { binding: KeyBinding }) => {\n  const { t } = useTranslation('os');\n  return (\n    <div role='none' className='flex items-center gap-2 whitespace-nowrap'>\n      <Key binding={binding.shortcut} />\n      <span className='text-sm'>{toLocalizedString(binding.data, t)}</span>\n    </div>\n  );\n};\n\nexport const ShortcutsHints = ({ onClose }: { onClose?: () => void }) => {\n  // TODO(burdon): Display by context/weight/cycle.\n  const defaults = ['meta+k', 'meta+/', 'meta+,'];\n  const bindings = Keyboard.singleton.getBindings();\n  const hints = bindings.filter((binding) => defaults.includes(binding.shortcut));\n\n  return (\n    <div role='none' className='flex overflow-hidden px-2 gap-4'>\n      {hints.map((binding) => (\n        <Shortcut key={binding.shortcut} binding={binding} />\n      ))}\n      {onClose && (\n        <Button variant='ghost' classNames='p-0 cursor-pointer' onClick={onClose}>\n          <Icon icon='ph--x--regular' size={4} />\n        </Button>\n      )}\n    </div>\n  );\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport React from 'react';\n\nimport { descriptionText } from '@dxos/react-ui-theme';\n\nimport { ShortcutsList } from './ShortcutsList';\n\nexport const ShortcutsSection = () => {\n  return (\n    <section className={descriptionText}>\n      <ShortcutsList />\n    </section>\n  );\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { useArrowNavigationGroup, useFocusableGroup } from '@fluentui/react-tabster';\nimport { CaretLeft, CaretRight, Circle, X } from '@phosphor-icons/react';\nimport React, { forwardRef } from 'react';\n// 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.\n// eslint-disable-next-line unused-imports/no-unused-imports\nimport _floater from 'react-floater';\nimport { type TooltipRenderProps, type Props } from 'react-joyride';\n// 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.\n// eslint-disable-next-line unused-imports/no-unused-imports\nimport _typefest from 'type-fest';\n\nimport { Button } from '@dxos/react-ui';\nimport { getSize, mx } from '@dxos/react-ui-theme';\n\n// https://docs.react-joyride.com/styling\n// https://github.com/gilbarbara/react-floater\nexport const floaterProps: Props['floaterProps'] = {\n  styles: {\n    // Arrow color is set by joyride.\n    arrow: {\n      length: 8,\n      spread: 16,\n    },\n    floater: {\n      // TODO(burdon): Get tokens from theme.\n      filter: 'drop-shadow(0 0 0.75rem rgba(0, 0, 0, 0.2))',\n    },\n  },\n};\n\n// TODO(burdon): Add info link to docs.\nexport const Tooltip = forwardRef<HTMLDivElement, TooltipRenderProps>(\n  ({ step: { title, content }, index, size, isLastStep, backProps, closeProps, primaryProps }, forwardedRef) => {\n    const arrowGroup = useArrowNavigationGroup({ axis: 'horizontal' });\n    const trapFocus = useFocusableGroup({ tabBehavior: 'limited-trap-focus' });\n\n    return (\n      <div\n        className='flex flex-col is-[15rem] min-bs-[10rem] overflow-hidden rounded-md shadow-xl bg-accentSurface text-inverse'\n        role='tooltip'\n        data-testid='helpPlugin.tooltip'\n        data-step={index + 1}\n        {...trapFocus}\n        ref={forwardedRef}\n      >\n        <div className='flex p-2'>\n          <h2 className='grow pli-2 plb-1 text-lg font-medium text-inverse'>{title}</h2>\n          <Button\n            density='fine'\n            variant='primary'\n            onClick={closeProps.onClick}\n            title={closeProps['aria-label']}\n            data-testid='helpPlugin.tooltip.close'\n          >\n            <X weight='bold' className={getSize(4)} />\n          </Button>\n        </div>\n        <div className='flex grow pli-4 mlb-2'>{content}</div>\n        <div className='flex p-2 items-center justify-between' {...arrowGroup}>\n          {\n            <Button\n              variant='primary'\n              onClick={backProps.onClick}\n              title={backProps['aria-label']}\n              classNames={[!(index > 0 && backProps) && 'invisible']}\n              data-testid='helpPlugin.tooltip.back'\n            >\n              <CaretLeft className={getSize(5)} />\n            </Button>\n          }\n          <div className='flex grow gap-2 justify-center'>\n            <div className='flex'>\n              {Array.from({ length: size }).map((_, i) => (\n                <Circle\n                  key={i}\n                  weight={index === i ? 'fill' : 'regular'}\n                  className={mx(getSize(2), 'mli-1 cursor-pointer')}\n                />\n              ))}\n            </div>\n          </div>\n          {isLastStep ? (\n            <Button\n              variant='primary'\n              onClick={closeProps.onClick}\n              title={closeProps['aria-label']}\n              autoFocus\n              data-testid='helpPlugin.tooltip.finish'\n            >\n              Done\n            </Button>\n          ) : (\n            <Button\n              variant='primary'\n              onClick={primaryProps.onClick}\n              title={primaryProps['aria-label']}\n              autoFocus\n              data-testid='helpPlugin.tooltip.next'\n            >\n              <CaretRight className={getSize(6)} />\n            </Button>\n          )}\n        </div>\n      </div>\n    );\n  },\n);\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { useState, useEffect } from 'react';\nimport Joyride, { ACTIONS, EVENTS } from 'react-joyride';\n\nimport { usePluginManager, useLayout } from '@dxos/app-framework';\n\nimport { type Step, HelpContext } from '../../types';\nimport { floaterProps, Tooltip } from '../Tooltip';\n\nconst addStepClass = (target: string | HTMLElement) => {\n  const element = typeof target === 'string' ? document.querySelector(target) : target;\n  if (element) {\n    element.classList.add('joyride-target');\n  }\n};\n\nconst removeTargetClass = (target: string | HTMLElement) => {\n  const element = typeof target === 'string' ? document.querySelector(target) : target;\n  if (element) {\n    element.classList.remove('joyride-target');\n  }\n};\n\nconst getTarget = (step: Step) => {\n  return typeof step.target === 'string' ? document.querySelector(step.target) : step.target;\n};\n\n/**\n * Wait for the target element to be in the document.\n */\nconst waitForTarget = async (step: Step) => {\n  if (typeof step.target === 'string') {\n    const target = step.target;\n    const element = document.querySelector(target);\n    if (element) {\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      const observer = new MutationObserver((mutations) => {\n        mutations.forEach((mutation) => {\n          if (mutation.addedNodes.length > 0) {\n            const element = document.querySelector(target);\n            if (element) {\n              observer.disconnect();\n              resolve();\n            }\n          }\n        });\n      });\n\n      observer.observe(document.body, { childList: true, subtree: true });\n    });\n  }\n};\n\nexport type WelcomeTourProps = {\n  steps: Step[];\n  running?: boolean;\n  onRunningChanged?: (state: boolean) => any;\n};\n\nexport const WelcomeTour = ({ steps: initialSteps, running: runningProp, onRunningChanged }: WelcomeTourProps) => {\n  const manager = usePluginManager();\n  const layout = useLayout();\n  const [running, setRunning] = useState(!!runningProp && !!getTarget(initialSteps[0]));\n  const [stepIndex, _setStepIndex] = useState(0);\n  const [steps, setSteps] = useState(initialSteps);\n\n  const paused = layout.dialogOpen;\n\n  const setStepIndex = (index: number) => {\n    if (runningProp) {\n      const step = steps[index];\n      step?.before?.(manager.context);\n    }\n    _setStepIndex(index);\n  };\n\n  const setRunningChanged = (state: boolean) => {\n    if (typeof runningProp !== 'undefined') {\n      onRunningChanged?.(state);\n    } else {\n      if (state) {\n        setStepIndex(0);\n        setRunning(true);\n      } else {\n        setRunning(false);\n      }\n    }\n  };\n\n  useEffect(() => {\n    const timeout = setTimeout(async () => {\n      if (runningProp) {\n        // This handles the case when the target is not yet in the document.\n        // If the target is not in the document, when the joyride is turned on, it will not show the tooltip.\n        await waitForTarget(steps[stepIndex]);\n        setStepIndex(0);\n        setRunning(true);\n      } else if (typeof runningProp !== 'undefined') {\n        setRunning(false);\n      }\n    });\n\n    return () => clearTimeout(timeout);\n  }, [runningProp]);\n\n  // https://docs.react-joyride.com/callback\n  const callback: Joyride['callback'] = async (options) => {\n    const { type, action, index, size } = options;\n    switch (type) {\n      case EVENTS.STEP_BEFORE:\n        addStepClass(options.step.target);\n        break;\n      case EVENTS.TOUR_END:\n        break;\n      case EVENTS.STEP_AFTER:\n        removeTargetClass(options.step.target);\n        switch (action) {\n          case ACTIONS.NEXT:\n            if (index < size - 1) {\n              setStepIndex(index + 1);\n            }\n            break;\n          case ACTIONS.PREV:\n            if (index > 0) {\n              setStepIndex(index - 1);\n            }\n            break;\n          case ACTIONS.CLOSE:\n            setRunningChanged(false);\n            setStepIndex(0);\n            break;\n        }\n        break;\n    }\n  };\n\n  return (\n    <HelpContext.Provider\n      value={{\n        running: running && !paused,\n        steps,\n        setSteps,\n        setIndex: setStepIndex,\n        start: () => setRunningChanged(true),\n        stop: () => setRunningChanged(false),\n      }}\n    >\n      <style>\n        {`.joyride-target {\n          --controls-opacity: 1;\n        }`}\n      </style>\n      <Joyride\n        continuous={true}\n        steps={steps}\n        stepIndex={stepIndex}\n        run={running && !paused}\n        callback={callback}\n        floaterProps={floaterProps}\n        tooltipComponent={Tooltip}\n      />\n    </HelpContext.Provider>\n  );\n};\n"],
+  "mappings": "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",
+  "names": ["React", "keySymbols", "mx", "shortcutKey", "mx", "Key", "binding", "span", "role", "className", "aria-label", "id", "keySymbols", "map", "c", "i", "key", "shortcutKey", "React", "Fragment", "Keyboard", "toLocalizedString", "useTranslation", "mx", "ShortcutsList", "t", "useTranslation", "HELP_PLUGIN", "bindings", "Keyboard", "singleton", "getBindings", "sort", "a", "b", "toLocalizedString", "data", "toLowerCase", "localeCompare", "React", "dl", "className", "mx", "map", "binding", "i", "Fragment", "key", "Key", "shortcut", "span", "role", "aria-labelledby", "React", "Button", "Dialog", "Icon", "useTranslation", "SHORTCUTS_DIALOG", "HELP_PLUGIN", "ShortcutsDialogContent", "t", "useTranslation", "React", "Dialog", "Content", "classNames", "div", "role", "className", "Title", "Close", "asChild", "Button", "density", "variant", "autoFocus", "Icon", "icon", "size", "ShortcutsList", "React", "Keyboard", "Button", "Icon", "toLocalizedString", "useTranslation", "Shortcut", "binding", "t", "useTranslation", "React", "div", "role", "className", "Key", "shortcut", "span", "toLocalizedString", "data", "ShortcutsHints", "onClose", "defaults", "bindings", "Keyboard", "singleton", "getBindings", "hints", "filter", "includes", "map", "key", "Button", "variant", "classNames", "onClick", "Icon", "icon", "size", "React", "descriptionText", "ShortcutsSection", "React", "section", "className", "descriptionText", "ShortcutsList", "useArrowNavigationGroup", "useFocusableGroup", "CaretLeft", "CaretRight", "Circle", "X", "React", "forwardRef", "Button", "getSize", "mx", "floaterProps", "styles", "arrow", "length", "spread", "floater", "filter", "Tooltip", "forwardRef", "step", "title", "content", "index", "size", "isLastStep", "backProps", "closeProps", "primaryProps", "forwardedRef", "arrowGroup", "useArrowNavigationGroup", "axis", "trapFocus", "useFocusableGroup", "tabBehavior", "React", "div", "className", "role", "data-testid", "data-step", "ref", "h2", "Button", "density", "variant", "onClick", "X", "weight", "getSize", "classNames", "CaretLeft", "Array", "from", "map", "_", "i", "Circle", "key", "mx", "autoFocus", "CaretRight", "React", "useState", "useEffect", "Joyride", "ACTIONS", "EVENTS", "usePluginManager", "useLayout", "addStepClass", "target", "element", "document", "querySelector", "classList", "add", "removeTargetClass", "remove", "getTarget", "step", "waitForTarget", "Promise", "resolve", "observer", "MutationObserver", "mutations", "forEach", "mutation", "addedNodes", "length", "disconnect", "observe", "body", "childList", "subtree", "WelcomeTour", "steps", "initialSteps", "running", "runningProp", "onRunningChanged", "manager", "usePluginManager", "layout", "useLayout", "setRunning", "useState", "stepIndex", "_setStepIndex", "setSteps", "paused", "dialogOpen", "setStepIndex", "index", "before", "context", "setRunningChanged", "state", "useEffect", "timeout", "setTimeout", "clearTimeout", "callback", "options", "type", "action", "size", "EVENTS", "STEP_BEFORE", "TOUR_END", "STEP_AFTER", "ACTIONS", "NEXT", "PREV", "CLOSE", "React", "HelpContext", "Provider", "value", "setIndex", "start", "stop", "style", "Joyride", "continuous", "run", "floaterProps", "tooltipComponent", "Tooltip"]
+}

package/dist/lib/browser/index.mjs

@@ -1,5 +1,4 @@
 import {
-  HelpContextProvider,
   Key,
   SHORTCUTS_DIALOG,
   ShortcutsDialogContent,
@@ -7,8 +6,9 @@ import {
   ShortcutsList,
   ShortcutsSection,
   Tooltip,
+  WelcomeTour,
   floaterProps
-} from "./chunk-VNAN5GRY.mjs";
+} from "./chunk-C7PCVS5K.mjs";
 import {
   HELP_ACTION,
   HelpAction,
@@ -24,9 +24,9 @@ import {
 
 // packages/plugins/plugin-help/src/capabilities/index.ts
 import { lazy } from "@dxos/app-framework";
-var AppGraphBuilder = lazy(() => import("./app-graph-builder-G3FCDRBG.mjs"));
-var ReactContext = lazy(() => import("./react-context-SIW6XKOC.mjs"));
-var ReactSurface = lazy(() => import("./react-surface-TZZUXIVX.mjs"));
+var AppGraphBuilder = lazy(() => import("./app-graph-builder-X4XWALX3.mjs"));
+var ReactRoot = lazy(() => import("./react-root-4AV22UGT.mjs"));
+var ReactSurface = lazy(() => import("./react-surface-7S3NUVZH.mjs"));
 var HelpState = lazy(() => import("./state-SLKOTRHH.mjs"));
 
 // packages/plugins/plugin-help/src/HelpPlugin.tsx
@@ -59,21 +59,24 @@ var HelpPlugin = ({ steps = [] }) => definePlugin(meta, [
     activate: () => contributes(Capabilities.Translations, translations_default)
   }),
   defineModule({
-    id: `${meta.id}/module/react-context`,
+    id: `${meta.id}/module/react-root`,
     activatesOn: Events.Startup,
-    activate: () => ReactContext(steps)
+    activate: () => ReactRoot(steps)
   }),
   defineModule({
     id: `${meta.id}/module/react-surface`,
-    activatesOn: Events.Startup,
+    activatesOn: Events.SetupSurfaces,
     activate: ReactSurface
   }),
   defineModule({
     id: `${meta.id}/module/intent-resolver`,
     activatesOn: Events.SetupIntents,
-    activate: (context) => contributes(Capabilities.IntentResolver, createResolver(HelpAction.Start, () => {
-      const state = context.requestCapability(HelpCapabilities.MutableState);
-      state.running = true;
+    activate: (context) => contributes(Capabilities.IntentResolver, createResolver({
+      intent: HelpAction.Start,
+      resolve: () => {
+        const state = context.requestCapability(HelpCapabilities.MutableState);
+        state.running = true;
+      }
     }))
   }),
   defineModule({
@@ -95,7 +98,6 @@ export {
   HelpAction,
   HelpCapabilities,
   HelpContext,
-  HelpContextProvider,
   HelpPlugin,
   Key,
   SHORTCUTS_DIALOG,
@@ -104,6 +106,7 @@ export {
   ShortcutsList,
   ShortcutsSection,
   Tooltip,
+  WelcomeTour,
   floaterProps,
   meta,
   useHelp

package/dist/lib/browser/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/capabilities/index.ts", "../../../src/HelpPlugin.tsx", "../../../src/translations.ts", "../../../src/hooks/useHelp.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { lazy } from '@dxos/app-framework';\n\nexport const AppGraphBuilder = lazy(() => import('./app-graph-builder'));\nexport const ReactContext = lazy(() => import('./react-context'));\nexport const ReactSurface = lazy(() => import('./react-surface'));\nexport const HelpState = lazy(() => import('./state'));\n\nexport * from './capabilities';\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { createResolver, defineModule, definePlugin, Events, contributes, Capabilities } from '@dxos/app-framework';\n\nimport { AppGraphBuilder, HelpState, ReactContext, ReactSurface } from './capabilities';\nimport { HelpCapabilities } from './capabilities/capabilities';\nimport { meta } from './meta';\nimport translations from './translations';\nimport { type Step, HelpAction } from './types';\n\nexport type HelpPluginOptions = { steps?: Step[] };\n\nexport const HelpPlugin = ({ steps = [] }: HelpPluginOptions) =>\n  definePlugin(meta, [\n    defineModule({\n      id: `${meta.id}/module/state`,\n      activatesOn: Events.Startup,\n      activate: HelpState,\n    }),\n    defineModule({\n      id: `${meta.id}/module/translations`,\n      activatesOn: Events.SetupTranslations,\n      activate: () => contributes(Capabilities.Translations, translations),\n    }),\n    defineModule({\n      id: `${meta.id}/module/react-context`,\n      activatesOn: Events.Startup,\n      activate: () => ReactContext(steps),\n    }),\n    defineModule({\n      id: `${meta.id}/module/react-surface`,\n      activatesOn: Events.Startup,\n      activate: ReactSurface,\n    }),\n    defineModule({\n      id: `${meta.id}/module/intent-resolver`,\n      activatesOn: Events.SetupIntents,\n      activate: (context) =>\n        contributes(\n          Capabilities.IntentResolver,\n          createResolver(HelpAction.Start, () => {\n            const state = context.requestCapability(HelpCapabilities.MutableState);\n            state.running = true;\n          }),\n        ),\n    }),\n    defineModule({\n      id: `${meta.id}/module/app-graph-builder`,\n      activatesOn: Events.SetupAppGraph,\n      activate: AppGraphBuilder,\n    }),\n  ]);\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { HELP_PLUGIN } from './meta';\n\nexport default [\n  {\n    'en-US': {\n      [HELP_PLUGIN]: {\n        'plugin name': 'Help',\n        'open help tour': 'Show welcome tour',\n        'open shortcuts label': 'Show shortcuts',\n        'shortcuts dialog title': 'Shortcuts',\n      },\n    },\n  },\n];\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { HelpContext } from '../types';\n\nexport const useHelp = () => {\n  return useContext(HelpContext) ?? raise(new Error('Missing HelpContext'));\n};\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;AAIA,SAASA,YAAY;AAEd,IAAMC,kBAAkBC,KAAK,MAAM,OAAO,kCAAA,CAAA;AAC1C,IAAMC,eAAeD,KAAK,MAAM,OAAO,8BAAA,CAAA;AACvC,IAAME,eAAeF,KAAK,MAAM,OAAO,8BAAA,CAAA;AACvC,IAAMG,YAAYH,KAAK,MAAM,OAAO,sBAAA,CAAA;;;ACL3C,SAASI,gBAAgBC,cAAcC,cAAcC,QAAQC,aAAaC,oBAAoB;;;ACE9F,IAAA,uBAAe;EACb;IACE,SAAS;MACP,CAACC,WAAAA,GAAc;QACb,eAAe;QACf,kBAAkB;QAClB,wBAAwB;QACxB,0BAA0B;MAC5B;IACF;EACF;;;;ADFK,IAAMC,aAAa,CAAC,EAAEC,QAAQ,CAAA,EAAE,MACrCC,aAAaC,MAAM;EACjBC,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOC;IACpBC,UAAUC;EACZ,CAAA;EACAN,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOI;IACpBF,UAAU,MAAMG,YAAYC,aAAaC,cAAcC,oBAAAA;EACzD,CAAA;EACAX,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOC;IACpBC,UAAU,MAAMO,aAAaf,KAAAA;EAC/B,CAAA;EACAG,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOC;IACpBC,UAAUQ;EACZ,CAAA;EACAb,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOW;IACpBT,UAAU,CAACU,YACTP,YACEC,aAAaO,gBACbC,eAAeC,WAAWC,OAAO,MAAA;AAC/B,YAAMC,QAAQL,QAAQM,kBAAkBC,iBAAiBC,YAAY;AACrEH,YAAMI,UAAU;IAClB,CAAA,CAAA;EAEN,CAAA;EACAxB,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOsB;IACpBpB,UAAUqB;EACZ,CAAA;CACD;;;AEjDH,SAASC,kBAAkB;AAE3B,SAASC,aAAa;AAIf,IAAMC,UAAU,MAAA;AACrB,SAAOC,WAAWC,WAAAA,KAAgBC,MAAM,IAAIC,MAAM,qBAAA,CAAA;AACpD;",
-  "names": ["lazy", "AppGraphBuilder", "lazy", "ReactContext", "ReactSurface", "HelpState", "createResolver", "defineModule", "definePlugin", "Events", "contributes", "Capabilities", "HELP_PLUGIN", "HelpPlugin", "steps", "definePlugin", "meta", "defineModule", "id", "activatesOn", "Events", "Startup", "activate", "HelpState", "SetupTranslations", "contributes", "Capabilities", "Translations", "translations", "ReactContext", "ReactSurface", "SetupIntents", "context", "IntentResolver", "createResolver", "HelpAction", "Start", "state", "requestCapability", "HelpCapabilities", "MutableState", "running", "SetupAppGraph", "AppGraphBuilder", "useContext", "raise", "useHelp", "useContext", "HelpContext", "raise", "Error"]
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { lazy } from '@dxos/app-framework';\n\nexport const AppGraphBuilder = lazy(() => import('./app-graph-builder'));\nexport const ReactRoot = lazy(() => import('./react-root'));\nexport const ReactSurface = lazy(() => import('./react-surface'));\nexport const HelpState = lazy(() => import('./state'));\n\nexport * from './capabilities';\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { createResolver, defineModule, definePlugin, Events, contributes, Capabilities } from '@dxos/app-framework';\n\nimport { AppGraphBuilder, HelpState, ReactRoot, ReactSurface } from './capabilities';\nimport { HelpCapabilities } from './capabilities/capabilities';\nimport { meta } from './meta';\nimport translations from './translations';\nimport { type Step, HelpAction } from './types';\n\nexport type HelpPluginOptions = { steps?: Step[] };\n\nexport const HelpPlugin = ({ steps = [] }: HelpPluginOptions) =>\n  definePlugin(meta, [\n    defineModule({\n      id: `${meta.id}/module/state`,\n      activatesOn: Events.Startup,\n      activate: HelpState,\n    }),\n    defineModule({\n      id: `${meta.id}/module/translations`,\n      activatesOn: Events.SetupTranslations,\n      activate: () => contributes(Capabilities.Translations, translations),\n    }),\n    defineModule({\n      id: `${meta.id}/module/react-root`,\n      activatesOn: Events.Startup,\n      activate: () => ReactRoot(steps),\n    }),\n    defineModule({\n      id: `${meta.id}/module/react-surface`,\n      activatesOn: Events.SetupSurfaces,\n      activate: ReactSurface,\n    }),\n    defineModule({\n      id: `${meta.id}/module/intent-resolver`,\n      activatesOn: Events.SetupIntents,\n      activate: (context) =>\n        contributes(\n          Capabilities.IntentResolver,\n          createResolver({\n            intent: HelpAction.Start,\n            resolve: () => {\n              const state = context.requestCapability(HelpCapabilities.MutableState);\n              state.running = true;\n            },\n          }),\n        ),\n    }),\n    defineModule({\n      id: `${meta.id}/module/app-graph-builder`,\n      activatesOn: Events.SetupAppGraph,\n      activate: AppGraphBuilder,\n    }),\n  ]);\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { HELP_PLUGIN } from './meta';\n\nexport default [\n  {\n    'en-US': {\n      [HELP_PLUGIN]: {\n        'plugin name': 'Help',\n        'open help tour': 'Show welcome tour',\n        'open shortcuts label': 'Show shortcuts',\n        'shortcuts dialog title': 'Shortcuts',\n      },\n    },\n  },\n];\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { HelpContext } from '../types';\n\nexport const useHelp = () => {\n  return useContext(HelpContext) ?? raise(new Error('Missing HelpContext'));\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;AAIA,SAASA,YAAY;AAEd,IAAMC,kBAAkBC,KAAK,MAAM,OAAO,kCAAA,CAAA;AAC1C,IAAMC,YAAYD,KAAK,MAAM,OAAO,2BAAA,CAAA;AACpC,IAAME,eAAeF,KAAK,MAAM,OAAO,8BAAA,CAAA;AACvC,IAAMG,YAAYH,KAAK,MAAM,OAAO,sBAAA,CAAA;;;ACL3C,SAASI,gBAAgBC,cAAcC,cAAcC,QAAQC,aAAaC,oBAAoB;;;ACE9F,IAAA,uBAAe;EACb;IACE,SAAS;MACP,CAACC,WAAAA,GAAc;QACb,eAAe;QACf,kBAAkB;QAClB,wBAAwB;QACxB,0BAA0B;MAC5B;IACF;EACF;;;;ADFK,IAAMC,aAAa,CAAC,EAAEC,QAAQ,CAAA,EAAE,MACrCC,aAAaC,MAAM;EACjBC,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOC;IACpBC,UAAUC;EACZ,CAAA;EACAN,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOI;IACpBF,UAAU,MAAMG,YAAYC,aAAaC,cAAcC,oBAAAA;EACzD,CAAA;EACAX,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOC;IACpBC,UAAU,MAAMO,UAAUf,KAAAA;EAC5B,CAAA;EACAG,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOU;IACpBR,UAAUS;EACZ,CAAA;EACAd,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOY;IACpBV,UAAU,CAACW,YACTR,YACEC,aAAaQ,gBACbC,eAAe;MACbC,QAAQC,WAAWC;MACnBC,SAAS,MAAA;AACP,cAAMC,QAAQP,QAAQQ,kBAAkBC,iBAAiBC,YAAY;AACrEH,cAAMI,UAAU;MAClB;IACF,CAAA,CAAA;EAEN,CAAA;EACA3B,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,OAAOyB;IACpBvB,UAAUwB;EACZ,CAAA;CACD;;;AEpDH,SAASC,kBAAkB;AAE3B,SAASC,aAAa;AAIf,IAAMC,UAAU,MAAA;AACrB,SAAOC,WAAWC,WAAAA,KAAgBC,MAAM,IAAIC,MAAM,qBAAA,CAAA;AACpD;",
+  "names": ["lazy", "AppGraphBuilder", "lazy", "ReactRoot", "ReactSurface", "HelpState", "createResolver", "defineModule", "definePlugin", "Events", "contributes", "Capabilities", "HELP_PLUGIN", "HelpPlugin", "steps", "definePlugin", "meta", "defineModule", "id", "activatesOn", "Events", "Startup", "activate", "HelpState", "SetupTranslations", "contributes", "Capabilities", "Translations", "translations", "ReactRoot", "SetupSurfaces", "ReactSurface", "SetupIntents", "context", "IntentResolver", "createResolver", "intent", "HelpAction", "Start", "resolve", "state", "requestCapability", "HelpCapabilities", "MutableState", "running", "SetupAppGraph", "AppGraphBuilder", "useContext", "raise", "useHelp", "useContext", "HelpContext", "raise", "Error"]
 }