@jupyterlab/debugger 3.3.0-alpha.16 → 3.3.0-alpha.17

package/lib/tokens.d.ts

@@ -1,10 +1,11 @@
 import { CodeEditor, CodeEditorWrapper } from '@jupyterlab/codeeditor';
 import { KernelMessage, Session } from '@jupyterlab/services';
-import { Token } from '@lumino/coreutils';
+import { ReadonlyJSONObject, Token } from '@lumino/coreutils';
 import { IObservableDisposable } from '@lumino/disposable';
 import { ISignal, Signal } from '@lumino/signaling';
 import { Widget } from '@lumino/widgets';
 import { DebugProtocol } from 'vscode-debugprotocol';
+import { DebuggerHandler } from './handler';
 /**
  * An interface describing an application's visual debugger.
  */
@@ -61,6 +62,14 @@ export interface IDebugger {
      * @param variablesReference The variable reference to request.
      */
     inspectVariable(variablesReference: number): Promise<DebugProtocol.Variable[]>;
+    /**
+     * Request rich representation of a variable.
+     *
+     * @param variableName The variable name to request
+     * @param frameId The current frame id in which to request the variable
+     * @returns The mime renderer data model
+     */
+    inspectRichVariable(variableName: string, frameId?: number): Promise<IDebugger.IRichVariable>;
     /**
      * Requests all the defined variables and display them in the
      * table view.
@@ -194,6 +203,11 @@ export declare namespace IDebugger {
          */
         getTmpFileParams(kernel: string): IConfig.FileParams;
     }
+    /**
+     * An interface for debugger handler.
+     */
+    interface IHandler extends DebuggerHandler.IHandler {
+    }
     /**
      * An interface for a scope.
      */
@@ -264,6 +278,19 @@ export declare namespace IDebugger {
      */
     interface IStackFrame extends DebugProtocol.StackFrame {
     }
+    /**
+     * A reply to an rich inspection request.
+     */
+    interface IRichVariable {
+        /**
+         * The MIME bundle data returned from an rich inspection request.
+         */
+        data: ReadonlyJSONObject;
+        /**
+         * Any metadata that accompanies the MIME bundle returning from a rich inspection request.
+         */
+        metadata: ReadonlyJSONObject;
+    }
     /**
      * An interface for a variable.
      */
@@ -342,6 +369,7 @@ export declare namespace IDebugger {
             restart: DebugProtocol.RestartArguments;
             restartFrame: DebugProtocol.RestartFrameArguments;
             reverseContinue: DebugProtocol.ReverseContinueArguments;
+            richInspectVariables: IRichVariablesArguments;
             scopes: DebugProtocol.ScopesArguments;
             setBreakpoints: DebugProtocol.SetBreakpointsArguments;
             setExceptionBreakpoints: DebugProtocol.SetExceptionBreakpointsArguments;
@@ -384,6 +412,7 @@ export declare namespace IDebugger {
             restart: DebugProtocol.RestartResponse;
             restartFrame: DebugProtocol.RestartFrameResponse;
             reverseContinue: DebugProtocol.ReverseContinueResponse;
+            richInspectVariables: IRichVariablesResponse;
             scopes: DebugProtocol.ScopesResponse;
             setBreakpoints: DebugProtocol.SetBreakpointsResponse;
             setExceptionBreakpoints: DebugProtocol.SetExceptionBreakpointsResponse;
@@ -415,13 +444,17 @@ export declare namespace IDebugger {
          */
         interface IDebugInfoResponse extends DebugProtocol.Response {
             body: {
-                isStarted: boolean;
+                breakpoints: IDebugInfoBreakpoints[];
                 hashMethod: string;
                 hashSeed: number;
-                breakpoints: IDebugInfoBreakpoints[];
+                isStarted: boolean;
+                /**
+                 * Whether the kernel supports variable rich rendering or not.
+                 */
+                richRendering?: boolean;
+                stoppedThreads: number[];
                 tmpFilePrefix: string;
                 tmpFileSuffix: string;
-                stoppedThreads: number[];
             };
         }
         /**
@@ -447,6 +480,34 @@ export declare namespace IDebugger {
                 variables: DebugProtocol.Variable[];
             };
         }
+        /**
+         * Arguments for 'richVariables' request
+         *
+         * This is an addition to the Debug Adapter Protocol to support
+         * render rich variable representation.
+         */
+        interface IRichVariablesArguments {
+            /**
+             * Variable name
+             */
+            variableName: string;
+            /**
+             * Frame Id
+             */
+            frameId?: number;
+        }
+        /**
+         * Arguments for 'richVariables' request
+         *
+         * This is an addition to the Debug Adapter Protocol to support
+         * rich rendering of variables.
+         */
+        interface IRichVariablesResponse extends DebugProtocol.Response {
+            /**
+             * Variable mime type data
+             */
+            body: IRichVariable;
+        }
         /**
          * Response to the 'kernel_info_request' request.
          * This interface extends the IInfoReply by adding the `debugger` key
@@ -457,6 +518,16 @@ export declare namespace IDebugger {
             debugger: boolean;
         }
     }
+    /**
+     * Select variable in the variables explorer.
+     *
+     * @hidden
+     *
+     * #### Notes
+     * This is experimental API
+     */
+    interface IVariableSelection extends Pick<DebugProtocol.Variable, 'name' | 'type' | 'variablesReference' | 'value'> {
+    }
     /**
      * Debugger sidebar interface.
      */
@@ -568,11 +639,11 @@ export declare namespace IDebugger {
             /**
              * Signal emitted when the current frame has changed.
              */
-            readonly currentFrameChanged: ISignal<this, IDebugger.IStackFrame>;
+            readonly currentFrameChanged: ISignal<this, IDebugger.IStackFrame | null>;
             /**
              * The current frame.
              */
-            frame: IDebugger.IStackFrame;
+            frame: IDebugger.IStackFrame | null;
             /**
              * The frames for the callstack.
              */
@@ -594,6 +665,10 @@ export declare namespace IDebugger {
              * The callstack UI model.
              */
             readonly callstack: ICallstack;
+            /**
+             * Whether the kernel support rich variable rendering based on mime type.
+             */
+            hasRichVariableRendering: boolean;
             /**
              * The variables UI model.
              */
@@ -626,7 +701,7 @@ export declare namespace IDebugger {
             /**
              * Signal emitted when the current frame changes.
              */
-            readonly currentFrameChanged: ISignal<IDebugger.Model.ICallstack, IDebugger.IStackFrame>;
+            readonly currentFrameChanged: ISignal<IDebugger.Model.ICallstack, IDebugger.IStackFrame | null>;
             /**
              * Return the current source.
              */
@@ -660,6 +735,10 @@ export declare namespace IDebugger {
              * Signal emitted when the current variable has been expanded.
              */
             readonly variableExpanded: ISignal<this, IDebugger.IVariable>;
+            /**
+             * Selected variable in the variables explorer.
+             */
+            selectedVariable: IVariableSelection | null;
             /**
              * Expand a variable.
              *
@@ -685,3 +764,7 @@ export declare const IDebuggerSources: Token<IDebugger.ISources>;
  * The debugger configuration token.
  */
 export declare const IDebuggerSidebar: Token<IDebugger.ISidebar>;
+/**
+ * The debugger handler token.
+ */
+export declare const IDebuggerHandler: Token<IDebugger.IHandler>;

package/lib/tokens.js

@@ -17,4 +17,8 @@ export const IDebuggerSources = new Token('@jupyterlab/debugger:IDebuggerSources
  * The debugger configuration token.
  */
 export const IDebuggerSidebar = new Token('@jupyterlab/debugger:IDebuggerSidebar');
+/**
+ * The debugger handler token.
+ */
+export const IDebuggerHandler = new Token('@jupyterlab/debugger:IDebuggerHandler');
 //# sourceMappingURL=tokens.js.map

package/lib/tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAM3D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AA8xB1C;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,KAAK,CAAY,gCAAgC,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,KAAK,CACtC,sCAAsC,CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC"}
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAM3D,OAAO,EAAsB,KAAK,EAAE,MAAM,mBAAmB,CAAC;AA43B9D;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,KAAK,CAAY,gCAAgC,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,KAAK,CACtC,sCAAsC,CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jupyterlab/debugger",
-  "version": "3.3.0-alpha.16",
+  "version": "3.3.0-alpha.17",
   "description": "JupyterLab - Debugger Extension",
   "keywords": [
     "jupyter",
@@ -48,21 +48,21 @@
     "watch": "tsc -b --watch"
   },
   "dependencies": {
-    "@jupyterlab/application": "^3.3.0-alpha.16",
-    "@jupyterlab/apputils": "^3.3.0-alpha.16",
-    "@jupyterlab/cells": "^3.3.0-alpha.16",
-    "@jupyterlab/codeeditor": "^3.3.0-alpha.16",
-    "@jupyterlab/codemirror": "^3.3.0-alpha.16",
-    "@jupyterlab/console": "^3.3.0-alpha.16",
-    "@jupyterlab/coreutils": "^5.3.0-alpha.16",
-    "@jupyterlab/docregistry": "^3.3.0-alpha.16",
-    "@jupyterlab/fileeditor": "^3.3.0-alpha.16",
-    "@jupyterlab/notebook": "^3.3.0-alpha.16",
-    "@jupyterlab/observables": "^4.3.0-alpha.16",
-    "@jupyterlab/rendermime": "^3.3.0-alpha.16",
-    "@jupyterlab/services": "^6.3.0-alpha.16",
-    "@jupyterlab/translation": "^3.3.0-alpha.16",
-    "@jupyterlab/ui-components": "^3.3.0-alpha.15",
+    "@jupyterlab/application": "^3.3.0-alpha.17",
+    "@jupyterlab/apputils": "^3.3.0-alpha.17",
+    "@jupyterlab/cells": "^3.3.0-alpha.17",
+    "@jupyterlab/codeeditor": "^3.3.0-alpha.17",
+    "@jupyterlab/codemirror": "^3.3.0-alpha.17",
+    "@jupyterlab/console": "^3.3.0-alpha.17",
+    "@jupyterlab/coreutils": "^5.3.0-alpha.17",
+    "@jupyterlab/docregistry": "^3.3.0-alpha.17",
+    "@jupyterlab/fileeditor": "^3.3.0-alpha.17",
+    "@jupyterlab/notebook": "^3.3.0-alpha.17",
+    "@jupyterlab/observables": "^4.3.0-alpha.17",
+    "@jupyterlab/rendermime": "^3.3.0-alpha.17",
+    "@jupyterlab/services": "^6.3.0-alpha.17",
+    "@jupyterlab/translation": "^3.3.0-alpha.17",
+    "@jupyterlab/ui-components": "^3.3.0-alpha.16",
     "@lumino/algorithm": "^1.3.3",
     "@lumino/commands": "^1.12.0",
     "@lumino/coreutils": "^1.5.3",
@@ -78,7 +78,7 @@
   "devDependencies": {
     "@babel/core": "^7.10.2",
     "@babel/preset-env": "^7.10.2",
-    "@jupyterlab/testutils": "^3.3.0-alpha.16",
+    "@jupyterlab/testutils": "^3.3.0-alpha.17",
     "@types/codemirror": "^0.0.109",
     "@types/jest": "^26.0.10",
     "@types/react-dom": "^17.0.0",

package/style/variables.css

@@ -30,6 +30,38 @@
   padding: 5px 0 0 0;
   cursor: pointer;
   color: var(--jp-content-font-color1);
+  display: flex;
+  align-items: center;
+}
+
+.jp-DebuggerVariables-body ul li:hover .jp-DebuggerVariables-renderVariable {
+  display: block;
+}
+
+.jp-DebuggerVariables-body .jp-DebuggerVariables-hspacer {
+  flex: 1 1 auto;
+}
+
+.jp-DebuggerVariables-body .jp-DebuggerVariables-renderVariable {
+  flex: 0 0 auto;
+  border: none;
+  background: none;
+  cursor: pointer;
+  display: none;
+  padding: 0px 8px;
+}
+
+.jp-DebuggerVariables-body .jp-DebuggerVariables-renderVariable:active {
+  transform: scale(1.272) translateX(-4px);
+  overflow: hidden;
+}
+
+.jp-DebuggerVariables-body .jp-DebuggerVariables-renderVariable:hover {
+  background-color: var(--jp-layout-color2);
+}
+
+.jp-DebuggerVariables-body .jp-DebuggerVariables-renderVariable:disabled {
+  cursor: default;
 }
 
 .jp-DebuggerVariables-body ul li > ul {
@@ -84,3 +116,17 @@
 .jp-DebuggerVariables-colorPalette .jp-mod-text {
   color: var(--jp-content-font-color0);
 }
+
+.jp-VariableRenderer-TrustButton[aria-pressed='true'] {
+  box-shadow: inset 0 var(--jp-border-width) 4px
+    rgba(
+      var(--jp-shadow-base-lightness),
+      var(--jp-shadow-base-lightness),
+      var(--jp-shadow-base-lightness),
+      0.6
+    );
+}
+
+.jp-DebuggerRichVariable div[data-mime-type='text/plain'] > pre {
+  white-space: normal;
+}