--- /dev/null
+/*! *****************************************************************************
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License. You may obtain a copy of the
+License at http://www.apache.org/licenses/LICENSE-2.0
+
+THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
+WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
+MERCHANTABLITY OR NON-INFRINGEMENT.
+
+See the Apache Version 2.0 License for specific language governing permissions
+and limitations under the License.
+***************************************************************************** */
+
+declare namespace ts {
+ const versionMajorMinor = "3.9";
+ /** The version of the TypeScript compiler release */
+ const version: string;
+ /**
+ * Type of objects whose values are all of the same type.
+ * The `in` and `for-in` operators can *not* be safely used,
+ * since `Object.prototype` may be modified by outside code.
+ */
+ interface MapLike<T> {
+ [index: string]: T;
+ }
+ interface SortedReadonlyArray<T> extends ReadonlyArray<T> {
+ " __sortedArrayBrand": any;
+ }
+ interface SortedArray<T> extends Array<T> {
+ " __sortedArrayBrand": any;
+ }
+ /** ES6 Map interface, only read methods included. */
+ interface ReadonlyMap<T> {
+ get(key: string): T | undefined;
+ has(key: string): boolean;
+ forEach(action: (value: T, key: string) => void): void;
+ readonly size: number;
+ keys(): Iterator<string>;
+ values(): Iterator<T>;
+ entries(): Iterator<[string, T]>;
+ }
+ /** ES6 Map interface. */
+ interface Map<T> extends ReadonlyMap<T> {
+ set(key: string, value: T): this;
+ delete(key: string): boolean;
+ clear(): void;
+ }
+ /** ES6 Iterator type. */
+ interface Iterator<T> {
+ next(): {
+ value: T;
+ done?: false;
+ } | {
+ value: never;
+ done: true;
+ };
+ }
+ /** Array that is only intended to be pushed to, never read. */
+ interface Push<T> {
+ push(...values: T[]): void;
+ }
+}
+declare namespace ts {
+ export type Path = string & {
+ __pathBrand: any;
+ };
+ export interface TextRange {
+ pos: number;
+ end: number;
+ }
+ export type JSDocSyntaxKind = SyntaxKind.EndOfFileToken | SyntaxKind.WhitespaceTrivia | SyntaxKind.AtToken | SyntaxKind.NewLineTrivia | SyntaxKind.AsteriskToken | SyntaxKind.OpenBraceToken | SyntaxKind.CloseBraceToken | SyntaxKind.LessThanToken | SyntaxKind.GreaterThanToken | SyntaxKind.OpenBracketToken | SyntaxKind.CloseBracketToken | SyntaxKind.EqualsToken | SyntaxKind.CommaToken | SyntaxKind.DotToken | SyntaxKind.Identifier | SyntaxKind.BacktickToken | SyntaxKind.Unknown | KeywordSyntaxKind;
+ export type KeywordSyntaxKind = SyntaxKind.AbstractKeyword | SyntaxKind.AnyKeyword | SyntaxKind.AsKeyword | SyntaxKind.AssertsKeyword | SyntaxKind.BigIntKeyword | SyntaxKind.BooleanKeyword | SyntaxKind.BreakKeyword | SyntaxKind.CaseKeyword | SyntaxKind.CatchKeyword | SyntaxKind.ClassKeyword | SyntaxKind.ContinueKeyword | SyntaxKind.ConstKeyword | SyntaxKind.ConstructorKeyword | SyntaxKind.DebuggerKeyword | SyntaxKind.DeclareKeyword | SyntaxKind.DefaultKeyword | SyntaxKind.DeleteKeyword | SyntaxKind.DoKeyword | SyntaxKind.ElseKeyword | SyntaxKind.EnumKeyword | SyntaxKind.ExportKeyword | SyntaxKind.ExtendsKeyword | SyntaxKind.FalseKeyword | SyntaxKind.FinallyKeyword | SyntaxKind.ForKeyword | SyntaxKind.FromKeyword | SyntaxKind.FunctionKeyword | SyntaxKind.GetKeyword | SyntaxKind.IfKeyword | SyntaxKind.ImplementsKeyword | SyntaxKind.ImportKeyword | SyntaxKind.InKeyword | SyntaxKind.InferKeyword | SyntaxKind.InstanceOfKeyword | SyntaxKind.InterfaceKeyword | SyntaxKind.IsKeyword | SyntaxKind.KeyOfKeyword | SyntaxKind.LetKeyword | SyntaxKind.ModuleKeyword | SyntaxKind.NamespaceKeyword | SyntaxKind.NeverKeyword | SyntaxKind.NewKeyword | SyntaxKind.NullKeyword | SyntaxKind.NumberKeyword | SyntaxKind.ObjectKeyword | SyntaxKind.PackageKeyword | SyntaxKind.PrivateKeyword | SyntaxKind.ProtectedKeyword | SyntaxKind.PublicKeyword | SyntaxKind.ReadonlyKeyword | SyntaxKind.RequireKeyword | SyntaxKind.GlobalKeyword | SyntaxKind.ReturnKeyword | SyntaxKind.SetKeyword | SyntaxKind.StaticKeyword | SyntaxKind.StringKeyword | SyntaxKind.SuperKeyword | SyntaxKind.SwitchKeyword | SyntaxKind.SymbolKeyword | SyntaxKind.ThisKeyword | SyntaxKind.ThrowKeyword | SyntaxKind.TrueKeyword | SyntaxKind.TryKeyword | SyntaxKind.TypeKeyword | SyntaxKind.TypeOfKeyword | SyntaxKind.UndefinedKeyword | SyntaxKind.UniqueKeyword | SyntaxKind.UnknownKeyword | SyntaxKind.VarKeyword | SyntaxKind.VoidKeyword | SyntaxKind.WhileKeyword | SyntaxKind.WithKeyword | SyntaxKind.YieldKeyword | SyntaxKind.AsyncKeyword | SyntaxKind.AwaitKeyword | SyntaxKind.OfKeyword;
+ export type JsxTokenSyntaxKind = SyntaxKind.LessThanSlashToken | SyntaxKind.EndOfFileToken | SyntaxKind.ConflictMarkerTrivia | SyntaxKind.JsxText | SyntaxKind.JsxTextAllWhiteSpaces | SyntaxKind.OpenBraceToken | SyntaxKind.LessThanToken;
+ export enum SyntaxKind {
+ Unknown = 0,
+ EndOfFileToken = 1,
+ SingleLineCommentTrivia = 2,
+ MultiLineCommentTrivia = 3,
+ NewLineTrivia = 4,
+ WhitespaceTrivia = 5,
+ ShebangTrivia = 6,
+ ConflictMarkerTrivia = 7,
+ NumericLiteral = 8,
+ BigIntLiteral = 9,
+ StringLiteral = 10,
+ JsxText = 11,
+ JsxTextAllWhiteSpaces = 12,
+ RegularExpressionLiteral = 13,
+ NoSubstitutionTemplateLiteral = 14,
+ TemplateHead = 15,
+ TemplateMiddle = 16,
+ TemplateTail = 17,
+ OpenBraceToken = 18,
+ CloseBraceToken = 19,
+ OpenParenToken = 20,
+ CloseParenToken = 21,
+ OpenBracketToken = 22,
+ CloseBracketToken = 23,
+ DotToken = 24,
+ DotDotDotToken = 25,
+ SemicolonToken = 26,
+ CommaToken = 27,
+ QuestionDotToken = 28,
+ LessThanToken = 29,
+ LessThanSlashToken = 30,
+ GreaterThanToken = 31,
+ LessThanEqualsToken = 32,
+ GreaterThanEqualsToken = 33,
+ EqualsEqualsToken = 34,
+ ExclamationEqualsToken = 35,
+ EqualsEqualsEqualsToken = 36,
+ ExclamationEqualsEqualsToken = 37,
+ EqualsGreaterThanToken = 38,
+ PlusToken = 39,
+ MinusToken = 40,
+ AsteriskToken = 41,
+ AsteriskAsteriskToken = 42,
+ SlashToken = 43,
+ PercentToken = 44,
+ PlusPlusToken = 45,
+ MinusMinusToken = 46,
+ LessThanLessThanToken = 47,
+ GreaterThanGreaterThanToken = 48,
+ GreaterThanGreaterThanGreaterThanToken = 49,
+ AmpersandToken = 50,
+ BarToken = 51,
+ CaretToken = 52,
+ ExclamationToken = 53,
+ TildeToken = 54,
+ AmpersandAmpersandToken = 55,
+ BarBarToken = 56,
+ QuestionToken = 57,
+ ColonToken = 58,
+ AtToken = 59,
+ QuestionQuestionToken = 60,
+ /** Only the JSDoc scanner produces BacktickToken. The normal scanner produces NoSubstitutionTemplateLiteral and related kinds. */
+ BacktickToken = 61,
+ EqualsToken = 62,
+ PlusEqualsToken = 63,
+ MinusEqualsToken = 64,
+ AsteriskEqualsToken = 65,
+ AsteriskAsteriskEqualsToken = 66,
+ SlashEqualsToken = 67,
+ PercentEqualsToken = 68,
+ LessThanLessThanEqualsToken = 69,
+ GreaterThanGreaterThanEqualsToken = 70,
+ GreaterThanGreaterThanGreaterThanEqualsToken = 71,
+ AmpersandEqualsToken = 72,
+ BarEqualsToken = 73,
+ CaretEqualsToken = 74,
+ Identifier = 75,
+ PrivateIdentifier = 76,
+ BreakKeyword = 77,
+ CaseKeyword = 78,
+ CatchKeyword = 79,
+ ClassKeyword = 80,
+ ConstKeyword = 81,
+ ContinueKeyword = 82,
+ DebuggerKeyword = 83,
+ DefaultKeyword = 84,
+ DeleteKeyword = 85,
+ DoKeyword = 86,
+ ElseKeyword = 87,
+ EnumKeyword = 88,
+ ExportKeyword = 89,
+ ExtendsKeyword = 90,
+ FalseKeyword = 91,
+ FinallyKeyword = 92,
+ ForKeyword = 93,
+ FunctionKeyword = 94,
+ IfKeyword = 95,
+ ImportKeyword = 96,
+ InKeyword = 97,
+ InstanceOfKeyword = 98,
+ NewKeyword = 99,
+ NullKeyword = 100,
+ ReturnKeyword = 101,
+ SuperKeyword = 102,
+ SwitchKeyword = 103,
+ ThisKeyword = 104,
+ ThrowKeyword = 105,
+ TrueKeyword = 106,
+ TryKeyword = 107,
+ TypeOfKeyword = 108,
+ VarKeyword = 109,
+ VoidKeyword = 110,
+ WhileKeyword = 111,
+ WithKeyword = 112,
+ ImplementsKeyword = 113,
+ InterfaceKeyword = 114,
+ LetKeyword = 115,
+ PackageKeyword = 116,
+ PrivateKeyword = 117,
+ ProtectedKeyword = 118,
+ PublicKeyword = 119,
+ StaticKeyword = 120,
+ YieldKeyword = 121,
+ AbstractKeyword = 122,
+ AsKeyword = 123,
+ AssertsKeyword = 124,
+ AnyKeyword = 125,
+ AsyncKeyword = 126,
+ AwaitKeyword = 127,
+ BooleanKeyword = 128,
+ ConstructorKeyword = 129,
+ DeclareKeyword = 130,
+ GetKeyword = 131,
+ InferKeyword = 132,
+ IsKeyword = 133,
+ KeyOfKeyword = 134,
+ ModuleKeyword = 135,
+ NamespaceKeyword = 136,
+ NeverKeyword = 137,
+ ReadonlyKeyword = 138,
+ RequireKeyword = 139,
+ NumberKeyword = 140,
+ ObjectKeyword = 141,
+ SetKeyword = 142,
+ StringKeyword = 143,
+ SymbolKeyword = 144,
+ TypeKeyword = 145,
+ UndefinedKeyword = 146,
+ UniqueKeyword = 147,
+ UnknownKeyword = 148,
+ FromKeyword = 149,
+ GlobalKeyword = 150,
+ BigIntKeyword = 151,
+ OfKeyword = 152,
+ QualifiedName = 153,
+ ComputedPropertyName = 154,
+ TypeParameter = 155,
+ Parameter = 156,
+ Decorator = 157,
+ PropertySignature = 158,
+ PropertyDeclaration = 159,
+ MethodSignature = 160,
+ MethodDeclaration = 161,
+ Constructor = 162,
+ GetAccessor = 163,
+ SetAccessor = 164,
+ CallSignature = 165,
+ ConstructSignature = 166,
+ IndexSignature = 167,
+ TypePredicate = 168,
+ TypeReference = 169,
+ FunctionType = 170,
+ ConstructorType = 171,
+ TypeQuery = 172,
+ TypeLiteral = 173,
+ ArrayType = 174,
+ TupleType = 175,
+ OptionalType = 176,
+ RestType = 177,
+ UnionType = 178,
+ IntersectionType = 179,
+ ConditionalType = 180,
+ InferType = 181,
+ ParenthesizedType = 182,
+ ThisType = 183,
+ TypeOperator = 184,
+ IndexedAccessType = 185,
+ MappedType = 186,
+ LiteralType = 187,
+ ImportType = 188,
+ ObjectBindingPattern = 189,
+ ArrayBindingPattern = 190,
+ BindingElement = 191,
+ ArrayLiteralExpression = 192,
+ ObjectLiteralExpression = 193,
+ PropertyAccessExpression = 194,
+ ElementAccessExpression = 195,
+ CallExpression = 196,
+ NewExpression = 197,
+ TaggedTemplateExpression = 198,
+ TypeAssertionExpression = 199,
+ ParenthesizedExpression = 200,
+ FunctionExpression = 201,
+ ArrowFunction = 202,
+ DeleteExpression = 203,
+ TypeOfExpression = 204,
+ VoidExpression = 205,
+ AwaitExpression = 206,
+ PrefixUnaryExpression = 207,
+ PostfixUnaryExpression = 208,
+ BinaryExpression = 209,
+ ConditionalExpression = 210,
+ TemplateExpression = 211,
+ YieldExpression = 212,
+ SpreadElement = 213,
+ ClassExpression = 214,
+ OmittedExpression = 215,
+ ExpressionWithTypeArguments = 216,
+ AsExpression = 217,
+ NonNullExpression = 218,
+ MetaProperty = 219,
+ SyntheticExpression = 220,
+ TemplateSpan = 221,
+ SemicolonClassElement = 222,
+ Block = 223,
+ EmptyStatement = 224,
+ VariableStatement = 225,
+ ExpressionStatement = 226,
+ IfStatement = 227,
+ DoStatement = 228,
+ WhileStatement = 229,
+ ForStatement = 230,
+ ForInStatement = 231,
+ ForOfStatement = 232,
+ ContinueStatement = 233,
+ BreakStatement = 234,
+ ReturnStatement = 235,
+ WithStatement = 236,
+ SwitchStatement = 237,
+ LabeledStatement = 238,
+ ThrowStatement = 239,
+ TryStatement = 240,
+ DebuggerStatement = 241,
+ VariableDeclaration = 242,
+ VariableDeclarationList = 243,
+ FunctionDeclaration = 244,
+ ClassDeclaration = 245,
+ InterfaceDeclaration = 246,
+ TypeAliasDeclaration = 247,
+ EnumDeclaration = 248,
+ ModuleDeclaration = 249,
+ ModuleBlock = 250,
+ CaseBlock = 251,
+ NamespaceExportDeclaration = 252,
+ ImportEqualsDeclaration = 253,
+ ImportDeclaration = 254,
+ ImportClause = 255,
+ NamespaceImport = 256,
+ NamedImports = 257,
+ ImportSpecifier = 258,
+ ExportAssignment = 259,
+ ExportDeclaration = 260,
+ NamedExports = 261,
+ NamespaceExport = 262,
+ ExportSpecifier = 263,
+ MissingDeclaration = 264,
+ ExternalModuleReference = 265,
+ JsxElement = 266,
+ JsxSelfClosingElement = 267,
+ JsxOpeningElement = 268,
+ JsxClosingElement = 269,
+ JsxFragment = 270,
+ JsxOpeningFragment = 271,
+ JsxClosingFragment = 272,
+ JsxAttribute = 273,
+ JsxAttributes = 274,
+ JsxSpreadAttribute = 275,
+ JsxExpression = 276,
+ CaseClause = 277,
+ DefaultClause = 278,
+ HeritageClause = 279,
+ CatchClause = 280,
+ PropertyAssignment = 281,
+ ShorthandPropertyAssignment = 282,
+ SpreadAssignment = 283,
+ EnumMember = 284,
+ UnparsedPrologue = 285,
+ UnparsedPrepend = 286,
+ UnparsedText = 287,
+ UnparsedInternalText = 288,
+ UnparsedSyntheticReference = 289,
+ SourceFile = 290,
+ Bundle = 291,
+ UnparsedSource = 292,
+ InputFiles = 293,
+ JSDocTypeExpression = 294,
+ JSDocAllType = 295,
+ JSDocUnknownType = 296,
+ JSDocNullableType = 297,
+ JSDocNonNullableType = 298,
+ JSDocOptionalType = 299,
+ JSDocFunctionType = 300,
+ JSDocVariadicType = 301,
+ JSDocNamepathType = 302,
+ JSDocComment = 303,
+ JSDocTypeLiteral = 304,
+ JSDocSignature = 305,
+ JSDocTag = 306,
+ JSDocAugmentsTag = 307,
+ JSDocImplementsTag = 308,
+ JSDocAuthorTag = 309,
+ JSDocClassTag = 310,
+ JSDocPublicTag = 311,
+ JSDocPrivateTag = 312,
+ JSDocProtectedTag = 313,
+ JSDocReadonlyTag = 314,
+ JSDocCallbackTag = 315,
+ JSDocEnumTag = 316,
+ JSDocParameterTag = 317,
+ JSDocReturnTag = 318,
+ JSDocThisTag = 319,
+ JSDocTypeTag = 320,
+ JSDocTemplateTag = 321,
+ JSDocTypedefTag = 322,
+ JSDocPropertyTag = 323,
+ SyntaxList = 324,
+ NotEmittedStatement = 325,
+ PartiallyEmittedExpression = 326,
+ CommaListExpression = 327,
+ MergeDeclarationMarker = 328,
+ EndOfDeclarationMarker = 329,
+ SyntheticReferenceExpression = 330,
+ Count = 331,
+ FirstAssignment = 62,
+ LastAssignment = 74,
+ FirstCompoundAssignment = 63,
+ LastCompoundAssignment = 74,
+ FirstReservedWord = 77,
+ LastReservedWord = 112,
+ FirstKeyword = 77,
+ LastKeyword = 152,
+ FirstFutureReservedWord = 113,
+ LastFutureReservedWord = 121,
+ FirstTypeNode = 168,
+ LastTypeNode = 188,
+ FirstPunctuation = 18,
+ LastPunctuation = 74,
+ FirstToken = 0,
+ LastToken = 152,
+ FirstTriviaToken = 2,
+ LastTriviaToken = 7,
+ FirstLiteralToken = 8,
+ LastLiteralToken = 14,
+ FirstTemplateToken = 14,
+ LastTemplateToken = 17,
+ FirstBinaryOperator = 29,
+ LastBinaryOperator = 74,
+ FirstStatement = 225,
+ LastStatement = 241,
+ FirstNode = 153,
+ FirstJSDocNode = 294,
+ LastJSDocNode = 323,
+ FirstJSDocTagNode = 306,
+ LastJSDocTagNode = 323,
+ }
+ export enum NodeFlags {
+ None = 0,
+ Let = 1,
+ Const = 2,
+ NestedNamespace = 4,
+ Synthesized = 8,
+ Namespace = 16,
+ OptionalChain = 32,
+ ExportContext = 64,
+ ContainsThis = 128,
+ HasImplicitReturn = 256,
+ HasExplicitReturn = 512,
+ GlobalAugmentation = 1024,
+ HasAsyncFunctions = 2048,
+ DisallowInContext = 4096,
+ YieldContext = 8192,
+ DecoratorContext = 16384,
+ AwaitContext = 32768,
+ ThisNodeHasError = 65536,
+ JavaScriptFile = 131072,
+ ThisNodeOrAnySubNodesHasError = 262144,
+ HasAggregatedChildData = 524288,
+ JSDoc = 4194304,
+ JsonFile = 33554432,
+ BlockScoped = 3,
+ ReachabilityCheckFlags = 768,
+ ReachabilityAndEmitFlags = 2816,
+ ContextFlags = 25358336,
+ TypeExcludesFlags = 40960,
+ }
+ export enum ModifierFlags {
+ None = 0,
+ Export = 1,
+ Ambient = 2,
+ Public = 4,
+ Private = 8,
+ Protected = 16,
+ Static = 32,
+ Readonly = 64,
+ Abstract = 128,
+ Async = 256,
+ Default = 512,
+ Const = 2048,
+ HasComputedFlags = 536870912,
+ AccessibilityModifier = 28,
+ ParameterPropertyModifier = 92,
+ NonPublicAccessibilityModifier = 24,
+ TypeScriptModifier = 2270,
+ ExportDefault = 513,
+ All = 3071
+ }
+ export enum JsxFlags {
+ None = 0,
+ /** An element from a named property of the JSX.IntrinsicElements interface */
+ IntrinsicNamedElement = 1,
+ /** An element inferred from the string index signature of the JSX.IntrinsicElements interface */
+ IntrinsicIndexedElement = 2,
+ IntrinsicElement = 3
+ }
+ export interface Node extends TextRange {
+ kind: SyntaxKind;
+ flags: NodeFlags;
+ decorators?: NodeArray<Decorator>;
+ modifiers?: ModifiersArray;
+ parent: Node;
+ }
+ export interface JSDocContainer {
+ }
+ export type HasJSDoc = ParameterDeclaration | CallSignatureDeclaration | ConstructSignatureDeclaration | MethodSignature | PropertySignature | ArrowFunction | ParenthesizedExpression | SpreadAssignment | ShorthandPropertyAssignment | PropertyAssignment | FunctionExpression | LabeledStatement | ExpressionStatement | VariableStatement | FunctionDeclaration | ConstructorDeclaration | MethodDeclaration | PropertyDeclaration | AccessorDeclaration | ClassLikeDeclaration | InterfaceDeclaration | TypeAliasDeclaration | EnumMember | EnumDeclaration | ModuleDeclaration | ImportEqualsDeclaration | IndexSignatureDeclaration | FunctionTypeNode | ConstructorTypeNode | JSDocFunctionType | ExportDeclaration | EndOfFileToken;
+ export type HasType = SignatureDeclaration | VariableDeclaration | ParameterDeclaration | PropertySignature | PropertyDeclaration | TypePredicateNode | ParenthesizedTypeNode | TypeOperatorNode | MappedTypeNode | AssertionExpression | TypeAliasDeclaration | JSDocTypeExpression | JSDocNonNullableType | JSDocNullableType | JSDocOptionalType | JSDocVariadicType;
+ export type HasTypeArguments = CallExpression | NewExpression | TaggedTemplateExpression | JsxOpeningElement | JsxSelfClosingElement;
+ export type HasInitializer = HasExpressionInitializer | ForStatement | ForInStatement | ForOfStatement | JsxAttribute;
+ export type HasExpressionInitializer = VariableDeclaration | ParameterDeclaration | BindingElement | PropertySignature | PropertyDeclaration | PropertyAssignment | EnumMember;
+ export interface NodeArray<T extends Node> extends ReadonlyArray<T>, TextRange {
+ hasTrailingComma?: boolean;
+ }
+ export interface Token<TKind extends SyntaxKind> extends Node {
+ kind: TKind;
+ }
+ export type DotToken = Token<SyntaxKind.DotToken>;
+ export type DotDotDotToken = Token<SyntaxKind.DotDotDotToken>;
+ export type QuestionToken = Token<SyntaxKind.QuestionToken>;
+ export type QuestionDotToken = Token<SyntaxKind.QuestionDotToken>;
+ export type ExclamationToken = Token<SyntaxKind.ExclamationToken>;
+ export type ColonToken = Token<SyntaxKind.ColonToken>;
+ export type EqualsToken = Token<SyntaxKind.EqualsToken>;
+ export type AsteriskToken = Token<SyntaxKind.AsteriskToken>;
+ export type EqualsGreaterThanToken = Token<SyntaxKind.EqualsGreaterThanToken>;
+ export type EndOfFileToken = Token<SyntaxKind.EndOfFileToken> & JSDocContainer;
+ export type ReadonlyToken = Token<SyntaxKind.ReadonlyKeyword>;
+ export type AwaitKeywordToken = Token<SyntaxKind.AwaitKeyword>;
+ export type PlusToken = Token<SyntaxKind.PlusToken>;
+ export type MinusToken = Token<SyntaxKind.MinusToken>;
+ export type AssertsToken = Token<SyntaxKind.AssertsKeyword>;
+ export type Modifier = Token<SyntaxKind.AbstractKeyword> | Token<SyntaxKind.AsyncKeyword> | Token<SyntaxKind.ConstKeyword> | Token<SyntaxKind.DeclareKeyword> | Token<SyntaxKind.DefaultKeyword> | Token<SyntaxKind.ExportKeyword> | Token<SyntaxKind.PublicKeyword> | Token<SyntaxKind.PrivateKeyword> | Token<SyntaxKind.ProtectedKeyword> | Token<SyntaxKind.ReadonlyKeyword> | Token<SyntaxKind.StaticKeyword>;
+ export type ModifiersArray = NodeArray<Modifier>;
+ export interface Identifier extends PrimaryExpression, Declaration {
+ kind: SyntaxKind.Identifier;
+ /**
+ * Prefer to use `id.unescapedText`. (Note: This is available only in services, not internally to the TypeScript compiler.)
+ * Text of identifier, but if the identifier begins with two underscores, this will begin with three.
+ */
+ escapedText: __String;
+ originalKeywordKind?: SyntaxKind;
+ isInJSDocNamespace?: boolean;
+ }
+ export interface TransientIdentifier extends Identifier {
+ resolvedSymbol: Symbol;
+ }
+ export interface QualifiedName extends Node {
+ kind: SyntaxKind.QualifiedName;
+ left: EntityName;
+ right: Identifier;
+ }
+ export type EntityName = Identifier | QualifiedName;
+ export type PropertyName = Identifier | StringLiteral | NumericLiteral | ComputedPropertyName | PrivateIdentifier;
+ export type DeclarationName = Identifier | PrivateIdentifier | StringLiteralLike | NumericLiteral | ComputedPropertyName | ElementAccessExpression | BindingPattern | EntityNameExpression;
+ export interface Declaration extends Node {
+ _declarationBrand: any;
+ }
+ export interface NamedDeclaration extends Declaration {
+ name?: DeclarationName;
+ }
+ export interface DeclarationStatement extends NamedDeclaration, Statement {
+ name?: Identifier | StringLiteral | NumericLiteral;
+ }
+ export interface ComputedPropertyName extends Node {
+ parent: Declaration;
+ kind: SyntaxKind.ComputedPropertyName;
+ expression: Expression;
+ }
+ export interface PrivateIdentifier extends Node {
+ kind: SyntaxKind.PrivateIdentifier;
+ escapedText: __String;
+ }
+ export interface Decorator extends Node {
+ kind: SyntaxKind.Decorator;
+ parent: NamedDeclaration;
+ expression: LeftHandSideExpression;
+ }
+ export interface TypeParameterDeclaration extends NamedDeclaration {
+ kind: SyntaxKind.TypeParameter;
+ parent: DeclarationWithTypeParameterChildren | InferTypeNode;
+ name: Identifier;
+ /** Note: Consider calling `getEffectiveConstraintOfTypeParameter` */
+ constraint?: TypeNode;
+ default?: TypeNode;
+ expression?: Expression;
+ }
+ export interface SignatureDeclarationBase extends NamedDeclaration, JSDocContainer {
+ kind: SignatureDeclaration["kind"];
+ name?: PropertyName;
+ typeParameters?: NodeArray<TypeParameterDeclaration>;
+ parameters: NodeArray<ParameterDeclaration>;
+ type?: TypeNode;
+ }
+ export type SignatureDeclaration = CallSignatureDeclaration | ConstructSignatureDeclaration | MethodSignature | IndexSignatureDeclaration | FunctionTypeNode | ConstructorTypeNode | JSDocFunctionType | FunctionDeclaration | MethodDeclaration | ConstructorDeclaration | AccessorDeclaration | FunctionExpression | ArrowFunction;
+ export interface CallSignatureDeclaration extends SignatureDeclarationBase, TypeElement {
+ kind: SyntaxKind.CallSignature;
+ }
+ export interface ConstructSignatureDeclaration extends SignatureDeclarationBase, TypeElement {
+ kind: SyntaxKind.ConstructSignature;
+ }
+ export type BindingName = Identifier | BindingPattern;
+ export interface VariableDeclaration extends NamedDeclaration {
+ kind: SyntaxKind.VariableDeclaration;
+ parent: VariableDeclarationList | CatchClause;
+ name: BindingName;
+ exclamationToken?: ExclamationToken;
+ type?: TypeNode;
+ initializer?: Expression;
+ }
+ export interface VariableDeclarationList extends Node {
+ kind: SyntaxKind.VariableDeclarationList;
+ parent: VariableStatement | ForStatement | ForOfStatement | ForInStatement;
+ declarations: NodeArray<VariableDeclaration>;
+ }
+ export interface ParameterDeclaration extends NamedDeclaration, JSDocContainer {
+ kind: SyntaxKind.Parameter;
+ parent: SignatureDeclaration;
+ dotDotDotToken?: DotDotDotToken;
+ name: BindingName;
+ questionToken?: QuestionToken;
+ type?: TypeNode;
+ initializer?: Expression;
+ }
+ export interface BindingElement extends NamedDeclaration {
+ kind: SyntaxKind.BindingElement;
+ parent: BindingPattern;
+ propertyName?: PropertyName;
+ dotDotDotToken?: DotDotDotToken;
+ name: BindingName;
+ initializer?: Expression;
+ }
+ export interface PropertySignature extends TypeElement, JSDocContainer {
+ kind: SyntaxKind.PropertySignature;
+ name: PropertyName;
+ questionToken?: QuestionToken;
+ type?: TypeNode;
+ initializer?: Expression;
+ }
+ export interface PropertyDeclaration extends ClassElement, JSDocContainer {
+ kind: SyntaxKind.PropertyDeclaration;
+ parent: ClassLikeDeclaration;
+ name: PropertyName;
+ questionToken?: QuestionToken;
+ exclamationToken?: ExclamationToken;
+ type?: TypeNode;
+ initializer?: Expression;
+ }
+ export interface ObjectLiteralElement extends NamedDeclaration {
+ _objectLiteralBrand: any;
+ name?: PropertyName;
+ }
+ /** Unlike ObjectLiteralElement, excludes JSXAttribute and JSXSpreadAttribute. */
+ export type ObjectLiteralElementLike = PropertyAssignment | ShorthandPropertyAssignment | SpreadAssignment | MethodDeclaration | AccessorDeclaration;
+ export interface PropertyAssignment extends ObjectLiteralElement, JSDocContainer {
+ parent: ObjectLiteralExpression;
+ kind: SyntaxKind.PropertyAssignment;
+ name: PropertyName;
+ questionToken?: QuestionToken;
+ initializer: Expression;
+ }
+ export interface ShorthandPropertyAssignment extends ObjectLiteralElement, JSDocContainer {
+ parent: ObjectLiteralExpression;
+ kind: SyntaxKind.ShorthandPropertyAssignment;
+ name: Identifier;
+ questionToken?: QuestionToken;
+ exclamationToken?: ExclamationToken;
+ equalsToken?: Token<SyntaxKind.EqualsToken>;
+ objectAssignmentInitializer?: Expression;
+ }
+ export interface SpreadAssignment extends ObjectLiteralElement, JSDocContainer {
+ parent: ObjectLiteralExpression;
+ kind: SyntaxKind.SpreadAssignment;
+ expression: Expression;
+ }
+ export type VariableLikeDeclaration = VariableDeclaration | ParameterDeclaration | BindingElement | PropertyDeclaration | PropertyAssignment | PropertySignature | JsxAttribute | ShorthandPropertyAssignment | EnumMember | JSDocPropertyTag | JSDocParameterTag;
+ export interface PropertyLikeDeclaration extends NamedDeclaration {
+ name: PropertyName;
+ }
+ export interface ObjectBindingPattern extends Node {
+ kind: SyntaxKind.ObjectBindingPattern;
+ parent: VariableDeclaration | ParameterDeclaration | BindingElement;
+ elements: NodeArray<BindingElement>;
+ }
+ export interface ArrayBindingPattern extends Node {
+ kind: SyntaxKind.ArrayBindingPattern;
+ parent: VariableDeclaration | ParameterDeclaration | BindingElement;
+ elements: NodeArray<ArrayBindingElement>;
+ }
+ export type BindingPattern = ObjectBindingPattern | ArrayBindingPattern;
+ export type ArrayBindingElement = BindingElement | OmittedExpression;
+ /**
+ * Several node kinds share function-like features such as a signature,
+ * a name, and a body. These nodes should extend FunctionLikeDeclarationBase.
+ * Examples:
+ * - FunctionDeclaration
+ * - MethodDeclaration
+ * - AccessorDeclaration
+ */
+ export interface FunctionLikeDeclarationBase extends SignatureDeclarationBase {
+ _functionLikeDeclarationBrand: any;
+ asteriskToken?: AsteriskToken;
+ questionToken?: QuestionToken;
+ exclamationToken?: ExclamationToken;
+ body?: Block | Expression;
+ }
+ export type FunctionLikeDeclaration = FunctionDeclaration | MethodDeclaration | GetAccessorDeclaration | SetAccessorDeclaration | ConstructorDeclaration | FunctionExpression | ArrowFunction;
+ /** @deprecated Use SignatureDeclaration */
+ export type FunctionLike = SignatureDeclaration;
+ export interface FunctionDeclaration extends FunctionLikeDeclarationBase, DeclarationStatement {
+ kind: SyntaxKind.FunctionDeclaration;
+ name?: Identifier;
+ body?: FunctionBody;
+ }
+ export interface MethodSignature extends SignatureDeclarationBase, TypeElement {
+ kind: SyntaxKind.MethodSignature;
+ parent: ObjectTypeDeclaration;
+ name: PropertyName;
+ }
+ export interface MethodDeclaration extends FunctionLikeDeclarationBase, ClassElement, ObjectLiteralElement, JSDocContainer {
+ kind: SyntaxKind.MethodDeclaration;
+ parent: ClassLikeDeclaration | ObjectLiteralExpression;
+ name: PropertyName;
+ body?: FunctionBody;
+ }
+ export interface ConstructorDeclaration extends FunctionLikeDeclarationBase, ClassElement, JSDocContainer {
+ kind: SyntaxKind.Constructor;
+ parent: ClassLikeDeclaration;
+ body?: FunctionBody;
+ }
+ /** For when we encounter a semicolon in a class declaration. ES6 allows these as class elements. */
+ export interface SemicolonClassElement extends ClassElement {
+ kind: SyntaxKind.SemicolonClassElement;
+ parent: ClassLikeDeclaration;
+ }
+ export interface GetAccessorDeclaration extends FunctionLikeDeclarationBase, ClassElement, ObjectLiteralElement, JSDocContainer {
+ kind: SyntaxKind.GetAccessor;
+ parent: ClassLikeDeclaration | ObjectLiteralExpression;
+ name: PropertyName;
+ body?: FunctionBody;
+ }
+ export interface SetAccessorDeclaration extends FunctionLikeDeclarationBase, ClassElement, ObjectLiteralElement, JSDocContainer {
+ kind: SyntaxKind.SetAccessor;
+ parent: ClassLikeDeclaration | ObjectLiteralExpression;
+ name: PropertyName;
+ body?: FunctionBody;
+ }
+ export type AccessorDeclaration = GetAccessorDeclaration | SetAccessorDeclaration;
+ export interface IndexSignatureDeclaration extends SignatureDeclarationBase, ClassElement, TypeElement {
+ kind: SyntaxKind.IndexSignature;
+ parent: ObjectTypeDeclaration;
+ }
+ export interface TypeNode extends Node {
+ _typeNodeBrand: any;
+ }
+ export interface KeywordTypeNode extends TypeNode {
+ kind: SyntaxKind.AnyKeyword | SyntaxKind.UnknownKeyword | SyntaxKind.NumberKeyword | SyntaxKind.BigIntKeyword | SyntaxKind.ObjectKeyword | SyntaxKind.BooleanKeyword | SyntaxKind.StringKeyword | SyntaxKind.SymbolKeyword | SyntaxKind.ThisKeyword | SyntaxKind.VoidKeyword | SyntaxKind.UndefinedKeyword | SyntaxKind.NullKeyword | SyntaxKind.NeverKeyword;
+ }
+ export interface ImportTypeNode extends NodeWithTypeArguments {
+ kind: SyntaxKind.ImportType;
+ isTypeOf?: boolean;
+ argument: TypeNode;
+ qualifier?: EntityName;
+ }
+ export interface ThisTypeNode extends TypeNode {
+ kind: SyntaxKind.ThisType;
+ }
+ export type FunctionOrConstructorTypeNode = FunctionTypeNode | ConstructorTypeNode;
+ export interface FunctionOrConstructorTypeNodeBase extends TypeNode, SignatureDeclarationBase {
+ kind: SyntaxKind.FunctionType | SyntaxKind.ConstructorType;
+ type: TypeNode;
+ }
+ export interface FunctionTypeNode extends FunctionOrConstructorTypeNodeBase {
+ kind: SyntaxKind.FunctionType;
+ }
+ export interface ConstructorTypeNode extends FunctionOrConstructorTypeNodeBase {
+ kind: SyntaxKind.ConstructorType;
+ }
+ export interface NodeWithTypeArguments extends TypeNode {
+ typeArguments?: NodeArray<TypeNode>;
+ }
+ export type TypeReferenceType = TypeReferenceNode | ExpressionWithTypeArguments;
+ export interface TypeReferenceNode extends NodeWithTypeArguments {
+ kind: SyntaxKind.TypeReference;
+ typeName: EntityName;
+ }
+ export interface TypePredicateNode extends TypeNode {
+ kind: SyntaxKind.TypePredicate;
+ parent: SignatureDeclaration | JSDocTypeExpression;
+ assertsModifier?: AssertsToken;
+ parameterName: Identifier | ThisTypeNode;
+ type?: TypeNode;
+ }
+ export interface TypeQueryNode extends TypeNode {
+ kind: SyntaxKind.TypeQuery;
+ exprName: EntityName;
+ }
+ export interface TypeLiteralNode extends TypeNode, Declaration {
+ kind: SyntaxKind.TypeLiteral;
+ members: NodeArray<TypeElement>;
+ }
+ export interface ArrayTypeNode extends TypeNode {
+ kind: SyntaxKind.ArrayType;
+ elementType: TypeNode;
+ }
+ export interface TupleTypeNode extends TypeNode {
+ kind: SyntaxKind.TupleType;
+ elementTypes: NodeArray<TypeNode>;
+ }
+ export interface OptionalTypeNode extends TypeNode {
+ kind: SyntaxKind.OptionalType;
+ type: TypeNode;
+ }
+ export interface RestTypeNode extends TypeNode {
+ kind: SyntaxKind.RestType;
+ type: TypeNode;
+ }
+ export type UnionOrIntersectionTypeNode = UnionTypeNode | IntersectionTypeNode;
+ export interface UnionTypeNode extends TypeNode {
+ kind: SyntaxKind.UnionType;
+ types: NodeArray<TypeNode>;
+ }
+ export interface IntersectionTypeNode extends TypeNode {
+ kind: SyntaxKind.IntersectionType;
+ types: NodeArray<TypeNode>;
+ }
+ export interface ConditionalTypeNode extends TypeNode {
+ kind: SyntaxKind.ConditionalType;
+ checkType: TypeNode;
+ extendsType: TypeNode;
+ trueType: TypeNode;
+ falseType: TypeNode;
+ }
+ export interface InferTypeNode extends TypeNode {
+ kind: SyntaxKind.InferType;
+ typeParameter: TypeParameterDeclaration;
+ }
+ export interface ParenthesizedTypeNode extends TypeNode {
+ kind: SyntaxKind.ParenthesizedType;
+ type: TypeNode;
+ }
+ export interface TypeOperatorNode extends TypeNode {
+ kind: SyntaxKind.TypeOperator;
+ operator: SyntaxKind.KeyOfKeyword | SyntaxKind.UniqueKeyword | SyntaxKind.ReadonlyKeyword;
+ type: TypeNode;
+ }
+ export interface IndexedAccessTypeNode extends TypeNode {
+ kind: SyntaxKind.IndexedAccessType;
+ objectType: TypeNode;
+ indexType: TypeNode;
+ }
+ export interface MappedTypeNode extends TypeNode, Declaration {
+ kind: SyntaxKind.MappedType;
+ readonlyToken?: ReadonlyToken | PlusToken | MinusToken;
+ typeParameter: TypeParameterDeclaration;
+ questionToken?: QuestionToken | PlusToken | MinusToken;
+ type?: TypeNode;
+ }
+ export interface LiteralTypeNode extends TypeNode {
+ kind: SyntaxKind.LiteralType;
+ literal: BooleanLiteral | LiteralExpression | PrefixUnaryExpression;
+ }
+ export interface StringLiteral extends LiteralExpression, Declaration {
+ kind: SyntaxKind.StringLiteral;
+ }
+ export type StringLiteralLike = StringLiteral | NoSubstitutionTemplateLiteral;
+ export interface Expression extends Node {
+ _expressionBrand: any;
+ }
+ export interface OmittedExpression extends Expression {
+ kind: SyntaxKind.OmittedExpression;
+ }
+ export interface PartiallyEmittedExpression extends LeftHandSideExpression {
+ kind: SyntaxKind.PartiallyEmittedExpression;
+ expression: Expression;
+ }
+ export interface UnaryExpression extends Expression {
+ _unaryExpressionBrand: any;
+ }
+ /** Deprecated, please use UpdateExpression */
+ export type IncrementExpression = UpdateExpression;
+ export interface UpdateExpression extends UnaryExpression {
+ _updateExpressionBrand: any;
+ }
+ export type PrefixUnaryOperator = SyntaxKind.PlusPlusToken | SyntaxKind.MinusMinusToken | SyntaxKind.PlusToken | SyntaxKind.MinusToken | SyntaxKind.TildeToken | SyntaxKind.ExclamationToken;
+ export interface PrefixUnaryExpression extends UpdateExpression {
+ kind: SyntaxKind.PrefixUnaryExpression;
+ operator: PrefixUnaryOperator;
+ operand: UnaryExpression;
+ }
+ export type PostfixUnaryOperator = SyntaxKind.PlusPlusToken | SyntaxKind.MinusMinusToken;
+ export interface PostfixUnaryExpression extends UpdateExpression {
+ kind: SyntaxKind.PostfixUnaryExpression;
+ operand: LeftHandSideExpression;
+ operator: PostfixUnaryOperator;
+ }
+ export interface LeftHandSideExpression extends UpdateExpression {
+ _leftHandSideExpressionBrand: any;
+ }
+ export interface MemberExpression extends LeftHandSideExpression {
+ _memberExpressionBrand: any;
+ }
+ export interface PrimaryExpression extends MemberExpression {
+ _primaryExpressionBrand: any;
+ }
+ export interface NullLiteral extends PrimaryExpression, TypeNode {
+ kind: SyntaxKind.NullKeyword;
+ }
+ export interface BooleanLiteral extends PrimaryExpression, TypeNode {
+ kind: SyntaxKind.TrueKeyword | SyntaxKind.FalseKeyword;
+ }
+ export interface ThisExpression extends PrimaryExpression, KeywordTypeNode {
+ kind: SyntaxKind.ThisKeyword;
+ }
+ export interface SuperExpression extends PrimaryExpression {
+ kind: SyntaxKind.SuperKeyword;
+ }
+ export interface ImportExpression extends PrimaryExpression {
+ kind: SyntaxKind.ImportKeyword;
+ }
+ export interface DeleteExpression extends UnaryExpression {
+ kind: SyntaxKind.DeleteExpression;
+ expression: UnaryExpression;
+ }
+ export interface TypeOfExpression extends UnaryExpression {
+ kind: SyntaxKind.TypeOfExpression;
+ expression: UnaryExpression;
+ }
+ export interface VoidExpression extends UnaryExpression {
+ kind: SyntaxKind.VoidExpression;
+ expression: UnaryExpression;
+ }
+ export interface AwaitExpression extends UnaryExpression {
+ kind: SyntaxKind.AwaitExpression;
+ expression: UnaryExpression;
+ }
+ export interface YieldExpression extends Expression {
+ kind: SyntaxKind.YieldExpression;
+ asteriskToken?: AsteriskToken;
+ expression?: Expression;
+ }
+ export interface SyntheticExpression extends Expression {
+ kind: SyntaxKind.SyntheticExpression;
+ isSpread: boolean;
+ type: Type;
+ }
+ export type ExponentiationOperator = SyntaxKind.AsteriskAsteriskToken;
+ export type MultiplicativeOperator = SyntaxKind.AsteriskToken | SyntaxKind.SlashToken | SyntaxKind.PercentToken;
+ export type MultiplicativeOperatorOrHigher = ExponentiationOperator | MultiplicativeOperator;
+ export type AdditiveOperator = SyntaxKind.PlusToken | SyntaxKind.MinusToken;
+ export type AdditiveOperatorOrHigher = MultiplicativeOperatorOrHigher | AdditiveOperator;
+ export type ShiftOperator = SyntaxKind.LessThanLessThanToken | SyntaxKind.GreaterThanGreaterThanToken | SyntaxKind.GreaterThanGreaterThanGreaterThanToken;
+ export type ShiftOperatorOrHigher = AdditiveOperatorOrHigher | ShiftOperator;
+ export type RelationalOperator = SyntaxKind.LessThanToken | SyntaxKind.LessThanEqualsToken | SyntaxKind.GreaterThanToken | SyntaxKind.GreaterThanEqualsToken | SyntaxKind.InstanceOfKeyword | SyntaxKind.InKeyword;
+ export type RelationalOperatorOrHigher = ShiftOperatorOrHigher | RelationalOperator;
+ export type EqualityOperator = SyntaxKind.EqualsEqualsToken | SyntaxKind.EqualsEqualsEqualsToken | SyntaxKind.ExclamationEqualsEqualsToken | SyntaxKind.ExclamationEqualsToken;
+ export type EqualityOperatorOrHigher = RelationalOperatorOrHigher | EqualityOperator;
+ export type BitwiseOperator = SyntaxKind.AmpersandToken | SyntaxKind.BarToken | SyntaxKind.CaretToken;
+ export type BitwiseOperatorOrHigher = EqualityOperatorOrHigher | BitwiseOperator;
+ export type LogicalOperator = SyntaxKind.AmpersandAmpersandToken | SyntaxKind.BarBarToken;
+ export type LogicalOperatorOrHigher = BitwiseOperatorOrHigher | LogicalOperator;
+ export type CompoundAssignmentOperator = SyntaxKind.PlusEqualsToken | SyntaxKind.MinusEqualsToken | SyntaxKind.AsteriskAsteriskEqualsToken | SyntaxKind.AsteriskEqualsToken | SyntaxKind.SlashEqualsToken | SyntaxKind.PercentEqualsToken | SyntaxKind.AmpersandEqualsToken | SyntaxKind.BarEqualsToken | SyntaxKind.CaretEqualsToken | SyntaxKind.LessThanLessThanEqualsToken | SyntaxKind.GreaterThanGreaterThanGreaterThanEqualsToken | SyntaxKind.GreaterThanGreaterThanEqualsToken;
+ export type AssignmentOperator = SyntaxKind.EqualsToken | CompoundAssignmentOperator;
+ export type AssignmentOperatorOrHigher = SyntaxKind.QuestionQuestionToken | LogicalOperatorOrHigher | AssignmentOperator;
+ export type BinaryOperator = AssignmentOperatorOrHigher | SyntaxKind.CommaToken;
+ export type BinaryOperatorToken = Token<BinaryOperator>;
+ export interface BinaryExpression extends Expression, Declaration {
+ kind: SyntaxKind.BinaryExpression;
+ left: Expression;
+ operatorToken: BinaryOperatorToken;
+ right: Expression;
+ }
+ export type AssignmentOperatorToken = Token<AssignmentOperator>;
+ export interface AssignmentExpression<TOperator extends AssignmentOperatorToken> extends BinaryExpression {
+ left: LeftHandSideExpression;
+ operatorToken: TOperator;
+ }
+ export interface ObjectDestructuringAssignment extends AssignmentExpression<EqualsToken> {
+ left: ObjectLiteralExpression;
+ }
+ export interface ArrayDestructuringAssignment extends AssignmentExpression<EqualsToken> {
+ left: ArrayLiteralExpression;
+ }
+ export type DestructuringAssignment = ObjectDestructuringAssignment | ArrayDestructuringAssignment;
+ export type BindingOrAssignmentElement = VariableDeclaration | ParameterDeclaration | BindingElement | PropertyAssignment | ShorthandPropertyAssignment | SpreadAssignment | OmittedExpression | SpreadElement | ArrayLiteralExpression | ObjectLiteralExpression | AssignmentExpression<EqualsToken> | Identifier | PropertyAccessExpression | ElementAccessExpression;
+ export type BindingOrAssignmentElementRestIndicator = DotDotDotToken | SpreadElement | SpreadAssignment;
+ export type BindingOrAssignmentElementTarget = BindingOrAssignmentPattern | Identifier | PropertyAccessExpression | ElementAccessExpression | OmittedExpression;
+ export type ObjectBindingOrAssignmentPattern = ObjectBindingPattern | ObjectLiteralExpression;
+ export type ArrayBindingOrAssignmentPattern = ArrayBindingPattern | ArrayLiteralExpression;
+ export type AssignmentPattern = ObjectLiteralExpression | ArrayLiteralExpression;
+ export type BindingOrAssignmentPattern = ObjectBindingOrAssignmentPattern | ArrayBindingOrAssignmentPattern;
+ export interface ConditionalExpression extends Expression {
+ kind: SyntaxKind.ConditionalExpression;
+ condition: Expression;
+ questionToken: QuestionToken;
+ whenTrue: Expression;
+ colonToken: ColonToken;
+ whenFalse: Expression;
+ }
+ export type FunctionBody = Block;
+ export type ConciseBody = FunctionBody | Expression;
+ export interface FunctionExpression extends PrimaryExpression, FunctionLikeDeclarationBase, JSDocContainer {
+ kind: SyntaxKind.FunctionExpression;
+ name?: Identifier;
+ body: FunctionBody;
+ }
+ export interface ArrowFunction extends Expression, FunctionLikeDeclarationBase, JSDocContainer {
+ kind: SyntaxKind.ArrowFunction;
+ equalsGreaterThanToken: EqualsGreaterThanToken;
+ body: ConciseBody;
+ name: never;
+ }
+ export interface LiteralLikeNode extends Node {
+ text: string;
+ isUnterminated?: boolean;
+ hasExtendedUnicodeEscape?: boolean;
+ }
+ export interface TemplateLiteralLikeNode extends LiteralLikeNode {
+ rawText?: string;
+ }
+ export interface LiteralExpression extends LiteralLikeNode, PrimaryExpression {
+ _literalExpressionBrand: any;
+ }
+ export interface RegularExpressionLiteral extends LiteralExpression {
+ kind: SyntaxKind.RegularExpressionLiteral;
+ }
+ export interface NoSubstitutionTemplateLiteral extends LiteralExpression, TemplateLiteralLikeNode, Declaration {
+ kind: SyntaxKind.NoSubstitutionTemplateLiteral;
+ }
+ export enum TokenFlags {
+ None = 0,
+ Scientific = 16,
+ Octal = 32,
+ HexSpecifier = 64,
+ BinarySpecifier = 128,
+ OctalSpecifier = 256,
+ }
+ export interface NumericLiteral extends LiteralExpression, Declaration {
+ kind: SyntaxKind.NumericLiteral;
+ }
+ export interface BigIntLiteral extends LiteralExpression {
+ kind: SyntaxKind.BigIntLiteral;
+ }
+ export interface TemplateHead extends TemplateLiteralLikeNode {
+ kind: SyntaxKind.TemplateHead;
+ parent: TemplateExpression;
+ }
+ export interface TemplateMiddle extends TemplateLiteralLikeNode {
+ kind: SyntaxKind.TemplateMiddle;
+ parent: TemplateSpan;
+ }
+ export interface TemplateTail extends TemplateLiteralLikeNode {
+ kind: SyntaxKind.TemplateTail;
+ parent: TemplateSpan;
+ }
+ export type TemplateLiteral = TemplateExpression | NoSubstitutionTemplateLiteral;
+ export interface TemplateExpression extends PrimaryExpression {
+ kind: SyntaxKind.TemplateExpression;
+ head: TemplateHead;
+ templateSpans: NodeArray<TemplateSpan>;
+ }
+ export interface TemplateSpan extends Node {
+ kind: SyntaxKind.TemplateSpan;
+ parent: TemplateExpression;
+ expression: Expression;
+ literal: TemplateMiddle | TemplateTail;
+ }
+ export interface ParenthesizedExpression extends PrimaryExpression, JSDocContainer {
+ kind: SyntaxKind.ParenthesizedExpression;
+ expression: Expression;
+ }
+ export interface ArrayLiteralExpression extends PrimaryExpression {
+ kind: SyntaxKind.ArrayLiteralExpression;
+ elements: NodeArray<Expression>;
+ }
+ export interface SpreadElement extends Expression {
+ kind: SyntaxKind.SpreadElement;
+ parent: ArrayLiteralExpression | CallExpression | NewExpression;
+ expression: Expression;
+ }
+ /**
+ * This interface is a base interface for ObjectLiteralExpression and JSXAttributes to extend from. JSXAttributes is similar to
+ * ObjectLiteralExpression in that it contains array of properties; however, JSXAttributes' properties can only be
+ * JSXAttribute or JSXSpreadAttribute. ObjectLiteralExpression, on the other hand, can only have properties of type
+ * ObjectLiteralElement (e.g. PropertyAssignment, ShorthandPropertyAssignment etc.)
+ */
+ export interface ObjectLiteralExpressionBase<T extends ObjectLiteralElement> extends PrimaryExpression, Declaration {
+ properties: NodeArray<T>;
+ }
+ export interface ObjectLiteralExpression extends ObjectLiteralExpressionBase<ObjectLiteralElementLike> {
+ kind: SyntaxKind.ObjectLiteralExpression;
+ }
+ export type EntityNameExpression = Identifier | PropertyAccessEntityNameExpression;
+ export type EntityNameOrEntityNameExpression = EntityName | EntityNameExpression;
+ export interface PropertyAccessExpression extends MemberExpression, NamedDeclaration {
+ kind: SyntaxKind.PropertyAccessExpression;
+ expression: LeftHandSideExpression;
+ questionDotToken?: QuestionDotToken;
+ name: Identifier | PrivateIdentifier;
+ }
+ export interface PropertyAccessChain extends PropertyAccessExpression {
+ _optionalChainBrand: any;
+ name: Identifier;
+ }
+ export interface SuperPropertyAccessExpression extends PropertyAccessExpression {
+ expression: SuperExpression;
+ }
+ /** Brand for a PropertyAccessExpression which, like a QualifiedName, consists of a sequence of identifiers separated by dots. */
+ export interface PropertyAccessEntityNameExpression extends PropertyAccessExpression {
+ _propertyAccessExpressionLikeQualifiedNameBrand?: any;
+ expression: EntityNameExpression;
+ name: Identifier;
+ }
+ export interface ElementAccessExpression extends MemberExpression {
+ kind: SyntaxKind.ElementAccessExpression;
+ expression: LeftHandSideExpression;
+ questionDotToken?: QuestionDotToken;
+ argumentExpression: Expression;
+ }
+ export interface ElementAccessChain extends ElementAccessExpression {
+ _optionalChainBrand: any;
+ }
+ export interface SuperElementAccessExpression extends ElementAccessExpression {
+ expression: SuperExpression;
+ }
+ export type SuperProperty = SuperPropertyAccessExpression | SuperElementAccessExpression;
+ export interface CallExpression extends LeftHandSideExpression, Declaration {
+ kind: SyntaxKind.CallExpression;
+ expression: LeftHandSideExpression;
+ questionDotToken?: QuestionDotToken;
+ typeArguments?: NodeArray<TypeNode>;
+ arguments: NodeArray<Expression>;
+ }
+ export interface CallChain extends CallExpression {
+ _optionalChainBrand: any;
+ }
+ export type OptionalChain = PropertyAccessChain | ElementAccessChain | CallChain | NonNullChain;
+ export interface SuperCall extends CallExpression {
+ expression: SuperExpression;
+ }
+ export interface ImportCall extends CallExpression {
+ expression: ImportExpression;
+ }
+ export interface ExpressionWithTypeArguments extends NodeWithTypeArguments {
+ kind: SyntaxKind.ExpressionWithTypeArguments;
+ parent: HeritageClause | JSDocAugmentsTag | JSDocImplementsTag;
+ expression: LeftHandSideExpression;
+ }
+ export interface NewExpression extends PrimaryExpression, Declaration {
+ kind: SyntaxKind.NewExpression;
+ expression: LeftHandSideExpression;
+ typeArguments?: NodeArray<TypeNode>;
+ arguments?: NodeArray<Expression>;
+ }
+ export interface TaggedTemplateExpression extends MemberExpression {
+ kind: SyntaxKind.TaggedTemplateExpression;
+ tag: LeftHandSideExpression;
+ typeArguments?: NodeArray<TypeNode>;
+ template: TemplateLiteral;
+ }
+ export type CallLikeExpression = CallExpression | NewExpression | TaggedTemplateExpression | Decorator | JsxOpeningLikeElement;
+ export interface AsExpression extends Expression {
+ kind: SyntaxKind.AsExpression;
+ expression: Expression;
+ type: TypeNode;
+ }
+ export interface TypeAssertion extends UnaryExpression {
+ kind: SyntaxKind.TypeAssertionExpression;
+ type: TypeNode;
+ expression: UnaryExpression;
+ }
+ export type AssertionExpression = TypeAssertion | AsExpression;
+ export interface NonNullExpression extends LeftHandSideExpression {
+ kind: SyntaxKind.NonNullExpression;
+ expression: Expression;
+ }
+ export interface NonNullChain extends NonNullExpression {
+ _optionalChainBrand: any;
+ }
+ export interface MetaProperty extends PrimaryExpression {
+ kind: SyntaxKind.MetaProperty;
+ keywordToken: SyntaxKind.NewKeyword | SyntaxKind.ImportKeyword;
+ name: Identifier;
+ }
+ export interface JsxElement extends PrimaryExpression {
+ kind: SyntaxKind.JsxElement;
+ openingElement: JsxOpeningElement;
+ children: NodeArray<JsxChild>;
+ closingElement: JsxClosingElement;
+ }
+ export type JsxOpeningLikeElement = JsxSelfClosingElement | JsxOpeningElement;
+ export type JsxAttributeLike = JsxAttribute | JsxSpreadAttribute;
+ export type JsxTagNameExpression = Identifier | ThisExpression | JsxTagNamePropertyAccess;
+ export interface JsxTagNamePropertyAccess extends PropertyAccessExpression {
+ expression: JsxTagNameExpression;
+ }
+ export interface JsxAttributes extends ObjectLiteralExpressionBase<JsxAttributeLike> {
+ kind: SyntaxKind.JsxAttributes;
+ parent: JsxOpeningLikeElement;
+ }
+ export interface JsxOpeningElement extends Expression {
+ kind: SyntaxKind.JsxOpeningElement;
+ parent: JsxElement;
+ tagName: JsxTagNameExpression;
+ typeArguments?: NodeArray<TypeNode>;
+ attributes: JsxAttributes;
+ }
+ export interface JsxSelfClosingElement extends PrimaryExpression {
+ kind: SyntaxKind.JsxSelfClosingElement;
+ tagName: JsxTagNameExpression;
+ typeArguments?: NodeArray<TypeNode>;
+ attributes: JsxAttributes;
+ }
+ export interface JsxFragment extends PrimaryExpression {
+ kind: SyntaxKind.JsxFragment;
+ openingFragment: JsxOpeningFragment;
+ children: NodeArray<JsxChild>;
+ closingFragment: JsxClosingFragment;
+ }
+ export interface JsxOpeningFragment extends Expression {
+ kind: SyntaxKind.JsxOpeningFragment;
+ parent: JsxFragment;
+ }
+ export interface JsxClosingFragment extends Expression {
+ kind: SyntaxKind.JsxClosingFragment;
+ parent: JsxFragment;
+ }
+ export interface JsxAttribute extends ObjectLiteralElement {
+ kind: SyntaxKind.JsxAttribute;
+ parent: JsxAttributes;
+ name: Identifier;
+ initializer?: StringLiteral | JsxExpression;
+ }
+ export interface JsxSpreadAttribute extends ObjectLiteralElement {
+ kind: SyntaxKind.JsxSpreadAttribute;
+ parent: JsxAttributes;
+ expression: Expression;
+ }
+ export interface JsxClosingElement extends Node {
+ kind: SyntaxKind.JsxClosingElement;
+ parent: JsxElement;
+ tagName: JsxTagNameExpression;
+ }
+ export interface JsxExpression extends Expression {
+ kind: SyntaxKind.JsxExpression;
+ parent: JsxElement | JsxAttributeLike;
+ dotDotDotToken?: Token<SyntaxKind.DotDotDotToken>;
+ expression?: Expression;
+ }
+ export interface JsxText extends LiteralLikeNode {
+ kind: SyntaxKind.JsxText;
+ containsOnlyTriviaWhiteSpaces: boolean;
+ parent: JsxElement;
+ }
+ export type JsxChild = JsxText | JsxExpression | JsxElement | JsxSelfClosingElement | JsxFragment;
+ export interface Statement extends Node {
+ _statementBrand: any;
+ }
+ export interface NotEmittedStatement extends Statement {
+ kind: SyntaxKind.NotEmittedStatement;
+ }
+ /**
+ * A list of comma-separated expressions. This node is only created by transformations.
+ */
+ export interface CommaListExpression extends Expression {
+ kind: SyntaxKind.CommaListExpression;
+ elements: NodeArray<Expression>;
+ }
+ export interface EmptyStatement extends Statement {
+ kind: SyntaxKind.EmptyStatement;
+ }
+ export interface DebuggerStatement extends Statement {
+ kind: SyntaxKind.DebuggerStatement;
+ }
+ export interface MissingDeclaration extends DeclarationStatement {
+ kind: SyntaxKind.MissingDeclaration;
+ name?: Identifier;
+ }
+ export type BlockLike = SourceFile | Block | ModuleBlock | CaseOrDefaultClause;
+ export interface Block extends Statement {
+ kind: SyntaxKind.Block;
+ statements: NodeArray<Statement>;
+ }
+ export interface VariableStatement extends Statement, JSDocContainer {
+ kind: SyntaxKind.VariableStatement;
+ declarationList: VariableDeclarationList;
+ }
+ export interface ExpressionStatement extends Statement, JSDocContainer {
+ kind: SyntaxKind.ExpressionStatement;
+ expression: Expression;
+ }
+ export interface IfStatement extends Statement {
+ kind: SyntaxKind.IfStatement;
+ expression: Expression;
+ thenStatement: Statement;
+ elseStatement?: Statement;
+ }
+ export interface IterationStatement extends Statement {
+ statement: Statement;
+ }
+ export interface DoStatement extends IterationStatement {
+ kind: SyntaxKind.DoStatement;
+ expression: Expression;
+ }
+ export interface WhileStatement extends IterationStatement {
+ kind: SyntaxKind.WhileStatement;
+ expression: Expression;
+ }
+ export type ForInitializer = VariableDeclarationList | Expression;
+ export interface ForStatement extends IterationStatement {
+ kind: SyntaxKind.ForStatement;
+ initializer?: ForInitializer;
+ condition?: Expression;
+ incrementor?: Expression;
+ }
+ export type ForInOrOfStatement = ForInStatement | ForOfStatement;
+ export interface ForInStatement extends IterationStatement {
+ kind: SyntaxKind.ForInStatement;
+ initializer: ForInitializer;
+ expression: Expression;
+ }
+ export interface ForOfStatement extends IterationStatement {
+ kind: SyntaxKind.ForOfStatement;
+ awaitModifier?: AwaitKeywordToken;
+ initializer: ForInitializer;
+ expression: Expression;
+ }
+ export interface BreakStatement extends Statement {
+ kind: SyntaxKind.BreakStatement;
+ label?: Identifier;
+ }
+ export interface ContinueStatement extends Statement {
+ kind: SyntaxKind.ContinueStatement;
+ label?: Identifier;
+ }
+ export type BreakOrContinueStatement = BreakStatement | ContinueStatement;
+ export interface ReturnStatement extends Statement {
+ kind: SyntaxKind.ReturnStatement;
+ expression?: Expression;
+ }
+ export interface WithStatement extends Statement {
+ kind: SyntaxKind.WithStatement;
+ expression: Expression;
+ statement: Statement;
+ }
+ export interface SwitchStatement extends Statement {
+ kind: SyntaxKind.SwitchStatement;
+ expression: Expression;
+ caseBlock: CaseBlock;
+ possiblyExhaustive?: boolean;
+ }
+ export interface CaseBlock extends Node {
+ kind: SyntaxKind.CaseBlock;
+ parent: SwitchStatement;
+ clauses: NodeArray<CaseOrDefaultClause>;
+ }
+ export interface CaseClause extends Node {
+ kind: SyntaxKind.CaseClause;
+ parent: CaseBlock;
+ expression: Expression;
+ statements: NodeArray<Statement>;
+ }
+ export interface DefaultClause extends Node {
+ kind: SyntaxKind.DefaultClause;
+ parent: CaseBlock;
+ statements: NodeArray<Statement>;
+ }
+ export type CaseOrDefaultClause = CaseClause | DefaultClause;
+ export interface LabeledStatement extends Statement, JSDocContainer {
+ kind: SyntaxKind.LabeledStatement;
+ label: Identifier;
+ statement: Statement;
+ }
+ export interface ThrowStatement extends Statement {
+ kind: SyntaxKind.ThrowStatement;
+ expression?: Expression;
+ }
+ export interface TryStatement extends Statement {
+ kind: SyntaxKind.TryStatement;
+ tryBlock: Block;
+ catchClause?: CatchClause;
+ finallyBlock?: Block;
+ }
+ export interface CatchClause extends Node {
+ kind: SyntaxKind.CatchClause;
+ parent: TryStatement;
+ variableDeclaration?: VariableDeclaration;
+ block: Block;
+ }
+ export type ObjectTypeDeclaration = ClassLikeDeclaration | InterfaceDeclaration | TypeLiteralNode;
+ export type DeclarationWithTypeParameters = DeclarationWithTypeParameterChildren | JSDocTypedefTag | JSDocCallbackTag | JSDocSignature;
+ export type DeclarationWithTypeParameterChildren = SignatureDeclaration | ClassLikeDeclaration | InterfaceDeclaration | TypeAliasDeclaration | JSDocTemplateTag;
+ export interface ClassLikeDeclarationBase extends NamedDeclaration, JSDocContainer {
+ kind: SyntaxKind.ClassDeclaration | SyntaxKind.ClassExpression;
+ name?: Identifier;
+ typeParameters?: NodeArray<TypeParameterDeclaration>;
+ heritageClauses?: NodeArray<HeritageClause>;
+ members: NodeArray<ClassElement>;
+ }
+ export interface ClassDeclaration extends ClassLikeDeclarationBase, DeclarationStatement {
+ kind: SyntaxKind.ClassDeclaration;
+ /** May be undefined in `export default class { ... }`. */
+ name?: Identifier;
+ }
+ export interface ClassExpression extends ClassLikeDeclarationBase, PrimaryExpression {
+ kind: SyntaxKind.ClassExpression;
+ }
+ export type ClassLikeDeclaration = ClassDeclaration | ClassExpression;
+ export interface ClassElement extends NamedDeclaration {
+ _classElementBrand: any;
+ name?: PropertyName;
+ }
+ export interface TypeElement extends NamedDeclaration {
+ _typeElementBrand: any;
+ name?: PropertyName;
+ questionToken?: QuestionToken;
+ }
+ export interface InterfaceDeclaration extends DeclarationStatement, JSDocContainer {
+ kind: SyntaxKind.InterfaceDeclaration;
+ name: Identifier;
+ typeParameters?: NodeArray<TypeParameterDeclaration>;
+ heritageClauses?: NodeArray<HeritageClause>;
+ members: NodeArray<TypeElement>;
+ }
+ export interface HeritageClause extends Node {
+ kind: SyntaxKind.HeritageClause;
+ parent: InterfaceDeclaration | ClassLikeDeclaration;
+ token: SyntaxKind.ExtendsKeyword | SyntaxKind.ImplementsKeyword;
+ types: NodeArray<ExpressionWithTypeArguments>;
+ }
+ export interface TypeAliasDeclaration extends DeclarationStatement, JSDocContainer {
+ kind: SyntaxKind.TypeAliasDeclaration;
+ name: Identifier;
+ typeParameters?: NodeArray<TypeParameterDeclaration>;
+ type: TypeNode;
+ }
+ export interface EnumMember extends NamedDeclaration, JSDocContainer {
+ kind: SyntaxKind.EnumMember;
+ parent: EnumDeclaration;
+ name: PropertyName;
+ initializer?: Expression;
+ }
+ export interface EnumDeclaration extends DeclarationStatement, JSDocContainer {
+ kind: SyntaxKind.EnumDeclaration;
+ name: Identifier;
+ members: NodeArray<EnumMember>;
+ }
+ export type ModuleName = Identifier | StringLiteral;
+ export type ModuleBody = NamespaceBody | JSDocNamespaceBody;
+ export interface ModuleDeclaration extends DeclarationStatement, JSDocContainer {
+ kind: SyntaxKind.ModuleDeclaration;
+ parent: ModuleBody | SourceFile;
+ name: ModuleName;
+ body?: ModuleBody | JSDocNamespaceDeclaration;
+ }
+ export type NamespaceBody = ModuleBlock | NamespaceDeclaration;
+ export interface NamespaceDeclaration extends ModuleDeclaration {
+ name: Identifier;
+ body: NamespaceBody;
+ }
+ export type JSDocNamespaceBody = Identifier | JSDocNamespaceDeclaration;
+ export interface JSDocNamespaceDeclaration extends ModuleDeclaration {
+ name: Identifier;
+ body?: JSDocNamespaceBody;
+ }
+ export interface ModuleBlock extends Node, Statement {
+ kind: SyntaxKind.ModuleBlock;
+ parent: ModuleDeclaration;
+ statements: NodeArray<Statement>;
+ }
+ export type ModuleReference = EntityName | ExternalModuleReference;
+ /**
+ * One of:
+ * - import x = require("mod");
+ * - import x = M.x;
+ */
+ export interface ImportEqualsDeclaration extends DeclarationStatement, JSDocContainer {
+ kind: SyntaxKind.ImportEqualsDeclaration;
+ parent: SourceFile | ModuleBlock;
+ name: Identifier;
+ moduleReference: ModuleReference;
+ }
+ export interface ExternalModuleReference extends Node {
+ kind: SyntaxKind.ExternalModuleReference;
+ parent: ImportEqualsDeclaration;
+ expression: Expression;
+ }
+ export interface ImportDeclaration extends Statement {
+ kind: SyntaxKind.ImportDeclaration;
+ parent: SourceFile | ModuleBlock;
+ importClause?: ImportClause;
+ /** If this is not a StringLiteral it will be a grammar error. */
+ moduleSpecifier: Expression;
+ }
+ export type NamedImportBindings = NamespaceImport | NamedImports;
+ export type NamedExportBindings = NamespaceExport | NamedExports;
+ export interface ImportClause extends NamedDeclaration {
+ kind: SyntaxKind.ImportClause;
+ parent: ImportDeclaration;
+ isTypeOnly: boolean;
+ name?: Identifier;
+ namedBindings?: NamedImportBindings;
+ }
+ export interface NamespaceImport extends NamedDeclaration {
+ kind: SyntaxKind.NamespaceImport;
+ parent: ImportClause;
+ name: Identifier;
+ }
+ export interface NamespaceExport extends NamedDeclaration {
+ kind: SyntaxKind.NamespaceExport;
+ parent: ExportDeclaration;
+ name: Identifier;
+ }
+ export interface NamespaceExportDeclaration extends DeclarationStatement {
+ kind: SyntaxKind.NamespaceExportDeclaration;
+ name: Identifier;
+ }
+ export interface ExportDeclaration extends DeclarationStatement, JSDocContainer {
+ kind: SyntaxKind.ExportDeclaration;
+ parent: SourceFile | ModuleBlock;
+ isTypeOnly: boolean;
+ /** Will not be assigned in the case of `export * from "foo";` */
+ exportClause?: NamedExportBindings;
+ /** If this is not a StringLiteral it will be a grammar error. */
+ moduleSpecifier?: Expression;
+ }
+ export interface NamedImports extends Node {
+ kind: SyntaxKind.NamedImports;
+ parent: ImportClause;
+ elements: NodeArray<ImportSpecifier>;
+ }
+ export interface NamedExports extends Node {
+ kind: SyntaxKind.NamedExports;
+ parent: ExportDeclaration;
+ elements: NodeArray<ExportSpecifier>;
+ }
+ export type NamedImportsOrExports = NamedImports | NamedExports;
+ export interface ImportSpecifier extends NamedDeclaration {
+ kind: SyntaxKind.ImportSpecifier;
+ parent: NamedImports;
+ propertyName?: Identifier;
+ name: Identifier;
+ }
+ export interface ExportSpecifier extends NamedDeclaration {
+ kind: SyntaxKind.ExportSpecifier;
+ parent: NamedExports;
+ propertyName?: Identifier;
+ name: Identifier;
+ }
+ export type ImportOrExportSpecifier = ImportSpecifier | ExportSpecifier;
+ export type TypeOnlyCompatibleAliasDeclaration = ImportClause | NamespaceImport | ImportOrExportSpecifier;
+ /**
+ * This is either an `export =` or an `export default` declaration.
+ * Unless `isExportEquals` is set, this node was parsed as an `export default`.
+ */
+ export interface ExportAssignment extends DeclarationStatement {
+ kind: SyntaxKind.ExportAssignment;
+ parent: SourceFile;
+ isExportEquals?: boolean;
+ expression: Expression;
+ }
+ export interface FileReference extends TextRange {
+ fileName: string;
+ }
+ export interface CheckJsDirective extends TextRange {
+ enabled: boolean;
+ }
+ export type CommentKind = SyntaxKind.SingleLineCommentTrivia | SyntaxKind.MultiLineCommentTrivia;
+ export interface CommentRange extends TextRange {
+ hasTrailingNewLine?: boolean;
+ kind: CommentKind;
+ }
+ export interface SynthesizedComment extends CommentRange {
+ text: string;
+ pos: -1;
+ end: -1;
+ }
+ export interface JSDocTypeExpression extends TypeNode {
+ kind: SyntaxKind.JSDocTypeExpression;
+ type: TypeNode;
+ }
+ export interface JSDocType extends TypeNode {
+ _jsDocTypeBrand: any;
+ }
+ export interface JSDocAllType extends JSDocType {
+ kind: SyntaxKind.JSDocAllType;
+ }
+ export interface JSDocUnknownType extends JSDocType {
+ kind: SyntaxKind.JSDocUnknownType;
+ }
+ export interface JSDocNonNullableType extends JSDocType {
+ kind: SyntaxKind.JSDocNonNullableType;
+ type: TypeNode;
+ }
+ export interface JSDocNullableType extends JSDocType {
+ kind: SyntaxKind.JSDocNullableType;
+ type: TypeNode;
+ }
+ export interface JSDocOptionalType extends JSDocType {
+ kind: SyntaxKind.JSDocOptionalType;
+ type: TypeNode;
+ }
+ export interface JSDocFunctionType extends JSDocType, SignatureDeclarationBase {
+ kind: SyntaxKind.JSDocFunctionType;
+ }
+ export interface JSDocVariadicType extends JSDocType {
+ kind: SyntaxKind.JSDocVariadicType;
+ type: TypeNode;
+ }
+ export interface JSDocNamepathType extends JSDocType {
+ kind: SyntaxKind.JSDocNamepathType;
+ type: TypeNode;
+ }
+ export type JSDocTypeReferencingNode = JSDocVariadicType | JSDocOptionalType | JSDocNullableType | JSDocNonNullableType;
+ export interface JSDoc extends Node {
+ kind: SyntaxKind.JSDocComment;
+ parent: HasJSDoc;
+ tags?: NodeArray<JSDocTag>;
+ comment?: string;
+ }
+ export interface JSDocTag extends Node {
+ parent: JSDoc | JSDocTypeLiteral;
+ tagName: Identifier;
+ comment?: string;
+ }
+ export interface JSDocUnknownTag extends JSDocTag {
+ kind: SyntaxKind.JSDocTag;
+ }
+ /**
+ * Note that `@extends` is a synonym of `@augments`.
+ * Both tags are represented by this interface.
+ */
+ export interface JSDocAugmentsTag extends JSDocTag {
+ kind: SyntaxKind.JSDocAugmentsTag;
+ class: ExpressionWithTypeArguments & {
+ expression: Identifier | PropertyAccessEntityNameExpression;
+ };
+ }
+ export interface JSDocImplementsTag extends JSDocTag {
+ kind: SyntaxKind.JSDocImplementsTag;
+ class: ExpressionWithTypeArguments & {
+ expression: Identifier | PropertyAccessEntityNameExpression;
+ };
+ }
+ export interface JSDocAuthorTag extends JSDocTag {
+ kind: SyntaxKind.JSDocAuthorTag;
+ }
+ export interface JSDocClassTag extends JSDocTag {
+ kind: SyntaxKind.JSDocClassTag;
+ }
+ export interface JSDocPublicTag extends JSDocTag {
+ kind: SyntaxKind.JSDocPublicTag;
+ }
+ export interface JSDocPrivateTag extends JSDocTag {
+ kind: SyntaxKind.JSDocPrivateTag;
+ }
+ export interface JSDocProtectedTag extends JSDocTag {
+ kind: SyntaxKind.JSDocProtectedTag;
+ }
+ export interface JSDocReadonlyTag extends JSDocTag {
+ kind: SyntaxKind.JSDocReadonlyTag;
+ }
+ export interface JSDocEnumTag extends JSDocTag, Declaration {
+ parent: JSDoc;
+ kind: SyntaxKind.JSDocEnumTag;
+ typeExpression?: JSDocTypeExpression;
+ }
+ export interface JSDocThisTag extends JSDocTag {
+ kind: SyntaxKind.JSDocThisTag;
+ typeExpression?: JSDocTypeExpression;
+ }
+ export interface JSDocTemplateTag extends JSDocTag {
+ kind: SyntaxKind.JSDocTemplateTag;
+ constraint: JSDocTypeExpression | undefined;
+ typeParameters: NodeArray<TypeParameterDeclaration>;
+ }
+ export interface JSDocReturnTag extends JSDocTag {
+ kind: SyntaxKind.JSDocReturnTag;
+ typeExpression?: JSDocTypeExpression;
+ }
+ export interface JSDocTypeTag extends JSDocTag {
+ kind: SyntaxKind.JSDocTypeTag;
+ typeExpression: JSDocTypeExpression;
+ }
+ export interface JSDocTypedefTag extends JSDocTag, NamedDeclaration {
+ parent: JSDoc;
+ kind: SyntaxKind.JSDocTypedefTag;
+ fullName?: JSDocNamespaceDeclaration | Identifier;
+ name?: Identifier;
+ typeExpression?: JSDocTypeExpression | JSDocTypeLiteral;
+ }
+ export interface JSDocCallbackTag extends JSDocTag, NamedDeclaration {
+ parent: JSDoc;
+ kind: SyntaxKind.JSDocCallbackTag;
+ fullName?: JSDocNamespaceDeclaration | Identifier;
+ name?: Identifier;
+ typeExpression: JSDocSignature;
+ }
+ export interface JSDocSignature extends JSDocType, Declaration {
+ kind: SyntaxKind.JSDocSignature;
+ typeParameters?: readonly JSDocTemplateTag[];
+ parameters: readonly JSDocParameterTag[];
+ type: JSDocReturnTag | undefined;
+ }
+ export interface JSDocPropertyLikeTag extends JSDocTag, Declaration {
+ parent: JSDoc;
+ name: EntityName;
+ typeExpression?: JSDocTypeExpression;
+ /** Whether the property name came before the type -- non-standard for JSDoc, but Typescript-like */
+ isNameFirst: boolean;
+ isBracketed: boolean;
+ }
+ export interface JSDocPropertyTag extends JSDocPropertyLikeTag {
+ kind: SyntaxKind.JSDocPropertyTag;
+ }
+ export interface JSDocParameterTag extends JSDocPropertyLikeTag {
+ kind: SyntaxKind.JSDocParameterTag;
+ }
+ export interface JSDocTypeLiteral extends JSDocType {
+ kind: SyntaxKind.JSDocTypeLiteral;
+ jsDocPropertyTags?: readonly JSDocPropertyLikeTag[];
+ /** If true, then this type literal represents an *array* of its type. */
+ isArrayType?: boolean;
+ }
+ export enum FlowFlags {
+ Unreachable = 1,
+ Start = 2,
+ BranchLabel = 4,
+ LoopLabel = 8,
+ Assignment = 16,
+ TrueCondition = 32,
+ FalseCondition = 64,
+ SwitchClause = 128,
+ ArrayMutation = 256,
+ Call = 512,
+ ReduceLabel = 1024,
+ Referenced = 2048,
+ Shared = 4096,
+ Label = 12,
+ Condition = 96
+ }
+ export type FlowNode = AfterFinallyFlow | PreFinallyFlow | FlowStart | FlowLabel | FlowAssignment | FlowCall | FlowCondition | FlowSwitchClause | FlowArrayMutation;
+ export interface FlowNodeBase {
+ flags: FlowFlags;
+ id?: number;
+ }
+ export interface FlowLock {
+ locked?: boolean;
+ }
+ export interface AfterFinallyFlow extends FlowNodeBase, FlowLock {
+ antecedent: FlowNode;
+ }
+ export interface PreFinallyFlow extends FlowNodeBase {
+ antecedent: FlowNode;
+ lock: FlowLock;
+ }
+ export interface FlowStart extends FlowNodeBase {
+ node?: FunctionExpression | ArrowFunction | MethodDeclaration;
+ }
+ export interface FlowLabel extends FlowNodeBase {
+ antecedents: FlowNode[] | undefined;
+ }
+ export interface FlowAssignment extends FlowNodeBase {
+ node: Expression | VariableDeclaration | BindingElement;
+ antecedent: FlowNode;
+ }
+ export interface FlowCall extends FlowNodeBase {
+ node: CallExpression;
+ antecedent: FlowNode;
+ }
+ export interface FlowCondition extends FlowNodeBase {
+ node: Expression;
+ antecedent: FlowNode;
+ }
+ export interface FlowSwitchClause extends FlowNodeBase {
+ switchStatement: SwitchStatement;
+ clauseStart: number;
+ clauseEnd: number;
+ antecedent: FlowNode;
+ }
+ export interface FlowArrayMutation extends FlowNodeBase {
+ node: CallExpression | BinaryExpression;
+ antecedent: FlowNode;
+ }
+ export interface FlowReduceLabel extends FlowNodeBase {
+ target: FlowLabel;
+ antecedents: FlowNode[];
+ antecedent: FlowNode;
+ }
+ export type FlowType = Type | IncompleteType;
+ export interface IncompleteType {
+ flags: TypeFlags;
+ type: Type;
+ }
+ export interface AmdDependency {
+ path: string;
+ name?: string;
+ }
+ export interface SourceFile extends Declaration {
+ kind: SyntaxKind.SourceFile;
+ statements: NodeArray<Statement>;
+ endOfFileToken: Token<SyntaxKind.EndOfFileToken>;
+ fileName: string;
+ text: string;
+ amdDependencies: readonly AmdDependency[];
+ moduleName?: string;
+ referencedFiles: readonly FileReference[];
+ typeReferenceDirectives: readonly FileReference[];
+ libReferenceDirectives: readonly FileReference[];
+ languageVariant: LanguageVariant;
+ isDeclarationFile: boolean;
+ /**
+ * lib.d.ts should have a reference comment like
+ *
+ * /// <reference no-default-lib="true"/>
+ *
+ * If any other file has this comment, it signals not to include lib.d.ts
+ * because this containing file is intended to act as a default library.
+ */
+ hasNoDefaultLib: boolean;
+ languageVersion: ScriptTarget;
+ }
+ export interface Bundle extends Node {
+ kind: SyntaxKind.Bundle;
+ prepends: readonly (InputFiles | UnparsedSource)[];
+ sourceFiles: readonly SourceFile[];
+ }
+ export interface InputFiles extends Node {
+ kind: SyntaxKind.InputFiles;
+ javascriptPath?: string;
+ javascriptText: string;
+ javascriptMapPath?: string;
+ javascriptMapText?: string;
+ declarationPath?: string;
+ declarationText: string;
+ declarationMapPath?: string;
+ declarationMapText?: string;
+ }
+ export interface UnparsedSource extends Node {
+ kind: SyntaxKind.UnparsedSource;
+ fileName: string;
+ text: string;
+ prologues: readonly UnparsedPrologue[];
+ helpers: readonly UnscopedEmitHelper[] | undefined;
+ referencedFiles: readonly FileReference[];
+ typeReferenceDirectives: readonly string[] | undefined;
+ libReferenceDirectives: readonly FileReference[];
+ hasNoDefaultLib?: boolean;
+ sourceMapPath?: string;
+ sourceMapText?: string;
+ syntheticReferences?: readonly UnparsedSyntheticReference[];
+ texts: readonly UnparsedSourceText[];
+ }
+ export type UnparsedSourceText = UnparsedPrepend | UnparsedTextLike;
+ export type UnparsedNode = UnparsedPrologue | UnparsedSourceText | UnparsedSyntheticReference;
+ export interface UnparsedSection extends Node {
+ kind: SyntaxKind;
+ data?: string;
+ parent: UnparsedSource;
+ }
+ export interface UnparsedPrologue extends UnparsedSection {
+ kind: SyntaxKind.UnparsedPrologue;
+ data: string;
+ parent: UnparsedSource;
+ }
+ export interface UnparsedPrepend extends UnparsedSection {
+ kind: SyntaxKind.UnparsedPrepend;
+ data: string;
+ parent: UnparsedSource;
+ texts: readonly UnparsedTextLike[];
+ }
+ export interface UnparsedTextLike extends UnparsedSection {
+ kind: SyntaxKind.UnparsedText | SyntaxKind.UnparsedInternalText;
+ parent: UnparsedSource;
+ }
+ export interface UnparsedSyntheticReference extends UnparsedSection {
+ kind: SyntaxKind.UnparsedSyntheticReference;
+ parent: UnparsedSource;
+ }
+ export interface JsonSourceFile extends SourceFile {
+ statements: NodeArray<JsonObjectExpressionStatement>;
+ }
+ export interface TsConfigSourceFile extends JsonSourceFile {
+ extendedSourceFiles?: string[];
+ }
+ export interface JsonMinusNumericLiteral extends PrefixUnaryExpression {
+ kind: SyntaxKind.PrefixUnaryExpression;
+ operator: SyntaxKind.MinusToken;
+ operand: NumericLiteral;
+ }
+ export interface JsonObjectExpressionStatement extends ExpressionStatement {
+ expression: ObjectLiteralExpression | ArrayLiteralExpression | JsonMinusNumericLiteral | NumericLiteral | StringLiteral | BooleanLiteral | NullLiteral;
+ }
+ export interface ScriptReferenceHost {
+ getCompilerOptions(): CompilerOptions;
+ getSourceFile(fileName: string): SourceFile | undefined;
+ getSourceFileByPath(path: Path): SourceFile | undefined;
+ getCurrentDirectory(): string;
+ }
+ export interface ParseConfigHost {
+ useCaseSensitiveFileNames: boolean;
+ readDirectory(rootDir: string, extensions: readonly string[], excludes: readonly string[] | undefined, includes: readonly string[], depth?: number): readonly string[];
+ /**
+ * Gets a value indicating whether the specified path exists and is a file.
+ * @param path The path to test.
+ */
+ fileExists(path: string): boolean;
+ readFile(path: string): string | undefined;
+ trace?(s: string): void;
+ }
+ /**
+ * Branded string for keeping track of when we've turned an ambiguous path
+ * specified like "./blah" to an absolute path to an actual
+ * tsconfig file, e.g. "/root/blah/tsconfig.json"
+ */
+ export type ResolvedConfigFileName = string & {
+ _isResolvedConfigFileName: never;
+ };
+ export type WriteFileCallback = (fileName: string, data: string, writeByteOrderMark: boolean, onError?: (message: string) => void, sourceFiles?: readonly SourceFile[]) => void;
+ export class OperationCanceledException {
+ }
+ export interface CancellationToken {
+ isCancellationRequested(): boolean;
+ /** @throws OperationCanceledException if isCancellationRequested is true */
+ throwIfCancellationRequested(): void;
+ }
+ export interface Program extends ScriptReferenceHost {
+ getCurrentDirectory(): string;
+ /**
+ * Get a list of root file names that were passed to a 'createProgram'
+ */
+ getRootFileNames(): readonly string[];
+ /**
+ * Get a list of files in the program
+ */
+ getSourceFiles(): readonly SourceFile[];
+ /**
+ * Emits the JavaScript and declaration files. If targetSourceFile is not specified, then
+ * the JavaScript and declaration files will be produced for all the files in this program.
+ * If targetSourceFile is specified, then only the JavaScript and declaration for that
+ * specific file will be generated.
+ *
+ * If writeFile is not specified then the writeFile callback from the compiler host will be
+ * used for writing the JavaScript and declaration files. Otherwise, the writeFile parameter
+ * will be invoked when writing the JavaScript and declaration files.
+ */
+ emit(targetSourceFile?: SourceFile, writeFile?: WriteFileCallback, cancellationToken?: CancellationToken, emitOnlyDtsFiles?: boolean, customTransformers?: CustomTransformers): EmitResult;
+ getOptionsDiagnostics(cancellationToken?: CancellationToken): readonly Diagnostic[];
+ getGlobalDiagnostics(cancellationToken?: CancellationToken): readonly Diagnostic[];
+ getSyntacticDiagnostics(sourceFile?: SourceFile, cancellationToken?: CancellationToken): readonly DiagnosticWithLocation[];
+ /** The first time this is called, it will return global diagnostics (no location). */
+ getSemanticDiagnostics(sourceFile?: SourceFile, cancellationToken?: CancellationToken): readonly Diagnostic[];
+ getDeclarationDiagnostics(sourceFile?: SourceFile, cancellationToken?: CancellationToken): readonly DiagnosticWithLocation[];
+ getConfigFileParsingDiagnostics(): readonly Diagnostic[];
+ /**
+ * Gets a type checker that can be used to semantically analyze source files in the program.
+ */
+ getTypeChecker(): TypeChecker;
+ getNodeCount(): number;
+ getIdentifierCount(): number;
+ getSymbolCount(): number;
+ getTypeCount(): number;
+ getInstantiationCount(): number;
+ getRelationCacheSizes(): {
+ assignable: number;
+ identity: number;
+ subtype: number;
+ strictSubtype: number;
+ };
+ isSourceFileFromExternalLibrary(file: SourceFile): boolean;
+ isSourceFileDefaultLibrary(file: SourceFile): boolean;
+ getProjectReferences(): readonly ProjectReference[] | undefined;
+ getResolvedProjectReferences(): readonly (ResolvedProjectReference | undefined)[] | undefined;
+ }
+ export interface ResolvedProjectReference {
+ commandLine: ParsedCommandLine;
+ sourceFile: SourceFile;
+ references?: readonly (ResolvedProjectReference | undefined)[];
+ }
+ export type CustomTransformerFactory = (context: TransformationContext) => CustomTransformer;
+ export interface CustomTransformer {
+ transformSourceFile(node: SourceFile): SourceFile;
+ transformBundle(node: Bundle): Bundle;
+ }
+ export interface CustomTransformers {
+ /** Custom transformers to evaluate before built-in .js transformations. */
+ before?: (TransformerFactory<SourceFile> | CustomTransformerFactory)[];
+ /** Custom transformers to evaluate after built-in .js transformations. */
+ after?: (TransformerFactory<SourceFile> | CustomTransformerFactory)[];
+ /** Custom transformers to evaluate after built-in .d.ts transformations. */
+ afterDeclarations?: (TransformerFactory<Bundle | SourceFile> | CustomTransformerFactory)[];
+ }
+ export interface SourceMapSpan {
+ /** Line number in the .js file. */
+ emittedLine: number;
+ /** Column number in the .js file. */
+ emittedColumn: number;
+ /** Line number in the .ts file. */
+ sourceLine: number;
+ /** Column number in the .ts file. */
+ sourceColumn: number;
+ /** Optional name (index into names array) associated with this span. */
+ nameIndex?: number;
+ /** .ts file (index into sources array) associated with this span */
+ sourceIndex: number;
+ }
+ /** Return code used by getEmitOutput function to indicate status of the function */
+ export enum ExitStatus {
+ Success = 0,
+ DiagnosticsPresent_OutputsSkipped = 1,
+ DiagnosticsPresent_OutputsGenerated = 2,
+ InvalidProject_OutputsSkipped = 3,
+ ProjectReferenceCycle_OutputsSkipped = 4,
+ /** @deprecated Use ProjectReferenceCycle_OutputsSkipped instead. */
+ ProjectReferenceCycle_OutputsSkupped = 4
+ }
+ export interface EmitResult {
+ emitSkipped: boolean;
+ /** Contains declaration emit diagnostics */
+ diagnostics: readonly Diagnostic[];
+ emittedFiles?: string[];
+ }
+ export interface TypeChecker {
+ getTypeOfSymbolAtLocation(symbol: Symbol, node: Node): Type;
+ getDeclaredTypeOfSymbol(symbol: Symbol): Type;
+ getPropertiesOfType(type: Type): Symbol[];
+ getPropertyOfType(type: Type, propertyName: string): Symbol | undefined;
+ getPrivateIdentifierPropertyOfType(leftType: Type, name: string, location: Node): Symbol | undefined;
+ getIndexInfoOfType(type: Type, kind: IndexKind): IndexInfo | undefined;
+ getSignaturesOfType(type: Type, kind: SignatureKind): readonly Signature[];
+ getIndexTypeOfType(type: Type, kind: IndexKind): Type | undefined;
+ getBaseTypes(type: InterfaceType): BaseType[];
+ getBaseTypeOfLiteralType(type: Type): Type;
+ getWidenedType(type: Type): Type;
+ getReturnTypeOfSignature(signature: Signature): Type;
+ getNullableType(type: Type, flags: TypeFlags): Type;
+ getNonNullableType(type: Type): Type;
+ getTypeArguments(type: TypeReference): readonly Type[];
+ /** Note that the resulting nodes cannot be checked. */
+ typeToTypeNode(type: Type, enclosingDeclaration?: Node, flags?: NodeBuilderFlags): TypeNode | undefined;
+ /** Note that the resulting nodes cannot be checked. */
+ signatureToSignatureDeclaration(signature: Signature, kind: SyntaxKind, enclosingDeclaration?: Node, flags?: NodeBuilderFlags): (SignatureDeclaration & {
+ typeArguments?: NodeArray<TypeNode>;
+ }) | undefined;
+ /** Note that the resulting nodes cannot be checked. */
+ indexInfoToIndexSignatureDeclaration(indexInfo: IndexInfo, kind: IndexKind, enclosingDeclaration?: Node, flags?: NodeBuilderFlags): IndexSignatureDeclaration | undefined;
+ /** Note that the resulting nodes cannot be checked. */
+ symbolToEntityName(symbol: Symbol, meaning: SymbolFlags, enclosingDeclaration?: Node, flags?: NodeBuilderFlags): EntityName | undefined;
+ /** Note that the resulting nodes cannot be checked. */
+ symbolToExpression(symbol: Symbol, meaning: SymbolFlags, enclosingDeclaration?: Node, flags?: NodeBuilderFlags): Expression | undefined;
+ /** Note that the resulting nodes cannot be checked. */
+ symbolToTypeParameterDeclarations(symbol: Symbol, enclosingDeclaration?: Node, flags?: NodeBuilderFlags): NodeArray<TypeParameterDeclaration> | undefined;
+ /** Note that the resulting nodes cannot be checked. */
+ symbolToParameterDeclaration(symbol: Symbol, enclosingDeclaration?: Node, flags?: NodeBuilderFlags): ParameterDeclaration | undefined;
+ /** Note that the resulting nodes cannot be checked. */
+ typeParameterToDeclaration(parameter: TypeParameter, enclosingDeclaration?: Node, flags?: NodeBuilderFlags): TypeParameterDeclaration | undefined;
+ getSymbolsInScope(location: Node, meaning: SymbolFlags): Symbol[];
+ getSymbolAtLocation(node: Node): Symbol | undefined;
+ getSymbolsOfParameterPropertyDeclaration(parameter: ParameterDeclaration, parameterName: string): Symbol[];
+ /**
+ * The function returns the value (local variable) symbol of an identifier in the short-hand property assignment.
+ * This is necessary as an identifier in short-hand property assignment can contains two meaning: property name and property value.
+ */
+ getShorthandAssignmentValueSymbol(location: Node): Symbol | undefined;
+ getExportSpecifierLocalTargetSymbol(location: ExportSpecifier): Symbol | undefined;
+ /**
+ * If a symbol is a local symbol with an associated exported symbol, returns the exported symbol.
+ * Otherwise returns its input.
+ * For example, at `export type T = number;`:
+ * - `getSymbolAtLocation` at the location `T` will return the exported symbol for `T`.
+ * - But the result of `getSymbolsInScope` will contain the *local* symbol for `T`, not the exported symbol.
+ * - Calling `getExportSymbolOfSymbol` on that local symbol will return the exported symbol.
+ */
+ getExportSymbolOfSymbol(symbol: Symbol): Symbol;
+ getPropertySymbolOfDestructuringAssignment(location: Identifier): Symbol | undefined;
+ getTypeOfAssignmentPattern(pattern: AssignmentPattern): Type;
+ getTypeAtLocation(node: Node): Type;
+ getTypeFromTypeNode(node: TypeNode): Type;
+ signatureToString(signature: Signature, enclosingDeclaration?: Node, flags?: TypeFormatFlags, kind?: SignatureKind): string;
+ typeToString(type: Type, enclosingDeclaration?: Node, flags?: TypeFormatFlags): string;
+ symbolToString(symbol: Symbol, enclosingDeclaration?: Node, meaning?: SymbolFlags, flags?: SymbolFormatFlags): string;
+ typePredicateToString(predicate: TypePredicate, enclosingDeclaration?: Node, flags?: TypeFormatFlags): string;
+ getFullyQualifiedName(symbol: Symbol): string;
+ getAugmentedPropertiesOfType(type: Type): Symbol[];
+ getRootSymbols(symbol: Symbol): readonly Symbol[];
+ getContextualType(node: Expression): Type | undefined;
+ /**
+ * returns unknownSignature in the case of an error.
+ * returns undefined if the node is not valid.
+ * @param argumentCount Apparent number of arguments, passed in case of a possibly incomplete call. This should come from an ArgumentListInfo. See `signatureHelp.ts`.
+ */
+ getResolvedSignature(node: CallLikeExpression, candidatesOutArray?: Signature[], argumentCount?: number): Signature | undefined;
+ getSignatureFromDeclaration(declaration: SignatureDeclaration): Signature | undefined;
+ isImplementationOfOverload(node: SignatureDeclaration): boolean | undefined;
+ isUndefinedSymbol(symbol: Symbol): boolean;
+ isArgumentsSymbol(symbol: Symbol): boolean;
+ isUnknownSymbol(symbol: Symbol): boolean;
+ getConstantValue(node: EnumMember | PropertyAccessExpression | ElementAccessExpression): string | number | undefined;
+ isValidPropertyAccess(node: PropertyAccessExpression | QualifiedName | ImportTypeNode, propertyName: string): boolean;
+ /** Follow all aliases to get the original symbol. */
+ getAliasedSymbol(symbol: Symbol): Symbol;
+ getExportsOfModule(moduleSymbol: Symbol): Symbol[];
+ getJsxIntrinsicTagNamesAt(location: Node): Symbol[];
+ isOptionalParameter(node: ParameterDeclaration): boolean;
+ getAmbientModules(): Symbol[];
+ tryGetMemberInModuleExports(memberName: string, moduleSymbol: Symbol): Symbol | undefined;
+ getApparentType(type: Type): Type;
+ getBaseConstraintOfType(type: Type): Type | undefined;
+ getDefaultFromTypeParameter(type: Type): Type | undefined;
+ /**
+ * Depending on the operation performed, it may be appropriate to throw away the checker
+ * if the cancellation token is triggered. Typically, if it is used for error checking
+ * and the operation is cancelled, then it should be discarded, otherwise it is safe to keep.
+ */
+ runWithCancellationToken<T>(token: CancellationToken, cb: (checker: TypeChecker) => T): T;
+ }
+ export enum NodeBuilderFlags {
+ None = 0,
+ NoTruncation = 1,
+ WriteArrayAsGenericType = 2,
+ GenerateNamesForShadowedTypeParams = 4,
+ UseStructuralFallback = 8,
+ ForbidIndexedAccessSymbolReferences = 16,
+ WriteTypeArgumentsOfSignature = 32,
+ UseFullyQualifiedType = 64,
+ UseOnlyExternalAliasing = 128,
+ SuppressAnyReturnType = 256,
+ WriteTypeParametersInQualifiedName = 512,
+ MultilineObjectLiterals = 1024,
+ WriteClassExpressionAsTypeLiteral = 2048,
+ UseTypeOfFunction = 4096,
+ OmitParameterModifiers = 8192,
+ UseAliasDefinedOutsideCurrentScope = 16384,
+ UseSingleQuotesForStringLiteralType = 268435456,
+ NoTypeReduction = 536870912,
+ AllowThisInObjectLiteral = 32768,
+ AllowQualifedNameInPlaceOfIdentifier = 65536,
+ AllowAnonymousIdentifier = 131072,
+ AllowEmptyUnionOrIntersection = 262144,
+ AllowEmptyTuple = 524288,
+ AllowUniqueESSymbolType = 1048576,
+ AllowEmptyIndexInfoType = 2097152,
+ AllowNodeModulesRelativePaths = 67108864,
+ IgnoreErrors = 70221824,
+ InObjectTypeLiteral = 4194304,
+ InTypeAlias = 8388608,
+ InInitialEntityName = 16777216,
+ InReverseMappedType = 33554432
+ }
+ export enum TypeFormatFlags {
+ None = 0,
+ NoTruncation = 1,
+ WriteArrayAsGenericType = 2,
+ UseStructuralFallback = 8,
+ WriteTypeArgumentsOfSignature = 32,
+ UseFullyQualifiedType = 64,
+ SuppressAnyReturnType = 256,
+ MultilineObjectLiterals = 1024,
+ WriteClassExpressionAsTypeLiteral = 2048,
+ UseTypeOfFunction = 4096,
+ OmitParameterModifiers = 8192,
+ UseAliasDefinedOutsideCurrentScope = 16384,
+ UseSingleQuotesForStringLiteralType = 268435456,
+ NoTypeReduction = 536870912,
+ AllowUniqueESSymbolType = 1048576,
+ AddUndefined = 131072,
+ WriteArrowStyleSignature = 262144,
+ InArrayType = 524288,
+ InElementType = 2097152,
+ InFirstTypeArgument = 4194304,
+ InTypeAlias = 8388608,
+ /** @deprecated */ WriteOwnNameForAnyLike = 0,
+ NodeBuilderFlagsMask = 814775659
+ }
+ export enum SymbolFormatFlags {
+ None = 0,
+ WriteTypeParametersOrArguments = 1,
+ UseOnlyExternalAliasing = 2,
+ AllowAnyNodeKind = 4,
+ UseAliasDefinedOutsideCurrentScope = 8,
+ }
+ export enum TypePredicateKind {
+ This = 0,
+ Identifier = 1,
+ AssertsThis = 2,
+ AssertsIdentifier = 3
+ }
+ export interface TypePredicateBase {
+ kind: TypePredicateKind;
+ type: Type | undefined;
+ }
+ export interface ThisTypePredicate extends TypePredicateBase {
+ kind: TypePredicateKind.This;
+ parameterName: undefined;
+ parameterIndex: undefined;
+ type: Type;
+ }
+ export interface IdentifierTypePredicate extends TypePredicateBase {
+ kind: TypePredicateKind.Identifier;
+ parameterName: string;
+ parameterIndex: number;
+ type: Type;
+ }
+ export interface AssertsThisTypePredicate extends TypePredicateBase {
+ kind: TypePredicateKind.AssertsThis;
+ parameterName: undefined;
+ parameterIndex: undefined;
+ type: Type | undefined;
+ }
+ export interface AssertsIdentifierTypePredicate extends TypePredicateBase {
+ kind: TypePredicateKind.AssertsIdentifier;
+ parameterName: string;
+ parameterIndex: number;
+ type: Type | undefined;
+ }
+ export type TypePredicate = ThisTypePredicate | IdentifierTypePredicate | AssertsThisTypePredicate | AssertsIdentifierTypePredicate;
+ export enum SymbolFlags {
+ None = 0,
+ FunctionScopedVariable = 1,
+ BlockScopedVariable = 2,
+ Property = 4,
+ EnumMember = 8,
+ Function = 16,
+ Class = 32,
+ Interface = 64,
+ ConstEnum = 128,
+ RegularEnum = 256,
+ ValueModule = 512,
+ NamespaceModule = 1024,
+ TypeLiteral = 2048,
+ ObjectLiteral = 4096,
+ Method = 8192,
+ Constructor = 16384,
+ GetAccessor = 32768,
+ SetAccessor = 65536,
+ Signature = 131072,
+ TypeParameter = 262144,
+ TypeAlias = 524288,
+ ExportValue = 1048576,
+ Alias = 2097152,
+ Prototype = 4194304,
+ ExportStar = 8388608,
+ Optional = 16777216,
+ Transient = 33554432,
+ Assignment = 67108864,
+ ModuleExports = 134217728,
+ Enum = 384,
+ Variable = 3,
+ Value = 111551,
+ Type = 788968,
+ Namespace = 1920,
+ Module = 1536,
+ Accessor = 98304,
+ FunctionScopedVariableExcludes = 111550,
+ BlockScopedVariableExcludes = 111551,
+ ParameterExcludes = 111551,
+ PropertyExcludes = 0,
+ EnumMemberExcludes = 900095,
+ FunctionExcludes = 110991,
+ ClassExcludes = 899503,
+ InterfaceExcludes = 788872,
+ RegularEnumExcludes = 899327,
+ ConstEnumExcludes = 899967,
+ ValueModuleExcludes = 110735,
+ NamespaceModuleExcludes = 0,
+ MethodExcludes = 103359,
+ GetAccessorExcludes = 46015,
+ SetAccessorExcludes = 78783,
+ TypeParameterExcludes = 526824,
+ TypeAliasExcludes = 788968,
+ AliasExcludes = 2097152,
+ ModuleMember = 2623475,
+ ExportHasLocal = 944,
+ BlockScoped = 418,
+ PropertyOrAccessor = 98308,
+ ClassMember = 106500,
+ }
+ export interface Symbol {
+ flags: SymbolFlags;
+ escapedName: __String;
+ declarations: Declaration[];
+ valueDeclaration: Declaration;
+ members?: SymbolTable;
+ exports?: SymbolTable;
+ globalExports?: SymbolTable;
+ }
+ export enum InternalSymbolName {
+ Call = "__call",
+ Constructor = "__constructor",
+ New = "__new",
+ Index = "__index",
+ ExportStar = "__export",
+ Global = "__global",
+ Missing = "__missing",
+ Type = "__type",
+ Object = "__object",
+ JSXAttributes = "__jsxAttributes",
+ Class = "__class",
+ Function = "__function",
+ Computed = "__computed",
+ Resolving = "__resolving__",
+ ExportEquals = "export=",
+ Default = "default",
+ This = "this"
+ }
+ /**
+ * This represents a string whose leading underscore have been escaped by adding extra leading underscores.
+ * The shape of this brand is rather unique compared to others we've used.
+ * Instead of just an intersection of a string and an object, it is that union-ed
+ * with an intersection of void and an object. This makes it wholly incompatible
+ * with a normal string (which is good, it cannot be misused on assignment or on usage),
+ * while still being comparable with a normal string via === (also good) and castable from a string.
+ */
+ export type __String = (string & {
+ __escapedIdentifier: void;
+ }) | (void & {
+ __escapedIdentifier: void;
+ }) | InternalSymbolName;
+ /** ReadonlyMap where keys are `__String`s. */
+ export interface ReadonlyUnderscoreEscapedMap<T> {
+ get(key: __String): T | undefined;
+ has(key: __String): boolean;
+ forEach(action: (value: T, key: __String) => void): void;
+ readonly size: number;
+ keys(): Iterator<__String>;
+ values(): Iterator<T>;
+ entries(): Iterator<[__String, T]>;
+ }
+ /** Map where keys are `__String`s. */
+ export interface UnderscoreEscapedMap<T> extends ReadonlyUnderscoreEscapedMap<T> {
+ set(key: __String, value: T): this;
+ delete(key: __String): boolean;
+ clear(): void;
+ }
+ /** SymbolTable based on ES6 Map interface. */
+ export type SymbolTable = UnderscoreEscapedMap<Symbol>;
+ export enum TypeFlags {
+ Any = 1,
+ Unknown = 2,
+ String = 4,
+ Number = 8,
+ Boolean = 16,
+ Enum = 32,
+ BigInt = 64,
+ StringLiteral = 128,
+ NumberLiteral = 256,
+ BooleanLiteral = 512,
+ EnumLiteral = 1024,
+ BigIntLiteral = 2048,
+ ESSymbol = 4096,
+ UniqueESSymbol = 8192,
+ Void = 16384,
+ Undefined = 32768,
+ Null = 65536,
+ Never = 131072,
+ TypeParameter = 262144,
+ Object = 524288,
+ Union = 1048576,
+ Intersection = 2097152,
+ Index = 4194304,
+ IndexedAccess = 8388608,
+ Conditional = 16777216,
+ Substitution = 33554432,
+ NonPrimitive = 67108864,
+ Literal = 2944,
+ Unit = 109440,
+ StringOrNumberLiteral = 384,
+ PossiblyFalsy = 117724,
+ StringLike = 132,
+ NumberLike = 296,
+ BigIntLike = 2112,
+ BooleanLike = 528,
+ EnumLike = 1056,
+ ESSymbolLike = 12288,
+ VoidLike = 49152,
+ UnionOrIntersection = 3145728,
+ StructuredType = 3670016,
+ TypeVariable = 8650752,
+ InstantiableNonPrimitive = 58982400,
+ InstantiablePrimitive = 4194304,
+ Instantiable = 63176704,
+ StructuredOrInstantiable = 66846720,
+ Narrowable = 133970943,
+ NotUnionOrUnit = 67637251,
+ }
+ export type DestructuringPattern = BindingPattern | ObjectLiteralExpression | ArrayLiteralExpression;
+ export interface Type {
+ flags: TypeFlags;
+ symbol: Symbol;
+ pattern?: DestructuringPattern;
+ aliasSymbol?: Symbol;
+ aliasTypeArguments?: readonly Type[];
+ }
+ export interface LiteralType extends Type {
+ value: string | number | PseudoBigInt;
+ freshType: LiteralType;
+ regularType: LiteralType;
+ }
+ export interface UniqueESSymbolType extends Type {
+ symbol: Symbol;
+ escapedName: __String;
+ }
+ export interface StringLiteralType extends LiteralType {
+ value: string;
+ }
+ export interface NumberLiteralType extends LiteralType {
+ value: number;
+ }
+ export interface BigIntLiteralType extends LiteralType {
+ value: PseudoBigInt;
+ }
+ export interface EnumType extends Type {
+ }
+ export enum ObjectFlags {
+ Class = 1,
+ Interface = 2,
+ Reference = 4,
+ Tuple = 8,
+ Anonymous = 16,
+ Mapped = 32,
+ Instantiated = 64,
+ ObjectLiteral = 128,
+ EvolvingArray = 256,
+ ObjectLiteralPatternWithComputedProperties = 512,
+ ContainsSpread = 1024,
+ ReverseMapped = 2048,
+ JsxAttributes = 4096,
+ MarkerType = 8192,
+ JSLiteral = 16384,
+ FreshLiteral = 32768,
+ ArrayLiteral = 65536,
+ ObjectRestType = 131072,
+ ClassOrInterface = 3,
+ }
+ export interface ObjectType extends Type {
+ objectFlags: ObjectFlags;
+ }
+ /** Class and interface types (ObjectFlags.Class and ObjectFlags.Interface). */
+ export interface InterfaceType extends ObjectType {
+ typeParameters: TypeParameter[] | undefined;
+ outerTypeParameters: TypeParameter[] | undefined;
+ localTypeParameters: TypeParameter[] | undefined;
+ thisType: TypeParameter | undefined;
+ }
+ export type BaseType = ObjectType | IntersectionType | TypeVariable;
+ export interface InterfaceTypeWithDeclaredMembers extends InterfaceType {
+ declaredProperties: Symbol[];
+ declaredCallSignatures: Signature[];
+ declaredConstructSignatures: Signature[];
+ declaredStringIndexInfo?: IndexInfo;
+ declaredNumberIndexInfo?: IndexInfo;
+ }
+ /**
+ * Type references (ObjectFlags.Reference). When a class or interface has type parameters or
+ * a "this" type, references to the class or interface are made using type references. The
+ * typeArguments property specifies the types to substitute for the type parameters of the
+ * class or interface and optionally includes an extra element that specifies the type to
+ * substitute for "this" in the resulting instantiation. When no extra argument is present,
+ * the type reference itself is substituted for "this". The typeArguments property is undefined
+ * if the class or interface has no type parameters and the reference isn't specifying an
+ * explicit "this" argument.
+ */
+ export interface TypeReference extends ObjectType {
+ target: GenericType;
+ node?: TypeReferenceNode | ArrayTypeNode | TupleTypeNode;
+ }
+ export interface DeferredTypeReference extends TypeReference {
+ }
+ export interface GenericType extends InterfaceType, TypeReference {
+ }
+ export interface TupleType extends GenericType {
+ minLength: number;
+ hasRestElement: boolean;
+ readonly: boolean;
+ associatedNames?: __String[];
+ }
+ export interface TupleTypeReference extends TypeReference {
+ target: TupleType;
+ }
+ export interface UnionOrIntersectionType extends Type {
+ types: Type[];
+ }
+ export interface UnionType extends UnionOrIntersectionType {
+ }
+ export interface IntersectionType extends UnionOrIntersectionType {
+ }
+ export type StructuredType = ObjectType | UnionType | IntersectionType;
+ export interface EvolvingArrayType extends ObjectType {
+ elementType: Type;
+ finalArrayType?: Type;
+ }
+ export interface InstantiableType extends Type {
+ }
+ export interface TypeParameter extends InstantiableType {
+ }
+ export interface IndexedAccessType extends InstantiableType {
+ objectType: Type;
+ indexType: Type;
+ constraint?: Type;
+ simplifiedForReading?: Type;
+ simplifiedForWriting?: Type;
+ }
+ export type TypeVariable = TypeParameter | IndexedAccessType;
+ export interface IndexType extends InstantiableType {
+ type: InstantiableType | UnionOrIntersectionType;
+ }
+ export interface ConditionalRoot {
+ node: ConditionalTypeNode;
+ checkType: Type;
+ extendsType: Type;
+ trueType: Type;
+ falseType: Type;
+ isDistributive: boolean;
+ inferTypeParameters?: TypeParameter[];
+ outerTypeParameters?: TypeParameter[];
+ instantiations?: Map<Type>;
+ aliasSymbol?: Symbol;
+ aliasTypeArguments?: Type[];
+ }
+ export interface ConditionalType extends InstantiableType {
+ root: ConditionalRoot;
+ checkType: Type;
+ extendsType: Type;
+ resolvedTrueType: Type;
+ resolvedFalseType: Type;
+ }
+ export interface SubstitutionType extends InstantiableType {
+ baseType: Type;
+ substitute: Type;
+ }
+ export enum SignatureKind {
+ Call = 0,
+ Construct = 1
+ }
+ export interface Signature {
+ declaration?: SignatureDeclaration | JSDocSignature;
+ typeParameters?: readonly TypeParameter[];
+ parameters: readonly Symbol[];
+ }
+ export enum IndexKind {
+ String = 0,
+ Number = 1
+ }
+ export interface IndexInfo {
+ type: Type;
+ isReadonly: boolean;
+ declaration?: IndexSignatureDeclaration;
+ }
+ export enum InferencePriority {
+ NakedTypeVariable = 1,
+ HomomorphicMappedType = 2,
+ PartialHomomorphicMappedType = 4,
+ MappedTypeConstraint = 8,
+ ContravariantConditional = 16,
+ ReturnType = 32,
+ LiteralKeyof = 64,
+ NoConstraints = 128,
+ AlwaysStrict = 256,
+ MaxValue = 512,
+ PriorityImpliesCombination = 104,
+ Circularity = -1
+ }
+ /** @deprecated Use FileExtensionInfo instead. */
+ export type JsFileExtensionInfo = FileExtensionInfo;
+ export interface FileExtensionInfo {
+ extension: string;
+ isMixedContent: boolean;
+ scriptKind?: ScriptKind;
+ }
+ export interface DiagnosticMessage {
+ key: string;
+ category: DiagnosticCategory;
+ code: number;
+ message: string;
+ reportsUnnecessary?: {};
+ }
+ /**
+ * A linked list of formatted diagnostic messages to be used as part of a multiline message.
+ * It is built from the bottom up, leaving the head to be the "main" diagnostic.
+ * While it seems that DiagnosticMessageChain is structurally similar to DiagnosticMessage,
+ * the difference is that messages are all preformatted in DMC.
+ */
+ export interface DiagnosticMessageChain {
+ messageText: string;
+ category: DiagnosticCategory;
+ code: number;
+ next?: DiagnosticMessageChain[];
+ }
+ export interface Diagnostic extends DiagnosticRelatedInformation {
+ /** May store more in future. For now, this will simply be `true` to indicate when a diagnostic is an unused-identifier diagnostic. */
+ reportsUnnecessary?: {};
+ source?: string;
+ relatedInformation?: DiagnosticRelatedInformation[];
+ }
+ export interface DiagnosticRelatedInformation {
+ category: DiagnosticCategory;
+ code: number;
+ file: SourceFile | undefined;
+ start: number | undefined;
+ length: number | undefined;
+ messageText: string | DiagnosticMessageChain;
+ }
+ export interface DiagnosticWithLocation extends Diagnostic {
+ file: SourceFile;
+ start: number;
+ length: number;
+ }
+ export enum DiagnosticCategory {
+ Warning = 0,
+ Error = 1,
+ Suggestion = 2,
+ Message = 3
+ }
+ export enum ModuleResolutionKind {
+ Classic = 1,
+ NodeJs = 2
+ }
+ export interface PluginImport {
+ name: string;
+ }
+ export interface ProjectReference {
+ /** A normalized path on disk */
+ path: string;
+ /** The path as the user originally wrote it */
+ originalPath?: string;
+ /** True if the output of this reference should be prepended to the output of this project. Only valid for --outFile compilations */
+ prepend?: boolean;
+ /** True if it is intended that this reference form a circularity */
+ circular?: boolean;
+ }
+ export enum WatchFileKind {
+ FixedPollingInterval = 0,
+ PriorityPollingInterval = 1,
+ DynamicPriorityPolling = 2,
+ UseFsEvents = 3,
+ UseFsEventsOnParentDirectory = 4
+ }
+ export enum WatchDirectoryKind {
+ UseFsEvents = 0,
+ FixedPollingInterval = 1,
+ DynamicPriorityPolling = 2
+ }
+ export enum PollingWatchKind {
+ FixedInterval = 0,
+ PriorityInterval = 1,
+ DynamicPriority = 2
+ }
+ export type CompilerOptionsValue = string | number | boolean | (string | number)[] | string[] | MapLike<string[]> | PluginImport[] | ProjectReference[] | null | undefined;
+ export interface CompilerOptions {
+ allowJs?: boolean;
+ allowSyntheticDefaultImports?: boolean;
+ allowUmdGlobalAccess?: boolean;
+ allowUnreachableCode?: boolean;
+ allowUnusedLabels?: boolean;
+ alwaysStrict?: boolean;
+ baseUrl?: string;
+ charset?: string;
+ checkJs?: boolean;
+ declaration?: boolean;
+ declarationMap?: boolean;
+ emitDeclarationOnly?: boolean;
+ declarationDir?: string;
+ disableSizeLimit?: boolean;
+ disableSourceOfProjectReferenceRedirect?: boolean;
+ disableSolutionSearching?: boolean;
+ downlevelIteration?: boolean;
+ emitBOM?: boolean;
+ emitDecoratorMetadata?: boolean;
+ experimentalDecorators?: boolean;
+ forceConsistentCasingInFileNames?: boolean;
+ importHelpers?: boolean;
+ importsNotUsedAsValues?: ImportsNotUsedAsValues;
+ inlineSourceMap?: boolean;
+ inlineSources?: boolean;
+ isolatedModules?: boolean;
+ jsx?: JsxEmit;
+ keyofStringsOnly?: boolean;
+ lib?: string[];
+ locale?: string;
+ mapRoot?: string;
+ maxNodeModuleJsDepth?: number;
+ module?: ModuleKind;
+ moduleResolution?: ModuleResolutionKind;
+ newLine?: NewLineKind;
+ noEmit?: boolean;
+ noEmitHelpers?: boolean;
+ noEmitOnError?: boolean;
+ noErrorTruncation?: boolean;
+ noFallthroughCasesInSwitch?: boolean;
+ noImplicitAny?: boolean;
+ noImplicitReturns?: boolean;
+ noImplicitThis?: boolean;
+ noStrictGenericChecks?: boolean;
+ noUnusedLocals?: boolean;
+ noUnusedParameters?: boolean;
+ noImplicitUseStrict?: boolean;
+ assumeChangesOnlyAffectDirectDependencies?: boolean;
+ noLib?: boolean;
+ noResolve?: boolean;
+ out?: string;
+ outDir?: string;
+ outFile?: string;
+ paths?: MapLike<string[]>;
+ preserveConstEnums?: boolean;
+ preserveSymlinks?: boolean;
+ project?: string;
+ reactNamespace?: string;
+ jsxFactory?: string;
+ composite?: boolean;
+ incremental?: boolean;
+ tsBuildInfoFile?: string;
+ removeComments?: boolean;
+ rootDir?: string;
+ rootDirs?: string[];
+ skipLibCheck?: boolean;
+ skipDefaultLibCheck?: boolean;
+ sourceMap?: boolean;
+ sourceRoot?: string;
+ strict?: boolean;
+ strictFunctionTypes?: boolean;
+ strictBindCallApply?: boolean;
+ strictNullChecks?: boolean;
+ strictPropertyInitialization?: boolean;
+ stripInternal?: boolean;
+ suppressExcessPropertyErrors?: boolean;
+ suppressImplicitAnyIndexErrors?: boolean;
+ target?: ScriptTarget;
+ traceResolution?: boolean;
+ resolveJsonModule?: boolean;
+ types?: string[];
+ /** Paths used to compute primary types search locations */
+ typeRoots?: string[];
+ esModuleInterop?: boolean;
+ useDefineForClassFields?: boolean;
+ [option: string]: CompilerOptionsValue | TsConfigSourceFile | undefined;
+ }
+ export interface WatchOptions {
+ watchFile?: WatchFileKind;
+ watchDirectory?: WatchDirectoryKind;
+ fallbackPolling?: PollingWatchKind;
+ synchronousWatchDirectory?: boolean;
+ [option: string]: CompilerOptionsValue | undefined;
+ }
+ export interface TypeAcquisition {
+ /**
+ * @deprecated typingOptions.enableAutoDiscovery
+ * Use typeAcquisition.enable instead.
+ */
+ enableAutoDiscovery?: boolean;
+ enable?: boolean;
+ include?: string[];
+ exclude?: string[];
+ [option: string]: string[] | boolean | undefined;
+ }
+ export enum ModuleKind {
+ None = 0,
+ CommonJS = 1,
+ AMD = 2,
+ UMD = 3,
+ System = 4,
+ ES2015 = 5,
+ ES2020 = 6,
+ ESNext = 99
+ }
+ export enum JsxEmit {
+ None = 0,
+ Preserve = 1,
+ React = 2,
+ ReactNative = 3
+ }
+ export enum ImportsNotUsedAsValues {
+ Remove = 0,
+ Preserve = 1,
+ Error = 2
+ }
+ export enum NewLineKind {
+ CarriageReturnLineFeed = 0,
+ LineFeed = 1
+ }
+ export interface LineAndCharacter {
+ /** 0-based. */
+ line: number;
+ character: number;
+ }
+ export enum ScriptKind {
+ Unknown = 0,
+ JS = 1,
+ JSX = 2,
+ TS = 3,
+ TSX = 4,
+ External = 5,
+ JSON = 6,
+ /**
+ * Used on extensions that doesn't define the ScriptKind but the content defines it.
+ * Deferred extensions are going to be included in all project contexts.
+ */
+ Deferred = 7
+ }
+ export enum ScriptTarget {
+ ES3 = 0,
+ ES5 = 1,
+ ES2015 = 2,
+ ES2016 = 3,
+ ES2017 = 4,
+ ES2018 = 5,
+ ES2019 = 6,
+ ES2020 = 7,
+ ESNext = 99,
+ JSON = 100,
+ Latest = 99
+ }
+ export enum LanguageVariant {
+ Standard = 0,
+ JSX = 1
+ }
+ /** Either a parsed command line or a parsed tsconfig.json */
+ export interface ParsedCommandLine {
+ options: CompilerOptions;
+ typeAcquisition?: TypeAcquisition;
+ fileNames: string[];
+ projectReferences?: readonly ProjectReference[];
+ watchOptions?: WatchOptions;
+ raw?: any;
+ errors: Diagnostic[];
+ wildcardDirectories?: MapLike<WatchDirectoryFlags>;
+ compileOnSave?: boolean;
+ }
+ export enum WatchDirectoryFlags {
+ None = 0,
+ Recursive = 1
+ }
+ export interface ExpandResult {
+ fileNames: string[];
+ wildcardDirectories: MapLike<WatchDirectoryFlags>;
+ }
+ export interface CreateProgramOptions {
+ rootNames: readonly string[];
+ options: CompilerOptions;
+ projectReferences?: readonly ProjectReference[];
+ host?: CompilerHost;
+ oldProgram?: Program;
+ configFileParsingDiagnostics?: readonly Diagnostic[];
+ }
+ export interface ModuleResolutionHost {
+ fileExists(fileName: string): boolean;
+ readFile(fileName: string): string | undefined;
+ trace?(s: string): void;
+ directoryExists?(directoryName: string): boolean;
+ /**
+ * Resolve a symbolic link.
+ * @see https://nodejs.org/api/fs.html#fs_fs_realpathsync_path_options
+ */
+ realpath?(path: string): string;
+ getCurrentDirectory?(): string;
+ getDirectories?(path: string): string[];
+ }
+ /**
+ * Represents the result of module resolution.
+ * Module resolution will pick up tsx/jsx/js files even if '--jsx' and '--allowJs' are turned off.
+ * The Program will then filter results based on these flags.
+ *
+ * Prefer to return a `ResolvedModuleFull` so that the file type does not have to be inferred.
+ */
+ export interface ResolvedModule {
+ /** Path of the file the module was resolved to. */
+ resolvedFileName: string;
+ /** True if `resolvedFileName` comes from `node_modules`. */
+ isExternalLibraryImport?: boolean;
+ }
+ /**
+ * ResolvedModule with an explicitly provided `extension` property.
+ * Prefer this over `ResolvedModule`.
+ * If changing this, remember to change `moduleResolutionIsEqualTo`.
+ */
+ export interface ResolvedModuleFull extends ResolvedModule {
+ /**
+ * Extension of resolvedFileName. This must match what's at the end of resolvedFileName.
+ * This is optional for backwards-compatibility, but will be added if not provided.
+ */
+ extension: Extension;
+ packageId?: PackageId;
+ }
+ /**
+ * Unique identifier with a package name and version.
+ * If changing this, remember to change `packageIdIsEqual`.
+ */
+ export interface PackageId {
+ /**
+ * Name of the package.
+ * Should not include `@types`.
+ * If accessing a non-index file, this should include its name e.g. "foo/bar".
+ */
+ name: string;
+ /**
+ * Name of a submodule within this package.
+ * May be "".
+ */
+ subModuleName: string;
+ /** Version of the package, e.g. "1.2.3" */
+ version: string;
+ }
+ export enum Extension {
+ Ts = ".ts",
+ Tsx = ".tsx",
+ Dts = ".d.ts",
+ Js = ".js",
+ Jsx = ".jsx",
+ Json = ".json",
+ TsBuildInfo = ".tsbuildinfo"
+ }
+ export interface ResolvedModuleWithFailedLookupLocations {
+ readonly resolvedModule: ResolvedModuleFull | undefined;
+ }
+ export interface ResolvedTypeReferenceDirective {
+ primary: boolean;
+ resolvedFileName: string | undefined;
+ packageId?: PackageId;
+ /** True if `resolvedFileName` comes from `node_modules`. */
+ isExternalLibraryImport?: boolean;
+ }
+ export interface ResolvedTypeReferenceDirectiveWithFailedLookupLocations {
+ readonly resolvedTypeReferenceDirective: ResolvedTypeReferenceDirective | undefined;
+ readonly failedLookupLocations: string[];
+ }
+ export interface CompilerHost extends ModuleResolutionHost {
+ getSourceFile(fileName: string, languageVersion: ScriptTarget, onError?: (message: string) => void, shouldCreateNewSourceFile?: boolean): SourceFile | undefined;
+ getSourceFileByPath?(fileName: string, path: Path, languageVersion: ScriptTarget, onError?: (message: string) => void, shouldCreateNewSourceFile?: boolean): SourceFile | undefined;
+ getCancellationToken?(): CancellationToken;
+ getDefaultLibFileName(options: CompilerOptions): string;
+ getDefaultLibLocation?(): string;
+ writeFile: WriteFileCallback;
+ getCurrentDirectory(): string;
+ getCanonicalFileName(fileName: string): string;
+ useCaseSensitiveFileNames(): boolean;
+ getNewLine(): string;
+ readDirectory?(rootDir: string, extensions: readonly string[], excludes: readonly string[] | undefined, includes: readonly string[], depth?: number): string[];
+ resolveModuleNames?(moduleNames: string[], containingFile: string, reusedNames: string[] | undefined, redirectedReference: ResolvedProjectReference | undefined, options: CompilerOptions): (ResolvedModule | undefined)[];
+ /**
+ * This method is a companion for 'resolveModuleNames' and is used to resolve 'types' references to actual type declaration files
+ */
+ resolveTypeReferenceDirectives?(typeReferenceDirectiveNames: string[], containingFile: string, redirectedReference: ResolvedProjectReference | undefined, options: CompilerOptions): (ResolvedTypeReferenceDirective | undefined)[];
+ getEnvironmentVariable?(name: string): string | undefined;
+ createHash?(data: string): string;
+ getParsedCommandLine?(fileName: string): ParsedCommandLine | undefined;
+ }
+ export interface SourceMapRange extends TextRange {
+ source?: SourceMapSource;
+ }
+ export interface SourceMapSource {
+ fileName: string;
+ text: string;
+ skipTrivia?: (pos: number) => number;
+ }
+ export enum EmitFlags {
+ None = 0,
+ SingleLine = 1,
+ AdviseOnEmitNode = 2,
+ NoSubstitution = 4,
+ CapturesThis = 8,
+ NoLeadingSourceMap = 16,
+ NoTrailingSourceMap = 32,
+ NoSourceMap = 48,
+ NoNestedSourceMaps = 64,
+ NoTokenLeadingSourceMaps = 128,
+ NoTokenTrailingSourceMaps = 256,
+ NoTokenSourceMaps = 384,
+ NoLeadingComments = 512,
+ NoTrailingComments = 1024,
+ NoComments = 1536,
+ NoNestedComments = 2048,
+ HelperName = 4096,
+ ExportName = 8192,
+ LocalName = 16384,
+ InternalName = 32768,
+ Indented = 65536,
+ NoIndentation = 131072,
+ AsyncFunctionBody = 262144,
+ ReuseTempVariableScope = 524288,
+ CustomPrologue = 1048576,
+ NoHoisting = 2097152,
+ HasEndOfDeclarationMarker = 4194304,
+ Iterator = 8388608,
+ NoAsciiEscaping = 16777216,
+ }
+ export interface EmitHelper {
+ readonly name: string;
+ readonly scoped: boolean;
+ readonly text: string | ((node: EmitHelperUniqueNameCallback) => string);
+ readonly priority?: number;
+ readonly dependencies?: EmitHelper[];
+ }
+ export interface UnscopedEmitHelper extends EmitHelper {
+ readonly scoped: false;
+ readonly text: string;
+ }
+ export type EmitHelperUniqueNameCallback = (name: string) => string;
+ export enum EmitHint {
+ SourceFile = 0,
+ Expression = 1,
+ IdentifierName = 2,
+ MappedTypeParameter = 3,
+ Unspecified = 4,
+ EmbeddedStatement = 5,
+ JsxAttributeValue = 6
+ }
+ export interface TransformationContext {
+ /** Gets the compiler options supplied to the transformer. */
+ getCompilerOptions(): CompilerOptions;
+ /** Starts a new lexical environment. */
+ startLexicalEnvironment(): void;
+ /** Suspends the current lexical environment, usually after visiting a parameter list. */
+ suspendLexicalEnvironment(): void;
+ /** Resumes a suspended lexical environment, usually before visiting a function body. */
+ resumeLexicalEnvironment(): void;
+ /** Ends a lexical environment, returning any declarations. */
+ endLexicalEnvironment(): Statement[] | undefined;
+ /** Hoists a function declaration to the containing scope. */
+ hoistFunctionDeclaration(node: FunctionDeclaration): void;
+ /** Hoists a variable declaration to the containing scope. */
+ hoistVariableDeclaration(node: Identifier): void;
+ /** Records a request for a non-scoped emit helper in the current context. */
+ requestEmitHelper(helper: EmitHelper): void;
+ /** Gets and resets the requested non-scoped emit helpers. */
+ readEmitHelpers(): EmitHelper[] | undefined;
+ /** Enables expression substitutions in the pretty printer for the provided SyntaxKind. */
+ enableSubstitution(kind: SyntaxKind): void;
+ /** Determines whether expression substitutions are enabled for the provided node. */
+ isSubstitutionEnabled(node: Node): boolean;
+ /**
+ * Hook used by transformers to substitute expressions just before they
+ * are emitted by the pretty printer.
+ *
+ * NOTE: Transformation hooks should only be modified during `Transformer` initialization,
+ * before returning the `NodeTransformer` callback.
+ */
+ onSubstituteNode: (hint: EmitHint, node: Node) => Node;
+ /**
+ * Enables before/after emit notifications in the pretty printer for the provided
+ * SyntaxKind.
+ */
+ enableEmitNotification(kind: SyntaxKind): void;
+ /**
+ * Determines whether before/after emit notifications should be raised in the pretty
+ * printer when it emits a node.
+ */
+ isEmitNotificationEnabled(node: Node): boolean;
+ /**
+ * Hook used to allow transformers to capture state before or after
+ * the printer emits a node.
+ *
+ * NOTE: Transformation hooks should only be modified during `Transformer` initialization,
+ * before returning the `NodeTransformer` callback.
+ */
+ onEmitNode: (hint: EmitHint, node: Node, emitCallback: (hint: EmitHint, node: Node) => void) => void;
+ }
+ export interface TransformationResult<T extends Node> {
+ /** Gets the transformed source files. */
+ transformed: T[];
+ /** Gets diagnostics for the transformation. */
+ diagnostics?: DiagnosticWithLocation[];
+ /**
+ * Gets a substitute for a node, if one is available; otherwise, returns the original node.
+ *
+ * @param hint A hint as to the intended usage of the node.
+ * @param node The node to substitute.
+ */
+ substituteNode(hint: EmitHint, node: Node): Node;
+ /**
+ * Emits a node with possible notification.
+ *
+ * @param hint A hint as to the intended usage of the node.
+ * @param node The node to emit.
+ * @param emitCallback A callback used to emit the node.
+ */
+ emitNodeWithNotification(hint: EmitHint, node: Node, emitCallback: (hint: EmitHint, node: Node) => void): void;
+ /**
+ * Indicates if a given node needs an emit notification
+ *
+ * @param node The node to emit.
+ */
+ isEmitNotificationEnabled?(node: Node): boolean;
+ /**
+ * Clean up EmitNode entries on any parse-tree nodes.
+ */
+ dispose(): void;
+ }
+ /**
+ * A function that is used to initialize and return a `Transformer` callback, which in turn
+ * will be used to transform one or more nodes.
+ */
+ export type TransformerFactory<T extends Node> = (context: TransformationContext) => Transformer<T>;
+ /**
+ * A function that transforms a node.
+ */
+ export type Transformer<T extends Node> = (node: T) => T;
+ /**
+ * A function that accepts and possibly transforms a node.
+ */
+ export type Visitor = (node: Node) => VisitResult<Node>;
+ export type VisitResult<T extends Node> = T | T[] | undefined;
+ export interface Printer {
+ /**
+ * Print a node and its subtree as-is, without any emit transformations.
+ * @param hint A value indicating the purpose of a node. This is primarily used to
+ * distinguish between an `Identifier` used in an expression position, versus an
+ * `Identifier` used as an `IdentifierName` as part of a declaration. For most nodes you
+ * should just pass `Unspecified`.
+ * @param node The node to print. The node and its subtree are printed as-is, without any
+ * emit transformations.
+ * @param sourceFile A source file that provides context for the node. The source text of
+ * the file is used to emit the original source content for literals and identifiers, while
+ * the identifiers of the source file are used when generating unique names to avoid
+ * collisions.
+ */
+ printNode(hint: EmitHint, node: Node, sourceFile: SourceFile): string;
+ /**
+ * Prints a list of nodes using the given format flags
+ */
+ printList<T extends Node>(format: ListFormat, list: NodeArray<T>, sourceFile: SourceFile): string;
+ /**
+ * Prints a source file as-is, without any emit transformations.
+ */
+ printFile(sourceFile: SourceFile): string;
+ /**
+ * Prints a bundle of source files as-is, without any emit transformations.
+ */
+ printBundle(bundle: Bundle): string;
+ }
+ export interface PrintHandlers {
+ /**
+ * A hook used by the Printer when generating unique names to avoid collisions with
+ * globally defined names that exist outside of the current source file.
+ */
+ hasGlobalName?(name: string): boolean;
+ /**
+ * A hook used by the Printer to provide notifications prior to emitting a node. A
+ * compatible implementation **must** invoke `emitCallback` with the provided `hint` and
+ * `node` values.
+ * @param hint A hint indicating the intended purpose of the node.
+ * @param node The node to emit.
+ * @param emitCallback A callback that, when invoked, will emit the node.
+ * @example
+ * ```ts
+ * var printer = createPrinter(printerOptions, {
+ * onEmitNode(hint, node, emitCallback) {
+ * // set up or track state prior to emitting the node...
+ * emitCallback(hint, node);
+ * // restore state after emitting the node...
+ * }
+ * });
+ * ```
+ */
+ onEmitNode?(hint: EmitHint, node: Node | undefined, emitCallback: (hint: EmitHint, node: Node | undefined) => void): void;
+ /**
+ * A hook used to check if an emit notification is required for a node.
+ * @param node The node to emit.
+ */
+ isEmitNotificationEnabled?(node: Node | undefined): boolean;
+ /**
+ * A hook used by the Printer to perform just-in-time substitution of a node. This is
+ * primarily used by node transformations that need to substitute one node for another,
+ * such as replacing `myExportedVar` with `exports.myExportedVar`.
+ * @param hint A hint indicating the intended purpose of the node.
+ * @param node The node to emit.
+ * @example
+ * ```ts
+ * var printer = createPrinter(printerOptions, {
+ * substituteNode(hint, node) {
+ * // perform substitution if necessary...
+ * return node;
+ * }
+ * });
+ * ```
+ */
+ substituteNode?(hint: EmitHint, node: Node): Node;
+ }
+ export interface PrinterOptions {
+ removeComments?: boolean;
+ newLine?: NewLineKind;
+ omitTrailingSemicolon?: boolean;
+ noEmitHelpers?: boolean;
+ }
+ export interface GetEffectiveTypeRootsHost {
+ directoryExists?(directoryName: string): boolean;
+ getCurrentDirectory?(): string;
+ }
+ export interface TextSpan {
+ start: number;
+ length: number;
+ }
+ export interface TextChangeRange {
+ span: TextSpan;
+ newLength: number;
+ }
+ export interface SyntaxList extends Node {
+ _children: Node[];
+ }
+ export enum ListFormat {
+ None = 0,
+ SingleLine = 0,
+ MultiLine = 1,
+ PreserveLines = 2,
+ LinesMask = 3,
+ NotDelimited = 0,
+ BarDelimited = 4,
+ AmpersandDelimited = 8,
+ CommaDelimited = 16,
+ AsteriskDelimited = 32,
+ DelimitersMask = 60,
+ AllowTrailingComma = 64,
+ Indented = 128,
+ SpaceBetweenBraces = 256,
+ SpaceBetweenSiblings = 512,
+ Braces = 1024,
+ Parenthesis = 2048,
+ AngleBrackets = 4096,
+ SquareBrackets = 8192,
+ BracketsMask = 15360,
+ OptionalIfUndefined = 16384,
+ OptionalIfEmpty = 32768,
+ Optional = 49152,
+ PreferNewLine = 65536,
+ NoTrailingNewLine = 131072,
+ NoInterveningComments = 262144,
+ NoSpaceIfEmpty = 524288,
+ SingleElement = 1048576,
+ SpaceAfterList = 2097152,
+ Modifiers = 262656,
+ HeritageClauses = 512,
+ SingleLineTypeLiteralMembers = 768,
+ MultiLineTypeLiteralMembers = 32897,
+ TupleTypeElements = 528,
+ UnionTypeConstituents = 516,
+ IntersectionTypeConstituents = 520,
+ ObjectBindingPatternElements = 525136,
+ ArrayBindingPatternElements = 524880,
+ ObjectLiteralExpressionProperties = 526226,
+ ArrayLiteralExpressionElements = 8914,
+ CommaListElements = 528,
+ CallExpressionArguments = 2576,
+ NewExpressionArguments = 18960,
+ TemplateExpressionSpans = 262144,
+ SingleLineBlockStatements = 768,
+ MultiLineBlockStatements = 129,
+ VariableDeclarationList = 528,
+ SingleLineFunctionBodyStatements = 768,
+ MultiLineFunctionBodyStatements = 1,
+ ClassHeritageClauses = 0,
+ ClassMembers = 129,
+ InterfaceMembers = 129,
+ EnumMembers = 145,
+ CaseBlockClauses = 129,
+ NamedImportsOrExportsElements = 525136,
+ JsxElementOrFragmentChildren = 262144,
+ JsxElementAttributes = 262656,
+ CaseOrDefaultClauseStatements = 163969,
+ HeritageClauseTypes = 528,
+ SourceFileStatements = 131073,
+ Decorators = 2146305,
+ TypeArguments = 53776,
+ TypeParameters = 53776,
+ Parameters = 2576,
+ IndexSignatureParameters = 8848,
+ JSDocComment = 33
+ }
+ export interface UserPreferences {
+ readonly disableSuggestions?: boolean;
+ readonly quotePreference?: "auto" | "double" | "single";
+ readonly includeCompletionsForModuleExports?: boolean;
+ readonly includeAutomaticOptionalChainCompletions?: boolean;
+ readonly includeCompletionsWithInsertText?: boolean;
+ readonly importModuleSpecifierPreference?: "auto" | "relative" | "non-relative";
+ /** Determines whether we import `foo/index.ts` as "foo", "foo/index", or "foo/index.js" */
+ readonly importModuleSpecifierEnding?: "auto" | "minimal" | "index" | "js";
+ readonly allowTextChangesInNewFiles?: boolean;
+ readonly providePrefixAndSuffixTextForRename?: boolean;
+ }
+ /** Represents a bigint literal value without requiring bigint support */
+ export interface PseudoBigInt {
+ negative: boolean;
+ base10Value: string;
+ }
+ export {};
+}
+declare function setTimeout(handler: (...args: any[]) => void, timeout: number): any;
+declare function clearTimeout(handle: any): void;
+declare namespace ts {
+ export enum FileWatcherEventKind {
+ Created = 0,
+ Changed = 1,
+ Deleted = 2
+ }
+ export type FileWatcherCallback = (fileName: string, eventKind: FileWatcherEventKind) => void;
+ export type DirectoryWatcherCallback = (fileName: string) => void;
+ export interface System {
+ args: string[];
+ newLine: string;
+ useCaseSensitiveFileNames: boolean;
+ write(s: string): void;
+ writeOutputIsTTY?(): boolean;
+ readFile(path: string, encoding?: string): string | undefined;
+ getFileSize?(path: string): number;
+ writeFile(path: string, data: string, writeByteOrderMark?: boolean): void;
+ /**
+ * @pollingInterval - this parameter is used in polling-based watchers and ignored in watchers that
+ * use native OS file watching
+ */
+ watchFile?(path: string, callback: FileWatcherCallback, pollingInterval?: number, options?: WatchOptions): FileWatcher;
+ watchDirectory?(path: string, callback: DirectoryWatcherCallback, recursive?: boolean, options?: WatchOptions): FileWatcher;
+ resolvePath(path: string): string;
+ fileExists(path: string): boolean;
+ directoryExists(path: string): boolean;
+ createDirectory(path: string): void;
+ getExecutingFilePath(): string;
+ getCurrentDirectory(): string;
+ getDirectories(path: string): string[];
+ readDirectory(path: string, extensions?: readonly string[], exclude?: readonly string[], include?: readonly string[], depth?: number): string[];
+ getModifiedTime?(path: string): Date | undefined;
+ setModifiedTime?(path: string, time: Date): void;
+ deleteFile?(path: string): void;
+ /**
+ * A good implementation is node.js' `crypto.createHash`. (https://nodejs.org/api/crypto.html#crypto_crypto_createhash_algorithm)
+ */
+ createHash?(data: string): string;
+ /** This must be cryptographically secure. Only implement this method using `crypto.createHash("sha256")`. */
+ createSHA256Hash?(data: string): string;
+ getMemoryUsage?(): number;
+ exit(exitCode?: number): void;
+ realpath?(path: string): string;
+ setTimeout?(callback: (...args: any[]) => void, ms: number, ...args: any[]): any;
+ clearTimeout?(timeoutId: any): void;
+ clearScreen?(): void;
+ base64decode?(input: string): string;
+ base64encode?(input: string): string;
+ }
+ export interface FileWatcher {
+ close(): void;
+ }
+ export function getNodeMajorVersion(): number | undefined;
+ export let sys: System;
+ export {};
+}
+declare namespace ts {
+ type ErrorCallback = (message: DiagnosticMessage, length: number) => void;
+ interface Scanner {
+ getStartPos(): number;
+ getToken(): SyntaxKind;
+ getTextPos(): number;
+ getTokenPos(): number;
+ getTokenText(): string;
+ getTokenValue(): string;
+ hasUnicodeEscape(): boolean;
+ hasExtendedUnicodeEscape(): boolean;
+ hasPrecedingLineBreak(): boolean;
+ isIdentifier(): boolean;
+ isReservedWord(): boolean;
+ isUnterminated(): boolean;
+ reScanGreaterToken(): SyntaxKind;
+ reScanSlashToken(): SyntaxKind;
+ reScanTemplateToken(isTaggedTemplate: boolean): SyntaxKind;
+ reScanTemplateHeadOrNoSubstitutionTemplate(): SyntaxKind;
+ scanJsxIdentifier(): SyntaxKind;
+ scanJsxAttributeValue(): SyntaxKind;
+ reScanJsxAttributeValue(): SyntaxKind;
+ reScanJsxToken(): JsxTokenSyntaxKind;
+ reScanLessThanToken(): SyntaxKind;
+ reScanQuestionToken(): SyntaxKind;
+ scanJsxToken(): JsxTokenSyntaxKind;
+ scanJsDocToken(): JSDocSyntaxKind;
+ scan(): SyntaxKind;
+ getText(): string;
+ setText(text: string | undefined, start?: number, length?: number): void;
+ setOnError(onError: ErrorCallback | undefined): void;
+ setScriptTarget(scriptTarget: ScriptTarget): void;
+ setLanguageVariant(variant: LanguageVariant): void;
+ setTextPos(textPos: number): void;
+ lookAhead<T>(callback: () => T): T;
+ scanRange<T>(start: number, length: number, callback: () => T): T;
+ tryScan<T>(callback: () => T): T;
+ }
+ function tokenToString(t: SyntaxKind): string | undefined;
+ function getPositionOfLineAndCharacter(sourceFile: SourceFileLike, line: number, character: number): number;
+ function getLineAndCharacterOfPosition(sourceFile: SourceFileLike, position: number): LineAndCharacter;
+ function isWhiteSpaceLike(ch: number): boolean;
+ /** Does not include line breaks. For that, see isWhiteSpaceLike. */
+ function isWhiteSpaceSingleLine(ch: number): boolean;
+ function isLineBreak(ch: number): boolean;
+ function couldStartTrivia(text: string, pos: number): boolean;
+ function forEachLeadingCommentRange<U>(text: string, pos: number, cb: (pos: number, end: number, kind: CommentKind, hasTrailingNewLine: boolean) => U): U | undefined;
+ function forEachLeadingCommentRange<T, U>(text: string, pos: number, cb: (pos: number, end: number, kind: CommentKind, hasTrailingNewLine: boolean, state: T) => U, state: T): U | undefined;
+ function forEachTrailingCommentRange<U>(text: string, pos: number, cb: (pos: number, end: number, kind: CommentKind, hasTrailingNewLine: boolean) => U): U | undefined;
+ function forEachTrailingCommentRange<T, U>(text: string, pos: number, cb: (pos: number, end: number, kind: CommentKind, hasTrailingNewLine: boolean, state: T) => U, state: T): U | undefined;
+ function reduceEachLeadingCommentRange<T, U>(text: string, pos: number, cb: (pos: number, end: number, kind: CommentKind, hasTrailingNewLine: boolean, state: T, memo: U) => U, state: T, initial: U): U | undefined;
+ function reduceEachTrailingCommentRange<T, U>(text: string, pos: number, cb: (pos: number, end: number, kind: CommentKind, hasTrailingNewLine: boolean, state: T, memo: U) => U, state: T, initial: U): U | undefined;
+ function getLeadingCommentRanges(text: string, pos: number): CommentRange[] | undefined;
+ function getTrailingCommentRanges(text: string, pos: number): CommentRange[] | undefined;
+ /** Optionally, get the shebang */
+ function getShebang(text: string): string | undefined;
+ function isIdentifierStart(ch: number, languageVersion: ScriptTarget | undefined): boolean;
+ function isIdentifierPart(ch: number, languageVersion: ScriptTarget | undefined, identifierVariant?: LanguageVariant): boolean;
+ function createScanner(languageVersion: ScriptTarget, skipTrivia: boolean, languageVariant?: LanguageVariant, textInitial?: string, onError?: ErrorCallback, start?: number, length?: number): Scanner;
+}
+declare namespace ts {
+ function isExternalModuleNameRelative(moduleName: string): boolean;
+ function sortAndDeduplicateDiagnostics<T extends Diagnostic>(diagnostics: readonly T[]): SortedReadonlyArray<T>;
+ function getDefaultLibFileName(options: CompilerOptions): string;
+ function textSpanEnd(span: TextSpan): number;
+ function textSpanIsEmpty(span: TextSpan): boolean;
+ function textSpanContainsPosition(span: TextSpan, position: number): boolean;
+ function textSpanContainsTextSpan(span: TextSpan, other: TextSpan): boolean;
+ function textSpanOverlapsWith(span: TextSpan, other: TextSpan): boolean;
+ function textSpanOverlap(span1: TextSpan, span2: TextSpan): TextSpan | undefined;
+ function textSpanIntersectsWithTextSpan(span: TextSpan, other: TextSpan): boolean;
+ function textSpanIntersectsWith(span: TextSpan, start: number, length: number): boolean;
+ function decodedTextSpanIntersectsWith(start1: number, length1: number, start2: number, length2: number): boolean;
+ function textSpanIntersectsWithPosition(span: TextSpan, position: number): boolean;
+ function textSpanIntersection(span1: TextSpan, span2: TextSpan): TextSpan | undefined;
+ function createTextSpan(start: number, length: number): TextSpan;
+ function createTextSpanFromBounds(start: number, end: number): TextSpan;
+ function textChangeRangeNewSpan(range: TextChangeRange): TextSpan;
+ function textChangeRangeIsUnchanged(range: TextChangeRange): boolean;
+ function createTextChangeRange(span: TextSpan, newLength: number): TextChangeRange;
+ let unchangedTextChangeRange: TextChangeRange;
+ /**
+ * Called to merge all the changes that occurred across several versions of a script snapshot
+ * into a single change. i.e. if a user keeps making successive edits to a script we will
+ * have a text change from V1 to V2, V2 to V3, ..., Vn.
+ *
+ * This function will then merge those changes into a single change range valid between V1 and
+ * Vn.
+ */
+ function collapseTextChangeRangesAcrossMultipleVersions(changes: readonly TextChangeRange[]): TextChangeRange;
+ function getTypeParameterOwner(d: Declaration): Declaration | undefined;
+ type ParameterPropertyDeclaration = ParameterDeclaration & {
+ parent: ConstructorDeclaration;
+ name: Identifier;
+ };
+ function isParameterPropertyDeclaration(node: Node, parent: Node): node is ParameterPropertyDeclaration;
+ function isEmptyBindingPattern(node: BindingName): node is BindingPattern;
+ function isEmptyBindingElement(node: BindingElement): boolean;
+ function walkUpBindingElementsAndPatterns(binding: BindingElement): VariableDeclaration | ParameterDeclaration;
+ function getCombinedModifierFlags(node: Declaration): ModifierFlags;
+ function getCombinedNodeFlags(node: Node): NodeFlags;
+ /**
+ * Checks to see if the locale is in the appropriate format,
+ * and if it is, attempts to set the appropriate language.
+ */
+ function validateLocaleAndSetLanguage(locale: string, sys: {
+ getExecutingFilePath(): string;
+ resolvePath(path: string): string;
+ fileExists(fileName: string): boolean;
+ readFile(fileName: string): string | undefined;
+ }, errors?: Push<Diagnostic>): void;
+ function getOriginalNode(node: Node): Node;
+ function getOriginalNode<T extends Node>(node: Node, nodeTest: (node: Node) => node is T): T;
+ function getOriginalNode(node: Node | undefined): Node | undefined;
+ function getOriginalNode<T extends Node>(node: Node | undefined, nodeTest: (node: Node | undefined) => node is T): T | undefined;
+ /**
+ * Gets a value indicating whether a node originated in the parse tree.
+ *
+ * @param node The node to test.
+ */
+ function isParseTreeNode(node: Node): boolean;
+ /**
+ * Gets the original parse tree node for a node.
+ *
+ * @param node The original node.
+ * @returns The original parse tree node if found; otherwise, undefined.
+ */
+ function getParseTreeNode(node: Node): Node;
+ /**
+ * Gets the original parse tree node for a node.
+ *
+ * @param node The original node.
+ * @param nodeTest A callback used to ensure the correct type of parse tree node is returned.
+ * @returns The original parse tree node if found; otherwise, undefined.
+ */
+ function getParseTreeNode<T extends Node>(node: Node | undefined, nodeTest?: (node: Node) => node is T): T | undefined;
+ /** Add an extra underscore to identifiers that start with two underscores to avoid issues with magic names like '__proto__' */
+ function escapeLeadingUnderscores(identifier: string): __String;
+ /**
+ * Remove extra underscore from escaped identifier text content.
+ *
+ * @param identifier The escaped identifier text.
+ * @returns The unescaped identifier text.
+ */
+ function unescapeLeadingUnderscores(identifier: __String): string;
+ function idText(identifierOrPrivateName: Identifier | PrivateIdentifier): string;
+ function symbolName(symbol: Symbol): string;
+ function getNameOfJSDocTypedef(declaration: JSDocTypedefTag): Identifier | PrivateIdentifier | undefined;
+ function getNameOfDeclaration(declaration: Declaration | Expression): DeclarationName | undefined;
+ /**
+ * Gets the JSDoc parameter tags for the node if present.
+ *
+ * @remarks Returns any JSDoc param tag whose name matches the provided
+ * parameter, whether a param tag on a containing function
+ * expression, or a param tag on a variable declaration whose
+ * initializer is the containing function. The tags closest to the
+ * node are returned first, so in the previous example, the param
+ * tag on the containing function expression would be first.
+ *
+ * For binding patterns, parameter tags are matched by position.
+ */
+ function getJSDocParameterTags(param: ParameterDeclaration): readonly JSDocParameterTag[];
+ /**
+ * Gets the JSDoc type parameter tags for the node if present.
+ *
+ * @remarks Returns any JSDoc template tag whose names match the provided
+ * parameter, whether a template tag on a containing function
+ * expression, or a template tag on a variable declaration whose
+ * initializer is the containing function. The tags closest to the
+ * node are returned first, so in the previous example, the template
+ * tag on the containing function expression would be first.
+ */
+ function getJSDocTypeParameterTags(param: TypeParameterDeclaration): readonly JSDocTemplateTag[];
+ /**
+ * Return true if the node has JSDoc parameter tags.
+ *
+ * @remarks Includes parameter tags that are not directly on the node,
+ * for example on a variable declaration whose initializer is a function expression.
+ */
+ function hasJSDocParameterTags(node: FunctionLikeDeclaration | SignatureDeclaration): boolean;
+ /** Gets the JSDoc augments tag for the node if present */
+ function getJSDocAugmentsTag(node: Node): JSDocAugmentsTag | undefined;
+ /** Gets the JSDoc implements tags for the node if present */
+ function getJSDocImplementsTags(node: Node): readonly JSDocImplementsTag[];
+ /** Gets the JSDoc class tag for the node if present */
+ function getJSDocClassTag(node: Node): JSDocClassTag | undefined;
+ /** Gets the JSDoc public tag for the node if present */
+ function getJSDocPublicTag(node: Node): JSDocPublicTag | undefined;
+ /** Gets the JSDoc private tag for the node if present */
+ function getJSDocPrivateTag(node: Node): JSDocPrivateTag | undefined;
+ /** Gets the JSDoc protected tag for the node if present */
+ function getJSDocProtectedTag(node: Node): JSDocProtectedTag | undefined;
+ /** Gets the JSDoc protected tag for the node if present */
+ function getJSDocReadonlyTag(node: Node): JSDocReadonlyTag | undefined;
+ /** Gets the JSDoc enum tag for the node if present */
+ function getJSDocEnumTag(node: Node): JSDocEnumTag | undefined;
+ /** Gets the JSDoc this tag for the node if present */
+ function getJSDocThisTag(node: Node): JSDocThisTag | undefined;
+ /** Gets the JSDoc return tag for the node if present */
+ function getJSDocReturnTag(node: Node): JSDocReturnTag | undefined;
+ /** Gets the JSDoc template tag for the node if present */
+ function getJSDocTemplateTag(node: Node): JSDocTemplateTag | undefined;
+ /** Gets the JSDoc type tag for the node if present and valid */
+ function getJSDocTypeTag(node: Node): JSDocTypeTag | undefined;
+ /**
+ * Gets the type node for the node if provided via JSDoc.
+ *
+ * @remarks The search includes any JSDoc param tag that relates
+ * to the provided parameter, for example a type tag on the
+ * parameter itself, or a param tag on a containing function
+ * expression, or a param tag on a variable declaration whose
+ * initializer is the containing function. The tags closest to the
+ * node are examined first, so in the previous example, the type
+ * tag directly on the node would be returned.
+ */
+ function getJSDocType(node: Node): TypeNode | undefined;
+ /**
+ * Gets the return type node for the node if provided via JSDoc return tag or type tag.
+ *
+ * @remarks `getJSDocReturnTag` just gets the whole JSDoc tag. This function
+ * gets the type from inside the braces, after the fat arrow, etc.
+ */
+ function getJSDocReturnType(node: Node): TypeNode | undefined;
+ /** Get all JSDoc tags related to a node, including those on parent nodes. */
+ function getJSDocTags(node: Node): readonly JSDocTag[];
+ /** Gets all JSDoc tags that match a specified predicate */
+ function getAllJSDocTags<T extends JSDocTag>(node: Node, predicate: (tag: JSDocTag) => tag is T): readonly T[];
+ /** Gets all JSDoc tags of a specified kind */
+ function getAllJSDocTagsOfKind(node: Node, kind: SyntaxKind): readonly JSDocTag[];
+ /**
+ * Gets the effective type parameters. If the node was parsed in a
+ * JavaScript file, gets the type parameters from the `@template` tag from JSDoc.
+ */
+ function getEffectiveTypeParameterDeclarations(node: DeclarationWithTypeParameters): readonly TypeParameterDeclaration[];
+ function getEffectiveConstraintOfTypeParameter(node: TypeParameterDeclaration): TypeNode | undefined;
+ function isNumericLiteral(node: Node): node is NumericLiteral;
+ function isBigIntLiteral(node: Node): node is BigIntLiteral;
+ function isStringLiteral(node: Node): node is StringLiteral;
+ function isJsxText(node: Node): node is JsxText;
+ function isRegularExpressionLiteral(node: Node): node is RegularExpressionLiteral;
+ function isNoSubstitutionTemplateLiteral(node: Node): node is NoSubstitutionTemplateLiteral;
+ function isTemplateHead(node: Node): node is TemplateHead;
+ function isTemplateMiddle(node: Node): node is TemplateMiddle;
+ function isTemplateTail(node: Node): node is TemplateTail;
+ function isIdentifier(node: Node): node is Identifier;
+ function isQualifiedName(node: Node): node is QualifiedName;
+ function isComputedPropertyName(node: Node): node is ComputedPropertyName;
+ function isPrivateIdentifier(node: Node): node is PrivateIdentifier;
+ function isIdentifierOrPrivateIdentifier(node: Node): node is Identifier | PrivateIdentifier;
+ function isTypeParameterDeclaration(node: Node): node is TypeParameterDeclaration;
+ function isParameter(node: Node): node is ParameterDeclaration;
+ function isDecorator(node: Node): node is Decorator;
+ function isPropertySignature(node: Node): node is PropertySignature;
+ function isPropertyDeclaration(node: Node): node is PropertyDeclaration;
+ function isMethodSignature(node: Node): node is MethodSignature;
+ function isMethodDeclaration(node: Node): node is MethodDeclaration;
+ function isConstructorDeclaration(node: Node): node is ConstructorDeclaration;
+ function isGetAccessorDeclaration(node: Node): node is GetAccessorDeclaration;
+ function isSetAccessorDeclaration(node: Node): node is SetAccessorDeclaration;
+ function isCallSignatureDeclaration(node: Node): node is CallSignatureDeclaration;
+ function isConstructSignatureDeclaration(node: Node): node is ConstructSignatureDeclaration;
+ function isIndexSignatureDeclaration(node: Node): node is IndexSignatureDeclaration;
+ function isTypePredicateNode(node: Node): node is TypePredicateNode;
+ function isTypeReferenceNode(node: Node): node is TypeReferenceNode;
+ function isFunctionTypeNode(node: Node): node is FunctionTypeNode;
+ function isConstructorTypeNode(node: Node): node is ConstructorTypeNode;
+ function isTypeQueryNode(node: Node): node is TypeQueryNode;
+ function isTypeLiteralNode(node: Node): node is TypeLiteralNode;
+ function isArrayTypeNode(node: Node): node is ArrayTypeNode;
+ function isTupleTypeNode(node: Node): node is TupleTypeNode;
+ function isUnionTypeNode(node: Node): node is UnionTypeNode;
+ function isIntersectionTypeNode(node: Node): node is IntersectionTypeNode;
+ function isConditionalTypeNode(node: Node): node is ConditionalTypeNode;
+ function isInferTypeNode(node: Node): node is InferTypeNode;
+ function isParenthesizedTypeNode(node: Node): node is ParenthesizedTypeNode;
+ function isThisTypeNode(node: Node): node is ThisTypeNode;
+ function isTypeOperatorNode(node: Node): node is TypeOperatorNode;
+ function isIndexedAccessTypeNode(node: Node): node is IndexedAccessTypeNode;
+ function isMappedTypeNode(node: Node): node is MappedTypeNode;
+ function isLiteralTypeNode(node: Node): node is LiteralTypeNode;
+ function isImportTypeNode(node: Node): node is ImportTypeNode;
+ function isObjectBindingPattern(node: Node): node is ObjectBindingPattern;
+ function isArrayBindingPattern(node: Node): node is ArrayBindingPattern;
+ function isBindingElement(node: Node): node is BindingElement;
+ function isArrayLiteralExpression(node: Node): node is ArrayLiteralExpression;
+ function isObjectLiteralExpression(node: Node): node is ObjectLiteralExpression;
+ function isPropertyAccessExpression(node: Node): node is PropertyAccessExpression;
+ function isPropertyAccessChain(node: Node): node is PropertyAccessChain;
+ function isElementAccessExpression(node: Node): node is ElementAccessExpression;
+ function isElementAccessChain(node: Node): node is ElementAccessChain;
+ function isCallExpression(node: Node): node is CallExpression;
+ function isCallChain(node: Node): node is CallChain;
+ function isOptionalChain(node: Node): node is PropertyAccessChain | ElementAccessChain | CallChain | NonNullChain;
+ function isNullishCoalesce(node: Node): boolean;
+ function isNewExpression(node: Node): node is NewExpression;
+ function isTaggedTemplateExpression(node: Node): node is TaggedTemplateExpression;
+ function isTypeAssertion(node: Node): node is TypeAssertion;
+ function isConstTypeReference(node: Node): boolean;
+ function isParenthesizedExpression(node: Node): node is ParenthesizedExpression;
+ function skipPartiallyEmittedExpressions(node: Expression): Expression;
+ function skipPartiallyEmittedExpressions(node: Node): Node;
+ function isFunctionExpression(node: Node): node is FunctionExpression;
+ function isArrowFunction(node: Node): node is ArrowFunction;
+ function isDeleteExpression(node: Node): node is DeleteExpression;
+ function isTypeOfExpression(node: Node): node is TypeOfExpression;
+ function isVoidExpression(node: Node): node is VoidExpression;
+ function isAwaitExpression(node: Node): node is AwaitExpression;
+ function isPrefixUnaryExpression(node: Node): node is PrefixUnaryExpression;
+ function isPostfixUnaryExpression(node: Node): node is PostfixUnaryExpression;
+ function isBinaryExpression(node: Node): node is BinaryExpression;
+ function isConditionalExpression(node: Node): node is ConditionalExpression;
+ function isTemplateExpression(node: Node): node is TemplateExpression;
+ function isYieldExpression(node: Node): node is YieldExpression;
+ function isSpreadElement(node: Node): node is SpreadElement;
+ function isClassExpression(node: Node): node is ClassExpression;
+ function isOmittedExpression(node: Node): node is OmittedExpression;
+ function isExpressionWithTypeArguments(node: Node): node is ExpressionWithTypeArguments;
+ function isAsExpression(node: Node): node is AsExpression;
+ function isNonNullExpression(node: Node): node is NonNullExpression;
+ function isNonNullChain(node: Node): node is NonNullChain;
+ function isMetaProperty(node: Node): node is MetaProperty;
+ function isTemplateSpan(node: Node): node is TemplateSpan;
+ function isSemicolonClassElement(node: Node): node is SemicolonClassElement;
+ function isBlock(node: Node): node is Block;
+ function isVariableStatement(node: Node): node is VariableStatement;
+ function isEmptyStatement(node: Node): node is EmptyStatement;
+ function isExpressionStatement(node: Node): node is ExpressionStatement;
+ function isIfStatement(node: Node): node is IfStatement;
+ function isDoStatement(node: Node): node is DoStatement;
+ function isWhileStatement(node: Node): node is WhileStatement;
+ function isForStatement(node: Node): node is ForStatement;
+ function isForInStatement(node: Node): node is ForInStatement;
+ function isForOfStatement(node: Node): node is ForOfStatement;
+ function isContinueStatement(node: Node): node is ContinueStatement;
+ function isBreakStatement(node: Node): node is BreakStatement;
+ function isBreakOrContinueStatement(node: Node): node is BreakOrContinueStatement;
+ function isReturnStatement(node: Node): node is ReturnStatement;
+ function isWithStatement(node: Node): node is WithStatement;
+ function isSwitchStatement(node: Node): node is SwitchStatement;
+ function isLabeledStatement(node: Node): node is LabeledStatement;
+ function isThrowStatement(node: Node): node is ThrowStatement;
+ function isTryStatement(node: Node): node is TryStatement;
+ function isDebuggerStatement(node: Node): node is DebuggerStatement;
+ function isVariableDeclaration(node: Node): node is VariableDeclaration;
+ function isVariableDeclarationList(node: Node): node is VariableDeclarationList;
+ function isFunctionDeclaration(node: Node): node is FunctionDeclaration;
+ function isClassDeclaration(node: Node): node is ClassDeclaration;
+ function isInterfaceDeclaration(node: Node): node is InterfaceDeclaration;
+ function isTypeAliasDeclaration(node: Node): node is TypeAliasDeclaration;
+ function isEnumDeclaration(node: Node): node is EnumDeclaration;
+ function isModuleDeclaration(node: Node): node is ModuleDeclaration;
+ function isModuleBlock(node: Node): node is ModuleBlock;
+ function isCaseBlock(node: Node): node is CaseBlock;
+ function isNamespaceExportDeclaration(node: Node): node is NamespaceExportDeclaration;
+ function isImportEqualsDeclaration(node: Node): node is ImportEqualsDeclaration;
+ function isImportDeclaration(node: Node): node is ImportDeclaration;
+ function isImportClause(node: Node): node is ImportClause;
+ function isNamespaceImport(node: Node): node is NamespaceImport;
+ function isNamespaceExport(node: Node): node is NamespaceExport;
+ function isNamedExportBindings(node: Node): node is NamedExportBindings;
+ function isNamedImports(node: Node): node is NamedImports;
+ function isImportSpecifier(node: Node): node is ImportSpecifier;
+ function isExportAssignment(node: Node): node is ExportAssignment;
+ function isExportDeclaration(node: Node): node is ExportDeclaration;
+ function isNamedExports(node: Node): node is NamedExports;
+ function isExportSpecifier(node: Node): node is ExportSpecifier;
+ function isMissingDeclaration(node: Node): node is MissingDeclaration;
+ function isExternalModuleReference(node: Node): node is ExternalModuleReference;
+ function isJsxElement(node: Node): node is JsxElement;
+ function isJsxSelfClosingElement(node: Node): node is JsxSelfClosingElement;
+ function isJsxOpeningElement(node: Node): node is JsxOpeningElement;
+ function isJsxClosingElement(node: Node): node is JsxClosingElement;
+ function isJsxFragment(node: Node): node is JsxFragment;
+ function isJsxOpeningFragment(node: Node): node is JsxOpeningFragment;
+ function isJsxClosingFragment(node: Node): node is JsxClosingFragment;
+ function isJsxAttribute(node: Node): node is JsxAttribute;
+ function isJsxAttributes(node: Node): node is JsxAttributes;
+ function isJsxSpreadAttribute(node: Node): node is JsxSpreadAttribute;
+ function isJsxExpression(node: Node): node is JsxExpression;
+ function isCaseClause(node: Node): node is CaseClause;
+ function isDefaultClause(node: Node): node is DefaultClause;
+ function isHeritageClause(node: Node): node is HeritageClause;
+ function isCatchClause(node: Node): node is CatchClause;
+ function isPropertyAssignment(node: Node): node is PropertyAssignment;
+ function isShorthandPropertyAssignment(node: Node): node is ShorthandPropertyAssignment;
+ function isSpreadAssignment(node: Node): node is SpreadAssignment;
+ function isEnumMember(node: Node): node is EnumMember;
+ function isSourceFile(node: Node): node is SourceFile;
+ function isBundle(node: Node): node is Bundle;
+ function isUnparsedSource(node: Node): node is UnparsedSource;
+ function isUnparsedPrepend(node: Node): node is UnparsedPrepend;
+ function isUnparsedTextLike(node: Node): node is UnparsedTextLike;
+ function isUnparsedNode(node: Node): node is UnparsedNode;
+ function isJSDocTypeExpression(node: Node): node is JSDocTypeExpression;
+ function isJSDocAllType(node: Node): node is JSDocAllType;
+ function isJSDocUnknownType(node: Node): node is JSDocUnknownType;
+ function isJSDocNullableType(node: Node): node is JSDocNullableType;
+ function isJSDocNonNullableType(node: Node): node is JSDocNonNullableType;
+ function isJSDocOptionalType(node: Node): node is JSDocOptionalType;
+ function isJSDocFunctionType(node: Node): node is JSDocFunctionType;
+ function isJSDocVariadicType(node: Node): node is JSDocVariadicType;
+ function isJSDoc(node: Node): node is JSDoc;
+ function isJSDocAuthorTag(node: Node): node is JSDocAuthorTag;
+ function isJSDocAugmentsTag(node: Node): node is JSDocAugmentsTag;
+ function isJSDocImplementsTag(node: Node): node is JSDocImplementsTag;
+ function isJSDocClassTag(node: Node): node is JSDocClassTag;
+ function isJSDocPublicTag(node: Node): node is JSDocPublicTag;
+ function isJSDocPrivateTag(node: Node): node is JSDocPrivateTag;
+ function isJSDocProtectedTag(node: Node): node is JSDocProtectedTag;
+ function isJSDocReadonlyTag(node: Node): node is JSDocReadonlyTag;
+ function isJSDocEnumTag(node: Node): node is JSDocEnumTag;
+ function isJSDocThisTag(node: Node): node is JSDocThisTag;
+ function isJSDocParameterTag(node: Node): node is JSDocParameterTag;
+ function isJSDocReturnTag(node: Node): node is JSDocReturnTag;
+ function isJSDocTypeTag(node: Node): node is JSDocTypeTag;
+ function isJSDocTemplateTag(node: Node): node is JSDocTemplateTag;
+ function isJSDocTypedefTag(node: Node): node is JSDocTypedefTag;
+ function isJSDocPropertyTag(node: Node): node is JSDocPropertyTag;
+ function isJSDocPropertyLikeTag(node: Node): node is JSDocPropertyLikeTag;
+ function isJSDocTypeLiteral(node: Node): node is JSDocTypeLiteral;
+ function isJSDocCallbackTag(node: Node): node is JSDocCallbackTag;
+ function isJSDocSignature(node: Node): node is JSDocSignature;
+ /**
+ * True if node is of some token syntax kind.
+ * For example, this is true for an IfKeyword but not for an IfStatement.
+ * Literals are considered tokens, except TemplateLiteral, but does include TemplateHead/Middle/Tail.
+ */
+ function isToken(n: Node): boolean;
+ function isLiteralExpression(node: Node): node is LiteralExpression;
+ type TemplateLiteralToken = NoSubstitutionTemplateLiteral | TemplateHead | TemplateMiddle | TemplateTail;
+ function isTemplateLiteralToken(node: Node): node is TemplateLiteralToken;
+ function isTemplateMiddleOrTemplateTail(node: Node): node is TemplateMiddle | TemplateTail;
+ function isImportOrExportSpecifier(node: Node): node is ImportSpecifier | ExportSpecifier;
+ function isTypeOnlyImportOrExportDeclaration(node: Node): node is TypeOnlyCompatibleAliasDeclaration;
+ function isStringTextContainingNode(node: Node): node is StringLiteral | TemplateLiteralToken;
+ function isModifier(node: Node): node is Modifier;
+ function isEntityName(node: Node): node is EntityName;
+ function isPropertyName(node: Node): node is PropertyName;
+ function isBindingName(node: Node): node is BindingName;
+ function isFunctionLike(node: Node): node is SignatureDeclaration;
+ function isClassElement(node: Node): node is ClassElement;
+ function isClassLike(node: Node): node is ClassLikeDeclaration;
+ function isAccessor(node: Node): node is AccessorDeclaration;
+ function isTypeElement(node: Node): node is TypeElement;
+ function isClassOrTypeElement(node: Node): node is ClassElement | TypeElement;
+ function isObjectLiteralElementLike(node: Node): node is ObjectLiteralElementLike;
+ /**
+ * Node test that determines whether a node is a valid type node.
+ * This differs from the `isPartOfTypeNode` function which determines whether a node is *part*
+ * of a TypeNode.
+ */
+ function isTypeNode(node: Node): node is TypeNode;
+ function isFunctionOrConstructorTypeNode(node: Node): node is FunctionTypeNode | ConstructorTypeNode;
+ function isPropertyAccessOrQualifiedName(node: Node): node is PropertyAccessExpression | QualifiedName;
+ function isCallLikeExpression(node: Node): node is CallLikeExpression;
+ function isCallOrNewExpression(node: Node): node is CallExpression | NewExpression;
+ function isTemplateLiteral(node: Node): node is TemplateLiteral;
+ function isAssertionExpression(node: Node): node is AssertionExpression;
+ function isIterationStatement(node: Node, lookInLabeledStatements: false): node is IterationStatement;
+ function isIterationStatement(node: Node, lookInLabeledStatements: boolean): node is IterationStatement | LabeledStatement;
+ function isJsxOpeningLikeElement(node: Node): node is JsxOpeningLikeElement;
+ function isCaseOrDefaultClause(node: Node): node is CaseOrDefaultClause;
+ /** True if node is of a kind that may contain comment text. */
+ function isJSDocCommentContainingNode(node: Node): boolean;
+ function isSetAccessor(node: Node): node is SetAccessorDeclaration;
+ function isGetAccessor(node: Node): node is GetAccessorDeclaration;
+ /** True if has initializer node attached to it. */
+ function hasOnlyExpressionInitializer(node: Node): node is HasExpressionInitializer;
+ function isObjectLiteralElement(node: Node): node is ObjectLiteralElement;
+ function isStringLiteralLike(node: Node): node is StringLiteralLike;
+}
+declare namespace ts {
+ export function createNode(kind: SyntaxKind, pos?: number, end?: number): Node;
+ /**
+ * Invokes a callback for each child of the given node. The 'cbNode' callback is invoked for all child nodes
+ * stored in properties. If a 'cbNodes' callback is specified, it is invoked for embedded arrays; otherwise,
+ * embedded arrays are flattened and the 'cbNode' callback is invoked for each element. If a callback returns
+ * a truthy value, iteration stops and that value is returned. Otherwise, undefined is returned.
+ *
+ * @param node a given node to visit its children
+ * @param cbNode a callback to be invoked for all child nodes
+ * @param cbNodes a callback to be invoked for embedded array
+ *
+ * @remarks `forEachChild` must visit the children of a node in the order
+ * that they appear in the source code. The language service depends on this property to locate nodes by position.
+ */
+ export function forEachChild<T>(node: Node, cbNode: (node: Node) => T | undefined, cbNodes?: (nodes: NodeArray<Node>) => T | undefined): T | undefined;
+ export function createSourceFile(fileName: string, sourceText: string, languageVersion: ScriptTarget, setParentNodes?: boolean, scriptKind?: ScriptKind): SourceFile;
+ export function parseIsolatedEntityName(text: string, languageVersion: ScriptTarget): EntityName | undefined;
+ /**
+ * Parse json text into SyntaxTree and return node and parse errors if any
+ * @param fileName
+ * @param sourceText
+ */
+ export function parseJsonText(fileName: string, sourceText: string): JsonSourceFile;
+ export function isExternalModule(file: SourceFile): boolean;
+ export function updateSourceFile(sourceFile: SourceFile, newText: string, textChangeRange: TextChangeRange, aggressiveChecks?: boolean): SourceFile;
+ export {};
+}
+declare namespace ts {
+ export function parseCommandLine(commandLine: readonly string[], readFile?: (path: string) => string | undefined): ParsedCommandLine;
+ export type DiagnosticReporter = (diagnostic: Diagnostic) => void;
+ /**
+ * Reports config file diagnostics
+ */
+ export interface ConfigFileDiagnosticsReporter {
+ /**
+ * Reports unrecoverable error when parsing config file
+ */
+ onUnRecoverableConfigFileDiagnostic: DiagnosticReporter;
+ }
+ /**
+ * Interface extending ParseConfigHost to support ParseConfigFile that reads config file and reports errors
+ */
+ export interface ParseConfigFileHost extends ParseConfigHost, ConfigFileDiagnosticsReporter {
+ getCurrentDirectory(): string;
+ }
+ /**
+ * Reads the config file, reports errors if any and exits if the config file cannot be found
+ */
+ export function getParsedCommandLineOfConfigFile(configFileName: string, optionsToExtend: CompilerOptions, host: ParseConfigFileHost, extendedConfigCache?: Map<ExtendedConfigCacheEntry>, watchOptionsToExtend?: WatchOptions, extraFileExtensions?: readonly FileExtensionInfo[]): ParsedCommandLine | undefined;
+ /**
+ * Read tsconfig.json file
+ * @param fileName The path to the config file
+ */
+ export function readConfigFile(fileName: string, readFile: (path: string) => string | undefined): {
+ config?: any;
+ error?: Diagnostic;
+ };
+ /**
+ * Parse the text of the tsconfig.json file
+ * @param fileName The path to the config file
+ * @param jsonText The text of the config file
+ */
+ export function parseConfigFileTextToJson(fileName: string, jsonText: string): {
+ config?: any;
+ error?: Diagnostic;
+ };
+ /**
+ * Read tsconfig.json file
+ * @param fileName The path to the config file
+ */
+ export function readJsonConfigFile(fileName: string, readFile: (path: string) => string | undefined): TsConfigSourceFile;
+ /**
+ * Convert the json syntax tree into the json value
+ */
+ export function convertToObject(sourceFile: JsonSourceFile, errors: Push<Diagnostic>): any;
+ /**
+ * Parse the contents of a config file (tsconfig.json).
+ * @param json The contents of the config file to parse
+ * @param host Instance of ParseConfigHost used to enumerate files in folder.
+ * @param basePath A root directory to resolve relative path entries in the config
+ * file to. e.g. outDir
+ */
+ export function parseJsonConfigFileContent(json: any, host: ParseConfigHost, basePath: string, existingOptions?: CompilerOptions, configFileName?: string, resolutionStack?: Path[], extraFileExtensions?: readonly FileExtensionInfo[], extendedConfigCache?: Map<ExtendedConfigCacheEntry>, existingWatchOptions?: WatchOptions): ParsedCommandLine;
+ /**
+ * Parse the contents of a config file (tsconfig.json).
+ * @param jsonNode The contents of the config file to parse
+ * @param host Instance of ParseConfigHost used to enumerate files in folder.
+ * @param basePath A root directory to resolve relative path entries in the config
+ * file to. e.g. outDir
+ */
+ export function parseJsonSourceFileConfigFileContent(sourceFile: TsConfigSourceFile, host: ParseConfigHost, basePath: string, existingOptions?: CompilerOptions, configFileName?: string, resolutionStack?: Path[], extraFileExtensions?: readonly FileExtensionInfo[], extendedConfigCache?: Map<ExtendedConfigCacheEntry>, existingWatchOptions?: WatchOptions): ParsedCommandLine;
+ export interface ParsedTsconfig {
+ raw: any;
+ options?: CompilerOptions;
+ watchOptions?: WatchOptions;
+ typeAcquisition?: TypeAcquisition;
+ /**
+ * Note that the case of the config path has not yet been normalized, as no files have been imported into the project yet
+ */
+ extendedConfigPath?: string;
+ }
+ export interface ExtendedConfigCacheEntry {
+ extendedResult: TsConfigSourceFile;
+ extendedConfig: ParsedTsconfig | undefined;
+ }
+ export function convertCompilerOptionsFromJson(jsonOptions: any, basePath: string, configFileName?: string): {
+ options: CompilerOptions;
+ errors: Diagnostic[];
+ };
+ export function convertTypeAcquisitionFromJson(jsonOptions: any, basePath: string, configFileName?: string): {
+ options: TypeAcquisition;
+ errors: Diagnostic[];
+ };
+ export {};
+}
+declare namespace ts {
+ function getEffectiveTypeRoots(options: CompilerOptions, host: GetEffectiveTypeRootsHost): string[] | undefined;
+ /**
+ * @param {string | undefined} containingFile - file that contains type reference directive, can be undefined if containing file is unknown.
+ * This is possible in case if resolution is performed for directives specified via 'types' parameter. In this case initial path for secondary lookups
+ * is assumed to be the same as root directory of the project.
+ */
+ function resolveTypeReferenceDirective(typeReferenceDirectiveName: string, containingFile: string | undefined, options: CompilerOptions, host: ModuleResolutionHost, redirectedReference?: ResolvedProjectReference): ResolvedTypeReferenceDirectiveWithFailedLookupLocations;
+ /**
+ * Given a set of options, returns the set of type directive names
+ * that should be included for this program automatically.
+ * This list could either come from the config file,
+ * or from enumerating the types root + initial secondary types lookup location.
+ * More type directives might appear in the program later as a result of loading actual source files;
+ * this list is only the set of defaults that are implicitly included.
+ */
+ function getAutomaticTypeDirectiveNames(options: CompilerOptions, host: ModuleResolutionHost): string[];
+ /**
+ * Cached module resolutions per containing directory.
+ * This assumes that any module id will have the same resolution for sibling files located in the same folder.
+ */
+ interface ModuleResolutionCache extends NonRelativeModuleNameResolutionCache {
+ getOrCreateCacheForDirectory(directoryName: string, redirectedReference?: ResolvedProjectReference): Map<ResolvedModuleWithFailedLookupLocations>;
+ }
+ /**
+ * Stored map from non-relative module name to a table: directory -> result of module lookup in this directory
+ * We support only non-relative module names because resolution of relative module names is usually more deterministic and thus less expensive.
+ */
+ interface NonRelativeModuleNameResolutionCache {
+ getOrCreateCacheForModuleName(nonRelativeModuleName: string, redirectedReference?: ResolvedProjectReference): PerModuleNameCache;
+ }
+ interface PerModuleNameCache {
+ get(directory: string): ResolvedModuleWithFailedLookupLocations | undefined;
+ set(directory: string, result: ResolvedModuleWithFailedLookupLocations): void;
+ }
+ function createModuleResolutionCache(currentDirectory: string, getCanonicalFileName: (s: string) => string, options?: CompilerOptions): ModuleResolutionCache;
+ function resolveModuleNameFromCache(moduleName: string, containingFile: string, cache: ModuleResolutionCache): ResolvedModuleWithFailedLookupLocations | undefined;
+ function resolveModuleName(moduleName: string, containingFile: string, compilerOptions: CompilerOptions, host: ModuleResolutionHost, cache?: ModuleResolutionCache, redirectedReference?: ResolvedProjectReference): ResolvedModuleWithFailedLookupLocations;
+ function nodeModuleNameResolver(moduleName: string, containingFile: string, compilerOptions: CompilerOptions, host: ModuleResolutionHost, cache?: ModuleResolutionCache, redirectedReference?: ResolvedProjectReference): ResolvedModuleWithFailedLookupLocations;
+ function classicNameResolver(moduleName: string, containingFile: string, compilerOptions: CompilerOptions, host: ModuleResolutionHost, cache?: NonRelativeModuleNameResolutionCache, redirectedReference?: ResolvedProjectReference): ResolvedModuleWithFailedLookupLocations;
+}
+declare namespace ts {
+ function createNodeArray<T extends Node>(elements?: readonly T[], hasTrailingComma?: boolean): NodeArray<T>;
+ /** If a node is passed, creates a string literal whose source text is read from a source node during emit. */
+ function createLiteral(value: string | StringLiteral | NoSubstitutionTemplateLiteral | NumericLiteral | Identifier): StringLiteral;
+ function createLiteral(value: number | PseudoBigInt): NumericLiteral;
+ function createLiteral(value: boolean): BooleanLiteral;
+ function createLiteral(value: string | number | PseudoBigInt | boolean): PrimaryExpression;
+ function createNumericLiteral(value: string, numericLiteralFlags?: TokenFlags): NumericLiteral;
+ function createBigIntLiteral(value: string): BigIntLiteral;
+ function createStringLiteral(text: string): StringLiteral;
+ function createRegularExpressionLiteral(text: string): RegularExpressionLiteral;
+ function createIdentifier(text: string): Identifier;
+ function updateIdentifier(node: Identifier): Identifier;
+ /** Create a unique temporary variable. */
+ function createTempVariable(recordTempVariable: ((node: Identifier) => void) | undefined): Identifier;
+ /** Create a unique temporary variable for use in a loop. */
+ function createLoopVariable(): Identifier;
+ /** Create a unique name based on the supplied text. */
+ function createUniqueName(text: string): Identifier;
+ /** Create a unique name based on the supplied text. */
+ function createOptimisticUniqueName(text: string): Identifier;
+ /** Create a unique name based on the supplied text. This does not consider names injected by the transformer. */
+ function createFileLevelUniqueName(text: string): Identifier;
+ /** Create a unique name generated for a node. */
+ function getGeneratedNameForNode(node: Node | undefined): Identifier;
+ function createPrivateIdentifier(text: string): PrivateIdentifier;
+ function createToken<TKind extends SyntaxKind>(token: TKind): Token<TKind>;
+ function createSuper(): SuperExpression;
+ function createThis(): ThisExpression & Token<SyntaxKind.ThisKeyword>;
+ function createNull(): NullLiteral & Token<SyntaxKind.NullKeyword>;
+ function createTrue(): BooleanLiteral & Token<SyntaxKind.TrueKeyword>;
+ function createFalse(): BooleanLiteral & Token<SyntaxKind.FalseKeyword>;
+ function createModifier<T extends Modifier["kind"]>(kind: T): Token<T>;
+ function createModifiersFromModifierFlags(flags: ModifierFlags): Modifier[];
+ function createQualifiedName(left: EntityName, right: string | Identifier): QualifiedName;
+ function updateQualifiedName(node: QualifiedName, left: EntityName, right: Identifier): QualifiedName;
+ function createComputedPropertyName(expression: Expression): ComputedPropertyName;
+ function updateComputedPropertyName(node: ComputedPropertyName, expression: Expression): ComputedPropertyName;
+ function createTypeParameterDeclaration(name: string | Identifier, constraint?: TypeNode, defaultType?: TypeNode): TypeParameterDeclaration;
+ function updateTypeParameterDeclaration(node: TypeParameterDeclaration, name: Identifier, constraint: TypeNode | undefined, defaultType: TypeNode | undefined): TypeParameterDeclaration;
+ function createParameter(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, dotDotDotToken: DotDotDotToken | undefined, name: string | BindingName, questionToken?: QuestionToken, type?: TypeNode, initializer?: Expression): ParameterDeclaration;
+ function updateParameter(node: ParameterDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, dotDotDotToken: DotDotDotToken | undefined, name: string | BindingName, questionToken: QuestionToken | undefined, type: TypeNode | undefined, initializer: Expression | undefined): ParameterDeclaration;
+ function createDecorator(expression: Expression): Decorator;
+ function updateDecorator(node: Decorator, expression: Expression): Decorator;
+ function createPropertySignature(modifiers: readonly Modifier[] | undefined, name: PropertyName | string, questionToken: QuestionToken | undefined, type: TypeNode | undefined, initializer: Expression | undefined): PropertySignature;
+ function updatePropertySignature(node: PropertySignature, modifiers: readonly Modifier[] | undefined, name: PropertyName, questionToken: QuestionToken | undefined, type: TypeNode | undefined, initializer: Expression | undefined): PropertySignature;
+ function createProperty(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: string | PropertyName, questionOrExclamationToken: QuestionToken | ExclamationToken | undefined, type: TypeNode | undefined, initializer: Expression | undefined): PropertyDeclaration;
+ function updateProperty(node: PropertyDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: string | PropertyName, questionOrExclamationToken: QuestionToken | ExclamationToken | undefined, type: TypeNode | undefined, initializer: Expression | undefined): PropertyDeclaration;
+ function createMethodSignature(typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined, name: string | PropertyName, questionToken: QuestionToken | undefined): MethodSignature;
+ function updateMethodSignature(node: MethodSignature, typeParameters: NodeArray<TypeParameterDeclaration> | undefined, parameters: NodeArray<ParameterDeclaration>, type: TypeNode | undefined, name: PropertyName, questionToken: QuestionToken | undefined): MethodSignature;
+ function createMethod(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, asteriskToken: AsteriskToken | undefined, name: string | PropertyName, questionToken: QuestionToken | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined, body: Block | undefined): MethodDeclaration;
+ function updateMethod(node: MethodDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, asteriskToken: AsteriskToken | undefined, name: PropertyName, questionToken: QuestionToken | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined, body: Block | undefined): MethodDeclaration;
+ function createConstructor(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, parameters: readonly ParameterDeclaration[], body: Block | undefined): ConstructorDeclaration;
+ function updateConstructor(node: ConstructorDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, parameters: readonly ParameterDeclaration[], body: Block | undefined): ConstructorDeclaration;
+ function createGetAccessor(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: string | PropertyName, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined, body: Block | undefined): GetAccessorDeclaration;
+ function updateGetAccessor(node: GetAccessorDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: PropertyName, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined, body: Block | undefined): GetAccessorDeclaration;
+ function createSetAccessor(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: string | PropertyName, parameters: readonly ParameterDeclaration[], body: Block | undefined): SetAccessorDeclaration;
+ function updateSetAccessor(node: SetAccessorDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: PropertyName, parameters: readonly ParameterDeclaration[], body: Block | undefined): SetAccessorDeclaration;
+ function createCallSignature(typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined): CallSignatureDeclaration;
+ function updateCallSignature(node: CallSignatureDeclaration, typeParameters: NodeArray<TypeParameterDeclaration> | undefined, parameters: NodeArray<ParameterDeclaration>, type: TypeNode | undefined): CallSignatureDeclaration;
+ function createConstructSignature(typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined): ConstructSignatureDeclaration;
+ function updateConstructSignature(node: ConstructSignatureDeclaration, typeParameters: NodeArray<TypeParameterDeclaration> | undefined, parameters: NodeArray<ParameterDeclaration>, type: TypeNode | undefined): ConstructSignatureDeclaration;
+ function createIndexSignature(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode): IndexSignatureDeclaration;
+ function updateIndexSignature(node: IndexSignatureDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode): IndexSignatureDeclaration;
+ function createKeywordTypeNode(kind: KeywordTypeNode["kind"]): KeywordTypeNode;
+ function createTypePredicateNode(parameterName: Identifier | ThisTypeNode | string, type: TypeNode): TypePredicateNode;
+ function createTypePredicateNodeWithModifier(assertsModifier: AssertsToken | undefined, parameterName: Identifier | ThisTypeNode | string, type: TypeNode | undefined): TypePredicateNode;
+ function updateTypePredicateNode(node: TypePredicateNode, parameterName: Identifier | ThisTypeNode, type: TypeNode): TypePredicateNode;
+ function updateTypePredicateNodeWithModifier(node: TypePredicateNode, assertsModifier: AssertsToken | undefined, parameterName: Identifier | ThisTypeNode, type: TypeNode | undefined): TypePredicateNode;
+ function createTypeReferenceNode(typeName: string | EntityName, typeArguments: readonly TypeNode[] | undefined): TypeReferenceNode;
+ function updateTypeReferenceNode(node: TypeReferenceNode, typeName: EntityName, typeArguments: NodeArray<TypeNode> | undefined): TypeReferenceNode;
+ function createFunctionTypeNode(typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined): FunctionTypeNode;
+ function updateFunctionTypeNode(node: FunctionTypeNode, typeParameters: NodeArray<TypeParameterDeclaration> | undefined, parameters: NodeArray<ParameterDeclaration>, type: TypeNode | undefined): FunctionTypeNode;
+ function createConstructorTypeNode(typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined): ConstructorTypeNode;
+ function updateConstructorTypeNode(node: ConstructorTypeNode, typeParameters: NodeArray<TypeParameterDeclaration> | undefined, parameters: NodeArray<ParameterDeclaration>, type: TypeNode | undefined): ConstructorTypeNode;
+ function createTypeQueryNode(exprName: EntityName): TypeQueryNode;
+ function updateTypeQueryNode(node: TypeQueryNode, exprName: EntityName): TypeQueryNode;
+ function createTypeLiteralNode(members: readonly TypeElement[] | undefined): TypeLiteralNode;
+ function updateTypeLiteralNode(node: TypeLiteralNode, members: NodeArray<TypeElement>): TypeLiteralNode;
+ function createArrayTypeNode(elementType: TypeNode): ArrayTypeNode;
+ function updateArrayTypeNode(node: ArrayTypeNode, elementType: TypeNode): ArrayTypeNode;
+ function createTupleTypeNode(elementTypes: readonly TypeNode[]): TupleTypeNode;
+ function updateTupleTypeNode(node: TupleTypeNode, elementTypes: readonly TypeNode[]): TupleTypeNode;
+ function createOptionalTypeNode(type: TypeNode): OptionalTypeNode;
+ function updateOptionalTypeNode(node: OptionalTypeNode, type: TypeNode): OptionalTypeNode;
+ function createRestTypeNode(type: TypeNode): RestTypeNode;
+ function updateRestTypeNode(node: RestTypeNode, type: TypeNode): RestTypeNode;
+ function createUnionTypeNode(types: readonly TypeNode[]): UnionTypeNode;
+ function updateUnionTypeNode(node: UnionTypeNode, types: NodeArray<TypeNode>): UnionTypeNode;
+ function createIntersectionTypeNode(types: readonly TypeNode[]): IntersectionTypeNode;
+ function updateIntersectionTypeNode(node: IntersectionTypeNode, types: NodeArray<TypeNode>): IntersectionTypeNode;
+ function createUnionOrIntersectionTypeNode(kind: SyntaxKind.UnionType | SyntaxKind.IntersectionType, types: readonly TypeNode[]): UnionOrIntersectionTypeNode;
+ function createConditionalTypeNode(checkType: TypeNode, extendsType: TypeNode, trueType: TypeNode, falseType: TypeNode): ConditionalTypeNode;
+ function updateConditionalTypeNode(node: ConditionalTypeNode, checkType: TypeNode, extendsType: TypeNode, trueType: TypeNode, falseType: TypeNode): ConditionalTypeNode;
+ function createInferTypeNode(typeParameter: TypeParameterDeclaration): InferTypeNode;
+ function updateInferTypeNode(node: InferTypeNode, typeParameter: TypeParameterDeclaration): InferTypeNode;
+ function createImportTypeNode(argument: TypeNode, qualifier?: EntityName, typeArguments?: readonly TypeNode[], isTypeOf?: boolean): ImportTypeNode;
+ function updateImportTypeNode(node: ImportTypeNode, argument: TypeNode, qualifier?: EntityName, typeArguments?: readonly TypeNode[], isTypeOf?: boolean): ImportTypeNode;
+ function createParenthesizedType(type: TypeNode): ParenthesizedTypeNode;
+ function updateParenthesizedType(node: ParenthesizedTypeNode, type: TypeNode): ParenthesizedTypeNode;
+ function createThisTypeNode(): ThisTypeNode;
+ function createTypeOperatorNode(type: TypeNode): TypeOperatorNode;
+ function createTypeOperatorNode(operator: SyntaxKind.KeyOfKeyword | SyntaxKind.UniqueKeyword | SyntaxKind.ReadonlyKeyword, type: TypeNode): TypeOperatorNode;
+ function updateTypeOperatorNode(node: TypeOperatorNode, type: TypeNode): TypeOperatorNode;
+ function createIndexedAccessTypeNode(objectType: TypeNode, indexType: TypeNode): IndexedAccessTypeNode;
+ function updateIndexedAccessTypeNode(node: IndexedAccessTypeNode, objectType: TypeNode, indexType: TypeNode): IndexedAccessTypeNode;
+ function createMappedTypeNode(readonlyToken: ReadonlyToken | PlusToken | MinusToken | undefined, typeParameter: TypeParameterDeclaration, questionToken: QuestionToken | PlusToken | MinusToken | undefined, type: TypeNode | undefined): MappedTypeNode;
+ function updateMappedTypeNode(node: MappedTypeNode, readonlyToken: ReadonlyToken | PlusToken | MinusToken | undefined, typeParameter: TypeParameterDeclaration, questionToken: QuestionToken | PlusToken | MinusToken | undefined, type: TypeNode | undefined): MappedTypeNode;
+ function createLiteralTypeNode(literal: LiteralTypeNode["literal"]): LiteralTypeNode;
+ function updateLiteralTypeNode(node: LiteralTypeNode, literal: LiteralTypeNode["literal"]): LiteralTypeNode;
+ function createObjectBindingPattern(elements: readonly BindingElement[]): ObjectBindingPattern;
+ function updateObjectBindingPattern(node: ObjectBindingPattern, elements: readonly BindingElement[]): ObjectBindingPattern;
+ function createArrayBindingPattern(elements: readonly ArrayBindingElement[]): ArrayBindingPattern;
+ function updateArrayBindingPattern(node: ArrayBindingPattern, elements: readonly ArrayBindingElement[]): ArrayBindingPattern;
+ function createBindingElement(dotDotDotToken: DotDotDotToken | undefined, propertyName: string | PropertyName | undefined, name: string | BindingName, initializer?: Expression): BindingElement;
+ function updateBindingElement(node: BindingElement, dotDotDotToken: DotDotDotToken | undefined, propertyName: PropertyName | undefined, name: BindingName, initializer: Expression | undefined): BindingElement;
+ function createArrayLiteral(elements?: readonly Expression[], multiLine?: boolean): ArrayLiteralExpression;
+ function updateArrayLiteral(node: ArrayLiteralExpression, elements: readonly Expression[]): ArrayLiteralExpression;
+ function createObjectLiteral(properties?: readonly ObjectLiteralElementLike[], multiLine?: boolean): ObjectLiteralExpression;
+ function updateObjectLiteral(node: ObjectLiteralExpression, properties: readonly ObjectLiteralElementLike[]): ObjectLiteralExpression;
+ function createPropertyAccess(expression: Expression, name: string | Identifier | PrivateIdentifier): PropertyAccessExpression;
+ function updatePropertyAccess(node: PropertyAccessExpression, expression: Expression, name: Identifier | PrivateIdentifier): PropertyAccessExpression;
+ function createPropertyAccessChain(expression: Expression, questionDotToken: QuestionDotToken | undefined, name: string | Identifier): PropertyAccessChain;
+ function updatePropertyAccessChain(node: PropertyAccessChain, expression: Expression, questionDotToken: QuestionDotToken | undefined, name: Identifier): PropertyAccessChain;
+ function createElementAccess(expression: Expression, index: number | Expression): ElementAccessExpression;
+ function updateElementAccess(node: ElementAccessExpression, expression: Expression, argumentExpression: Expression): ElementAccessExpression;
+ function createElementAccessChain(expression: Expression, questionDotToken: QuestionDotToken | undefined, index: number | Expression): ElementAccessChain;
+ function updateElementAccessChain(node: ElementAccessChain, expression: Expression, questionDotToken: QuestionDotToken | undefined, argumentExpression: Expression): ElementAccessChain;
+ function createCall(expression: Expression, typeArguments: readonly TypeNode[] | undefined, argumentsArray: readonly Expression[] | undefined): CallExpression;
+ function updateCall(node: CallExpression, expression: Expression, typeArguments: readonly TypeNode[] | undefined, argumentsArray: readonly Expression[]): CallExpression;
+ function createCallChain(expression: Expression, questionDotToken: QuestionDotToken | undefined, typeArguments: readonly TypeNode[] | undefined, argumentsArray: readonly Expression[] | undefined): CallChain;
+ function updateCallChain(node: CallChain, expression: Expression, questionDotToken: QuestionDotToken | undefined, typeArguments: readonly TypeNode[] | undefined, argumentsArray: readonly Expression[]): CallChain;
+ function createNew(expression: Expression, typeArguments: readonly TypeNode[] | undefined, argumentsArray: readonly Expression[] | undefined): NewExpression;
+ function updateNew(node: NewExpression, expression: Expression, typeArguments: readonly TypeNode[] | undefined, argumentsArray: readonly Expression[] | undefined): NewExpression;
+ /** @deprecated */ function createTaggedTemplate(tag: Expression, template: TemplateLiteral): TaggedTemplateExpression;
+ function createTaggedTemplate(tag: Expression, typeArguments: readonly TypeNode[] | undefined, template: TemplateLiteral): TaggedTemplateExpression;
+ /** @deprecated */ function updateTaggedTemplate(node: TaggedTemplateExpression, tag: Expression, template: TemplateLiteral): TaggedTemplateExpression;
+ function updateTaggedTemplate(node: TaggedTemplateExpression, tag: Expression, typeArguments: readonly TypeNode[] | undefined, template: TemplateLiteral): TaggedTemplateExpression;
+ function createTypeAssertion(type: TypeNode, expression: Expression): TypeAssertion;
+ function updateTypeAssertion(node: TypeAssertion, type: TypeNode, expression: Expression): TypeAssertion;
+ function createParen(expression: Expression): ParenthesizedExpression;
+ function updateParen(node: ParenthesizedExpression, expression: Expression): ParenthesizedExpression;
+ function createFunctionExpression(modifiers: readonly Modifier[] | undefined, asteriskToken: AsteriskToken | undefined, name: string | Identifier | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[] | undefined, type: TypeNode | undefined, body: Block): FunctionExpression;
+ function updateFunctionExpression(node: FunctionExpression, modifiers: readonly Modifier[] | undefined, asteriskToken: AsteriskToken | undefined, name: Identifier | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined, body: Block): FunctionExpression;
+ function createArrowFunction(modifiers: readonly Modifier[] | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined, equalsGreaterThanToken: EqualsGreaterThanToken | undefined, body: ConciseBody): ArrowFunction;
+ function updateArrowFunction(node: ArrowFunction, modifiers: readonly Modifier[] | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined, equalsGreaterThanToken: Token<SyntaxKind.EqualsGreaterThanToken>, body: ConciseBody): ArrowFunction;
+ function createDelete(expression: Expression): DeleteExpression;
+ function updateDelete(node: DeleteExpression, expression: Expression): DeleteExpression;
+ function createTypeOf(expression: Expression): TypeOfExpression;
+ function updateTypeOf(node: TypeOfExpression, expression: Expression): TypeOfExpression;
+ function createVoid(expression: Expression): VoidExpression;
+ function updateVoid(node: VoidExpression, expression: Expression): VoidExpression;
+ function createAwait(expression: Expression): AwaitExpression;
+ function updateAwait(node: AwaitExpression, expression: Expression): AwaitExpression;
+ function createPrefix(operator: PrefixUnaryOperator, operand: Expression): PrefixUnaryExpression;
+ function updatePrefix(node: PrefixUnaryExpression, operand: Expression): PrefixUnaryExpression;
+ function createPostfix(operand: Expression, operator: PostfixUnaryOperator): PostfixUnaryExpression;
+ function updatePostfix(node: PostfixUnaryExpression, operand: Expression): PostfixUnaryExpression;
+ function createBinary(left: Expression, operator: BinaryOperator | BinaryOperatorToken, right: Expression): BinaryExpression;
+ function updateBinary(node: BinaryExpression, left: Expression, right: Expression, operator?: BinaryOperator | BinaryOperatorToken): BinaryExpression;
+ /** @deprecated */ function createConditional(condition: Expression, whenTrue: Expression, whenFalse: Expression): ConditionalExpression;
+ function createConditional(condition: Expression, questionToken: QuestionToken, whenTrue: Expression, colonToken: ColonToken, whenFalse: Expression): ConditionalExpression;
+ function updateConditional(node: ConditionalExpression, condition: Expression, questionToken: Token<SyntaxKind.QuestionToken>, whenTrue: Expression, colonToken: Token<SyntaxKind.ColonToken>, whenFalse: Expression): ConditionalExpression;
+ function createTemplateExpression(head: TemplateHead, templateSpans: readonly TemplateSpan[]): TemplateExpression;
+ function updateTemplateExpression(node: TemplateExpression, head: TemplateHead, templateSpans: readonly TemplateSpan[]): TemplateExpression;
+ function createTemplateHead(text: string, rawText?: string): TemplateHead;
+ function createTemplateMiddle(text: string, rawText?: string): TemplateMiddle;
+ function createTemplateTail(text: string, rawText?: string): TemplateTail;
+ function createNoSubstitutionTemplateLiteral(text: string, rawText?: string): NoSubstitutionTemplateLiteral;
+ function createYield(expression?: Expression): YieldExpression;
+ function createYield(asteriskToken: AsteriskToken | undefined, expression: Expression): YieldExpression;
+ function updateYield(node: YieldExpression, asteriskToken: AsteriskToken | undefined, expression: Expression): YieldExpression;
+ function createSpread(expression: Expression): SpreadElement;
+ function updateSpread(node: SpreadElement, expression: Expression): SpreadElement;
+ function createClassExpression(modifiers: readonly Modifier[] | undefined, name: string | Identifier | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, heritageClauses: readonly HeritageClause[] | undefined, members: readonly ClassElement[]): ClassExpression;
+ function updateClassExpression(node: ClassExpression, modifiers: readonly Modifier[] | undefined, name: Identifier | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, heritageClauses: readonly HeritageClause[] | undefined, members: readonly ClassElement[]): ClassExpression;
+ function createOmittedExpression(): OmittedExpression;
+ function createExpressionWithTypeArguments(typeArguments: readonly TypeNode[] | undefined, expression: Expression): ExpressionWithTypeArguments;
+ function updateExpressionWithTypeArguments(node: ExpressionWithTypeArguments, typeArguments: readonly TypeNode[] | undefined, expression: Expression): ExpressionWithTypeArguments;
+ function createAsExpression(expression: Expression, type: TypeNode): AsExpression;
+ function updateAsExpression(node: AsExpression, expression: Expression, type: TypeNode): AsExpression;
+ function createNonNullExpression(expression: Expression): NonNullExpression;
+ function updateNonNullExpression(node: NonNullExpression, expression: Expression): NonNullExpression;
+ function createNonNullChain(expression: Expression): NonNullChain;
+ function updateNonNullChain(node: NonNullChain, expression: Expression): NonNullChain;
+ function createMetaProperty(keywordToken: MetaProperty["keywordToken"], name: Identifier): MetaProperty;
+ function updateMetaProperty(node: MetaProperty, name: Identifier): MetaProperty;
+ function createTemplateSpan(expression: Expression, literal: TemplateMiddle | TemplateTail): TemplateSpan;
+ function updateTemplateSpan(node: TemplateSpan, expression: Expression, literal: TemplateMiddle | TemplateTail): TemplateSpan;
+ function createSemicolonClassElement(): SemicolonClassElement;
+ function createBlock(statements: readonly Statement[], multiLine?: boolean): Block;
+ function updateBlock(node: Block, statements: readonly Statement[]): Block;
+ function createVariableStatement(modifiers: readonly Modifier[] | undefined, declarationList: VariableDeclarationList | readonly VariableDeclaration[]): VariableStatement;
+ function updateVariableStatement(node: VariableStatement, modifiers: readonly Modifier[] | undefined, declarationList: VariableDeclarationList): VariableStatement;
+ function createEmptyStatement(): EmptyStatement;
+ function createExpressionStatement(expression: Expression): ExpressionStatement;
+ function updateExpressionStatement(node: ExpressionStatement, expression: Expression): ExpressionStatement;
+ /** @deprecated Use `createExpressionStatement` instead. */
+ const createStatement: typeof createExpressionStatement;
+ /** @deprecated Use `updateExpressionStatement` instead. */
+ const updateStatement: typeof updateExpressionStatement;
+ function createIf(expression: Expression, thenStatement: Statement, elseStatement?: Statement): IfStatement;
+ function updateIf(node: IfStatement, expression: Expression, thenStatement: Statement, elseStatement: Statement | undefined): IfStatement;
+ function createDo(statement: Statement, expression: Expression): DoStatement;
+ function updateDo(node: DoStatement, statement: Statement, expression: Expression): DoStatement;
+ function createWhile(expression: Expression, statement: Statement): WhileStatement;
+ function updateWhile(node: WhileStatement, expression: Expression, statement: Statement): WhileStatement;
+ function createFor(initializer: ForInitializer | undefined, condition: Expression | undefined, incrementor: Expression | undefined, statement: Statement): ForStatement;
+ function updateFor(node: ForStatement, initializer: ForInitializer | undefined, condition: Expression | undefined, incrementor: Expression | undefined, statement: Statement): ForStatement;
+ function createForIn(initializer: ForInitializer, expression: Expression, statement: Statement): ForInStatement;
+ function updateForIn(node: ForInStatement, initializer: ForInitializer, expression: Expression, statement: Statement): ForInStatement;
+ function createForOf(awaitModifier: AwaitKeywordToken | undefined, initializer: ForInitializer, expression: Expression, statement: Statement): ForOfStatement;
+ function updateForOf(node: ForOfStatement, awaitModifier: AwaitKeywordToken | undefined, initializer: ForInitializer, expression: Expression, statement: Statement): ForOfStatement;
+ function createContinue(label?: string | Identifier): ContinueStatement;
+ function updateContinue(node: ContinueStatement, label: Identifier | undefined): ContinueStatement;
+ function createBreak(label?: string | Identifier): BreakStatement;
+ function updateBreak(node: BreakStatement, label: Identifier | undefined): BreakStatement;
+ function createReturn(expression?: Expression): ReturnStatement;
+ function updateReturn(node: ReturnStatement, expression: Expression | undefined): ReturnStatement;
+ function createWith(expression: Expression, statement: Statement): WithStatement;
+ function updateWith(node: WithStatement, expression: Expression, statement: Statement): WithStatement;
+ function createSwitch(expression: Expression, caseBlock: CaseBlock): SwitchStatement;
+ function updateSwitch(node: SwitchStatement, expression: Expression, caseBlock: CaseBlock): SwitchStatement;
+ function createLabel(label: string | Identifier, statement: Statement): LabeledStatement;
+ function updateLabel(node: LabeledStatement, label: Identifier, statement: Statement): LabeledStatement;
+ function createThrow(expression: Expression): ThrowStatement;
+ function updateThrow(node: ThrowStatement, expression: Expression): ThrowStatement;
+ function createTry(tryBlock: Block, catchClause: CatchClause | undefined, finallyBlock: Block | undefined): TryStatement;
+ function updateTry(node: TryStatement, tryBlock: Block, catchClause: CatchClause | undefined, finallyBlock: Block | undefined): TryStatement;
+ function createDebuggerStatement(): DebuggerStatement;
+ function createVariableDeclaration(name: string | BindingName, type?: TypeNode, initializer?: Expression): VariableDeclaration;
+ function updateVariableDeclaration(node: VariableDeclaration, name: BindingName, type: TypeNode | undefined, initializer: Expression | undefined): VariableDeclaration;
+ function createVariableDeclarationList(declarations: readonly VariableDeclaration[], flags?: NodeFlags): VariableDeclarationList;
+ function updateVariableDeclarationList(node: VariableDeclarationList, declarations: readonly VariableDeclaration[]): VariableDeclarationList;
+ function createFunctionDeclaration(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, asteriskToken: AsteriskToken | undefined, name: string | Identifier | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined, body: Block | undefined): FunctionDeclaration;
+ function updateFunctionDeclaration(node: FunctionDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, asteriskToken: AsteriskToken | undefined, name: Identifier | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, parameters: readonly ParameterDeclaration[], type: TypeNode | undefined, body: Block | undefined): FunctionDeclaration;
+ function createClassDeclaration(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: string | Identifier | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, heritageClauses: readonly HeritageClause[] | undefined, members: readonly ClassElement[]): ClassDeclaration;
+ function updateClassDeclaration(node: ClassDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: Identifier | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, heritageClauses: readonly HeritageClause[] | undefined, members: readonly ClassElement[]): ClassDeclaration;
+ function createInterfaceDeclaration(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: string | Identifier, typeParameters: readonly TypeParameterDeclaration[] | undefined, heritageClauses: readonly HeritageClause[] | undefined, members: readonly TypeElement[]): InterfaceDeclaration;
+ function updateInterfaceDeclaration(node: InterfaceDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: Identifier, typeParameters: readonly TypeParameterDeclaration[] | undefined, heritageClauses: readonly HeritageClause[] | undefined, members: readonly TypeElement[]): InterfaceDeclaration;
+ function createTypeAliasDeclaration(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: string | Identifier, typeParameters: readonly TypeParameterDeclaration[] | undefined, type: TypeNode): TypeAliasDeclaration;
+ function updateTypeAliasDeclaration(node: TypeAliasDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: Identifier, typeParameters: readonly TypeParameterDeclaration[] | undefined, type: TypeNode): TypeAliasDeclaration;
+ function createEnumDeclaration(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: string | Identifier, members: readonly EnumMember[]): EnumDeclaration;
+ function updateEnumDeclaration(node: EnumDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: Identifier, members: readonly EnumMember[]): EnumDeclaration;
+ function createModuleDeclaration(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: ModuleName, body: ModuleBody | undefined, flags?: NodeFlags): ModuleDeclaration;
+ function updateModuleDeclaration(node: ModuleDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: ModuleName, body: ModuleBody | undefined): ModuleDeclaration;
+ function createModuleBlock(statements: readonly Statement[]): ModuleBlock;
+ function updateModuleBlock(node: ModuleBlock, statements: readonly Statement[]): ModuleBlock;
+ function createCaseBlock(clauses: readonly CaseOrDefaultClause[]): CaseBlock;
+ function updateCaseBlock(node: CaseBlock, clauses: readonly CaseOrDefaultClause[]): CaseBlock;
+ function createNamespaceExportDeclaration(name: string | Identifier): NamespaceExportDeclaration;
+ function updateNamespaceExportDeclaration(node: NamespaceExportDeclaration, name: Identifier): NamespaceExportDeclaration;
+ function createImportEqualsDeclaration(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: string | Identifier, moduleReference: ModuleReference): ImportEqualsDeclaration;
+ function updateImportEqualsDeclaration(node: ImportEqualsDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, name: Identifier, moduleReference: ModuleReference): ImportEqualsDeclaration;
+ function createImportDeclaration(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, importClause: ImportClause | undefined, moduleSpecifier: Expression): ImportDeclaration;
+ function updateImportDeclaration(node: ImportDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, importClause: ImportClause | undefined, moduleSpecifier: Expression): ImportDeclaration;
+ function createImportClause(name: Identifier | undefined, namedBindings: NamedImportBindings | undefined, isTypeOnly?: boolean): ImportClause;
+ function updateImportClause(node: ImportClause, name: Identifier | undefined, namedBindings: NamedImportBindings | undefined, isTypeOnly: boolean): ImportClause;
+ function createNamespaceImport(name: Identifier): NamespaceImport;
+ function createNamespaceExport(name: Identifier): NamespaceExport;
+ function updateNamespaceImport(node: NamespaceImport, name: Identifier): NamespaceImport;
+ function updateNamespaceExport(node: NamespaceExport, name: Identifier): NamespaceExport;
+ function createNamedImports(elements: readonly ImportSpecifier[]): NamedImports;
+ function updateNamedImports(node: NamedImports, elements: readonly ImportSpecifier[]): NamedImports;
+ function createImportSpecifier(propertyName: Identifier | undefined, name: Identifier): ImportSpecifier;
+ function updateImportSpecifier(node: ImportSpecifier, propertyName: Identifier | undefined, name: Identifier): ImportSpecifier;
+ function createExportAssignment(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, isExportEquals: boolean | undefined, expression: Expression): ExportAssignment;
+ function updateExportAssignment(node: ExportAssignment, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, expression: Expression): ExportAssignment;
+ function createExportDeclaration(decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, exportClause: NamedExportBindings | undefined, moduleSpecifier?: Expression, isTypeOnly?: boolean): ExportDeclaration;
+ function updateExportDeclaration(node: ExportDeclaration, decorators: readonly Decorator[] | undefined, modifiers: readonly Modifier[] | undefined, exportClause: NamedExportBindings | undefined, moduleSpecifier: Expression | undefined, isTypeOnly: boolean): ExportDeclaration;
+ function createNamedExports(elements: readonly ExportSpecifier[]): NamedExports;
+ function updateNamedExports(node: NamedExports, elements: readonly ExportSpecifier[]): NamedExports;
+ function createExportSpecifier(propertyName: string | Identifier | undefined, name: string | Identifier): ExportSpecifier;
+ function updateExportSpecifier(node: ExportSpecifier, propertyName: Identifier | undefined, name: Identifier): ExportSpecifier;
+ function createExternalModuleReference(expression: Expression): ExternalModuleReference;
+ function updateExternalModuleReference(node: ExternalModuleReference, expression: Expression): ExternalModuleReference;
+ function createJsxElement(openingElement: JsxOpeningElement, children: readonly JsxChild[], closingElement: JsxClosingElement): JsxElement;
+ function updateJsxElement(node: JsxElement, openingElement: JsxOpeningElement, children: readonly JsxChild[], closingElement: JsxClosingElement): JsxElement;
+ function createJsxSelfClosingElement(tagName: JsxTagNameExpression, typeArguments: readonly TypeNode[] | undefined, attributes: JsxAttributes): JsxSelfClosingElement;
+ function updateJsxSelfClosingElement(node: JsxSelfClosingElement, tagName: JsxTagNameExpression, typeArguments: readonly TypeNode[] | undefined, attributes: JsxAttributes): JsxSelfClosingElement;
+ function createJsxOpeningElement(tagName: JsxTagNameExpression, typeArguments: readonly TypeNode[] | undefined, attributes: JsxAttributes): JsxOpeningElement;
+ function updateJsxOpeningElement(node: JsxOpeningElement, tagName: JsxTagNameExpression, typeArguments: readonly TypeNode[] | undefined, attributes: JsxAttributes): JsxOpeningElement;
+ function createJsxClosingElement(tagName: JsxTagNameExpression): JsxClosingElement;
+ function updateJsxClosingElement(node: JsxClosingElement, tagName: JsxTagNameExpression): JsxClosingElement;
+ function createJsxFragment(openingFragment: JsxOpeningFragment, children: readonly JsxChild[], closingFragment: JsxClosingFragment): JsxFragment;
+ function createJsxText(text: string, containsOnlyTriviaWhiteSpaces?: boolean): JsxText;
+ function updateJsxText(node: JsxText, text: string, containsOnlyTriviaWhiteSpaces?: boolean): JsxText;
+ function createJsxOpeningFragment(): JsxOpeningFragment;
+ function createJsxJsxClosingFragment(): JsxClosingFragment;
+ function updateJsxFragment(node: JsxFragment, openingFragment: JsxOpeningFragment, children: readonly JsxChild[], closingFragment: JsxClosingFragment): JsxFragment;
+ function createJsxAttribute(name: Identifier, initializer: StringLiteral | JsxExpression): JsxAttribute;
+ function updateJsxAttribute(node: JsxAttribute, name: Identifier, initializer: StringLiteral | JsxExpression): JsxAttribute;
+ function createJsxAttributes(properties: readonly JsxAttributeLike[]): JsxAttributes;
+ function updateJsxAttributes(node: JsxAttributes, properties: readonly JsxAttributeLike[]): JsxAttributes;
+ function createJsxSpreadAttribute(expression: Expression): JsxSpreadAttribute;
+ function updateJsxSpreadAttribute(node: JsxSpreadAttribute, expression: Expression): JsxSpreadAttribute;
+ function createJsxExpression(dotDotDotToken: DotDotDotToken | undefined, expression: Expression | undefined): JsxExpression;
+ function updateJsxExpression(node: JsxExpression, expression: Expression | undefined): JsxExpression;
+ function createCaseClause(expression: Expression, statements: readonly Statement[]): CaseClause;
+ function updateCaseClause(node: CaseClause, expression: Expression, statements: readonly Statement[]): CaseClause;
+ function createDefaultClause(statements: readonly Statement[]): DefaultClause;
+ function updateDefaultClause(node: DefaultClause, statements: readonly Statement[]): DefaultClause;
+ function createHeritageClause(token: HeritageClause["token"], types: readonly ExpressionWithTypeArguments[]): HeritageClause;
+ function updateHeritageClause(node: HeritageClause, types: readonly ExpressionWithTypeArguments[]): HeritageClause;
+ function createCatchClause(variableDeclaration: string | VariableDeclaration | undefined, block: Block): CatchClause;
+ function updateCatchClause(node: CatchClause, variableDeclaration: VariableDeclaration | undefined, block: Block): CatchClause;
+ function createPropertyAssignment(name: string | PropertyName, initializer: Expression): PropertyAssignment;
+ function updatePropertyAssignment(node: PropertyAssignment, name: PropertyName, initializer: Expression): PropertyAssignment;
+ function createShorthandPropertyAssignment(name: string | Identifier, objectAssignmentInitializer?: Expression): ShorthandPropertyAssignment;
+ function updateShorthandPropertyAssignment(node: ShorthandPropertyAssignment, name: Identifier, objectAssignmentInitializer: Expression | undefined): ShorthandPropertyAssignment;
+ function createSpreadAssignment(expression: Expression): SpreadAssignment;
+ function updateSpreadAssignment(node: SpreadAssignment, expression: Expression): SpreadAssignment;
+ function createEnumMember(name: string | PropertyName, initializer?: Expression): EnumMember;
+ function updateEnumMember(node: EnumMember, name: PropertyName, initializer: Expression | undefined): EnumMember;
+ function updateSourceFileNode(node: SourceFile, statements: readonly Statement[], isDeclarationFile?: boolean, referencedFiles?: SourceFile["referencedFiles"], typeReferences?: SourceFile["typeReferenceDirectives"], hasNoDefaultLib?: boolean, libReferences?: SourceFile["libReferenceDirectives"]): SourceFile;
+ /**
+ * Creates a shallow, memberwise clone of a node for mutation.
+ */
+ function getMutableClone<T extends Node>(node: T): T;
+ /**
+ * Creates a synthetic statement to act as a placeholder for a not-emitted statement in
+ * order to preserve comments.
+ *
+ * @param original The original statement.
+ */
+ function createNotEmittedStatement(original: Node): NotEmittedStatement;
+ /**
+ * Creates a synthetic expression to act as a placeholder for a not-emitted expression in
+ * order to preserve comments or sourcemap positions.
+ *
+ * @param expression The inner expression to emit.
+ * @param original The original outer expression.
+ * @param location The location for the expression. Defaults to the positions from "original" if provided.
+ */
+ function createPartiallyEmittedExpression(expression: Expression, original?: Node): PartiallyEmittedExpression;
+ function updatePartiallyEmittedExpression(node: PartiallyEmittedExpression, expression: Expression): PartiallyEmittedExpression;
+ function createCommaList(elements: readonly Expression[]): CommaListExpression;
+ function updateCommaList(node: CommaListExpression, elements: readonly Expression[]): CommaListExpression;
+ function createBundle(sourceFiles: readonly SourceFile[], prepends?: readonly (UnparsedSource | InputFiles)[]): Bundle;
+ function createUnparsedSourceFile(text: string): UnparsedSource;
+ function createUnparsedSourceFile(inputFile: InputFiles, type: "js" | "dts", stripInternal?: boolean): UnparsedSource;
+ function createUnparsedSourceFile(text: string, mapPath: string | undefined, map: string | undefined): UnparsedSource;
+ function createInputFiles(javascriptText: string, declarationText: string): InputFiles;
+ function createInputFiles(readFileText: (path: string) => string | undefined, javascriptPath: string, javascriptMapPath: string | undefined, declarationPath: string, declarationMapPath: string | undefined, buildInfoPath: string | undefined): InputFiles;
+ function createInputFiles(javascriptText: string, declarationText: string, javascriptMapPath: string | undefined, javascriptMapText: string | undefined, declarationMapPath: string | undefined, declarationMapText: string | undefined): InputFiles;
+ function updateBundle(node: Bundle, sourceFiles: readonly SourceFile[], prepends?: readonly (UnparsedSource | InputFiles)[]): Bundle;
+ function createImmediatelyInvokedFunctionExpression(statements: readonly Statement[]): CallExpression;
+ function createImmediatelyInvokedFunctionExpression(statements: readonly Statement[], param: ParameterDeclaration, paramValue: Expression): CallExpression;
+ function createImmediatelyInvokedArrowFunction(statements: readonly Statement[]): CallExpression;
+ function createImmediatelyInvokedArrowFunction(statements: readonly Statement[], param: ParameterDeclaration, paramValue: Expression): CallExpression;
+ function createComma(left: Expression, right: Expression): Expression;
+ function createLessThan(left: Expression, right: Expression): Expression;
+ function createAssignment(left: ObjectLiteralExpression | ArrayLiteralExpression, right: Expression): DestructuringAssignment;
+ function createAssignment(left: Expression, right: Expression): BinaryExpression;
+ function createStrictEquality(left: Expression, right: Expression): BinaryExpression;
+ function createStrictInequality(left: Expression, right: Expression): BinaryExpression;
+ function createAdd(left: Expression, right: Expression): BinaryExpression;
+ function createSubtract(left: Expression, right: Expression): BinaryExpression;
+ function createPostfixIncrement(operand: Expression): PostfixUnaryExpression;
+ function createLogicalAnd(left: Expression, right: Expression): BinaryExpression;
+ function createLogicalOr(left: Expression, right: Expression): BinaryExpression;
+ function createNullishCoalesce(left: Expression, right: Expression): BinaryExpression;
+ function createLogicalNot(operand: Expression): PrefixUnaryExpression;
+ function createVoidZero(): VoidExpression;
+ function createExportDefault(expression: Expression): ExportAssignment;
+ function createExternalModuleExport(exportName: Identifier): ExportDeclaration;
+ /**
+ * Clears any EmitNode entries from parse-tree nodes.
+ * @param sourceFile A source file.
+ */
+ function disposeEmitNodes(sourceFile: SourceFile): void;
+ function setTextRange<T extends TextRange>(range: T, location: TextRange | undefined): T;
+ /**
+ * Sets flags that control emit behavior of a node.
+ */
+ function setEmitFlags<T extends Node>(node: T, emitFlags: EmitFlags): T;
+ /**
+ * Gets a custom text range to use when emitting source maps.
+ */
+ function getSourceMapRange(node: Node): SourceMapRange;
+ /**
+ * Sets a custom text range to use when emitting source maps.
+ */
+ function setSourceMapRange<T extends Node>(node: T, range: SourceMapRange | undefined): T;
+ /**
+ * Create an external source map source file reference
+ */
+ function createSourceMapSource(fileName: string, text: string, skipTrivia?: (pos: number) => number): SourceMapSource;
+ /**
+ * Gets the TextRange to use for source maps for a token of a node.
+ */
+ function getTokenSourceMapRange(node: Node, token: SyntaxKind): SourceMapRange | undefined;
+ /**
+ * Sets the TextRange to use for source maps for a token of a node.
+ */
+ function setTokenSourceMapRange<T extends Node>(node: T, token: SyntaxKind, range: SourceMapRange | undefined): T;
+ /**
+ * Gets a custom text range to use when emitting comments.
+ */
+ function getCommentRange(node: Node): TextRange;
+ /**
+ * Sets a custom text range to use when emitting comments.
+ */
+ function setCommentRange<T extends Node>(node: T, range: TextRange): T;
+ function getSyntheticLeadingComments(node: Node): SynthesizedComment[] | undefined;
+ function setSyntheticLeadingComments<T extends Node>(node: T, comments: SynthesizedComment[] | undefined): T;
+ function addSyntheticLeadingComment<T extends Node>(node: T, kind: SyntaxKind.SingleLineCommentTrivia | SyntaxKind.MultiLineCommentTrivia, text: string, hasTrailingNewLine?: boolean): T;
+ function getSyntheticTrailingComments(node: Node): SynthesizedComment[] | undefined;
+ function setSyntheticTrailingComments<T extends Node>(node: T, comments: SynthesizedComment[] | undefined): T;
+ function addSyntheticTrailingComment<T extends Node>(node: T, kind: SyntaxKind.SingleLineCommentTrivia | SyntaxKind.MultiLineCommentTrivia, text: string, hasTrailingNewLine?: boolean): T;
+ function moveSyntheticComments<T extends Node>(node: T, original: Node): T;
+ /**
+ * Gets the constant value to emit for an expression.
+ */
+ function getConstantValue(node: PropertyAccessExpression | ElementAccessExpression): string | number | undefined;
+ /**
+ * Sets the constant value to emit for an expression.
+ */
+ function setConstantValue(node: PropertyAccessExpression | ElementAccessExpression, value: string | number): PropertyAccessExpression | ElementAccessExpression;
+ /**
+ * Adds an EmitHelper to a node.
+ */
+ function addEmitHelper<T extends Node>(node: T, helper: EmitHelper): T;
+ /**
+ * Add EmitHelpers to a node.
+ */
+ function addEmitHelpers<T extends Node>(node: T, helpers: EmitHelper[] | undefined): T;
+ /**
+ * Removes an EmitHelper from a node.
+ */
+ function removeEmitHelper(node: Node, helper: EmitHelper): boolean;
+ /**
+ * Gets the EmitHelpers of a node.
+ */
+ function getEmitHelpers(node: Node): EmitHelper[] | undefined;
+ /**
+ * Moves matching emit helpers from a source node to a target node.
+ */
+ function moveEmitHelpers(source: Node, target: Node, predicate: (helper: EmitHelper) => boolean): void;
+ function setOriginalNode<T extends Node>(node: T, original: Node | undefined): T;
+}
+declare namespace ts {
+ /**
+ * Visits a Node using the supplied visitor, possibly returning a new Node in its place.
+ *
+ * @param node The Node to visit.
+ * @param visitor The callback used to visit the Node.
+ * @param test A callback to execute to verify the Node is valid.
+ * @param lift An optional callback to execute to lift a NodeArray into a valid Node.
+ */
+ function visitNode<T extends Node>(node: T | undefined, visitor: Visitor | undefined, test?: (node: Node) => boolean, lift?: (node: NodeArray<Node>) => T): T;
+ /**
+ * Visits a Node using the supplied visitor, possibly returning a new Node in its place.
+ *
+ * @param node The Node to visit.
+ * @param visitor The callback used to visit the Node.
+ * @param test A callback to execute to verify the Node is valid.
+ * @param lift An optional callback to execute to lift a NodeArray into a valid Node.
+ */
+ function visitNode<T extends Node>(node: T | undefined, visitor: Visitor | undefined, test?: (node: Node) => boolean, lift?: (node: NodeArray<Node>) => T): T | undefined;
+ /**
+ * Visits a NodeArray using the supplied visitor, possibly returning a new NodeArray in its place.
+ *
+ * @param nodes The NodeArray to visit.
+ * @param visitor The callback used to visit a Node.
+ * @param test A node test to execute for each node.
+ * @param start An optional value indicating the starting offset at which to start visiting.
+ * @param count An optional value indicating the maximum number of nodes to visit.
+ */
+ function visitNodes<T extends Node>(nodes: NodeArray<T> | undefined, visitor: Visitor, test?: (node: Node) => boolean, start?: number, count?: number): NodeArray<T>;
+ /**
+ * Visits a NodeArray using the supplied visitor, possibly returning a new NodeArray in its place.
+ *
+ * @param nodes The NodeArray to visit.
+ * @param visitor The callback used to visit a Node.
+ * @param test A node test to execute for each node.
+ * @param start An optional value indicating the starting offset at which to start visiting.
+ * @param count An optional value indicating the maximum number of nodes to visit.
+ */
+ function visitNodes<T extends Node>(nodes: NodeArray<T> | undefined, visitor: Visitor, test?: (node: Node) => boolean, start?: number, count?: number): NodeArray<T> | undefined;
+ /**
+ * Starts a new lexical environment and visits a statement list, ending the lexical environment
+ * and merging hoisted declarations upon completion.
+ */
+ function visitLexicalEnvironment(statements: NodeArray<Statement>, visitor: Visitor, context: TransformationContext, start?: number, ensureUseStrict?: boolean): NodeArray<Statement>;
+ /**
+ * Starts a new lexical environment and visits a parameter list, suspending the lexical
+ * environment upon completion.
+ */
+ function visitParameterList(nodes: NodeArray<ParameterDeclaration>, visitor: Visitor, context: TransformationContext, nodesVisitor?: <T extends Node>(nodes: NodeArray<T>, visitor: Visitor, test?: (node: Node) => boolean, start?: number, count?: number) => NodeArray<T>): NodeArray<ParameterDeclaration>;
+ function visitParameterList(nodes: NodeArray<ParameterDeclaration> | undefined, visitor: Visitor, context: TransformationContext, nodesVisitor?: <T extends Node>(nodes: NodeArray<T> | undefined, visitor: Visitor, test?: (node: Node) => boolean, start?: number, count?: number) => NodeArray<T> | undefined): NodeArray<ParameterDeclaration> | undefined;
+ /**
+ * Resumes a suspended lexical environment and visits a function body, ending the lexical
+ * environment and merging hoisted declarations upon completion.
+ */
+ function visitFunctionBody(node: FunctionBody, visitor: Visitor, context: TransformationContext): FunctionBody;
+ /**
+ * Resumes a suspended lexical environment and visits a function body, ending the lexical
+ * environment and merging hoisted declarations upon completion.
+ */
+ function visitFunctionBody(node: FunctionBody | undefined, visitor: Visitor, context: TransformationContext): FunctionBody | undefined;
+ /**
+ * Resumes a suspended lexical environment and visits a concise body, ending the lexical
+ * environment and merging hoisted declarations upon completion.
+ */
+ function visitFunctionBody(node: ConciseBody, visitor: Visitor, context: TransformationContext): ConciseBody;
+ /**
+ * Visits each child of a Node using the supplied visitor, possibly returning a new Node of the same kind in its place.
+ *
+ * @param node The Node whose children will be visited.
+ * @param visitor The callback used to visit each child.
+ * @param context A lexical environment context for the visitor.
+ */
+ function visitEachChild<T extends Node>(node: T, visitor: Visitor, context: TransformationContext): T;
+ /**
+ * Visits each child of a Node using the supplied visitor, possibly returning a new Node of the same kind in its place.
+ *
+ * @param node The Node whose children will be visited.
+ * @param visitor The callback used to visit each child.
+ * @param context A lexical environment context for the visitor.
+ */
+ function visitEachChild<T extends Node>(node: T | undefined, visitor: Visitor, context: TransformationContext, nodesVisitor?: typeof visitNodes, tokenVisitor?: Visitor): T | undefined;
+}
+declare namespace ts {
+ function getTsBuildInfoEmitOutputFilePath(options: CompilerOptions): string | undefined;
+ function getOutputFileNames(commandLine: ParsedCommandLine, inputFileName: string, ignoreCase: boolean): readonly string[];
+ function createPrinter(printerOptions?: PrinterOptions, handlers?: PrintHandlers): Printer;
+}
+declare namespace ts {
+ export function findConfigFile(searchPath: string, fileExists: (fileName: string) => boolean, configName?: string): string | undefined;
+ export function resolveTripleslashReference(moduleName: string, containingFile: string): string;
+ export function createCompilerHost(options: CompilerOptions, setParentNodes?: boolean): CompilerHost;
+ export function getPreEmitDiagnostics(program: Program, sourceFile?: SourceFile, cancellationToken?: CancellationToken): readonly Diagnostic[];
+ export interface FormatDiagnosticsHost {
+ getCurrentDirectory(): string;
+ getCanonicalFileName(fileName: string): string;
+ getNewLine(): string;
+ }
+ export function formatDiagnostics(diagnostics: readonly Diagnostic[], host: FormatDiagnosticsHost): string;
+ export function formatDiagnostic(diagnostic: Diagnostic, host: FormatDiagnosticsHost): string;
+ export function formatDiagnosticsWithColorAndContext(diagnostics: readonly Diagnostic[], host: FormatDiagnosticsHost): string;
+ export function flattenDiagnosticMessageText(diag: string | DiagnosticMessageChain | undefined, newLine: string, indent?: number): string;
+ export function getConfigFileParsingDiagnostics(configFileParseResult: ParsedCommandLine): readonly Diagnostic[];
+ /**
+ * Create a new 'Program' instance. A Program is an immutable collection of 'SourceFile's and a 'CompilerOptions'
+ * that represent a compilation unit.
+ *
+ * Creating a program proceeds from a set of root files, expanding the set of inputs by following imports and
+ * triple-slash-reference-path directives transitively. '@types' and triple-slash-reference-types are also pulled in.
+ *
+ * @param createProgramOptions - The options for creating a program.
+ * @returns A 'Program' object.
+ */
+ export function createProgram(createProgramOptions: CreateProgramOptions): Program;
+ /**
+ * Create a new 'Program' instance. A Program is an immutable collection of 'SourceFile's and a 'CompilerOptions'
+ * that represent a compilation unit.
+ *
+ * Creating a program proceeds from a set of root files, expanding the set of inputs by following imports and
+ * triple-slash-reference-path directives transitively. '@types' and triple-slash-reference-types are also pulled in.
+ *
+ * @param rootNames - A set of root files.
+ * @param options - The compiler options which should be used.
+ * @param host - The host interacts with the underlying file system.
+ * @param oldProgram - Reuses an old program structure.
+ * @param configFileParsingDiagnostics - error during config file parsing
+ * @returns A 'Program' object.
+ */
+ export function createProgram(rootNames: readonly string[], options: CompilerOptions, host?: CompilerHost, oldProgram?: Program, configFileParsingDiagnostics?: readonly Diagnostic[]): Program;
+ /** @deprecated */ export interface ResolveProjectReferencePathHost {
+ fileExists(fileName: string): boolean;
+ }
+ /**
+ * Returns the target config filename of a project reference.
+ * Note: The file might not exist.
+ */
+ export function resolveProjectReferencePath(ref: ProjectReference): ResolvedConfigFileName;
+ /** @deprecated */ export function resolveProjectReferencePath(host: ResolveProjectReferencePathHost, ref: ProjectReference): ResolvedConfigFileName;
+ export {};
+}
+declare namespace ts {
+ interface EmitOutput {
+ outputFiles: OutputFile[];
+ emitSkipped: boolean;
+ }
+ interface OutputFile {
+ name: string;
+ writeByteOrderMark: boolean;
+ text: string;
+ }
+}
+declare namespace ts {
+ type AffectedFileResult<T> = {
+ result: T;
+ affected: SourceFile | Program;
+ } | undefined;
+ interface BuilderProgramHost {
+ /**
+ * return true if file names are treated with case sensitivity
+ */
+ useCaseSensitiveFileNames(): boolean;
+ /**
+ * If provided this would be used this hash instead of actual file shape text for detecting changes
+ */
+ createHash?: (data: string) => string;
+ /**
+ * When emit or emitNextAffectedFile are called without writeFile,
+ * this callback if present would be used to write files
+ */
+ writeFile?: WriteFileCallback;
+ }
+ /**
+ * Builder to manage the program state changes
+ */
+ interface BuilderProgram {
+ /**
+ * Returns current program
+ */
+ getProgram(): Program;
+ /**
+ * Get compiler options of the program
+ */
+ getCompilerOptions(): CompilerOptions;
+ /**
+ * Get the source file in the program with file name
+ */
+ getSourceFile(fileName: string): SourceFile | undefined;
+ /**
+ * Get a list of files in the program
+ */
+ getSourceFiles(): readonly SourceFile[];
+ /**
+ * Get the diagnostics for compiler options
+ */
+ getOptionsDiagnostics(cancellationToken?: CancellationToken): readonly Diagnostic[];
+ /**
+ * Get the diagnostics that dont belong to any file
+ */
+ getGlobalDiagnostics(cancellationToken?: CancellationToken): readonly Diagnostic[];
+ /**
+ * Get the diagnostics from config file parsing
+ */
+ getConfigFileParsingDiagnostics(): readonly Diagnostic[];
+ /**
+ * Get the syntax diagnostics, for all source files if source file is not supplied
+ */
+ getSyntacticDiagnostics(sourceFile?: SourceFile, cancellationToken?: CancellationToken): readonly Diagnostic[];
+ /**
+ * Get the declaration diagnostics, for all source files if source file is not supplied
+ */
+ getDeclarationDiagnostics(sourceFile?: SourceFile, cancellationToken?: CancellationToken): readonly DiagnosticWithLocation[];
+ /**
+ * Get all the dependencies of the file
+ */
+ getAllDependencies(sourceFile: SourceFile): readonly string[];
+ /**
+ * Gets the semantic diagnostics from the program corresponding to this state of file (if provided) or whole program
+ * The semantic diagnostics are cached and managed here
+ * Note that it is assumed that when asked about semantic diagnostics through this API,
+ * the file has been taken out of affected files so it is safe to use cache or get from program and cache the diagnostics
+ * In case of SemanticDiagnosticsBuilderProgram if the source file is not provided,
+ * it will iterate through all the affected files, to ensure that cache stays valid and yet provide a way to get all semantic diagnostics
+ */
+ getSemanticDiagnostics(sourceFile?: SourceFile, cancellationToken?: CancellationToken): readonly Diagnostic[];
+ /**
+ * Emits the JavaScript and declaration files.
+ * When targetSource file is specified, emits the files corresponding to that source file,
+ * otherwise for the whole program.
+ * In case of EmitAndSemanticDiagnosticsBuilderProgram, when targetSourceFile is specified,
+ * it is assumed that that file is handled from affected file list. If targetSourceFile is not specified,
+ * it will only emit all the affected files instead of whole program
+ *
+ * The first of writeFile if provided, writeFile of BuilderProgramHost if provided, writeFile of compiler host
+ * in that order would be used to write the files
+ */
+ emit(targetSourceFile?: SourceFile, writeFile?: WriteFileCallback, cancellationToken?: CancellationToken, emitOnlyDtsFiles?: boolean, customTransformers?: CustomTransformers): EmitResult;
+ /**
+ * Get the current directory of the program
+ */
+ getCurrentDirectory(): string;
+ }
+ /**
+ * The builder that caches the semantic diagnostics for the program and handles the changed files and affected files
+ */
+ interface SemanticDiagnosticsBuilderProgram extends BuilderProgram {
+ /**
+ * Gets the semantic diagnostics from the program for the next affected file and caches it
+ * Returns undefined if the iteration is complete
+ */
+ getSemanticDiagnosticsOfNextAffectedFile(cancellationToken?: CancellationToken, ignoreSourceFile?: (sourceFile: SourceFile) => boolean): AffectedFileResult<readonly Diagnostic[]>;
+ }
+ /**
+ * The builder that can handle the changes in program and iterate through changed file to emit the files
+ * The semantic diagnostics are cached per file and managed by clearing for the changed/affected files
+ */
+ interface EmitAndSemanticDiagnosticsBuilderProgram extends SemanticDiagnosticsBuilderProgram {
+ /**
+ * Emits the next affected file's emit result (EmitResult and sourceFiles emitted) or returns undefined if iteration is complete
+ * The first of writeFile if provided, writeFile of BuilderProgramHost if provided, writeFile of compiler host
+ * in that order would be used to write the files
+ */
+ emitNextAffectedFile(writeFile?: WriteFileCallback, cancellationToken?: CancellationToken, emitOnlyDtsFiles?: boolean, customTransformers?: CustomTransformers): AffectedFileResult<EmitResult>;
+ }
+ /**
+ * Create the builder to manage semantic diagnostics and cache them
+ */
+ function createSemanticDiagnosticsBuilderProgram(newProgram: Program, host: BuilderProgramHost, oldProgram?: SemanticDiagnosticsBuilderProgram, configFileParsingDiagnostics?: readonly Diagnostic[]): SemanticDiagnosticsBuilderProgram;
+ function createSemanticDiagnosticsBuilderProgram(rootNames: readonly string[] | undefined, options: CompilerOptions | undefined, host?: CompilerHost, oldProgram?: SemanticDiagnosticsBuilderProgram, configFileParsingDiagnostics?: readonly Diagnostic[], projectReferences?: readonly ProjectReference[]): SemanticDiagnosticsBuilderProgram;
+ /**
+ * Create the builder that can handle the changes in program and iterate through changed files
+ * to emit the those files and manage semantic diagnostics cache as well
+ */
+ function createEmitAndSemanticDiagnosticsBuilderProgram(newProgram: Program, host: BuilderProgramHost, oldProgram?: EmitAndSemanticDiagnosticsBuilderProgram, configFileParsingDiagnostics?: readonly Diagnostic[]): EmitAndSemanticDiagnosticsBuilderProgram;
+ function createEmitAndSemanticDiagnosticsBuilderProgram(rootNames: readonly string[] | undefined, options: CompilerOptions | undefined, host?: CompilerHost, oldProgram?: EmitAndSemanticDiagnosticsBuilderProgram, configFileParsingDiagnostics?: readonly Diagnostic[], projectReferences?: readonly ProjectReference[]): EmitAndSemanticDiagnosticsBuilderProgram;
+ /**
+ * Creates a builder thats just abstraction over program and can be used with watch
+ */
+ function createAbstractBuilder(newProgram: Program, host: BuilderProgramHost, oldProgram?: BuilderProgram, configFileParsingDiagnostics?: readonly Diagnostic[]): BuilderProgram;
+ function createAbstractBuilder(rootNames: readonly string[] | undefined, options: CompilerOptions | undefined, host?: CompilerHost, oldProgram?: BuilderProgram, configFileParsingDiagnostics?: readonly Diagnostic[], projectReferences?: readonly ProjectReference[]): BuilderProgram;
+}
+declare namespace ts {
+ interface ReadBuildProgramHost {
+ useCaseSensitiveFileNames(): boolean;
+ getCurrentDirectory(): string;
+ readFile(fileName: string): string | undefined;
+ }
+ function readBuilderProgram(compilerOptions: CompilerOptions, host: ReadBuildProgramHost): EmitAndSemanticDiagnosticsBuilderProgram | undefined;
+ function createIncrementalCompilerHost(options: CompilerOptions, system?: System): CompilerHost;
+ interface IncrementalProgramOptions<T extends BuilderProgram> {
+ rootNames: readonly string[];
+ options: CompilerOptions;
+ configFileParsingDiagnostics?: readonly Diagnostic[];
+ projectReferences?: readonly ProjectReference[];
+ host?: CompilerHost;
+ createProgram?: CreateProgram<T>;
+ }
+ function createIncrementalProgram<T extends BuilderProgram = EmitAndSemanticDiagnosticsBuilderProgram>({ rootNames, options, configFileParsingDiagnostics, projectReferences, host, createProgram }: IncrementalProgramOptions<T>): T;
+ type WatchStatusReporter = (diagnostic: Diagnostic, newLine: string, options: CompilerOptions, errorCount?: number) => void;
+ /** Create the program with rootNames and options, if they are undefined, oldProgram and new configFile diagnostics create new program */
+ type CreateProgram<T extends BuilderProgram> = (rootNames: readonly string[] | undefined, options: CompilerOptions | undefined, host?: CompilerHost, oldProgram?: T, configFileParsingDiagnostics?: readonly Diagnostic[], projectReferences?: readonly ProjectReference[] | undefined) => T;
+ /** Host that has watch functionality used in --watch mode */
+ interface WatchHost {
+ /** If provided, called with Diagnostic message that informs about change in watch status */
+ onWatchStatusChange?(diagnostic: Diagnostic, newLine: string, options: CompilerOptions, errorCount?: number): void;
+ /** Used to watch changes in source files, missing files needed to update the program or config file */
+ watchFile(path: string, callback: FileWatcherCallback, pollingInterval?: number, options?: CompilerOptions): FileWatcher;
+ /** Used to watch resolved module's failed lookup locations, config file specs, type roots where auto type reference directives are added */
+ watchDirectory(path: string, callback: DirectoryWatcherCallback, recursive?: boolean, options?: CompilerOptions): FileWatcher;
+ /** If provided, will be used to set delayed compilation, so that multiple changes in short span are compiled together */
+ setTimeout?(callback: (...args: any[]) => void, ms: number, ...args: any[]): any;
+ /** If provided, will be used to reset existing delayed compilation */
+ clearTimeout?(timeoutId: any): void;
+ }
+ interface ProgramHost<T extends BuilderProgram> {
+ /**
+ * Used to create the program when need for program creation or recreation detected
+ */
+ createProgram: CreateProgram<T>;
+ useCaseSensitiveFileNames(): boolean;
+ getNewLine(): string;
+ getCurrentDirectory(): string;
+ getDefaultLibFileName(options: CompilerOptions): string;
+ getDefaultLibLocation?(): string;
+ createHash?(data: string): string;
+ /**
+ * Use to check file presence for source files and
+ * if resolveModuleNames is not provided (complier is in charge of module resolution) then module files as well
+ */
+ fileExists(path: string): boolean;
+ /**
+ * Use to read file text for source files and
+ * if resolveModuleNames is not provided (complier is in charge of module resolution) then module files as well
+ */
+ readFile(path: string, encoding?: string): string | undefined;
+ /** If provided, used for module resolution as well as to handle directory structure */
+ directoryExists?(path: string): boolean;
+ /** If provided, used in resolutions as well as handling directory structure */
+ getDirectories?(path: string): string[];
+ /** If provided, used to cache and handle directory structure modifications */
+ readDirectory?(path: string, extensions?: readonly string[], exclude?: readonly string[], include?: readonly string[], depth?: number): string[];
+ /** Symbol links resolution */
+ realpath?(path: string): string;
+ /** If provided would be used to write log about compilation */
+ trace?(s: string): void;
+ /** If provided is used to get the environment variable */
+ getEnvironmentVariable?(name: string): string | undefined;
+ /** If provided, used to resolve the module names, otherwise typescript's default module resolution */
+ resolveModuleNames?(moduleNames: string[], containingFile: string, reusedNames: string[] | undefined, redirectedReference: ResolvedProjectReference | undefined, options: CompilerOptions): (ResolvedModule | undefined)[];
+ /** If provided, used to resolve type reference directives, otherwise typescript's default resolution */
+ resolveTypeReferenceDirectives?(typeReferenceDirectiveNames: string[], containingFile: string, redirectedReference: ResolvedProjectReference | undefined, options: CompilerOptions): (ResolvedTypeReferenceDirective | undefined)[];
+ }
+ interface WatchCompilerHost<T extends BuilderProgram> extends ProgramHost<T>, WatchHost {
+ /** Instead of using output d.ts file from project reference, use its source file */
+ useSourceOfProjectReferenceRedirect?(): boolean;
+ /** If provided, callback to invoke after every new program creation */
+ afterProgramCreate?(program: T): void;
+ }
+ /**
+ * Host to create watch with root files and options
+ */
+ interface WatchCompilerHostOfFilesAndCompilerOptions<T extends BuilderProgram> extends WatchCompilerHost<T> {
+ /** root files to use to generate program */
+ rootFiles: string[];
+ /** Compiler options */
+ options: CompilerOptions;
+ watchOptions?: WatchOptions;
+ /** Project References */
+ projectReferences?: readonly ProjectReference[];
+ }
+ /**
+ * Host to create watch with config file
+ */
+ interface WatchCompilerHostOfConfigFile<T extends BuilderProgram> extends WatchCompilerHost<T>, ConfigFileDiagnosticsReporter {
+ /** Name of the config file to compile */
+ configFileName: string;
+ /** Options to extend */
+ optionsToExtend?: CompilerOptions;
+ watchOptionsToExtend?: WatchOptions;
+ extraFileExtensions?: readonly FileExtensionInfo[];
+ /**
+ * Used to generate source file names from the config file and its include, exclude, files rules
+ * and also to cache the directory stucture
+ */
+ readDirectory(path: string, extensions?: readonly string[], exclude?: readonly string[], include?: readonly string[], depth?: number): string[];
+ }
+ interface Watch<T> {
+ /** Synchronize with host and get updated program */
+ getProgram(): T;
+ /** Closes the watch */
+ close(): void;
+ }
+ /**
+ * Creates the watch what generates program using the config file
+ */
+ interface WatchOfConfigFile<T> extends Watch<T> {
+ }
+ /**
+ * Creates the watch that generates program using the root files and compiler options
+ */
+ interface WatchOfFilesAndCompilerOptions<T> extends Watch<T> {
+ /** Updates the root files in the program, only if this is not config file compilation */
+ updateRootFileNames(fileNames: string[]): void;
+ }
+ /**
+ * Create the watch compiler host for either configFile or fileNames and its options
+ */
+ function createWatchCompilerHost<T extends BuilderProgram>(configFileName: string, optionsToExtend: CompilerOptions | undefined, system: System, createProgram?: CreateProgram<T>, reportDiagnostic?: DiagnosticReporter, reportWatchStatus?: WatchStatusReporter, watchOptionsToExtend?: WatchOptions, extraFileExtensions?: readonly FileExtensionInfo[]): WatchCompilerHostOfConfigFile<T>;
+ function createWatchCompilerHost<T extends BuilderProgram>(rootFiles: string[], options: CompilerOptions, system: System, createProgram?: CreateProgram<T>, reportDiagnostic?: DiagnosticReporter, reportWatchStatus?: WatchStatusReporter, projectReferences?: readonly ProjectReference[], watchOptions?: WatchOptions): WatchCompilerHostOfFilesAndCompilerOptions<T>;
+ /**
+ * Creates the watch from the host for root files and compiler options
+ */
+ function createWatchProgram<T extends BuilderProgram>(host: WatchCompilerHostOfFilesAndCompilerOptions<T>): WatchOfFilesAndCompilerOptions<T>;
+ /**
+ * Creates the watch from the host for config file
+ */
+ function createWatchProgram<T extends BuilderProgram>(host: WatchCompilerHostOfConfigFile<T>): WatchOfConfigFile<T>;
+}
+declare namespace ts {
+ interface BuildOptions {
+ dry?: boolean;
+ force?: boolean;
+ verbose?: boolean;
+ incremental?: boolean;
+ assumeChangesOnlyAffectDirectDependencies?: boolean;
+ traceResolution?: boolean;
+ [option: string]: CompilerOptionsValue | undefined;
+ }
+ type ReportEmitErrorSummary = (errorCount: number) => void;
+ interface SolutionBuilderHostBase<T extends BuilderProgram> extends ProgramHost<T> {
+ createDirectory?(path: string): void;
+ /**
+ * Should provide create directory and writeFile if done of invalidatedProjects is not invoked with
+ * writeFileCallback
+ */
+ writeFile?(path: string, data: string, writeByteOrderMark?: boolean): void;
+ getModifiedTime(fileName: string): Date | undefined;
+ setModifiedTime(fileName: string, date: Date): void;
+ deleteFile(fileName: string): void;
+ getParsedCommandLine?(fileName: string): ParsedCommandLine | undefined;
+ reportDiagnostic: DiagnosticReporter;
+ reportSolutionBuilderStatus: DiagnosticReporter;
+ afterProgramEmitAndDiagnostics?(program: T): void;
+ }
+ interface SolutionBuilderHost<T extends BuilderProgram> extends SolutionBuilderHostBase<T> {
+ reportErrorSummary?: ReportEmitErrorSummary;
+ }
+ interface SolutionBuilderWithWatchHost<T extends BuilderProgram> extends SolutionBuilderHostBase<T>, WatchHost {
+ }
+ interface SolutionBuilder<T extends BuilderProgram> {
+ build(project?: string, cancellationToken?: CancellationToken): ExitStatus;
+ clean(project?: string): ExitStatus;
+ buildReferences(project: string, cancellationToken?: CancellationToken): ExitStatus;
+ cleanReferences(project?: string): ExitStatus;
+ getNextInvalidatedProject(cancellationToken?: CancellationToken): InvalidatedProject<T> | undefined;
+ }
+ /**
+ * Create a function that reports watch status by writing to the system and handles the formating of the diagnostic
+ */
+ function createBuilderStatusReporter(system: System, pretty?: boolean): DiagnosticReporter;
+ function createSolutionBuilderHost<T extends BuilderProgram = EmitAndSemanticDiagnosticsBuilderProgram>(system?: System, createProgram?: CreateProgram<T>, reportDiagnostic?: DiagnosticReporter, reportSolutionBuilderStatus?: DiagnosticReporter, reportErrorSummary?: ReportEmitErrorSummary): SolutionBuilderHost<T>;
+ function createSolutionBuilderWithWatchHost<T extends BuilderProgram = EmitAndSemanticDiagnosticsBuilderProgram>(system?: System, createProgram?: CreateProgram<T>, reportDiagnostic?: DiagnosticReporter, reportSolutionBuilderStatus?: DiagnosticReporter, reportWatchStatus?: WatchStatusReporter): SolutionBuilderWithWatchHost<T>;
+ function createSolutionBuilder<T extends BuilderProgram>(host: SolutionBuilderHost<T>, rootNames: readonly string[], defaultOptions: BuildOptions): SolutionBuilder<T>;
+ function createSolutionBuilderWithWatch<T extends BuilderProgram>(host: SolutionBuilderWithWatchHost<T>, rootNames: readonly string[], defaultOptions: BuildOptions, baseWatchOptions?: WatchOptions): SolutionBuilder<T>;
+ enum InvalidatedProjectKind {
+ Build = 0,
+ UpdateBundle = 1,
+ UpdateOutputFileStamps = 2
+ }
+ interface InvalidatedProjectBase {
+ readonly kind: InvalidatedProjectKind;
+ readonly project: ResolvedConfigFileName;
+ /**
+ * To dispose this project and ensure that all the necessary actions are taken and state is updated accordingly
+ */
+ done(cancellationToken?: CancellationToken, writeFile?: WriteFileCallback, customTransformers?: CustomTransformers): ExitStatus;
+ getCompilerOptions(): CompilerOptions;
+ getCurrentDirectory(): string;
+ }
+ interface UpdateOutputFileStampsProject extends InvalidatedProjectBase {
+ readonly kind: InvalidatedProjectKind.UpdateOutputFileStamps;
+ updateOutputFileStatmps(): void;
+ }
+ interface BuildInvalidedProject<T extends BuilderProgram> extends InvalidatedProjectBase {
+ readonly kind: InvalidatedProjectKind.Build;
+ getBuilderProgram(): T | undefined;
+ getProgram(): Program | undefined;
+ getSourceFile(fileName: string): SourceFile | undefined;
+ getSourceFiles(): readonly SourceFile[];
+ getOptionsDiagnostics(cancellationToken?: CancellationToken): readonly Diagnostic[];
+ getGlobalDiagnostics(cancellationToken?: CancellationToken): readonly Diagnostic[];
+ getConfigFileParsingDiagnostics(): readonly Diagnostic[];
+ getSyntacticDiagnostics(sourceFile?: SourceFile, cancellationToken?: CancellationToken): readonly Diagnostic[];
+ getAllDependencies(sourceFile: SourceFile): readonly string[];
+ getSemanticDiagnostics(sourceFile?: SourceFile, cancellationToken?: CancellationToken): readonly Diagnostic[];
+ getSemanticDiagnosticsOfNextAffectedFile(cancellationToken?: CancellationToken, ignoreSourceFile?: (sourceFile: SourceFile) => boolean): AffectedFileResult<readonly Diagnostic[]>;
+ emit(targetSourceFile?: SourceFile, writeFile?: WriteFileCallback, cancellationToken?: CancellationToken, emitOnlyDtsFiles?: boolean, customTransformers?: CustomTransformers): EmitResult | undefined;
+ }
+ interface UpdateBundleProject<T extends BuilderProgram> extends InvalidatedProjectBase {
+ readonly kind: InvalidatedProjectKind.UpdateBundle;
+ emit(writeFile?: WriteFileCallback, customTransformers?: CustomTransformers): EmitResult | BuildInvalidedProject<T> | undefined;
+ }
+ type InvalidatedProject<T extends BuilderProgram> = UpdateOutputFileStampsProject | BuildInvalidedProject<T> | UpdateBundleProject<T>;
+}
+declare namespace ts.server {
+ type ActionSet = "action::set";
+ type ActionInvalidate = "action::invalidate";
+ type ActionPackageInstalled = "action::packageInstalled";
+ type EventTypesRegistry = "event::typesRegistry";
+ type EventBeginInstallTypes = "event::beginInstallTypes";
+ type EventEndInstallTypes = "event::endInstallTypes";
+ type EventInitializationFailed = "event::initializationFailed";
+}
+declare namespace ts.server {
+ interface TypingInstallerResponse {
+ readonly kind: ActionSet | ActionInvalidate | EventTypesRegistry | ActionPackageInstalled | EventBeginInstallTypes | EventEndInstallTypes | EventInitializationFailed;
+ }
+ interface TypingInstallerRequestWithProjectName {
+ readonly projectName: string;
+ }
+ interface DiscoverTypings extends TypingInstallerRequestWithProjectName {
+ readonly fileNames: string[];
+ readonly projectRootPath: Path;
+ readonly compilerOptions: CompilerOptions;
+ readonly watchOptions?: WatchOptions;
+ readonly typeAcquisition: TypeAcquisition;
+ readonly unresolvedImports: SortedReadonlyArray<string>;
+ readonly cachePath?: string;
+ readonly kind: "discover";
+ }
+ interface CloseProject extends TypingInstallerRequestWithProjectName {
+ readonly kind: "closeProject";
+ }
+ interface TypesRegistryRequest {
+ readonly kind: "typesRegistry";
+ }
+ interface InstallPackageRequest extends TypingInstallerRequestWithProjectName {
+ readonly kind: "installPackage";
+ readonly fileName: Path;
+ readonly packageName: string;
+ readonly projectRootPath: Path;
+ }
+ interface PackageInstalledResponse extends ProjectResponse {
+ readonly kind: ActionPackageInstalled;
+ readonly success: boolean;
+ readonly message: string;
+ }
+ interface InitializationFailedResponse extends TypingInstallerResponse {
+ readonly kind: EventInitializationFailed;
+ readonly message: string;
+ }
+ interface ProjectResponse extends TypingInstallerResponse {
+ readonly projectName: string;
+ }
+ interface InvalidateCachedTypings extends ProjectResponse {
+ readonly kind: ActionInvalidate;
+ }
+ interface InstallTypes extends ProjectResponse {
+ readonly kind: EventBeginInstallTypes | EventEndInstallTypes;
+ readonly eventId: number;
+ readonly typingsInstallerVersion: string;
+ readonly packagesToInstall: readonly string[];
+ }
+ interface BeginInstallTypes extends InstallTypes {
+ readonly kind: EventBeginInstallTypes;
+ }
+ interface EndInstallTypes extends InstallTypes {
+ readonly kind: EventEndInstallTypes;
+ readonly installSuccess: boolean;
+ }
+ interface SetTypings extends ProjectResponse {
+ readonly typeAcquisition: TypeAcquisition;
+ readonly compilerOptions: CompilerOptions;
+ readonly typings: string[];
+ readonly unresolvedImports: SortedReadonlyArray<string>;
+ readonly kind: ActionSet;
+ }
+}
+declare namespace ts {
+ interface Node {
+ getSourceFile(): SourceFile;
+ getChildCount(sourceFile?: SourceFile): number;
+ getChildAt(index: number, sourceFile?: SourceFile): Node;
+ getChildren(sourceFile?: SourceFile): Node[];
+ getStart(sourceFile?: SourceFile, includeJsDocComment?: boolean): number;
+ getFullStart(): number;
+ getEnd(): number;
+ getWidth(sourceFile?: SourceFileLike): number;
+ getFullWidth(): number;
+ getLeadingTriviaWidth(sourceFile?: SourceFile): number;
+ getFullText(sourceFile?: SourceFile): string;
+ getText(sourceFile?: SourceFile): string;
+ getFirstToken(sourceFile?: SourceFile): Node | undefined;
+ getLastToken(sourceFile?: SourceFile): Node | undefined;
+ forEachChild<T>(cbNode: (node: Node) => T | undefined, cbNodeArray?: (nodes: NodeArray<Node>) => T | undefined): T | undefined;
+ }
+ interface Identifier {
+ readonly text: string;
+ }
+ interface PrivateIdentifier {
+ readonly text: string;
+ }
+ interface Symbol {
+ readonly name: string;
+ getFlags(): SymbolFlags;
+ getEscapedName(): __String;
+ getName(): string;
+ getDeclarations(): Declaration[] | undefined;
+ getDocumentationComment(typeChecker: TypeChecker | undefined): SymbolDisplayPart[];
+ getJsDocTags(): JSDocTagInfo[];
+ }
+ interface Type {
+ getFlags(): TypeFlags;
+ getSymbol(): Symbol | undefined;
+ getProperties(): Symbol[];
+ getProperty(propertyName: string): Symbol | undefined;
+ getApparentProperties(): Symbol[];
+ getCallSignatures(): readonly Signature[];
+ getConstructSignatures(): readonly Signature[];
+ getStringIndexType(): Type | undefined;
+ getNumberIndexType(): Type | undefined;
+ getBaseTypes(): BaseType[] | undefined;
+ getNonNullableType(): Type;
+ getConstraint(): Type | undefined;
+ getDefault(): Type | undefined;
+ isUnion(): this is UnionType;
+ isIntersection(): this is IntersectionType;
+ isUnionOrIntersection(): this is UnionOrIntersectionType;
+ isLiteral(): this is LiteralType;
+ isStringLiteral(): this is StringLiteralType;
+ isNumberLiteral(): this is NumberLiteralType;
+ isTypeParameter(): this is TypeParameter;
+ isClassOrInterface(): this is InterfaceType;
+ isClass(): this is InterfaceType;
+ }
+ interface TypeReference {
+ typeArguments?: readonly Type[];
+ }
+ interface Signature {
+ getDeclaration(): SignatureDeclaration;
+ getTypeParameters(): TypeParameter[] | undefined;
+ getParameters(): Symbol[];
+ getReturnType(): Type;
+ getDocumentationComment(typeChecker: TypeChecker | undefined): SymbolDisplayPart[];
+ getJsDocTags(): JSDocTagInfo[];
+ }
+ interface SourceFile {
+ getLineAndCharacterOfPosition(pos: number): LineAndCharacter;
+ getLineEndOfPosition(pos: number): number;
+ getLineStarts(): readonly number[];
+ getPositionOfLineAndCharacter(line: number, character: number): number;
+ update(newText: string, textChangeRange: TextChangeRange): SourceFile;
+ }
+ interface SourceFileLike {
+ getLineAndCharacterOfPosition(pos: number): LineAndCharacter;
+ }
+ interface SourceMapSource {
+ getLineAndCharacterOfPosition(pos: number): LineAndCharacter;
+ }
+ /**
+ * Represents an immutable snapshot of a script at a specified time.Once acquired, the
+ * snapshot is observably immutable. i.e. the same calls with the same parameters will return
+ * the same values.
+ */
+ interface IScriptSnapshot {
+ /** Gets a portion of the script snapshot specified by [start, end). */
+ getText(start: number, end: number): string;
+ /** Gets the length of this script snapshot. */
+ getLength(): number;
+ /**
+ * Gets the TextChangeRange that describe how the text changed between this text and
+ * an older version. This information is used by the incremental parser to determine
+ * what sections of the script need to be re-parsed. 'undefined' can be returned if the
+ * change range cannot be determined. However, in that case, incremental parsing will
+ * not happen and the entire document will be re - parsed.
+ */
+ getChangeRange(oldSnapshot: IScriptSnapshot): TextChangeRange | undefined;
+ /** Releases all resources held by this script snapshot */
+ dispose?(): void;
+ }
+ namespace ScriptSnapshot {
+ function fromString(text: string): IScriptSnapshot;
+ }
+ interface PreProcessedFileInfo {
+ referencedFiles: FileReference[];
+ typeReferenceDirectives: FileReference[];
+ libReferenceDirectives: FileReference[];
+ importedFiles: FileReference[];
+ ambientExternalModules?: string[];
+ isLibFile: boolean;
+ }
+ interface HostCancellationToken {
+ isCancellationRequested(): boolean;
+ }
+ interface InstallPackageOptions {
+ fileName: Path;
+ packageName: string;
+ }
+ interface LanguageServiceHost extends GetEffectiveTypeRootsHost {
+ getCompilationSettings(): CompilerOptions;
+ getNewLine?(): string;
+ getProjectVersion?(): string;
+ getScriptFileNames(): string[];
+ getScriptKind?(fileName: string): ScriptKind;
+ getScriptVersion(fileName: string): string;
+ getScriptSnapshot(fileName: string): IScriptSnapshot | undefined;
+ getProjectReferences?(): readonly ProjectReference[] | undefined;
+ getLocalizedDiagnosticMessages?(): any;
+ getCancellationToken?(): HostCancellationToken;
+ getCurrentDirectory(): string;
+ getDefaultLibFileName(options: CompilerOptions): string;
+ log?(s: string): void;
+ trace?(s: string): void;
+ error?(s: string): void;
+ useCaseSensitiveFileNames?(): boolean;
+ readDirectory?(path: string, extensions?: readonly string[], exclude?: readonly string[], include?: readonly string[], depth?: number): string[];
+ readFile?(path: string, encoding?: string): string | undefined;
+ realpath?(path: string): string;
+ fileExists?(path: string): boolean;
+ getTypeRootsVersion?(): number;
+ resolveModuleNames?(moduleNames: string[], containingFile: string, reusedNames: string[] | undefined, redirectedReference: ResolvedProjectReference | undefined, options: CompilerOptions): (ResolvedModule | undefined)[];
+ getResolvedModuleWithFailedLookupLocationsFromCache?(modulename: string, containingFile: string): ResolvedModuleWithFailedLookupLocations | undefined;
+ resolveTypeReferenceDirectives?(typeDirectiveNames: string[], containingFile: string, redirectedReference: ResolvedProjectReference | undefined, options: CompilerOptions): (ResolvedTypeReferenceDirective | undefined)[];
+ getDirectories?(directoryName: string): string[];
+ /**
+ * Gets a set of custom transformers to use during emit.
+ */
+ getCustomTransformers?(): CustomTransformers | undefined;
+ isKnownTypesPackageName?(name: string): boolean;
+ installPackage?(options: InstallPackageOptions): Promise<ApplyCodeActionCommandResult>;
+ writeFile?(fileName: string, content: string): void;
+ }
+ type WithMetadata<T> = T & {
+ metadata?: unknown;
+ };
+ interface LanguageService {
+ /** This is used as a part of restarting the language service. */
+ cleanupSemanticCache(): void;
+ /**
+ * Gets errors indicating invalid syntax in a file.
+ *
+ * In English, "this cdeo have, erorrs" is syntactically invalid because it has typos,
+ * grammatical errors, and misplaced punctuation. Likewise, examples of syntax
+ * errors in TypeScript are missing parentheses in an `if` statement, mismatched
+ * curly braces, and using a reserved keyword as a variable name.
+ *
+ * These diagnostics are inexpensive to compute and don't require knowledge of
+ * other files. Note that a non-empty result increases the likelihood of false positives
+ * from `getSemanticDiagnostics`.
+ *
+ * While these represent the majority of syntax-related diagnostics, there are some
+ * that require the type system, which will be present in `getSemanticDiagnostics`.
+ *
+ * @param fileName A path to the file you want syntactic diagnostics for
+ */
+ getSyntacticDiagnostics(fileName: string): DiagnosticWithLocation[];
+ /**
+ * Gets warnings or errors indicating type system issues in a given file.
+ * Requesting semantic diagnostics may start up the type system and
+ * run deferred work, so the first call may take longer than subsequent calls.
+ *
+ * Unlike the other get*Diagnostics functions, these diagnostics can potentially not
+ * include a reference to a source file. Specifically, the first time this is called,
+ * it will return global diagnostics with no associated location.
+ *
+ * To contrast the differences between semantic and syntactic diagnostics, consider the
+ * sentence: "The sun is green." is syntactically correct; those are real English words with
+ * correct sentence structure. However, it is semantically invalid, because it is not true.
+ *
+ * @param fileName A path to the file you want semantic diagnostics for
+ */
+ getSemanticDiagnostics(fileName: string): Diagnostic[];
+ /**
+ * Gets suggestion diagnostics for a specific file. These diagnostics tend to
+ * proactively suggest refactors, as opposed to diagnostics that indicate
+ * potentially incorrect runtime behavior.
+ *
+ * @param fileName A path to the file you want semantic diagnostics for
+ */
+ getSuggestionDiagnostics(fileName: string): DiagnosticWithLocation[];
+ /**
+ * Gets global diagnostics related to the program configuration and compiler options.
+ */
+ getCompilerOptionsDiagnostics(): Diagnostic[];
+ /** @deprecated Use getEncodedSyntacticClassifications instead. */
+ getSyntacticClassifications(fileName: string, span: TextSpan): ClassifiedSpan[];
+ /** @deprecated Use getEncodedSemanticClassifications instead. */
+ getSemanticClassifications(fileName: string, span: TextSpan): ClassifiedSpan[];
+ getEncodedSyntacticClassifications(fileName: string, span: TextSpan): Classifications;
+ getEncodedSemanticClassifications(fileName: string, span: TextSpan): Classifications;
+ /**
+ * Gets completion entries at a particular position in a file.
+ *
+ * @param fileName The path to the file
+ * @param position A zero-based index of the character where you want the entries
+ * @param options An object describing how the request was triggered and what kinds
+ * of code actions can be returned with the completions.
+ */
+ getCompletionsAtPosition(fileName: string, position: number, options: GetCompletionsAtPositionOptions | undefined): WithMetadata<CompletionInfo> | undefined;
+ /**
+ * Gets the extended details for a completion entry retrieved from `getCompletionsAtPosition`.
+ *
+ * @param fileName The path to the file
+ * @param position A zero based index of the character where you want the entries
+ * @param entryName The name from an existing completion which came from `getCompletionsAtPosition`
+ * @param formatOptions How should code samples in the completions be formatted, can be undefined for backwards compatibility
+ * @param source Source code for the current file, can be undefined for backwards compatibility
+ * @param preferences User settings, can be undefined for backwards compatibility
+ */
+ getCompletionEntryDetails(fileName: string, position: number, entryName: string, formatOptions: FormatCodeOptions | FormatCodeSettings | undefined, source: string | undefined, preferences: UserPreferences | undefined): CompletionEntryDetails | undefined;
+ getCompletionEntrySymbol(fileName: string, position: number, name: string, source: string | undefined): Symbol | undefined;
+ /**
+ * Gets semantic information about the identifier at a particular position in a
+ * file. Quick info is what you typically see when you hover in an editor.
+ *
+ * @param fileName The path to the file
+ * @param position A zero-based index of the character where you want the quick info
+ */
+ getQuickInfoAtPosition(fileName: string, position: number): QuickInfo | undefined;
+ getNameOrDottedNameSpan(fileName: string, startPos: number, endPos: number): TextSpan | undefined;
+ getBreakpointStatementAtPosition(fileName: string, position: number): TextSpan | undefined;
+ getSignatureHelpItems(fileName: string, position: number, options: SignatureHelpItemsOptions | undefined): SignatureHelpItems | undefined;
+ getRenameInfo(fileName: string, position: number, options?: RenameInfoOptions): RenameInfo;
+ findRenameLocations(fileName: string, position: number, findInStrings: boolean, findInComments: boolean, providePrefixAndSuffixTextForRename?: boolean): readonly RenameLocation[] | undefined;
+ getSmartSelectionRange(fileName: string, position: number): SelectionRange;
+ getDefinitionAtPosition(fileName: string, position: number): readonly DefinitionInfo[] | undefined;
+ getDefinitionAndBoundSpan(fileName: string, position: number): DefinitionInfoAndBoundSpan | undefined;
+ getTypeDefinitionAtPosition(fileName: string, position: number): readonly DefinitionInfo[] | undefined;
+ getImplementationAtPosition(fileName: string, position: number): readonly ImplementationLocation[] | undefined;
+ getReferencesAtPosition(fileName: string, position: number): ReferenceEntry[] | undefined;
+ findReferences(fileName: string, position: number): ReferencedSymbol[] | undefined;
+ getDocumentHighlights(fileName: string, position: number, filesToSearch: string[]): DocumentHighlights[] | undefined;
+ /** @deprecated */
+ getOccurrencesAtPosition(fileName: string, position: number): readonly ReferenceEntry[] | undefined;
+ getNavigateToItems(searchValue: string, maxResultCount?: number, fileName?: string, excludeDtsFiles?: boolean): NavigateToItem[];
+ getNavigationBarItems(fileName: string): NavigationBarItem[];
+ getNavigationTree(fileName: string): NavigationTree;
+ prepareCallHierarchy(fileName: string, position: number): CallHierarchyItem | CallHierarchyItem[] | undefined;
+ provideCallHierarchyIncomingCalls(fileName: string, position: number): CallHierarchyIncomingCall[];
+ provideCallHierarchyOutgoingCalls(fileName: string, position: number): CallHierarchyOutgoingCall[];
+ getOutliningSpans(fileName: string): OutliningSpan[];
+ getTodoComments(fileName: string, descriptors: TodoCommentDescriptor[]): TodoComment[];
+ getBraceMatchingAtPosition(fileName: string, position: number): TextSpan[];
+ getIndentationAtPosition(fileName: string, position: number, options: EditorOptions | EditorSettings): number;
+ getFormattingEditsForRange(fileName: string, start: number, end: number, options: FormatCodeOptions | FormatCodeSettings): TextChange[];
+ getFormattingEditsForDocument(fileName: string, options: FormatCodeOptions | FormatCodeSettings): TextChange[];
+ getFormattingEditsAfterKeystroke(fileName: string, position: number, key: string, options: FormatCodeOptions | FormatCodeSettings): TextChange[];
+ getDocCommentTemplateAtPosition(fileName: string, position: number): TextInsertion | undefined;
+ isValidBraceCompletionAtPosition(fileName: string, position: number, openingBrace: number): boolean;
+ /**
+ * This will return a defined result if the position is after the `>` of the opening tag, or somewhere in the text, of a JSXElement with no closing tag.
+ * Editors should call this after `>` is typed.
+ */
+ getJsxClosingTagAtPosition(fileName: string, position: number): JsxClosingTagInfo | undefined;
+ getSpanOfEnclosingComment(fileName: string, position: number, onlyMultiLine: boolean): TextSpan | undefined;
+ toLineColumnOffset?(fileName: string, position: number): LineAndCharacter;
+ getCodeFixesAtPosition(fileName: string, start: number, end: number, errorCodes: readonly number[], formatOptions: FormatCodeSettings, preferences: UserPreferences): readonly CodeFixAction[];
+ getCombinedCodeFix(scope: CombinedCodeFixScope, fixId: {}, formatOptions: FormatCodeSettings, preferences: UserPreferences): CombinedCodeActions;
+ applyCodeActionCommand(action: CodeActionCommand, formatSettings?: FormatCodeSettings): Promise<ApplyCodeActionCommandResult>;
+ applyCodeActionCommand(action: CodeActionCommand[], formatSettings?: FormatCodeSettings): Promise<ApplyCodeActionCommandResult[]>;
+ applyCodeActionCommand(action: CodeActionCommand | CodeActionCommand[], formatSettings?: FormatCodeSettings): Promise<ApplyCodeActionCommandResult | ApplyCodeActionCommandResult[]>;
+ /** @deprecated `fileName` will be ignored */
+ applyCodeActionCommand(fileName: string, action: CodeActionCommand): Promise<ApplyCodeActionCommandResult>;
+ /** @deprecated `fileName` will be ignored */
+ applyCodeActionCommand(fileName: string, action: CodeActionCommand[]): Promise<ApplyCodeActionCommandResult[]>;
+ /** @deprecated `fileName` will be ignored */
+ applyCodeActionCommand(fileName: string, action: CodeActionCommand | CodeActionCommand[]): Promise<ApplyCodeActionCommandResult | ApplyCodeActionCommandResult[]>;
+ getApplicableRefactors(fileName: string, positionOrRange: number | TextRange, preferences: UserPreferences | undefined): ApplicableRefactorInfo[];
+ getEditsForRefactor(fileName: string, formatOptions: FormatCodeSettings, positionOrRange: number | TextRange, refactorName: string, actionName: string, preferences: UserPreferences | undefined): RefactorEditInfo | undefined;
+ organizeImports(scope: OrganizeImportsScope, formatOptions: FormatCodeSettings, preferences: UserPreferences | undefined): readonly FileTextChanges[];
+ getEditsForFileRename(oldFilePath: string, newFilePath: string, formatOptions: FormatCodeSettings, preferences: UserPreferences | undefined): readonly FileTextChanges[];
+ getEmitOutput(fileName: string, emitOnlyDtsFiles?: boolean, forceDtsEmit?: boolean): EmitOutput;
+ getProgram(): Program | undefined;
+ dispose(): void;
+ }
+ interface JsxClosingTagInfo {
+ readonly newText: string;
+ }
+ interface CombinedCodeFixScope {
+ type: "file";
+ fileName: string;
+ }
+ type OrganizeImportsScope = CombinedCodeFixScope;
+ type CompletionsTriggerCharacter = "." | '"' | "'" | "`" | "/" | "@" | "<" | "#";
+ interface GetCompletionsAtPositionOptions extends UserPreferences {
+ /**
+ * If the editor is asking for completions because a certain character was typed
+ * (as opposed to when the user explicitly requested them) this should be set.
+ */
+ triggerCharacter?: CompletionsTriggerCharacter;
+ /** @deprecated Use includeCompletionsForModuleExports */
+ includeExternalModuleExports?: boolean;
+ /** @deprecated Use includeCompletionsWithInsertText */
+ includeInsertTextCompletions?: boolean;
+ }
+ type SignatureHelpTriggerCharacter = "," | "(" | "<";
+ type SignatureHelpRetriggerCharacter = SignatureHelpTriggerCharacter | ")";
+ interface SignatureHelpItemsOptions {
+ triggerReason?: SignatureHelpTriggerReason;
+ }
+ type SignatureHelpTriggerReason = SignatureHelpInvokedReason | SignatureHelpCharacterTypedReason | SignatureHelpRetriggeredReason;
+ /**
+ * Signals that the user manually requested signature help.
+ * The language service will unconditionally attempt to provide a result.
+ */
+ interface SignatureHelpInvokedReason {
+ kind: "invoked";
+ triggerCharacter?: undefined;
+ }
+ /**
+ * Signals that the signature help request came from a user typing a character.
+ * Depending on the character and the syntactic context, the request may or may not be served a result.
+ */
+ interface SignatureHelpCharacterTypedReason {
+ kind: "characterTyped";
+ /**
+ * Character that was responsible for triggering signature help.
+ */
+ triggerCharacter: SignatureHelpTriggerCharacter;
+ }
+ /**
+ * Signals that this signature help request came from typing a character or moving the cursor.
+ * This should only occur if a signature help session was already active and the editor needs to see if it should adjust.
+ * The language service will unconditionally attempt to provide a result.
+ * `triggerCharacter` can be `undefined` for a retrigger caused by a cursor move.
+ */
+ interface SignatureHelpRetriggeredReason {
+ kind: "retrigger";
+ /**
+ * Character that was responsible for triggering signature help.
+ */
+ triggerCharacter?: SignatureHelpRetriggerCharacter;
+ }
+ interface ApplyCodeActionCommandResult {
+ successMessage: string;
+ }
+ interface Classifications {
+ spans: number[];
+ endOfLineState: EndOfLineState;
+ }
+ interface ClassifiedSpan {
+ textSpan: TextSpan;
+ classificationType: ClassificationTypeNames;
+ }
+ /**
+ * Navigation bar interface designed for visual studio's dual-column layout.
+ * This does not form a proper tree.
+ * The navbar is returned as a list of top-level items, each of which has a list of child items.
+ * Child items always have an empty array for their `childItems`.
+ */
+ interface NavigationBarItem {
+ text: string;
+ kind: ScriptElementKind;
+ kindModifiers: string;
+ spans: TextSpan[];
+ childItems: NavigationBarItem[];
+ indent: number;
+ bolded: boolean;
+ grayed: boolean;
+ }
+ /**
+ * Node in a tree of nested declarations in a file.
+ * The top node is always a script or module node.
+ */
+ interface NavigationTree {
+ /** Name of the declaration, or a short description, e.g. "<class>". */
+ text: string;
+ kind: ScriptElementKind;
+ /** ScriptElementKindModifier separated by commas, e.g. "public,abstract" */
+ kindModifiers: string;
+ /**
+ * Spans of the nodes that generated this declaration.
+ * There will be more than one if this is the result of merging.
+ */
+ spans: TextSpan[];
+ nameSpan: TextSpan | undefined;
+ /** Present if non-empty */
+ childItems?: NavigationTree[];
+ }
+ interface CallHierarchyItem {
+ name: string;
+ kind: ScriptElementKind;
+ file: string;
+ span: TextSpan;
+ selectionSpan: TextSpan;
+ }
+ interface CallHierarchyIncomingCall {
+ from: CallHierarchyItem;
+ fromSpans: TextSpan[];
+ }
+ interface CallHierarchyOutgoingCall {
+ to: CallHierarchyItem;
+ fromSpans: TextSpan[];
+ }
+ interface TodoCommentDescriptor {
+ text: string;
+ priority: number;
+ }
+ interface TodoComment {
+ descriptor: TodoCommentDescriptor;
+ message: string;
+ position: number;
+ }
+ interface TextChange {
+ span: TextSpan;
+ newText: string;
+ }
+ interface FileTextChanges {
+ fileName: string;
+ textChanges: readonly TextChange[];
+ isNewFile?: boolean;
+ }
+ interface CodeAction {
+ /** Description of the code action to display in the UI of the editor */
+ description: string;
+ /** Text changes to apply to each file as part of the code action */
+ changes: FileTextChanges[];
+ /**
+ * If the user accepts the code fix, the editor should send the action back in a `applyAction` request.
+ * This allows the language service to have side effects (e.g. installing dependencies) upon a code fix.
+ */
+ commands?: CodeActionCommand[];
+ }
+ interface CodeFixAction extends CodeAction {
+ /** Short name to identify the fix, for use by telemetry. */
+ fixName: string;
+ /**
+ * If present, one may call 'getCombinedCodeFix' with this fixId.
+ * This may be omitted to indicate that the code fix can't be applied in a group.
+ */
+ fixId?: {};
+ fixAllDescription?: string;
+ }
+ interface CombinedCodeActions {
+ changes: readonly FileTextChanges[];
+ commands?: readonly CodeActionCommand[];
+ }
+ type CodeActionCommand = InstallPackageAction;
+ interface InstallPackageAction {
+ }
+ /**
+ * A set of one or more available refactoring actions, grouped under a parent refactoring.
+ */
+ interface ApplicableRefactorInfo {
+ /**
+ * The programmatic name of the refactoring
+ */
+ name: string;
+ /**
+ * A description of this refactoring category to show to the user.
+ * If the refactoring gets inlined (see below), this text will not be visible.
+ */
+ description: string;
+ /**
+ * Inlineable refactorings can have their actions hoisted out to the top level
+ * of a context menu. Non-inlineanable refactorings should always be shown inside
+ * their parent grouping.
+ *
+ * If not specified, this value is assumed to be 'true'
+ */
+ inlineable?: boolean;
+ actions: RefactorActionInfo[];
+ }
+ /**
+ * Represents a single refactoring action - for example, the "Extract Method..." refactor might
+ * offer several actions, each corresponding to a surround class or closure to extract into.
+ */
+ interface RefactorActionInfo {
+ /**
+ * The programmatic name of the refactoring action
+ */
+ name: string;
+ /**
+ * A description of this refactoring action to show to the user.
+ * If the parent refactoring is inlined away, this will be the only text shown,
+ * so this description should make sense by itself if the parent is inlineable=true
+ */
+ description: string;
+ }
+ /**
+ * A set of edits to make in response to a refactor action, plus an optional
+ * location where renaming should be invoked from
+ */
+ interface RefactorEditInfo {
+ edits: FileTextChanges[];
+ renameFilename?: string;
+ renameLocation?: number;
+ commands?: CodeActionCommand[];
+ }
+ interface TextInsertion {
+ newText: string;
+ /** The position in newText the caret should point to after the insertion. */
+ caretOffset: number;
+ }
+ interface DocumentSpan {
+ textSpan: TextSpan;
+ fileName: string;
+ /**
+ * If the span represents a location that was remapped (e.g. via a .d.ts.map file),
+ * then the original filename and span will be specified here
+ */
+ originalTextSpan?: TextSpan;
+ originalFileName?: string;
+ /**
+ * If DocumentSpan.textSpan is the span for name of the declaration,
+ * then this is the span for relevant declaration
+ */
+ contextSpan?: TextSpan;
+ originalContextSpan?: TextSpan;
+ }
+ interface RenameLocation extends DocumentSpan {
+ readonly prefixText?: string;
+ readonly suffixText?: string;
+ }
+ interface ReferenceEntry extends DocumentSpan {
+ isWriteAccess: boolean;
+ isDefinition: boolean;
+ isInString?: true;
+ }
+ interface ImplementationLocation extends DocumentSpan {
+ kind: ScriptElementKind;
+ displayParts: SymbolDisplayPart[];
+ }
+ enum HighlightSpanKind {
+ none = "none",
+ definition = "definition",
+ reference = "reference",
+ writtenReference = "writtenReference"
+ }
+ interface HighlightSpan {
+ fileName?: string;
+ isInString?: true;
+ textSpan: TextSpan;
+ contextSpan?: TextSpan;
+ kind: HighlightSpanKind;
+ }
+ interface NavigateToItem {
+ name: string;
+ kind: ScriptElementKind;
+ kindModifiers: string;
+ matchKind: "exact" | "prefix" | "substring" | "camelCase";
+ isCaseSensitive: boolean;
+ fileName: string;
+ textSpan: TextSpan;
+ containerName: string;
+ containerKind: ScriptElementKind;
+ }
+ enum IndentStyle {
+ None = 0,
+ Block = 1,
+ Smart = 2
+ }
+ enum SemicolonPreference {
+ Ignore = "ignore",
+ Insert = "insert",
+ Remove = "remove"
+ }
+ interface EditorOptions {
+ BaseIndentSize?: number;
+ IndentSize: number;
+ TabSize: number;
+ NewLineCharacter: string;
+ ConvertTabsToSpaces: boolean;
+ IndentStyle: IndentStyle;
+ }
+ interface EditorSettings {
+ baseIndentSize?: number;
+ indentSize?: number;
+ tabSize?: number;
+ newLineCharacter?: string;
+ convertTabsToSpaces?: boolean;
+ indentStyle?: IndentStyle;
+ trimTrailingWhitespace?: boolean;
+ }
+ interface FormatCodeOptions extends EditorOptions {
+ InsertSpaceAfterCommaDelimiter: boolean;
+ InsertSpaceAfterSemicolonInForStatements: boolean;
+ InsertSpaceBeforeAndAfterBinaryOperators: boolean;
+ InsertSpaceAfterConstructor?: boolean;
+ InsertSpaceAfterKeywordsInControlFlowStatements: boolean;
+ InsertSpaceAfterFunctionKeywordForAnonymousFunctions: boolean;
+ InsertSpaceAfterOpeningAndBeforeClosingNonemptyParenthesis: boolean;
+ InsertSpaceAfterOpeningAndBeforeClosingNonemptyBrackets: boolean;
+ InsertSpaceAfterOpeningAndBeforeClosingNonemptyBraces?: boolean;
+ InsertSpaceAfterOpeningAndBeforeClosingTemplateStringBraces: boolean;
+ InsertSpaceAfterOpeningAndBeforeClosingJsxExpressionBraces?: boolean;
+ InsertSpaceAfterTypeAssertion?: boolean;
+ InsertSpaceBeforeFunctionParenthesis?: boolean;
+ PlaceOpenBraceOnNewLineForFunctions: boolean;
+ PlaceOpenBraceOnNewLineForControlBlocks: boolean;
+ insertSpaceBeforeTypeAnnotation?: boolean;
+ }
+ interface FormatCodeSettings extends EditorSettings {
+ readonly insertSpaceAfterCommaDelimiter?: boolean;
+ readonly insertSpaceAfterSemicolonInForStatements?: boolean;
+ readonly insertSpaceBeforeAndAfterBinaryOperators?: boolean;
+ readonly insertSpaceAfterConstructor?: boolean;
+ readonly insertSpaceAfterKeywordsInControlFlowStatements?: boolean;
+ readonly insertSpaceAfterFunctionKeywordForAnonymousFunctions?: boolean;
+ readonly insertSpaceAfterOpeningAndBeforeClosingNonemptyParenthesis?: boolean;
+ readonly insertSpaceAfterOpeningAndBeforeClosingNonemptyBrackets?: boolean;
+ readonly insertSpaceAfterOpeningAndBeforeClosingNonemptyBraces?: boolean;
+ readonly insertSpaceAfterOpeningAndBeforeClosingEmptyBraces?: boolean;
+ readonly insertSpaceAfterOpeningAndBeforeClosingTemplateStringBraces?: boolean;
+ readonly insertSpaceAfterOpeningAndBeforeClosingJsxExpressionBraces?: boolean;
+ readonly insertSpaceAfterTypeAssertion?: boolean;
+ readonly insertSpaceBeforeFunctionParenthesis?: boolean;
+ readonly placeOpenBraceOnNewLineForFunctions?: boolean;
+ readonly placeOpenBraceOnNewLineForControlBlocks?: boolean;
+ readonly insertSpaceBeforeTypeAnnotation?: boolean;
+ readonly indentMultiLineObjectLiteralBeginningOnBlankLine?: boolean;
+ readonly semicolons?: SemicolonPreference;
+ }
+ function getDefaultFormatCodeSettings(newLineCharacter?: string): FormatCodeSettings;
+ interface DefinitionInfo extends DocumentSpan {
+ kind: ScriptElementKind;
+ name: string;
+ containerKind: ScriptElementKind;
+ containerName: string;
+ }
+ interface DefinitionInfoAndBoundSpan {
+ definitions?: readonly DefinitionInfo[];
+ textSpan: TextSpan;
+ }
+ interface ReferencedSymbolDefinitionInfo extends DefinitionInfo {
+ displayParts: SymbolDisplayPart[];
+ }
+ interface ReferencedSymbol {
+ definition: ReferencedSymbolDefinitionInfo;
+ references: ReferenceEntry[];
+ }
+ enum SymbolDisplayPartKind {
+ aliasName = 0,
+ className = 1,
+ enumName = 2,
+ fieldName = 3,
+ interfaceName = 4,
+ keyword = 5,
+ lineBreak = 6,
+ numericLiteral = 7,
+ stringLiteral = 8,
+ localName = 9,
+ methodName = 10,
+ moduleName = 11,
+ operator = 12,
+ parameterName = 13,
+ propertyName = 14,
+ punctuation = 15,
+ space = 16,
+ text = 17,
+ typeParameterName = 18,
+ enumMemberName = 19,
+ functionName = 20,
+ regularExpressionLiteral = 21
+ }
+ interface SymbolDisplayPart {
+ text: string;
+ kind: string;
+ }
+ interface JSDocTagInfo {
+ name: string;
+ text?: string;
+ }
+ interface QuickInfo {
+ kind: ScriptElementKind;
+ kindModifiers: string;
+ textSpan: TextSpan;
+ displayParts?: SymbolDisplayPart[];
+ documentation?: SymbolDisplayPart[];
+ tags?: JSDocTagInfo[];
+ }
+ type RenameInfo = RenameInfoSuccess | RenameInfoFailure;
+ interface RenameInfoSuccess {
+ canRename: true;
+ /**
+ * File or directory to rename.
+ * If set, `getEditsForFileRename` should be called instead of `findRenameLocations`.
+ */
+ fileToRename?: string;
+ displayName: string;
+ fullDisplayName: string;
+ kind: ScriptElementKind;
+ kindModifiers: string;
+ triggerSpan: TextSpan;
+ }
+ interface RenameInfoFailure {
+ canRename: false;
+ localizedErrorMessage: string;
+ }
+ interface RenameInfoOptions {
+ readonly allowRenameOfImportPath?: boolean;
+ }
+ interface SignatureHelpParameter {
+ name: string;
+ documentation: SymbolDisplayPart[];
+ displayParts: SymbolDisplayPart[];
+ isOptional: boolean;
+ }
+ interface SelectionRange {
+ textSpan: TextSpan;
+ parent?: SelectionRange;
+ }
+ /**
+ * Represents a single signature to show in signature help.
+ * The id is used for subsequent calls into the language service to ask questions about the
+ * signature help item in the context of any documents that have been updated. i.e. after
+ * an edit has happened, while signature help is still active, the host can ask important
+ * questions like 'what parameter is the user currently contained within?'.
+ */
+ interface SignatureHelpItem {
+ isVariadic: boolean;
+ prefixDisplayParts: SymbolDisplayPart[];
+ suffixDisplayParts: SymbolDisplayPart[];
+ separatorDisplayParts: SymbolDisplayPart[];
+ parameters: SignatureHelpParameter[];
+ documentation: SymbolDisplayPart[];
+ tags: JSDocTagInfo[];
+ }
+ /**
+ * Represents a set of signature help items, and the preferred item that should be selected.
+ */
+ interface SignatureHelpItems {
+ items: SignatureHelpItem[];
+ applicableSpan: TextSpan;
+ selectedItemIndex: number;
+ argumentIndex: number;
+ argumentCount: number;
+ }
+ interface CompletionInfo {
+ /** Not true for all global completions. This will be true if the enclosing scope matches a few syntax kinds. See `isSnippetScope`. */
+ isGlobalCompletion: boolean;
+ isMemberCompletion: boolean;
+ /**
+ * true when the current location also allows for a new identifier
+ */
+ isNewIdentifierLocation: boolean;
+ entries: CompletionEntry[];
+ }
+ interface CompletionEntry {
+ name: string;
+ kind: ScriptElementKind;
+ kindModifiers?: string;
+ sortText: string;
+ insertText?: string;
+ /**
+ * An optional span that indicates the text to be replaced by this completion item.
+ * If present, this span should be used instead of the default one.
+ * It will be set if the required span differs from the one generated by the default replacement behavior.
+ */
+ replacementSpan?: TextSpan;
+ hasAction?: true;
+ source?: string;
+ isRecommended?: true;
+ isFromUncheckedFile?: true;
+ }
+ interface CompletionEntryDetails {
+ name: string;
+ kind: ScriptElementKind;
+ kindModifiers: string;
+ displayParts: SymbolDisplayPart[];
+ documentation?: SymbolDisplayPart[];
+ tags?: JSDocTagInfo[];
+ codeActions?: CodeAction[];
+ source?: SymbolDisplayPart[];
+ }
+ interface OutliningSpan {
+ /** The span of the document to actually collapse. */
+ textSpan: TextSpan;
+ /** The span of the document to display when the user hovers over the collapsed span. */
+ hintSpan: TextSpan;
+ /** The text to display in the editor for the collapsed region. */
+ bannerText: string;
+ /**
+ * Whether or not this region should be automatically collapsed when
+ * the 'Collapse to Definitions' command is invoked.
+ */
+ autoCollapse: boolean;
+ /**
+ * Classification of the contents of the span
+ */
+ kind: OutliningSpanKind;
+ }
+ enum OutliningSpanKind {
+ /** Single or multi-line comments */
+ Comment = "comment",
+ /** Sections marked by '// #region' and '// #endregion' comments */
+ Region = "region",
+ /** Declarations and expressions */
+ Code = "code",
+ /** Contiguous blocks of import declarations */
+ Imports = "imports"
+ }
+ enum OutputFileType {
+ JavaScript = 0,
+ SourceMap = 1,
+ Declaration = 2
+ }
+ enum EndOfLineState {
+ None = 0,
+ InMultiLineCommentTrivia = 1,
+ InSingleQuoteStringLiteral = 2,
+ InDoubleQuoteStringLiteral = 3,
+ InTemplateHeadOrNoSubstitutionTemplate = 4,
+ InTemplateMiddleOrTail = 5,
+ InTemplateSubstitutionPosition = 6
+ }
+ enum TokenClass {
+ Punctuation = 0,
+ Keyword = 1,
+ Operator = 2,
+ Comment = 3,
+ Whitespace = 4,
+ Identifier = 5,
+ NumberLiteral = 6,
+ BigIntLiteral = 7,
+ StringLiteral = 8,
+ RegExpLiteral = 9
+ }
+ interface ClassificationResult {
+ finalLexState: EndOfLineState;
+ entries: ClassificationInfo[];
+ }
+ interface ClassificationInfo {
+ length: number;
+ classification: TokenClass;
+ }
+ interface Classifier {
+ /**
+ * Gives lexical classifications of tokens on a line without any syntactic context.
+ * For instance, a token consisting of the text 'string' can be either an identifier
+ * named 'string' or the keyword 'string', however, because this classifier is not aware,
+ * it relies on certain heuristics to give acceptable results. For classifications where
+ * speed trumps accuracy, this function is preferable; however, for true accuracy, the
+ * syntactic classifier is ideal. In fact, in certain editing scenarios, combining the
+ * lexical, syntactic, and semantic classifiers may issue the best user experience.
+ *
+ * @param text The text of a line to classify.
+ * @param lexState The state of the lexical classifier at the end of the previous line.
+ * @param syntacticClassifierAbsent Whether the client is *not* using a syntactic classifier.
+ * If there is no syntactic classifier (syntacticClassifierAbsent=true),
+ * certain heuristics may be used in its place; however, if there is a
+ * syntactic classifier (syntacticClassifierAbsent=false), certain
+ * classifications which may be incorrectly categorized will be given
+ * back as Identifiers in order to allow the syntactic classifier to
+ * subsume the classification.
+ * @deprecated Use getLexicalClassifications instead.
+ */
+ getClassificationsForLine(text: string, lexState: EndOfLineState, syntacticClassifierAbsent: boolean): ClassificationResult;
+ getEncodedLexicalClassifications(text: string, endOfLineState: EndOfLineState, syntacticClassifierAbsent: boolean): Classifications;
+ }
+ enum ScriptElementKind {
+ unknown = "",
+ warning = "warning",
+ /** predefined type (void) or keyword (class) */
+ keyword = "keyword",
+ /** top level script node */
+ scriptElement = "script",
+ /** module foo {} */
+ moduleElement = "module",
+ /** class X {} */
+ classElement = "class",
+ /** var x = class X {} */
+ localClassElement = "local class",
+ /** interface Y {} */
+ interfaceElement = "interface",
+ /** type T = ... */
+ typeElement = "type",
+ /** enum E */
+ enumElement = "enum",
+ enumMemberElement = "enum member",
+ /**
+ * Inside module and script only
+ * const v = ..
+ */
+ variableElement = "var",
+ /** Inside function */
+ localVariableElement = "local var",
+ /**
+ * Inside module and script only
+ * function f() { }
+ */
+ functionElement = "function",
+ /** Inside function */
+ localFunctionElement = "local function",
+ /** class X { [public|private]* foo() {} } */
+ memberFunctionElement = "method",
+ /** class X { [public|private]* [get|set] foo:number; } */
+ memberGetAccessorElement = "getter",
+ memberSetAccessorElement = "setter",
+ /**
+ * class X { [public|private]* foo:number; }
+ * interface Y { foo:number; }
+ */
+ memberVariableElement = "property",
+ /** class X { constructor() { } } */
+ constructorImplementationElement = "constructor",
+ /** interface Y { ():number; } */
+ callSignatureElement = "call",
+ /** interface Y { []:number; } */
+ indexSignatureElement = "index",
+ /** interface Y { new():Y; } */
+ constructSignatureElement = "construct",
+ /** function foo(*Y*: string) */
+ parameterElement = "parameter",
+ typeParameterElement = "type parameter",
+ primitiveType = "primitive type",
+ label = "label",
+ alias = "alias",
+ constElement = "const",
+ letElement = "let",
+ directory = "directory",
+ externalModuleName = "external module name",
+ /**
+ * <JsxTagName attribute1 attribute2={0} />
+ */
+ jsxAttribute = "JSX attribute",
+ /** String literal */
+ string = "string"
+ }
+ enum ScriptElementKindModifier {
+ none = "",
+ publicMemberModifier = "public",
+ privateMemberModifier = "private",
+ protectedMemberModifier = "protected",
+ exportedModifier = "export",
+ ambientModifier = "declare",
+ staticModifier = "static",
+ abstractModifier = "abstract",
+ optionalModifier = "optional",
+ dtsModifier = ".d.ts",
+ tsModifier = ".ts",
+ tsxModifier = ".tsx",
+ jsModifier = ".js",
+ jsxModifier = ".jsx",
+ jsonModifier = ".json"
+ }
+ enum ClassificationTypeNames {
+ comment = "comment",
+ identifier = "identifier",
+ keyword = "keyword",
+ numericLiteral = "number",
+ bigintLiteral = "bigint",
+ operator = "operator",
+ stringLiteral = "string",
+ whiteSpace = "whitespace",
+ text = "text",
+ punctuation = "punctuation",
+ className = "class name",
+ enumName = "enum name",
+ interfaceName = "interface name",
+ moduleName = "module name",
+ typeParameterName = "type parameter name",
+ typeAliasName = "type alias name",
+ parameterName = "parameter name",
+ docCommentTagName = "doc comment tag name",
+ jsxOpenTagName = "jsx open tag name",
+ jsxCloseTagName = "jsx close tag name",
+ jsxSelfClosingTagName = "jsx self closing tag name",
+ jsxAttribute = "jsx attribute",
+ jsxText = "jsx text",
+ jsxAttributeStringLiteralValue = "jsx attribute string literal value"
+ }
+ enum ClassificationType {
+ comment = 1,
+ identifier = 2,
+ keyword = 3,
+ numericLiteral = 4,
+ operator = 5,
+ stringLiteral = 6,
+ regularExpressionLiteral = 7,
+ whiteSpace = 8,
+ text = 9,
+ punctuation = 10,
+ className = 11,
+ enumName = 12,
+ interfaceName = 13,
+ moduleName = 14,
+ typeParameterName = 15,
+ typeAliasName = 16,
+ parameterName = 17,
+ docCommentTagName = 18,
+ jsxOpenTagName = 19,
+ jsxCloseTagName = 20,
+ jsxSelfClosingTagName = 21,
+ jsxAttribute = 22,
+ jsxText = 23,
+ jsxAttributeStringLiteralValue = 24,
+ bigintLiteral = 25
+ }
+}
+declare namespace ts {
+ /** The classifier is used for syntactic highlighting in editors via the TSServer */
+ function createClassifier(): Classifier;
+}
+declare namespace ts {
+ interface DocumentHighlights {
+ fileName: string;
+ highlightSpans: HighlightSpan[];
+ }
+}
+declare namespace ts {
+ /**
+ * The document registry represents a store of SourceFile objects that can be shared between
+ * multiple LanguageService instances. A LanguageService instance holds on the SourceFile (AST)
+ * of files in the context.
+ * SourceFile objects account for most of the memory usage by the language service. Sharing
+ * the same DocumentRegistry instance between different instances of LanguageService allow
+ * for more efficient memory utilization since all projects will share at least the library
+ * file (lib.d.ts).
+ *
+ * A more advanced use of the document registry is to serialize sourceFile objects to disk
+ * and re-hydrate them when needed.
+ *
+ * To create a default DocumentRegistry, use createDocumentRegistry to create one, and pass it
+ * to all subsequent createLanguageService calls.
+ */
+ interface DocumentRegistry {
+ /**
+ * Request a stored SourceFile with a given fileName and compilationSettings.
+ * The first call to acquire will call createLanguageServiceSourceFile to generate
+ * the SourceFile if was not found in the registry.
+ *
+ * @param fileName The name of the file requested
+ * @param compilationSettings Some compilation settings like target affects the
+ * shape of a the resulting SourceFile. This allows the DocumentRegistry to store
+ * multiple copies of the same file for different compilation settings.
+ * @param scriptSnapshot Text of the file. Only used if the file was not found
+ * in the registry and a new one was created.
+ * @param version Current version of the file. Only used if the file was not found
+ * in the registry and a new one was created.
+ */
+ acquireDocument(fileName: string, compilationSettings: CompilerOptions, scriptSnapshot: IScriptSnapshot, version: string, scriptKind?: ScriptKind): SourceFile;
+ acquireDocumentWithKey(fileName: string, path: Path, compilationSettings: CompilerOptions, key: DocumentRegistryBucketKey, scriptSnapshot: IScriptSnapshot, version: string, scriptKind?: ScriptKind): SourceFile;
+ /**
+ * Request an updated version of an already existing SourceFile with a given fileName
+ * and compilationSettings. The update will in-turn call updateLanguageServiceSourceFile
+ * to get an updated SourceFile.
+ *
+ * @param fileName The name of the file requested
+ * @param compilationSettings Some compilation settings like target affects the
+ * shape of a the resulting SourceFile. This allows the DocumentRegistry to store
+ * multiple copies of the same file for different compilation settings.
+ * @param scriptSnapshot Text of the file.
+ * @param version Current version of the file.
+ */
+ updateDocument(fileName: string, compilationSettings: CompilerOptions, scriptSnapshot: IScriptSnapshot, version: string, scriptKind?: ScriptKind): SourceFile;
+ updateDocumentWithKey(fileName: string, path: Path, compilationSettings: CompilerOptions, key: DocumentRegistryBucketKey, scriptSnapshot: IScriptSnapshot, version: string, scriptKind?: ScriptKind): SourceFile;
+ getKeyForCompilationSettings(settings: CompilerOptions): DocumentRegistryBucketKey;
+ /**
+ * Informs the DocumentRegistry that a file is not needed any longer.
+ *
+ * Note: It is not allowed to call release on a SourceFile that was not acquired from
+ * this registry originally.
+ *
+ * @param fileName The name of the file to be released
+ * @param compilationSettings The compilation settings used to acquire the file
+ */
+ releaseDocument(fileName: string, compilationSettings: CompilerOptions): void;
+ releaseDocumentWithKey(path: Path, key: DocumentRegistryBucketKey): void;
+ reportStats(): string;
+ }
+ type DocumentRegistryBucketKey = string & {
+ __bucketKey: any;
+ };
+ function createDocumentRegistry(useCaseSensitiveFileNames?: boolean, currentDirectory?: string): DocumentRegistry;
+}
+declare namespace ts {
+ function preProcessFile(sourceText: string, readImportFiles?: boolean, detectJavaScriptImports?: boolean): PreProcessedFileInfo;
+}
+declare namespace ts {
+ interface TranspileOptions {
+ compilerOptions?: CompilerOptions;
+ fileName?: string;
+ reportDiagnostics?: boolean;
+ moduleName?: string;
+ renamedDependencies?: MapLike<string>;
+ transformers?: CustomTransformers;
+ }
+ interface TranspileOutput {
+ outputText: string;
+ diagnostics?: Diagnostic[];
+ sourceMapText?: string;
+ }
+ function transpileModule(input: string, transpileOptions: TranspileOptions): TranspileOutput;
+ function transpile(input: string, compilerOptions?: CompilerOptions, fileName?: string, diagnostics?: Diagnostic[], moduleName?: string): string;
+}
+declare namespace ts {
+ /** The version of the language service API */
+ const servicesVersion = "0.8";
+ function toEditorSettings(options: EditorOptions | EditorSettings): EditorSettings;
+ function displayPartsToString(displayParts: SymbolDisplayPart[] | undefined): string;
+ function getDefaultCompilerOptions(): CompilerOptions;
+ function getSupportedCodeFixes(): string[];
+ function createLanguageServiceSourceFile(fileName: string, scriptSnapshot: IScriptSnapshot, scriptTarget: ScriptTarget, version: string, setNodeParents: boolean, scriptKind?: ScriptKind): SourceFile;
+ function updateLanguageServiceSourceFile(sourceFile: SourceFile, scriptSnapshot: IScriptSnapshot, version: string, textChangeRange: TextChangeRange | undefined, aggressiveChecks?: boolean): SourceFile;
+ function createLanguageService(host: LanguageServiceHost, documentRegistry?: DocumentRegistry, syntaxOnly?: boolean): LanguageService;
+ /**
+ * Get the path of the default library files (lib.d.ts) as distributed with the typescript
+ * node package.
+ * The functionality is not supported if the ts module is consumed outside of a node module.
+ */
+ function getDefaultLibFilePath(options: CompilerOptions): string;
+}
+declare namespace ts {
+ /**
+ * Transform one or more nodes using the supplied transformers.
+ * @param source A single `Node` or an array of `Node` objects.
+ * @param transformers An array of `TransformerFactory` callbacks used to process the transformation.
+ * @param compilerOptions Optional compiler options.
+ */
+ function transform<T extends Node>(source: T | T[], transformers: TransformerFactory<T>[], compilerOptions?: CompilerOptions): TransformationResult<T>;
+}
+declare namespace ts.server {
+ interface CompressedData {
+ length: number;
+ compressionKind: string;
+ data: any;
+ }
+ type RequireResult = {
+ module: {};
+ error: undefined;
+ } | {
+ module: undefined;
+ error: {
+ stack?: string;
+ message?: string;
+ };
+ };
+ interface ServerHost extends System {
+ watchFile(path: string, callback: FileWatcherCallback, pollingInterval?: number, options?: WatchOptions): FileWatcher;
+ watchDirectory(path: string, callback: DirectoryWatcherCallback, recursive?: boolean, options?: WatchOptions): FileWatcher;
+ setTimeout(callback: (...args: any[]) => void, ms: number, ...args: any[]): any;
+ clearTimeout(timeoutId: any): void;
+ setImmediate(callback: (...args: any[]) => void, ...args: any[]): any;
+ clearImmediate(timeoutId: any): void;
+ gc?(): void;
+ trace?(s: string): void;
+ require?(initialPath: string, moduleName: string): RequireResult;
+ }
+}
+declare namespace ts.server {
+ enum LogLevel {
+ terse = 0,
+ normal = 1,
+ requestTime = 2,
+ verbose = 3
+ }
+ const emptyArray: SortedReadonlyArray<never>;
+ interface Logger {
+ close(): void;
+ hasLevel(level: LogLevel): boolean;
+ loggingEnabled(): boolean;
+ perftrc(s: string): void;
+ info(s: string): void;
+ startGroup(): void;
+ endGroup(): void;
+ msg(s: string, type?: Msg): void;
+ getLogFileName(): string | undefined;
+ }
+ enum Msg {
+ Err = "Err",
+ Info = "Info",
+ Perf = "Perf"
+ }
+ namespace Msg {
+ /** @deprecated Only here for backwards-compatibility. Prefer just `Msg`. */
+ type Types = Msg;
+ }
+ function createInstallTypingsRequest(project: Project, typeAcquisition: TypeAcquisition, unresolvedImports: SortedReadonlyArray<string>, cachePath?: string): DiscoverTypings;
+ namespace Errors {
+ function ThrowNoProject(): never;
+ function ThrowProjectLanguageServiceDisabled(): never;
+ function ThrowProjectDoesNotContainDocument(fileName: string, project: Project): never;
+ }
+ type NormalizedPath = string & {
+ __normalizedPathTag: any;
+ };
+ function toNormalizedPath(fileName: string): NormalizedPath;
+ function normalizedPathToPath(normalizedPath: NormalizedPath, currentDirectory: string, getCanonicalFileName: (f: string) => string): Path;
+ function asNormalizedPath(fileName: string): NormalizedPath;
+ interface NormalizedPathMap<T> {
+ get(path: NormalizedPath): T | undefined;
+ set(path: NormalizedPath, value: T): void;
+ contains(path: NormalizedPath): boolean;
+ remove(path: NormalizedPath): void;
+ }
+ function createNormalizedPathMap<T>(): NormalizedPathMap<T>;
+ function isInferredProjectName(name: string): boolean;
+ function makeInferredProjectName(counter: number): string;
+ function createSortedArray<T>(): SortedArray<T>;
+}
+/**
+ * Declaration module describing the TypeScript Server protocol
+ */
+declare namespace ts.server.protocol {
+ enum CommandTypes {
+ JsxClosingTag = "jsxClosingTag",
+ Brace = "brace",
+ BraceCompletion = "braceCompletion",
+ GetSpanOfEnclosingComment = "getSpanOfEnclosingComment",
+ Change = "change",
+ Close = "close",
+ /** @deprecated Prefer CompletionInfo -- see comment on CompletionsResponse */
+ Completions = "completions",
+ CompletionInfo = "completionInfo",
+ CompletionDetails = "completionEntryDetails",
+ CompileOnSaveAffectedFileList = "compileOnSaveAffectedFileList",
+ CompileOnSaveEmitFile = "compileOnSaveEmitFile",
+ Configure = "configure",
+ Definition = "definition",
+ DefinitionAndBoundSpan = "definitionAndBoundSpan",
+ Implementation = "implementation",
+ Exit = "exit",
+ Format = "format",
+ Formatonkey = "formatonkey",
+ Geterr = "geterr",
+ GeterrForProject = "geterrForProject",
+ SemanticDiagnosticsSync = "semanticDiagnosticsSync",
+ SyntacticDiagnosticsSync = "syntacticDiagnosticsSync",
+ SuggestionDiagnosticsSync = "suggestionDiagnosticsSync",
+ NavBar = "navbar",
+ Navto = "navto",
+ NavTree = "navtree",
+ NavTreeFull = "navtree-full",
+ /** @deprecated */
+ Occurrences = "occurrences",
+ DocumentHighlights = "documentHighlights",
+ Open = "open",
+ Quickinfo = "quickinfo",
+ References = "references",
+ Reload = "reload",
+ Rename = "rename",
+ Saveto = "saveto",
+ SignatureHelp = "signatureHelp",
+ Status = "status",
+ TypeDefinition = "typeDefinition",
+ ProjectInfo = "projectInfo",
+ ReloadProjects = "reloadProjects",
+ Unknown = "unknown",
+ OpenExternalProject = "openExternalProject",
+ OpenExternalProjects = "openExternalProjects",
+ CloseExternalProject = "closeExternalProject",
+ UpdateOpen = "updateOpen",
+ GetOutliningSpans = "getOutliningSpans",
+ TodoComments = "todoComments",
+ Indentation = "indentation",
+ DocCommentTemplate = "docCommentTemplate",
+ CompilerOptionsForInferredProjects = "compilerOptionsForInferredProjects",
+ GetCodeFixes = "getCodeFixes",
+ GetCombinedCodeFix = "getCombinedCodeFix",
+ ApplyCodeActionCommand = "applyCodeActionCommand",
+ GetSupportedCodeFixes = "getSupportedCodeFixes",
+ GetApplicableRefactors = "getApplicableRefactors",
+ GetEditsForRefactor = "getEditsForRefactor",
+ OrganizeImports = "organizeImports",
+ GetEditsForFileRename = "getEditsForFileRename",
+ ConfigurePlugin = "configurePlugin",
+ SelectionRange = "selectionRange",
+ PrepareCallHierarchy = "prepareCallHierarchy",
+ ProvideCallHierarchyIncomingCalls = "provideCallHierarchyIncomingCalls",
+ ProvideCallHierarchyOutgoingCalls = "provideCallHierarchyOutgoingCalls"
+ }
+ /**
+ * A TypeScript Server message
+ */
+ interface Message {
+ /**
+ * Sequence number of the message
+ */
+ seq: number;
+ /**
+ * One of "request", "response", or "event"
+ */
+ type: "request" | "response" | "event";
+ }
+ /**
+ * Client-initiated request message
+ */
+ interface Request extends Message {
+ type: "request";
+ /**
+ * The command to execute
+ */
+ command: string;
+ /**
+ * Object containing arguments for the command
+ */
+ arguments?: any;
+ }
+ /**
+ * Request to reload the project structure for all the opened files
+ */
+ interface ReloadProjectsRequest extends Message {
+ command: CommandTypes.ReloadProjects;
+ }
+ /**
+ * Server-initiated event message
+ */
+ interface Event extends Message {
+ type: "event";
+ /**
+ * Name of event
+ */
+ event: string;
+ /**
+ * Event-specific information
+ */
+ body?: any;
+ }
+ /**
+ * Response by server to client request message.
+ */
+ interface Response extends Message {
+ type: "response";
+ /**
+ * Sequence number of the request message.
+ */
+ request_seq: number;
+ /**
+ * Outcome of the request.
+ */
+ success: boolean;
+ /**
+ * The command requested.
+ */
+ command: string;
+ /**
+ * If success === false, this should always be provided.
+ * Otherwise, may (or may not) contain a success message.
+ */
+ message?: string;
+ /**
+ * Contains message body if success === true.
+ */
+ body?: any;
+ /**
+ * Contains extra information that plugin can include to be passed on
+ */
+ metadata?: unknown;
+ /**
+ * Exposes information about the performance of this request-response pair.
+ */
+ performanceData?: PerformanceData;
+ }
+ interface PerformanceData {
+ /**
+ * Time spent updating the program graph, in milliseconds.
+ */
+ updateGraphDurationMs?: number;
+ }
+ /**
+ * Arguments for FileRequest messages.
+ */
+ interface FileRequestArgs {
+ /**
+ * The file for the request (absolute pathname required).
+ */
+ file: string;
+ projectFileName?: string;
+ }
+ interface StatusRequest extends Request {
+ command: CommandTypes.Status;
+ }
+ interface StatusResponseBody {
+ /**
+ * The TypeScript version (`ts.version`).
+ */
+ version: string;
+ }
+ /**
+ * Response to StatusRequest
+ */
+ interface StatusResponse extends Response {
+ body: StatusResponseBody;
+ }
+ /**
+ * Requests a JS Doc comment template for a given position
+ */
+ interface DocCommentTemplateRequest extends FileLocationRequest {
+ command: CommandTypes.DocCommentTemplate;
+ }
+ /**
+ * Response to DocCommentTemplateRequest
+ */
+ interface DocCommandTemplateResponse extends Response {
+ body?: TextInsertion;
+ }
+ /**
+ * A request to get TODO comments from the file
+ */
+ interface TodoCommentRequest extends FileRequest {
+ command: CommandTypes.TodoComments;
+ arguments: TodoCommentRequestArgs;
+ }
+ /**
+ * Arguments for TodoCommentRequest request.
+ */
+ interface TodoCommentRequestArgs extends FileRequestArgs {
+ /**
+ * Array of target TodoCommentDescriptors that describes TODO comments to be found
+ */
+ descriptors: TodoCommentDescriptor[];
+ }
+ /**
+ * Response for TodoCommentRequest request.
+ */
+ interface TodoCommentsResponse extends Response {
+ body?: TodoComment[];
+ }
+ /**
+ * A request to determine if the caret is inside a comment.
+ */
+ interface SpanOfEnclosingCommentRequest extends FileLocationRequest {
+ command: CommandTypes.GetSpanOfEnclosingComment;
+ arguments: SpanOfEnclosingCommentRequestArgs;
+ }
+ interface SpanOfEnclosingCommentRequestArgs extends FileLocationRequestArgs {
+ /**
+ * Requires that the enclosing span be a multi-line comment, or else the request returns undefined.
+ */
+ onlyMultiLine: boolean;
+ }
+ /**
+ * Request to obtain outlining spans in file.
+ */
+ interface OutliningSpansRequest extends FileRequest {
+ command: CommandTypes.GetOutliningSpans;
+ }
+ interface OutliningSpan {
+ /** The span of the document to actually collapse. */
+ textSpan: TextSpan;
+ /** The span of the document to display when the user hovers over the collapsed span. */
+ hintSpan: TextSpan;
+ /** The text to display in the editor for the collapsed region. */
+ bannerText: string;
+ /**
+ * Whether or not this region should be automatically collapsed when
+ * the 'Collapse to Definitions' command is invoked.
+ */
+ autoCollapse: boolean;
+ /**
+ * Classification of the contents of the span
+ */
+ kind: OutliningSpanKind;
+ }
+ /**
+ * Response to OutliningSpansRequest request.
+ */
+ interface OutliningSpansResponse extends Response {
+ body?: OutliningSpan[];
+ }
+ /**
+ * A request to get indentation for a location in file
+ */
+ interface IndentationRequest extends FileLocationRequest {
+ command: CommandTypes.Indentation;
+ arguments: IndentationRequestArgs;
+ }
+ /**
+ * Response for IndentationRequest request.
+ */
+ interface IndentationResponse extends Response {
+ body?: IndentationResult;
+ }
+ /**
+ * Indentation result representing where indentation should be placed
+ */
+ interface IndentationResult {
+ /**
+ * The base position in the document that the indent should be relative to
+ */
+ position: number;
+ /**
+ * The number of columns the indent should be at relative to the position's column.
+ */
+ indentation: number;
+ }
+ /**
+ * Arguments for IndentationRequest request.
+ */
+ interface IndentationRequestArgs extends FileLocationRequestArgs {
+ /**
+ * An optional set of settings to be used when computing indentation.
+ * If argument is omitted - then it will use settings for file that were previously set via 'configure' request or global settings.
+ */
+ options?: EditorSettings;
+ }
+ /**
+ * Arguments for ProjectInfoRequest request.
+ */
+ interface ProjectInfoRequestArgs extends FileRequestArgs {
+ /**
+ * Indicate if the file name list of the project is needed
+ */
+ needFileNameList: boolean;
+ }
+ /**
+ * A request to get the project information of the current file.
+ */
+ interface ProjectInfoRequest extends Request {
+ command: CommandTypes.ProjectInfo;
+ arguments: ProjectInfoRequestArgs;
+ }
+ /**
+ * A request to retrieve compiler options diagnostics for a project
+ */
+ interface CompilerOptionsDiagnosticsRequest extends Request {
+ arguments: CompilerOptionsDiagnosticsRequestArgs;
+ }
+ /**
+ * Arguments for CompilerOptionsDiagnosticsRequest request.
+ */
+ interface CompilerOptionsDiagnosticsRequestArgs {
+ /**
+ * Name of the project to retrieve compiler options diagnostics.
+ */
+ projectFileName: string;
+ }
+ /**
+ * Response message body for "projectInfo" request
+ */
+ interface ProjectInfo {
+ /**
+ * For configured project, this is the normalized path of the 'tsconfig.json' file
+ * For inferred project, this is undefined
+ */
+ configFileName: string;
+ /**
+ * The list of normalized file name in the project, including 'lib.d.ts'
+ */
+ fileNames?: string[];
+ /**
+ * Indicates if the project has a active language service instance
+ */
+ languageServiceDisabled?: boolean;
+ }
+ /**
+ * Represents diagnostic info that includes location of diagnostic in two forms
+ * - start position and length of the error span
+ * - startLocation and endLocation - a pair of Location objects that store start/end line and offset of the error span.
+ */
+ interface DiagnosticWithLinePosition {
+ message: string;
+ start: number;
+ length: number;
+ startLocation: Location;
+ endLocation: Location;
+ category: string;
+ code: number;
+ /** May store more in future. For now, this will simply be `true` to indicate when a diagnostic is an unused-identifier diagnostic. */
+ reportsUnnecessary?: {};
+ relatedInformation?: DiagnosticRelatedInformation[];
+ }
+ /**
+ * Response message for "projectInfo" request
+ */
+ interface ProjectInfoResponse extends Response {
+ body?: ProjectInfo;
+ }
+ /**
+ * Request whose sole parameter is a file name.
+ */
+ interface FileRequest extends Request {
+ arguments: FileRequestArgs;
+ }
+ /**
+ * Instances of this interface specify a location in a source file:
+ * (file, line, character offset), where line and character offset are 1-based.
+ */
+ interface FileLocationRequestArgs extends FileRequestArgs {
+ /**
+ * The line number for the request (1-based).
+ */
+ line: number;
+ /**
+ * The character offset (on the line) for the request (1-based).
+ */
+ offset: number;
+ }
+ type FileLocationOrRangeRequestArgs = FileLocationRequestArgs | FileRangeRequestArgs;
+ /**
+ * Request refactorings at a given position or selection area.
+ */
+ interface GetApplicableRefactorsRequest extends Request {
+ command: CommandTypes.GetApplicableRefactors;
+ arguments: GetApplicableRefactorsRequestArgs;
+ }
+ type GetApplicableRefactorsRequestArgs = FileLocationOrRangeRequestArgs;
+ /**
+ * Response is a list of available refactorings.
+ * Each refactoring exposes one or more "Actions"; a user selects one action to invoke a refactoring
+ */
+ interface GetApplicableRefactorsResponse extends Response {
+ body?: ApplicableRefactorInfo[];
+ }
+ /**
+ * A set of one or more available refactoring actions, grouped under a parent refactoring.
+ */
+ interface ApplicableRefactorInfo {
+ /**
+ * The programmatic name of the refactoring
+ */
+ name: string;
+ /**
+ * A description of this refactoring category to show to the user.
+ * If the refactoring gets inlined (see below), this text will not be visible.
+ */
+ description: string;
+ /**
+ * Inlineable refactorings can have their actions hoisted out to the top level
+ * of a context menu. Non-inlineanable refactorings should always be shown inside
+ * their parent grouping.
+ *
+ * If not specified, this value is assumed to be 'true'
+ */
+ inlineable?: boolean;
+ actions: RefactorActionInfo[];
+ }
+ /**
+ * Represents a single refactoring action - for example, the "Extract Method..." refactor might
+ * offer several actions, each corresponding to a surround class or closure to extract into.
+ */
+ interface RefactorActionInfo {
+ /**
+ * The programmatic name of the refactoring action
+ */
+ name: string;
+ /**
+ * A description of this refactoring action to show to the user.
+ * If the parent refactoring is inlined away, this will be the only text shown,
+ * so this description should make sense by itself if the parent is inlineable=true
+ */
+ description: string;
+ }
+ interface GetEditsForRefactorRequest extends Request {
+ command: CommandTypes.GetEditsForRefactor;
+ arguments: GetEditsForRefactorRequestArgs;
+ }
+ /**
+ * Request the edits that a particular refactoring action produces.
+ * Callers must specify the name of the refactor and the name of the action.
+ */
+ type GetEditsForRefactorRequestArgs = FileLocationOrRangeRequestArgs & {
+ refactor: string;
+ action: string;
+ };
+ interface GetEditsForRefactorResponse extends Response {
+ body?: RefactorEditInfo;
+ }
+ interface RefactorEditInfo {
+ edits: FileCodeEdits[];
+ /**
+ * An optional location where the editor should start a rename operation once
+ * the refactoring edits have been applied
+ */
+ renameLocation?: Location;
+ renameFilename?: string;
+ }
+ /**
+ * Organize imports by:
+ * 1) Removing unused imports
+ * 2) Coalescing imports from the same module
+ * 3) Sorting imports
+ */
+ interface OrganizeImportsRequest extends Request {
+ command: CommandTypes.OrganizeImports;
+ arguments: OrganizeImportsRequestArgs;
+ }
+ type OrganizeImportsScope = GetCombinedCodeFixScope;
+ interface OrganizeImportsRequestArgs {
+ scope: OrganizeImportsScope;
+ }
+ interface OrganizeImportsResponse extends Response {
+ body: readonly FileCodeEdits[];
+ }
+ interface GetEditsForFileRenameRequest extends Request {
+ command: CommandTypes.GetEditsForFileRename;
+ arguments: GetEditsForFileRenameRequestArgs;
+ }
+ /** Note: Paths may also be directories. */
+ interface GetEditsForFileRenameRequestArgs {
+ readonly oldFilePath: string;
+ readonly newFilePath: string;
+ }
+ interface GetEditsForFileRenameResponse extends Response {
+ body: readonly FileCodeEdits[];
+ }
+ /**
+ * Request for the available codefixes at a specific position.
+ */
+ interface CodeFixRequest extends Request {
+ command: CommandTypes.GetCodeFixes;
+ arguments: CodeFixRequestArgs;
+ }
+ interface GetCombinedCodeFixRequest extends Request {
+ command: CommandTypes.GetCombinedCodeFix;
+ arguments: GetCombinedCodeFixRequestArgs;
+ }
+ interface GetCombinedCodeFixResponse extends Response {
+ body: CombinedCodeActions;
+ }
+ interface ApplyCodeActionCommandRequest extends Request {
+ command: CommandTypes.ApplyCodeActionCommand;
+ arguments: ApplyCodeActionCommandRequestArgs;
+ }
+ interface ApplyCodeActionCommandResponse extends Response {
+ }
+ interface FileRangeRequestArgs extends FileRequestArgs {
+ /**
+ * The line number for the request (1-based).
+ */
+ startLine: number;
+ /**
+ * The character offset (on the line) for the request (1-based).
+ */
+ startOffset: number;
+ /**
+ * The line number for the request (1-based).
+ */
+ endLine: number;
+ /**
+ * The character offset (on the line) for the request (1-based).
+ */
+ endOffset: number;
+ }
+ /**
+ * Instances of this interface specify errorcodes on a specific location in a sourcefile.
+ */
+ interface CodeFixRequestArgs extends FileRangeRequestArgs {
+ /**
+ * Errorcodes we want to get the fixes for.
+ */
+ errorCodes: readonly number[];
+ }
+ interface GetCombinedCodeFixRequestArgs {
+ scope: GetCombinedCodeFixScope;
+ fixId: {};
+ }
+ interface GetCombinedCodeFixScope {
+ type: "file";
+ args: FileRequestArgs;
+ }
+ interface ApplyCodeActionCommandRequestArgs {
+ /** May also be an array of commands. */
+ command: {};
+ }
+ /**
+ * Response for GetCodeFixes request.
+ */
+ interface GetCodeFixesResponse extends Response {
+ body?: CodeAction[];
+ }
+ /**
+ * A request whose arguments specify a file location (file, line, col).
+ */
+ interface FileLocationRequest extends FileRequest {
+ arguments: FileLocationRequestArgs;
+ }
+ /**
+ * A request to get codes of supported code fixes.
+ */
+ interface GetSupportedCodeFixesRequest extends Request {
+ command: CommandTypes.GetSupportedCodeFixes;
+ }
+ /**
+ * A response for GetSupportedCodeFixesRequest request.
+ */
+ interface GetSupportedCodeFixesResponse extends Response {
+ /**
+ * List of error codes supported by the server.
+ */
+ body?: string[];
+ }
+ /**
+ * Arguments in document highlight request; include: filesToSearch, file,
+ * line, offset.
+ */
+ interface DocumentHighlightsRequestArgs extends FileLocationRequestArgs {
+ /**
+ * List of files to search for document highlights.
+ */
+ filesToSearch: string[];
+ }
+ /**
+ * Go to definition request; value of command field is
+ * "definition". Return response giving the file locations that
+ * define the symbol found in file at location line, col.
+ */
+ interface DefinitionRequest extends FileLocationRequest {
+ command: CommandTypes.Definition;
+ }
+ interface DefinitionAndBoundSpanRequest extends FileLocationRequest {
+ readonly command: CommandTypes.DefinitionAndBoundSpan;
+ }
+ interface DefinitionAndBoundSpanResponse extends Response {
+ readonly body: DefinitionInfoAndBoundSpan;
+ }
+ /**
+ * Go to type request; value of command field is
+ * "typeDefinition". Return response giving the file locations that
+ * define the type for the symbol found in file at location line, col.
+ */
+ interface TypeDefinitionRequest extends FileLocationRequest {
+ command: CommandTypes.TypeDefinition;
+ }
+ /**
+ * Go to implementation request; value of command field is
+ * "implementation". Return response giving the file locations that
+ * implement the symbol found in file at location line, col.
+ */
+ interface ImplementationRequest extends FileLocationRequest {
+ command: CommandTypes.Implementation;
+ }
+ /**
+ * Location in source code expressed as (one-based) line and (one-based) column offset.
+ */
+ interface Location {
+ line: number;
+ offset: number;
+ }
+ /**
+ * Object found in response messages defining a span of text in source code.
+ */
+ interface TextSpan {
+ /**
+ * First character of the definition.
+ */
+ start: Location;
+ /**
+ * One character past last character of the definition.
+ */
+ end: Location;
+ }
+ /**
+ * Object found in response messages defining a span of text in a specific source file.
+ */
+ interface FileSpan extends TextSpan {
+ /**
+ * File containing text span.
+ */
+ file: string;
+ }
+ interface TextSpanWithContext extends TextSpan {
+ contextStart?: Location;
+ contextEnd?: Location;
+ }
+ interface FileSpanWithContext extends FileSpan, TextSpanWithContext {
+ }
+ interface DefinitionInfoAndBoundSpan {
+ definitions: readonly FileSpanWithContext[];
+ textSpan: TextSpan;
+ }
+ /**
+ * Definition response message. Gives text range for definition.
+ */
+ interface DefinitionResponse extends Response {
+ body?: FileSpanWithContext[];
+ }
+ interface DefinitionInfoAndBoundSpanResponse extends Response {
+ body?: DefinitionInfoAndBoundSpan;
+ }
+ /** @deprecated Use `DefinitionInfoAndBoundSpanResponse` instead. */
+ type DefinitionInfoAndBoundSpanReponse = DefinitionInfoAndBoundSpanResponse;
+ /**
+ * Definition response message. Gives text range for definition.
+ */
+ interface TypeDefinitionResponse extends Response {
+ body?: FileSpanWithContext[];
+ }
+ /**
+ * Implementation response message. Gives text range for implementations.
+ */
+ interface ImplementationResponse extends Response {
+ body?: FileSpanWithContext[];
+ }
+ /**
+ * Request to get brace completion for a location in the file.
+ */
+ interface BraceCompletionRequest extends FileLocationRequest {
+ command: CommandTypes.BraceCompletion;
+ arguments: BraceCompletionRequestArgs;
+ }
+ /**
+ * Argument for BraceCompletionRequest request.
+ */
+ interface BraceCompletionRequestArgs extends FileLocationRequestArgs {
+ /**
+ * Kind of opening brace
+ */
+ openingBrace: string;
+ }
+ interface JsxClosingTagRequest extends FileLocationRequest {
+ readonly command: CommandTypes.JsxClosingTag;
+ readonly arguments: JsxClosingTagRequestArgs;
+ }
+ interface JsxClosingTagRequestArgs extends FileLocationRequestArgs {
+ }
+ interface JsxClosingTagResponse extends Response {
+ readonly body: TextInsertion;
+ }
+ /**
+ * @deprecated
+ * Get occurrences request; value of command field is
+ * "occurrences". Return response giving spans that are relevant
+ * in the file at a given line and column.
+ */
+ interface OccurrencesRequest extends FileLocationRequest {
+ command: CommandTypes.Occurrences;
+ }
+ /** @deprecated */
+ interface OccurrencesResponseItem extends FileSpanWithContext {
+ /**
+ * True if the occurrence is a write location, false otherwise.
+ */
+ isWriteAccess: boolean;
+ /**
+ * True if the occurrence is in a string, undefined otherwise;
+ */
+ isInString?: true;
+ }
+ /** @deprecated */
+ interface OccurrencesResponse extends Response {
+ body?: OccurrencesResponseItem[];
+ }
+ /**
+ * Get document highlights request; value of command field is
+ * "documentHighlights". Return response giving spans that are relevant
+ * in the file at a given line and column.
+ */
+ interface DocumentHighlightsRequest extends FileLocationRequest {
+ command: CommandTypes.DocumentHighlights;
+ arguments: DocumentHighlightsRequestArgs;
+ }
+ /**
+ * Span augmented with extra information that denotes the kind of the highlighting to be used for span.
+ */
+ interface HighlightSpan extends TextSpanWithContext {
+ kind: HighlightSpanKind;
+ }
+ /**
+ * Represents a set of highligh spans for a give name
+ */
+ interface DocumentHighlightsItem {
+ /**
+ * File containing highlight spans.
+ */
+ file: string;
+ /**
+ * Spans to highlight in file.
+ */
+ highlightSpans: HighlightSpan[];
+ }
+ /**
+ * Response for a DocumentHighlightsRequest request.
+ */
+ interface DocumentHighlightsResponse extends Response {
+ body?: DocumentHighlightsItem[];
+ }
+ /**
+ * Find references request; value of command field is
+ * "references". Return response giving the file locations that
+ * reference the symbol found in file at location line, col.
+ */
+ interface ReferencesRequest extends FileLocationRequest {
+ command: CommandTypes.References;
+ }
+ interface ReferencesResponseItem extends FileSpanWithContext {
+ /** Text of line containing the reference. Including this
+ * with the response avoids latency of editor loading files
+ * to show text of reference line (the server already has
+ * loaded the referencing files).
+ */
+ lineText: string;
+ /**
+ * True if reference is a write location, false otherwise.
+ */
+ isWriteAccess: boolean;
+ /**
+ * True if reference is a definition, false otherwise.
+ */
+ isDefinition: boolean;
+ }
+ /**
+ * The body of a "references" response message.
+ */
+ interface ReferencesResponseBody {
+ /**
+ * The file locations referencing the symbol.
+ */
+ refs: readonly ReferencesResponseItem[];
+ /**
+ * The name of the symbol.
+ */
+ symbolName: string;
+ /**
+ * The start character offset of the symbol (on the line provided by the references request).
+ */
+ symbolStartOffset: number;
+ /**
+ * The full display name of the symbol.
+ */
+ symbolDisplayString: string;
+ }
+ /**
+ * Response to "references" request.
+ */
+ interface ReferencesResponse extends Response {
+ body?: ReferencesResponseBody;
+ }
+ /**
+ * Argument for RenameRequest request.
+ */
+ interface RenameRequestArgs extends FileLocationRequestArgs {
+ /**
+ * Should text at specified location be found/changed in comments?
+ */
+ findInComments?: boolean;
+ /**
+ * Should text at specified location be found/changed in strings?
+ */
+ findInStrings?: boolean;
+ }
+ /**
+ * Rename request; value of command field is "rename". Return
+ * response giving the file locations that reference the symbol
+ * found in file at location line, col. Also return full display
+ * name of the symbol so that client can print it unambiguously.
+ */
+ interface RenameRequest extends FileLocationRequest {
+ command: CommandTypes.Rename;
+ arguments: RenameRequestArgs;
+ }
+ /**
+ * Information about the item to be renamed.
+ */
+ type RenameInfo = RenameInfoSuccess | RenameInfoFailure;
+ interface RenameInfoSuccess {
+ /**
+ * True if item can be renamed.
+ */
+ canRename: true;
+ /**
+ * File or directory to rename.
+ * If set, `getEditsForFileRename` should be called instead of `findRenameLocations`.
+ */
+ fileToRename?: string;
+ /**
+ * Display name of the item to be renamed.
+ */
+ displayName: string;
+ /**
+ * Full display name of item to be renamed.
+ */
+ fullDisplayName: string;
+ /**
+ * The items's kind (such as 'className' or 'parameterName' or plain 'text').
+ */
+ kind: ScriptElementKind;
+ /**
+ * Optional modifiers for the kind (such as 'public').
+ */
+ kindModifiers: string;
+ /** Span of text to rename. */
+ triggerSpan: TextSpan;
+ }
+ interface RenameInfoFailure {
+ canRename: false;
+ /**
+ * Error message if item can not be renamed.
+ */
+ localizedErrorMessage: string;
+ }
+ /**
+ * A group of text spans, all in 'file'.
+ */
+ interface SpanGroup {
+ /** The file to which the spans apply */
+ file: string;
+ /** The text spans in this group */
+ locs: RenameTextSpan[];
+ }
+ interface RenameTextSpan extends TextSpanWithContext {
+ readonly prefixText?: string;
+ readonly suffixText?: string;
+ }
+ interface RenameResponseBody {
+ /**
+ * Information about the item to be renamed.
+ */
+ info: RenameInfo;
+ /**
+ * An array of span groups (one per file) that refer to the item to be renamed.
+ */
+ locs: readonly SpanGroup[];
+ }
+ /**
+ * Rename response message.
+ */
+ interface RenameResponse extends Response {
+ body?: RenameResponseBody;
+ }
+ /**
+ * Represents a file in external project.
+ * External project is project whose set of files, compilation options and open\close state
+ * is maintained by the client (i.e. if all this data come from .csproj file in Visual Studio).
+ * External project will exist even if all files in it are closed and should be closed explicitly.
+ * If external project includes one or more tsconfig.json/jsconfig.json files then tsserver will
+ * create configured project for every config file but will maintain a link that these projects were created
+ * as a result of opening external project so they should be removed once external project is closed.
+ */
+ interface ExternalFile {
+ /**
+ * Name of file file
+ */
+ fileName: string;
+ /**
+ * Script kind of the file
+ */
+ scriptKind?: ScriptKindName | ts.ScriptKind;
+ /**
+ * Whether file has mixed content (i.e. .cshtml file that combines html markup with C#/JavaScript)
+ */
+ hasMixedContent?: boolean;
+ /**
+ * Content of the file
+ */
+ content?: string;
+ }
+ /**
+ * Represent an external project
+ */
+ interface ExternalProject {
+ /**
+ * Project name
+ */
+ projectFileName: string;
+ /**
+ * List of root files in project
+ */
+ rootFiles: ExternalFile[];
+ /**
+ * Compiler options for the project
+ */
+ options: ExternalProjectCompilerOptions;
+ /**
+ * @deprecated typingOptions. Use typeAcquisition instead
+ */
+ typingOptions?: TypeAcquisition;
+ /**
+ * Explicitly specified type acquisition for the project
+ */
+ typeAcquisition?: TypeAcquisition;
+ }
+ interface CompileOnSaveMixin {
+ /**
+ * If compile on save is enabled for the project
+ */
+ compileOnSave?: boolean;
+ }
+ /**
+ * For external projects, some of the project settings are sent together with
+ * compiler settings.
+ */
+ type ExternalProjectCompilerOptions = CompilerOptions & CompileOnSaveMixin & WatchOptions;
+ interface FileWithProjectReferenceRedirectInfo {
+ /**
+ * Name of file
+ */
+ fileName: string;
+ /**
+ * True if the file is primarily included in a referenced project
+ */
+ isSourceOfProjectReferenceRedirect: boolean;
+ }
+ /**
+ * Represents a set of changes that happen in project
+ */
+ interface ProjectChanges {
+ /**
+ * List of added files
+ */
+ added: string[] | FileWithProjectReferenceRedirectInfo[];
+ /**
+ * List of removed files
+ */
+ removed: string[] | FileWithProjectReferenceRedirectInfo[];
+ /**
+ * List of updated files
+ */
+ updated: string[] | FileWithProjectReferenceRedirectInfo[];
+ /**
+ * List of files that have had their project reference redirect status updated
+ * Only provided when the synchronizeProjectList request has includeProjectReferenceRedirectInfo set to true
+ */
+ updatedRedirects?: FileWithProjectReferenceRedirectInfo[];
+ }
+ /**
+ * Information found in a configure request.
+ */
+ interface ConfigureRequestArguments {
+ /**
+ * Information about the host, for example 'Emacs 24.4' or
+ * 'Sublime Text version 3075'
+ */
+ hostInfo?: string;
+ /**
+ * If present, tab settings apply only to this file.
+ */
+ file?: string;
+ /**
+ * The format options to use during formatting and other code editing features.
+ */
+ formatOptions?: FormatCodeSettings;
+ preferences?: UserPreferences;
+ /**
+ * The host's additional supported .js file extensions
+ */
+ extraFileExtensions?: FileExtensionInfo[];
+ watchOptions?: WatchOptions;
+ }
+ enum WatchFileKind {
+ FixedPollingInterval = "FixedPollingInterval",
+ PriorityPollingInterval = "PriorityPollingInterval",
+ DynamicPriorityPolling = "DynamicPriorityPolling",
+ UseFsEvents = "UseFsEvents",
+ UseFsEventsOnParentDirectory = "UseFsEventsOnParentDirectory"
+ }
+ enum WatchDirectoryKind {
+ UseFsEvents = "UseFsEvents",
+ FixedPollingInterval = "FixedPollingInterval",
+ DynamicPriorityPolling = "DynamicPriorityPolling"
+ }
+ enum PollingWatchKind {
+ FixedInterval = "FixedInterval",
+ PriorityInterval = "PriorityInterval",
+ DynamicPriority = "DynamicPriority"
+ }
+ interface WatchOptions {
+ watchFile?: WatchFileKind | ts.WatchFileKind;
+ watchDirectory?: WatchDirectoryKind | ts.WatchDirectoryKind;
+ fallbackPolling?: PollingWatchKind | ts.PollingWatchKind;
+ synchronousWatchDirectory?: boolean;
+ [option: string]: CompilerOptionsValue | undefined;
+ }
+ /**
+ * Configure request; value of command field is "configure". Specifies
+ * host information, such as host type, tab size, and indent size.
+ */
+ interface ConfigureRequest extends Request {
+ command: CommandTypes.Configure;
+ arguments: ConfigureRequestArguments;
+ }
+ /**
+ * Response to "configure" request. This is just an acknowledgement, so
+ * no body field is required.
+ */
+ interface ConfigureResponse extends Response {
+ }
+ interface ConfigurePluginRequestArguments {
+ pluginName: string;
+ configuration: any;
+ }
+ interface ConfigurePluginRequest extends Request {
+ command: CommandTypes.ConfigurePlugin;
+ arguments: ConfigurePluginRequestArguments;
+ }
+ interface ConfigurePluginResponse extends Response {
+ }
+ interface SelectionRangeRequest extends FileRequest {
+ command: CommandTypes.SelectionRange;
+ arguments: SelectionRangeRequestArgs;
+ }
+ interface SelectionRangeRequestArgs extends FileRequestArgs {
+ locations: Location[];
+ }
+ interface SelectionRangeResponse extends Response {
+ body?: SelectionRange[];
+ }
+ interface SelectionRange {
+ textSpan: TextSpan;
+ parent?: SelectionRange;
+ }
+ /**
+ * Information found in an "open" request.
+ */
+ interface OpenRequestArgs extends FileRequestArgs {
+ /**
+ * Used when a version of the file content is known to be more up to date than the one on disk.
+ * Then the known content will be used upon opening instead of the disk copy
+ */
+ fileContent?: string;
+ /**
+ * Used to specify the script kind of the file explicitly. It could be one of the following:
+ * "TS", "JS", "TSX", "JSX"
+ */
+ scriptKindName?: ScriptKindName;
+ /**
+ * Used to limit the searching for project config file. If given the searching will stop at this
+ * root path; otherwise it will go all the way up to the dist root path.
+ */
+ projectRootPath?: string;
+ }
+ type ScriptKindName = "TS" | "JS" | "TSX" | "JSX";
+ /**
+ * Open request; value of command field is "open". Notify the
+ * server that the client has file open. The server will not
+ * monitor the filesystem for changes in this file and will assume
+ * that the client is updating the server (using the change and/or
+ * reload messages) when the file changes. Server does not currently
+ * send a response to an open request.
+ */
+ interface OpenRequest extends Request {
+ command: CommandTypes.Open;
+ arguments: OpenRequestArgs;
+ }
+ /**
+ * Request to open or update external project
+ */
+ interface OpenExternalProjectRequest extends Request {
+ command: CommandTypes.OpenExternalProject;
+ arguments: OpenExternalProjectArgs;
+ }
+ /**
+ * Arguments to OpenExternalProjectRequest request
+ */
+ type OpenExternalProjectArgs = ExternalProject;
+ /**
+ * Request to open multiple external projects
+ */
+ interface OpenExternalProjectsRequest extends Request {
+ command: CommandTypes.OpenExternalProjects;
+ arguments: OpenExternalProjectsArgs;
+ }
+ /**
+ * Arguments to OpenExternalProjectsRequest
+ */
+ interface OpenExternalProjectsArgs {
+ /**
+ * List of external projects to open or update
+ */
+ projects: ExternalProject[];
+ }
+ /**
+ * Response to OpenExternalProjectRequest request. This is just an acknowledgement, so
+ * no body field is required.
+ */
+ interface OpenExternalProjectResponse extends Response {
+ }
+ /**
+ * Response to OpenExternalProjectsRequest request. This is just an acknowledgement, so
+ * no body field is required.
+ */
+ interface OpenExternalProjectsResponse extends Response {
+ }
+ /**
+ * Request to close external project.
+ */
+ interface CloseExternalProjectRequest extends Request {
+ command: CommandTypes.CloseExternalProject;
+ arguments: CloseExternalProjectRequestArgs;
+ }
+ /**
+ * Arguments to CloseExternalProjectRequest request
+ */
+ interface CloseExternalProjectRequestArgs {
+ /**
+ * Name of the project to close
+ */
+ projectFileName: string;
+ }
+ /**
+ * Response to CloseExternalProjectRequest request. This is just an acknowledgement, so
+ * no body field is required.
+ */
+ interface CloseExternalProjectResponse extends Response {
+ }
+ /**
+ * Request to synchronize list of open files with the client
+ */
+ interface UpdateOpenRequest extends Request {
+ command: CommandTypes.UpdateOpen;
+ arguments: UpdateOpenRequestArgs;
+ }
+ /**
+ * Arguments to UpdateOpenRequest
+ */
+ interface UpdateOpenRequestArgs {
+ /**
+ * List of newly open files
+ */
+ openFiles?: OpenRequestArgs[];
+ /**
+ * List of open files files that were changes
+ */
+ changedFiles?: FileCodeEdits[];
+ /**
+ * List of files that were closed
+ */
+ closedFiles?: string[];
+ }
+ /**
+ * Request to set compiler options for inferred projects.
+ * External projects are opened / closed explicitly.
+ * Configured projects are opened when user opens loose file that has 'tsconfig.json' or 'jsconfig.json' anywhere in one of containing folders.
+ * This configuration file will be used to obtain a list of files and configuration settings for the project.
+ * Inferred projects are created when user opens a loose file that is not the part of external project
+ * or configured project and will contain only open file and transitive closure of referenced files if 'useOneInferredProject' is false,
+ * or all open loose files and its transitive closure of referenced files if 'useOneInferredProject' is true.
+ */
+ interface SetCompilerOptionsForInferredProjectsRequest extends Request {
+ command: CommandTypes.CompilerOptionsForInferredProjects;
+ arguments: SetCompilerOptionsForInferredProjectsArgs;
+ }
+ /**
+ * Argument for SetCompilerOptionsForInferredProjectsRequest request.
+ */
+ interface SetCompilerOptionsForInferredProjectsArgs {
+ /**
+ * Compiler options to be used with inferred projects.
+ */
+ options: ExternalProjectCompilerOptions;
+ /**
+ * Specifies the project root path used to scope compiler options.
+ * It is an error to provide this property if the server has not been started with
+ * `useInferredProjectPerProjectRoot` enabled.
+ */
+ projectRootPath?: string;
+ }
+ /**
+ * Response to SetCompilerOptionsForInferredProjectsResponse request. This is just an acknowledgement, so
+ * no body field is required.
+ */
+ interface SetCompilerOptionsForInferredProjectsResponse extends Response {
+ }
+ /**
+ * Exit request; value of command field is "exit". Ask the server process
+ * to exit.
+ */
+ interface ExitRequest extends Request {
+ command: CommandTypes.Exit;
+ }
+ /**
+ * Close request; value of command field is "close". Notify the
+ * server that the client has closed a previously open file. If
+ * file is still referenced by open files, the server will resume
+ * monitoring the filesystem for changes to file. Server does not
+ * currently send a response to a close request.
+ */
+ interface CloseRequest extends FileRequest {
+ command: CommandTypes.Close;
+ }
+ /**
+ * Request to obtain the list of files that should be regenerated if target file is recompiled.
+ * NOTE: this us query-only operation and does not generate any output on disk.
+ */
+ interface CompileOnSaveAffectedFileListRequest extends FileRequest {
+ command: CommandTypes.CompileOnSaveAffectedFileList;
+ }
+ /**
+ * Contains a list of files that should be regenerated in a project
+ */
+ interface CompileOnSaveAffectedFileListSingleProject {
+ /**
+ * Project name
+ */
+ projectFileName: string;
+ /**
+ * List of files names that should be recompiled
+ */
+ fileNames: string[];
+ /**
+ * true if project uses outFile or out compiler option
+ */
+ projectUsesOutFile: boolean;
+ }
+ /**
+ * Response for CompileOnSaveAffectedFileListRequest request;
+ */
+ interface CompileOnSaveAffectedFileListResponse extends Response {
+ body: CompileOnSaveAffectedFileListSingleProject[];
+ }
+ /**
+ * Request to recompile the file. All generated outputs (.js, .d.ts or .js.map files) is written on disk.
+ */
+ interface CompileOnSaveEmitFileRequest extends FileRequest {
+ command: CommandTypes.CompileOnSaveEmitFile;
+ arguments: CompileOnSaveEmitFileRequestArgs;
+ }
+ /**
+ * Arguments for CompileOnSaveEmitFileRequest
+ */
+ interface CompileOnSaveEmitFileRequestArgs extends FileRequestArgs {
+ /**
+ * if true - then file should be recompiled even if it does not have any changes.
+ */
+ forced?: boolean;
+ includeLinePosition?: boolean;
+ /** if true - return response as object with emitSkipped and diagnostics */
+ richResponse?: boolean;
+ }
+ interface CompileOnSaveEmitFileResponse extends Response {
+ body: boolean | EmitResult;
+ }
+ interface EmitResult {
+ emitSkipped: boolean;
+ diagnostics: Diagnostic[] | DiagnosticWithLinePosition[];
+ }
+ /**
+ * Quickinfo request; value of command field is
+ * "quickinfo". Return response giving a quick type and
+ * documentation string for the symbol found in file at location
+ * line, col.
+ */
+ interface QuickInfoRequest extends FileLocationRequest {
+ command: CommandTypes.Quickinfo;
+ }
+ /**
+ * Body of QuickInfoResponse.
+ */
+ interface QuickInfoResponseBody {
+ /**
+ * The symbol's kind (such as 'className' or 'parameterName' or plain 'text').
+ */
+ kind: ScriptElementKind;
+ /**
+ * Optional modifiers for the kind (such as 'public').
+ */
+ kindModifiers: string;
+ /**
+ * Starting file location of symbol.
+ */
+ start: Location;
+ /**
+ * One past last character of symbol.
+ */
+ end: Location;
+ /**
+ * Type and kind of symbol.
+ */
+ displayString: string;
+ /**
+ * Documentation associated with symbol.
+ */
+ documentation: string;
+ /**
+ * JSDoc tags associated with symbol.
+ */
+ tags: JSDocTagInfo[];
+ }
+ /**
+ * Quickinfo response message.
+ */
+ interface QuickInfoResponse extends Response {
+ body?: QuickInfoResponseBody;
+ }
+ /**
+ * Arguments for format messages.
+ */
+ interface FormatRequestArgs extends FileLocationRequestArgs {
+ /**
+ * Last line of range for which to format text in file.
+ */
+ endLine: number;
+ /**
+ * Character offset on last line of range for which to format text in file.
+ */
+ endOffset: number;
+ /**
+ * Format options to be used.
+ */
+ options?: FormatCodeSettings;
+ }
+ /**
+ * Format request; value of command field is "format". Return
+ * response giving zero or more edit instructions. The edit
+ * instructions will be sorted in file order. Applying the edit
+ * instructions in reverse to file will result in correctly
+ * reformatted text.
+ */
+ interface FormatRequest extends FileLocationRequest {
+ command: CommandTypes.Format;
+ arguments: FormatRequestArgs;
+ }
+ /**
+ * Object found in response messages defining an editing
+ * instruction for a span of text in source code. The effect of
+ * this instruction is to replace the text starting at start and
+ * ending one character before end with newText. For an insertion,
+ * the text span is empty. For a deletion, newText is empty.
+ */
+ interface CodeEdit {
+ /**
+ * First character of the text span to edit.
+ */
+ start: Location;
+ /**
+ * One character past last character of the text span to edit.
+ */
+ end: Location;
+ /**
+ * Replace the span defined above with this string (may be
+ * the empty string).
+ */
+ newText: string;
+ }
+ interface FileCodeEdits {
+ fileName: string;
+ textChanges: CodeEdit[];
+ }
+ interface CodeFixResponse extends Response {
+ /** The code actions that are available */
+ body?: CodeFixAction[];
+ }
+ interface CodeAction {
+ /** Description of the code action to display in the UI of the editor */
+ description: string;
+ /** Text changes to apply to each file as part of the code action */
+ changes: FileCodeEdits[];
+ /** A command is an opaque object that should be passed to `ApplyCodeActionCommandRequestArgs` without modification. */
+ commands?: {}[];
+ }
+ interface CombinedCodeActions {
+ changes: readonly FileCodeEdits[];
+ commands?: readonly {}[];
+ }
+ interface CodeFixAction extends CodeAction {
+ /** Short name to identify the fix, for use by telemetry. */
+ fixName: string;
+ /**
+ * If present, one may call 'getCombinedCodeFix' with this fixId.
+ * This may be omitted to indicate that the code fix can't be applied in a group.
+ */
+ fixId?: {};
+ /** Should be present if and only if 'fixId' is. */
+ fixAllDescription?: string;
+ }
+ /**
+ * Format and format on key response message.
+ */
+ interface FormatResponse extends Response {
+ body?: CodeEdit[];
+ }
+ /**
+ * Arguments for format on key messages.
+ */
+ interface FormatOnKeyRequestArgs extends FileLocationRequestArgs {
+ /**
+ * Key pressed (';', '\n', or '}').
+ */
+ key: string;
+ options?: FormatCodeSettings;
+ }
+ /**
+ * Format on key request; value of command field is
+ * "formatonkey". Given file location and key typed (as string),
+ * return response giving zero or more edit instructions. The
+ * edit instructions will be sorted in file order. Applying the
+ * edit instructions in reverse to file will result in correctly
+ * reformatted text.
+ */
+ interface FormatOnKeyRequest extends FileLocationRequest {
+ command: CommandTypes.Formatonkey;
+ arguments: FormatOnKeyRequestArgs;
+ }
+ type CompletionsTriggerCharacter = "." | '"' | "'" | "`" | "/" | "@" | "<" | "#";
+ /**
+ * Arguments for completions messages.
+ */
+ interface CompletionsRequestArgs extends FileLocationRequestArgs {
+ /**
+ * Optional prefix to apply to possible completions.
+ */
+ prefix?: string;
+ /**
+ * Character that was responsible for triggering completion.
+ * Should be `undefined` if a user manually requested completion.
+ */
+ triggerCharacter?: CompletionsTriggerCharacter;
+ /**
+ * @deprecated Use UserPreferences.includeCompletionsForModuleExports
+ */
+ includeExternalModuleExports?: boolean;
+ /**
+ * @deprecated Use UserPreferences.includeCompletionsWithInsertText
+ */
+ includeInsertTextCompletions?: boolean;
+ }
+ /**
+ * Completions request; value of command field is "completions".
+ * Given a file location (file, line, col) and a prefix (which may
+ * be the empty string), return the possible completions that
+ * begin with prefix.
+ */
+ interface CompletionsRequest extends FileLocationRequest {
+ command: CommandTypes.Completions | CommandTypes.CompletionInfo;
+ arguments: CompletionsRequestArgs;
+ }
+ /**
+ * Arguments for completion details request.
+ */
+ interface CompletionDetailsRequestArgs extends FileLocationRequestArgs {
+ /**
+ * Names of one or more entries for which to obtain details.
+ */
+ entryNames: (string | CompletionEntryIdentifier)[];
+ }
+ interface CompletionEntryIdentifier {
+ name: string;
+ source?: string;
+ }
+ /**
+ * Completion entry details request; value of command field is
+ * "completionEntryDetails". Given a file location (file, line,
+ * col) and an array of completion entry names return more
+ * detailed information for each completion entry.
+ */
+ interface CompletionDetailsRequest extends FileLocationRequest {
+ command: CommandTypes.CompletionDetails;
+ arguments: CompletionDetailsRequestArgs;
+ }
+ /**
+ * Part of a symbol description.
+ */
+ interface SymbolDisplayPart {
+ /**
+ * Text of an item describing the symbol.
+ */
+ text: string;
+ /**
+ * The symbol's kind (such as 'className' or 'parameterName' or plain 'text').
+ */
+ kind: string;
+ }
+ /**
+ * An item found in a completion response.
+ */
+ interface CompletionEntry {
+ /**
+ * The symbol's name.
+ */
+ name: string;
+ /**
+ * The symbol's kind (such as 'className' or 'parameterName').
+ */
+ kind: ScriptElementKind;
+ /**
+ * Optional modifiers for the kind (such as 'public').
+ */
+ kindModifiers?: string;
+ /**
+ * A string that is used for comparing completion items so that they can be ordered. This
+ * is often the same as the name but may be different in certain circumstances.
+ */
+ sortText: string;
+ /**
+ * Text to insert instead of `name`.
+ * This is used to support bracketed completions; If `name` might be "a-b" but `insertText` would be `["a-b"]`,
+ * coupled with `replacementSpan` to replace a dotted access with a bracket access.
+ */
+ insertText?: string;
+ /**
+ * An optional span that indicates the text to be replaced by this completion item.
+ * If present, this span should be used instead of the default one.
+ * It will be set if the required span differs from the one generated by the default replacement behavior.
+ */
+ replacementSpan?: TextSpan;
+ /**
+ * Indicates whether commiting this completion entry will require additional code actions to be
+ * made to avoid errors. The CompletionEntryDetails will have these actions.
+ */
+ hasAction?: true;
+ /**
+ * Identifier (not necessarily human-readable) identifying where this completion came from.
+ */
+ source?: string;
+ /**
+ * If true, this completion should be highlighted as recommended. There will only be one of these.
+ * This will be set when we know the user should write an expression with a certain type and that type is an enum or constructable class.
+ * Then either that enum/class or a namespace containing it will be the recommended symbol.
+ */
+ isRecommended?: true;
+ /**
+ * If true, this completion was generated from traversing the name table of an unchecked JS file,
+ * and therefore may not be accurate.
+ */
+ isFromUncheckedFile?: true;
+ }
+ /**
+ * Additional completion entry details, available on demand
+ */
+ interface CompletionEntryDetails {
+ /**
+ * The symbol's name.
+ */
+ name: string;
+ /**
+ * The symbol's kind (such as 'className' or 'parameterName').
+ */
+ kind: ScriptElementKind;
+ /**
+ * Optional modifiers for the kind (such as 'public').
+ */
+ kindModifiers: string;
+ /**
+ * Display parts of the symbol (similar to quick info).
+ */
+ displayParts: SymbolDisplayPart[];
+ /**
+ * Documentation strings for the symbol.
+ */
+ documentation?: SymbolDisplayPart[];
+ /**
+ * JSDoc tags for the symbol.
+ */
+ tags?: JSDocTagInfo[];
+ /**
+ * The associated code actions for this entry
+ */
+ codeActions?: CodeAction[];
+ /**
+ * Human-readable description of the `source` from the CompletionEntry.
+ */
+ source?: SymbolDisplayPart[];
+ }
+ /** @deprecated Prefer CompletionInfoResponse, which supports several top-level fields in addition to the array of entries. */
+ interface CompletionsResponse extends Response {
+ body?: CompletionEntry[];
+ }
+ interface CompletionInfoResponse extends Response {
+ body?: CompletionInfo;
+ }
+ interface CompletionInfo {
+ readonly isGlobalCompletion: boolean;
+ readonly isMemberCompletion: boolean;
+ readonly isNewIdentifierLocation: boolean;
+ readonly entries: readonly CompletionEntry[];
+ }
+ interface CompletionDetailsResponse extends Response {
+ body?: CompletionEntryDetails[];
+ }
+ /**
+ * Signature help information for a single parameter
+ */
+ interface SignatureHelpParameter {
+ /**
+ * The parameter's name
+ */
+ name: string;
+ /**
+ * Documentation of the parameter.
+ */
+ documentation: SymbolDisplayPart[];
+ /**
+ * Display parts of the parameter.
+ */
+ displayParts: SymbolDisplayPart[];
+ /**
+ * Whether the parameter is optional or not.
+ */
+ isOptional: boolean;
+ }
+ /**
+ * Represents a single signature to show in signature help.
+ */
+ interface SignatureHelpItem {
+ /**
+ * Whether the signature accepts a variable number of arguments.
+ */
+ isVariadic: boolean;
+ /**
+ * The prefix display parts.
+ */
+ prefixDisplayParts: SymbolDisplayPart[];
+ /**
+ * The suffix display parts.
+ */
+ suffixDisplayParts: SymbolDisplayPart[];
+ /**
+ * The separator display parts.
+ */
+ separatorDisplayParts: SymbolDisplayPart[];
+ /**
+ * The signature helps items for the parameters.
+ */
+ parameters: SignatureHelpParameter[];
+ /**
+ * The signature's documentation
+ */
+ documentation: SymbolDisplayPart[];
+ /**
+ * The signature's JSDoc tags
+ */
+ tags: JSDocTagInfo[];
+ }
+ /**
+ * Signature help items found in the response of a signature help request.
+ */
+ interface SignatureHelpItems {
+ /**
+ * The signature help items.
+ */
+ items: SignatureHelpItem[];
+ /**
+ * The span for which signature help should appear on a signature
+ */
+ applicableSpan: TextSpan;
+ /**
+ * The item selected in the set of available help items.
+ */
+ selectedItemIndex: number;
+ /**
+ * The argument selected in the set of parameters.
+ */
+ argumentIndex: number;
+ /**
+ * The argument count
+ */
+ argumentCount: number;
+ }
+ type SignatureHelpTriggerCharacter = "," | "(" | "<";
+ type SignatureHelpRetriggerCharacter = SignatureHelpTriggerCharacter | ")";
+ /**
+ * Arguments of a signature help request.
+ */
+ interface SignatureHelpRequestArgs extends FileLocationRequestArgs {
+ /**
+ * Reason why signature help was invoked.
+ * See each individual possible
+ */
+ triggerReason?: SignatureHelpTriggerReason;
+ }
+ type SignatureHelpTriggerReason = SignatureHelpInvokedReason | SignatureHelpCharacterTypedReason | SignatureHelpRetriggeredReason;
+ /**
+ * Signals that the user manually requested signature help.
+ * The language service will unconditionally attempt to provide a result.
+ */
+ interface SignatureHelpInvokedReason {
+ kind: "invoked";
+ triggerCharacter?: undefined;
+ }
+ /**
+ * Signals that the signature help request came from a user typing a character.
+ * Depending on the character and the syntactic context, the request may or may not be served a result.
+ */
+ interface SignatureHelpCharacterTypedReason {
+ kind: "characterTyped";
+ /**
+ * Character that was responsible for triggering signature help.
+ */
+ triggerCharacter: SignatureHelpTriggerCharacter;
+ }
+ /**
+ * Signals that this signature help request came from typing a character or moving the cursor.
+ * This should only occur if a signature help session was already active and the editor needs to see if it should adjust.
+ * The language service will unconditionally attempt to provide a result.
+ * `triggerCharacter` can be `undefined` for a retrigger caused by a cursor move.
+ */
+ interface SignatureHelpRetriggeredReason {
+ kind: "retrigger";
+ /**
+ * Character that was responsible for triggering signature help.
+ */
+ triggerCharacter?: SignatureHelpRetriggerCharacter;
+ }
+ /**
+ * Signature help request; value of command field is "signatureHelp".
+ * Given a file location (file, line, col), return the signature
+ * help.
+ */
+ interface SignatureHelpRequest extends FileLocationRequest {
+ command: CommandTypes.SignatureHelp;
+ arguments: SignatureHelpRequestArgs;
+ }
+ /**
+ * Response object for a SignatureHelpRequest.
+ */
+ interface SignatureHelpResponse extends Response {
+ body?: SignatureHelpItems;
+ }
+ /**
+ * Synchronous request for semantic diagnostics of one file.
+ */
+ interface SemanticDiagnosticsSyncRequest extends FileRequest {
+ command: CommandTypes.SemanticDiagnosticsSync;
+ arguments: SemanticDiagnosticsSyncRequestArgs;
+ }
+ interface SemanticDiagnosticsSyncRequestArgs extends FileRequestArgs {
+ includeLinePosition?: boolean;
+ }
+ /**
+ * Response object for synchronous sematic diagnostics request.
+ */
+ interface SemanticDiagnosticsSyncResponse extends Response {
+ body?: Diagnostic[] | DiagnosticWithLinePosition[];
+ }
+ interface SuggestionDiagnosticsSyncRequest extends FileRequest {
+ command: CommandTypes.SuggestionDiagnosticsSync;
+ arguments: SuggestionDiagnosticsSyncRequestArgs;
+ }
+ type SuggestionDiagnosticsSyncRequestArgs = SemanticDiagnosticsSyncRequestArgs;
+ type SuggestionDiagnosticsSyncResponse = SemanticDiagnosticsSyncResponse;
+ /**
+ * Synchronous request for syntactic diagnostics of one file.
+ */
+ interface SyntacticDiagnosticsSyncRequest extends FileRequest {
+ command: CommandTypes.SyntacticDiagnosticsSync;
+ arguments: SyntacticDiagnosticsSyncRequestArgs;
+ }
+ interface SyntacticDiagnosticsSyncRequestArgs extends FileRequestArgs {
+ includeLinePosition?: boolean;
+ }
+ /**
+ * Response object for synchronous syntactic diagnostics request.
+ */
+ interface SyntacticDiagnosticsSyncResponse extends Response {
+ body?: Diagnostic[] | DiagnosticWithLinePosition[];
+ }
+ /**
+ * Arguments for GeterrForProject request.
+ */
+ interface GeterrForProjectRequestArgs {
+ /**
+ * the file requesting project error list
+ */
+ file: string;
+ /**
+ * Delay in milliseconds to wait before starting to compute
+ * errors for the files in the file list
+ */
+ delay: number;
+ }
+ /**
+ * GeterrForProjectRequest request; value of command field is
+ * "geterrForProject". It works similarly with 'Geterr', only
+ * it request for every file in this project.
+ */
+ interface GeterrForProjectRequest extends Request {
+ command: CommandTypes.GeterrForProject;
+ arguments: GeterrForProjectRequestArgs;
+ }
+ /**
+ * Arguments for geterr messages.
+ */
+ interface GeterrRequestArgs {
+ /**
+ * List of file names for which to compute compiler errors.
+ * The files will be checked in list order.
+ */
+ files: string[];
+ /**
+ * Delay in milliseconds to wait before starting to compute
+ * errors for the files in the file list
+ */
+ delay: number;
+ }
+ /**
+ * Geterr request; value of command field is "geterr". Wait for
+ * delay milliseconds and then, if during the wait no change or
+ * reload messages have arrived for the first file in the files
+ * list, get the syntactic errors for the file, field requests,
+ * and then get the semantic errors for the file. Repeat with a
+ * smaller delay for each subsequent file on the files list. Best
+ * practice for an editor is to send a file list containing each
+ * file that is currently visible, in most-recently-used order.
+ */
+ interface GeterrRequest extends Request {
+ command: CommandTypes.Geterr;
+ arguments: GeterrRequestArgs;
+ }
+ type RequestCompletedEventName = "requestCompleted";
+ /**
+ * Event that is sent when server have finished processing request with specified id.
+ */
+ interface RequestCompletedEvent extends Event {
+ event: RequestCompletedEventName;
+ body: RequestCompletedEventBody;
+ }
+ interface RequestCompletedEventBody {
+ request_seq: number;
+ }
+ /**
+ * Item of diagnostic information found in a DiagnosticEvent message.
+ */
+ interface Diagnostic {
+ /**
+ * Starting file location at which text applies.
+ */
+ start: Location;
+ /**
+ * The last file location at which the text applies.
+ */
+ end: Location;
+ /**
+ * Text of diagnostic message.
+ */
+ text: string;
+ /**
+ * The category of the diagnostic message, e.g. "error", "warning", or "suggestion".
+ */
+ category: string;
+ reportsUnnecessary?: {};
+ /**
+ * Any related spans the diagnostic may have, such as other locations relevant to an error, such as declarartion sites
+ */
+ relatedInformation?: DiagnosticRelatedInformation[];
+ /**
+ * The error code of the diagnostic message.
+ */
+ code?: number;
+ /**
+ * The name of the plugin reporting the message.
+ */
+ source?: string;
+ }
+ interface DiagnosticWithFileName extends Diagnostic {
+ /**
+ * Name of the file the diagnostic is in
+ */
+ fileName: string;
+ }
+ /**
+ * Represents additional spans returned with a diagnostic which are relevant to it
+ */
+ interface DiagnosticRelatedInformation {
+ /**
+ * The category of the related information message, e.g. "error", "warning", or "suggestion".
+ */
+ category: string;
+ /**
+ * The code used ot identify the related information
+ */
+ code: number;
+ /**
+ * Text of related or additional information.
+ */
+ message: string;
+ /**
+ * Associated location
+ */
+ span?: FileSpan;
+ }
+ interface DiagnosticEventBody {
+ /**
+ * The file for which diagnostic information is reported.
+ */
+ file: string;
+ /**
+ * An array of diagnostic information items.
+ */
+ diagnostics: Diagnostic[];
+ }
+ type DiagnosticEventKind = "semanticDiag" | "syntaxDiag" | "suggestionDiag";
+ /**
+ * Event message for DiagnosticEventKind event types.
+ * These events provide syntactic and semantic errors for a file.
+ */
+ interface DiagnosticEvent extends Event {
+ body?: DiagnosticEventBody;
+ event: DiagnosticEventKind;
+ }
+ interface ConfigFileDiagnosticEventBody {
+ /**
+ * The file which trigged the searching and error-checking of the config file
+ */
+ triggerFile: string;
+ /**
+ * The name of the found config file.
+ */
+ configFile: string;
+ /**
+ * An arry of diagnostic information items for the found config file.
+ */
+ diagnostics: DiagnosticWithFileName[];
+ }
+ /**
+ * Event message for "configFileDiag" event type.
+ * This event provides errors for a found config file.
+ */
+ interface ConfigFileDiagnosticEvent extends Event {
+ body?: ConfigFileDiagnosticEventBody;
+ event: "configFileDiag";
+ }
+ type ProjectLanguageServiceStateEventName = "projectLanguageServiceState";
+ interface ProjectLanguageServiceStateEvent extends Event {
+ event: ProjectLanguageServiceStateEventName;
+ body?: ProjectLanguageServiceStateEventBody;
+ }
+ interface ProjectLanguageServiceStateEventBody {
+ /**
+ * Project name that has changes in the state of language service.
+ * For configured projects this will be the config file path.
+ * For external projects this will be the name of the projects specified when project was open.
+ * For inferred projects this event is not raised.
+ */
+ projectName: string;
+ /**
+ * True if language service state switched from disabled to enabled
+ * and false otherwise.
+ */
+ languageServiceEnabled: boolean;
+ }
+ type ProjectsUpdatedInBackgroundEventName = "projectsUpdatedInBackground";
+ interface ProjectsUpdatedInBackgroundEvent extends Event {
+ event: ProjectsUpdatedInBackgroundEventName;
+ body: ProjectsUpdatedInBackgroundEventBody;
+ }
+ interface ProjectsUpdatedInBackgroundEventBody {
+ /**
+ * Current set of open files
+ */
+ openFiles: string[];
+ }
+ type ProjectLoadingStartEventName = "projectLoadingStart";
+ interface ProjectLoadingStartEvent extends Event {
+ event: ProjectLoadingStartEventName;
+ body: ProjectLoadingStartEventBody;
+ }
+ interface ProjectLoadingStartEventBody {
+ /** name of the project */
+ projectName: string;
+ /** reason for loading */
+ reason: string;
+ }
+ type ProjectLoadingFinishEventName = "projectLoadingFinish";
+ interface ProjectLoadingFinishEvent extends Event {
+ event: ProjectLoadingFinishEventName;
+ body: ProjectLoadingFinishEventBody;
+ }
+ interface ProjectLoadingFinishEventBody {
+ /** name of the project */
+ projectName: string;
+ }
+ type SurveyReadyEventName = "surveyReady";
+ interface SurveyReadyEvent extends Event {
+ event: SurveyReadyEventName;
+ body: SurveyReadyEventBody;
+ }
+ interface SurveyReadyEventBody {
+ /** Name of the survey. This is an internal machine- and programmer-friendly name */
+ surveyId: string;
+ }
+ type LargeFileReferencedEventName = "largeFileReferenced";
+ interface LargeFileReferencedEvent extends Event {
+ event: LargeFileReferencedEventName;
+ body: LargeFileReferencedEventBody;
+ }
+ interface LargeFileReferencedEventBody {
+ /**
+ * name of the large file being loaded
+ */
+ file: string;
+ /**
+ * size of the file
+ */
+ fileSize: number;
+ /**
+ * max file size allowed on the server
+ */
+ maxFileSize: number;
+ }
+ /**
+ * Arguments for reload request.
+ */
+ interface ReloadRequestArgs extends FileRequestArgs {
+ /**
+ * Name of temporary file from which to reload file
+ * contents. May be same as file.
+ */
+ tmpfile: string;
+ }
+ /**
+ * Reload request message; value of command field is "reload".
+ * Reload contents of file with name given by the 'file' argument
+ * from temporary file with name given by the 'tmpfile' argument.
+ * The two names can be identical.
+ */
+ interface ReloadRequest extends FileRequest {
+ command: CommandTypes.Reload;
+ arguments: ReloadRequestArgs;
+ }
+ /**
+ * Response to "reload" request. This is just an acknowledgement, so
+ * no body field is required.
+ */
+ interface ReloadResponse extends Response {
+ }
+ /**
+ * Arguments for saveto request.
+ */
+ interface SavetoRequestArgs extends FileRequestArgs {
+ /**
+ * Name of temporary file into which to save server's view of
+ * file contents.
+ */
+ tmpfile: string;
+ }
+ /**
+ * Saveto request message; value of command field is "saveto".
+ * For debugging purposes, save to a temporaryfile (named by
+ * argument 'tmpfile') the contents of file named by argument
+ * 'file'. The server does not currently send a response to a
+ * "saveto" request.
+ */
+ interface SavetoRequest extends FileRequest {
+ command: CommandTypes.Saveto;
+ arguments: SavetoRequestArgs;
+ }
+ /**
+ * Arguments for navto request message.
+ */
+ interface NavtoRequestArgs {
+ /**
+ * Search term to navigate to from current location; term can
+ * be '.*' or an identifier prefix.
+ */
+ searchValue: string;
+ /**
+ * Optional limit on the number of items to return.
+ */
+ maxResultCount?: number;
+ /**
+ * The file for the request (absolute pathname required).
+ */
+ file?: string;
+ /**
+ * Optional flag to indicate we want results for just the current file
+ * or the entire project.
+ */
+ currentFileOnly?: boolean;
+ projectFileName?: string;
+ }
+ /**
+ * Navto request message; value of command field is "navto".
+ * Return list of objects giving file locations and symbols that
+ * match the search term given in argument 'searchTerm'. The
+ * context for the search is given by the named file.
+ */
+ interface NavtoRequest extends Request {
+ command: CommandTypes.Navto;
+ arguments: NavtoRequestArgs;
+ }
+ /**
+ * An item found in a navto response.
+ */
+ interface NavtoItem extends FileSpan {
+ /**
+ * The symbol's name.
+ */
+ name: string;
+ /**
+ * The symbol's kind (such as 'className' or 'parameterName').
+ */
+ kind: ScriptElementKind;
+ /**
+ * exact, substring, or prefix.
+ */
+ matchKind: string;
+ /**
+ * If this was a case sensitive or insensitive match.
+ */
+ isCaseSensitive: boolean;
+ /**
+ * Optional modifiers for the kind (such as 'public').
+ */
+ kindModifiers?: string;
+ /**
+ * Name of symbol's container symbol (if any); for example,
+ * the class name if symbol is a class member.
+ */
+ containerName?: string;
+ /**
+ * Kind of symbol's container symbol (if any).
+ */
+ containerKind?: ScriptElementKind;
+ }
+ /**
+ * Navto response message. Body is an array of navto items. Each
+ * item gives a symbol that matched the search term.
+ */
+ interface NavtoResponse extends Response {
+ body?: NavtoItem[];
+ }
+ /**
+ * Arguments for change request message.
+ */
+ interface ChangeRequestArgs extends FormatRequestArgs {
+ /**
+ * Optional string to insert at location (file, line, offset).
+ */
+ insertString?: string;
+ }
+ /**
+ * Change request message; value of command field is "change".
+ * Update the server's view of the file named by argument 'file'.
+ * Server does not currently send a response to a change request.
+ */
+ interface ChangeRequest extends FileLocationRequest {
+ command: CommandTypes.Change;
+ arguments: ChangeRequestArgs;
+ }
+ /**
+ * Response to "brace" request.
+ */
+ interface BraceResponse extends Response {
+ body?: TextSpan[];
+ }
+ /**
+ * Brace matching request; value of command field is "brace".
+ * Return response giving the file locations of matching braces
+ * found in file at location line, offset.
+ */
+ interface BraceRequest extends FileLocationRequest {
+ command: CommandTypes.Brace;
+ }
+ /**
+ * NavBar items request; value of command field is "navbar".
+ * Return response giving the list of navigation bar entries
+ * extracted from the requested file.
+ */
+ interface NavBarRequest extends FileRequest {
+ command: CommandTypes.NavBar;
+ }
+ /**
+ * NavTree request; value of command field is "navtree".
+ * Return response giving the navigation tree of the requested file.
+ */
+ interface NavTreeRequest extends FileRequest {
+ command: CommandTypes.NavTree;
+ }
+ interface NavigationBarItem {
+ /**
+ * The item's display text.
+ */
+ text: string;
+ /**
+ * The symbol's kind (such as 'className' or 'parameterName').
+ */
+ kind: ScriptElementKind;
+ /**
+ * Optional modifiers for the kind (such as 'public').
+ */
+ kindModifiers?: string;
+ /**
+ * The definition locations of the item.
+ */
+ spans: TextSpan[];
+ /**
+ * Optional children.
+ */
+ childItems?: NavigationBarItem[];
+ /**
+ * Number of levels deep this item should appear.
+ */
+ indent: number;
+ }
+ /** protocol.NavigationTree is identical to ts.NavigationTree, except using protocol.TextSpan instead of ts.TextSpan */
+ interface NavigationTree {
+ text: string;
+ kind: ScriptElementKind;
+ kindModifiers: string;
+ spans: TextSpan[];
+ nameSpan: TextSpan | undefined;
+ childItems?: NavigationTree[];
+ }
+ type TelemetryEventName = "telemetry";
+ interface TelemetryEvent extends Event {
+ event: TelemetryEventName;
+ body: TelemetryEventBody;
+ }
+ interface TelemetryEventBody {
+ telemetryEventName: string;
+ payload: any;
+ }
+ type TypesInstallerInitializationFailedEventName = "typesInstallerInitializationFailed";
+ interface TypesInstallerInitializationFailedEvent extends Event {
+ event: TypesInstallerInitializationFailedEventName;
+ body: TypesInstallerInitializationFailedEventBody;
+ }
+ interface TypesInstallerInitializationFailedEventBody {
+ message: string;
+ }
+ type TypingsInstalledTelemetryEventName = "typingsInstalled";
+ interface TypingsInstalledTelemetryEventBody extends TelemetryEventBody {
+ telemetryEventName: TypingsInstalledTelemetryEventName;
+ payload: TypingsInstalledTelemetryEventPayload;
+ }
+ interface TypingsInstalledTelemetryEventPayload {
+ /**
+ * Comma separated list of installed typing packages
+ */
+ installedPackages: string;
+ /**
+ * true if install request succeeded, otherwise - false
+ */
+ installSuccess: boolean;
+ /**
+ * version of typings installer
+ */
+ typingsInstallerVersion: string;
+ }
+ type BeginInstallTypesEventName = "beginInstallTypes";
+ type EndInstallTypesEventName = "endInstallTypes";
+ interface BeginInstallTypesEvent extends Event {
+ event: BeginInstallTypesEventName;
+ body: BeginInstallTypesEventBody;
+ }
+ interface EndInstallTypesEvent extends Event {
+ event: EndInstallTypesEventName;
+ body: EndInstallTypesEventBody;
+ }
+ interface InstallTypesEventBody {
+ /**
+ * correlation id to match begin and end events
+ */
+ eventId: number;
+ /**
+ * list of packages to install
+ */
+ packages: readonly string[];
+ }
+ interface BeginInstallTypesEventBody extends InstallTypesEventBody {
+ }
+ interface EndInstallTypesEventBody extends InstallTypesEventBody {
+ /**
+ * true if installation succeeded, otherwise false
+ */
+ success: boolean;
+ }
+ interface NavBarResponse extends Response {
+ body?: NavigationBarItem[];
+ }
+ interface NavTreeResponse extends Response {
+ body?: NavigationTree;
+ }
+ interface CallHierarchyItem {
+ name: string;
+ kind: ScriptElementKind;
+ file: string;
+ span: TextSpan;
+ selectionSpan: TextSpan;
+ }
+ interface CallHierarchyIncomingCall {
+ from: CallHierarchyItem;
+ fromSpans: TextSpan[];
+ }
+ interface CallHierarchyOutgoingCall {
+ to: CallHierarchyItem;
+ fromSpans: TextSpan[];
+ }
+ interface PrepareCallHierarchyRequest extends FileLocationRequest {
+ command: CommandTypes.PrepareCallHierarchy;
+ }
+ interface PrepareCallHierarchyResponse extends Response {
+ readonly body: CallHierarchyItem | CallHierarchyItem[];
+ }
+ interface ProvideCallHierarchyIncomingCallsRequest extends FileLocationRequest {
+ command: CommandTypes.ProvideCallHierarchyIncomingCalls;
+ }
+ interface ProvideCallHierarchyIncomingCallsResponse extends Response {
+ readonly body: CallHierarchyIncomingCall[];
+ }
+ interface ProvideCallHierarchyOutgoingCallsRequest extends FileLocationRequest {
+ command: CommandTypes.ProvideCallHierarchyOutgoingCalls;
+ }
+ interface ProvideCallHierarchyOutgoingCallsResponse extends Response {
+ readonly body: CallHierarchyOutgoingCall[];
+ }
+ enum IndentStyle {
+ None = "None",
+ Block = "Block",
+ Smart = "Smart"
+ }
+ enum SemicolonPreference {
+ Ignore = "ignore",
+ Insert = "insert",
+ Remove = "remove"
+ }
+ interface EditorSettings {
+ baseIndentSize?: number;
+ indentSize?: number;
+ tabSize?: number;
+ newLineCharacter?: string;
+ convertTabsToSpaces?: boolean;
+ indentStyle?: IndentStyle | ts.IndentStyle;
+ trimTrailingWhitespace?: boolean;
+ }
+ interface FormatCodeSettings extends EditorSettings {
+ insertSpaceAfterCommaDelimiter?: boolean;
+ insertSpaceAfterSemicolonInForStatements?: boolean;
+ insertSpaceBeforeAndAfterBinaryOperators?: boolean;
+ insertSpaceAfterConstructor?: boolean;
+ insertSpaceAfterKeywordsInControlFlowStatements?: boolean;
+ insertSpaceAfterFunctionKeywordForAnonymousFunctions?: boolean;
+ insertSpaceAfterOpeningAndBeforeClosingNonemptyParenthesis?: boolean;
+ insertSpaceAfterOpeningAndBeforeClosingNonemptyBrackets?: boolean;
+ insertSpaceAfterOpeningAndBeforeClosingNonemptyBraces?: boolean;
+ insertSpaceAfterOpeningAndBeforeClosingTemplateStringBraces?: boolean;
+ insertSpaceAfterOpeningAndBeforeClosingJsxExpressionBraces?: boolean;
+ insertSpaceAfterTypeAssertion?: boolean;
+ insertSpaceBeforeFunctionParenthesis?: boolean;
+ placeOpenBraceOnNewLineForFunctions?: boolean;
+ placeOpenBraceOnNewLineForControlBlocks?: boolean;
+ insertSpaceBeforeTypeAnnotation?: boolean;
+ semicolons?: SemicolonPreference;
+ }
+ interface UserPreferences {
+ readonly disableSuggestions?: boolean;
+ readonly quotePreference?: "auto" | "double" | "single";
+ /**
+ * If enabled, TypeScript will search through all external modules' exports and add them to the completions list.
+ * This affects lone identifier completions but not completions on the right hand side of `obj.`.
+ */
+ readonly includeCompletionsForModuleExports?: boolean;
+ /**
+ * If enabled, the completion list will include completions with invalid identifier names.
+ * For those entries, The `insertText` and `replacementSpan` properties will be set to change from `.x` property access to `["x"]`.
+ */
+ readonly includeCompletionsWithInsertText?: boolean;
+ /**
+ * Unless this option is `false`, or `includeCompletionsWithInsertText` is not enabled,
+ * member completion lists triggered with `.` will include entries on potentially-null and potentially-undefined
+ * values, with insertion text to replace preceding `.` tokens with `?.`.
+ */
+ readonly includeAutomaticOptionalChainCompletions?: boolean;
+ readonly importModuleSpecifierPreference?: "auto" | "relative" | "non-relative";
+ /** Determines whether we import `foo/index.ts` as "foo", "foo/index", or "foo/index.js" */
+ readonly importModuleSpecifierEnding?: "auto" | "minimal" | "index" | "js";
+ readonly allowTextChangesInNewFiles?: boolean;
+ readonly lazyConfiguredProjectsFromExternalProject?: boolean;
+ readonly providePrefixAndSuffixTextForRename?: boolean;
+ readonly allowRenameOfImportPath?: boolean;
+ }
+ interface CompilerOptions {
+ allowJs?: boolean;
+ allowSyntheticDefaultImports?: boolean;
+ allowUnreachableCode?: boolean;
+ allowUnusedLabels?: boolean;
+ alwaysStrict?: boolean;
+ baseUrl?: string;
+ charset?: string;
+ checkJs?: boolean;
+ declaration?: boolean;
+ declarationDir?: string;
+ disableSizeLimit?: boolean;
+ downlevelIteration?: boolean;
+ emitBOM?: boolean;
+ emitDecoratorMetadata?: boolean;
+ experimentalDecorators?: boolean;
+ forceConsistentCasingInFileNames?: boolean;
+ importHelpers?: boolean;
+ inlineSourceMap?: boolean;
+ inlineSources?: boolean;
+ isolatedModules?: boolean;
+ jsx?: JsxEmit | ts.JsxEmit;
+ lib?: string[];
+ locale?: string;
+ mapRoot?: string;
+ maxNodeModuleJsDepth?: number;
+ module?: ModuleKind | ts.ModuleKind;
+ moduleResolution?: ModuleResolutionKind | ts.ModuleResolutionKind;
+ newLine?: NewLineKind | ts.NewLineKind;
+ noEmit?: boolean;
+ noEmitHelpers?: boolean;
+ noEmitOnError?: boolean;
+ noErrorTruncation?: boolean;
+ noFallthroughCasesInSwitch?: boolean;
+ noImplicitAny?: boolean;
+ noImplicitReturns?: boolean;
+ noImplicitThis?: boolean;
+ noUnusedLocals?: boolean;
+ noUnusedParameters?: boolean;
+ noImplicitUseStrict?: boolean;
+ noLib?: boolean;
+ noResolve?: boolean;
+ out?: string;
+ outDir?: string;
+ outFile?: string;
+ paths?: MapLike<string[]>;
+ plugins?: PluginImport[];
+ preserveConstEnums?: boolean;
+ preserveSymlinks?: boolean;
+ project?: string;
+ reactNamespace?: string;
+ removeComments?: boolean;
+ references?: ProjectReference[];
+ rootDir?: string;
+ rootDirs?: string[];
+ skipLibCheck?: boolean;
+ skipDefaultLibCheck?: boolean;
+ sourceMap?: boolean;
+ sourceRoot?: string;
+ strict?: boolean;
+ strictNullChecks?: boolean;
+ suppressExcessPropertyErrors?: boolean;
+ suppressImplicitAnyIndexErrors?: boolean;
+ useDefineForClassFields?: boolean;
+ target?: ScriptTarget | ts.ScriptTarget;
+ traceResolution?: boolean;
+ resolveJsonModule?: boolean;
+ types?: string[];
+ /** Paths used to used to compute primary types search locations */
+ typeRoots?: string[];
+ [option: string]: CompilerOptionsValue | undefined;
+ }
+ enum JsxEmit {
+ None = "None",
+ Preserve = "Preserve",
+ ReactNative = "ReactNative",
+ React = "React"
+ }
+ enum ModuleKind {
+ None = "None",
+ CommonJS = "CommonJS",
+ AMD = "AMD",
+ UMD = "UMD",
+ System = "System",
+ ES6 = "ES6",
+ ES2015 = "ES2015",
+ ESNext = "ESNext"
+ }
+ enum ModuleResolutionKind {
+ Classic = "Classic",
+ Node = "Node"
+ }
+ enum NewLineKind {
+ Crlf = "Crlf",
+ Lf = "Lf"
+ }
+ enum ScriptTarget {
+ ES3 = "ES3",
+ ES5 = "ES5",
+ ES6 = "ES6",
+ ES2015 = "ES2015",
+ ES2016 = "ES2016",
+ ES2017 = "ES2017",
+ ES2018 = "ES2018",
+ ES2019 = "ES2019",
+ ES2020 = "ES2020",
+ ESNext = "ESNext"
+ }
+}
+declare namespace ts.server {
+ interface ScriptInfoVersion {
+ svc: number;
+ text: number;
+ }
+ class ScriptInfo {
+ private readonly host;
+ readonly fileName: NormalizedPath;
+ readonly scriptKind: ScriptKind;
+ readonly hasMixedContent: boolean;
+ readonly path: Path;
+ /**
+ * All projects that include this file
+ */
+ readonly containingProjects: Project[];
+ private formatSettings;
+ private preferences;
+ private textStorage;
+ constructor(host: ServerHost, fileName: NormalizedPath, scriptKind: ScriptKind, hasMixedContent: boolean, path: Path, initialVersion?: ScriptInfoVersion);
+ isScriptOpen(): boolean;
+ open(newText: string): void;
+ close(fileExists?: boolean): void;
+ getSnapshot(): IScriptSnapshot;
+ private ensureRealPath;
+ getFormatCodeSettings(): FormatCodeSettings | undefined;
+ getPreferences(): protocol.UserPreferences | undefined;
+ attachToProject(project: Project): boolean;
+ isAttached(project: Project): boolean;
+ detachFromProject(project: Project): void;
+ detachAllProjects(): void;
+ getDefaultProject(): Project;
+ registerFileUpdate(): void;
+ setOptions(formatSettings: FormatCodeSettings, preferences: protocol.UserPreferences | undefined): void;
+ getLatestVersion(): string;
+ saveTo(fileName: string): void;
+ reloadFromFile(tempFileName?: NormalizedPath): boolean;
+ editContent(start: number, end: number, newText: string): void;
+ markContainingProjectsAsDirty(): void;
+ isOrphan(): boolean;
+ /**
+ * @param line 1 based index
+ */
+ lineToTextSpan(line: number): TextSpan;
+ /**
+ * @param line 1 based index
+ * @param offset 1 based index
+ */
+ lineOffsetToPosition(line: number, offset: number): number;
+ positionToLineOffset(position: number): protocol.Location;
+ isJavaScript(): boolean;
+ }
+}
+declare namespace ts.server {
+ interface InstallPackageOptionsWithProject extends InstallPackageOptions {
+ projectName: string;
+ projectRootPath: Path;
+ }
+ interface ITypingsInstaller {
+ isKnownTypesPackageName(name: string): boolean;
+ installPackage(options: InstallPackageOptionsWithProject): Promise<ApplyCodeActionCommandResult>;
+ enqueueInstallTypingsRequest(p: Project, typeAcquisition: TypeAcquisition, unresolvedImports: SortedReadonlyArray<string> | undefined): void;
+ attach(projectService: ProjectService): void;
+ onProjectClosed(p: Project): void;
+ readonly globalTypingsCacheLocation: string | undefined;
+ }
+ const nullTypingsInstaller: ITypingsInstaller;
+}
+declare namespace ts.server {
+ enum ProjectKind {
+ Inferred = 0,
+ Configured = 1,
+ External = 2
+ }
+ function allRootFilesAreJsOrDts(project: Project): boolean;
+ function allFilesAreJsOrDts(project: Project): boolean;
+ interface PluginCreateInfo {
+ project: Project;
+ languageService: LanguageService;
+ languageServiceHost: LanguageServiceHost;
+ serverHost: ServerHost;
+ config: any;
+ }
+ interface PluginModule {
+ create(createInfo: PluginCreateInfo): LanguageService;
+ getExternalFiles?(proj: Project): string[];
+ onConfigurationChanged?(config: any): void;
+ }
+ interface PluginModuleWithName {
+ name: string;
+ module: PluginModule;
+ }
+ type PluginModuleFactory = (mod: {
+ typescript: typeof ts;
+ }) => PluginModule;
+ abstract class Project implements LanguageServiceHost, ModuleResolutionHost {
+ readonly projectName: string;
+ readonly projectKind: ProjectKind;
+ readonly projectService: ProjectService;
+ private documentRegistry;
+ private compilerOptions;
+ compileOnSaveEnabled: boolean;
+ protected watchOptions: WatchOptions | undefined;
+ private rootFiles;
+ private rootFilesMap;
+ private program;
+ private externalFiles;
+ private missingFilesMap;
+ private generatedFilesMap;
+ private plugins;
+ private lastFileExceededProgramSize;
+ protected languageService: LanguageService;
+ languageServiceEnabled: boolean;
+ readonly trace?: (s: string) => void;
+ readonly realpath?: (path: string) => string;
+ private builderState;
+ /**
+ * Set of files names that were updated since the last call to getChangesSinceVersion.
+ */
+ private updatedFileNames;
+ /**
+ * Set of files that was returned from the last call to getChangesSinceVersion.
+ */
+ private lastReportedFileNames;
+ /**
+ * Last version that was reported.
+ */
+ private lastReportedVersion;
+ /**
+ * Current project's program version. (incremented everytime new program is created that is not complete reuse from the old one)
+ * This property is changed in 'updateGraph' based on the set of files in program
+ */
+ private projectProgramVersion;
+ /**
+ * Current version of the project state. It is changed when:
+ * - new root file was added/removed
+ * - edit happen in some file that is currently included in the project.
+ * This property is different from projectStructureVersion since in most cases edits don't affect set of files in the project
+ */
+ private projectStateVersion;
+ protected isInitialLoadPending: () => boolean;
+ private readonly cancellationToken;
+ isNonTsProject(): boolean;
+ isJsOnlyProject(): boolean;
+ static resolveModule(moduleName: string, initialDir: string, host: ServerHost, log: (message: string) => void, logErrors?: (message: string) => void): {} | undefined;
+ isKnownTypesPackageName(name: string): boolean;
+ installPackage(options: InstallPackageOptions): Promise<ApplyCodeActionCommandResult>;
+ private get typingsCache();
+ getCompilationSettings(): CompilerOptions;
+ getCompilerOptions(): CompilerOptions;
+ getNewLine(): string;
+ getProjectVersion(): string;
+ getProjectReferences(): readonly ProjectReference[] | undefined;
+ getScriptFileNames(): string[];
+ private getOrCreateScriptInfoAndAttachToProject;
+ getScriptKind(fileName: string): ScriptKind;
+ getScriptVersion(filename: string): string;
+ getScriptSnapshot(filename: string): IScriptSnapshot | undefined;
+ getCancellationToken(): HostCancellationToken;
+ getCurrentDirectory(): string;
+ getDefaultLibFileName(): string;
+ useCaseSensitiveFileNames(): boolean;
+ readDirectory(path: string, extensions?: readonly string[], exclude?: readonly string[], include?: readonly string[], depth?: number): string[];
+ readFile(fileName: string): string | undefined;
+ writeFile(fileName: string, content: string): void;
+ fileExists(file: string): boolean;
+ resolveModuleNames(moduleNames: string[], containingFile: string, reusedNames?: string[], redirectedReference?: ResolvedProjectReference): (ResolvedModuleFull | undefined)[];
+ getResolvedModuleWithFailedLookupLocationsFromCache(moduleName: string, containingFile: string): ResolvedModuleWithFailedLookupLocations | undefined;
+ resolveTypeReferenceDirectives(typeDirectiveNames: string[], containingFile: string, redirectedReference?: ResolvedProjectReference): (ResolvedTypeReferenceDirective | undefined)[];
+ directoryExists(path: string): boolean;
+ getDirectories(path: string): string[];
+ log(s: string): void;
+ error(s: string): void;
+ private setInternalCompilerOptionsForEmittingJsFiles;
+ /**
+ * Get the errors that dont have any file name associated
+ */
+ getGlobalProjectErrors(): readonly Diagnostic[];
+ getAllProjectErrors(): readonly Diagnostic[];
+ getLanguageService(ensureSynchronized?: boolean): LanguageService;
+ getCompileOnSaveAffectedFileList(scriptInfo: ScriptInfo): string[];
+ /**
+ * Returns true if emit was conducted
+ */
+ emitFile(scriptInfo: ScriptInfo, writeFile: (path: string, data: string, writeByteOrderMark?: boolean) => void): EmitResult;
+ enableLanguageService(): void;
+ disableLanguageService(lastFileExceededProgramSize?: string): void;
+ getProjectName(): string;
+ abstract getTypeAcquisition(): TypeAcquisition;
+ protected removeLocalTypingsFromTypeAcquisition(newTypeAcquisition: TypeAcquisition): TypeAcquisition;
+ getExternalFiles(): SortedReadonlyArray<string>;
+ getSourceFile(path: Path): SourceFile | undefined;
+ close(): void;
+ private detachScriptInfoIfNotRoot;
+ isClosed(): boolean;
+ hasRoots(): boolean;
+ getRootFiles(): NormalizedPath[];
+ getRootScriptInfos(): ScriptInfo[];
+ getScriptInfos(): ScriptInfo[];
+ getExcludedFiles(): readonly NormalizedPath[];
+ getFileNames(excludeFilesFromExternalLibraries?: boolean, excludeConfigFiles?: boolean): NormalizedPath[];
+ hasConfigFile(configFilePath: NormalizedPath): boolean;
+ containsScriptInfo(info: ScriptInfo): boolean;
+ containsFile(filename: NormalizedPath, requireOpen?: boolean): boolean;
+ isRoot(info: ScriptInfo): boolean;
+ addRoot(info: ScriptInfo, fileName?: NormalizedPath): void;
+ addMissingFileRoot(fileName: NormalizedPath): void;
+ removeFile(info: ScriptInfo, fileExists: boolean, detachFromProject: boolean): void;
+ registerFileUpdate(fileName: string): void;
+ markAsDirty(): void;
+ /**
+ * Updates set of files that contribute to this project
+ * @returns: true if set of files in the project stays the same and false - otherwise.
+ */
+ updateGraph(): boolean;
+ protected removeExistingTypings(include: string[]): string[];
+ private updateGraphWorker;
+ private detachScriptInfoFromProject;
+ private addMissingFileWatcher;
+ private isWatchedMissingFile;
+ private createGeneratedFileWatcher;
+ private isValidGeneratedFileWatcher;
+ private clearGeneratedFileWatch;
+ getScriptInfoForNormalizedPath(fileName: NormalizedPath): ScriptInfo | undefined;
+ getScriptInfo(uncheckedFileName: string): ScriptInfo | undefined;
+ filesToString(writeProjectFileNames: boolean): string;
+ setCompilerOptions(compilerOptions: CompilerOptions): void;
+ protected removeRoot(info: ScriptInfo): void;
+ protected enableGlobalPlugins(options: CompilerOptions, pluginConfigOverrides: Map<any> | undefined): void;
+ protected enablePlugin(pluginConfigEntry: PluginImport, searchPaths: string[], pluginConfigOverrides: Map<any> | undefined): void;
+ private enableProxy;
+ /** Starts a new check for diagnostics. Call this if some file has updated that would cause diagnostics to be changed. */
+ refreshDiagnostics(): void;
+ private watchPackageJsonFile;
+ }
+ /**
+ * If a file is opened and no tsconfig (or jsconfig) is found,
+ * the file and its imports/references are put into an InferredProject.
+ */
+ class InferredProject extends Project {
+ private static readonly newName;
+ private _isJsInferredProject;
+ toggleJsInferredProject(isJsInferredProject: boolean): void;
+ setCompilerOptions(options?: CompilerOptions): void;
+ /** this is canonical project root path */
+ readonly projectRootPath: string | undefined;
+ addRoot(info: ScriptInfo): void;
+ removeRoot(info: ScriptInfo): void;
+ isProjectWithSingleRoot(): boolean;
+ close(): void;
+ getTypeAcquisition(): TypeAcquisition;
+ }
+ /**
+ * If a file is opened, the server will look for a tsconfig (or jsconfig)
+ * and if successful create a ConfiguredProject for it.
+ * Otherwise it will create an InferredProject.
+ */
+ class ConfiguredProject extends Project {
+ private typeAcquisition;
+ private directoriesWatchedForWildcards;
+ readonly canonicalConfigFilePath: NormalizedPath;
+ /** Ref count to the project when opened from external project */
+ private externalProjectRefCount;
+ private projectErrors;
+ private projectReferences;
+ /**
+ * If the project has reload from disk pending, it reloads (and then updates graph as part of that) instead of just updating the graph
+ * @returns: true if set of files in the project stays the same and false - otherwise.
+ */
+ updateGraph(): boolean;
+ getConfigFilePath(): NormalizedPath;
+ getProjectReferences(): readonly ProjectReference[] | undefined;
+ updateReferences(refs: readonly ProjectReference[] | undefined): void;
+ /**
+ * Get the errors that dont have any file name associated
+ */
+ getGlobalProjectErrors(): readonly Diagnostic[];
+ /**
+ * Get all the project errors
+ */
+ getAllProjectErrors(): readonly Diagnostic[];
+ setProjectErrors(projectErrors: Diagnostic[]): void;
+ setTypeAcquisition(newTypeAcquisition: TypeAcquisition): void;
+ getTypeAcquisition(): TypeAcquisition;
+ close(): void;
+ getEffectiveTypeRoots(): string[];
+ }
+ /**
+ * Project whose configuration is handled externally, such as in a '.csproj'.
+ * These are created only if a host explicitly calls `openExternalProject`.
+ */
+ class ExternalProject extends Project {
+ externalProjectName: string;
+ compileOnSaveEnabled: boolean;
+ excludedFiles: readonly NormalizedPath[];
+ private typeAcquisition;
+ updateGraph(): boolean;
+ getExcludedFiles(): readonly NormalizedPath[];
+ getTypeAcquisition(): TypeAcquisition;
+ setTypeAcquisition(newTypeAcquisition: TypeAcquisition): void;
+ }
+}
+declare namespace ts.server {
+ export const maxProgramSizeForNonTsFiles: number;
+ export const ProjectsUpdatedInBackgroundEvent = "projectsUpdatedInBackground";
+ export const ProjectLoadingStartEvent = "projectLoadingStart";
+ export const ProjectLoadingFinishEvent = "projectLoadingFinish";
+ export const LargeFileReferencedEvent = "largeFileReferenced";
+ export const ConfigFileDiagEvent = "configFileDiag";
+ export const ProjectLanguageServiceStateEvent = "projectLanguageServiceState";
+ export const ProjectInfoTelemetryEvent = "projectInfo";
+ export const OpenFileInfoTelemetryEvent = "openFileInfo";
+ export interface ProjectsUpdatedInBackgroundEvent {
+ eventName: typeof ProjectsUpdatedInBackgroundEvent;
+ data: {
+ openFiles: string[];
+ };
+ }
+ export interface ProjectLoadingStartEvent {
+ eventName: typeof ProjectLoadingStartEvent;
+ data: {
+ project: Project;
+ reason: string;
+ };
+ }
+ export interface ProjectLoadingFinishEvent {
+ eventName: typeof ProjectLoadingFinishEvent;
+ data: {
+ project: Project;
+ };
+ }
+ export interface LargeFileReferencedEvent {
+ eventName: typeof LargeFileReferencedEvent;
+ data: {
+ file: string;
+ fileSize: number;
+ maxFileSize: number;
+ };
+ }
+ export interface ConfigFileDiagEvent {
+ eventName: typeof ConfigFileDiagEvent;
+ data: {
+ triggerFile: string;
+ configFileName: string;
+ diagnostics: readonly Diagnostic[];
+ };
+ }
+ export interface ProjectLanguageServiceStateEvent {
+ eventName: typeof ProjectLanguageServiceStateEvent;
+ data: {
+ project: Project;
+ languageServiceEnabled: boolean;
+ };
+ }
+ /** This will be converted to the payload of a protocol.TelemetryEvent in session.defaultEventHandler. */
+ export interface ProjectInfoTelemetryEvent {
+ readonly eventName: typeof ProjectInfoTelemetryEvent;
+ readonly data: ProjectInfoTelemetryEventData;
+ }
+ export interface ProjectInfoTelemetryEventData {
+ /** Cryptographically secure hash of project file location. */
+ readonly projectId: string;
+ /** Count of file extensions seen in the project. */
+ readonly fileStats: FileStats;
+ /**
+ * Any compiler options that might contain paths will be taken out.
+ * Enum compiler options will be converted to strings.
+ */
+ readonly compilerOptions: CompilerOptions;
+ readonly extends: boolean | undefined;
+ readonly files: boolean | undefined;
+ readonly include: boolean | undefined;
+ readonly exclude: boolean | undefined;
+ readonly compileOnSave: boolean;
+ readonly typeAcquisition: ProjectInfoTypeAcquisitionData;
+ readonly configFileName: "tsconfig.json" | "jsconfig.json" | "other";
+ readonly projectType: "external" | "configured";
+ readonly languageServiceEnabled: boolean;
+ /** TypeScript version used by the server. */
+ readonly version: string;
+ }
+ /**
+ * Info that we may send about a file that was just opened.
+ * Info about a file will only be sent once per session, even if the file changes in ways that might affect the info.
+ * Currently this is only sent for '.js' files.
+ */
+ export interface OpenFileInfoTelemetryEvent {
+ readonly eventName: typeof OpenFileInfoTelemetryEvent;
+ readonly data: OpenFileInfoTelemetryEventData;
+ }
+ export interface OpenFileInfoTelemetryEventData {
+ readonly info: OpenFileInfo;
+ }
+ export interface ProjectInfoTypeAcquisitionData {
+ readonly enable: boolean | undefined;
+ readonly include: boolean;
+ readonly exclude: boolean;
+ }
+ export interface FileStats {
+ readonly js: number;
+ readonly jsSize?: number;
+ readonly jsx: number;
+ readonly jsxSize?: number;
+ readonly ts: number;
+ readonly tsSize?: number;
+ readonly tsx: number;
+ readonly tsxSize?: number;
+ readonly dts: number;
+ readonly dtsSize?: number;
+ readonly deferred: number;
+ readonly deferredSize?: number;
+ }
+ export interface OpenFileInfo {
+ readonly checkJs: boolean;
+ }
+ export type ProjectServiceEvent = LargeFileReferencedEvent | ProjectsUpdatedInBackgroundEvent | ProjectLoadingStartEvent | ProjectLoadingFinishEvent | ConfigFileDiagEvent | ProjectLanguageServiceStateEvent | ProjectInfoTelemetryEvent | OpenFileInfoTelemetryEvent;
+ export type ProjectServiceEventHandler = (event: ProjectServiceEvent) => void;
+ export interface SafeList {
+ [name: string]: {
+ match: RegExp;
+ exclude?: (string | number)[][];
+ types?: string[];
+ };
+ }
+ export interface TypesMapFile {
+ typesMap: SafeList;
+ simpleMap: {
+ [libName: string]: string;
+ };
+ }
+ export function convertFormatOptions(protocolOptions: protocol.FormatCodeSettings): FormatCodeSettings;
+ export function convertCompilerOptions(protocolOptions: protocol.ExternalProjectCompilerOptions): CompilerOptions & protocol.CompileOnSaveMixin;
+ export function convertWatchOptions(protocolOptions: protocol.ExternalProjectCompilerOptions): WatchOptions | undefined;
+ export function tryConvertScriptKindName(scriptKindName: protocol.ScriptKindName | ScriptKind): ScriptKind;
+ export function convertScriptKindName(scriptKindName: protocol.ScriptKindName): ScriptKind.Unknown | ScriptKind.JS | ScriptKind.JSX | ScriptKind.TS | ScriptKind.TSX;
+ export interface HostConfiguration {
+ formatCodeOptions: FormatCodeSettings;
+ preferences: protocol.UserPreferences;
+ hostInfo: string;
+ extraFileExtensions?: FileExtensionInfo[];
+ watchOptions?: WatchOptions;
+ }
+ export interface OpenConfiguredProjectResult {
+ configFileName?: NormalizedPath;
+ configFileErrors?: readonly Diagnostic[];
+ }
+ export interface ProjectServiceOptions {
+ host: ServerHost;
+ logger: Logger;
+ cancellationToken: HostCancellationToken;
+ useSingleInferredProject: boolean;
+ useInferredProjectPerProjectRoot: boolean;
+ typingsInstaller: ITypingsInstaller;
+ eventHandler?: ProjectServiceEventHandler;
+ suppressDiagnosticEvents?: boolean;
+ throttleWaitMilliseconds?: number;
+ globalPlugins?: readonly string[];
+ pluginProbeLocations?: readonly string[];
+ allowLocalPluginLoads?: boolean;
+ typesMapLocation?: string;
+ syntaxOnly?: boolean;
+ }
+ export class ProjectService {
+ private readonly scriptInfoInNodeModulesWatchers;
+ /**
+ * Contains all the deleted script info's version information so that
+ * it does not reset when creating script info again
+ * (and could have potentially collided with version where contents mismatch)
+ */
+ private readonly filenameToScriptInfoVersion;
+ private readonly allJsFilesForOpenFileTelemetry;
+ /**
+ * maps external project file name to list of config files that were the part of this project
+ */
+ private readonly externalProjectToConfiguredProjectMap;
+ /**
+ * external projects (configuration and list of root files is not controlled by tsserver)
+ */
+ readonly externalProjects: ExternalProject[];
+ /**
+ * projects built from openFileRoots
+ */
+ readonly inferredProjects: InferredProject[];
+ /**
+ * projects specified by a tsconfig.json file
+ */
+ readonly configuredProjects: Map<ConfiguredProject>;
+ /**
+ * Open files: with value being project root path, and key being Path of the file that is open
+ */
+ readonly openFiles: Map<NormalizedPath | undefined>;
+ /**
+ * Map of open files that are opened without complete path but have projectRoot as current directory
+ */
+ private readonly openFilesWithNonRootedDiskPath;
+ private compilerOptionsForInferredProjects;
+ private compilerOptionsForInferredProjectsPerProjectRoot;
+ private watchOptionsForInferredProjects;
+ private watchOptionsForInferredProjectsPerProjectRoot;
+ /**
+ * Project size for configured or external projects
+ */
+ private readonly projectToSizeMap;
+ /**
+ * This is a map of config file paths existence that doesnt need query to disk
+ * - The entry can be present because there is inferred project that needs to watch addition of config file to directory
+ * In this case the exists could be true/false based on config file is present or not
+ * - Or it is present if we have configured project open with config file at that location
+ * In this case the exists property is always true
+ */
+ private readonly configFileExistenceInfoCache;
+ private readonly throttledOperations;
+ private readonly hostConfiguration;
+ private safelist;
+ private readonly legacySafelist;
+ private pendingProjectUpdates;
+ readonly currentDirectory: NormalizedPath;
+ readonly toCanonicalFileName: (f: string) => string;
+ readonly host: ServerHost;
+ readonly logger: Logger;
+ readonly cancellationToken: HostCancellationToken;
+ readonly useSingleInferredProject: boolean;
+ readonly useInferredProjectPerProjectRoot: boolean;
+ readonly typingsInstaller: ITypingsInstaller;
+ private readonly globalCacheLocationDirectoryPath;
+ readonly throttleWaitMilliseconds?: number;
+ private readonly eventHandler?;
+ private readonly suppressDiagnosticEvents?;
+ readonly globalPlugins: readonly string[];
+ readonly pluginProbeLocations: readonly string[];
+ readonly allowLocalPluginLoads: boolean;
+ private currentPluginConfigOverrides;
+ readonly typesMapLocation: string | undefined;
+ readonly syntaxOnly?: boolean;
+ /** Tracks projects that we have already sent telemetry for. */
+ private readonly seenProjects;
+ private performanceEventHandler?;
+ constructor(opts: ProjectServiceOptions);
+ toPath(fileName: string): Path;
+ private loadTypesMap;
+ updateTypingsForProject(response: SetTypings | InvalidateCachedTypings | PackageInstalledResponse): void;
+ private delayEnsureProjectForOpenFiles;
+ private delayUpdateProjectGraph;
+ private delayUpdateProjectGraphs;
+ setCompilerOptionsForInferredProjects(projectCompilerOptions: protocol.ExternalProjectCompilerOptions, projectRootPath?: string): void;
+ findProject(projectName: string): Project | undefined;
+ getDefaultProjectForFile(fileName: NormalizedPath, ensureProject: boolean): Project | undefined;
+ private doEnsureDefaultProjectForFile;
+ getScriptInfoEnsuringProjectsUptoDate(uncheckedFileName: string): ScriptInfo | undefined;
+ /**
+ * Ensures the project structures are upto date
+ * This means,
+ * - we go through all the projects and update them if they are dirty
+ * - if updates reflect some change in structure or there was pending request to ensure projects for open files
+ * ensure that each open script info has project
+ */
+ private ensureProjectStructuresUptoDate;
+ getFormatCodeOptions(file: NormalizedPath): FormatCodeSettings;
+ getPreferences(file: NormalizedPath): protocol.UserPreferences;
+ getHostFormatCodeOptions(): FormatCodeSettings;
+ getHostPreferences(): protocol.UserPreferences;
+ private onSourceFileChanged;
+ private handleSourceMapProjects;
+ private delayUpdateSourceInfoProjects;
+ private delayUpdateProjectsOfScriptInfoPath;
+ private handleDeletedFile;
+ /**
+ * This is the callback function for the config file add/remove/change at any location
+ * that matters to open script info but doesnt have configured project open
+ * for the config file
+ */
+ private onConfigFileChangeForOpenScriptInfo;
+ private removeProject;
+ private assignOrphanScriptInfosToInferredProject;
+ /**
+ * Remove this file from the set of open, non-configured files.
+ * @param info The file that has been closed or newly configured
+ */
+ private closeOpenFile;
+ private deleteScriptInfo;
+ private configFileExists;
+ private setConfigFileExistenceByNewConfiguredProject;
+ /**
+ * Returns true if the configFileExistenceInfo is needed/impacted by open files that are root of inferred project
+ */
+ private configFileExistenceImpactsRootOfInferredProject;
+ private setConfigFileExistenceInfoByClosedConfiguredProject;
+ private logConfigFileWatchUpdate;
+ /**
+ * Create the watcher for the configFileExistenceInfo
+ */
+ private createConfigFileWatcherOfConfigFileExistence;
+ /**
+ * Close the config file watcher in the cached ConfigFileExistenceInfo
+ * if there arent any open files that are root of inferred project
+ */
+ private closeConfigFileWatcherOfConfigFileExistenceInfo;
+ /**
+ * This is called on file close, so that we stop watching the config file for this script info
+ */
+ private stopWatchingConfigFilesForClosedScriptInfo;
+ /**
+ * This function tries to search for a tsconfig.json for the given file.
+ * This is different from the method the compiler uses because
+ * the compiler can assume it will always start searching in the
+ * current directory (the directory in which tsc was invoked).
+ * The server must start searching from the directory containing
+ * the newly opened file.
+ */
+ private forEachConfigFileLocation;
+ /**
+ * This function tries to search for a tsconfig.json for the given file.
+ * This is different from the method the compiler uses because
+ * the compiler can assume it will always start searching in the
+ * current directory (the directory in which tsc was invoked).
+ * The server must start searching from the directory containing
+ * the newly opened file.
+ * If script info is passed in, it is asserted to be open script info
+ * otherwise just file name
+ */
+ private getConfigFileNameForFile;
+ private printProjects;
+ private getConfiguredProjectByCanonicalConfigFilePath;
+ private findExternalProjectByProjectName;
+ /** Get a filename if the language service exceeds the maximum allowed program size; otherwise returns undefined. */
+ private getFilenameForExceededTotalSizeLimitForNonTsFiles;
+ private createExternalProject;
+ private addFilesToNonInferredProject;
+ private updateNonInferredProjectFiles;
+ private updateRootAndOptionsOfNonInferredProject;
+ private sendConfigFileDiagEvent;
+ private getOrCreateInferredProjectForProjectRootPathIfEnabled;
+ private getOrCreateSingleInferredProjectIfEnabled;
+ private getOrCreateSingleInferredWithoutProjectRoot;
+ private createInferredProject;
+ getScriptInfo(uncheckedFileName: string): ScriptInfo | undefined;
+ private watchClosedScriptInfo;
+ private watchClosedScriptInfoInNodeModules;
+ private getModifiedTime;
+ private refreshScriptInfo;
+ private refreshScriptInfosInDirectory;
+ private stopWatchingScriptInfo;
+ private getOrCreateScriptInfoNotOpenedByClientForNormalizedPath;
+ private getOrCreateScriptInfoOpenedByClientForNormalizedPath;
+ getOrCreateScriptInfoForNormalizedPath(fileName: NormalizedPath, openedByClient: boolean, fileContent?: string, scriptKind?: ScriptKind, hasMixedContent?: boolean, hostToQueryFileExistsOn?: {
+ fileExists(path: string): boolean;
+ }): ScriptInfo | undefined;
+ private getOrCreateScriptInfoWorker;
+ /**
+ * This gets the script info for the normalized path. If the path is not rooted disk path then the open script info with project root context is preferred
+ */
+ getScriptInfoForNormalizedPath(fileName: NormalizedPath): ScriptInfo | undefined;
+ getScriptInfoForPath(fileName: Path): ScriptInfo | undefined;
+ private addSourceInfoToSourceMap;
+ private addMissingSourceMapFile;
+ setHostConfiguration(args: protocol.ConfigureRequestArguments): void;
+ closeLog(): void;
+ /**
+ * This function rebuilds the project for every file opened by the client
+ * This does not reload contents of open files from disk. But we could do that if needed
+ */
+ reloadProjects(): void;
+ private delayReloadConfiguredProjectForFiles;
+ /**
+ * This function goes through all the openFiles and tries to file the config file for them.
+ * If the config file is found and it refers to existing project, it reloads it either immediately
+ * or schedules it for reload depending on delayReload option
+ * If the there is no existing project it just opens the configured project for the config file
+ * reloadForInfo provides a way to filter out files to reload configured project for
+ */
+ private reloadConfiguredProjectForFiles;
+ /**
+ * Remove the root of inferred project if script info is part of another project
+ */
+ private removeRootOfInferredProjectIfNowPartOfOtherProject;
+ /**
+ * This function is to update the project structure for every inferred project.
+ * It is called on the premise that all the configured projects are
+ * up to date.
+ * This will go through open files and assign them to inferred project if open file is not part of any other project
+ * After that all the inferred project graphs are updated
+ */
+ private ensureProjectForOpenFiles;
+ /**
+ * Open file whose contents is managed by the client
+ * @param filename is absolute pathname
+ * @param fileContent is a known version of the file content that is more up to date than the one on disk
+ */
+ openClientFile(fileName: string, fileContent?: string, scriptKind?: ScriptKind, projectRootPath?: string): OpenConfiguredProjectResult;
+ private findExternalProjectContainingOpenScriptInfo;
+ private getOrCreateOpenScriptInfo;
+ private assignProjectToOpenedScriptInfo;
+ private createAncestorProjects;
+ private ensureProjectChildren;
+ private cleanupAfterOpeningFile;
+ openClientFileWithNormalizedPath(fileName: NormalizedPath, fileContent?: string, scriptKind?: ScriptKind, hasMixedContent?: boolean, projectRootPath?: NormalizedPath): OpenConfiguredProjectResult;
+ private removeOrphanConfiguredProjects;
+ private removeOrphanScriptInfos;
+ private telemetryOnOpenFile;
+ /**
+ * Close file whose contents is managed by the client
+ * @param filename is absolute pathname
+ */
+ closeClientFile(uncheckedFileName: string): void;
+ private collectChanges;
+ private closeConfiguredProjectReferencedFromExternalProject;
+ closeExternalProject(uncheckedFileName: string): void;
+ openExternalProjects(projects: protocol.ExternalProject[]): void;
+ /** Makes a filename safe to insert in a RegExp */
+ private static readonly filenameEscapeRegexp;
+ private static escapeFilenameForRegex;
+ resetSafeList(): void;
+ applySafeList(proj: protocol.ExternalProject): NormalizedPath[];
+ openExternalProject(proj: protocol.ExternalProject): void;
+ hasDeferredExtension(): boolean;
+ configurePlugin(args: protocol.ConfigurePluginRequestArguments): void;
+ }
+ export {};
+}
+declare namespace ts.server {
+ interface ServerCancellationToken extends HostCancellationToken {
+ setRequest(requestId: number): void;
+ resetRequest(requestId: number): void;
+ }
+ const nullCancellationToken: ServerCancellationToken;
+ interface PendingErrorCheck {
+ fileName: NormalizedPath;
+ project: Project;
+ }
+ type CommandNames = protocol.CommandTypes;
+ const CommandNames: any;
+ function formatMessage<T extends protocol.Message>(msg: T, logger: Logger, byteLength: (s: string, encoding: string) => number, newLine: string): string;
+ type Event = <T extends object>(body: T, eventName: string) => void;
+ interface EventSender {
+ event: Event;
+ }
+ interface SessionOptions {
+ host: ServerHost;
+ cancellationToken: ServerCancellationToken;
+ useSingleInferredProject: boolean;
+ useInferredProjectPerProjectRoot: boolean;
+ typingsInstaller: ITypingsInstaller;
+ byteLength: (buf: string, encoding?: string) => number;
+ hrtime: (start?: number[]) => number[];
+ logger: Logger;
+ /**
+ * If falsy, all events are suppressed.
+ */
+ canUseEvents: boolean;
+ eventHandler?: ProjectServiceEventHandler;
+ /** Has no effect if eventHandler is also specified. */
+ suppressDiagnosticEvents?: boolean;
+ syntaxOnly?: boolean;
+ throttleWaitMilliseconds?: number;
+ noGetErrOnBackgroundUpdate?: boolean;
+ globalPlugins?: readonly string[];
+ pluginProbeLocations?: readonly string[];
+ allowLocalPluginLoads?: boolean;
+ typesMapLocation?: string;
+ }
+ class Session implements EventSender {
+ private readonly gcTimer;
+ protected projectService: ProjectService;
+ private changeSeq;
+ private updateGraphDurationMs;
+ private currentRequestId;
+ private errorCheck;
+ protected host: ServerHost;
+ private readonly cancellationToken;
+ protected readonly typingsInstaller: ITypingsInstaller;
+ protected byteLength: (buf: string, encoding?: string) => number;
+ private hrtime;
+ protected logger: Logger;
+ protected canUseEvents: boolean;
+ private suppressDiagnosticEvents?;
+ private eventHandler;
+ private readonly noGetErrOnBackgroundUpdate?;
+ constructor(opts: SessionOptions);
+ private sendRequestCompletedEvent;
+ private performanceEventHandler;
+ private defaultEventHandler;
+ private projectsUpdatedInBackgroundEvent;
+ logError(err: Error, cmd: string): void;
+ private logErrorWorker;
+ send(msg: protocol.Message): void;
+ event<T extends object>(body: T, eventName: string): void;
+ /** @deprecated */
+ output(info: any, cmdName: string, reqSeq?: number, errorMsg?: string): void;
+ private doOutput;
+ private semanticCheck;
+ private syntacticCheck;
+ private suggestionCheck;
+ private sendDiagnosticsEvent;
+ /** It is the caller's responsibility to verify that `!this.suppressDiagnosticEvents`. */
+ private updateErrorCheck;
+ private cleanProjects;
+ private cleanup;
+ private getEncodedSyntacticClassifications;
+ private getEncodedSemanticClassifications;
+ private getProject;
+ private getConfigFileAndProject;
+ private getConfigFileDiagnostics;
+ private convertToDiagnosticsWithLinePositionFromDiagnosticFile;
+ private getCompilerOptionsDiagnostics;
+ private convertToDiagnosticsWithLinePosition;
+ private getDiagnosticsWorker;
+ private getDefinition;
+ private mapDefinitionInfoLocations;
+ private getDefinitionAndBoundSpan;
+ private getEmitOutput;
+ private mapDefinitionInfo;
+ private static mapToOriginalLocation;
+ private toFileSpan;
+ private toFileSpanWithContext;
+ private getTypeDefinition;
+ private mapImplementationLocations;
+ private getImplementation;
+ private getOccurrences;
+ private getSyntacticDiagnosticsSync;
+ private getSemanticDiagnosticsSync;
+ private getSuggestionDiagnosticsSync;
+ private getJsxClosingTag;
+ private getDocumentHighlights;
+ private setCompilerOptionsForInferredProjects;
+ private getProjectInfo;
+ private getProjectInfoWorker;
+ private getRenameInfo;
+ private getProjects;
+ private getDefaultProject;
+ private getRenameLocations;
+ private mapRenameInfo;
+ private toSpanGroups;
+ private getReferences;
+ /**
+ * @param fileName is the name of the file to be opened
+ * @param fileContent is a version of the file content that is known to be more up to date than the one on disk
+ */
+ private openClientFile;
+ private getPosition;
+ private getPositionInFile;
+ private getFileAndProject;
+ private getFileAndLanguageServiceForSyntacticOperation;
+ private getFileAndProjectWorker;
+ private getOutliningSpans;
+ private getTodoComments;
+ private getDocCommentTemplate;
+ private getSpanOfEnclosingComment;
+ private getIndentation;
+ private getBreakpointStatement;
+ private getNameOrDottedNameSpan;
+ private isValidBraceCompletion;
+ private getQuickInfoWorker;
+ private getFormattingEditsForRange;
+ private getFormattingEditsForRangeFull;
+ private getFormattingEditsForDocumentFull;
+ private getFormattingEditsAfterKeystrokeFull;
+ private getFormattingEditsAfterKeystroke;
+ private getCompletions;
+ private getCompletionEntryDetails;
+ private getCompileOnSaveAffectedFileList;
+ private emitFile;
+ private getSignatureHelpItems;
+ private toPendingErrorCheck;
+ private getDiagnostics;
+ private change;
+ private reload;
+ private saveToTmp;
+ private closeClientFile;
+ private mapLocationNavigationBarItems;
+ private getNavigationBarItems;
+ private toLocationNavigationTree;
+ private getNavigationTree;
+ private getNavigateToItems;
+ private getFullNavigateToItems;
+ private getSupportedCodeFixes;
+ private isLocation;
+ private extractPositionOrRange;
+ private getApplicableRefactors;
+ private getEditsForRefactor;
+ private organizeImports;
+ private getEditsForFileRename;
+ private getCodeFixes;
+ private getCombinedCodeFix;
+ private applyCodeActionCommand;
+ private getStartAndEndPosition;
+ private mapCodeAction;
+ private mapCodeFixAction;
+ private mapTextChangesToCodeEdits;
+ private mapTextChangeToCodeEdit;
+ private convertTextChangeToCodeEdit;
+ private getBraceMatching;
+ private getDiagnosticsForProject;
+ private configurePlugin;
+ private getSmartSelectionRange;
+ private mapSelectionRange;
+ private getScriptInfoFromProjectService;
+ private toProtocolCallHierarchyItem;
+ private toProtocolCallHierarchyIncomingCall;
+ private toProtocolCallHierarchyOutgoingCall;
+ private prepareCallHierarchy;
+ private provideCallHierarchyIncomingCalls;
+ private provideCallHierarchyOutgoingCalls;
+ getCanonicalFileName(fileName: string): string;
+ exit(): void;
+ private notRequired;
+ private requiredResponse;
+ private handlers;
+ addProtocolHandler(command: string, handler: (request: protocol.Request) => HandlerResponse): void;
+ private setCurrentRequest;
+ private resetCurrentRequest;
+ executeWithRequestId<T>(requestId: number, f: () => T): T;
+ executeCommand(request: protocol.Request): HandlerResponse;
+ onMessage(message: string): void;
+ private getFormatOptions;
+ private getPreferences;
+ private getHostFormatOptions;
+ private getHostPreferences;
+ }
+ interface HandlerResponse {
+ response?: {};
+ responseRequired?: boolean;
+ }
+}
+
+export = ts;
+export as namespace ts;
\ No newline at end of file