@dxos/plugin-help 0.8.4-main.422d1c7879 → 0.8.4-main.4f23b4e393

package/dist/lib/neutral/HelpPlugin.mjs

@@ -0,0 +1,30 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/HelpPlugin.tsx
+import { ActivationEvents, Plugin } from "@dxos/app-framework";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { AppGraphBuilder, HelpState, OperationHandler, ReactRoot, ReactSurface } from "#capabilities";
+import { meta } from "#meta";
+import { translations } from "#translations";
+var HelpPlugin = Plugin.define(meta).pipe(AppPlugin.addAppGraphModule({
+  activate: AppGraphBuilder
+}), AppPlugin.addOperationHandlerModule({
+  activate: OperationHandler
+}), AppPlugin.addSurfaceModule({
+  activate: ReactSurface
+}), AppPlugin.addTranslationsModule({
+  translations
+}), Plugin.addModule({
+  activatesOn: ActivationEvents.Startup,
+  activate: HelpState
+}), Plugin.addModule(({ steps = [] }) => ({
+  id: "react-root",
+  activatesOn: ActivationEvents.Startup,
+  activate: () => ReactRoot(steps)
+})), Plugin.make);
+var HelpPlugin_default = HelpPlugin;
+export {
+  HelpPlugin,
+  HelpPlugin_default as default
+};
+//# sourceMappingURL=HelpPlugin.mjs.map

package/dist/lib/neutral/HelpPlugin.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/HelpPlugin.tsx"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { ActivationEvents, Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { AppGraphBuilder, HelpState, OperationHandler, ReactRoot, ReactSurface } from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { type Step } from '#types';\n\nexport type HelpPluginOptions = { steps?: Step[] };\n\nexport const HelpPlugin = Plugin.define<HelpPluginOptions>(meta).pipe(\n  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addSurfaceModule({ activate: ReactSurface }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.addModule({\n    activatesOn: ActivationEvents.Startup,\n    activate: HelpState,\n  }),\n  Plugin.addModule(({ steps = [] }) => ({\n    id: 'react-root',\n    activatesOn: ActivationEvents.Startup,\n    activate: () => ReactRoot(steps),\n  })),\n  Plugin.make,\n);\n\nexport default HelpPlugin;\n"],
+  "mappings": ";;;AAIA,SAASA,kBAAkBC,cAAc;AACzC,SAASC,iBAAiB;AAE1B,SAASC,iBAAiBC,WAAWC,kBAAkBC,WAAWC,oBAAoB;AACtF,SAASC,YAAY;AACrB,SAASC,oBAAoB;AAKtB,IAAMC,aAAaT,OAAOU,OAA0BH,IAAAA,EAAMI,KAC/DV,UAAUW,kBAAkB;EAAEC,UAAUX;AAAgB,CAAA,GACxDD,UAAUa,0BAA0B;EAAED,UAAUT;AAAiB,CAAA,GACjEH,UAAUc,iBAAiB;EAAEF,UAAUP;AAAa,CAAA,GACpDL,UAAUe,sBAAsB;EAAER;AAAa,CAAA,GAC/CR,OAAOiB,UAAU;EACfC,aAAanB,iBAAiBoB;EAC9BN,UAAUV;AACZ,CAAA,GACAH,OAAOiB,UAAU,CAAC,EAAEG,QAAQ,CAAA,EAAE,OAAQ;EACpCC,IAAI;EACJH,aAAanB,iBAAiBoB;EAC9BN,UAAU,MAAMR,UAAUe,KAAAA;AAC5B,EAAA,GACApB,OAAOsB,IAAI;AAGb,IAAA,qBAAeb;",
+  "names": ["ActivationEvents", "Plugin", "AppPlugin", "AppGraphBuilder", "HelpState", "OperationHandler", "ReactRoot", "ReactSurface", "meta", "translations", "HelpPlugin", "define", "pipe", "addAppGraphModule", "activate", "addOperationHandlerModule", "addSurfaceModule", "addTranslationsModule", "addModule", "activatesOn", "Startup", "steps", "id", "make"]
+}

package/dist/lib/neutral/ShortcutsDialogContent-TB5PZWVY.mjs

@@ -0,0 +1,17 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/containers/ShortcutsDialogContent/ShortcutsDialogContent.tsx
+import React from "react";
+import { Dialog, useTranslation } from "@dxos/react-ui";
+import { ShortcutsList } from "#components";
+import { meta } from "#meta";
+var ShortcutsDialogContent = () => {
+  const { t } = useTranslation(meta.id);
+  return /* @__PURE__ */ React.createElement(Dialog.Content, null, /* @__PURE__ */ React.createElement(Dialog.Header, null, /* @__PURE__ */ React.createElement(Dialog.Title, null, t("shortcuts-dialog.title")), /* @__PURE__ */ React.createElement(Dialog.Close, {
+    asChild: true
+  }, /* @__PURE__ */ React.createElement(Dialog.CloseIconButton, null))), /* @__PURE__ */ React.createElement(Dialog.Body, null, /* @__PURE__ */ React.createElement(ShortcutsList, null)));
+};
+export {
+  ShortcutsDialogContent as default
+};
+//# sourceMappingURL=ShortcutsDialogContent-TB5PZWVY.mjs.map

package/dist/lib/neutral/ShortcutsDialogContent-TB5PZWVY.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/containers/ShortcutsDialogContent/ShortcutsDialogContent.tsx"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Dialog, useTranslation } from '@dxos/react-ui';\n\nimport { ShortcutsList } from '#components';\nimport { meta } from '#meta';\n\nexport const ShortcutsDialogContent = () => {\n  const { t } = useTranslation(meta.id);\n\n  return (\n    <Dialog.Content>\n      <Dialog.Header>\n        <Dialog.Title>{t('shortcuts-dialog.title')}</Dialog.Title>\n        <Dialog.Close asChild>\n          <Dialog.CloseIconButton />\n        </Dialog.Close>\n      </Dialog.Header>\n      <Dialog.Body>\n        <ShortcutsList />\n      </Dialog.Body>\n    </Dialog.Content>\n  );\n};\n"],
+  "mappings": ";;;AAIA,OAAOA,WAAW;AAElB,SAASC,QAAQC,sBAAsB;AAEvC,SAASC,qBAAqB;AAC9B,SAASC,YAAY;AAEd,IAAMC,yBAAyB,MAAA;AACpC,QAAM,EAAEC,EAAC,IAAKJ,eAAeE,KAAKG,EAAE;AAEpC,SACE,sBAAA,cAACN,OAAOO,SAAO,MACb,sBAAA,cAACP,OAAOQ,QAAM,MACZ,sBAAA,cAACR,OAAOS,OAAK,MAAEJ,EAAE,wBAAA,CAAA,GACjB,sBAAA,cAACL,OAAOU,OAAK;IAACC,SAAAA;KACZ,sBAAA,cAACX,OAAOY,iBAAe,IAAA,CAAA,CAAA,GAG3B,sBAAA,cAACZ,OAAOa,MAAI,MACV,sBAAA,cAACX,eAAAA,IAAAA,CAAAA,CAAAA;AAIT;",
+  "names": ["React", "Dialog", "useTranslation", "ShortcutsList", "meta", "ShortcutsDialogContent", "t", "id", "Content", "Header", "Title", "Close", "asChild", "CloseIconButton", "Body"]
+}

package/dist/lib/neutral/ShortcutsHints-ROTD5B7S.mjs

@@ -0,0 +1,8 @@
+import {
+  ShortcutsHints
+} from "./chunk-2COFFSNF.mjs";
+import "./chunk-J5LGTIGS.mjs";
+export {
+  ShortcutsHints as default
+};
+//# sourceMappingURL=ShortcutsHints-ROTD5B7S.mjs.map

package/dist/lib/neutral/ShortcutsList-SK56WBBY.mjs

@@ -0,0 +1,8 @@
+import {
+  ShortcutsList
+} from "./chunk-2COFFSNF.mjs";
+import "./chunk-J5LGTIGS.mjs";
+export {
+  ShortcutsList as default
+};
+//# sourceMappingURL=ShortcutsList-SK56WBBY.mjs.map

package/dist/lib/neutral/app-graph-builder-BJYIYNMN.mjs

@@ -0,0 +1,75 @@
+import {
+  SHORTCUTS_DIALOG
+} from "./chunk-MQQNHGDV.mjs";
+import "./chunk-J5LGTIGS.mjs";
+
+// src/capabilities/app-graph-builder.ts
+import * as Effect from "effect/Effect";
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { GraphBuilder, Node, NodeMatcher } from "@dxos/app-graph";
+import { AppCapabilities, LayoutOperation } from "@dxos/app-toolkit";
+import { Operation } from "@dxos/compute";
+import { meta } from "#meta";
+import { HelpCapabilities, HelpOperation } from "#types";
+var app_graph_builder_default = Capability.makeModule(Effect.fnUntraced(function* () {
+  const extensions = yield* GraphBuilder.createExtension({
+    id: "root",
+    match: NodeMatcher.whenRoot,
+    actions: () => Effect.succeed([
+      Node.makeAction({
+        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.message",
+            {
+              ns: meta.id
+            }
+          ],
+          icon: "ph--info--regular",
+          keyBinding: {
+            macos: "shift+meta+/",
+            windows: "shift+ctrl+/",
+            linux: "shift+ctrl+?"
+          },
+          testId: "helpPlugin.openHelp"
+        }
+      }),
+      Node.makeAction({
+        id: "open-shortcuts",
+        data: Effect.fnUntraced(function* () {
+          yield* Capabilities.updateAtomValue(HelpCapabilities.State, (s) => ({
+            ...s,
+            showHints: true
+          }));
+          yield* Operation.invoke(LayoutOperation.UpdateDialog, {
+            subject: SHORTCUTS_DIALOG
+          });
+        }),
+        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-BJYIYNMN.mjs.map

package/dist/lib/neutral/app-graph-builder-BJYIYNMN.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/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, Node, NodeMatcher } from '@dxos/app-graph';\nimport { AppCapabilities, LayoutOperation } from '@dxos/app-toolkit';\nimport { Operation } from '@dxos/compute';\n\nimport { meta } from '#meta';\nimport { HelpCapabilities, HelpOperation } from '#types';\n\nimport { SHORTCUTS_DIALOG } from '../constants';\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const extensions = yield* GraphBuilder.createExtension({\n      id: 'root',\n      match: NodeMatcher.whenRoot,\n      actions: () =>\n        Effect.succeed([\n          Node.makeAction({\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.message', { 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          Node.makeAction({\n            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              });\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,MAAMC,mBAAmB;AAChD,SAASC,iBAAiBC,uBAAuB;AACjD,SAASC,iBAAiB;AAE1B,SAASC,YAAY;AACrB,SAASC,kBAAkBC,qBAAqB;AAIhD,IAAA,4BAAeC,WAAWC,WACjBC,kBAAW,aAAA;AAChB,QAAMC,aAAa,OAAOC,aAAaC,gBAAgB;IACrDC,IAAI;IACJC,OAAOC,YAAYC;IACnBC,SAAS,MACAC,eAAQ;MACbC,KAAKC,WAAW;QACdP,IAAIQ,cAAcC,MAAMC,KAAKC;QAC7BC,MAAahB,kBAAW,aAAA;AACtB,iBAAOiB,aAAaC,gBAAgBC,iBAAiBC,OAAO,CAACC,OAAO;YAAE,GAAGA;YAAGC,WAAW;UAAK,EAAA;AAC5F,iBAAOC,UAAUC,OAAOZ,cAAcC,KAAK;QAC7C,CAAA;QACAY,YAAY;UACVC,OAAO;YAAC;YAA0B;cAAEC,IAAIb,KAAKV;YAAG;;UAChDwB,MAAM;UACNC,YAAY;YACVC,OAAO;YACPC,SAAS;YACTC,OAAO;UACT;UACAC,QAAQ;QACV;MACF,CAAA;MACAvB,KAAKC,WAAW;QACdP,IAAI;QACJY,MAAahB,kBAAW,aAAA;AACtB,iBAAOiB,aAAaC,gBAAgBC,iBAAiBC,OAAO,CAACC,OAAO;YAAE,GAAGA;YAAGC,WAAW;UAAK,EAAA;AAC5F,iBAAOC,UAAUC,OAAOU,gBAAgBC,cAAc;YACpDC,SAASC;UACX,CAAA;QACF,CAAA;QACAZ,YAAY;UACVC,OAAO;YAAC;YAAwB;cAAEC,IAAIb,KAAKV;YAAG;;UAC9CwB,MAAM;UACNC,YAAY;YACVC,OAAO;UACT;QACF;MACF,CAAA;KACD;EACL,CAAA;AAEA,SAAOhC,WAAWwC,YAAYC,gBAAgBC,iBAAiBvC,UAAAA;AACjE,CAAA,CAAA;",
+  "names": ["Effect", "Capabilities", "Capability", "GraphBuilder", "Node", "NodeMatcher", "AppCapabilities", "LayoutOperation", "Operation", "meta", "HelpCapabilities", "HelpOperation", "Capability", "makeModule", "fnUntraced", "extensions", "GraphBuilder", "createExtension", "id", "match", "NodeMatcher", "whenRoot", "actions", "succeed", "Node", "makeAction", "HelpOperation", "Start", "meta", "key", "data", "Capabilities", "updateAtomValue", "HelpCapabilities", "State", "s", "showHints", "Operation", "invoke", "properties", "label", "ns", "icon", "keyBinding", "macos", "windows", "linux", "testId", "LayoutOperation", "UpdateDialog", "subject", "SHORTCUTS_DIALOG", "contributes", "AppCapabilities", "AppGraphBuilder"]
+}

package/dist/lib/neutral/capabilities/index.mjs

@@ -0,0 +1,17 @@
+import "../chunk-J5LGTIGS.mjs";
+
+// src/capabilities/index.ts
+import { Capability } from "@dxos/app-framework";
+var AppGraphBuilder = Capability.lazy("AppGraphBuilder", () => import("../app-graph-builder-BJYIYNMN.mjs"));
+var OperationHandler = Capability.lazy("OperationHandler", () => import("../operation-handler-F2JU4V62.mjs"));
+var ReactRoot = Capability.lazy("ReactRoot", () => import("../react-root-PYPAXETF.mjs"));
+var ReactSurface = Capability.lazy("ReactSurface", () => import("../react-surface-SNS4QQMR.mjs"));
+var HelpState = Capability.lazy("HelpState", () => import("../state-5HQJG3KW.mjs"));
+export {
+  AppGraphBuilder,
+  HelpState,
+  OperationHandler,
+  ReactRoot,
+  ReactSurface
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/neutral/capabilities/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/capabilities/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\nimport { OperationHandlerSet } from '@dxos/compute';\n\nexport const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));\nexport const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(\n  'OperationHandler',\n  () => import('./operation-handler'),\n);\nexport const ReactRoot = Capability.lazy('ReactRoot', () => import('./react-root'));\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\nexport const HelpState = Capability.lazy('HelpState', () => import('./state'));\n"],
+  "mappings": ";;;AAIA,SAASA,kBAAkB;AAGpB,IAAMC,kBAAkBD,WAAWE,KAAK,mBAAmB,MAAM,OAAO,mCAAA,CAAA;AACxE,IAAMC,mBAAmBH,WAAWE,KACzC,oBACA,MAAM,OAAO,mCAAA,CAAA;AAER,IAAME,YAAYJ,WAAWE,KAAK,aAAa,MAAM,OAAO,4BAAA,CAAA;AAC5D,IAAMG,eAAeL,WAAWE,KAAK,gBAAgB,MAAM,OAAO,+BAAA,CAAA;AAClE,IAAMI,YAAYN,WAAWE,KAAK,aAAa,MAAM,OAAO,uBAAA,CAAA;",
+  "names": ["Capability", "AppGraphBuilder", "lazy", "OperationHandler", "ReactRoot", "ReactSurface", "HelpState"]
+}

package/dist/lib/{browser/index.mjs → neutral/chunk-2COFFSNF.mjs}

@@ -1,12 +1,3 @@
-import {
-  meta
-} from "./chunk-TEXIV2IJ.mjs";
-import {
-  HelpCapabilities,
-  HelpContext
-} from "./chunk-K4LQ2TR7.mjs";
-import "./chunk-J5LGTIGS.mjs";
-
 // src/components/Shortcuts/ShortcutsHints.tsx
 import React2 from "react";
 import { Keyboard } from "@dxos/keyboard";
@@ -38,7 +29,6 @@ var Key = ({ binding }) => {
 var Shortcut = ({ binding }) => {
   const { t } = useTranslation(osTranslations);
   return /* @__PURE__ */ React2.createElement("div", {
-    role: "none",
     className: "flex items-center gap-2 whitespace-nowrap"
   }, /* @__PURE__ */ React2.createElement(Key, {
     binding: binding.shortcut
@@ -55,7 +45,6 @@ var ShortcutsHints = ({ onClose }) => {
   const bindings = Keyboard.singleton.getBindings();
   const hints = bindings.filter((binding) => defaults.includes(binding.shortcut));
   return /* @__PURE__ */ React2.createElement("div", {
-    role: "none",
     className: "flex overflow-hidden px-2 gap-4"
   }, hints.map((binding) => /* @__PURE__ */ React2.createElement(Shortcut, {
     key: binding.shortcut,
@@ -77,9 +66,9 @@ import React3, { Fragment } from "react";
 import { Keyboard as Keyboard2 } from "@dxos/keyboard";
 import { toLocalizedString as toLocalizedString2, useTranslation as useTranslation2 } from "@dxos/react-ui";
 import { mx as mx2 } from "@dxos/ui-theme";
-import { meta as meta2 } from "#meta";
+import { meta } from "#meta";
 var ShortcutsList = () => {
-  const { t } = useTranslation2(meta2.id);
+  const { t } = useTranslation2(meta.id);
   const bindings = Keyboard2.singleton.getBindings();
   bindings.sort((a, b) => {
     return toLocalizedString2(a.data, t)?.toLowerCase().localeCompare(toLocalizedString2(b.data, t)?.toLowerCase());
@@ -130,7 +119,7 @@ var Tooltip = /* @__PURE__ */ forwardRef(({ step: { title, content }, index, siz
     tabBehavior: "limited-trap-focus"
   });
   return /* @__PURE__ */ React5.createElement("div", {
-    className: "flex flex-col w-[15rem] min-h-[10rem] overflow-hidden rounded-md shadow-xl bg-accent-surface text-accent-surface-text",
+    className: "flex flex-col w-[15rem] min-h-[10rem] overflow-hidden rounded-md shadow-xl bg-accent-surface text-accent-foreground",
     role: "tooltip",
     "data-testid": "helpPlugin.tooltip",
     "data-step": index + 1,
@@ -139,7 +128,7 @@ var Tooltip = /* @__PURE__ */ forwardRef(({ step: { title, content }, index, siz
   }, /* @__PURE__ */ React5.createElement("div", {
     className: "flex p-2"
   }, /* @__PURE__ */ React5.createElement("h2", {
-    className: "grow px-2 py-1 text-lg font-medium text-accent-surface-text"
+    className: "grow px-2 py-1 text-lg font-medium text-accent-foreground"
   }, title), /* @__PURE__ */ React5.createElement(IconButton2, {
     density: "fine",
     icon: "ph--x--bold",
@@ -199,7 +188,7 @@ 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";
-import { HelpContext as HelpContext2 } from "#types";
+import { HelpContext } from "#types";
 var addStepClass = (target) => {
   const element = typeof target === "string" ? document.querySelector(target) : target;
   if (element) {
@@ -307,7 +296,7 @@ var WelcomeTour = ({ steps: initialSteps, running: runningProp, onRunningChanged
         break;
     }
   };
-  return /* @__PURE__ */ React6.createElement(HelpContext2.Provider, {
+  return /* @__PURE__ */ React6.createElement(HelpContext.Provider, {
     value: {
       running: running && !paused,
       steps,
@@ -330,69 +319,13 @@ var WelcomeTour = ({ steps: initialSteps, running: runningProp, onRunningChanged
   }));
 };
 
-// src/constants.ts
-import { meta as meta3 } from "#meta";
-var SHORTCUTS_DIALOG = `${meta3.id}.ShortcutsDialog`;
-
-// src/HelpPlugin.tsx
-import { ActivationEvents, Plugin } from "@dxos/app-framework";
-import { AppPlugin } from "@dxos/app-toolkit";
-import { AppGraphBuilder, HelpState, OperationHandler, ReactRoot, ReactSurface } from "#capabilities";
-import { meta as meta5 } from "#meta";
-
-// src/translations.ts
-import { meta as meta4 } from "#meta";
-var translations = [
-  {
-    "en-US": {
-      [meta4.id]: {
-        "plugin.name": "Help",
-        "open-help-tour.message": "Show welcome tour",
-        "open-shortcuts.label": "Show shortcuts",
-        "shortcuts-dialog.title": "Shortcuts"
-      }
-    }
-  }
-];
-
-// src/HelpPlugin.tsx
-var HelpPlugin = Plugin.define(meta5).pipe(AppPlugin.addAppGraphModule({
-  activate: AppGraphBuilder
-}), AppPlugin.addOperationHandlerModule({
-  activate: OperationHandler
-}), AppPlugin.addSurfaceModule({
-  activate: ReactSurface
-}), AppPlugin.addTranslationsModule({
-  translations
-}), Plugin.addModule({
-  activatesOn: ActivationEvents.Startup,
-  activate: HelpState
-}), Plugin.addModule(({ steps = [] }) => ({
-  id: "react-root",
-  activatesOn: ActivationEvents.Startup,
-  activate: () => ReactRoot(steps)
-})), Plugin.make);
-
-// src/hooks/useHelp.tsx
-import { useContext } from "react";
-import { raise } from "@dxos/debug";
-import { HelpContext as HelpContext3 } from "#types";
-var useHelp = () => {
-  return useContext(HelpContext3) ?? raise(new Error("Missing HelpContext"));
-};
 export {
-  HelpCapabilities,
-  HelpContext,
-  HelpPlugin,
   Key,
-  SHORTCUTS_DIALOG,
   ShortcutsHints,
   ShortcutsList,
   ShortcutsSection,
-  Tooltip,
-  WelcomeTour,
   floaterProps,
-  meta,
-  useHelp
+  Tooltip,
+  WelcomeTour
 };
-//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=chunk-2COFFSNF.mjs.map

package/dist/lib/neutral/chunk-2COFFSNF.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/components/Shortcuts/ShortcutsHints.tsx", "../../../src/components/Shortcuts/Key.tsx", "../../../src/components/Shortcuts/styles.ts", "../../../src/components/Shortcuts/ShortcutsList.tsx", "../../../src/components/Shortcuts/ShortcutsSection.tsx", "../../../src/components/Tooltip/Tooltip.tsx", "../../../src/components/WelcomeTour/WelcomeTour.tsx"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { type KeyBinding, Keyboard } from '@dxos/keyboard';\nimport { IconButton, toLocalizedString, useTranslation } from '@dxos/react-ui';\nimport { osTranslations } from '@dxos/ui-theme';\n\nimport { Key } from './Key';\n\nconst Shortcut = ({ binding }: { binding: KeyBinding }) => {\n  const { t } = useTranslation(osTranslations);\n  return (\n    <div 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 className='flex overflow-hidden px-2 gap-4'>\n      {hints.map((binding) => (\n        <Shortcut key={binding.shortcut} binding={binding} />\n      ))}\n      {onClose && (\n        <IconButton\n          icon='ph--x--regular'\n          size={4}\n          label='Close'\n          iconOnly\n          noTooltip\n          variant='ghost'\n          classNames='p-0 cursor-pointer'\n          onClick={onClose}\n        />\n      )}\n    </div>\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/ui-theme';\n\nexport const shortcutKey = mx(\n  'inline-flex min-w-[24px] h-[24px] px-0.5 justify-center items-center text-xs',\n  'rounded-sm 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/ui-theme';\n\nimport { meta } from '#meta';\n\nimport { Key } from './Key';\n\nexport const ShortcutsList = () => {\n  const { t } = useTranslation(meta.id);\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('w-fit grid grid-cols-[min-content_minmax(12rem,1fr)] gap-2 my-4 text-subdued select-none')}>\n      {bindings.map((binding, i) => (\n        <Fragment key={i}>\n          <Key binding={binding.shortcut} />\n          <span role='definition' className='ms-4' aria-labelledby={binding.shortcut}>\n            {toLocalizedString(binding.data, t)}\n          </span>\n        </Fragment>\n      ))}\n    </dl>\n  );\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport React from 'react';\n\nimport { ShortcutsList } from './ShortcutsList';\n\nexport const ShortcutsSection = () => {\n  return (\n    <section className='text-description'>\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 Props, type TooltipRenderProps } 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 w-[15rem] min-h-[10rem] overflow-hidden rounded-md shadow-xl bg-accent-surface text-accent-foreground'\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 px-2 py-1 text-lg font-medium text-accent-foreground'>{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 px-4 my-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              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='mx-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 } from 'react';\nimport Joyride, { ACTIONS, EVENTS } from 'react-joyride';\n\nimport { usePluginManager } from '@dxos/app-framework/ui';\nimport { useLayout } from '@dxos/app-toolkit/ui';\nimport { useAsyncEffect } from '@dxos/react-ui';\n\nimport { HelpContext, type Step } from '#types';\n\nimport { Tooltip, floaterProps } 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.capabilities);\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  useAsyncEffect(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  }, [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        spotlightPadding={0}\n      />\n    </HelpContext.Provider>\n  );\n};\n"],
+  "mappings": "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",
+  "names": ["React", "Keyboard", "IconButton", "toLocalizedString", "useTranslation", "osTranslations", "React", "keySymbols", "mx", "shortcutKey", "Key", "binding", "span", "role", "className", "aria-label", "id", "keySymbols", "map", "c", "i", "key", "shortcutKey", "Shortcut", "binding", "t", "useTranslation", "osTranslations", "React", "div", "className", "Key", "shortcut", "span", "toLocalizedString", "data", "ShortcutsHints", "onClose", "defaults", "bindings", "Keyboard", "singleton", "getBindings", "hints", "filter", "includes", "map", "key", "IconButton", "icon", "size", "label", "iconOnly", "noTooltip", "variant", "classNames", "onClick", "React", "Fragment", "Keyboard", "toLocalizedString", "useTranslation", "mx", "meta", "ShortcutsList", "t", "useTranslation", "meta", "id", "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", "ShortcutsSection", "React", "section", "className", "ShortcutsList", "useArrowNavigationGroup", "useFocusableGroup", "React", "forwardRef", "Button", "Icon", "IconButton", "floaterProps", "styles", "arrow", "length", "spread", "floater", "filter", "Tooltip", "step", "title", "content", "index", "size", "isLastStep", "backProps", "closeProps", "primaryProps", "forwardedRef", "arrowNavigationAttrs", "axis", "focusableGroupAttrs", "tabBehavior", "div", "className", "role", "data-testid", "data-step", "ref", "h2", "density", "icon", "iconOnly", "label", "onClick", "variant", "classNames", "Array", "from", "map", "_", "i", "key", "autoFocus", "React", "useState", "Joyride", "ACTIONS", "EVENTS", "usePluginManager", "useLayout", "useAsyncEffect", "HelpContext", "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", "capabilities", "setRunningChanged", "state", "useAsyncEffect", "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", "spotlightPadding"]
+}

package/dist/lib/neutral/chunk-BI3HKFKB.mjs

@@ -0,0 +1,63 @@
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/types/HelpCapabilities.ts
+var HelpCapabilities_exports = {};
+__export(HelpCapabilities_exports, {
+  State: () => State,
+  StateSchema: () => StateSchema
+});
+import * as Schema from "effect/Schema";
+import { Capability } from "@dxos/app-framework";
+import { meta } from "#meta";
+var StateSchema = Schema.mutable(Schema.Struct({
+  running: Schema.Boolean,
+  showHints: Schema.Boolean,
+  showWelcome: Schema.Boolean
+}));
+var State = Capability.make(`${meta.id}.capability.state`);
+
+// src/types/HelpOperation.ts
+var HelpOperation_exports = {};
+__export(HelpOperation_exports, {
+  Start: () => Start
+});
+import * as Schema2 from "effect/Schema";
+import { Capability as Capability2 } from "@dxos/app-framework";
+import { Operation } from "@dxos/compute";
+import { meta as meta2 } from "#meta";
+var HELP_OPERATION = `${meta2.id}.operation`;
+var Start = Operation.make({
+  meta: {
+    key: `${HELP_OPERATION}.start`,
+    name: "Start Help"
+  },
+  services: [
+    Capability2.Service
+  ],
+  input: Schema2.Void,
+  output: Schema2.Void
+});
+
+// src/types/schema.ts
+import { createContext } from "react";
+var HelpContext = createContext({
+  running: false,
+  steps: [],
+  setSteps: () => {
+  },
+  setIndex: () => {
+  },
+  start: () => {
+  },
+  stop: () => {
+  }
+});
+
+export {
+  HelpCapabilities_exports,
+  HelpOperation_exports,
+  HelpContext
+};
+//# sourceMappingURL=chunk-BI3HKFKB.mjs.map

package/dist/lib/neutral/chunk-BI3HKFKB.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/HelpCapabilities.ts", "../../../src/types/HelpOperation.ts", "../../../src/types/schema.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { type Atom } from '@effect-atom/atom-react';\nimport * as Schema from 'effect/Schema';\n\nimport { Capability } from '@dxos/app-framework';\n\nimport { meta } from '#meta';\n\nexport const StateSchema = Schema.mutable(\n  Schema.Struct({\n    running: Schema.Boolean,\n    showHints: Schema.Boolean,\n    showWelcome: Schema.Boolean,\n  }),\n);\n\nexport type State = Schema.Schema.Type<typeof StateSchema>;\n\nexport const State = Capability.make<Atom.Writable<State>>(`${meta.id}.capability.state`);\n", "//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { Capability } from '@dxos/app-framework';\nimport { Operation } from '@dxos/compute';\n\nimport { meta } from '#meta';\n\nconst HELP_OPERATION = `${meta.id}.operation`;\n\nexport const Start = Operation.make({\n  meta: { key: `${HELP_OPERATION}.start`, name: 'Start Help' },\n  services: [Capability.Service],\n  input: Schema.Void,\n  output: Schema.Void,\n});\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Context, createContext } from 'react';\nimport { type Step as BaseStep } from 'react-joyride';\n\nimport { type CapabilityManager } from '@dxos/app-framework';\n\nexport type Step = BaseStep & {\n  before?: (capabilities: CapabilityManager.CapabilityManager) => 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"],
+  "mappings": ";;;;;AAAA;;;;;AAOA,YAAYA,YAAY;AAExB,SAASC,kBAAkB;AAE3B,SAASC,YAAY;AAEd,IAAMC,cAAqBC,eACzBC,cAAO;EACZC,SAAgBC;EAChBC,WAAkBD;EAClBE,aAAoBF;AACtB,CAAA,CAAA;AAKK,IAAMG,QAAQT,WAAWU,KAA2B,GAAGT,KAAKU,EAAE,mBAAmB;;;ACvBxF;;;;AAMA,YAAYC,aAAY;AAExB,SAASC,cAAAA,mBAAkB;AAC3B,SAASC,iBAAiB;AAE1B,SAASC,QAAAA,aAAY;AAErB,IAAMC,iBAAiB,GAAGD,MAAKE,EAAE;AAE1B,IAAMC,QAAQJ,UAAUK,KAAK;EAClCJ,MAAM;IAAEK,KAAK,GAAGJ,cAAAA;IAAwBK,MAAM;EAAa;EAC3DC,UAAU;IAACT,YAAWU;;EACtBC,OAAcC;EACdC,QAAeD;AACjB,CAAA;;;AChBA,SAAuBE,qBAAqB;AAkBrC,IAAMC,cAAwCD,cAA+B;EAClFE,SAAS;EACTC,OAAO,CAAA;EACPC,UAAU,MAAA;EAAO;EACjBC,UAAU,MAAA;EAAO;EACjBC,OAAO,MAAA;EAAO;EACdC,MAAM,MAAA;EAAO;AACf,CAAA;",
+  "names": ["Schema", "Capability", "meta", "StateSchema", "mutable", "Struct", "running", "Boolean", "showHints", "showWelcome", "State", "make", "id", "Schema", "Capability", "Operation", "meta", "HELP_OPERATION", "id", "Start", "make", "key", "name", "services", "Service", "input", "Void", "output", "createContext", "HelpContext", "running", "steps", "setSteps", "setIndex", "start", "stop"]
+}

package/dist/lib/neutral/chunk-GZL2J55W.mjs

@@ -0,0 +1,8 @@
+// src/operations/index.ts
+import { OperationHandlerSet } from "@dxos/compute";
+var HelpOperationHandlerSet = OperationHandlerSet.lazy(() => import("./start-XYUDZGXJ.mjs"));
+
+export {
+  HelpOperationHandlerSet
+};
+//# sourceMappingURL=chunk-GZL2J55W.mjs.map

package/dist/lib/neutral/chunk-GZL2J55W.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/operations/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { OperationHandlerSet } from '@dxos/compute';\n\nexport const HelpOperationHandlerSet = OperationHandlerSet.lazy(() => import('./start'));\n"],
+  "mappings": ";AAIA,SAASA,2BAA2B;AAE7B,IAAMC,0BAA0BD,oBAAoBE,KAAK,MAAM,OAAO,sBAAA,CAAA;",
+  "names": ["OperationHandlerSet", "HelpOperationHandlerSet", "lazy"]
+}

package/dist/lib/neutral/chunk-MQQNHGDV.mjs

@@ -0,0 +1,8 @@
+// src/constants.ts
+import { meta } from "#meta";
+var SHORTCUTS_DIALOG = `${meta.id}.ShortcutsDialog`;
+
+export {
+  SHORTCUTS_DIALOG
+};
+//# sourceMappingURL=chunk-MQQNHGDV.mjs.map

package/dist/lib/neutral/chunk-MQQNHGDV.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/constants.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { meta } from '#meta';\n\nexport const SHORTCUTS_DIALOG = `${meta.id}.ShortcutsDialog`;\n"],
+  "mappings": ";AAIA,SAASA,YAAY;AAEd,IAAMC,mBAAmB,GAAGD,KAAKE,EAAE;",
+  "names": ["meta", "SHORTCUTS_DIALOG", "id"]
+}

package/dist/lib/{browser/chunk-TEXIV2IJ.mjs → neutral/chunk-NHTI7NEQ.mjs}

@@ -7,10 +7,13 @@ var meta = {
     Built-in help system with documentation, tutorials, and contextual assistance.
     Access keyboard shortcuts, feature guides, and support resources.
   `,
-  icon: "ph--info--regular"
+  icon: "ph--info--regular",
+  tags: [
+    "system"
+  ]
 };
 
 export {
   meta
 };
-//# sourceMappingURL=chunk-TEXIV2IJ.mjs.map
+//# sourceMappingURL=chunk-NHTI7NEQ.mjs.map

package/dist/lib/{browser/chunk-TEXIV2IJ.mjs.map → neutral/chunk-NHTI7NEQ.mjs.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/meta.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Plugin } from '@dxos/app-framework';\nimport { trim } from '@dxos/util';\n\nexport const meta: Plugin.Meta = {\n  id: 'org.dxos.plugin.help',\n  name: 'Help',\n  description: trim`\n    Built-in help system with documentation, tutorials, and contextual assistance.\n    Access keyboard shortcuts, feature guides, and support resources.\n  `,\n  icon: 'ph--info--regular',\n};\n"],
-  "mappings": ";AAKA,SAASA,YAAY;AAEd,IAAMC,OAAoB;EAC/BC,IAAI;EACJC,MAAM;EACNC,aAAaC;;;;EAIbC,MAAM;AACR;",
-  "names": ["trim", "meta", "id", "name", "description", "trim", "icon"]
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Plugin } from '@dxos/app-framework';\nimport { trim } from '@dxos/util';\n\nexport const meta: Plugin.Meta = {\n  id: 'org.dxos.plugin.help',\n  name: 'Help',\n  description: trim`\n    Built-in help system with documentation, tutorials, and contextual assistance.\n    Access keyboard shortcuts, feature guides, and support resources.\n  `,\n  icon: 'ph--info--regular',\n  tags: ['system'],\n};\n"],
+  "mappings": ";AAKA,SAASA,YAAY;AAEd,IAAMC,OAAoB;EAC/BC,IAAI;EACJC,MAAM;EACNC,aAAaJ;;;;EAIbK,MAAM;EACNC,MAAM;IAAC;;AACT;",
+  "names": ["trim", "meta", "id", "name", "description", "icon", "tags"]
 }

package/dist/lib/neutral/components/index.mjs

@@ -0,0 +1,20 @@
+import {
+  Key,
+  ShortcutsHints,
+  ShortcutsList,
+  ShortcutsSection,
+  Tooltip,
+  WelcomeTour,
+  floaterProps
+} from "../chunk-2COFFSNF.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  Key,
+  ShortcutsHints,
+  ShortcutsList,
+  ShortcutsSection,
+  Tooltip,
+  WelcomeTour,
+  floaterProps
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/neutral/components/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/lib/neutral/containers/index.mjs

@@ -0,0 +1,13 @@
+import "../chunk-J5LGTIGS.mjs";
+
+// src/containers/index.ts
+import { lazy } from "react";
+var ShortcutsDialogContent = lazy(() => import("../ShortcutsDialogContent-TB5PZWVY.mjs"));
+var ShortcutsHints = lazy(() => import("../ShortcutsHints-ROTD5B7S.mjs"));
+var ShortcutsList = lazy(() => import("../ShortcutsList-SK56WBBY.mjs"));
+export {
+  ShortcutsDialogContent,
+  ShortcutsHints,
+  ShortcutsList
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/neutral/containers/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/containers/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type ComponentType, lazy } from 'react';\n\nexport const ShortcutsDialogContent: ComponentType<any> = lazy(() => import('./ShortcutsDialogContent'));\nexport const ShortcutsHints: ComponentType<any> = lazy(() => import('./ShortcutsHints'));\nexport const ShortcutsList: ComponentType<any> = lazy(() => import('./ShortcutsList'));\n"],
+  "mappings": ";;;AAIA,SAA6BA,YAAY;AAElC,IAAMC,yBAA6CD,KAAK,MAAM,OAAO,wCAAA,CAAA;AACrE,IAAME,iBAAqCF,KAAK,MAAM,OAAO,gCAAA,CAAA;AAC7D,IAAMG,gBAAoCH,KAAK,MAAM,OAAO,+BAAA,CAAA;",
+  "names": ["lazy", "ShortcutsDialogContent", "ShortcutsHints", "ShortcutsList"]
+}