@theia/debug 1.34.2 → 1.34.3

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 (250) hide show
  1. package/LICENSE +641 -641
  2. package/README.md +62 -62
  3. package/bin/download-adapters.js +76 -76
  4. package/lib/browser/breakpoint/breakpoint-manager.d.ts +69 -69
  5. package/lib/browser/breakpoint/breakpoint-manager.js +311 -311
  6. package/lib/browser/breakpoint/breakpoint-marker.d.ts +40 -40
  7. package/lib/browser/breakpoint/breakpoint-marker.js +73 -73
  8. package/lib/browser/console/debug-console-contribution.d.ts +40 -40
  9. package/lib/browser/console/debug-console-contribution.js +227 -227
  10. package/lib/browser/console/debug-console-items.d.ts +93 -93
  11. package/lib/browser/console/debug-console-items.js +318 -318
  12. package/lib/browser/console/debug-console-session.d.ts +31 -31
  13. package/lib/browser/console/debug-console-session.js +199 -199
  14. package/lib/browser/debug-call-stack-item-type-key.d.ts +3 -3
  15. package/lib/browser/debug-call-stack-item-type-key.js +19 -19
  16. package/lib/browser/debug-configuration-manager.d.ts +101 -101
  17. package/lib/browser/debug-configuration-manager.js +521 -521
  18. package/lib/browser/debug-configuration-model.d.ts +29 -29
  19. package/lib/browser/debug-configuration-model.js +79 -79
  20. package/lib/browser/debug-contribution.d.ts +22 -22
  21. package/lib/browser/debug-contribution.js +19 -19
  22. package/lib/browser/debug-frontend-application-contribution.d.ts +214 -214
  23. package/lib/browser/debug-frontend-application-contribution.js +1351 -1351
  24. package/lib/browser/debug-frontend-module.d.ts +4 -4
  25. package/lib/browser/debug-frontend-module.js +108 -108
  26. package/lib/browser/debug-keybinding-contexts.d.ts +24 -24
  27. package/lib/browser/debug-keybinding-contexts.js +85 -85
  28. package/lib/browser/debug-package.spec.js +18 -18
  29. package/lib/browser/debug-preferences.d.ts +17 -17
  30. package/lib/browser/debug-preferences.js +89 -89
  31. package/lib/browser/debug-prefix-configuration.d.ts +50 -50
  32. package/lib/browser/debug-prefix-configuration.js +204 -204
  33. package/lib/browser/debug-resource.d.ts +14 -14
  34. package/lib/browser/debug-resource.js +65 -65
  35. package/lib/browser/debug-schema-updater.d.ts +15 -15
  36. package/lib/browser/debug-schema-updater.js +168 -168
  37. package/lib/browser/debug-session-connection.d.ts +110 -110
  38. package/lib/browser/debug-session-connection.js +258 -258
  39. package/lib/browser/debug-session-contribution.d.ts +73 -73
  40. package/lib/browser/debug-session-contribution.js +145 -145
  41. package/lib/browser/debug-session-manager.d.ts +137 -137
  42. package/lib/browser/debug-session-manager.js +593 -593
  43. package/lib/browser/debug-session-options.d.ts +48 -48
  44. package/lib/browser/debug-session-options.js +85 -85
  45. package/lib/browser/debug-session.d.ts +178 -178
  46. package/lib/browser/debug-session.js +859 -859
  47. package/lib/browser/debug-tab-bar-decorator.d.ts +16 -16
  48. package/lib/browser/debug-tab-bar-decorator.js +70 -70
  49. package/lib/browser/debug-watch-manager.d.ts +21 -21
  50. package/lib/browser/debug-watch-manager.js +93 -93
  51. package/lib/browser/disassembly-view/disassembly-view-accessibility-provider.d.ts +6 -6
  52. package/lib/browser/disassembly-view/disassembly-view-accessibility-provider.js +38 -38
  53. package/lib/browser/disassembly-view/disassembly-view-breakpoint-renderer.d.ts +19 -19
  54. package/lib/browser/disassembly-view/disassembly-view-breakpoint-renderer.js +110 -110
  55. package/lib/browser/disassembly-view/disassembly-view-contribution.d.ts +24 -24
  56. package/lib/browser/disassembly-view/disassembly-view-contribution.js +131 -131
  57. package/lib/browser/disassembly-view/disassembly-view-instruction-renderer.d.ts +38 -38
  58. package/lib/browser/disassembly-view/disassembly-view-instruction-renderer.js +222 -222
  59. package/lib/browser/disassembly-view/disassembly-view-table-delegate.d.ts +15 -15
  60. package/lib/browser/disassembly-view/disassembly-view-table-delegate.js +38 -38
  61. package/lib/browser/disassembly-view/disassembly-view-utilities.d.ts +37 -37
  62. package/lib/browser/disassembly-view/disassembly-view-utilities.js +17 -17
  63. package/lib/browser/disassembly-view/disassembly-view-widget.d.ts +60 -60
  64. package/lib/browser/disassembly-view/disassembly-view-widget.js +452 -452
  65. package/lib/browser/editor/debug-breakpoint-widget.d.ts +51 -51
  66. package/lib/browser/editor/debug-breakpoint-widget.js +245 -245
  67. package/lib/browser/editor/debug-editor-model.d.ts +91 -91
  68. package/lib/browser/editor/debug-editor-model.js +497 -497
  69. package/lib/browser/editor/debug-editor-service.d.ts +37 -37
  70. package/lib/browser/editor/debug-editor-service.js +214 -214
  71. package/lib/browser/editor/debug-editor.d.ts +3 -3
  72. package/lib/browser/editor/debug-editor.js +19 -19
  73. package/lib/browser/editor/debug-exception-widget.d.ts +28 -28
  74. package/lib/browser/editor/debug-exception-widget.js +111 -111
  75. package/lib/browser/editor/debug-expression-provider.d.ts +11 -11
  76. package/lib/browser/editor/debug-expression-provider.js +81 -81
  77. package/lib/browser/editor/debug-hover-source.d.ts +18 -18
  78. package/lib/browser/editor/debug-hover-source.js +117 -117
  79. package/lib/browser/editor/debug-hover-widget.d.ts +47 -47
  80. package/lib/browser/editor/debug-hover-widget.js +267 -267
  81. package/lib/browser/editor/debug-inline-value-decorator.d.ts +21 -21
  82. package/lib/browser/editor/debug-inline-value-decorator.js +337 -337
  83. package/lib/browser/model/debug-breakpoint.d.ts +47 -47
  84. package/lib/browser/model/debug-breakpoint.js +109 -109
  85. package/lib/browser/model/debug-function-breakpoint.d.ts +18 -18
  86. package/lib/browser/model/debug-function-breakpoint.js +92 -92
  87. package/lib/browser/model/debug-instruction-breakpoint.d.ts +14 -14
  88. package/lib/browser/model/debug-instruction-breakpoint.js +65 -65
  89. package/lib/browser/model/debug-source-breakpoint.d.ts +37 -37
  90. package/lib/browser/model/debug-source-breakpoint.js +211 -211
  91. package/lib/browser/model/debug-source.d.ts +24 -24
  92. package/lib/browser/model/debug-source.js +80 -80
  93. package/lib/browser/model/debug-stack-frame.d.ts +41 -41
  94. package/lib/browser/model/debug-stack-frame.js +146 -146
  95. package/lib/browser/model/debug-thread.d.ts +60 -60
  96. package/lib/browser/model/debug-thread.js +200 -200
  97. package/lib/browser/preferences/launch-preferences.d.ts +4 -4
  98. package/lib/browser/preferences/launch-preferences.js +38 -38
  99. package/lib/browser/view/debug-action.d.ts +16 -16
  100. package/lib/browser/view/debug-action.js +43 -43
  101. package/lib/browser/view/debug-breakpoints-source.d.ts +9 -9
  102. package/lib/browser/view/debug-breakpoints-source.js +70 -70
  103. package/lib/browser/view/debug-breakpoints-widget.d.ts +22 -22
  104. package/lib/browser/view/debug-breakpoints-widget.js +87 -87
  105. package/lib/browser/view/debug-configuration-select.d.ts +61 -61
  106. package/lib/browser/view/debug-configuration-select.js +204 -204
  107. package/lib/browser/view/debug-configuration-widget.d.ts +30 -30
  108. package/lib/browser/view/debug-configuration-widget.js +135 -135
  109. package/lib/browser/view/debug-exception-breakpoint.d.ts +13 -13
  110. package/lib/browser/view/debug-exception-breakpoint.js +34 -34
  111. package/lib/browser/view/debug-session-widget.d.ts +28 -28
  112. package/lib/browser/view/debug-session-widget.js +134 -134
  113. package/lib/browser/view/debug-stack-frames-source.d.ts +17 -17
  114. package/lib/browser/view/debug-stack-frames-source.js +89 -89
  115. package/lib/browser/view/debug-stack-frames-widget.d.ts +24 -24
  116. package/lib/browser/view/debug-stack-frames-widget.js +154 -154
  117. package/lib/browser/view/debug-threads-source.d.ts +8 -8
  118. package/lib/browser/view/debug-threads-source.js +63 -63
  119. package/lib/browser/view/debug-threads-widget.d.ts +26 -26
  120. package/lib/browser/view/debug-threads-widget.js +145 -145
  121. package/lib/browser/view/debug-toolbar-widget.d.ts +34 -34
  122. package/lib/browser/view/debug-toolbar-widget.js +156 -156
  123. package/lib/browser/view/debug-variables-source.d.ts +9 -9
  124. package/lib/browser/view/debug-variables-source.js +60 -60
  125. package/lib/browser/view/debug-variables-widget.d.ts +16 -16
  126. package/lib/browser/view/debug-variables-widget.js +78 -78
  127. package/lib/browser/view/debug-view-model.d.ts +51 -51
  128. package/lib/browser/view/debug-view-model.js +220 -220
  129. package/lib/browser/view/debug-watch-expression.d.ts +30 -30
  130. package/lib/browser/view/debug-watch-expression.js +73 -73
  131. package/lib/browser/view/debug-watch-source.d.ts +9 -9
  132. package/lib/browser/view/debug-watch-source.js +58 -58
  133. package/lib/browser/view/debug-watch-widget.d.ts +16 -16
  134. package/lib/browser/view/debug-watch-widget.js +78 -78
  135. package/lib/browser/view/debug-widget.d.ts +23 -23
  136. package/lib/browser/view/debug-widget.js +108 -108
  137. package/lib/common/debug-adapter-contribution-registry.d.ts +59 -59
  138. package/lib/common/debug-adapter-contribution-registry.js +212 -212
  139. package/lib/common/debug-adapter-session.d.ts +18 -18
  140. package/lib/common/debug-adapter-session.js +78 -78
  141. package/lib/common/debug-common.d.ts +1 -1
  142. package/lib/common/debug-common.js +29 -29
  143. package/lib/common/debug-compound.d.ts +14 -14
  144. package/lib/common/debug-compound.js +27 -27
  145. package/lib/common/debug-configuration.d.ts +58 -58
  146. package/lib/common/debug-configuration.js +31 -31
  147. package/lib/common/debug-model.d.ts +152 -152
  148. package/lib/common/debug-model.js +35 -35
  149. package/lib/common/debug-service.d.ts +123 -123
  150. package/lib/common/debug-service.js +66 -66
  151. package/lib/common/debug-uri-utils.d.ts +23 -23
  152. package/lib/common/debug-uri-utils.js +26 -26
  153. package/lib/common/inline-debug-adapter.d.ts +18 -18
  154. package/lib/common/inline-debug-adapter.js +44 -44
  155. package/lib/node/debug-adapter-factory.d.ts +19 -19
  156. package/lib/node/debug-adapter-factory.js +96 -96
  157. package/lib/node/debug-adapter-session-manager.d.ts +37 -37
  158. package/lib/node/debug-adapter-session-manager.js +111 -111
  159. package/lib/node/debug-backend-module.d.ts +3 -3
  160. package/lib/node/debug-backend-module.js +41 -41
  161. package/lib/node/debug-service-impl.d.ts +30 -30
  162. package/lib/node/debug-service-impl.js +124 -124
  163. package/lib/node/stream-debug-adapter.d.ts +36 -36
  164. package/lib/node/stream-debug-adapter.js +112 -112
  165. package/lib/node/vscode/vscode-debug-adapter-contribution.d.ts +47 -47
  166. package/lib/node/vscode/vscode-debug-adapter-contribution.js +221 -221
  167. package/package.json +15 -15
  168. package/src/browser/breakpoint/breakpoint-manager.ts +351 -351
  169. package/src/browser/breakpoint/breakpoint-marker.ts +102 -102
  170. package/src/browser/console/debug-console-contribution.tsx +239 -239
  171. package/src/browser/console/debug-console-items.tsx +383 -383
  172. package/src/browser/console/debug-console-session.ts +205 -205
  173. package/src/browser/debug-call-stack-item-type-key.ts +20 -20
  174. package/src/browser/debug-configuration-manager.ts +559 -559
  175. package/src/browser/debug-configuration-model.ts +100 -100
  176. package/src/browser/debug-contribution.ts +43 -43
  177. package/src/browser/debug-frontend-application-contribution.ts +1503 -1503
  178. package/src/browser/debug-frontend-module.ts +136 -136
  179. package/src/browser/debug-keybinding-contexts.ts +75 -75
  180. package/src/browser/debug-package.spec.ts +20 -20
  181. package/src/browser/debug-preferences.ts +98 -98
  182. package/src/browser/debug-prefix-configuration.ts +190 -190
  183. package/src/browser/debug-resource.ts +59 -59
  184. package/src/browser/debug-schema-updater.ts +149 -149
  185. package/src/browser/debug-session-connection.ts +357 -357
  186. package/src/browser/debug-session-contribution.ts +150 -150
  187. package/src/browser/debug-session-manager.ts +681 -681
  188. package/src/browser/debug-session-options.ts +114 -114
  189. package/src/browser/debug-session.tsx +936 -936
  190. package/src/browser/debug-tab-bar-decorator.ts +57 -57
  191. package/src/browser/debug-watch-manager.ts +93 -93
  192. package/src/browser/disassembly-view/disassembly-view-accessibility-provider.ts +43 -43
  193. package/src/browser/disassembly-view/disassembly-view-breakpoint-renderer.ts +119 -119
  194. package/src/browser/disassembly-view/disassembly-view-contribution.ts +109 -109
  195. package/src/browser/disassembly-view/disassembly-view-instruction-renderer.ts +245 -245
  196. package/src/browser/disassembly-view/disassembly-view-table-delegate.ts +39 -39
  197. package/src/browser/disassembly-view/disassembly-view-utilities.ts +55 -55
  198. package/src/browser/disassembly-view/disassembly-view-widget.ts +463 -463
  199. package/src/browser/editor/debug-breakpoint-widget.tsx +275 -275
  200. package/src/browser/editor/debug-editor-model.ts +508 -508
  201. package/src/browser/editor/debug-editor-service.ts +206 -206
  202. package/src/browser/editor/debug-editor.ts +20 -20
  203. package/src/browser/editor/debug-exception-widget.tsx +118 -118
  204. package/src/browser/editor/debug-expression-provider.ts +78 -78
  205. package/src/browser/editor/debug-hover-source.tsx +105 -105
  206. package/src/browser/editor/debug-hover-widget.ts +280 -280
  207. package/src/browser/editor/debug-inline-value-decorator.ts +377 -377
  208. package/src/browser/model/debug-breakpoint.tsx +151 -151
  209. package/src/browser/model/debug-function-breakpoint.tsx +101 -101
  210. package/src/browser/model/debug-instruction-breakpoint.tsx +68 -68
  211. package/src/browser/model/debug-source-breakpoint.tsx +237 -237
  212. package/src/browser/model/debug-source.ts +93 -93
  213. package/src/browser/model/debug-stack-frame.tsx +170 -170
  214. package/src/browser/model/debug-thread.tsx +240 -240
  215. package/src/browser/preferences/launch-preferences.ts +38 -38
  216. package/src/browser/style/index.css +445 -445
  217. package/src/browser/view/debug-action.tsx +57 -57
  218. package/src/browser/view/debug-breakpoints-source.tsx +53 -53
  219. package/src/browser/view/debug-breakpoints-widget.ts +71 -71
  220. package/src/browser/view/debug-configuration-select.tsx +256 -256
  221. package/src/browser/view/debug-configuration-widget.tsx +121 -121
  222. package/src/browser/view/debug-exception-breakpoint.tsx +43 -43
  223. package/src/browser/view/debug-session-widget.ts +124 -124
  224. package/src/browser/view/debug-stack-frames-source.tsx +75 -75
  225. package/src/browser/view/debug-stack-frames-widget.ts +135 -135
  226. package/src/browser/view/debug-threads-source.tsx +48 -48
  227. package/src/browser/view/debug-threads-widget.ts +125 -125
  228. package/src/browser/view/debug-toolbar-widget.tsx +145 -145
  229. package/src/browser/view/debug-variables-source.ts +43 -43
  230. package/src/browser/view/debug-variables-widget.ts +61 -61
  231. package/src/browser/view/debug-view-model.ts +230 -230
  232. package/src/browser/view/debug-watch-expression.tsx +88 -88
  233. package/src/browser/view/debug-watch-source.ts +41 -41
  234. package/src/browser/view/debug-watch-widget.ts +61 -61
  235. package/src/browser/view/debug-widget.ts +97 -97
  236. package/src/common/debug-adapter-contribution-registry.ts +206 -206
  237. package/src/common/debug-adapter-session.ts +102 -102
  238. package/src/common/debug-common.ts +19 -19
  239. package/src/common/debug-compound.ts +33 -33
  240. package/src/common/debug-configuration.ts +93 -93
  241. package/src/common/debug-model.ts +200 -200
  242. package/src/common/debug-service.ts +184 -184
  243. package/src/common/debug-uri-utils.ts +24 -24
  244. package/src/common/inline-debug-adapter.ts +47 -47
  245. package/src/node/debug-adapter-factory.ts +107 -107
  246. package/src/node/debug-adapter-session-manager.ts +106 -106
  247. package/src/node/debug-backend-module.ts +57 -57
  248. package/src/node/debug-service-impl.ts +119 -119
  249. package/src/node/stream-debug-adapter.ts +126 -126
  250. package/src/node/vscode/vscode-debug-adapter-contribution.ts +252 -252
@@ -1,153 +1,153 @@
1
- import { DebugConfiguration } from './debug-configuration';
2
- import { IJSONSchema, IJSONSchemaSnippet } from '@theia/core/lib/common/json-schema';
3
- import { MaybePromise } from '@theia/core/lib/common/types';
4
- import { Event } from '@theia/core';
5
- import { DebugChannel } from './debug-service';
6
- /**
7
- * DebugAdapterSession symbol for DI.
8
- */
9
- export declare const DebugAdapterSession: unique symbol;
10
- /**
11
- * The debug adapter session. The debug adapter session manages the lifecycle of a
12
- * debug session: the debug session should be discarded if and only if the debug adapter
13
- * session is stopped.
14
- */
15
- export interface DebugAdapterSession {
16
- id: string;
17
- parentSession?: DebugAdapterSession;
18
- start(channel: DebugChannel): Promise<void>;
19
- stop(): Promise<void>;
20
- }
21
- /**
22
- * DebugAdapterSessionFactory symbol for DI.
23
- */
24
- export declare const DebugAdapterSessionFactory: unique symbol;
25
- /**
26
- * The [debug session](#DebugSession) factory.
27
- */
28
- export interface DebugAdapterSessionFactory {
29
- get(sessionId: string, debugAdapter: DebugAdapter): DebugAdapterSession;
30
- }
31
- /**
32
- * Debug adapter executable for spawning.
33
- */
34
- export interface DebugAdapterSpawnExecutable {
35
- command: string;
36
- args?: string[];
37
- }
38
- /**
39
- * Debug adapter executable for forking.
40
- */
41
- export interface DebugAdapterForkExecutable {
42
- modulePath: string;
43
- execArgv?: string[];
44
- args?: string[];
45
- }
46
- /**
47
- * Debug adapter executable.
48
- * Parameters to instantiate the debug adapter.
49
- *
50
- * In case of launching adapter the parameters contain a command and arguments. For instance:
51
- * {'command' : 'COMMAND_TO_LAUNCH_DEBUG_ADAPTER', args : [ { 'arg1', 'arg2' } ] }
52
- *
53
- * In case of forking the node process, contain the modulePath to fork. For instance:
54
- * {'modulePath' : 'NODE_COMMAND_TO_LAUNCH_DEBUG_ADAPTER', args : [ { 'arg1', 'arg2' } ] }
55
- */
56
- export declare type DebugAdapterExecutable = DebugAdapterSpawnExecutable | DebugAdapterForkExecutable;
57
- /**
58
- * Implementers stand for the various types of debug adapters the system can talk to.
59
- * Creation of debug adapters is not covered in this interface, but handling communication
60
- * and the end of life is.
61
- */
62
- export interface DebugAdapter {
63
- /**
64
- * A DAP protocol message has been received from the debug adapter
65
- */
66
- onMessageReceived: Event<string>;
67
- /**
68
- * Send a DAP message to the debug adapter
69
- * @param message the JSON-encoded DAP message
70
- */
71
- send(message: string): void;
72
- /**
73
- * An error has occurred communicating with the debug adapter. This does not meant the debug adapter
74
- * has terminated.
75
- */
76
- onError: Event<Error>;
77
- /**
78
- * The connection to the debug adapter has been lost. This signals the end of life for this
79
- * debug adapter instance.
80
- */
81
- onClose: Event<void>;
82
- /**
83
- * Terminate the connection to the debug adapter.
84
- */
85
- stop(): Promise<void>;
86
- }
87
- /**
88
- * DebugAdapterFactory symbol for DI.
89
- */
90
- export declare const DebugAdapterFactory: unique symbol;
91
- /**
92
- * Factory to start debug adapter.
93
- */
94
- export interface DebugAdapterFactory {
95
- start(executable: DebugAdapterExecutable): DebugAdapter;
96
- connect(debugServerPort: number): DebugAdapter;
97
- }
98
- /**
99
- * DebugAdapterContribution symbol for DI.
100
- */
101
- export declare const DebugAdapterContribution: unique symbol;
102
- /**
103
- * A contribution point for debug adapters.
104
- */
105
- export interface DebugAdapterContribution {
106
- /**
107
- * The debug type. Should be a unique value among all debug adapters.
108
- */
109
- readonly type: string;
110
- readonly label?: MaybePromise<string | undefined>;
111
- readonly languages?: MaybePromise<string[] | undefined>;
112
- /**
113
- * The [debug adapter session](#DebugAdapterSession) factory.
114
- * If a default implementation of the debug adapter session does not
115
- * fit all needs it is possible to provide its own implementation using
116
- * this factory. But it is strongly recommended to extend the default
117
- * implementation if so.
118
- */
119
- debugAdapterSessionFactory?: DebugAdapterSessionFactory;
120
- /**
121
- * @returns The contributed configuration schema for this debug type.
122
- */
123
- getSchemaAttributes?(): MaybePromise<IJSONSchema[]>;
124
- getConfigurationSnippets?(): MaybePromise<IJSONSchemaSnippet[]>;
125
- /**
126
- * Provides a [debug adapter executable](#DebugAdapterExecutable)
127
- * based on [debug configuration](#DebugConfiguration) to launch a new debug adapter
128
- * or to connect to existed one.
129
- * @param config The resolved [debug configuration](#DebugConfiguration).
130
- * @returns The [debug adapter executable](#DebugAdapterExecutable).
131
- */
132
- provideDebugAdapterExecutable?(config: DebugConfiguration): MaybePromise<DebugAdapterExecutable | undefined>;
133
- /**
134
- * Provides initial [debug configuration](#DebugConfiguration).
135
- * @returns An array of [debug configurations](#DebugConfiguration).
136
- */
137
- provideDebugConfigurations?(workspaceFolderUri?: string): MaybePromise<DebugConfiguration[]>;
138
- /**
139
- * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
140
- * or by adding/changing/removing attributes before variable substitution.
141
- * @param config The [debug configuration](#DebugConfiguration) to resolve.
142
- * @returns The resolved debug configuration.
143
- */
144
- resolveDebugConfiguration?(config: DebugConfiguration, workspaceFolderUri?: string): MaybePromise<DebugConfiguration | undefined>;
145
- /**
146
- * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
147
- * or by adding/changing/removing attributes with substituted variables.
148
- * @param config The [debug configuration](#DebugConfiguration) to resolve.
149
- * @returns The resolved debug configuration.
150
- */
151
- resolveDebugConfigurationWithSubstitutedVariables?(config: DebugConfiguration, workspaceFolderUri?: string): MaybePromise<DebugConfiguration | undefined>;
152
- }
1
+ import { DebugConfiguration } from './debug-configuration';
2
+ import { IJSONSchema, IJSONSchemaSnippet } from '@theia/core/lib/common/json-schema';
3
+ import { MaybePromise } from '@theia/core/lib/common/types';
4
+ import { Event } from '@theia/core';
5
+ import { DebugChannel } from './debug-service';
6
+ /**
7
+ * DebugAdapterSession symbol for DI.
8
+ */
9
+ export declare const DebugAdapterSession: unique symbol;
10
+ /**
11
+ * The debug adapter session. The debug adapter session manages the lifecycle of a
12
+ * debug session: the debug session should be discarded if and only if the debug adapter
13
+ * session is stopped.
14
+ */
15
+ export interface DebugAdapterSession {
16
+ id: string;
17
+ parentSession?: DebugAdapterSession;
18
+ start(channel: DebugChannel): Promise<void>;
19
+ stop(): Promise<void>;
20
+ }
21
+ /**
22
+ * DebugAdapterSessionFactory symbol for DI.
23
+ */
24
+ export declare const DebugAdapterSessionFactory: unique symbol;
25
+ /**
26
+ * The [debug session](#DebugSession) factory.
27
+ */
28
+ export interface DebugAdapterSessionFactory {
29
+ get(sessionId: string, debugAdapter: DebugAdapter): DebugAdapterSession;
30
+ }
31
+ /**
32
+ * Debug adapter executable for spawning.
33
+ */
34
+ export interface DebugAdapterSpawnExecutable {
35
+ command: string;
36
+ args?: string[];
37
+ }
38
+ /**
39
+ * Debug adapter executable for forking.
40
+ */
41
+ export interface DebugAdapterForkExecutable {
42
+ modulePath: string;
43
+ execArgv?: string[];
44
+ args?: string[];
45
+ }
46
+ /**
47
+ * Debug adapter executable.
48
+ * Parameters to instantiate the debug adapter.
49
+ *
50
+ * In case of launching adapter the parameters contain a command and arguments. For instance:
51
+ * {'command' : 'COMMAND_TO_LAUNCH_DEBUG_ADAPTER', args : [ { 'arg1', 'arg2' } ] }
52
+ *
53
+ * In case of forking the node process, contain the modulePath to fork. For instance:
54
+ * {'modulePath' : 'NODE_COMMAND_TO_LAUNCH_DEBUG_ADAPTER', args : [ { 'arg1', 'arg2' } ] }
55
+ */
56
+ export declare type DebugAdapterExecutable = DebugAdapterSpawnExecutable | DebugAdapterForkExecutable;
57
+ /**
58
+ * Implementers stand for the various types of debug adapters the system can talk to.
59
+ * Creation of debug adapters is not covered in this interface, but handling communication
60
+ * and the end of life is.
61
+ */
62
+ export interface DebugAdapter {
63
+ /**
64
+ * A DAP protocol message has been received from the debug adapter
65
+ */
66
+ onMessageReceived: Event<string>;
67
+ /**
68
+ * Send a DAP message to the debug adapter
69
+ * @param message the JSON-encoded DAP message
70
+ */
71
+ send(message: string): void;
72
+ /**
73
+ * An error has occurred communicating with the debug adapter. This does not meant the debug adapter
74
+ * has terminated.
75
+ */
76
+ onError: Event<Error>;
77
+ /**
78
+ * The connection to the debug adapter has been lost. This signals the end of life for this
79
+ * debug adapter instance.
80
+ */
81
+ onClose: Event<void>;
82
+ /**
83
+ * Terminate the connection to the debug adapter.
84
+ */
85
+ stop(): Promise<void>;
86
+ }
87
+ /**
88
+ * DebugAdapterFactory symbol for DI.
89
+ */
90
+ export declare const DebugAdapterFactory: unique symbol;
91
+ /**
92
+ * Factory to start debug adapter.
93
+ */
94
+ export interface DebugAdapterFactory {
95
+ start(executable: DebugAdapterExecutable): DebugAdapter;
96
+ connect(debugServerPort: number): DebugAdapter;
97
+ }
98
+ /**
99
+ * DebugAdapterContribution symbol for DI.
100
+ */
101
+ export declare const DebugAdapterContribution: unique symbol;
102
+ /**
103
+ * A contribution point for debug adapters.
104
+ */
105
+ export interface DebugAdapterContribution {
106
+ /**
107
+ * The debug type. Should be a unique value among all debug adapters.
108
+ */
109
+ readonly type: string;
110
+ readonly label?: MaybePromise<string | undefined>;
111
+ readonly languages?: MaybePromise<string[] | undefined>;
112
+ /**
113
+ * The [debug adapter session](#DebugAdapterSession) factory.
114
+ * If a default implementation of the debug adapter session does not
115
+ * fit all needs it is possible to provide its own implementation using
116
+ * this factory. But it is strongly recommended to extend the default
117
+ * implementation if so.
118
+ */
119
+ debugAdapterSessionFactory?: DebugAdapterSessionFactory;
120
+ /**
121
+ * @returns The contributed configuration schema for this debug type.
122
+ */
123
+ getSchemaAttributes?(): MaybePromise<IJSONSchema[]>;
124
+ getConfigurationSnippets?(): MaybePromise<IJSONSchemaSnippet[]>;
125
+ /**
126
+ * Provides a [debug adapter executable](#DebugAdapterExecutable)
127
+ * based on [debug configuration](#DebugConfiguration) to launch a new debug adapter
128
+ * or to connect to existed one.
129
+ * @param config The resolved [debug configuration](#DebugConfiguration).
130
+ * @returns The [debug adapter executable](#DebugAdapterExecutable).
131
+ */
132
+ provideDebugAdapterExecutable?(config: DebugConfiguration): MaybePromise<DebugAdapterExecutable | undefined>;
133
+ /**
134
+ * Provides initial [debug configuration](#DebugConfiguration).
135
+ * @returns An array of [debug configurations](#DebugConfiguration).
136
+ */
137
+ provideDebugConfigurations?(workspaceFolderUri?: string): MaybePromise<DebugConfiguration[]>;
138
+ /**
139
+ * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
140
+ * or by adding/changing/removing attributes before variable substitution.
141
+ * @param config The [debug configuration](#DebugConfiguration) to resolve.
142
+ * @returns The resolved debug configuration.
143
+ */
144
+ resolveDebugConfiguration?(config: DebugConfiguration, workspaceFolderUri?: string): MaybePromise<DebugConfiguration | undefined>;
145
+ /**
146
+ * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
147
+ * or by adding/changing/removing attributes with substituted variables.
148
+ * @param config The [debug configuration](#DebugConfiguration) to resolve.
149
+ * @returns The resolved debug configuration.
150
+ */
151
+ resolveDebugConfigurationWithSubstitutedVariables?(config: DebugConfiguration, workspaceFolderUri?: string): MaybePromise<DebugConfiguration | undefined>;
152
+ }
153
153
  //# sourceMappingURL=debug-model.d.ts.map
@@ -1,36 +1,36 @@
1
- "use strict";
2
- // *****************************************************************************
3
- // Copyright (C) 2018 Red Hat, Inc. and others.
4
- //
5
- // This program and the accompanying materials are made available under the
6
- // terms of the Eclipse Public License v. 2.0 which is available at
7
- // http://www.eclipse.org/legal/epl-2.0.
8
- //
9
- // This Source Code may also be made available under the following Secondary
10
- // Licenses when the conditions for such availability set forth in the Eclipse
11
- // Public License v. 2.0 are satisfied: GNU General Public License, version 2
12
- // with the GNU Classpath Exception which is available at
13
- // https://www.gnu.org/software/classpath/license.html.
14
- //
15
- // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
16
- // *****************************************************************************
17
- Object.defineProperty(exports, "__esModule", { value: true });
18
- exports.DebugAdapterContribution = exports.DebugAdapterFactory = exports.DebugAdapterSessionFactory = exports.DebugAdapterSession = void 0;
19
- // FIXME: break down this file to debug adapter and debug adapter contribution (see Theia file naming conventions)
20
- /**
21
- * DebugAdapterSession symbol for DI.
22
- */
23
- exports.DebugAdapterSession = Symbol('DebugAdapterSession');
24
- /**
25
- * DebugAdapterSessionFactory symbol for DI.
26
- */
27
- exports.DebugAdapterSessionFactory = Symbol('DebugAdapterSessionFactory');
28
- /**
29
- * DebugAdapterFactory symbol for DI.
30
- */
31
- exports.DebugAdapterFactory = Symbol('DebugAdapterFactory');
32
- /**
33
- * DebugAdapterContribution symbol for DI.
34
- */
35
- exports.DebugAdapterContribution = Symbol('DebugAdapterContribution');
1
+ "use strict";
2
+ // *****************************************************************************
3
+ // Copyright (C) 2018 Red Hat, Inc. and others.
4
+ //
5
+ // This program and the accompanying materials are made available under the
6
+ // terms of the Eclipse Public License v. 2.0 which is available at
7
+ // http://www.eclipse.org/legal/epl-2.0.
8
+ //
9
+ // This Source Code may also be made available under the following Secondary
10
+ // Licenses when the conditions for such availability set forth in the Eclipse
11
+ // Public License v. 2.0 are satisfied: GNU General Public License, version 2
12
+ // with the GNU Classpath Exception which is available at
13
+ // https://www.gnu.org/software/classpath/license.html.
14
+ //
15
+ // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
16
+ // *****************************************************************************
17
+ Object.defineProperty(exports, "__esModule", { value: true });
18
+ exports.DebugAdapterContribution = exports.DebugAdapterFactory = exports.DebugAdapterSessionFactory = exports.DebugAdapterSession = void 0;
19
+ // FIXME: break down this file to debug adapter and debug adapter contribution (see Theia file naming conventions)
20
+ /**
21
+ * DebugAdapterSession symbol for DI.
22
+ */
23
+ exports.DebugAdapterSession = Symbol('DebugAdapterSession');
24
+ /**
25
+ * DebugAdapterSessionFactory symbol for DI.
26
+ */
27
+ exports.DebugAdapterSessionFactory = Symbol('DebugAdapterSessionFactory');
28
+ /**
29
+ * DebugAdapterFactory symbol for DI.
30
+ */
31
+ exports.DebugAdapterFactory = Symbol('DebugAdapterFactory');
32
+ /**
33
+ * DebugAdapterContribution symbol for DI.
34
+ */
35
+ exports.DebugAdapterContribution = Symbol('DebugAdapterContribution');
36
36
  //# sourceMappingURL=debug-model.js.map
@@ -1,124 +1,124 @@
1
- import { Channel, Disposable, Event } from '@theia/core';
2
- import { ApplicationError } from '@theia/core/lib/common/application-error';
3
- import { IJSONSchema, IJSONSchemaSnippet } from '@theia/core/lib/common/json-schema';
4
- import { CommandIdVariables } from '@theia/variable-resolver/lib/common/variable-types';
5
- import { DebugConfiguration } from './debug-configuration';
6
- export interface DebuggerDescription {
7
- type: string;
8
- label: string;
9
- }
10
- /**
11
- * The WS endpoint path to the Debug service.
12
- */
13
- export declare const DebugPath = "/services/debug";
14
- /**
15
- * DebugService symbol for DI.
16
- */
17
- export declare const DebugService: unique symbol;
18
- /**
19
- * This service provides functionality to configure and to start a new debug adapter session.
20
- * The workflow is the following. If user wants to debug an application and
21
- * there is no debug configuration associated with the application then
22
- * the list of available providers is requested to create suitable debug configuration.
23
- * When configuration is chosen it is possible to alter the configuration
24
- * by filling in missing values or by adding/changing/removing attributes. For this purpose the
25
- * #resolveDebugConfiguration method is invoked. After that the debug adapter session will be started.
26
- */
27
- export interface DebugService extends Disposable {
28
- onDidChangeDebuggers?: Event<void>;
29
- /**
30
- * Finds and returns an array of registered debug types.
31
- * @returns An array of registered debug types
32
- */
33
- debugTypes(): Promise<string[]>;
34
- getDebuggersForLanguage(language: string): Promise<DebuggerDescription[]>;
35
- /**
36
- * Provide debugger contributed variables
37
- * see "variables" at https://code.visualstudio.com/api/references/contribution-points#contributes.debuggers
38
- */
39
- provideDebuggerVariables(debugType: string): Promise<CommandIdVariables>;
40
- /**
41
- * Provides the schema attributes.
42
- * @param debugType The registered debug type
43
- * @returns An JSON Schema describing the configuration attributes for the given debug type
44
- */
45
- getSchemaAttributes(debugType: string): Promise<IJSONSchema[]>;
46
- getConfigurationSnippets(): Promise<IJSONSchemaSnippet[]>;
47
- /**
48
- * Provides initial [debug configuration](#DebugConfiguration).
49
- * @param debugType The registered debug type
50
- * @returns An array of [debug configurations](#DebugConfiguration)
51
- */
52
- provideDebugConfigurations(debugType: string, workspaceFolderUri: string | undefined): Promise<DebugConfiguration[]>;
53
- /**
54
- * @returns A Record of debug configuration provider types and a corresponding dynamic debug configurations array
55
- */
56
- provideDynamicDebugConfigurations?(): Promise<Record<string, DebugConfiguration[]>>;
57
- /**
58
- * Provides a dynamic debug configuration matching the name and the provider debug type
59
- */
60
- fetchDynamicDebugConfiguration(name: string, type: string): Promise<DebugConfiguration | undefined>;
61
- /**
62
- * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
63
- * or by adding/changing/removing attributes before variable substitution.
64
- * @param debugConfiguration The [debug configuration](#DebugConfiguration) to resolve.
65
- * @returns The resolved debug configuration, undefined or null.
66
- */
67
- resolveDebugConfiguration(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<DebugConfiguration | undefined | null>;
68
- /**
69
- * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
70
- * or by adding/changing/removing attributes with substituted variables.
71
- * @param debugConfiguration The [debug configuration](#DebugConfiguration) to resolve.
72
- * @returns The resolved debug configuration, undefined or null.
73
- */
74
- resolveDebugConfigurationWithSubstitutedVariables(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<DebugConfiguration | undefined | null>;
75
- /**
76
- * Creates a new [debug adapter session](#DebugAdapterSession).
77
- * @param config The resolved [debug configuration](#DebugConfiguration).
78
- * @param workspaceFolderUri The workspace folder for this sessions or undefined when folderless
79
- * @returns The identifier of the created [debug adapter session](#DebugAdapterSession).
80
- */
81
- createDebugSession(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<string>;
82
- /**
83
- * Stop a running session for the given session id.
84
- */
85
- terminateDebugSession(sessionId: string): Promise<void>;
86
- /**
87
- * Event handle to indicate when one or more dynamic debug configuration providers
88
- * have been registered or unregistered.
89
- */
90
- onDidChangeDebugConfigurationProviders: Event<void>;
91
- }
92
- /**
93
- * The endpoint path to the debug adapter session.
94
- */
95
- export declare const DebugAdapterPath = "/services/debug-adapter";
96
- export declare namespace DebugError {
97
- const NotFound: ApplicationError.Constructor<-41000, {
98
- type: string;
99
- }>;
100
- }
101
- /**
102
- * A closeable channel to send debug protocol messages over with error/close handling
103
- */
104
- export interface DebugChannel {
105
- send(content: string): void;
106
- onMessage(cb: (message: string) => void): void;
107
- onError(cb: (reason: unknown) => void): void;
108
- onClose(cb: (code: number, reason: string) => void): void;
109
- close(): void;
110
- }
111
- /**
112
- * A {@link DebugChannel} wrapper implementation that sends and receives messages to/from an underlying {@link Channel}.
113
- */
114
- export declare class ForwardingDebugChannel implements DebugChannel {
115
- private readonly underlyingChannel;
116
- private onMessageEmitter;
117
- constructor(underlyingChannel: Channel);
118
- send(content: string): void;
119
- onMessage(cb: (message: string) => void): void;
120
- onError(cb: (reason: unknown) => void): void;
121
- onClose(cb: (code: number, reason: string) => void): void;
122
- close(): void;
123
- }
1
+ import { Channel, Disposable, Event } from '@theia/core';
2
+ import { ApplicationError } from '@theia/core/lib/common/application-error';
3
+ import { IJSONSchema, IJSONSchemaSnippet } from '@theia/core/lib/common/json-schema';
4
+ import { CommandIdVariables } from '@theia/variable-resolver/lib/common/variable-types';
5
+ import { DebugConfiguration } from './debug-configuration';
6
+ export interface DebuggerDescription {
7
+ type: string;
8
+ label: string;
9
+ }
10
+ /**
11
+ * The WS endpoint path to the Debug service.
12
+ */
13
+ export declare const DebugPath = "/services/debug";
14
+ /**
15
+ * DebugService symbol for DI.
16
+ */
17
+ export declare const DebugService: unique symbol;
18
+ /**
19
+ * This service provides functionality to configure and to start a new debug adapter session.
20
+ * The workflow is the following. If user wants to debug an application and
21
+ * there is no debug configuration associated with the application then
22
+ * the list of available providers is requested to create suitable debug configuration.
23
+ * When configuration is chosen it is possible to alter the configuration
24
+ * by filling in missing values or by adding/changing/removing attributes. For this purpose the
25
+ * #resolveDebugConfiguration method is invoked. After that the debug adapter session will be started.
26
+ */
27
+ export interface DebugService extends Disposable {
28
+ onDidChangeDebuggers?: Event<void>;
29
+ /**
30
+ * Finds and returns an array of registered debug types.
31
+ * @returns An array of registered debug types
32
+ */
33
+ debugTypes(): Promise<string[]>;
34
+ getDebuggersForLanguage(language: string): Promise<DebuggerDescription[]>;
35
+ /**
36
+ * Provide debugger contributed variables
37
+ * see "variables" at https://code.visualstudio.com/api/references/contribution-points#contributes.debuggers
38
+ */
39
+ provideDebuggerVariables(debugType: string): Promise<CommandIdVariables>;
40
+ /**
41
+ * Provides the schema attributes.
42
+ * @param debugType The registered debug type
43
+ * @returns An JSON Schema describing the configuration attributes for the given debug type
44
+ */
45
+ getSchemaAttributes(debugType: string): Promise<IJSONSchema[]>;
46
+ getConfigurationSnippets(): Promise<IJSONSchemaSnippet[]>;
47
+ /**
48
+ * Provides initial [debug configuration](#DebugConfiguration).
49
+ * @param debugType The registered debug type
50
+ * @returns An array of [debug configurations](#DebugConfiguration)
51
+ */
52
+ provideDebugConfigurations(debugType: string, workspaceFolderUri: string | undefined): Promise<DebugConfiguration[]>;
53
+ /**
54
+ * @returns A Record of debug configuration provider types and a corresponding dynamic debug configurations array
55
+ */
56
+ provideDynamicDebugConfigurations?(): Promise<Record<string, DebugConfiguration[]>>;
57
+ /**
58
+ * Provides a dynamic debug configuration matching the name and the provider debug type
59
+ */
60
+ fetchDynamicDebugConfiguration(name: string, type: string): Promise<DebugConfiguration | undefined>;
61
+ /**
62
+ * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
63
+ * or by adding/changing/removing attributes before variable substitution.
64
+ * @param debugConfiguration The [debug configuration](#DebugConfiguration) to resolve.
65
+ * @returns The resolved debug configuration, undefined or null.
66
+ */
67
+ resolveDebugConfiguration(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<DebugConfiguration | undefined | null>;
68
+ /**
69
+ * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
70
+ * or by adding/changing/removing attributes with substituted variables.
71
+ * @param debugConfiguration The [debug configuration](#DebugConfiguration) to resolve.
72
+ * @returns The resolved debug configuration, undefined or null.
73
+ */
74
+ resolveDebugConfigurationWithSubstitutedVariables(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<DebugConfiguration | undefined | null>;
75
+ /**
76
+ * Creates a new [debug adapter session](#DebugAdapterSession).
77
+ * @param config The resolved [debug configuration](#DebugConfiguration).
78
+ * @param workspaceFolderUri The workspace folder for this sessions or undefined when folderless
79
+ * @returns The identifier of the created [debug adapter session](#DebugAdapterSession).
80
+ */
81
+ createDebugSession(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<string>;
82
+ /**
83
+ * Stop a running session for the given session id.
84
+ */
85
+ terminateDebugSession(sessionId: string): Promise<void>;
86
+ /**
87
+ * Event handle to indicate when one or more dynamic debug configuration providers
88
+ * have been registered or unregistered.
89
+ */
90
+ onDidChangeDebugConfigurationProviders: Event<void>;
91
+ }
92
+ /**
93
+ * The endpoint path to the debug adapter session.
94
+ */
95
+ export declare const DebugAdapterPath = "/services/debug-adapter";
96
+ export declare namespace DebugError {
97
+ const NotFound: ApplicationError.Constructor<-41000, {
98
+ type: string;
99
+ }>;
100
+ }
101
+ /**
102
+ * A closeable channel to send debug protocol messages over with error/close handling
103
+ */
104
+ export interface DebugChannel {
105
+ send(content: string): void;
106
+ onMessage(cb: (message: string) => void): void;
107
+ onError(cb: (reason: unknown) => void): void;
108
+ onClose(cb: (code: number, reason: string) => void): void;
109
+ close(): void;
110
+ }
111
+ /**
112
+ * A {@link DebugChannel} wrapper implementation that sends and receives messages to/from an underlying {@link Channel}.
113
+ */
114
+ export declare class ForwardingDebugChannel implements DebugChannel {
115
+ private readonly underlyingChannel;
116
+ private onMessageEmitter;
117
+ constructor(underlyingChannel: Channel);
118
+ send(content: string): void;
119
+ onMessage(cb: (message: string) => void): void;
120
+ onError(cb: (reason: unknown) => void): void;
121
+ onClose(cb: (code: number, reason: string) => void): void;
122
+ close(): void;
123
+ }
124
124
  //# sourceMappingURL=debug-service.d.ts.map