@dxos/plugin-help 0.8.4-main.f9ba587 → 0.8.4-main.fcfe5033a5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (163) hide show
  1. package/dist/lib/browser/chunk-J5LGTIGS.mjs +10 -0
  2. package/dist/lib/browser/chunk-K4LQ2TR7.mjs +34 -0
  3. package/dist/lib/browser/chunk-K4LQ2TR7.mjs.map +7 -0
  4. package/dist/lib/browser/chunk-KUUIRJG5.mjs +31 -0
  5. package/dist/lib/browser/chunk-KUUIRJG5.mjs.map +7 -0
  6. package/dist/lib/browser/chunk-TEXIV2IJ.mjs +16 -0
  7. package/dist/lib/browser/chunk-TEXIV2IJ.mjs.map +7 -0
  8. package/dist/lib/browser/index.mjs +358 -75
  9. package/dist/lib/browser/index.mjs.map +4 -4
  10. package/dist/lib/browser/meta.json +1 -1
  11. package/dist/lib/browser/meta.mjs +2 -3
  12. package/dist/lib/browser/operations/index.mjs +13 -0
  13. package/dist/lib/browser/operations/index.mjs.map +7 -0
  14. package/dist/lib/browser/start-YZBO346C.mjs +23 -0
  15. package/dist/lib/browser/start-YZBO346C.mjs.map +7 -0
  16. package/dist/lib/browser/types/index.mjs +10 -0
  17. package/dist/types/src/HelpPlugin.d.ts +3 -2
  18. package/dist/types/src/HelpPlugin.d.ts.map +1 -1
  19. package/dist/types/src/capabilities/app-graph-builder.d.ts +4 -2
  20. package/dist/types/src/capabilities/app-graph-builder.d.ts.map +1 -1
  21. package/dist/types/src/capabilities/index.d.ts +16 -6
  22. package/dist/types/src/capabilities/index.d.ts.map +1 -1
  23. package/dist/types/src/capabilities/operation-handler.d.ts +6 -0
  24. package/dist/types/src/capabilities/operation-handler.d.ts.map +1 -0
  25. package/dist/types/src/capabilities/react-root.d.ts +5 -3
  26. package/dist/types/src/capabilities/react-root.d.ts.map +1 -1
  27. package/dist/types/src/capabilities/react-surface.d.ts +3 -2
  28. package/dist/types/src/capabilities/react-surface.d.ts.map +1 -1
  29. package/dist/types/src/capabilities/state.d.ts +11 -2
  30. package/dist/types/src/capabilities/state.d.ts.map +1 -1
  31. package/dist/types/src/components/Shortcuts/ShortcutsHints.d.ts.map +1 -1
  32. package/dist/types/src/components/Shortcuts/ShortcutsList.d.ts.map +1 -1
  33. package/dist/types/src/components/Shortcuts/ShortcutsSection.d.ts.map +1 -1
  34. package/dist/types/src/components/Shortcuts/index.d.ts +0 -1
  35. package/dist/types/src/components/Shortcuts/index.d.ts.map +1 -1
  36. package/dist/types/src/components/Tooltip/Tooltip.d.ts.map +1 -1
  37. package/dist/types/src/components/WelcomeTour/WelcomeTour.d.ts +1 -1
  38. package/dist/types/src/components/WelcomeTour/WelcomeTour.d.ts.map +1 -1
  39. package/dist/types/src/components/WelcomeTour/WelcomeTour.stories.d.ts +9 -4
  40. package/dist/types/src/components/WelcomeTour/WelcomeTour.stories.d.ts.map +1 -1
  41. package/dist/types/src/constants.d.ts +2 -0
  42. package/dist/types/src/constants.d.ts.map +1 -0
  43. package/dist/types/src/containers/ShortcutsDialogContent/ShortcutsDialogContent.d.ts +3 -0
  44. package/dist/types/src/containers/ShortcutsDialogContent/ShortcutsDialogContent.d.ts.map +1 -0
  45. package/dist/types/src/containers/ShortcutsDialogContent/ShortcutsDialogContent.stories.d.ts +25 -0
  46. package/dist/types/src/containers/ShortcutsDialogContent/ShortcutsDialogContent.stories.d.ts.map +1 -0
  47. package/dist/types/src/containers/ShortcutsDialogContent/index.d.ts +2 -0
  48. package/dist/types/src/containers/ShortcutsDialogContent/index.d.ts.map +1 -0
  49. package/dist/types/src/containers/ShortcutsHints/ShortcutsHints.d.ts +2 -0
  50. package/dist/types/src/containers/ShortcutsHints/ShortcutsHints.d.ts.map +1 -0
  51. package/dist/types/src/containers/ShortcutsHints/index.d.ts +2 -0
  52. package/dist/types/src/containers/ShortcutsHints/index.d.ts.map +1 -0
  53. package/dist/types/src/containers/ShortcutsList/ShortcutsList.d.ts +2 -0
  54. package/dist/types/src/containers/ShortcutsList/ShortcutsList.d.ts.map +1 -0
  55. package/dist/types/src/containers/ShortcutsList/index.d.ts +2 -0
  56. package/dist/types/src/containers/ShortcutsList/index.d.ts.map +1 -0
  57. package/dist/types/src/containers/index.d.ts +5 -0
  58. package/dist/types/src/containers/index.d.ts.map +1 -0
  59. package/dist/types/src/hooks/useHelp.d.ts +1 -1
  60. package/dist/types/src/hooks/useHelp.d.ts.map +1 -1
  61. package/dist/types/src/index.d.ts +2 -1
  62. package/dist/types/src/index.d.ts.map +1 -1
  63. package/dist/types/src/meta.d.ts +2 -3
  64. package/dist/types/src/meta.d.ts.map +1 -1
  65. package/dist/types/src/operations/definitions.d.ts +4 -0
  66. package/dist/types/src/operations/definitions.d.ts.map +1 -0
  67. package/dist/types/src/operations/index.d.ts +4 -0
  68. package/dist/types/src/operations/index.d.ts.map +1 -0
  69. package/dist/types/src/operations/start.d.ts +5 -0
  70. package/dist/types/src/operations/start.d.ts.map +1 -0
  71. package/dist/types/src/translations.d.ts +5 -5
  72. package/dist/types/src/translations.d.ts.map +1 -1
  73. package/dist/types/src/types/capabilities.d.ts +21 -0
  74. package/dist/types/src/types/capabilities.d.ts.map +1 -0
  75. package/dist/types/src/types/index.d.ts +3 -0
  76. package/dist/types/src/types/index.d.ts.map +1 -0
  77. package/dist/types/src/types/schema.d.ts +16 -0
  78. package/dist/types/src/types/schema.d.ts.map +1 -0
  79. package/dist/types/tsconfig.tsbuildinfo +1 -1
  80. package/package.json +63 -39
  81. package/src/HelpPlugin.tsx +22 -48
  82. package/src/capabilities/app-graph-builder.ts +54 -67
  83. package/src/capabilities/index.ts +10 -7
  84. package/src/capabilities/operation-handler.ts +16 -0
  85. package/src/capabilities/react-root.tsx +28 -24
  86. package/src/capabilities/react-surface.tsx +28 -22
  87. package/src/capabilities/state.ts +19 -15
  88. package/src/components/Shortcuts/ShortcutsHints.tsx +13 -5
  89. package/src/components/Shortcuts/ShortcutsList.tsx +6 -5
  90. package/src/components/Shortcuts/ShortcutsSection.tsx +1 -3
  91. package/src/components/Shortcuts/index.ts +0 -1
  92. package/src/components/Shortcuts/styles.ts +3 -3
  93. package/src/components/Tooltip/Tooltip.tsx +31 -30
  94. package/src/components/WelcomeTour/WelcomeTour.stories.tsx +27 -22
  95. package/src/components/WelcomeTour/WelcomeTour.tsx +18 -19
  96. package/src/constants.ts +7 -0
  97. package/src/containers/ShortcutsDialogContent/ShortcutsDialogContent.stories.tsx +38 -0
  98. package/src/containers/ShortcutsDialogContent/ShortcutsDialogContent.tsx +28 -0
  99. package/src/containers/ShortcutsDialogContent/index.ts +5 -0
  100. package/src/containers/ShortcutsHints/ShortcutsHints.tsx +5 -0
  101. package/src/containers/ShortcutsHints/index.ts +5 -0
  102. package/src/containers/ShortcutsList/ShortcutsList.tsx +5 -0
  103. package/src/containers/ShortcutsList/index.ts +5 -0
  104. package/src/containers/index.ts +9 -0
  105. package/src/hooks/useHelp.tsx +1 -1
  106. package/src/index.ts +2 -1
  107. package/src/meta.ts +8 -6
  108. package/src/operations/definitions.ts +19 -0
  109. package/src/operations/index.ts +9 -0
  110. package/src/operations/start.ts +21 -0
  111. package/src/translations.ts +5 -5
  112. package/src/types/capabilities.ts +24 -0
  113. package/src/types/index.ts +6 -0
  114. package/src/{types.ts → types/schema.ts} +2 -13
  115. package/dist/lib/browser/app-graph-builder-IXCF4ZDE.mjs +0 -79
  116. package/dist/lib/browser/app-graph-builder-IXCF4ZDE.mjs.map +0 -7
  117. package/dist/lib/browser/chunk-27RZVOIE.mjs +0 -408
  118. package/dist/lib/browser/chunk-27RZVOIE.mjs.map +0 -7
  119. package/dist/lib/browser/chunk-3Y4CMOZP.mjs +0 -13
  120. package/dist/lib/browser/chunk-3Y4CMOZP.mjs.map +0 -7
  121. package/dist/lib/browser/chunk-LDRUZNSN.mjs +0 -16
  122. package/dist/lib/browser/chunk-LDRUZNSN.mjs.map +0 -7
  123. package/dist/lib/browser/chunk-WAN2NFYE.mjs +0 -36
  124. package/dist/lib/browser/chunk-WAN2NFYE.mjs.map +0 -7
  125. package/dist/lib/browser/react-root-A32LXEU4.mjs +0 -34
  126. package/dist/lib/browser/react-root-A32LXEU4.mjs.map +0 -7
  127. package/dist/lib/browser/react-surface-DIIOUUMT.mjs +0 -36
  128. package/dist/lib/browser/react-surface-DIIOUUMT.mjs.map +0 -7
  129. package/dist/lib/browser/state-FWUZG6NL.mjs +0 -29
  130. package/dist/lib/browser/state-FWUZG6NL.mjs.map +0 -7
  131. package/dist/lib/browser/types.mjs +0 -12
  132. package/dist/lib/node-esm/app-graph-builder-5QQRWRWG.mjs +0 -80
  133. package/dist/lib/node-esm/app-graph-builder-5QQRWRWG.mjs.map +0 -7
  134. package/dist/lib/node-esm/chunk-6JMO5FFN.mjs +0 -37
  135. package/dist/lib/node-esm/chunk-6JMO5FFN.mjs.map +0 -7
  136. package/dist/lib/node-esm/chunk-CXQ5LKQI.mjs +0 -17
  137. package/dist/lib/node-esm/chunk-CXQ5LKQI.mjs.map +0 -7
  138. package/dist/lib/node-esm/chunk-PU7X4MJO.mjs +0 -409
  139. package/dist/lib/node-esm/chunk-PU7X4MJO.mjs.map +0 -7
  140. package/dist/lib/node-esm/chunk-T523OGIV.mjs +0 -15
  141. package/dist/lib/node-esm/chunk-T523OGIV.mjs.map +0 -7
  142. package/dist/lib/node-esm/index.mjs +0 -115
  143. package/dist/lib/node-esm/index.mjs.map +0 -7
  144. package/dist/lib/node-esm/meta.json +0 -1
  145. package/dist/lib/node-esm/meta.mjs +0 -10
  146. package/dist/lib/node-esm/react-root-Q6PGYYYP.mjs +0 -35
  147. package/dist/lib/node-esm/react-root-Q6PGYYYP.mjs.map +0 -7
  148. package/dist/lib/node-esm/react-surface-QEIKNNW3.mjs +0 -37
  149. package/dist/lib/node-esm/react-surface-QEIKNNW3.mjs.map +0 -7
  150. package/dist/lib/node-esm/state-Y476FGII.mjs +0 -30
  151. package/dist/lib/node-esm/state-Y476FGII.mjs.map +0 -7
  152. package/dist/lib/node-esm/types.mjs +0 -13
  153. package/dist/lib/node-esm/types.mjs.map +0 -7
  154. package/dist/types/src/capabilities/capabilities.d.ts +0 -10
  155. package/dist/types/src/capabilities/capabilities.d.ts.map +0 -1
  156. package/dist/types/src/components/Shortcuts/ShortcutsDialog.d.ts +0 -4
  157. package/dist/types/src/components/Shortcuts/ShortcutsDialog.d.ts.map +0 -1
  158. package/dist/types/src/types.d.ts +0 -29
  159. package/dist/types/src/types.d.ts.map +0 -1
  160. package/src/capabilities/capabilities.ts +0 -13
  161. package/src/components/Shortcuts/ShortcutsDialog.tsx +0 -34
  162. /package/dist/lib/browser/{types.mjs.map → chunk-J5LGTIGS.mjs.map} +0 -0
  163. /package/dist/lib/{node-esm/meta.mjs.map → browser/types/index.mjs.map} +0 -0
@@ -0,0 +1,10 @@
1
+ var __defProp = Object.defineProperty;
2
+ var __export = (target, all) => {
3
+ for (var name in all)
4
+ __defProp(target, name, { get: all[name], enumerable: true });
5
+ };
6
+
7
+ export {
8
+ __export
9
+ };
10
+ //# sourceMappingURL=chunk-J5LGTIGS.mjs.map
@@ -0,0 +1,34 @@
1
+ // src/types/capabilities.ts
2
+ import * as Schema from "effect/Schema";
3
+ import { Capability } from "@dxos/app-framework";
4
+ import { meta } from "#meta";
5
+ (function(HelpCapabilities2) {
6
+ HelpCapabilities2.StateSchema = Schema.mutable(Schema.Struct({
7
+ running: Schema.Boolean,
8
+ showHints: Schema.Boolean,
9
+ showWelcome: Schema.Boolean
10
+ }));
11
+ HelpCapabilities2.State = Capability.make(`${meta.id}.capability.state`);
12
+ })(HelpCapabilities || (HelpCapabilities = {}));
13
+ var HelpCapabilities;
14
+
15
+ // src/types/schema.ts
16
+ import { createContext } from "react";
17
+ var HelpContext = createContext({
18
+ running: false,
19
+ steps: [],
20
+ setSteps: () => {
21
+ },
22
+ setIndex: () => {
23
+ },
24
+ start: () => {
25
+ },
26
+ stop: () => {
27
+ }
28
+ });
29
+
30
+ export {
31
+ HelpCapabilities,
32
+ HelpContext
33
+ };
34
+ //# sourceMappingURL=chunk-K4LQ2TR7.mjs.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/types/capabilities.ts", "../../../src/types/schema.ts"],
4
+ "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\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 namespace HelpCapabilities {\n export const StateSchema = Schema.mutable(\n Schema.Struct({\n running: Schema.Boolean,\n showHints: Schema.Boolean,\n showWelcome: Schema.Boolean,\n }),\n );\n\n export type State = Schema.Schema.Type<typeof StateSchema>;\n\n export const State = Capability.make<Atom.Writable<State>>(`${meta.id}.capability.state`);\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"],
5
+ "mappings": ";AAKA,YAAYA,YAAY;AAExB,SAASC,kBAAkB;AAE3B,SAASC,YAAY;UAEJC,mBAAAA;oBACFC,cAAqBC,eACzBC,cAAO;IACZC,SAAgBC;IAChBC,WAAkBD;IAClBE,aAAoBF;EACtB,CAAA,CAAA;oBAKWG,QAAQC,WAAWC,KAA2B,GAAGC,KAAKC,EAAE,mBAAmB;AAC1F,GAZiBZ,qBAAAA,mBAAAA,CAAAA,EAAAA;;;;ACPjB,SAAuBa,qBAAqB;AAkBrC,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;",
6
+ "names": ["Schema", "Capability", "meta", "HelpCapabilities", "StateSchema", "mutable", "Struct", "running", "Boolean", "showHints", "showWelcome", "State", "Capability", "make", "meta", "id", "createContext", "HelpContext", "createContext", "running", "steps", "setSteps", "setIndex", "start", "stop"]
7
+ }
@@ -0,0 +1,31 @@
1
+ import {
2
+ __export
3
+ } from "./chunk-J5LGTIGS.mjs";
4
+
5
+ // src/operations/definitions.ts
6
+ var definitions_exports = {};
7
+ __export(definitions_exports, {
8
+ Start: () => Start
9
+ });
10
+ import * as Schema from "effect/Schema";
11
+ import { Capability } from "@dxos/app-framework";
12
+ import { Operation } from "@dxos/operation";
13
+ import { meta } from "#meta";
14
+ var HELP_OPERATION = `${meta.id}.operation`;
15
+ var Start = Operation.make({
16
+ meta: {
17
+ key: `${HELP_OPERATION}.start`,
18
+ name: "Start Help"
19
+ },
20
+ services: [
21
+ Capability.Service
22
+ ],
23
+ input: Schema.Void,
24
+ output: Schema.Void
25
+ });
26
+
27
+ export {
28
+ Start,
29
+ definitions_exports
30
+ };
31
+ //# sourceMappingURL=chunk-KUUIRJG5.mjs.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/operations/definitions.ts"],
4
+ "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Capability } from '@dxos/app-framework';\nimport { Operation } from '@dxos/operation';\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"],
5
+ "mappings": ";;;;;AAAA;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,kBAAkB;AAC3B,SAASC,iBAAiB;AAE1B,SAASC,YAAY;AAErB,IAAMC,iBAAiB,GAAGC,KAAKC,EAAE;AAE1B,IAAMC,QAAQC,UAAUC,KAAK;EAClCJ,MAAM;IAAEK,KAAK,GAAGN,cAAAA;IAAwBO,MAAM;EAAa;EAC3DC,UAAU;IAACC,WAAWC;;EACtBC,OAAcC;EACdC,QAAeD;AACjB,CAAA;",
6
+ "names": ["Schema", "Capability", "Operation", "meta", "HELP_OPERATION", "meta", "id", "Start", "Operation", "make", "key", "name", "services", "Capability", "Service", "input", "Void", "output"]
7
+ }
@@ -0,0 +1,16 @@
1
+ // src/meta.ts
2
+ import { trim } from "@dxos/util";
3
+ var meta = {
4
+ id: "org.dxos.plugin.help",
5
+ name: "Help",
6
+ description: trim`
7
+ Built-in help system with documentation, tutorials, and contextual assistance.
8
+ Access keyboard shortcuts, feature guides, and support resources.
9
+ `,
10
+ icon: "ph--info--regular"
11
+ };
12
+
13
+ export {
14
+ meta
15
+ };
16
+ //# sourceMappingURL=chunk-TEXIV2IJ.mjs.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/meta.ts"],
4
+ "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"],
5
+ "mappings": ";AAKA,SAASA,YAAY;AAEd,IAAMC,OAAoB;EAC/BC,IAAI;EACJC,MAAM;EACNC,aAAaC;;;;EAIbC,MAAM;AACR;",
6
+ "names": ["trim", "meta", "id", "name", "description", "trim", "icon"]
7
+ }
@@ -1,107 +1,390 @@
1
1
  import {
2
- Key,
3
- SHORTCUTS_DIALOG,
4
- ShortcutsDialogContent,
5
- ShortcutsHints,
6
- ShortcutsList,
7
- ShortcutsSection,
8
- Tooltip,
9
- WelcomeTour,
10
- floaterProps
11
- } from "./chunk-27RZVOIE.mjs";
2
+ meta
3
+ } from "./chunk-TEXIV2IJ.mjs";
12
4
  import {
13
- HELP_ACTION,
14
- HelpAction,
5
+ HelpCapabilities,
15
6
  HelpContext
16
- } from "./chunk-WAN2NFYE.mjs";
17
- import {
18
- HelpCapabilities
19
- } from "./chunk-LDRUZNSN.mjs";
20
- import {
21
- HELP_PLUGIN,
22
- meta
23
- } from "./chunk-3Y4CMOZP.mjs";
7
+ } from "./chunk-K4LQ2TR7.mjs";
8
+ import "./chunk-J5LGTIGS.mjs";
24
9
 
25
- // src/capabilities/index.ts
26
- import { lazy } from "@dxos/app-framework";
27
- var AppGraphBuilder = lazy(() => import("./app-graph-builder-IXCF4ZDE.mjs"));
28
- var ReactRoot = lazy(() => import("./react-root-A32LXEU4.mjs"));
29
- var ReactSurface = lazy(() => import("./react-surface-DIIOUUMT.mjs"));
30
- var HelpState = lazy(() => import("./state-FWUZG6NL.mjs"));
10
+ // src/components/Shortcuts/ShortcutsHints.tsx
11
+ import React2 from "react";
12
+ import { Keyboard } from "@dxos/keyboard";
13
+ import { IconButton, toLocalizedString, useTranslation } from "@dxos/react-ui";
14
+ import { osTranslations } from "@dxos/ui-theme";
15
+
16
+ // src/components/Shortcuts/Key.tsx
17
+ import React from "react";
18
+ import { keySymbols } from "@dxos/keyboard";
19
+
20
+ // src/components/Shortcuts/styles.ts
21
+ import { mx } from "@dxos/ui-theme";
22
+ var shortcutKey = mx("inline-flex min-w-[24px] h-[24px] px-0.5 justify-center items-center text-xs", "rounded-sm bg-neutral-100 dark:bg-neutral-900");
23
+
24
+ // src/components/Shortcuts/Key.tsx
25
+ var Key = ({ binding }) => {
26
+ return /* @__PURE__ */ React.createElement("span", {
27
+ role: "term",
28
+ className: "inline-flex gap-1",
29
+ "aria-label": binding,
30
+ id: binding
31
+ }, keySymbols(binding).map((c, i) => /* @__PURE__ */ React.createElement("span", {
32
+ key: i,
33
+ className: shortcutKey
34
+ }, c)));
35
+ };
36
+
37
+ // src/components/Shortcuts/ShortcutsHints.tsx
38
+ var Shortcut = ({ binding }) => {
39
+ const { t } = useTranslation(osTranslations);
40
+ return /* @__PURE__ */ React2.createElement("div", {
41
+ role: "none",
42
+ className: "flex items-center gap-2 whitespace-nowrap"
43
+ }, /* @__PURE__ */ React2.createElement(Key, {
44
+ binding: binding.shortcut
45
+ }), /* @__PURE__ */ React2.createElement("span", {
46
+ className: "text-sm"
47
+ }, toLocalizedString(binding.data, t)));
48
+ };
49
+ var ShortcutsHints = ({ onClose }) => {
50
+ const defaults = [
51
+ "meta+k",
52
+ "meta+/",
53
+ "meta+,"
54
+ ];
55
+ const bindings = Keyboard.singleton.getBindings();
56
+ const hints = bindings.filter((binding) => defaults.includes(binding.shortcut));
57
+ return /* @__PURE__ */ React2.createElement("div", {
58
+ role: "none",
59
+ className: "flex overflow-hidden px-2 gap-4"
60
+ }, hints.map((binding) => /* @__PURE__ */ React2.createElement(Shortcut, {
61
+ key: binding.shortcut,
62
+ binding
63
+ })), onClose && /* @__PURE__ */ React2.createElement(IconButton, {
64
+ icon: "ph--x--regular",
65
+ size: 4,
66
+ label: "Close",
67
+ iconOnly: true,
68
+ noTooltip: true,
69
+ variant: "ghost",
70
+ classNames: "p-0 cursor-pointer",
71
+ onClick: onClose
72
+ }));
73
+ };
74
+
75
+ // src/components/Shortcuts/ShortcutsList.tsx
76
+ import React3, { Fragment } from "react";
77
+ import { Keyboard as Keyboard2 } from "@dxos/keyboard";
78
+ import { toLocalizedString as toLocalizedString2, useTranslation as useTranslation2 } from "@dxos/react-ui";
79
+ import { mx as mx2 } from "@dxos/ui-theme";
80
+ import { meta as meta2 } from "#meta";
81
+ var ShortcutsList = () => {
82
+ const { t } = useTranslation2(meta2.id);
83
+ const bindings = Keyboard2.singleton.getBindings();
84
+ bindings.sort((a, b) => {
85
+ return toLocalizedString2(a.data, t)?.toLowerCase().localeCompare(toLocalizedString2(b.data, t)?.toLowerCase());
86
+ });
87
+ return /* @__PURE__ */ React3.createElement("dl", {
88
+ className: mx2("w-fit grid grid-cols-[min-content_minmax(12rem,1fr)] gap-2 my-4 text-subdued select-none")
89
+ }, bindings.map((binding, i) => /* @__PURE__ */ React3.createElement(Fragment, {
90
+ key: i
91
+ }, /* @__PURE__ */ React3.createElement(Key, {
92
+ binding: binding.shortcut
93
+ }), /* @__PURE__ */ React3.createElement("span", {
94
+ role: "definition",
95
+ className: "ms-4",
96
+ "aria-labelledby": binding.shortcut
97
+ }, toLocalizedString2(binding.data, t)))));
98
+ };
99
+
100
+ // src/components/Shortcuts/ShortcutsSection.tsx
101
+ import React4 from "react";
102
+ var ShortcutsSection = () => {
103
+ return /* @__PURE__ */ React4.createElement("section", {
104
+ className: "text-description"
105
+ }, /* @__PURE__ */ React4.createElement(ShortcutsList, null));
106
+ };
107
+
108
+ // src/components/Tooltip/Tooltip.tsx
109
+ import { useArrowNavigationGroup, useFocusableGroup } from "@fluentui/react-tabster";
110
+ import React5, { forwardRef } from "react";
111
+ import { Button, Icon, IconButton as IconButton2 } from "@dxos/react-ui";
112
+ var floaterProps = {
113
+ styles: {
114
+ // Arrow color is set by joyride.
115
+ arrow: {
116
+ length: 8,
117
+ spread: 16
118
+ },
119
+ floater: {
120
+ // TODO(burdon): Get tokens from theme.
121
+ filter: "drop-shadow(0 0 0.75rem rgba(0, 0, 0, 0.2))"
122
+ }
123
+ }
124
+ };
125
+ var Tooltip = /* @__PURE__ */ forwardRef(({ step: { title, content }, index, size, isLastStep, backProps, closeProps, primaryProps }, forwardedRef) => {
126
+ const arrowNavigationAttrs = useArrowNavigationGroup({
127
+ axis: "horizontal"
128
+ });
129
+ const focusableGroupAttrs = useFocusableGroup({
130
+ tabBehavior: "limited-trap-focus"
131
+ });
132
+ return /* @__PURE__ */ React5.createElement("div", {
133
+ className: "flex flex-col w-[15rem] min-h-[10rem] overflow-hidden rounded-md shadow-xl bg-accent-surface text-accent-surface-text",
134
+ role: "tooltip",
135
+ "data-testid": "helpPlugin.tooltip",
136
+ "data-step": index + 1,
137
+ ...focusableGroupAttrs,
138
+ ref: forwardedRef
139
+ }, /* @__PURE__ */ React5.createElement("div", {
140
+ className: "flex p-2"
141
+ }, /* @__PURE__ */ React5.createElement("h2", {
142
+ className: "grow px-2 py-1 text-lg font-medium text-accent-surface-text"
143
+ }, title), /* @__PURE__ */ React5.createElement(IconButton2, {
144
+ density: "fine",
145
+ icon: "ph--x--bold",
146
+ iconOnly: true,
147
+ label: closeProps["aria-label"],
148
+ onClick: closeProps.onClick,
149
+ size: 4,
150
+ variant: "primary",
151
+ "data-testid": "helpPlugin.tooltip.close"
152
+ })), /* @__PURE__ */ React5.createElement("div", {
153
+ className: "flex grow px-4 my-2"
154
+ }, content), /* @__PURE__ */ React5.createElement("div", {
155
+ className: "flex p-2 items-center justify-between",
156
+ ...arrowNavigationAttrs
157
+ }, /* @__PURE__ */ React5.createElement(IconButton2, {
158
+ classNames: [
159
+ !(index > 0 && backProps) && "invisible"
160
+ ],
161
+ icon: "ph--caret-left--regular",
162
+ iconOnly: true,
163
+ label: backProps["aria-label"],
164
+ onClick: backProps.onClick,
165
+ variant: "primary",
166
+ "data-testid": "helpPlugin.tooltip.back"
167
+ }), /* @__PURE__ */ React5.createElement("div", {
168
+ className: "flex grow gap-2 justify-center"
169
+ }, /* @__PURE__ */ React5.createElement("div", {
170
+ className: "flex"
171
+ }, Array.from({
172
+ length: size
173
+ }).map((_, i) => /* @__PURE__ */ React5.createElement(Icon, {
174
+ key: i,
175
+ icon: index === i ? "ph--circle--fill" : "ph--circle--regular",
176
+ size: 2,
177
+ classNames: "mx-1 cursor-pointer"
178
+ })))), isLastStep ? /* @__PURE__ */ React5.createElement(Button, {
179
+ variant: "primary",
180
+ onClick: closeProps.onClick,
181
+ title: closeProps["aria-label"],
182
+ autoFocus: true,
183
+ "data-testid": "helpPlugin.tooltip.finish"
184
+ }, "Done") : /* @__PURE__ */ React5.createElement(IconButton2, {
185
+ autoFocus: true,
186
+ icon: "ph--caret-right--regular",
187
+ iconOnly: true,
188
+ label: primaryProps["aria-label"],
189
+ onClick: primaryProps.onClick,
190
+ size: 6,
191
+ variant: "primary",
192
+ "data-testid": "helpPlugin.tooltip.next"
193
+ })));
194
+ });
195
+
196
+ // src/components/WelcomeTour/WelcomeTour.tsx
197
+ import React6, { useState } from "react";
198
+ import Joyride, { ACTIONS, EVENTS } from "react-joyride";
199
+ import { usePluginManager } from "@dxos/app-framework/ui";
200
+ import { useLayout } from "@dxos/app-toolkit/ui";
201
+ import { useAsyncEffect } from "@dxos/react-ui";
202
+ import { HelpContext as HelpContext2 } from "#types";
203
+ var addStepClass = (target) => {
204
+ const element = typeof target === "string" ? document.querySelector(target) : target;
205
+ if (element) {
206
+ element.classList.add("joyride-target");
207
+ }
208
+ };
209
+ var removeTargetClass = (target) => {
210
+ const element = typeof target === "string" ? document.querySelector(target) : target;
211
+ if (element) {
212
+ element.classList.remove("joyride-target");
213
+ }
214
+ };
215
+ var getTarget = (step) => {
216
+ return typeof step.target === "string" ? document.querySelector(step.target) : step.target;
217
+ };
218
+ var waitForTarget = async (step) => {
219
+ if (typeof step.target === "string") {
220
+ const target = step.target;
221
+ const element = document.querySelector(target);
222
+ if (element) {
223
+ return;
224
+ }
225
+ await new Promise((resolve) => {
226
+ const observer = new MutationObserver((mutations) => {
227
+ mutations.forEach((mutation) => {
228
+ if (mutation.addedNodes.length > 0) {
229
+ const element2 = document.querySelector(target);
230
+ if (element2) {
231
+ observer.disconnect();
232
+ resolve();
233
+ }
234
+ }
235
+ });
236
+ });
237
+ observer.observe(document.body, {
238
+ childList: true,
239
+ subtree: true
240
+ });
241
+ });
242
+ }
243
+ };
244
+ var WelcomeTour = ({ steps: initialSteps, running: runningProp, onRunningChanged }) => {
245
+ const manager = usePluginManager();
246
+ const layout = useLayout();
247
+ const [running, setRunning] = useState(!!runningProp && !!getTarget(initialSteps[0]));
248
+ const [stepIndex, _setStepIndex] = useState(0);
249
+ const [steps, setSteps] = useState(initialSteps);
250
+ const paused = layout.dialogOpen;
251
+ const setStepIndex = (index) => {
252
+ if (runningProp) {
253
+ const step = steps[index];
254
+ step?.before?.(manager.capabilities);
255
+ }
256
+ _setStepIndex(index);
257
+ };
258
+ const setRunningChanged = (state) => {
259
+ if (typeof runningProp !== "undefined") {
260
+ onRunningChanged?.(state);
261
+ } else {
262
+ if (state) {
263
+ setStepIndex(0);
264
+ setRunning(true);
265
+ } else {
266
+ setRunning(false);
267
+ }
268
+ }
269
+ };
270
+ useAsyncEffect(async () => {
271
+ if (runningProp) {
272
+ await waitForTarget(steps[stepIndex]);
273
+ setStepIndex(0);
274
+ setRunning(true);
275
+ } else if (typeof runningProp !== "undefined") {
276
+ setRunning(false);
277
+ }
278
+ }, [
279
+ runningProp
280
+ ]);
281
+ const callback = async (options) => {
282
+ const { type, action, index, size } = options;
283
+ switch (type) {
284
+ case EVENTS.STEP_BEFORE:
285
+ addStepClass(options.step.target);
286
+ break;
287
+ case EVENTS.TOUR_END:
288
+ break;
289
+ case EVENTS.STEP_AFTER:
290
+ removeTargetClass(options.step.target);
291
+ switch (action) {
292
+ case ACTIONS.NEXT:
293
+ if (index < size - 1) {
294
+ setStepIndex(index + 1);
295
+ }
296
+ break;
297
+ case ACTIONS.PREV:
298
+ if (index > 0) {
299
+ setStepIndex(index - 1);
300
+ }
301
+ break;
302
+ case ACTIONS.CLOSE:
303
+ setRunningChanged(false);
304
+ setStepIndex(0);
305
+ break;
306
+ }
307
+ break;
308
+ }
309
+ };
310
+ return /* @__PURE__ */ React6.createElement(HelpContext2.Provider, {
311
+ value: {
312
+ running: running && !paused,
313
+ steps,
314
+ setSteps,
315
+ setIndex: setStepIndex,
316
+ start: () => setRunningChanged(true),
317
+ stop: () => setRunningChanged(false)
318
+ }
319
+ }, /* @__PURE__ */ React6.createElement("style", null, `.joyride-target {
320
+ --controls-opacity: 1;
321
+ }`), /* @__PURE__ */ React6.createElement(Joyride, {
322
+ continuous: true,
323
+ steps,
324
+ stepIndex,
325
+ run: running && !paused,
326
+ callback,
327
+ floaterProps,
328
+ tooltipComponent: Tooltip
329
+ }));
330
+ };
331
+
332
+ // src/constants.ts
333
+ import { meta as meta3 } from "#meta";
334
+ var SHORTCUTS_DIALOG = `${meta3.id}.ShortcutsDialog`;
31
335
 
32
336
  // src/HelpPlugin.tsx
33
- import { createResolver, defineModule, definePlugin, Events, contributes, Capabilities } from "@dxos/app-framework";
337
+ import { ActivationEvents, Plugin } from "@dxos/app-framework";
338
+ import { AppPlugin } from "@dxos/app-toolkit";
339
+ import { AppGraphBuilder, HelpState, OperationHandler, ReactRoot, ReactSurface } from "#capabilities";
340
+ import { meta as meta5 } from "#meta";
34
341
 
35
342
  // src/translations.ts
343
+ import { meta as meta4 } from "#meta";
36
344
  var translations = [
37
345
  {
38
346
  "en-US": {
39
- [meta.id]: {
40
- "plugin name": "Help",
41
- "open help tour": "Show welcome tour",
42
- "open shortcuts label": "Show shortcuts",
43
- "shortcuts dialog title": "Shortcuts"
347
+ [meta4.id]: {
348
+ "plugin.name": "Help",
349
+ "open-help-tour.message": "Show welcome tour",
350
+ "open-shortcuts.label": "Show shortcuts",
351
+ "shortcuts-dialog.title": "Shortcuts"
44
352
  }
45
353
  }
46
354
  }
47
355
  ];
48
356
 
49
357
  // src/HelpPlugin.tsx
50
- var HelpPlugin = ({ steps = [] }) => definePlugin(meta, [
51
- defineModule({
52
- id: `${meta.id}/module/state`,
53
- activatesOn: Events.Startup,
54
- activate: HelpState
55
- }),
56
- defineModule({
57
- id: `${meta.id}/module/translations`,
58
- activatesOn: Events.SetupTranslations,
59
- activate: () => contributes(Capabilities.Translations, translations)
60
- }),
61
- defineModule({
62
- id: `${meta.id}/module/react-root`,
63
- activatesOn: Events.Startup,
64
- activate: () => ReactRoot(steps)
65
- }),
66
- defineModule({
67
- id: `${meta.id}/module/react-surface`,
68
- activatesOn: Events.SetupReactSurface,
69
- activate: ReactSurface
70
- }),
71
- defineModule({
72
- id: `${meta.id}/module/intent-resolver`,
73
- activatesOn: Events.SetupIntentResolver,
74
- activate: (context) => contributes(Capabilities.IntentResolver, createResolver({
75
- intent: HelpAction.Start,
76
- resolve: () => {
77
- const state = context.getCapability(HelpCapabilities.MutableState);
78
- state.running = true;
79
- }
80
- }))
81
- }),
82
- defineModule({
83
- id: `${meta.id}/module/app-graph-builder`,
84
- activatesOn: Events.SetupAppGraph,
85
- activate: AppGraphBuilder
86
- })
87
- ]);
358
+ var HelpPlugin = Plugin.define(meta5).pipe(AppPlugin.addAppGraphModule({
359
+ activate: AppGraphBuilder
360
+ }), AppPlugin.addOperationHandlerModule({
361
+ activate: OperationHandler
362
+ }), AppPlugin.addSurfaceModule({
363
+ activate: ReactSurface
364
+ }), AppPlugin.addTranslationsModule({
365
+ translations
366
+ }), Plugin.addModule({
367
+ activatesOn: ActivationEvents.Startup,
368
+ activate: HelpState
369
+ }), Plugin.addModule(({ steps = [] }) => ({
370
+ id: "react-root",
371
+ activatesOn: ActivationEvents.Startup,
372
+ activate: () => ReactRoot(steps)
373
+ })), Plugin.make);
88
374
 
89
375
  // src/hooks/useHelp.tsx
90
376
  import { useContext } from "react";
91
377
  import { raise } from "@dxos/debug";
378
+ import { HelpContext as HelpContext3 } from "#types";
92
379
  var useHelp = () => {
93
- return useContext(HelpContext) ?? raise(new Error("Missing HelpContext"));
380
+ return useContext(HelpContext3) ?? raise(new Error("Missing HelpContext"));
94
381
  };
95
382
  export {
96
- HELP_ACTION,
97
- HELP_PLUGIN,
98
- HelpAction,
99
383
  HelpCapabilities,
100
384
  HelpContext,
101
385
  HelpPlugin,
102
386
  Key,
103
387
  SHORTCUTS_DIALOG,
104
- ShortcutsDialogContent,
105
388
  ShortcutsHints,
106
389
  ShortcutsList,
107
390
  ShortcutsSection,