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>

src/common/Types.d.ts

@@ -9,7 +9,7 @@ import { Attributes, UnderlineStyle } from 'common/buffer/Constants'; // eslint-
 import { IBufferSet } from 'common/buffer/Types';
 import { IParams } from 'common/parser/Types';
 import { ICoreMouseService, ICoreService, IOptionsService, IUnicodeService } from 'common/services/Services';
-import { IFunctionIdentifier, ITerminalOptions as IPublicTerminalOptions } from 'xterm';
+import { ClipboardSelection as ClipboardSelection, IFunctionIdentifier, ITerminalOptions as IPublicTerminalOptions } from 'xterm';
 
 export interface ICoreTerminal {
   coreMouseService: ICoreMouseService;
@@ -445,6 +445,16 @@ export interface IColorRestoreRequest {
 }
 export type IColorEvent = (IColorReportRequest | IColorSetRequest | IColorRestoreRequest)[];
 
+export const enum ClipboardEventType {
+  REPORT = 0,
+  SET = 1
+}
+
+export interface IClipboardEvent {
+  type: ClipboardEventType;
+  selection: ClipboardSelection;
+  data: string;
+}
 
 /**
  * Calls the parser and handles actions generated by the parser.
@@ -515,6 +525,7 @@ export interface IInputHandler {
   /** OSC 10 */ setOrReportFgColor(data: string): boolean;
   /** OSC 11 */ setOrReportBgColor(data: string): boolean;
   /** OSC 12 */ setOrReportCursorColor(data: string): boolean;
+  /** OSC 52 */ setOrReportClipboard(data: string): boolean;
   /** OSC 104 */ restoreIndexedColor(data: string): boolean;
   /** OSC 110 */ restoreFgColor(data: string): boolean;
   /** OSC 111 */ restoreBgColor(data: string): boolean;