Add support to ANSI OSC52

Add support to ANSI OSC52 sequence to manipulate selection and clipboard
data. The sequence specs supports multiple clipboard selections but we
only support the common ones, system and primary clipboard selections.

This adds a new event listener to the common terminal module
`onClipboard` to allow external implementations to hook into it.

The addon uses the browser Clipboard API to read/write from and to the
clipboard. The default `ClipboardProvider` uses the browser Clipboard
API. This means it only supports read/write to and from the system
clipboard.

Reference: https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Operating-System-Commands
Fixes: xtermjs#3260
Signed-off-by: Ayman Bagabas <ayman.bagabas@gmail.com>

.eslintrc.json

@@ -18,6 +18,8 @@
       "addons/xterm-addon-attach/test/tsconfig.json",
       "addons/xterm-addon-canvas/src/tsconfig.json",
       "addons/xterm-addon-canvas/test/tsconfig.json",
+      "addons/xterm-addon-clipboard/src/tsconfig.json",
+      "addons/xterm-addon-clipboard/test/tsconfig.json",
       "addons/xterm-addon-fit/src/tsconfig.json",
       "addons/xterm-addon-fit/test/tsconfig.json",
       "addons/xterm-addon-image/src/tsconfig.json",

README.md

@@ -77,6 +77,7 @@ terminal.loadAddon(new WebLinksAddon());
 The xterm.js team maintains the following addons, but anyone can build them:
 
 - [`xterm-addon-attach`](https://github.com/xtermjs/xterm.js/tree/master/addons/xterm-addon-attach): Attaches to a server running a process via a websocket
+- [`xterm-addon-clipboard`](https://github.com/xtermjs/xterm.js/tree/master/addons/xterm-addon-clipboard): Access the browser's clipboard
 - [`xterm-addon-fit`](https://github.com/xtermjs/xterm.js/tree/master/addons/xterm-addon-fit): Fits the terminal to the containing element
 - [`xterm-addon-search`](https://github.com/xtermjs/xterm.js/tree/master/addons/xterm-addon-search): Adds search functionality
 - [`xterm-addon-web-links`](https://github.com/xtermjs/xterm.js/tree/master/addons/xterm-addon-web-links): Adds web link detection and interaction

addons/xterm-addon-clipboard/.gitignore

@@ -0,0 +1,2 @@
+lib
+node_modules

addons/xterm-addon-clipboard/.npmignore

@@ -0,0 +1,29 @@
+# Blacklist - exclude everything except npm defaults such as LICENSE, etc
+*
+!*/
+
+# Whitelist - lib/
+!lib/**/*.d.ts
+
+!lib/**/*.js
+!lib/**/*.js.map
+
+!lib/**/*.css
+
+# Whitelist - src/
+!src/**/*.ts
+!src/**/*.d.ts
+
+!src/**/*.js
+!src/**/*.js.map
+
+!src/**/*.css
+
+# Blacklist - src/ test files
+src/**/*.test.ts
+src/**/*.test.d.ts
+src/**/*.test.js
+src/**/*.test.js.map
+
+# Whitelist - typings/
+!typings/*.d.ts

addons/xterm-addon-clipboard/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2023, The xterm.js authors (https://github.com/xtermjs/xterm.js)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

addons/xterm-addon-clipboard/README.md

@@ -0,0 +1,52 @@
+## xterm-addon-clipboard
+
+An addon for [xterm.js](https://github.com/xtermjs/xterm.js) that enables accessing the system clipboard. This addon requires xterm.js v4+.
+
+### Install
+
+```bash
+npm install --save xterm-addon-clipboard
+```
+
+### Usage
+
+```ts
+import { Terminal } from 'xterm';
+import { ClipboardAddon } from 'xterm-addon-clipboard';
+
+const terminal = new Terminal();
+const clipboardAddon = new ClipboardAddon();
+terminal.loadAddon(clipboardAddon);
+```
+
+To use a custom clipboard provider
+
+```ts
+import { Terminal, IClipboardProvider, ClipboardSelection } from 'xterm';
+import { ClipboardAddon } from 'xterm-addon-clipboard';
+
+function b64Encode(data: string): string {
+  // Base64 encode impl
+}
+
+function b64Decode(data: string): string {
+  // Base64 decode impl
+}
+
+class MyCustomClipboardProvider implements IClipboardProvider {
+  private _data: string
+  public readText(selection: ClipboardSelection): Promise<string> {
+    return Promise.resolve(b64Encode(this._data));
+  }
+  public writeText(selection: ClipboardSelection, data: string): Promise<void> {
+    this._data = b64Decode(data);
+    return Promise.resolve();
+  }
+}
+
+const terminal = new Terminal();
+const clipboardAddon = new ClipboardAddon(new MyCustomClipboardProvider());
+terminal.loadAddon(clipboardAddon);
+```
+
+See the full [API](https://github.com/xtermjs/xterm.js/blob/master/addons/xterm-addon-clipboard/typings/xterm-addon-clipboard.d.ts) for more advanced usage.

addons/xterm-addon-clipboard/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "xterm-addon-clipboard",
+  "version": "0.1.0",
+  "author": {
+    "name": "The xterm.js authors",
+    "url": "https://xtermjs.org/"
+  },
+  "main": "lib/xterm-addon-clipboard.js",
+  "types": "typings/xterm-addon-clipboard.d.ts",
+  "repository": "https://github.com/xtermjs/xterm.js",
+  "license": "MIT",
+  "keywords": [
+    "terminal",
+    "xterm",
+    "xterm.js"
+  ],
+  "scripts": {
+    "build": "../../node_modules/.bin/tsc -p .",
+    "prepackage": "npm run build",
+    "package": "../../node_modules/.bin/webpack",
+    "prepublishOnly": "npm run package"
+  },
+  "peerDependencies": {
+    "xterm": "^5.3.0"
+  },
+  "dependencies": {
+    "js-base64": "^3.7.5"
+  }
+}

addons/xterm-addon-clipboard/src/ClipboardAddon.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2023 The xterm.js authors. All rights reserved.
+ * @license MIT
+ */
+
+import { ClipboardProvider } from './ClipboardProvider';
+import { IClipboardProvider, ITerminalAddon, Terminal } from 'xterm';
+
+export class ClipboardAddon implements ITerminalAddon {
+  private _terminal: Terminal | undefined;
+  constructor(private _provider: IClipboardProvider = new ClipboardProvider()) {}
+
+  public activate(terminal: Terminal): void {
+    this._terminal = terminal;
+    terminal.registerClipboardProvider(this._provider);
+  }
+
+  public dispose(): void {
+    this._terminal?.deregisterClipboardProvider();
+  }
+}

addons/xterm-addon-clipboard/src/ClipboardProvider.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2023 The xterm.js authors. All rights reserved.
+ * @license MIT
+ */
+
+import { Base64 } from 'js-base64';
+import { ClipboardSelection, IClipboardProvider } from 'xterm';
+
+export class ClipboardProvider implements IClipboardProvider {
+  constructor(
+    /**
+     * The maximum amount of data that can be copied to the clipboard.
+     * Zero means no limit.
+     */
+    public limit = 1000000 // 1MB
+  ){}
+  public readText(selection: ClipboardSelection): Promise<string> {
+    if (selection !== 'c') {
+      return Promise.resolve('');
+    }
+    return navigator.clipboard.readText().then((text) =>
+      Base64.encode(text));
+  }
+  public writeText(selection: ClipboardSelection, data: string): Promise<void> {
+    if (selection !== 'c' || (this.limit > 0 && data.length > this.limit)) {
+      return Promise.resolve();
+    }
+    const text = Base64.decode(data);
+    // clear the clipboard if the data is not valid base64
+    if (!Base64.isValid(data) || Base64.encode(text) !== data) {
+      return navigator.clipboard.writeText('');
+    }
+    return navigator.clipboard.writeText(text);
+  }
+}

addons/xterm-addon-clipboard/src/tsconfig.json

@@ -0,0 +1,36 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "es2017",
+    "sourceMap": true,
+    "outDir": "../out",
+    "rootDir": ".",
+    "strict": true,
+    "noUnusedLocals": true,
+    "preserveWatchOutput": true,
+    "types": [
+      "../../../node_modules/@types/mocha"
+    ],
+    "baseUrl": ".",
+    "paths": {
+      "browser/*": [
+        "../../../src/browser/*"
+      ],
+      "common/*": [
+        "../../../src/common/*"
+      ]
+    }
+  },
+  "include": [
+    "./**/*",
+    "../../../typings/xterm.d.ts"
+  ],
+  "references": [
+    {
+      "path": "../../../src/browser"
+    },
+    {
+      "path": "../../../src/common"
+    }
+  ]
+}

addons/xterm-addon-clipboard/test/ClipboardAddon.api.ts

@@ -0,0 +1,86 @@
+/**
+ * Copyright (c) 2023 The xterm.js authors. All rights reserved.
+ * @license MIT
+ */
+
+import { assert } from 'chai';
+import { openTerminal, launchBrowser, writeSync, getBrowserType } from '../../../out-test/api/TestUtils';
+import { Browser, BrowserContext, Page } from '@playwright/test';
+
+const APP = 'http://127.0.0.1:3001/test';
+
+let browser: Browser;
+let context: BrowserContext;
+let page: Page;
+const width = 800;
+const height = 600;
+
+describe('ClipboardAddon', () => {
+  before(async function (): Promise<any> {
+    browser = await launchBrowser({
+      // Enable clipboard access in firefox, mainly for readText
+      firefoxUserPrefs: {
+        // eslint-disable-next-line @typescript-eslint/naming-convention
+        'dom.events.testing.asyncClipboard': true,
+        // eslint-disable-next-line @typescript-eslint/naming-convention
+        'dom.events.asyncClipboard.readText': true
+      }
+    });
+    context = await browser.newContext();
+    if (getBrowserType().name() !== 'webkit') {
+      // Enable clipboard access in chromium without user gesture
+      context.grantPermissions(['clipboard-read', 'clipboard-write']);
+    }
+    page = await context.newPage();
+    await page.setViewportSize({ width, height });
+    await page.goto(APP);
+    await openTerminal(page, { allowClipboardAccess: true });
+    await page.evaluate(`
+      window.clipboardAddon = new ClipboardAddon();
+      window.term.loadAddon(window.clipboardAddon);
+    `);
+  });
+
+  after(() => {
+    browser.close();
+  });
+
+  beforeEach(async () => {
+    await page.evaluate(`window.term.reset()`);
+  });
+
+  const testDataEncoded = 'aGVsbG8gd29ybGQ=';
+  const testDataDecoded = 'hello world';
+
+  describe('write data', async function (): Promise<any> {
+    it('simple string', async () => {
+      await writeSync(page, `\x1b]52;c;${testDataEncoded}\x07`);
+      assert.deepEqual(await page.evaluate(() => window.navigator.clipboard.readText()), testDataDecoded);
+    });
+    it('invalid base64 string', async () => {
+      await writeSync(page, `\x1b]52;c;${testDataEncoded}invalid\x07`);
+      assert.deepEqual(await page.evaluate(() => window.navigator.clipboard.readText()), '');
+    });
+    it('empty string', async () => {
+      await writeSync(page, `\x1b]52;c;\x07`);
+      assert.deepEqual(await page.evaluate(() => window.navigator.clipboard.readText()), '');
+    });
+  });
+
+  describe('read data', async function (): Promise<any> {
+    it('simple string', async () => {
+      await page.evaluate(`
+        window.data = [];
+        window.term.onData(e => data.push(e));
+      `);
+      await page.evaluate(() => window.navigator.clipboard.writeText('hello world'));
+      await writeSync(page, `\x1b]52;c;?\x07`);
+      assert.deepEqual(await page.evaluate(`window.data`), [testDataEncoded]);
+    });
+    it('clear clipboard', async () => {
+      await writeSync(page, `\x1b]52;c;!\x07`);
+      await writeSync(page, `\x1b]52;c;?\x07`);
+      assert.deepEqual(await page.evaluate(() => window.navigator.clipboard.readText()), '');
+    });
+  });
+});

addons/xterm-addon-clipboard/test/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "es2015",
+    "lib": [
+      "es2015"
+    ],
+    "rootDir": ".",
+    "outDir": "../out-test",
+    "sourceMap": true,
+    "removeComments": true,
+    "strict": true,
+    "types": [
+      "../../../node_modules/@types/mocha",
+      "../../../node_modules/@types/node",
+    ]
+  },
+  "include": [
+    "./**/*",
+    "../../../typings/xterm.d.ts"
+  ]
+}

addons/xterm-addon-clipboard/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "files": [],
+  "include": [],
+  "references": [
+    { "path": "./src" },
+    { "path": "./test" }
+  ]
+}

addons/xterm-addon-clipboard/typings/xterm-addon-clipboard.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2023 The xterm.js authors. All rights reserved.
+ * @license MIT
+ */
+
+import { Terminal, ITerminalAddon, IClipboardProvider, ClipboardSelection } from 'xterm';
+
+declare module 'xterm-addon-clipboard' {
+  export class ClipboardProvider implements IClipboardProvider{
+    public readText(selection: ClipboardSelection): Promise<string>;
+    public writeText(selection: ClipboardSelection, data: string): Promise<void>;
+  }
+
+  /**
+   * An xterm.js addon that enables accessing the system clipboard from
+   * xterm.js.
+   */
+  export class ClipboardAddon implements ITerminalAddon {
+    /**
+     * Creates a new clipboard addon.
+     */
+    constructor(_provider: IClipboardProvider);
+
+    /**
+     * Activates the addon
+     * @param terminal The terminal the addon is being loaded in.
+     */
+    public activate(terminal: Terminal): void;
+
+    /**
+     * Disposes the addon.
+     */
+    public dispose(): void
+  }
+}

addons/xterm-addon-clipboard/webpack.config.js

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2023 The xterm.js authors. All rights reserved.
+ * @license MIT
+ */
+
+const path = require('path');
+
+const addonName = 'ClipboardAddon';
+const mainFile = 'xterm-addon-clipboard.js';
+
+module.exports = {
+  entry: `./out/${addonName}.js`,
+  devtool: 'source-map',
+  module: {
+    rules: [
+      {
+        test: /\.js$/,
+        use: ["source-map-loader"],
+        enforce: "pre",
+        exclude: /node_modules/
+      }
+    ]
+  },
+  output: {
+    filename: mainFile,
+    path: path.resolve('./lib'),
+    library: addonName,
+    libraryTarget: 'umd'
+  },
+  mode: 'production'
+};

addons/xterm-addon-clipboard/yarn.lock

@@ -0,0 +1,8 @@
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+# yarn lockfile v1
+
+
+js-base64@^3.7.5:
+  version "3.7.5"
+  resolved "https://registry.yarnpkg.com/js-base64/-/js-base64-3.7.5.tgz#21e24cf6b886f76d6f5f165bfcd69cc55b9e3fca"
+  integrity sha512-3MEt5DTINKqfScXKfJFrRbxkrnk2AxPWGBL/ycjz4dK8iqiSJ06UxD8jh8xuh6p10TX4t2+7FsBYVxxQbMg+qA==

bin/publish.js

@@ -29,6 +29,7 @@ if (changedFiles.some(e => e.search(/^addons\//) === -1)) {
 const addonPackageDirs = [
   path.resolve(__dirname, '../addons/xterm-addon-attach'),
   path.resolve(__dirname, '../addons/xterm-addon-canvas'),
+  path.resolve(__dirname, '../addons/xterm-addon-clipboard'),
   path.resolve(__dirname, '../addons/xterm-addon-fit'),
   // path.resolve(__dirname, '../addons/xterm-addon-image'),
   path.resolve(__dirname, '../addons/xterm-addon-ligatures'),

demo/client.ts

@@ -12,6 +12,7 @@
 import { Terminal } from '../out/browser/public/Terminal';
 import { AttachAddon } from '../addons/xterm-addon-attach/out/AttachAddon';
 import { CanvasAddon } from '../addons/xterm-addon-canvas/out/CanvasAddon';
+import { ClipboardAddon } from '../addons/xterm-addon-clipboard/out/ClipboardAddon';
 import { FitAddon } from '../addons/xterm-addon-fit/out/FitAddon';
 import { SearchAddon, ISearchOptions } from '../addons/xterm-addon-search/out/SearchAddon';
 import { SerializeAddon } from '../addons/xterm-addon-serialize/out/SerializeAddon';
@@ -32,6 +33,7 @@ if ('WebAssembly' in window) {
 // Use webpacked version (yarn package)
 // import { Terminal } from '../lib/xterm';
 // import { AttachAddon } from 'xterm-addon-attach';
+// import { ClipboardAddon } from 'xterm-addon-clipboard';
 // import { FitAddon } from 'xterm-addon-fit';
 // import { ImageAddon } from 'xterm-addon-image';
 // import { SearchAddon, ISearchOptions } from 'xterm-addon-search';
@@ -51,6 +53,7 @@ export interface IWindowWithTerminal extends Window {
   Terminal?: typeof TerminalType; // eslint-disable-line @typescript-eslint/naming-convention
   AttachAddon?: typeof AttachAddon; // eslint-disable-line @typescript-eslint/naming-convention
   CanvasAddon?: typeof CanvasAddon; // eslint-disable-line @typescript-eslint/naming-convention
+  ClipboardAddon?: typeof ClipboardAddon; // eslint-disable-line @typescript-eslint/naming-convention
   FitAddon?: typeof FitAddon; // eslint-disable-line @typescript-eslint/naming-convention
   ImageAddon?: typeof ImageAddonType; // eslint-disable-line @typescript-eslint/naming-convention
   SearchAddon?: typeof SearchAddon; // eslint-disable-line @typescript-eslint/naming-convention
@@ -70,7 +73,7 @@ let socket;
 let pid;
 let autoResize: boolean = true;
 
-type AddonType = 'attach' | 'canvas' | 'fit' | 'image' | 'search' | 'serialize' | 'unicode11' | 'unicodeGraphemes' | 'webLinks' | 'webgl' | 'ligatures';
+type AddonType = 'attach' | 'canvas' | 'clipboard' | 'fit' | 'image' | 'search' | 'serialize' | 'unicode11' | 'unicodeGraphemes' | 'webLinks' | 'webgl' | 'ligatures';
 
 interface IDemoAddon<T extends AddonType> {
   name: T;
@@ -78,35 +81,38 @@ interface IDemoAddon<T extends AddonType> {
   ctor: (
     T extends 'attach' ? typeof AttachAddon :
       T extends 'canvas' ? typeof CanvasAddon :
-        T extends 'fit' ? typeof FitAddon :
-          T extends 'image' ? typeof ImageAddonType :
-            T extends 'search' ? typeof SearchAddon :
-              T extends 'serialize' ? typeof SerializeAddon :
-                T extends 'webLinks' ? typeof WebLinksAddon :
-                  T extends 'unicode11' ? typeof Unicode11Addon :
-                    T extends 'unicodeGraphemes' ? typeof UnicodeGraphemesAddon :
-                      T extends 'ligatures' ? typeof LigaturesAddon :
+        T extends 'clipboard' ? typeof ClipboardAddon :
+          T extends 'fit' ? typeof FitAddon :
+            T extends 'image' ? typeof ImageAddonType :
+              T extends 'search' ? typeof SearchAddon :
+                T extends 'serialize' ? typeof SerializeAddon :
+                  T extends 'webLinks' ? typeof WebLinksAddon :
+                    T extends 'unicode11' ? typeof Unicode11Addon :
+                      T extends 'unicodeGraphemes' ? typeof UnicodeGraphemesAddon :
+                        T extends 'ligatures' ? typeof LigaturesAddon :
                         typeof WebglAddon
   );
   instance?: (
     T extends 'attach' ? AttachAddon :
       T extends 'canvas' ? CanvasAddon :
-        T extends 'fit' ? FitAddon :
-          T extends 'image' ? ImageAddonType :
-            T extends 'search' ? SearchAddon :
-              T extends 'serialize' ? SerializeAddon :
-                T extends 'webLinks' ? WebLinksAddon :
-                  T extends 'webgl' ? WebglAddon :
-                    T extends 'unicode11' ? typeof Unicode11Addon :
-                      T extends 'unicodeGraphemes' ? typeof UnicodeGraphemesAddon :
-                        T extends 'ligatures' ? typeof LigaturesAddon :
-                          never
+        T extends 'clipboard' ? ClipboardAddon :
+          T extends 'fit' ? FitAddon :
+            T extends 'image' ? ImageAddonType :
+              T extends 'search' ? SearchAddon :
+                T extends 'serialize' ? SerializeAddon :
+                  T extends 'webLinks' ? WebLinksAddon :
+                    T extends 'webgl' ? WebglAddon :
+                      T extends 'unicode11' ? typeof Unicode11Addon :
+                        T extends 'unicodeGraphemes' ? typeof UnicodeGraphemesAddon :
+                          T extends 'ligatures' ? typeof LigaturesAddon :
+                            never
   );
 }
 
 const addons: { [T in AddonType]: IDemoAddon<T> } = {
   attach: { name: 'attach', ctor: AttachAddon, canChange: false },
   canvas: { name: 'canvas', ctor: CanvasAddon, canChange: true },
+  clipboard: { name: 'clipboard', ctor: ClipboardAddon, canChange: true },
   fit: { name: 'fit', ctor: FitAddon, canChange: false },
   image: { name: 'image', ctor: ImageAddon, canChange: true },
   search: { name: 'search', ctor: SearchAddon, canChange: true },
@@ -179,6 +185,7 @@ const disposeRecreateButtonHandler: () => void = () => {
     socket = null;
     addons.attach.instance = undefined;
     addons.canvas.instance = undefined;
+    addons.clipboard.instance = undefined;
     addons.fit.instance = undefined;
     addons.image.instance = undefined;
     addons.search.instance = undefined;
@@ -228,6 +235,7 @@ if (document.location.pathname === '/test') {
   window.Terminal = Terminal;
   window.AttachAddon = AttachAddon;
   window.CanvasAddon = CanvasAddon;
+  window.ClipboardAddon = ClipboardAddon;
   window.FitAddon = FitAddon;
   window.ImageAddon = ImageAddon;
   window.SearchAddon = SearchAddon;
@@ -287,6 +295,7 @@ function createTerminal(): void {
   addons.fit.instance = new FitAddon();
   addons.image.instance = new ImageAddon();
   addons.unicodeGraphemes.instance = new UnicodeGraphemesAddon();
+  addons.clipboard.instance = new ClipboardAddon();
   try {  // try to start with webgl renderer (might throw on older safari/webkit)
     addons.webgl.instance = new WebglAddon();
   } catch (e) {
@@ -299,6 +308,7 @@ function createTerminal(): void {
   typedTerm.loadAddon(addons.serialize.instance);
   typedTerm.loadAddon(addons.unicodeGraphemes.instance);
   typedTerm.loadAddon(addons.webLinks.instance);
+  typedTerm.loadAddon(addons.clipboard.instance);
 
   window.term = term;  // Expose `term` to window for debugging purposes
   term.onResize((size: { cols: number, rows: number }) => {

demo/tsconfig.json

@@ -7,6 +7,7 @@
     "baseUrl": ".",
     "paths": {
       "xterm-addon-attach": ["../addons/xterm-addon-attach"],
+      "xterm-addon-clipboard": ["../addons/xterm-addon-clipboard"],
       "xterm-addon-fit": ["../addons/xterm-addon-fit"],
       "xterm-addon-image": ["../addons/xterm-addon-image"],
       "xterm-addon-search": ["../addons/xterm-addon-search"],

src/browser/Terminal.ts

@@ -46,7 +46,7 @@ import { CoreTerminal } from 'common/CoreTerminal';
 import { EventEmitter, IEvent, forwardEvent } from 'common/EventEmitter';
 import { MutableDisposable, toDisposable } from 'common/Lifecycle';
 import * as Browser from 'common/Platform';
-import { ColorRequestType, CoreMouseAction, CoreMouseButton, CoreMouseEventType, IColorEvent, ITerminalOptions, KeyboardResultType, ScrollSource, SpecialColorIndex } from 'common/Types';
+import { ColorRequestType, CoreMouseAction, CoreMouseButton, CoreMouseEventType, IClipboardEvent, IColorEvent, ITerminalOptions, KeyboardResultType, ScrollSource, SpecialColorIndex } from 'common/Types';
 import { DEFAULT_ATTR_DATA } from 'common/buffer/BufferLine';
 import { IBuffer } from 'common/buffer/Types';
 import { C0, C1_ESCAPED } from 'common/data/EscapeSequences';
@@ -54,7 +54,7 @@ import { evaluateKeyboardEvent } from 'common/input/Keyboard';
 import { toRgbString } from 'common/input/XParseColor';
 import { DecorationService } from 'common/services/DecorationService';
 import { IDecorationService } from 'common/services/Services';
-import { IDecoration, IDecorationOptions, IDisposable, ILinkProvider, IMarker } from 'xterm';
+import { IDecoration, IDecorationOptions, IDisposable, ILinkProvider, IMarker, IClipboardProvider } from 'xterm';
 import { WindowsOptionsReportType } from '../common/InputHandler';
 import { AccessibilityManager } from './AccessibilityManager';
 
@@ -119,6 +119,7 @@ export class Terminal extends CoreTerminal implements ITerminal {
   public viewport: IViewport | undefined;
   private _compositionHelper: ICompositionHelper | undefined;
   private _accessibilityManager: MutableDisposable<AccessibilityManager> = this.register(new MutableDisposable());
+  private _clipboardProvider: IClipboardProvider | undefined;
 
   private readonly _onCursorMove = this.register(new EventEmitter<void>());
   public readonly onCursorMove = this._onCursorMove.event;
@@ -163,6 +164,7 @@ export class Terminal extends CoreTerminal implements ITerminal {
     this.register(this._inputHandler.onRequestReset(() => this.reset()));
     this.register(this._inputHandler.onRequestWindowsOptionsReport(type => this._reportWindowsOptions(type)));
     this.register(this._inputHandler.onColor((event) => this._handleColorEvent(event)));
+    this.register(this._inputHandler.onClipboard((event) => this._handleClipboardEvent(event)));
     this.register(forwardEvent(this._inputHandler.onCursorMove, this._onCursorMove));
     this.register(forwardEvent(this._inputHandler.onTitleChange, this._onTitleChange));
     this.register(forwardEvent(this._inputHandler.onA11yChar, this._onA11yCharEmitter));
@@ -881,6 +883,14 @@ export class Terminal extends CoreTerminal implements ITerminal {
     return this.linkifier2.registerLinkProvider(linkProvider);
   }
 
+  public registerClipboardProvider(provider: IClipboardProvider): void {
+    this._clipboardProvider = provider;
+  }
+
+  public deregisterClipboardProvider(): void {
+    this._clipboardProvider = undefined;
+  }
+
   public registerCharacterJoiner(handler: CharacterJoinerHandler): number {
     if (!this._characterJoinerService) {
       throw new Error('Terminal must be opened first');
@@ -1281,6 +1291,18 @@ export class Terminal extends CoreTerminal implements ITerminal {
     }
   }
 
+  private _handleClipboardEvent(ev: IClipboardEvent): void {
+    if (!this._clipboardProvider) {
+      return;
+    }
+    if (ev.data === '?') {
+      this._clipboardProvider.readText(ev.selection).then(data =>
+        this.coreService.triggerDataEvent(data));
+      return;
+    }
+    this._clipboardProvider.writeText(ev.selection, ev.data);
+  }
+
   // TODO: Remove cancel function and cancelEvents option
   public cancel(ev: Event, force?: boolean): boolean | undefined {
     if (!this.options.cancelEvents && !force) {