@dxos/plugin-help 0.8.4-main.1da679c → 0.8.4-main.21d9917

package/src/meta.ts

@@ -2,13 +2,15 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type PluginMeta } from '@dxos/app-framework';
+import { type Plugin } from '@dxos/app-framework';
+import { trim } from '@dxos/util';
 
-// TODO(burdon): Rename Guide? Help?
-export const HELP_PLUGIN = 'dxos.org/plugin/help';
-
-export const meta: PluginMeta = {
-  id: HELP_PLUGIN,
+export const meta: Plugin.Meta = {
+  id: 'dxos.org/plugin/help',
   name: 'Help',
+  description: trim`
+    Built-in help system with documentation, tutorials, and contextual assistance.
+    Access keyboard shortcuts, feature guides, and support resources.
+  `,
   icon: 'ph--info--regular',
 };

package/src/types/capabilities.ts

@@ -0,0 +1,24 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type Atom } from '@effect-atom/atom-react';
+import * as Schema from 'effect/Schema';
+
+import { Capability } from '@dxos/app-framework';
+
+import { meta } from '../meta';
+
+export namespace HelpCapabilities {
+  export const StateSchema = Schema.mutable(
+    Schema.Struct({
+      running: Schema.Boolean,
+      showHints: Schema.Boolean,
+      showWelcome: Schema.Boolean,
+    }),
+  );
+
+  export type State = Schema.Schema.Type<typeof StateSchema>;
+
+  export const State = Capability.make<Atom.Writable<State>>(`${meta.id}/capability/state`);
+}

package/src/types/index.ts

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

package/src/types/schema.ts

@@ -2,16 +2,17 @@
 // 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';
 
-import { type PluginContext } from '@dxos/app-framework';
+import { Capability, type CapabilityManager } from '@dxos/app-framework';
+import { Operation } from '@dxos/operation';
 
 import { meta } from '../meta';
 
 export type Step = BaseStep & {
-  before?: (context: PluginContext) => void;
+  before?: (capabilities: CapabilityManager.CapabilityManager) => void;
 };
 
 export type HelpContextType = {
@@ -32,9 +33,12 @@ export const HelpContext: Context<HelpContextType> = createContext<HelpContextTy
   stop: () => {},
 });
 
-export namespace HelpAction {
-  export class Start extends Schema.TaggedClass<Start>()(`${meta.id}/action/start`, {
-    input: Schema.Void,
-    output: Schema.Void,
-  }) {}
+const HELP_OPERATION = `${meta.id}/operation`;
+
+export namespace HelpOperation {
+  export const Start = Operation.make({
+    meta: { key: `${HELP_OPERATION}/start`, name: 'Start Help' },
+    services: [Capability.Service],
+    schema: { input: Schema.Void, output: Schema.Void },
+  });
 }

package/dist/lib/browser/app-graph-builder-DB3PXQVE.mjs

@@ -1,79 +0,0 @@
-import {
-  SHORTCUTS_DIALOG
-} from "./chunk-4CVVSQQC.mjs";
-import {
-  HelpAction
-} from "./chunk-J2SJSGSX.mjs";
-import {
-  HelpCapabilities
-} from "./chunk-LDRUZNSN.mjs";
-import {
-  HELP_PLUGIN
-} from "./chunk-3Y4CMOZP.mjs";
-
-// src/capabilities/app-graph-builder.ts
-import { Rx } from "@effect-rx/rx-react";
-import { Option, pipe } from "effect";
-import { Capabilities, LayoutAction, contributes, createIntent } from "@dxos/app-framework";
-import { createExtension } from "@dxos/app-graph";
-var app_graph_builder_default = ((context) => contributes(Capabilities.AppGraphBuilder, createExtension({
-  id: HELP_PLUGIN,
-  actions: (node) => Rx.make((get) => pipe(get(node), Option.flatMap((node2) => node2.id === "root" ? Option.some(node2) : Option.none()), Option.map(() => [
-    {
-      id: HelpAction.Start._tag,
-      data: async () => {
-        const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
-        const state = context.getCapability(HelpCapabilities.MutableState);
-        state.showHints = true;
-        await dispatch(createIntent(HelpAction.Start));
-      },
-      properties: {
-        label: [
-          "open help tour",
-          {
-            ns: HELP_PLUGIN
-          }
-        ],
-        icon: "ph--info--regular",
-        keyBinding: {
-          macos: "shift+meta+/",
-          // TODO(wittjosiah): Test on windows to see if it behaves the same as linux.
-          windows: "shift+ctrl+/",
-          linux: "shift+ctrl+?"
-        },
-        testId: "helpPlugin.openHelp"
-      }
-    },
-    {
-      id: "dxos.org/plugin/help/open-shortcuts",
-      data: async () => {
-        const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
-        const state = context.getCapability(HelpCapabilities.MutableState);
-        state.showHints = true;
-        await dispatch(createIntent(LayoutAction.UpdateDialog, {
-          part: "dialog",
-          subject: SHORTCUTS_DIALOG,
-          options: {
-            blockAlign: "center"
-          }
-        }));
-      },
-      properties: {
-        label: [
-          "open shortcuts label",
-          {
-            ns: HELP_PLUGIN
-          }
-        ],
-        icon: "ph--keyboard--regular",
-        keyBinding: {
-          macos: "meta+ctrl+/"
-        }
-      }
-    }
-  ]), Option.getOrElse(() => [])))
-})));
-export {
-  app_graph_builder_default as default
-};
-//# sourceMappingURL=app-graph-builder-DB3PXQVE.mjs.map

package/dist/lib/browser/app-graph-builder-DB3PXQVE.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, LayoutAction, type PluginContext, contributes, createIntent } from '@dxos/app-framework';\nimport { createExtension } from '@dxos/app-graph';\n\nimport { SHORTCUTS_DIALOG } from '../components';\nimport { HELP_PLUGIN } from '../meta';\nimport { HelpAction } from '../types';\n\nimport { HelpCapabilities } from './capabilities';\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,cAAkCC,aAAaC,oBAAoB;AAC1F,SAASC,uBAAuB;AAQhC,IAAA,6BAAe,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", "LayoutAction", "contributes", "createIntent", "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-4CVVSQQC.mjs

@@ -1,407 +0,0 @@
-import {
-  HelpContext
-} from "./chunk-J2SJSGSX.mjs";
-import {
-  HELP_PLUGIN
-} from "./chunk-3Y4CMOZP.mjs";
-
-// src/components/Shortcuts/Key.tsx
-import { useSignals as _useSignals } from "@preact-signals/safe-react/tracking";
-import React from "react";
-import { keySymbols } from "@dxos/keyboard";
-
-// 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");
-
-// src/components/Shortcuts/Key.tsx
-var Key = ({ binding }) => {
-  var _effect = _useSignals();
-  try {
-    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)));
-  } finally {
-    _effect.f();
-  }
-};
-
-// src/components/Shortcuts/ShortcutsList.tsx
-import { useSignals as _useSignals2 } from "@preact-signals/safe-react/tracking";
-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 = () => {
-  var _effect = _useSignals2();
-  try {
-    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 select-none")
-    }, 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)))));
-  } finally {
-    _effect.f();
-  }
-};
-
-// src/components/Shortcuts/ShortcutsDialog.tsx
-import { useSignals as _useSignals3 } from "@preact-signals/safe-react/tracking";
-import React3 from "react";
-import { Button, Dialog, Icon, useTranslation as useTranslation2 } from "@dxos/react-ui";
-var SHORTCUTS_DIALOG = `${HELP_PLUGIN}/ShortcutsDialog`;
-var ShortcutsDialogContent = () => {
-  var _effect = _useSignals3();
-  try {
-    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--bold",
-      size: 3
-    })))), /* @__PURE__ */ React3.createElement("div", {
-      className: "flex items-center justify-center"
-    }, /* @__PURE__ */ React3.createElement(ShortcutsList, null)));
-  } finally {
-    _effect.f();
-  }
-};
-
-// src/components/Shortcuts/ShortcutsHints.tsx
-import { useSignals as _useSignals4 } from "@preact-signals/safe-react/tracking";
-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 }) => {
-  var _effect = _useSignals4();
-  try {
-    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)));
-  } finally {
-    _effect.f();
-  }
-};
-var ShortcutsHints = ({ onClose }) => {
-  var _effect = _useSignals4();
-  try {
-    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
-    })));
-  } finally {
-    _effect.f();
-  }
-};
-
-// src/components/Shortcuts/ShortcutsSection.tsx
-import { useSignals as _useSignals5 } from "@preact-signals/safe-react/tracking";
-import React5 from "react";
-import { descriptionText } from "@dxos/react-ui-theme";
-var ShortcutsSection = () => {
-  var _effect = _useSignals5();
-  try {
-    return /* @__PURE__ */ React5.createElement("section", {
-      className: descriptionText
-    }, /* @__PURE__ */ React5.createElement(ShortcutsList, null));
-  } finally {
-    _effect.f();
-  }
-};
-
-// src/components/Tooltip/Tooltip.tsx
-import { useSignals as _useSignals6 } from "@preact-signals/safe-react/tracking";
-import { useArrowNavigationGroup, useFocusableGroup } from "@fluentui/react-tabster";
-import React6, { forwardRef } from "react";
-import { Button as Button3, Icon as Icon3, IconButton } from "@dxos/react-ui";
-var floaterProps = {
-  styles: {
-    // Arrow color is set by joyride.
-    arrow: {
-      length: 8,
-      spread: 16
-    },
-    floater: {
-      // TODO(burdon): Get tokens from theme.
-      filter: "drop-shadow(0 0 0.75rem rgba(0, 0, 0, 0.2))"
-    }
-  }
-};
-var Tooltip = /* @__PURE__ */ forwardRef(({ step: { title, content }, index, size, isLastStep, backProps, closeProps, primaryProps }, forwardedRef) => {
-  var _effect = _useSignals6();
-  try {
-    const arrowNavigationAttrs = useArrowNavigationGroup({
-      axis: "horizontal"
-    });
-    const focusableGroupAttrs = useFocusableGroup({
-      tabBehavior: "limited-trap-focus"
-    });
-    return /* @__PURE__ */ React6.createElement("div", {
-      className: "flex flex-col is-[15rem] min-bs-[10rem] overflow-hidden rounded-md shadow-xl bg-accentSurface text-accentSurfaceText",
-      role: "tooltip",
-      "data-testid": "helpPlugin.tooltip",
-      "data-step": index + 1,
-      ...focusableGroupAttrs,
-      ref: forwardedRef
-    }, /* @__PURE__ */ React6.createElement("div", {
-      className: "flex p-2"
-    }, /* @__PURE__ */ React6.createElement("h2", {
-      className: "grow pli-2 plb-1 text-lg font-medium text-accentSurfaceText"
-    }, title), /* @__PURE__ */ React6.createElement(IconButton, {
-      density: "fine",
-      icon: "ph--x--bold",
-      iconOnly: true,
-      label: closeProps["aria-label"],
-      onClick: closeProps.onClick,
-      size: 4,
-      variant: "primary",
-      "data-testid": "helpPlugin.tooltip.close"
-    })), /* @__PURE__ */ React6.createElement("div", {
-      className: "flex grow pli-4 mlb-2"
-    }, content), /* @__PURE__ */ React6.createElement("div", {
-      className: "flex p-2 items-center justify-between",
-      ...arrowNavigationAttrs
-    }, /* @__PURE__ */ React6.createElement(IconButton, {
-      classNames: [
-        !(index > 0 && backProps) && "invisible"
-      ],
-      icon: "ph--caret-left--regular",
-      iconOnly: true,
-      label: backProps["aria-label"],
-      onClick: backProps.onClick,
-      size: 5,
-      variant: "primary",
-      "data-testid": "helpPlugin.tooltip.back"
-    }), /* @__PURE__ */ React6.createElement("div", {
-      className: "flex grow gap-2 justify-center"
-    }, /* @__PURE__ */ React6.createElement("div", {
-      className: "flex"
-    }, Array.from({
-      length: size
-    }).map((_, i) => /* @__PURE__ */ React6.createElement(Icon3, {
-      key: i,
-      icon: index === i ? "ph--circle--fill" : "ph--circle--regular",
-      size: 2,
-      classNames: "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__ */ React6.createElement(IconButton, {
-      autoFocus: true,
-      icon: "ph--caret-right--regular",
-      iconOnly: true,
-      label: primaryProps["aria-label"],
-      onClick: primaryProps.onClick,
-      size: 6,
-      variant: "primary",
-      "data-testid": "helpPlugin.tooltip.next"
-    })));
-  } finally {
-    _effect.f();
-  }
-});
-
-// src/components/WelcomeTour/WelcomeTour.tsx
-import { useSignals as _useSignals7 } from "@preact-signals/safe-react/tracking";
-import React7, { useState } from "react";
-import Joyride, { ACTIONS, EVENTS } from "react-joyride";
-import { useLayout, usePluginManager } from "@dxos/app-framework";
-import { useAsyncEffect } from "@dxos/react-ui";
-var addStepClass = (target) => {
-  const element = typeof target === "string" ? document.querySelector(target) : target;
-  if (element) {
-    element.classList.add("joyride-target");
-  }
-};
-var removeTargetClass = (target) => {
-  const element = typeof target === "string" ? document.querySelector(target) : target;
-  if (element) {
-    element.classList.remove("joyride-target");
-  }
-};
-var getTarget = (step) => {
-  return typeof step.target === "string" ? document.querySelector(step.target) : step.target;
-};
-var waitForTarget = async (step) => {
-  if (typeof step.target === "string") {
-    const target = step.target;
-    const element = document.querySelector(target);
-    if (element) {
-      return;
-    }
-    await new Promise((resolve) => {
-      const observer = new MutationObserver((mutations) => {
-        mutations.forEach((mutation) => {
-          if (mutation.addedNodes.length > 0) {
-            const element2 = document.querySelector(target);
-            if (element2) {
-              observer.disconnect();
-              resolve();
-            }
-          }
-        });
-      });
-      observer.observe(document.body, {
-        childList: true,
-        subtree: true
-      });
-    });
-  }
-};
-var WelcomeTour = ({ steps: initialSteps, running: runningProp, onRunningChanged }) => {
-  var _effect = _useSignals7();
-  try {
-    const manager = usePluginManager();
-    const layout = useLayout();
-    const [running, setRunning] = useState(!!runningProp && !!getTarget(initialSteps[0]));
-    const [stepIndex, _setStepIndex] = useState(0);
-    const [steps, setSteps] = useState(initialSteps);
-    const paused = layout.dialogOpen;
-    const setStepIndex = (index) => {
-      if (runningProp) {
-        const step = steps[index];
-        step?.before?.(manager.context);
-      }
-      _setStepIndex(index);
-    };
-    const setRunningChanged = (state) => {
-      if (typeof runningProp !== "undefined") {
-        onRunningChanged?.(state);
-      } else {
-        if (state) {
-          setStepIndex(0);
-          setRunning(true);
-        } else {
-          setRunning(false);
-        }
-      }
-    };
-    useAsyncEffect(async () => {
-      if (runningProp) {
-        await waitForTarget(steps[stepIndex]);
-        setStepIndex(0);
-        setRunning(true);
-      } else if (typeof runningProp !== "undefined") {
-        setRunning(false);
-      }
-    }, [
-      runningProp
-    ]);
-    const callback = async (options) => {
-      const { type, action, index, size } = options;
-      switch (type) {
-        case EVENTS.STEP_BEFORE:
-          addStepClass(options.step.target);
-          break;
-        case EVENTS.TOUR_END:
-          break;
-        case EVENTS.STEP_AFTER:
-          removeTargetClass(options.step.target);
-          switch (action) {
-            case ACTIONS.NEXT:
-              if (index < size - 1) {
-                setStepIndex(index + 1);
-              }
-              break;
-            case ACTIONS.PREV:
-              if (index > 0) {
-                setStepIndex(index - 1);
-              }
-              break;
-            case ACTIONS.CLOSE:
-              setRunningChanged(false);
-              setStepIndex(0);
-              break;
-          }
-          break;
-      }
-    };
-    return /* @__PURE__ */ React7.createElement(HelpContext.Provider, {
-      value: {
-        running: running && !paused,
-        steps,
-        setSteps,
-        setIndex: setStepIndex,
-        start: () => setRunningChanged(true),
-        stop: () => setRunningChanged(false)
-      }
-    }, /* @__PURE__ */ React7.createElement("style", null, `.joyride-target {
-          --controls-opacity: 1;
-        }`), /* @__PURE__ */ React7.createElement(Joyride, {
-      continuous: true,
-      steps,
-      stepIndex,
-      run: running && !paused,
-      callback,
-      floaterProps,
-      tooltipComponent: Tooltip
-    }));
-  } finally {
-    _effect.f();
-  }
-};
-
-export {
-  Key,
-  ShortcutsList,
-  SHORTCUTS_DIALOG,
-  ShortcutsDialogContent,
-  ShortcutsHints,
-  ShortcutsSection,
-  floaterProps,
-  Tooltip,
-  WelcomeTour
-};
-//# sourceMappingURL=chunk-4CVVSQQC.mjs.map