@jupyterlab/terminal 4.0.0-alpha.9 → 4.0.0-beta.1

package/lib/tokens.d.ts

@@ -33,6 +33,18 @@ export declare namespace ITerminal {
          * Refresh the terminal session.
          */
         refresh(): Promise<void>;
+        /**
+         * Check if terminal has any text selected.
+         */
+        hasSelection(): boolean;
+        /**
+         * Paste text into terminal.
+         */
+        paste(data: string): void;
+        /**
+         * Get selected text from terminal.
+         */
+        getSelection(): string | null;
     }
     /**
      * Options for the terminal widget.
@@ -110,6 +122,7 @@ export declare namespace ITerminal {
         background: string;
         cursor: string;
         cursorAccent: string;
-        selection: string;
+        selectionBackground: string;
+        selectionInactiveBackground: string;
     }
 }

package/lib/tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAI3D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAS1C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC;AAEF;;;GAGG;AACH,MAAM,KAAW,SAAS,CAiIzB;AAjID,WAAiB,SAAS;IA+FxB;;OAEG;IACU,wBAAc,GAAa;QACtC,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,gDAAgD;QAC5D,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,KAAK;QACtB,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,EAAE;QAClB,gBAAgB,EAAE,KAAK;QACvB,cAAc,EAAE,IAAI;QACpB,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,KAAK;KACvB,CAAC;AAiBJ,CAAC,EAjIgB,SAAS,KAAT,SAAS,QAiIzB"}
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAI3D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAS1C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC;AAEF;;;GAGG;AACH,MAAM,KAAW,SAAS,CAiJzB;AAjJD,WAAiB,SAAS;IA8GxB;;OAEG;IACU,wBAAc,GAAa;QACtC,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,gDAAgD;QAC5D,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,KAAK;QACtB,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,EAAE;QAClB,gBAAgB,EAAE,KAAK;QACvB,cAAc,EAAE,IAAI;QACpB,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,KAAK;KACvB,CAAC;AAkBJ,CAAC,EAjJgB,SAAS,KAAT,SAAS,QAiJzB"}

package/lib/widget.d.ts

@@ -17,8 +17,10 @@ export declare class Terminal extends Widget implements ITerminal.ITerminal {
      * @param translator - The language translator.
      */
     constructor(session: TerminalNS.ITerminalConnection, options?: Partial<ITerminal.IOptions>, translator?: ITranslator);
-    private _setThemeAttribute;
-    private _initialConnection;
+    /**
+     * A promise that is fulfilled when the terminal is ready.
+     */
+    get ready(): Promise<void>;
     /**
      * The terminal session associated with the widget.
      */
@@ -42,6 +44,18 @@ export declare class Terminal extends Widget implements ITerminal.ITerminal {
      * Failure to reconnect to the session should be caught appropriately
      */
     refresh(): Promise<void>;
+    /**
+     * Check if terminal has any text selected.
+     */
+    hasSelection(): boolean;
+    /**
+     * Paste text into terminal.
+     */
+    paste(data: string): void;
+    /**
+     * Get selected text from terminal.
+     */
+    getSelection(): string | null;
     /**
      * Process a message sent to the widget.
      *
@@ -75,6 +89,7 @@ export declare class Terminal extends Widget implements ITerminal.ITerminal {
      * Handle `'activate-request'` messages.
      */
     protected onActivateRequest(msg: Message): void;
+    private _initialConnection;
     /**
      * Initialize the terminal object.
      */
@@ -91,12 +106,15 @@ export declare class Terminal extends Widget implements ITerminal.ITerminal {
      * Set the size of the terminal in the session.
      */
     private _setSessionSize;
-    private readonly _term;
-    private readonly _fitAddon;
-    private _trans;
+    private _setThemeAttribute;
+    private _fitAddon;
     private _needsResize;
-    private _termOpened;
     private _offsetWidth;
     private _offsetHeight;
     private _options;
+    private _isReady;
+    private _ready;
+    private _term;
+    private _termOpened;
+    private _trans;
 }

package/lib/widget.js

@@ -1,22 +1,10 @@
 // Copyright (c) Jupyter Development Team.
 // Distributed under the terms of the Modified BSD License.
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
 import { nullTranslator } from '@jupyterlab/translation';
+import { PromiseDelegate } from '@lumino/coreutils';
 import { Platform } from '@lumino/domutils';
 import { MessageLoop } from '@lumino/messaging';
 import { Widget } from '@lumino/widgets';
-import { Terminal as Xterm } from 'xterm';
-import { FitAddon } from 'xterm-addon-fit';
 import { ITerminal } from '.';
 /**
  * The class name added to a terminal widget.
@@ -42,61 +30,75 @@ export class Terminal extends Widget {
     constructor(session, options = {}, translator) {
         super();
         this._needsResize = true;
-        this._termOpened = false;
         this._offsetWidth = -1;
         this._offsetHeight = -1;
+        this._isReady = false;
+        this._ready = new PromiseDelegate();
+        this._termOpened = false;
         translator = translator || nullTranslator;
         this._trans = translator.load('jupyterlab');
         this.session = session;
         // Initialize settings.
-        this._options = Object.assign(Object.assign({}, ITerminal.defaultOptions), options);
-        const _a = this._options, { theme } = _a, other = __rest(_a, ["theme"]);
-        const xtermOptions = Object.assign({ theme: Private.getXTermTheme(theme) }, other);
+        this._options = { ...ITerminal.defaultOptions, ...options };
+        const { theme, ...other } = this._options;
+        const xtermOptions = {
+            theme: Private.getXTermTheme(theme),
+            ...other
+        };
         this.addClass(TERMINAL_CLASS);
         this._setThemeAttribute(theme);
-        // Create the xterm.
-        this._term = new Xterm(xtermOptions);
-        this._fitAddon = new FitAddon();
-        this._term.loadAddon(this._fitAddon);
-        this._initializeTerm();
-        this.id = `jp-Terminal-${Private.id++}`;
-        this.title.label = this._trans.__('Terminal');
-        session.messageReceived.connect(this._onMessage, this);
+        // Buffer session message while waiting for the terminal
+        let buffer = '';
+        const bufferMessage = (sender, msg) => {
+            switch (msg.type) {
+                case 'stdout':
+                    if (msg.content) {
+                        buffer += msg.content[0];
+                    }
+                    break;
+                default:
+                    break;
+            }
+        };
+        session.messageReceived.connect(bufferMessage);
         session.disposed.connect(() => {
             if (this.getOption('closeOnExit')) {
                 this.dispose();
             }
         }, this);
-        if (session.connectionStatus === 'connected') {
-            this._initialConnection();
-        }
-        else {
-            session.connectionStatusChanged.connect(this._initialConnection, this);
-        }
-    }
-    _setThemeAttribute(theme) {
-        if (this.isDisposed) {
-            return;
-        }
-        this.node.setAttribute('data-term-theme', theme ? theme.toLowerCase() : 'inherit');
+        // Create the xterm.
+        Private.createTerminal(xtermOptions)
+            .then(([term, fitAddon]) => {
+            this._term = term;
+            this._fitAddon = fitAddon;
+            this._initializeTerm();
+            this.id = `jp-Terminal-${Private.id++}`;
+            this.title.label = this._trans.__('Terminal');
+            this._isReady = true;
+            this._ready.resolve();
+            if (buffer) {
+                this._term.write(buffer);
+            }
+            session.messageReceived.disconnect(bufferMessage);
+            session.messageReceived.connect(this._onMessage, this);
+            if (session.connectionStatus === 'connected') {
+                this._initialConnection();
+            }
+            else {
+                session.connectionStatusChanged.connect(this._initialConnection, this);
+            }
+            this.update();
+        })
+            .catch(reason => {
+            console.error('Failed to create a terminal.\n', reason);
+            this._ready.reject(reason);
+        });
     }
-    _initialConnection() {
-        if (this.isDisposed) {
-            return;
-        }
-        if (this.session.connectionStatus !== 'connected') {
-            return;
-        }
-        this.title.label = this._trans.__('Terminal %1', this.session.name);
-        this._setSessionSize();
-        if (this._options.initialCommand) {
-            this.session.send({
-                type: 'stdin',
-                content: [this._options.initialCommand + '\r']
-            });
-        }
-        // Only run this initial connection logic once.
-        this.session.connectionStatusChanged.disconnect(this._initialConnection, this);
+    /**
+     * A promise that is fulfilled when the terminal is ready.
+     */
+    get ready() {
+        return this._ready.promise;
     }
     /**
      * Get a config option for the terminal.
@@ -114,15 +116,32 @@ export class Terminal extends Widget {
         }
         this._options[option] = value;
         switch (option) {
-            case 'shutdownOnClose': // Do not transmit to XTerm
-            case 'closeOnExit': // Do not transmit to XTerm
+            case 'fontFamily':
+                this._term.options.fontFamily = value;
+                break;
+            case 'fontSize':
+                this._term.options.fontSize = value;
+                break;
+            case 'lineHeight':
+                this._term.options.lineHeight = value;
+                break;
+            case 'screenReaderMode':
+                this._term.options.screenReaderMode = value;
+                break;
+            case 'scrollback':
+                this._term.options.scrollback = value;
                 break;
             case 'theme':
-                this._term.setOption('theme', Private.getXTermTheme(value));
+                this._term.options.theme = {
+                    ...Private.getXTermTheme(value)
+                };
                 this._setThemeAttribute(value);
                 break;
+            case 'macOptionIsMeta':
+                this._term.options.macOptionIsMeta = value;
+                break;
             default:
-                this._term.setOption(option, value);
+                // Do not transmit options not listed above to XTerm
                 break;
         }
         this._needsResize = true;
@@ -139,7 +158,9 @@ export class Terminal extends Widget {
                 });
             }
         }
-        this._term.dispose();
+        void this.ready.then(() => {
+            this._term.dispose();
+        });
         super.dispose();
     }
     /**
@@ -149,11 +170,37 @@ export class Terminal extends Widget {
      * Failure to reconnect to the session should be caught appropriately
      */
     async refresh() {
-        if (!this.isDisposed) {
+        if (!this.isDisposed && this._isReady) {
             await this.session.reconnect();
             this._term.clear();
         }
     }
+    /**
+     * Check if terminal has any text selected.
+     */
+    hasSelection() {
+        if (!this.isDisposed && this._isReady) {
+            return this._term.hasSelection();
+        }
+        return false;
+    }
+    /**
+     * Paste text into terminal.
+     */
+    paste(data) {
+        if (!this.isDisposed && this._isReady) {
+            return this._term.paste(data);
+        }
+    }
+    /**
+     * Get selected text from terminal.
+     */
+    getSelection() {
+        if (!this.isDisposed && this._isReady) {
+            return this._term.getSelection();
+        }
+        return null;
+    }
     /**
      * Process a message sent to the widget.
      *
@@ -198,7 +245,7 @@ export class Terminal extends Widget {
      */
     onUpdateRequest(msg) {
         var _a;
-        if (!this.isVisible || !this.isAttached) {
+        if (!this.isVisible || !this.isAttached || !this._isReady) {
             return;
         }
         // Open the terminal if necessary.
@@ -222,7 +269,26 @@ export class Terminal extends Widget {
      * Handle `'activate-request'` messages.
      */
     onActivateRequest(msg) {
-        this._term.focus();
+        var _a;
+        (_a = this._term) === null || _a === void 0 ? void 0 : _a.focus();
+    }
+    _initialConnection() {
+        if (this.isDisposed) {
+            return;
+        }
+        if (this.session.connectionStatus !== 'connected') {
+            return;
+        }
+        this.title.label = this._trans.__('Terminal %1', this.session.name);
+        this._setSessionSize();
+        if (this._options.initialCommand) {
+            this.session.send({
+                type: 'stdin',
+                content: [this._options.initialCommand + '\r']
+            });
+        }
+        // Only run this initial connection logic once.
+        this.session.connectionStatusChanged.disconnect(this._initialConnection, this);
     }
     /**
      * Initialize the terminal object.
@@ -306,6 +372,12 @@ export class Terminal extends Widget {
             this.session.send({ type: 'set_size', content });
         }
     }
+    _setThemeAttribute(theme) {
+        if (this.isDisposed) {
+            return;
+        }
+        this.node.setAttribute('data-term-theme', theme ? theme.toLowerCase() : 'inherit');
+    }
 }
 /**
  * A namespace for private data.
@@ -324,7 +396,8 @@ var Private;
         background: '#fff',
         cursor: '#616161',
         cursorAccent: '#F5F5F5',
-        selection: 'rgba(97, 97, 97, 0.3)' // md-grey-700
+        selectionBackground: 'rgba(97, 97, 97, 0.3)',
+        selectionInactiveBackground: 'rgba(189, 189, 189, 0.3)' // md-grey-400
     };
     /**
      * The dark terminal theme.
@@ -334,7 +407,8 @@ var Private;
         background: '#000',
         cursor: '#fff',
         cursorAccent: '#000',
-        selection: 'rgba(255, 255, 255, 0.3)'
+        selectionBackground: 'rgba(255, 255, 255, 0.3)',
+        selectionInactiveBackground: 'rgba(238, 238, 238, 0.3)' // md-grey-200
     };
     /**
      * The current theme.
@@ -352,8 +426,11 @@ var Private;
         cursorAccent: getComputedStyle(document.body)
             .getPropertyValue('--jp-ui-inverse-font-color0')
             .trim(),
-        selection: getComputedStyle(document.body)
-            .getPropertyValue('--jp-ui-font-color3')
+        selectionBackground: getComputedStyle(document.body)
+            .getPropertyValue('--jp-layout-color3')
+            .trim(),
+        selectionInactiveBackground: getComputedStyle(document.body)
+            .getPropertyValue('--jp-layout-color2')
             .trim()
     });
     function getXTermTheme(theme) {
@@ -369,4 +446,75 @@ var Private;
     }
     Private.getXTermTheme = getXTermTheme;
 })(Private || (Private = {}));
+/**
+ * Utility functions for creating a Terminal widget
+ */
+(function (Private) {
+    let supportWebGL = false;
+    let Xterm_;
+    let FitAddon_;
+    let WeblinksAddon_;
+    let Renderer_;
+    /**
+     * Detect if the browser supports WebGL or not.
+     *
+     * Reference: https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/By_example/Detect_WebGL
+     */
+    function hasWebGLContext() {
+        // Create canvas element. The canvas is not added to the
+        // document itself, so it is never displayed in the
+        // browser window.
+        const canvas = document.createElement('canvas');
+        // Get WebGLRenderingContext from canvas element.
+        const gl = canvas.getContext('webgl') || canvas.getContext('experimental-webgl');
+        // Report the result.
+        try {
+            return gl instanceof WebGLRenderingContext;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    function addRenderer(term) {
+        let renderer = new Renderer_();
+        term.loadAddon(renderer);
+        if (supportWebGL) {
+            renderer.onContextLoss(event => {
+                console.debug('WebGL context lost - reinitialize Xtermjs renderer.');
+                renderer.dispose();
+                // If the Webgl context is lost, reinitialize the addon
+                addRenderer(term);
+            });
+        }
+    }
+    /**
+     * Create a xterm.js terminal asynchronously.
+     */
+    async function createTerminal(options) {
+        var _a;
+        if (!Xterm_) {
+            supportWebGL = hasWebGLContext();
+            const [xterm_, fitAddon_, renderer_, weblinksAddon_] = await Promise.all([
+                import('xterm'),
+                import('xterm-addon-fit'),
+                supportWebGL
+                    ? import('xterm-addon-webgl')
+                    : import('xterm-addon-canvas'),
+                import('xterm-addon-web-links')
+            ]);
+            Xterm_ = xterm_.Terminal;
+            FitAddon_ = fitAddon_.FitAddon;
+            Renderer_ =
+                (_a = renderer_.WebglAddon) !== null && _a !== void 0 ? _a : renderer_.CanvasAddon;
+            WeblinksAddon_ = weblinksAddon_.WebLinksAddon;
+        }
+        const term = new Xterm_(options);
+        addRenderer(term);
+        const fitAddon = new FitAddon_();
+        term.loadAddon(fitAddon);
+        term.loadAddon(new WeblinksAddon_());
+        return [term, fitAddon];
+    }
+    Private.createTerminal = createTerminal;
+})(Private || (Private = {}));
 //# sourceMappingURL=widget.js.map

package/lib/widget.js.map

@@ -1 +1 @@
-{"version":3,"file":"widget.js","sourceRoot":"","sources":["../src/widget.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"widget.js","sourceRoot":"","sources":["../src/widget.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jupyterlab/terminal",
-  "version": "4.0.0-alpha.9",
+  "version": "4.0.0-beta.1",
   "description": "JupyterLab - Terminal Emulator Widget",
   "homepage": "https://github.com/jupyterlab/jupyterlab",
   "bugs": {
@@ -27,7 +27,8 @@
     "lib/*.js.map",
     "lib/*.js",
     "style/*.css",
-    "style/index.js"
+    "style/index.js",
+    "src/**/*.{ts,tsx}"
   ],
   "scripts": {
     "build": "tsc -b",
@@ -41,25 +42,27 @@
     "watch": "tsc -b --watch"
   },
   "dependencies": {
-    "@jupyterlab/apputils": "^4.0.0-alpha.9",
-    "@jupyterlab/services": "^7.0.0-alpha.9",
-    "@jupyterlab/translation": "^4.0.0-alpha.9",
-    "@lumino/coreutils": "^1.12.0",
-    "@lumino/domutils": "^1.8.1",
-    "@lumino/messaging": "^1.10.1",
-    "@lumino/widgets": "^1.31.1",
-    "xterm": "~4.8.1",
-    "xterm-addon-fit": "~0.4.0"
+    "@jupyterlab/apputils": "^4.0.0-beta.1",
+    "@jupyterlab/services": "^7.0.0-beta.1",
+    "@jupyterlab/translation": "^4.0.0-beta.1",
+    "@lumino/coreutils": "^2.0.0",
+    "@lumino/domutils": "^2.0.0",
+    "@lumino/messaging": "^2.0.0",
+    "@lumino/widgets": "^2.0.1",
+    "xterm": "~5.1.0",
+    "xterm-addon-canvas": "~0.3.0",
+    "xterm-addon-fit": "~0.7.0",
+    "xterm-addon-web-links": "~0.8.0",
+    "xterm-addon-webgl": "~0.14.0"
   },
   "devDependencies": {
-    "@jupyterlab/testutils": "^4.0.0-alpha.9",
-    "@types/jest": "^26.0.10",
+    "@jupyterlab/testing": "^4.0.0-beta.1",
+    "@types/jest": "^29.2.0",
     "canvas": "^2.9.1",
-    "jest": "^26.4.2",
+    "jest": "^29.2.0",
     "rimraf": "~3.0.0",
-    "ts-jest": "^26.3.0",
-    "typedoc": "~0.22.10",
-    "typescript": "~4.6.3"
+    "typedoc": "~0.23.25",
+    "typescript": "~5.0.2"
   },
   "publishConfig": {
     "access": "public"

package/src/index.ts

@@ -0,0 +1,9 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+/**
+ * @packageDocumentation
+ * @module terminal
+ */
+
+export * from './tokens';
+export * from './widget';

package/src/tokens.ts

@@ -0,0 +1,171 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+
+import { IWidgetTracker, MainAreaWidget } from '@jupyterlab/apputils';
+import { Terminal } from '@jupyterlab/services';
+import { Token } from '@lumino/coreutils';
+import { Widget } from '@lumino/widgets';
+
+/**
+ * A class that tracks editor widgets.
+ */
+export interface ITerminalTracker
+  extends IWidgetTracker<MainAreaWidget<ITerminal.ITerminal>> {}
+
+/**
+ * The editor tracker token.
+ */
+export const ITerminalTracker = new Token<ITerminalTracker>(
+  '@jupyterlab/terminal:ITerminalTracker'
+);
+
+/**
+ * The namespace for terminals. Separated from the widget so it can be lazy
+ * loaded.
+ */
+export namespace ITerminal {
+  export interface ITerminal extends Widget {
+    /**
+     * The terminal session associated with the widget.
+     */
+    session: Terminal.ITerminalConnection;
+
+    /**
+     * Get a config option for the terminal.
+     */
+    getOption<K extends keyof IOptions>(option: K): IOptions[K];
+
+    /**
+     * Set a config option for the terminal.
+     */
+    setOption<K extends keyof IOptions>(option: K, value: IOptions[K]): void;
+
+    /**
+     * Refresh the terminal session.
+     */
+    refresh(): Promise<void>;
+
+    /**
+     * Check if terminal has any text selected.
+     */
+    hasSelection(): boolean;
+
+    /**
+     * Paste text into terminal.
+     */
+    paste(data: string): void;
+
+    /**
+     * Get selected text from terminal.
+     */
+    getSelection(): string | null;
+  }
+  /**
+   * Options for the terminal widget.
+   */
+  export interface IOptions {
+    /**
+     * The font family used to render text.
+     */
+    fontFamily?: string;
+
+    /**
+     * The font size of the terminal in pixels.
+     */
+    fontSize: number;
+
+    /**
+     * The line height used to render text.
+     */
+    lineHeight?: number;
+
+    /**
+     * The theme of the terminal.
+     */
+    theme: Theme;
+
+    /**
+     * The amount of buffer scrollback to be used
+     * with the terminal
+     */
+    scrollback?: number;
+
+    /**
+     * Whether to shut down the session when closing a terminal or not.
+     */
+    shutdownOnClose: boolean;
+
+    /**
+     * Whether to close the widget when exiting a terminal or not.
+     */
+    closeOnExit: boolean;
+
+    /**
+     * Whether to blink the cursor.  Can only be set at startup.
+     */
+    cursorBlink: boolean;
+
+    /**
+     * An optional command to run when the session starts.
+     */
+    initialCommand: string;
+
+    /**
+     * Whether to enable screen reader support.
+     */
+    screenReaderMode: boolean;
+
+    /**
+     * Whether to enable using Ctrl+V to paste.
+     *
+     * This setting has no effect on macOS, where Cmd+V is available.
+     */
+    pasteWithCtrlV: boolean;
+
+    /**
+     * Whether to auto-fit the terminal to its host element size.
+     */
+    autoFit?: boolean;
+
+    /**
+     * Treat option as meta key on macOS.
+     */
+    macOptionIsMeta?: boolean;
+  }
+
+  /**
+   * The default options used for creating terminals.
+   */
+  export const defaultOptions: IOptions = {
+    theme: 'inherit',
+    fontFamily: 'Menlo, Consolas, "DejaVu Sans Mono", monospace',
+    fontSize: 13,
+    lineHeight: 1.0,
+    scrollback: 1000,
+    shutdownOnClose: false,
+    closeOnExit: true,
+    cursorBlink: true,
+    initialCommand: '',
+    screenReaderMode: false, // False by default, can cause scrollbar mouse interaction issues.
+    pasteWithCtrlV: true,
+    autoFit: true,
+    macOptionIsMeta: false
+  };
+
+  /**
+   * A type for the terminal theme.
+   */
+  export type Theme = 'light' | 'dark' | 'inherit';
+
+  /**
+   * A type for the terminal theme.
+   */
+  export interface IThemeObject {
+    foreground: string;
+    background: string;
+    cursor: string;
+    cursorAccent: string;
+    selectionBackground: string;
+    selectionInactiveBackground: string;
+  }
+}

package/src/widget.ts

@@ -0,0 +1,626 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+
+import { Terminal as TerminalNS } from '@jupyterlab/services';
+import {
+  ITranslator,
+  nullTranslator,
+  TranslationBundle
+} from '@jupyterlab/translation';
+import { PromiseDelegate } from '@lumino/coreutils';
+import { Platform } from '@lumino/domutils';
+import { Message, MessageLoop } from '@lumino/messaging';
+import { Widget } from '@lumino/widgets';
+import type {
+  ITerminalInitOnlyOptions,
+  ITerminalOptions,
+  Terminal as Xterm
+} from 'xterm';
+import type { CanvasAddon } from 'xterm-addon-canvas';
+import type { FitAddon } from 'xterm-addon-fit';
+import type { WebLinksAddon } from 'xterm-addon-web-links';
+import type { WebglAddon } from 'xterm-addon-webgl';
+import { ITerminal } from '.';
+
+/**
+ * The class name added to a terminal widget.
+ */
+const TERMINAL_CLASS = 'jp-Terminal';
+
+/**
+ * The class name added to a terminal body.
+ */
+const TERMINAL_BODY_CLASS = 'jp-Terminal-body';
+
+/**
+ * A widget which manages a terminal session.
+ */
+export class Terminal extends Widget implements ITerminal.ITerminal {
+  /**
+   * Construct a new terminal widget.
+   *
+   * @param session - The terminal session object.
+   *
+   * @param options - The terminal configuration options.
+   *
+   * @param translator - The language translator.
+   */
+  constructor(
+    session: TerminalNS.ITerminalConnection,
+    options: Partial<ITerminal.IOptions> = {},
+    translator?: ITranslator
+  ) {
+    super();
+    translator = translator || nullTranslator;
+    this._trans = translator.load('jupyterlab');
+    this.session = session;
+
+    // Initialize settings.
+    this._options = { ...ITerminal.defaultOptions, ...options };
+
+    const { theme, ...other } = this._options;
+    const xtermOptions = {
+      theme: Private.getXTermTheme(theme),
+      ...other
+    };
+
+    this.addClass(TERMINAL_CLASS);
+
+    this._setThemeAttribute(theme);
+
+    // Buffer session message while waiting for the terminal
+    let buffer = '';
+    const bufferMessage = (
+      sender: TerminalNS.ITerminalConnection,
+      msg: TerminalNS.IMessage
+    ): void => {
+      switch (msg.type) {
+        case 'stdout':
+          if (msg.content) {
+            buffer += msg.content[0] as string;
+          }
+          break;
+        default:
+          break;
+      }
+    };
+    session.messageReceived.connect(bufferMessage);
+    session.disposed.connect(() => {
+      if (this.getOption('closeOnExit')) {
+        this.dispose();
+      }
+    }, this);
+
+    // Create the xterm.
+    Private.createTerminal(xtermOptions)
+      .then(([term, fitAddon]) => {
+        this._term = term;
+        this._fitAddon = fitAddon;
+        this._initializeTerm();
+
+        this.id = `jp-Terminal-${Private.id++}`;
+        this.title.label = this._trans.__('Terminal');
+        this._isReady = true;
+        this._ready.resolve();
+
+        if (buffer) {
+          this._term.write(buffer);
+        }
+        session.messageReceived.disconnect(bufferMessage);
+        session.messageReceived.connect(this._onMessage, this);
+
+        if (session.connectionStatus === 'connected') {
+          this._initialConnection();
+        } else {
+          session.connectionStatusChanged.connect(
+            this._initialConnection,
+            this
+          );
+        }
+        this.update();
+      })
+      .catch(reason => {
+        console.error('Failed to create a terminal.\n', reason);
+        this._ready.reject(reason);
+      });
+  }
+
+  /**
+   * A promise that is fulfilled when the terminal is ready.
+   */
+  get ready(): Promise<void> {
+    return this._ready.promise;
+  }
+
+  /**
+   * The terminal session associated with the widget.
+   */
+  readonly session: TerminalNS.ITerminalConnection;
+
+  /**
+   * Get a config option for the terminal.
+   */
+  getOption<K extends keyof ITerminal.IOptions>(
+    option: K
+  ): ITerminal.IOptions[K] {
+    return this._options[option];
+  }
+
+  /**
+   * Set a config option for the terminal.
+   */
+  setOption<K extends keyof ITerminal.IOptions>(
+    option: K,
+    value: ITerminal.IOptions[K]
+  ): void {
+    if (
+      option !== 'theme' &&
+      (this._options[option] === value || option === 'initialCommand')
+    ) {
+      return;
+    }
+
+    this._options[option] = value;
+
+    switch (option) {
+      case 'fontFamily':
+        this._term.options.fontFamily = value as string | undefined;
+        break;
+      case 'fontSize':
+        this._term.options.fontSize = value as number | undefined;
+        break;
+      case 'lineHeight':
+        this._term.options.lineHeight = value as number | undefined;
+        break;
+      case 'screenReaderMode':
+        this._term.options.screenReaderMode = value as boolean | undefined;
+        break;
+      case 'scrollback':
+        this._term.options.scrollback = value as number | undefined;
+        break;
+      case 'theme':
+        this._term.options.theme = {
+          ...Private.getXTermTheme(value as ITerminal.Theme)
+        };
+        this._setThemeAttribute(value as ITerminal.Theme);
+        break;
+      case 'macOptionIsMeta':
+        this._term.options.macOptionIsMeta = value as boolean | undefined;
+        break;
+      default:
+        // Do not transmit options not listed above to XTerm
+        break;
+    }
+
+    this._needsResize = true;
+    this.update();
+  }
+
+  /**
+   * Dispose of the resources held by the terminal widget.
+   */
+  dispose(): void {
+    if (!this.session.isDisposed) {
+      if (this.getOption('shutdownOnClose')) {
+        this.session.shutdown().catch(reason => {
+          console.error(`Terminal not shut down: ${reason}`);
+        });
+      }
+    }
+    void this.ready.then(() => {
+      this._term.dispose();
+    });
+    super.dispose();
+  }
+
+  /**
+   * Refresh the terminal session.
+   *
+   * #### Notes
+   * Failure to reconnect to the session should be caught appropriately
+   */
+  async refresh(): Promise<void> {
+    if (!this.isDisposed && this._isReady) {
+      await this.session.reconnect();
+      this._term.clear();
+    }
+  }
+
+  /**
+   * Check if terminal has any text selected.
+   */
+  hasSelection(): boolean {
+    if (!this.isDisposed && this._isReady) {
+      return this._term.hasSelection();
+    }
+    return false;
+  }
+
+  /**
+   * Paste text into terminal.
+   */
+  paste(data: string): void {
+    if (!this.isDisposed && this._isReady) {
+      return this._term.paste(data);
+    }
+  }
+
+  /**
+   * Get selected text from terminal.
+   */
+  getSelection(): string | null {
+    if (!this.isDisposed && this._isReady) {
+      return this._term.getSelection();
+    }
+    return null;
+  }
+
+  /**
+   * Process a message sent to the widget.
+   *
+   * @param msg - The message sent to the widget.
+   *
+   * #### Notes
+   * Subclasses may reimplement this method as needed.
+   */
+  processMessage(msg: Message): void {
+    super.processMessage(msg);
+    switch (msg.type) {
+      case 'fit-request':
+        this.onFitRequest(msg);
+        break;
+      default:
+        break;
+    }
+  }
+
+  /**
+   * Set the size of the terminal when attached if dirty.
+   */
+  protected onAfterAttach(msg: Message): void {
+    this.update();
+  }
+
+  /**
+   * Set the size of the terminal when shown if dirty.
+   */
+  protected onAfterShow(msg: Message): void {
+    this.update();
+  }
+
+  /**
+   * On resize, use the computed row and column sizes to resize the terminal.
+   */
+  protected onResize(msg: Widget.ResizeMessage): void {
+    this._offsetWidth = msg.width;
+    this._offsetHeight = msg.height;
+    this._needsResize = true;
+    this.update();
+  }
+
+  /**
+   * A message handler invoked on an `'update-request'` message.
+   */
+  protected onUpdateRequest(msg: Message): void {
+    if (!this.isVisible || !this.isAttached || !this._isReady) {
+      return;
+    }
+
+    // Open the terminal if necessary.
+    if (!this._termOpened) {
+      this._term.open(this.node);
+      this._term.element?.classList.add(TERMINAL_BODY_CLASS);
+      this._termOpened = true;
+    }
+
+    if (this._needsResize) {
+      this._resizeTerminal();
+    }
+  }
+
+  /**
+   * A message handler invoked on an `'fit-request'` message.
+   */
+  protected onFitRequest(msg: Message): void {
+    const resize = Widget.ResizeMessage.UnknownSize;
+    MessageLoop.sendMessage(this, resize);
+  }
+
+  /**
+   * Handle `'activate-request'` messages.
+   */
+  protected onActivateRequest(msg: Message): void {
+    this._term?.focus();
+  }
+
+  private _initialConnection() {
+    if (this.isDisposed) {
+      return;
+    }
+
+    if (this.session.connectionStatus !== 'connected') {
+      return;
+    }
+
+    this.title.label = this._trans.__('Terminal %1', this.session.name);
+    this._setSessionSize();
+    if (this._options.initialCommand) {
+      this.session.send({
+        type: 'stdin',
+        content: [this._options.initialCommand + '\r']
+      });
+    }
+
+    // Only run this initial connection logic once.
+    this.session.connectionStatusChanged.disconnect(
+      this._initialConnection,
+      this
+    );
+  }
+
+  /**
+   * Initialize the terminal object.
+   */
+  private _initializeTerm(): void {
+    const term = this._term;
+    term.onData((data: string) => {
+      if (this.isDisposed) {
+        return;
+      }
+      this.session.send({
+        type: 'stdin',
+        content: [data]
+      });
+    });
+
+    term.onTitleChange((title: string) => {
+      this.title.label = title;
+    });
+
+    // Do not add any Ctrl+C/Ctrl+V handling on macOS,
+    // where Cmd+C/Cmd+V works as intended.
+    if (Platform.IS_MAC) {
+      return;
+    }
+
+    term.attachCustomKeyEventHandler(event => {
+      if (event.ctrlKey && event.key === 'c' && term.hasSelection()) {
+        // Return so that the usual OS copy happens
+        // instead of interrupt signal.
+        return false;
+      }
+
+      if (event.ctrlKey && event.key === 'v' && this._options.pasteWithCtrlV) {
+        // Return so that the usual paste happens.
+        return false;
+      }
+
+      return true;
+    });
+  }
+
+  /**
+   * Handle a message from the terminal session.
+   */
+  private _onMessage(
+    sender: TerminalNS.ITerminalConnection,
+    msg: TerminalNS.IMessage
+  ): void {
+    switch (msg.type) {
+      case 'stdout':
+        if (msg.content) {
+          this._term.write(msg.content[0] as string);
+        }
+        break;
+      case 'disconnect':
+        this._term.write('\r\n\r\n[Finished… Term Session]\r\n');
+        break;
+      default:
+        break;
+    }
+  }
+
+  /**
+   * Resize the terminal based on computed geometry.
+   */
+  private _resizeTerminal() {
+    if (this._options.autoFit) {
+      this._fitAddon.fit();
+    }
+    if (this._offsetWidth === -1) {
+      this._offsetWidth = this.node.offsetWidth;
+    }
+    if (this._offsetHeight === -1) {
+      this._offsetHeight = this.node.offsetHeight;
+    }
+    this._setSessionSize();
+    this._needsResize = false;
+  }
+
+  /**
+   * Set the size of the terminal in the session.
+   */
+  private _setSessionSize(): void {
+    const content = [
+      this._term.rows,
+      this._term.cols,
+      this._offsetHeight,
+      this._offsetWidth
+    ];
+    if (!this.isDisposed) {
+      this.session.send({ type: 'set_size', content });
+    }
+  }
+
+  private _setThemeAttribute(theme: string | null | undefined) {
+    if (this.isDisposed) {
+      return;
+    }
+
+    this.node.setAttribute(
+      'data-term-theme',
+      theme ? theme.toLowerCase() : 'inherit'
+    );
+  }
+
+  private _fitAddon: FitAddon;
+  private _needsResize = true;
+  private _offsetWidth = -1;
+  private _offsetHeight = -1;
+  private _options: ITerminal.IOptions;
+  private _isReady = false;
+  private _ready = new PromiseDelegate<void>();
+  private _term: Xterm;
+  private _termOpened = false;
+  private _trans: TranslationBundle;
+}
+
+/**
+ * A namespace for private data.
+ */
+namespace Private {
+  /**
+   * An incrementing counter for ids.
+   */
+  export let id = 0;
+
+  /**
+   * The light terminal theme.
+   */
+  export const lightTheme: ITerminal.IThemeObject = {
+    foreground: '#000',
+    background: '#fff',
+    cursor: '#616161', // md-grey-700
+    cursorAccent: '#F5F5F5', // md-grey-100
+    selectionBackground: 'rgba(97, 97, 97, 0.3)', // md-grey-700
+    selectionInactiveBackground: 'rgba(189, 189, 189, 0.3)' // md-grey-400
+  };
+
+  /**
+   * The dark terminal theme.
+   */
+  export const darkTheme: ITerminal.IThemeObject = {
+    foreground: '#fff',
+    background: '#000',
+    cursor: '#fff',
+    cursorAccent: '#000',
+    selectionBackground: 'rgba(255, 255, 255, 0.3)',
+    selectionInactiveBackground: 'rgba(238, 238, 238, 0.3)' // md-grey-200
+  };
+
+  /**
+   * The current theme.
+   */
+  export const inheritTheme = (): ITerminal.IThemeObject => ({
+    foreground: getComputedStyle(document.body)
+      .getPropertyValue('--jp-ui-font-color0')
+      .trim(),
+    background: getComputedStyle(document.body)
+      .getPropertyValue('--jp-layout-color0')
+      .trim(),
+    cursor: getComputedStyle(document.body)
+      .getPropertyValue('--jp-ui-font-color1')
+      .trim(),
+    cursorAccent: getComputedStyle(document.body)
+      .getPropertyValue('--jp-ui-inverse-font-color0')
+      .trim(),
+    selectionBackground: getComputedStyle(document.body)
+      .getPropertyValue('--jp-layout-color3')
+      .trim(),
+    selectionInactiveBackground: getComputedStyle(document.body)
+      .getPropertyValue('--jp-layout-color2')
+      .trim()
+  });
+
+  export function getXTermTheme(
+    theme: ITerminal.Theme
+  ): ITerminal.IThemeObject {
+    switch (theme) {
+      case 'light':
+        return lightTheme;
+      case 'dark':
+        return darkTheme;
+      case 'inherit':
+      default:
+        return inheritTheme();
+    }
+  }
+}
+
+/**
+ * Utility functions for creating a Terminal widget
+ */
+namespace Private {
+  let supportWebGL: boolean = false;
+  let Xterm_: typeof Xterm;
+  let FitAddon_: typeof FitAddon;
+  let WeblinksAddon_: typeof WebLinksAddon;
+  let Renderer_: typeof CanvasAddon | typeof WebglAddon;
+
+  /**
+   * Detect if the browser supports WebGL or not.
+   *
+   * Reference: https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/By_example/Detect_WebGL
+   */
+  function hasWebGLContext(): boolean {
+    // Create canvas element. The canvas is not added to the
+    // document itself, so it is never displayed in the
+    // browser window.
+    const canvas = document.createElement('canvas');
+
+    // Get WebGLRenderingContext from canvas element.
+    const gl =
+      canvas.getContext('webgl') || canvas.getContext('experimental-webgl');
+
+    // Report the result.
+    try {
+      return gl instanceof WebGLRenderingContext;
+    } catch (error) {
+      return false;
+    }
+  }
+
+  function addRenderer(term: Xterm): void {
+    let renderer = new Renderer_();
+    term.loadAddon(renderer);
+    if (supportWebGL) {
+      (renderer as WebglAddon).onContextLoss(event => {
+        console.debug('WebGL context lost - reinitialize Xtermjs renderer.');
+        renderer.dispose();
+        // If the Webgl context is lost, reinitialize the addon
+        addRenderer(term);
+      });
+    }
+  }
+
+  /**
+   * Create a xterm.js terminal asynchronously.
+   */
+  export async function createTerminal(
+    options: ITerminalOptions & ITerminalInitOnlyOptions
+  ): Promise<[Xterm, FitAddon]> {
+    if (!Xterm_) {
+      supportWebGL = hasWebGLContext();
+      const [xterm_, fitAddon_, renderer_, weblinksAddon_] = await Promise.all([
+        import('xterm'),
+        import('xterm-addon-fit'),
+        supportWebGL
+          ? import('xterm-addon-webgl')
+          : import('xterm-addon-canvas'),
+        import('xterm-addon-web-links')
+      ]);
+      Xterm_ = xterm_.Terminal;
+      FitAddon_ = fitAddon_.FitAddon;
+      Renderer_ =
+        (renderer_ as any).WebglAddon ?? (renderer_ as any).CanvasAddon;
+      WeblinksAddon_ = weblinksAddon_.WebLinksAddon;
+    }
+
+    const term = new Xterm_(options);
+    addRenderer(term);
+    const fitAddon = new FitAddon_();
+    term.loadAddon(fitAddon);
+    term.loadAddon(new WeblinksAddon_());
+    return [term, fitAddon];
+  }
+}