@theia/memory-inspector 1.45.1 → 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 (102) hide show
  1. package/README.md +71 -71
  2. package/lib/browser/diff-widget/memory-diff-options-widget.d.ts +36 -36
  3. package/lib/browser/diff-widget/memory-diff-options-widget.js +132 -132
  4. package/lib/browser/diff-widget/memory-diff-select-widget.d.ts +50 -50
  5. package/lib/browser/diff-widget/memory-diff-select-widget.js +137 -137
  6. package/lib/browser/diff-widget/memory-diff-table-widget.d.ts +77 -77
  7. package/lib/browser/diff-widget/memory-diff-table-widget.js +314 -314
  8. package/lib/browser/diff-widget/memory-diff-widget-types.d.ts +41 -41
  9. package/lib/browser/diff-widget/memory-diff-widget-types.js +23 -23
  10. package/lib/browser/editable-widget/memory-editable-table-widget.d.ts +64 -64
  11. package/lib/browser/editable-widget/memory-editable-table-widget.js +324 -324
  12. package/lib/browser/memory-inspector-frontend-contribution.d.ts +46 -46
  13. package/lib/browser/memory-inspector-frontend-contribution.js +291 -291
  14. package/lib/browser/memory-inspector-frontend-module.d.ts +21 -21
  15. package/lib/browser/memory-inspector-frontend-module.js +87 -87
  16. package/lib/browser/memory-provider/cdt-gdb-memory-provider.d.ts +35 -35
  17. package/lib/browser/memory-provider/cdt-gdb-memory-provider.js +136 -136
  18. package/lib/browser/memory-provider/memory-provider-service.d.ts +36 -36
  19. package/lib/browser/memory-provider/memory-provider-service.js +101 -101
  20. package/lib/browser/memory-provider/memory-provider.d.ts +65 -65
  21. package/lib/browser/memory-provider/memory-provider.js +96 -96
  22. package/lib/browser/memory-provider/memory-provider.spec.d.ts +16 -16
  23. package/lib/browser/memory-provider/memory-provider.spec.js +23 -23
  24. package/lib/browser/memory-widget/memory-options-widget.d.ts +136 -136
  25. package/lib/browser/memory-widget/memory-options-widget.js +564 -564
  26. package/lib/browser/memory-widget/memory-table-widget.d.ts +146 -146
  27. package/lib/browser/memory-widget/memory-table-widget.js +487 -487
  28. package/lib/browser/memory-widget/memory-widget.d.ts +33 -33
  29. package/lib/browser/memory-widget/memory-widget.js +112 -112
  30. package/lib/browser/register-widget/register-filter-service.d.ts +42 -42
  31. package/lib/browser/register-widget/register-filter-service.js +81 -81
  32. package/lib/browser/register-widget/register-options-widget.d.ts +81 -81
  33. package/lib/browser/register-widget/register-options-widget.js +338 -338
  34. package/lib/browser/register-widget/register-table-widget.d.ts +77 -77
  35. package/lib/browser/register-widget/register-table-widget.js +230 -230
  36. package/lib/browser/register-widget/register-widget-types.d.ts +29 -29
  37. package/lib/browser/register-widget/register-widget-types.js +35 -35
  38. package/lib/browser/utils/memory-commands.d.ts +27 -27
  39. package/lib/browser/utils/memory-commands.js +67 -67
  40. package/lib/browser/utils/memory-hover-renderer.d.ts +33 -33
  41. package/lib/browser/utils/memory-hover-renderer.js +111 -111
  42. package/lib/browser/utils/memory-recents.d.ts +27 -27
  43. package/lib/browser/utils/memory-recents.js +52 -52
  44. package/lib/browser/utils/memory-widget-components.d.ts +58 -58
  45. package/lib/browser/utils/memory-widget-components.js +69 -69
  46. package/lib/browser/utils/memory-widget-manager.d.ts +50 -50
  47. package/lib/browser/utils/memory-widget-manager.js +182 -182
  48. package/lib/browser/utils/memory-widget-utils.d.ts +113 -113
  49. package/lib/browser/utils/memory-widget-utils.js +42 -42
  50. package/lib/browser/utils/memory-widget-variable-utils.d.ts +57 -57
  51. package/lib/browser/utils/memory-widget-variable-utils.js +143 -143
  52. package/lib/browser/utils/multi-select-bar.d.ts +31 -31
  53. package/lib/browser/utils/multi-select-bar.js +34 -34
  54. package/lib/browser/wrapper-widgets/memory-dock-panel.d.ts +24 -24
  55. package/lib/browser/wrapper-widgets/memory-dock-panel.js +48 -48
  56. package/lib/browser/wrapper-widgets/memory-dockpanel-placeholder-widget.d.ts +23 -23
  57. package/lib/browser/wrapper-widgets/memory-dockpanel-placeholder-widget.js +57 -57
  58. package/lib/browser/wrapper-widgets/memory-layout-widget.d.ts +51 -51
  59. package/lib/browser/wrapper-widgets/memory-layout-widget.js +191 -191
  60. package/lib/common/util.d.ts +21 -21
  61. package/lib/common/util.js +30 -30
  62. package/lib/common/utils.spec.d.ts +16 -16
  63. package/lib/common/utils.spec.js +45 -45
  64. package/package.json +4 -4
  65. package/src/browser/diff-widget/memory-diff-options-widget.tsx +152 -152
  66. package/src/browser/diff-widget/memory-diff-select-widget.tsx +163 -163
  67. package/src/browser/diff-widget/memory-diff-table-widget.tsx +366 -366
  68. package/src/browser/diff-widget/memory-diff-widget-types.ts +45 -45
  69. package/src/browser/editable-widget/memory-editable-table-widget.tsx +359 -359
  70. package/src/browser/memory-inspector-frontend-contribution.ts +301 -301
  71. package/src/browser/memory-inspector-frontend-module.ts +118 -118
  72. package/src/browser/memory-provider/cdt-gdb-memory-provider.ts +132 -132
  73. package/src/browser/memory-provider/memory-provider-service.ts +86 -86
  74. package/src/browser/memory-provider/memory-provider.spec.ts +23 -23
  75. package/src/browser/memory-provider/memory-provider.ts +119 -119
  76. package/src/browser/memory-widget/memory-options-widget.tsx +738 -738
  77. package/src/browser/memory-widget/memory-table-widget.tsx +625 -625
  78. package/src/browser/memory-widget/memory-widget.ts +114 -114
  79. package/src/browser/register-widget/register-filter-service.ts +76 -76
  80. package/src/browser/register-widget/register-options-widget.tsx +393 -393
  81. package/src/browser/register-widget/register-table-widget.tsx +276 -276
  82. package/src/browser/register-widget/register-widget-types.ts +45 -45
  83. package/src/browser/register-widget/register-widget.css +34 -34
  84. package/src/browser/style/index.css +746 -746
  85. package/src/browser/style/memory-lock.svg +21 -21
  86. package/src/browser/style/memory-view.svg +20 -20
  87. package/src/browser/style/register-lock.svg +29 -29
  88. package/src/browser/style/register-view.svg +28 -28
  89. package/src/browser/utils/memory-commands.ts +76 -76
  90. package/src/browser/utils/memory-hover-renderer.ts +113 -113
  91. package/src/browser/utils/memory-recents.ts +58 -58
  92. package/src/browser/utils/memory-widget-components.tsx +193 -193
  93. package/src/browser/utils/memory-widget-manager.ts +179 -179
  94. package/src/browser/utils/memory-widget-utils.tsx +132 -132
  95. package/src/browser/utils/memory-widget-variable-utils.ts +170 -170
  96. package/src/browser/utils/multi-select-bar.css +61 -61
  97. package/src/browser/utils/multi-select-bar.tsx +75 -75
  98. package/src/browser/wrapper-widgets/memory-dock-panel.ts +51 -51
  99. package/src/browser/wrapper-widgets/memory-dockpanel-placeholder-widget.tsx +38 -38
  100. package/src/browser/wrapper-widgets/memory-layout-widget.tsx +167 -167
  101. package/src/common/util.ts +28 -28
  102. package/src/common/utils.spec.ts +52 -52
@@ -1,366 +1,366 @@
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-only WITH Classpath-exception-2.0
15
- ********************************************************************************/
16
-
17
- import { inject, injectable } from '@theia/core/shared/inversify';
18
- import * as React from '@theia/core/shared/react';
19
- import * as Long from 'long';
20
- import { MemoryTable, MemoryTableWidget } from '../memory-widget/memory-table-widget';
21
- import { MemoryWidget } from '../memory-widget/memory-widget';
22
- import { EasilyMappedObject } from '../utils/memory-hover-renderer';
23
- import { Interfaces, MemoryDiffWidgetData } from '../utils/memory-widget-utils';
24
- import { VariableDecoration, VariableFinder } from '../utils/memory-widget-variable-utils';
25
- import { DiffMemoryOptions, MemoryDiffOptionsWidget } from './memory-diff-options-widget';
26
- import { DiffExtraColumnOptions, DiffLabels, DiffRowOptions, RowData } from './memory-diff-widget-types';
27
-
28
- export type MemoryDiffWidget = MemoryWidget<MemoryDiffOptionsWidget, MemoryDiffTableWidget>;
29
- export namespace MemoryDiffWidget {
30
- export const ID = 'memory.diff.view';
31
- export const is = (widget: MemoryWidget): boolean => widget.optionsWidget instanceof MemoryDiffOptionsWidget;
32
- }
33
-
34
- interface DummyCounts {
35
- leading: number;
36
- trailing: number;
37
- }
38
-
39
- interface OffsetData {
40
- before: DummyCounts;
41
- after: DummyCounts;
42
- }
43
-
44
- @injectable()
45
- export class MemoryDiffTableWidget extends MemoryTableWidget {
46
- @inject(MemoryDiffWidgetData) protected diffData: MemoryDiffWidgetData;
47
- @inject(MemoryDiffOptionsWidget) override readonly optionsWidget: MemoryDiffOptionsWidget;
48
-
49
- protected diffedSpanCounter = 0;
50
- protected beforeVariableFinder: VariableFinder;
51
- protected afterVariableFinder: VariableFinder;
52
- protected isHighContrast = false;
53
- protected override options: DiffMemoryOptions;
54
- protected offsetData: OffsetData;
55
-
56
- updateDiffData(newDiffData: Partial<MemoryDiffWidgetData>): void {
57
- this.optionsWidget.updateDiffData(newDiffData);
58
- this.diffData = { ...this.diffData, ...newDiffData };
59
- this.getStateAndUpdate();
60
- }
61
-
62
- protected override getState(): void {
63
- this.options = this.optionsWidget.options;
64
- this.isHighContrast = this.themeService.getCurrentTheme().type === 'hc';
65
- this.beforeVariableFinder = new VariableFinder(this.diffData.beforeVariables, this.isHighContrast);
66
- this.afterVariableFinder = new VariableFinder(this.diffData.afterVariables, this.isHighContrast);
67
- this.memory = { bytes: this.diffData.beforeBytes, address: new Long(0), variables: this.diffData.beforeVariables };
68
- this.offsetData = this.getOffsetData();
69
- }
70
-
71
- protected getOffsetData(): OffsetData {
72
- const offsetData: OffsetData = {
73
- before: {
74
- leading: this.options.beforeOffset * this.options.byteSize / 8,
75
- trailing: 0,
76
- },
77
- after: {
78
- leading: this.options.afterOffset * this.options.byteSize / 8,
79
- trailing: 0,
80
- },
81
- };
82
- this.setTrailing(offsetData);
83
- return offsetData;
84
- }
85
-
86
- protected setTrailing(offsetData: OffsetData): void {
87
- const totalBeforeLength = this.diffData.beforeBytes.length - offsetData.before.leading;
88
- const totalAfterLength = this.diffData.afterBytes.length - offsetData.after.leading;
89
- const totalDifference = totalBeforeLength - totalAfterLength;
90
- const realDifference = Math.abs(totalDifference);
91
- const beforeShorter = totalDifference < 0;
92
- if (beforeShorter) {
93
- offsetData.before.trailing = realDifference;
94
- } else {
95
- offsetData.after.trailing = realDifference;
96
- }
97
- }
98
- /* eslint-enable no-param-reassign */
99
-
100
- protected override getWrapperClass(): string {
101
- return `${super.getWrapperClass()} diff-table`;
102
- }
103
-
104
- protected override getTableHeaderClass(): string {
105
- return `${super.getTableHeaderClass()} diff-table`;
106
- }
107
-
108
- protected override *renderRows(): IterableIterator<React.ReactNode> {
109
- const bytesPerRow = this.options.bytesPerGroup * this.options.groupsPerRow;
110
- const oldGroupIterator = this.renderGroups(this.diffData.beforeBytes);
111
- const changeGroupIterator = this.renderGroups(this.diffData.afterBytes);
112
- let rowsYielded = 0;
113
- let before = this.getNewRowData();
114
- let after = this.getNewRowData();
115
- let isModified = false;
116
- for (const oldGroup of oldGroupIterator) {
117
- const nextChanged: IteratorResult<MemoryTable.GroupData, undefined> = changeGroupIterator.next();
118
- isModified = isModified || !!oldGroup.isHighlighted;
119
- this.aggregate(before, oldGroup);
120
- this.aggregate(after, nextChanged.value);
121
- if (before.groups.length === this.options.groupsPerRow || oldGroup.index === this.diffData.beforeBytes.length - 1) {
122
- const beforeID = this.diffData.beforeAddress.add(this.options.beforeOffset + (bytesPerRow * rowsYielded));
123
- const afterID = this.diffData.afterAddress.add(this.options.afterOffset + (bytesPerRow * rowsYielded));
124
- const beforeAddress = `0x${beforeID.toString(16)}`;
125
- const afterAddress = `0x${afterID.toString(16)}`;
126
- const doShowDivider = (rowsYielded % 4) === 3;
127
- yield this.renderSingleRow({ beforeAddress, afterAddress, doShowDivider, before, after, isModified });
128
- rowsYielded += 1;
129
- isModified = false;
130
- before = this.getNewRowData();
131
- after = this.getNewRowData();
132
- }
133
- }
134
- }
135
-
136
- protected renderSingleRow(
137
- options: DiffRowOptions,
138
- getRowAttributes: Interfaces.RowDecorator = this.getRowAttributes.bind(this),
139
- ): React.ReactNode {
140
- const { beforeAddress, afterAddress, before, after, isModified, doShowDivider } = options;
141
- const { className } = getRowAttributes({ doShowDivider });
142
- return (
143
- <tr key={beforeAddress} className={className}>
144
- <td className={MemoryTable.ADDRESS_DATA_CLASS}>{beforeAddress}</td>
145
- <td className={this.getDataCellClass('before', isModified)}>{before.groups}</td>
146
- <td className={MemoryTable.ADDRESS_DATA_CLASS}>{afterAddress}</td>
147
- <td className={this.getDataCellClass('after', isModified)}>{after.groups}</td>
148
- {this.getExtraColumn({
149
- variables: before.variables.slice(),
150
- ascii: before.ascii,
151
- afterVariables: after.variables.slice(),
152
- afterAscii: after.ascii,
153
- })}
154
- </tr>
155
- );
156
- }
157
-
158
- protected override getExtraColumn(options: DiffExtraColumnOptions): React.ReactNode[] {
159
- const additionalColumns = [];
160
- if (this.options.columnsDisplayed.variables.doRender) {
161
- additionalColumns.push(this.getDiffedVariables(options));
162
- }
163
- if (this.options.columnsDisplayed.ascii.doRender) {
164
- additionalColumns.push(this.getDiffedAscii(options));
165
- }
166
- return additionalColumns;
167
- }
168
-
169
- protected getDiffedAscii(options: DiffExtraColumnOptions): React.ReactNode {
170
- const { ascii: beforeAscii, afterAscii } = options;
171
- const highContrastClass = this.isHighContrast ? ' hc' : '';
172
- if (beforeAscii === afterAscii) {
173
- return super.getExtraColumn({ ascii: beforeAscii });
174
- }
175
-
176
- const EMPTY_TEXT = {
177
- before: '',
178
- after: '',
179
- };
180
-
181
- let currentText = { ...EMPTY_TEXT };
182
-
183
- const beforeSpans: React.ReactNode[] = [];
184
- const afterSpans: React.ReactNode[] = [];
185
- let lastWasSame = true;
186
-
187
- for (let i = 0; i < beforeAscii.length; i += 1) {
188
- const beforeLetter = beforeAscii[i];
189
- const afterLetter = afterAscii[i];
190
- const thisIsSame = beforeLetter === afterLetter;
191
-
192
- if (thisIsSame !== lastWasSame) {
193
- lastWasSame = thisIsSame;
194
- this.addTextBits(beforeSpans, afterSpans, currentText);
195
- currentText = { ...EMPTY_TEXT };
196
- }
197
- currentText.before += beforeLetter;
198
- currentText.after += afterLetter;
199
- }
200
- this.addTextBits(beforeSpans, afterSpans, currentText);
201
- return (
202
- <td key='ascii' className={MemoryTable.EXTRA_COLUMN_DATA_CLASS}>
203
- <span className={`different t-mv-diffed-ascii before${highContrastClass}`}>{beforeSpans}</span>
204
- <span className={`different t-mv-diffed-ascii after${highContrastClass}`}>{afterSpans}</span>
205
- </td>
206
- );
207
- }
208
-
209
- protected addTextBits(beforeSpans: React.ReactNode[], afterSpans: React.ReactNode[], texts: { before: string; after: string }): void {
210
- const [newBeforeSpans, newAfterSpans] = this.getAsciiSpan(texts);
211
- beforeSpans.push(newBeforeSpans);
212
- afterSpans.push(newAfterSpans);
213
- }
214
-
215
- protected getAsciiSpan({ before, after }: { before: string; after: string }): [React.ReactNode, React.ReactNode] {
216
- if (!before) {
217
- return [undefined, undefined];
218
- }
219
- const differentClass = before === after ? '' : 'different';
220
- const highContrastClass = this.isHighContrast ? ' hc' : '';
221
- // use non-breaking spaces so they show up in the diff.
222
- return [
223
- <span key={before + after + (this.diffedSpanCounter += 1)} className={`before ${differentClass}${highContrastClass}`}>
224
- {before.replace(/ /g, '\xa0')}
225
- </span>,
226
- <span key={before + after + (this.diffedSpanCounter += 1)} className={`after ${differentClass}${highContrastClass}`}>
227
- {after.replace(/ /g, '\xa0')}
228
- </span>,
229
- ];
230
- }
231
-
232
- protected getDiffedVariables(options: DiffExtraColumnOptions): React.ReactNode {
233
- const { variables: beforeVariables, afterVariables } = options;
234
- const variableSpans: React.ReactNode[] = [];
235
-
236
- let areDifferent = false;
237
- for (const beforeVariable of beforeVariables) {
238
- const placeInAfterVariables = afterVariables.findIndex(afterVariable => afterVariable.name === beforeVariable.name);
239
- if (placeInAfterVariables > -1) {
240
- afterVariables.splice(placeInAfterVariables, 1);
241
- variableSpans.push(this.getVariableSpan(beforeVariable, DiffLabels.Before, false));
242
- } else {
243
- areDifferent = true;
244
- variableSpans.push(this.getVariableSpan(beforeVariable, DiffLabels.Before, true));
245
- }
246
- }
247
- for (const afterVariable of afterVariables) {
248
- variableSpans.push(this.getVariableSpan(afterVariable, DiffLabels.After, true));
249
- }
250
-
251
- return <td key='variables' className={`${MemoryTable.EXTRA_COLUMN_DATA_CLASS}${areDifferent ? ' different' : ''}`}>{variableSpans}</td>;
252
- }
253
-
254
- protected getVariableSpan({ name, color }: VariableDecoration, origin: DiffLabels, isChanged: boolean): React.ReactNode {
255
- return (
256
- <span
257
- key={name}
258
- className={`t-mv-variable-label ${origin} ${isChanged ? ' different' : ''}`}
259
- style={{ color }}
260
- >
261
- {name}
262
- </span>
263
- );
264
- }
265
-
266
- protected getDataCellClass(modifier: 'before' | 'after', isModified?: boolean): string {
267
- const highContrastClass = this.isHighContrast ? 'hc' : '';
268
- let base = `${MemoryTable.MEMORY_DATA_CLASS} ${modifier} ${highContrastClass}`;
269
- if (isModified) {
270
- base += ' different';
271
- }
272
- return base;
273
- }
274
-
275
- protected getNewRowData(): RowData {
276
- return {
277
- groups: [],
278
- variables: [],
279
- ascii: '',
280
- };
281
- }
282
-
283
- protected aggregate(container: RowData, newData?: MemoryTable.GroupData): void {
284
- if (newData) {
285
- container.groups.push(newData.node);
286
- container.variables.push(...newData.variables);
287
- container.ascii += newData.ascii;
288
- }
289
- }
290
-
291
- protected override *renderArrayItems(
292
- iteratee: Interfaces.LabeledUint8Array = this.memory.bytes,
293
- getBitAttributes: Interfaces.BitDecorator = this.getBitAttributes.bind(this),
294
- ): IterableIterator<MemoryTable.ItemData> {
295
- let ignoredItems = 0;
296
- const iterateeOffsetData = iteratee.label === DiffLabels.Before ? this.offsetData.before : this.offsetData.after;
297
- for (const item of super.renderArrayItems(iteratee, getBitAttributes)) {
298
- if (ignoredItems < iterateeOffsetData.leading) {
299
- ignoredItems += 1;
300
- continue;
301
- }
302
- yield item;
303
- }
304
- for (let i = 0; i < iterateeOffsetData.trailing; i += 1) {
305
- yield this.getDummySpan(i);
306
- }
307
- }
308
-
309
- protected getDummySpan(key: number): MemoryTable.ItemData {
310
- const node = <span key={key}>{'\xa0'.repeat(2)}</span>;
311
- return {
312
- node,
313
- content: '',
314
- index: -1 * key,
315
- };
316
- }
317
-
318
- protected override getBitAttributes(arrayOffset: number, iteratee: Interfaces.LabeledUint8Array): Partial<Interfaces.FullNodeAttributes> {
319
- const isHighlighted = this.getHighlightStatus(arrayOffset, iteratee);
320
- const content = iteratee[arrayOffset].toString(16).padStart(2, '0');
321
- let className = `${MemoryTable.EIGHT_BIT_SPAN_CLASS} ${iteratee.label ?? ''}`;
322
- const highContrastClass = this.isHighContrast ? 'hc' : '';
323
- if (isHighlighted) {
324
- className += ` different ${highContrastClass}`;
325
- }
326
-
327
- const isBeforeChunk = iteratee.label === DiffLabels.Before;
328
- const baseAddress = isBeforeChunk ? this.diffData.beforeAddress : this.diffData.afterAddress;
329
- const itemAddress = baseAddress.add(arrayOffset * 8 / this.options.byteSize);
330
-
331
- const variable = isBeforeChunk
332
- ? this.beforeVariableFinder.getVariableForAddress(itemAddress)
333
- : this.afterVariableFinder.getVariableForAddress(itemAddress);
334
-
335
- return { className, content, isHighlighted, variable, style: { color: variable?.color } };
336
- }
337
-
338
- protected getHighlightStatus(arrayOffset: number, iteratee: Interfaces.LabeledUint8Array): boolean {
339
- const source = iteratee.label === DiffLabels.Before ? DiffLabels.Before : DiffLabels.After;
340
- const targetArray = source === DiffLabels.Before ? this.diffData.afterBytes : this.diffData.beforeBytes;
341
- const sourceValue = iteratee[arrayOffset];
342
- const targetIndex = this.translateBetweenShiftedArrays(arrayOffset, source);
343
- const targetValue = targetArray[targetIndex];
344
- return sourceValue !== undefined &&
345
- targetValue !== undefined &&
346
- sourceValue !== targetValue;
347
- }
348
-
349
- protected translateBetweenShiftedArrays(sourceIndex: number, source: DiffLabels): number {
350
- const sourceOffsets = source === DiffLabels.Before ? this.offsetData.before : this.offsetData.after;
351
- const targetOffsets = source === DiffLabels.Before ? this.offsetData.after : this.offsetData.before;
352
-
353
- return sourceIndex - sourceOffsets.leading + targetOffsets.leading;
354
- }
355
-
356
- protected override getHoverForVariable(span: HTMLElement): EasilyMappedObject | undefined {
357
- const name = span.textContent ?? '';
358
- const variable = this.beforeVariableFinder.searchForVariable(name) ??
359
- this.afterVariableFinder.searchForVariable(name);
360
-
361
- if (variable?.type) {
362
- return { type: variable.type };
363
- }
364
- return undefined;
365
- }
366
- }
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-only WITH Classpath-exception-2.0
15
+ ********************************************************************************/
16
+
17
+ import { inject, injectable } from '@theia/core/shared/inversify';
18
+ import * as React from '@theia/core/shared/react';
19
+ import * as Long from 'long';
20
+ import { MemoryTable, MemoryTableWidget } from '../memory-widget/memory-table-widget';
21
+ import { MemoryWidget } from '../memory-widget/memory-widget';
22
+ import { EasilyMappedObject } from '../utils/memory-hover-renderer';
23
+ import { Interfaces, MemoryDiffWidgetData } from '../utils/memory-widget-utils';
24
+ import { VariableDecoration, VariableFinder } from '../utils/memory-widget-variable-utils';
25
+ import { DiffMemoryOptions, MemoryDiffOptionsWidget } from './memory-diff-options-widget';
26
+ import { DiffExtraColumnOptions, DiffLabels, DiffRowOptions, RowData } from './memory-diff-widget-types';
27
+
28
+ export type MemoryDiffWidget = MemoryWidget<MemoryDiffOptionsWidget, MemoryDiffTableWidget>;
29
+ export namespace MemoryDiffWidget {
30
+ export const ID = 'memory.diff.view';
31
+ export const is = (widget: MemoryWidget): boolean => widget.optionsWidget instanceof MemoryDiffOptionsWidget;
32
+ }
33
+
34
+ interface DummyCounts {
35
+ leading: number;
36
+ trailing: number;
37
+ }
38
+
39
+ interface OffsetData {
40
+ before: DummyCounts;
41
+ after: DummyCounts;
42
+ }
43
+
44
+ @injectable()
45
+ export class MemoryDiffTableWidget extends MemoryTableWidget {
46
+ @inject(MemoryDiffWidgetData) protected diffData: MemoryDiffWidgetData;
47
+ @inject(MemoryDiffOptionsWidget) override readonly optionsWidget: MemoryDiffOptionsWidget;
48
+
49
+ protected diffedSpanCounter = 0;
50
+ protected beforeVariableFinder: VariableFinder;
51
+ protected afterVariableFinder: VariableFinder;
52
+ protected isHighContrast = false;
53
+ protected override options: DiffMemoryOptions;
54
+ protected offsetData: OffsetData;
55
+
56
+ updateDiffData(newDiffData: Partial<MemoryDiffWidgetData>): void {
57
+ this.optionsWidget.updateDiffData(newDiffData);
58
+ this.diffData = { ...this.diffData, ...newDiffData };
59
+ this.getStateAndUpdate();
60
+ }
61
+
62
+ protected override getState(): void {
63
+ this.options = this.optionsWidget.options;
64
+ this.isHighContrast = this.themeService.getCurrentTheme().type === 'hc';
65
+ this.beforeVariableFinder = new VariableFinder(this.diffData.beforeVariables, this.isHighContrast);
66
+ this.afterVariableFinder = new VariableFinder(this.diffData.afterVariables, this.isHighContrast);
67
+ this.memory = { bytes: this.diffData.beforeBytes, address: new Long(0), variables: this.diffData.beforeVariables };
68
+ this.offsetData = this.getOffsetData();
69
+ }
70
+
71
+ protected getOffsetData(): OffsetData {
72
+ const offsetData: OffsetData = {
73
+ before: {
74
+ leading: this.options.beforeOffset * this.options.byteSize / 8,
75
+ trailing: 0,
76
+ },
77
+ after: {
78
+ leading: this.options.afterOffset * this.options.byteSize / 8,
79
+ trailing: 0,
80
+ },
81
+ };
82
+ this.setTrailing(offsetData);
83
+ return offsetData;
84
+ }
85
+
86
+ protected setTrailing(offsetData: OffsetData): void {
87
+ const totalBeforeLength = this.diffData.beforeBytes.length - offsetData.before.leading;
88
+ const totalAfterLength = this.diffData.afterBytes.length - offsetData.after.leading;
89
+ const totalDifference = totalBeforeLength - totalAfterLength;
90
+ const realDifference = Math.abs(totalDifference);
91
+ const beforeShorter = totalDifference < 0;
92
+ if (beforeShorter) {
93
+ offsetData.before.trailing = realDifference;
94
+ } else {
95
+ offsetData.after.trailing = realDifference;
96
+ }
97
+ }
98
+ /* eslint-enable no-param-reassign */
99
+
100
+ protected override getWrapperClass(): string {
101
+ return `${super.getWrapperClass()} diff-table`;
102
+ }
103
+
104
+ protected override getTableHeaderClass(): string {
105
+ return `${super.getTableHeaderClass()} diff-table`;
106
+ }
107
+
108
+ protected override *renderRows(): IterableIterator<React.ReactNode> {
109
+ const bytesPerRow = this.options.bytesPerGroup * this.options.groupsPerRow;
110
+ const oldGroupIterator = this.renderGroups(this.diffData.beforeBytes);
111
+ const changeGroupIterator = this.renderGroups(this.diffData.afterBytes);
112
+ let rowsYielded = 0;
113
+ let before = this.getNewRowData();
114
+ let after = this.getNewRowData();
115
+ let isModified = false;
116
+ for (const oldGroup of oldGroupIterator) {
117
+ const nextChanged: IteratorResult<MemoryTable.GroupData, undefined> = changeGroupIterator.next();
118
+ isModified = isModified || !!oldGroup.isHighlighted;
119
+ this.aggregate(before, oldGroup);
120
+ this.aggregate(after, nextChanged.value);
121
+ if (before.groups.length === this.options.groupsPerRow || oldGroup.index === this.diffData.beforeBytes.length - 1) {
122
+ const beforeID = this.diffData.beforeAddress.add(this.options.beforeOffset + (bytesPerRow * rowsYielded));
123
+ const afterID = this.diffData.afterAddress.add(this.options.afterOffset + (bytesPerRow * rowsYielded));
124
+ const beforeAddress = `0x${beforeID.toString(16)}`;
125
+ const afterAddress = `0x${afterID.toString(16)}`;
126
+ const doShowDivider = (rowsYielded % 4) === 3;
127
+ yield this.renderSingleRow({ beforeAddress, afterAddress, doShowDivider, before, after, isModified });
128
+ rowsYielded += 1;
129
+ isModified = false;
130
+ before = this.getNewRowData();
131
+ after = this.getNewRowData();
132
+ }
133
+ }
134
+ }
135
+
136
+ protected renderSingleRow(
137
+ options: DiffRowOptions,
138
+ getRowAttributes: Interfaces.RowDecorator = this.getRowAttributes.bind(this),
139
+ ): React.ReactNode {
140
+ const { beforeAddress, afterAddress, before, after, isModified, doShowDivider } = options;
141
+ const { className } = getRowAttributes({ doShowDivider });
142
+ return (
143
+ <tr key={beforeAddress} className={className}>
144
+ <td className={MemoryTable.ADDRESS_DATA_CLASS}>{beforeAddress}</td>
145
+ <td className={this.getDataCellClass('before', isModified)}>{before.groups}</td>
146
+ <td className={MemoryTable.ADDRESS_DATA_CLASS}>{afterAddress}</td>
147
+ <td className={this.getDataCellClass('after', isModified)}>{after.groups}</td>
148
+ {this.getExtraColumn({
149
+ variables: before.variables.slice(),
150
+ ascii: before.ascii,
151
+ afterVariables: after.variables.slice(),
152
+ afterAscii: after.ascii,
153
+ })}
154
+ </tr>
155
+ );
156
+ }
157
+
158
+ protected override getExtraColumn(options: DiffExtraColumnOptions): React.ReactNode[] {
159
+ const additionalColumns = [];
160
+ if (this.options.columnsDisplayed.variables.doRender) {
161
+ additionalColumns.push(this.getDiffedVariables(options));
162
+ }
163
+ if (this.options.columnsDisplayed.ascii.doRender) {
164
+ additionalColumns.push(this.getDiffedAscii(options));
165
+ }
166
+ return additionalColumns;
167
+ }
168
+
169
+ protected getDiffedAscii(options: DiffExtraColumnOptions): React.ReactNode {
170
+ const { ascii: beforeAscii, afterAscii } = options;
171
+ const highContrastClass = this.isHighContrast ? ' hc' : '';
172
+ if (beforeAscii === afterAscii) {
173
+ return super.getExtraColumn({ ascii: beforeAscii });
174
+ }
175
+
176
+ const EMPTY_TEXT = {
177
+ before: '',
178
+ after: '',
179
+ };
180
+
181
+ let currentText = { ...EMPTY_TEXT };
182
+
183
+ const beforeSpans: React.ReactNode[] = [];
184
+ const afterSpans: React.ReactNode[] = [];
185
+ let lastWasSame = true;
186
+
187
+ for (let i = 0; i < beforeAscii.length; i += 1) {
188
+ const beforeLetter = beforeAscii[i];
189
+ const afterLetter = afterAscii[i];
190
+ const thisIsSame = beforeLetter === afterLetter;
191
+
192
+ if (thisIsSame !== lastWasSame) {
193
+ lastWasSame = thisIsSame;
194
+ this.addTextBits(beforeSpans, afterSpans, currentText);
195
+ currentText = { ...EMPTY_TEXT };
196
+ }
197
+ currentText.before += beforeLetter;
198
+ currentText.after += afterLetter;
199
+ }
200
+ this.addTextBits(beforeSpans, afterSpans, currentText);
201
+ return (
202
+ <td key='ascii' className={MemoryTable.EXTRA_COLUMN_DATA_CLASS}>
203
+ <span className={`different t-mv-diffed-ascii before${highContrastClass}`}>{beforeSpans}</span>
204
+ <span className={`different t-mv-diffed-ascii after${highContrastClass}`}>{afterSpans}</span>
205
+ </td>
206
+ );
207
+ }
208
+
209
+ protected addTextBits(beforeSpans: React.ReactNode[], afterSpans: React.ReactNode[], texts: { before: string; after: string }): void {
210
+ const [newBeforeSpans, newAfterSpans] = this.getAsciiSpan(texts);
211
+ beforeSpans.push(newBeforeSpans);
212
+ afterSpans.push(newAfterSpans);
213
+ }
214
+
215
+ protected getAsciiSpan({ before, after }: { before: string; after: string }): [React.ReactNode, React.ReactNode] {
216
+ if (!before) {
217
+ return [undefined, undefined];
218
+ }
219
+ const differentClass = before === after ? '' : 'different';
220
+ const highContrastClass = this.isHighContrast ? ' hc' : '';
221
+ // use non-breaking spaces so they show up in the diff.
222
+ return [
223
+ <span key={before + after + (this.diffedSpanCounter += 1)} className={`before ${differentClass}${highContrastClass}`}>
224
+ {before.replace(/ /g, '\xa0')}
225
+ </span>,
226
+ <span key={before + after + (this.diffedSpanCounter += 1)} className={`after ${differentClass}${highContrastClass}`}>
227
+ {after.replace(/ /g, '\xa0')}
228
+ </span>,
229
+ ];
230
+ }
231
+
232
+ protected getDiffedVariables(options: DiffExtraColumnOptions): React.ReactNode {
233
+ const { variables: beforeVariables, afterVariables } = options;
234
+ const variableSpans: React.ReactNode[] = [];
235
+
236
+ let areDifferent = false;
237
+ for (const beforeVariable of beforeVariables) {
238
+ const placeInAfterVariables = afterVariables.findIndex(afterVariable => afterVariable.name === beforeVariable.name);
239
+ if (placeInAfterVariables > -1) {
240
+ afterVariables.splice(placeInAfterVariables, 1);
241
+ variableSpans.push(this.getVariableSpan(beforeVariable, DiffLabels.Before, false));
242
+ } else {
243
+ areDifferent = true;
244
+ variableSpans.push(this.getVariableSpan(beforeVariable, DiffLabels.Before, true));
245
+ }
246
+ }
247
+ for (const afterVariable of afterVariables) {
248
+ variableSpans.push(this.getVariableSpan(afterVariable, DiffLabels.After, true));
249
+ }
250
+
251
+ return <td key='variables' className={`${MemoryTable.EXTRA_COLUMN_DATA_CLASS}${areDifferent ? ' different' : ''}`}>{variableSpans}</td>;
252
+ }
253
+
254
+ protected getVariableSpan({ name, color }: VariableDecoration, origin: DiffLabels, isChanged: boolean): React.ReactNode {
255
+ return (
256
+ <span
257
+ key={name}
258
+ className={`t-mv-variable-label ${origin} ${isChanged ? ' different' : ''}`}
259
+ style={{ color }}
260
+ >
261
+ {name}
262
+ </span>
263
+ );
264
+ }
265
+
266
+ protected getDataCellClass(modifier: 'before' | 'after', isModified?: boolean): string {
267
+ const highContrastClass = this.isHighContrast ? 'hc' : '';
268
+ let base = `${MemoryTable.MEMORY_DATA_CLASS} ${modifier} ${highContrastClass}`;
269
+ if (isModified) {
270
+ base += ' different';
271
+ }
272
+ return base;
273
+ }
274
+
275
+ protected getNewRowData(): RowData {
276
+ return {
277
+ groups: [],
278
+ variables: [],
279
+ ascii: '',
280
+ };
281
+ }
282
+
283
+ protected aggregate(container: RowData, newData?: MemoryTable.GroupData): void {
284
+ if (newData) {
285
+ container.groups.push(newData.node);
286
+ container.variables.push(...newData.variables);
287
+ container.ascii += newData.ascii;
288
+ }
289
+ }
290
+
291
+ protected override *renderArrayItems(
292
+ iteratee: Interfaces.LabeledUint8Array = this.memory.bytes,
293
+ getBitAttributes: Interfaces.BitDecorator = this.getBitAttributes.bind(this),
294
+ ): IterableIterator<MemoryTable.ItemData> {
295
+ let ignoredItems = 0;
296
+ const iterateeOffsetData = iteratee.label === DiffLabels.Before ? this.offsetData.before : this.offsetData.after;
297
+ for (const item of super.renderArrayItems(iteratee, getBitAttributes)) {
298
+ if (ignoredItems < iterateeOffsetData.leading) {
299
+ ignoredItems += 1;
300
+ continue;
301
+ }
302
+ yield item;
303
+ }
304
+ for (let i = 0; i < iterateeOffsetData.trailing; i += 1) {
305
+ yield this.getDummySpan(i);
306
+ }
307
+ }
308
+
309
+ protected getDummySpan(key: number): MemoryTable.ItemData {
310
+ const node = <span key={key}>{'\xa0'.repeat(2)}</span>;
311
+ return {
312
+ node,
313
+ content: '',
314
+ index: -1 * key,
315
+ };
316
+ }
317
+
318
+ protected override getBitAttributes(arrayOffset: number, iteratee: Interfaces.LabeledUint8Array): Partial<Interfaces.FullNodeAttributes> {
319
+ const isHighlighted = this.getHighlightStatus(arrayOffset, iteratee);
320
+ const content = iteratee[arrayOffset].toString(16).padStart(2, '0');
321
+ let className = `${MemoryTable.EIGHT_BIT_SPAN_CLASS} ${iteratee.label ?? ''}`;
322
+ const highContrastClass = this.isHighContrast ? 'hc' : '';
323
+ if (isHighlighted) {
324
+ className += ` different ${highContrastClass}`;
325
+ }
326
+
327
+ const isBeforeChunk = iteratee.label === DiffLabels.Before;
328
+ const baseAddress = isBeforeChunk ? this.diffData.beforeAddress : this.diffData.afterAddress;
329
+ const itemAddress = baseAddress.add(arrayOffset * 8 / this.options.byteSize);
330
+
331
+ const variable = isBeforeChunk
332
+ ? this.beforeVariableFinder.getVariableForAddress(itemAddress)
333
+ : this.afterVariableFinder.getVariableForAddress(itemAddress);
334
+
335
+ return { className, content, isHighlighted, variable, style: { color: variable?.color } };
336
+ }
337
+
338
+ protected getHighlightStatus(arrayOffset: number, iteratee: Interfaces.LabeledUint8Array): boolean {
339
+ const source = iteratee.label === DiffLabels.Before ? DiffLabels.Before : DiffLabels.After;
340
+ const targetArray = source === DiffLabels.Before ? this.diffData.afterBytes : this.diffData.beforeBytes;
341
+ const sourceValue = iteratee[arrayOffset];
342
+ const targetIndex = this.translateBetweenShiftedArrays(arrayOffset, source);
343
+ const targetValue = targetArray[targetIndex];
344
+ return sourceValue !== undefined &&
345
+ targetValue !== undefined &&
346
+ sourceValue !== targetValue;
347
+ }
348
+
349
+ protected translateBetweenShiftedArrays(sourceIndex: number, source: DiffLabels): number {
350
+ const sourceOffsets = source === DiffLabels.Before ? this.offsetData.before : this.offsetData.after;
351
+ const targetOffsets = source === DiffLabels.Before ? this.offsetData.after : this.offsetData.before;
352
+
353
+ return sourceIndex - sourceOffsets.leading + targetOffsets.leading;
354
+ }
355
+
356
+ protected override getHoverForVariable(span: HTMLElement): EasilyMappedObject | undefined {
357
+ const name = span.textContent ?? '';
358
+ const variable = this.beforeVariableFinder.searchForVariable(name) ??
359
+ this.afterVariableFinder.searchForVariable(name);
360
+
361
+ if (variable?.type) {
362
+ return { type: variable.type };
363
+ }
364
+ return undefined;
365
+ }
366
+ }