@theia/memory-inspector 1.29.0-next.50

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 (165) hide show
  1. package/LICENSE +642 -0
  2. package/README.md +71 -0
  3. package/lib/browser/diff-widget/memory-diff-options-widget.d.ts +37 -0
  4. package/lib/browser/diff-widget/memory-diff-options-widget.d.ts.map +1 -0
  5. package/lib/browser/diff-widget/memory-diff-options-widget.js +130 -0
  6. package/lib/browser/diff-widget/memory-diff-options-widget.js.map +1 -0
  7. package/lib/browser/diff-widget/memory-diff-select-widget.d.ts +51 -0
  8. package/lib/browser/diff-widget/memory-diff-select-widget.d.ts.map +1 -0
  9. package/lib/browser/diff-widget/memory-diff-select-widget.js +138 -0
  10. package/lib/browser/diff-widget/memory-diff-select-widget.js.map +1 -0
  11. package/lib/browser/diff-widget/memory-diff-table-widget.d.ts +78 -0
  12. package/lib/browser/diff-widget/memory-diff-table-widget.d.ts.map +1 -0
  13. package/lib/browser/diff-widget/memory-diff-table-widget.js +315 -0
  14. package/lib/browser/diff-widget/memory-diff-table-widget.js.map +1 -0
  15. package/lib/browser/diff-widget/memory-diff-widget-types.d.ts +42 -0
  16. package/lib/browser/diff-widget/memory-diff-widget-types.d.ts.map +1 -0
  17. package/lib/browser/diff-widget/memory-diff-widget-types.js +24 -0
  18. package/lib/browser/diff-widget/memory-diff-widget-types.js.map +1 -0
  19. package/lib/browser/editable-widget/memory-editable-table-widget.d.ts +65 -0
  20. package/lib/browser/editable-widget/memory-editable-table-widget.d.ts.map +1 -0
  21. package/lib/browser/editable-widget/memory-editable-table-widget.js +330 -0
  22. package/lib/browser/editable-widget/memory-editable-table-widget.js.map +1 -0
  23. package/lib/browser/memory-inspector-frontend-contribution.d.ts +47 -0
  24. package/lib/browser/memory-inspector-frontend-contribution.d.ts.map +1 -0
  25. package/lib/browser/memory-inspector-frontend-contribution.js +292 -0
  26. package/lib/browser/memory-inspector-frontend-contribution.js.map +1 -0
  27. package/lib/browser/memory-inspector-frontend-module.d.ts +22 -0
  28. package/lib/browser/memory-inspector-frontend-module.d.ts.map +1 -0
  29. package/lib/browser/memory-inspector-frontend-module.js +88 -0
  30. package/lib/browser/memory-inspector-frontend-module.js.map +1 -0
  31. package/lib/browser/memory-provider/cdt-gdb-memory-provider.d.ts +36 -0
  32. package/lib/browser/memory-provider/cdt-gdb-memory-provider.d.ts.map +1 -0
  33. package/lib/browser/memory-provider/cdt-gdb-memory-provider.js +131 -0
  34. package/lib/browser/memory-provider/cdt-gdb-memory-provider.js.map +1 -0
  35. package/lib/browser/memory-provider/memory-provider-service.d.ts +37 -0
  36. package/lib/browser/memory-provider/memory-provider-service.d.ts.map +1 -0
  37. package/lib/browser/memory-provider/memory-provider-service.js +102 -0
  38. package/lib/browser/memory-provider/memory-provider-service.js.map +1 -0
  39. package/lib/browser/memory-provider/memory-provider.d.ts +66 -0
  40. package/lib/browser/memory-provider/memory-provider.d.ts.map +1 -0
  41. package/lib/browser/memory-provider/memory-provider.js +97 -0
  42. package/lib/browser/memory-provider/memory-provider.js.map +1 -0
  43. package/lib/browser/memory-provider/memory-provider.spec.d.ts +17 -0
  44. package/lib/browser/memory-provider/memory-provider.spec.d.ts.map +1 -0
  45. package/lib/browser/memory-provider/memory-provider.spec.js +24 -0
  46. package/lib/browser/memory-provider/memory-provider.spec.js.map +1 -0
  47. package/lib/browser/memory-widget/memory-options-widget.d.ts +137 -0
  48. package/lib/browser/memory-widget/memory-options-widget.d.ts.map +1 -0
  49. package/lib/browser/memory-widget/memory-options-widget.js +562 -0
  50. package/lib/browser/memory-widget/memory-options-widget.js.map +1 -0
  51. package/lib/browser/memory-widget/memory-table-widget.d.ts +146 -0
  52. package/lib/browser/memory-widget/memory-table-widget.d.ts.map +1 -0
  53. package/lib/browser/memory-widget/memory-table-widget.js +485 -0
  54. package/lib/browser/memory-widget/memory-table-widget.js.map +1 -0
  55. package/lib/browser/memory-widget/memory-widget.d.ts +33 -0
  56. package/lib/browser/memory-widget/memory-widget.d.ts.map +1 -0
  57. package/lib/browser/memory-widget/memory-widget.js +110 -0
  58. package/lib/browser/memory-widget/memory-widget.js.map +1 -0
  59. package/lib/browser/register-widget/register-filter-service.d.ts +43 -0
  60. package/lib/browser/register-widget/register-filter-service.d.ts.map +1 -0
  61. package/lib/browser/register-widget/register-filter-service.js +83 -0
  62. package/lib/browser/register-widget/register-filter-service.js.map +1 -0
  63. package/lib/browser/register-widget/register-options-widget.d.ts +82 -0
  64. package/lib/browser/register-widget/register-options-widget.d.ts.map +1 -0
  65. package/lib/browser/register-widget/register-options-widget.js +344 -0
  66. package/lib/browser/register-widget/register-options-widget.js.map +1 -0
  67. package/lib/browser/register-widget/register-table-widget.d.ts +78 -0
  68. package/lib/browser/register-widget/register-table-widget.d.ts.map +1 -0
  69. package/lib/browser/register-widget/register-table-widget.js +237 -0
  70. package/lib/browser/register-widget/register-table-widget.js.map +1 -0
  71. package/lib/browser/register-widget/register-widget-types.d.ts +30 -0
  72. package/lib/browser/register-widget/register-widget-types.d.ts.map +1 -0
  73. package/lib/browser/register-widget/register-widget-types.js +36 -0
  74. package/lib/browser/register-widget/register-widget-types.js.map +1 -0
  75. package/lib/browser/utils/memory-commands.d.ts +28 -0
  76. package/lib/browser/utils/memory-commands.d.ts.map +1 -0
  77. package/lib/browser/utils/memory-commands.js +68 -0
  78. package/lib/browser/utils/memory-commands.js.map +1 -0
  79. package/lib/browser/utils/memory-hover-renderer.d.ts +34 -0
  80. package/lib/browser/utils/memory-hover-renderer.d.ts.map +1 -0
  81. package/lib/browser/utils/memory-hover-renderer.js +112 -0
  82. package/lib/browser/utils/memory-hover-renderer.js.map +1 -0
  83. package/lib/browser/utils/memory-recents.d.ts +28 -0
  84. package/lib/browser/utils/memory-recents.d.ts.map +1 -0
  85. package/lib/browser/utils/memory-recents.js +53 -0
  86. package/lib/browser/utils/memory-recents.js.map +1 -0
  87. package/lib/browser/utils/memory-widget-components.d.ts +59 -0
  88. package/lib/browser/utils/memory-widget-components.d.ts.map +1 -0
  89. package/lib/browser/utils/memory-widget-components.js +70 -0
  90. package/lib/browser/utils/memory-widget-components.js.map +1 -0
  91. package/lib/browser/utils/memory-widget-manager.d.ts +51 -0
  92. package/lib/browser/utils/memory-widget-manager.d.ts.map +1 -0
  93. package/lib/browser/utils/memory-widget-manager.js +183 -0
  94. package/lib/browser/utils/memory-widget-manager.js.map +1 -0
  95. package/lib/browser/utils/memory-widget-utils.d.ts +114 -0
  96. package/lib/browser/utils/memory-widget-utils.d.ts.map +1 -0
  97. package/lib/browser/utils/memory-widget-utils.js +43 -0
  98. package/lib/browser/utils/memory-widget-utils.js.map +1 -0
  99. package/lib/browser/utils/memory-widget-variable-utils.d.ts +58 -0
  100. package/lib/browser/utils/memory-widget-variable-utils.d.ts.map +1 -0
  101. package/lib/browser/utils/memory-widget-variable-utils.js +144 -0
  102. package/lib/browser/utils/memory-widget-variable-utils.js.map +1 -0
  103. package/lib/browser/utils/multi-select-bar.d.ts +32 -0
  104. package/lib/browser/utils/multi-select-bar.d.ts.map +1 -0
  105. package/lib/browser/utils/multi-select-bar.js +35 -0
  106. package/lib/browser/utils/multi-select-bar.js.map +1 -0
  107. package/lib/browser/wrapper-widgets/memory-dock-panel.d.ts +25 -0
  108. package/lib/browser/wrapper-widgets/memory-dock-panel.d.ts.map +1 -0
  109. package/lib/browser/wrapper-widgets/memory-dock-panel.js +49 -0
  110. package/lib/browser/wrapper-widgets/memory-dock-panel.js.map +1 -0
  111. package/lib/browser/wrapper-widgets/memory-dockpanel-placeholder-widget.d.ts +24 -0
  112. package/lib/browser/wrapper-widgets/memory-dockpanel-placeholder-widget.d.ts.map +1 -0
  113. package/lib/browser/wrapper-widgets/memory-dockpanel-placeholder-widget.js +58 -0
  114. package/lib/browser/wrapper-widgets/memory-dockpanel-placeholder-widget.js.map +1 -0
  115. package/lib/browser/wrapper-widgets/memory-layout-widget.d.ts +51 -0
  116. package/lib/browser/wrapper-widgets/memory-layout-widget.d.ts.map +1 -0
  117. package/lib/browser/wrapper-widgets/memory-layout-widget.js +189 -0
  118. package/lib/browser/wrapper-widgets/memory-layout-widget.js.map +1 -0
  119. package/lib/common/util.d.ts +22 -0
  120. package/lib/common/util.d.ts.map +1 -0
  121. package/lib/common/util.js +31 -0
  122. package/lib/common/util.js.map +1 -0
  123. package/lib/common/utils.spec.d.ts +17 -0
  124. package/lib/common/utils.spec.d.ts.map +1 -0
  125. package/lib/common/utils.spec.js +46 -0
  126. package/lib/common/utils.spec.js.map +1 -0
  127. package/package.json +47 -0
  128. package/src/browser/diff-widget/memory-diff-options-widget.tsx +152 -0
  129. package/src/browser/diff-widget/memory-diff-select-widget.tsx +163 -0
  130. package/src/browser/diff-widget/memory-diff-table-widget.tsx +366 -0
  131. package/src/browser/diff-widget/memory-diff-widget-types.ts +45 -0
  132. package/src/browser/editable-widget/memory-editable-table-widget.tsx +360 -0
  133. package/src/browser/memory-inspector-frontend-contribution.ts +301 -0
  134. package/src/browser/memory-inspector-frontend-module.ts +118 -0
  135. package/src/browser/memory-provider/cdt-gdb-memory-provider.ts +133 -0
  136. package/src/browser/memory-provider/memory-provider-service.ts +86 -0
  137. package/src/browser/memory-provider/memory-provider.spec.ts +23 -0
  138. package/src/browser/memory-provider/memory-provider.ts +119 -0
  139. package/src/browser/memory-widget/memory-options-widget.tsx +738 -0
  140. package/src/browser/memory-widget/memory-table-widget.tsx +621 -0
  141. package/src/browser/memory-widget/memory-widget.ts +110 -0
  142. package/src/browser/register-widget/register-filter-service.ts +77 -0
  143. package/src/browser/register-widget/register-options-widget.tsx +393 -0
  144. package/src/browser/register-widget/register-table-widget.tsx +277 -0
  145. package/src/browser/register-widget/register-widget-types.ts +45 -0
  146. package/src/browser/register-widget/register-widget.css +34 -0
  147. package/src/browser/style/index.css +750 -0
  148. package/src/browser/style/memory-lock.svg +21 -0
  149. package/src/browser/style/memory-view.svg +20 -0
  150. package/src/browser/style/register-lock.svg +29 -0
  151. package/src/browser/style/register-view.svg +28 -0
  152. package/src/browser/utils/memory-commands.ts +76 -0
  153. package/src/browser/utils/memory-hover-renderer.ts +113 -0
  154. package/src/browser/utils/memory-recents.ts +58 -0
  155. package/src/browser/utils/memory-widget-components.tsx +193 -0
  156. package/src/browser/utils/memory-widget-manager.ts +179 -0
  157. package/src/browser/utils/memory-widget-utils.tsx +132 -0
  158. package/src/browser/utils/memory-widget-variable-utils.ts +170 -0
  159. package/src/browser/utils/multi-select-bar.css +62 -0
  160. package/src/browser/utils/multi-select-bar.tsx +75 -0
  161. package/src/browser/wrapper-widgets/memory-dock-panel.ts +51 -0
  162. package/src/browser/wrapper-widgets/memory-dockpanel-placeholder-widget.tsx +38 -0
  163. package/src/browser/wrapper-widgets/memory-layout-widget.tsx +163 -0
  164. package/src/common/util.ts +28 -0
  165. package/src/common/utils.spec.ts +52 -0
@@ -0,0 +1,360 @@
1
+ /********************************************************************************
2
+ * Copyright (C) 2021 Ericsson and others.
3
+ *
4
+ * This program and the accompanying materials are made available under the
5
+ * terms of the Eclipse Public License v. 2.0 which is available at
6
+ * http://www.eclipse.org/legal/epl-2.0.
7
+ *
8
+ * This Source Code may also be made available under the following Secondary
9
+ * Licenses when the conditions for such availability set forth in the Eclipse
10
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
11
+ * with the GNU Classpath Exception which is available at
12
+ * https://www.gnu.org/software/classpath/license.html.
13
+ *
14
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
15
+ ********************************************************************************/
16
+
17
+ import { Key, KeyCode } from '@theia/core/lib/browser';
18
+ import { Deferred } from '@theia/core/lib/common/promise-util';
19
+ import { injectable, postConstruct } from '@theia/core/shared/inversify';
20
+ import * as React from '@theia/core/shared/react';
21
+ import * as Long from 'long';
22
+ import { DebugProtocol } from '@vscode/debugprotocol';
23
+ import { hexStrToUnsignedLong } from '../../common/util';
24
+ import { MemoryOptionsWidget } from '../memory-widget/memory-options-widget';
25
+ import { MemoryTable, MemoryTableWidget } from '../memory-widget/memory-table-widget';
26
+ import { MemoryWidget } from '../memory-widget/memory-widget';
27
+ import { EasilyMappedObject } from '../utils/memory-hover-renderer';
28
+ import { Constants, Interfaces } from '../utils/memory-widget-utils';
29
+ import { nls } from '@theia/core/lib/common/nls';
30
+
31
+ export type EditableMemoryWidget = MemoryWidget<MemoryOptionsWidget, MemoryEditableTableWidget>;
32
+ export namespace EditableMemoryWidget {
33
+ export const ID = 'editable.memory.widget';
34
+ }
35
+
36
+ @injectable()
37
+ export class MemoryEditableTableWidget extends MemoryTableWidget {
38
+ protected pendingMemoryEdits = new Map<string, string>();
39
+ protected override previousBytes: Interfaces.LabeledUint8Array | undefined;
40
+ protected memoryEditsCompleted = new Deferred<void>();
41
+ protected highlightedField: Long = Long.fromInt(-1);
42
+ protected writeErrorInfo: { location: string, error: string } | undefined;
43
+ protected currentErrorTimeout: number | undefined;
44
+
45
+ protected doShowMoreMemoryBefore = false;
46
+ protected doShowMoreMemoryAfter = false;
47
+
48
+ @postConstruct()
49
+ protected override async init(): Promise<void> {
50
+ this.memoryEditsCompleted.resolve();
51
+ await super.init();
52
+ this.addClass('editable');
53
+ }
54
+
55
+ resetModifiedValue(valueAddress: Long): void {
56
+ const didChange = this.pendingMemoryEdits.delete(valueAddress.toString());
57
+ if (didChange) {
58
+ this.update();
59
+ }
60
+ }
61
+
62
+ protected override getState(): void {
63
+ super.getState();
64
+ if (!this.isInBounds(this.highlightedField)) {
65
+ this.highlightedField = this.memory.address;
66
+ }
67
+ }
68
+
69
+ protected override async handleMemoryChange(newMemory: Interfaces.MemoryReadResult): Promise<void> {
70
+ await this.memoryEditsCompleted.promise;
71
+ if (newMemory.bytes.length === 0) {
72
+ this.pendingMemoryEdits.clear();
73
+ }
74
+ super.handleMemoryChange(newMemory);
75
+ }
76
+
77
+ protected override areSameRegion(a: Interfaces.MemoryReadResult, b?: Interfaces.MemoryReadResult): boolean {
78
+ return b !== undefined && a.address.equals(b.address) && a.bytes.length === b.bytes.length;
79
+ }
80
+
81
+ protected override getTableFooter(): React.ReactNode {
82
+ const showButtons = !!this.pendingMemoryEdits.size && !this.writeErrorInfo;
83
+ return (
84
+ (showButtons || this.writeErrorInfo) && (
85
+ <div className='memory-edit-button-container'>
86
+ {showButtons && <button
87
+ className='theia-button secondary'
88
+ onClick={this.handleClearEditClick}
89
+ type='reset'
90
+ title={nls.localize('theia/memory-inspector/editable/clear', 'Clear Changes')}
91
+ >
92
+ {nls.localize('theia/memory-inspector/editable/clear', 'Clear Changes')}
93
+ </button>}
94
+ {showButtons && <button
95
+ className='theia-button main'
96
+ onClick={this.submitMemoryEdits}
97
+ type='submit'
98
+ title={nls.localize('theia/memory-inspector/editable/apply', 'Apply Changes')}
99
+ >
100
+ {nls.localize('theia/memory-inspector/editable/apply', 'Apply Changes')}
101
+ </button>}
102
+ {!!this.writeErrorInfo && <div className='memory-edit-error'>
103
+ <div className='memory-edit-error-location'>{`Error writing to 0x${Long.fromString(this.writeErrorInfo?.location).toString(16)}`}</div>
104
+ <div className='memory-edit-error-details'>{this.writeErrorInfo?.error}</div>
105
+ </div>}
106
+ </div>)
107
+ );
108
+ }
109
+
110
+ protected override getBitAttributes(arrayOffset: number, iteratee: Interfaces.LabeledUint8Array): Partial<Interfaces.FullNodeAttributes> {
111
+ const attributes = super.getBitAttributes(arrayOffset, iteratee);
112
+ const classNames = attributes.className?.split(' ') ?? [];
113
+ const itemID = this.memory.address.add(arrayOffset);
114
+ const isHighlight = itemID.equals(this.highlightedField);
115
+ const isEditPending = this.pendingMemoryEdits.has(itemID.toString());
116
+ const padder = isHighlight && isEditPending ? '\xa0' : '0'; // non-breaking space so it doesn't look like plain whitespace.
117
+ const stringValue = (this.pendingMemoryEdits.get(itemID.toString()) ?? this.memory.bytes[arrayOffset].toString(16)).padStart(2, padder);
118
+ if (!this.options.isFrozen) {
119
+ if (isHighlight) {
120
+ classNames.push('highlight');
121
+ }
122
+ if (isEditPending) {
123
+ classNames.push('modified');
124
+ }
125
+ }
126
+ return {
127
+ ...attributes,
128
+ className: classNames.join(' '),
129
+ content: stringValue
130
+ };
131
+ }
132
+
133
+ protected override getHoverForChunk(span: HTMLElement): EasilyMappedObject | undefined {
134
+ const addressAsString = span.getAttribute('data-id');
135
+ if (addressAsString) {
136
+ const address = hexStrToUnsignedLong(addressAsString);
137
+ const { value } = this.composeByte(address, true);
138
+ const { value: inMemory } = this.composeByte(address, false);
139
+ const oldValue = this.previousBytes && this.composeByte(address, false, this.previousBytes).value;
140
+ const decimal = parseInt(value, 16);
141
+ const octal = decimal.toString(8).padStart(this.options.byteSize / 8, '0');
142
+ const UTF8 = String.fromCharCode(decimal);
143
+ const binary = this.getPaddedBinary(decimal);
144
+ const toSend: EasilyMappedObject = { hex: value, octal, binary, decimal };
145
+ if (UTF8) {
146
+ toSend.UTF8 = UTF8;
147
+ }
148
+ if (inMemory !== value) {
149
+ toSend['Current Value'] = inMemory;
150
+ }
151
+ if (oldValue !== undefined && oldValue !== value) {
152
+ toSend['Previous Value'] = oldValue;
153
+ }
154
+ return toSend;
155
+ }
156
+ return undefined;
157
+ }
158
+
159
+ protected composeByte(
160
+ addressPlusArrayOffset: Long,
161
+ usePendingEdits: boolean,
162
+ dataSource: Uint8Array = this.memory.bytes,
163
+ ): Interfaces.ByteFromChunkData {
164
+ let value = '';
165
+
166
+ const offset = addressPlusArrayOffset.subtract(this.memory.address);
167
+ const chunksPerByte = this.options.byteSize / 8;
168
+ const startingChunkIndex = offset.subtract(offset.modulo(chunksPerByte));
169
+ const address = this.memory.address.add(startingChunkIndex.divide(chunksPerByte));
170
+ for (let i = 0; i < chunksPerByte; i += 1) {
171
+ const targetOffset = startingChunkIndex.add(i);
172
+ const targetChunk = this.getFromMapOrArray(targetOffset, usePendingEdits, dataSource);
173
+ value += targetChunk.padStart(2, '0');
174
+ }
175
+
176
+ return { address, value };
177
+ }
178
+
179
+ protected getFromMapOrArray(arrayOffset: Long, usePendingEdits: boolean, dataSource: Uint8Array = this.memory.bytes): string {
180
+ let value = usePendingEdits ? this.pendingMemoryEdits.get(arrayOffset.add(this.memory.address).toString()) : undefined;
181
+ if (value === undefined) {
182
+ value = dataSource[arrayOffset.toInt()]?.toString(16) ?? '';
183
+ }
184
+ return value;
185
+ }
186
+
187
+ protected handleClearEditClick = (): void => this.clearEdits();
188
+
189
+ protected clearEdits(address?: Long): void {
190
+ if (typeof address === 'number') {
191
+ this.pendingMemoryEdits.delete(address);
192
+ } else {
193
+ this.pendingMemoryEdits.clear();
194
+ }
195
+ this.update();
196
+ }
197
+
198
+ protected submitMemoryEdits = async (): Promise<void> => {
199
+ this.memoryEditsCompleted = new Deferred();
200
+ let didUpdateMemory = false;
201
+ for (const [key, edit] of this.createUniqueEdits()) {
202
+ try {
203
+ await this.doWriteMemory(edit);
204
+ didUpdateMemory = true;
205
+ this.pendingMemoryEdits.delete(key);
206
+ } catch (e) {
207
+ console.warn('Problem writing memory with arguments', edit, '\n', e);
208
+ const text = e instanceof Error ? e.message : 'Unknown error';
209
+ this.showWriteError(key, text);
210
+ break;
211
+ }
212
+ }
213
+ this.memoryEditsCompleted.resolve();
214
+ if (didUpdateMemory) {
215
+ this.optionsWidget.fetchNewMemory();
216
+ }
217
+ };
218
+
219
+ protected createUniqueEdits(): Array<[string, DebugProtocol.WriteMemoryArguments]> {
220
+ const addressesSubmitted = new Set<string>();
221
+ const edits: Array<[string, DebugProtocol.WriteMemoryArguments]> = [];
222
+ for (const k of this.pendingMemoryEdits.keys()) {
223
+ const address = Long.fromString(k);
224
+ const { address: addressToSend, value: valueToSend } = this.composeByte(address, true);
225
+ const memoryReference = '0x' + addressToSend.toString(16);
226
+ if (!addressesSubmitted.has(memoryReference)) {
227
+ const data = Buffer.from(valueToSend, 'hex').toString('base64');
228
+ edits.push([k, { memoryReference, data }]);
229
+ addressesSubmitted.add(memoryReference);
230
+ }
231
+ }
232
+ return edits;
233
+ }
234
+
235
+ protected doWriteMemory(writeMemoryArgs: DebugProtocol.WriteMemoryArguments): Promise<DebugProtocol.WriteMemoryResponse> {
236
+ return this.memoryProvider.writeMemory(writeMemoryArgs);
237
+ }
238
+
239
+ protected showWriteError(location: string, error: string): void {
240
+ if (this.currentErrorTimeout !== undefined) {
241
+ clearTimeout(this.currentErrorTimeout);
242
+ }
243
+ this.writeErrorInfo = { location, error };
244
+ this.update();
245
+ this.currentErrorTimeout = window.setTimeout(() => this.hideWriteError(), Constants.ERROR_TIMEOUT);
246
+ }
247
+
248
+ protected hideWriteError(): void {
249
+ this.currentErrorTimeout = undefined;
250
+ this.writeErrorInfo = undefined;
251
+ this.update();
252
+ }
253
+
254
+ protected override getWrapperHandlers(): MemoryTable.WrapperHandlers {
255
+ return this.options.isFrozen
256
+ ? super.getWrapperHandlers()
257
+ : {
258
+ onClick: this.handleTableClick,
259
+ onContextMenu: this.handleTableRightClick,
260
+ onKeyDown: this.handleTableInput,
261
+ onMouseMove: this.handleTableMouseMove,
262
+ };
263
+ }
264
+
265
+ protected handleTableClick = (event: React.MouseEvent): void => {
266
+ const target = event.target as HTMLElement;
267
+ if (target.classList?.contains('eight-bits')) {
268
+ this.highlightedField = hexStrToUnsignedLong(target.getAttribute('data-id') ?? '-0x1');
269
+ this.update();
270
+ event.stopPropagation();
271
+ }
272
+ };
273
+
274
+ protected override doHandleTableRightClick(event: React.MouseEvent): void {
275
+ const target = event.target as HTMLElement;
276
+ if (target.classList?.contains('eight-bits')) {
277
+ this.highlightedField = hexStrToUnsignedLong(target.getAttribute('data-id') ?? '-0x1');
278
+ }
279
+ super.doHandleTableRightClick(event);
280
+ }
281
+
282
+ protected handleTableInput = (event: React.KeyboardEvent): void => {
283
+ if (this.highlightedField.lessThan(0)) {
284
+ return;
285
+ }
286
+ const keyCode = KeyCode.createKeyCode(event.nativeEvent).key?.keyCode;
287
+ const initialHighlight = this.highlightedField;
288
+ const initialHighlightIndex = initialHighlight.subtract(this.memory.address);
289
+ if (keyCode === Key.TAB.keyCode) {
290
+ return;
291
+ }
292
+ const arrayElementsPerRow = (this.options.byteSize / 8) * this.options.bytesPerGroup * this.options.groupsPerRow;
293
+ const isAlreadyEdited = this.pendingMemoryEdits.has(this.highlightedField.toString());
294
+ const oldValue = this.pendingMemoryEdits.get(initialHighlight.toString()) ??
295
+ this.memory.bytes[initialHighlightIndex.toInt()].toString(16).padStart(2, '0');
296
+ let possibleNewHighlight = new Long(-1);
297
+ let newValue = oldValue;
298
+ switch (keyCode) {
299
+ case Key.ARROW_DOWN.keyCode:
300
+ possibleNewHighlight = initialHighlight.add(arrayElementsPerRow);
301
+ event.preventDefault();
302
+ event.stopPropagation();
303
+ break;
304
+ case Key.ARROW_UP.keyCode:
305
+ possibleNewHighlight = initialHighlight.greaterThan(arrayElementsPerRow) ? initialHighlight.subtract(arrayElementsPerRow) : possibleNewHighlight;
306
+ event.preventDefault();
307
+ event.stopPropagation();
308
+ break;
309
+ case Key.ARROW_RIGHT.keyCode:
310
+ possibleNewHighlight = initialHighlight.add(1);
311
+ event.preventDefault();
312
+ event.stopPropagation();
313
+ break;
314
+ case Key.ARROW_LEFT.keyCode:
315
+ possibleNewHighlight = initialHighlight.greaterThan(0) ? initialHighlight.subtract(1) : possibleNewHighlight;
316
+ break;
317
+ case Key.BACKSPACE.keyCode:
318
+ newValue = oldValue.slice(0, oldValue.length - 1);
319
+ break;
320
+ case Key.DELETE.keyCode:
321
+ newValue = '';
322
+ break;
323
+ case Key.ENTER.keyCode:
324
+ this.submitMemoryEdits();
325
+ break;
326
+ case Key.ESCAPE.keyCode:
327
+ if (isAlreadyEdited) {
328
+ this.clearEdits(this.highlightedField);
329
+ } else {
330
+ this.clearEdits();
331
+ }
332
+ break;
333
+ default: {
334
+ const keyValue = parseInt(KeyCode.createKeyCode(event.nativeEvent).toString(), 16);
335
+ if (!Number.isNaN(keyValue)) {
336
+ newValue = isAlreadyEdited ? oldValue : '';
337
+ if (newValue.length < 2) {
338
+ newValue += keyValue.toString(16);
339
+ }
340
+ }
341
+ }
342
+ }
343
+ if (this.isInBounds(possibleNewHighlight)) {
344
+ this.highlightedField = possibleNewHighlight;
345
+ }
346
+ const valueWasChanged = newValue !== oldValue;
347
+ if (valueWasChanged) {
348
+ this.pendingMemoryEdits.set(this.highlightedField.toString(), newValue);
349
+ }
350
+ if (valueWasChanged || !this.highlightedField.equals(initialHighlight)) {
351
+ this.update();
352
+ }
353
+ };
354
+
355
+ protected isInBounds(candidateAddress: Long): boolean {
356
+ const { address, bytes } = this.memory;
357
+ return candidateAddress.greaterThanOrEqual(address) &&
358
+ candidateAddress.lessThan(address.add(bytes.length));
359
+ }
360
+ }
@@ -0,0 +1,301 @@
1
+ /********************************************************************************
2
+ * Copyright (C) 2019 Ericsson and others.
3
+ *
4
+ * This program and the accompanying materials are made available under the
5
+ * terms of the Eclipse Public License v. 2.0 which is available at
6
+ * http://www.eclipse.org/legal/epl-2.0.
7
+ *
8
+ * This Source Code may also be made available under the following Secondary
9
+ * Licenses when the conditions for such availability set forth in the Eclipse
10
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
11
+ * with the GNU Classpath Exception which is available at
12
+ * https://www.gnu.org/software/classpath/license.html.
13
+ *
14
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
15
+ ********************************************************************************/
16
+
17
+ import { AbstractViewContribution, FrontendApplicationContribution, Widget } from '@theia/core/lib/browser';
18
+ import { ColorContribution } from '@theia/core/lib/browser/color-application-contribution';
19
+ import { ColorRegistry } from '@theia/core/lib/browser/color-registry';
20
+ import { FrontendApplicationStateService } from '@theia/core/lib/browser/frontend-application-state';
21
+ import { TabBarToolbarContribution, TabBarToolbarRegistry } from '@theia/core/lib/browser/shell/tab-bar-toolbar';
22
+ import { Command, CommandRegistry, MenuModelRegistry } from '@theia/core/lib/common';
23
+ import { Color } from '@theia/core/lib/common/color';
24
+ import { inject, injectable, postConstruct } from '@theia/core/shared/inversify';
25
+ import { DebugScope, DebugVariable } from '@theia/debug/lib/browser/console/debug-console-items';
26
+ import { DebugFrontendApplicationContribution } from '@theia/debug/lib/browser/debug-frontend-application-contribution';
27
+ import { DebugVariablesWidget } from '@theia/debug/lib/browser/view/debug-variables-widget';
28
+ import * as Long from 'long';
29
+ import { MemoryEditableTableWidget } from './editable-widget/memory-editable-table-widget';
30
+ import { MemoryProviderService } from './memory-provider/memory-provider-service';
31
+ import { MemoryTableWidget } from './memory-widget/memory-table-widget';
32
+ import { MemoryWidget } from './memory-widget/memory-widget';
33
+ import { RegisterTableWidget } from './register-widget/register-table-widget';
34
+ import { RegisterWidget } from './register-widget/register-widget-types';
35
+ import {
36
+ CreateNewMemoryViewCommand, CreateNewRegisterViewCommand, FollowPointerDebugCommand, FollowPointerTableCommand, MemoryCommand,
37
+ RegisterSetVariableCommand, ResetModifiedCellCommand, ToggleDiffSelectWidgetVisibilityCommand, ViewVariableInMemoryCommand, ViewVariableInRegisterViewCommand
38
+ } from './utils/memory-commands';
39
+ import { MemoryWidgetManager } from './utils/memory-widget-manager';
40
+ import { VariableRange } from './utils/memory-widget-variable-utils';
41
+ import { MemoryDockPanel } from './wrapper-widgets/memory-dock-panel';
42
+ import { MemoryLayoutWidget } from './wrapper-widgets/memory-layout-widget';
43
+ import { nls } from '@theia/core/lib/common/nls';
44
+
45
+ const ONE_HALF_OPACITY = 0.5;
46
+
47
+ @injectable()
48
+ export class DebugFrontendContribution extends AbstractViewContribution<MemoryLayoutWidget>
49
+ implements FrontendApplicationContribution,
50
+ TabBarToolbarContribution,
51
+ ColorContribution {
52
+ @inject(DebugFrontendApplicationContribution) protected readonly debugContribution: DebugFrontendApplicationContribution;
53
+ @inject(MemoryWidgetManager) protected readonly memoryWidgetManager: MemoryWidgetManager;
54
+ @inject(FrontendApplicationStateService) protected readonly stateService: FrontendApplicationStateService;
55
+ @inject(MemoryProviderService) protected readonly memoryProvider: MemoryProviderService;
56
+
57
+ constructor() {
58
+ super({
59
+ widgetId: MemoryLayoutWidget.ID,
60
+ widgetName: MemoryLayoutWidget.LABEL,
61
+ defaultWidgetOptions: {
62
+ area: 'right',
63
+ },
64
+ toggleCommandId: MemoryCommand.id,
65
+ });
66
+ }
67
+
68
+ @postConstruct()
69
+ init(): void {
70
+ this.stateService.reachedState('initialized_layout').then(() => {
71
+ // Close leftover widgets from previous sessions.
72
+ this.memoryWidgetManager.availableWidgets.forEach(widget => {
73
+ if (!(widget.parent instanceof MemoryDockPanel)) {
74
+ widget.close();
75
+ }
76
+ });
77
+ });
78
+ }
79
+
80
+ async initializeLayout(): Promise<void> {
81
+ await this.openView({ activate: false });
82
+ }
83
+
84
+ override registerCommands(registry: CommandRegistry): void {
85
+ super.registerCommands(registry);
86
+ registry.registerCommand(ViewVariableInMemoryCommand, {
87
+ execute: async () => {
88
+ const { selectedVariable } = this.debugContribution;
89
+ const referenceText = this.memoryProvider.formatVariableReference(selectedVariable);
90
+ if (referenceText) {
91
+ await this.openMemoryWidgetAt(referenceText);
92
+ }
93
+ },
94
+ isVisible: () => {
95
+ const { selectedVariable } = this.debugContribution;
96
+ return Boolean(this.memoryProvider.supportsVariableReferenceSyntax(selectedVariable) && this.memoryProvider.formatVariableReference(selectedVariable));
97
+ },
98
+ });
99
+ registry.registerCommand(ViewVariableInRegisterViewCommand, {
100
+ execute: async () => {
101
+ const name = this.debugContribution.selectedVariable?.name;
102
+ if (name) {
103
+ await this.openRegisterWidgetWithReg(name);
104
+ }
105
+ },
106
+ isVisible: () => {
107
+ let { selectedVariable: currentLevel } = this.debugContribution;
108
+ if (!currentLevel) {
109
+ return false;
110
+ }
111
+ // Make sure it looks like it has a numerical value.
112
+ try { BigInt(currentLevel.value); } catch { return false; }
113
+ while (currentLevel.parent instanceof DebugVariable) {
114
+ currentLevel = currentLevel.parent;
115
+ }
116
+ return currentLevel.parent instanceof DebugScope && currentLevel.parent?.['raw']?.name === 'Registers';
117
+ },
118
+ });
119
+ registry.registerCommand(FollowPointerDebugCommand, {
120
+ isVisible: () => !!this.isPointer(this.debugContribution.selectedVariable?.type),
121
+ isEnabled: () => !!this.isPointer(this.debugContribution.selectedVariable?.type),
122
+ execute: async () => {
123
+ const name = this.debugContribution.selectedVariable?.name;
124
+ if (name) {
125
+ await this.openMemoryWidgetAt(name);
126
+ }
127
+ },
128
+ });
129
+ registry.registerCommand(ResetModifiedCellCommand, {
130
+ isEnabled: (widgetToActOn, address: Long) => Long.isLong(address) && widgetToActOn instanceof MemoryEditableTableWidget,
131
+ isVisible: (widgetToActOn, address: Long) => Long.isLong(address) && widgetToActOn instanceof MemoryEditableTableWidget,
132
+ execute: (widgetToActOn: MemoryEditableTableWidget, address: Long) => widgetToActOn.resetModifiedValue(address),
133
+ });
134
+ registry.registerCommand(FollowPointerTableCommand, {
135
+ isEnabled: (widgetToActOn, address, variable?: VariableRange) => widgetToActOn instanceof MemoryTableWidget &&
136
+ this.isPointer(variable?.type),
137
+ isVisible: (widgetToActOn, address, variable?: VariableRange) => widgetToActOn instanceof MemoryTableWidget &&
138
+ this.isPointer(variable?.type),
139
+ execute: (widgetToActOn: MemoryTableWidget, address, variable: VariableRange) => {
140
+ if (variable?.name) {
141
+ widgetToActOn.optionsWidget.setAddressAndGo(variable.name);
142
+ }
143
+ },
144
+ });
145
+ registry.registerCommand(CreateNewMemoryViewCommand, {
146
+ isEnabled: w => this.withWidget(() => true, w),
147
+ isVisible: w => this.withWidget(() => true, w),
148
+ execute: () => this.memoryWidgetManager.createNewMemoryWidget(),
149
+ });
150
+ registry.registerCommand(CreateNewRegisterViewCommand, {
151
+ isEnabled: w => this.withWidget(() => true, w),
152
+ isVisible: w => this.withWidget(() => true, w),
153
+ execute: () => this.memoryWidgetManager.createNewMemoryWidget('register'),
154
+ });
155
+ registry.registerCommand(RegisterSetVariableCommand, {
156
+ isEnabled: (widgetToActOn, dVar: DebugVariable) => widgetToActOn instanceof RegisterTableWidget &&
157
+ dVar && dVar.supportSetVariable,
158
+ isVisible: (widgetToActOn, dVar: DebugVariable) => widgetToActOn instanceof RegisterTableWidget &&
159
+ dVar && dVar.supportSetVariable,
160
+ execute: (widgetToActOn: RegisterTableWidget, dVar: DebugVariable) => dVar && widgetToActOn.handleSetValue(dVar),
161
+ });
162
+ registry.registerCommand(ToggleDiffSelectWidgetVisibilityCommand, {
163
+ isVisible: widget => this.withWidget(() => this.memoryWidgetManager.canCompare, widget),
164
+ execute: (widget: MemoryLayoutWidget) => {
165
+ widget.toggleComparisonVisibility();
166
+ },
167
+ });
168
+ }
169
+
170
+ protected isPointer(type?: string): boolean {
171
+ return !!type?.includes('*');
172
+ }
173
+
174
+ /**
175
+ * @param {string} addressReference Should be the exact string to be used in the address bar. I.e. it must resolve to an address value.
176
+ */
177
+ protected async openMemoryWidgetAt(addressReference: string): Promise<MemoryWidget> {
178
+ await this.openView({ activate: false });
179
+ const newWidget = await this.memoryWidgetManager.createNewMemoryWidget();
180
+ await this.shell.activateWidget(newWidget.id);
181
+ if (newWidget) {
182
+ newWidget.optionsWidget.setAddressAndGo(addressReference);
183
+ }
184
+ return newWidget;
185
+ }
186
+
187
+ protected async openRegisterWidgetWithReg(name: string): Promise<MemoryWidget> {
188
+ await this.openView({ activate: false });
189
+ const newWidget = await this.memoryWidgetManager.createNewMemoryWidget<RegisterWidget>('register');
190
+ await this.shell.activateWidget(newWidget.id);
191
+ if (newWidget) {
192
+ newWidget.optionsWidget.setRegAndUpdate(name);
193
+ }
194
+ return newWidget;
195
+ }
196
+
197
+ protected withWidget(fn: (widget: MemoryLayoutWidget) => boolean, widget: Widget | undefined = this.tryGetWidget()): boolean {
198
+ if (widget instanceof MemoryLayoutWidget && widget.id === MemoryLayoutWidget.ID) {
199
+ return fn(widget);
200
+ }
201
+ return false;
202
+ }
203
+
204
+ override registerMenus(registry: MenuModelRegistry): void {
205
+ super.registerMenus(registry);
206
+ const registerMenuActions = (menuPath: string[], ...commands: Command[]): void => {
207
+ for (const [index, command] of commands.entries()) {
208
+ registry.registerMenuAction(menuPath, {
209
+ commandId: command.id,
210
+ label: command.label,
211
+ icon: command.iconClass,
212
+ order: String.fromCharCode('a'.charCodeAt(0) + index),
213
+ });
214
+ }
215
+ };
216
+
217
+ registry.registerMenuAction(
218
+ DebugVariablesWidget.WATCH_MENU,
219
+ { commandId: ViewVariableInMemoryCommand.id, label: ViewVariableInMemoryCommand.label },
220
+ );
221
+ registry.registerMenuAction(
222
+ DebugVariablesWidget.WATCH_MENU,
223
+ { commandId: FollowPointerDebugCommand.id, label: FollowPointerDebugCommand.label },
224
+ );
225
+ registry.registerMenuAction(
226
+ DebugVariablesWidget.WATCH_MENU,
227
+ { commandId: ViewVariableInRegisterViewCommand.id, label: ViewVariableInRegisterViewCommand.label },
228
+ );
229
+ registry.registerMenuAction(
230
+ MemoryEditableTableWidget.CONTEXT_MENU,
231
+ { commandId: ResetModifiedCellCommand.id, label: ResetModifiedCellCommand.label },
232
+ );
233
+ registry.registerMenuAction(
234
+ MemoryTableWidget.CONTEXT_MENU,
235
+ { commandId: FollowPointerTableCommand.id, label: FollowPointerTableCommand.label },
236
+ );
237
+ registerMenuActions(
238
+ RegisterTableWidget.CONTEXT_MENU,
239
+ RegisterSetVariableCommand,
240
+ );
241
+ }
242
+
243
+ registerToolbarItems(toolbarRegistry: TabBarToolbarRegistry): void {
244
+ toolbarRegistry.registerItem({
245
+ id: CreateNewMemoryViewCommand.id,
246
+ command: CreateNewMemoryViewCommand.id,
247
+ tooltip: CreateNewMemoryViewCommand.label,
248
+ priority: -2,
249
+ });
250
+ toolbarRegistry.registerItem({
251
+ id: CreateNewRegisterViewCommand.id,
252
+ command: CreateNewRegisterViewCommand.id,
253
+ tooltip: CreateNewRegisterViewCommand.label,
254
+ priority: -1,
255
+ });
256
+ toolbarRegistry.registerItem({
257
+ id: ToggleDiffSelectWidgetVisibilityCommand.id,
258
+ command: ToggleDiffSelectWidgetVisibilityCommand.id,
259
+ tooltip: nls.localize('theia/memory-inspector/toggleComparisonWidgetVisibility', 'Toggle Comparison Widget Visibility'),
260
+ priority: -3,
261
+ onDidChange: this.memoryWidgetManager.onChanged,
262
+ });
263
+ }
264
+
265
+ registerColors(colorRegistry: ColorRegistry): void {
266
+ colorRegistry.register(
267
+ {
268
+ id: 'memoryDiff.removedTextBackground',
269
+ defaults: {
270
+ dark: Color.transparent('diffEditor.removedTextBackground', ONE_HALF_OPACITY),
271
+ light: Color.transparent('diffEditor.removedTextBackground', ONE_HALF_OPACITY),
272
+ },
273
+ description: 'A less opaque diff color for use in the Memory Inspector where various overlays may me in place at once.',
274
+ },
275
+ {
276
+ id: 'memoryDiff.insertedTextBackground',
277
+ defaults: {
278
+ dark: Color.transparent('diffEditor.insertedTextBackground', ONE_HALF_OPACITY),
279
+ light: Color.transparent('diffEditor.insertedTextBackground', ONE_HALF_OPACITY),
280
+ },
281
+ description: 'A less opaque diff color for use in the Memory Inspector where various overlays may me in place at once.',
282
+ },
283
+ {
284
+ id: 'memoryInspector.focusBorder',
285
+ defaults: {
286
+ dark: Color.transparent('focusBorder', ONE_HALF_OPACITY),
287
+ light: Color.transparent('focusBorder', ONE_HALF_OPACITY),
288
+ },
289
+ description: 'A less opaque focus border color for use in the Memory Inspector where several overlays may be in place at once.',
290
+ },
291
+ {
292
+ id: 'memoryInspector.foreground',
293
+ defaults: {
294
+ dark: Color.transparent('editor.foreground', ONE_HALF_OPACITY),
295
+ light: Color.transparent('editor.foreground', ONE_HALF_OPACITY),
296
+ },
297
+ description: 'A less opaque foreground text style for use in the Memory Inspector',
298
+ },
299
+ );
300
+ }
301
+ }