Component Viewer initial commit (#725)

* Component Viewer initial commit

---------
Authored-by: Thorsten de Buhr <thorsten.deBuhr@arm.com>
Co-authored-by: Omar Elkhouly <omar.elkhouly@arm.com>

Author: thorstendb-ARM

src/views/component-viewer/component-viewer-main.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2026 Arm Limited
+ * Copyright 2025-2026 Arm Limited
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,9 +22,9 @@ import { ComponentViewerTreeDataProvider } from './component-viewer-tree-view';
 
 
 export class ComponentViewer {
-    private activeSession: GDBTargetDebugSession | undefined;
-    private instances: ComponentViewerInstance[] = [];
-    private componentViewerTreeDataProvider: ComponentViewerTreeDataProvider | undefined;
+    private _activeSession: GDBTargetDebugSession | undefined;
+    private _instances: ComponentViewerInstance[] = [];
+    private _componentViewerTreeDataProvider: ComponentViewerTreeDataProvider | undefined;
     private _context: vscode.ExtensionContext;
     private _instanceUpdateCounter: number = 0;
     private _updateSemaphoreFlag: boolean = false;
@@ -36,8 +36,8 @@ export class ComponentViewer {
 
     public activate(tracker: GDBTargetDebugTracker): void {
         /* Create Tree Viewer */
-        this.componentViewerTreeDataProvider = new ComponentViewerTreeDataProvider();
-        const treeProviderDisposable = vscode.window.registerTreeDataProvider('cmsis-debugger.componentViewer', this.componentViewerTreeDataProvider);
+        this._componentViewerTreeDataProvider = new ComponentViewerTreeDataProvider();
+        const treeProviderDisposable = vscode.window.registerTreeDataProvider('cmsis-debugger.componentViewer', this._componentViewerTreeDataProvider);
         this._context.subscriptions.push(
             treeProviderDisposable);
         // Subscribe to debug tracker events to update active session
@@ -60,12 +60,12 @@ export class ComponentViewer {
         const cbuildRunInstances: ComponentViewerInstance[] = [];
         for (const scvdFilePath of scvdFilesPaths) {
             const instance = new ComponentViewerInstance();
-            if (this.activeSession !== undefined) {
-                await instance.readModel(URI.file(scvdFilePath), this.activeSession, tracker);
+            if (this._activeSession !== undefined) {
+                await instance.readModel(URI.file(scvdFilePath), this._activeSession, tracker);
                 cbuildRunInstances.push(instance);
             }
         }
-        this.instances = cbuildRunInstances;
+        this._instances = cbuildRunInstances;
     }
 
     private async loadCbuildRunInstances(session: GDBTargetDebugSession, tracker: GDBTargetDebugTracker) : Promise<void> {
@@ -74,8 +74,8 @@ export class ComponentViewer {
         // Try to read SCVD files from cbuild-run file first
         await this.readScvdFiles(tracker, session);
         // Are there any SCVD files found in cbuild-run?
-        if (this.instances.length > 0) {
-            //await this.updateInstances();
+        if (this._instances.length > 0) {
+            await this.updateInstances();
             return;
         }
     }
@@ -93,50 +93,50 @@ export class ComponentViewer {
         const onDidChangeActiveDebugSessionDisposable = tracker.onDidChangeActiveDebugSession(async (session) => {
             await this.handleOnDidChangeActiveDebugSession(session);
         });
-        const onStackTrace = tracker.onStackTrace(async (session) => {
-            await this.handleOnStackTrace(session.session);
+        const onStopped = tracker.onStopped(async (session) => {
+            await this.handleOnStopped(session.session);
         });
         // clear all disposables on extension deactivation
         context.subscriptions.push(
             onWillStopSessionDisposable,
             onConnectedDisposable,
             onDidChangeActiveStackItemDisposable,
             onDidChangeActiveDebugSessionDisposable,
-            onStackTrace
+            onStopped
         );
     }
 
-    private async handleOnStackTrace(session: GDBTargetDebugSession): Promise<void> {
+    private async handleOnStopped(session: GDBTargetDebugSession): Promise<void> {
         // Clear active session if it is NOT the one being stopped
-        if (this.activeSession?.session.id !== session.session.id) {
-            this.activeSession = undefined;
+        if (this._activeSession?.session.id !== session.session.id) {
+            this._activeSession = undefined;
         }
         // Update component viewer instance(s)
         await this.updateInstances();
     }
 
     private async handleOnWillStopSession(session: GDBTargetDebugSession): Promise<void> {
         // Clear active session if it is the one being stopped
-        if (this.activeSession?.session.id === session.session.id) {
-            this.activeSession = undefined;
+        if (this._activeSession?.session.id === session.session.id) {
+            this._activeSession = undefined;
         }
         // Update component viewer instance(s)
-        //await this.updateInstances();
+        await this.updateInstances();
     }
 
     private async handleOnConnected(session: GDBTargetDebugSession, tracker: GDBTargetDebugTracker): Promise<void> {
         // if new session is not the current active session, erase old instances and read the new ones
-        if (this.activeSession?.session.id !== session.session.id) {
-            this.instances = [];
-            this.componentViewerTreeDataProvider?.deleteModels();
+        if (this._activeSession?.session.id !== session.session.id) {
+            this._instances = [];
+            this._componentViewerTreeDataProvider?.deleteModels();
         }
         // Update debug session
-        this.activeSession = session;
+        this._activeSession = session;
         // Load SCVD files from cbuild-run
         await this.loadCbuildRunInstances(session, tracker);
         // Subscribe to refresh events of the started session
         session.refreshTimer.onRefresh(async (refreshSession) => {
-            if (this.activeSession?.session.id === refreshSession.session.id) {
+            if (this._activeSession?.session.id === refreshSession.session.id) {
                 // Update component viewer instance(s)
                 await this.updateInstances();
             }
@@ -146,13 +146,13 @@ export class ComponentViewer {
     private async handleOnDidChangeActiveStackItem(stackTraceItem: SessionStackItem): Promise<void> {
         if ((stackTraceItem.item as vscode.DebugStackFrame).frameId !== undefined) {
             // Update instance(s) with new stack frame info
-            //await this.updateInstances();
+            await this.updateInstances();
         }
     }
 
     private async handleOnDidChangeActiveDebugSession(session: GDBTargetDebugSession | undefined): Promise<void> {
         // Update debug session
-        this.activeSession = session;
+        this._activeSession = session;
         // Update component viewer instance(s)
         await this.updateInstances();
     }
@@ -163,23 +163,23 @@ export class ComponentViewer {
         }
         this._updateSemaphoreFlag = true;
         this._instanceUpdateCounter = 0;
-        if (!this.activeSession) {
-            this.componentViewerTreeDataProvider?.deleteModels();
+        if (!this._activeSession) {
+            this._componentViewerTreeDataProvider?.deleteModels();
             this._updateSemaphoreFlag = false;
             return;
         }
-        if (this.instances.length === 0) {
+        if (this._instances.length === 0) {
             this._updateSemaphoreFlag = false;
             return;
         }
-        this.componentViewerTreeDataProvider?.resetModelCache();
-        for (const instance of this.instances) {
+        this._componentViewerTreeDataProvider?.resetModelCache();
+        for (const instance of this._instances) {
             this._instanceUpdateCounter++;
             console.log(`Updating Component Viewer Instance #${this._instanceUpdateCounter}`);
             await instance.update();
-            this.componentViewerTreeDataProvider?.addGuiOut(instance.getGuiTree());
+            this._componentViewerTreeDataProvider?.addGuiOut(instance.getGuiTree());
         }
-        this.componentViewerTreeDataProvider?.showModelData();
+        this._componentViewerTreeDataProvider?.showModelData();
         this._updateSemaphoreFlag = false;
     }
 }

src/views/component-viewer/component-viewer-tree-view.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2026 Arm Limited
+ * Copyright 2025-2026 Arm Limited
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,24 +14,14 @@
  * limitations under the License.
  */
 
-/*
- * Component Viewer Tree (ordered exactly as provided by getGuiChildren())
- * - Root = model.objects?.objects?.[0]?.out?.[0]
- * - Label/description from node.getGuiEntry() -> { name, value }
- * - Children from node.getGuiChildren() (returned AS-IS, in order)
- * - Each item id = node.nodeId (no fallbacks)
- * - Activation via `await provider.activate()`; no constructor args
- * - View ID defaults to 'cmsis-debugger.componentViewer'
- */
 
 import * as vscode from 'vscode';
 import { ScvdGuiInterface } from './model/scvd-gui-interface';
 
 
 export class ComponentViewerTreeDataProvider implements vscode.TreeDataProvider<ScvdGuiInterface> {
     private readonly _onDidChangeTreeData = new vscode.EventEmitter<ScvdGuiInterface | void>();
-    readonly onDidChangeTreeData = this._onDidChangeTreeData.event;
-    //private _activeSession: GDBTargetDebugSession | undefined;
+    public readonly onDidChangeTreeData = this._onDidChangeTreeData.event;
     private _objectOutRoots: ScvdGuiInterface[] = [];
     private _scvdModel: ScvdGuiInterface[] = [];
 

src/views/component-viewer/model/number-type.ts

@@ -14,7 +14,6 @@
  * limitations under the License.
  */
 
-
 import * as utils from './scvd-utils';
 
 export enum NumFormat {

src/views/component-viewer/model/scvd-base.ts

@@ -12,12 +12,13 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- *
+ */
+
+/**
  * Minimal core for SCVD tree nodes: parent/child wiring and basic metadata.
  * Model-specific behaviour lives in ScvdNode.
  */
 
-
 export type Json = Record<string, unknown>;
 
 // Constructor type used for runtime instanceof checks; kept loose to cover differing ctor shapes.

src/views/component-viewer/model/scvd-component-identifier.ts

@@ -14,7 +14,6 @@
  * limitations under the License.
  */
 
-// /component_viewer/component
 // https://arm-software.github.io/CMSIS-View/main/elem_component.html
 
 import { Json } from './scvd-base';

src/views/component-viewer/model/scvd-component-viewer.ts

@@ -43,18 +43,6 @@ export class ScvdComponentViewer extends ScvdNode {
         return 'ScvdComponentViewer';
     }
 
-    /* template for readXml
-    public override readXml(xml: Json): boolean {
-        if (xml === undefined ) {
-            return super.readXml(xml);
-        }
-
-        //this.tag = xml.tag;
-
-        return super.readXml(xml);
-    }
-    */
-
     public override readXml(xml: Json): boolean {
         if (xml === undefined ) {
             return super.readXml(xml);

src/views/component-viewer/model/scvd-component.ts

@@ -14,7 +14,6 @@
  * limitations under the License.
  */
 
-// /component_viewer/events
 // https://arm-software.github.io/CMSIS-View/main/elem_events.html
 
 import { NumberType, NumberTypeInput } from './number-type';

src/views/component-viewer/model/scvd-event-level.ts

@@ -14,10 +14,10 @@
  * limitations under the License.
  */
 
-import { ScvdNode } from './scvd-node';
-
 // https://arm-software.github.io/CMSIS-View/main/elem_component_viewer.html
 
+import { ScvdNode } from './scvd-node';
+
 export enum EventLevel {
     EventLevelError = 0,   // Run-time error
     EventLevelAPI = 1,     // API function call

src/views/component-viewer/model/scvd-event-state.ts

@@ -14,6 +14,9 @@
  * limitations under the License.
  */
 
+// https://arm-software.github.io/CMSIS-View/main/elem_component_viewer.html
+
+
 import { Json } from './scvd-base';
 import { ScvdNode } from './scvd-node';
 import { getStringFromJson } from './scvd-utils';
@@ -24,8 +27,6 @@ function isEventColor(v: string): v is EventColor {
     return EVENT_COLORS.includes(v as EventColor);
 }
 
-// https://arm-software.github.io/CMSIS-View/main/elem_component_viewer.html
-
 export class ScvdEventState extends ScvdNode {
     private _plot: 'off' | 'line' | 'box' = 'off';
     private _color: EventColor = 'blue';

src/views/component-viewer/model/scvd-event-tracking.ts

@@ -14,10 +14,10 @@
  * limitations under the License.
  */
 
-import { ScvdNode } from './scvd-node';
-
 // https://arm-software.github.io/CMSIS-View/main/elem_component_viewer.html
 
+import { ScvdNode } from './scvd-node';
+
 /**
  * Specifies the tracking for an event handle.
  *  - Start: start the state tracking for an event handle.