@dxos/plugin-help 0.8.3-staging.0fa589b → 0.8.4-main.3f58842

package/dist/lib/browser/{app-graph-builder-2TXP7S56.mjs → app-graph-builder-BYCMEBNG.mjs}

@@ -1,17 +1,17 @@
 import {
   SHORTCUTS_DIALOG
-} from "./chunk-JNDWLTUJ.mjs";
+} from "./chunk-MNETJXKS.mjs";
 import {
   HelpAction
-} from "./chunk-BZUIJQPN.mjs";
+} from "./chunk-J2SJSGSX.mjs";
 import {
   HelpCapabilities
-} from "./chunk-ACLT6V7I.mjs";
+} from "./chunk-LDRUZNSN.mjs";
 import {
   HELP_PLUGIN
-} from "./chunk-4KTRSNO5.mjs";
+} from "./chunk-3Y4CMOZP.mjs";
 
-// packages/plugins/plugin-help/src/capabilities/app-graph-builder.ts
+// src/capabilities/app-graph-builder.ts
 import { Rx } from "@effect-rx/rx-react";
 import { Option, pipe } from "effect";
 import { Capabilities, contributes, createIntent, LayoutAction } from "@dxos/app-framework";
@@ -76,4 +76,4 @@ var app_graph_builder_default = (context) => contributes(Capabilities.AppGraphBu
 export {
   app_graph_builder_default as default
 };
-//# sourceMappingURL=app-graph-builder-2TXP7S56.mjs.map
+//# sourceMappingURL=app-graph-builder-BYCMEBNG.mjs.map

package/dist/lib/browser/{chunk-4KTRSNO5.mjs → chunk-3Y4CMOZP.mjs}

@@ -1,4 +1,4 @@
-// packages/plugins/plugin-help/src/meta.ts
+// src/meta.ts
 var HELP_PLUGIN = "dxos.org/plugin/help";
 var meta = {
   id: HELP_PLUGIN,
@@ -10,4 +10,4 @@ export {
   HELP_PLUGIN,
   meta
 };
-//# sourceMappingURL=chunk-4KTRSNO5.mjs.map
+//# sourceMappingURL=chunk-3Y4CMOZP.mjs.map

package/dist/lib/browser/{chunk-BZUIJQPN.mjs → chunk-J2SJSGSX.mjs}

@@ -1,8 +1,8 @@
 import {
-  HELP_PLUGIN
-} from "./chunk-4KTRSNO5.mjs";
+  meta
+} from "./chunk-3Y4CMOZP.mjs";
 
-// packages/plugins/plugin-help/src/types.ts
+// src/types/schema.ts
 import { Schema } from "effect";
 import { createContext } from "react";
 var HelpContext = createContext({
@@ -17,9 +17,8 @@ var HelpContext = createContext({
   stop: () => {
   }
 });
-var HELP_ACTION = `${HELP_PLUGIN}/action`;
 (function(HelpAction2) {
-  class Start extends Schema.TaggedClass()(`${HELP_ACTION}/start`, {
+  class Start extends Schema.TaggedClass()(`${meta.id}/action/start`, {
     input: Schema.Void,
     output: Schema.Void
   }) {
@@ -30,7 +29,6 @@ var HelpAction;
 
 export {
   HelpContext,
-  HELP_ACTION,
   HelpAction
 };
-//# sourceMappingURL=chunk-BZUIJQPN.mjs.map
+//# sourceMappingURL=chunk-J2SJSGSX.mjs.map

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

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

package/dist/lib/browser/{chunk-ACLT6V7I.mjs → chunk-LDRUZNSN.mjs}

@@ -1,8 +1,8 @@
 import {
   HELP_PLUGIN
-} from "./chunk-4KTRSNO5.mjs";
+} from "./chunk-3Y4CMOZP.mjs";
 
-// packages/plugins/plugin-help/src/capabilities/capabilities.ts
+// src/capabilities/capabilities.ts
 import { defineCapability } from "@dxos/app-framework";
 (function(HelpCapabilities2) {
   HelpCapabilities2.State = defineCapability(`${HELP_PLUGIN}/capability/state`);
@@ -13,4 +13,4 @@ var HelpCapabilities;
 export {
   HelpCapabilities
 };
-//# sourceMappingURL=chunk-ACLT6V7I.mjs.map
+//# sourceMappingURL=chunk-LDRUZNSN.mjs.map

package/dist/lib/browser/{chunk-JNDWLTUJ.mjs → chunk-MNETJXKS.mjs}

@@ -1,20 +1,20 @@
 import {
   HelpContext
-} from "./chunk-BZUIJQPN.mjs";
+} from "./chunk-J2SJSGSX.mjs";
 import {
   HELP_PLUGIN
-} from "./chunk-4KTRSNO5.mjs";
+} from "./chunk-3Y4CMOZP.mjs";
 
-// packages/plugins/plugin-help/src/components/Shortcuts/Key.tsx
+// src/components/Shortcuts/Key.tsx
 import { useSignals as _useSignals } from "@preact-signals/safe-react/tracking";
 import React from "react";
 import { keySymbols } from "@dxos/keyboard";
 
-// packages/plugins/plugin-help/src/components/Shortcuts/styles.ts
+// 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
+// src/components/Shortcuts/Key.tsx
 var Key = ({ binding }) => {
   var _effect = _useSignals();
   try {
@@ -32,7 +32,7 @@ var Key = ({ binding }) => {
   }
 };
 
-// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsList.tsx
+// 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";
@@ -62,7 +62,7 @@ var ShortcutsList = () => {
   }
 };
 
-// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsDialog.tsx
+// 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";
@@ -93,7 +93,7 @@ var ShortcutsDialogContent = () => {
   }
 };
 
-// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsHints.tsx
+// 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";
@@ -143,7 +143,7 @@ var ShortcutsHints = ({ onClose }) => {
   }
 };
 
-// packages/plugins/plugin-help/src/components/Shortcuts/ShortcutsSection.tsx
+// 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";
@@ -158,13 +158,11 @@ var ShortcutsSection = () => {
   }
 };
 
-// packages/plugins/plugin-help/src/components/Tooltip/Tooltip.tsx
+// src/components/Tooltip/Tooltip.tsx
 import { useSignals as _useSignals6 } from "@preact-signals/safe-react/tracking";
 import { useArrowNavigationGroup, useFocusableGroup } from "@fluentui/react-tabster";
-import { CaretLeft, CaretRight, Circle, X } from "@phosphor-icons/react";
 import React6, { forwardRef } from "react";
-import { Button as Button3 } from "@dxos/react-ui";
-import { getSize, mx as mx3 } from "@dxos/react-ui-theme";
+import { Button as Button3, Icon as Icon3, IconButton } from "@dxos/react-ui";
 var floaterProps = {
   styles: {
     // Arrow color is set by joyride.
@@ -198,61 +196,64 @@ var Tooltip = /* @__PURE__ */ forwardRef(({ step: { title, content }, index, siz
       className: "flex p-2"
     }, /* @__PURE__ */ React6.createElement("h2", {
       className: "grow pli-2 plb-1 text-lg font-medium text-accentSurfaceText"
-    }, title), /* @__PURE__ */ React6.createElement(Button3, {
+    }, title), /* @__PURE__ */ React6.createElement(IconButton, {
       density: "fine",
-      variant: "primary",
+      icon: "ph--x--bold",
+      iconOnly: true,
+      label: closeProps["aria-label"],
       onClick: closeProps.onClick,
-      title: closeProps["aria-label"],
+      size: 4,
+      variant: "primary",
       "data-testid": "helpPlugin.tooltip.close"
-    }, /* @__PURE__ */ React6.createElement(X, {
-      weight: "bold",
-      className: getSize(4)
-    }))), /* @__PURE__ */ React6.createElement("div", {
+    })), /* @__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(Button3, {
-      variant: "primary",
-      onClick: backProps.onClick,
-      title: backProps["aria-label"],
+    }, /* @__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(CaretLeft, {
-      className: getSize(5)
-    })), /* @__PURE__ */ React6.createElement("div", {
+    }), /* @__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(Circle, {
+    }).map((_, i) => /* @__PURE__ */ React6.createElement(Icon3, {
       key: i,
-      weight: index === i ? "fill" : "regular",
-      className: mx3(getSize(2), "mli-1 cursor-pointer")
+      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(Button3, {
-      variant: "primary",
-      onClick: primaryProps.onClick,
-      title: primaryProps["aria-label"],
+    }, "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"
-    }, /* @__PURE__ */ React6.createElement(CaretRight, {
-      className: getSize(6)
-    }))));
+    })));
   } finally {
     _effect.f();
   }
 });
 
-// packages/plugins/plugin-help/src/components/WelcomeTour/WelcomeTour.tsx
+// src/components/WelcomeTour/WelcomeTour.tsx
 import { useSignals as _useSignals7 } from "@preact-signals/safe-react/tracking";
 import React7, { useState, useEffect } from "react";
 import Joyride, { ACTIONS, EVENTS } from "react-joyride";
@@ -405,4 +406,4 @@ export {
   Tooltip,
   WelcomeTour
 };
-//# sourceMappingURL=chunk-JNDWLTUJ.mjs.map
+//# sourceMappingURL=chunk-MNETJXKS.mjs.map

package/dist/lib/browser/chunk-MNETJXKS.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 select-none')}>\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--bold' 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 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, Icon, IconButton } from '@dxos/react-ui';\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 arrowNavigationAttrs = useArrowNavigationGroup({ axis: 'horizontal' });\n    const focusableGroupAttrs = 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-accentSurfaceText'\n        role='tooltip'\n        data-testid='helpPlugin.tooltip'\n        data-step={index + 1}\n        {...focusableGroupAttrs}\n        ref={forwardedRef}\n      >\n        <div className='flex p-2'>\n          <h2 className='grow pli-2 plb-1 text-lg font-medium text-accentSurfaceText'>{title}</h2>\n          <IconButton\n            density='fine'\n            icon='ph--x--bold'\n            iconOnly\n            label={closeProps['aria-label']}\n            onClick={closeProps.onClick}\n            size={4}\n            variant='primary'\n            data-testid='helpPlugin.tooltip.close'\n          />\n        </div>\n        <div className='flex grow pli-4 mlb-2'>{content}</div>\n        <div className='flex p-2 items-center justify-between' {...arrowNavigationAttrs}>\n          {\n            <IconButton\n              classNames={[!(index > 0 && backProps) && 'invisible']}\n              icon='ph--caret-left--regular'\n              iconOnly\n              label={backProps['aria-label']}\n              onClick={backProps.onClick}\n              size={5}\n              variant='primary'\n              data-testid='helpPlugin.tooltip.back'\n            />\n          }\n          <div className='flex grow gap-2 justify-center'>\n            <div className='flex'>\n              {Array.from({ length: size }).map((_, i) => (\n                <Icon\n                  key={i}\n                  icon={index === i ? 'ph--circle--fill' : 'ph--circle--regular'}\n                  size={2}\n                  classNames='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            <IconButton\n              autoFocus\n              icon='ph--caret-right--regular'\n              iconOnly\n              label={primaryProps['aria-label']}\n              onClick={primaryProps.onClick}\n              size={6}\n              variant='primary'\n              data-testid='helpPlugin.tooltip.next'\n            />\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", "React", "forwardRef", "Button", "Icon", "IconButton", "floaterProps", "styles", "arrow", "length", "spread", "floater", "filter", "Tooltip", "forwardRef", "step", "title", "content", "index", "size", "isLastStep", "backProps", "closeProps", "primaryProps", "forwardedRef", "arrowNavigationAttrs", "useArrowNavigationGroup", "axis", "focusableGroupAttrs", "useFocusableGroup", "tabBehavior", "React", "div", "className", "role", "data-testid", "data-step", "ref", "h2", "IconButton", "density", "icon", "iconOnly", "label", "onClick", "variant", "classNames", "Array", "from", "map", "_", "i", "Icon", "key", "Button", "autoFocus", "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

@@ -8,35 +8,34 @@ import {
   Tooltip,
   WelcomeTour,
   floaterProps
-} from "./chunk-JNDWLTUJ.mjs";
+} from "./chunk-MNETJXKS.mjs";
 import {
-  HELP_ACTION,
   HelpAction,
   HelpContext
-} from "./chunk-BZUIJQPN.mjs";
+} from "./chunk-J2SJSGSX.mjs";
 import {
   HelpCapabilities
-} from "./chunk-ACLT6V7I.mjs";
+} from "./chunk-LDRUZNSN.mjs";
 import {
   HELP_PLUGIN,
   meta
-} from "./chunk-4KTRSNO5.mjs";
+} from "./chunk-3Y4CMOZP.mjs";
 
-// packages/plugins/plugin-help/src/capabilities/index.ts
+// src/capabilities/index.ts
 import { lazy } from "@dxos/app-framework";
-var AppGraphBuilder = lazy(() => import("./app-graph-builder-2TXP7S56.mjs"));
-var ReactRoot = lazy(() => import("./react-root-PRXEQ5QF.mjs"));
-var ReactSurface = lazy(() => import("./react-surface-IDR3XY36.mjs"));
-var HelpState = lazy(() => import("./state-UOKD6P5V.mjs"));
+var AppGraphBuilder = lazy(() => import("./app-graph-builder-BYCMEBNG.mjs"));
+var ReactRoot = lazy(() => import("./react-root-W6ZDEGBU.mjs"));
+var ReactSurface = lazy(() => import("./react-surface-SATVEWS5.mjs"));
+var HelpState = lazy(() => import("./state-FWUZG6NL.mjs"));
 
-// packages/plugins/plugin-help/src/HelpPlugin.tsx
+// src/HelpPlugin.tsx
 import { createResolver, defineModule, definePlugin, Events, contributes, Capabilities } from "@dxos/app-framework";
 
-// packages/plugins/plugin-help/src/translations.ts
-var translations_default = [
+// src/translations.ts
+var translations = [
   {
     "en-US": {
-      [HELP_PLUGIN]: {
+      [meta.id]: {
         "plugin name": "Help",
         "open help tour": "Show welcome tour",
         "open shortcuts label": "Show shortcuts",
@@ -46,7 +45,7 @@ var translations_default = [
   }
 ];
 
-// packages/plugins/plugin-help/src/HelpPlugin.tsx
+// src/HelpPlugin.tsx
 var HelpPlugin = ({ steps = [] }) => definePlugin(meta, [
   defineModule({
     id: `${meta.id}/module/state`,
@@ -56,7 +55,7 @@ var HelpPlugin = ({ steps = [] }) => definePlugin(meta, [
   defineModule({
     id: `${meta.id}/module/translations`,
     activatesOn: Events.SetupTranslations,
-    activate: () => contributes(Capabilities.Translations, translations_default)
+    activate: () => contributes(Capabilities.Translations, translations)
   }),
   defineModule({
     id: `${meta.id}/module/react-root`,
@@ -86,14 +85,13 @@ var HelpPlugin = ({ steps = [] }) => definePlugin(meta, [
   })
 ]);
 
-// packages/plugins/plugin-help/src/hooks/useHelp.tsx
+// src/hooks/useHelp.tsx
 import { useContext } from "react";
 import { raise } from "@dxos/debug";
 var useHelp = () => {
   return useContext(HelpContext) ?? raise(new Error("Missing HelpContext"));
 };
 export {
-  HELP_ACTION,
   HELP_PLUGIN,
   HelpAction,
   HelpCapabilities,

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 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.SetupReactSurface,\n      activate: ReactSurface,\n    }),\n    defineModule({\n      id: `${meta.id}/module/intent-resolver`,\n      activatesOn: Events.SetupIntentResolver,\n      activate: (context) =>\n        contributes(\n          Capabilities.IntentResolver,\n          createResolver({\n            intent: HelpAction.Start,\n            resolve: () => {\n              const state = context.getCapability(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,cAAcC,iBAAiBC,YAAY;AACjEH,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", "SetupReactSurface", "ReactSurface", "SetupIntentResolver", "context", "IntentResolver", "createResolver", "intent", "HelpAction", "Start", "resolve", "state", "getCapability", "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.SetupReactSurface,\n      activate: ReactSurface,\n    }),\n    defineModule({\n      id: `${meta.id}/module/intent-resolver`,\n      activatesOn: Events.SetupIntentResolver,\n      activate: (context) =>\n        contributes(\n          Capabilities.IntentResolver,\n          createResolver({\n            intent: HelpAction.Start,\n            resolve: () => {\n              const state = context.getCapability(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 { type Resource } from '@dxos/react-ui';\n\nimport { meta } from './meta';\n\nexport const translations = [\n  {\n    'en-US': {\n      [meta.id]: {\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] as const satisfies Resource[];\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;;;ACIvF,IAAMC,eAAe;EAC1B;IACE,SAAS;MACP,CAACC,KAAKC,EAAE,GAAG;QACT,eAAe;QACf,kBAAkB;QAClB,wBAAwB;QACxB,0BAA0B;MAC5B;IACF;EACF;;;;ADJK,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,YAAAA;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,cAAcC,iBAAiBC,YAAY;AACjEH,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", "translations", "meta", "id", "HelpPlugin", "steps", "definePlugin", "meta", "defineModule", "id", "activatesOn", "Events", "Startup", "activate", "HelpState", "SetupTranslations", "contributes", "Capabilities", "Translations", "translations", "ReactRoot", "SetupReactSurface", "ReactSurface", "SetupIntentResolver", "context", "IntentResolver", "createResolver", "intent", "HelpAction", "Start", "resolve", "state", "getCapability", "HelpCapabilities", "MutableState", "running", "SetupAppGraph", "AppGraphBuilder", "useContext", "raise", "useHelp", "useContext", "HelpContext", "raise", "Error"]
 }