import { PATH_DELIMITER, STATIC_DELIMITER, INSTANCE_DELIMITER } from "./program"; import { Token, Tokenizer, Range } from "./tokenizer"; import { I64 } from "./util/i64"; import { normalize as normalizePath, resolve as resolvePath } from "./util/path"; export { Token, Range }; /** Indicates the kind of a node. */ export enum NodeKind { SOURCE, // types TYPE, TYPEPARAMETER, // expressions IDENTIFIER, ASSERTION, BINARY, CALL, COMMA, ELEMENTACCESS, FALSE, LITERAL, NEW, NULL, PARENTHESIZED, PROPERTYACCESS, TERNARY, SUPER, THIS, TRUE, CONSTRUCTOR, UNARYPOSTFIX, UNARYPREFIX, // statements BLOCK, BREAK, CONTINUE, DO, EMPTY, EXPORT, EXPORTIMPORT, EXPRESSION, FOR, IF, IMPORT, RETURN, SWITCH, THROW, TRY, VARIABLE, WHILE, // declaration statements CLASSDECLARATION, ENUMDECLARATION, ENUMVALUEDECLARATION, FIELDDECLARATION, FUNCTIONDECLARATION, IMPORTDECLARATION, INTERFACEDECLARATION, METHODDECLARATION, NAMESPACEDECLARATION, TYPEDECLARATION, VARIABLEDECLARATION, // other DECORATOR, EXPORTMEMBER, MODIFIER, PARAMETER, SWITCHCASE } /** Base class of all nodes. */ export abstract class Node { /** Node kind indicator. */ kind: NodeKind; /** Source range. */ range: Range; /** Parent node. */ parent: Node | null = null; // types static createType(identifier: IdentifierExpression, typeArguments: TypeNode[], isNullable: bool, range: Range): TypeNode { var type = new TypeNode(); type.range = range; type.identifier = identifier; type.typeArguments = typeArguments; type.isNullable = isNullable; return type; } // expressions static createIdentifierExpression(name: string, range: Range): IdentifierExpression { var expr = new IdentifierExpression(); expr.range = range; expr.name = name; return expr; } static createArrayLiteralExpression(elementExpressions: (Expression | null)[], range: Range): ArrayLiteralExpression { var expr = new ArrayLiteralExpression(); expr.range = range; for (var i = 0, k = (expr.elementExpressions = elementExpressions).length; i < k; ++i) if (elementExpressions[i]) (elementExpressions[i]).parent = expr; return expr; } static createAssertionExpression(assertionKind: AssertionKind, expression: Expression, toType: TypeNode, range: Range): AssertionExpression { var expr = new AssertionExpression(); expr.range = range; expr.assertionKind = assertionKind; (expr.expression = expression).parent = expr; (expr.toType = toType).parent = expr; return expr; } static createBinaryExpression(operator: Token, left: Expression, right: Expression, range: Range): BinaryExpression { var expr = new BinaryExpression(); expr.range = range; expr.operator = operator; (expr.left = left).parent = expr; (expr.right = right).parent = expr; return expr; } static createCallExpression(expression: Expression, typeArguments: TypeNode[] | null, args: Expression[], range: Range): CallExpression { var expr = new CallExpression(); expr.range = range; (expr.expression = expression).parent = expr; if (expr.typeArguments = typeArguments) for (var i = 0, k = (typeArguments).length; i < k; ++i) (typeArguments)[i].parent = expr; for (i = 0, k = (expr.arguments = args).length; i < k; ++i) args[i].parent = expr; return expr; } static createCommaExpression(expressions: Expression[], range: Range): CommaExpression { var expr = new CommaExpression(); expr.range = range; for (var i = 0, k = (expr.expressions = expressions).length; i < k; ++i) expressions[i].parent = expr; return expr; } static createConstructorExpression(range: Range): ConstructorExpression { var expr = new ConstructorExpression(); expr.range = range; return expr; } static createElementAccessExpression(expression: Expression, element: Expression, range: Range): ElementAccessExpression { var expr = new ElementAccessExpression(); expr.range = range; (expr.expression = expression).parent = expr; (expr.elementExpression = element).parent = expr; return expr; } static createFalseExpression(range: Range): FalseExpression { var expr = new FalseExpression(); expr.range = range; return expr; } static createFloatLiteralExpression(value: f64, range: Range): FloatLiteralExpression { var expr = new FloatLiteralExpression(); expr.range = range; expr.value = value; return expr; } static createIntegerLiteralExpression(value: I64, range: Range): IntegerLiteralExpression { var expr = new IntegerLiteralExpression(); expr.range = range; expr.value = value; return expr; } static createNewExpression(expression: Expression, typeArguments: TypeNode[] | null, args: Expression[], range: Range): NewExpression { var expr = new NewExpression(); expr.range = range; (expr.expression = expression).parent = expr; if (expr.typeArguments = typeArguments) for (var i = 0, k = (typeArguments).length; i < k; ++i) (typeArguments)[i].parent = expr; for (i = 0, k = (expr.arguments = args).length; i < k; ++i) args[i].parent = expr; return expr; } static createNullExpression(range: Range): NullExpression { var expr = new NullExpression(); expr.range = range; return expr; } static createParenthesizedExpression(expression: Expression, range: Range): ParenthesizedExpression { var expr = new ParenthesizedExpression(); expr.range = range; (expr.expression = expression).parent = expr; return expr; } static createPropertyAccessExpression(expression: Expression, property: IdentifierExpression, range: Range): PropertyAccessExpression { var expr = new PropertyAccessExpression(); expr.range = range; (expr.expression = expression).parent = expr; (expr.property = property).parent = expr; return expr; } static createRegexpLiteralExpression(pattern: string, flags: string, range: Range): RegexpLiteralExpression { var expr = new RegexpLiteralExpression(); expr.range = range; expr.pattern = pattern; expr.patternFlags = flags; return expr; } static createTernaryExpression(condition: Expression, ifThen: Expression, ifElse: Expression, range: Range): TernaryExpression { var expr = new TernaryExpression(); expr.range = range; (expr.condition = condition).parent = expr; (expr.ifThen = ifThen).parent = expr; (expr.ifElse = ifElse).parent = expr; return expr; } static createStringLiteralExpression(value: string, range: Range): StringLiteralExpression { var expr = new StringLiteralExpression(); expr.range = range; expr.value = value; return expr; } static createSuperExpression(range: Range): SuperExpression { var expr = new SuperExpression(); expr.range = range; return expr; } static createThisExpression(range: Range): ThisExpression { var expr = new ThisExpression(); expr.range = range; return expr; } static createTrueExpression(range: Range): TrueExpression { var expr = new TrueExpression(); expr.range = range; return expr; } static createUnaryPostfixExpression(operator: Token, expression: Expression, range: Range): UnaryPostfixExpression { var expr = new UnaryPostfixExpression(); expr.range = range; expr.operator = operator; (expr.operand = expression).parent = expr; return expr; } static createUnaryPrefixExpression(operator: Token, expression: Expression, range: Range): UnaryPrefixExpression { var expr = new UnaryPrefixExpression(); expr.range = range; expr.operator = operator; (expr.operand = expression).parent = expr; return expr; } // statements static createBlockStatement(statements: Statement[], range: Range): BlockStatement { var stmt = new BlockStatement(); stmt.range = range; for (var i: i32 = 0, k: i32 = (stmt.statements = statements).length; i < k; ++i) statements[i].parent = stmt; return stmt; } static createBreakStatement(label: IdentifierExpression | null, range: Range): BreakStatement { var stmt = new BreakStatement(); stmt.range = range; if (stmt.label = label) (label).parent = stmt; return stmt; } static createClassDeclaration(identifier: IdentifierExpression, typeParameters: TypeParameter[], extendsType: TypeNode | null, implementsTypes: TypeNode[], members: DeclarationStatement[], modifiers: Modifier[] | null, decorators: Decorator[] | null, range: Range): ClassDeclaration { var stmt = new ClassDeclaration(); stmt.range = range; (stmt.name = identifier).parent = stmt; for (var i = 0, k = (stmt.typeParameters = typeParameters).length; i < k; ++i) typeParameters[i].parent = stmt; if (stmt.extendsType = extendsType) (extendsType).parent = stmt; for (i = 0, k = (stmt.implementsTypes = implementsTypes).length; i < k; ++i) implementsTypes[i].parent = stmt; for (i = 0, k = (stmt.members = members).length; i < k; ++i) members[i].parent = stmt; if (stmt.modifiers = modifiers) for (i = 0, k = (modifiers).length; i < k; ++i) (modifiers)[i].parent = stmt; if (stmt.decorators = decorators) for (i = 0, k = (decorators).length; i < k; ++i) (decorators)[i].parent = stmt; return stmt; } static createContinueStatement(label: IdentifierExpression | null, range: Range): ContinueStatement { var stmt = new ContinueStatement(); stmt.range = range; if (stmt.label = label) (label).parent = stmt; return stmt; } static createDecorator(expression: Expression, args: Expression[] | null, range: Range): Decorator { var stmt = new Decorator(); stmt.range = range; (stmt.name = expression).parent = stmt; if (stmt.arguments = args) for (var i: i32 = 0, k: i32 = (args).length; i < k; ++i) (args)[i].parent = stmt; if (expression.kind == NodeKind.IDENTIFIER) { switch ((expression).name) { case "global": stmt.decoratorKind = DecoratorKind.GLOBAL; break; case "operator": stmt.decoratorKind = DecoratorKind.OPERATOR; break; case "explicit": stmt.decoratorKind = DecoratorKind.EXPLICIT; break; case "offset": stmt.decoratorKind = DecoratorKind.OFFSET; break; default: stmt.decoratorKind = DecoratorKind.CUSTOM; break; } } else stmt.decoratorKind = DecoratorKind.CUSTOM; return stmt; } static createDoStatement(statement: Statement, condition: Expression, range: Range): DoStatement { var stmt = new DoStatement(); stmt.range = range; (stmt.statement = statement).parent = stmt; (stmt.condition = condition).parent = stmt; return stmt; } static createEmptyStatement(range: Range): EmptyStatement { var stmt = new EmptyStatement(); stmt.range = range; return stmt; } static createEnumDeclaration(identifier: IdentifierExpression, members: EnumValueDeclaration[], modifiers: Modifier[] | null, decorators: Decorator[] | null, range: Range): EnumDeclaration { var stmt = new EnumDeclaration(); stmt.range = range; (stmt.name = identifier).parent = stmt; for (var i = 0, k = (stmt.values = members).length; i < k; ++i) members[i].parent = stmt; if (stmt.modifiers = modifiers) for (i = 0, k = (modifiers).length; i < k; ++i) (modifiers)[i].parent = stmt; if (stmt.decorators = decorators) for (i = 0, k = (decorators).length; i < k; ++i) (decorators)[i].parent = stmt; return stmt; } static createEnumValueDeclaration(identifier: IdentifierExpression, value: Expression | null, range: Range): EnumValueDeclaration { var stmt = new EnumValueDeclaration(); stmt.range = range; (stmt.name = identifier).parent = stmt; if (stmt.value = value) (value).parent = stmt; return stmt; } static createExportStatement(members: ExportMember[], path: StringLiteralExpression | null, modifiers: Modifier[] | null, range: Range): ExportStatement { var stmt = new ExportStatement(); stmt.range = range; for (var i = 0, k = (stmt.members = members).length; i < k; ++i) members[i].parent = stmt; stmt.path = path; stmt.normalizedPath = path ? resolvePath(normalizePath(path.value), range.source.normalizedPath) : null; stmt.internalPath = stmt.normalizedPath ? mangleInternalPath(stmt.normalizedPath) : null; if (stmt.modifiers = modifiers) for (i = 0, k = (modifiers).length; i < k; ++i) (modifiers)[i].parent = stmt; return stmt; } static createExportImportStatement(identifier: IdentifierExpression, asIdentifier: IdentifierExpression, range: Range): ExportImportStatement { var stmt = new ExportImportStatement(); stmt.range = range; (stmt.identifier = identifier).parent = stmt; (stmt.externalIdentifier = asIdentifier).parent = stmt; return stmt; } static createExportMember(identifier: IdentifierExpression, externalIdentifier: IdentifierExpression | null, range: Range): ExportMember { var elem = new ExportMember(); elem.range = range; (elem.identifier = identifier).parent = elem; (elem.externalIdentifier = externalIdentifier ? externalIdentifier : identifier).parent = elem; return elem; } static createExpressionStatement(expression: Expression): ExpressionStatement { var stmt = new ExpressionStatement(); stmt.range = expression.range; (stmt.expression = expression).parent = stmt; return stmt; } static createIfStatement(condition: Expression, ifTrue: Statement, ifFalse: Statement | null, range: Range): IfStatement { var stmt = new IfStatement(); stmt.range = range; (stmt.condition = condition).parent = stmt; (stmt.ifTrue = ifTrue).parent = stmt; if (stmt.ifFalse = ifFalse) (ifFalse).parent = stmt; return stmt; } static createImportStatement(declarations: ImportDeclaration[] | null, path: StringLiteralExpression, range: Range): ImportStatement { var stmt = new ImportStatement(); stmt.range = range; if (stmt.declarations = declarations) for (var i: i32 = 0, k: i32 = (declarations).length; i < k; ++i) (declarations)[i].parent = stmt; stmt.namespaceName = null; stmt.path = path; stmt.normalizedPath = resolvePath(normalizePath(path.value), range.source.normalizedPath); stmt.internalPath = mangleInternalPath(stmt.normalizedPath); return stmt; } static createImportStatementWithWildcard(identifier: IdentifierExpression, path: StringLiteralExpression, range: Range): ImportStatement { var stmt = new ImportStatement(); stmt.range = range; stmt.declarations = null; stmt.namespaceName = identifier; stmt.path = path; stmt.normalizedPath = resolvePath(normalizePath(path.value), range.source.normalizedPath); stmt.internalPath = mangleInternalPath(stmt.normalizedPath); return stmt; } static createImportDeclaration(externalIdentifier: IdentifierExpression, identifier: IdentifierExpression | null, range: Range): ImportDeclaration { var elem = new ImportDeclaration(); elem.range = range; (elem.name = identifier ? identifier : externalIdentifier).parent = elem; (elem.externalIdentifier = externalIdentifier).parent = elem; return elem; } static createInterfaceDeclaration(identifier: IdentifierExpression, extendsType: TypeNode | null, members: DeclarationStatement[], modifiers: Modifier[] | null, range: Range): InterfaceDeclaration { var stmt = new InterfaceDeclaration(); stmt.range = range; (stmt.name = identifier).parent = stmt; if (stmt.extendsType = extendsType) (extendsType).parent = stmt; for (var i = 0, k = (stmt.members = members).length; i < k; ++i) members[i].parent = stmt; if (stmt.modifiers = modifiers) for (i = 0, k = (modifiers).length; i < k; ++i) (modifiers)[i].parent = stmt; return stmt; } static createFieldDeclaration(identifier: IdentifierExpression, type: TypeNode | null, initializer: Expression | null, modifiers: Modifier[] | null, decorators: Decorator[] | null, range: Range): FieldDeclaration { var stmt = new FieldDeclaration(); stmt.range = range; (stmt.name = identifier).parent = stmt; if (stmt.type = type) (type).parent = stmt; if (stmt.initializer = initializer) (initializer).parent = stmt; if (stmt.modifiers = modifiers) for (var i = 0, k = (modifiers).length; i < k; ++i) (modifiers)[i].parent = stmt; if (stmt.decorators = decorators) for (i = 0, k = (decorators).length; i < k; ++i) (decorators)[i].parent = stmt; return stmt; } static createForStatement(initializer: Statement | null, condition: Expression | null, incrementor: Expression | null, statement: Statement, range: Range): ForStatement { var stmt = new ForStatement(); stmt.range = range; if (stmt.initializer = initializer) (initializer).parent = stmt; if (stmt.condition = condition) (condition).parent = stmt; if (stmt.incrementor = incrementor) (incrementor).parent = stmt; (stmt.statement = statement).parent = stmt; return stmt; } static createTypeParameter(identifier: IdentifierExpression, extendsType: TypeNode | null, range: Range): TypeParameter { var elem = new TypeParameter(); elem.range = range; (elem.identifier = identifier).parent = elem; if (elem.extendsType = extendsType) (extendsType).parent = elem; return elem; } static createParameter(identifier: IdentifierExpression, type: TypeNode | null, initializer: Expression | null, isRest: bool, range: Range): Parameter { var elem = new Parameter(); elem.range = range; (elem.name = identifier).parent = elem; if (elem.type = type) (type).parent = elem; if (elem.initializer = initializer) (initializer).parent = elem; elem.isRest = isRest; return elem; } static createFunctionDeclaration(identifier: IdentifierExpression, typeParameters: TypeParameter[], parameters: Parameter[], returnType: TypeNode | null, statements: Statement[] | null, modifiers: Modifier[] | null, decorators: Decorator[] | null, range: Range): FunctionDeclaration { var stmt = new FunctionDeclaration(); stmt.range = range; (stmt.name = identifier).parent = stmt; for (var i = 0, k = (stmt.typeParameters = typeParameters).length; i < k; ++i) typeParameters[i].parent = stmt; for (i = 0, k = (stmt.parameters = parameters).length; i < k; ++i) parameters[i].parent = stmt; if (stmt.returnType = returnType) (returnType).parent = stmt; if (stmt.statements = statements) for (i = 0, k = (statements).length; i < k; ++i) (statements)[i].parent = stmt; if (stmt.modifiers = modifiers) for (i = 0, k = (modifiers).length; i < k; ++i) (modifiers)[i].parent = stmt; if (stmt.decorators = decorators) for (i = 0, k = (decorators).length; i < k; ++i) (decorators)[i].parent = stmt; return stmt; } static createMethodDeclaration(identifier: IdentifierExpression, typeParameters: TypeParameter[], parameters: Parameter[], returnType: TypeNode | null, statements: Statement[] | null, modifiers: Modifier[] | null, decorators: Decorator[] | null, range: Range): MethodDeclaration { var stmt = new MethodDeclaration(); stmt.range = range; (stmt.name = identifier).parent = stmt; for (var i = 0, k = (stmt.typeParameters = typeParameters).length; i < k; ++i) typeParameters[i].parent = stmt; for (i = 0, k = (stmt.parameters = parameters).length; i < k; ++i) parameters[i].parent = stmt; if (stmt.returnType = returnType) (returnType).parent = stmt; if (stmt.statements = statements) for (i = 0, k = (statements).length; i < k; ++i) (statements)[i].parent = stmt; if (stmt.modifiers = modifiers) for (i = 0, k = (modifiers).length; i < k; ++i) (modifiers)[i].parent = stmt; if (stmt.decorators = decorators) for (i = 0, k = (decorators).length; i < k; ++i) (decorators)[i].parent = stmt; return stmt; } static createModifier(kind: ModifierKind, range: Range): Modifier { var elem = new Modifier(); elem.range = range; elem.modifierKind = kind; return elem; } static createNamespaceDeclaration(identifier: IdentifierExpression, members: Statement[], modifiers: Modifier[] | null, decorators: Decorator[] | null, range: Range): NamespaceDeclaration { var stmt = new NamespaceDeclaration(); stmt.range = range; (stmt.name = identifier).parent = stmt; for (var i = 0, k = (stmt.members = members).length; i < k; ++i) members[i].parent = stmt; if (stmt.modifiers = modifiers) for (i = 0, k = (modifiers).length; i < k; ++i) (modifiers)[i].parent = stmt; if (stmt.decorators = decorators) for (i = 0, k = (decorators).length; i < k; ++i) (decorators)[i].parent = stmt; return stmt; } static createReturnStatement(expression: Expression | null, range: Range): ReturnStatement { var stmt = new ReturnStatement(); stmt.range = range; if (stmt.value = expression) (expression).parent = stmt; return stmt; } static createSwitchStatement(expression: Expression, cases: SwitchCase[], range: Range): SwitchStatement { var stmt = new SwitchStatement(); stmt.range = range; (stmt.condition = expression).parent = stmt; for (var i: i32 = 0, k: i32 = (stmt.cases = cases).length; i < k; ++i) cases[i].parent = stmt; return stmt; } static createSwitchCase(label: Expression | null, statements: Statement[], range: Range): SwitchCase { var elem = new SwitchCase(); elem.range = range; if (elem.label = label) (label).parent = elem; for (var i: i32 = 0, k: i32 = (elem.statements = statements).length; i < k; ++i) statements[i].parent = elem; return elem; } static createThrowStatement(expression: Expression, range: Range): ThrowStatement { var stmt = new ThrowStatement(); stmt.range = range; (stmt.value = expression).parent = stmt; return stmt; } static createTryStatement(statements: Statement[], catchVariable: IdentifierExpression | null, catchStatements: Statement[] | null, finallyStatements: Statement[] | null, range: Range): TryStatement { var stmt = new TryStatement(); stmt.range = range; for (var i = 0, k = (stmt.statements = statements).length; i < k; ++i) statements[i].parent = stmt; if (stmt.catchVariable = catchVariable) (catchVariable).parent = stmt; if (stmt.catchStatements = catchStatements) for (i = 0, k = (catchStatements).length; i < k; ++i) (catchStatements)[i].parent = stmt; if (stmt.finallyStatements = finallyStatements) for (i = 0, k = (finallyStatements).length; i < k; ++i) (finallyStatements)[i].parent = stmt; return stmt; } static createTypeDeclaration(identifier: IdentifierExpression, alias: TypeNode, modifiers: Modifier[] | null, decorators: Decorator[] | null, range: Range): TypeDeclaration { var stmt = new TypeDeclaration(); stmt.range = range; (stmt.name = identifier).parent = stmt; (stmt.alias = alias).parent = stmt; if (stmt.modifiers = modifiers) for (var i = 0, k = (modifiers).length; i < k; ++i) (modifiers)[i].parent = stmt; if (stmt.decorators = decorators) for (i = 0, k = (decorators).length; i < k; ++i) (decorators)[i].parent = stmt; return stmt; } static createVariableStatement(declarations: VariableDeclaration[], modifiers: Modifier[] | null, decorators: Decorator[] | null, range: Range): VariableStatement { var stmt = new VariableStatement(); stmt.range = range; for (var i = 0, k = (stmt.declarations = declarations).length; i < k; ++i) declarations[i].parent = stmt; if (stmt.modifiers = modifiers) for (i = 0, k = (modifiers).length; i < k; ++i) (modifiers)[i].parent = stmt; if (stmt.decorators = decorators) for (i = 0, k = (decorators).length; i < k; ++i) (decorators)[i].parent = stmt; return stmt; } static createVariableDeclaration(name: IdentifierExpression, type: TypeNode | null, initializer: Expression | null, modifiers: Modifier[] | null, decorators: Decorator[] | null, range: Range): VariableDeclaration { var elem = new VariableDeclaration(); elem.range = range; (elem.name = name).parent = elem; if (elem.type = type) (type).parent = elem; if (elem.initializer = initializer) (initializer).parent = elem; elem.modifiers = modifiers; elem.decorators = decorators; return elem; } static createWhileStatement(condition: Expression, statement: Statement, range: Range): WhileStatement { var stmt = new WhileStatement(); stmt.range = range; (stmt.condition = condition).parent = stmt; (stmt.statement = statement).parent = stmt; return stmt; } } // types /** Represents a type annotation. */ export class TypeNode extends Node { kind = NodeKind.TYPE; /** Identifier reference. */ identifier: IdentifierExpression; /** Type argument references. */ typeArguments: TypeNode[]; /** Whether nullable or not. */ isNullable: bool; } /** Represents a type parameter. */ export class TypeParameter extends Node { kind = NodeKind.TYPEPARAMETER; /** Identifier reference. */ identifier: IdentifierExpression; /** Extended type reference, if any. */ extendsType: TypeNode | null; } // expressions /** Base class of all expression nodes. */ export abstract class Expression extends Node { } /** Represents an identifier expression. */ export class IdentifierExpression extends Expression { kind = NodeKind.IDENTIFIER; /** Textual name. */ name: string; } /** Indicates the kind of a literal. */ export const enum LiteralKind { FLOAT, INTEGER, STRING, REGEXP, ARRAY, OBJECT } /** Base class of all literal expressions. */ export abstract class LiteralExpression extends Expression { kind = NodeKind.LITERAL; /** Specific literal kind. */ literalKind: LiteralKind; } /** Represents an `[]` literal expression. */ export class ArrayLiteralExpression extends LiteralExpression { literalKind = LiteralKind.ARRAY; /** Nested element expressions. */ elementExpressions: (Expression | null)[]; } /** Indicates the kind of an assertion. */ export const enum AssertionKind { PREFIX, AS } /** Represents an assertion expression. */ export class AssertionExpression extends Expression { kind = NodeKind.ASSERTION; /** Specific kind of this assertion. */ assertionKind: AssertionKind; /** Expression being asserted. */ expression: Expression; /** Target type. */ toType: TypeNode; } /** Represents a binary expression. */ export class BinaryExpression extends Expression { kind = NodeKind.BINARY; /** Operator token. */ operator: Token; /** Left-hand side expression */ left: Expression; /** Right-hand side expression. */ right: Expression; } /** Represents a call expression. */ export class CallExpression extends Expression { kind = NodeKind.CALL; /** Called expression. Usually an identifier or property access expression. */ expression: Expression; /** Provided type arguments. */ typeArguments: TypeNode[] | null; /** Provided arguments. */ arguments: Expression[]; } /** Represents a comma expression composed of multiple sequential expressions. */ export class CommaExpression extends Expression { kind = NodeKind.COMMA; /** Sequential expressions. */ expressions: Expression[]; } /** Represents a `constructor` expression. */ export class ConstructorExpression extends IdentifierExpression { kind = NodeKind.CONSTRUCTOR; name = "constructor"; } /** Represents an element access expression, e.g., array access. */ export class ElementAccessExpression extends Expression { kind = NodeKind.ELEMENTACCESS; /** Expression being accessed. */ expression: Expression; /** Element of the expression being accessed. */ elementExpression: Expression; } /** Represents a float literal expression. */ export class FloatLiteralExpression extends LiteralExpression { literalKind = LiteralKind.FLOAT; /** Float value. */ value: f64; } /** Represents an integer literal expression. */ export class IntegerLiteralExpression extends LiteralExpression { literalKind = LiteralKind.INTEGER; /** Integer value. */ value: I64; } /** Represents a `new` expression. Like a call but with its own kind. */ export class NewExpression extends CallExpression { kind = NodeKind.NEW; } /** Represents a `null` expression. */ export class NullExpression extends IdentifierExpression { kind = NodeKind.NULL; name = "null"; } /** Represents a parenthesized expression. */ export class ParenthesizedExpression extends Expression { kind = NodeKind.PARENTHESIZED; /** Expression in parenthesis. */ expression: Expression; } /** Represents a property access expression. */ export class PropertyAccessExpression extends Expression { kind = NodeKind.PROPERTYACCESS; /** Expression being accessed. */ expression: Expression; /** Property of the expression being accessed. */ property: IdentifierExpression; } /** Represents a regular expression literal expression. */ export class RegexpLiteralExpression extends LiteralExpression { literalKind = LiteralKind.REGEXP; /** Regular expression pattern. */ pattern: string; /** Regular expression flags. */ patternFlags: string; } /** Represents a ternary expression, i.e., short if notation. */ export class TernaryExpression extends Expression { kind = NodeKind.TERNARY; /** Condition expression. */ condition: Expression; /** Expression executed when condition is `true`. */ ifThen: Expression; /** Expression executed when condition is `false`. */ ifElse: Expression; } /** Represents a string literal expression. */ export class StringLiteralExpression extends LiteralExpression { literalKind = LiteralKind.STRING; /** String value without quotes. */ value: string; } /** Represents a `super` expression. */ export class SuperExpression extends IdentifierExpression { kind = NodeKind.SUPER; name = "super"; } /** Represents a `this` expression. */ export class ThisExpression extends IdentifierExpression { kind = NodeKind.THIS; name = "this"; } /** Represents a `true` expression. */ export class TrueExpression extends IdentifierExpression { kind = NodeKind.TRUE; name = "true"; } /** Represents a `false` expression. */ export class FalseExpression extends IdentifierExpression { kind = NodeKind.FALSE; name = "false"; } /** Base class of all unary expressions. */ export abstract class UnaryExpression extends Expression { /** Operator token. */ operator: Token; /** Operand expression. */ operand: Expression; } /** Represents a unary postfix expression, e.g. a postfix increment. */ export class UnaryPostfixExpression extends UnaryExpression { kind = NodeKind.UNARYPOSTFIX; } /** Represents a unary prefix expression, e.g. a negation. */ export class UnaryPrefixExpression extends UnaryExpression { kind = NodeKind.UNARYPREFIX; } // statements /** Indicates the specific kind of a modifier. */ export enum ModifierKind { ASYNC, CONST, LET, DECLARE, EXPORT, IMPORT, STATIC, ABSTRACT, PUBLIC, PRIVATE, PROTECTED, READONLY, GET, SET, } /** Base class of all statement nodes. */ export abstract class Statement extends Node { } export enum SourceKind { DEFAULT, ENTRY, STDLIB } /** A top-level source node. */ export class Source extends Node { kind = NodeKind.SOURCE; parent = null; /** Source kind. */ sourceKind: SourceKind; /** Path as provided to the parser. */ path: string; /** Normalized path. */ normalizedPath: string; /** Path used internally. */ internalPath: string; /** Contained statements. */ statements: Statement[]; /** Full source text. */ text: string; /** Tokenizer reference. */ tokenizer: Tokenizer | null = null; /** Constructs a new source node. */ constructor(path: string, text: string, kind: SourceKind = SourceKind.DEFAULT) { super(); this.sourceKind = kind; this.path = path; this.normalizedPath = normalizePath(path, true); this.internalPath = mangleInternalPath(this.normalizedPath); this.statements = new Array(); this.range = new Range(this, 0, text.length); this.text = text; } /** Tests if this source is an entry file. */ get isEntry(): bool { return this.sourceKind == SourceKind.ENTRY; } /** Tests if this source is a stdlib file. */ get isStdlib(): bool { return this.sourceKind == SourceKind.STDLIB; } } /** Base class of all declaration statements. */ export abstract class DeclarationStatement extends Statement { /** Simple name being declared. */ name: IdentifierExpression; /** Array of modifiers. */ modifiers: Modifier[] | null; /** Array of decorators. */ decorators: Decorator[] | null = null; protected cachedProgramLevelInternalName: string | null = null; protected cachedFileLevelInternalName: string | null = null; /** Gets the mangled program-level internal name of this declaration. */ get programLevelInternalName(): string { if (!this.cachedProgramLevelInternalName) this.cachedProgramLevelInternalName = mangleInternalName(this, true); return this.cachedProgramLevelInternalName; } /** Gets the mangled file-level internal name of this declaration. */ get fileLevelInternalName(): string { if (!this.cachedFileLevelInternalName) this.cachedFileLevelInternalName = mangleInternalName(this, false); return this.cachedFileLevelInternalName; } /** Tests if this is a top-level declaration within its source file. */ get isTopLevel(): bool { var parent = this.parent; if (!parent) return false; if (parent.kind == NodeKind.VARIABLE) if (!(parent = parent.parent)) return false; return parent.kind == NodeKind.SOURCE; } /** Tests if this declaration is a top-level export within its source file. */ get isTopLevelExport(): bool { var parent = this.parent; if (!parent) return false; if (parent.kind == NodeKind.VARIABLE) if (!(parent = parent.parent)) return false; if (parent.kind == NodeKind.NAMESPACEDECLARATION) return hasModifier(ModifierKind.EXPORT, this.modifiers) && (parent).isTopLevelExport; if (parent.kind == NodeKind.CLASSDECLARATION) return hasModifier(ModifierKind.STATIC, this.modifiers) && (parent).isTopLevelExport; return parent.kind == NodeKind.SOURCE && hasModifier(ModifierKind.EXPORT, this.modifiers); } /** Tests if this declaration exported by the given member needs an explicit export. */ needsExplicitExport(member: ExportMember): bool { // This is necessary because module-level exports are automatically created for // exported top level declarations of all sorts. In other words this function // tests that this condition doesn't apply so the export isn't a duplicate. return ( member.identifier.name != member.externalIdentifier.name || // if aliased this.range.source != member.range.source || // if a re-export !this.isTopLevelExport // if not top-level ); } } /** Base class of all variable-like declaration statements with a type and initializer. */ export abstract class VariableLikeDeclarationStatement extends DeclarationStatement { /** Variable type. */ type: TypeNode | null; /** Variable initializer. */ initializer: Expression | null; } /** Represents a block statement. */ export class BlockStatement extends Statement { kind = NodeKind.BLOCK; /** Contained statements. */ statements: Statement[]; } /** Represents a `break` statement. */ export class BreakStatement extends Statement { kind = NodeKind.BREAK; /** Target label, if applicable. */ label: IdentifierExpression | null; } /** Represents a `class` declaration. */ export class ClassDeclaration extends DeclarationStatement { kind = NodeKind.CLASSDECLARATION; /** Accepted type parameters. */ typeParameters: TypeParameter[]; /** Base class type being extended. */ extendsType: TypeNode | null; /** Interface types being implemented. */ implementsTypes: TypeNode[]; /** Class member declarations. */ members: DeclarationStatement[]; } /** Represents a `continue` statement. */ export class ContinueStatement extends Statement { kind = NodeKind.CONTINUE; /** Target label, if applicable. */ label: IdentifierExpression | null; } /** Built-in decorator kinds. */ export const enum DecoratorKind { CUSTOM, GLOBAL, OPERATOR, EXPLICIT, OFFSET } /** Depresents a decorator. */ export class Decorator extends Statement { kind = NodeKind.DECORATOR; /** Name expression. */ name: Expression; /** Argument expressions. */ arguments: Expression[] | null; /** Built-in kind, if applicable. */ decoratorKind: DecoratorKind; } /** Represents a `do` statement. */ export class DoStatement extends Statement { kind = NodeKind.DO; /** Statement being looped over. */ statement: Statement; /** Condition when to repeat. */ condition: Expression; } /** Represents an empty statement, i.e., a semicolon terminating nothing. */ export class EmptyStatement extends Statement { kind = NodeKind.EMPTY; } /** Represents an `enum` declaration. */ export class EnumDeclaration extends DeclarationStatement { kind = NodeKind.ENUMDECLARATION; /** Enum value declarations. */ values: EnumValueDeclaration[]; } /** Represents a value of an `enum` declaration. */ export class EnumValueDeclaration extends DeclarationStatement { kind = NodeKind.ENUMVALUEDECLARATION; modifiers = null; // name is inherited /** Value expression. */ value: Expression | null; } /** Represents an `export import` statement of an interface. */ export class ExportImportStatement extends Node { kind = NodeKind.EXPORTIMPORT; /** Identifier being imported. */ identifier: IdentifierExpression; /** Identifier being exported. */ externalIdentifier: IdentifierExpression; } /** Represents a member of an `export` statement. */ export class ExportMember extends Node { kind = NodeKind.EXPORTMEMBER; /** Identifier being exported. */ identifier: IdentifierExpression; /** Identifier seen when imported again. */ externalIdentifier: IdentifierExpression; } /** Represents an `export` statement. */ export class ExportStatement extends Statement { kind = NodeKind.EXPORT; /** Array of modifiers. */ modifiers: Modifier[] | null; /** Array of members. */ members: ExportMember[]; /** Path being exported from, if applicable. */ path: StringLiteralExpression | null; /** Normalized path, if `path` is set. */ normalizedPath: string | null; /** Mangled internal path being referenced, if `path` is set. */ internalPath: string | null; } /** Represents an expression statement, i.e., an expression being used as a statement */ export class ExpressionStatement extends Statement { kind = NodeKind.EXPRESSION; /** Expression being used as a statement.*/ expression: Expression; } /** Represents a field declaration within a `class`. */ export class FieldDeclaration extends VariableLikeDeclarationStatement { kind = NodeKind.FIELDDECLARATION; } /** Represents a `for` statement. */ export class ForStatement extends Statement { kind = NodeKind.FOR; /** Initializer statement, if present. Either a {@link VariableStatement} or {@link ExpressionStatement}. */ initializer: Statement | null; /** Condition expression, if present. */ condition: Expression | null; /** Incrementor expression, if present. */ incrementor: Expression | null; /** Statement being looped over. */ statement: Statement; } /** Represents a `function` declaration. */ export class FunctionDeclaration extends DeclarationStatement { kind = NodeKind.FUNCTIONDECLARATION; /** Accepted type parameters. */ typeParameters: TypeParameter[]; /** Accepted parameters. */ parameters: Parameter[]; /** Return type. */ returnType: TypeNode | null; /** Contained statements. */ statements: Statement[] | null; } /** Represents an `if` statement. */ export class IfStatement extends Statement { kind = NodeKind.IF; /** Condition. */ condition: Expression; /** Statement executed when condition is `true`. */ ifTrue: Statement; /** Statement executed when condition is `false`. */ ifFalse: Statement | null; } /** Represents an `import` declaration, a single member within an {@link ImportStatement}. */ export class ImportDeclaration extends DeclarationStatement { kind = NodeKind.IMPORTDECLARATION; modifiers = null; /** Identifier being imported. */ externalIdentifier: IdentifierExpression; } /** Represents an `import` statement. */ export class ImportStatement extends Statement { kind = NodeKind.IMPORT; /** Array of member declarations or `null` if an asterisk import. */ declarations: ImportDeclaration[] | null; /** Name of the local namespace, if an asterisk import. */ namespaceName: IdentifierExpression | null; /** Path being imported from. */ path: StringLiteralExpression; /** Normalized path. */ normalizedPath: string; /** Mangled internal path being referenced. */ internalPath: string; } /** Represents an `interfarce` declaration. */ export class InterfaceDeclaration extends ClassDeclaration { kind = NodeKind.INTERFACEDECLARATION; } /** Represents a method declaration within a `class`. */ export class MethodDeclaration extends FunctionDeclaration { kind = NodeKind.METHODDECLARATION; } /** Represents a `namespace` declaration. */ export class NamespaceDeclaration extends DeclarationStatement { kind = NodeKind.NAMESPACEDECLARATION; /** Array of namespace members. */ members: Statement[]; } /** Represents a function parameter. */ export class Parameter extends Node { kind = NodeKind.PARAMETER; /** Parameter name. */ name: IdentifierExpression; /** Parameter type. */ type: TypeNode | null; /** Initializer expression, if present. */ initializer: Expression | null; /** Whether a rest parameter or not. */ isRest: bool; } /** Represents a single modifier. */ export class Modifier extends Node { kind = NodeKind.MODIFIER; /** Specific modifier kind. */ modifierKind: ModifierKind; } /** Represents a `return` statement. */ export class ReturnStatement extends Statement { kind = NodeKind.RETURN; /** Value expression being returned, if present. */ value: Expression | null; } /** Represents a single `case` within a `switch` statement. */ export class SwitchCase extends Node { kind = NodeKind.SWITCHCASE; /** Label expression. `null` indicates the default case. */ label: Expression | null; /** Contained statements. */ statements: Statement[]; } /** Represents a `switch` statement. */ export class SwitchStatement extends Statement { kind = NodeKind.SWITCH; /** Condition expression. */ condition: Expression; /** Contained cases. */ cases: SwitchCase[]; } /** Represents a `throw` statement. */ export class ThrowStatement extends Statement { kind = NodeKind.THROW; /** Value expression being thrown. */ value: Expression; } /** Represents a `try` statement. */ export class TryStatement extends Statement { kind = NodeKind.TRY; /** Contained statements. */ statements: Statement[]; /** Variable identifier for a caught exception, if a `catch` clause is present. */ catchVariable: IdentifierExpression | null; /** Statements being executed when an exception has been caught, if a `catch` clause is present. */ catchStatements: Statement[] | null; /** Statements being executed in any case, if a `finally` clause is present. */ finallyStatements: Statement[] | null; } /** Represents a `type` declaration. */ export class TypeDeclaration extends DeclarationStatement { kind = NodeKind.TYPEDECLARATION; /** Type being aliased. */ alias: TypeNode; } /** Represents a single variable declaration within a {@link VariableStatement}. */ export class VariableDeclaration extends VariableLikeDeclarationStatement { kind = NodeKind.VARIABLEDECLARATION; /** Array of modifiers. */ modifiers: Modifier[] | null; } /** Represents a variable statement, i.e., a `var`, `let` or `const` statement. */ export class VariableStatement extends Statement { kind = NodeKind.VARIABLE; /** Array of modifiers. */ modifiers: Modifier[] | null; /** Array of decorators. */ decorators: Decorator[] | null; /** Array of member declarations. */ declarations: VariableDeclaration[]; } /** Represents a `while` statement. */ export class WhileStatement extends Statement { kind = NodeKind.WHILE; /** Condition expression. */ condition: Expression; /** Statement being looped over. */ statement: Statement; } /** Cached unused modifiers for reuse. */ var reusableModifiers: Modifier[] | null = null; export function setReusableModifiers(modifiers: Modifier[]) { reusableModifiers = modifiers; } /** Creates a new modifiers array. */ export function createModifiers(): Modifier[] { var ret: Modifier[]; if (reusableModifiers != null) { ret = reusableModifiers; reusableModifiers = null; } else ret = new Array(1); ret.length = 0; return ret; } /** Adds a modifier to a modifiers array. Creates and returns a new array if `null`. */ export function addModifier(modifier: Modifier, modifiers: Modifier[] | null): Modifier[] { if (modifiers == null) modifiers = createModifiers(); modifiers.push(modifier); return modifiers; } /** Gets a specific modifier from the specified array of modifiers. */ export function getModifier(kind: ModifierKind, modifiers: Modifier[] | null): Modifier | null { if (modifiers) for (var i = 0, k = modifiers.length; i < k; ++i) if (modifiers[i].modifierKind == kind) return modifiers[i]; return null; } /** Tests whether a specific modifier exists in the specified array of modifiers. */ export function hasModifier(kind: ModifierKind, modifiers: Modifier[] | null): bool { return getModifier(kind, modifiers) != null; } /** Gets a specific decorator within the specified decorators, if present. */ export function getFirstDecorator(name: string, decorators: Decorator[] | null): Decorator | null { if (decorators) for (var i = 0, k = decorators.length; i < k; ++i) { var decorator = decorators[i]; var expression = decorator.name; if (expression.kind == NodeKind.IDENTIFIER && (expression).name == name) return decorator; } return null; } /** Tests if a specific decorator is present within the specified decorators. */ export function hasDecorator(name: string, decorators: Decorator[] | null): bool { return getFirstDecorator(name, decorators) != null; } /** Mangles a declaration's name to an internal name. */ export function mangleInternalName(declaration: DeclarationStatement, asGlobal: bool = false): string { var name = declaration.name.name; var parent = declaration.parent; if (!parent) return name; if (declaration.kind == NodeKind.VARIABLEDECLARATION && parent.kind == NodeKind.VARIABLE) // skip over if (!(parent = parent.parent)) return name; if (parent.kind == NodeKind.CLASSDECLARATION) return mangleInternalName(parent, asGlobal) + (hasModifier(ModifierKind.STATIC, declaration.modifiers) ? STATIC_DELIMITER : INSTANCE_DELIMITER) + name; if (parent.kind == NodeKind.NAMESPACEDECLARATION || parent.kind == NodeKind.ENUMDECLARATION) return mangleInternalName(parent, asGlobal) + STATIC_DELIMITER + name; if (asGlobal) return name; return declaration.range.source.internalPath + PATH_DELIMITER + name; } /** Mangles an external to an internal path. */ export function mangleInternalPath(path: string): string { // not necessary with current config // if (PATH_DELIMITER.charCodeAt(0) != CharCode.SLASH) // path = path.replace("/", PATH_DELIMITER); // if (PARENT_SUBST != "..") // path = path.replace("..", PARENT_SUBST); return path; }