@dxos/plugin-help 0.8.4-main.c4373fc → 0.8.4-main.c85a9c8dae

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 (152) hide show
  1. package/dist/lib/browser/ShortcutsDialogContent-BETHLZYK.mjs +36 -0
  2. package/dist/lib/browser/ShortcutsDialogContent-BETHLZYK.mjs.map +7 -0
  3. package/dist/lib/browser/ShortcutsHints-Q4LKOCKH.mjs +12 -0
  4. package/dist/lib/browser/ShortcutsHints-Q4LKOCKH.mjs.map +7 -0
  5. package/dist/lib/browser/ShortcutsList-P334CJ7O.mjs +12 -0
  6. package/dist/lib/browser/ShortcutsList-P334CJ7O.mjs.map +7 -0
  7. package/dist/lib/browser/app-graph-builder-2O2CUPGU.mjs +79 -0
  8. package/dist/lib/browser/app-graph-builder-2O2CUPGU.mjs.map +7 -0
  9. package/dist/lib/browser/chunk-IM2QVQOH.mjs +16 -0
  10. package/dist/lib/browser/chunk-IM2QVQOH.mjs.map +7 -0
  11. package/dist/lib/browser/chunk-PNXUNKZW.mjs +335 -0
  12. package/dist/lib/browser/chunk-PNXUNKZW.mjs.map +7 -0
  13. package/dist/lib/browser/chunk-TS66J4C6.mjs +58 -0
  14. package/dist/lib/browser/chunk-TS66J4C6.mjs.map +7 -0
  15. package/dist/lib/browser/chunk-XAC3AYP4.mjs +11 -0
  16. package/dist/lib/browser/chunk-XAC3AYP4.mjs.map +7 -0
  17. package/dist/lib/browser/index.mjs +62 -58
  18. package/dist/lib/browser/index.mjs.map +4 -4
  19. package/dist/lib/browser/meta.json +1 -1
  20. package/dist/lib/browser/meta.mjs +1 -1
  21. package/dist/lib/browser/react-root-GK7XGIBN.mjs +43 -0
  22. package/dist/lib/browser/react-root-GK7XGIBN.mjs.map +7 -0
  23. package/dist/lib/browser/react-surface-KGND4ZJD.mjs +42 -0
  24. package/dist/lib/browser/react-surface-KGND4ZJD.mjs.map +7 -0
  25. package/dist/lib/browser/state-VRPLKT3F.mjs +27 -0
  26. package/dist/lib/browser/state-VRPLKT3F.mjs.map +7 -0
  27. package/dist/lib/browser/types/index.mjs +8 -6
  28. package/dist/types/src/HelpPlugin.d.ts +2 -1
  29. package/dist/types/src/HelpPlugin.d.ts.map +1 -1
  30. package/dist/types/src/capabilities/app-graph-builder/app-graph-builder.d.ts +6 -0
  31. package/dist/types/src/capabilities/app-graph-builder/app-graph-builder.d.ts.map +1 -0
  32. package/dist/types/src/capabilities/app-graph-builder/index.d.ts +3 -0
  33. package/dist/types/src/capabilities/app-graph-builder/index.d.ts.map +1 -0
  34. package/dist/types/src/capabilities/index.d.ts +5 -8
  35. package/dist/types/src/capabilities/index.d.ts.map +1 -1
  36. package/dist/types/src/capabilities/operation-resolver/index.d.ts +2 -0
  37. package/dist/types/src/capabilities/operation-resolver/index.d.ts.map +1 -0
  38. package/dist/types/src/capabilities/operation-resolver/operation-resolver.d.ts +5 -0
  39. package/dist/types/src/capabilities/operation-resolver/operation-resolver.d.ts.map +1 -0
  40. package/dist/types/src/capabilities/react-root/index.d.ts +6 -0
  41. package/dist/types/src/capabilities/react-root/index.d.ts.map +1 -0
  42. package/dist/types/src/capabilities/react-root/react-root.d.ts +10 -0
  43. package/dist/types/src/capabilities/react-root/react-root.d.ts.map +1 -0
  44. package/dist/types/src/capabilities/react-surface/index.d.ts +3 -0
  45. package/dist/types/src/capabilities/react-surface/index.d.ts.map +1 -0
  46. package/dist/types/src/capabilities/react-surface/react-surface.d.ts +5 -0
  47. package/dist/types/src/capabilities/react-surface/react-surface.d.ts.map +1 -0
  48. package/dist/types/src/capabilities/state/index.d.ts +11 -0
  49. package/dist/types/src/capabilities/state/index.d.ts.map +1 -0
  50. package/dist/types/src/capabilities/state/state.d.ts +13 -0
  51. package/dist/types/src/capabilities/state/state.d.ts.map +1 -0
  52. package/dist/types/src/components/Shortcuts/ShortcutsHints.d.ts.map +1 -1
  53. package/dist/types/src/components/Shortcuts/ShortcutsSection.d.ts.map +1 -1
  54. package/dist/types/src/components/Shortcuts/index.d.ts +0 -1
  55. package/dist/types/src/components/Shortcuts/index.d.ts.map +1 -1
  56. package/dist/types/src/components/Tooltip/Tooltip.d.ts.map +1 -1
  57. package/dist/types/src/components/WelcomeTour/WelcomeTour.d.ts.map +1 -1
  58. package/dist/types/src/components/WelcomeTour/WelcomeTour.stories.d.ts.map +1 -1
  59. package/dist/types/src/constants.d.ts +2 -0
  60. package/dist/types/src/constants.d.ts.map +1 -0
  61. package/dist/types/src/{components/Shortcuts/ShortcutsDialog.d.ts → containers/ShortcutsDialogContent/ShortcutsDialogContent.d.ts} +1 -2
  62. package/dist/types/src/containers/ShortcutsDialogContent/ShortcutsDialogContent.d.ts.map +1 -0
  63. package/dist/types/src/containers/ShortcutsDialogContent/index.d.ts +3 -0
  64. package/dist/types/src/containers/ShortcutsDialogContent/index.d.ts.map +1 -0
  65. package/dist/types/src/containers/ShortcutsHints/ShortcutsHints.d.ts +2 -0
  66. package/dist/types/src/containers/ShortcutsHints/ShortcutsHints.d.ts.map +1 -0
  67. package/dist/types/src/containers/ShortcutsHints/index.d.ts +3 -0
  68. package/dist/types/src/containers/ShortcutsHints/index.d.ts.map +1 -0
  69. package/dist/types/src/containers/ShortcutsList/ShortcutsList.d.ts +2 -0
  70. package/dist/types/src/containers/ShortcutsList/ShortcutsList.d.ts.map +1 -0
  71. package/dist/types/src/containers/ShortcutsList/index.d.ts +3 -0
  72. package/dist/types/src/containers/ShortcutsList/index.d.ts.map +1 -0
  73. package/dist/types/src/containers/index.d.ts +5 -0
  74. package/dist/types/src/containers/index.d.ts.map +1 -0
  75. package/dist/types/src/index.d.ts +2 -1
  76. package/dist/types/src/index.d.ts.map +1 -1
  77. package/dist/types/src/meta.d.ts +2 -2
  78. package/dist/types/src/meta.d.ts.map +1 -1
  79. package/dist/types/src/types/capabilities.d.ts +21 -0
  80. package/dist/types/src/types/capabilities.d.ts.map +1 -0
  81. package/dist/types/src/types/index.d.ts +1 -0
  82. package/dist/types/src/types/index.d.ts.map +1 -1
  83. package/dist/types/src/types/schema.d.ts +16 -12
  84. package/dist/types/src/types/schema.d.ts.map +1 -1
  85. package/dist/types/tsconfig.tsbuildinfo +1 -1
  86. package/package.json +40 -34
  87. package/src/HelpPlugin.tsx +17 -42
  88. package/src/capabilities/app-graph-builder/app-graph-builder.ts +61 -0
  89. package/src/capabilities/app-graph-builder/index.ts +7 -0
  90. package/src/capabilities/index.ts +5 -8
  91. package/src/capabilities/operation-resolver/index.ts +5 -0
  92. package/src/capabilities/operation-resolver/operation-resolver.ts +23 -0
  93. package/src/capabilities/react-root/index.ts +7 -0
  94. package/src/capabilities/react-root/react-root.tsx +36 -0
  95. package/src/capabilities/react-surface/index.ts +7 -0
  96. package/src/capabilities/react-surface/react-surface.tsx +36 -0
  97. package/src/capabilities/state/index.ts +7 -0
  98. package/src/capabilities/state/state.ts +27 -0
  99. package/src/components/Shortcuts/ShortcutsHints.tsx +13 -5
  100. package/src/components/Shortcuts/ShortcutsList.tsx +3 -3
  101. package/src/components/Shortcuts/ShortcutsSection.tsx +1 -3
  102. package/src/components/Shortcuts/index.ts +0 -1
  103. package/src/components/Shortcuts/styles.ts +3 -3
  104. package/src/components/Tooltip/Tooltip.tsx +4 -5
  105. package/src/components/WelcomeTour/WelcomeTour.stories.tsx +9 -5
  106. package/src/components/WelcomeTour/WelcomeTour.tsx +3 -2
  107. package/src/constants.ts +7 -0
  108. package/src/containers/ShortcutsDialogContent/ShortcutsDialogContent.tsx +29 -0
  109. package/src/containers/ShortcutsDialogContent/index.ts +7 -0
  110. package/src/containers/ShortcutsHints/ShortcutsHints.tsx +5 -0
  111. package/src/containers/ShortcutsHints/index.ts +7 -0
  112. package/src/containers/ShortcutsList/ShortcutsList.tsx +5 -0
  113. package/src/containers/ShortcutsList/index.ts +7 -0
  114. package/src/containers/index.ts +9 -0
  115. package/src/index.ts +2 -1
  116. package/src/meta.ts +7 -2
  117. package/src/types/capabilities.ts +24 -0
  118. package/src/types/index.ts +1 -0
  119. package/src/types/schema.ts +11 -7
  120. package/dist/lib/browser/app-graph-builder-OBX2JPME.mjs +0 -80
  121. package/dist/lib/browser/app-graph-builder-OBX2JPME.mjs.map +0 -7
  122. package/dist/lib/browser/chunk-2OGXA47I.mjs +0 -34
  123. package/dist/lib/browser/chunk-2OGXA47I.mjs.map +0 -7
  124. package/dist/lib/browser/chunk-2X6D7RV7.mjs +0 -407
  125. package/dist/lib/browser/chunk-2X6D7RV7.mjs.map +0 -7
  126. package/dist/lib/browser/chunk-3WYHGOGD.mjs +0 -16
  127. package/dist/lib/browser/chunk-3WYHGOGD.mjs.map +0 -7
  128. package/dist/lib/browser/chunk-HUJHLAHD.mjs +0 -11
  129. package/dist/lib/browser/chunk-HUJHLAHD.mjs.map +0 -7
  130. package/dist/lib/browser/react-root-TXBGER6K.mjs +0 -34
  131. package/dist/lib/browser/react-root-TXBGER6K.mjs.map +0 -7
  132. package/dist/lib/browser/react-surface-B6YRCLU3.mjs +0 -36
  133. package/dist/lib/browser/react-surface-B6YRCLU3.mjs.map +0 -7
  134. package/dist/lib/browser/state-Y7EYMGFM.mjs +0 -29
  135. package/dist/lib/browser/state-Y7EYMGFM.mjs.map +0 -7
  136. package/dist/types/src/capabilities/app-graph-builder.d.ts +0 -4
  137. package/dist/types/src/capabilities/app-graph-builder.d.ts.map +0 -1
  138. package/dist/types/src/capabilities/capabilities.d.ts +0 -10
  139. package/dist/types/src/capabilities/capabilities.d.ts.map +0 -1
  140. package/dist/types/src/capabilities/react-root.d.ts +0 -8
  141. package/dist/types/src/capabilities/react-root.d.ts.map +0 -1
  142. package/dist/types/src/capabilities/react-surface.d.ts +0 -4
  143. package/dist/types/src/capabilities/react-surface.d.ts.map +0 -1
  144. package/dist/types/src/capabilities/state.d.ts +0 -4
  145. package/dist/types/src/capabilities/state.d.ts.map +0 -1
  146. package/dist/types/src/components/Shortcuts/ShortcutsDialog.d.ts.map +0 -1
  147. package/src/capabilities/app-graph-builder.ts +0 -78
  148. package/src/capabilities/capabilities.ts +0 -13
  149. package/src/capabilities/react-root.tsx +0 -33
  150. package/src/capabilities/react-surface.tsx +0 -30
  151. package/src/capabilities/state.ts +0 -24
  152. package/src/components/Shortcuts/ShortcutsDialog.tsx +0 -35
@@ -1 +0,0 @@
1
- {"version":3,"file":"app-graph-builder.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/app-graph-builder.ts"],"names":[],"mappings":"AAQA,OAAO,EAA8B,KAAK,aAAa,EAA6B,MAAM,qBAAqB,CAAC;yBAShG,SAAS,aAAa;AAAtC,wBA4DI"}
@@ -1,10 +0,0 @@
1
- export declare namespace HelpCapabilities {
2
- type State = {
3
- running: boolean;
4
- showHints: boolean;
5
- showWelcome: boolean;
6
- };
7
- const State: import("@dxos/app-framework").InterfaceDef<Readonly<State>>;
8
- const MutableState: import("@dxos/app-framework").InterfaceDef<State>;
9
- }
10
- //# sourceMappingURL=capabilities.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/capabilities.ts"],"names":[],"mappings":"AAQA,yBAAiB,gBAAgB,CAAC;IAChC,KAAY,KAAK,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5E,MAAM,KAAK,6DAAmE,CAAC;IAC/E,MAAM,YAAY,mDAAyD,CAAC;CACpF"}
@@ -1,8 +0,0 @@
1
- import React from 'react';
2
- import { type Step } from '../types';
3
- declare const _default: (steps: Step[]) => import("@dxos/app-framework").Capability<import("@dxos/app-framework").InterfaceDef<Readonly<{
4
- id: string;
5
- root: React.FC<React.PropsWithChildren>;
6
- }>>>;
7
- export default _default;
8
- //# sourceMappingURL=react-root.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"react-root.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/react-root.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,UAAU,CAAC;yBAIrB,OAAO,IAAI,EAAE;;;;AAA7B,wBAkBK"}
@@ -1,4 +0,0 @@
1
- import { Capabilities } from '@dxos/app-framework';
2
- declare const _default: () => import("@dxos/app-framework").Capability<import("@dxos/app-framework").InterfaceDef<Capabilities.ReactSurface>>;
3
- export default _default;
4
- //# sourceMappingURL=react-surface.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"react-surface.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/react-surface.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAA8B,MAAM,qBAAqB,CAAC;;AAK/E,wBAkBK"}
@@ -1,4 +0,0 @@
1
- import { HelpCapabilities } from './capabilities';
2
- declare const _default: () => import("@dxos/app-framework").Capability<import("@dxos/app-framework").InterfaceDef<Readonly<HelpCapabilities.State>>>;
3
- export default _default;
4
- //# sourceMappingURL=state.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/state.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;;AAElD,wBAYE"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"ShortcutsDialog.d.ts","sourceRoot":"","sources":["../../../../../src/components/Shortcuts/ShortcutsDialog.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B,eAAO,MAAM,gBAAgB,QAA+B,CAAC;AAE7D,eAAO,MAAM,sBAAsB,yBAoBlC,CAAC"}
@@ -1,78 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import { Rx } from '@effect-rx/rx-react';
6
- import * as Function from 'effect/Function';
7
- import * as Option from 'effect/Option';
8
-
9
- import { Capabilities, LayoutAction, type PluginContext, contributes, createIntent } from '@dxos/app-framework';
10
- import { createExtension } from '@dxos/app-graph';
11
-
12
- import { SHORTCUTS_DIALOG } from '../components';
13
- import { meta } from '../meta';
14
- import { HelpAction } from '../types';
15
-
16
- import { HelpCapabilities } from './capabilities';
17
-
18
- export default (context: PluginContext) =>
19
- contributes(
20
- Capabilities.AppGraphBuilder,
21
- createExtension({
22
- id: meta.id,
23
- actions: (node) =>
24
- Rx.make((get) =>
25
- Function.pipe(
26
- get(node),
27
- Option.flatMap((node) => (node.id === 'root' ? Option.some(node) : Option.none())),
28
- Option.map(() => [
29
- {
30
- id: HelpAction.Start._tag,
31
- data: async () => {
32
- const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
33
- const state = context.getCapability(HelpCapabilities.MutableState);
34
- state.showHints = true;
35
- await dispatch(createIntent(HelpAction.Start));
36
- },
37
- properties: {
38
- label: ['open help tour', { ns: meta.id }],
39
- icon: 'ph--info--regular',
40
- keyBinding: {
41
- macos: 'shift+meta+/',
42
- // TODO(wittjosiah): Test on windows to see if it behaves the same as linux.
43
- windows: 'shift+ctrl+/',
44
- linux: 'shift+ctrl+?',
45
- },
46
- testId: 'helpPlugin.openHelp',
47
- },
48
- },
49
- {
50
- id: `${meta.id}/open-shortcuts`,
51
- data: async () => {
52
- const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
53
- const state = context.getCapability(HelpCapabilities.MutableState);
54
- state.showHints = true;
55
- await dispatch(
56
- createIntent(LayoutAction.UpdateDialog, {
57
- part: 'dialog',
58
- subject: SHORTCUTS_DIALOG,
59
- options: {
60
- blockAlign: 'center',
61
- },
62
- }),
63
- );
64
- },
65
- properties: {
66
- label: ['open shortcuts label', { ns: meta.id }],
67
- icon: 'ph--keyboard--regular',
68
- keyBinding: {
69
- macos: 'meta+ctrl+/',
70
- },
71
- },
72
- },
73
- ]),
74
- Option.getOrElse(() => []),
75
- ),
76
- ),
77
- }),
78
- );
@@ -1,13 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import { defineCapability } from '@dxos/app-framework';
6
-
7
- import { meta } from '../meta';
8
-
9
- export namespace HelpCapabilities {
10
- export type State = { running: boolean; showHints: boolean; showWelcome: boolean };
11
- export const State = defineCapability<Readonly<State>>(`${meta.id}/capability/state`);
12
- export const MutableState = defineCapability<State>(`${meta.id}/capability/state`);
13
- }
@@ -1,33 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import React from 'react';
6
-
7
- import { Capabilities, contributes, useCapability } from '@dxos/app-framework';
8
-
9
- import { WelcomeTour } from '../components';
10
- import { meta } from '../meta';
11
- import { type Step } from '../types';
12
-
13
- import { HelpCapabilities } from './capabilities';
14
-
15
- export default (steps: Step[]) =>
16
- contributes(Capabilities.ReactRoot, {
17
- id: meta.id,
18
- root: () => {
19
- const state = useCapability(HelpCapabilities.MutableState);
20
- return (
21
- <WelcomeTour
22
- steps={steps}
23
- running={state.running}
24
- onRunningChanged={(newState) => {
25
- state.running = newState;
26
- if (!newState) {
27
- state.showHints = false;
28
- }
29
- }}
30
- />
31
- );
32
- },
33
- });
@@ -1,30 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import React from 'react';
6
-
7
- import { Capabilities, contributes, createSurface } from '@dxos/app-framework';
8
-
9
- import { SHORTCUTS_DIALOG, ShortcutsDialogContent, ShortcutsHints, ShortcutsList } from '../components';
10
- import { meta } from '../meta';
11
-
12
- export default () =>
13
- contributes(Capabilities.ReactSurface, [
14
- createSurface({
15
- id: `${meta.id}/hints`,
16
- role: 'hints',
17
- component: () => <ShortcutsHints />,
18
- }),
19
- createSurface({
20
- id: `${meta.id}/keyshortcuts`,
21
- role: 'keyshortcuts',
22
- component: () => <ShortcutsList />,
23
- }),
24
- createSurface({
25
- id: SHORTCUTS_DIALOG,
26
- role: 'dialog',
27
- filter: (data): data is any => data.component === SHORTCUTS_DIALOG,
28
- component: () => <ShortcutsDialogContent />,
29
- }),
30
- ]);
@@ -1,24 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import { contributes } from '@dxos/app-framework';
6
- import { LocalStorageStore } from '@dxos/local-storage';
7
-
8
- import { meta } from '../meta';
9
-
10
- import { HelpCapabilities } from './capabilities';
11
-
12
- export default () => {
13
- const state = new LocalStorageStore<HelpCapabilities.State>(meta.id, {
14
- running: false,
15
- showHints: true,
16
- showWelcome: true,
17
- });
18
-
19
- state
20
- .prop({ key: 'showHints', type: LocalStorageStore.bool() })
21
- .prop({ key: 'showWelcome', type: LocalStorageStore.bool() });
22
-
23
- return contributes(HelpCapabilities.State, state.values);
24
- };
@@ -1,35 +0,0 @@
1
- //
2
- // Copyright 2023 DXOS.org
3
- //
4
-
5
- import React from 'react';
6
-
7
- import { Button, Dialog, Icon, useTranslation } from '@dxos/react-ui';
8
-
9
- import { meta } from '../../meta';
10
-
11
- import { ShortcutsList } from './ShortcutsList';
12
-
13
- export const SHORTCUTS_DIALOG = `${meta.id}/ShortcutsDialog`;
14
-
15
- export const ShortcutsDialogContent = () => {
16
- const { t } = useTranslation(meta.id);
17
-
18
- return (
19
- <Dialog.Content classNames='p-0 bs-content max-bs-full md:max-is-[25rem] overflow-hidden'>
20
- <div role='none' className='flex justify-between mbe-1 pbs-3 pis-2 pie-3 @md:pbs-4 @md:pis-4 @md:pie-5'>
21
- <Dialog.Title>{t('shortcuts dialog title')}</Dialog.Title>
22
-
23
- <Dialog.Close asChild>
24
- <Button density='fine' variant='ghost' autoFocus>
25
- <Icon icon='ph--x--bold' size={3} />
26
- </Button>
27
- </Dialog.Close>
28
- </div>
29
-
30
- <div className='flex items-center justify-center'>
31
- <ShortcutsList />
32
- </div>
33
- </Dialog.Content>
34
- );
35
- };