/** * Copyright (c) 2019 The xterm.js authors. All rights reserved. * @license MIT */ import { IEvent } from 'common/EventEmitter'; import { IBuffer, IBufferSet } from 'common/buffer/Types'; import { IDecPrivateModes, ICoreMouseEvent, CoreMouseEncoding, ICoreMouseProtocol, CoreMouseEventType, ICharset, IWindowOptions } from 'common/Types'; import { createDecorator } from 'common/services/ServiceRegistry'; export const IBufferService = createDecorator('BufferService'); export interface IBufferService { serviceBrand: any; readonly cols: number; readonly rows: number; readonly buffer: IBuffer; readonly buffers: IBufferSet; // TODO: Move resize event here resize(cols: number, rows: number): void; reset(): void; } export const ICoreMouseService = createDecorator('CoreMouseService'); export interface ICoreMouseService { activeProtocol: string; activeEncoding: string; addProtocol(name: string, protocol: ICoreMouseProtocol): void; addEncoding(name: string, encoding: CoreMouseEncoding): void; reset(): void; /** * Triggers a mouse event to be sent. * * Returns true if the event passed all protocol restrictions and a report * was sent, otherwise false. The return value may be used to decide whether * the default event action in the bowser component should be omitted. * * Note: The method will change values of the given event object * to fullfill protocol and encoding restrictions. */ triggerMouseEvent(event: ICoreMouseEvent): boolean; /** * Event to announce changes in mouse tracking. */ onProtocolChange: IEvent; /** * Human readable version of mouse events. */ explainEvents(events: CoreMouseEventType): {[event: string]: boolean}; } export const ICoreService = createDecorator('CoreService'); export interface ICoreService { serviceBrand: any; /** * Initially the cursor will not be visible until the first time the terminal * is focused. */ isCursorInitialized: boolean; isCursorHidden: boolean; readonly decPrivateModes: IDecPrivateModes; readonly onData: IEvent; readonly onUserInput: IEvent; readonly onBinary: IEvent; reset(): void; /** * Triggers the onData event in the public API. * @param data The data that is being emitted. * @param wasFromUser Whether the data originated from the user (as opposed to * resulting from parsing incoming data). When true this will also: * - Scroll to the bottom of the buffer.s * - Fire the `onUserInput` event (so selection can be cleared). */ triggerDataEvent(data: string, wasUserInput?: boolean): void; /** * Triggers the onBinary event in the public API. * @param data The data that is being emitted. */ triggerBinaryEvent(data: string): void; } export const ICharsetService = createDecorator('CharsetService'); export interface ICharsetService { serviceBrand: any; charset: ICharset | undefined; readonly glevel: number; readonly charsets: ReadonlyArray; reset(): void; /** * Set the G level of the terminal. * @param g */ setgLevel(g: number): void; /** * Set the charset for the given G level of the terminal. * @param g * @param charset */ setgCharset(g: number, charset: ICharset): void; } export const IDirtyRowService = createDecorator('DirtyRowService'); export interface IDirtyRowService { serviceBrand: any; readonly start: number; readonly end: number; clearRange(): void; markDirty(y: number): void; markRangeDirty(y1: number, y2: number): void; markAllDirty(): void; } export interface IServiceIdentifier { (...args: any[]): void; type: T; } export interface IConstructorSignature0 { new(...services: { serviceBrand: any; }[]): T; } export interface IConstructorSignature1 { new(first: A1, ...services: { serviceBrand: any; }[]): T; } export interface IConstructorSignature2 { new(first: A1, second: A2, ...services: { serviceBrand: any; }[]): T; } export interface IConstructorSignature3 { new(first: A1, second: A2, third: A3, ...services: { serviceBrand: any; }[]): T; } export interface IConstructorSignature4 { new(first: A1, second: A2, third: A3, fourth: A4, ...services: { serviceBrand: any; }[]): T; } export interface IConstructorSignature5 { new(first: A1, second: A2, third: A3, fourth: A4, fifth: A5, ...services: { serviceBrand: any; }[]): T; } export interface IConstructorSignature6 { new(first: A1, second: A2, third: A3, fourth: A4, fifth: A5, sixth: A6, ...services: { serviceBrand: any; }[]): T; } export interface IConstructorSignature7 { new(first: A1, second: A2, third: A3, fourth: A4, fifth: A5, sixth: A6, seventh: A7, ...services: { serviceBrand: any; }[]): T; } export interface IConstructorSignature8 { new(first: A1, second: A2, third: A3, fourth: A4, fifth: A5, sixth: A6, seventh: A7, eigth: A8, ...services: { serviceBrand: any; }[]): T; } export const IInstantiationService = createDecorator('InstantiationService'); export interface IInstantiationService { setService(id: IServiceIdentifier, instance: T): void; getService(id: IServiceIdentifier): T | undefined; createInstance(ctor: IConstructorSignature0): T; createInstance(ctor: IConstructorSignature1, first: A1): T; createInstance(ctor: IConstructorSignature2, first: A1, second: A2): T; createInstance(ctor: IConstructorSignature3, first: A1, second: A2, third: A3): T; createInstance(ctor: IConstructorSignature4, first: A1, second: A2, third: A3, fourth: A4): T; createInstance(ctor: IConstructorSignature5, first: A1, second: A2, third: A3, fourth: A4, fifth: A5): T; createInstance(ctor: IConstructorSignature6, first: A1, second: A2, third: A3, fourth: A4, fifth: A5, sixth: A6): T; createInstance(ctor: IConstructorSignature7, first: A1, second: A2, third: A3, fourth: A4, fifth: A5, sixth: A6, seventh: A7): T; createInstance(ctor: IConstructorSignature8, first: A1, second: A2, third: A3, fourth: A4, fifth: A5, sixth: A6, seventh: A7, eigth: A8): T; } export const ILogService = createDecorator('LogService'); export interface ILogService { serviceBrand: any; debug(message: any, ...optionalParams: any[]): void; info(message: any, ...optionalParams: any[]): void; warn(message: any, ...optionalParams: any[]): void; error(message: any, ...optionalParams: any[]): void; } export const IOptionsService = createDecorator('OptionsService'); export interface IOptionsService { serviceBrand: any; readonly options: ITerminalOptions; readonly onOptionChange: IEvent; setOption(key: string, value: T): void; getOption(key: string): T | undefined; } export type FontWeight = 'normal' | 'bold' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900'; export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'off'; export type RendererType = 'dom' | 'canvas'; export interface IPartialTerminalOptions { allowTransparency?: boolean; bellSound?: string; bellStyle?: 'none' /*| 'visual'*/ | 'sound' /*| 'both'*/; cols?: number; cursorBlink?: boolean; cursorStyle?: 'block' | 'underline' | 'bar'; cursorWidth?: number; disableStdin?: boolean; drawBoldTextInBrightColors?: boolean; fastScrollModifier?: 'alt' | 'ctrl' | 'shift'; fastScrollSensitivity?: number; fontSize?: number; fontFamily?: string; fontWeight?: FontWeight; fontWeightBold?: FontWeight; letterSpacing?: number; lineHeight?: number; logLevel?: LogLevel; macOptionIsMeta?: boolean; macOptionClickForcesSelection?: boolean; rendererType?: RendererType; rightClickSelectsWord?: boolean; rows?: number; screenReaderMode?: boolean; scrollback?: number; scrollSensitivity?: number; tabStopWidth?: number; theme?: ITheme; windowsMode?: boolean; wordSeparator?: string; windowOptions?: IWindowOptions; } export interface ITerminalOptions { allowTransparency: boolean; bellSound: string; bellStyle: 'none' /*| 'visual'*/ | 'sound' /*| 'both'*/; cols: number; cursorBlink: boolean; cursorStyle: 'block' | 'underline' | 'bar'; cursorWidth: number; disableStdin: boolean; drawBoldTextInBrightColors: boolean; fastScrollModifier: 'alt' | 'ctrl' | 'shift' | undefined; fastScrollSensitivity: number; fontSize: number; fontFamily: string; fontWeight: FontWeight; fontWeightBold: FontWeight; letterSpacing: number; lineHeight: number; logLevel: LogLevel; macOptionIsMeta: boolean; macOptionClickForcesSelection: boolean; minimumContrastRatio: number; rendererType: RendererType; rightClickSelectsWord: boolean; rows: number; screenReaderMode: boolean; scrollback: number; scrollSensitivity: number; tabStopWidth: number; theme: ITheme; windowsMode: boolean; windowOptions: IWindowOptions; wordSeparator: string; [key: string]: any; cancelEvents: boolean; convertEol: boolean; termName: string; } export interface ITheme { foreground?: string; background?: string; cursor?: string; cursorAccent?: string; selection?: string; black?: string; red?: string; green?: string; yellow?: string; blue?: string; magenta?: string; cyan?: string; white?: string; brightBlack?: string; brightRed?: string; brightGreen?: string; brightYellow?: string; brightBlue?: string; brightMagenta?: string; brightCyan?: string; brightWhite?: string; } export const IUnicodeService = createDecorator('UnicodeService'); export interface IUnicodeService { /** Register an Unicode version provider. */ register(provider: IUnicodeVersionProvider): void; /** Registered Unicode versions. */ readonly versions: string[]; /** Currently active version. */ activeVersion: string; /** Event triggered, when activate version changed. */ readonly onChange: IEvent; /** * Unicode version dependent */ wcwidth(codepoint: number): number; getStringCellWidth(s: string): number; } export interface IUnicodeVersionProvider { readonly version: string; wcwidth(ucs: number): 0 | 1 | 2; }