@dxos/plugin-help 0.8.4-main.ae835ea → 0.8.4-main.bc674ce

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 (113) hide show
  1. package/dist/lib/browser/app-graph-builder-DX3VXARQ.mjs +79 -0
  2. package/dist/lib/browser/app-graph-builder-DX3VXARQ.mjs.map +7 -0
  3. package/dist/lib/browser/{chunk-BCYK4LXW.mjs → chunk-IM2QVQOH.mjs} +1 -1
  4. package/dist/lib/browser/chunk-IM2QVQOH.mjs.map +7 -0
  5. package/dist/lib/browser/chunk-TS66J4C6.mjs +58 -0
  6. package/dist/lib/browser/chunk-TS66J4C6.mjs.map +7 -0
  7. package/dist/lib/browser/chunk-W5XAZM46.mjs +360 -0
  8. package/dist/lib/browser/chunk-W5XAZM46.mjs.map +7 -0
  9. package/dist/lib/browser/index.mjs +58 -55
  10. package/dist/lib/browser/index.mjs.map +4 -4
  11. package/dist/lib/browser/meta.json +1 -1
  12. package/dist/lib/browser/meta.mjs +1 -1
  13. package/dist/lib/browser/react-root-SZRF6EXG.mjs +43 -0
  14. package/dist/lib/browser/react-root-SZRF6EXG.mjs.map +7 -0
  15. package/dist/lib/browser/{react-surface-K3QAYZIQ.mjs → react-surface-DWNTJBVM.mjs} +12 -11
  16. package/dist/lib/browser/react-surface-DWNTJBVM.mjs.map +7 -0
  17. package/dist/lib/browser/state-VRPLKT3F.mjs +27 -0
  18. package/dist/lib/browser/state-VRPLKT3F.mjs.map +7 -0
  19. package/dist/lib/browser/types/index.mjs +8 -6
  20. package/dist/types/src/HelpPlugin.d.ts +2 -1
  21. package/dist/types/src/HelpPlugin.d.ts.map +1 -1
  22. package/dist/types/src/capabilities/app-graph-builder/app-graph-builder.d.ts +6 -0
  23. package/dist/types/src/capabilities/app-graph-builder/app-graph-builder.d.ts.map +1 -0
  24. package/dist/types/src/capabilities/app-graph-builder/index.d.ts +3 -0
  25. package/dist/types/src/capabilities/app-graph-builder/index.d.ts.map +1 -0
  26. package/dist/types/src/capabilities/index.d.ts +5 -8
  27. package/dist/types/src/capabilities/index.d.ts.map +1 -1
  28. package/dist/types/src/capabilities/operation-resolver/index.d.ts +2 -0
  29. package/dist/types/src/capabilities/operation-resolver/index.d.ts.map +1 -0
  30. package/dist/types/src/capabilities/operation-resolver/operation-resolver.d.ts +5 -0
  31. package/dist/types/src/capabilities/operation-resolver/operation-resolver.d.ts.map +1 -0
  32. package/dist/types/src/capabilities/react-root/index.d.ts +6 -0
  33. package/dist/types/src/capabilities/react-root/index.d.ts.map +1 -0
  34. package/dist/types/src/capabilities/react-root/react-root.d.ts +10 -0
  35. package/dist/types/src/capabilities/react-root/react-root.d.ts.map +1 -0
  36. package/dist/types/src/capabilities/react-surface/index.d.ts +3 -0
  37. package/dist/types/src/capabilities/react-surface/index.d.ts.map +1 -0
  38. package/dist/types/src/capabilities/react-surface/react-surface.d.ts +5 -0
  39. package/dist/types/src/capabilities/react-surface/react-surface.d.ts.map +1 -0
  40. package/dist/types/src/capabilities/state/index.d.ts +11 -0
  41. package/dist/types/src/capabilities/state/index.d.ts.map +1 -0
  42. package/dist/types/src/capabilities/state/state.d.ts +13 -0
  43. package/dist/types/src/capabilities/state/state.d.ts.map +1 -0
  44. package/dist/types/src/components/Shortcuts/ShortcutsDialog.d.ts.map +1 -1
  45. package/dist/types/src/components/Shortcuts/ShortcutsHints.d.ts.map +1 -1
  46. package/dist/types/src/components/Tooltip/Tooltip.d.ts.map +1 -1
  47. package/dist/types/src/components/WelcomeTour/WelcomeTour.stories.d.ts.map +1 -1
  48. package/dist/types/src/index.d.ts +1 -1
  49. package/dist/types/src/index.d.ts.map +1 -1
  50. package/dist/types/src/meta.d.ts +2 -2
  51. package/dist/types/src/meta.d.ts.map +1 -1
  52. package/dist/types/src/types/capabilities.d.ts +21 -0
  53. package/dist/types/src/types/capabilities.d.ts.map +1 -0
  54. package/dist/types/src/types/index.d.ts +1 -0
  55. package/dist/types/src/types/index.d.ts.map +1 -1
  56. package/dist/types/src/types/schema.d.ts +16 -12
  57. package/dist/types/src/types/schema.d.ts.map +1 -1
  58. package/dist/types/tsconfig.tsbuildinfo +1 -1
  59. package/package.json +38 -34
  60. package/src/HelpPlugin.tsx +16 -42
  61. package/src/capabilities/app-graph-builder/app-graph-builder.ts +61 -0
  62. package/src/capabilities/app-graph-builder/index.ts +7 -0
  63. package/src/capabilities/index.ts +5 -8
  64. package/src/capabilities/operation-resolver/index.ts +5 -0
  65. package/src/capabilities/operation-resolver/operation-resolver.ts +23 -0
  66. package/src/capabilities/react-root/index.ts +7 -0
  67. package/src/capabilities/react-root/react-root.tsx +36 -0
  68. package/src/capabilities/react-surface/index.ts +7 -0
  69. package/src/capabilities/react-surface/react-surface.tsx +34 -0
  70. package/src/capabilities/state/index.ts +7 -0
  71. package/src/capabilities/state/state.ts +27 -0
  72. package/src/components/Shortcuts/ShortcutsDialog.tsx +3 -6
  73. package/src/components/Shortcuts/ShortcutsHints.tsx +14 -6
  74. package/src/components/Shortcuts/ShortcutsList.tsx +1 -1
  75. package/src/components/Shortcuts/ShortcutsSection.tsx +1 -1
  76. package/src/components/Shortcuts/styles.ts +1 -1
  77. package/src/components/Tooltip/Tooltip.tsx +0 -1
  78. package/src/components/WelcomeTour/WelcomeTour.stories.tsx +12 -8
  79. package/src/components/WelcomeTour/WelcomeTour.tsx +2 -2
  80. package/src/index.ts +1 -1
  81. package/src/meta.ts +2 -2
  82. package/src/types/capabilities.ts +24 -0
  83. package/src/types/index.ts +1 -0
  84. package/src/types/schema.ts +11 -7
  85. package/dist/lib/browser/app-graph-builder-V35EXVG5.mjs +0 -80
  86. package/dist/lib/browser/app-graph-builder-V35EXVG5.mjs.map +0 -7
  87. package/dist/lib/browser/chunk-AZJJLAG7.mjs +0 -16
  88. package/dist/lib/browser/chunk-AZJJLAG7.mjs.map +0 -7
  89. package/dist/lib/browser/chunk-BCYK4LXW.mjs.map +0 -7
  90. package/dist/lib/browser/chunk-I7FKM6VC.mjs +0 -34
  91. package/dist/lib/browser/chunk-I7FKM6VC.mjs.map +0 -7
  92. package/dist/lib/browser/chunk-RGVUINGG.mjs +0 -407
  93. package/dist/lib/browser/chunk-RGVUINGG.mjs.map +0 -7
  94. package/dist/lib/browser/react-root-7LMCJR73.mjs +0 -34
  95. package/dist/lib/browser/react-root-7LMCJR73.mjs.map +0 -7
  96. package/dist/lib/browser/react-surface-K3QAYZIQ.mjs.map +0 -7
  97. package/dist/lib/browser/state-5PVJCYWJ.mjs +0 -29
  98. package/dist/lib/browser/state-5PVJCYWJ.mjs.map +0 -7
  99. package/dist/types/src/capabilities/app-graph-builder.d.ts +0 -4
  100. package/dist/types/src/capabilities/app-graph-builder.d.ts.map +0 -1
  101. package/dist/types/src/capabilities/capabilities.d.ts +0 -10
  102. package/dist/types/src/capabilities/capabilities.d.ts.map +0 -1
  103. package/dist/types/src/capabilities/react-root.d.ts +0 -8
  104. package/dist/types/src/capabilities/react-root.d.ts.map +0 -1
  105. package/dist/types/src/capabilities/react-surface.d.ts +0 -4
  106. package/dist/types/src/capabilities/react-surface.d.ts.map +0 -1
  107. package/dist/types/src/capabilities/state.d.ts +0 -4
  108. package/dist/types/src/capabilities/state.d.ts.map +0 -1
  109. package/src/capabilities/app-graph-builder.ts +0 -78
  110. package/src/capabilities/capabilities.ts +0 -13
  111. package/src/capabilities/react-root.tsx +0 -33
  112. package/src/capabilities/react-surface.tsx +0 -30
  113. package/src/capabilities/state.ts +0 -24
@@ -0,0 +1,79 @@
1
+ import {
2
+ SHORTCUTS_DIALOG
3
+ } from "./chunk-W5XAZM46.mjs";
4
+ import {
5
+ HelpCapabilities,
6
+ HelpOperation
7
+ } from "./chunk-TS66J4C6.mjs";
8
+ import {
9
+ meta
10
+ } from "./chunk-IM2QVQOH.mjs";
11
+
12
+ // src/capabilities/app-graph-builder/app-graph-builder.ts
13
+ import * as Effect from "effect/Effect";
14
+ import { Capability, Common } from "@dxos/app-framework";
15
+ import { GraphBuilder, NodeMatcher } from "@dxos/app-graph";
16
+ import { Operation } from "@dxos/operation";
17
+ var app_graph_builder_default = Capability.makeModule(Effect.fnUntraced(function* () {
18
+ const extensions = yield* GraphBuilder.createExtension({
19
+ id: meta.id,
20
+ match: NodeMatcher.whenRoot,
21
+ actions: () => Effect.succeed([
22
+ {
23
+ id: HelpOperation.Start.meta.key,
24
+ data: Effect.fnUntraced(function* () {
25
+ yield* Common.Capability.updateAtomValue(HelpCapabilities.State, (s) => ({
26
+ ...s,
27
+ showHints: true
28
+ }));
29
+ yield* Operation.invoke(HelpOperation.Start);
30
+ }),
31
+ properties: {
32
+ label: [
33
+ "open help tour",
34
+ {
35
+ ns: meta.id
36
+ }
37
+ ],
38
+ icon: "ph--info--regular",
39
+ keyBinding: {
40
+ macos: "shift+meta+/",
41
+ windows: "shift+ctrl+/",
42
+ linux: "shift+ctrl+?"
43
+ },
44
+ testId: "helpPlugin.openHelp"
45
+ }
46
+ },
47
+ {
48
+ id: `${meta.id}/open-shortcuts`,
49
+ data: Effect.fnUntraced(function* () {
50
+ yield* Common.Capability.updateAtomValue(HelpCapabilities.State, (s) => ({
51
+ ...s,
52
+ showHints: true
53
+ }));
54
+ yield* Operation.invoke(Common.LayoutOperation.UpdateDialog, {
55
+ subject: SHORTCUTS_DIALOG,
56
+ blockAlign: "center"
57
+ });
58
+ }),
59
+ properties: {
60
+ label: [
61
+ "open shortcuts label",
62
+ {
63
+ ns: meta.id
64
+ }
65
+ ],
66
+ icon: "ph--keyboard--regular",
67
+ keyBinding: {
68
+ macos: "meta+ctrl+/"
69
+ }
70
+ }
71
+ }
72
+ ])
73
+ });
74
+ return Capability.contributes(Common.Capability.AppGraphBuilder, extensions);
75
+ }));
76
+ export {
77
+ app_graph_builder_default as default
78
+ };
79
+ //# sourceMappingURL=app-graph-builder-DX3VXARQ.mjs.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/capabilities/app-graph-builder/app-graph-builder.ts"],
4
+ "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability, Common } from '@dxos/app-framework';\nimport { GraphBuilder, NodeMatcher } from '@dxos/app-graph';\nimport { Operation } from '@dxos/operation';\n\nimport { SHORTCUTS_DIALOG } from '../../components';\nimport { meta } from '../../meta';\nimport { HelpCapabilities, HelpOperation } from '../../types';\n\nexport default Capability.makeModule(\n Effect.fnUntraced(function* () {\n const extensions = yield* GraphBuilder.createExtension({\n id: meta.id,\n match: NodeMatcher.whenRoot,\n actions: () =>\n Effect.succeed([\n {\n id: HelpOperation.Start.meta.key,\n data: Effect.fnUntraced(function* () {\n yield* Common.Capability.updateAtomValue(HelpCapabilities.State, (s) => ({ ...s, showHints: true }));\n yield* Operation.invoke(HelpOperation.Start);\n }),\n properties: {\n label: ['open help tour', { 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 {\n id: `${meta.id}/open-shortcuts`,\n data: Effect.fnUntraced(function* () {\n yield* Common.Capability.updateAtomValue(HelpCapabilities.State, (s) => ({ ...s, showHints: true }));\n yield* Operation.invoke(Common.LayoutOperation.UpdateDialog, {\n subject: SHORTCUTS_DIALOG,\n blockAlign: 'center',\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(Common.Capability.AppGraphBuilder, extensions);\n }),\n);\n"],
5
+ "mappings": ";;;;;;;;;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,YAAYC,cAAc;AACnC,SAASC,cAAcC,mBAAmB;AAC1C,SAASC,iBAAiB;AAM1B,IAAA,4BAAeC,WAAWC,WACjBC,kBAAW,aAAA;AAChB,QAAMC,aAAa,OAAOC,aAAaC,gBAAgB;IACrDC,IAAIC,KAAKD;IACTE,OAAOC,YAAYC;IACnBC,SAAS,MACAC,eAAQ;MACb;QACEN,IAAIO,cAAcC,MAAMP,KAAKQ;QAC7BC,MAAad,kBAAW,aAAA;AACtB,iBAAOe,OAAOjB,WAAWkB,gBAAgBC,iBAAiBC,OAAO,CAACC,OAAO;YAAE,GAAGA;YAAGC,WAAW;UAAK,EAAA;AACjG,iBAAOC,UAAUC,OAAOX,cAAcC,KAAK;QAC7C,CAAA;QACAW,YAAY;UACVC,OAAO;YAAC;YAAkB;cAAEC,IAAIpB,KAAKD;YAAG;;UACxCsB,MAAM;UACNC,YAAY;YACVC,OAAO;YACPC,SAAS;YACTC,OAAO;UACT;UACAC,QAAQ;QACV;MACF;MACA;QACE3B,IAAI,GAAGC,KAAKD,EAAE;QACdU,MAAad,kBAAW,aAAA;AACtB,iBAAOe,OAAOjB,WAAWkB,gBAAgBC,iBAAiBC,OAAO,CAACC,OAAO;YAAE,GAAGA;YAAGC,WAAW;UAAK,EAAA;AACjG,iBAAOC,UAAUC,OAAOP,OAAOiB,gBAAgBC,cAAc;YAC3DC,SAASC;YACTC,YAAY;UACd,CAAA;QACF,CAAA;QACAb,YAAY;UACVC,OAAO;YAAC;YAAwB;cAAEC,IAAIpB,KAAKD;YAAG;;UAC9CsB,MAAM;UACNC,YAAY;YACVC,OAAO;UACT;QACF;MACF;KACD;EACL,CAAA;AAEA,SAAO9B,WAAWuC,YAAYtB,OAAOjB,WAAWwC,iBAAiBrC,UAAAA;AACnE,CAAA,CAAA;",
6
+ "names": ["Effect", "Capability", "Common", "GraphBuilder", "NodeMatcher", "Operation", "Capability", "makeModule", "fnUntraced", "extensions", "GraphBuilder", "createExtension", "id", "meta", "match", "NodeMatcher", "whenRoot", "actions", "succeed", "HelpOperation", "Start", "key", "data", "Common", "updateAtomValue", "HelpCapabilities", "State", "s", "showHints", "Operation", "invoke", "properties", "label", "ns", "icon", "keyBinding", "macos", "windows", "linux", "testId", "LayoutOperation", "UpdateDialog", "subject", "SHORTCUTS_DIALOG", "blockAlign", "contributes", "AppGraphBuilder"]
7
+ }
@@ -13,4 +13,4 @@ var meta = {
13
13
  export {
14
14
  meta
15
15
  };
16
- //# sourceMappingURL=chunk-BCYK4LXW.mjs.map
16
+ //# sourceMappingURL=chunk-IM2QVQOH.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: 'dxos.org/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
+ }
@@ -0,0 +1,58 @@
1
+ import {
2
+ meta
3
+ } from "./chunk-IM2QVQOH.mjs";
4
+
5
+ // src/types/capabilities.ts
6
+ import * as Schema from "effect/Schema";
7
+ import { Capability } from "@dxos/app-framework";
8
+ (function(HelpCapabilities2) {
9
+ HelpCapabilities2.StateSchema = Schema.mutable(Schema.Struct({
10
+ running: Schema.Boolean,
11
+ showHints: Schema.Boolean,
12
+ showWelcome: Schema.Boolean
13
+ }));
14
+ HelpCapabilities2.State = Capability.make(`${meta.id}/capability/state`);
15
+ })(HelpCapabilities || (HelpCapabilities = {}));
16
+ var HelpCapabilities;
17
+
18
+ // src/types/schema.ts
19
+ import * as Schema2 from "effect/Schema";
20
+ import { createContext } from "react";
21
+ import { Capability as Capability2 } from "@dxos/app-framework";
22
+ import { Operation } from "@dxos/operation";
23
+ var HelpContext = createContext({
24
+ running: false,
25
+ steps: [],
26
+ setSteps: () => {
27
+ },
28
+ setIndex: () => {
29
+ },
30
+ start: () => {
31
+ },
32
+ stop: () => {
33
+ }
34
+ });
35
+ var HELP_OPERATION = `${meta.id}/operation`;
36
+ (function(HelpOperation2) {
37
+ HelpOperation2.Start = Operation.make({
38
+ meta: {
39
+ key: `${HELP_OPERATION}/start`,
40
+ name: "Start Help"
41
+ },
42
+ services: [
43
+ Capability2.Service
44
+ ],
45
+ schema: {
46
+ input: Schema2.Void,
47
+ output: Schema2.Void
48
+ }
49
+ });
50
+ })(HelpOperation || (HelpOperation = {}));
51
+ var HelpOperation;
52
+
53
+ export {
54
+ HelpCapabilities,
55
+ HelpContext,
56
+ HelpOperation
57
+ };
58
+ //# sourceMappingURL=chunk-TS66J4C6.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 * as Schema from 'effect/Schema';\nimport { type Context, createContext } from 'react';\nimport { type Step as BaseStep } from 'react-joyride';\n\nimport { Capability, type CapabilityManager } from '@dxos/app-framework';\nimport { Operation } from '@dxos/operation';\n\nimport { meta } from '../meta';\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\nconst HELP_OPERATION = `${meta.id}/operation`;\n\nexport namespace HelpOperation {\n export const Start = Operation.make({\n meta: { key: `${HELP_OPERATION}/start`, name: 'Start Help' },\n services: [Capability.Service],\n schema: { input: Schema.Void, output: Schema.Void },\n });\n}\n"],
5
+ "mappings": ";;;;;AAKA,YAAYA,YAAY;AAExB,SAASC,kBAAkB;UAIVC,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,YAAYa,aAAY;AACxB,SAAuBC,qBAAqB;AAG5C,SAASC,cAAAA,mBAA0C;AACnD,SAASC,iBAAiB;AAiBnB,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;AAEA,IAAMC,iBAAiB,GAAGC,KAAKC,EAAE;UAEhBC,gBAAAA;iBACFC,QAAQC,UAAUC,KAAK;IAClCL,MAAM;MAAEM,KAAK,GAAGP,cAAAA;MAAwBQ,MAAM;IAAa;IAC3DC,UAAU;MAACC,YAAWC;;IACtBC,QAAQ;MAAEC,OAAcC;MAAMC,QAAeD;IAAK;EACpD,CAAA;AACF,GANiBX,kBAAAA,gBAAAA,CAAAA,EAAAA;;",
6
+ "names": ["Schema", "Capability", "HelpCapabilities", "StateSchema", "mutable", "Struct", "running", "Boolean", "showHints", "showWelcome", "State", "Capability", "make", "meta", "id", "Schema", "createContext", "Capability", "Operation", "HelpContext", "createContext", "running", "steps", "setSteps", "setIndex", "start", "stop", "HELP_OPERATION", "meta", "id", "HelpOperation", "Start", "Operation", "make", "key", "name", "services", "Capability", "Service", "schema", "input", "Void", "output"]
7
+ }
@@ -0,0 +1,360 @@
1
+ import {
2
+ HelpContext
3
+ } from "./chunk-TS66J4C6.mjs";
4
+ import {
5
+ meta
6
+ } from "./chunk-IM2QVQOH.mjs";
7
+
8
+ // src/components/Shortcuts/Key.tsx
9
+ import React from "react";
10
+ import { keySymbols } from "@dxos/keyboard";
11
+
12
+ // src/components/Shortcuts/styles.ts
13
+ import { mx } from "@dxos/ui-theme";
14
+ var shortcutKey = mx("inline-flex min-is-[24px] bs-[24px] pli-0.5 justify-center items-center text-xs", "rounded bg-neutral-100 dark:bg-neutral-900");
15
+
16
+ // src/components/Shortcuts/Key.tsx
17
+ var Key = ({ binding }) => {
18
+ return /* @__PURE__ */ React.createElement("span", {
19
+ role: "term",
20
+ className: "inline-flex gap-1",
21
+ "aria-label": binding,
22
+ id: binding
23
+ }, keySymbols(binding).map((c, i) => /* @__PURE__ */ React.createElement("span", {
24
+ key: i,
25
+ className: shortcutKey
26
+ }, c)));
27
+ };
28
+
29
+ // src/components/Shortcuts/ShortcutsList.tsx
30
+ import React2, { Fragment } from "react";
31
+ import { Keyboard } from "@dxos/keyboard";
32
+ import { toLocalizedString, useTranslation } from "@dxos/react-ui";
33
+ import { mx as mx2 } from "@dxos/ui-theme";
34
+ var ShortcutsList = () => {
35
+ const { t } = useTranslation(meta.id);
36
+ const bindings = Keyboard.singleton.getBindings();
37
+ bindings.sort((a, b) => {
38
+ return toLocalizedString(a.data, t)?.toLowerCase().localeCompare(toLocalizedString(b.data, t)?.toLowerCase());
39
+ });
40
+ return /* @__PURE__ */ React2.createElement("dl", {
41
+ className: mx2("is-fit grid grid-cols-[min-content_minmax(12rem,1fr)] gap-2 mlb-4 text-subdued select-none")
42
+ }, bindings.map((binding, i) => /* @__PURE__ */ React2.createElement(Fragment, {
43
+ key: i
44
+ }, /* @__PURE__ */ React2.createElement(Key, {
45
+ binding: binding.shortcut
46
+ }), /* @__PURE__ */ React2.createElement("span", {
47
+ role: "definition",
48
+ className: "mis-4",
49
+ "aria-labelledby": binding.shortcut
50
+ }, toLocalizedString(binding.data, t)))));
51
+ };
52
+
53
+ // src/components/Shortcuts/ShortcutsDialog.tsx
54
+ import React3 from "react";
55
+ import { Dialog, IconButton, useTranslation as useTranslation2 } from "@dxos/react-ui";
56
+ var SHORTCUTS_DIALOG = `${meta.id}/ShortcutsDialog`;
57
+ var ShortcutsDialogContent = () => {
58
+ const { t } = useTranslation2(meta.id);
59
+ return /* @__PURE__ */ React3.createElement(Dialog.Content, null, /* @__PURE__ */ React3.createElement("div", {
60
+ role: "none",
61
+ className: "flex justify-between mbe-1 pbs-3 pis-2 pie-3 @md:pbs-4 @md:pis-4 @md:pie-5"
62
+ }, /* @__PURE__ */ React3.createElement(Dialog.Title, null, t("shortcuts dialog title")), /* @__PURE__ */ React3.createElement(Dialog.Close, {
63
+ asChild: true
64
+ }, /* @__PURE__ */ React3.createElement(IconButton, {
65
+ icon: "ph--x--bold",
66
+ iconOnly: true,
67
+ size: 3,
68
+ label: "Close",
69
+ variant: "ghost",
70
+ autoFocus: true
71
+ }))), /* @__PURE__ */ React3.createElement("div", {
72
+ className: "flex items-center justify-center"
73
+ }, /* @__PURE__ */ React3.createElement(ShortcutsList, null)));
74
+ };
75
+
76
+ // src/components/Shortcuts/ShortcutsHints.tsx
77
+ import React4 from "react";
78
+ import { Keyboard as Keyboard2 } from "@dxos/keyboard";
79
+ import { IconButton as IconButton2, toLocalizedString as toLocalizedString2, useTranslation as useTranslation3 } from "@dxos/react-ui";
80
+ import { osTranslations } from "@dxos/ui-theme";
81
+ var Shortcut = ({ binding }) => {
82
+ const { t } = useTranslation3(osTranslations);
83
+ return /* @__PURE__ */ React4.createElement("div", {
84
+ role: "none",
85
+ className: "flex items-center gap-2 whitespace-nowrap"
86
+ }, /* @__PURE__ */ React4.createElement(Key, {
87
+ binding: binding.shortcut
88
+ }), /* @__PURE__ */ React4.createElement("span", {
89
+ className: "text-sm"
90
+ }, toLocalizedString2(binding.data, t)));
91
+ };
92
+ var ShortcutsHints = ({ onClose }) => {
93
+ const defaults = [
94
+ "meta+k",
95
+ "meta+/",
96
+ "meta+,"
97
+ ];
98
+ const bindings = Keyboard2.singleton.getBindings();
99
+ const hints = bindings.filter((binding) => defaults.includes(binding.shortcut));
100
+ return /* @__PURE__ */ React4.createElement("div", {
101
+ role: "none",
102
+ className: "flex overflow-hidden pli-2 gap-4"
103
+ }, hints.map((binding) => /* @__PURE__ */ React4.createElement(Shortcut, {
104
+ key: binding.shortcut,
105
+ binding
106
+ })), onClose && /* @__PURE__ */ React4.createElement(IconButton2, {
107
+ icon: "ph--x--regular",
108
+ size: 4,
109
+ label: "Close",
110
+ iconOnly: true,
111
+ noTooltip: true,
112
+ variant: "ghost",
113
+ classNames: "p-0 cursor-pointer",
114
+ onClick: onClose
115
+ }));
116
+ };
117
+
118
+ // src/components/Shortcuts/ShortcutsSection.tsx
119
+ import React5 from "react";
120
+ import { descriptionText } from "@dxos/ui-theme";
121
+ var ShortcutsSection = () => {
122
+ return /* @__PURE__ */ React5.createElement("section", {
123
+ className: descriptionText
124
+ }, /* @__PURE__ */ React5.createElement(ShortcutsList, null));
125
+ };
126
+
127
+ // src/components/Tooltip/Tooltip.tsx
128
+ import { useArrowNavigationGroup, useFocusableGroup } from "@fluentui/react-tabster";
129
+ import React6, { forwardRef } from "react";
130
+ import { Button, Icon, IconButton as IconButton3 } from "@dxos/react-ui";
131
+ var floaterProps = {
132
+ styles: {
133
+ // Arrow color is set by joyride.
134
+ arrow: {
135
+ length: 8,
136
+ spread: 16
137
+ },
138
+ floater: {
139
+ // TODO(burdon): Get tokens from theme.
140
+ filter: "drop-shadow(0 0 0.75rem rgba(0, 0, 0, 0.2))"
141
+ }
142
+ }
143
+ };
144
+ var Tooltip = /* @__PURE__ */ forwardRef(({ step: { title, content }, index, size, isLastStep, backProps, closeProps, primaryProps }, forwardedRef) => {
145
+ const arrowNavigationAttrs = useArrowNavigationGroup({
146
+ axis: "horizontal"
147
+ });
148
+ const focusableGroupAttrs = useFocusableGroup({
149
+ tabBehavior: "limited-trap-focus"
150
+ });
151
+ return /* @__PURE__ */ React6.createElement("div", {
152
+ className: "flex flex-col is-[15rem] min-bs-[10rem] overflow-hidden rounded-md shadow-xl bg-accentSurface text-accentSurfaceText",
153
+ role: "tooltip",
154
+ "data-testid": "helpPlugin.tooltip",
155
+ "data-step": index + 1,
156
+ ...focusableGroupAttrs,
157
+ ref: forwardedRef
158
+ }, /* @__PURE__ */ React6.createElement("div", {
159
+ className: "flex p-2"
160
+ }, /* @__PURE__ */ React6.createElement("h2", {
161
+ className: "grow pli-2 plb-1 text-lg font-medium text-accentSurfaceText"
162
+ }, title), /* @__PURE__ */ React6.createElement(IconButton3, {
163
+ density: "fine",
164
+ icon: "ph--x--bold",
165
+ iconOnly: true,
166
+ label: closeProps["aria-label"],
167
+ onClick: closeProps.onClick,
168
+ size: 4,
169
+ variant: "primary",
170
+ "data-testid": "helpPlugin.tooltip.close"
171
+ })), /* @__PURE__ */ React6.createElement("div", {
172
+ className: "flex grow pli-4 mlb-2"
173
+ }, content), /* @__PURE__ */ React6.createElement("div", {
174
+ className: "flex p-2 items-center justify-between",
175
+ ...arrowNavigationAttrs
176
+ }, /* @__PURE__ */ React6.createElement(IconButton3, {
177
+ classNames: [
178
+ !(index > 0 && backProps) && "invisible"
179
+ ],
180
+ icon: "ph--caret-left--regular",
181
+ iconOnly: true,
182
+ label: backProps["aria-label"],
183
+ onClick: backProps.onClick,
184
+ variant: "primary",
185
+ "data-testid": "helpPlugin.tooltip.back"
186
+ }), /* @__PURE__ */ React6.createElement("div", {
187
+ className: "flex grow gap-2 justify-center"
188
+ }, /* @__PURE__ */ React6.createElement("div", {
189
+ className: "flex"
190
+ }, Array.from({
191
+ length: size
192
+ }).map((_, i) => /* @__PURE__ */ React6.createElement(Icon, {
193
+ key: i,
194
+ icon: index === i ? "ph--circle--fill" : "ph--circle--regular",
195
+ size: 2,
196
+ classNames: "mli-1 cursor-pointer"
197
+ })))), isLastStep ? /* @__PURE__ */ React6.createElement(Button, {
198
+ variant: "primary",
199
+ onClick: closeProps.onClick,
200
+ title: closeProps["aria-label"],
201
+ autoFocus: true,
202
+ "data-testid": "helpPlugin.tooltip.finish"
203
+ }, "Done") : /* @__PURE__ */ React6.createElement(IconButton3, {
204
+ autoFocus: true,
205
+ icon: "ph--caret-right--regular",
206
+ iconOnly: true,
207
+ label: primaryProps["aria-label"],
208
+ onClick: primaryProps.onClick,
209
+ size: 6,
210
+ variant: "primary",
211
+ "data-testid": "helpPlugin.tooltip.next"
212
+ })));
213
+ });
214
+
215
+ // src/components/WelcomeTour/WelcomeTour.tsx
216
+ import React7, { useState } from "react";
217
+ import Joyride, { ACTIONS, EVENTS } from "react-joyride";
218
+ import { useLayout, usePluginManager } from "@dxos/app-framework/react";
219
+ import { useAsyncEffect } from "@dxos/react-ui";
220
+ var addStepClass = (target) => {
221
+ const element = typeof target === "string" ? document.querySelector(target) : target;
222
+ if (element) {
223
+ element.classList.add("joyride-target");
224
+ }
225
+ };
226
+ var removeTargetClass = (target) => {
227
+ const element = typeof target === "string" ? document.querySelector(target) : target;
228
+ if (element) {
229
+ element.classList.remove("joyride-target");
230
+ }
231
+ };
232
+ var getTarget = (step) => {
233
+ return typeof step.target === "string" ? document.querySelector(step.target) : step.target;
234
+ };
235
+ var waitForTarget = async (step) => {
236
+ if (typeof step.target === "string") {
237
+ const target = step.target;
238
+ const element = document.querySelector(target);
239
+ if (element) {
240
+ return;
241
+ }
242
+ await new Promise((resolve) => {
243
+ const observer = new MutationObserver((mutations) => {
244
+ mutations.forEach((mutation) => {
245
+ if (mutation.addedNodes.length > 0) {
246
+ const element2 = document.querySelector(target);
247
+ if (element2) {
248
+ observer.disconnect();
249
+ resolve();
250
+ }
251
+ }
252
+ });
253
+ });
254
+ observer.observe(document.body, {
255
+ childList: true,
256
+ subtree: true
257
+ });
258
+ });
259
+ }
260
+ };
261
+ var WelcomeTour = ({ steps: initialSteps, running: runningProp, onRunningChanged }) => {
262
+ const manager = usePluginManager();
263
+ const layout = useLayout();
264
+ const [running, setRunning] = useState(!!runningProp && !!getTarget(initialSteps[0]));
265
+ const [stepIndex, _setStepIndex] = useState(0);
266
+ const [steps, setSteps] = useState(initialSteps);
267
+ const paused = layout.dialogOpen;
268
+ const setStepIndex = (index) => {
269
+ if (runningProp) {
270
+ const step = steps[index];
271
+ step?.before?.(manager.capabilities);
272
+ }
273
+ _setStepIndex(index);
274
+ };
275
+ const setRunningChanged = (state) => {
276
+ if (typeof runningProp !== "undefined") {
277
+ onRunningChanged?.(state);
278
+ } else {
279
+ if (state) {
280
+ setStepIndex(0);
281
+ setRunning(true);
282
+ } else {
283
+ setRunning(false);
284
+ }
285
+ }
286
+ };
287
+ useAsyncEffect(async () => {
288
+ if (runningProp) {
289
+ await waitForTarget(steps[stepIndex]);
290
+ setStepIndex(0);
291
+ setRunning(true);
292
+ } else if (typeof runningProp !== "undefined") {
293
+ setRunning(false);
294
+ }
295
+ }, [
296
+ runningProp
297
+ ]);
298
+ const callback = async (options) => {
299
+ const { type, action, index, size } = options;
300
+ switch (type) {
301
+ case EVENTS.STEP_BEFORE:
302
+ addStepClass(options.step.target);
303
+ break;
304
+ case EVENTS.TOUR_END:
305
+ break;
306
+ case EVENTS.STEP_AFTER:
307
+ removeTargetClass(options.step.target);
308
+ switch (action) {
309
+ case ACTIONS.NEXT:
310
+ if (index < size - 1) {
311
+ setStepIndex(index + 1);
312
+ }
313
+ break;
314
+ case ACTIONS.PREV:
315
+ if (index > 0) {
316
+ setStepIndex(index - 1);
317
+ }
318
+ break;
319
+ case ACTIONS.CLOSE:
320
+ setRunningChanged(false);
321
+ setStepIndex(0);
322
+ break;
323
+ }
324
+ break;
325
+ }
326
+ };
327
+ return /* @__PURE__ */ React7.createElement(HelpContext.Provider, {
328
+ value: {
329
+ running: running && !paused,
330
+ steps,
331
+ setSteps,
332
+ setIndex: setStepIndex,
333
+ start: () => setRunningChanged(true),
334
+ stop: () => setRunningChanged(false)
335
+ }
336
+ }, /* @__PURE__ */ React7.createElement("style", null, `.joyride-target {
337
+ --controls-opacity: 1;
338
+ }`), /* @__PURE__ */ React7.createElement(Joyride, {
339
+ continuous: true,
340
+ steps,
341
+ stepIndex,
342
+ run: running && !paused,
343
+ callback,
344
+ floaterProps,
345
+ tooltipComponent: Tooltip
346
+ }));
347
+ };
348
+
349
+ export {
350
+ Key,
351
+ ShortcutsList,
352
+ SHORTCUTS_DIALOG,
353
+ ShortcutsDialogContent,
354
+ ShortcutsHints,
355
+ ShortcutsSection,
356
+ floaterProps,
357
+ Tooltip,
358
+ WelcomeTour
359
+ };
360
+ //# sourceMappingURL=chunk-W5XAZM46.mjs.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/components/Shortcuts/Key.tsx", "../../../src/components/Shortcuts/styles.ts", "../../../src/components/Shortcuts/ShortcutsList.tsx", "../../../src/components/Shortcuts/ShortcutsDialog.tsx", "../../../src/components/Shortcuts/ShortcutsHints.tsx", "../../../src/components/Shortcuts/ShortcutsSection.tsx", "../../../src/components/Tooltip/Tooltip.tsx", "../../../src/components/WelcomeTour/WelcomeTour.tsx"],
4
+ "sourcesContent": ["//\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-is-[24px] bs-[24px] pli-0.5 justify-center items-center text-xs',\n 'rounded bg-neutral-100 dark:bg-neutral-900',\n);\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport React, { Fragment } from 'react';\n\nimport { Keyboard } from '@dxos/keyboard';\nimport { toLocalizedString, useTranslation } from '@dxos/react-ui';\nimport { mx } from '@dxos/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('is-fit grid grid-cols-[min-content_minmax(12rem,1fr)] gap-2 mlb-4 text-subdued select-none')}>\n {bindings.map((binding, i) => (\n <Fragment key={i}>\n <Key binding={binding.shortcut} />\n <span role='definition' className='mis-4' aria-labelledby={binding.shortcut}>\n {toLocalizedString(binding.data, t)}\n </span>\n </Fragment>\n ))}\n </dl>\n );\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Dialog, IconButton, useTranslation } from '@dxos/react-ui';\n\nimport { meta } from '../../meta';\n\nimport { ShortcutsList } from './ShortcutsList';\n\nexport const SHORTCUTS_DIALOG = `${meta.id}/ShortcutsDialog`;\n\nexport const ShortcutsDialogContent = () => {\n const { t } = useTranslation(meta.id);\n\n return (\n <Dialog.Content>\n <div role='none' className='flex justify-between mbe-1 pbs-3 pis-2 pie-3 @md:pbs-4 @md:pis-4 @md:pie-5'>\n <Dialog.Title>{t('shortcuts dialog title')}</Dialog.Title>\n <Dialog.Close asChild>\n <IconButton icon='ph--x--bold' iconOnly size={3} label='Close' variant='ghost' autoFocus />\n </Dialog.Close>\n </div>\n\n <div className='flex items-center justify-center'>\n <ShortcutsList />\n </div>\n </Dialog.Content>\n );\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { type KeyBinding, Keyboard } from '@dxos/keyboard';\nimport { 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 role='none' className='flex items-center gap-2 whitespace-nowrap'>\n <Key binding={binding.shortcut} />\n <span className='text-sm'>{toLocalizedString(binding.data, t)}</span>\n </div>\n );\n};\n\nexport const ShortcutsHints = ({ onClose }: { onClose?: () => void }) => {\n // TODO(burdon): Display by context/weight/cycle.\n const defaults = ['meta+k', 'meta+/', 'meta+,'];\n const bindings = Keyboard.singleton.getBindings();\n const hints = bindings.filter((binding) => defaults.includes(binding.shortcut));\n\n return (\n <div role='none' className='flex overflow-hidden pli-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 { descriptionText } from '@dxos/ui-theme';\n\nimport { ShortcutsList } from './ShortcutsList';\n\nexport const ShortcutsSection = () => {\n return (\n <section className={descriptionText}>\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 is-[15rem] min-bs-[10rem] overflow-hidden rounded-md shadow-xl bg-accentSurface text-accentSurfaceText'\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 pli-2 plb-1 text-lg font-medium text-accentSurfaceText'>{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 pli-4 mlb-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='mli-1 cursor-pointer'\n />\n ))}\n </div>\n </div>\n {isLastStep ? (\n <Button\n variant='primary'\n onClick={closeProps.onClick}\n title={closeProps['aria-label']}\n autoFocus\n data-testid='helpPlugin.tooltip.finish'\n >\n Done\n </Button>\n ) : (\n <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 { useLayout, usePluginManager } from '@dxos/app-framework/react';\nimport { useAsyncEffect } from '@dxos/react-ui';\n\nimport { HelpContext, type Step } from '../../types';\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 />\n </HelpContext.Provider>\n );\n};\n"],
5
+ "mappings": "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",
6
+ "names": ["React", "keySymbols", "mx", "shortcutKey", "mx", "Key", "binding", "span", "role", "className", "aria-label", "id", "keySymbols", "map", "c", "i", "key", "shortcutKey", "React", "Fragment", "Keyboard", "toLocalizedString", "useTranslation", "mx", "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", "Dialog", "IconButton", "useTranslation", "SHORTCUTS_DIALOG", "meta", "id", "ShortcutsDialogContent", "t", "useTranslation", "React", "Dialog", "Content", "div", "role", "className", "Title", "Close", "asChild", "IconButton", "icon", "iconOnly", "size", "label", "variant", "autoFocus", "ShortcutsList", "React", "Keyboard", "IconButton", "toLocalizedString", "useTranslation", "osTranslations", "Shortcut", "binding", "t", "useTranslation", "osTranslations", "React", "div", "role", "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", "descriptionText", "ShortcutsSection", "React", "section", "className", "descriptionText", "ShortcutsList", "useArrowNavigationGroup", "useFocusableGroup", "React", "forwardRef", "Button", "Icon", "IconButton", "floaterProps", "styles", "arrow", "length", "spread", "floater", "filter", "Tooltip", "forwardRef", "step", "title", "content", "index", "size", "isLastStep", "backProps", "closeProps", "primaryProps", "forwardedRef", "arrowNavigationAttrs", "useArrowNavigationGroup", "axis", "focusableGroupAttrs", "useFocusableGroup", "tabBehavior", "React", "div", "className", "role", "data-testid", "data-step", "ref", "h2", "IconButton", "density", "icon", "iconOnly", "label", "onClick", "variant", "classNames", "Array", "from", "map", "_", "i", "Icon", "key", "Button", "autoFocus", "React", "useState", "Joyride", "ACTIONS", "EVENTS", "useLayout", "usePluginManager", "useAsyncEffect", "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"]
7
+ }