@dxos/plugin-help 0.8.4-main.1068cf700f → 0.8.4-main.1c7ec43d41

package/src/containers/ShortcutsHints/ShortcutsHints.tsx

@@ -0,0 +1,5 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export { ShortcutsHints } from '../../components';

package/src/containers/ShortcutsHints/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export { ShortcutsHints as default } from './ShortcutsHints';

package/src/containers/ShortcutsList/ShortcutsList.tsx

@@ -0,0 +1,5 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+export { ShortcutsList } from '../../components';

package/src/containers/ShortcutsList/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+export { ShortcutsList as default } from './ShortcutsList';

package/src/containers/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { type ComponentType, lazy } from 'react';
+
+export const ShortcutsDialogContent: ComponentType<any> = lazy(() => import('./ShortcutsDialogContent'));
+export const ShortcutsHints: ComponentType<any> = lazy(() => import('./ShortcutsHints'));
+export const ShortcutsList: ComponentType<any> = lazy(() => import('./ShortcutsList'));

package/src/hooks/useHelp.tsx

@@ -6,7 +6,7 @@ import { useContext } from 'react';
 
 import { raise } from '@dxos/debug';
 
-import { HelpContext } from '../types';
+import { HelpContext } from '#types';
 
 export const useHelp = () => {
   return useContext(HelpContext) ?? raise(new Error('Missing HelpContext'));

package/src/index.ts

@@ -2,9 +2,14 @@
 // Copyright 2023 DXOS.org
 //
 
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from './meta';
+
 export { HelpCapabilities } from './types';
-export * from './components';
+export * from './constants';
 export * from './meta';
-export * from './HelpPlugin';
-export * from './hooks';
 export * from './types';
+
+export const HelpPlugin = Plugin.lazy(meta, () => import('#plugin'));
+export type { HelpPluginOptions } from '#plugin';

package/src/meta.ts

@@ -6,11 +6,12 @@ import { type Plugin } from '@dxos/app-framework';
 import { trim } from '@dxos/util';
 
 export const meta: Plugin.Meta = {
-  id: 'dxos.org/plugin/help',
+  id: 'org.dxos.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',
+  tags: ['system'],
 };

package/src/operations/definitions.ts

@@ -0,0 +1,19 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Schema from 'effect/Schema';
+
+import { Capability } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+
+import { meta } from '#meta';
+
+const HELP_OPERATION = `${meta.id}.operation`;
+
+export const Start = Operation.make({
+  meta: { key: `${HELP_OPERATION}.start`, name: 'Start Help' },
+  services: [Capability.Service],
+  input: Schema.Void,
+  output: Schema.Void,
+});

package/src/operations/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { OperationHandlerSet } from '@dxos/compute';
+
+export * as HelpOperation from './definitions';
+
+export const HelpOperationHandlerSet = OperationHandlerSet.lazy(() => import('./start'));

package/src/operations/start.ts

@@ -0,0 +1,21 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+
+import { HelpCapabilities } from '../types';
+import { Start } from './definitions';
+
+const handler: Operation.WithHandler<typeof Start> = Start.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* () {
+      yield* Capabilities.updateAtomValue(HelpCapabilities.State, (state) => ({ ...state, running: true }));
+    }),
+  ),
+);
+
+export default handler;

package/src/translations.ts

@@ -4,16 +4,16 @@
 
 import { type Resource } from '@dxos/react-ui';
 
-import { meta } from './meta';
+import { meta } from '#meta';
 
 export const translations = [
   {
     'en-US': {
       [meta.id]: {
-        'plugin name': 'Help',
-        'open help tour': 'Show welcome tour',
-        'open shortcuts label': 'Show shortcuts',
-        'shortcuts dialog title': 'Shortcuts',
+        'plugin.name': 'Help',
+        'open-help-tour.message': 'Show welcome tour',
+        'open-shortcuts.label': 'Show shortcuts',
+        'shortcuts-dialog.title': 'Shortcuts',
       },
     },
   },

package/src/types/capabilities.ts

@@ -7,7 +7,7 @@ import * as Schema from 'effect/Schema';
 
 import { Capability } from '@dxos/app-framework';
 
-import { meta } from '../meta';
+import { meta } from '#meta';
 
 export namespace HelpCapabilities {
   export const StateSchema = Schema.mutable(
@@ -20,5 +20,5 @@ export namespace HelpCapabilities {
 
   export type State = Schema.Schema.Type<typeof StateSchema>;
 
-  export const State = Capability.make<Atom.Writable<State>>(`${meta.id}/capability/state`);
+  export const State = Capability.make<Atom.Writable<State>>(`${meta.id}.capability.state`);
 }

package/src/types/schema.ts

@@ -2,14 +2,10 @@
 // Copyright 2023 DXOS.org
 //
 
-import * as Schema from 'effect/Schema';
 import { type Context, createContext } from 'react';
 import { type Step as BaseStep } from 'react-joyride';
 
-import { Capability, type CapabilityManager } from '@dxos/app-framework';
-import { Operation } from '@dxos/operation';
-
-import { meta } from '../meta';
+import { type CapabilityManager } from '@dxos/app-framework';
 
 export type Step = BaseStep & {
   before?: (capabilities: CapabilityManager.CapabilityManager) => void;
@@ -32,13 +28,3 @@ export const HelpContext: Context<HelpContextType> = createContext<HelpContextTy
   start: () => {},
   stop: () => {},
 });
-
-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-QSESB5XF.mjs

@@ -1,80 +0,0 @@
-import {
-  SHORTCUTS_DIALOG
-} from "./chunk-M5LBB7IY.mjs";
-import {
-  HelpCapabilities,
-  HelpOperation
-} from "./chunk-TS66J4C6.mjs";
-import {
-  meta
-} from "./chunk-IM2QVQOH.mjs";
-
-// src/capabilities/app-graph-builder/app-graph-builder.ts
-import * as Effect from "effect/Effect";
-import { Capabilities, Capability } from "@dxos/app-framework";
-import { GraphBuilder, NodeMatcher } from "@dxos/app-graph";
-import { AppCapabilities, LayoutOperation } from "@dxos/app-toolkit";
-import { Operation } from "@dxos/operation";
-var app_graph_builder_default = Capability.makeModule(Effect.fnUntraced(function* () {
-  const extensions = yield* GraphBuilder.createExtension({
-    id: meta.id,
-    match: NodeMatcher.whenRoot,
-    actions: () => Effect.succeed([
-      {
-        id: HelpOperation.Start.meta.key,
-        data: Effect.fnUntraced(function* () {
-          yield* Capabilities.updateAtomValue(HelpCapabilities.State, (s) => ({
-            ...s,
-            showHints: true
-          }));
-          yield* Operation.invoke(HelpOperation.Start);
-        }),
-        properties: {
-          label: [
-            "open help tour",
-            {
-              ns: meta.id
-            }
-          ],
-          icon: "ph--info--regular",
-          keyBinding: {
-            macos: "shift+meta+/",
-            windows: "shift+ctrl+/",
-            linux: "shift+ctrl+?"
-          },
-          testId: "helpPlugin.openHelp"
-        }
-      },
-      {
-        id: `${meta.id}/open-shortcuts`,
-        data: Effect.fnUntraced(function* () {
-          yield* Capabilities.updateAtomValue(HelpCapabilities.State, (s) => ({
-            ...s,
-            showHints: true
-          }));
-          yield* Operation.invoke(LayoutOperation.UpdateDialog, {
-            subject: SHORTCUTS_DIALOG,
-            blockAlign: "center"
-          });
-        }),
-        properties: {
-          label: [
-            "open shortcuts label",
-            {
-              ns: meta.id
-            }
-          ],
-          icon: "ph--keyboard--regular",
-          keyBinding: {
-            macos: "meta+ctrl+/"
-          }
-        }
-      }
-    ])
-  });
-  return Capability.contributes(AppCapabilities.AppGraphBuilder, extensions);
-}));
-export {
-  app_graph_builder_default as default
-};
-//# sourceMappingURL=app-graph-builder-QSESB5XF.mjs.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/capabilities/app-graph-builder/app-graph-builder.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { GraphBuilder, NodeMatcher } from '@dxos/app-graph';\nimport { AppCapabilities, LayoutOperation } from '@dxos/app-toolkit';\nimport { Operation } from '@dxos/operation';\n\nimport { SHORTCUTS_DIALOG } from '../../components';\nimport { meta } from '../../meta';\nimport { HelpCapabilities, HelpOperation } from '../../types';\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const extensions = yield* GraphBuilder.createExtension({\n      id: meta.id,\n      match: NodeMatcher.whenRoot,\n      actions: () =>\n        Effect.succeed([\n          {\n            id: HelpOperation.Start.meta.key,\n            data: Effect.fnUntraced(function* () {\n              yield* Capabilities.updateAtomValue(HelpCapabilities.State, (s) => ({ ...s, showHints: true }));\n              yield* Operation.invoke(HelpOperation.Start);\n            }),\n            properties: {\n              label: ['open help tour', { ns: meta.id }],\n              icon: 'ph--info--regular',\n              keyBinding: {\n                macos: 'shift+meta+/',\n                windows: 'shift+ctrl+/',\n                linux: 'shift+ctrl+?',\n              },\n              testId: 'helpPlugin.openHelp',\n            },\n          },\n          {\n            id: `${meta.id}/open-shortcuts`,\n            data: Effect.fnUntraced(function* () {\n              yield* Capabilities.updateAtomValue(HelpCapabilities.State, (s) => ({ ...s, showHints: true }));\n              yield* Operation.invoke(LayoutOperation.UpdateDialog, {\n                subject: SHORTCUTS_DIALOG,\n                blockAlign: 'center',\n              });\n            }),\n            properties: {\n              label: ['open shortcuts label', { ns: meta.id }],\n              icon: 'ph--keyboard--regular',\n              keyBinding: {\n                macos: 'meta+ctrl+/',\n              },\n            },\n          },\n        ]),\n    });\n\n    return Capability.contributes(AppCapabilities.AppGraphBuilder, extensions);\n  }),\n);\n"],
-  "mappings": ";;;;;;;;;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,cAAcC,kBAAkB;AACzC,SAASC,cAAcC,mBAAmB;AAC1C,SAASC,iBAAiBC,uBAAuB;AACjD,SAASC,iBAAiB;AAM1B,IAAA,4BAAeC,WAAWC,WACjBC,kBAAW,aAAA;AAChB,QAAMC,aAAa,OAAOC,aAAaC,gBAAgB;IACrDC,IAAIC,KAAKD;IACTE,OAAOC,YAAYC;IACnBC,SAAS,MACAC,eAAQ;MACb;QACEN,IAAIO,cAAcC,MAAMP,KAAKQ;QAC7BC,MAAad,kBAAW,aAAA;AACtB,iBAAOe,aAAaC,gBAAgBC,iBAAiBC,OAAO,CAACC,OAAO;YAAE,GAAGA;YAAGC,WAAW;UAAK,EAAA;AAC5F,iBAAOC,UAAUC,OAAOX,cAAcC,KAAK;QAC7C,CAAA;QACAW,YAAY;UACVC,OAAO;YAAC;YAAkB;cAAEC,IAAIpB,KAAKD;YAAG;;UACxCsB,MAAM;UACNC,YAAY;YACVC,OAAO;YACPC,SAAS;YACTC,OAAO;UACT;UACAC,QAAQ;QACV;MACF;MACA;QACE3B,IAAI,GAAGC,KAAKD,EAAE;QACdU,MAAad,kBAAW,aAAA;AACtB,iBAAOe,aAAaC,gBAAgBC,iBAAiBC,OAAO,CAACC,OAAO;YAAE,GAAGA;YAAGC,WAAW;UAAK,EAAA;AAC5F,iBAAOC,UAAUC,OAAOU,gBAAgBC,cAAc;YACpDC,SAASC;YACTC,YAAY;UACd,CAAA;QACF,CAAA;QACAb,YAAY;UACVC,OAAO;YAAC;YAAwB;cAAEC,IAAIpB,KAAKD;YAAG;;UAC9CsB,MAAM;UACNC,YAAY;YACVC,OAAO;UACT;QACF;MACF;KACD;EACL,CAAA;AAEA,SAAO9B,WAAWuC,YAAYC,gBAAgBC,iBAAiBtC,UAAAA;AACjE,CAAA,CAAA;",
-  "names": ["Effect", "Capabilities", "Capability", "GraphBuilder", "NodeMatcher", "AppCapabilities", "LayoutOperation", "Operation", "Capability", "makeModule", "fnUntraced", "extensions", "GraphBuilder", "createExtension", "id", "meta", "match", "NodeMatcher", "whenRoot", "actions", "succeed", "HelpOperation", "Start", "key", "data", "Capabilities", "updateAtomValue", "HelpCapabilities", "State", "s", "showHints", "Operation", "invoke", "properties", "label", "ns", "icon", "keyBinding", "macos", "windows", "linux", "testId", "LayoutOperation", "UpdateDialog", "subject", "SHORTCUTS_DIALOG", "blockAlign", "contributes", "AppCapabilities", "AppGraphBuilder"]
-}

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

@@ -1,361 +0,0 @@
-import {
-  HelpContext
-} from "./chunk-TS66J4C6.mjs";
-import {
-  meta
-} from "./chunk-IM2QVQOH.mjs";
-
-// src/components/Shortcuts/Key.tsx
-import React from "react";
-import { keySymbols } from "@dxos/keyboard";
-
-// src/components/Shortcuts/styles.ts
-import { mx } from "@dxos/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 }) => {
-  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)));
-};
-
-// 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/ui-theme";
-var ShortcutsList = () => {
-  const { t } = useTranslation(meta.id);
-  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)))));
-};
-
-// src/components/Shortcuts/ShortcutsDialog.tsx
-import React3 from "react";
-import { Dialog, IconButton, useTranslation as useTranslation2 } from "@dxos/react-ui";
-var SHORTCUTS_DIALOG = `${meta.id}/ShortcutsDialog`;
-var ShortcutsDialogContent = () => {
-  const { t } = useTranslation2(meta.id);
-  return /* @__PURE__ */ React3.createElement(Dialog.Content, null, /* @__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(IconButton, {
-    icon: "ph--x--bold",
-    iconOnly: true,
-    size: 3,
-    label: "Close",
-    variant: "ghost",
-    autoFocus: true
-  }))), /* @__PURE__ */ React3.createElement("div", {
-    className: "flex items-center justify-center"
-  }, /* @__PURE__ */ React3.createElement(ShortcutsList, null)));
-};
-
-// src/components/Shortcuts/ShortcutsHints.tsx
-import React4 from "react";
-import { Keyboard as Keyboard2 } from "@dxos/keyboard";
-import { IconButton as IconButton2, toLocalizedString as toLocalizedString2, useTranslation as useTranslation3 } from "@dxos/react-ui";
-import { osTranslations } from "@dxos/ui-theme";
-var Shortcut = ({ binding }) => {
-  const { t } = useTranslation3(osTranslations);
-  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 pli-2 gap-4"
-  }, hints.map((binding) => /* @__PURE__ */ React4.createElement(Shortcut, {
-    key: binding.shortcut,
-    binding
-  })), onClose && /* @__PURE__ */ React4.createElement(IconButton2, {
-    icon: "ph--x--regular",
-    size: 4,
-    label: "Close",
-    iconOnly: true,
-    noTooltip: true,
-    variant: "ghost",
-    classNames: "p-0 cursor-pointer",
-    onClick: onClose
-  }));
-};
-
-// src/components/Shortcuts/ShortcutsSection.tsx
-import React5 from "react";
-import { descriptionText } from "@dxos/ui-theme";
-var ShortcutsSection = () => {
-  return /* @__PURE__ */ React5.createElement("section", {
-    className: descriptionText
-  }, /* @__PURE__ */ React5.createElement(ShortcutsList, null));
-};
-
-// src/components/Tooltip/Tooltip.tsx
-import { useArrowNavigationGroup, useFocusableGroup } from "@fluentui/react-tabster";
-import React6, { forwardRef } from "react";
-import { Button, Icon, IconButton as IconButton3 } 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) => {
-  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(IconButton3, {
-    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(IconButton3, {
-    classNames: [
-      !(index > 0 && backProps) && "invisible"
-    ],
-    icon: "ph--caret-left--regular",
-    iconOnly: true,
-    label: backProps["aria-label"],
-    onClick: backProps.onClick,
-    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(Icon, {
-    key: i,
-    icon: index === i ? "ph--circle--fill" : "ph--circle--regular",
-    size: 2,
-    classNames: "mli-1 cursor-pointer"
-  })))), isLastStep ? /* @__PURE__ */ React6.createElement(Button, {
-    variant: "primary",
-    onClick: closeProps.onClick,
-    title: closeProps["aria-label"],
-    autoFocus: true,
-    "data-testid": "helpPlugin.tooltip.finish"
-  }, "Done") : /* @__PURE__ */ React6.createElement(IconButton3, {
-    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"
-  })));
-});
-
-// src/components/WelcomeTour/WelcomeTour.tsx
-import React7, { useState } from "react";
-import Joyride, { ACTIONS, EVENTS } from "react-joyride";
-import { usePluginManager } from "@dxos/app-framework/ui";
-import { useLayout } from "@dxos/app-toolkit/ui";
-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 }) => {
-  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.capabilities);
-    }
-    _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
-  }));
-};
-
-export {
-  Key,
-  ShortcutsList,
-  SHORTCUTS_DIALOG,
-  ShortcutsDialogContent,
-  ShortcutsHints,
-  ShortcutsSection,
-  floaterProps,
-  Tooltip,
-  WelcomeTour
-};
-//# sourceMappingURL=chunk-M5LBB7IY.mjs.map