@theia/debug 1.45.0 → 1.46.0-next.72

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 (251) hide show
  1. package/README.md +62 -62
  2. package/lib/browser/breakpoint/breakpoint-manager.d.ts +70 -70
  3. package/lib/browser/breakpoint/breakpoint-manager.js +328 -328
  4. package/lib/browser/breakpoint/breakpoint-marker.d.ts +41 -41
  5. package/lib/browser/breakpoint/breakpoint-marker.js +87 -87
  6. package/lib/browser/console/debug-console-contribution.d.ts +40 -40
  7. package/lib/browser/console/debug-console-contribution.js +231 -231
  8. package/lib/browser/console/debug-console-items.d.ts +93 -93
  9. package/lib/browser/console/debug-console-items.js +319 -319
  10. package/lib/browser/console/debug-console-session.d.ts +31 -31
  11. package/lib/browser/console/debug-console-session.js +199 -199
  12. package/lib/browser/debug-call-stack-item-type-key.d.ts +3 -3
  13. package/lib/browser/debug-call-stack-item-type-key.js +19 -19
  14. package/lib/browser/debug-configuration-manager.d.ts +102 -102
  15. package/lib/browser/debug-configuration-manager.js +552 -552
  16. package/lib/browser/debug-configuration-model.d.ts +29 -29
  17. package/lib/browser/debug-configuration-model.js +79 -79
  18. package/lib/browser/debug-contribution.d.ts +22 -22
  19. package/lib/browser/debug-contribution.js +19 -19
  20. package/lib/browser/debug-frontend-application-contribution.d.ts +222 -222
  21. package/lib/browser/debug-frontend-application-contribution.js +1404 -1404
  22. package/lib/browser/debug-frontend-module.d.ts +4 -4
  23. package/lib/browser/debug-frontend-module.d.ts.map +1 -1
  24. package/lib/browser/debug-frontend-module.js +105 -104
  25. package/lib/browser/debug-frontend-module.js.map +1 -1
  26. package/lib/browser/debug-package.spec.js +18 -18
  27. package/lib/browser/debug-preferences.d.ts +17 -17
  28. package/lib/browser/debug-preferences.js +89 -89
  29. package/lib/browser/debug-prefix-configuration.d.ts +51 -51
  30. package/lib/browser/debug-prefix-configuration.js +208 -208
  31. package/lib/browser/debug-resource.d.ts +14 -14
  32. package/lib/browser/debug-resource.js +65 -65
  33. package/lib/browser/debug-schema-updater.d.ts +15 -15
  34. package/lib/browser/debug-schema-updater.js +168 -168
  35. package/lib/browser/debug-session-connection.d.ts +110 -110
  36. package/lib/browser/debug-session-connection.js +258 -258
  37. package/lib/browser/debug-session-contribution.d.ts +73 -73
  38. package/lib/browser/debug-session-contribution.js +145 -145
  39. package/lib/browser/debug-session-manager.d.ts +137 -137
  40. package/lib/browser/debug-session-manager.js +599 -599
  41. package/lib/browser/debug-session-manager.js.map +1 -1
  42. package/lib/browser/debug-session-options.d.ts +48 -48
  43. package/lib/browser/debug-session-options.js +85 -85
  44. package/lib/browser/debug-session.d.ts +178 -178
  45. package/lib/browser/debug-session.js +871 -871
  46. package/lib/browser/debug-tab-bar-decorator.d.ts +16 -16
  47. package/lib/browser/debug-tab-bar-decorator.js +70 -70
  48. package/lib/browser/debug-watch-manager.d.ts +21 -21
  49. package/lib/browser/debug-watch-manager.js +93 -93
  50. package/lib/browser/disassembly-view/disassembly-view-accessibility-provider.d.ts +6 -6
  51. package/lib/browser/disassembly-view/disassembly-view-accessibility-provider.js +38 -38
  52. package/lib/browser/disassembly-view/disassembly-view-breakpoint-renderer.d.ts +19 -19
  53. package/lib/browser/disassembly-view/disassembly-view-breakpoint-renderer.js +110 -110
  54. package/lib/browser/disassembly-view/disassembly-view-contribution.d.ts +24 -24
  55. package/lib/browser/disassembly-view/disassembly-view-contribution.js +131 -131
  56. package/lib/browser/disassembly-view/disassembly-view-instruction-renderer.d.ts +38 -38
  57. package/lib/browser/disassembly-view/disassembly-view-instruction-renderer.js +222 -222
  58. package/lib/browser/disassembly-view/disassembly-view-instruction-renderer.js.map +1 -1
  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 +453 -452
  65. package/lib/browser/disassembly-view/disassembly-view-widget.js.map +1 -1
  66. package/lib/browser/editor/debug-breakpoint-widget.d.ts +53 -53
  67. package/lib/browser/editor/debug-breakpoint-widget.js +261 -261
  68. package/lib/browser/editor/debug-editor-model.d.ts +91 -93
  69. package/lib/browser/editor/debug-editor-model.d.ts.map +1 -1
  70. package/lib/browser/editor/debug-editor-model.js +515 -516
  71. package/lib/browser/editor/debug-editor-model.js.map +1 -1
  72. package/lib/browser/editor/debug-editor-service.d.ts +35 -35
  73. package/lib/browser/editor/debug-editor-service.js +202 -202
  74. package/lib/browser/editor/debug-editor.d.ts +3 -3
  75. package/lib/browser/editor/debug-editor.js +19 -19
  76. package/lib/browser/editor/debug-exception-widget.d.ts +29 -29
  77. package/lib/browser/editor/debug-exception-widget.js +114 -114
  78. package/lib/browser/editor/debug-expression-provider.d.ts +11 -11
  79. package/lib/browser/editor/debug-expression-provider.js +81 -81
  80. package/lib/browser/editor/debug-hover-source.d.ts +18 -18
  81. package/lib/browser/editor/debug-hover-source.js +117 -117
  82. package/lib/browser/editor/debug-hover-widget.d.ts +47 -47
  83. package/lib/browser/editor/debug-hover-widget.js +276 -276
  84. package/lib/browser/editor/debug-inline-value-decorator.d.ts +19 -21
  85. package/lib/browser/editor/debug-inline-value-decorator.d.ts.map +1 -1
  86. package/lib/browser/editor/debug-inline-value-decorator.js +333 -337
  87. package/lib/browser/editor/debug-inline-value-decorator.js.map +1 -1
  88. package/lib/browser/model/debug-breakpoint.d.ts +47 -47
  89. package/lib/browser/model/debug-breakpoint.js +109 -109
  90. package/lib/browser/model/debug-function-breakpoint.d.ts +18 -18
  91. package/lib/browser/model/debug-function-breakpoint.js +92 -92
  92. package/lib/browser/model/debug-instruction-breakpoint.d.ts +14 -14
  93. package/lib/browser/model/debug-instruction-breakpoint.js +65 -65
  94. package/lib/browser/model/debug-source-breakpoint.d.ts +37 -37
  95. package/lib/browser/model/debug-source-breakpoint.js +217 -217
  96. package/lib/browser/model/debug-source.d.ts +24 -24
  97. package/lib/browser/model/debug-source.js +80 -80
  98. package/lib/browser/model/debug-stack-frame.d.ts +41 -41
  99. package/lib/browser/model/debug-stack-frame.js +150 -150
  100. package/lib/browser/model/debug-thread.d.ts +62 -62
  101. package/lib/browser/model/debug-thread.js +237 -237
  102. package/lib/browser/preferences/launch-preferences.d.ts +4 -4
  103. package/lib/browser/preferences/launch-preferences.js +38 -38
  104. package/lib/browser/view/debug-action.d.ts +16 -16
  105. package/lib/browser/view/debug-action.js +43 -43
  106. package/lib/browser/view/debug-breakpoints-source.d.ts +9 -9
  107. package/lib/browser/view/debug-breakpoints-source.js +70 -70
  108. package/lib/browser/view/debug-breakpoints-widget.d.ts +22 -22
  109. package/lib/browser/view/debug-breakpoints-widget.js +87 -87
  110. package/lib/browser/view/debug-configuration-select.d.ts +64 -64
  111. package/lib/browser/view/debug-configuration-select.js +216 -216
  112. package/lib/browser/view/debug-configuration-widget.d.ts +30 -30
  113. package/lib/browser/view/debug-configuration-widget.js +135 -135
  114. package/lib/browser/view/debug-exception-breakpoint.d.ts +14 -14
  115. package/lib/browser/view/debug-exception-breakpoint.js +61 -61
  116. package/lib/browser/view/debug-session-widget.d.ts +28 -28
  117. package/lib/browser/view/debug-session-widget.js +134 -134
  118. package/lib/browser/view/debug-stack-frames-source.d.ts +17 -17
  119. package/lib/browser/view/debug-stack-frames-source.js +89 -89
  120. package/lib/browser/view/debug-stack-frames-widget.d.ts +24 -24
  121. package/lib/browser/view/debug-stack-frames-widget.js +154 -154
  122. package/lib/browser/view/debug-threads-source.d.ts +8 -8
  123. package/lib/browser/view/debug-threads-source.js +63 -63
  124. package/lib/browser/view/debug-threads-widget.d.ts +26 -26
  125. package/lib/browser/view/debug-threads-widget.js +145 -145
  126. package/lib/browser/view/debug-toolbar-widget.d.ts +34 -34
  127. package/lib/browser/view/debug-toolbar-widget.js +156 -156
  128. package/lib/browser/view/debug-variables-source.d.ts +9 -9
  129. package/lib/browser/view/debug-variables-source.js +60 -60
  130. package/lib/browser/view/debug-variables-widget.d.ts +16 -16
  131. package/lib/browser/view/debug-variables-widget.js +78 -78
  132. package/lib/browser/view/debug-view-model.d.ts +51 -51
  133. package/lib/browser/view/debug-view-model.js +220 -220
  134. package/lib/browser/view/debug-watch-expression.d.ts +30 -30
  135. package/lib/browser/view/debug-watch-expression.js +73 -73
  136. package/lib/browser/view/debug-watch-source.d.ts +9 -9
  137. package/lib/browser/view/debug-watch-source.js +58 -58
  138. package/lib/browser/view/debug-watch-widget.d.ts +16 -16
  139. package/lib/browser/view/debug-watch-widget.js +78 -78
  140. package/lib/browser/view/debug-widget.d.ts +23 -23
  141. package/lib/browser/view/debug-widget.js +108 -108
  142. package/lib/common/debug-adapter-contribution-registry.d.ts +59 -59
  143. package/lib/common/debug-adapter-contribution-registry.js +212 -212
  144. package/lib/common/debug-adapter-session.d.ts +18 -18
  145. package/lib/common/debug-adapter-session.js +78 -78
  146. package/lib/common/debug-common.d.ts +1 -1
  147. package/lib/common/debug-common.js +29 -29
  148. package/lib/common/debug-compound.d.ts +14 -14
  149. package/lib/common/debug-compound.js +27 -27
  150. package/lib/common/debug-configuration.d.ts +70 -70
  151. package/lib/common/debug-configuration.js +31 -31
  152. package/lib/common/debug-model.d.ts +152 -152
  153. package/lib/common/debug-model.js +35 -35
  154. package/lib/common/debug-service.d.ts +123 -123
  155. package/lib/common/debug-service.js +66 -66
  156. package/lib/common/debug-uri-utils.d.ts +23 -23
  157. package/lib/common/debug-uri-utils.js +26 -26
  158. package/lib/common/inline-debug-adapter.d.ts +18 -18
  159. package/lib/common/inline-debug-adapter.js +44 -44
  160. package/lib/node/debug-adapter-factory.d.ts +19 -19
  161. package/lib/node/debug-adapter-factory.js +96 -96
  162. package/lib/node/debug-adapter-session-manager.d.ts +37 -37
  163. package/lib/node/debug-adapter-session-manager.js +111 -111
  164. package/lib/node/debug-backend-module.d.ts +3 -3
  165. package/lib/node/debug-backend-module.js +41 -41
  166. package/lib/node/debug-service-impl.d.ts +30 -30
  167. package/lib/node/debug-service-impl.js +124 -124
  168. package/lib/node/stream-debug-adapter.d.ts +36 -36
  169. package/lib/node/stream-debug-adapter.js +112 -112
  170. package/package.json +16 -16
  171. package/src/browser/breakpoint/breakpoint-manager.ts +369 -369
  172. package/src/browser/breakpoint/breakpoint-marker.ts +104 -104
  173. package/src/browser/console/debug-console-contribution.tsx +240 -240
  174. package/src/browser/console/debug-console-items.tsx +384 -384
  175. package/src/browser/console/debug-console-session.ts +205 -205
  176. package/src/browser/debug-call-stack-item-type-key.ts +20 -20
  177. package/src/browser/debug-configuration-manager.ts +591 -591
  178. package/src/browser/debug-configuration-model.ts +100 -100
  179. package/src/browser/debug-contribution.ts +43 -43
  180. package/src/browser/debug-frontend-application-contribution.ts +1551 -1551
  181. package/src/browser/debug-frontend-module.ts +133 -132
  182. package/src/browser/debug-package.spec.ts +20 -20
  183. package/src/browser/debug-preferences.ts +98 -98
  184. package/src/browser/debug-prefix-configuration.ts +195 -195
  185. package/src/browser/debug-resource.ts +59 -59
  186. package/src/browser/debug-schema-updater.ts +149 -149
  187. package/src/browser/debug-session-connection.ts +357 -357
  188. package/src/browser/debug-session-contribution.ts +150 -150
  189. package/src/browser/debug-session-manager.ts +682 -682
  190. package/src/browser/debug-session-options.ts +114 -114
  191. package/src/browser/debug-session.tsx +947 -947
  192. package/src/browser/debug-tab-bar-decorator.ts +57 -57
  193. package/src/browser/debug-watch-manager.ts +93 -93
  194. package/src/browser/disassembly-view/disassembly-view-accessibility-provider.ts +43 -43
  195. package/src/browser/disassembly-view/disassembly-view-breakpoint-renderer.ts +119 -119
  196. package/src/browser/disassembly-view/disassembly-view-contribution.ts +109 -109
  197. package/src/browser/disassembly-view/disassembly-view-instruction-renderer.ts +245 -245
  198. package/src/browser/disassembly-view/disassembly-view-table-delegate.ts +39 -39
  199. package/src/browser/disassembly-view/disassembly-view-utilities.ts +55 -55
  200. package/src/browser/disassembly-view/disassembly-view-widget.ts +463 -463
  201. package/src/browser/editor/debug-breakpoint-widget.tsx +293 -293
  202. package/src/browser/editor/debug-editor-model.ts +529 -528
  203. package/src/browser/editor/debug-editor-service.ts +192 -192
  204. package/src/browser/editor/debug-editor.ts +20 -20
  205. package/src/browser/editor/debug-exception-widget.tsx +122 -122
  206. package/src/browser/editor/debug-expression-provider.ts +78 -78
  207. package/src/browser/editor/debug-hover-source.tsx +105 -105
  208. package/src/browser/editor/debug-hover-widget.ts +298 -298
  209. package/src/browser/editor/debug-inline-value-decorator.ts +373 -377
  210. package/src/browser/model/debug-breakpoint.tsx +151 -151
  211. package/src/browser/model/debug-function-breakpoint.tsx +101 -101
  212. package/src/browser/model/debug-instruction-breakpoint.tsx +68 -68
  213. package/src/browser/model/debug-source-breakpoint.tsx +237 -237
  214. package/src/browser/model/debug-source.ts +93 -93
  215. package/src/browser/model/debug-stack-frame.tsx +170 -170
  216. package/src/browser/model/debug-thread.tsx +285 -285
  217. package/src/browser/preferences/launch-preferences.ts +38 -38
  218. package/src/browser/style/index.css +453 -453
  219. package/src/browser/view/debug-action.tsx +57 -57
  220. package/src/browser/view/debug-breakpoints-source.tsx +53 -53
  221. package/src/browser/view/debug-breakpoints-widget.ts +71 -71
  222. package/src/browser/view/debug-configuration-select.tsx +269 -269
  223. package/src/browser/view/debug-configuration-widget.tsx +121 -121
  224. package/src/browser/view/debug-exception-breakpoint.tsx +68 -68
  225. package/src/browser/view/debug-session-widget.ts +124 -124
  226. package/src/browser/view/debug-stack-frames-source.tsx +75 -75
  227. package/src/browser/view/debug-stack-frames-widget.ts +135 -135
  228. package/src/browser/view/debug-threads-source.tsx +48 -48
  229. package/src/browser/view/debug-threads-widget.ts +125 -125
  230. package/src/browser/view/debug-toolbar-widget.tsx +145 -145
  231. package/src/browser/view/debug-variables-source.ts +43 -43
  232. package/src/browser/view/debug-variables-widget.ts +61 -61
  233. package/src/browser/view/debug-view-model.ts +230 -230
  234. package/src/browser/view/debug-watch-expression.tsx +88 -88
  235. package/src/browser/view/debug-watch-source.ts +41 -41
  236. package/src/browser/view/debug-watch-widget.ts +61 -61
  237. package/src/browser/view/debug-widget.ts +97 -97
  238. package/src/common/debug-adapter-contribution-registry.ts +206 -206
  239. package/src/common/debug-adapter-session.ts +102 -102
  240. package/src/common/debug-common.ts +19 -19
  241. package/src/common/debug-compound.ts +33 -33
  242. package/src/common/debug-configuration.ts +108 -108
  243. package/src/common/debug-model.ts +200 -200
  244. package/src/common/debug-service.ts +184 -184
  245. package/src/common/debug-uri-utils.ts +24 -24
  246. package/src/common/inline-debug-adapter.ts +47 -47
  247. package/src/node/debug-adapter-factory.ts +107 -107
  248. package/src/node/debug-adapter-session-manager.ts +106 -106
  249. package/src/node/debug-backend-module.ts +57 -57
  250. package/src/node/debug-service-impl.ts +119 -119
  251. package/src/node/stream-debug-adapter.ts +126 -126
package/README.md CHANGED
@@ -1,62 +1,62 @@
1
- <div align='center'>
2
-
3
- <br />
4
-
5
- <img src='https://raw.githubusercontent.com/eclipse-theia/theia/master/logo/theia.svg?sanitize=true' alt='theia-ext-logo' width='100px' />
6
-
7
- <h2>ECLIPSE THEIA - DEBUG EXTENSION</h2>
8
-
9
- <hr />
10
-
11
- </div>
12
-
13
- ## Architecture
14
-
15
- `DebugService` is used to initialize a new `DebugSession`. This service provides functionality to configure and to start a new debug session. The workflow is the following. If user wants to debug an application and there is no debug configuration associated with the application then the list of available debuggers is requested to create a suitable debug configuration. When configuration is chosen it is possible to alter the configuration by filling in missing values or by adding/changing/removing attributes.
16
-
17
- In most cases the default behavior of the `DebugSession` is enough. But it is possible to provide its own implementation. The `DebugSessionFactory` is used for this purpose via `DebugSessionContribution`. Documented model objects are located [here](https://github.com/eclipse-theia/theia/tree/master/packages/debug/src/browser/debug-model.ts)
18
-
19
- ### Debug Session life-cycle API
20
-
21
- `DebugSession` life-cycle is controlled and can be tracked as follows:
22
- * An `onDidPreCreateDebugSession` event indicates that a debug session is going to be created.
23
- * An `onDidCreateDebugSession` event indicates that a debug session has been created.
24
- * An `onDidDestroyDebugSession` event indicates that a debug session has terminated.
25
- * An `onDidChangeActiveDebugSession` event indicates that an active debug session has been changed
26
-
27
- ### Breakpoints API
28
-
29
- `ExtDebugProtocol.AggregatedBreakpoint` is used to handle breakpoints on the client side. It covers all three breakpoint types: `DebugProtocol.SourceBreakpoint`, `DebugProtocol.FunctionBreakpoint` and `ExtDebugProtocol.ExceptionBreakpoint`. It is possible to identify a breakpoint type with help of `DebugUtils`. Notification about added, removed, or changed breakpoints is received via `onDidChangeBreakpoints`.
30
-
31
- ### Server side
32
-
33
- At the back-end we start a debug adapter using `DebugAdapterFactory` and then a `DebugAdapterSession` is instantiated which works as a proxy between client and debug adapter. If a default implementation of the debug adapter session does not fit needs, it is possible to provide its own implementation using `DebugAdapterSessionFactory`. If so, it is recommended to extend the default implementation of the `DebugAdapterSession`. Documented model objects are located [here](https://github.com/eclipse-theia/theia/tree/master/packages/debug/src/node/debug-model.ts)
34
-
35
- `DebugSessionState` accumulates debug adapter events and is used to restore debug session on the client side when page is refreshed.
36
-
37
- ## How to contribute a new debugger
38
-
39
- `DebugAdapterContribution` is a contribution point for all debug adapters to provide and resolve debug configuration.
40
-
41
- ## Additional Information
42
-
43
- - [API documentation for `@theia/debug`](https://eclipse-theia.github.io/theia/docs/next/modules/debug.html)
44
- - [Theia - GitHub](https://github.com/eclipse-theia/theia)
45
- - [Theia - Website](https://theia-ide.org/)
46
- - [Debug Adapter Protocol](https://github.com/Microsoft/vscode-debugadapter-node/blob/master/protocol/src/debugProtocol.ts)
47
- - [VS Code debug API](https://code.visualstudio.com/docs/extensionAPI/api-debugging)
48
- - [Debug adapter example for VS Code](https://code.visualstudio.com/docs/extensions/example-debuggers)
49
-
50
- ## Debug adapter implementations for VS Code
51
- * [Node Debugger](https://github.com/microsoft/vscode-node-debug)
52
- * [Node Debugger 2](https://github.com/microsoft/vscode-node-debug2)
53
- * [Java Debugger](https://github.com/Microsoft/vscode-java-debug)
54
-
55
- ## License
56
-
57
- - [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)
58
- - [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)
59
-
60
- ## Trademark
61
- "Theia" is a trademark of the Eclipse Foundation
62
- https://www.eclipse.org/theia
1
+ <div align='center'>
2
+
3
+ <br />
4
+
5
+ <img src='https://raw.githubusercontent.com/eclipse-theia/theia/master/logo/theia.svg?sanitize=true' alt='theia-ext-logo' width='100px' />
6
+
7
+ <h2>ECLIPSE THEIA - DEBUG EXTENSION</h2>
8
+
9
+ <hr />
10
+
11
+ </div>
12
+
13
+ ## Architecture
14
+
15
+ `DebugService` is used to initialize a new `DebugSession`. This service provides functionality to configure and to start a new debug session. The workflow is the following. If user wants to debug an application and there is no debug configuration associated with the application then the list of available debuggers is requested to create a suitable debug configuration. When configuration is chosen it is possible to alter the configuration by filling in missing values or by adding/changing/removing attributes.
16
+
17
+ In most cases the default behavior of the `DebugSession` is enough. But it is possible to provide its own implementation. The `DebugSessionFactory` is used for this purpose via `DebugSessionContribution`. Documented model objects are located [here](https://github.com/eclipse-theia/theia/tree/master/packages/debug/src/browser/debug-model.ts)
18
+
19
+ ### Debug Session life-cycle API
20
+
21
+ `DebugSession` life-cycle is controlled and can be tracked as follows:
22
+ * An `onDidPreCreateDebugSession` event indicates that a debug session is going to be created.
23
+ * An `onDidCreateDebugSession` event indicates that a debug session has been created.
24
+ * An `onDidDestroyDebugSession` event indicates that a debug session has terminated.
25
+ * An `onDidChangeActiveDebugSession` event indicates that an active debug session has been changed
26
+
27
+ ### Breakpoints API
28
+
29
+ `ExtDebugProtocol.AggregatedBreakpoint` is used to handle breakpoints on the client side. It covers all three breakpoint types: `DebugProtocol.SourceBreakpoint`, `DebugProtocol.FunctionBreakpoint` and `ExtDebugProtocol.ExceptionBreakpoint`. It is possible to identify a breakpoint type with help of `DebugUtils`. Notification about added, removed, or changed breakpoints is received via `onDidChangeBreakpoints`.
30
+
31
+ ### Server side
32
+
33
+ At the back-end we start a debug adapter using `DebugAdapterFactory` and then a `DebugAdapterSession` is instantiated which works as a proxy between client and debug adapter. If a default implementation of the debug adapter session does not fit needs, it is possible to provide its own implementation using `DebugAdapterSessionFactory`. If so, it is recommended to extend the default implementation of the `DebugAdapterSession`. Documented model objects are located [here](https://github.com/eclipse-theia/theia/tree/master/packages/debug/src/node/debug-model.ts)
34
+
35
+ `DebugSessionState` accumulates debug adapter events and is used to restore debug session on the client side when page is refreshed.
36
+
37
+ ## How to contribute a new debugger
38
+
39
+ `DebugAdapterContribution` is a contribution point for all debug adapters to provide and resolve debug configuration.
40
+
41
+ ## Additional Information
42
+
43
+ - [API documentation for `@theia/debug`](https://eclipse-theia.github.io/theia/docs/next/modules/debug.html)
44
+ - [Theia - GitHub](https://github.com/eclipse-theia/theia)
45
+ - [Theia - Website](https://theia-ide.org/)
46
+ - [Debug Adapter Protocol](https://github.com/Microsoft/vscode-debugadapter-node/blob/master/protocol/src/debugProtocol.ts)
47
+ - [VS Code debug API](https://code.visualstudio.com/docs/extensionAPI/api-debugging)
48
+ - [Debug adapter example for VS Code](https://code.visualstudio.com/docs/extensions/example-debuggers)
49
+
50
+ ## Debug adapter implementations for VS Code
51
+ * [Node Debugger](https://github.com/microsoft/vscode-node-debug)
52
+ * [Node Debugger 2](https://github.com/microsoft/vscode-node-debug2)
53
+ * [Java Debugger](https://github.com/Microsoft/vscode-java-debug)
54
+
55
+ ## License
56
+
57
+ - [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)
58
+ - [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)
59
+
60
+ ## Trademark
61
+ "Theia" is a trademark of the Eclipse Foundation
62
+ https://www.eclipse.org/theia
@@ -1,71 +1,71 @@
1
- import { Emitter } from '@theia/core/lib/common';
2
- import { StorageService } from '@theia/core/lib/browser';
3
- import { Marker } from '@theia/markers/lib/common/marker';
4
- import { MarkerManager } from '@theia/markers/lib/browser/marker-manager';
5
- import URI from '@theia/core/lib/common/uri';
6
- import { SourceBreakpoint, ExceptionBreakpoint, FunctionBreakpoint, BaseBreakpoint, InstructionBreakpoint } from './breakpoint-marker';
7
- export interface BreakpointsChangeEvent<T extends BaseBreakpoint> {
8
- uri: URI;
9
- added: T[];
10
- removed: T[];
11
- changed: T[];
12
- }
13
- export declare type SourceBreakpointsChangeEvent = BreakpointsChangeEvent<SourceBreakpoint>;
14
- export declare type FunctionBreakpointsChangeEvent = BreakpointsChangeEvent<FunctionBreakpoint>;
15
- export declare type InstructionBreakpointsChangeEvent = BreakpointsChangeEvent<InstructionBreakpoint>;
16
- export declare class BreakpointManager extends MarkerManager<SourceBreakpoint> {
17
- static EXCEPTION_URI: URI;
18
- static FUNCTION_URI: URI;
19
- static INSTRUCTION_URI: URI;
20
- protected readonly owner = "breakpoint";
21
- protected readonly storage: StorageService;
22
- getKind(): string;
23
- protected readonly onDidChangeBreakpointsEmitter: Emitter<SourceBreakpointsChangeEvent>;
24
- readonly onDidChangeBreakpoints: import("@theia/core/lib/common").Event<SourceBreakpointsChangeEvent>;
25
- protected readonly onDidChangeFunctionBreakpointsEmitter: Emitter<FunctionBreakpointsChangeEvent>;
26
- readonly onDidChangeFunctionBreakpoints: import("@theia/core/lib/common").Event<FunctionBreakpointsChangeEvent>;
27
- protected readonly onDidChangeInstructionBreakpointsEmitter: Emitter<InstructionBreakpointsChangeEvent>;
28
- readonly onDidChangeInstructionBreakpoints: import("@theia/core/lib/common").Event<InstructionBreakpointsChangeEvent>;
29
- setMarkers(uri: URI, owner: string, newMarkers: SourceBreakpoint[]): Marker<SourceBreakpoint>[];
30
- getLineBreakpoints(uri: URI, line: number): SourceBreakpoint[];
31
- getInlineBreakpoint(uri: URI, line: number, column: number): SourceBreakpoint | undefined;
32
- getBreakpoints(uri?: URI): SourceBreakpoint[];
33
- setBreakpoints(uri: URI, breakpoints: SourceBreakpoint[]): void;
34
- addBreakpoint(breakpoint: SourceBreakpoint): boolean;
35
- enableAllBreakpoints(enabled: boolean): void;
36
- protected _breakpointsEnabled: boolean;
37
- get breakpointsEnabled(): boolean;
38
- set breakpointsEnabled(breakpointsEnabled: boolean);
39
- protected readonly exceptionBreakpoints: Map<string, ExceptionBreakpoint>;
40
- getExceptionBreakpoint(filter: string): ExceptionBreakpoint | undefined;
41
- getExceptionBreakpoints(): IterableIterator<ExceptionBreakpoint>;
42
- setExceptionBreakpoints(exceptionBreakpoints: ExceptionBreakpoint[]): void;
43
- toggleExceptionBreakpoint(filter: string): void;
44
- updateExceptionBreakpoint(filter: string, options: Partial<Pick<ExceptionBreakpoint, 'condition' | 'enabled'>>): void;
45
- protected functionBreakpoints: FunctionBreakpoint[];
46
- getFunctionBreakpoints(): FunctionBreakpoint[];
47
- setFunctionBreakpoints(functionBreakpoints: FunctionBreakpoint[]): void;
48
- protected instructionBreakpoints: InstructionBreakpoint[];
49
- getInstructionBreakpoints(): ReadonlyArray<InstructionBreakpoint>;
50
- hasBreakpoints(): boolean;
51
- protected setInstructionBreakpoints(newBreakpoints: InstructionBreakpoint[]): void;
52
- addInstructionBreakpoint(address: string, offset: number, condition?: string, hitCondition?: string): void;
53
- updateInstructionBreakpoint(id: string, options: Partial<Pick<InstructionBreakpoint, 'condition' | 'hitCondition' | 'enabled'>>): void;
54
- removeInstructionBreakpoint(address?: string): void;
55
- clearInstructionBreakpoints(): void;
56
- removeBreakpoints(): void;
57
- load(): Promise<void>;
58
- save(): void;
59
- }
60
- export declare namespace BreakpointManager {
61
- interface Data {
62
- breakpointsEnabled: boolean;
63
- breakpoints: {
64
- [uri: string]: SourceBreakpoint[];
65
- };
66
- exceptionBreakpoints?: ExceptionBreakpoint[];
67
- functionBreakpoints?: FunctionBreakpoint[];
68
- instructionBreakpoints?: InstructionBreakpoint[];
69
- }
70
- }
1
+ import { Emitter } from '@theia/core/lib/common';
2
+ import { StorageService } from '@theia/core/lib/browser';
3
+ import { Marker } from '@theia/markers/lib/common/marker';
4
+ import { MarkerManager } from '@theia/markers/lib/browser/marker-manager';
5
+ import URI from '@theia/core/lib/common/uri';
6
+ import { SourceBreakpoint, ExceptionBreakpoint, FunctionBreakpoint, BaseBreakpoint, InstructionBreakpoint } from './breakpoint-marker';
7
+ export interface BreakpointsChangeEvent<T extends BaseBreakpoint> {
8
+ uri: URI;
9
+ added: T[];
10
+ removed: T[];
11
+ changed: T[];
12
+ }
13
+ export declare type SourceBreakpointsChangeEvent = BreakpointsChangeEvent<SourceBreakpoint>;
14
+ export declare type FunctionBreakpointsChangeEvent = BreakpointsChangeEvent<FunctionBreakpoint>;
15
+ export declare type InstructionBreakpointsChangeEvent = BreakpointsChangeEvent<InstructionBreakpoint>;
16
+ export declare class BreakpointManager extends MarkerManager<SourceBreakpoint> {
17
+ static EXCEPTION_URI: URI;
18
+ static FUNCTION_URI: URI;
19
+ static INSTRUCTION_URI: URI;
20
+ protected readonly owner = "breakpoint";
21
+ protected readonly storage: StorageService;
22
+ getKind(): string;
23
+ protected readonly onDidChangeBreakpointsEmitter: Emitter<SourceBreakpointsChangeEvent>;
24
+ readonly onDidChangeBreakpoints: import("@theia/core/lib/common").Event<SourceBreakpointsChangeEvent>;
25
+ protected readonly onDidChangeFunctionBreakpointsEmitter: Emitter<FunctionBreakpointsChangeEvent>;
26
+ readonly onDidChangeFunctionBreakpoints: import("@theia/core/lib/common").Event<FunctionBreakpointsChangeEvent>;
27
+ protected readonly onDidChangeInstructionBreakpointsEmitter: Emitter<InstructionBreakpointsChangeEvent>;
28
+ readonly onDidChangeInstructionBreakpoints: import("@theia/core/lib/common").Event<InstructionBreakpointsChangeEvent>;
29
+ setMarkers(uri: URI, owner: string, newMarkers: SourceBreakpoint[]): Marker<SourceBreakpoint>[];
30
+ getLineBreakpoints(uri: URI, line: number): SourceBreakpoint[];
31
+ getInlineBreakpoint(uri: URI, line: number, column: number): SourceBreakpoint | undefined;
32
+ getBreakpoints(uri?: URI): SourceBreakpoint[];
33
+ setBreakpoints(uri: URI, breakpoints: SourceBreakpoint[]): void;
34
+ addBreakpoint(breakpoint: SourceBreakpoint): boolean;
35
+ enableAllBreakpoints(enabled: boolean): void;
36
+ protected _breakpointsEnabled: boolean;
37
+ get breakpointsEnabled(): boolean;
38
+ set breakpointsEnabled(breakpointsEnabled: boolean);
39
+ protected readonly exceptionBreakpoints: Map<string, ExceptionBreakpoint>;
40
+ getExceptionBreakpoint(filter: string): ExceptionBreakpoint | undefined;
41
+ getExceptionBreakpoints(): IterableIterator<ExceptionBreakpoint>;
42
+ setExceptionBreakpoints(exceptionBreakpoints: ExceptionBreakpoint[]): void;
43
+ toggleExceptionBreakpoint(filter: string): void;
44
+ updateExceptionBreakpoint(filter: string, options: Partial<Pick<ExceptionBreakpoint, 'condition' | 'enabled'>>): void;
45
+ protected functionBreakpoints: FunctionBreakpoint[];
46
+ getFunctionBreakpoints(): FunctionBreakpoint[];
47
+ setFunctionBreakpoints(functionBreakpoints: FunctionBreakpoint[]): void;
48
+ protected instructionBreakpoints: InstructionBreakpoint[];
49
+ getInstructionBreakpoints(): ReadonlyArray<InstructionBreakpoint>;
50
+ hasBreakpoints(): boolean;
51
+ protected setInstructionBreakpoints(newBreakpoints: InstructionBreakpoint[]): void;
52
+ addInstructionBreakpoint(address: string, offset: number, condition?: string, hitCondition?: string): void;
53
+ updateInstructionBreakpoint(id: string, options: Partial<Pick<InstructionBreakpoint, 'condition' | 'hitCondition' | 'enabled'>>): void;
54
+ removeInstructionBreakpoint(address?: string): void;
55
+ clearInstructionBreakpoints(): void;
56
+ removeBreakpoints(): void;
57
+ load(): Promise<void>;
58
+ save(): void;
59
+ }
60
+ export declare namespace BreakpointManager {
61
+ interface Data {
62
+ breakpointsEnabled: boolean;
63
+ breakpoints: {
64
+ [uri: string]: SourceBreakpoint[];
65
+ };
66
+ exceptionBreakpoints?: ExceptionBreakpoint[];
67
+ functionBreakpoints?: FunctionBreakpoint[];
68
+ instructionBreakpoints?: InstructionBreakpoint[];
69
+ }
70
+ }
71
71
  //# sourceMappingURL=breakpoint-manager.d.ts.map