@dxos/plugin-help 0.7.5-main.9d2a38b → 0.7.5-main.b19bfc8

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

@@ -43,7 +43,15 @@ export default (context: PluginsContext) =>
             const { dispatchPromise: dispatch } = context.requestCapability(Capabilities.IntentDispatcher);
             const state = context.requestCapability(HelpCapabilities.MutableState);
             state.showHints = true;
-            await dispatch?.(createIntent(LayoutAction.SetLayout, { element: 'dialog', component: SHORTCUTS_DIALOG }));
+            await dispatch(
+              createIntent(LayoutAction.UpdateDialog, {
+                part: 'dialog',
+                subject: SHORTCUTS_DIALOG,
+                options: {
+                  blockAlign: 'center',
+                },
+              }),
+            );
           },
           properties: {
             label: ['open shortcuts label', { ns: HELP_PLUGIN }],

package/src/capabilities/index.ts

@@ -5,7 +5,7 @@
 import { lazy } from '@dxos/app-framework';
 
 export const AppGraphBuilder = lazy(() => import('./app-graph-builder'));
-export const ReactContext = lazy(() => import('./react-context'));
+export const ReactRoot = lazy(() => import('./react-root'));
 export const ReactSurface = lazy(() => import('./react-surface'));
 export const HelpState = lazy(() => import('./state'));
 

package/src/capabilities/{react-context.tsx → react-root.tsx}

@@ -7,17 +7,17 @@ import React from 'react';
 import { Capabilities, contributes, useCapability } from '@dxos/app-framework';
 
 import { HelpCapabilities } from './capabilities';
-import { HelpContextProvider } from '../components';
+import { WelcomeTour } from '../components';
 import { HELP_PLUGIN } from '../meta';
 import { type Step } from '../types';
 
 export default (steps: Step[]) =>
-  contributes(Capabilities.ReactContext, {
+  contributes(Capabilities.ReactRoot, {
     id: HELP_PLUGIN,
-    context: ({ children }) => {
+    root: () => {
       const state = useCapability(HelpCapabilities.MutableState);
       return (
-        <HelpContextProvider
+        <WelcomeTour
           steps={steps}
           running={state.running}
           onRunningChanged={(newState) => {
@@ -26,9 +26,7 @@ export default (steps: Step[]) =>
               state.showHints = false;
             }
           }}
-        >
-          {children}
-        </HelpContextProvider>
+        />
       );
     },
   });

package/src/components/{HelpContextProvider/HelpContextProvider.stories.tsx → WelcomeTour/WelcomeTour.stories.tsx}

@@ -12,7 +12,7 @@ import { faker } from '@dxos/random';
 import { Button } from '@dxos/react-ui';
 import { withTheme } from '@dxos/storybook-utils';
 
-import { HelpContextProvider, type HelpContextProviderProps } from './HelpContextProvider';
+import { WelcomeTour, type WelcomeTourProps } from './WelcomeTour';
 import { useHelp } from '../../hooks';
 
 const App = () => {
@@ -57,18 +57,19 @@ const App = () => {
   );
 };
 
-const DefaultStory = ({ steps = [] }: HelpContextProviderProps) => (
-  <HelpContextProvider steps={steps}>
+const DefaultStory = ({ steps = [] }: WelcomeTourProps) => (
+  <>
+    <WelcomeTour steps={steps} />
     <div className='fixed inset-0 overflow-hidden'>
       <App />
     </div>
-  </HelpContextProvider>
+  </>
 );
 
 // TODO(burdon): Tour should prompt user to create a Stack -- and respond to it being created.
 //  Use beacon to simulate click.
 
-export const Default: StoryObj<typeof HelpContextProvider> = {
+export const Default: StoryObj<typeof WelcomeTour> = {
   args: {
     // https://docs.react-joyride.com/step#options
     steps: [
@@ -103,9 +104,9 @@ export const Default: StoryObj<typeof HelpContextProvider> = {
 /**
  * IMPORTANT: Run in separate tab.
  */
-const meta: Meta<typeof HelpContextProvider> = {
-  title: 'plugins/plugin-help/Joyride',
-  component: HelpContextProvider,
+const meta: Meta<typeof WelcomeTour> = {
+  title: 'plugins/plugin-help/WelcomeTour',
+  component: WelcomeTour,
   render: DefaultStory,
   decorators: [withTheme],
 };

package/src/components/{HelpContextProvider/HelpContextProvider.tsx → WelcomeTour/WelcomeTour.tsx}

@@ -2,10 +2,10 @@
 // Copyright 2023 DXOS.org
 //
 
-import React, { type PropsWithChildren, useState, useEffect } from 'react';
+import React, { useState, useEffect } from 'react';
 import Joyride, { ACTIONS, EVENTS } from 'react-joyride';
 
-import { usePluginManager, useCapability, Capabilities } from '@dxos/app-framework';
+import { usePluginManager, useLayout } from '@dxos/app-framework';
 
 import { type Step, HelpContext } from '../../types';
 import { floaterProps, Tooltip } from '../Tooltip';
@@ -57,20 +57,15 @@ const waitForTarget = async (step: Step) => {
   }
 };
 
-export type HelpContextProviderProps = PropsWithChildren<{
+export type WelcomeTourProps = {
   steps: Step[];
   running?: boolean;
   onRunningChanged?: (state: boolean) => any;
-}>;
-
-export const HelpContextProvider = ({
-  children,
-  steps: initialSteps,
-  running: runningProp,
-  onRunningChanged,
-}: HelpContextProviderProps) => {
+};
+
+export const WelcomeTour = ({ steps: initialSteps, running: runningProp, onRunningChanged }: WelcomeTourProps) => {
   const manager = usePluginManager();
-  const layout = useCapability(Capabilities.Layout);
+  const layout = useLayout();
   const [running, setRunning] = useState(!!runningProp && !!getTarget(initialSteps[0]));
   const [stepIndex, _setStepIndex] = useState(0);
   const [steps, setSteps] = useState(initialSteps);
@@ -170,7 +165,6 @@ export const HelpContextProvider = ({
         floaterProps={floaterProps}
         tooltipComponent={Tooltip}
       />
-      {children}
     </HelpContext.Provider>
   );
 };

package/src/components/WelcomeTour/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export * from './WelcomeTour';

package/src/components/index.ts

@@ -2,6 +2,6 @@
 // Copyright 2023 DXOS.org
 //
 
-export * from './HelpContextProvider';
 export * from './Shortcuts';
 export * from './Tooltip';
+export * from './WelcomeTour';

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/components/Tooltip/Tooltip.tsx", "../../../src/components/HelpContextProvider/HelpContextProvider.tsx", "../../../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"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { useArrowNavigationGroup, useFocusableGroup } from '@fluentui/react-tabster';\nimport { CaretLeft, CaretRight, Circle, X } from '@phosphor-icons/react';\nimport React, { forwardRef } from 'react';\n// TODO(thure): This needed to be imported in the package.json specifically to pacify TS2742. See if this is resolved with typescript@5.5.x.\n// eslint-disable-next-line unused-imports/no-unused-imports\nimport _floater from 'react-floater';\nimport { type TooltipRenderProps, type Props } from 'react-joyride';\n// TODO(thure): This needed to be imported in the package.json specifically to pacify TS2742. See if this is resolved with typescript@5.5.x.\n// eslint-disable-next-line unused-imports/no-unused-imports\nimport _typefest from 'type-fest';\n\nimport { Button } from '@dxos/react-ui';\nimport { getSize, mx } from '@dxos/react-ui-theme';\n\n// https://docs.react-joyride.com/styling\n// https://github.com/gilbarbara/react-floater\nexport const floaterProps: Props['floaterProps'] = {\n  styles: {\n    // Arrow color is set by joyride.\n    arrow: {\n      length: 8,\n      spread: 16,\n    },\n    floater: {\n      // TODO(burdon): Get tokens from theme.\n      filter: 'drop-shadow(0 0 0.75rem rgba(0, 0, 0, 0.2))',\n    },\n  },\n};\n\n// TODO(burdon): Add info link to docs.\nexport const Tooltip = forwardRef<HTMLDivElement, TooltipRenderProps>(\n  ({ step: { title, content }, index, size, isLastStep, backProps, closeProps, primaryProps }, forwardedRef) => {\n    const arrowGroup = useArrowNavigationGroup({ axis: 'horizontal' });\n    const trapFocus = useFocusableGroup({ tabBehavior: 'limited-trap-focus' });\n\n    return (\n      <div\n        className='flex flex-col is-[15rem] min-bs-[10rem] overflow-hidden rounded-md shadow-xl bg-accentSurface text-inverse'\n        role='tooltip'\n        data-testid='helpPlugin.tooltip'\n        data-step={index + 1}\n        {...trapFocus}\n        ref={forwardedRef}\n      >\n        <div className='flex p-2'>\n          <h2 className='grow pli-2 plb-1 text-lg font-medium text-inverse'>{title}</h2>\n          <Button\n            density='fine'\n            variant='primary'\n            onClick={closeProps.onClick}\n            title={closeProps['aria-label']}\n            data-testid='helpPlugin.tooltip.close'\n          >\n            <X weight='bold' className={getSize(4)} />\n          </Button>\n        </div>\n        <div className='flex grow pli-4 mlb-2'>{content}</div>\n        <div className='flex p-2 items-center justify-between' {...arrowGroup}>\n          {\n            <Button\n              variant='primary'\n              onClick={backProps.onClick}\n              title={backProps['aria-label']}\n              classNames={[!(index > 0 && backProps) && 'invisible']}\n              data-testid='helpPlugin.tooltip.back'\n            >\n              <CaretLeft className={getSize(5)} />\n            </Button>\n          }\n          <div className='flex grow gap-2 justify-center'>\n            <div className='flex'>\n              {Array.from({ length: size }).map((_, i) => (\n                <Circle\n                  key={i}\n                  weight={index === i ? 'fill' : 'regular'}\n                  className={mx(getSize(2), 'mli-1 cursor-pointer')}\n                />\n              ))}\n            </div>\n          </div>\n          {isLastStep ? (\n            <Button\n              variant='primary'\n              onClick={closeProps.onClick}\n              title={closeProps['aria-label']}\n              autoFocus\n              data-testid='helpPlugin.tooltip.finish'\n            >\n              Done\n            </Button>\n          ) : (\n            <Button\n              variant='primary'\n              onClick={primaryProps.onClick}\n              title={primaryProps['aria-label']}\n              autoFocus\n              data-testid='helpPlugin.tooltip.next'\n            >\n              <CaretRight className={getSize(6)} />\n            </Button>\n          )}\n        </div>\n      </div>\n    );\n  },\n);\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { type PropsWithChildren, useState, useEffect } from 'react';\nimport Joyride, { ACTIONS, EVENTS } from 'react-joyride';\n\nimport { usePluginManager, useCapability, Capabilities } 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 HelpContextProviderProps = PropsWithChildren<{\n  steps: Step[];\n  running?: boolean;\n  onRunningChanged?: (state: boolean) => any;\n}>;\n\nexport const HelpContextProvider = ({\n  children,\n  steps: initialSteps,\n  running: runningProp,\n  onRunningChanged,\n}: HelpContextProviderProps) => {\n  const manager = usePluginManager();\n  const layout = useCapability(Capabilities.Layout);\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      {children}\n    </HelpContext.Provider>\n  );\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport React from 'react';\n\nimport { keySymbols } from '@dxos/keyboard';\n\nimport { shortcutKey } from './styles';\n\nexport const Key = ({ binding }: { binding: string }) => {\n  return (\n    <span role='term' className='inline-flex gap-1' aria-label={binding} id={binding}>\n      {keySymbols(binding).map((c, i) => (\n        <span key={i} className={shortcutKey}>\n          {c}\n        </span>\n      ))}\n    </span>\n  );\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { mx } from '@dxos/react-ui-theme';\n\nexport const shortcutKey = mx(\n  'inline-flex min-is-[24px] bs-[24px] pli-0.5 justify-center items-center text-xs',\n  'rounded bg-neutral-100 dark:bg-neutral-900',\n);\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport React, { Fragment } from 'react';\n\nimport { Keyboard } from '@dxos/keyboard';\nimport { toLocalizedString, useTranslation } from '@dxos/react-ui';\nimport { mx } from '@dxos/react-ui-theme';\n\nimport { Key } from './Key';\nimport { HELP_PLUGIN } from '../../meta';\n\nexport const ShortcutsList = () => {\n  const { t } = useTranslation(HELP_PLUGIN);\n  const bindings = Keyboard.singleton.getBindings();\n\n  // TODO(burdon): Get shortcuts from TextEditor.\n  bindings.sort((a, b) => {\n    return toLocalizedString(a.data, t)?.toLowerCase().localeCompare(toLocalizedString(b.data, t)?.toLowerCase());\n  });\n\n  return (\n    <dl className={mx('is-fit grid grid-cols-[min-content_minmax(12rem,1fr)] gap-2 mlb-4 text-subdued')}>\n      {bindings.map((binding, i) => (\n        <Fragment key={i}>\n          <Key binding={binding.shortcut} />\n          <span role='definition' className='mis-4' aria-labelledby={binding.shortcut}>\n            {toLocalizedString(binding.data, t)}\n          </span>\n        </Fragment>\n      ))}\n    </dl>\n  );\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Button, Dialog, Icon, useTranslation } from '@dxos/react-ui';\n\nimport { ShortcutsList } from './ShortcutsList';\nimport { HELP_PLUGIN } from '../../meta';\n\nexport const SHORTCUTS_DIALOG = `${HELP_PLUGIN}/ShortcutsDialog`;\n\nexport const ShortcutsDialogContent = () => {\n  const { t } = useTranslation(HELP_PLUGIN);\n\n  return (\n    <Dialog.Content classNames='p-0 bs-content max-bs-full md:max-is-[25rem] overflow-hidden'>\n      <div role='none' className='flex justify-between mbe-1 pbs-3 pis-2 pie-3 @md:pbs-4 @md:pis-4 @md:pie-5'>\n        <Dialog.Title>{t('shortcuts dialog title')}</Dialog.Title>\n\n        <Dialog.Close asChild>\n          <Button density='fine' variant='ghost' autoFocus>\n            <Icon icon='ph--x--regular' size={3} />\n          </Button>\n        </Dialog.Close>\n      </div>\n\n      <div className='flex items-center justify-center'>\n        <ShortcutsList />\n      </div>\n    </Dialog.Content>\n  );\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { type KeyBinding, Keyboard } from '@dxos/keyboard';\nimport { Button, Icon, toLocalizedString, useTranslation } from '@dxos/react-ui';\n\nimport { Key } from './Key';\n\nconst Shortcut = ({ binding }: { binding: KeyBinding }) => {\n  const { t } = useTranslation('os');\n  return (\n    <div role='none' className='flex items-center gap-2 whitespace-nowrap'>\n      <Key binding={binding.shortcut} />\n      <span className='text-sm'>{toLocalizedString(binding.data, t)}</span>\n    </div>\n  );\n};\n\nexport const ShortcutsHints = ({ onClose }: { onClose?: () => void }) => {\n  // TODO(burdon): Display by context/weight/cycle.\n  const defaults = ['meta+k', 'meta+/', 'meta+,'];\n  const bindings = Keyboard.singleton.getBindings();\n  const hints = bindings.filter((binding) => defaults.includes(binding.shortcut));\n\n  return (\n    <div role='none' className='flex overflow-hidden px-2 gap-4'>\n      {hints.map((binding) => (\n        <Shortcut key={binding.shortcut} binding={binding} />\n      ))}\n      {onClose && (\n        <Button variant='ghost' classNames='p-0 cursor-pointer' onClick={onClose}>\n          <Icon icon='ph--x--regular' size={4} />\n        </Button>\n      )}\n    </div>\n  );\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport React from 'react';\n\nimport { descriptionText } from '@dxos/react-ui-theme';\n\nimport { ShortcutsList } from './ShortcutsList';\n\nexport const ShortcutsSection = () => {\n  return (\n    <section className={descriptionText}>\n      <ShortcutsList />\n    </section>\n  );\n};\n"],
-  "mappings": "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",
-  "names": ["useArrowNavigationGroup", "useFocusableGroup", "CaretLeft", "CaretRight", "Circle", "X", "React", "forwardRef", "Button", "getSize", "mx", "floaterProps", "styles", "arrow", "length", "spread", "floater", "filter", "Tooltip", "forwardRef", "step", "title", "content", "index", "size", "isLastStep", "backProps", "closeProps", "primaryProps", "forwardedRef", "arrowGroup", "useArrowNavigationGroup", "axis", "trapFocus", "useFocusableGroup", "tabBehavior", "div", "className", "role", "data-testid", "data-step", "ref", "h2", "Button", "density", "variant", "onClick", "X", "weight", "getSize", "classNames", "CaretLeft", "Array", "from", "map", "_", "i", "Circle", "key", "mx", "autoFocus", "CaretRight", "React", "useState", "useEffect", "Joyride", "ACTIONS", "EVENTS", "usePluginManager", "useCapability", "Capabilities", "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", "HelpContextProvider", "children", "steps", "initialSteps", "running", "runningProp", "onRunningChanged", "manager", "usePluginManager", "layout", "useCapability", "Capabilities", "Layout", "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", "React", "keySymbols", "mx", "shortcutKey", "mx", "Key", "binding", "React", "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"]
-}

package/dist/lib/browser/react-context-SIW6XKOC.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/capabilities/react-context.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Capabilities, contributes, useCapability } from '@dxos/app-framework';\n\nimport { HelpCapabilities } from './capabilities';\nimport { HelpContextProvider } from '../components';\nimport { HELP_PLUGIN } from '../meta';\nimport { type Step } from '../types';\n\nexport default (steps: Step[]) =>\n  contributes(Capabilities.ReactContext, {\n    id: HELP_PLUGIN,\n    context: ({ children }) => {\n      const state = useCapability(HelpCapabilities.MutableState);\n      return (\n        <HelpContextProvider\n          steps={steps}\n          running={state.running}\n          onRunningChanged={(newState) => {\n            state.running = newState;\n            if (!newState) {\n              state.showHints = false;\n            }\n          }}\n        >\n          {children}\n        </HelpContextProvider>\n      );\n    },\n  });\n"],
-  "mappings": ";;;;;;;;;;;;AAIA,OAAOA,WAAW;AAElB,SAASC,cAAcC,aAAaC,qBAAqB;AAOzD,IAAA,wBAAe,CAACC,UACdC,YAAYC,aAAaC,cAAc;EACrCC,IAAIC;EACJC,SAAS,CAAC,EAAEC,SAAQ,MAAE;AACpB,UAAMC,QAAQC,cAAcC,iBAAiBC,YAAY;AACzD,WACE,sBAAA,cAACC,qBAAAA;MACCZ;MACAa,SAASL,MAAMK;MACfC,kBAAkB,CAACC,aAAAA;AACjBP,cAAMK,UAAUE;AAChB,YAAI,CAACA,UAAU;AACbP,gBAAMQ,YAAY;QACpB;MACF;OAECT,QAAAA;EAGP;AACF,CAAA;",
-  "names": ["React", "Capabilities", "contributes", "useCapability", "steps", "contributes", "Capabilities", "ReactContext", "id", "HELP_PLUGIN", "context", "children", "state", "useCapability", "HelpCapabilities", "MutableState", "HelpContextProvider", "running", "onRunningChanged", "newState", "showHints"]
-}

package/dist/types/src/capabilities/react-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"react-context.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/react-context.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,UAAU,CAAC;gCAEd,IAAI,EAAE;;;;;AAA7B,wBAoBK"}

package/dist/types/src/components/HelpContextProvider/HelpContextProvider.d.ts

@@ -1,9 +0,0 @@
-import React, { type PropsWithChildren } from 'react';
-import { type Step } from '../../types';
-export type HelpContextProviderProps = PropsWithChildren<{
-    steps: Step[];
-    running?: boolean;
-    onRunningChanged?: (state: boolean) => any;
-}>;
-export declare const HelpContextProvider: ({ children, steps: initialSteps, running: runningProp, onRunningChanged, }: HelpContextProviderProps) => React.JSX.Element;
-//# sourceMappingURL=HelpContextProvider.d.ts.map

package/dist/types/src/components/HelpContextProvider/HelpContextProvider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"HelpContextProvider.d.ts","sourceRoot":"","sources":["../../../../../src/components/HelpContextProvider/HelpContextProvider.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAuB,MAAM,OAAO,CAAC;AAK3E,OAAO,EAAE,KAAK,IAAI,EAAe,MAAM,aAAa,CAAC;AAkDrD,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;IACvD,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,GAAG,CAAC;CAC5C,CAAC,CAAC;AAEH,eAAO,MAAM,mBAAmB,+EAK7B,wBAAwB,sBAyG1B,CAAC"}

package/dist/types/src/components/HelpContextProvider/HelpContextProvider.stories.d.ts

@@ -1,10 +0,0 @@
-import '@dxos-theme';
-import { type Meta, type StoryObj } from '@storybook/react';
-import { HelpContextProvider } from './HelpContextProvider';
-export declare const Default: StoryObj<typeof HelpContextProvider>;
-/**
- * IMPORTANT: Run in separate tab.
- */
-declare const meta: Meta<typeof HelpContextProvider>;
-export default meta;
-//# sourceMappingURL=HelpContextProvider.stories.d.ts.map

package/dist/types/src/components/HelpContextProvider/HelpContextProvider.stories.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"HelpContextProvider.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/HelpContextProvider/HelpContextProvider.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAO5D,OAAO,EAAE,mBAAmB,EAAiC,MAAM,uBAAuB,CAAC;AAwD3F,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,OAAO,mBAAmB,CA8BxD,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,mBAAmB,CAK1C,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/types/src/components/HelpContextProvider/index.d.ts

@@ -1,2 +0,0 @@
-export * from './HelpContextProvider';
-//# sourceMappingURL=index.d.ts.map

package/dist/types/src/components/HelpContextProvider/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/HelpContextProvider/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC"}

package/src/components/HelpContextProvider/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-export * from './HelpContextProvider';