f235bf7db8
* Remove check narrowing only certain types, add test showing issues with this * string literal case test * Reconcile fix with CFA work * Defaultable -> NotNarrowable to align with use * Missed a defaultable in comments * Add test for narrowing to unions of string literals * Rewrite isInStringLiteral to accomodate for unterminated strings * Refactor signatureHelp to expose helper functions * Add support for completion in string literals * Remove unused check * Use const instead of let * Fix error * Formatting changes * Use shorthand properties * Add failing test for #8738 * Sort baseline reference identifier by name * Detects assignment to internal module export clause, fixes #8738 * add SharedArrayBuffer fix * Factor out assignment op check * Add test for composite assignment * Factor out the behaviour and handles x++ and ++x * Handles ES3 default as identifier name * Fix missing else statement * isNameOfExportedDeclarationInNonES6Module * Reorder options alphabetically * Mark diagnostics, and skipDefaultLibCheck as internal * Allow an import of "foo.js" to be matched by a file "foo.ts" * Improve loadModuleFromFile code * Respond to PR comments * Respond to more PR comments * Fix test * Actually merge from master * Revert to old tryLoad implementation * Run fixupParentReferences when parsing isolated jsDocComment * initial revision of unit test support for project system in tsserver * Allow wildcard ("*") patterns in ambient module declarations * Add non-widening forms of null and undefined * Create separate control flows for property declarations with initializers * Add regression test * Allow trailing commas in function parameter and argument lists * Add tests * Remove unused variable * Add null check and CR feedback * Support shorthand ambient module declarations * Revert "Merge pull request #7235 from weswigham/narrow-all-types" This reverts commitef0f6c8fe4, reversing changes made to9f087cb62a. * reuse the fixupParentReferences function * Improve typing of && operator with --strictNullChecks * Add test * Respond to PR comments * Respond to PR comments * Add merging tests * Use a function `stringify` to simplify calls to `JSON.stringify(xyz, undefined, 2)` * Update tests * Fix mistake * Include indent in navigation bar protocol Previously navbar01 test had indents when run in the browser but not when run from node. Now they run the same. * Remove unnecessary restrictions in property access narrowing * Fix fourslash test * Add regression test * Consider property declarations to be control flow containers * Adding regression test * Remove restriction on --target es5 and --module es6 * change type definition for Object.create * Fix signature help * Add "implicit any" warning for shorthand ambient modules * Remove trailing whitespace * Support using string values in enums for CompilerOptions in transpile methods * Remove trailing whitespace in jakefile * Make `jake runtests-browser` support test regexes with spaces For example: `jake runtests-browser t="transpile .js files"` now works. * Add another test * factor out isJsxOrTsxExtension * Move to a conformance test * Revert "Revert "Merge pull request #7235 from weswigham/narrow-all-types"" This reverts commitfc3e040c51. * Use inclusive flag, as originally done, but include almost everything * Add additional tests * Respond to PR comments * Fix typo * add tests for tsserver project system * Fix test * Allow case comparison to undefined and null in strict null checking mode * Remove incorrectly added tests * check if moduleResolution when verifying that program can be reused * more tests for module resolution change and exclude * Fix linting issues * Merge JSDoc of assignments from function expressions * Allow nested assignments in type guards * Add tests * Improve order of parameter's merged jsdoc * Force LF newlines for LKG builds/non debug builds Fixes 6630 * Create intersection types in type guards for unrelated types * Split commentsFunction test into expr/decl And renumber. * Remove TODO comments * Accept new baselines * Add tests * Remove comments * Fix test helper * Recognize relative path using in outDir property (#9025) * Recognize relative path using in outDir property * Add projects tests * Add project .json files * Update baselines * Add comments * Add test case The test passes in 1.8 and fails in master. * Return trace when exception happens * Remove Long-Done TODO AFAIK, the harness sources have been concatenated into `run.js` for as long as I've known. This stops executing them twice (and in turn makes debugging tests much easier, since you no longer have to debug into eval'd code). * Allow primitive type guards with typeof on right Previously, only type guards of the form `typeof x === 'string'` were allowed. Now you can write `'string' === typeof x`. * Primitive type guards are now order independent * Fix comments in tests * Add handleing for classes * Add more tests for target=es5 module=es6 * addExportToArgumentListKind * Accept baseline * Add more tests * wip-fixing transforms * Adds progress indicators to the runtests-parallel build task. * Fixed typo * Fix comment * Add test for out-of-range error * Use proper method of not resolving alias * Fix module loading error (commandLineOptions_stringToEnum would be undefined if optionDeclarations wasn't loaded yet) * Port 8739 * Update tests * Update baselines * Contextually type return statement in async function * Remove stale files * Undo change * Improve perf * Improve tests * Fix sourcemaps for debugging tests * Allow --sourceRoot with --inlineSources option Fixes #8445 * this in parameter initializers resolves to class Accept baselines now that the test passes. * Add tests for more kinds of import/export * Fix7334 Disallow async in functionExpression and ArrowFunction (#9062) * Error when using async modifier in function-expression and arrow-function when target es5 * Add tests and baselines * Resolve function-this in parameter initialisers when explicitly provided * Allow null/undefined guard with null/undefined on left Also add a test with baselines. * Code review comments * Update more diagnostic messages ES6->2015 Fix #8996 CC @mhegazy. * Fixes an issue with runtests-parallel when global mocha is not installed. * Update LKG * Add tests * fix baselines * Recommend runtests-parallel in CONTRIBUTING * Only inlineSourceMap when debugging through jake-browser (#9080) * Only inlineSourceMap when debugging through jake-browser * Address PR: fix typo in opt's property * Manually port tests from PR 8470 * minor fix: add missing return clause * Support using string values in enums for CompilerOptions in transpile methods * Support using string values in enums for CompilerOptions in transpile methods # Conflicts: # tests/cases/unittests/transpile.ts * Fix test helper * Add test for out-of-range error * Fix module loading error (commandLineOptions_stringToEnum would be undefined if optionDeclarations wasn't loaded yet) * Use camel-case instead of snake-case (#9134) * Manually add tests for PR 8988 * Allow wildcard ("*") patterns in ambient module declarations * Respond to PR comments * Add another test * Improve perf * Improve tests * Update baseline from merging with master * Address PR comment * Update baseline * Refactor how we retrieve binding-name cache in module transformer * Temporary accept so we get a clean run-tests result
2525 lines
94 KiB
TypeScript
2525 lines
94 KiB
TypeScript
/*! *****************************************************************************
|
|
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 {
|
|
interface Map<T> {
|
|
[index: string]: T;
|
|
}
|
|
type Path = string & {
|
|
__pathBrand: any;
|
|
};
|
|
interface FileMap<T> {
|
|
get(fileName: Path): T;
|
|
set(fileName: Path, value: T): void;
|
|
contains(fileName: Path): boolean;
|
|
remove(fileName: Path): void;
|
|
forEachValue(f: (key: Path, v: T) => void): void;
|
|
clear(): void;
|
|
}
|
|
interface TextRange {
|
|
pos: number;
|
|
end: number;
|
|
}
|
|
enum SyntaxKind {
|
|
Unknown = 0,
|
|
EndOfFileToken = 1,
|
|
SingleLineCommentTrivia = 2,
|
|
MultiLineCommentTrivia = 3,
|
|
NewLineTrivia = 4,
|
|
WhitespaceTrivia = 5,
|
|
ShebangTrivia = 6,
|
|
ConflictMarkerTrivia = 7,
|
|
NumericLiteral = 8,
|
|
StringLiteral = 9,
|
|
RegularExpressionLiteral = 10,
|
|
NoSubstitutionTemplateLiteral = 11,
|
|
TemplateHead = 12,
|
|
TemplateMiddle = 13,
|
|
TemplateTail = 14,
|
|
OpenBraceToken = 15,
|
|
CloseBraceToken = 16,
|
|
OpenParenToken = 17,
|
|
CloseParenToken = 18,
|
|
OpenBracketToken = 19,
|
|
CloseBracketToken = 20,
|
|
DotToken = 21,
|
|
DotDotDotToken = 22,
|
|
SemicolonToken = 23,
|
|
CommaToken = 24,
|
|
LessThanToken = 25,
|
|
LessThanSlashToken = 26,
|
|
GreaterThanToken = 27,
|
|
LessThanEqualsToken = 28,
|
|
GreaterThanEqualsToken = 29,
|
|
EqualsEqualsToken = 30,
|
|
ExclamationEqualsToken = 31,
|
|
EqualsEqualsEqualsToken = 32,
|
|
ExclamationEqualsEqualsToken = 33,
|
|
EqualsGreaterThanToken = 34,
|
|
PlusToken = 35,
|
|
MinusToken = 36,
|
|
AsteriskToken = 37,
|
|
AsteriskAsteriskToken = 38,
|
|
SlashToken = 39,
|
|
PercentToken = 40,
|
|
PlusPlusToken = 41,
|
|
MinusMinusToken = 42,
|
|
LessThanLessThanToken = 43,
|
|
GreaterThanGreaterThanToken = 44,
|
|
GreaterThanGreaterThanGreaterThanToken = 45,
|
|
AmpersandToken = 46,
|
|
BarToken = 47,
|
|
CaretToken = 48,
|
|
ExclamationToken = 49,
|
|
TildeToken = 50,
|
|
AmpersandAmpersandToken = 51,
|
|
BarBarToken = 52,
|
|
QuestionToken = 53,
|
|
ColonToken = 54,
|
|
AtToken = 55,
|
|
EqualsToken = 56,
|
|
PlusEqualsToken = 57,
|
|
MinusEqualsToken = 58,
|
|
AsteriskEqualsToken = 59,
|
|
AsteriskAsteriskEqualsToken = 60,
|
|
SlashEqualsToken = 61,
|
|
PercentEqualsToken = 62,
|
|
LessThanLessThanEqualsToken = 63,
|
|
GreaterThanGreaterThanEqualsToken = 64,
|
|
GreaterThanGreaterThanGreaterThanEqualsToken = 65,
|
|
AmpersandEqualsToken = 66,
|
|
BarEqualsToken = 67,
|
|
CaretEqualsToken = 68,
|
|
Identifier = 69,
|
|
BreakKeyword = 70,
|
|
CaseKeyword = 71,
|
|
CatchKeyword = 72,
|
|
ClassKeyword = 73,
|
|
ConstKeyword = 74,
|
|
ContinueKeyword = 75,
|
|
DebuggerKeyword = 76,
|
|
DefaultKeyword = 77,
|
|
DeleteKeyword = 78,
|
|
DoKeyword = 79,
|
|
ElseKeyword = 80,
|
|
EnumKeyword = 81,
|
|
ExportKeyword = 82,
|
|
ExtendsKeyword = 83,
|
|
FalseKeyword = 84,
|
|
FinallyKeyword = 85,
|
|
ForKeyword = 86,
|
|
FunctionKeyword = 87,
|
|
IfKeyword = 88,
|
|
ImportKeyword = 89,
|
|
InKeyword = 90,
|
|
InstanceOfKeyword = 91,
|
|
NewKeyword = 92,
|
|
NullKeyword = 93,
|
|
ReturnKeyword = 94,
|
|
SuperKeyword = 95,
|
|
SwitchKeyword = 96,
|
|
ThisKeyword = 97,
|
|
ThrowKeyword = 98,
|
|
TrueKeyword = 99,
|
|
TryKeyword = 100,
|
|
TypeOfKeyword = 101,
|
|
VarKeyword = 102,
|
|
VoidKeyword = 103,
|
|
WhileKeyword = 104,
|
|
WithKeyword = 105,
|
|
ImplementsKeyword = 106,
|
|
InterfaceKeyword = 107,
|
|
LetKeyword = 108,
|
|
PackageKeyword = 109,
|
|
PrivateKeyword = 110,
|
|
ProtectedKeyword = 111,
|
|
PublicKeyword = 112,
|
|
StaticKeyword = 113,
|
|
YieldKeyword = 114,
|
|
AbstractKeyword = 115,
|
|
AsKeyword = 116,
|
|
AnyKeyword = 117,
|
|
AsyncKeyword = 118,
|
|
AwaitKeyword = 119,
|
|
BooleanKeyword = 120,
|
|
ConstructorKeyword = 121,
|
|
DeclareKeyword = 122,
|
|
GetKeyword = 123,
|
|
IsKeyword = 124,
|
|
ModuleKeyword = 125,
|
|
NamespaceKeyword = 126,
|
|
NeverKeyword = 127,
|
|
ReadonlyKeyword = 128,
|
|
RequireKeyword = 129,
|
|
NumberKeyword = 130,
|
|
SetKeyword = 131,
|
|
StringKeyword = 132,
|
|
SymbolKeyword = 133,
|
|
TypeKeyword = 134,
|
|
UndefinedKeyword = 135,
|
|
FromKeyword = 136,
|
|
GlobalKeyword = 137,
|
|
OfKeyword = 138,
|
|
QualifiedName = 139,
|
|
ComputedPropertyName = 140,
|
|
TypeParameter = 141,
|
|
Parameter = 142,
|
|
Decorator = 143,
|
|
PropertySignature = 144,
|
|
PropertyDeclaration = 145,
|
|
MethodSignature = 146,
|
|
MethodDeclaration = 147,
|
|
Constructor = 148,
|
|
GetAccessor = 149,
|
|
SetAccessor = 150,
|
|
CallSignature = 151,
|
|
ConstructSignature = 152,
|
|
IndexSignature = 153,
|
|
TypePredicate = 154,
|
|
TypeReference = 155,
|
|
FunctionType = 156,
|
|
ConstructorType = 157,
|
|
TypeQuery = 158,
|
|
TypeLiteral = 159,
|
|
ArrayType = 160,
|
|
TupleType = 161,
|
|
UnionType = 162,
|
|
IntersectionType = 163,
|
|
ParenthesizedType = 164,
|
|
ThisType = 165,
|
|
StringLiteralType = 166,
|
|
ObjectBindingPattern = 167,
|
|
ArrayBindingPattern = 168,
|
|
BindingElement = 169,
|
|
ArrayLiteralExpression = 170,
|
|
ObjectLiteralExpression = 171,
|
|
PropertyAccessExpression = 172,
|
|
ElementAccessExpression = 173,
|
|
CallExpression = 174,
|
|
NewExpression = 175,
|
|
TaggedTemplateExpression = 176,
|
|
TypeAssertionExpression = 177,
|
|
ParenthesizedExpression = 178,
|
|
FunctionExpression = 179,
|
|
ArrowFunction = 180,
|
|
DeleteExpression = 181,
|
|
TypeOfExpression = 182,
|
|
VoidExpression = 183,
|
|
AwaitExpression = 184,
|
|
PrefixUnaryExpression = 185,
|
|
PostfixUnaryExpression = 186,
|
|
BinaryExpression = 187,
|
|
ConditionalExpression = 188,
|
|
TemplateExpression = 189,
|
|
YieldExpression = 190,
|
|
SpreadElementExpression = 191,
|
|
ClassExpression = 192,
|
|
OmittedExpression = 193,
|
|
ExpressionWithTypeArguments = 194,
|
|
AsExpression = 195,
|
|
NonNullExpression = 196,
|
|
TemplateSpan = 197,
|
|
SemicolonClassElement = 198,
|
|
Block = 199,
|
|
VariableStatement = 200,
|
|
EmptyStatement = 201,
|
|
ExpressionStatement = 202,
|
|
IfStatement = 203,
|
|
DoStatement = 204,
|
|
WhileStatement = 205,
|
|
ForStatement = 206,
|
|
ForInStatement = 207,
|
|
ForOfStatement = 208,
|
|
ContinueStatement = 209,
|
|
BreakStatement = 210,
|
|
ReturnStatement = 211,
|
|
WithStatement = 212,
|
|
SwitchStatement = 213,
|
|
LabeledStatement = 214,
|
|
ThrowStatement = 215,
|
|
TryStatement = 216,
|
|
DebuggerStatement = 217,
|
|
VariableDeclaration = 218,
|
|
VariableDeclarationList = 219,
|
|
FunctionDeclaration = 220,
|
|
ClassDeclaration = 221,
|
|
InterfaceDeclaration = 222,
|
|
TypeAliasDeclaration = 223,
|
|
EnumDeclaration = 224,
|
|
ModuleDeclaration = 225,
|
|
ModuleBlock = 226,
|
|
CaseBlock = 227,
|
|
NamespaceExportDeclaration = 228,
|
|
ImportEqualsDeclaration = 229,
|
|
ImportDeclaration = 230,
|
|
ImportClause = 231,
|
|
NamespaceImport = 232,
|
|
NamedImports = 233,
|
|
ImportSpecifier = 234,
|
|
ExportAssignment = 235,
|
|
ExportDeclaration = 236,
|
|
NamedExports = 237,
|
|
ExportSpecifier = 238,
|
|
MissingDeclaration = 239,
|
|
ExternalModuleReference = 240,
|
|
JsxElement = 241,
|
|
JsxSelfClosingElement = 242,
|
|
JsxOpeningElement = 243,
|
|
JsxText = 244,
|
|
JsxClosingElement = 245,
|
|
JsxAttribute = 246,
|
|
JsxSpreadAttribute = 247,
|
|
JsxExpression = 248,
|
|
CaseClause = 249,
|
|
DefaultClause = 250,
|
|
HeritageClause = 251,
|
|
CatchClause = 252,
|
|
PropertyAssignment = 253,
|
|
ShorthandPropertyAssignment = 254,
|
|
EnumMember = 255,
|
|
SourceFile = 256,
|
|
JSDocTypeExpression = 257,
|
|
JSDocAllType = 258,
|
|
JSDocUnknownType = 259,
|
|
JSDocArrayType = 260,
|
|
JSDocUnionType = 261,
|
|
JSDocTupleType = 262,
|
|
JSDocNullableType = 263,
|
|
JSDocNonNullableType = 264,
|
|
JSDocRecordType = 265,
|
|
JSDocRecordMember = 266,
|
|
JSDocTypeReference = 267,
|
|
JSDocOptionalType = 268,
|
|
JSDocFunctionType = 269,
|
|
JSDocVariadicType = 270,
|
|
JSDocConstructorType = 271,
|
|
JSDocThisType = 272,
|
|
JSDocComment = 273,
|
|
JSDocTag = 274,
|
|
JSDocParameterTag = 275,
|
|
JSDocReturnTag = 276,
|
|
JSDocTypeTag = 277,
|
|
JSDocTemplateTag = 278,
|
|
JSDocTypedefTag = 279,
|
|
JSDocPropertyTag = 280,
|
|
JSDocTypeLiteral = 281,
|
|
SyntaxList = 282,
|
|
Count = 283,
|
|
FirstAssignment = 56,
|
|
LastAssignment = 68,
|
|
FirstReservedWord = 70,
|
|
LastReservedWord = 105,
|
|
FirstKeyword = 70,
|
|
LastKeyword = 138,
|
|
FirstFutureReservedWord = 106,
|
|
LastFutureReservedWord = 114,
|
|
FirstTypeNode = 154,
|
|
LastTypeNode = 166,
|
|
FirstPunctuation = 15,
|
|
LastPunctuation = 68,
|
|
FirstToken = 0,
|
|
LastToken = 138,
|
|
FirstTriviaToken = 2,
|
|
LastTriviaToken = 7,
|
|
FirstLiteralToken = 8,
|
|
LastLiteralToken = 11,
|
|
FirstTemplateToken = 11,
|
|
LastTemplateToken = 14,
|
|
FirstBinaryOperator = 25,
|
|
LastBinaryOperator = 68,
|
|
FirstNode = 139,
|
|
FirstJSDocNode = 257,
|
|
LastJSDocNode = 281,
|
|
FirstJSDocTagNode = 273,
|
|
LastJSDocTagNode = 281,
|
|
}
|
|
enum NodeFlags {
|
|
None = 0,
|
|
Export = 1,
|
|
Ambient = 2,
|
|
Public = 4,
|
|
Private = 8,
|
|
Protected = 16,
|
|
Static = 32,
|
|
Readonly = 64,
|
|
Abstract = 128,
|
|
Async = 256,
|
|
Default = 512,
|
|
Let = 1024,
|
|
Const = 2048,
|
|
Namespace = 4096,
|
|
ExportContext = 8192,
|
|
ContainsThis = 16384,
|
|
HasImplicitReturn = 32768,
|
|
HasExplicitReturn = 65536,
|
|
GlobalAugmentation = 131072,
|
|
HasClassExtends = 262144,
|
|
HasDecorators = 524288,
|
|
HasParamDecorators = 1048576,
|
|
HasAsyncFunctions = 2097152,
|
|
DisallowInContext = 4194304,
|
|
YieldContext = 8388608,
|
|
DecoratorContext = 16777216,
|
|
AwaitContext = 33554432,
|
|
ThisNodeHasError = 67108864,
|
|
JavaScriptFile = 134217728,
|
|
ThisNodeOrAnySubNodesHasError = 268435456,
|
|
HasAggregatedChildData = 536870912,
|
|
HasJsxSpreadAttribute = 1073741824,
|
|
Modifier = 1023,
|
|
AccessibilityModifier = 28,
|
|
ParameterPropertyModifier = 92,
|
|
BlockScoped = 3072,
|
|
ReachabilityCheckFlags = 98304,
|
|
EmitHelperFlags = 3932160,
|
|
ReachabilityAndEmitFlags = 4030464,
|
|
ContextFlags = 197132288,
|
|
TypeExcludesFlags = 41943040,
|
|
}
|
|
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,
|
|
}
|
|
interface Node extends TextRange {
|
|
kind: SyntaxKind;
|
|
flags: NodeFlags;
|
|
decorators?: NodeArray<Decorator>;
|
|
modifiers?: ModifiersArray;
|
|
parent?: Node;
|
|
}
|
|
interface NodeArray<T> extends Array<T>, TextRange {
|
|
hasTrailingComma?: boolean;
|
|
}
|
|
interface ModifiersArray extends NodeArray<Modifier> {
|
|
flags: number;
|
|
}
|
|
interface Modifier extends Node {
|
|
}
|
|
interface Identifier extends PrimaryExpression {
|
|
text: string;
|
|
originalKeywordKind?: SyntaxKind;
|
|
}
|
|
interface QualifiedName extends Node {
|
|
left: EntityName;
|
|
right: Identifier;
|
|
}
|
|
type EntityName = Identifier | QualifiedName;
|
|
type PropertyName = Identifier | LiteralExpression | ComputedPropertyName;
|
|
type DeclarationName = Identifier | LiteralExpression | ComputedPropertyName | BindingPattern;
|
|
interface Declaration extends Node {
|
|
_declarationBrand: any;
|
|
name?: DeclarationName;
|
|
}
|
|
interface DeclarationStatement extends Declaration, Statement {
|
|
name?: Identifier;
|
|
}
|
|
interface ComputedPropertyName extends Node {
|
|
expression: Expression;
|
|
}
|
|
interface Decorator extends Node {
|
|
expression: LeftHandSideExpression;
|
|
}
|
|
interface TypeParameterDeclaration extends Declaration {
|
|
name: Identifier;
|
|
constraint?: TypeNode;
|
|
expression?: Expression;
|
|
}
|
|
interface SignatureDeclaration extends Declaration {
|
|
name?: PropertyName;
|
|
typeParameters?: NodeArray<TypeParameterDeclaration>;
|
|
parameters: NodeArray<ParameterDeclaration>;
|
|
type?: TypeNode;
|
|
}
|
|
interface CallSignatureDeclaration extends SignatureDeclaration, TypeElement {
|
|
}
|
|
interface ConstructSignatureDeclaration extends SignatureDeclaration, TypeElement {
|
|
}
|
|
interface VariableDeclaration extends Declaration {
|
|
parent?: VariableDeclarationList;
|
|
name: Identifier | BindingPattern;
|
|
type?: TypeNode;
|
|
initializer?: Expression;
|
|
}
|
|
interface VariableDeclarationList extends Node {
|
|
declarations: NodeArray<VariableDeclaration>;
|
|
}
|
|
interface ParameterDeclaration extends Declaration {
|
|
dotDotDotToken?: Node;
|
|
name: Identifier | BindingPattern;
|
|
questionToken?: Node;
|
|
type?: TypeNode;
|
|
initializer?: Expression;
|
|
}
|
|
interface BindingElement extends Declaration {
|
|
propertyName?: PropertyName;
|
|
dotDotDotToken?: Node;
|
|
name: Identifier | BindingPattern;
|
|
initializer?: Expression;
|
|
}
|
|
interface PropertySignature extends TypeElement {
|
|
name: PropertyName;
|
|
questionToken?: Node;
|
|
type?: TypeNode;
|
|
initializer?: Expression;
|
|
}
|
|
interface PropertyDeclaration extends ClassElement {
|
|
questionToken?: Node;
|
|
name: PropertyName;
|
|
type?: TypeNode;
|
|
initializer?: Expression;
|
|
}
|
|
interface ObjectLiteralElement extends Declaration {
|
|
_objectLiteralBrandBrand: any;
|
|
name?: PropertyName;
|
|
}
|
|
interface PropertyAssignment extends ObjectLiteralElement {
|
|
_propertyAssignmentBrand: any;
|
|
name: PropertyName;
|
|
questionToken?: Node;
|
|
initializer: Expression;
|
|
}
|
|
interface ShorthandPropertyAssignment extends ObjectLiteralElement {
|
|
name: Identifier;
|
|
questionToken?: Node;
|
|
equalsToken?: Node;
|
|
objectAssignmentInitializer?: Expression;
|
|
}
|
|
interface VariableLikeDeclaration extends Declaration {
|
|
propertyName?: PropertyName;
|
|
dotDotDotToken?: Node;
|
|
name: DeclarationName;
|
|
questionToken?: Node;
|
|
type?: TypeNode;
|
|
initializer?: Expression;
|
|
}
|
|
interface PropertyLikeDeclaration extends Declaration {
|
|
name: PropertyName;
|
|
}
|
|
interface BindingPattern extends Node {
|
|
elements: NodeArray<BindingElement>;
|
|
}
|
|
interface ObjectBindingPattern extends BindingPattern {
|
|
}
|
|
interface ArrayBindingPattern extends BindingPattern {
|
|
}
|
|
/**
|
|
* Several node kinds share function-like features such as a signature,
|
|
* a name, and a body. These nodes should extend FunctionLikeDeclaration.
|
|
* Examples:
|
|
* - FunctionDeclaration
|
|
* - MethodDeclaration
|
|
* - AccessorDeclaration
|
|
*/
|
|
interface FunctionLikeDeclaration extends SignatureDeclaration {
|
|
_functionLikeDeclarationBrand: any;
|
|
asteriskToken?: Node;
|
|
questionToken?: Node;
|
|
body?: Block | Expression;
|
|
}
|
|
interface FunctionDeclaration extends FunctionLikeDeclaration, DeclarationStatement {
|
|
name?: Identifier;
|
|
body?: FunctionBody;
|
|
}
|
|
interface MethodSignature extends SignatureDeclaration, TypeElement {
|
|
name: PropertyName;
|
|
}
|
|
interface MethodDeclaration extends FunctionLikeDeclaration, ClassElement, ObjectLiteralElement {
|
|
name: PropertyName;
|
|
body?: FunctionBody;
|
|
}
|
|
interface ConstructorDeclaration extends FunctionLikeDeclaration, ClassElement {
|
|
body?: FunctionBody;
|
|
}
|
|
interface SemicolonClassElement extends ClassElement {
|
|
_semicolonClassElementBrand: any;
|
|
}
|
|
interface AccessorDeclaration extends FunctionLikeDeclaration, ClassElement, ObjectLiteralElement {
|
|
_accessorDeclarationBrand: any;
|
|
name: PropertyName;
|
|
body: FunctionBody;
|
|
}
|
|
interface GetAccessorDeclaration extends AccessorDeclaration {
|
|
}
|
|
interface SetAccessorDeclaration extends AccessorDeclaration {
|
|
}
|
|
interface IndexSignatureDeclaration extends SignatureDeclaration, ClassElement, TypeElement {
|
|
_indexSignatureDeclarationBrand: any;
|
|
}
|
|
interface TypeNode extends Node {
|
|
_typeNodeBrand: any;
|
|
}
|
|
interface ThisTypeNode extends TypeNode {
|
|
_thisTypeNodeBrand: any;
|
|
}
|
|
interface FunctionOrConstructorTypeNode extends TypeNode, SignatureDeclaration {
|
|
_functionOrConstructorTypeNodeBrand: any;
|
|
}
|
|
interface FunctionTypeNode extends FunctionOrConstructorTypeNode {
|
|
}
|
|
interface ConstructorTypeNode extends FunctionOrConstructorTypeNode {
|
|
}
|
|
interface TypeReferenceNode extends TypeNode {
|
|
typeName: EntityName;
|
|
typeArguments?: NodeArray<TypeNode>;
|
|
}
|
|
interface TypePredicateNode extends TypeNode {
|
|
parameterName: Identifier | ThisTypeNode;
|
|
type: TypeNode;
|
|
}
|
|
interface TypeQueryNode extends TypeNode {
|
|
exprName: EntityName;
|
|
}
|
|
interface TypeLiteralNode extends TypeNode, Declaration {
|
|
members: NodeArray<TypeElement>;
|
|
}
|
|
interface ArrayTypeNode extends TypeNode {
|
|
elementType: TypeNode;
|
|
}
|
|
interface TupleTypeNode extends TypeNode {
|
|
elementTypes: NodeArray<TypeNode>;
|
|
}
|
|
interface UnionOrIntersectionTypeNode extends TypeNode {
|
|
types: NodeArray<TypeNode>;
|
|
}
|
|
interface UnionTypeNode extends UnionOrIntersectionTypeNode {
|
|
}
|
|
interface IntersectionTypeNode extends UnionOrIntersectionTypeNode {
|
|
}
|
|
interface ParenthesizedTypeNode extends TypeNode {
|
|
type: TypeNode;
|
|
}
|
|
interface StringLiteralTypeNode extends LiteralLikeNode, TypeNode {
|
|
_stringLiteralTypeBrand: any;
|
|
}
|
|
interface StringLiteral extends LiteralExpression {
|
|
_stringLiteralBrand: any;
|
|
}
|
|
interface Expression extends Node {
|
|
_expressionBrand: any;
|
|
contextualType?: Type;
|
|
}
|
|
interface OmittedExpression extends Expression {
|
|
}
|
|
interface UnaryExpression extends Expression {
|
|
_unaryExpressionBrand: any;
|
|
}
|
|
interface IncrementExpression extends UnaryExpression {
|
|
_incrementExpressionBrand: any;
|
|
}
|
|
interface PrefixUnaryExpression extends IncrementExpression {
|
|
operator: SyntaxKind;
|
|
operand: UnaryExpression;
|
|
}
|
|
interface PostfixUnaryExpression extends IncrementExpression {
|
|
operand: LeftHandSideExpression;
|
|
operator: SyntaxKind;
|
|
}
|
|
interface PostfixExpression extends UnaryExpression {
|
|
_postfixExpressionBrand: any;
|
|
}
|
|
interface LeftHandSideExpression extends IncrementExpression {
|
|
_leftHandSideExpressionBrand: any;
|
|
}
|
|
interface MemberExpression extends LeftHandSideExpression {
|
|
_memberExpressionBrand: any;
|
|
}
|
|
interface PrimaryExpression extends MemberExpression {
|
|
_primaryExpressionBrand: any;
|
|
}
|
|
interface DeleteExpression extends UnaryExpression {
|
|
expression: UnaryExpression;
|
|
}
|
|
interface TypeOfExpression extends UnaryExpression {
|
|
expression: UnaryExpression;
|
|
}
|
|
interface VoidExpression extends UnaryExpression {
|
|
expression: UnaryExpression;
|
|
}
|
|
interface AwaitExpression extends UnaryExpression {
|
|
expression: UnaryExpression;
|
|
}
|
|
interface YieldExpression extends Expression {
|
|
asteriskToken?: Node;
|
|
expression?: Expression;
|
|
}
|
|
interface BinaryExpression extends Expression, Declaration {
|
|
left: Expression;
|
|
operatorToken: Node;
|
|
right: Expression;
|
|
}
|
|
interface ConditionalExpression extends Expression {
|
|
condition: Expression;
|
|
questionToken: Node;
|
|
whenTrue: Expression;
|
|
colonToken: Node;
|
|
whenFalse: Expression;
|
|
}
|
|
type FunctionBody = Block;
|
|
type ConciseBody = FunctionBody | Expression;
|
|
interface FunctionExpression extends PrimaryExpression, FunctionLikeDeclaration {
|
|
name?: Identifier;
|
|
body: FunctionBody;
|
|
}
|
|
interface ArrowFunction extends Expression, FunctionLikeDeclaration {
|
|
equalsGreaterThanToken: Node;
|
|
body: ConciseBody;
|
|
}
|
|
interface LiteralLikeNode extends Node {
|
|
text: string;
|
|
isUnterminated?: boolean;
|
|
hasExtendedUnicodeEscape?: boolean;
|
|
}
|
|
interface LiteralExpression extends LiteralLikeNode, PrimaryExpression {
|
|
_literalExpressionBrand: any;
|
|
}
|
|
interface TemplateLiteralFragment extends LiteralLikeNode {
|
|
_templateLiteralFragmentBrand: any;
|
|
}
|
|
interface TemplateExpression extends PrimaryExpression {
|
|
head: TemplateLiteralFragment;
|
|
templateSpans: NodeArray<TemplateSpan>;
|
|
}
|
|
interface TemplateSpan extends Node {
|
|
expression: Expression;
|
|
literal: TemplateLiteralFragment;
|
|
}
|
|
interface ParenthesizedExpression extends PrimaryExpression {
|
|
expression: Expression;
|
|
}
|
|
interface ArrayLiteralExpression extends PrimaryExpression {
|
|
elements: NodeArray<Expression>;
|
|
}
|
|
interface SpreadElementExpression extends Expression {
|
|
expression: Expression;
|
|
}
|
|
interface ObjectLiteralExpression extends PrimaryExpression, Declaration {
|
|
properties: NodeArray<ObjectLiteralElement>;
|
|
}
|
|
interface PropertyAccessExpression extends MemberExpression, Declaration {
|
|
expression: LeftHandSideExpression;
|
|
dotToken: Node;
|
|
name: Identifier;
|
|
}
|
|
type IdentifierOrPropertyAccess = Identifier | PropertyAccessExpression;
|
|
interface ElementAccessExpression extends MemberExpression {
|
|
expression: LeftHandSideExpression;
|
|
argumentExpression?: Expression;
|
|
}
|
|
interface CallExpression extends LeftHandSideExpression, Declaration {
|
|
expression: LeftHandSideExpression;
|
|
typeArguments?: NodeArray<TypeNode>;
|
|
arguments: NodeArray<Expression>;
|
|
}
|
|
interface ExpressionWithTypeArguments extends TypeNode {
|
|
expression: LeftHandSideExpression;
|
|
typeArguments?: NodeArray<TypeNode>;
|
|
}
|
|
interface NewExpression extends CallExpression, PrimaryExpression {
|
|
}
|
|
interface TaggedTemplateExpression extends MemberExpression {
|
|
tag: LeftHandSideExpression;
|
|
template: LiteralExpression | TemplateExpression;
|
|
}
|
|
type CallLikeExpression = CallExpression | NewExpression | TaggedTemplateExpression | Decorator;
|
|
interface AsExpression extends Expression {
|
|
expression: Expression;
|
|
type: TypeNode;
|
|
}
|
|
interface TypeAssertion extends UnaryExpression {
|
|
type: TypeNode;
|
|
expression: UnaryExpression;
|
|
}
|
|
type AssertionExpression = TypeAssertion | AsExpression;
|
|
interface NonNullExpression extends LeftHandSideExpression {
|
|
expression: Expression;
|
|
}
|
|
interface JsxElement extends PrimaryExpression {
|
|
openingElement: JsxOpeningElement;
|
|
children: NodeArray<JsxChild>;
|
|
closingElement: JsxClosingElement;
|
|
}
|
|
interface JsxOpeningElement extends Expression {
|
|
_openingElementBrand?: any;
|
|
tagName: EntityName;
|
|
attributes: NodeArray<JsxAttribute | JsxSpreadAttribute>;
|
|
}
|
|
interface JsxSelfClosingElement extends PrimaryExpression, JsxOpeningElement {
|
|
_selfClosingElementBrand?: any;
|
|
}
|
|
type JsxOpeningLikeElement = JsxSelfClosingElement | JsxOpeningElement;
|
|
interface JsxAttribute extends Node {
|
|
name: Identifier;
|
|
initializer?: Expression;
|
|
}
|
|
interface JsxSpreadAttribute extends Node {
|
|
expression: Expression;
|
|
}
|
|
interface JsxClosingElement extends Node {
|
|
tagName: EntityName;
|
|
}
|
|
interface JsxExpression extends Expression {
|
|
expression?: Expression;
|
|
}
|
|
interface JsxText extends Node {
|
|
_jsxTextExpressionBrand: any;
|
|
}
|
|
type JsxChild = JsxText | JsxExpression | JsxElement | JsxSelfClosingElement;
|
|
interface Statement extends Node {
|
|
_statementBrand: any;
|
|
}
|
|
interface EmptyStatement extends Statement {
|
|
}
|
|
interface DebuggerStatement extends Statement {
|
|
}
|
|
interface MissingDeclaration extends DeclarationStatement, ClassElement, ObjectLiteralElement, TypeElement {
|
|
name?: Identifier;
|
|
}
|
|
type BlockLike = SourceFile | Block | ModuleBlock | CaseClause;
|
|
interface Block extends Statement {
|
|
statements: NodeArray<Statement>;
|
|
}
|
|
interface VariableStatement extends Statement {
|
|
declarationList: VariableDeclarationList;
|
|
}
|
|
interface ExpressionStatement extends Statement {
|
|
expression: Expression;
|
|
}
|
|
interface IfStatement extends Statement {
|
|
expression: Expression;
|
|
thenStatement: Statement;
|
|
elseStatement?: Statement;
|
|
}
|
|
interface IterationStatement extends Statement {
|
|
statement: Statement;
|
|
}
|
|
interface DoStatement extends IterationStatement {
|
|
expression: Expression;
|
|
}
|
|
interface WhileStatement extends IterationStatement {
|
|
expression: Expression;
|
|
}
|
|
interface ForStatement extends IterationStatement {
|
|
initializer?: VariableDeclarationList | Expression;
|
|
condition?: Expression;
|
|
incrementor?: Expression;
|
|
}
|
|
interface ForInStatement extends IterationStatement {
|
|
initializer: VariableDeclarationList | Expression;
|
|
expression: Expression;
|
|
}
|
|
interface ForOfStatement extends IterationStatement {
|
|
initializer: VariableDeclarationList | Expression;
|
|
expression: Expression;
|
|
}
|
|
interface BreakStatement extends Statement {
|
|
label?: Identifier;
|
|
}
|
|
interface ContinueStatement extends Statement {
|
|
label?: Identifier;
|
|
}
|
|
type BreakOrContinueStatement = BreakStatement | ContinueStatement;
|
|
interface ReturnStatement extends Statement {
|
|
expression?: Expression;
|
|
}
|
|
interface WithStatement extends Statement {
|
|
expression: Expression;
|
|
statement: Statement;
|
|
}
|
|
interface SwitchStatement extends Statement {
|
|
expression: Expression;
|
|
caseBlock: CaseBlock;
|
|
}
|
|
interface CaseBlock extends Node {
|
|
clauses: NodeArray<CaseOrDefaultClause>;
|
|
}
|
|
interface CaseClause extends Node {
|
|
expression: Expression;
|
|
statements: NodeArray<Statement>;
|
|
}
|
|
interface DefaultClause extends Node {
|
|
statements: NodeArray<Statement>;
|
|
}
|
|
type CaseOrDefaultClause = CaseClause | DefaultClause;
|
|
interface LabeledStatement extends Statement {
|
|
label: Identifier;
|
|
statement: Statement;
|
|
}
|
|
interface ThrowStatement extends Statement {
|
|
expression: Expression;
|
|
}
|
|
interface TryStatement extends Statement {
|
|
tryBlock: Block;
|
|
catchClause?: CatchClause;
|
|
finallyBlock?: Block;
|
|
}
|
|
interface CatchClause extends Node {
|
|
variableDeclaration: VariableDeclaration;
|
|
block: Block;
|
|
}
|
|
type DeclarationWithTypeParameters = SignatureDeclaration | ClassLikeDeclaration | InterfaceDeclaration | TypeAliasDeclaration;
|
|
interface ClassLikeDeclaration extends Declaration {
|
|
name?: Identifier;
|
|
typeParameters?: NodeArray<TypeParameterDeclaration>;
|
|
heritageClauses?: NodeArray<HeritageClause>;
|
|
members: NodeArray<ClassElement>;
|
|
}
|
|
interface ClassDeclaration extends ClassLikeDeclaration, DeclarationStatement {
|
|
name?: Identifier;
|
|
}
|
|
interface ClassExpression extends ClassLikeDeclaration, PrimaryExpression {
|
|
}
|
|
interface ClassElement extends Declaration {
|
|
_classElementBrand: any;
|
|
name?: PropertyName;
|
|
}
|
|
interface TypeElement extends Declaration {
|
|
_typeElementBrand: any;
|
|
name?: PropertyName;
|
|
questionToken?: Node;
|
|
}
|
|
interface InterfaceDeclaration extends DeclarationStatement {
|
|
name: Identifier;
|
|
typeParameters?: NodeArray<TypeParameterDeclaration>;
|
|
heritageClauses?: NodeArray<HeritageClause>;
|
|
members: NodeArray<TypeElement>;
|
|
}
|
|
interface HeritageClause extends Node {
|
|
token: SyntaxKind;
|
|
types?: NodeArray<ExpressionWithTypeArguments>;
|
|
}
|
|
interface TypeAliasDeclaration extends DeclarationStatement {
|
|
name: Identifier;
|
|
typeParameters?: NodeArray<TypeParameterDeclaration>;
|
|
type: TypeNode;
|
|
}
|
|
interface EnumMember extends Declaration {
|
|
name: DeclarationName;
|
|
initializer?: Expression;
|
|
}
|
|
interface EnumDeclaration extends DeclarationStatement {
|
|
name: Identifier;
|
|
members: NodeArray<EnumMember>;
|
|
}
|
|
type ModuleBody = ModuleBlock | ModuleDeclaration;
|
|
interface ModuleDeclaration extends DeclarationStatement {
|
|
name: Identifier | LiteralExpression;
|
|
body: ModuleBlock | ModuleDeclaration;
|
|
}
|
|
interface ModuleBlock extends Node, Statement {
|
|
statements: NodeArray<Statement>;
|
|
}
|
|
interface ImportEqualsDeclaration extends DeclarationStatement {
|
|
name: Identifier;
|
|
moduleReference: EntityName | ExternalModuleReference;
|
|
}
|
|
interface ExternalModuleReference extends Node {
|
|
expression?: Expression;
|
|
}
|
|
interface ImportDeclaration extends Statement {
|
|
importClause?: ImportClause;
|
|
moduleSpecifier: Expression;
|
|
}
|
|
interface ImportClause extends Declaration {
|
|
name?: Identifier;
|
|
namedBindings?: NamespaceImport | NamedImports;
|
|
}
|
|
interface NamespaceImport extends Declaration {
|
|
name: Identifier;
|
|
}
|
|
interface NamespaceExportDeclaration extends DeclarationStatement {
|
|
name: Identifier;
|
|
moduleReference: LiteralLikeNode;
|
|
}
|
|
interface ExportDeclaration extends DeclarationStatement {
|
|
exportClause?: NamedExports;
|
|
moduleSpecifier?: Expression;
|
|
}
|
|
interface NamedImports extends Node {
|
|
elements: NodeArray<ImportSpecifier>;
|
|
}
|
|
interface NamedExports extends Node {
|
|
elements: NodeArray<ExportSpecifier>;
|
|
}
|
|
type NamedImportsOrExports = NamedImports | NamedExports;
|
|
interface ImportSpecifier extends Declaration {
|
|
propertyName?: Identifier;
|
|
name: Identifier;
|
|
}
|
|
interface ExportSpecifier extends Declaration {
|
|
propertyName?: Identifier;
|
|
name: Identifier;
|
|
}
|
|
type ImportOrExportSpecifier = ImportSpecifier | ExportSpecifier;
|
|
interface ExportAssignment extends DeclarationStatement {
|
|
isExportEquals?: boolean;
|
|
expression: Expression;
|
|
}
|
|
interface FileReference extends TextRange {
|
|
fileName: string;
|
|
}
|
|
interface CommentRange extends TextRange {
|
|
hasTrailingNewLine?: boolean;
|
|
kind: SyntaxKind;
|
|
}
|
|
interface JSDocTypeExpression extends Node {
|
|
type: JSDocType;
|
|
}
|
|
interface JSDocType extends TypeNode {
|
|
_jsDocTypeBrand: any;
|
|
}
|
|
interface JSDocAllType extends JSDocType {
|
|
_JSDocAllTypeBrand: any;
|
|
}
|
|
interface JSDocUnknownType extends JSDocType {
|
|
_JSDocUnknownTypeBrand: any;
|
|
}
|
|
interface JSDocArrayType extends JSDocType {
|
|
elementType: JSDocType;
|
|
}
|
|
interface JSDocUnionType extends JSDocType {
|
|
types: NodeArray<JSDocType>;
|
|
}
|
|
interface JSDocTupleType extends JSDocType {
|
|
types: NodeArray<JSDocType>;
|
|
}
|
|
interface JSDocNonNullableType extends JSDocType {
|
|
type: JSDocType;
|
|
}
|
|
interface JSDocNullableType extends JSDocType {
|
|
type: JSDocType;
|
|
}
|
|
interface JSDocRecordType extends JSDocType, TypeLiteralNode {
|
|
members: NodeArray<JSDocRecordMember>;
|
|
}
|
|
interface JSDocTypeReference extends JSDocType {
|
|
name: EntityName;
|
|
typeArguments: NodeArray<JSDocType>;
|
|
}
|
|
interface JSDocOptionalType extends JSDocType {
|
|
type: JSDocType;
|
|
}
|
|
interface JSDocFunctionType extends JSDocType, SignatureDeclaration {
|
|
parameters: NodeArray<ParameterDeclaration>;
|
|
type: JSDocType;
|
|
}
|
|
interface JSDocVariadicType extends JSDocType {
|
|
type: JSDocType;
|
|
}
|
|
interface JSDocConstructorType extends JSDocType {
|
|
type: JSDocType;
|
|
}
|
|
interface JSDocThisType extends JSDocType {
|
|
type: JSDocType;
|
|
}
|
|
type JSDocTypeReferencingNode = JSDocThisType | JSDocConstructorType | JSDocVariadicType | JSDocOptionalType | JSDocNullableType | JSDocNonNullableType;
|
|
interface JSDocRecordMember extends PropertySignature {
|
|
name: Identifier | LiteralExpression;
|
|
type?: JSDocType;
|
|
}
|
|
interface JSDocComment extends Node {
|
|
tags: NodeArray<JSDocTag>;
|
|
}
|
|
interface JSDocTag extends Node {
|
|
atToken: Node;
|
|
tagName: Identifier;
|
|
}
|
|
interface JSDocTemplateTag extends JSDocTag {
|
|
typeParameters: NodeArray<TypeParameterDeclaration>;
|
|
}
|
|
interface JSDocReturnTag extends JSDocTag {
|
|
typeExpression: JSDocTypeExpression;
|
|
}
|
|
interface JSDocTypeTag extends JSDocTag {
|
|
typeExpression: JSDocTypeExpression;
|
|
}
|
|
interface JSDocTypedefTag extends JSDocTag, Declaration {
|
|
name?: Identifier;
|
|
typeExpression?: JSDocTypeExpression;
|
|
jsDocTypeLiteral?: JSDocTypeLiteral;
|
|
}
|
|
interface JSDocPropertyTag extends JSDocTag, TypeElement {
|
|
name: Identifier;
|
|
typeExpression: JSDocTypeExpression;
|
|
}
|
|
interface JSDocTypeLiteral extends JSDocType {
|
|
jsDocPropertyTags?: NodeArray<JSDocPropertyTag>;
|
|
jsDocTypeTag?: JSDocTypeTag;
|
|
}
|
|
interface JSDocParameterTag extends JSDocTag {
|
|
preParameterName?: Identifier;
|
|
typeExpression?: JSDocTypeExpression;
|
|
postParameterName?: Identifier;
|
|
isBracketed: boolean;
|
|
}
|
|
enum FlowFlags {
|
|
Unreachable = 1,
|
|
Start = 2,
|
|
BranchLabel = 4,
|
|
LoopLabel = 8,
|
|
Assignment = 16,
|
|
TrueCondition = 32,
|
|
FalseCondition = 64,
|
|
Referenced = 128,
|
|
Shared = 256,
|
|
Label = 12,
|
|
Condition = 96,
|
|
}
|
|
interface FlowNode {
|
|
flags: FlowFlags;
|
|
id?: number;
|
|
}
|
|
interface FlowStart extends FlowNode {
|
|
container?: FunctionExpression | ArrowFunction;
|
|
}
|
|
interface FlowLabel extends FlowNode {
|
|
antecedents: FlowNode[];
|
|
}
|
|
interface FlowAssignment extends FlowNode {
|
|
node: Expression | VariableDeclaration | BindingElement;
|
|
antecedent: FlowNode;
|
|
}
|
|
interface FlowCondition extends FlowNode {
|
|
expression: Expression;
|
|
antecedent: FlowNode;
|
|
}
|
|
interface AmdDependency {
|
|
path: string;
|
|
name: string;
|
|
}
|
|
interface SourceFile extends Declaration {
|
|
statements: NodeArray<Statement>;
|
|
endOfFileToken: Node;
|
|
fileName: string;
|
|
path: Path;
|
|
text: string;
|
|
amdDependencies: AmdDependency[];
|
|
moduleName: string;
|
|
referencedFiles: FileReference[];
|
|
typeReferenceDirectives: 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;
|
|
}
|
|
interface ScriptReferenceHost {
|
|
getCompilerOptions(): CompilerOptions;
|
|
getSourceFile(fileName: string): SourceFile;
|
|
getSourceFileByPath(path: Path): SourceFile;
|
|
getCurrentDirectory(): string;
|
|
}
|
|
interface ParseConfigHost {
|
|
readDirectory(rootDir: string, extension: string, exclude: string[]): string[];
|
|
}
|
|
interface WriteFileCallback {
|
|
(fileName: string, data: string, writeByteOrderMark: boolean, onError?: (message: string) => void, sourceFiles?: SourceFile[]): void;
|
|
}
|
|
class OperationCanceledException {
|
|
}
|
|
interface CancellationToken {
|
|
isCancellationRequested(): boolean;
|
|
/** @throws OperationCanceledException if isCancellationRequested is true */
|
|
throwIfCancellationRequested(): void;
|
|
}
|
|
interface Program extends ScriptReferenceHost {
|
|
/**
|
|
* Get a list of root file names that were passed to a 'createProgram'
|
|
*/
|
|
getRootFileNames(): string[];
|
|
/**
|
|
* Get a list of files in the program
|
|
*/
|
|
getSourceFiles(): 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): EmitResult;
|
|
getOptionsDiagnostics(cancellationToken?: CancellationToken): Diagnostic[];
|
|
getGlobalDiagnostics(cancellationToken?: CancellationToken): Diagnostic[];
|
|
getSyntacticDiagnostics(sourceFile?: SourceFile, cancellationToken?: CancellationToken): Diagnostic[];
|
|
getSemanticDiagnostics(sourceFile?: SourceFile, cancellationToken?: CancellationToken): Diagnostic[];
|
|
getDeclarationDiagnostics(sourceFile?: SourceFile, cancellationToken?: CancellationToken): Diagnostic[];
|
|
/**
|
|
* Gets a type checker that can be used to semantically analyze source fils in the program.
|
|
*/
|
|
getTypeChecker(): TypeChecker;
|
|
}
|
|
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;
|
|
}
|
|
interface SourceMapData {
|
|
sourceMapFilePath: string;
|
|
jsSourceMappingURL: string;
|
|
sourceMapFile: string;
|
|
sourceMapSourceRoot: string;
|
|
sourceMapSources: string[];
|
|
sourceMapSourcesContent?: string[];
|
|
inputSourceFileNames: string[];
|
|
sourceMapNames?: string[];
|
|
sourceMapMappings: string;
|
|
sourceMapDecodedMappings: SourceMapSpan[];
|
|
}
|
|
/** Return code used by getEmitOutput function to indicate status of the function */
|
|
enum ExitStatus {
|
|
Success = 0,
|
|
DiagnosticsPresent_OutputsSkipped = 1,
|
|
DiagnosticsPresent_OutputsGenerated = 2,
|
|
}
|
|
interface EmitResult {
|
|
emitSkipped: boolean;
|
|
/** Contains declaration emit diagnostics */
|
|
diagnostics: Diagnostic[];
|
|
emittedFiles: string[];
|
|
}
|
|
interface TypeChecker {
|
|
getTypeOfSymbolAtLocation(symbol: Symbol, node: Node): Type;
|
|
getDeclaredTypeOfSymbol(symbol: Symbol): Type;
|
|
getPropertiesOfType(type: Type): Symbol[];
|
|
getPropertyOfType(type: Type, propertyName: string): Symbol;
|
|
getSignaturesOfType(type: Type, kind: SignatureKind): Signature[];
|
|
getIndexTypeOfType(type: Type, kind: IndexKind): Type;
|
|
getBaseTypes(type: InterfaceType): ObjectType[];
|
|
getReturnTypeOfSignature(signature: Signature): Type;
|
|
getNonNullableType(type: Type): Type;
|
|
getSymbolsInScope(location: Node, meaning: SymbolFlags): Symbol[];
|
|
getSymbolAtLocation(node: Node): Symbol;
|
|
getSymbolsOfParameterPropertyDeclaration(parameter: ParameterDeclaration, parameterName: string): Symbol[];
|
|
getShorthandAssignmentValueSymbol(location: Node): Symbol;
|
|
getExportSpecifierLocalTargetSymbol(location: ExportSpecifier): Symbol;
|
|
getPropertySymbolOfDestructuringAssignment(location: Identifier): Symbol;
|
|
getTypeAtLocation(node: Node): Type;
|
|
typeToString(type: Type, enclosingDeclaration?: Node, flags?: TypeFormatFlags): string;
|
|
symbolToString(symbol: Symbol, enclosingDeclaration?: Node, meaning?: SymbolFlags): string;
|
|
getSymbolDisplayBuilder(): SymbolDisplayBuilder;
|
|
getFullyQualifiedName(symbol: Symbol): string;
|
|
getAugmentedPropertiesOfType(type: Type): Symbol[];
|
|
getRootSymbols(symbol: Symbol): Symbol[];
|
|
getContextualType(node: Expression): Type;
|
|
getResolvedSignature(node: CallLikeExpression, candidatesOutArray?: Signature[]): Signature;
|
|
getSignatureFromDeclaration(declaration: SignatureDeclaration): Signature;
|
|
isImplementationOfOverload(node: FunctionLikeDeclaration): boolean;
|
|
isUndefinedSymbol(symbol: Symbol): boolean;
|
|
isArgumentsSymbol(symbol: Symbol): boolean;
|
|
isUnknownSymbol(symbol: Symbol): boolean;
|
|
getConstantValue(node: EnumMember | PropertyAccessExpression | ElementAccessExpression): number;
|
|
isValidPropertyAccess(node: PropertyAccessExpression | QualifiedName, propertyName: string): boolean;
|
|
getAliasedSymbol(symbol: Symbol): Symbol;
|
|
getExportsOfModule(moduleSymbol: Symbol): Symbol[];
|
|
getJsxElementAttributesType(elementNode: JsxOpeningLikeElement): Type;
|
|
getJsxIntrinsicTagNames(): Symbol[];
|
|
isOptionalParameter(node: ParameterDeclaration): boolean;
|
|
}
|
|
interface SymbolDisplayBuilder {
|
|
buildTypeDisplay(type: Type, writer: SymbolWriter, enclosingDeclaration?: Node, flags?: TypeFormatFlags): void;
|
|
buildSymbolDisplay(symbol: Symbol, writer: SymbolWriter, enclosingDeclaration?: Node, meaning?: SymbolFlags, flags?: SymbolFormatFlags): void;
|
|
buildSignatureDisplay(signatures: Signature, writer: SymbolWriter, enclosingDeclaration?: Node, flags?: TypeFormatFlags, kind?: SignatureKind): void;
|
|
buildParameterDisplay(parameter: Symbol, writer: SymbolWriter, enclosingDeclaration?: Node, flags?: TypeFormatFlags): void;
|
|
buildTypeParameterDisplay(tp: TypeParameter, writer: SymbolWriter, enclosingDeclaration?: Node, flags?: TypeFormatFlags): void;
|
|
buildTypePredicateDisplay(predicate: TypePredicate, writer: SymbolWriter, enclosingDeclaration?: Node, flags?: TypeFormatFlags): void;
|
|
buildTypeParameterDisplayFromSymbol(symbol: Symbol, writer: SymbolWriter, enclosingDeclaration?: Node, flags?: TypeFormatFlags): void;
|
|
buildDisplayForParametersAndDelimiters(thisType: Type, parameters: Symbol[], writer: SymbolWriter, enclosingDeclaration?: Node, flags?: TypeFormatFlags): void;
|
|
buildDisplayForTypeParametersAndDelimiters(typeParameters: TypeParameter[], writer: SymbolWriter, enclosingDeclaration?: Node, flags?: TypeFormatFlags): void;
|
|
buildReturnTypeDisplay(signature: Signature, writer: SymbolWriter, enclosingDeclaration?: Node, flags?: TypeFormatFlags): void;
|
|
}
|
|
interface SymbolWriter {
|
|
writeKeyword(text: string): void;
|
|
writeOperator(text: string): void;
|
|
writePunctuation(text: string): void;
|
|
writeSpace(text: string): void;
|
|
writeStringLiteral(text: string): void;
|
|
writeParameter(text: string): void;
|
|
writeSymbol(text: string, symbol: Symbol): void;
|
|
writeLine(): void;
|
|
increaseIndent(): void;
|
|
decreaseIndent(): void;
|
|
clear(): void;
|
|
trackSymbol(symbol: Symbol, enclosingDeclaration?: Node, meaning?: SymbolFlags): void;
|
|
reportInaccessibleThisError(): void;
|
|
}
|
|
enum TypeFormatFlags {
|
|
None = 0,
|
|
WriteArrayAsGenericType = 1,
|
|
UseTypeOfFunction = 2,
|
|
NoTruncation = 4,
|
|
WriteArrowStyleSignature = 8,
|
|
WriteOwnNameForAnyLike = 16,
|
|
WriteTypeArgumentsOfSignature = 32,
|
|
InElementType = 64,
|
|
UseFullyQualifiedType = 128,
|
|
InFirstTypeArgument = 256,
|
|
}
|
|
enum SymbolFormatFlags {
|
|
None = 0,
|
|
WriteTypeParametersOrArguments = 1,
|
|
UseOnlyExternalAliasing = 2,
|
|
}
|
|
enum TypePredicateKind {
|
|
This = 0,
|
|
Identifier = 1,
|
|
}
|
|
interface TypePredicateBase {
|
|
kind: TypePredicateKind;
|
|
type: Type;
|
|
}
|
|
interface ThisTypePredicate extends TypePredicateBase {
|
|
_thisTypePredicateBrand: any;
|
|
}
|
|
interface IdentifierTypePredicate extends TypePredicateBase {
|
|
parameterName: string;
|
|
parameterIndex: number;
|
|
}
|
|
type TypePredicate = IdentifierTypePredicate | ThisTypePredicate;
|
|
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,
|
|
ExportType = 2097152,
|
|
ExportNamespace = 4194304,
|
|
Alias = 8388608,
|
|
Instantiated = 16777216,
|
|
Merged = 33554432,
|
|
Transient = 67108864,
|
|
Prototype = 134217728,
|
|
SyntheticProperty = 268435456,
|
|
Optional = 536870912,
|
|
ExportStar = 1073741824,
|
|
Enum = 384,
|
|
Variable = 3,
|
|
Value = 107455,
|
|
Type = 793056,
|
|
Namespace = 1536,
|
|
Module = 1536,
|
|
Accessor = 98304,
|
|
FunctionScopedVariableExcludes = 107454,
|
|
BlockScopedVariableExcludes = 107455,
|
|
ParameterExcludes = 107455,
|
|
PropertyExcludes = 0,
|
|
EnumMemberExcludes = 107455,
|
|
FunctionExcludes = 106927,
|
|
ClassExcludes = 899519,
|
|
InterfaceExcludes = 792960,
|
|
RegularEnumExcludes = 899327,
|
|
ConstEnumExcludes = 899967,
|
|
ValueModuleExcludes = 106639,
|
|
NamespaceModuleExcludes = 0,
|
|
MethodExcludes = 99263,
|
|
GetAccessorExcludes = 41919,
|
|
SetAccessorExcludes = 74687,
|
|
TypeParameterExcludes = 530912,
|
|
TypeAliasExcludes = 793056,
|
|
AliasExcludes = 8388608,
|
|
ModuleMember = 8914931,
|
|
ExportHasLocal = 944,
|
|
HasExports = 1952,
|
|
HasMembers = 6240,
|
|
BlockScoped = 418,
|
|
PropertyOrAccessor = 98308,
|
|
Export = 7340032,
|
|
}
|
|
interface Symbol {
|
|
flags: SymbolFlags;
|
|
name: string;
|
|
declarations?: Declaration[];
|
|
valueDeclaration?: Declaration;
|
|
members?: SymbolTable;
|
|
exports?: SymbolTable;
|
|
globalExports?: SymbolTable;
|
|
}
|
|
interface SymbolTable {
|
|
[index: string]: Symbol;
|
|
}
|
|
enum TypeFlags {
|
|
Any = 1,
|
|
String = 2,
|
|
Number = 4,
|
|
Boolean = 8,
|
|
Void = 16,
|
|
Undefined = 32,
|
|
Null = 64,
|
|
Enum = 128,
|
|
StringLiteral = 256,
|
|
TypeParameter = 512,
|
|
Class = 1024,
|
|
Interface = 2048,
|
|
Reference = 4096,
|
|
Tuple = 8192,
|
|
Union = 16384,
|
|
Intersection = 32768,
|
|
Anonymous = 65536,
|
|
Instantiated = 131072,
|
|
ObjectLiteral = 524288,
|
|
ESSymbol = 16777216,
|
|
ThisType = 33554432,
|
|
ObjectLiteralPatternWithComputedProperties = 67108864,
|
|
Never = 134217728,
|
|
Falsy = 126,
|
|
StringLike = 258,
|
|
NumberLike = 132,
|
|
ObjectType = 80896,
|
|
UnionOrIntersection = 49152,
|
|
StructuredType = 130048,
|
|
Narrowable = 16908175,
|
|
}
|
|
type DestructuringPattern = BindingPattern | ObjectLiteralExpression | ArrayLiteralExpression;
|
|
interface Type {
|
|
flags: TypeFlags;
|
|
symbol?: Symbol;
|
|
pattern?: DestructuringPattern;
|
|
}
|
|
interface StringLiteralType extends Type {
|
|
text: string;
|
|
}
|
|
interface ObjectType extends Type {
|
|
}
|
|
interface InterfaceType extends ObjectType {
|
|
typeParameters: TypeParameter[];
|
|
outerTypeParameters: TypeParameter[];
|
|
localTypeParameters: TypeParameter[];
|
|
thisType: TypeParameter;
|
|
}
|
|
interface InterfaceTypeWithDeclaredMembers extends InterfaceType {
|
|
declaredProperties: Symbol[];
|
|
declaredCallSignatures: Signature[];
|
|
declaredConstructSignatures: Signature[];
|
|
declaredStringIndexInfo: IndexInfo;
|
|
declaredNumberIndexInfo: IndexInfo;
|
|
}
|
|
interface TypeReference extends ObjectType {
|
|
target: GenericType;
|
|
typeArguments: Type[];
|
|
}
|
|
interface GenericType extends InterfaceType, TypeReference {
|
|
}
|
|
interface TupleType extends ObjectType {
|
|
elementTypes: Type[];
|
|
}
|
|
interface UnionOrIntersectionType extends Type {
|
|
types: Type[];
|
|
}
|
|
interface UnionType extends UnionOrIntersectionType {
|
|
}
|
|
interface IntersectionType extends UnionOrIntersectionType {
|
|
}
|
|
interface TypeParameter extends Type {
|
|
constraint: Type;
|
|
}
|
|
enum SignatureKind {
|
|
Call = 0,
|
|
Construct = 1,
|
|
}
|
|
interface Signature {
|
|
declaration: SignatureDeclaration;
|
|
typeParameters: TypeParameter[];
|
|
parameters: Symbol[];
|
|
thisType?: Type;
|
|
}
|
|
enum IndexKind {
|
|
String = 0,
|
|
Number = 1,
|
|
}
|
|
interface IndexInfo {
|
|
type: Type;
|
|
isReadonly: boolean;
|
|
declaration?: SignatureDeclaration;
|
|
}
|
|
interface DiagnosticMessage {
|
|
key: string;
|
|
category: DiagnosticCategory;
|
|
code: number;
|
|
message: string;
|
|
}
|
|
/**
|
|
* 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.
|
|
*/
|
|
interface DiagnosticMessageChain {
|
|
messageText: string;
|
|
category: DiagnosticCategory;
|
|
code: number;
|
|
next?: DiagnosticMessageChain;
|
|
}
|
|
interface Diagnostic {
|
|
file: SourceFile;
|
|
start: number;
|
|
length: number;
|
|
messageText: string | DiagnosticMessageChain;
|
|
category: DiagnosticCategory;
|
|
code: number;
|
|
}
|
|
enum DiagnosticCategory {
|
|
Warning = 0,
|
|
Error = 1,
|
|
Message = 2,
|
|
}
|
|
enum ModuleResolutionKind {
|
|
Classic = 1,
|
|
NodeJs = 2,
|
|
}
|
|
type RootPaths = string[];
|
|
type PathSubstitutions = Map<string[]>;
|
|
type TsConfigOnlyOptions = RootPaths | PathSubstitutions;
|
|
type CompilerOptionsValue = string | number | boolean | (string | number)[] | TsConfigOnlyOptions;
|
|
interface CompilerOptions {
|
|
allowJs?: boolean;
|
|
allowSyntheticDefaultImports?: boolean;
|
|
allowUnreachableCode?: boolean;
|
|
allowUnusedLabels?: boolean;
|
|
baseUrl?: string;
|
|
charset?: string;
|
|
declaration?: boolean;
|
|
declarationDir?: string;
|
|
emitBOM?: boolean;
|
|
emitDecoratorMetadata?: boolean;
|
|
experimentalDecorators?: boolean;
|
|
forceConsistentCasingInFileNames?: boolean;
|
|
inlineSourceMap?: boolean;
|
|
inlineSources?: boolean;
|
|
isolatedModules?: boolean;
|
|
jsx?: JsxEmit;
|
|
lib?: string[];
|
|
locale?: string;
|
|
mapRoot?: string;
|
|
module?: ModuleKind;
|
|
moduleResolution?: ModuleResolutionKind;
|
|
newLine?: NewLineKind;
|
|
noEmit?: boolean;
|
|
noEmitHelpers?: boolean;
|
|
noEmitOnError?: boolean;
|
|
noErrorTruncation?: boolean;
|
|
noFallthroughCasesInSwitch?: boolean;
|
|
noImplicitAny?: boolean;
|
|
noImplicitReturns?: boolean;
|
|
noImplicitThis?: boolean;
|
|
noImplicitUseStrict?: boolean;
|
|
noLib?: boolean;
|
|
noResolve?: boolean;
|
|
out?: string;
|
|
outDir?: string;
|
|
outFile?: string;
|
|
paths?: PathSubstitutions;
|
|
preserveConstEnums?: boolean;
|
|
project?: string;
|
|
reactNamespace?: string;
|
|
removeComments?: boolean;
|
|
rootDir?: string;
|
|
rootDirs?: RootPaths;
|
|
skipLibCheck?: boolean;
|
|
skipDefaultLibCheck?: boolean;
|
|
sourceMap?: boolean;
|
|
sourceRoot?: string;
|
|
strictNullChecks?: boolean;
|
|
suppressExcessPropertyErrors?: boolean;
|
|
suppressImplicitAnyIndexErrors?: boolean;
|
|
target?: ScriptTarget;
|
|
traceResolution?: boolean;
|
|
types?: string[];
|
|
typesSearchPaths?: string[];
|
|
[option: string]: CompilerOptionsValue | undefined;
|
|
}
|
|
interface TypingOptions {
|
|
enableAutoDiscovery?: boolean;
|
|
include?: string[];
|
|
exclude?: string[];
|
|
[option: string]: string[] | boolean | undefined;
|
|
}
|
|
interface DiscoverTypingsInfo {
|
|
fileNames: string[];
|
|
projectRootPath: string;
|
|
safeListPath: string;
|
|
packageNameToTypingLocation: Map<string>;
|
|
typingOptions: TypingOptions;
|
|
compilerOptions: CompilerOptions;
|
|
}
|
|
enum ModuleKind {
|
|
None = 0,
|
|
CommonJS = 1,
|
|
AMD = 2,
|
|
UMD = 3,
|
|
System = 4,
|
|
ES6 = 5,
|
|
ES2015 = 5,
|
|
}
|
|
enum JsxEmit {
|
|
None = 0,
|
|
Preserve = 1,
|
|
React = 2,
|
|
}
|
|
enum NewLineKind {
|
|
CarriageReturnLineFeed = 0,
|
|
LineFeed = 1,
|
|
}
|
|
interface LineAndCharacter {
|
|
line: number;
|
|
character: number;
|
|
}
|
|
enum ScriptKind {
|
|
Unknown = 0,
|
|
JS = 1,
|
|
JSX = 2,
|
|
TS = 3,
|
|
TSX = 4,
|
|
}
|
|
enum ScriptTarget {
|
|
ES3 = 0,
|
|
ES5 = 1,
|
|
ES6 = 2,
|
|
ES2015 = 2,
|
|
Latest = 2,
|
|
}
|
|
enum LanguageVariant {
|
|
Standard = 0,
|
|
JSX = 1,
|
|
}
|
|
interface ParsedCommandLine {
|
|
options: CompilerOptions;
|
|
typingOptions?: TypingOptions;
|
|
fileNames: string[];
|
|
raw?: any;
|
|
errors: Diagnostic[];
|
|
}
|
|
interface ModuleResolutionHost {
|
|
fileExists(fileName: string): boolean;
|
|
readFile(fileName: string): string;
|
|
trace?(s: string): void;
|
|
directoryExists?(directoryName: string): boolean;
|
|
realpath?(path: string): string;
|
|
getCurrentDirectory?(): string;
|
|
}
|
|
interface ResolvedModule {
|
|
resolvedFileName: string;
|
|
isExternalLibraryImport?: boolean;
|
|
}
|
|
interface ResolvedModuleWithFailedLookupLocations {
|
|
resolvedModule: ResolvedModule;
|
|
failedLookupLocations: string[];
|
|
}
|
|
interface ResolvedTypeReferenceDirective {
|
|
primary: boolean;
|
|
resolvedFileName?: string;
|
|
}
|
|
interface ResolvedTypeReferenceDirectiveWithFailedLookupLocations {
|
|
resolvedTypeReferenceDirective: ResolvedTypeReferenceDirective;
|
|
failedLookupLocations: string[];
|
|
}
|
|
interface CompilerHost extends ModuleResolutionHost {
|
|
getSourceFile(fileName: string, languageVersion: ScriptTarget, onError?: (message: string) => void): SourceFile;
|
|
getSourceFileByPath?(fileName: string, path: Path, languageVersion: ScriptTarget, onError?: (message: string) => void): SourceFile;
|
|
getCancellationToken?(): CancellationToken;
|
|
getDefaultLibFileName(options: CompilerOptions): string;
|
|
getDefaultLibLocation?(): string;
|
|
getDefaultTypeDirectiveNames?(rootPath: string): string[];
|
|
writeFile: WriteFileCallback;
|
|
getCurrentDirectory(): string;
|
|
getCanonicalFileName(fileName: string): string;
|
|
useCaseSensitiveFileNames(): boolean;
|
|
getNewLine(): string;
|
|
resolveModuleNames?(moduleNames: string[], containingFile: string): ResolvedModule[];
|
|
/**
|
|
* This method is a companion for 'resolveModuleNames' and is used to resolve 'types' references to actual type declaration files
|
|
*/
|
|
resolveTypeReferenceDirectives?(typeReferenceDirectiveNames: string[], containingFile: string): ResolvedTypeReferenceDirective[];
|
|
}
|
|
interface TextSpan {
|
|
start: number;
|
|
length: number;
|
|
}
|
|
interface TextChangeRange {
|
|
span: TextSpan;
|
|
newLength: number;
|
|
}
|
|
interface SyntaxList extends Node {
|
|
_children: Node[];
|
|
}
|
|
}
|
|
declare namespace ts {
|
|
type FileWatcherCallback = (fileName: string, removed?: boolean) => void;
|
|
type DirectoryWatcherCallback = (fileName: string) => void;
|
|
interface WatchedFile {
|
|
fileName: string;
|
|
callback: FileWatcherCallback;
|
|
mtime?: Date;
|
|
}
|
|
interface System {
|
|
args: string[];
|
|
newLine: string;
|
|
useCaseSensitiveFileNames: boolean;
|
|
write(s: string): void;
|
|
readFile(path: string, encoding?: string): string;
|
|
writeFile(path: string, data: string, writeByteOrderMark?: boolean): void;
|
|
watchFile?(path: string, callback: FileWatcherCallback): FileWatcher;
|
|
watchDirectory?(path: string, callback: DirectoryWatcherCallback, recursive?: boolean): 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, extension?: string, exclude?: string[]): string[];
|
|
getModifiedTime?(path: string): Date;
|
|
createHash?(data: string): string;
|
|
getMemoryUsage?(): number;
|
|
exit(exitCode?: number): void;
|
|
realpath?(path: string): string;
|
|
}
|
|
interface FileWatcher {
|
|
close(): void;
|
|
}
|
|
interface DirectoryWatcher extends FileWatcher {
|
|
directoryName: string;
|
|
referenceCount: number;
|
|
}
|
|
var sys: System;
|
|
}
|
|
declare namespace ts {
|
|
interface ErrorCallback {
|
|
(message: DiagnosticMessage, length: number): void;
|
|
}
|
|
interface Scanner {
|
|
getStartPos(): number;
|
|
getToken(): SyntaxKind;
|
|
getTextPos(): number;
|
|
getTokenPos(): number;
|
|
getTokenText(): string;
|
|
getTokenValue(): string;
|
|
hasExtendedUnicodeEscape(): boolean;
|
|
hasPrecedingLineBreak(): boolean;
|
|
isIdentifier(): boolean;
|
|
isReservedWord(): boolean;
|
|
isUnterminated(): boolean;
|
|
reScanGreaterToken(): SyntaxKind;
|
|
reScanSlashToken(): SyntaxKind;
|
|
reScanTemplateToken(): SyntaxKind;
|
|
scanJsxIdentifier(): SyntaxKind;
|
|
reScanJsxToken(): SyntaxKind;
|
|
scanJsxToken(): SyntaxKind;
|
|
scanJSDocToken(): SyntaxKind;
|
|
scan(): SyntaxKind;
|
|
setText(text: string, start?: number, length?: number): void;
|
|
setOnError(onError: ErrorCallback): 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;
|
|
function getPositionOfLineAndCharacter(sourceFile: SourceFile, line: number, character: number): number;
|
|
function getLineAndCharacterOfPosition(sourceFile: SourceFile, position: number): LineAndCharacter;
|
|
function isWhiteSpace(ch: number): boolean;
|
|
function isLineBreak(ch: number): boolean;
|
|
function couldStartTrivia(text: string, pos: number): boolean;
|
|
function getLeadingCommentRanges(text: string, pos: number): CommentRange[];
|
|
function getTrailingCommentRanges(text: string, pos: number): CommentRange[];
|
|
/** Optionally, get the shebang */
|
|
function getShebang(text: string): string;
|
|
function isIdentifierStart(ch: number, languageVersion: ScriptTarget): boolean;
|
|
function isIdentifierPart(ch: number, languageVersion: ScriptTarget): boolean;
|
|
function createScanner(languageVersion: ScriptTarget, skipTrivia: boolean, languageVariant?: LanguageVariant, text?: string, onError?: ErrorCallback, start?: number, length?: number): Scanner;
|
|
}
|
|
declare namespace ts {
|
|
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;
|
|
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;
|
|
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: TextChangeRange[]): TextChangeRange;
|
|
function getTypeParameterOwner(d: Declaration): Declaration;
|
|
function isParameterPropertyDeclaration(node: ParameterDeclaration): boolean;
|
|
function startsWith(str: string, prefix: string): boolean;
|
|
function endsWith(str: string, suffix: string): boolean;
|
|
}
|
|
declare namespace ts {
|
|
function createNode(kind: SyntaxKind, pos?: number, end?: number): Node;
|
|
function forEachChild<T>(node: Node, cbNode: (node: Node) => T, cbNodeArray?: (nodes: Node[]) => T): T;
|
|
function createSourceFile(fileName: string, sourceText: string, languageVersion: ScriptTarget, setParentNodes?: boolean, scriptKind?: ScriptKind): SourceFile;
|
|
function isExternalModule(file: SourceFile): boolean;
|
|
function updateSourceFile(sourceFile: SourceFile, newText: string, textChangeRange: TextChangeRange, aggressiveChecks?: boolean): SourceFile;
|
|
}
|
|
declare namespace ts {
|
|
const version: string;
|
|
function findConfigFile(searchPath: string, fileExists: (fileName: string) => boolean): string;
|
|
function resolveTripleslashReference(moduleName: string, containingFile: string): string;
|
|
/**
|
|
* @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, options: CompilerOptions, host: ModuleResolutionHost): ResolvedTypeReferenceDirectiveWithFailedLookupLocations;
|
|
function resolveModuleName(moduleName: string, containingFile: string, compilerOptions: CompilerOptions, host: ModuleResolutionHost): ResolvedModuleWithFailedLookupLocations;
|
|
function nodeModuleNameResolver(moduleName: string, containingFile: string, compilerOptions: CompilerOptions, host: ModuleResolutionHost): ResolvedModuleWithFailedLookupLocations;
|
|
function classicNameResolver(moduleName: string, containingFile: string, compilerOptions: CompilerOptions, host: ModuleResolutionHost): ResolvedModuleWithFailedLookupLocations;
|
|
function createCompilerHost(options: CompilerOptions, setParentNodes?: boolean): CompilerHost;
|
|
function getPreEmitDiagnostics(program: Program, sourceFile?: SourceFile, cancellationToken?: CancellationToken): Diagnostic[];
|
|
function flattenDiagnosticMessageText(messageText: string | DiagnosticMessageChain, newLine: string): string;
|
|
function getDefaultTypeDirectiveNames(options: CompilerOptions, rootFiles: string[], host: CompilerHost): string[];
|
|
function createProgram(rootNames: string[], options: CompilerOptions, host?: CompilerHost, oldProgram?: Program): Program;
|
|
}
|
|
declare namespace ts {
|
|
/**
|
|
* Read tsconfig.json file
|
|
* @param fileName The path to the config file
|
|
*/
|
|
function readConfigFile(fileName: string, readFile: (path: string) => string): {
|
|
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
|
|
*/
|
|
function parseConfigFileTextToJson(fileName: string, jsonText: string): {
|
|
config?: any;
|
|
error?: Diagnostic;
|
|
};
|
|
/**
|
|
* 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
|
|
*/
|
|
function parseJsonConfigFileContent(json: any, host: ParseConfigHost, basePath: string, existingOptions?: CompilerOptions, configFileName?: string): ParsedCommandLine;
|
|
function convertCompilerOptionsFromJson(jsonOptions: any, basePath: string, configFileName?: string): {
|
|
options: CompilerOptions;
|
|
errors: Diagnostic[];
|
|
};
|
|
function convertTypingOptionsFromJson(jsonOptions: any, basePath: string, configFileName?: string): {
|
|
options: CompilerOptions;
|
|
errors: Diagnostic[];
|
|
};
|
|
}
|
|
declare namespace ts {
|
|
/** The version of the language service API */
|
|
const servicesVersion: string;
|
|
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?: SourceFile): number;
|
|
getFullWidth(): number;
|
|
getLeadingTriviaWidth(sourceFile?: SourceFile): number;
|
|
getFullText(sourceFile?: SourceFile): string;
|
|
getText(sourceFile?: SourceFile): string;
|
|
getFirstToken(sourceFile?: SourceFile): Node;
|
|
getLastToken(sourceFile?: SourceFile): Node;
|
|
}
|
|
interface Symbol {
|
|
getFlags(): SymbolFlags;
|
|
getName(): string;
|
|
getDeclarations(): Declaration[];
|
|
getDocumentationComment(): SymbolDisplayPart[];
|
|
}
|
|
interface Type {
|
|
getFlags(): TypeFlags;
|
|
getSymbol(): Symbol;
|
|
getProperties(): Symbol[];
|
|
getProperty(propertyName: string): Symbol;
|
|
getApparentProperties(): Symbol[];
|
|
getCallSignatures(): Signature[];
|
|
getConstructSignatures(): Signature[];
|
|
getStringIndexType(): Type;
|
|
getNumberIndexType(): Type;
|
|
getBaseTypes(): ObjectType[];
|
|
getNonNullableType(): Type;
|
|
}
|
|
interface Signature {
|
|
getDeclaration(): SignatureDeclaration;
|
|
getTypeParameters(): Type[];
|
|
getParameters(): Symbol[];
|
|
getReturnType(): Type;
|
|
getDocumentationComment(): SymbolDisplayPart[];
|
|
}
|
|
interface SourceFile {
|
|
getLineAndCharacterOfPosition(pos: number): LineAndCharacter;
|
|
getLineStarts(): number[];
|
|
getPositionOfLineAndCharacter(line: number, character: number): number;
|
|
update(newText: string, textChangeRange: TextChangeRange): SourceFile;
|
|
}
|
|
/**
|
|
* 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;
|
|
/** Releases all resources held by this script snapshot */
|
|
dispose?(): void;
|
|
}
|
|
namespace ScriptSnapshot {
|
|
function fromString(text: string): IScriptSnapshot;
|
|
}
|
|
interface PreProcessedFileInfo {
|
|
referencedFiles: FileReference[];
|
|
typeReferenceDirectives: FileReference[];
|
|
importedFiles: FileReference[];
|
|
ambientExternalModules: string[];
|
|
isLibFile: boolean;
|
|
}
|
|
interface HostCancellationToken {
|
|
isCancellationRequested(): boolean;
|
|
}
|
|
interface LanguageServiceHost {
|
|
getCompilationSettings(): CompilerOptions;
|
|
getNewLine?(): string;
|
|
getProjectVersion?(): string;
|
|
getScriptFileNames(): string[];
|
|
getScriptKind?(fileName: string): ScriptKind;
|
|
getScriptVersion(fileName: string): string;
|
|
getScriptSnapshot(fileName: string): IScriptSnapshot | 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;
|
|
resolveModuleNames?(moduleNames: string[], containingFile: string): ResolvedModule[];
|
|
resolveTypeReferenceDirectives?(typeDirectiveNames: string[], containingFile: string): ResolvedTypeReferenceDirective[];
|
|
directoryExists?(directoryName: string): boolean;
|
|
}
|
|
interface LanguageService {
|
|
cleanupSemanticCache(): void;
|
|
getSyntacticDiagnostics(fileName: string): Diagnostic[];
|
|
getSemanticDiagnostics(fileName: string): Diagnostic[];
|
|
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;
|
|
getCompletionsAtPosition(fileName: string, position: number): CompletionInfo;
|
|
getCompletionEntryDetails(fileName: string, position: number, entryName: string): CompletionEntryDetails;
|
|
getQuickInfoAtPosition(fileName: string, position: number): QuickInfo;
|
|
getNameOrDottedNameSpan(fileName: string, startPos: number, endPos: number): TextSpan;
|
|
getBreakpointStatementAtPosition(fileName: string, position: number): TextSpan;
|
|
getSignatureHelpItems(fileName: string, position: number): SignatureHelpItems;
|
|
getRenameInfo(fileName: string, position: number): RenameInfo;
|
|
findRenameLocations(fileName: string, position: number, findInStrings: boolean, findInComments: boolean): RenameLocation[];
|
|
getDefinitionAtPosition(fileName: string, position: number): DefinitionInfo[];
|
|
getTypeDefinitionAtPosition(fileName: string, position: number): DefinitionInfo[];
|
|
getReferencesAtPosition(fileName: string, position: number): ReferenceEntry[];
|
|
findReferences(fileName: string, position: number): ReferencedSymbol[];
|
|
getDocumentHighlights(fileName: string, position: number, filesToSearch: string[]): DocumentHighlights[];
|
|
/** @deprecated */
|
|
getOccurrencesAtPosition(fileName: string, position: number): ReferenceEntry[];
|
|
getNavigateToItems(searchValue: string, maxResultCount?: number): NavigateToItem[];
|
|
getNavigationBarItems(fileName: string): NavigationBarItem[];
|
|
getOutliningSpans(fileName: string): OutliningSpan[];
|
|
getTodoComments(fileName: string, descriptors: TodoCommentDescriptor[]): TodoComment[];
|
|
getBraceMatchingAtPosition(fileName: string, position: number): TextSpan[];
|
|
getIndentationAtPosition(fileName: string, position: number, options: EditorOptions): number;
|
|
getFormattingEditsForRange(fileName: string, start: number, end: number, options: FormatCodeOptions): TextChange[];
|
|
getFormattingEditsForDocument(fileName: string, options: FormatCodeOptions): TextChange[];
|
|
getFormattingEditsAfterKeystroke(fileName: string, position: number, key: string, options: FormatCodeOptions): TextChange[];
|
|
getDocCommentTemplateAtPosition(fileName: string, position: number): TextInsertion;
|
|
isValidBraceCompletionAtPostion(fileName: string, position: number, openingBrace: number): boolean;
|
|
getEmitOutput(fileName: string): EmitOutput;
|
|
getProgram(): Program;
|
|
dispose(): void;
|
|
}
|
|
interface Classifications {
|
|
spans: number[];
|
|
endOfLineState: EndOfLineState;
|
|
}
|
|
interface ClassifiedSpan {
|
|
textSpan: TextSpan;
|
|
classificationType: string;
|
|
}
|
|
interface NavigationBarItem {
|
|
text: string;
|
|
kind: string;
|
|
kindModifiers: string;
|
|
spans: TextSpan[];
|
|
childItems: NavigationBarItem[];
|
|
indent: number;
|
|
bolded: boolean;
|
|
grayed: boolean;
|
|
}
|
|
interface TodoCommentDescriptor {
|
|
text: string;
|
|
priority: number;
|
|
}
|
|
interface TodoComment {
|
|
descriptor: TodoCommentDescriptor;
|
|
message: string;
|
|
position: number;
|
|
}
|
|
class TextChange {
|
|
span: TextSpan;
|
|
newText: string;
|
|
}
|
|
interface TextInsertion {
|
|
newText: string;
|
|
/** The position in newText the caret should point to after the insertion. */
|
|
caretOffset: number;
|
|
}
|
|
interface RenameLocation {
|
|
textSpan: TextSpan;
|
|
fileName: string;
|
|
}
|
|
interface ReferenceEntry {
|
|
textSpan: TextSpan;
|
|
fileName: string;
|
|
isWriteAccess: boolean;
|
|
}
|
|
interface DocumentHighlights {
|
|
fileName: string;
|
|
highlightSpans: HighlightSpan[];
|
|
}
|
|
namespace HighlightSpanKind {
|
|
const none: string;
|
|
const definition: string;
|
|
const reference: string;
|
|
const writtenReference: string;
|
|
}
|
|
interface HighlightSpan {
|
|
fileName?: string;
|
|
textSpan: TextSpan;
|
|
kind: string;
|
|
}
|
|
interface NavigateToItem {
|
|
name: string;
|
|
kind: string;
|
|
kindModifiers: string;
|
|
matchKind: string;
|
|
isCaseSensitive: boolean;
|
|
fileName: string;
|
|
textSpan: TextSpan;
|
|
containerName: string;
|
|
containerKind: string;
|
|
}
|
|
interface EditorOptions {
|
|
IndentSize: number;
|
|
TabSize: number;
|
|
NewLineCharacter: string;
|
|
ConvertTabsToSpaces: boolean;
|
|
IndentStyle: IndentStyle;
|
|
}
|
|
enum IndentStyle {
|
|
None = 0,
|
|
Block = 1,
|
|
Smart = 2,
|
|
}
|
|
interface FormatCodeOptions extends EditorOptions {
|
|
InsertSpaceAfterCommaDelimiter: boolean;
|
|
InsertSpaceAfterSemicolonInForStatements: boolean;
|
|
InsertSpaceBeforeAndAfterBinaryOperators: boolean;
|
|
InsertSpaceAfterKeywordsInControlFlowStatements: boolean;
|
|
InsertSpaceAfterFunctionKeywordForAnonymousFunctions: boolean;
|
|
InsertSpaceAfterOpeningAndBeforeClosingNonemptyParenthesis: boolean;
|
|
InsertSpaceAfterOpeningAndBeforeClosingNonemptyBrackets: boolean;
|
|
InsertSpaceAfterOpeningAndBeforeClosingTemplateStringBraces: boolean;
|
|
PlaceOpenBraceOnNewLineForFunctions: boolean;
|
|
PlaceOpenBraceOnNewLineForControlBlocks: boolean;
|
|
[s: string]: boolean | number | string;
|
|
}
|
|
interface DefinitionInfo {
|
|
fileName: string;
|
|
textSpan: TextSpan;
|
|
kind: string;
|
|
name: string;
|
|
containerKind: string;
|
|
containerName: string;
|
|
}
|
|
interface ReferencedSymbol {
|
|
definition: DefinitionInfo;
|
|
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 QuickInfo {
|
|
kind: string;
|
|
kindModifiers: string;
|
|
textSpan: TextSpan;
|
|
displayParts: SymbolDisplayPart[];
|
|
documentation: SymbolDisplayPart[];
|
|
}
|
|
interface RenameInfo {
|
|
canRename: boolean;
|
|
localizedErrorMessage: string;
|
|
displayName: string;
|
|
fullDisplayName: string;
|
|
kind: string;
|
|
kindModifiers: string;
|
|
triggerSpan: TextSpan;
|
|
}
|
|
interface SignatureHelpParameter {
|
|
name: string;
|
|
documentation: SymbolDisplayPart[];
|
|
displayParts: SymbolDisplayPart[];
|
|
isOptional: boolean;
|
|
}
|
|
/**
|
|
* 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[];
|
|
}
|
|
/**
|
|
* 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 {
|
|
isMemberCompletion: boolean;
|
|
isNewIdentifierLocation: boolean;
|
|
entries: CompletionEntry[];
|
|
}
|
|
interface CompletionEntry {
|
|
name: string;
|
|
kind: string;
|
|
kindModifiers: string;
|
|
sortText: string;
|
|
}
|
|
interface CompletionEntryDetails {
|
|
name: string;
|
|
kind: string;
|
|
kindModifiers: string;
|
|
displayParts: SymbolDisplayPart[];
|
|
documentation: 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;
|
|
}
|
|
interface EmitOutput {
|
|
outputFiles: OutputFile[];
|
|
emitSkipped: boolean;
|
|
}
|
|
enum OutputFileType {
|
|
JavaScript = 0,
|
|
SourceMap = 1,
|
|
Declaration = 2,
|
|
}
|
|
interface OutputFile {
|
|
name: string;
|
|
writeByteOrderMark: boolean;
|
|
text: string;
|
|
}
|
|
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,
|
|
StringLiteral = 7,
|
|
RegExpLiteral = 8,
|
|
}
|
|
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;
|
|
}
|
|
/**
|
|
* 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.
|
|
* @parm scriptSnapshot Text of the file. Only used if the file was not found
|
|
* in the registry and a new one was created.
|
|
* @parm 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;
|
|
};
|
|
namespace ScriptElementKind {
|
|
const unknown: string;
|
|
const warning: string;
|
|
/** predefined type (void) or keyword (class) */
|
|
const keyword: string;
|
|
/** top level script node */
|
|
const scriptElement: string;
|
|
/** module foo {} */
|
|
const moduleElement: string;
|
|
/** class X {} */
|
|
const classElement: string;
|
|
/** var x = class X {} */
|
|
const localClassElement: string;
|
|
/** interface Y {} */
|
|
const interfaceElement: string;
|
|
/** type T = ... */
|
|
const typeElement: string;
|
|
/** enum E */
|
|
const enumElement: string;
|
|
/**
|
|
* Inside module and script only
|
|
* const v = ..
|
|
*/
|
|
const variableElement: string;
|
|
/** Inside function */
|
|
const localVariableElement: string;
|
|
/**
|
|
* Inside module and script only
|
|
* function f() { }
|
|
*/
|
|
const functionElement: string;
|
|
/** Inside function */
|
|
const localFunctionElement: string;
|
|
/** class X { [public|private]* foo() {} } */
|
|
const memberFunctionElement: string;
|
|
/** class X { [public|private]* [get|set] foo:number; } */
|
|
const memberGetAccessorElement: string;
|
|
const memberSetAccessorElement: string;
|
|
/**
|
|
* class X { [public|private]* foo:number; }
|
|
* interface Y { foo:number; }
|
|
*/
|
|
const memberVariableElement: string;
|
|
/** class X { constructor() { } } */
|
|
const constructorImplementationElement: string;
|
|
/** interface Y { ():number; } */
|
|
const callSignatureElement: string;
|
|
/** interface Y { []:number; } */
|
|
const indexSignatureElement: string;
|
|
/** interface Y { new():Y; } */
|
|
const constructSignatureElement: string;
|
|
/** function foo(*Y*: string) */
|
|
const parameterElement: string;
|
|
const typeParameterElement: string;
|
|
const primitiveType: string;
|
|
const label: string;
|
|
const alias: string;
|
|
const constElement: string;
|
|
const letElement: string;
|
|
}
|
|
namespace ScriptElementKindModifier {
|
|
const none: string;
|
|
const publicMemberModifier: string;
|
|
const privateMemberModifier: string;
|
|
const protectedMemberModifier: string;
|
|
const exportedModifier: string;
|
|
const ambientModifier: string;
|
|
const staticModifier: string;
|
|
const abstractModifier: string;
|
|
}
|
|
class ClassificationTypeNames {
|
|
static comment: string;
|
|
static identifier: string;
|
|
static keyword: string;
|
|
static numericLiteral: string;
|
|
static operator: string;
|
|
static stringLiteral: string;
|
|
static whiteSpace: string;
|
|
static text: string;
|
|
static punctuation: string;
|
|
static className: string;
|
|
static enumName: string;
|
|
static interfaceName: string;
|
|
static moduleName: string;
|
|
static typeParameterName: string;
|
|
static typeAliasName: string;
|
|
static parameterName: string;
|
|
static docCommentTagName: string;
|
|
static jsxOpenTagName: string;
|
|
static jsxCloseTagName: string;
|
|
static jsxSelfClosingTagName: string;
|
|
static jsxAttribute: string;
|
|
static jsxText: string;
|
|
static jsxAttributeStringLiteralValue: string;
|
|
}
|
|
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,
|
|
}
|
|
interface DisplayPartsSymbolWriter extends SymbolWriter {
|
|
displayParts(): SymbolDisplayPart[];
|
|
}
|
|
function displayPartsToString(displayParts: SymbolDisplayPart[]): string;
|
|
function getDefaultCompilerOptions(): CompilerOptions;
|
|
interface TranspileOptions {
|
|
compilerOptions?: CompilerOptions;
|
|
fileName?: string;
|
|
reportDiagnostics?: boolean;
|
|
moduleName?: string;
|
|
renamedDependencies?: Map<string>;
|
|
}
|
|
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;
|
|
function createLanguageServiceSourceFile(fileName: string, scriptSnapshot: IScriptSnapshot, scriptTarget: ScriptTarget, version: string, setNodeParents: boolean, scriptKind?: ScriptKind): SourceFile;
|
|
let disableIncrementalParsing: boolean;
|
|
function updateLanguageServiceSourceFile(sourceFile: SourceFile, scriptSnapshot: IScriptSnapshot, version: string, textChangeRange: TextChangeRange, aggressiveChecks?: boolean): SourceFile;
|
|
function createDocumentRegistry(useCaseSensitiveFileNames?: boolean, currentDirectory?: string): DocumentRegistry;
|
|
function preProcessFile(sourceText: string, readImportFiles?: boolean, detectJavaScriptImports?: boolean): PreProcessedFileInfo;
|
|
function createLanguageService(host: LanguageServiceHost, documentRegistry?: DocumentRegistry): LanguageService;
|
|
function createClassifier(): Classifier;
|
|
/**
|
|
* 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;
|
|
}
|
|
|
|
export = ts; |