+++ /dev/null
-/**
- * Copyright (c) 2014 The xterm.js authors. All rights reserved.
- * Copyright (c) 2012-2013, Christopher Jeffrey (MIT License)
- * @license MIT
- */
-
-import { IInputHandler, IInputHandlingTerminal } from './Types';
-import { C0, C1 } from 'common/data/EscapeSequences';
-import { CHARSETS, DEFAULT_CHARSET } from 'common/data/Charsets';
-import { wcwidth } from 'common/CharWidth';
-import { EscapeSequenceParser } from 'common/parser/EscapeSequenceParser';
-import { Disposable } from 'common/Lifecycle';
-import { concat } from 'common/TypedArrayUtils';
-import { StringToUtf32, stringFromCodePoint, utf32ToString, Utf8ToUtf32 } from 'common/input/TextDecoder';
-import { DEFAULT_ATTR_DATA } from 'common/buffer/BufferLine';
-import { EventEmitter, IEvent } from 'common/EventEmitter';
-import { IParsingState, IDcsHandler, IEscapeSequenceParser, IParams, IFunctionIdentifier } from 'common/parser/Types';
-import { NULL_CELL_CODE, NULL_CELL_WIDTH, Attributes, FgFlags, BgFlags, Content } from 'common/buffer/Constants';
-import { CellData } from 'common/buffer/CellData';
-import { AttributeData } from 'common/buffer/AttributeData';
-import { IAttributeData, IDisposable } from 'common/Types';
-import { ICoreService, IBufferService, IOptionsService, ILogService, IDirtyRowService, ICoreMouseService } from 'common/services/Services';
-import { OscHandler } from 'common/parser/OscParser';
-import { DcsHandler } from 'common/parser/DcsParser';
-
-/**
- * Map collect to glevel. Used in `selectCharset`.
- */
-const GLEVEL: {[key: string]: number} = {'(': 0, ')': 1, '*': 2, '+': 3, '-': 1, '.': 2};
-
-/**
- * Max length of the UTF32 input buffer. Real memory consumption is 4 times higher.
- */
-const MAX_PARSEBUFFER_LENGTH = 131072;
-
-
-/**
- * DCS subparser implementations
- */
-
-/**
- * DCS $ q Pt ST
- * DECRQSS (https://vt100.net/docs/vt510-rm/DECRQSS.html)
- * Request Status String (DECRQSS), VT420 and up.
- * Response: DECRPSS (https://vt100.net/docs/vt510-rm/DECRPSS.html)
- */
-class DECRQSS implements IDcsHandler {
- private _data: Uint32Array = new Uint32Array(0);
-
- constructor(
- private _bufferService: IBufferService,
- private _coreService: ICoreService,
- private _logService: ILogService,
- private _optionsService: IOptionsService
- ) { }
-
- hook(params: IParams): void {
- this._data = new Uint32Array(0);
- }
-
- put(data: Uint32Array, start: number, end: number): void {
- this._data = concat(this._data, data.subarray(start, end));
- }
-
- unhook(success: boolean): void {
- if (!success) {
- this._data = new Uint32Array(0);
- return;
- }
- const data = utf32ToString(this._data);
- this._data = new Uint32Array(0);
- switch (data) {
- // valid: DCS 1 $ r Pt ST (xterm)
- case '"q': // DECSCA
- return this._coreService.triggerDataEvent(`${C0.ESC}P1$r0"q${C0.ESC}\\`);
- case '"p': // DECSCL
- return this._coreService.triggerDataEvent(`${C0.ESC}P1$r61"p${C0.ESC}\\`);
- case 'r': // DECSTBM
- const pt = '' + (this._bufferService.buffer.scrollTop + 1) +
- ';' + (this._bufferService.buffer.scrollBottom + 1) + 'r';
- return this._coreService.triggerDataEvent(`${C0.ESC}P1$r${pt}${C0.ESC}\\`);
- case 'm': // SGR
- // TODO: report real settings instead of 0m
- return this._coreService.triggerDataEvent(`${C0.ESC}P1$r0m${C0.ESC}\\`);
- case ' q': // DECSCUSR
- const STYLES: {[key: string]: number} = {'block': 2, 'underline': 4, 'bar': 6};
- let style = STYLES[this._optionsService.options.cursorStyle];
- style -= this._optionsService.options.cursorBlink ? 1 : 0;
- return this._coreService.triggerDataEvent(`${C0.ESC}P1$r${style} q${C0.ESC}\\`);
- default:
- // invalid: DCS 0 $ r Pt ST (xterm)
- this._logService.debug('Unknown DCS $q %s', data);
- this._coreService.triggerDataEvent(`${C0.ESC}P0$r${C0.ESC}\\`);
- }
- }
-}
-
-/**
- * DCS Ps; Ps| Pt ST
- * DECUDK (https://vt100.net/docs/vt510-rm/DECUDK.html)
- * not supported
- */
-
-/**
- * DCS + q Pt ST (xterm)
- * Request Terminfo String
- * not implemented
- */
-
-/**
- * DCS + p Pt ST (xterm)
- * Set Terminfo Data
- * not supported
- */
-
-
-
-/**
- * The terminal's standard implementation of IInputHandler, this handles all
- * input from the Parser.
- *
- * Refer to http://invisible-island.net/xterm/ctlseqs/ctlseqs.html to understand
- * each function's header comment.
- */
-export class InputHandler extends Disposable implements IInputHandler {
- private _parseBuffer: Uint32Array = new Uint32Array(4096);
- private _stringDecoder: StringToUtf32 = new StringToUtf32();
- private _utf8Decoder: Utf8ToUtf32 = new Utf8ToUtf32();
- private _workCell: CellData = new CellData();
-
- private _onCursorMove = new EventEmitter<void>();
- public get onCursorMove(): IEvent<void> { return this._onCursorMove.event; }
- private _onLineFeed = new EventEmitter<void>();
- public get onLineFeed(): IEvent<void> { return this._onLineFeed.event; }
- private _onScroll = new EventEmitter<number>();
- public get onScroll(): IEvent<number> { return this._onScroll.event; }
-
- constructor(
- protected _terminal: IInputHandlingTerminal,
- private readonly _bufferService: IBufferService,
- private readonly _coreService: ICoreService,
- private readonly _dirtyRowService: IDirtyRowService,
- private readonly _logService: ILogService,
- private readonly _optionsService: IOptionsService,
- private readonly _coreMouseService: ICoreMouseService,
- private readonly _parser: IEscapeSequenceParser = new EscapeSequenceParser())
- {
- super();
-
- this.register(this._parser);
-
- /**
- * custom fallback handlers
- */
- this._parser.setCsiHandlerFallback((ident, params) => {
- this._logService.debug('Unknown CSI code: ', { identifier: this._parser.identToString(ident), params: params.toArray() });
- });
- this._parser.setEscHandlerFallback(ident => {
- this._logService.debug('Unknown ESC code: ', { identifier: this._parser.identToString(ident) });
- });
- this._parser.setExecuteHandlerFallback(code => {
- this._logService.debug('Unknown EXECUTE code: ', { code });
- });
- this._parser.setOscHandlerFallback((identifier, action, data) => {
- this._logService.debug('Unknown OSC code: ', { identifier, action, data });
- });
- this._parser.setDcsHandlerFallback((ident, action, payload) => {
- if (action === 'HOOK') {
- payload = payload.toArray();
- }
- this._logService.debug('Unknown DCS code: ', { identifier: this._parser.identToString(ident), action, payload });
- });
-
- /**
- * print handler
- */
- this._parser.setPrintHandler((data, start, end) => this.print(data, start, end));
-
- /**
- * CSI handler
- */
- this._parser.setCsiHandler({final: '@'}, params => this.insertChars(params));
- this._parser.setCsiHandler({intermediates: ' ', final: '@'}, params => this.scrollLeft(params));
- this._parser.setCsiHandler({final: 'A'}, params => this.cursorUp(params));
- this._parser.setCsiHandler({intermediates: ' ', final: 'A'}, params => this.scrollRight(params));
- this._parser.setCsiHandler({final: 'B'}, params => this.cursorDown(params));
- this._parser.setCsiHandler({final: 'C'}, params => this.cursorForward(params));
- this._parser.setCsiHandler({final: 'D'}, params => this.cursorBackward(params));
- this._parser.setCsiHandler({final: 'E'}, params => this.cursorNextLine(params));
- this._parser.setCsiHandler({final: 'F'}, params => this.cursorPrecedingLine(params));
- this._parser.setCsiHandler({final: 'G'}, params => this.cursorCharAbsolute(params));
- this._parser.setCsiHandler({final: 'H'}, params => this.cursorPosition(params));
- this._parser.setCsiHandler({final: 'I'}, params => this.cursorForwardTab(params));
- this._parser.setCsiHandler({final: 'J'}, params => this.eraseInDisplay(params));
- this._parser.setCsiHandler({prefix: '?', final: 'J'}, params => this.eraseInDisplay(params));
- this._parser.setCsiHandler({final: 'K'}, params => this.eraseInLine(params));
- this._parser.setCsiHandler({prefix: '?', final: 'K'}, params => this.eraseInLine(params));
- this._parser.setCsiHandler({final: 'L'}, params => this.insertLines(params));
- this._parser.setCsiHandler({final: 'M'}, params => this.deleteLines(params));
- this._parser.setCsiHandler({final: 'P'}, params => this.deleteChars(params));
- this._parser.setCsiHandler({final: 'S'}, params => this.scrollUp(params));
- this._parser.setCsiHandler({final: 'T'}, params => this.scrollDown(params));
- this._parser.setCsiHandler({final: 'X'}, params => this.eraseChars(params));
- this._parser.setCsiHandler({final: 'Z'}, params => this.cursorBackwardTab(params));
- this._parser.setCsiHandler({final: '`'}, params => this.charPosAbsolute(params));
- this._parser.setCsiHandler({final: 'a'}, params => this.hPositionRelative(params));
- this._parser.setCsiHandler({final: 'b'}, params => this.repeatPrecedingCharacter(params));
- this._parser.setCsiHandler({final: 'c'}, params => this.sendDeviceAttributesPrimary(params));
- this._parser.setCsiHandler({prefix: '>', final: 'c'}, params => this.sendDeviceAttributesSecondary(params));
- this._parser.setCsiHandler({final: 'd'}, params => this.linePosAbsolute(params));
- this._parser.setCsiHandler({final: 'e'}, params => this.vPositionRelative(params));
- this._parser.setCsiHandler({final: 'f'}, params => this.hVPosition(params));
- this._parser.setCsiHandler({final: 'g'}, params => this.tabClear(params));
- this._parser.setCsiHandler({final: 'h'}, params => this.setMode(params));
- this._parser.setCsiHandler({prefix: '?', final: 'h'}, params => this.setModePrivate(params));
- this._parser.setCsiHandler({final: 'l'}, params => this.resetMode(params));
- this._parser.setCsiHandler({prefix: '?', final: 'l'}, params => this.resetModePrivate(params));
- this._parser.setCsiHandler({final: 'm'}, params => this.charAttributes(params));
- this._parser.setCsiHandler({final: 'n'}, params => this.deviceStatus(params));
- this._parser.setCsiHandler({prefix: '?', final: 'n'}, params => this.deviceStatusPrivate(params));
- this._parser.setCsiHandler({intermediates: '!', final: 'p'}, params => this.softReset(params));
- this._parser.setCsiHandler({intermediates: ' ', final: 'q'}, params => this.setCursorStyle(params));
- this._parser.setCsiHandler({final: 'r'}, params => this.setScrollRegion(params));
- this._parser.setCsiHandler({final: 's'}, params => this.saveCursor(params));
- this._parser.setCsiHandler({final: 'u'}, params => this.restoreCursor(params));
- this._parser.setCsiHandler({intermediates: '\'', final: '}'}, params => this.insertColumns(params));
- this._parser.setCsiHandler({intermediates: '\'', final: '~'}, params => this.deleteColumns(params));
-
- /**
- * execute handler
- */
- this._parser.setExecuteHandler(C0.BEL, () => this.bell());
- this._parser.setExecuteHandler(C0.LF, () => this.lineFeed());
- this._parser.setExecuteHandler(C0.VT, () => this.lineFeed());
- this._parser.setExecuteHandler(C0.FF, () => this.lineFeed());
- this._parser.setExecuteHandler(C0.CR, () => this.carriageReturn());
- this._parser.setExecuteHandler(C0.BS, () => this.backspace());
- this._parser.setExecuteHandler(C0.HT, () => this.tab());
- this._parser.setExecuteHandler(C0.SO, () => this.shiftOut());
- this._parser.setExecuteHandler(C0.SI, () => this.shiftIn());
- // FIXME: What do to with missing? Old code just added those to print.
-
- this._parser.setExecuteHandler(C1.IND, () => this.index());
- this._parser.setExecuteHandler(C1.NEL, () => this.nextLine());
- this._parser.setExecuteHandler(C1.HTS, () => this.tabSet());
-
- /**
- * OSC handler
- */
- // 0 - icon name + title
- this._parser.setOscHandler(0, new OscHandler((data: string) => this.setTitle(data)));
- // 1 - icon name
- // 2 - title
- this._parser.setOscHandler(2, new OscHandler((data: string) => this.setTitle(data)));
- // 3 - set property X in the form "prop=value"
- // 4 - Change Color Number
- // 5 - Change Special Color Number
- // 6 - Enable/disable Special Color Number c
- // 7 - current directory? (not in xterm spec, see https://gitlab.com/gnachman/iterm2/issues/3939)
- // 10 - Change VT100 text foreground color to Pt.
- // 11 - Change VT100 text background color to Pt.
- // 12 - Change text cursor color to Pt.
- // 13 - Change mouse foreground color to Pt.
- // 14 - Change mouse background color to Pt.
- // 15 - Change Tektronix foreground color to Pt.
- // 16 - Change Tektronix background color to Pt.
- // 17 - Change highlight background color to Pt.
- // 18 - Change Tektronix cursor color to Pt.
- // 19 - Change highlight foreground color to Pt.
- // 46 - Change Log File to Pt.
- // 50 - Set Font to Pt.
- // 51 - reserved for Emacs shell.
- // 52 - Manipulate Selection Data.
- // 104 ; c - Reset Color Number c.
- // 105 ; c - Reset Special Color Number c.
- // 106 ; c; f - Enable/disable Special Color Number c.
- // 110 - Reset VT100 text foreground color.
- // 111 - Reset VT100 text background color.
- // 112 - Reset text cursor color.
- // 113 - Reset mouse foreground color.
- // 114 - Reset mouse background color.
- // 115 - Reset Tektronix foreground color.
- // 116 - Reset Tektronix background color.
- // 117 - Reset highlight color.
- // 118 - Reset Tektronix cursor color.
- // 119 - Reset highlight foreground color.
-
- /**
- * ESC handlers
- */
- this._parser.setEscHandler({final: '7'}, () => this.saveCursor());
- this._parser.setEscHandler({final: '8'}, () => this.restoreCursor());
- this._parser.setEscHandler({final: 'D'}, () => this.index());
- this._parser.setEscHandler({final: 'E'}, () => this.nextLine());
- this._parser.setEscHandler({final: 'H'}, () => this.tabSet());
- this._parser.setEscHandler({final: 'M'}, () => this.reverseIndex());
- this._parser.setEscHandler({final: '='}, () => this.keypadApplicationMode());
- this._parser.setEscHandler({final: '>'}, () => this.keypadNumericMode());
- this._parser.setEscHandler({final: 'c'}, () => this.reset());
- this._parser.setEscHandler({final: 'n'}, () => this.setgLevel(2));
- this._parser.setEscHandler({final: 'o'}, () => this.setgLevel(3));
- this._parser.setEscHandler({final: '|'}, () => this.setgLevel(3));
- this._parser.setEscHandler({final: '}'}, () => this.setgLevel(2));
- this._parser.setEscHandler({final: '~'}, () => this.setgLevel(1));
- this._parser.setEscHandler({intermediates: '%', final: '@'}, () => this.selectDefaultCharset());
- this._parser.setEscHandler({intermediates: '%', final: 'G'}, () => this.selectDefaultCharset());
- for (const flag in CHARSETS) {
- this._parser.setEscHandler({intermediates: '(', final: flag}, () => this.selectCharset('(' + flag));
- this._parser.setEscHandler({intermediates: ')', final: flag}, () => this.selectCharset(')' + flag));
- this._parser.setEscHandler({intermediates: '*', final: flag}, () => this.selectCharset('*' + flag));
- this._parser.setEscHandler({intermediates: '+', final: flag}, () => this.selectCharset('+' + flag));
- this._parser.setEscHandler({intermediates: '-', final: flag}, () => this.selectCharset('-' + flag));
- this._parser.setEscHandler({intermediates: '.', final: flag}, () => this.selectCharset('.' + flag));
- this._parser.setEscHandler({intermediates: '/', final: flag}, () => this.selectCharset('/' + flag)); // TODO: supported?
- }
- this._parser.setEscHandler({intermediates: '#', final: '8'}, () => this.screenAlignmentPattern());
-
- /**
- * error handler
- */
- this._parser.setErrorHandler((state: IParsingState) => {
- this._logService.error('Parsing error: ', state);
- return state;
- });
-
- /**
- * DCS handler
- */
- this._parser.setDcsHandler({intermediates: '$', final: 'q'}, new DECRQSS(this._bufferService, this._coreService, this._logService, this._optionsService));
- }
-
- public dispose(): void {
- super.dispose();
- }
-
- public parse(data: string | Uint8Array): void {
- let buffer = this._bufferService.buffer;
- const cursorStartX = buffer.x;
- const cursorStartY = buffer.y;
-
- this._logService.debug('parsing data', data);
-
- // resize input buffer if needed
- if (this._parseBuffer.length < data.length) {
- if (this._parseBuffer.length < MAX_PARSEBUFFER_LENGTH) {
- this._parseBuffer = new Uint32Array(Math.min(data.length, MAX_PARSEBUFFER_LENGTH));
- }
- }
-
- // process big data in smaller chunks
- if (data.length > MAX_PARSEBUFFER_LENGTH) {
- for (let i = 0; i < data.length; i += MAX_PARSEBUFFER_LENGTH) {
- const end = i + MAX_PARSEBUFFER_LENGTH < data.length ? i + MAX_PARSEBUFFER_LENGTH : data.length;
- const len = (typeof data === 'string')
- ? this._stringDecoder.decode(data.substring(i, end), this._parseBuffer)
- : this._utf8Decoder.decode(data.subarray(i, end), this._parseBuffer);
- this._parser.parse(this._parseBuffer, len);
- }
- } else {
- const len = (typeof data === 'string')
- ? this._stringDecoder.decode(data, this._parseBuffer)
- : this._utf8Decoder.decode(data, this._parseBuffer);
- this._parser.parse(this._parseBuffer, len);
- }
-
- buffer = this._bufferService.buffer;
- if (buffer.x !== cursorStartX || buffer.y !== cursorStartY) {
- this._onCursorMove.fire();
- }
- this._terminal.refresh(this._dirtyRowService.start, this._dirtyRowService.end);
- }
-
- public print(data: Uint32Array, start: number, end: number): void {
- let code: number;
- let chWidth: number;
- const buffer = this._bufferService.buffer;
- const charset = this._terminal.charset;
- const screenReaderMode = this._optionsService.options.screenReaderMode;
- const cols = this._bufferService.cols;
- const wraparoundMode = this._terminal.wraparoundMode;
- const insertMode = this._terminal.insertMode;
- const curAttr = this._terminal.curAttrData;
- let bufferRow = buffer.lines.get(buffer.y + buffer.ybase);
-
- this._dirtyRowService.markDirty(buffer.y);
- for (let pos = start; pos < end; ++pos) {
- code = data[pos];
-
- // calculate print space
- // expensive call, therefore we save width in line buffer
- chWidth = wcwidth(code);
-
- // get charset replacement character
- // charset is only defined for ASCII, therefore we only
- // search for an replacement char if code < 127
- if (code < 127 && charset) {
- const ch = charset[String.fromCharCode(code)];
- if (ch) {
- code = ch.charCodeAt(0);
- }
- }
-
- if (screenReaderMode) {
- this._terminal.onA11yCharEmitter.fire(stringFromCodePoint(code));
- }
-
- // insert combining char at last cursor position
- // FIXME: needs handling after cursor jumps
- // buffer.x should never be 0 for a combining char
- // since they always follow a cell consuming char
- // therefore we can test for buffer.x to avoid overflow left
- if (!chWidth && buffer.x) {
- if (!bufferRow.getWidth(buffer.x - 1)) {
- // found empty cell after fullwidth, need to go 2 cells back
- // it is save to step 2 cells back here
- // since an empty cell is only set by fullwidth chars
- bufferRow.addCodepointToCell(buffer.x - 2, code);
- } else {
- bufferRow.addCodepointToCell(buffer.x - 1, code);
- }
- continue;
- }
-
- // goto next line if ch would overflow
- // TODO: needs a global min terminal width of 2
- // FIXME: additionally ensure chWidth fits into a line
- // --> maybe forbid cols<xy at higher level as it would
- // introduce a bad runtime penalty here
- if (buffer.x + chWidth - 1 >= cols) {
- // autowrap - DECAWM
- // automatically wraps to the beginning of the next line
- if (wraparoundMode) {
- buffer.x = 0;
- buffer.y++;
- if (buffer.y === buffer.scrollBottom + 1) {
- buffer.y--;
- this._terminal.scroll(true);
- } else {
- if (buffer.y >= this._bufferService.rows) {
- buffer.y = this._bufferService.rows - 1;
- }
- // The line already exists (eg. the initial viewport), mark it as a
- // wrapped line
- buffer.lines.get(buffer.y).isWrapped = true;
- }
- // row changed, get it again
- bufferRow = buffer.lines.get(buffer.y + buffer.ybase);
- } else {
- buffer.x = cols - 1;
- if (chWidth === 2) {
- // FIXME: check for xterm behavior
- // What to do here? We got a wide char that does not fit into last cell
- continue;
- }
- }
- }
-
- // insert mode: move characters to right
- if (insertMode) {
- // right shift cells according to the width
- bufferRow.insertCells(buffer.x, chWidth, buffer.getNullCell(curAttr));
- // test last cell - since the last cell has only room for
- // a halfwidth char any fullwidth shifted there is lost
- // and will be set to empty cell
- if (bufferRow.getWidth(cols - 1) === 2) {
- bufferRow.setCellFromCodePoint(cols - 1, NULL_CELL_CODE, NULL_CELL_WIDTH, curAttr.fg, curAttr.bg);
- }
- }
-
- // write current char to buffer and advance cursor
- bufferRow.setCellFromCodePoint(buffer.x++, code, chWidth, curAttr.fg, curAttr.bg);
-
- // fullwidth char - also set next cell to placeholder stub and advance cursor
- // for graphemes bigger than fullwidth we can simply loop to zero
- // we already made sure above, that buffer.x + chWidth will not overflow right
- if (chWidth > 0) {
- while (--chWidth) {
- // other than a regular empty cell a cell following a wide char has no width
- bufferRow.setCellFromCodePoint(buffer.x++, 0, 0, curAttr.fg, curAttr.bg);
- }
- }
- }
- // store last char in Parser.precedingCodepoint for REP to work correctly
- // This needs to check whether:
- // - fullwidth + surrogates: reset
- // - combining: only base char gets carried on (bug in xterm?)
- if (end) {
- bufferRow.loadCell(buffer.x - 1, this._workCell);
- if (this._workCell.getWidth() === 2 || this._workCell.getCode() > 0xFFFF) {
- this._parser.precedingCodepoint = 0;
- } else if (this._workCell.isCombined()) {
- this._parser.precedingCodepoint = this._workCell.getChars().charCodeAt(0);
- } else {
- this._parser.precedingCodepoint = this._workCell.content;
- }
- }
- this._dirtyRowService.markDirty(buffer.y);
- }
-
- /**
- * Forward addCsiHandler from parser.
- */
- public addCsiHandler(id: IFunctionIdentifier, callback: (params: IParams) => boolean): IDisposable {
- return this._parser.addCsiHandler(id, callback);
- }
-
- /**
- * Forward addDcsHandler from parser.
- */
- public addDcsHandler(id: IFunctionIdentifier, callback: (data: string, param: IParams) => boolean): IDisposable {
- return this._parser.addDcsHandler(id, new DcsHandler(callback));
- }
-
- /**
- * Forward addEscHandler from parser.
- */
- public addEscHandler(id: IFunctionIdentifier, callback: () => boolean): IDisposable {
- return this._parser.addEscHandler(id, callback);
- }
-
- /**
- * Forward addOscHandler from parser.
- */
- public addOscHandler(ident: number, callback: (data: string) => boolean): IDisposable {
- return this._parser.addOscHandler(ident, new OscHandler(callback));
- }
-
- /**
- * BEL
- * Bell (Ctrl-G).
- */
- public bell(): void {
- this._terminal.bell();
- }
-
- /**
- * LF
- * Line Feed or New Line (NL). (LF is Ctrl-J).
- */
- public lineFeed(): void {
- // make buffer local for faster access
- const buffer = this._bufferService.buffer;
-
- if (this._optionsService.options.convertEol) {
- buffer.x = 0;
- }
- buffer.y++;
- if (buffer.y === buffer.scrollBottom + 1) {
- buffer.y--;
- this._terminal.scroll();
- } else if (buffer.y >= this._bufferService.rows) {
- buffer.y = this._bufferService.rows - 1;
- }
- // If the end of the line is hit, prevent this action from wrapping around to the next line.
- if (buffer.x >= this._bufferService.cols) {
- buffer.x--;
- }
-
- this._onLineFeed.fire();
- }
-
- /**
- * CR
- * Carriage Return (Ctrl-M).
- */
- public carriageReturn(): void {
- this._bufferService.buffer.x = 0;
- }
-
- /**
- * BS
- * Backspace (Ctrl-H).
- */
- public backspace(): void {
- this._restrictCursor();
- if (this._bufferService.buffer.x > 0) {
- this._bufferService.buffer.x--;
- }
- }
-
- /**
- * TAB
- * Horizontal Tab (HT) (Ctrl-I).
- */
- public tab(): void {
- if (this._bufferService.buffer.x >= this._bufferService.cols) {
- return;
- }
- const originalX = this._bufferService.buffer.x;
- this._bufferService.buffer.x = this._bufferService.buffer.nextStop();
- if (this._optionsService.options.screenReaderMode) {
- this._terminal.onA11yTabEmitter.fire(this._bufferService.buffer.x - originalX);
- }
- }
-
- /**
- * SO
- * Shift Out (Ctrl-N) -> Switch to Alternate Character Set. This invokes the
- * G1 character set.
- */
- public shiftOut(): void {
- this._terminal.setgLevel(1);
- }
-
- /**
- * SI
- * Shift In (Ctrl-O) -> Switch to Standard Character Set. This invokes the G0
- * character set (the default).
- */
- public shiftIn(): void {
- this._terminal.setgLevel(0);
- }
-
- /**
- * Restrict cursor to viewport size / scroll margin (origin mode).
- */
- private _restrictCursor(): void {
- this._bufferService.buffer.x = Math.min(this._bufferService.cols - 1, Math.max(0, this._bufferService.buffer.x));
- this._bufferService.buffer.y = this._terminal.originMode
- ? Math.min(this._bufferService.buffer.scrollBottom, Math.max(this._bufferService.buffer.scrollTop, this._bufferService.buffer.y))
- : Math.min(this._bufferService.rows - 1, Math.max(0, this._bufferService.buffer.y));
- }
-
- /**
- * Set absolute cursor position.
- */
- private _setCursor(x: number, y: number): void {
- if (this._terminal.originMode) {
- this._bufferService.buffer.x = x;
- this._bufferService.buffer.y = this._bufferService.buffer.scrollTop + y;
- } else {
- this._bufferService.buffer.x = x;
- this._bufferService.buffer.y = y;
- }
- this._restrictCursor();
- }
-
- /**
- * Set relative cursor position.
- */
- private _moveCursor(x: number, y: number): void {
- // for relative changes we have to make sure we are within 0 .. cols/rows - 1
- // before calculating the new position
- this._restrictCursor();
- this._setCursor(this._bufferService.buffer.x + x, this._bufferService.buffer.y + y);
- }
-
- /**
- * CSI Ps A
- * Cursor Up Ps Times (default = 1) (CUU).
- */
- public cursorUp(params: IParams): void {
- // stop at scrollTop
- const diffToTop = this._bufferService.buffer.y - this._bufferService.buffer.scrollTop;
- if (diffToTop >= 0) {
- this._moveCursor(0, -Math.min(diffToTop, params.params[0] || 1));
- } else {
- this._moveCursor(0, -(params.params[0] || 1));
- }
- }
-
- /**
- * CSI Ps B
- * Cursor Down Ps Times (default = 1) (CUD).
- */
- public cursorDown(params: IParams): void {
- // stop at scrollBottom
- const diffToBottom = this._bufferService.buffer.scrollBottom - this._bufferService.buffer.y;
- if (diffToBottom >= 0) {
- this._moveCursor(0, Math.min(diffToBottom, params.params[0] || 1));
- } else {
- this._moveCursor(0, params.params[0] || 1);
- }
- }
-
- /**
- * CSI Ps C
- * Cursor Forward Ps Times (default = 1) (CUF).
- */
- public cursorForward(params: IParams): void {
- this._moveCursor(params.params[0] || 1, 0);
- }
-
- /**
- * CSI Ps D
- * Cursor Backward Ps Times (default = 1) (CUB).
- */
- public cursorBackward(params: IParams): void {
- this._moveCursor(-(params.params[0] || 1), 0);
- }
-
- /**
- * CSI Ps E
- * Cursor Next Line Ps Times (default = 1) (CNL).
- * Other than cursorDown (CUD) also set the cursor to first column.
- */
- public cursorNextLine(params: IParams): void {
- this.cursorDown(params);
- this._bufferService.buffer.x = 0;
- }
-
- /**
- * CSI Ps F
- * Cursor Previous Line Ps Times (default = 1) (CPL).
- * Other than cursorUp (CUU) also set the cursor to first column.
- */
- public cursorPrecedingLine(params: IParams): void {
- this.cursorUp(params);
- this._bufferService.buffer.x = 0;
- }
-
- /**
- * CSI Ps G
- * Cursor Character Absolute [column] (default = [row,1]) (CHA).
- */
- public cursorCharAbsolute(params: IParams): void {
- this._setCursor((params.params[0] || 1) - 1, this._bufferService.buffer.y);
- }
-
- /**
- * CSI Ps ; Ps H
- * Cursor Position [row;column] (default = [1,1]) (CUP).
- */
- public cursorPosition(params: IParams): void {
- this._setCursor(
- // col
- (params.length >= 2) ? (params.params[1] || 1) - 1 : 0,
- // row
- (params.params[0] || 1) - 1);
- }
-
- /**
- * CSI Pm ` Character Position Absolute
- * [column] (default = [row,1]) (HPA).
- * Currently same functionality as CHA.
- */
- public charPosAbsolute(params: IParams): void {
- this._setCursor((params.params[0] || 1) - 1, this._bufferService.buffer.y);
- }
-
- /**
- * CSI Pm a Character Position Relative
- * [columns] (default = [row,col+1]) (HPR)
- * Currently same functionality as CUF.
- */
- public hPositionRelative(params: IParams): void {
- this._moveCursor(params.params[0] || 1, 0);
- }
-
- /**
- * CSI Pm d Vertical Position Absolute (VPA)
- * [row] (default = [1,column])
- */
- public linePosAbsolute(params: IParams): void {
- this._setCursor(this._bufferService.buffer.x, (params.params[0] || 1) - 1);
- }
-
- /**
- * CSI Pm e Vertical Position Relative (VPR)
- * [rows] (default = [row+1,column])
- * reuse CSI Ps B ?
- */
- public vPositionRelative(params: IParams): void {
- this._moveCursor(0, params.params[0] || 1);
- }
-
- /**
- * CSI Ps ; Ps f
- * Horizontal and Vertical Position [row;column] (default =
- * [1,1]) (HVP).
- * Same as CUP.
- */
- public hVPosition(params: IParams): void {
- this.cursorPosition(params);
- }
-
- /**
- * CSI Ps g Tab Clear (TBC).
- * Ps = 0 -> Clear Current Column (default).
- * Ps = 3 -> Clear All.
- * Potentially:
- * Ps = 2 -> Clear Stops on Line.
- * http://vt100.net/annarbor/aaa-ug/section6.html
- */
- public tabClear(params: IParams): void {
- const param = params.params[0];
- if (param === 0) {
- delete this._bufferService.buffer.tabs[this._bufferService.buffer.x];
- } else if (param === 3) {
- this._bufferService.buffer.tabs = {};
- }
- }
-
- /**
- * CSI Ps I
- * Cursor Forward Tabulation Ps tab stops (default = 1) (CHT).
- */
- public cursorForwardTab(params: IParams): void {
- if (this._bufferService.buffer.x >= this._bufferService.cols) {
- return;
- }
- let param = params.params[0] || 1;
- while (param--) {
- this._bufferService.buffer.x = this._bufferService.buffer.nextStop();
- }
- }
-
- /**
- * CSI Ps Z Cursor Backward Tabulation Ps tab stops (default = 1) (CBT).
- */
- public cursorBackwardTab(params: IParams): void {
- if (this._bufferService.buffer.x >= this._bufferService.cols) {
- return;
- }
- let param = params.params[0] || 1;
-
- // make buffer local for faster access
- const buffer = this._bufferService.buffer;
-
- while (param--) {
- buffer.x = buffer.prevStop();
- }
- }
-
-
- /**
- * Helper method to erase cells in a terminal row.
- * The cell gets replaced with the eraseChar of the terminal.
- * @param y row index
- * @param start first cell index to be erased
- * @param end end - 1 is last erased cell
- */
- private _eraseInBufferLine(y: number, start: number, end: number, clearWrap: boolean = false): void {
- const line = this._bufferService.buffer.lines.get(this._bufferService.buffer.ybase + y);
- line.replaceCells(
- start,
- end,
- this._bufferService.buffer.getNullCell(this._terminal.eraseAttrData())
- );
- if (clearWrap) {
- line.isWrapped = false;
- }
- }
-
- /**
- * Helper method to reset cells in a terminal row.
- * The cell gets replaced with the eraseChar of the terminal and the isWrapped property is set to false.
- * @param y row index
- */
- private _resetBufferLine(y: number): void {
- const line = this._bufferService.buffer.lines.get(this._bufferService.buffer.ybase + y);
- line.fill(this._bufferService.buffer.getNullCell(this._terminal.eraseAttrData()));
- line.isWrapped = false;
- }
-
- /**
- * CSI Ps J Erase in Display (ED).
- * Ps = 0 -> Erase Below (default).
- * Ps = 1 -> Erase Above.
- * Ps = 2 -> Erase All.
- * Ps = 3 -> Erase Saved Lines (xterm).
- * CSI ? Ps J
- * Erase in Display (DECSED).
- * Ps = 0 -> Selective Erase Below (default).
- * Ps = 1 -> Selective Erase Above.
- * Ps = 2 -> Selective Erase All.
- */
- public eraseInDisplay(params: IParams): void {
- this._restrictCursor();
- let j;
- switch (params.params[0]) {
- case 0:
- j = this._bufferService.buffer.y;
- this._dirtyRowService.markDirty(j);
- this._eraseInBufferLine(j++, this._bufferService.buffer.x, this._bufferService.cols, this._bufferService.buffer.x === 0);
- for (; j < this._bufferService.rows; j++) {
- this._resetBufferLine(j);
- }
- this._dirtyRowService.markDirty(j);
- break;
- case 1:
- j = this._bufferService.buffer.y;
- this._dirtyRowService.markDirty(j);
- // Deleted front part of line and everything before. This line will no longer be wrapped.
- this._eraseInBufferLine(j, 0, this._bufferService.buffer.x + 1, true);
- if (this._bufferService.buffer.x + 1 >= this._bufferService.cols) {
- // Deleted entire previous line. This next line can no longer be wrapped.
- this._bufferService.buffer.lines.get(j + 1).isWrapped = false;
- }
- while (j--) {
- this._resetBufferLine(j);
- }
- this._dirtyRowService.markDirty(0);
- break;
- case 2:
- j = this._bufferService.rows;
- this._dirtyRowService.markDirty(j - 1);
- while (j--) {
- this._resetBufferLine(j);
- }
- this._dirtyRowService.markDirty(0);
- break;
- case 3:
- // Clear scrollback (everything not in viewport)
- const scrollBackSize = this._bufferService.buffer.lines.length - this._bufferService.rows;
- if (scrollBackSize > 0) {
- this._bufferService.buffer.lines.trimStart(scrollBackSize);
- this._bufferService.buffer.ybase = Math.max(this._bufferService.buffer.ybase - scrollBackSize, 0);
- this._bufferService.buffer.ydisp = Math.max(this._bufferService.buffer.ydisp - scrollBackSize, 0);
- // Force a scroll event to refresh viewport
- this._onScroll.fire(0);
- }
- break;
- }
- }
-
- /**
- * CSI Ps K Erase in Line (EL).
- * Ps = 0 -> Erase to Right (default).
- * Ps = 1 -> Erase to Left.
- * Ps = 2 -> Erase All.
- * CSI ? Ps K
- * Erase in Line (DECSEL).
- * Ps = 0 -> Selective Erase to Right (default).
- * Ps = 1 -> Selective Erase to Left.
- * Ps = 2 -> Selective Erase All.
- */
- public eraseInLine(params: IParams): void {
- this._restrictCursor();
- switch (params.params[0]) {
- case 0:
- this._eraseInBufferLine(this._bufferService.buffer.y, this._bufferService.buffer.x, this._bufferService.cols);
- break;
- case 1:
- this._eraseInBufferLine(this._bufferService.buffer.y, 0, this._bufferService.buffer.x + 1);
- break;
- case 2:
- this._eraseInBufferLine(this._bufferService.buffer.y, 0, this._bufferService.cols);
- break;
- }
- this._dirtyRowService.markDirty(this._bufferService.buffer.y);
- }
-
- /**
- * CSI Ps L
- * Insert Ps Line(s) (default = 1) (IL).
- */
- public insertLines(params: IParams): void {
- this._restrictCursor();
- let param = params.params[0] || 1;
-
- // make buffer local for faster access
- const buffer = this._bufferService.buffer;
-
- if (buffer.y > buffer.scrollBottom || buffer.y < buffer.scrollTop) {
- return;
- }
-
- const row: number = buffer.y + buffer.ybase;
-
- const scrollBottomRowsOffset = this._bufferService.rows - 1 - buffer.scrollBottom;
- const scrollBottomAbsolute = this._bufferService.rows - 1 + buffer.ybase - scrollBottomRowsOffset + 1;
- while (param--) {
- // test: echo -e '\e[44m\e[1L\e[0m'
- // blankLine(true) - xterm/linux behavior
- buffer.lines.splice(scrollBottomAbsolute - 1, 1);
- buffer.lines.splice(row, 0, buffer.getBlankLine(this._terminal.eraseAttrData()));
- }
-
- this._dirtyRowService.markRangeDirty(buffer.y, buffer.scrollBottom);
- buffer.x = 0; // see https://vt100.net/docs/vt220-rm/chapter4.html - vt220 only?
- }
-
- /**
- * CSI Ps M
- * Delete Ps Line(s) (default = 1) (DL).
- */
- public deleteLines(params: IParams): void {
- this._restrictCursor();
- let param = params.params[0] || 1;
-
- // make buffer local for faster access
- const buffer = this._bufferService.buffer;
-
- if (buffer.y > buffer.scrollBottom || buffer.y < buffer.scrollTop) {
- return;
- }
-
- const row: number = buffer.y + buffer.ybase;
-
- let j: number;
- j = this._bufferService.rows - 1 - buffer.scrollBottom;
- j = this._bufferService.rows - 1 + buffer.ybase - j;
- while (param--) {
- // test: echo -e '\e[44m\e[1M\e[0m'
- // blankLine(true) - xterm/linux behavior
- buffer.lines.splice(row, 1);
- buffer.lines.splice(j, 0, buffer.getBlankLine(this._terminal.eraseAttrData()));
- }
-
- this._dirtyRowService.markRangeDirty(buffer.y, buffer.scrollBottom);
- buffer.x = 0; // see https://vt100.net/docs/vt220-rm/chapter4.html - vt220 only?
- }
-
- /**
- * CSI Ps @
- * Insert Ps (Blank) Character(s) (default = 1) (ICH).
- */
- public insertChars(params: IParams): void {
- this._restrictCursor();
- const line = this._bufferService.buffer.lines.get(this._bufferService.buffer.y + this._bufferService.buffer.ybase);
- if (line) {
- line.insertCells(
- this._bufferService.buffer.x,
- params.params[0] || 1,
- this._bufferService.buffer.getNullCell(this._terminal.eraseAttrData())
- );
- this._dirtyRowService.markDirty(this._bufferService.buffer.y);
- }
- }
-
- /**
- * CSI Ps P
- * Delete Ps Character(s) (default = 1) (DCH).
- */
- public deleteChars(params: IParams): void {
- this._restrictCursor();
- const line = this._bufferService.buffer.lines.get(this._bufferService.buffer.y + this._bufferService.buffer.ybase);
- if (line) {
- line.deleteCells(
- this._bufferService.buffer.x,
- params.params[0] || 1,
- this._bufferService.buffer.getNullCell(this._terminal.eraseAttrData())
- );
- this._dirtyRowService.markDirty(this._bufferService.buffer.y);
- }
- }
-
- /**
- * CSI Ps S Scroll up Ps lines (default = 1) (SU).
- */
- public scrollUp(params: IParams): void {
- let param = params.params[0] || 1;
-
- // make buffer local for faster access
- const buffer = this._bufferService.buffer;
-
- while (param--) {
- buffer.lines.splice(buffer.ybase + buffer.scrollTop, 1);
- buffer.lines.splice(buffer.ybase + buffer.scrollBottom, 0, buffer.getBlankLine(this._terminal.eraseAttrData()));
- }
- this._dirtyRowService.markRangeDirty(buffer.scrollTop, buffer.scrollBottom);
- }
-
- /**
- * CSI Ps T Scroll down Ps lines (default = 1) (SD).
- */
- public scrollDown(params: IParams): void {
- let param = params.params[0] || 1;
-
- // make buffer local for faster access
- const buffer = this._bufferService.buffer;
-
- while (param--) {
- buffer.lines.splice(buffer.ybase + buffer.scrollBottom, 1);
- buffer.lines.splice(buffer.ybase + buffer.scrollTop, 0, buffer.getBlankLine(DEFAULT_ATTR_DATA));
- }
- this._dirtyRowService.markRangeDirty(buffer.scrollTop, buffer.scrollBottom);
- }
-
- /**
- * CSI Ps SP @ Scroll left Ps columns (default = 1) (SL) ECMA-48
- *
- * Notation: (Pn)
- * Representation: CSI Pn 02/00 04/00
- * Parameter default value: Pn = 1
- * SL causes the data in the presentation component to be moved by n character positions
- * if the line orientation is horizontal, or by n line positions if the line orientation
- * is vertical, such that the data appear to move to the left; where n equals the value of Pn.
- * The active presentation position is not affected by this control function.
- *
- * Supported:
- * - always left shift (no line orientation setting respected)
- */
- public scrollLeft(params: IParams): void {
- const buffer = this._bufferService.buffer;
- if (buffer.y > buffer.scrollBottom || buffer.y < buffer.scrollTop) {
- return;
- }
- const param = params.params[0] || 1;
- for (let y = buffer.scrollTop; y <= buffer.scrollBottom; ++y) {
- const line = buffer.lines.get(buffer.ybase + y);
- line.deleteCells(0, param, buffer.getNullCell(this._terminal.eraseAttrData()));
- line.isWrapped = false;
- }
- this._dirtyRowService.markRangeDirty(buffer.scrollTop, buffer.scrollBottom);
- }
-
- /**
- * CSI Ps SP A Scroll right Ps columns (default = 1) (SR) ECMA-48
- *
- * Notation: (Pn)
- * Representation: CSI Pn 02/00 04/01
- * Parameter default value: Pn = 1
- * SR causes the data in the presentation component to be moved by n character positions
- * if the line orientation is horizontal, or by n line positions if the line orientation
- * is vertical, such that the data appear to move to the right; where n equals the value of Pn.
- * The active presentation position is not affected by this control function.
- *
- * Supported:
- * - always right shift (no line orientation setting respected)
- */
- public scrollRight(params: IParams): void {
- const buffer = this._bufferService.buffer;
- if (buffer.y > buffer.scrollBottom || buffer.y < buffer.scrollTop) {
- return;
- }
- const param = params.params[0] || 1;
- for (let y = buffer.scrollTop; y <= buffer.scrollBottom; ++y) {
- const line = buffer.lines.get(buffer.ybase + y);
- line.insertCells(0, param, buffer.getNullCell(this._terminal.eraseAttrData()));
- line.isWrapped = false;
- }
- this._dirtyRowService.markRangeDirty(buffer.scrollTop, buffer.scrollBottom);
- }
-
- /**
- * CSI Pm ' }
- * Insert Ps Column(s) (default = 1) (DECIC), VT420 and up.
- */
- public insertColumns(params: IParams): void {
- const buffer = this._bufferService.buffer;
- if (buffer.y > buffer.scrollBottom || buffer.y < buffer.scrollTop) {
- return;
- }
- const param = params.params[0] || 1;
- for (let y = buffer.scrollTop; y <= buffer.scrollBottom; ++y) {
- const line = this._bufferService.buffer.lines.get(buffer.ybase + y);
- line.insertCells(buffer.x, param, buffer.getNullCell(this._terminal.eraseAttrData()));
- line.isWrapped = false;
- }
- this._dirtyRowService.markRangeDirty(buffer.scrollTop, buffer.scrollBottom);
- }
-
- /**
- * CSI Pm ' ~
- * Delete Ps Column(s) (default = 1) (DECDC), VT420 and up.
- */
- public deleteColumns(params: IParams): void {
- const buffer = this._bufferService.buffer;
- if (buffer.y > buffer.scrollBottom || buffer.y < buffer.scrollTop) {
- return;
- }
- const param = params.params[0] || 1;
- for (let y = buffer.scrollTop; y <= buffer.scrollBottom; ++y) {
- const line = buffer.lines.get(buffer.ybase + y);
- line.deleteCells(buffer.x, param, buffer.getNullCell(this._terminal.eraseAttrData()));
- line.isWrapped = false;
- }
- this._dirtyRowService.markRangeDirty(buffer.scrollTop, buffer.scrollBottom);
- }
-
- /**
- * CSI Ps X
- * Erase Ps Character(s) (default = 1) (ECH).
- */
- public eraseChars(params: IParams): void {
- this._restrictCursor();
- const line = this._bufferService.buffer.lines.get(this._bufferService.buffer.y + this._bufferService.buffer.ybase);
- if (line) {
- line.replaceCells(
- this._bufferService.buffer.x,
- this._bufferService.buffer.x + (params.params[0] || 1),
- this._bufferService.buffer.getNullCell(this._terminal.eraseAttrData())
- );
- this._dirtyRowService.markDirty(this._bufferService.buffer.y);
- }
- }
-
- /**
- * CSI Ps b Repeat the preceding graphic character Ps times (REP).
- * From ECMA 48 (@see http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-048.pdf)
- * Notation: (Pn)
- * Representation: CSI Pn 06/02
- * Parameter default value: Pn = 1
- * REP is used to indicate that the preceding character in the data stream,
- * if it is a graphic character (represented by one or more bit combinations) including SPACE,
- * is to be repeated n times, where n equals the value of Pn.
- * If the character preceding REP is a control function or part of a control function,
- * the effect of REP is not defined by this Standard.
- *
- * Since we propagate the terminal as xterm-256color we have to follow xterm's behavior:
- * - fullwidth + surrogate chars are ignored
- * - for combining chars only the base char gets repeated
- * - text attrs are applied normally
- * - wrap around is respected
- * - any valid sequence resets the carried forward char
- *
- * Note: To get reset on a valid sequence working correctly without much runtime penalty,
- * the preceding codepoint is stored on the parser in `this.print` and reset during `parser.parse`.
- */
- public repeatPrecedingCharacter(params: IParams): void {
- if (!this._parser.precedingCodepoint) {
- return;
- }
- // call print to insert the chars and handle correct wrapping
- const length = params.params[0] || 1;
- const data = new Uint32Array(length);
- for (let i = 0; i < length; ++i) {
- data[i] = this._parser.precedingCodepoint;
- }
- this.print(data, 0, data.length);
- }
-
- /**
- * CSI Ps c Send Device Attributes (Primary DA).
- * Ps = 0 or omitted -> request attributes from terminal. The
- * response depends on the decTerminalID resource setting.
- * -> CSI ? 1 ; 2 c (``VT100 with Advanced Video Option'')
- * -> CSI ? 1 ; 0 c (``VT101 with No Options'')
- * -> CSI ? 6 c (``VT102'')
- * -> CSI ? 6 0 ; 1 ; 2 ; 6 ; 8 ; 9 ; 1 5 ; c (``VT220'')
- * The VT100-style response parameters do not mean anything by
- * themselves. VT220 parameters do, telling the host what fea-
- * tures the terminal supports:
- * Ps = 1 -> 132-columns.
- * Ps = 2 -> Printer.
- * Ps = 6 -> Selective erase.
- * Ps = 8 -> User-defined keys.
- * Ps = 9 -> National replacement character sets.
- * Ps = 1 5 -> Technical characters.
- * Ps = 2 2 -> ANSI color, e.g., VT525.
- * Ps = 2 9 -> ANSI text locator (i.e., DEC Locator mode).
- * CSI > Ps c
- * Send Device Attributes (Secondary DA).
- * Ps = 0 or omitted -> request the terminal's identification
- * code. The response depends on the decTerminalID resource set-
- * ting. It should apply only to VT220 and up, but xterm extends
- * this to VT100.
- * -> CSI > Pp ; Pv ; Pc c
- * where Pp denotes the terminal type
- * Pp = 0 -> ``VT100''.
- * Pp = 1 -> ``VT220''.
- * and Pv is the firmware version (for xterm, this was originally
- * the XFree86 patch number, starting with 95). In a DEC termi-
- * nal, Pc indicates the ROM cartridge registration number and is
- * always zero.
- * More information:
- * xterm/charproc.c - line 2012, for more information.
- * vim responds with ^[[?0c or ^[[?1c after the terminal's response (?)
- */
- public sendDeviceAttributesPrimary(params: IParams): void {
- if (params.params[0] > 0) {
- return;
- }
- if (this._terminal.is('xterm') || this._terminal.is('rxvt-unicode') || this._terminal.is('screen')) {
- this._coreService.triggerDataEvent(C0.ESC + '[?1;2c');
- } else if (this._terminal.is('linux')) {
- this._coreService.triggerDataEvent(C0.ESC + '[?6c');
- }
- }
- public sendDeviceAttributesSecondary(params: IParams): void {
- if (params.params[0] > 0) {
- return;
- }
- // xterm and urxvt
- // seem to spit this
- // out around ~370 times (?).
- if (this._terminal.is('xterm')) {
- this._coreService.triggerDataEvent(C0.ESC + '[>0;276;0c');
- } else if (this._terminal.is('rxvt-unicode')) {
- this._coreService.triggerDataEvent(C0.ESC + '[>85;95;0c');
- } else if (this._terminal.is('linux')) {
- // not supported by linux console.
- // linux console echoes parameters.
- this._coreService.triggerDataEvent(params.params[0] + 'c');
- } else if (this._terminal.is('screen')) {
- this._coreService.triggerDataEvent(C0.ESC + '[>83;40003;0c');
- }
- }
-
- /**
- * CSI Pm h Set Mode (SM).
- * Ps = 2 -> Keyboard Action Mode (AM).
- * Ps = 4 -> Insert Mode (IRM).
- * Ps = 1 2 -> Send/receive (SRM).
- * Ps = 2 0 -> Automatic Newline (LNM).
- * CSI ? Pm h
- * DEC Private Mode Set (DECSET).
- * Ps = 1 -> Application Cursor Keys (DECCKM).
- * Ps = 2 -> Designate USASCII for character sets G0-G3
- * (DECANM), and set VT100 mode.
- * Ps = 3 -> 132 Column Mode (DECCOLM).
- * Ps = 4 -> Smooth (Slow) Scroll (DECSCLM).
- * Ps = 5 -> Reverse Video (DECSCNM).
- * Ps = 6 -> Origin Mode (DECOM).
- * Ps = 7 -> Wraparound Mode (DECAWM).
- * Ps = 8 -> Auto-repeat Keys (DECARM).
- * Ps = 9 -> Send Mouse X & Y on button press. See the sec-
- * tion Mouse Tracking.
- * Ps = 1 0 -> Show toolbar (rxvt).
- * Ps = 1 2 -> Start Blinking Cursor (att610).
- * Ps = 1 8 -> Print form feed (DECPFF).
- * Ps = 1 9 -> Set print extent to full screen (DECPEX).
- * Ps = 2 5 -> Show Cursor (DECTCEM).
- * Ps = 3 0 -> Show scrollbar (rxvt).
- * Ps = 3 5 -> Enable font-shifting functions (rxvt).
- * Ps = 3 8 -> Enter Tektronix Mode (DECTEK).
- * Ps = 4 0 -> Allow 80 -> 132 Mode.
- * Ps = 4 1 -> more(1) fix (see curses resource).
- * Ps = 4 2 -> Enable Nation Replacement Character sets (DECN-
- * RCM).
- * Ps = 4 4 -> Turn On Margin Bell.
- * Ps = 4 5 -> Reverse-wraparound Mode.
- * Ps = 4 6 -> Start Logging. This is normally disabled by a
- * compile-time option.
- * Ps = 4 7 -> Use Alternate Screen Buffer. (This may be dis-
- * abled by the titeInhibit resource).
- * Ps = 6 6 -> Application keypad (DECNKM).
- * Ps = 6 7 -> Backarrow key sends backspace (DECBKM).
- * Ps = 1 0 0 0 -> Send Mouse X & Y on button press and
- * release. See the section Mouse Tracking.
- * Ps = 1 0 0 1 -> Use Hilite Mouse Tracking.
- * Ps = 1 0 0 2 -> Use Cell Motion Mouse Tracking.
- * Ps = 1 0 0 3 -> Use All Motion Mouse Tracking.
- * Ps = 1 0 0 4 -> Send FocusIn/FocusOut events.
- * Ps = 1 0 0 5 -> Enable Extended Mouse Mode.
- * Ps = 1 0 1 0 -> Scroll to bottom on tty output (rxvt).
- * Ps = 1 0 1 1 -> Scroll to bottom on key press (rxvt).
- * Ps = 1 0 3 4 -> Interpret "meta" key, sets eighth bit.
- * (enables the eightBitInput resource).
- * Ps = 1 0 3 5 -> Enable special modifiers for Alt and Num-
- * Lock keys. (This enables the numLock resource).
- * Ps = 1 0 3 6 -> Send ESC when Meta modifies a key. (This
- * enables the metaSendsEscape resource).
- * Ps = 1 0 3 7 -> Send DEL from the editing-keypad Delete
- * key.
- * Ps = 1 0 3 9 -> Send ESC when Alt modifies a key. (This
- * enables the altSendsEscape resource).
- * Ps = 1 0 4 0 -> Keep selection even if not highlighted.
- * (This enables the keepSelection resource).
- * Ps = 1 0 4 1 -> Use the CLIPBOARD selection. (This enables
- * the selectToClipboard resource).
- * Ps = 1 0 4 2 -> Enable Urgency window manager hint when
- * Control-G is received. (This enables the bellIsUrgent
- * resource).
- * Ps = 1 0 4 3 -> Enable raising of the window when Control-G
- * is received. (enables the popOnBell resource).
- * Ps = 1 0 4 7 -> Use Alternate Screen Buffer. (This may be
- * disabled by the titeInhibit resource).
- * Ps = 1 0 4 8 -> Save cursor as in DECSC. (This may be dis-
- * abled by the titeInhibit resource).
- * Ps = 1 0 4 9 -> Save cursor as in DECSC and use Alternate
- * Screen Buffer, clearing it first. (This may be disabled by
- * the titeInhibit resource). This combines the effects of the 1
- * 0 4 7 and 1 0 4 8 modes. Use this with terminfo-based
- * applications rather than the 4 7 mode.
- * Ps = 1 0 5 0 -> Set terminfo/termcap function-key mode.
- * Ps = 1 0 5 1 -> Set Sun function-key mode.
- * Ps = 1 0 5 2 -> Set HP function-key mode.
- * Ps = 1 0 5 3 -> Set SCO function-key mode.
- * Ps = 1 0 6 0 -> Set legacy keyboard emulation (X11R6).
- * Ps = 1 0 6 1 -> Set VT220 keyboard emulation.
- * Ps = 2 0 0 4 -> Set bracketed paste mode.
- * Modes:
- * http: *vt100.net/docs/vt220-rm/chapter4.html
- */
- public setMode(params: IParams): void {
- for (let i = 0; i < params.length; i++) {
- switch (params.params[i]) {
- case 4:
- this._terminal.insertMode = true;
- break;
- case 20:
- // this._t.convertEol = true;
- break;
- }
- }
- }
- public setModePrivate(params: IParams): void {
- for (let i = 0; i < params.length; i++) {
- switch (params.params[i]) {
- case 1:
- this._coreService.decPrivateModes.applicationCursorKeys = true;
- break;
- case 2:
- this._terminal.setgCharset(0, DEFAULT_CHARSET);
- this._terminal.setgCharset(1, DEFAULT_CHARSET);
- this._terminal.setgCharset(2, DEFAULT_CHARSET);
- this._terminal.setgCharset(3, DEFAULT_CHARSET);
- // set VT100 mode here
- break;
- case 3: // 132 col mode
- // TODO: move DECCOLM into compat addon
- this._terminal.savedCols = this._bufferService.cols;
- this._terminal.resize(132, this._bufferService.rows);
- this._terminal.reset();
- break;
- case 6:
- this._terminal.originMode = true;
- this._setCursor(0, 0);
- break;
- case 7:
- this._terminal.wraparoundMode = true;
- break;
- case 12:
- // this.cursorBlink = true;
- break;
- case 66:
- this._logService.debug('Serial port requested application keypad.');
- this._terminal.applicationKeypad = true;
- if (this._terminal.viewport) {
- this._terminal.viewport.syncScrollArea();
- }
- break;
- case 9: // X10 Mouse
- // no release, no motion, no wheel, no modifiers.
- this._coreMouseService.activeProtocol = 'X10';
- break;
- case 1000: // vt200 mouse
- // no motion.
- this._coreMouseService.activeProtocol = 'VT200';
- break;
- case 1002: // button event mouse
- this._coreMouseService.activeProtocol = 'DRAG';
- break;
- case 1003: // any event mouse
- // any event - sends motion events,
- // even if there is no button held down.
- this._coreMouseService.activeProtocol = 'ANY';
- break;
- case 1004: // send focusin/focusout events
- // focusin: ^[[I
- // focusout: ^[[O
- this._terminal.sendFocus = true;
- break;
- case 1005: // utf8 ext mode mouse - removed in #2507
- this._logService.debug('DECSET 1005 not supported (see #2507)');
- break;
- case 1006: // sgr ext mode mouse
- this._coreMouseService.activeEncoding = 'SGR';
- break;
- case 1015: // urxvt ext mode mouse - removed in #2507
- this._logService.debug('DECSET 1015 not supported (see #2507)');
- break;
- case 25: // show cursor
- this._terminal.cursorHidden = false;
- break;
- case 1048: // alt screen cursor
- this.saveCursor();
- break;
- case 1049: // alt screen buffer cursor
- this.saveCursor();
- // FALL-THROUGH
- case 47: // alt screen buffer
- case 1047: // alt screen buffer
- this._bufferService.buffers.activateAltBuffer(this._terminal.eraseAttrData());
- this._terminal.refresh(0, this._bufferService.rows - 1);
- if (this._terminal.viewport) {
- this._terminal.viewport.syncScrollArea();
- }
- this._terminal.showCursor();
- break;
- case 2004: // bracketed paste mode (https://cirw.in/blog/bracketed-paste)
- this._terminal.bracketedPasteMode = true;
- break;
- }
- }
- }
-
-
- /**
- * CSI Pm l Reset Mode (RM).
- * Ps = 2 -> Keyboard Action Mode (AM).
- * Ps = 4 -> Replace Mode (IRM).
- * Ps = 1 2 -> Send/receive (SRM).
- * Ps = 2 0 -> Normal Linefeed (LNM).
- * CSI ? Pm l
- * DEC Private Mode Reset (DECRST).
- * Ps = 1 -> Normal Cursor Keys (DECCKM).
- * Ps = 2 -> Designate VT52 mode (DECANM).
- * Ps = 3 -> 80 Column Mode (DECCOLM).
- * Ps = 4 -> Jump (Fast) Scroll (DECSCLM).
- * Ps = 5 -> Normal Video (DECSCNM).
- * Ps = 6 -> Normal Cursor Mode (DECOM).
- * Ps = 7 -> No Wraparound Mode (DECAWM).
- * Ps = 8 -> No Auto-repeat Keys (DECARM).
- * Ps = 9 -> Don't send Mouse X & Y on button press.
- * Ps = 1 0 -> Hide toolbar (rxvt).
- * Ps = 1 2 -> Stop Blinking Cursor (att610).
- * Ps = 1 8 -> Don't print form feed (DECPFF).
- * Ps = 1 9 -> Limit print to scrolling region (DECPEX).
- * Ps = 2 5 -> Hide Cursor (DECTCEM).
- * Ps = 3 0 -> Don't show scrollbar (rxvt).
- * Ps = 3 5 -> Disable font-shifting functions (rxvt).
- * Ps = 4 0 -> Disallow 80 -> 132 Mode.
- * Ps = 4 1 -> No more(1) fix (see curses resource).
- * Ps = 4 2 -> Disable Nation Replacement Character sets (DEC-
- * NRCM).
- * Ps = 4 4 -> Turn Off Margin Bell.
- * Ps = 4 5 -> No Reverse-wraparound Mode.
- * Ps = 4 6 -> Stop Logging. (This is normally disabled by a
- * compile-time option).
- * Ps = 4 7 -> Use Normal Screen Buffer.
- * Ps = 6 6 -> Numeric keypad (DECNKM).
- * Ps = 6 7 -> Backarrow key sends delete (DECBKM).
- * Ps = 1 0 0 0 -> Don't send Mouse X & Y on button press and
- * release. See the section Mouse Tracking.
- * Ps = 1 0 0 1 -> Don't use Hilite Mouse Tracking.
- * Ps = 1 0 0 2 -> Don't use Cell Motion Mouse Tracking.
- * Ps = 1 0 0 3 -> Don't use All Motion Mouse Tracking.
- * Ps = 1 0 0 4 -> Don't send FocusIn/FocusOut events.
- * Ps = 1 0 0 5 -> Disable Extended Mouse Mode.
- * Ps = 1 0 1 0 -> Don't scroll to bottom on tty output
- * (rxvt).
- * Ps = 1 0 1 1 -> Don't scroll to bottom on key press (rxvt).
- * Ps = 1 0 3 4 -> Don't interpret "meta" key. (This disables
- * the eightBitInput resource).
- * Ps = 1 0 3 5 -> Disable special modifiers for Alt and Num-
- * Lock keys. (This disables the numLock resource).
- * Ps = 1 0 3 6 -> Don't send ESC when Meta modifies a key.
- * (This disables the metaSendsEscape resource).
- * Ps = 1 0 3 7 -> Send VT220 Remove from the editing-keypad
- * Delete key.
- * Ps = 1 0 3 9 -> Don't send ESC when Alt modifies a key.
- * (This disables the altSendsEscape resource).
- * Ps = 1 0 4 0 -> Do not keep selection when not highlighted.
- * (This disables the keepSelection resource).
- * Ps = 1 0 4 1 -> Use the PRIMARY selection. (This disables
- * the selectToClipboard resource).
- * Ps = 1 0 4 2 -> Disable Urgency window manager hint when
- * Control-G is received. (This disables the bellIsUrgent
- * resource).
- * Ps = 1 0 4 3 -> Disable raising of the window when Control-
- * G is received. (This disables the popOnBell resource).
- * Ps = 1 0 4 7 -> Use Normal Screen Buffer, clearing screen
- * first if in the Alternate Screen. (This may be disabled by
- * the titeInhibit resource).
- * Ps = 1 0 4 8 -> Restore cursor as in DECRC. (This may be
- * disabled by the titeInhibit resource).
- * Ps = 1 0 4 9 -> Use Normal Screen Buffer and restore cursor
- * as in DECRC. (This may be disabled by the titeInhibit
- * resource). This combines the effects of the 1 0 4 7 and 1 0
- * 4 8 modes. Use this with terminfo-based applications rather
- * than the 4 7 mode.
- * Ps = 1 0 5 0 -> Reset terminfo/termcap function-key mode.
- * Ps = 1 0 5 1 -> Reset Sun function-key mode.
- * Ps = 1 0 5 2 -> Reset HP function-key mode.
- * Ps = 1 0 5 3 -> Reset SCO function-key mode.
- * Ps = 1 0 6 0 -> Reset legacy keyboard emulation (X11R6).
- * Ps = 1 0 6 1 -> Reset keyboard emulation to Sun/PC style.
- * Ps = 2 0 0 4 -> Reset bracketed paste mode.
- */
- public resetMode(params: IParams): void {
- for (let i = 0; i < params.length; i++) {
- switch (params.params[i]) {
- case 4:
- this._terminal.insertMode = false;
- break;
- case 20:
- // this._t.convertEol = false;
- break;
- }
- }
- }
- public resetModePrivate(params: IParams): void {
- for (let i = 0; i < params.length; i++) {
- switch (params.params[i]) {
- case 1:
- this._coreService.decPrivateModes.applicationCursorKeys = false;
- break;
- case 3:
- // TODO: move DECCOLM into compat addon
- // Note: This impl currently does not enforce col 80, instead reverts
- // to previous terminal width before entering DECCOLM 132
- if (this._bufferService.cols === 132 && this._terminal.savedCols) {
- this._terminal.resize(this._terminal.savedCols, this._bufferService.rows);
- }
- delete this._terminal.savedCols;
- this._terminal.reset();
- break;
- case 6:
- this._terminal.originMode = false;
- this._setCursor(0, 0);
- break;
- case 7:
- this._terminal.wraparoundMode = false;
- break;
- case 12:
- // this.cursorBlink = false;
- break;
- case 66:
- this._logService.debug('Switching back to normal keypad.');
- this._terminal.applicationKeypad = false;
- if (this._terminal.viewport) {
- this._terminal.viewport.syncScrollArea();
- }
- break;
- case 9: // X10 Mouse
- case 1000: // vt200 mouse
- case 1002: // button event mouse
- case 1003: // any event mouse
- this._coreMouseService.activeProtocol = 'NONE';
- break;
- case 1004: // send focusin/focusout events
- this._terminal.sendFocus = false;
- break;
- case 1005: // utf8 ext mode mouse - removed in #2507
- this._logService.debug('DECRST 1005 not supported (see #2507)');
- break;
- case 1006: // sgr ext mode mouse
- this._coreMouseService.activeEncoding = 'DEFAULT';
- break;
- case 1015: // urxvt ext mode mouse - removed in #2507
- this._logService.debug('DECRST 1015 not supported (see #2507)');
- break;
- case 25: // hide cursor
- this._terminal.cursorHidden = true;
- break;
- case 1048: // alt screen cursor
- this.restoreCursor();
- break;
- case 1049: // alt screen buffer cursor
- // FALL-THROUGH
- case 47: // normal screen buffer
- case 1047: // normal screen buffer - clearing it first
- // Ensure the selection manager has the correct buffer
- this._bufferService.buffers.activateNormalBuffer();
- if (params.params[i] === 1049) {
- this.restoreCursor();
- }
- this._terminal.refresh(0, this._bufferService.rows - 1);
- if (this._terminal.viewport) {
- this._terminal.viewport.syncScrollArea();
- }
- this._terminal.showCursor();
- break;
- case 2004: // bracketed paste mode (https://cirw.in/blog/bracketed-paste)
- this._terminal.bracketedPasteMode = false;
- break;
- }
- }
- }
-
- /**
- * Helper to extract and apply color params/subparams.
- * Returns advance for params index.
- */
- private _extractColor(params: IParams, pos: number, attr: IAttributeData): number {
- // normalize params
- // meaning: [target, CM, ign, val, val, val]
- // RGB : [ 38/48, 2, ign, r, g, b]
- // P256 : [ 38/48, 5, ign, v, ign, ign]
- const accu = [0, 0, -1, 0, 0, 0];
-
- // alignment placeholder for non color space sequences
- let cSpace = 0;
-
- // return advance we took in params
- let advance = 0;
-
- do {
- accu[advance + cSpace] = params.params[pos + advance];
- if (params.hasSubParams(pos + advance)) {
- const subparams = params.getSubParams(pos + advance);
- let i = 0;
- do {
- if (accu[1] === 5) {
- cSpace = 1;
- }
- accu[advance + i + 1 + cSpace] = subparams[i];
- } while (++i < subparams.length && i + advance + 1 + cSpace < accu.length);
- break;
- }
- // exit early if can decide color mode with semicolons
- if ((accu[1] === 5 && advance + cSpace >= 2)
- || (accu[1] === 2 && advance + cSpace >= 5)) {
- break;
- }
- // offset colorSpace slot for semicolon mode
- if (accu[1]) {
- cSpace = 1;
- }
- } while (++advance + pos < params.length && advance + cSpace < accu.length);
-
- // set default values to 0
- for (let i = 2; i < accu.length; ++i) {
- if (accu[i] === -1) {
- accu[i] = 0;
- }
- }
-
- // apply colors
- if (accu[0] === 38) {
- if (accu[1] === 2) {
- attr.fg |= Attributes.CM_RGB;
- attr.fg &= ~Attributes.RGB_MASK;
- attr.fg |= AttributeData.fromColorRGB([accu[3], accu[4], accu[5]]);
- } else if (accu[1] === 5) {
- attr.fg &= ~(Attributes.CM_MASK | Attributes.PCOLOR_MASK);
- attr.fg |= Attributes.CM_P256 | (accu[3] & 0xff);
- }
- } else if (accu[0] === 48) {
- if (accu[1] === 2) {
- attr.bg |= Attributes.CM_RGB;
- attr.bg &= ~Attributes.RGB_MASK;
- attr.bg |= AttributeData.fromColorRGB([accu[3], accu[4], accu[5]]);
- } else if (accu[1] === 5) {
- attr.bg &= ~(Attributes.CM_MASK | Attributes.PCOLOR_MASK);
- attr.bg |= Attributes.CM_P256 | (accu[3] & 0xff);
- }
- }
-
- return advance;
- }
-
- /**
- * CSI Pm m Character Attributes (SGR).
- * Ps = 0 -> Normal (default).
- * Ps = 1 -> Bold.
- * Ps = 2 -> Faint, decreased intensity (ISO 6429).
- * Ps = 4 -> Underlined.
- * Ps = 5 -> Blink (appears as Bold).
- * Ps = 7 -> Inverse.
- * Ps = 8 -> Invisible, i.e., hidden (VT300).
- * Ps = 2 2 -> Normal (neither bold nor faint).
- * Ps = 2 4 -> Not underlined.
- * Ps = 2 5 -> Steady (not blinking).
- * Ps = 2 7 -> Positive (not inverse).
- * Ps = 2 8 -> Visible, i.e., not hidden (VT300).
- * Ps = 3 0 -> Set foreground color to Black.
- * Ps = 3 1 -> Set foreground color to Red.
- * Ps = 3 2 -> Set foreground color to Green.
- * Ps = 3 3 -> Set foreground color to Yellow.
- * Ps = 3 4 -> Set foreground color to Blue.
- * Ps = 3 5 -> Set foreground color to Magenta.
- * Ps = 3 6 -> Set foreground color to Cyan.
- * Ps = 3 7 -> Set foreground color to White.
- * Ps = 3 9 -> Set foreground color to default (original).
- * Ps = 4 0 -> Set background color to Black.
- * Ps = 4 1 -> Set background color to Red.
- * Ps = 4 2 -> Set background color to Green.
- * Ps = 4 3 -> Set background color to Yellow.
- * Ps = 4 4 -> Set background color to Blue.
- * Ps = 4 5 -> Set background color to Magenta.
- * Ps = 4 6 -> Set background color to Cyan.
- * Ps = 4 7 -> Set background color to White.
- * Ps = 4 9 -> Set background color to default (original).
- *
- * If 16-color support is compiled, the following apply. Assume
- * that xterm's resources are set so that the ISO color codes are
- * the first 8 of a set of 16. Then the aixterm colors are the
- * bright versions of the ISO colors:
- * Ps = 9 0 -> Set foreground color to Black.
- * Ps = 9 1 -> Set foreground color to Red.
- * Ps = 9 2 -> Set foreground color to Green.
- * Ps = 9 3 -> Set foreground color to Yellow.
- * Ps = 9 4 -> Set foreground color to Blue.
- * Ps = 9 5 -> Set foreground color to Magenta.
- * Ps = 9 6 -> Set foreground color to Cyan.
- * Ps = 9 7 -> Set foreground color to White.
- * Ps = 1 0 0 -> Set background color to Black.
- * Ps = 1 0 1 -> Set background color to Red.
- * Ps = 1 0 2 -> Set background color to Green.
- * Ps = 1 0 3 -> Set background color to Yellow.
- * Ps = 1 0 4 -> Set background color to Blue.
- * Ps = 1 0 5 -> Set background color to Magenta.
- * Ps = 1 0 6 -> Set background color to Cyan.
- * Ps = 1 0 7 -> Set background color to White.
- *
- * If xterm is compiled with the 16-color support disabled, it
- * supports the following, from rxvt:
- * Ps = 1 0 0 -> Set foreground and background color to
- * default.
- *
- * If 88- or 256-color support is compiled, the following apply.
- * Ps = 3 8 ; 5 ; Ps -> Set foreground color to the second
- * Ps.
- * Ps = 4 8 ; 5 ; Ps -> Set background color to the second
- * Ps.
- */
- public charAttributes(params: IParams): void {
- // Optimize a single SGR0.
- if (params.length === 1 && params.params[0] === 0) {
- this._terminal.curAttrData.fg = DEFAULT_ATTR_DATA.fg;
- this._terminal.curAttrData.bg = DEFAULT_ATTR_DATA.bg;
- return;
- }
-
- const l = params.length;
- let p;
- const attr = this._terminal.curAttrData;
-
- for (let i = 0; i < l; i++) {
- p = params.params[i];
- if (p >= 30 && p <= 37) {
- // fg color 8
- attr.fg &= ~(Attributes.CM_MASK | Attributes.PCOLOR_MASK);
- attr.fg |= Attributes.CM_P16 | (p - 30);
- } else if (p >= 40 && p <= 47) {
- // bg color 8
- attr.bg &= ~(Attributes.CM_MASK | Attributes.PCOLOR_MASK);
- attr.bg |= Attributes.CM_P16 | (p - 40);
- } else if (p >= 90 && p <= 97) {
- // fg color 16
- attr.fg &= ~(Attributes.CM_MASK | Attributes.PCOLOR_MASK);
- attr.fg |= Attributes.CM_P16 | (p - 90) | 8;
- } else if (p >= 100 && p <= 107) {
- // bg color 16
- attr.bg &= ~(Attributes.CM_MASK | Attributes.PCOLOR_MASK);
- attr.bg |= Attributes.CM_P16 | (p - 100) | 8;
- } else if (p === 0) {
- // default
- attr.fg = DEFAULT_ATTR_DATA.fg;
- attr.bg = DEFAULT_ATTR_DATA.bg;
- } else if (p === 1) {
- // bold text
- attr.fg |= FgFlags.BOLD;
- } else if (p === 3) {
- // italic text
- attr.bg |= BgFlags.ITALIC;
- } else if (p === 4) {
- // underlined text
- attr.fg |= FgFlags.UNDERLINE;
- } else if (p === 5) {
- // blink
- attr.fg |= FgFlags.BLINK;
- } else if (p === 7) {
- // inverse and positive
- // test with: echo -e '\e[31m\e[42mhello\e[7mworld\e[27mhi\e[m'
- attr.fg |= FgFlags.INVERSE;
- } else if (p === 8) {
- // invisible
- attr.fg |= FgFlags.INVISIBLE;
- } else if (p === 2) {
- // dimmed text
- attr.bg |= BgFlags.DIM;
- } else if (p === 22) {
- // not bold nor faint
- attr.fg &= ~FgFlags.BOLD;
- attr.bg &= ~BgFlags.DIM;
- } else if (p === 23) {
- // not italic
- attr.bg &= ~BgFlags.ITALIC;
- } else if (p === 24) {
- // not underlined
- attr.fg &= ~FgFlags.UNDERLINE;
- } else if (p === 25) {
- // not blink
- attr.fg &= ~FgFlags.BLINK;
- } else if (p === 27) {
- // not inverse
- attr.fg &= ~FgFlags.INVERSE;
- } else if (p === 28) {
- // not invisible
- attr.fg &= ~FgFlags.INVISIBLE;
- } else if (p === 39) {
- // reset fg
- attr.fg &= ~(Attributes.CM_MASK | Attributes.RGB_MASK);
- attr.fg |= DEFAULT_ATTR_DATA.fg & (Attributes.PCOLOR_MASK | Attributes.RGB_MASK);
- } else if (p === 49) {
- // reset bg
- attr.bg &= ~(Attributes.CM_MASK | Attributes.RGB_MASK);
- attr.bg |= DEFAULT_ATTR_DATA.bg & (Attributes.PCOLOR_MASK | Attributes.RGB_MASK);
- } else if (p === 38 || p === 48) {
- // fg color 256 and RGB
- i += this._extractColor(params, i, attr);
- } else if (p === 100) {
- // reset fg/bg
- attr.fg &= ~(Attributes.CM_MASK | Attributes.RGB_MASK);
- attr.fg |= DEFAULT_ATTR_DATA.fg & (Attributes.PCOLOR_MASK | Attributes.RGB_MASK);
- attr.bg &= ~(Attributes.CM_MASK | Attributes.RGB_MASK);
- attr.bg |= DEFAULT_ATTR_DATA.bg & (Attributes.PCOLOR_MASK | Attributes.RGB_MASK);
- } else {
- this._logService.debug('Unknown SGR attribute: %d.', p);
- }
- }
- }
-
- /**
- * CSI Ps n Device Status Report (DSR).
- * Ps = 5 -> Status Report. Result (``OK'') is
- * CSI 0 n
- * Ps = 6 -> Report Cursor Position (CPR) [row;column].
- * Result is
- * CSI r ; c R
- * CSI ? Ps n
- * Device Status Report (DSR, DEC-specific).
- * Ps = 6 -> Report Cursor Position (CPR) [row;column] as CSI
- * ? r ; c R (assumes page is zero).
- * Ps = 1 5 -> Report Printer status as CSI ? 1 0 n (ready).
- * or CSI ? 1 1 n (not ready).
- * Ps = 2 5 -> Report UDK status as CSI ? 2 0 n (unlocked)
- * or CSI ? 2 1 n (locked).
- * Ps = 2 6 -> Report Keyboard status as
- * CSI ? 2 7 ; 1 ; 0 ; 0 n (North American).
- * The last two parameters apply to VT400 & up, and denote key-
- * board ready and LK01 respectively.
- * Ps = 5 3 -> Report Locator status as
- * CSI ? 5 3 n Locator available, if compiled-in, or
- * CSI ? 5 0 n No Locator, if not.
- */
- public deviceStatus(params: IParams): void {
- switch (params.params[0]) {
- case 5:
- // status report
- this._coreService.triggerDataEvent(`${C0.ESC}[0n`);
- break;
- case 6:
- // cursor position
- const y = this._bufferService.buffer.y + 1;
- const x = this._bufferService.buffer.x + 1;
- this._coreService.triggerDataEvent(`${C0.ESC}[${y};${x}R`);
- break;
- }
- }
-
- public deviceStatusPrivate(params: IParams): void {
- // modern xterm doesnt seem to
- // respond to any of these except ?6, 6, and 5
- switch (params.params[0]) {
- case 6:
- // cursor position
- const y = this._bufferService.buffer.y + 1;
- const x = this._bufferService.buffer.x + 1;
- this._coreService.triggerDataEvent(`${C0.ESC}[?${y};${x}R`);
- break;
- case 15:
- // no printer
- // this.handler(C0.ESC + '[?11n');
- break;
- case 25:
- // dont support user defined keys
- // this.handler(C0.ESC + '[?21n');
- break;
- case 26:
- // north american keyboard
- // this.handler(C0.ESC + '[?27;1;0;0n');
- break;
- case 53:
- // no dec locator/mouse
- // this.handler(C0.ESC + '[?50n');
- break;
- }
- }
-
- /**
- * CSI ! p Soft terminal reset (DECSTR).
- * http://vt100.net/docs/vt220-rm/table4-10.html
- */
- public softReset(params: IParams): void {
- this._terminal.cursorHidden = false;
- this._terminal.insertMode = false;
- this._terminal.originMode = false;
- this._terminal.wraparoundMode = true; // defaults: xterm - true, vt100 - false
- this._terminal.applicationKeypad = false; // ?
- if (this._terminal.viewport) {
- this._terminal.viewport.syncScrollArea();
- }
- this._coreService.decPrivateModes.applicationCursorKeys = false;
- this._bufferService.buffer.scrollTop = 0;
- this._bufferService.buffer.scrollBottom = this._bufferService.rows - 1;
- this._terminal.curAttrData = DEFAULT_ATTR_DATA.clone();
- this._bufferService.buffer.x = this._bufferService.buffer.y = 0; // ?
- this._terminal.charset = null;
- this._terminal.glevel = 0; // ??
- this._terminal.charsets = [null]; // ??
- }
-
- /**
- * CSI Ps SP q Set cursor style (DECSCUSR, VT520).
- * Ps = 0 -> blinking block.
- * Ps = 1 -> blinking block (default).
- * Ps = 2 -> steady block.
- * Ps = 3 -> blinking underline.
- * Ps = 4 -> steady underline.
- * Ps = 5 -> blinking bar (xterm).
- * Ps = 6 -> steady bar (xterm).
- */
- public setCursorStyle(params: IParams): void {
- const param = params.params[0] || 1;
- switch (param) {
- case 1:
- case 2:
- this._optionsService.options.cursorStyle = 'block';
- break;
- case 3:
- case 4:
- this._optionsService.options.cursorStyle = 'underline';
- break;
- case 5:
- case 6:
- this._optionsService.options.cursorStyle = 'bar';
- break;
- }
- const isBlinking = param % 2 === 1;
- this._optionsService.options.cursorBlink = isBlinking;
- }
-
- /**
- * CSI Ps ; Ps r
- * Set Scrolling Region [top;bottom] (default = full size of win-
- * dow) (DECSTBM).
- */
- public setScrollRegion(params: IParams): void {
- const top = params.params[0] || 1;
- let bottom: number;
-
- if (params.length < 2 || (bottom = params.params[1]) > this._bufferService.rows || bottom === 0) {
- bottom = this._bufferService.rows;
- }
-
- if (bottom > top) {
- this._bufferService.buffer.scrollTop = top - 1;
- this._bufferService.buffer.scrollBottom = bottom - 1;
- this._setCursor(0, 0);
- }
- }
-
-
- /**
- * CSI s
- * ESC 7
- * Save cursor (ANSI.SYS).
- */
- public saveCursor(params?: IParams): void {
- this._bufferService.buffer.savedX = this._bufferService.buffer.x;
- this._bufferService.buffer.savedY = this._bufferService.buffer.ybase + this._bufferService.buffer.y;
- this._bufferService.buffer.savedCurAttrData.fg = this._terminal.curAttrData.fg;
- this._bufferService.buffer.savedCurAttrData.bg = this._terminal.curAttrData.bg;
- this._bufferService.buffer.savedCharset = this._terminal.charset;
- }
-
-
- /**
- * CSI u
- * ESC 8
- * Restore cursor (ANSI.SYS).
- */
- public restoreCursor(params?: IParams): void {
- this._bufferService.buffer.x = this._bufferService.buffer.savedX || 0;
- this._bufferService.buffer.y = Math.max(this._bufferService.buffer.savedY - this._bufferService.buffer.ybase, 0);
- this._terminal.curAttrData.fg = this._bufferService.buffer.savedCurAttrData.fg;
- this._terminal.curAttrData.bg = this._bufferService.buffer.savedCurAttrData.bg;
- this._terminal.charset = (this as any)._savedCharset;
- if (this._bufferService.buffer.savedCharset) {
- this._terminal.charset = this._bufferService.buffer.savedCharset;
- }
- this._restrictCursor();
- }
-
-
- /**
- * OSC 0; <data> ST (set icon name + window title)
- * OSC 2; <data> ST (set window title)
- * Proxy to set window title. Icon name is not supported.
- */
- public setTitle(data: string): void {
- this._terminal.handleTitle(data);
- }
-
- /**
- * ESC E
- * C1.NEL
- * DEC mnemonic: NEL (https://vt100.net/docs/vt510-rm/NEL)
- * Moves cursor to first position on next line.
- */
- public nextLine(): void {
- this._bufferService.buffer.x = 0;
- this.index();
- }
-
- /**
- * ESC =
- * DEC mnemonic: DECKPAM (https://vt100.net/docs/vt510-rm/DECKPAM.html)
- * Enables the numeric keypad to send application sequences to the host.
- */
- public keypadApplicationMode(): void {
- this._logService.debug('Serial port requested application keypad.');
- this._terminal.applicationKeypad = true;
- if (this._terminal.viewport) {
- this._terminal.viewport.syncScrollArea();
- }
- }
-
- /**
- * ESC >
- * DEC mnemonic: DECKPNM (https://vt100.net/docs/vt510-rm/DECKPNM.html)
- * Enables the keypad to send numeric characters to the host.
- */
- public keypadNumericMode(): void {
- this._logService.debug('Switching back to normal keypad.');
- this._terminal.applicationKeypad = false;
- if (this._terminal.viewport) {
- this._terminal.viewport.syncScrollArea();
- }
- }
-
- /**
- * ESC % @
- * ESC % G
- * Select default character set. UTF-8 is not supported (string are unicode anyways)
- * therefore ESC % G does the same.
- */
- public selectDefaultCharset(): void {
- this._terminal.setgLevel(0);
- this._terminal.setgCharset(0, DEFAULT_CHARSET); // US (default)
- }
-
- /**
- * ESC ( C
- * Designate G0 Character Set, VT100, ISO 2022.
- * ESC ) C
- * Designate G1 Character Set (ISO 2022, VT100).
- * ESC * C
- * Designate G2 Character Set (ISO 2022, VT220).
- * ESC + C
- * Designate G3 Character Set (ISO 2022, VT220).
- * ESC - C
- * Designate G1 Character Set (VT300).
- * ESC . C
- * Designate G2 Character Set (VT300).
- * ESC / C
- * Designate G3 Character Set (VT300). C = A -> ISO Latin-1 Supplemental. - Supported?
- */
- public selectCharset(collectAndFlag: string): void {
- if (collectAndFlag.length !== 2) {
- this.selectDefaultCharset();
- return;
- }
- if (collectAndFlag[0] === '/') {
- return; // TODO: Is this supported?
- }
- this._terminal.setgCharset(GLEVEL[collectAndFlag[0]], CHARSETS[collectAndFlag[1]] || DEFAULT_CHARSET);
- return;
- }
-
- /**
- * ESC D
- * C1.IND
- * DEC mnemonic: IND (https://vt100.net/docs/vt510-rm/IND.html)
- * Moves the cursor down one line in the same column.
- */
- public index(): void {
- this._restrictCursor();
- const buffer = this._bufferService.buffer;
- this._bufferService.buffer.y++;
- if (buffer.y === buffer.scrollBottom + 1) {
- buffer.y--;
- this._terminal.scroll();
- } else if (buffer.y >= this._bufferService.rows) {
- buffer.y = this._bufferService.rows - 1;
- }
- this._restrictCursor();
- }
-
- /**
- * ESC H
- * C1.HTS
- * DEC mnemonic: HTS (https://vt100.net/docs/vt510-rm/HTS.html)
- * Sets a horizontal tab stop at the column position indicated by
- * the value of the active column when the terminal receives an HTS.
- */
- public tabSet(): void {
- this._bufferService.buffer.tabs[this._bufferService.buffer.x] = true;
- }
-
- /**
- * ESC M
- * C1.RI
- * DEC mnemonic: HTS
- * Moves the cursor up one line in the same column. If the cursor is at the top margin,
- * the page scrolls down.
- */
- public reverseIndex(): void {
- this._restrictCursor();
- const buffer = this._bufferService.buffer;
- if (buffer.y === buffer.scrollTop) {
- // possibly move the code below to term.reverseScroll();
- // test: echo -ne '\e[1;1H\e[44m\eM\e[0m'
- // blankLine(true) is xterm/linux behavior
- const scrollRegionHeight = buffer.scrollBottom - buffer.scrollTop;
- buffer.lines.shiftElements(buffer.y + buffer.ybase, scrollRegionHeight, 1);
- buffer.lines.set(buffer.y + buffer.ybase, buffer.getBlankLine(this._terminal.eraseAttrData()));
- this._dirtyRowService.markRangeDirty(buffer.scrollTop, buffer.scrollBottom);
- } else {
- buffer.y--;
- this._restrictCursor(); // quickfix to not run out of bounds
- }
- }
-
- /**
- * ESC c
- * DEC mnemonic: RIS (https://vt100.net/docs/vt510-rm/RIS.html)
- * Reset to initial state.
- */
- public reset(): void {
- this._parser.reset();
- this._terminal.reset(); // TODO: save to move from terminal?
- }
-
- /**
- * ESC n
- * ESC o
- * ESC |
- * ESC }
- * ESC ~
- * DEC mnemonic: LS (https://vt100.net/docs/vt510-rm/LS.html)
- * When you use a locking shift, the character set remains in GL or GR until
- * you use another locking shift. (partly supported)
- */
- public setgLevel(level: number): void {
- this._terminal.setgLevel(level); // TODO: save to move from terminal?
- }
-
- /**
- * ESC # 8
- * DEC mnemonic: DECALN (https://vt100.net/docs/vt510-rm/DECALN.html)
- * This control function fills the complete screen area with
- * a test pattern (E) used for adjusting screen alignment.
- *
- * TODO: move DECALN into compat addon
- */
- public screenAlignmentPattern(): void {
- // prepare cell data
- const cell = new CellData();
- cell.content = 1 << Content.WIDTH_SHIFT | 'E'.charCodeAt(0);
- cell.fg = this._terminal.curAttrData.fg;
- cell.bg = this._terminal.curAttrData.bg;
-
- const buffer = this._bufferService.buffer;
-
- this._setCursor(0, 0);
- for (let yOffset = 0; yOffset < this._bufferService.rows; ++yOffset) {
- const row = buffer.y + buffer.ybase + yOffset;
- buffer.lines.get(row).fill(cell);
- buffer.lines.get(row).isWrapped = false;
- }
- this._dirtyRowService.markAllDirty();
- this._setCursor(0, 0);
- }
-}