@dxos/plugin-help 0.8.4-main.fd6878d → 0.8.4-main.fffef41
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.
- package/dist/lib/browser/{app-graph-builder-TUTK2ONB.mjs → app-graph-builder-L6GUMAIH.mjs} +16 -15
- package/dist/lib/browser/app-graph-builder-L6GUMAIH.mjs.map +7 -0
- package/dist/lib/browser/chunk-AZJJLAG7.mjs +16 -0
- package/dist/lib/browser/chunk-AZJJLAG7.mjs.map +7 -0
- package/dist/lib/browser/chunk-BCYK4LXW.mjs +16 -0
- package/dist/lib/browser/chunk-BCYK4LXW.mjs.map +7 -0
- package/dist/lib/browser/{chunk-J2SJSGSX.mjs → chunk-I7FKM6VC.mjs} +3 -3
- package/dist/lib/browser/chunk-I7FKM6VC.mjs.map +7 -0
- package/dist/lib/browser/{chunk-GIDPSFGY.mjs → chunk-W4AUSEGO.mjs} +40 -41
- package/dist/lib/browser/chunk-W4AUSEGO.mjs.map +7 -0
- package/dist/lib/browser/index.mjs +9 -11
- package/dist/lib/browser/index.mjs.map +3 -3
- package/dist/lib/browser/meta.json +1 -1
- package/dist/lib/browser/meta.mjs +1 -3
- package/dist/lib/browser/{react-root-5GSVXKQD.mjs → react-root-QJH33RNI.mjs} +11 -10
- package/dist/lib/browser/react-root-QJH33RNI.mjs.map +7 -0
- package/dist/lib/browser/{react-surface-V7U4IDJV.mjs → react-surface-OTMERRAV.mjs} +9 -9
- package/dist/lib/browser/react-surface-OTMERRAV.mjs.map +7 -0
- package/dist/lib/browser/{state-IXBTB3WH.mjs → state-5PVJCYWJ.mjs} +7 -7
- package/dist/lib/browser/state-5PVJCYWJ.mjs.map +7 -0
- package/dist/lib/browser/types/index.mjs +2 -2
- package/dist/types/src/HelpPlugin.d.ts +1 -1
- package/dist/types/src/HelpPlugin.d.ts.map +1 -1
- package/dist/types/src/capabilities/app-graph-builder.d.ts +1 -1
- package/dist/types/src/capabilities/app-graph-builder.d.ts.map +1 -1
- package/dist/types/src/capabilities/capabilities.d.ts.map +1 -1
- package/dist/types/src/capabilities/index.d.ts +5 -5
- package/dist/types/src/capabilities/index.d.ts.map +1 -1
- package/dist/types/src/capabilities/react-root.d.ts +2 -2
- package/dist/types/src/capabilities/react-root.d.ts.map +1 -1
- package/dist/types/src/capabilities/react-surface.d.ts +1 -1
- package/dist/types/src/capabilities/state.d.ts +1 -1
- package/dist/types/src/components/Shortcuts/ShortcutsDialog.d.ts +1 -1
- package/dist/types/src/components/Shortcuts/ShortcutsDialog.d.ts.map +1 -1
- package/dist/types/src/components/Shortcuts/ShortcutsHints.d.ts.map +1 -1
- package/dist/types/src/components/Tooltip/Tooltip.d.ts.map +1 -1
- package/dist/types/src/components/WelcomeTour/WelcomeTour.d.ts.map +1 -1
- package/dist/types/src/components/WelcomeTour/WelcomeTour.stories.d.ts +9 -4
- package/dist/types/src/components/WelcomeTour/WelcomeTour.stories.d.ts.map +1 -1
- package/dist/types/src/meta.d.ts +0 -1
- package/dist/types/src/meta.d.ts.map +1 -1
- package/dist/types/src/types/schema.d.ts +1 -1
- package/dist/types/src/types/schema.d.ts.map +1 -1
- package/dist/types/tsconfig.tsbuildinfo +1 -1
- package/package.json +31 -30
- package/src/HelpPlugin.tsx +43 -45
- package/src/capabilities/app-graph-builder.ts +10 -9
- package/src/capabilities/capabilities.ts +3 -3
- package/src/capabilities/react-root.tsx +4 -3
- package/src/capabilities/react-surface.tsx +3 -3
- package/src/capabilities/state.ts +2 -2
- package/src/components/Shortcuts/ShortcutsDialog.tsx +5 -8
- package/src/components/Shortcuts/ShortcutsHints.tsx +12 -5
- package/src/components/Shortcuts/ShortcutsList.tsx +2 -2
- package/src/components/Tooltip/Tooltip.tsx +0 -1
- package/src/components/WelcomeTour/WelcomeTour.stories.tsx +11 -10
- package/src/components/WelcomeTour/WelcomeTour.tsx +13 -16
- package/src/meta.ts +6 -4
- package/src/types/schema.ts +1 -1
- package/dist/lib/browser/app-graph-builder-TUTK2ONB.mjs.map +0 -7
- package/dist/lib/browser/chunk-3Y4CMOZP.mjs +0 -13
- package/dist/lib/browser/chunk-3Y4CMOZP.mjs.map +0 -7
- package/dist/lib/browser/chunk-GIDPSFGY.mjs.map +0 -7
- package/dist/lib/browser/chunk-J2SJSGSX.mjs.map +0 -7
- package/dist/lib/browser/chunk-LDRUZNSN.mjs +0 -16
- package/dist/lib/browser/chunk-LDRUZNSN.mjs.map +0 -7
- package/dist/lib/browser/react-root-5GSVXKQD.mjs.map +0 -7
- package/dist/lib/browser/react-surface-V7U4IDJV.mjs.map +0 -7
- package/dist/lib/browser/state-IXBTB3WH.mjs.map +0 -7
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dxos/plugin-help",
|
|
3
|
-
"version": "0.8.4-main.
|
|
3
|
+
"version": "0.8.4-main.fffef41",
|
|
4
4
|
"description": "Help plugin.",
|
|
5
5
|
"homepage": "https://dxos.org",
|
|
6
6
|
"bugs": "https://github.com/dxos/dxos/issues",
|
|
@@ -44,43 +44,44 @@
|
|
|
44
44
|
"@fluentui/react-tabster": "^9.24.2",
|
|
45
45
|
"@preact-signals/safe-react": "^0.9.0",
|
|
46
46
|
"react-joyride": "^2.7.2",
|
|
47
|
-
"@dxos/app-framework": "0.8.4-main.
|
|
48
|
-
"@dxos/app-graph": "0.8.4-main.
|
|
49
|
-
"@dxos/debug": "0.8.4-main.
|
|
50
|
-
"@dxos/echo
|
|
51
|
-
"@dxos/
|
|
52
|
-
"@dxos/
|
|
53
|
-
"@dxos/
|
|
54
|
-
"@dxos/plugin-
|
|
55
|
-
"@dxos/
|
|
56
|
-
"@dxos/plugin-space": "0.8.4-main.
|
|
57
|
-
"@dxos/react-client": "0.8.4-main.
|
|
58
|
-
"@dxos/
|
|
47
|
+
"@dxos/app-framework": "0.8.4-main.fffef41",
|
|
48
|
+
"@dxos/app-graph": "0.8.4-main.fffef41",
|
|
49
|
+
"@dxos/debug": "0.8.4-main.fffef41",
|
|
50
|
+
"@dxos/echo": "0.8.4-main.fffef41",
|
|
51
|
+
"@dxos/keyboard": "0.8.4-main.fffef41",
|
|
52
|
+
"@dxos/live-object": "0.8.4-main.fffef41",
|
|
53
|
+
"@dxos/local-storage": "0.8.4-main.fffef41",
|
|
54
|
+
"@dxos/plugin-graph": "0.8.4-main.fffef41",
|
|
55
|
+
"@dxos/plugin-client": "0.8.4-main.fffef41",
|
|
56
|
+
"@dxos/plugin-space": "0.8.4-main.fffef41",
|
|
57
|
+
"@dxos/react-client": "0.8.4-main.fffef41",
|
|
58
|
+
"@dxos/util": "0.8.4-main.fffef41"
|
|
59
59
|
},
|
|
60
60
|
"devDependencies": {
|
|
61
|
-
"@effect-
|
|
62
|
-
"@effect/platform": "0.
|
|
63
|
-
"@types/react": "~
|
|
64
|
-
"@types/react-dom": "~
|
|
65
|
-
"effect": "3.
|
|
66
|
-
"react": "~
|
|
67
|
-
"react-dom": "~
|
|
61
|
+
"@effect-atom/atom-react": "^0.3.4",
|
|
62
|
+
"@effect/platform": "0.92.1",
|
|
63
|
+
"@types/react": "~19.2.2",
|
|
64
|
+
"@types/react-dom": "~19.2.2",
|
|
65
|
+
"effect": "3.18.3",
|
|
66
|
+
"react": "~19.2.0",
|
|
67
|
+
"react-dom": "~19.2.0",
|
|
68
68
|
"react-floater": "0.7.9",
|
|
69
69
|
"type-fest": "4.10.1",
|
|
70
|
-
"vite": "
|
|
71
|
-
"@dxos/random": "0.8.4-main.
|
|
72
|
-
"@dxos/react-ui-theme": "0.8.4-main.
|
|
73
|
-
"@dxos/
|
|
74
|
-
"@dxos/
|
|
70
|
+
"vite": "7.1.9",
|
|
71
|
+
"@dxos/random": "0.8.4-main.fffef41",
|
|
72
|
+
"@dxos/react-ui-theme": "0.8.4-main.fffef41",
|
|
73
|
+
"@dxos/storybook-utils": "0.8.4-main.fffef41",
|
|
74
|
+
"@dxos/react-ui": "0.8.4-main.fffef41",
|
|
75
|
+
"@dxos/plugin-storybook-layout": "0.8.4-main.fffef41"
|
|
75
76
|
},
|
|
76
77
|
"peerDependencies": {
|
|
77
|
-
"@effect-
|
|
78
|
+
"@effect-atom/atom-react": "^0.3.4",
|
|
78
79
|
"@effect/platform": "^0.80.12",
|
|
79
80
|
"effect": "^3.13.3",
|
|
80
|
-
"react": "
|
|
81
|
-
"react-dom": "
|
|
82
|
-
"@dxos/react-ui": "0.8.4-main.
|
|
83
|
-
"@dxos/react-ui-theme": "0.8.4-main.
|
|
81
|
+
"react": "^19.0.0",
|
|
82
|
+
"react-dom": "^19.0.0",
|
|
83
|
+
"@dxos/react-ui": "0.8.4-main.fffef41",
|
|
84
|
+
"@dxos/react-ui-theme": "0.8.4-main.fffef41"
|
|
84
85
|
},
|
|
85
86
|
"publishConfig": {
|
|
86
87
|
"access": "public"
|
package/src/HelpPlugin.tsx
CHANGED
|
@@ -4,54 +4,52 @@
|
|
|
4
4
|
|
|
5
5
|
import { Capabilities, Events, contributes, createResolver, defineModule, definePlugin } from '@dxos/app-framework';
|
|
6
6
|
|
|
7
|
-
import { AppGraphBuilder, HelpState, ReactRoot, ReactSurface } from './capabilities';
|
|
8
|
-
import { HelpCapabilities } from './capabilities/capabilities';
|
|
7
|
+
import { AppGraphBuilder, HelpCapabilities, HelpState, ReactRoot, ReactSurface } from './capabilities';
|
|
9
8
|
import { meta } from './meta';
|
|
10
9
|
import { translations } from './translations';
|
|
11
10
|
import { HelpAction, type Step } from './types';
|
|
12
11
|
|
|
13
12
|
export type HelpPluginOptions = { steps?: Step[] };
|
|
14
13
|
|
|
15
|
-
export const HelpPlugin = ({ steps = [] }
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
]);
|
|
14
|
+
export const HelpPlugin = definePlugin<HelpPluginOptions>(meta, ({ steps = [] }) => [
|
|
15
|
+
defineModule({
|
|
16
|
+
id: `${meta.id}/module/state`,
|
|
17
|
+
activatesOn: Events.Startup,
|
|
18
|
+
activate: HelpState,
|
|
19
|
+
}),
|
|
20
|
+
defineModule({
|
|
21
|
+
id: `${meta.id}/module/translations`,
|
|
22
|
+
activatesOn: Events.SetupTranslations,
|
|
23
|
+
activate: () => contributes(Capabilities.Translations, translations),
|
|
24
|
+
}),
|
|
25
|
+
defineModule({
|
|
26
|
+
id: `${meta.id}/module/react-root`,
|
|
27
|
+
activatesOn: Events.Startup,
|
|
28
|
+
activate: () => ReactRoot(steps),
|
|
29
|
+
}),
|
|
30
|
+
defineModule({
|
|
31
|
+
id: `${meta.id}/module/react-surface`,
|
|
32
|
+
activatesOn: Events.SetupReactSurface,
|
|
33
|
+
activate: ReactSurface,
|
|
34
|
+
}),
|
|
35
|
+
defineModule({
|
|
36
|
+
id: `${meta.id}/module/intent-resolver`,
|
|
37
|
+
activatesOn: Events.SetupIntentResolver,
|
|
38
|
+
activate: (context) =>
|
|
39
|
+
contributes(
|
|
40
|
+
Capabilities.IntentResolver,
|
|
41
|
+
createResolver({
|
|
42
|
+
intent: HelpAction.Start,
|
|
43
|
+
resolve: () => {
|
|
44
|
+
const state = context.getCapability(HelpCapabilities.MutableState);
|
|
45
|
+
state.running = true;
|
|
46
|
+
},
|
|
47
|
+
}),
|
|
48
|
+
),
|
|
49
|
+
}),
|
|
50
|
+
defineModule({
|
|
51
|
+
id: `${meta.id}/module/app-graph-builder`,
|
|
52
|
+
activatesOn: Events.SetupAppGraph,
|
|
53
|
+
activate: AppGraphBuilder,
|
|
54
|
+
}),
|
|
55
|
+
]);
|
|
@@ -2,14 +2,15 @@
|
|
|
2
2
|
// Copyright 2025 DXOS.org
|
|
3
3
|
//
|
|
4
4
|
|
|
5
|
-
import {
|
|
6
|
-
import
|
|
5
|
+
import { Atom } from '@effect-atom/atom-react';
|
|
6
|
+
import * as Function from 'effect/Function';
|
|
7
|
+
import * as Option from 'effect/Option';
|
|
7
8
|
|
|
8
9
|
import { Capabilities, LayoutAction, type PluginContext, contributes, createIntent } from '@dxos/app-framework';
|
|
9
10
|
import { createExtension } from '@dxos/app-graph';
|
|
10
11
|
|
|
11
12
|
import { SHORTCUTS_DIALOG } from '../components';
|
|
12
|
-
import {
|
|
13
|
+
import { meta } from '../meta';
|
|
13
14
|
import { HelpAction } from '../types';
|
|
14
15
|
|
|
15
16
|
import { HelpCapabilities } from './capabilities';
|
|
@@ -18,10 +19,10 @@ export default (context: PluginContext) =>
|
|
|
18
19
|
contributes(
|
|
19
20
|
Capabilities.AppGraphBuilder,
|
|
20
21
|
createExtension({
|
|
21
|
-
id:
|
|
22
|
+
id: meta.id,
|
|
22
23
|
actions: (node) =>
|
|
23
|
-
|
|
24
|
-
pipe(
|
|
24
|
+
Atom.make((get) =>
|
|
25
|
+
Function.pipe(
|
|
25
26
|
get(node),
|
|
26
27
|
Option.flatMap((node) => (node.id === 'root' ? Option.some(node) : Option.none())),
|
|
27
28
|
Option.map(() => [
|
|
@@ -34,7 +35,7 @@ export default (context: PluginContext) =>
|
|
|
34
35
|
await dispatch(createIntent(HelpAction.Start));
|
|
35
36
|
},
|
|
36
37
|
properties: {
|
|
37
|
-
label: ['open help tour', { ns:
|
|
38
|
+
label: ['open help tour', { ns: meta.id }],
|
|
38
39
|
icon: 'ph--info--regular',
|
|
39
40
|
keyBinding: {
|
|
40
41
|
macos: 'shift+meta+/',
|
|
@@ -46,7 +47,7 @@ export default (context: PluginContext) =>
|
|
|
46
47
|
},
|
|
47
48
|
},
|
|
48
49
|
{
|
|
49
|
-
id:
|
|
50
|
+
id: `${meta.id}/open-shortcuts`,
|
|
50
51
|
data: async () => {
|
|
51
52
|
const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
|
|
52
53
|
const state = context.getCapability(HelpCapabilities.MutableState);
|
|
@@ -62,7 +63,7 @@ export default (context: PluginContext) =>
|
|
|
62
63
|
);
|
|
63
64
|
},
|
|
64
65
|
properties: {
|
|
65
|
-
label: ['open shortcuts label', { ns:
|
|
66
|
+
label: ['open shortcuts label', { ns: meta.id }],
|
|
66
67
|
icon: 'ph--keyboard--regular',
|
|
67
68
|
keyBinding: {
|
|
68
69
|
macos: 'meta+ctrl+/',
|
|
@@ -4,10 +4,10 @@
|
|
|
4
4
|
|
|
5
5
|
import { defineCapability } from '@dxos/app-framework';
|
|
6
6
|
|
|
7
|
-
import {
|
|
7
|
+
import { meta } from '../meta';
|
|
8
8
|
|
|
9
9
|
export namespace HelpCapabilities {
|
|
10
10
|
export type State = { running: boolean; showHints: boolean; showWelcome: boolean };
|
|
11
|
-
export const State = defineCapability<Readonly<State>>(`${
|
|
12
|
-
export const MutableState = defineCapability<State>(`${
|
|
11
|
+
export const State = defineCapability<Readonly<State>>(`${meta.id}/capability/state`);
|
|
12
|
+
export const MutableState = defineCapability<State>(`${meta.id}/capability/state`);
|
|
13
13
|
}
|
|
@@ -4,17 +4,18 @@
|
|
|
4
4
|
|
|
5
5
|
import React from 'react';
|
|
6
6
|
|
|
7
|
-
import { Capabilities, contributes
|
|
7
|
+
import { Capabilities, contributes } from '@dxos/app-framework';
|
|
8
|
+
import { useCapability } from '@dxos/app-framework/react';
|
|
8
9
|
|
|
9
10
|
import { WelcomeTour } from '../components';
|
|
10
|
-
import {
|
|
11
|
+
import { meta } from '../meta';
|
|
11
12
|
import { type Step } from '../types';
|
|
12
13
|
|
|
13
14
|
import { HelpCapabilities } from './capabilities';
|
|
14
15
|
|
|
15
16
|
export default (steps: Step[]) =>
|
|
16
17
|
contributes(Capabilities.ReactRoot, {
|
|
17
|
-
id:
|
|
18
|
+
id: meta.id,
|
|
18
19
|
root: () => {
|
|
19
20
|
const state = useCapability(HelpCapabilities.MutableState);
|
|
20
21
|
return (
|
|
@@ -7,17 +7,17 @@ import React from 'react';
|
|
|
7
7
|
import { Capabilities, contributes, createSurface } from '@dxos/app-framework';
|
|
8
8
|
|
|
9
9
|
import { SHORTCUTS_DIALOG, ShortcutsDialogContent, ShortcutsHints, ShortcutsList } from '../components';
|
|
10
|
-
import {
|
|
10
|
+
import { meta } from '../meta';
|
|
11
11
|
|
|
12
12
|
export default () =>
|
|
13
13
|
contributes(Capabilities.ReactSurface, [
|
|
14
14
|
createSurface({
|
|
15
|
-
id: `${
|
|
15
|
+
id: `${meta.id}/hints`,
|
|
16
16
|
role: 'hints',
|
|
17
17
|
component: () => <ShortcutsHints />,
|
|
18
18
|
}),
|
|
19
19
|
createSurface({
|
|
20
|
-
id: `${
|
|
20
|
+
id: `${meta.id}/keyshortcuts`,
|
|
21
21
|
role: 'keyshortcuts',
|
|
22
22
|
component: () => <ShortcutsList />,
|
|
23
23
|
}),
|
|
@@ -5,12 +5,12 @@
|
|
|
5
5
|
import { contributes } from '@dxos/app-framework';
|
|
6
6
|
import { LocalStorageStore } from '@dxos/local-storage';
|
|
7
7
|
|
|
8
|
-
import {
|
|
8
|
+
import { meta } from '../meta';
|
|
9
9
|
|
|
10
10
|
import { HelpCapabilities } from './capabilities';
|
|
11
11
|
|
|
12
12
|
export default () => {
|
|
13
|
-
const state = new LocalStorageStore<HelpCapabilities.State>(
|
|
13
|
+
const state = new LocalStorageStore<HelpCapabilities.State>(meta.id, {
|
|
14
14
|
running: false,
|
|
15
15
|
showHints: true,
|
|
16
16
|
showWelcome: true,
|
|
@@ -4,26 +4,23 @@
|
|
|
4
4
|
|
|
5
5
|
import React from 'react';
|
|
6
6
|
|
|
7
|
-
import {
|
|
7
|
+
import { Dialog, IconButton, useTranslation } from '@dxos/react-ui';
|
|
8
8
|
|
|
9
|
-
import {
|
|
9
|
+
import { meta } from '../../meta';
|
|
10
10
|
|
|
11
11
|
import { ShortcutsList } from './ShortcutsList';
|
|
12
12
|
|
|
13
|
-
export const SHORTCUTS_DIALOG = `${
|
|
13
|
+
export const SHORTCUTS_DIALOG = `${meta.id}/ShortcutsDialog`;
|
|
14
14
|
|
|
15
15
|
export const ShortcutsDialogContent = () => {
|
|
16
|
-
const { t } = useTranslation(
|
|
16
|
+
const { t } = useTranslation(meta.id);
|
|
17
17
|
|
|
18
18
|
return (
|
|
19
19
|
<Dialog.Content classNames='p-0 bs-content max-bs-full md:max-is-[25rem] overflow-hidden'>
|
|
20
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
21
|
<Dialog.Title>{t('shortcuts dialog title')}</Dialog.Title>
|
|
22
|
-
|
|
23
22
|
<Dialog.Close asChild>
|
|
24
|
-
<
|
|
25
|
-
<Icon icon='ph--x--bold' size={3} />
|
|
26
|
-
</Button>
|
|
23
|
+
<IconButton icon='ph--x--bold' iconOnly size={3} label='Close' variant='ghost' autoFocus />
|
|
27
24
|
</Dialog.Close>
|
|
28
25
|
</div>
|
|
29
26
|
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
import React from 'react';
|
|
6
6
|
|
|
7
7
|
import { type KeyBinding, Keyboard } from '@dxos/keyboard';
|
|
8
|
-
import {
|
|
8
|
+
import { IconButton, toLocalizedString, useTranslation } from '@dxos/react-ui';
|
|
9
9
|
|
|
10
10
|
import { Key } from './Key';
|
|
11
11
|
|
|
@@ -26,14 +26,21 @@ export const ShortcutsHints = ({ onClose }: { onClose?: () => void }) => {
|
|
|
26
26
|
const hints = bindings.filter((binding) => defaults.includes(binding.shortcut));
|
|
27
27
|
|
|
28
28
|
return (
|
|
29
|
-
<div role='none' className='flex overflow-hidden
|
|
29
|
+
<div role='none' className='flex overflow-hidden pli-2 gap-4'>
|
|
30
30
|
{hints.map((binding) => (
|
|
31
31
|
<Shortcut key={binding.shortcut} binding={binding} />
|
|
32
32
|
))}
|
|
33
33
|
{onClose && (
|
|
34
|
-
<
|
|
35
|
-
|
|
36
|
-
|
|
34
|
+
<IconButton
|
|
35
|
+
icon='ph--x--regular'
|
|
36
|
+
size={4}
|
|
37
|
+
label='Close'
|
|
38
|
+
iconOnly
|
|
39
|
+
noTooltip
|
|
40
|
+
variant='ghost'
|
|
41
|
+
classNames='p-0 cursor-pointer'
|
|
42
|
+
onClick={onClose}
|
|
43
|
+
/>
|
|
37
44
|
)}
|
|
38
45
|
</div>
|
|
39
46
|
);
|
|
@@ -8,12 +8,12 @@ import { Keyboard } from '@dxos/keyboard';
|
|
|
8
8
|
import { toLocalizedString, useTranslation } from '@dxos/react-ui';
|
|
9
9
|
import { mx } from '@dxos/react-ui-theme';
|
|
10
10
|
|
|
11
|
-
import {
|
|
11
|
+
import { meta } from '../../meta';
|
|
12
12
|
|
|
13
13
|
import { Key } from './Key';
|
|
14
14
|
|
|
15
15
|
export const ShortcutsList = () => {
|
|
16
|
-
const { t } = useTranslation(
|
|
16
|
+
const { t } = useTranslation(meta.id);
|
|
17
17
|
const bindings = Keyboard.singleton.getBindings();
|
|
18
18
|
|
|
19
19
|
// TODO(burdon): Get shortcuts from TextEditor.
|
|
@@ -2,14 +2,14 @@
|
|
|
2
2
|
// Copyright 2023 DXOS.org
|
|
3
3
|
//
|
|
4
4
|
|
|
5
|
-
import '@dxos-theme';
|
|
6
|
-
|
|
7
5
|
import { type Meta, type StoryObj } from '@storybook/react-vite';
|
|
8
6
|
import React, { useState } from 'react';
|
|
9
7
|
|
|
8
|
+
import { withPluginManager } from '@dxos/app-framework/testing';
|
|
9
|
+
import { StorybookLayoutPlugin } from '@dxos/plugin-storybook-layout';
|
|
10
10
|
import { faker } from '@dxos/random';
|
|
11
11
|
import { Button, Icon } from '@dxos/react-ui';
|
|
12
|
-
import { withTheme } from '@dxos/
|
|
12
|
+
import { withTheme } from '@dxos/react-ui/testing';
|
|
13
13
|
|
|
14
14
|
import { useHelp } from '../../hooks';
|
|
15
15
|
|
|
@@ -23,8 +23,8 @@ const App = () => {
|
|
|
23
23
|
};
|
|
24
24
|
|
|
25
25
|
return (
|
|
26
|
-
<div className='flex flex-col
|
|
27
|
-
<div className='flex items-center gap-2
|
|
26
|
+
<div className='flex flex-col bs-full p-4 space-y-8'>
|
|
27
|
+
<div className='flex items-center gap-2 plb-2'>
|
|
28
28
|
<Button data-joyride='basic/1' onClick={() => start()}>
|
|
29
29
|
Start
|
|
30
30
|
</Button>
|
|
@@ -41,13 +41,13 @@ const App = () => {
|
|
|
41
41
|
))}
|
|
42
42
|
</ul>
|
|
43
43
|
</div>
|
|
44
|
-
<div className='flex items-center gap-2
|
|
44
|
+
<div className='flex items-center gap-2 plb-2'>
|
|
45
45
|
<Button data-joyride='basic/3' onClick={handleAdd}>
|
|
46
46
|
Add
|
|
47
47
|
</Button>
|
|
48
48
|
</div>
|
|
49
49
|
<div className='flex grow' />
|
|
50
|
-
<div className='flex items-center
|
|
50
|
+
<div className='flex items-center plb-2'>
|
|
51
51
|
<div className='grow' />
|
|
52
52
|
<Icon icon='ph--circle--regular' data-joyride='basic/4' />
|
|
53
53
|
<Icon icon='ph--circle--regular' />
|
|
@@ -104,11 +104,12 @@ export const Default: StoryObj<typeof WelcomeTour> = {
|
|
|
104
104
|
/**
|
|
105
105
|
* IMPORTANT: Run in separate tab.
|
|
106
106
|
*/
|
|
107
|
-
const meta
|
|
107
|
+
const meta = {
|
|
108
108
|
title: 'plugins/plugin-help/WelcomeTour',
|
|
109
109
|
component: WelcomeTour,
|
|
110
110
|
render: DefaultStory,
|
|
111
|
-
|
|
112
|
-
}
|
|
111
|
+
// TODO(wittjosiah): Try to write story which does not depend on plugin manager.
|
|
112
|
+
decorators: [withTheme, withPluginManager({ plugins: [StorybookLayoutPlugin({})] })],
|
|
113
|
+
} satisfies Meta<typeof WelcomeTour>;
|
|
113
114
|
|
|
114
115
|
export default meta;
|
|
@@ -2,10 +2,11 @@
|
|
|
2
2
|
// Copyright 2023 DXOS.org
|
|
3
3
|
//
|
|
4
4
|
|
|
5
|
-
import React, {
|
|
5
|
+
import React, { useState } from 'react';
|
|
6
6
|
import Joyride, { ACTIONS, EVENTS } from 'react-joyride';
|
|
7
7
|
|
|
8
|
-
import { useLayout, usePluginManager } from '@dxos/app-framework';
|
|
8
|
+
import { useLayout, usePluginManager } from '@dxos/app-framework/react';
|
|
9
|
+
import { useAsyncEffect } from '@dxos/react-ui';
|
|
9
10
|
|
|
10
11
|
import { HelpContext, type Step } from '../../types';
|
|
11
12
|
import { Tooltip, floaterProps } from '../Tooltip';
|
|
@@ -93,20 +94,16 @@ export const WelcomeTour = ({ steps: initialSteps, running: runningProp, onRunni
|
|
|
93
94
|
}
|
|
94
95
|
};
|
|
95
96
|
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
}
|
|
107
|
-
});
|
|
108
|
-
|
|
109
|
-
return () => clearTimeout(timeout);
|
|
97
|
+
useAsyncEffect(async () => {
|
|
98
|
+
if (runningProp) {
|
|
99
|
+
// This handles the case when the target is not yet in the document.
|
|
100
|
+
// If the target is not in the document, when the joyride is turned on, it will not show the tooltip.
|
|
101
|
+
await waitForTarget(steps[stepIndex]);
|
|
102
|
+
setStepIndex(0);
|
|
103
|
+
setRunning(true);
|
|
104
|
+
} else if (typeof runningProp !== 'undefined') {
|
|
105
|
+
setRunning(false);
|
|
106
|
+
}
|
|
110
107
|
}, [runningProp]);
|
|
111
108
|
|
|
112
109
|
// https://docs.react-joyride.com/callback
|
package/src/meta.ts
CHANGED
|
@@ -3,12 +3,14 @@
|
|
|
3
3
|
//
|
|
4
4
|
|
|
5
5
|
import { type PluginMeta } from '@dxos/app-framework';
|
|
6
|
-
|
|
7
|
-
// TODO(burdon): Rename Guide? Help?
|
|
8
|
-
export const HELP_PLUGIN = 'dxos.org/plugin/help';
|
|
6
|
+
import { trim } from '@dxos/util';
|
|
9
7
|
|
|
10
8
|
export const meta: PluginMeta = {
|
|
11
|
-
id:
|
|
9
|
+
id: 'dxos.org/plugin/help',
|
|
12
10
|
name: 'Help',
|
|
11
|
+
description: trim`
|
|
12
|
+
Built-in help system with documentation, tutorials, and contextual assistance.
|
|
13
|
+
Access keyboard shortcuts, feature guides, and support resources.
|
|
14
|
+
`,
|
|
13
15
|
icon: 'ph--info--regular',
|
|
14
16
|
};
|
package/src/types/schema.ts
CHANGED
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"version": 3,
|
|
3
|
-
"sources": ["../../../src/capabilities/app-graph-builder.ts"],
|
|
4
|
-
"sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Rx } from '@effect-rx/rx-react';\nimport { Option, pipe } from 'effect';\n\nimport { Capabilities, LayoutAction, type PluginContext, contributes, createIntent } from '@dxos/app-framework';\nimport { createExtension } from '@dxos/app-graph';\n\nimport { SHORTCUTS_DIALOG } from '../components';\nimport { HELP_PLUGIN } from '../meta';\nimport { HelpAction } from '../types';\n\nimport { HelpCapabilities } from './capabilities';\n\nexport default (context: PluginContext) =>\n contributes(\n Capabilities.AppGraphBuilder,\n createExtension({\n id: HELP_PLUGIN,\n actions: (node) =>\n Rx.make((get) =>\n pipe(\n get(node),\n Option.flatMap((node) => (node.id === 'root' ? Option.some(node) : Option.none())),\n Option.map(() => [\n {\n id: HelpAction.Start._tag,\n data: async () => {\n const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);\n const state = context.getCapability(HelpCapabilities.MutableState);\n state.showHints = true;\n await dispatch(createIntent(HelpAction.Start));\n },\n properties: {\n label: ['open help tour', { ns: HELP_PLUGIN }],\n icon: 'ph--info--regular',\n keyBinding: {\n macos: 'shift+meta+/',\n // TODO(wittjosiah): Test on windows to see if it behaves the same as linux.\n windows: 'shift+ctrl+/',\n linux: 'shift+ctrl+?',\n },\n testId: 'helpPlugin.openHelp',\n },\n },\n {\n id: 'dxos.org/plugin/help/open-shortcuts',\n data: async () => {\n const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);\n const state = context.getCapability(HelpCapabilities.MutableState);\n state.showHints = true;\n await dispatch(\n createIntent(LayoutAction.UpdateDialog, {\n part: 'dialog',\n subject: SHORTCUTS_DIALOG,\n options: {\n blockAlign: 'center',\n },\n }),\n );\n },\n properties: {\n label: ['open shortcuts label', { ns: HELP_PLUGIN }],\n icon: 'ph--keyboard--regular',\n keyBinding: {\n macos: 'meta+ctrl+/',\n },\n },\n },\n ]),\n Option.getOrElse(() => []),\n ),\n ),\n }),\n );\n"],
|
|
5
|
-
"mappings": ";;;;;;;;;;;;;;AAIA,SAASA,UAAU;AACnB,SAASC,QAAQC,YAAY;AAE7B,SAASC,cAAcC,cAAkCC,aAAaC,oBAAoB;AAC1F,SAASC,uBAAuB;AAQhC,IAAA,4BAAe,CAACC,YACdC,YACEC,aAAaC,iBACbC,gBAAgB;EACdC,IAAIC;EACJC,SAAS,CAACC,SACRC,GAAGC,KAAK,CAACC,QACPC,KACED,IAAIH,IAAAA,GACJK,OAAOC,QAAQ,CAACN,UAAUA,MAAKH,OAAO,SAASQ,OAAOE,KAAKP,KAAAA,IAAQK,OAAOG,KAAI,CAAA,GAC9EH,OAAOI,IAAI,MAAM;IACf;MACEZ,IAAIa,WAAWC,MAAMC;MACrBC,MAAM,YAAA;AACJ,cAAM,EAAEC,iBAAiBC,SAAQ,IAAKvB,QAAQwB,cAActB,aAAauB,gBAAgB;AACzF,cAAMC,QAAQ1B,QAAQwB,cAAcG,iBAAiBC,YAAY;AACjEF,cAAMG,YAAY;AAClB,cAAMN,SAASO,aAAaZ,WAAWC,KAAK,CAAA;MAC9C;MACAY,YAAY;QACVC,OAAO;UAAC;UAAkB;YAAEC,IAAI3B;UAAY;;QAC5C4B,MAAM;QACNC,YAAY;UACVC,OAAO;;UAEPC,SAAS;UACTC,OAAO;QACT;QACAC,QAAQ;MACV;IACF;IACA;MACElC,IAAI;MACJgB,MAAM,YAAA;AACJ,cAAM,EAAEC,iBAAiBC,SAAQ,IAAKvB,QAAQwB,cAActB,aAAauB,gBAAgB;AACzF,cAAMC,QAAQ1B,QAAQwB,cAAcG,iBAAiBC,YAAY;AACjEF,cAAMG,YAAY;AAClB,cAAMN,SACJO,aAAaU,aAAaC,cAAc;UACtCC,MAAM;UACNC,SAASC;UACTC,SAAS;YACPC,YAAY;UACd;QACF,CAAA,CAAA;MAEJ;MACAf,YAAY;QACVC,OAAO;UAAC;UAAwB;YAAEC,IAAI3B;UAAY;;QAClD4B,MAAM;QACNC,YAAY;UACVC,OAAO;QACT;MACF;IACF;GACD,GACDvB,OAAOkC,UAAU,MAAM,CAAA,CAAE,CAAA,CAAA;AAGjC,CAAA,CAAA;",
|
|
6
|
-
"names": ["Rx", "Option", "pipe", "Capabilities", "LayoutAction", "contributes", "createIntent", "createExtension", "context", "contributes", "Capabilities", "AppGraphBuilder", "createExtension", "id", "HELP_PLUGIN", "actions", "node", "Rx", "make", "get", "pipe", "Option", "flatMap", "some", "none", "map", "HelpAction", "Start", "_tag", "data", "dispatchPromise", "dispatch", "getCapability", "IntentDispatcher", "state", "HelpCapabilities", "MutableState", "showHints", "createIntent", "properties", "label", "ns", "icon", "keyBinding", "macos", "windows", "linux", "testId", "LayoutAction", "UpdateDialog", "part", "subject", "SHORTCUTS_DIALOG", "options", "blockAlign", "getOrElse"]
|
|
7
|
-
}
|
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"version": 3,
|
|
3
|
-
"sources": ["../../../src/meta.ts"],
|
|
4
|
-
"sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type PluginMeta } from '@dxos/app-framework';\n\n// TODO(burdon): Rename Guide? Help?\nexport const HELP_PLUGIN = 'dxos.org/plugin/help';\n\nexport const meta: PluginMeta = {\n id: HELP_PLUGIN,\n name: 'Help',\n icon: 'ph--info--regular',\n};\n"],
|
|
5
|
-
"mappings": ";AAOO,IAAMA,cAAc;AAEpB,IAAMC,OAAmB;EAC9BC,IAAIF;EACJG,MAAM;EACNC,MAAM;AACR;",
|
|
6
|
-
"names": ["HELP_PLUGIN", "meta", "id", "name", "icon"]
|
|
7
|
-
}
|