Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(2760)

Unified Diff: observatory_pub_packages/analyzer/src/generated/ast.dart

Issue 816693004: Add observatory_pub_packages snapshot to third_party (Closed) Base URL: http://dart.googlecode.com/svn/third_party/
Patch Set: Created 6 years ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: observatory_pub_packages/analyzer/src/generated/ast.dart
===================================================================
--- observatory_pub_packages/analyzer/src/generated/ast.dart (revision 0)
+++ observatory_pub_packages/analyzer/src/generated/ast.dart (working copy)
@@ -0,0 +1,19542 @@
+// Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+// This code was auto-generated, is not intended to be edited, and is subject to
+// significant change. Please see the README file for more information.
+
+library engine.ast;
+
+import 'dart:collection';
+import 'java_core.dart';
+import 'java_engine.dart';
+import 'source.dart' show LineInfo, Source;
+import 'scanner.dart';
+import 'engine.dart' show AnalysisEngine;
+import 'utilities_dart.dart';
+import 'utilities_collection.dart' show TokenMap;
+import 'element.dart';
+import 'constant.dart';
+import 'parser.dart';
+
+/**
+ * Instances of the class `AdjacentStrings` represents two or more string literals that are
+ * implicitly concatenated because of being adjacent (separated only by whitespace).
+ *
+ * While the grammar only allows adjacent strings when all of the strings are of the same kind
+ * (single line or multi-line), this class doesn't enforce that restriction.
+ *
+ * <pre>
+ * adjacentStrings ::=
+ * [StringLiteral] [StringLiteral]+
+ * </pre>
+ */
+class AdjacentStrings extends StringLiteral {
+ /**
+ * The strings that are implicitly concatenated.
+ */
+ NodeList<StringLiteral> _strings;
+
+ /**
+ * Initialize a newly created list of adjacent strings.
+ *
+ * @param strings the strings that are implicitly concatenated
+ */
+ AdjacentStrings(List<StringLiteral> strings) {
+ this._strings = new NodeList<StringLiteral>(this);
+ this._strings.addAll(strings);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitAdjacentStrings(this);
+
+ @override
+ Token get beginToken => _strings.beginToken;
+
+ @override
+ Token get endToken => _strings.endToken;
+
+ /**
+ * Return the strings that are implicitly concatenated.
+ *
+ * @return the strings that are implicitly concatenated
+ */
+ NodeList<StringLiteral> get strings => _strings;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _strings.accept(visitor);
+ }
+
+ @override
+ void appendStringValue(JavaStringBuilder builder) {
+ for (StringLiteral stringLiteral in strings) {
+ stringLiteral.appendStringValue(builder);
+ }
+ }
+}
+
+/**
+ * The abstract class `AnnotatedNode` defines the behavior of nodes that can be annotated with
+ * both a comment and metadata.
+ */
+abstract class AnnotatedNode extends AstNode {
+ /**
+ * The documentation comment associated with this node, or `null` if this node does not have
+ * a documentation comment associated with it.
+ */
+ Comment _comment;
+
+ /**
+ * The annotations associated with this node.
+ */
+ NodeList<Annotation> _metadata;
+
+ /**
+ * Initialize a newly created node.
+ *
+ * @param comment the documentation comment associated with this node
+ * @param metadata the annotations associated with this node
+ */
+ AnnotatedNode(Comment comment, List<Annotation> metadata) {
+ this._metadata = new NodeList<Annotation>(this);
+ this._comment = becomeParentOf(comment);
+ this._metadata.addAll(metadata);
+ }
+
+ @override
+ Token get beginToken {
+ if (_comment == null) {
+ if (_metadata.isEmpty) {
+ return firstTokenAfterCommentAndMetadata;
+ } else {
+ return _metadata.beginToken;
+ }
+ } else if (_metadata.isEmpty) {
+ return _comment.beginToken;
+ }
+ Token commentToken = _comment.beginToken;
+ Token metadataToken = _metadata.beginToken;
+ if (commentToken.offset < metadataToken.offset) {
+ return commentToken;
+ }
+ return metadataToken;
+ }
+
+ /**
+ * Return the documentation comment associated with this node, or `null` if this node does
+ * not have a documentation comment associated with it.
+ *
+ * @return the documentation comment associated with this node
+ */
+ Comment get documentationComment => _comment;
+
+ /**
+ * Return the annotations associated with this node.
+ *
+ * @return the annotations associated with this node
+ */
+ NodeList<Annotation> get metadata => _metadata;
+
+ /**
+ * Set the documentation comment associated with this node to the given comment.
+ *
+ * @param comment the documentation comment to be associated with this node
+ */
+ void set documentationComment(Comment comment) {
+ this._comment = becomeParentOf(comment);
+ }
+
+ /**
+ * Set the metadata associated with this node to the given metadata.
+ *
+ * @param metadata the metadata to be associated with this node
+ */
+ void set metadata(List<Annotation> metadata) {
+ this._metadata.clear();
+ this._metadata.addAll(metadata);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ if (_commentIsBeforeAnnotations()) {
+ safelyVisitChild(_comment, visitor);
+ _metadata.accept(visitor);
+ } else {
+ for (AstNode child in sortedCommentAndAnnotations) {
+ child.accept(visitor);
+ }
+ }
+ }
+
+ /**
+ * Return the first token following the comment and metadata.
+ *
+ * @return the first token following the comment and metadata
+ */
+ Token get firstTokenAfterCommentAndMetadata;
+
+ /**
+ * Return `true` if the comment is lexically before any annotations.
+ *
+ * @return `true` if the comment is lexically before any annotations
+ */
+ bool _commentIsBeforeAnnotations() {
+ if (_comment == null || _metadata.isEmpty) {
+ return true;
+ }
+ Annotation firstAnnotation = _metadata[0];
+ return _comment.offset < firstAnnotation.offset;
+ }
+
+ /**
+ * Return an array containing the comment and annotations associated with this node, sorted in
+ * lexical order.
+ *
+ * @return the comment and annotations associated with this node in the order in which they
+ * appeared in the original source
+ */
+ List<AstNode> get sortedCommentAndAnnotations {
+ List<AstNode> childList = new List<AstNode>();
+ childList.add(_comment);
+ childList.addAll(_metadata);
+ List<AstNode> children = new List.from(childList);
+ children.sort(AstNode.LEXICAL_ORDER);
+ return children;
+ }
+}
+
+/**
+ * Instances of the class `Annotation` represent an annotation that can be associated with an
+ * AST node.
+ *
+ * <pre>
+ * metadata ::=
+ * annotation*
+ *
+ * annotation ::=
+ * '@' [Identifier] ('.' [SimpleIdentifier])? [ArgumentList]?
+ * </pre>
+ */
+class Annotation extends AstNode {
+ /**
+ * The at sign that introduced the annotation.
+ */
+ Token atSign;
+
+ /**
+ * The name of the class defining the constructor that is being invoked or the name of the field
+ * that is being referenced.
+ */
+ Identifier _name;
+
+ /**
+ * The period before the constructor name, or `null` if this annotation is not the
+ * invocation of a named constructor.
+ */
+ Token period;
+
+ /**
+ * The name of the constructor being invoked, or `null` if this annotation is not the
+ * invocation of a named constructor.
+ */
+ SimpleIdentifier _constructorName;
+
+ /**
+ * The arguments to the constructor being invoked, or `null` if this annotation is not the
+ * invocation of a constructor.
+ */
+ ArgumentList _arguments;
+
+ /**
+ * The element associated with this annotation, or `null` if the AST structure has not been
+ * resolved or if this annotation could not be resolved.
+ */
+ Element _element;
+
+ /**
+ * The element annotation representing this annotation in the element model.
+ */
+ ElementAnnotation elementAnnotation;
+
+ /**
+ * Initialize a newly created annotation.
+ *
+ * @param atSign the at sign that introduced the annotation
+ * @param name the name of the class defining the constructor that is being invoked or the name of
+ * the field that is being referenced
+ * @param period the period before the constructor name, or `null` if this annotation is not
+ * the invocation of a named constructor
+ * @param constructorName the name of the constructor being invoked, or `null` if this
+ * annotation is not the invocation of a named constructor
+ * @param arguments the arguments to the constructor being invoked, or `null` if this
+ * annotation is not the invocation of a constructor
+ */
+ Annotation(this.atSign, Identifier name, this.period, SimpleIdentifier constructorName, ArgumentList arguments) {
+ this._name = becomeParentOf(name);
+ this._constructorName = becomeParentOf(constructorName);
+ this._arguments = becomeParentOf(arguments);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitAnnotation(this);
+
+ /**
+ * Return the arguments to the constructor being invoked, or `null` if this annotation is
+ * not the invocation of a constructor.
+ *
+ * @return the arguments to the constructor being invoked
+ */
+ ArgumentList get arguments => _arguments;
+
+ @override
+ Token get beginToken => atSign;
+
+ /**
+ * Return the name of the constructor being invoked, or `null` if this annotation is not the
+ * invocation of a named constructor.
+ *
+ * @return the name of the constructor being invoked
+ */
+ SimpleIdentifier get constructorName => _constructorName;
+
+ /**
+ * Return the element associated with this annotation, or `null` if the AST structure has
+ * not been resolved or if this annotation could not be resolved.
+ *
+ * @return the element associated with this annotation
+ */
+ Element get element {
+ if (_element != null) {
+ return _element;
+ }
+ if (_name != null) {
+ return _name.staticElement;
+ }
+ return null;
+ }
+
+ @override
+ Token get endToken {
+ if (_arguments != null) {
+ return _arguments.endToken;
+ } else if (_constructorName != null) {
+ return _constructorName.endToken;
+ }
+ return _name.endToken;
+ }
+
+ /**
+ * Return the name of the class defining the constructor that is being invoked or the name of the
+ * field that is being referenced.
+ *
+ * @return the name of the constructor being invoked or the name of the field being referenced
+ */
+ Identifier get name => _name;
+
+ /**
+ * Set the arguments to the constructor being invoked to the given arguments.
+ *
+ * @param arguments the arguments to the constructor being invoked
+ */
+ void set arguments(ArgumentList arguments) {
+ this._arguments = becomeParentOf(arguments);
+ }
+
+ /**
+ * Set the name of the constructor being invoked to the given name.
+ *
+ * @param constructorName the name of the constructor being invoked
+ */
+ void set constructorName(SimpleIdentifier constructorName) {
+ this._constructorName = becomeParentOf(constructorName);
+ }
+
+ /**
+ * Set the element associated with this annotation based.
+ *
+ * @param element the element to be associated with this identifier
+ */
+ void set element(Element element) {
+ this._element = element;
+ }
+
+ /**
+ * Set the name of the class defining the constructor that is being invoked or the name of the
+ * field that is being referenced to the given name.
+ *
+ * @param name the name of the constructor being invoked or the name of the field being referenced
+ */
+ void set name(Identifier name) {
+ this._name = becomeParentOf(name);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_name, visitor);
+ safelyVisitChild(_constructorName, visitor);
+ safelyVisitChild(_arguments, visitor);
+ }
+}
+
+/**
+ * Instances of the class `ArgumentList` represent a list of arguments in the invocation of a
+ * executable element: a function, method, or constructor.
+ *
+ * <pre>
+ * argumentList ::=
+ * '(' arguments? ')'
+ *
+ * arguments ::=
+ * [NamedExpression] (',' [NamedExpression])*
+ * | [Expression] (',' [NamedExpression])*
+ * </pre>
+ */
+class ArgumentList extends AstNode {
+ /**
+ * The left parenthesis.
+ */
+ Token _leftParenthesis;
+
+ /**
+ * The expressions producing the values of the arguments.
+ */
+ NodeList<Expression> _arguments;
+
+ /**
+ * The right parenthesis.
+ */
+ Token _rightParenthesis;
+
+ /**
+ * An array containing the elements representing the parameters corresponding to each of the
+ * arguments in this list, or `null` if the AST has not been resolved or if the function or
+ * method being invoked could not be determined based on static type information. The array must
+ * be the same length as the number of arguments, but can contain `null` entries if a given
+ * argument does not correspond to a formal parameter.
+ */
+ List<ParameterElement> _correspondingStaticParameters;
+
+ /**
+ * An array containing the elements representing the parameters corresponding to each of the
+ * arguments in this list, or `null` if the AST has not been resolved or if the function or
+ * method being invoked could not be determined based on propagated type information. The array
+ * must be the same length as the number of arguments, but can contain `null` entries if a
+ * given argument does not correspond to a formal parameter.
+ */
+ List<ParameterElement> _correspondingPropagatedParameters;
+
+ /**
+ * Initialize a newly created list of arguments.
+ *
+ * @param leftParenthesis the left parenthesis
+ * @param arguments the expressions producing the values of the arguments
+ * @param rightParenthesis the right parenthesis
+ */
+ ArgumentList(Token leftParenthesis, List<Expression> arguments, Token rightParenthesis) {
+ this._arguments = new NodeList<Expression>(this);
+ this._leftParenthesis = leftParenthesis;
+ this._arguments.addAll(arguments);
+ this._rightParenthesis = rightParenthesis;
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitArgumentList(this);
+
+ /**
+ * Return the expressions producing the values of the arguments. Although the language requires
+ * that positional arguments appear before named arguments, this class allows them to be
+ * intermixed.
+ *
+ * @return the expressions producing the values of the arguments
+ */
+ NodeList<Expression> get arguments => _arguments;
+
+ @override
+ Token get beginToken => _leftParenthesis;
+
+ @override
+ Token get endToken => _rightParenthesis;
+
+ /**
+ * Return the left parenthesis.
+ *
+ * @return the left parenthesis
+ */
+ Token get leftParenthesis => _leftParenthesis;
+
+ /**
+ * Return the right parenthesis.
+ *
+ * @return the right parenthesis
+ */
+ Token get rightParenthesis => _rightParenthesis;
+
+ /**
+ * Set the parameter elements corresponding to each of the arguments in this list to the given
+ * array of parameters. The array of parameters must be the same length as the number of
+ * arguments, but can contain `null` entries if a given argument does not correspond to a
+ * formal parameter.
+ *
+ * @param parameters the parameter elements corresponding to the arguments
+ */
+ void set correspondingPropagatedParameters(List<ParameterElement> parameters) {
+ if (parameters.length != _arguments.length) {
+ throw new IllegalArgumentException("Expected ${_arguments.length} parameters, not ${parameters.length}");
+ }
+ _correspondingPropagatedParameters = parameters;
+ }
+
+ /**
+ * Set the parameter elements corresponding to each of the arguments in this list to the given
+ * array of parameters. The array of parameters must be the same length as the number of
+ * arguments, but can contain `null` entries if a given argument does not correspond to a
+ * formal parameter.
+ *
+ * @param parameters the parameter elements corresponding to the arguments
+ */
+ void set correspondingStaticParameters(List<ParameterElement> parameters) {
+ if (parameters.length != _arguments.length) {
+ throw new IllegalArgumentException("Expected ${_arguments.length} parameters, not ${parameters.length}");
+ }
+ _correspondingStaticParameters = parameters;
+ }
+
+ /**
+ * Set the left parenthesis to the given token.
+ *
+ * @param parenthesis the left parenthesis
+ */
+ void set leftParenthesis(Token parenthesis) {
+ _leftParenthesis = parenthesis;
+ }
+
+ /**
+ * Set the right parenthesis to the given token.
+ *
+ * @param parenthesis the right parenthesis
+ */
+ void set rightParenthesis(Token parenthesis) {
+ _rightParenthesis = parenthesis;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _arguments.accept(visitor);
+ }
+
+ /**
+ * If the given expression is a child of this list, and the AST structure has been resolved, and
+ * the function being invoked is known based on propagated type information, and the expression
+ * corresponds to one of the parameters of the function being invoked, then return the parameter
+ * element representing the parameter to which the value of the given expression will be bound.
+ * Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getPropagatedParameterElement].
+ *
+ * @param expression the expression corresponding to the parameter to be returned
+ * @return the parameter element representing the parameter to which the value of the expression
+ * will be bound
+ */
+ ParameterElement getPropagatedParameterElementFor(Expression expression) {
+ if (_correspondingPropagatedParameters == null) {
+ // Either the AST structure has not been resolved or the invocation of which this list is a
+ // part could not be resolved.
+ return null;
+ }
+ int index = _arguments.indexOf(expression);
+ if (index < 0) {
+ // The expression isn't a child of this node.
+ return null;
+ }
+ return _correspondingPropagatedParameters[index];
+ }
+
+ /**
+ * If the given expression is a child of this list, and the AST structure has been resolved, and
+ * the function being invoked is known based on static type information, and the expression
+ * corresponds to one of the parameters of the function being invoked, then return the parameter
+ * element representing the parameter to which the value of the given expression will be bound.
+ * Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getStaticParameterElement].
+ *
+ * @param expression the expression corresponding to the parameter to be returned
+ * @return the parameter element representing the parameter to which the value of the expression
+ * will be bound
+ */
+ ParameterElement getStaticParameterElementFor(Expression expression) {
+ if (_correspondingStaticParameters == null) {
+ // Either the AST structure has not been resolved or the invocation of which this list is a
+ // part could not be resolved.
+ return null;
+ }
+ int index = _arguments.indexOf(expression);
+ if (index < 0) {
+ // The expression isn't a child of this node.
+ return null;
+ }
+ return _correspondingStaticParameters[index];
+ }
+}
+
+/**
+ * Instances of the class `AsExpression` represent an 'as' expression.
+ *
+ * <pre>
+ * asExpression ::=
+ * [Expression] 'as' [TypeName]
+ * </pre>
+ */
+class AsExpression extends Expression {
+ /**
+ * The expression used to compute the value being cast.
+ */
+ Expression _expression;
+
+ /**
+ * The as operator.
+ */
+ Token asOperator;
+
+ /**
+ * The name of the type being cast to.
+ */
+ TypeName _type;
+
+ /**
+ * Initialize a newly created as expression.
+ *
+ * @param expression the expression used to compute the value being cast
+ * @param isOperator the is operator
+ * @param type the name of the type being cast to
+ */
+ AsExpression(Expression expression, Token isOperator, TypeName type) {
+ this._expression = becomeParentOf(expression);
+ this.asOperator = isOperator;
+ this._type = becomeParentOf(type);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitAsExpression(this);
+
+ @override
+ Token get beginToken => _expression.beginToken;
+
+ @override
+ Token get endToken => _type.endToken;
+
+ /**
+ * Return the expression used to compute the value being cast.
+ *
+ * @return the expression used to compute the value being cast
+ */
+ Expression get expression => _expression;
+
+ @override
+ int get precedence => 7;
+
+ /**
+ * Return the name of the type being cast to.
+ *
+ * @return the name of the type being cast to
+ */
+ TypeName get type => _type;
+
+ /**
+ * Set the expression used to compute the value being cast to the given expression.
+ *
+ * @param expression the expression used to compute the value being cast
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the name of the type being cast to to the given name.
+ *
+ * @param name the name of the type being cast to
+ */
+ void set type(TypeName name) {
+ this._type = becomeParentOf(name);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_expression, visitor);
+ safelyVisitChild(_type, visitor);
+ }
+}
+
+/**
+ * Instances of the class `AssertStatement` represent an assert statement.
+ *
+ * <pre>
+ * assertStatement ::=
+ * 'assert' '(' [Expression] ')' ';'
+ * </pre>
+ */
+class AssertStatement extends Statement {
+ /**
+ * The token representing the 'assert' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The left parenthesis.
+ */
+ Token leftParenthesis;
+
+ /**
+ * The condition that is being asserted to be `true`.
+ */
+ Expression _condition;
+
+ /**
+ * The right parenthesis.
+ */
+ Token rightParenthesis;
+
+ /**
+ * The semicolon terminating the statement.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created assert statement.
+ *
+ * @param keyword the token representing the 'assert' keyword
+ * @param leftParenthesis the left parenthesis
+ * @param condition the condition that is being asserted to be `true`
+ * @param rightParenthesis the right parenthesis
+ * @param semicolon the semicolon terminating the statement
+ */
+ AssertStatement(this.keyword, this.leftParenthesis, Expression condition, this.rightParenthesis, this.semicolon) {
+ this._condition = becomeParentOf(condition);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitAssertStatement(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ /**
+ * Return the condition that is being asserted to be `true`.
+ *
+ * @return the condition that is being asserted to be `true`
+ */
+ Expression get condition => _condition;
+
+ @override
+ Token get endToken => semicolon;
+
+ /**
+ * Set the condition that is being asserted to be `true` to the given expression.
+ *
+ * @param the condition that is being asserted to be `true`
+ */
+ void set condition(Expression condition) {
+ this._condition = becomeParentOf(condition);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_condition, visitor);
+ }
+}
+
+/**
+ * Instances of the class `AssignmentExpression` represent an assignment expression.
+ *
+ * <pre>
+ * assignmentExpression ::=
+ * [Expression] [Token] [Expression]
+ * </pre>
+ */
+class AssignmentExpression extends Expression {
+ /**
+ * The expression used to compute the left hand side.
+ */
+ Expression _leftHandSide;
+
+ /**
+ * The assignment operator being applied.
+ */
+ Token operator;
+
+ /**
+ * The expression used to compute the right hand side.
+ */
+ Expression _rightHandSide;
+
+ /**
+ * The element associated with the operator based on the static type of the left-hand-side, or
+ * `null` if the AST structure has not been resolved, if the operator is not a compound
+ * operator, or if the operator could not be resolved.
+ */
+ MethodElement _staticElement;
+
+ /**
+ * The element associated with the operator based on the propagated type of the left-hand-side, or
+ * `null` if the AST structure has not been resolved, if the operator is not a compound
+ * operator, or if the operator could not be resolved.
+ */
+ MethodElement _propagatedElement;
+
+ /**
+ * Initialize a newly created assignment expression.
+ *
+ * @param leftHandSide the expression used to compute the left hand side
+ * @param operator the assignment operator being applied
+ * @param rightHandSide the expression used to compute the right hand side
+ */
+ AssignmentExpression(Expression leftHandSide, this.operator, Expression rightHandSide) {
+ if (leftHandSide == null || rightHandSide == null) {
+ String message;
+ if (leftHandSide == null) {
+ if (rightHandSide == null) {
+ message = "Both the left-hand and right-hand sides are null";
+ } else {
+ message = "The left-hand size is null";
+ }
+ } else {
+ message = "The right-hand size is null";
+ }
+ AnalysisEngine.instance.logger.logError2(message, new JavaException(message));
+ }
+ this._leftHandSide = becomeParentOf(leftHandSide);
+ this._rightHandSide = becomeParentOf(rightHandSide);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitAssignmentExpression(this);
+
+ @override
+ Token get beginToken => _leftHandSide.beginToken;
+
+ /**
+ * Return the best element available for this operator. If resolution was able to find a better
+ * element based on type propagation, that element will be returned. Otherwise, the element found
+ * using the result of static analysis will be returned. If resolution has not been performed,
+ * then `null` will be returned.
+ *
+ * @return the best element available for this operator
+ */
+ MethodElement get bestElement {
+ MethodElement element = propagatedElement;
+ if (element == null) {
+ element = staticElement;
+ }
+ return element;
+ }
+
+ @override
+ Token get endToken => _rightHandSide.endToken;
+
+ /**
+ * Set the expression used to compute the left hand side to the given expression.
+ *
+ * @return the expression used to compute the left hand side
+ */
+ Expression get leftHandSide => _leftHandSide;
+
+ @override
+ int get precedence => 1;
+
+ /**
+ * Return the element associated with the operator based on the propagated type of the
+ * left-hand-side, or `null` if the AST structure has not been resolved, if the operator is
+ * not a compound operator, or if the operator could not be resolved. One example of the latter
+ * case is an operator that is not defined for the type of the left-hand operand.
+ *
+ * @return the element associated with the operator
+ */
+ MethodElement get propagatedElement => _propagatedElement;
+
+ /**
+ * Return the expression used to compute the right hand side.
+ *
+ * @return the expression used to compute the right hand side
+ */
+ Expression get rightHandSide => _rightHandSide;
+
+ /**
+ * Return the element associated with the operator based on the static type of the left-hand-side,
+ * or `null` if the AST structure has not been resolved, if the operator is not a compound
+ * operator, or if the operator could not be resolved. One example of the latter case is an
+ * operator that is not defined for the type of the left-hand operand.
+ *
+ * @return the element associated with the operator
+ */
+ MethodElement get staticElement => _staticElement;
+
+ /**
+ * Return the expression used to compute the left hand side.
+ *
+ * @param expression the expression used to compute the left hand side
+ */
+ void set leftHandSide(Expression expression) {
+ _leftHandSide = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the element associated with the operator based on the propagated type of the left-hand-side
+ * to the given element.
+ *
+ * @param element the element to be associated with the operator
+ */
+ void set propagatedElement(MethodElement element) {
+ _propagatedElement = element;
+ }
+
+ /**
+ * Set the expression used to compute the left hand side to the given expression.
+ *
+ * @param expression the expression used to compute the left hand side
+ */
+ void set rightHandSide(Expression expression) {
+ _rightHandSide = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the element associated with the operator based on the static type of the left-hand-side to
+ * the given element.
+ *
+ * @param element the static element to be associated with the operator
+ */
+ void set staticElement(MethodElement element) {
+ _staticElement = element;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_leftHandSide, visitor);
+ safelyVisitChild(_rightHandSide, visitor);
+ }
+
+ /**
+ * If the AST structure has been resolved, and the function being invoked is known based on
+ * propagated type information, then return the parameter element representing the parameter to
+ * which the value of the right operand will be bound. Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getPropagatedParameterElement].
+ *
+ * @return the parameter element representing the parameter to which the value of the right
+ * operand will be bound
+ */
+ ParameterElement get propagatedParameterElementForRightHandSide {
+ if (_propagatedElement == null) {
+ return null;
+ }
+ List<ParameterElement> parameters = _propagatedElement.parameters;
+ if (parameters.length < 1) {
+ return null;
+ }
+ return parameters[0];
+ }
+
+ /**
+ * If the AST structure has been resolved, and the function being invoked is known based on static
+ * type information, then return the parameter element representing the parameter to which the
+ * value of the right operand will be bound. Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getStaticParameterElement].
+ *
+ * @return the parameter element representing the parameter to which the value of the right
+ * operand will be bound
+ */
+ ParameterElement get staticParameterElementForRightHandSide {
+ if (_staticElement == null) {
+ return null;
+ }
+ List<ParameterElement> parameters = _staticElement.parameters;
+ if (parameters.length < 1) {
+ return null;
+ }
+ return parameters[0];
+ }
+}
+
+/**
+ * Instances of the class `AstCloner` implement an object that will clone any AST structure
+ * that it visits. The cloner will only clone the structure, it will not preserve any resolution
+ * results or properties associated with the nodes.
+ */
+class AstCloner implements AstVisitor<AstNode> {
+ List cloneNodeList(NodeList nodes) {
+ int count = nodes.length;
+ List clonedNodes = new List();
+ for (int i = 0; i < count; i++) {
+ clonedNodes.add((nodes[i]).accept(this) as AstNode);
+ }
+ return clonedNodes;
+ }
+
+ @override
+ AdjacentStrings visitAdjacentStrings(AdjacentStrings node) => new AdjacentStrings(cloneNodeList(node.strings));
+
+ @override
+ Annotation visitAnnotation(Annotation node) => new Annotation(node.atSign, cloneNode(node.name), node.period, cloneNode(node.constructorName), cloneNode(node.arguments));
+
+ @override
+ ArgumentList visitArgumentList(ArgumentList node) => new ArgumentList(node.leftParenthesis, cloneNodeList(node.arguments), node.rightParenthesis);
+
+ @override
+ AsExpression visitAsExpression(AsExpression node) => new AsExpression(cloneNode(node.expression), node.asOperator, cloneNode(node.type));
+
+ @override
+ AstNode visitAssertStatement(AssertStatement node) => new AssertStatement(node.keyword, node.leftParenthesis, cloneNode(node.condition), node.rightParenthesis, node.semicolon);
+
+ @override
+ AssignmentExpression visitAssignmentExpression(AssignmentExpression node) => new AssignmentExpression(cloneNode(node.leftHandSide), node.operator, cloneNode(node.rightHandSide));
+
+ @override
+ AwaitExpression visitAwaitExpression(AwaitExpression node) => new AwaitExpression(node.awaitKeyword, node.expression);
+
+ @override
+ BinaryExpression visitBinaryExpression(BinaryExpression node) => new BinaryExpression(cloneNode(node.leftOperand), node.operator, cloneNode(node.rightOperand));
+
+ @override
+ Block visitBlock(Block node) => new Block(node.leftBracket, cloneNodeList(node.statements), node.rightBracket);
+
+ @override
+ BlockFunctionBody visitBlockFunctionBody(BlockFunctionBody node) => new BlockFunctionBody(node.keyword, node.star, cloneNode(node.block));
+
+ @override
+ BooleanLiteral visitBooleanLiteral(BooleanLiteral node) => new BooleanLiteral(node.literal, node.value);
+
+ @override
+ BreakStatement visitBreakStatement(BreakStatement node) => new BreakStatement(node.keyword, cloneNode(node.label), node.semicolon);
+
+ @override
+ CascadeExpression visitCascadeExpression(CascadeExpression node) => new CascadeExpression(cloneNode(node.target), cloneNodeList(node.cascadeSections));
+
+ @override
+ CatchClause visitCatchClause(CatchClause node) => new CatchClause(node.onKeyword, cloneNode(node.exceptionType), node.catchKeyword, node.leftParenthesis, cloneNode(node.exceptionParameter), node.comma, cloneNode(node.stackTraceParameter), node.rightParenthesis, cloneNode(node.body));
+
+ @override
+ ClassDeclaration visitClassDeclaration(ClassDeclaration node) {
+ ClassDeclaration copy = new ClassDeclaration(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.abstractKeyword, node.classKeyword, cloneNode(node.name), cloneNode(node.typeParameters), cloneNode(node.extendsClause), cloneNode(node.withClause), cloneNode(node.implementsClause), node.leftBracket, cloneNodeList(node.members), node.rightBracket);
+ copy.nativeClause = cloneNode(node.nativeClause);
+ return copy;
+ }
+
+ @override
+ ClassTypeAlias visitClassTypeAlias(ClassTypeAlias node) => new ClassTypeAlias(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.keyword, cloneNode(node.name), cloneNode(node.typeParameters), node.equals, node.abstractKeyword, cloneNode(node.superclass), cloneNode(node.withClause), cloneNode(node.implementsClause), node.semicolon);
+
+ @override
+ Comment visitComment(Comment node) {
+ if (node.isDocumentation) {
+ return Comment.createDocumentationCommentWithReferences(node.tokens, cloneNodeList(node.references));
+ } else if (node.isBlock) {
+ return Comment.createBlockComment(node.tokens);
+ }
+ return Comment.createEndOfLineComment(node.tokens);
+ }
+
+ @override
+ CommentReference visitCommentReference(CommentReference node) => new CommentReference(node.newKeyword, cloneNode(node.identifier));
+
+ @override
+ CompilationUnit visitCompilationUnit(CompilationUnit node) {
+ CompilationUnit clone = new CompilationUnit(node.beginToken, cloneNode(node.scriptTag), cloneNodeList(node.directives), cloneNodeList(node.declarations), node.endToken);
+ clone.lineInfo = node.lineInfo;
+ return clone;
+ }
+
+ @override
+ ConditionalExpression visitConditionalExpression(ConditionalExpression node) => new ConditionalExpression(cloneNode(node.condition), node.question, cloneNode(node.thenExpression), node.colon, cloneNode(node.elseExpression));
+
+ @override
+ ConstructorDeclaration visitConstructorDeclaration(ConstructorDeclaration node) => new ConstructorDeclaration(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.externalKeyword, node.constKeyword, node.factoryKeyword, cloneNode(node.returnType), node.period, cloneNode(node.name), cloneNode(node.parameters), node.separator, cloneNodeList(node.initializers), cloneNode(node.redirectedConstructor), cloneNode(node.body));
+
+ @override
+ ConstructorFieldInitializer visitConstructorFieldInitializer(ConstructorFieldInitializer node) => new ConstructorFieldInitializer(node.keyword, node.period, cloneNode(node.fieldName), node.equals, cloneNode(node.expression));
+
+ @override
+ ConstructorName visitConstructorName(ConstructorName node) => new ConstructorName(cloneNode(node.type), node.period, cloneNode(node.name));
+
+ @override
+ ContinueStatement visitContinueStatement(ContinueStatement node) => new ContinueStatement(node.keyword, cloneNode(node.label), node.semicolon);
+
+ @override
+ DeclaredIdentifier visitDeclaredIdentifier(DeclaredIdentifier node) => new DeclaredIdentifier(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.keyword, cloneNode(node.type), cloneNode(node.identifier));
+
+ @override
+ DefaultFormalParameter visitDefaultFormalParameter(DefaultFormalParameter node) => new DefaultFormalParameter(cloneNode(node.parameter), node.kind, node.separator, cloneNode(node.defaultValue));
+
+ @override
+ DoStatement visitDoStatement(DoStatement node) => new DoStatement(node.doKeyword, cloneNode(node.body), node.whileKeyword, node.leftParenthesis, cloneNode(node.condition), node.rightParenthesis, node.semicolon);
+
+ @override
+ DoubleLiteral visitDoubleLiteral(DoubleLiteral node) => new DoubleLiteral(node.literal, node.value);
+
+ @override
+ EmptyFunctionBody visitEmptyFunctionBody(EmptyFunctionBody node) => new EmptyFunctionBody(node.semicolon);
+
+ @override
+ EmptyStatement visitEmptyStatement(EmptyStatement node) => new EmptyStatement(node.semicolon);
+
+ @override
+ AstNode visitEnumConstantDeclaration(EnumConstantDeclaration node) => new EnumConstantDeclaration(cloneNode(node.documentationComment), cloneNodeList(node.metadata), cloneNode(node.name));
+
+ @override
+ EnumDeclaration visitEnumDeclaration(EnumDeclaration node) => new EnumDeclaration(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.keyword, cloneNode(node.name), node.leftBracket, cloneNodeList(node.constants), node.rightBracket);
+
+ @override
+ ExportDirective visitExportDirective(ExportDirective node) {
+ ExportDirective directive = new ExportDirective(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.keyword, cloneNode(node.uri), cloneNodeList(node.combinators), node.semicolon);
+ directive.source = node.source;
+ directive.uriContent = node.uriContent;
+ return directive;
+ }
+
+ @override
+ ExpressionFunctionBody visitExpressionFunctionBody(ExpressionFunctionBody node) => new ExpressionFunctionBody(node.keyword, node.functionDefinition, cloneNode(node.expression), node.semicolon);
+
+ @override
+ ExpressionStatement visitExpressionStatement(ExpressionStatement node) => new ExpressionStatement(cloneNode(node.expression), node.semicolon);
+
+ @override
+ ExtendsClause visitExtendsClause(ExtendsClause node) => new ExtendsClause(node.keyword, cloneNode(node.superclass));
+
+ @override
+ FieldDeclaration visitFieldDeclaration(FieldDeclaration node) => new FieldDeclaration(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.staticKeyword, cloneNode(node.fields), node.semicolon);
+
+ @override
+ FieldFormalParameter visitFieldFormalParameter(FieldFormalParameter node) => new FieldFormalParameter(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.keyword, cloneNode(node.type), node.thisToken, node.period, cloneNode(node.identifier), cloneNode(node.parameters));
+
+ @override
+ ForEachStatement visitForEachStatement(ForEachStatement node) {
+ DeclaredIdentifier loopVariable = node.loopVariable;
+ if (loopVariable == null) {
+ return new ForEachStatement.con2(node.awaitKeyword, node.forKeyword, node.leftParenthesis, cloneNode(node.identifier), node.inKeyword, cloneNode(node.iterator), node.rightParenthesis, cloneNode(node.body));
+ }
+ return new ForEachStatement.con1(node.awaitKeyword, node.forKeyword, node.leftParenthesis, cloneNode(loopVariable), node.inKeyword, cloneNode(node.iterator), node.rightParenthesis, cloneNode(node.body));
+ }
+
+ @override
+ FormalParameterList visitFormalParameterList(FormalParameterList node) => new FormalParameterList(node.leftParenthesis, cloneNodeList(node.parameters), node.leftDelimiter, node.rightDelimiter, node.rightParenthesis);
+
+ @override
+ ForStatement visitForStatement(ForStatement node) => new ForStatement(node.forKeyword, node.leftParenthesis, cloneNode(node.variables), cloneNode(node.initialization), node.leftSeparator, cloneNode(node.condition), node.rightSeparator, cloneNodeList(node.updaters), node.rightParenthesis, cloneNode(node.body));
+
+ @override
+ FunctionDeclaration visitFunctionDeclaration(FunctionDeclaration node) => new FunctionDeclaration(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.externalKeyword, cloneNode(node.returnType), node.propertyKeyword, cloneNode(node.name), cloneNode(node.functionExpression));
+
+ @override
+ FunctionDeclarationStatement visitFunctionDeclarationStatement(FunctionDeclarationStatement node) => new FunctionDeclarationStatement(cloneNode(node.functionDeclaration));
+
+ @override
+ FunctionExpression visitFunctionExpression(FunctionExpression node) => new FunctionExpression(cloneNode(node.parameters), cloneNode(node.body));
+
+ @override
+ FunctionExpressionInvocation visitFunctionExpressionInvocation(FunctionExpressionInvocation node) => new FunctionExpressionInvocation(cloneNode(node.function), cloneNode(node.argumentList));
+
+ @override
+ FunctionTypeAlias visitFunctionTypeAlias(FunctionTypeAlias node) => new FunctionTypeAlias(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.keyword, cloneNode(node.returnType), cloneNode(node.name), cloneNode(node.typeParameters), cloneNode(node.parameters), node.semicolon);
+
+ @override
+ FunctionTypedFormalParameter visitFunctionTypedFormalParameter(FunctionTypedFormalParameter node) => new FunctionTypedFormalParameter(cloneNode(node.documentationComment), cloneNodeList(node.metadata), cloneNode(node.returnType), cloneNode(node.identifier), cloneNode(node.parameters));
+
+ @override
+ HideCombinator visitHideCombinator(HideCombinator node) => new HideCombinator(node.keyword, cloneNodeList(node.hiddenNames));
+
+ @override
+ IfStatement visitIfStatement(IfStatement node) => new IfStatement(node.ifKeyword, node.leftParenthesis, cloneNode(node.condition), node.rightParenthesis, cloneNode(node.thenStatement), node.elseKeyword, cloneNode(node.elseStatement));
+
+ @override
+ ImplementsClause visitImplementsClause(ImplementsClause node) => new ImplementsClause(node.keyword, cloneNodeList(node.interfaces));
+
+ @override
+ ImportDirective visitImportDirective(ImportDirective node) {
+ ImportDirective directive = new ImportDirective(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.keyword, cloneNode(node.uri), node.deferredToken, node.asToken, cloneNode(node.prefix), cloneNodeList(node.combinators), node.semicolon);
+ directive.source = node.source;
+ directive.uriContent = node.uriContent;
+ return directive;
+ }
+
+ @override
+ IndexExpression visitIndexExpression(IndexExpression node) {
+ Token period = node.period;
+ if (period == null) {
+ return new IndexExpression.forTarget(cloneNode(node.target), node.leftBracket, cloneNode(node.index), node.rightBracket);
+ } else {
+ return new IndexExpression.forCascade(period, node.leftBracket, cloneNode(node.index), node.rightBracket);
+ }
+ }
+
+ @override
+ InstanceCreationExpression visitInstanceCreationExpression(InstanceCreationExpression node) => new InstanceCreationExpression(node.keyword, cloneNode(node.constructorName), cloneNode(node.argumentList));
+
+ @override
+ IntegerLiteral visitIntegerLiteral(IntegerLiteral node) => new IntegerLiteral(node.literal, node.value);
+
+ @override
+ InterpolationExpression visitInterpolationExpression(InterpolationExpression node) => new InterpolationExpression(node.leftBracket, cloneNode(node.expression), node.rightBracket);
+
+ @override
+ InterpolationString visitInterpolationString(InterpolationString node) => new InterpolationString(node.contents, node.value);
+
+ @override
+ IsExpression visitIsExpression(IsExpression node) => new IsExpression(cloneNode(node.expression), node.isOperator, node.notOperator, cloneNode(node.type));
+
+ @override
+ Label visitLabel(Label node) => new Label(cloneNode(node.label), node.colon);
+
+ @override
+ LabeledStatement visitLabeledStatement(LabeledStatement node) => new LabeledStatement(cloneNodeList(node.labels), cloneNode(node.statement));
+
+ @override
+ LibraryDirective visitLibraryDirective(LibraryDirective node) => new LibraryDirective(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.libraryToken, cloneNode(node.name), node.semicolon);
+
+ @override
+ LibraryIdentifier visitLibraryIdentifier(LibraryIdentifier node) => new LibraryIdentifier(cloneNodeList(node.components));
+
+ @override
+ ListLiteral visitListLiteral(ListLiteral node) => new ListLiteral(node.constKeyword, cloneNode(node.typeArguments), node.leftBracket, cloneNodeList(node.elements), node.rightBracket);
+
+ @override
+ MapLiteral visitMapLiteral(MapLiteral node) => new MapLiteral(node.constKeyword, cloneNode(node.typeArguments), node.leftBracket, cloneNodeList(node.entries), node.rightBracket);
+
+ @override
+ MapLiteralEntry visitMapLiteralEntry(MapLiteralEntry node) => new MapLiteralEntry(cloneNode(node.key), node.separator, cloneNode(node.value));
+
+ @override
+ MethodDeclaration visitMethodDeclaration(MethodDeclaration node) => new MethodDeclaration(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.externalKeyword, node.modifierKeyword, cloneNode(node.returnType), node.propertyKeyword, node.operatorKeyword, cloneNode(node.name), cloneNode(node.parameters), cloneNode(node.body));
+
+ @override
+ MethodInvocation visitMethodInvocation(MethodInvocation node) => new MethodInvocation(cloneNode(node.target), node.period, cloneNode(node.methodName), cloneNode(node.argumentList));
+
+ @override
+ NamedExpression visitNamedExpression(NamedExpression node) => new NamedExpression(cloneNode(node.name), cloneNode(node.expression));
+
+ @override
+ AstNode visitNativeClause(NativeClause node) => new NativeClause(node.keyword, cloneNode(node.name));
+
+ @override
+ NativeFunctionBody visitNativeFunctionBody(NativeFunctionBody node) => new NativeFunctionBody(node.nativeToken, cloneNode(node.stringLiteral), node.semicolon);
+
+ @override
+ NullLiteral visitNullLiteral(NullLiteral node) => new NullLiteral(node.literal);
+
+ @override
+ ParenthesizedExpression visitParenthesizedExpression(ParenthesizedExpression node) => new ParenthesizedExpression(node.leftParenthesis, cloneNode(node.expression), node.rightParenthesis);
+
+ @override
+ PartDirective visitPartDirective(PartDirective node) {
+ PartDirective directive = new PartDirective(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.partToken, cloneNode(node.uri), node.semicolon);
+ directive.source = node.source;
+ directive.uriContent = node.uriContent;
+ return directive;
+ }
+
+ @override
+ PartOfDirective visitPartOfDirective(PartOfDirective node) => new PartOfDirective(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.partToken, node.ofToken, cloneNode(node.libraryName), node.semicolon);
+
+ @override
+ PostfixExpression visitPostfixExpression(PostfixExpression node) => new PostfixExpression(cloneNode(node.operand), node.operator);
+
+ @override
+ PrefixedIdentifier visitPrefixedIdentifier(PrefixedIdentifier node) => new PrefixedIdentifier(cloneNode(node.prefix), node.period, cloneNode(node.identifier));
+
+ @override
+ PrefixExpression visitPrefixExpression(PrefixExpression node) => new PrefixExpression(node.operator, cloneNode(node.operand));
+
+ @override
+ PropertyAccess visitPropertyAccess(PropertyAccess node) => new PropertyAccess(cloneNode(node.target), node.operator, cloneNode(node.propertyName));
+
+ @override
+ RedirectingConstructorInvocation visitRedirectingConstructorInvocation(RedirectingConstructorInvocation node) => new RedirectingConstructorInvocation(node.keyword, node.period, cloneNode(node.constructorName), cloneNode(node.argumentList));
+
+ @override
+ RethrowExpression visitRethrowExpression(RethrowExpression node) => new RethrowExpression(node.keyword);
+
+ @override
+ ReturnStatement visitReturnStatement(ReturnStatement node) => new ReturnStatement(node.keyword, cloneNode(node.expression), node.semicolon);
+
+ @override
+ ScriptTag visitScriptTag(ScriptTag node) => new ScriptTag(node.scriptTag);
+
+ @override
+ ShowCombinator visitShowCombinator(ShowCombinator node) => new ShowCombinator(node.keyword, cloneNodeList(node.shownNames));
+
+ @override
+ SimpleFormalParameter visitSimpleFormalParameter(SimpleFormalParameter node) => new SimpleFormalParameter(cloneNode(node.documentationComment), cloneNodeList(node.metadata), node.keyword, cloneNode(node.type), cloneNode(node.identifier));
+
+ @override
+ SimpleIdentifier visitSimpleIdentifier(SimpleIdentifier node) => new SimpleIdentifier(node.token);
+
+ @override
+ SimpleStringLiteral visitSimpleStringLiteral(SimpleStringLiteral node) => new SimpleStringLiteral(node.literal, node.value);
+
+ @override
+ StringInterpolation visitStringInterpolation(StringInterpolation node) => new StringInterpolation(cloneNodeList(node.elements));
+
+ @override
+ SuperConstructorInvocation visitSuperConstructorInvocation(SuperConstructorInvocation node) => new SuperConstructorInvocation(node.keyword, node.period, cloneNode(node.constructorName), cloneNode(node.argumentList));
+
+ @override
+ SuperExpression visitSuperExpression(SuperExpression node) => new SuperExpression(node.keyword);
+
+ @override
+ SwitchCase visitSwitchCase(SwitchCase node) => new SwitchCase(cloneNodeList(node.labels), node.keyword, cloneNode(node.expression), node.colon, cloneNodeList(node.statements));
+
+ @override
+ SwitchDefault visitSwitchDefault(SwitchDefault node) => new SwitchDefault(cloneNodeList(node.labels), node.keyword, node.colon, cloneNodeList(node.statements));
+
+ @override
+ SwitchStatement visitSwitchStatement(SwitchStatement node) => new SwitchStatement(node.keyword, node.leftParenthesis, cloneNode(node.expression), node.rightParenthesis, node.leftBracket, cloneNodeList(node.members), node.rightBracket);
+
+ @override
+ SymbolLiteral visitSymbolLiteral(SymbolLiteral node) => new SymbolLiteral(node.poundSign, node.components);
+
+ @override
+ ThisExpression visitThisExpression(ThisExpression node) => new ThisExpression(node.keyword);
+
+ @override
+ ThrowExpression visitThrowExpression(ThrowExpression node) => new ThrowExpression(node.keyword, cloneNode(node.expression));
+
+ @override
+ TopLevelVariableDeclaration visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node) => new TopLevelVariableDeclaration(cloneNode(node.documentationComment), cloneNodeList(node.metadata), cloneNode(node.variables), node.semicolon);
+
+ @override
+ TryStatement visitTryStatement(TryStatement node) => new TryStatement(node.tryKeyword, cloneNode(node.body), cloneNodeList(node.catchClauses), node.finallyKeyword, cloneNode(node.finallyBlock));
+
+ @override
+ TypeArgumentList visitTypeArgumentList(TypeArgumentList node) => new TypeArgumentList(node.leftBracket, cloneNodeList(node.arguments), node.rightBracket);
+
+ @override
+ TypeName visitTypeName(TypeName node) => new TypeName(cloneNode(node.name), cloneNode(node.typeArguments));
+
+ @override
+ TypeParameter visitTypeParameter(TypeParameter node) => new TypeParameter(cloneNode(node.documentationComment), cloneNodeList(node.metadata), cloneNode(node.name), node.keyword, cloneNode(node.bound));
+
+ @override
+ TypeParameterList visitTypeParameterList(TypeParameterList node) => new TypeParameterList(node.leftBracket, cloneNodeList(node.typeParameters), node.rightBracket);
+
+ @override
+ VariableDeclaration visitVariableDeclaration(VariableDeclaration node) => new VariableDeclaration(null, cloneNodeList(node.metadata), cloneNode(node.name), node.equals, cloneNode(node.initializer));
+
+ @override
+ VariableDeclarationList visitVariableDeclarationList(VariableDeclarationList node) => new VariableDeclarationList(null, cloneNodeList(node.metadata), node.keyword, cloneNode(node.type), cloneNodeList(node.variables));
+
+ @override
+ VariableDeclarationStatement visitVariableDeclarationStatement(VariableDeclarationStatement node) => new VariableDeclarationStatement(cloneNode(node.variables), node.semicolon);
+
+ @override
+ WhileStatement visitWhileStatement(WhileStatement node) => new WhileStatement(node.keyword, node.leftParenthesis, cloneNode(node.condition), node.rightParenthesis, cloneNode(node.body));
+
+ @override
+ WithClause visitWithClause(WithClause node) => new WithClause(node.withKeyword, cloneNodeList(node.mixinTypes));
+
+ @override
+ YieldStatement visitYieldStatement(YieldStatement node) => new YieldStatement(node.yieldKeyword, node.star, node.expression, node.semicolon);
+
+ AstNode cloneNode(AstNode node) {
+ if (node == null) {
+ return null;
+ }
+ return node.accept(this) as AstNode;
+ }
+}
+
+/**
+ * Instances of the class `AstComparator` compare the structure of two ASTNodes to see whether
+ * they are equal.
+ */
+class AstComparator implements AstVisitor<bool> {
+ /**
+ * Return `true` if the two AST nodes are equal.
+ *
+ * @param first the first node being compared
+ * @param second the second node being compared
+ * @return `true` if the two AST nodes are equal
+ */
+ static bool equalNodes(AstNode first, AstNode second) {
+ AstComparator comparator = new AstComparator();
+ return comparator._isEqualNodes(first, second);
+ }
+
+ /**
+ * The AST node with which the node being visited is to be compared. This is only valid at the
+ * beginning of each visit method (until [isEqualNodes] is invoked).
+ */
+ AstNode _other;
+
+ @override
+ bool visitAdjacentStrings(AdjacentStrings node) {
+ AdjacentStrings other = this._other as AdjacentStrings;
+ return _isEqualNodeLists(node.strings, other.strings);
+ }
+
+ @override
+ bool visitAnnotation(Annotation node) {
+ Annotation other = this._other as Annotation;
+ return _isEqualTokens(node.atSign, other.atSign) && _isEqualNodes(node.name, other.name) && _isEqualTokens(node.period, other.period) && _isEqualNodes(node.constructorName, other.constructorName) && _isEqualNodes(node.arguments, other.arguments);
+ }
+
+ @override
+ bool visitArgumentList(ArgumentList node) {
+ ArgumentList other = this._other as ArgumentList;
+ return _isEqualTokens(node.leftParenthesis, other.leftParenthesis) && _isEqualNodeLists(node.arguments, other.arguments) && _isEqualTokens(node.rightParenthesis, other.rightParenthesis);
+ }
+
+ @override
+ bool visitAsExpression(AsExpression node) {
+ AsExpression other = this._other as AsExpression;
+ return _isEqualNodes(node.expression, other.expression) && _isEqualTokens(node.asOperator, other.asOperator) && _isEqualNodes(node.type, other.type);
+ }
+
+ @override
+ bool visitAssertStatement(AssertStatement node) {
+ AssertStatement other = this._other as AssertStatement;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualTokens(node.leftParenthesis, other.leftParenthesis) && _isEqualNodes(node.condition, other.condition) && _isEqualTokens(node.rightParenthesis, other.rightParenthesis) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitAssignmentExpression(AssignmentExpression node) {
+ AssignmentExpression other = this._other as AssignmentExpression;
+ return _isEqualNodes(node.leftHandSide, other.leftHandSide) && _isEqualTokens(node.operator, other.operator) && _isEqualNodes(node.rightHandSide, other.rightHandSide);
+ }
+
+ @override
+ bool visitAwaitExpression(AwaitExpression node) {
+ AwaitExpression other = this._other as AwaitExpression;
+ return _isEqualTokens(node.awaitKeyword, other.awaitKeyword) && _isEqualNodes(node.expression, other.expression);
+ }
+
+ @override
+ bool visitBinaryExpression(BinaryExpression node) {
+ BinaryExpression other = this._other as BinaryExpression;
+ return _isEqualNodes(node.leftOperand, other.leftOperand) && _isEqualTokens(node.operator, other.operator) && _isEqualNodes(node.rightOperand, other.rightOperand);
+ }
+
+ @override
+ bool visitBlock(Block node) {
+ Block other = this._other as Block;
+ return _isEqualTokens(node.leftBracket, other.leftBracket) && _isEqualNodeLists(node.statements, other.statements) && _isEqualTokens(node.rightBracket, other.rightBracket);
+ }
+
+ @override
+ bool visitBlockFunctionBody(BlockFunctionBody node) {
+ BlockFunctionBody other = this._other as BlockFunctionBody;
+ return _isEqualNodes(node.block, other.block);
+ }
+
+ @override
+ bool visitBooleanLiteral(BooleanLiteral node) {
+ BooleanLiteral other = this._other as BooleanLiteral;
+ return _isEqualTokens(node.literal, other.literal) && node.value == other.value;
+ }
+
+ @override
+ bool visitBreakStatement(BreakStatement node) {
+ BreakStatement other = this._other as BreakStatement;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.label, other.label) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitCascadeExpression(CascadeExpression node) {
+ CascadeExpression other = this._other as CascadeExpression;
+ return _isEqualNodes(node.target, other.target) && _isEqualNodeLists(node.cascadeSections, other.cascadeSections);
+ }
+
+ @override
+ bool visitCatchClause(CatchClause node) {
+ CatchClause other = this._other as CatchClause;
+ return _isEqualTokens(node.onKeyword, other.onKeyword) && _isEqualNodes(node.exceptionType, other.exceptionType) && _isEqualTokens(node.catchKeyword, other.catchKeyword) && _isEqualTokens(node.leftParenthesis, other.leftParenthesis) && _isEqualNodes(node.exceptionParameter, other.exceptionParameter) && _isEqualTokens(node.comma, other.comma) && _isEqualNodes(node.stackTraceParameter, other.stackTraceParameter) && _isEqualTokens(node.rightParenthesis, other.rightParenthesis) && _isEqualNodes(node.body, other.body);
+ }
+
+ @override
+ bool visitClassDeclaration(ClassDeclaration node) {
+ ClassDeclaration other = this._other as ClassDeclaration;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.abstractKeyword, other.abstractKeyword) && _isEqualTokens(node.classKeyword, other.classKeyword) && _isEqualNodes(node.name, other.name) && _isEqualNodes(node.typeParameters, other.typeParameters) && _isEqualNodes(node.extendsClause, other.extendsClause) && _isEqualNodes(node.withClause, other.withClause) && _isEqualNodes(node.implementsClause, other.implementsClause) && _isEqualTokens(node.leftBracket, other.leftBracket) && _isEqualNodeLists(node.members, other.members) && _isEqualTokens(node.rightBracket, other.rightBracket);
+ }
+
+ @override
+ bool visitClassTypeAlias(ClassTypeAlias node) {
+ ClassTypeAlias other = this._other as ClassTypeAlias;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.name, other.name) && _isEqualNodes(node.typeParameters, other.typeParameters) && _isEqualTokens(node.equals, other.equals) && _isEqualTokens(node.abstractKeyword, other.abstractKeyword) && _isEqualNodes(node.superclass, other.superclass) && _isEqualNodes(node.withClause, other.withClause) && _isEqualNodes(node.implementsClause, other.implementsClause) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitComment(Comment node) {
+ Comment other = this._other as Comment;
+ return _isEqualNodeLists(node.references, other.references);
+ }
+
+ @override
+ bool visitCommentReference(CommentReference node) {
+ CommentReference other = this._other as CommentReference;
+ return _isEqualTokens(node.newKeyword, other.newKeyword) && _isEqualNodes(node.identifier, other.identifier);
+ }
+
+ @override
+ bool visitCompilationUnit(CompilationUnit node) {
+ CompilationUnit other = this._other as CompilationUnit;
+ return _isEqualTokens(node.beginToken, other.beginToken) && _isEqualNodes(node.scriptTag, other.scriptTag) && _isEqualNodeLists(node.directives, other.directives) && _isEqualNodeLists(node.declarations, other.declarations) && _isEqualTokens(node.endToken, other.endToken);
+ }
+
+ @override
+ bool visitConditionalExpression(ConditionalExpression node) {
+ ConditionalExpression other = this._other as ConditionalExpression;
+ return _isEqualNodes(node.condition, other.condition) && _isEqualTokens(node.question, other.question) && _isEqualNodes(node.thenExpression, other.thenExpression) && _isEqualTokens(node.colon, other.colon) && _isEqualNodes(node.elseExpression, other.elseExpression);
+ }
+
+ @override
+ bool visitConstructorDeclaration(ConstructorDeclaration node) {
+ ConstructorDeclaration other = this._other as ConstructorDeclaration;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.externalKeyword, other.externalKeyword) && _isEqualTokens(node.constKeyword, other.constKeyword) && _isEqualTokens(node.factoryKeyword, other.factoryKeyword) && _isEqualNodes(node.returnType, other.returnType) && _isEqualTokens(node.period, other.period) && _isEqualNodes(node.name, other.name) && _isEqualNodes(node.parameters, other.parameters) && _isEqualTokens(node.separator, other.separator) && _isEqualNodeLists(node.initializers, other.initializers) && _isEqualNodes(node.redirectedConstructor, other.redirectedConstructor) && _isEqualNodes(node.body, other.body);
+ }
+
+ @override
+ bool visitConstructorFieldInitializer(ConstructorFieldInitializer node) {
+ ConstructorFieldInitializer other = this._other as ConstructorFieldInitializer;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualTokens(node.period, other.period) && _isEqualNodes(node.fieldName, other.fieldName) && _isEqualTokens(node.equals, other.equals) && _isEqualNodes(node.expression, other.expression);
+ }
+
+ @override
+ bool visitConstructorName(ConstructorName node) {
+ ConstructorName other = this._other as ConstructorName;
+ return _isEqualNodes(node.type, other.type) && _isEqualTokens(node.period, other.period) && _isEqualNodes(node.name, other.name);
+ }
+
+ @override
+ bool visitContinueStatement(ContinueStatement node) {
+ ContinueStatement other = this._other as ContinueStatement;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.label, other.label) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitDeclaredIdentifier(DeclaredIdentifier node) {
+ DeclaredIdentifier other = this._other as DeclaredIdentifier;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.type, other.type) && _isEqualNodes(node.identifier, other.identifier);
+ }
+
+ @override
+ bool visitDefaultFormalParameter(DefaultFormalParameter node) {
+ DefaultFormalParameter other = this._other as DefaultFormalParameter;
+ return _isEqualNodes(node.parameter, other.parameter) && node.kind == other.kind && _isEqualTokens(node.separator, other.separator) && _isEqualNodes(node.defaultValue, other.defaultValue);
+ }
+
+ @override
+ bool visitDoStatement(DoStatement node) {
+ DoStatement other = this._other as DoStatement;
+ return _isEqualTokens(node.doKeyword, other.doKeyword) && _isEqualNodes(node.body, other.body) && _isEqualTokens(node.whileKeyword, other.whileKeyword) && _isEqualTokens(node.leftParenthesis, other.leftParenthesis) && _isEqualNodes(node.condition, other.condition) && _isEqualTokens(node.rightParenthesis, other.rightParenthesis) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitDoubleLiteral(DoubleLiteral node) {
+ DoubleLiteral other = this._other as DoubleLiteral;
+ return _isEqualTokens(node.literal, other.literal) && node.value == other.value;
+ }
+
+ @override
+ bool visitEmptyFunctionBody(EmptyFunctionBody node) {
+ EmptyFunctionBody other = this._other as EmptyFunctionBody;
+ return _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitEmptyStatement(EmptyStatement node) {
+ EmptyStatement other = this._other as EmptyStatement;
+ return _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitEnumConstantDeclaration(EnumConstantDeclaration node) {
+ EnumConstantDeclaration other = this._other as EnumConstantDeclaration;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualNodes(node.name, other.name);
+ }
+
+ @override
+ bool visitEnumDeclaration(EnumDeclaration node) {
+ EnumDeclaration other = this._other as EnumDeclaration;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.name, other.name) && _isEqualTokens(node.leftBracket, other.leftBracket) && _isEqualNodeLists(node.constants, other.constants) && _isEqualTokens(node.rightBracket, other.rightBracket);
+ }
+
+ @override
+ bool visitExportDirective(ExportDirective node) {
+ ExportDirective other = this._other as ExportDirective;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.uri, other.uri) && _isEqualNodeLists(node.combinators, other.combinators) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitExpressionFunctionBody(ExpressionFunctionBody node) {
+ ExpressionFunctionBody other = this._other as ExpressionFunctionBody;
+ return _isEqualTokens(node.functionDefinition, other.functionDefinition) && _isEqualNodes(node.expression, other.expression) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitExpressionStatement(ExpressionStatement node) {
+ ExpressionStatement other = this._other as ExpressionStatement;
+ return _isEqualNodes(node.expression, other.expression) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitExtendsClause(ExtendsClause node) {
+ ExtendsClause other = this._other as ExtendsClause;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.superclass, other.superclass);
+ }
+
+ @override
+ bool visitFieldDeclaration(FieldDeclaration node) {
+ FieldDeclaration other = this._other as FieldDeclaration;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.staticKeyword, other.staticKeyword) && _isEqualNodes(node.fields, other.fields) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitFieldFormalParameter(FieldFormalParameter node) {
+ FieldFormalParameter other = this._other as FieldFormalParameter;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.type, other.type) && _isEqualTokens(node.thisToken, other.thisToken) && _isEqualTokens(node.period, other.period) && _isEqualNodes(node.identifier, other.identifier);
+ }
+
+ @override
+ bool visitForEachStatement(ForEachStatement node) {
+ ForEachStatement other = this._other as ForEachStatement;
+ return _isEqualTokens(node.forKeyword, other.forKeyword) && _isEqualTokens(node.leftParenthesis, other.leftParenthesis) && _isEqualNodes(node.loopVariable, other.loopVariable) && _isEqualTokens(node.inKeyword, other.inKeyword) && _isEqualNodes(node.iterator, other.iterator) && _isEqualTokens(node.rightParenthesis, other.rightParenthesis) && _isEqualNodes(node.body, other.body);
+ }
+
+ @override
+ bool visitFormalParameterList(FormalParameterList node) {
+ FormalParameterList other = this._other as FormalParameterList;
+ return _isEqualTokens(node.leftParenthesis, other.leftParenthesis) && _isEqualNodeLists(node.parameters, other.parameters) && _isEqualTokens(node.leftDelimiter, other.leftDelimiter) && _isEqualTokens(node.rightDelimiter, other.rightDelimiter) && _isEqualTokens(node.rightParenthesis, other.rightParenthesis);
+ }
+
+ @override
+ bool visitForStatement(ForStatement node) {
+ ForStatement other = this._other as ForStatement;
+ return _isEqualTokens(node.forKeyword, other.forKeyword) && _isEqualTokens(node.leftParenthesis, other.leftParenthesis) && _isEqualNodes(node.variables, other.variables) && _isEqualNodes(node.initialization, other.initialization) && _isEqualTokens(node.leftSeparator, other.leftSeparator) && _isEqualNodes(node.condition, other.condition) && _isEqualTokens(node.rightSeparator, other.rightSeparator) && _isEqualNodeLists(node.updaters, other.updaters) && _isEqualTokens(node.rightParenthesis, other.rightParenthesis) && _isEqualNodes(node.body, other.body);
+ }
+
+ @override
+ bool visitFunctionDeclaration(FunctionDeclaration node) {
+ FunctionDeclaration other = this._other as FunctionDeclaration;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.externalKeyword, other.externalKeyword) && _isEqualNodes(node.returnType, other.returnType) && _isEqualTokens(node.propertyKeyword, other.propertyKeyword) && _isEqualNodes(node.name, other.name) && _isEqualNodes(node.functionExpression, other.functionExpression);
+ }
+
+ @override
+ bool visitFunctionDeclarationStatement(FunctionDeclarationStatement node) {
+ FunctionDeclarationStatement other = this._other as FunctionDeclarationStatement;
+ return _isEqualNodes(node.functionDeclaration, other.functionDeclaration);
+ }
+
+ @override
+ bool visitFunctionExpression(FunctionExpression node) {
+ FunctionExpression other = this._other as FunctionExpression;
+ return _isEqualNodes(node.parameters, other.parameters) && _isEqualNodes(node.body, other.body);
+ }
+
+ @override
+ bool visitFunctionExpressionInvocation(FunctionExpressionInvocation node) {
+ FunctionExpressionInvocation other = this._other as FunctionExpressionInvocation;
+ return _isEqualNodes(node.function, other.function) && _isEqualNodes(node.argumentList, other.argumentList);
+ }
+
+ @override
+ bool visitFunctionTypeAlias(FunctionTypeAlias node) {
+ FunctionTypeAlias other = this._other as FunctionTypeAlias;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.returnType, other.returnType) && _isEqualNodes(node.name, other.name) && _isEqualNodes(node.typeParameters, other.typeParameters) && _isEqualNodes(node.parameters, other.parameters) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitFunctionTypedFormalParameter(FunctionTypedFormalParameter node) {
+ FunctionTypedFormalParameter other = this._other as FunctionTypedFormalParameter;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualNodes(node.returnType, other.returnType) && _isEqualNodes(node.identifier, other.identifier) && _isEqualNodes(node.parameters, other.parameters);
+ }
+
+ @override
+ bool visitHideCombinator(HideCombinator node) {
+ HideCombinator other = this._other as HideCombinator;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualNodeLists(node.hiddenNames, other.hiddenNames);
+ }
+
+ @override
+ bool visitIfStatement(IfStatement node) {
+ IfStatement other = this._other as IfStatement;
+ return _isEqualTokens(node.ifKeyword, other.ifKeyword) && _isEqualTokens(node.leftParenthesis, other.leftParenthesis) && _isEqualNodes(node.condition, other.condition) && _isEqualTokens(node.rightParenthesis, other.rightParenthesis) && _isEqualNodes(node.thenStatement, other.thenStatement) && _isEqualTokens(node.elseKeyword, other.elseKeyword) && _isEqualNodes(node.elseStatement, other.elseStatement);
+ }
+
+ @override
+ bool visitImplementsClause(ImplementsClause node) {
+ ImplementsClause other = this._other as ImplementsClause;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualNodeLists(node.interfaces, other.interfaces);
+ }
+
+ @override
+ bool visitImportDirective(ImportDirective node) {
+ ImportDirective other = this._other as ImportDirective;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.uri, other.uri) && _isEqualTokens(node.asToken, other.asToken) && _isEqualNodes(node.prefix, other.prefix) && _isEqualNodeLists(node.combinators, other.combinators) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitIndexExpression(IndexExpression node) {
+ IndexExpression other = this._other as IndexExpression;
+ return _isEqualNodes(node.target, other.target) && _isEqualTokens(node.leftBracket, other.leftBracket) && _isEqualNodes(node.index, other.index) && _isEqualTokens(node.rightBracket, other.rightBracket);
+ }
+
+ @override
+ bool visitInstanceCreationExpression(InstanceCreationExpression node) {
+ InstanceCreationExpression other = this._other as InstanceCreationExpression;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.constructorName, other.constructorName) && _isEqualNodes(node.argumentList, other.argumentList);
+ }
+
+ @override
+ bool visitIntegerLiteral(IntegerLiteral node) {
+ IntegerLiteral other = this._other as IntegerLiteral;
+ return _isEqualTokens(node.literal, other.literal) && (node.value == other.value);
+ }
+
+ @override
+ bool visitInterpolationExpression(InterpolationExpression node) {
+ InterpolationExpression other = this._other as InterpolationExpression;
+ return _isEqualTokens(node.leftBracket, other.leftBracket) && _isEqualNodes(node.expression, other.expression) && _isEqualTokens(node.rightBracket, other.rightBracket);
+ }
+
+ @override
+ bool visitInterpolationString(InterpolationString node) {
+ InterpolationString other = this._other as InterpolationString;
+ return _isEqualTokens(node.contents, other.contents) && node.value == other.value;
+ }
+
+ @override
+ bool visitIsExpression(IsExpression node) {
+ IsExpression other = this._other as IsExpression;
+ return _isEqualNodes(node.expression, other.expression) && _isEqualTokens(node.isOperator, other.isOperator) && _isEqualTokens(node.notOperator, other.notOperator) && _isEqualNodes(node.type, other.type);
+ }
+
+ @override
+ bool visitLabel(Label node) {
+ Label other = this._other as Label;
+ return _isEqualNodes(node.label, other.label) && _isEqualTokens(node.colon, other.colon);
+ }
+
+ @override
+ bool visitLabeledStatement(LabeledStatement node) {
+ LabeledStatement other = this._other as LabeledStatement;
+ return _isEqualNodeLists(node.labels, other.labels) && _isEqualNodes(node.statement, other.statement);
+ }
+
+ @override
+ bool visitLibraryDirective(LibraryDirective node) {
+ LibraryDirective other = this._other as LibraryDirective;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.libraryToken, other.libraryToken) && _isEqualNodes(node.name, other.name) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitLibraryIdentifier(LibraryIdentifier node) {
+ LibraryIdentifier other = this._other as LibraryIdentifier;
+ return _isEqualNodeLists(node.components, other.components);
+ }
+
+ @override
+ bool visitListLiteral(ListLiteral node) {
+ ListLiteral other = this._other as ListLiteral;
+ return _isEqualTokens(node.constKeyword, other.constKeyword) && _isEqualNodes(node.typeArguments, other.typeArguments) && _isEqualTokens(node.leftBracket, other.leftBracket) && _isEqualNodeLists(node.elements, other.elements) && _isEqualTokens(node.rightBracket, other.rightBracket);
+ }
+
+ @override
+ bool visitMapLiteral(MapLiteral node) {
+ MapLiteral other = this._other as MapLiteral;
+ return _isEqualTokens(node.constKeyword, other.constKeyword) && _isEqualNodes(node.typeArguments, other.typeArguments) && _isEqualTokens(node.leftBracket, other.leftBracket) && _isEqualNodeLists(node.entries, other.entries) && _isEqualTokens(node.rightBracket, other.rightBracket);
+ }
+
+ @override
+ bool visitMapLiteralEntry(MapLiteralEntry node) {
+ MapLiteralEntry other = this._other as MapLiteralEntry;
+ return _isEqualNodes(node.key, other.key) && _isEqualTokens(node.separator, other.separator) && _isEqualNodes(node.value, other.value);
+ }
+
+ @override
+ bool visitMethodDeclaration(MethodDeclaration node) {
+ MethodDeclaration other = this._other as MethodDeclaration;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.externalKeyword, other.externalKeyword) && _isEqualTokens(node.modifierKeyword, other.modifierKeyword) && _isEqualNodes(node.returnType, other.returnType) && _isEqualTokens(node.propertyKeyword, other.propertyKeyword) && _isEqualTokens(node.propertyKeyword, other.propertyKeyword) && _isEqualNodes(node.name, other.name) && _isEqualNodes(node.parameters, other.parameters) && _isEqualNodes(node.body, other.body);
+ }
+
+ @override
+ bool visitMethodInvocation(MethodInvocation node) {
+ MethodInvocation other = this._other as MethodInvocation;
+ return _isEqualNodes(node.target, other.target) && _isEqualTokens(node.period, other.period) && _isEqualNodes(node.methodName, other.methodName) && _isEqualNodes(node.argumentList, other.argumentList);
+ }
+
+ @override
+ bool visitNamedExpression(NamedExpression node) {
+ NamedExpression other = this._other as NamedExpression;
+ return _isEqualNodes(node.name, other.name) && _isEqualNodes(node.expression, other.expression);
+ }
+
+ @override
+ bool visitNativeClause(NativeClause node) {
+ NativeClause other = this._other as NativeClause;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.name, other.name);
+ }
+
+ @override
+ bool visitNativeFunctionBody(NativeFunctionBody node) {
+ NativeFunctionBody other = this._other as NativeFunctionBody;
+ return _isEqualTokens(node.nativeToken, other.nativeToken) && _isEqualNodes(node.stringLiteral, other.stringLiteral) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitNullLiteral(NullLiteral node) {
+ NullLiteral other = this._other as NullLiteral;
+ return _isEqualTokens(node.literal, other.literal);
+ }
+
+ @override
+ bool visitParenthesizedExpression(ParenthesizedExpression node) {
+ ParenthesizedExpression other = this._other as ParenthesizedExpression;
+ return _isEqualTokens(node.leftParenthesis, other.leftParenthesis) && _isEqualNodes(node.expression, other.expression) && _isEqualTokens(node.rightParenthesis, other.rightParenthesis);
+ }
+
+ @override
+ bool visitPartDirective(PartDirective node) {
+ PartDirective other = this._other as PartDirective;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.partToken, other.partToken) && _isEqualNodes(node.uri, other.uri) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitPartOfDirective(PartOfDirective node) {
+ PartOfDirective other = this._other as PartOfDirective;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.partToken, other.partToken) && _isEqualTokens(node.ofToken, other.ofToken) && _isEqualNodes(node.libraryName, other.libraryName) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitPostfixExpression(PostfixExpression node) {
+ PostfixExpression other = this._other as PostfixExpression;
+ return _isEqualNodes(node.operand, other.operand) && _isEqualTokens(node.operator, other.operator);
+ }
+
+ @override
+ bool visitPrefixedIdentifier(PrefixedIdentifier node) {
+ PrefixedIdentifier other = this._other as PrefixedIdentifier;
+ return _isEqualNodes(node.prefix, other.prefix) && _isEqualTokens(node.period, other.period) && _isEqualNodes(node.identifier, other.identifier);
+ }
+
+ @override
+ bool visitPrefixExpression(PrefixExpression node) {
+ PrefixExpression other = this._other as PrefixExpression;
+ return _isEqualTokens(node.operator, other.operator) && _isEqualNodes(node.operand, other.operand);
+ }
+
+ @override
+ bool visitPropertyAccess(PropertyAccess node) {
+ PropertyAccess other = this._other as PropertyAccess;
+ return _isEqualNodes(node.target, other.target) && _isEqualTokens(node.operator, other.operator) && _isEqualNodes(node.propertyName, other.propertyName);
+ }
+
+ @override
+ bool visitRedirectingConstructorInvocation(RedirectingConstructorInvocation node) {
+ RedirectingConstructorInvocation other = this._other as RedirectingConstructorInvocation;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualTokens(node.period, other.period) && _isEqualNodes(node.constructorName, other.constructorName) && _isEqualNodes(node.argumentList, other.argumentList);
+ }
+
+ @override
+ bool visitRethrowExpression(RethrowExpression node) {
+ RethrowExpression other = this._other as RethrowExpression;
+ return _isEqualTokens(node.keyword, other.keyword);
+ }
+
+ @override
+ bool visitReturnStatement(ReturnStatement node) {
+ ReturnStatement other = this._other as ReturnStatement;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.expression, other.expression) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitScriptTag(ScriptTag node) {
+ ScriptTag other = this._other as ScriptTag;
+ return _isEqualTokens(node.scriptTag, other.scriptTag);
+ }
+
+ @override
+ bool visitShowCombinator(ShowCombinator node) {
+ ShowCombinator other = this._other as ShowCombinator;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualNodeLists(node.shownNames, other.shownNames);
+ }
+
+ @override
+ bool visitSimpleFormalParameter(SimpleFormalParameter node) {
+ SimpleFormalParameter other = this._other as SimpleFormalParameter;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.type, other.type) && _isEqualNodes(node.identifier, other.identifier);
+ }
+
+ @override
+ bool visitSimpleIdentifier(SimpleIdentifier node) {
+ SimpleIdentifier other = this._other as SimpleIdentifier;
+ return _isEqualTokens(node.token, other.token);
+ }
+
+ @override
+ bool visitSimpleStringLiteral(SimpleStringLiteral node) {
+ SimpleStringLiteral other = this._other as SimpleStringLiteral;
+ return _isEqualTokens(node.literal, other.literal) && (node.value == other.value);
+ }
+
+ @override
+ bool visitStringInterpolation(StringInterpolation node) {
+ StringInterpolation other = this._other as StringInterpolation;
+ return _isEqualNodeLists(node.elements, other.elements);
+ }
+
+ @override
+ bool visitSuperConstructorInvocation(SuperConstructorInvocation node) {
+ SuperConstructorInvocation other = this._other as SuperConstructorInvocation;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualTokens(node.period, other.period) && _isEqualNodes(node.constructorName, other.constructorName) && _isEqualNodes(node.argumentList, other.argumentList);
+ }
+
+ @override
+ bool visitSuperExpression(SuperExpression node) {
+ SuperExpression other = this._other as SuperExpression;
+ return _isEqualTokens(node.keyword, other.keyword);
+ }
+
+ @override
+ bool visitSwitchCase(SwitchCase node) {
+ SwitchCase other = this._other as SwitchCase;
+ return _isEqualNodeLists(node.labels, other.labels) && _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.expression, other.expression) && _isEqualTokens(node.colon, other.colon) && _isEqualNodeLists(node.statements, other.statements);
+ }
+
+ @override
+ bool visitSwitchDefault(SwitchDefault node) {
+ SwitchDefault other = this._other as SwitchDefault;
+ return _isEqualNodeLists(node.labels, other.labels) && _isEqualTokens(node.keyword, other.keyword) && _isEqualTokens(node.colon, other.colon) && _isEqualNodeLists(node.statements, other.statements);
+ }
+
+ @override
+ bool visitSwitchStatement(SwitchStatement node) {
+ SwitchStatement other = this._other as SwitchStatement;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualTokens(node.leftParenthesis, other.leftParenthesis) && _isEqualNodes(node.expression, other.expression) && _isEqualTokens(node.rightParenthesis, other.rightParenthesis) && _isEqualTokens(node.leftBracket, other.leftBracket) && _isEqualNodeLists(node.members, other.members) && _isEqualTokens(node.rightBracket, other.rightBracket);
+ }
+
+ @override
+ bool visitSymbolLiteral(SymbolLiteral node) {
+ SymbolLiteral other = this._other as SymbolLiteral;
+ return _isEqualTokens(node.poundSign, other.poundSign) && _isEqualTokenLists(node.components, other.components);
+ }
+
+ @override
+ bool visitThisExpression(ThisExpression node) {
+ ThisExpression other = this._other as ThisExpression;
+ return _isEqualTokens(node.keyword, other.keyword);
+ }
+
+ @override
+ bool visitThrowExpression(ThrowExpression node) {
+ ThrowExpression other = this._other as ThrowExpression;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.expression, other.expression);
+ }
+
+ @override
+ bool visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node) {
+ TopLevelVariableDeclaration other = this._other as TopLevelVariableDeclaration;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualNodes(node.variables, other.variables) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitTryStatement(TryStatement node) {
+ TryStatement other = this._other as TryStatement;
+ return _isEqualTokens(node.tryKeyword, other.tryKeyword) && _isEqualNodes(node.body, other.body) && _isEqualNodeLists(node.catchClauses, other.catchClauses) && _isEqualTokens(node.finallyKeyword, other.finallyKeyword) && _isEqualNodes(node.finallyBlock, other.finallyBlock);
+ }
+
+ @override
+ bool visitTypeArgumentList(TypeArgumentList node) {
+ TypeArgumentList other = this._other as TypeArgumentList;
+ return _isEqualTokens(node.leftBracket, other.leftBracket) && _isEqualNodeLists(node.arguments, other.arguments) && _isEqualTokens(node.rightBracket, other.rightBracket);
+ }
+
+ @override
+ bool visitTypeName(TypeName node) {
+ TypeName other = this._other as TypeName;
+ return _isEqualNodes(node.name, other.name) && _isEqualNodes(node.typeArguments, other.typeArguments);
+ }
+
+ @override
+ bool visitTypeParameter(TypeParameter node) {
+ TypeParameter other = this._other as TypeParameter;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualNodes(node.name, other.name) && _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.bound, other.bound);
+ }
+
+ @override
+ bool visitTypeParameterList(TypeParameterList node) {
+ TypeParameterList other = this._other as TypeParameterList;
+ return _isEqualTokens(node.leftBracket, other.leftBracket) && _isEqualNodeLists(node.typeParameters, other.typeParameters) && _isEqualTokens(node.rightBracket, other.rightBracket);
+ }
+
+ @override
+ bool visitVariableDeclaration(VariableDeclaration node) {
+ VariableDeclaration other = this._other as VariableDeclaration;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualNodes(node.name, other.name) && _isEqualTokens(node.equals, other.equals) && _isEqualNodes(node.initializer, other.initializer);
+ }
+
+ @override
+ bool visitVariableDeclarationList(VariableDeclarationList node) {
+ VariableDeclarationList other = this._other as VariableDeclarationList;
+ return _isEqualNodes(node.documentationComment, other.documentationComment) && _isEqualNodeLists(node.metadata, other.metadata) && _isEqualTokens(node.keyword, other.keyword) && _isEqualNodes(node.type, other.type) && _isEqualNodeLists(node.variables, other.variables);
+ }
+
+ @override
+ bool visitVariableDeclarationStatement(VariableDeclarationStatement node) {
+ VariableDeclarationStatement other = this._other as VariableDeclarationStatement;
+ return _isEqualNodes(node.variables, other.variables) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ @override
+ bool visitWhileStatement(WhileStatement node) {
+ WhileStatement other = this._other as WhileStatement;
+ return _isEqualTokens(node.keyword, other.keyword) && _isEqualTokens(node.leftParenthesis, other.leftParenthesis) && _isEqualNodes(node.condition, other.condition) && _isEqualTokens(node.rightParenthesis, other.rightParenthesis) && _isEqualNodes(node.body, other.body);
+ }
+
+ @override
+ bool visitWithClause(WithClause node) {
+ WithClause other = this._other as WithClause;
+ return _isEqualTokens(node.withKeyword, other.withKeyword) && _isEqualNodeLists(node.mixinTypes, other.mixinTypes);
+ }
+
+ @override
+ bool visitYieldStatement(YieldStatement node) {
+ YieldStatement other = this._other as YieldStatement;
+ return _isEqualTokens(node.yieldKeyword, other.yieldKeyword) && _isEqualNodes(node.expression, other.expression) && _isEqualTokens(node.semicolon, other.semicolon);
+ }
+
+ /**
+ * Return `true` if the given lists of AST nodes have the same size and corresponding
+ * elements are equal.
+ *
+ * @param first the first node being compared
+ * @param second the second node being compared
+ * @return `true` if the given AST nodes have the same size and corresponding elements are
+ * equal
+ */
+ bool _isEqualNodeLists(NodeList first, NodeList second) {
+ if (first == null) {
+ return second == null;
+ } else if (second == null) {
+ return false;
+ }
+ int size = first.length;
+ if (second.length != size) {
+ return false;
+ }
+ for (int i = 0; i < size; i++) {
+ if (!_isEqualNodes(first[i], second[i])) {
+ return false;
+ }
+ }
+ return true;
+ }
+
+ /**
+ * Return `true` if the given AST nodes have the same structure.
+ *
+ * @param first the first node being compared
+ * @param second the second node being compared
+ * @return `true` if the given AST nodes have the same structure
+ */
+ bool _isEqualNodes(AstNode first, AstNode second) {
+ if (first == null) {
+ return second == null;
+ } else if (second == null) {
+ return false;
+ } else if (first.runtimeType != second.runtimeType) {
+ return false;
+ }
+ _other = second;
+ return first.accept(this);
+ }
+
+ /**
+ * Return `true` if the given arrays of tokens have the same length and corresponding
+ * elements are equal.
+ *
+ * @param first the first node being compared
+ * @param second the second node being compared
+ * @return `true` if the given arrays of tokens have the same length and corresponding
+ * elements are equal
+ */
+ bool _isEqualTokenLists(List<Token> first, List<Token> second) {
+ int length = first.length;
+ if (second.length != length) {
+ return false;
+ }
+ for (int i = 0; i < length; i++) {
+ if (!_isEqualTokens(first[i], second[i])) {
+ return false;
+ }
+ }
+ return true;
+ }
+
+ /**
+ * Return `true` if the given tokens have the same structure.
+ *
+ * @param first the first node being compared
+ * @param second the second node being compared
+ * @return `true` if the given tokens have the same structure
+ */
+ bool _isEqualTokens(Token first, Token second) {
+ if (first == null) {
+ return second == null;
+ } else if (second == null) {
+ return false;
+ } else if (identical(first, second)) {
+ return true;
+ }
+ return first.offset == second.offset && first.length == second.length && first.lexeme == second.lexeme;
+ }
+}
+
+/**
+ * The abstract class `AstNode` defines the behavior common to all nodes in the AST structure
+ * for a Dart program.
+ */
+abstract class AstNode {
+ /**
+ * An empty array of ast nodes.
+ */
+ static List<AstNode> EMPTY_ARRAY = new List<AstNode>(0);
+
+ /**
+ * The parent of the node, or `null` if the node is the root of an AST structure.
+ */
+ AstNode _parent;
+
+ /**
+ * A table mapping the names of properties to their values, or `null` if this node does not
+ * have any properties associated with it.
+ */
+ Map<String, Object> _propertyMap;
+
+ /**
+ * A comparator that can be used to sort AST nodes in lexical order. In other words,
+ * `compare` will return a negative value if the offset of the first node is less than the
+ * offset of the second node, zero (0) if the nodes have the same offset, and a positive value if
+ * if the offset of the first node is greater than the offset of the second node.
+ */
+ static Comparator<AstNode> LEXICAL_ORDER = (AstNode first, AstNode second) => second.offset - first.offset;
+
+ /**
+ * Use the given visitor to visit this node.
+ *
+ * @param visitor the visitor that will visit this node
+ * @return the value returned by the visitor as a result of visiting this node
+ */
+ accept(AstVisitor visitor);
+
+ /**
+ * Return the node of the given class that most immediately encloses this node, or `null` if
+ * there is no enclosing node of the given class.
+ *
+ * @param nodeClass the class of the node to be returned
+ * @return the node of the given type that encloses this node
+ */
+ AstNode getAncestor(Predicate<AstNode> predicate) {
+ AstNode node = this;
+ while (node != null && !predicate(node)) {
+ node = node.parent;
+ }
+ return node;
+ }
+
+ /**
+ * Return the first token included in this node's source range.
+ *
+ * @return the first token included in this node's source range
+ */
+ Token get beginToken;
+
+ /**
+ * Return the offset of the character immediately following the last character of this node's
+ * source range. This is equivalent to `node.getOffset() + node.getLength()`. For a
+ * compilation unit this will be equal to the length of the unit's source. For synthetic nodes
+ * this will be equivalent to the node's offset (because the length is zero (0) by definition).
+ *
+ * @return the offset of the character just past the node's source range
+ */
+ int get end => offset + length;
+
+ /**
+ * Return the last token included in this node's source range.
+ *
+ * @return the last token included in this node's source range
+ */
+ Token get endToken;
+
+ /**
+ * Return the number of characters in the node's source range.
+ *
+ * @return the number of characters in the node's source range
+ */
+ int get length {
+ Token beginToken = this.beginToken;
+ Token endToken = this.endToken;
+ if (beginToken == null || endToken == null) {
+ return -1;
+ }
+ return endToken.offset + endToken.length - beginToken.offset;
+ }
+
+ /**
+ * Return the offset from the beginning of the file to the first character in the node's source
+ * range.
+ *
+ * @return the offset from the beginning of the file to the first character in the node's source
+ * range
+ */
+ int get offset {
+ Token beginToken = this.beginToken;
+ if (beginToken == null) {
+ return -1;
+ }
+ return beginToken.offset;
+ }
+
+ /**
+ * Return this node's parent node, or `null` if this node is the root of an AST structure.
+ *
+ * Note that the relationship between an AST node and its parent node may change over the lifetime
+ * of a node.
+ *
+ * @return the parent of this node, or `null` if none
+ */
+ AstNode get parent => _parent;
+
+ /**
+ * Return the value of the property with the given name, or `null` if this node does not
+ * have a property with the given name.
+ *
+ * @return the value of the property with the given name
+ */
+ Object getProperty(String propertyName) {
+ if (_propertyMap == null) {
+ return null;
+ }
+ return _propertyMap[propertyName];
+ }
+
+ /**
+ * Return the node at the root of this node's AST structure. Note that this method's performance
+ * is linear with respect to the depth of the node in the AST structure (O(depth)).
+ *
+ * @return the node at the root of this node's AST structure
+ */
+ AstNode get root {
+ AstNode root = this;
+ AstNode parent = this.parent;
+ while (parent != null) {
+ root = parent;
+ parent = root.parent;
+ }
+ return root;
+ }
+
+ /**
+ * Return `true` if this node is a synthetic node. A synthetic node is a node that was
+ * introduced by the parser in order to recover from an error in the code. Synthetic nodes always
+ * have a length of zero (`0`).
+ *
+ * @return `true` if this node is a synthetic node
+ */
+ bool get isSynthetic => false;
+
+ /**
+ * Set the value of the property with the given name to the given value. If the value is
+ * `null`, the property will effectively be removed.
+ *
+ * @param propertyName the name of the property whose value is to be set
+ * @param propertyValue the new value of the property
+ */
+ void setProperty(String propertyName, Object propertyValue) {
+ if (propertyValue == null) {
+ if (_propertyMap != null) {
+ _propertyMap.remove(propertyName);
+ if (_propertyMap.isEmpty) {
+ _propertyMap = null;
+ }
+ }
+ } else {
+ if (_propertyMap == null) {
+ _propertyMap = new HashMap<String, Object>();
+ }
+ _propertyMap[propertyName] = propertyValue;
+ }
+ }
+
+ /**
+ * Return a textual description of this node in a form approximating valid source. The returned
+ * string will not be valid source primarily in the case where the node itself is not well-formed.
+ *
+ * @return the source code equivalent of this node
+ */
+ String toSource() {
+ PrintStringWriter writer = new PrintStringWriter();
+ accept(new ToSourceVisitor(writer));
+ return writer.toString();
+ }
+
+ @override
+ String toString() => toSource();
+
+ /**
+ * Use the given visitor to visit all of the children of this node. The children will be visited
+ * in source order.
+ *
+ * @param visitor the visitor that will be used to visit the children of this node
+ */
+ void visitChildren(AstVisitor visitor);
+
+ /**
+ * Make this node the parent of the given child node.
+ *
+ * @param child the node that will become a child of this node
+ * @return the node that was made a child of this node
+ */
+ AstNode becomeParentOf(AstNode child) {
+ if (child != null) {
+ AstNode node = child;
+ node.parent = this;
+ }
+ return child;
+ }
+
+ /**
+ * If the given child is not `null`, use the given visitor to visit it.
+ *
+ * @param child the child to be visited
+ * @param visitor the visitor that will be used to visit the child
+ */
+ void safelyVisitChild(AstNode child, AstVisitor visitor) {
+ if (child != null) {
+ child.accept(visitor);
+ }
+ }
+
+ /**
+ * Set the parent of this node to the given node.
+ *
+ * @param newParent the node that is to be made the parent of this node
+ */
+ void set parent(AstNode newParent) {
+ _parent = newParent;
+ }
+}
+
+/**
+ * The interface `AstVisitor` defines the behavior of objects that can be used to visit an AST
+ * structure.
+ */
+abstract class AstVisitor<R> {
+ R visitAdjacentStrings(AdjacentStrings node);
+
+ R visitAnnotation(Annotation node);
+
+ R visitArgumentList(ArgumentList node);
+
+ R visitAsExpression(AsExpression node);
+
+ R visitAssertStatement(AssertStatement assertStatement);
+
+ R visitAssignmentExpression(AssignmentExpression node);
+
+ R visitAwaitExpression(AwaitExpression node);
+
+ R visitBinaryExpression(BinaryExpression node);
+
+ R visitBlock(Block node);
+
+ R visitBlockFunctionBody(BlockFunctionBody node);
+
+ R visitBooleanLiteral(BooleanLiteral node);
+
+ R visitBreakStatement(BreakStatement node);
+
+ R visitCascadeExpression(CascadeExpression node);
+
+ R visitCatchClause(CatchClause node);
+
+ R visitClassDeclaration(ClassDeclaration node);
+
+ R visitClassTypeAlias(ClassTypeAlias node);
+
+ R visitComment(Comment node);
+
+ R visitCommentReference(CommentReference node);
+
+ R visitCompilationUnit(CompilationUnit node);
+
+ R visitConditionalExpression(ConditionalExpression node);
+
+ R visitConstructorDeclaration(ConstructorDeclaration node);
+
+ R visitConstructorFieldInitializer(ConstructorFieldInitializer node);
+
+ R visitConstructorName(ConstructorName node);
+
+ R visitContinueStatement(ContinueStatement node);
+
+ R visitDeclaredIdentifier(DeclaredIdentifier node);
+
+ R visitDefaultFormalParameter(DefaultFormalParameter node);
+
+ R visitDoStatement(DoStatement node);
+
+ R visitDoubleLiteral(DoubleLiteral node);
+
+ R visitEmptyFunctionBody(EmptyFunctionBody node);
+
+ R visitEmptyStatement(EmptyStatement node);
+
+ R visitEnumConstantDeclaration(EnumConstantDeclaration node);
+
+ R visitEnumDeclaration(EnumDeclaration node);
+
+ R visitExportDirective(ExportDirective node);
+
+ R visitExpressionFunctionBody(ExpressionFunctionBody node);
+
+ R visitExpressionStatement(ExpressionStatement node);
+
+ R visitExtendsClause(ExtendsClause node);
+
+ R visitFieldDeclaration(FieldDeclaration node);
+
+ R visitFieldFormalParameter(FieldFormalParameter node);
+
+ R visitForEachStatement(ForEachStatement node);
+
+ R visitFormalParameterList(FormalParameterList node);
+
+ R visitForStatement(ForStatement node);
+
+ R visitFunctionDeclaration(FunctionDeclaration node);
+
+ R visitFunctionDeclarationStatement(FunctionDeclarationStatement node);
+
+ R visitFunctionExpression(FunctionExpression node);
+
+ R visitFunctionExpressionInvocation(FunctionExpressionInvocation node);
+
+ R visitFunctionTypeAlias(FunctionTypeAlias functionTypeAlias);
+
+ R visitFunctionTypedFormalParameter(FunctionTypedFormalParameter node);
+
+ R visitHideCombinator(HideCombinator node);
+
+ R visitIfStatement(IfStatement node);
+
+ R visitImplementsClause(ImplementsClause node);
+
+ R visitImportDirective(ImportDirective node);
+
+ R visitIndexExpression(IndexExpression node);
+
+ R visitInstanceCreationExpression(InstanceCreationExpression node);
+
+ R visitIntegerLiteral(IntegerLiteral node);
+
+ R visitInterpolationExpression(InterpolationExpression node);
+
+ R visitInterpolationString(InterpolationString node);
+
+ R visitIsExpression(IsExpression node);
+
+ R visitLabel(Label node);
+
+ R visitLabeledStatement(LabeledStatement node);
+
+ R visitLibraryDirective(LibraryDirective node);
+
+ R visitLibraryIdentifier(LibraryIdentifier node);
+
+ R visitListLiteral(ListLiteral node);
+
+ R visitMapLiteral(MapLiteral node);
+
+ R visitMapLiteralEntry(MapLiteralEntry node);
+
+ R visitMethodDeclaration(MethodDeclaration node);
+
+ R visitMethodInvocation(MethodInvocation node);
+
+ R visitNamedExpression(NamedExpression node);
+
+ R visitNativeClause(NativeClause node);
+
+ R visitNativeFunctionBody(NativeFunctionBody node);
+
+ R visitNullLiteral(NullLiteral node);
+
+ R visitParenthesizedExpression(ParenthesizedExpression node);
+
+ R visitPartDirective(PartDirective node);
+
+ R visitPartOfDirective(PartOfDirective node);
+
+ R visitPostfixExpression(PostfixExpression node);
+
+ R visitPrefixedIdentifier(PrefixedIdentifier node);
+
+ R visitPrefixExpression(PrefixExpression node);
+
+ R visitPropertyAccess(PropertyAccess node);
+
+ R visitRedirectingConstructorInvocation(RedirectingConstructorInvocation node);
+
+ R visitRethrowExpression(RethrowExpression node);
+
+ R visitReturnStatement(ReturnStatement node);
+
+ R visitScriptTag(ScriptTag node);
+
+ R visitShowCombinator(ShowCombinator node);
+
+ R visitSimpleFormalParameter(SimpleFormalParameter node);
+
+ R visitSimpleIdentifier(SimpleIdentifier node);
+
+ R visitSimpleStringLiteral(SimpleStringLiteral node);
+
+ R visitStringInterpolation(StringInterpolation node);
+
+ R visitSuperConstructorInvocation(SuperConstructorInvocation node);
+
+ R visitSuperExpression(SuperExpression node);
+
+ R visitSwitchCase(SwitchCase node);
+
+ R visitSwitchDefault(SwitchDefault node);
+
+ R visitSwitchStatement(SwitchStatement node);
+
+ R visitSymbolLiteral(SymbolLiteral node);
+
+ R visitThisExpression(ThisExpression node);
+
+ R visitThrowExpression(ThrowExpression node);
+
+ R visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node);
+
+ R visitTryStatement(TryStatement node);
+
+ R visitTypeArgumentList(TypeArgumentList node);
+
+ R visitTypeName(TypeName node);
+
+ R visitTypeParameter(TypeParameter node);
+
+ R visitTypeParameterList(TypeParameterList node);
+
+ R visitVariableDeclaration(VariableDeclaration node);
+
+ R visitVariableDeclarationList(VariableDeclarationList node);
+
+ R visitVariableDeclarationStatement(VariableDeclarationStatement node);
+
+ R visitWhileStatement(WhileStatement node);
+
+ R visitWithClause(WithClause node);
+
+ R visitYieldStatement(YieldStatement node);
+}
+
+/**
+ * Instances of the class `AwaitExpression` implement an await expression.
+ */
+class AwaitExpression extends Expression {
+ /**
+ * The 'await' keyword.
+ */
+ Token awaitKeyword;
+
+ /**
+ * The expression whose value is being waited on.
+ */
+ Expression _expression;
+
+ /**
+ * Initialize a newly created await expression.
+ *
+ * @param awaitKeyword the 'await' keyword
+ * @param expression the expression whose value is being waited on
+ */
+ AwaitExpression(this.awaitKeyword, Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitAwaitExpression(this);
+
+ @override
+ Token get beginToken {
+ if (awaitKeyword != null) {
+ return awaitKeyword;
+ }
+ return _expression.beginToken;
+ }
+
+ @override
+ Token get endToken => _expression.endToken;
+
+ /**
+ * Return the expression whose value is being waited on.
+ *
+ * @return the expression whose value is being waited on
+ */
+ Expression get expression => _expression;
+
+ @override
+ int get precedence => 0;
+
+ /**
+ * Set the expression whose value is being waited on to the given expression.
+ *
+ * @param expression the expression whose value is being waited on
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_expression, visitor);
+ }
+}
+
+/**
+ * Instances of the class `BinaryExpression` represent a binary (infix) expression.
+ *
+ * <pre>
+ * binaryExpression ::=
+ * [Expression] [Token] [Expression]
+ * </pre>
+ */
+class BinaryExpression extends Expression {
+ /**
+ * The expression used to compute the left operand.
+ */
+ Expression _leftOperand;
+
+ /**
+ * The binary operator being applied.
+ */
+ Token operator;
+
+ /**
+ * The expression used to compute the right operand.
+ */
+ Expression _rightOperand;
+
+ /**
+ * The element associated with the operator based on the static type of the left operand, or
+ * `null` if the AST structure has not been resolved, if the operator is not user definable,
+ * or if the operator could not be resolved.
+ */
+ MethodElement _staticElement;
+
+ /**
+ * The element associated with the operator based on the propagated type of the left operand, or
+ * `null` if the AST structure has not been resolved, if the operator is not user definable,
+ * or if the operator could not be resolved.
+ */
+ MethodElement _propagatedElement;
+
+ /**
+ * Initialize a newly created binary expression.
+ *
+ * @param leftOperand the expression used to compute the left operand
+ * @param operator the binary operator being applied
+ * @param rightOperand the expression used to compute the right operand
+ */
+ BinaryExpression(Expression leftOperand, this.operator, Expression rightOperand) {
+ this._leftOperand = becomeParentOf(leftOperand);
+ this._rightOperand = becomeParentOf(rightOperand);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitBinaryExpression(this);
+
+ @override
+ Token get beginToken => _leftOperand.beginToken;
+
+ /**
+ * Return the best element available for this operator. If resolution was able to find a better
+ * element based on type propagation, that element will be returned. Otherwise, the element found
+ * using the result of static analysis will be returned. If resolution has not been performed,
+ * then `null` will be returned.
+ *
+ * @return the best element available for this operator
+ */
+ MethodElement get bestElement {
+ MethodElement element = propagatedElement;
+ if (element == null) {
+ element = staticElement;
+ }
+ return element;
+ }
+
+ @override
+ Token get endToken => _rightOperand.endToken;
+
+ /**
+ * Return the expression used to compute the left operand.
+ *
+ * @return the expression used to compute the left operand
+ */
+ Expression get leftOperand => _leftOperand;
+
+ @override
+ int get precedence => operator.type.precedence;
+
+ /**
+ * Return the element associated with the operator based on the propagated type of the left
+ * operand, or `null` if the AST structure has not been resolved, if the operator is not
+ * user definable, or if the operator could not be resolved. One example of the latter case is an
+ * operator that is not defined for the type of the left-hand operand.
+ *
+ * @return the element associated with the operator
+ */
+ MethodElement get propagatedElement => _propagatedElement;
+
+ /**
+ * Return the expression used to compute the right operand.
+ *
+ * @return the expression used to compute the right operand
+ */
+ Expression get rightOperand => _rightOperand;
+
+ /**
+ * Return the element associated with the operator based on the static type of the left operand,
+ * or `null` if the AST structure has not been resolved, if the operator is not user
+ * definable, or if the operator could not be resolved. One example of the latter case is an
+ * operator that is not defined for the type of the left operand.
+ *
+ * @return the element associated with the operator
+ */
+ MethodElement get staticElement => _staticElement;
+
+ /**
+ * Set the expression used to compute the left operand to the given expression.
+ *
+ * @param expression the expression used to compute the left operand
+ */
+ void set leftOperand(Expression expression) {
+ _leftOperand = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the element associated with the operator based on the propagated type of the left operand
+ * to the given element.
+ *
+ * @param element the element to be associated with the operator
+ */
+ void set propagatedElement(MethodElement element) {
+ _propagatedElement = element;
+ }
+
+ /**
+ * Set the expression used to compute the right operand to the given expression.
+ *
+ * @param expression the expression used to compute the right operand
+ */
+ void set rightOperand(Expression expression) {
+ _rightOperand = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the element associated with the operator based on the static type of the left operand to
+ * the given element.
+ *
+ * @param element the static element to be associated with the operator
+ */
+ void set staticElement(MethodElement element) {
+ _staticElement = element;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_leftOperand, visitor);
+ safelyVisitChild(_rightOperand, visitor);
+ }
+
+ /**
+ * If the AST structure has been resolved, and the function being invoked is known based on
+ * propagated type information, then return the parameter element representing the parameter to
+ * which the value of the right operand will be bound. Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getPropagatedParameterElement].
+ *
+ * @return the parameter element representing the parameter to which the value of the right
+ * operand will be bound
+ */
+ ParameterElement get propagatedParameterElementForRightOperand {
+ if (_propagatedElement == null) {
+ return null;
+ }
+ List<ParameterElement> parameters = _propagatedElement.parameters;
+ if (parameters.length < 1) {
+ return null;
+ }
+ return parameters[0];
+ }
+
+ /**
+ * If the AST structure has been resolved, and the function being invoked is known based on static
+ * type information, then return the parameter element representing the parameter to which the
+ * value of the right operand will be bound. Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getStaticParameterElement].
+ *
+ * @return the parameter element representing the parameter to which the value of the right
+ * operand will be bound
+ */
+ ParameterElement get staticParameterElementForRightOperand {
+ if (_staticElement == null) {
+ return null;
+ }
+ List<ParameterElement> parameters = _staticElement.parameters;
+ if (parameters.length < 1) {
+ return null;
+ }
+ return parameters[0];
+ }
+}
+
+/**
+ * Instances of the class `Block` represent a sequence of statements.
+ *
+ * <pre>
+ * block ::=
+ * '{' statement* '}'
+ * </pre>
+ */
+class Block extends Statement {
+ /**
+ * The left curly bracket.
+ */
+ Token leftBracket;
+
+ /**
+ * The statements contained in the block.
+ */
+ NodeList<Statement> _statements;
+
+ /**
+ * The right curly bracket.
+ */
+ Token rightBracket;
+
+ /**
+ * Initialize a newly created block of code.
+ *
+ * @param leftBracket the left curly bracket
+ * @param statements the statements contained in the block
+ * @param rightBracket the right curly bracket
+ */
+ Block(this.leftBracket, List<Statement> statements, this.rightBracket) {
+ this._statements = new NodeList<Statement>(this);
+ this._statements.addAll(statements);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitBlock(this);
+
+ @override
+ Token get beginToken => leftBracket;
+
+ @override
+ Token get endToken => rightBracket;
+
+ /**
+ * Return the statements contained in the block.
+ *
+ * @return the statements contained in the block
+ */
+ NodeList<Statement> get statements => _statements;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _statements.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `BlockFunctionBody` represent a function body that consists of a
+ * block of statements.
+ *
+ * <pre>
+ * blockFunctionBody ::=
+ * ('async' | 'async' '*' | 'sync' '*')? [Block]
+ * </pre>
+ */
+class BlockFunctionBody extends FunctionBody {
+ /**
+ * The token representing the 'async' or 'sync' keyword, or `null` if there is no such
+ * keyword.
+ */
+ Token keyword;
+
+ /**
+ * The star optionally following the 'async' or following the 'sync' keyword.
+ */
+ Token star;
+
+ /**
+ * The block representing the body of the function.
+ */
+ Block _block;
+
+ /**
+ * Initialize a newly created function body consisting of a block of statements.
+ *
+ * @param keyword the token representing the 'async' or 'sync' keyword
+ * @param star the star following the 'async' or 'sync' keyword
+ * @param block the block representing the body of the function
+ */
+ BlockFunctionBody(this.keyword, this.star, Block block) {
+ this._block = becomeParentOf(block);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitBlockFunctionBody(this);
+
+ @override
+ Token get beginToken => _block.beginToken;
+
+ /**
+ * Return the block representing the body of the function.
+ *
+ * @return the block representing the body of the function
+ */
+ Block get block => _block;
+
+ @override
+ Token get endToken => _block.endToken;
+
+ @override
+ bool get isAsynchronous {
+ if (keyword == null) {
+ return false;
+ }
+ String keywordValue = keyword.lexeme;
+ return keywordValue == Parser.ASYNC;
+ }
+
+ @override
+ bool get isGenerator => star != null;
+
+ @override
+ bool get isSynchronous => keyword == null || keyword.lexeme != Parser.ASYNC;
+
+ /**
+ * Set the block representing the body of the function to the given block.
+ *
+ * @param block the block representing the body of the function
+ */
+ void set block(Block block) {
+ this._block = becomeParentOf(block);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_block, visitor);
+ }
+}
+
+/**
+ * Instances of the class `BooleanLiteral` represent a boolean literal expression.
+ *
+ * <pre>
+ * booleanLiteral ::=
+ * 'false' | 'true'
+ * </pre>
+ */
+class BooleanLiteral extends Literal {
+ /**
+ * The token representing the literal.
+ */
+ Token literal;
+
+ /**
+ * The value of the literal.
+ */
+ bool value = false;
+
+ /**
+ * Initialize a newly created boolean literal.
+ *
+ * @param literal the token representing the literal
+ * @param value the value of the literal
+ */
+ BooleanLiteral(this.literal, this.value);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitBooleanLiteral(this);
+
+ @override
+ Token get beginToken => literal;
+
+ @override
+ Token get endToken => literal;
+
+ @override
+ bool get isSynthetic => literal.isSynthetic;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * Instances of the class `BreadthFirstVisitor` implement an AST visitor that will recursively
+ * visit all of the nodes in an AST structure, similar to [GeneralizingAstVisitor]. This
+ * visitor uses a breadth-first ordering rather than the depth-first ordering of
+ * [GeneralizingAstVisitor].
+ *
+ * Subclasses that override a visit method must either invoke the overridden visit method or
+ * explicitly invoke the more general visit method. Failure to do so will cause the visit methods
+ * for superclasses of the node to not be invoked and will cause the children of the visited node to
+ * not be visited.
+ *
+ * In addition, subclasses should <b>not</b> explicitly visit the children of a node, but should
+ * ensure that the method [visitNode] is used to visit the children (either directly
+ * or indirectly). Failure to do will break the order in which nodes are visited.
+ */
+class BreadthFirstVisitor<R> extends GeneralizingAstVisitor<R> {
+ /**
+ * A queue holding the nodes that have not yet been visited in the order in which they ought to be
+ * visited.
+ */
+ Queue<AstNode> _queue = new Queue<AstNode>();
+
+ /**
+ * A visitor, used to visit the children of the current node, that will add the nodes it visits to
+ * the [queue].
+ */
+ GeneralizingAstVisitor<Object> _childVisitor;
+
+ /**
+ * Visit all nodes in the tree starting at the given `root` node, in breadth-first order.
+ *
+ * @param root the root of the AST structure to be visited
+ */
+ void visitAllNodes(AstNode root) {
+ _queue.add(root);
+ while (!_queue.isEmpty) {
+ AstNode next = _queue.removeFirst();
+ next.accept(this);
+ }
+ }
+
+ @override
+ R visitNode(AstNode node) {
+ node.visitChildren(_childVisitor);
+ return null;
+ }
+
+ BreadthFirstVisitor() {
+ this._childVisitor = new GeneralizingAstVisitor_BreadthFirstVisitor(this);
+ }
+}
+
+/**
+ * Instances of the class `BreakStatement` represent a break statement.
+ *
+ * <pre>
+ * breakStatement ::=
+ * 'break' [SimpleIdentifier]? ';'
+ * </pre>
+ */
+class BreakStatement extends Statement {
+ /**
+ * The token representing the 'break' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The label associated with the statement, or `null` if there is no label.
+ */
+ SimpleIdentifier _label;
+
+ /**
+ * The semicolon terminating the statement.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created break statement.
+ *
+ * @param keyword the token representing the 'break' keyword
+ * @param label the label associated with the statement
+ * @param semicolon the semicolon terminating the statement
+ */
+ BreakStatement(this.keyword, SimpleIdentifier label, this.semicolon) {
+ this._label = becomeParentOf(label);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitBreakStatement(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ @override
+ Token get endToken => semicolon;
+
+ /**
+ * Return the label associated with the statement, or `null` if there is no label.
+ *
+ * @return the label associated with the statement
+ */
+ SimpleIdentifier get label => _label;
+
+ /**
+ * Set the label associated with the statement to the given identifier.
+ *
+ * @param identifier the label associated with the statement
+ */
+ void set label(SimpleIdentifier identifier) {
+ _label = becomeParentOf(identifier);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_label, visitor);
+ }
+}
+
+/**
+ * Instances of the class `CascadeExpression` represent a sequence of cascaded expressions:
+ * expressions that share a common target. There are three kinds of expressions that can be used in
+ * a cascade expression: [IndexExpression], [MethodInvocation] and
+ * [PropertyAccess].
+ *
+ * <pre>
+ * cascadeExpression ::=
+ * [Expression] cascadeSection*
+ *
+ * cascadeSection ::=
+ * '..' (cascadeSelector arguments*) (assignableSelector arguments*)* (assignmentOperator expressionWithoutCascade)?
+ *
+ * cascadeSelector ::=
+ * '[ ' expression '] '
+ * | identifier
+ * </pre>
+ */
+class CascadeExpression extends Expression {
+ /**
+ * The target of the cascade sections.
+ */
+ Expression _target;
+
+ /**
+ * The cascade sections sharing the common target.
+ */
+ NodeList<Expression> _cascadeSections;
+
+ /**
+ * Initialize a newly created cascade expression.
+ *
+ * @param target the target of the cascade sections
+ * @param cascadeSections the cascade sections sharing the common target
+ */
+ CascadeExpression(Expression target, List<Expression> cascadeSections) {
+ this._cascadeSections = new NodeList<Expression>(this);
+ this._target = becomeParentOf(target);
+ this._cascadeSections.addAll(cascadeSections);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitCascadeExpression(this);
+
+ @override
+ Token get beginToken => _target.beginToken;
+
+ /**
+ * Return the cascade sections sharing the common target.
+ *
+ * @return the cascade sections sharing the common target
+ */
+ NodeList<Expression> get cascadeSections => _cascadeSections;
+
+ @override
+ Token get endToken => _cascadeSections.endToken;
+
+ @override
+ int get precedence => 2;
+
+ /**
+ * Return the target of the cascade sections.
+ *
+ * @return the target of the cascade sections
+ */
+ Expression get target => _target;
+
+ /**
+ * Set the target of the cascade sections to the given expression.
+ *
+ * @param target the target of the cascade sections
+ */
+ void set target(Expression target) {
+ this._target = becomeParentOf(target);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_target, visitor);
+ _cascadeSections.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `CatchClause` represent a catch clause within a try statement.
+ *
+ * <pre>
+ * onPart ::=
+ * catchPart [Block]
+ * | 'on' type catchPart? [Block]
+ *
+ * catchPart ::=
+ * 'catch' '(' [SimpleIdentifier] (',' [SimpleIdentifier])? ')'
+ * </pre>
+ */
+class CatchClause extends AstNode {
+ /**
+ * The token representing the 'on' keyword, or `null` if there is no 'on' keyword.
+ */
+ Token onKeyword;
+
+ /**
+ * The type of exceptions caught by this catch clause, or `null` if this catch clause
+ * catches every type of exception.
+ */
+ TypeName _exceptionType;
+
+ /**
+ * The token representing the 'catch' keyword, or `null` if there is no 'catch' keyword.
+ */
+ Token catchKeyword;
+
+ /**
+ * The left parenthesis.
+ */
+ Token _leftParenthesis;
+
+ /**
+ * The parameter whose value will be the exception that was thrown.
+ */
+ SimpleIdentifier _exceptionParameter;
+
+ /**
+ * The comma separating the exception parameter from the stack trace parameter, or `null` if
+ * there is no stack trace parameter.
+ */
+ Token comma;
+
+ /**
+ * The parameter whose value will be the stack trace associated with the exception, or
+ * `null` if there is no stack trace parameter.
+ */
+ SimpleIdentifier _stackTraceParameter;
+
+ /**
+ * The right parenthesis.
+ */
+ Token _rightParenthesis;
+
+ /**
+ * The body of the catch block.
+ */
+ Block _body;
+
+ /**
+ * Initialize a newly created catch clause.
+ *
+ * @param onKeyword the token representing the 'on' keyword
+ * @param exceptionType the type of exceptions caught by this catch clause
+ * @param leftParenthesis the left parenthesis
+ * @param exceptionParameter the parameter whose value will be the exception that was thrown
+ * @param comma the comma separating the exception parameter from the stack trace parameter
+ * @param stackTraceParameter the parameter whose value will be the stack trace associated with
+ * the exception
+ * @param rightParenthesis the right parenthesis
+ * @param body the body of the catch block
+ */
+ CatchClause(this.onKeyword, TypeName exceptionType, this.catchKeyword, Token leftParenthesis, SimpleIdentifier exceptionParameter, this.comma, SimpleIdentifier stackTraceParameter, Token rightParenthesis, Block body) {
+ this._exceptionType = becomeParentOf(exceptionType);
+ this._leftParenthesis = leftParenthesis;
+ this._exceptionParameter = becomeParentOf(exceptionParameter);
+ this._stackTraceParameter = becomeParentOf(stackTraceParameter);
+ this._rightParenthesis = rightParenthesis;
+ this._body = becomeParentOf(body);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitCatchClause(this);
+
+ @override
+ Token get beginToken {
+ if (onKeyword != null) {
+ return onKeyword;
+ }
+ return catchKeyword;
+ }
+
+ /**
+ * Return the body of the catch block.
+ *
+ * @return the body of the catch block
+ */
+ Block get body => _body;
+
+ @override
+ Token get endToken => _body.endToken;
+
+ /**
+ * Return the parameter whose value will be the exception that was thrown.
+ *
+ * @return the parameter whose value will be the exception that was thrown
+ */
+ SimpleIdentifier get exceptionParameter => _exceptionParameter;
+
+ /**
+ * Return the type of exceptions caught by this catch clause, or `null` if this catch clause
+ * catches every type of exception.
+ *
+ * @return the type of exceptions caught by this catch clause
+ */
+ TypeName get exceptionType => _exceptionType;
+
+ /**
+ * Return the left parenthesis.
+ *
+ * @return the left parenthesis
+ */
+ Token get leftParenthesis => _leftParenthesis;
+
+ /**
+ * Return the right parenthesis.
+ *
+ * @return the right parenthesis
+ */
+ Token get rightParenthesis => _rightParenthesis;
+
+ /**
+ * Return the parameter whose value will be the stack trace associated with the exception, or
+ * `null` if there is no stack trace parameter.
+ *
+ * @return the parameter whose value will be the stack trace associated with the exception
+ */
+ SimpleIdentifier get stackTraceParameter => _stackTraceParameter;
+
+ /**
+ * Set the body of the catch block to the given block.
+ *
+ * @param block the body of the catch block
+ */
+ void set body(Block block) {
+ _body = becomeParentOf(block);
+ }
+
+ /**
+ * Set the parameter whose value will be the exception that was thrown to the given parameter.
+ *
+ * @param parameter the parameter whose value will be the exception that was thrown
+ */
+ void set exceptionParameter(SimpleIdentifier parameter) {
+ _exceptionParameter = becomeParentOf(parameter);
+ }
+
+ /**
+ * Set the type of exceptions caught by this catch clause to the given type.
+ *
+ * @param exceptionType the type of exceptions caught by this catch clause
+ */
+ void set exceptionType(TypeName exceptionType) {
+ this._exceptionType = becomeParentOf(exceptionType);
+ }
+
+ /**
+ * Set the left parenthesis to the given token.
+ *
+ * @param parenthesis the left parenthesis
+ */
+ void set leftParenthesis(Token parenthesis) {
+ _leftParenthesis = parenthesis;
+ }
+
+ /**
+ * Set the right parenthesis to the given token.
+ *
+ * @param parenthesis the right parenthesis
+ */
+ void set rightParenthesis(Token parenthesis) {
+ _rightParenthesis = parenthesis;
+ }
+
+ /**
+ * Set the parameter whose value will be the stack trace associated with the exception to the
+ * given parameter.
+ *
+ * @param parameter the parameter whose value will be the stack trace associated with the
+ * exception
+ */
+ void set stackTraceParameter(SimpleIdentifier parameter) {
+ _stackTraceParameter = becomeParentOf(parameter);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_exceptionType, visitor);
+ safelyVisitChild(_exceptionParameter, visitor);
+ safelyVisitChild(_stackTraceParameter, visitor);
+ safelyVisitChild(_body, visitor);
+ }
+}
+
+/**
+ * Instances of the class `ClassDeclaration` represent the declaration of a class.
+ *
+ * <pre>
+ * classDeclaration ::=
+ * 'abstract'? 'class' [SimpleIdentifier] [TypeParameterList]?
+ * ([ExtendsClause] [WithClause]?)?
+ * [ImplementsClause]?
+ * '{' [ClassMember]* '}'
+ * </pre>
+ */
+class ClassDeclaration extends CompilationUnitMember {
+ /**
+ * The 'abstract' keyword, or `null` if the keyword was absent.
+ */
+ Token abstractKeyword;
+
+ /**
+ * The token representing the 'class' keyword.
+ */
+ Token classKeyword;
+
+ /**
+ * The name of the class being declared.
+ */
+ SimpleIdentifier _name;
+
+ /**
+ * The type parameters for the class, or `null` if the class does not have any type
+ * parameters.
+ */
+ TypeParameterList _typeParameters;
+
+ /**
+ * The extends clause for the class, or `null` if the class does not extend any other class.
+ */
+ ExtendsClause _extendsClause;
+
+ /**
+ * The with clause for the class, or `null` if the class does not have a with clause.
+ */
+ WithClause _withClause;
+
+ /**
+ * The implements clause for the class, or `null` if the class does not implement any
+ * interfaces.
+ */
+ ImplementsClause _implementsClause;
+
+ /**
+ * The native clause for the class, or `null` if the class does not have a native clause.
+ */
+ NativeClause _nativeClause;
+
+ /**
+ * The left curly bracket.
+ */
+ Token leftBracket;
+
+ /**
+ * The members defined by the class.
+ */
+ NodeList<ClassMember> _members;
+
+ /**
+ * The right curly bracket.
+ */
+ Token rightBracket;
+
+ /**
+ * Initialize a newly created class declaration.
+ *
+ * @param comment the documentation comment associated with this class
+ * @param metadata the annotations associated with this class
+ * @param abstractKeyword the 'abstract' keyword, or `null` if the keyword was absent
+ * @param classKeyword the token representing the 'class' keyword
+ * @param name the name of the class being declared
+ * @param typeParameters the type parameters for the class
+ * @param extendsClause the extends clause for the class
+ * @param withClause the with clause for the class
+ * @param implementsClause the implements clause for the class
+ * @param leftBracket the left curly bracket
+ * @param members the members defined by the class
+ * @param rightBracket the right curly bracket
+ */
+ ClassDeclaration(Comment comment, List<Annotation> metadata, this.abstractKeyword, this.classKeyword, SimpleIdentifier name, TypeParameterList typeParameters, ExtendsClause extendsClause, WithClause withClause, ImplementsClause implementsClause, this.leftBracket, List<ClassMember> members, this.rightBracket) : super(comment, metadata) {
+ this._members = new NodeList<ClassMember>(this);
+ this._name = becomeParentOf(name);
+ this._typeParameters = becomeParentOf(typeParameters);
+ this._extendsClause = becomeParentOf(extendsClause);
+ this._withClause = becomeParentOf(withClause);
+ this._implementsClause = becomeParentOf(implementsClause);
+ this._members.addAll(members);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitClassDeclaration(this);
+
+ /**
+ * Return the constructor declared in the class with the given name.
+ *
+ * @param name the name of the constructor to find, `null` for default
+ * @return the found constructor or `null` if not found
+ */
+ ConstructorDeclaration getConstructor(String name) {
+ for (ClassMember classMember in _members) {
+ if (classMember is ConstructorDeclaration) {
+ ConstructorDeclaration constructor = classMember;
+ SimpleIdentifier constructorName = constructor.name;
+ if (name == null && constructorName == null) {
+ return constructor;
+ }
+ if (constructorName != null && constructorName.name == name) {
+ return constructor;
+ }
+ }
+ }
+ return null;
+ }
+
+ @override
+ ClassElement get element => _name != null ? (_name.staticElement as ClassElement) : null;
+
+ @override
+ Token get endToken => rightBracket;
+
+ /**
+ * Return the extends clause for this class, or `null` if the class does not extend any
+ * other class.
+ *
+ * @return the extends clause for this class
+ */
+ ExtendsClause get extendsClause => _extendsClause;
+
+ /**
+ * Return the field declared in the class with the given name.
+ *
+ * @param name the name of the field to find
+ * @return the found field or `null` if not found
+ */
+ VariableDeclaration getField(String name) {
+ for (ClassMember classMember in _members) {
+ if (classMember is FieldDeclaration) {
+ FieldDeclaration fieldDeclaration = classMember;
+ NodeList<VariableDeclaration> fields = fieldDeclaration.fields.variables;
+ for (VariableDeclaration field in fields) {
+ SimpleIdentifier fieldName = field.name;
+ if (fieldName != null && name == fieldName.name) {
+ return field;
+ }
+ }
+ }
+ }
+ return null;
+ }
+
+ /**
+ * Return the implements clause for the class, or `null` if the class does not implement any
+ * interfaces.
+ *
+ * @return the implements clause for the class
+ */
+ ImplementsClause get implementsClause => _implementsClause;
+
+ /**
+ * Return the members defined by the class.
+ *
+ * @return the members defined by the class
+ */
+ NodeList<ClassMember> get members => _members;
+
+ /**
+ * Return the method declared in the class with the given name.
+ *
+ * @param name the name of the method to find
+ * @return the found method or `null` if not found
+ */
+ MethodDeclaration getMethod(String name) {
+ for (ClassMember classMember in _members) {
+ if (classMember is MethodDeclaration) {
+ MethodDeclaration method = classMember;
+ SimpleIdentifier methodName = method.name;
+ if (methodName != null && name == methodName.name) {
+ return method;
+ }
+ }
+ }
+ return null;
+ }
+
+ /**
+ * Return the name of the class being declared.
+ *
+ * @return the name of the class being declared
+ */
+ SimpleIdentifier get name => _name;
+
+ /**
+ * Return the native clause for this class, or `null` if the class does not have a native
+ * cluse.
+ *
+ * @return the native clause for this class
+ */
+ NativeClause get nativeClause => _nativeClause;
+
+ /**
+ * Return the type parameters for the class, or `null` if the class does not have any type
+ * parameters.
+ *
+ * @return the type parameters for the class
+ */
+ TypeParameterList get typeParameters => _typeParameters;
+
+ /**
+ * Return the with clause for the class, or `null` if the class does not have a with clause.
+ *
+ * @return the with clause for the class
+ */
+ WithClause get withClause => _withClause;
+
+ /**
+ * Return `true` if this class is declared to be an abstract class.
+ *
+ * @return `true` if this class is declared to be an abstract class
+ */
+ bool get isAbstract => abstractKeyword != null;
+
+ /**
+ * Set the extends clause for this class to the given clause.
+ *
+ * @param extendsClause the extends clause for this class
+ */
+ void set extendsClause(ExtendsClause extendsClause) {
+ this._extendsClause = becomeParentOf(extendsClause);
+ }
+
+ /**
+ * Set the implements clause for the class to the given clause.
+ *
+ * @param implementsClause the implements clause for the class
+ */
+ void set implementsClause(ImplementsClause implementsClause) {
+ this._implementsClause = becomeParentOf(implementsClause);
+ }
+
+ /**
+ * Set the name of the class being declared to the given identifier.
+ *
+ * @param identifier the name of the class being declared
+ */
+ void set name(SimpleIdentifier identifier) {
+ _name = becomeParentOf(identifier);
+ }
+
+ /**
+ * Set the native clause for this class to the given clause.
+ *
+ * @param nativeClause the native clause for this class
+ */
+ void set nativeClause(NativeClause nativeClause) {
+ this._nativeClause = becomeParentOf(nativeClause);
+ }
+
+ /**
+ * Set the type parameters for the class to the given list of type parameters.
+ *
+ * @param typeParameters the type parameters for the class
+ */
+ void set typeParameters(TypeParameterList typeParameters) {
+ this._typeParameters = becomeParentOf(typeParameters);
+ }
+
+ /**
+ * Set the with clause for the class to the given clause.
+ *
+ * @param withClause the with clause for the class
+ */
+ void set withClause(WithClause withClause) {
+ this._withClause = becomeParentOf(withClause);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_name, visitor);
+ safelyVisitChild(_typeParameters, visitor);
+ safelyVisitChild(_extendsClause, visitor);
+ safelyVisitChild(_withClause, visitor);
+ safelyVisitChild(_implementsClause, visitor);
+ safelyVisitChild(_nativeClause, visitor);
+ members.accept(visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata {
+ if (abstractKeyword != null) {
+ return abstractKeyword;
+ }
+ return classKeyword;
+ }
+}
+
+/**
+ * The abstract class `ClassMember` defines the behavior common to nodes that declare a name
+ * within the scope of a class.
+ */
+abstract class ClassMember extends Declaration {
+ /**
+ * Initialize a newly created member of a class.
+ *
+ * @param comment the documentation comment associated with this member
+ * @param metadata the annotations associated with this member
+ */
+ ClassMember(Comment comment, List<Annotation> metadata) : super(comment, metadata);
+}
+
+/**
+ * Instances of the class `ClassTypeAlias` represent a class type alias.
+ *
+ * <pre>
+ * classTypeAlias ::=
+ * [SimpleIdentifier] [TypeParameterList]? '=' 'abstract'? mixinApplication
+ *
+ * mixinApplication ::=
+ * [TypeName] [WithClause] [ImplementsClause]? ';'
+ * </pre>
+ */
+class ClassTypeAlias extends TypeAlias {
+ /**
+ * The name of the class being declared.
+ */
+ SimpleIdentifier _name;
+
+ /**
+ * The type parameters for the class, or `null` if the class does not have any type
+ * parameters.
+ */
+ TypeParameterList _typeParameters;
+
+ /**
+ * The token for the '=' separating the name from the definition.
+ */
+ Token equals;
+
+ /**
+ * The token for the 'abstract' keyword, or `null` if this is not defining an abstract
+ * class.
+ */
+ Token abstractKeyword;
+
+ /**
+ * The name of the superclass of the class being declared.
+ */
+ TypeName _superclass;
+
+ /**
+ * The with clause for this class.
+ */
+ WithClause _withClause;
+
+ /**
+ * The implements clause for this class, or `null` if there is no implements clause.
+ */
+ ImplementsClause _implementsClause;
+
+ /**
+ * Initialize a newly created class type alias.
+ *
+ * @param comment the documentation comment associated with this type alias
+ * @param metadata the annotations associated with this type alias
+ * @param keyword the token representing the 'typedef' keyword
+ * @param name the name of the class being declared
+ * @param typeParameters the type parameters for the class
+ * @param equals the token for the '=' separating the name from the definition
+ * @param abstractKeyword the token for the 'abstract' keyword
+ * @param superclass the name of the superclass of the class being declared
+ * @param withClause the with clause for this class
+ * @param implementsClause the implements clause for this class
+ * @param semicolon the semicolon terminating the declaration
+ */
+ ClassTypeAlias(Comment comment, List<Annotation> metadata, Token keyword, SimpleIdentifier name, TypeParameterList typeParameters, this.equals, this.abstractKeyword, TypeName superclass, WithClause withClause, ImplementsClause implementsClause, Token semicolon) : super(comment, metadata, keyword, semicolon) {
+ this._name = becomeParentOf(name);
+ this._typeParameters = becomeParentOf(typeParameters);
+ this._superclass = becomeParentOf(superclass);
+ this._withClause = becomeParentOf(withClause);
+ this._implementsClause = becomeParentOf(implementsClause);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitClassTypeAlias(this);
+
+ @override
+ ClassElement get element => _name != null ? (_name.staticElement as ClassElement) : null;
+
+ /**
+ * Return the implements clause for this class, or `null` if there is no implements clause.
+ *
+ * @return the implements clause for this class
+ */
+ ImplementsClause get implementsClause => _implementsClause;
+
+ /**
+ * Return the name of the class being declared.
+ *
+ * @return the name of the class being declared
+ */
+ SimpleIdentifier get name => _name;
+
+ /**
+ * Return the name of the superclass of the class being declared.
+ *
+ * @return the name of the superclass of the class being declared
+ */
+ TypeName get superclass => _superclass;
+
+ /**
+ * Return the type parameters for the class, or `null` if the class does not have any type
+ * parameters.
+ *
+ * @return the type parameters for the class
+ */
+ TypeParameterList get typeParameters => _typeParameters;
+
+ /**
+ * Return the with clause for this class.
+ *
+ * @return the with clause for this class
+ */
+ WithClause get withClause => _withClause;
+
+ /**
+ * Return `true` if this class is declared to be an abstract class.
+ *
+ * @return `true` if this class is declared to be an abstract class
+ */
+ bool get isAbstract => abstractKeyword != null;
+
+ /**
+ * Set the implements clause for this class to the given implements clause.
+ *
+ * @param implementsClause the implements clause for this class
+ */
+ void set implementsClause(ImplementsClause implementsClause) {
+ this._implementsClause = becomeParentOf(implementsClause);
+ }
+
+ /**
+ * Set the name of the class being declared to the given identifier.
+ *
+ * @param name the name of the class being declared
+ */
+ void set name(SimpleIdentifier name) {
+ this._name = becomeParentOf(name);
+ }
+
+ /**
+ * Set the name of the superclass of the class being declared to the given name.
+ *
+ * @param superclass the name of the superclass of the class being declared
+ */
+ void set superclass(TypeName superclass) {
+ this._superclass = becomeParentOf(superclass);
+ }
+
+ /**
+ * Set the type parameters for the class to the given list of parameters.
+ *
+ * @param typeParameters the type parameters for the class
+ */
+ void set typeParameters(TypeParameterList typeParameters) {
+ this._typeParameters = becomeParentOf(typeParameters);
+ }
+
+ /**
+ * Set the with clause for this class to the given with clause.
+ *
+ * @param withClause the with clause for this class
+ */
+ void set withClause(WithClause withClause) {
+ this._withClause = becomeParentOf(withClause);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_name, visitor);
+ safelyVisitChild(_typeParameters, visitor);
+ safelyVisitChild(_superclass, visitor);
+ safelyVisitChild(_withClause, visitor);
+ safelyVisitChild(_implementsClause, visitor);
+ }
+}
+
+/**
+ * Instances of the class `Combinator` represent the combinator associated with an import
+ * directive.
+ *
+ * <pre>
+ * combinator ::=
+ * [HideCombinator]
+ * | [ShowCombinator]
+ * </pre>
+ */
+abstract class Combinator extends AstNode {
+ /**
+ * The keyword specifying what kind of processing is to be done on the imported names.
+ */
+ Token keyword;
+
+ /**
+ * Initialize a newly created import combinator.
+ *
+ * @param keyword the keyword specifying what kind of processing is to be done on the imported
+ * names
+ */
+ Combinator(this.keyword);
+
+ @override
+ Token get beginToken => keyword;
+}
+
+/**
+ * Instances of the class `Comment` represent a comment within the source code.
+ *
+ * <pre>
+ * comment ::=
+ * endOfLineComment
+ * | blockComment
+ * | documentationComment
+ *
+ * endOfLineComment ::=
+ * '//' (CHARACTER - EOL)* EOL
+ *
+ * blockComment ::=
+ * '/ *' CHARACTER* '&#42;/'
+ *
+ * documentationComment ::=
+ * '/ **' (CHARACTER | [CommentReference])* '&#42;/'
+ * | ('///' (CHARACTER - EOL)* EOL)+
+ * </pre>
+ */
+class Comment extends AstNode {
+ /**
+ * Create a block comment.
+ *
+ * @param tokens the tokens representing the comment
+ * @return the block comment that was created
+ */
+ static Comment createBlockComment(List<Token> tokens) => new Comment(tokens, CommentType.BLOCK, null);
+
+ /**
+ * Create a documentation comment.
+ *
+ * @param tokens the tokens representing the comment
+ * @return the documentation comment that was created
+ */
+ static Comment createDocumentationComment(List<Token> tokens) => new Comment(tokens, CommentType.DOCUMENTATION, new List<CommentReference>());
+
+ /**
+ * Create a documentation comment.
+ *
+ * @param tokens the tokens representing the comment
+ * @param references the references embedded within the documentation comment
+ * @return the documentation comment that was created
+ */
+ static Comment createDocumentationCommentWithReferences(List<Token> tokens, List<CommentReference> references) => new Comment(tokens, CommentType.DOCUMENTATION, references);
+
+ /**
+ * Create an end-of-line comment.
+ *
+ * @param tokens the tokens representing the comment
+ * @return the end-of-line comment that was created
+ */
+ static Comment createEndOfLineComment(List<Token> tokens) => new Comment(tokens, CommentType.END_OF_LINE, null);
+
+ /**
+ * The tokens representing the comment.
+ */
+ final List<Token> tokens;
+
+ /**
+ * The type of the comment.
+ */
+ final CommentType _type;
+
+ /**
+ * The references embedded within the documentation comment. This list will be empty unless this
+ * is a documentation comment that has references embedded within it.
+ */
+ NodeList<CommentReference> _references;
+
+ /**
+ * Initialize a newly created comment.
+ *
+ * @param tokens the tokens representing the comment
+ * @param type the type of the comment
+ * @param references the references embedded within the documentation comment
+ */
+ Comment(this.tokens, this._type, List<CommentReference> references) {
+ this._references = new NodeList<CommentReference>(this);
+ this._references.addAll(references);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitComment(this);
+
+ @override
+ Token get beginToken => tokens[0];
+
+ @override
+ Token get endToken => tokens[tokens.length - 1];
+
+ /**
+ * Return the references embedded within the documentation comment.
+ *
+ * @return the references embedded within the documentation comment
+ */
+ NodeList<CommentReference> get references => _references;
+
+ /**
+ * Return `true` if this is a block comment.
+ *
+ * @return `true` if this is a block comment
+ */
+ bool get isBlock => _type == CommentType.BLOCK;
+
+ /**
+ * Return `true` if this is a documentation comment.
+ *
+ * @return `true` if this is a documentation comment
+ */
+ bool get isDocumentation => _type == CommentType.DOCUMENTATION;
+
+ /**
+ * Return `true` if this is an end-of-line comment.
+ *
+ * @return `true` if this is an end-of-line comment
+ */
+ bool get isEndOfLine => _type == CommentType.END_OF_LINE;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _references.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `CommentReference` represent a reference to a Dart element that is
+ * found within a documentation comment.
+ *
+ * <pre>
+ * commentReference ::=
+ * '[' 'new'? [Identifier] ']'
+ * </pre>
+ */
+class CommentReference extends AstNode {
+ /**
+ * The token representing the 'new' keyword, or `null` if there was no 'new' keyword.
+ */
+ Token newKeyword;
+
+ /**
+ * The identifier being referenced.
+ */
+ Identifier _identifier;
+
+ /**
+ * Initialize a newly created reference to a Dart element.
+ *
+ * @param newKeyword the token representing the 'new' keyword
+ * @param identifier the identifier being referenced
+ */
+ CommentReference(this.newKeyword, Identifier identifier) {
+ this._identifier = becomeParentOf(identifier);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitCommentReference(this);
+
+ @override
+ Token get beginToken => _identifier.beginToken;
+
+ @override
+ Token get endToken => _identifier.endToken;
+
+ /**
+ * Return the identifier being referenced.
+ *
+ * @return the identifier being referenced
+ */
+ Identifier get identifier => _identifier;
+
+ /**
+ * Set the identifier being referenced to the given identifier.
+ *
+ * @param identifier the identifier being referenced
+ */
+ void set identifier(Identifier identifier) {
+ this._identifier = becomeParentOf(identifier);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_identifier, visitor);
+ }
+}
+
+/**
+ * The enumeration `CommentType` encodes all the different types of comments that are
+ * recognized by the parser.
+ */
+class CommentType extends Enum<CommentType> {
+ /**
+ * An end-of-line comment.
+ */
+ static const CommentType END_OF_LINE = const CommentType('END_OF_LINE', 0);
+
+ /**
+ * A block comment.
+ */
+ static const CommentType BLOCK = const CommentType('BLOCK', 1);
+
+ /**
+ * A documentation comment.
+ */
+ static const CommentType DOCUMENTATION = const CommentType('DOCUMENTATION', 2);
+
+ static const List<CommentType> values = const [END_OF_LINE, BLOCK, DOCUMENTATION];
+
+ const CommentType(String name, int ordinal) : super(name, ordinal);
+}
+
+/**
+ * Instances of the class `CompilationUnit` represent a compilation unit.
+ *
+ * While the grammar restricts the order of the directives and declarations within a compilation
+ * unit, this class does not enforce those restrictions. In particular, the children of a
+ * compilation unit will be visited in lexical order even if lexical order does not conform to the
+ * restrictions of the grammar.
+ *
+ * <pre>
+ * compilationUnit ::=
+ * directives declarations
+ *
+ * directives ::=
+ * [ScriptTag]? [LibraryDirective]? namespaceDirective* [PartDirective]*
+ * | [PartOfDirective]
+ *
+ * namespaceDirective ::=
+ * [ImportDirective]
+ * | [ExportDirective]
+ *
+ * declarations ::=
+ * [CompilationUnitMember]*
+ * </pre>
+ */
+class CompilationUnit extends AstNode {
+ /**
+ * The first token in the token stream that was parsed to form this compilation unit.
+ */
+ final Token beginToken;
+
+ /**
+ * The script tag at the beginning of the compilation unit, or `null` if there is no script
+ * tag in this compilation unit.
+ */
+ ScriptTag _scriptTag;
+
+ /**
+ * The directives contained in this compilation unit.
+ */
+ NodeList<Directive> _directives;
+
+ /**
+ * The declarations contained in this compilation unit.
+ */
+ NodeList<CompilationUnitMember> _declarations;
+
+ /**
+ * The last token in the token stream that was parsed to form this compilation unit. This token
+ * should always have a type of [TokenType.EOF].
+ */
+ final Token endToken;
+
+ /**
+ * The element associated with this compilation unit, or `null` if the AST structure has not
+ * been resolved.
+ */
+ CompilationUnitElement element;
+
+ /**
+ * The line information for this compilation unit.
+ */
+ LineInfo lineInfo;
+
+ /**
+ * Initialize a newly created compilation unit to have the given directives and declarations.
+ *
+ * @param beginToken the first token in the token stream
+ * @param scriptTag the script tag at the beginning of the compilation unit
+ * @param directives the directives contained in this compilation unit
+ * @param declarations the declarations contained in this compilation unit
+ * @param endToken the last token in the token stream
+ */
+ CompilationUnit(this.beginToken, ScriptTag scriptTag, List<Directive> directives, List<CompilationUnitMember> declarations, this.endToken) {
+ this._directives = new NodeList<Directive>(this);
+ this._declarations = new NodeList<CompilationUnitMember>(this);
+ this._scriptTag = becomeParentOf(scriptTag);
+ this._directives.addAll(directives);
+ this._declarations.addAll(declarations);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitCompilationUnit(this);
+
+ /**
+ * Return the declarations contained in this compilation unit.
+ *
+ * @return the declarations contained in this compilation unit
+ */
+ NodeList<CompilationUnitMember> get declarations => _declarations;
+
+ /**
+ * Return the directives contained in this compilation unit.
+ *
+ * @return the directives contained in this compilation unit
+ */
+ NodeList<Directive> get directives => _directives;
+
+ @override
+ int get length {
+ Token endToken = this.endToken;
+ if (endToken == null) {
+ return 0;
+ }
+ return endToken.offset + endToken.length;
+ }
+
+ @override
+ int get offset => 0;
+
+ /**
+ * Return the script tag at the beginning of the compilation unit, or `null` if there is no
+ * script tag in this compilation unit.
+ *
+ * @return the script tag at the beginning of the compilation unit
+ */
+ ScriptTag get scriptTag => _scriptTag;
+
+ /**
+ * Set the script tag at the beginning of the compilation unit to the given script tag.
+ *
+ * @param scriptTag the script tag at the beginning of the compilation unit
+ */
+ void set scriptTag(ScriptTag scriptTag) {
+ this._scriptTag = becomeParentOf(scriptTag);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_scriptTag, visitor);
+ if (_directivesAreBeforeDeclarations()) {
+ _directives.accept(visitor);
+ _declarations.accept(visitor);
+ } else {
+ for (AstNode child in sortedDirectivesAndDeclarations) {
+ child.accept(visitor);
+ }
+ }
+ }
+
+ /**
+ * Return `true` if all of the directives are lexically before any declarations.
+ *
+ * @return `true` if all of the directives are lexically before any declarations
+ */
+ bool _directivesAreBeforeDeclarations() {
+ if (_directives.isEmpty || _declarations.isEmpty) {
+ return true;
+ }
+ Directive lastDirective = _directives[_directives.length - 1];
+ CompilationUnitMember firstDeclaration = _declarations[0];
+ return lastDirective.offset < firstDeclaration.offset;
+ }
+
+ /**
+ * Return an array containing all of the directives and declarations in this compilation unit,
+ * sorted in lexical order.
+ *
+ * @return the directives and declarations in this compilation unit in the order in which they
+ * appeared in the original source
+ */
+ List<AstNode> get sortedDirectivesAndDeclarations {
+ List<AstNode> childList = new List<AstNode>();
+ childList.addAll(_directives);
+ childList.addAll(_declarations);
+ List<AstNode> children = new List.from(childList);
+ children.sort(AstNode.LEXICAL_ORDER);
+ return children;
+ }
+}
+
+/**
+ * Instances of the class `CompilationUnitMember` defines the behavior common to nodes that
+ * declare a name within the scope of a compilation unit.
+ *
+ * <pre>
+ * compilationUnitMember ::=
+ * [ClassDeclaration]
+ * | [TypeAlias]
+ * | [FunctionDeclaration]
+ * | [MethodDeclaration]
+ * | [VariableDeclaration]
+ * | [VariableDeclaration]
+ * </pre>
+ */
+abstract class CompilationUnitMember extends Declaration {
+ /**
+ * Initialize a newly created generic compilation unit member.
+ *
+ * @param comment the documentation comment associated with this member
+ * @param metadata the annotations associated with this member
+ */
+ CompilationUnitMember(Comment comment, List<Annotation> metadata) : super(comment, metadata);
+}
+
+/**
+ * Instances of the class `ConditionalExpression` represent a conditional expression.
+ *
+ * <pre>
+ * conditionalExpression ::=
+ * [Expression] '?' [Expression] ':' [Expression]
+ * </pre>
+ */
+class ConditionalExpression extends Expression {
+ /**
+ * The condition used to determine which of the expressions is executed next.
+ */
+ Expression _condition;
+
+ /**
+ * The token used to separate the condition from the then expression.
+ */
+ Token question;
+
+ /**
+ * The expression that is executed if the condition evaluates to `true`.
+ */
+ Expression _thenExpression;
+
+ /**
+ * The token used to separate the then expression from the else expression.
+ */
+ Token colon;
+
+ /**
+ * The expression that is executed if the condition evaluates to `false`.
+ */
+ Expression _elseExpression;
+
+ /**
+ * Initialize a newly created conditional expression.
+ *
+ * @param condition the condition used to determine which expression is executed next
+ * @param question the token used to separate the condition from the then expression
+ * @param thenExpression the expression that is executed if the condition evaluates to
+ * `true`
+ * @param colon the token used to separate the then expression from the else expression
+ * @param elseExpression the expression that is executed if the condition evaluates to
+ * `false`
+ */
+ ConditionalExpression(Expression condition, this.question, Expression thenExpression, this.colon, Expression elseExpression) {
+ this._condition = becomeParentOf(condition);
+ this._thenExpression = becomeParentOf(thenExpression);
+ this._elseExpression = becomeParentOf(elseExpression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitConditionalExpression(this);
+
+ @override
+ Token get beginToken => _condition.beginToken;
+
+ /**
+ * Return the condition used to determine which of the expressions is executed next.
+ *
+ * @return the condition used to determine which expression is executed next
+ */
+ Expression get condition => _condition;
+
+ /**
+ * Return the expression that is executed if the condition evaluates to `false`.
+ *
+ * @return the expression that is executed if the condition evaluates to `false`
+ */
+ Expression get elseExpression => _elseExpression;
+
+ @override
+ Token get endToken => _elseExpression.endToken;
+
+ @override
+ int get precedence => 3;
+
+ /**
+ * Return the expression that is executed if the condition evaluates to `true`.
+ *
+ * @return the expression that is executed if the condition evaluates to `true`
+ */
+ Expression get thenExpression => _thenExpression;
+
+ /**
+ * Set the condition used to determine which of the expressions is executed next to the given
+ * expression.
+ *
+ * @param expression the condition used to determine which expression is executed next
+ */
+ void set condition(Expression expression) {
+ _condition = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the expression that is executed if the condition evaluates to `false` to the given
+ * expression.
+ *
+ * @param expression the expression that is executed if the condition evaluates to `false`
+ */
+ void set elseExpression(Expression expression) {
+ _elseExpression = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the expression that is executed if the condition evaluates to `true` to the given
+ * expression.
+ *
+ * @param expression the expression that is executed if the condition evaluates to `true`
+ */
+ void set thenExpression(Expression expression) {
+ _thenExpression = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_condition, visitor);
+ safelyVisitChild(_thenExpression, visitor);
+ safelyVisitChild(_elseExpression, visitor);
+ }
+}
+
+/**
+ * Instances of the class `ConstantEvaluator` evaluate constant expressions to produce their
+ * compile-time value. According to the Dart Language Specification: <blockquote> A constant
+ * expression is one of the following:
+ * * A literal number.
+ * * A literal boolean.
+ * * A literal string where any interpolated expression is a compile-time constant that evaluates
+ * to a numeric, string or boolean value or to `null`.
+ * * `null`.
+ * * A reference to a static constant variable.
+ * * An identifier expression that denotes a constant variable, a class or a type parameter.
+ * * A constant constructor invocation.
+ * * A constant list literal.
+ * * A constant map literal.
+ * * A simple or qualified identifier denoting a top-level function or a static method.
+ * * A parenthesized expression `(e)` where `e` is a constant expression.
+ * * An expression of one of the forms `identical(e1, e2)`, `e1 == e2`,
+ * `e1 != e2` where `e1` and `e2` are constant expressions that evaluate to a
+ * numeric, string or boolean value or to `null`.
+ * * An expression of one of the forms `!e`, `e1 && e2` or `e1 || e2`, where
+ * `e`, `e1` and `e2` are constant expressions that evaluate to a boolean value or
+ * to `null`.
+ * * An expression of one of the forms `~e`, `e1 ^ e2`, `e1 & e2`,
+ * `e1 | e2`, `e1 >> e2` or `e1 << e2`, where `e`, `e1` and `e2`
+ * are constant expressions that evaluate to an integer value or to `null`.
+ * * An expression of one of the forms `-e`, `e1 + e2`, `e1 - e2`,
+ * `e1 * e2`, `e1 / e2`, `e1 ~/ e2`, `e1 > e2`, `e1 < e2`,
+ * `e1 >= e2`, `e1 <= e2` or `e1 % e2`, where `e`, `e1` and `e2`
+ * are constant expressions that evaluate to a numeric value or to `null`.
+ * </blockquote> The values returned by instances of this class are therefore `null` and
+ * instances of the classes `Boolean`, `BigInteger`, `Double`, `String`, and
+ * `DartObject`.
+ *
+ * In addition, this class defines several values that can be returned to indicate various
+ * conditions encountered during evaluation. These are documented with the static field that define
+ * those values.
+ */
+class ConstantEvaluator extends GeneralizingAstVisitor<Object> {
+ /**
+ * The value returned for expressions (or non-expression nodes) that are not compile-time constant
+ * expressions.
+ */
+ static Object NOT_A_CONSTANT = new Object();
+
+ @override
+ Object visitAdjacentStrings(AdjacentStrings node) {
+ JavaStringBuilder builder = new JavaStringBuilder();
+ for (StringLiteral string in node.strings) {
+ Object value = string.accept(this);
+ if (identical(value, NOT_A_CONSTANT)) {
+ return value;
+ }
+ builder.append(value);
+ }
+ return builder.toString();
+ }
+
+ @override
+ Object visitBinaryExpression(BinaryExpression node) {
+ Object leftOperand = node.leftOperand.accept(this);
+ if (identical(leftOperand, NOT_A_CONSTANT)) {
+ return leftOperand;
+ }
+ Object rightOperand = node.rightOperand.accept(this);
+ if (identical(rightOperand, NOT_A_CONSTANT)) {
+ return rightOperand;
+ }
+ while (true) {
+ if (node.operator.type == TokenType.AMPERSAND) {
+ // integer or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand & rightOperand;
+ }
+ } else if (node.operator.type == TokenType.AMPERSAND_AMPERSAND) {
+ // boolean or {@code null}
+ if (leftOperand is bool && rightOperand is bool) {
+ return leftOperand && rightOperand;
+ }
+ } else if (node.operator.type == TokenType.BANG_EQ) {
+ // numeric, string, boolean, or {@code null}
+ if (leftOperand is bool && rightOperand is bool) {
+ return leftOperand != rightOperand;
+ } else if (leftOperand is int && rightOperand is int) {
+ return leftOperand != rightOperand;
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand != rightOperand;
+ } else if (leftOperand is String && rightOperand is String) {
+ return leftOperand != rightOperand;
+ }
+ } else if (node.operator.type == TokenType.BAR) {
+ // integer or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand | rightOperand;
+ }
+ } else if (node.operator.type == TokenType.BAR_BAR) {
+ // boolean or {@code null}
+ if (leftOperand is bool && rightOperand is bool) {
+ return leftOperand || rightOperand;
+ }
+ } else if (node.operator.type == TokenType.CARET) {
+ // integer or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand ^ rightOperand;
+ }
+ } else if (node.operator.type == TokenType.EQ_EQ) {
+ // numeric, string, boolean, or {@code null}
+ if (leftOperand is bool && rightOperand is bool) {
+ return leftOperand == rightOperand;
+ } else if (leftOperand is int && rightOperand is int) {
+ return leftOperand == rightOperand;
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand == rightOperand;
+ } else if (leftOperand is String && rightOperand is String) {
+ return leftOperand == rightOperand;
+ }
+ } else if (node.operator.type == TokenType.GT) {
+ // numeric or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand.compareTo(rightOperand) > 0;
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand.compareTo(rightOperand) > 0;
+ }
+ } else if (node.operator.type == TokenType.GT_EQ) {
+ // numeric or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand.compareTo(rightOperand) >= 0;
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand.compareTo(rightOperand) >= 0;
+ }
+ } else if (node.operator.type == TokenType.GT_GT) {
+ // integer or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand >> rightOperand;
+ }
+ } else if (node.operator.type == TokenType.LT) {
+ // numeric or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand.compareTo(rightOperand) < 0;
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand.compareTo(rightOperand) < 0;
+ }
+ } else if (node.operator.type == TokenType.LT_EQ) {
+ // numeric or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand.compareTo(rightOperand) <= 0;
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand.compareTo(rightOperand) <= 0;
+ }
+ } else if (node.operator.type == TokenType.LT_LT) {
+ // integer or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand << rightOperand;
+ }
+ } else if (node.operator.type == TokenType.MINUS) {
+ // numeric or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand - rightOperand;
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand - rightOperand;
+ }
+ } else if (node.operator.type == TokenType.PERCENT) {
+ // numeric or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand.remainder(rightOperand);
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand % rightOperand;
+ }
+ } else if (node.operator.type == TokenType.PLUS) {
+ // numeric or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand + rightOperand;
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand + rightOperand;
+ }
+ } else if (node.operator.type == TokenType.STAR) {
+ // numeric or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ return leftOperand * rightOperand;
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand * rightOperand;
+ }
+ } else if (node.operator.type == TokenType.SLASH) {
+ // numeric or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ if (rightOperand != 0) {
+ return leftOperand ~/ rightOperand;
+ } else {
+ return leftOperand.toDouble() / rightOperand.toDouble();
+ }
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand / rightOperand;
+ }
+ } else if (node.operator.type == TokenType.TILDE_SLASH) {
+ // numeric or {@code null}
+ if (leftOperand is int && rightOperand is int) {
+ if (rightOperand != 0) {
+ return leftOperand ~/ rightOperand;
+ } else {
+ return 0;
+ }
+ } else if (leftOperand is double && rightOperand is double) {
+ return leftOperand ~/ rightOperand;
+ }
+ } else {
+ }
+ break;
+ }
+ // TODO(brianwilkerson) This doesn't handle numeric conversions.
+ return visitExpression(node);
+ }
+
+ @override
+ Object visitBooleanLiteral(BooleanLiteral node) => node.value ? true : false;
+
+ @override
+ Object visitDoubleLiteral(DoubleLiteral node) => node.value;
+
+ @override
+ Object visitIntegerLiteral(IntegerLiteral node) => node.value;
+
+ @override
+ Object visitInterpolationExpression(InterpolationExpression node) {
+ Object value = node.expression.accept(this);
+ if (value == null || value is bool || value is String || value is int || value is double) {
+ return value;
+ }
+ return NOT_A_CONSTANT;
+ }
+
+ @override
+ Object visitInterpolationString(InterpolationString node) => node.value;
+
+ @override
+ Object visitListLiteral(ListLiteral node) {
+ List<Object> list = new List<Object>();
+ for (Expression element in node.elements) {
+ Object value = element.accept(this);
+ if (identical(value, NOT_A_CONSTANT)) {
+ return value;
+ }
+ list.add(value);
+ }
+ return list;
+ }
+
+ @override
+ Object visitMapLiteral(MapLiteral node) {
+ HashMap<String, Object> map = new HashMap<String, Object>();
+ for (MapLiteralEntry entry in node.entries) {
+ Object key = entry.key.accept(this);
+ Object value = entry.value.accept(this);
+ if (key is! String || identical(value, NOT_A_CONSTANT)) {
+ return NOT_A_CONSTANT;
+ }
+ map[(key as String)] = value;
+ }
+ return map;
+ }
+
+ @override
+ Object visitMethodInvocation(MethodInvocation node) => visitNode(node);
+
+ @override
+ Object visitNode(AstNode node) => NOT_A_CONSTANT;
+
+ @override
+ Object visitNullLiteral(NullLiteral node) => null;
+
+ @override
+ Object visitParenthesizedExpression(ParenthesizedExpression node) => node.expression.accept(this);
+
+ @override
+ Object visitPrefixedIdentifier(PrefixedIdentifier node) => _getConstantValue(null);
+
+ @override
+ Object visitPrefixExpression(PrefixExpression node) {
+ Object operand = node.operand.accept(this);
+ if (identical(operand, NOT_A_CONSTANT)) {
+ return operand;
+ }
+ while (true) {
+ if (node.operator.type == TokenType.BANG) {
+ if (identical(operand, true)) {
+ return false;
+ } else if (identical(operand, false)) {
+ return true;
+ }
+ } else if (node.operator.type == TokenType.TILDE) {
+ if (operand is int) {
+ return ~operand;
+ }
+ } else if (node.operator.type == TokenType.MINUS) {
+ if (operand == null) {
+ return null;
+ } else if (operand is int) {
+ return -operand;
+ } else if (operand is double) {
+ return -operand;
+ }
+ } else {
+ }
+ break;
+ }
+ return NOT_A_CONSTANT;
+ }
+
+ @override
+ Object visitPropertyAccess(PropertyAccess node) => _getConstantValue(null);
+
+ @override
+ Object visitSimpleIdentifier(SimpleIdentifier node) => _getConstantValue(null);
+
+ @override
+ Object visitSimpleStringLiteral(SimpleStringLiteral node) => node.value;
+
+ @override
+ Object visitStringInterpolation(StringInterpolation node) {
+ JavaStringBuilder builder = new JavaStringBuilder();
+ for (InterpolationElement element in node.elements) {
+ Object value = element.accept(this);
+ if (identical(value, NOT_A_CONSTANT)) {
+ return value;
+ }
+ builder.append(value);
+ }
+ return builder.toString();
+ }
+
+ @override
+ Object visitSymbolLiteral(SymbolLiteral node) {
+ // TODO(brianwilkerson) This isn't optimal because a Symbol is not a String.
+ JavaStringBuilder builder = new JavaStringBuilder();
+ for (Token component in node.components) {
+ if (builder.length > 0) {
+ builder.appendChar(0x2E);
+ }
+ builder.append(component.lexeme);
+ }
+ return builder.toString();
+ }
+
+ /**
+ * Return the constant value of the static constant represented by the given element.
+ *
+ * @param element the element whose value is to be returned
+ * @return the constant value of the static constant
+ */
+ Object _getConstantValue(Element element) {
+ // TODO(brianwilkerson) Implement this
+ if (element is FieldElement) {
+ FieldElement field = element;
+ if (field.isStatic && field.isConst) {
+ }
+ }
+ return NOT_A_CONSTANT;
+ }
+}
+
+/**
+ * Instances of the class `ConstructorDeclaration` represent a constructor declaration.
+ *
+ * <pre>
+ * constructorDeclaration ::=
+ * constructorSignature [FunctionBody]?
+ * | constructorName formalParameterList ':' 'this' ('.' [SimpleIdentifier])? arguments
+ *
+ * constructorSignature ::=
+ * 'external'? constructorName formalParameterList initializerList?
+ * | 'external'? 'factory' factoryName formalParameterList initializerList?
+ * | 'external'? 'const' constructorName formalParameterList initializerList?
+ *
+ * constructorName ::=
+ * [SimpleIdentifier] ('.' [SimpleIdentifier])?
+ *
+ * factoryName ::=
+ * [Identifier] ('.' [SimpleIdentifier])?
+ *
+ * initializerList ::=
+ * ':' [ConstructorInitializer] (',' [ConstructorInitializer])*
+ * </pre>
+ */
+class ConstructorDeclaration extends ClassMember {
+ /**
+ * The token for the 'external' keyword, or `null` if the constructor is not external.
+ */
+ Token externalKeyword;
+
+ /**
+ * The token for the 'const' keyword, or `null` if the constructor is not a const
+ * constructor.
+ */
+ Token constKeyword;
+
+ /**
+ * The token for the 'factory' keyword, or `null` if the constructor is not a factory
+ * constructor.
+ */
+ Token factoryKeyword;
+
+ /**
+ * The type of object being created. This can be different than the type in which the constructor
+ * is being declared if the constructor is the implementation of a factory constructor.
+ */
+ Identifier _returnType;
+
+ /**
+ * The token for the period before the constructor name, or `null` if the constructor being
+ * declared is unnamed.
+ */
+ Token period;
+
+ /**
+ * The name of the constructor, or `null` if the constructor being declared is unnamed.
+ */
+ SimpleIdentifier _name;
+
+ /**
+ * The parameters associated with the constructor.
+ */
+ FormalParameterList _parameters;
+
+ /**
+ * The token for the separator (colon or equals) before the initializer list or redirection, or
+ * `null` if there are no initializers.
+ */
+ Token separator;
+
+ /**
+ * The initializers associated with the constructor.
+ */
+ NodeList<ConstructorInitializer> _initializers;
+
+ /**
+ * The name of the constructor to which this constructor will be redirected, or `null` if
+ * this is not a redirecting factory constructor.
+ */
+ ConstructorName _redirectedConstructor;
+
+ /**
+ * The body of the constructor, or `null` if the constructor does not have a body.
+ */
+ FunctionBody _body;
+
+ /**
+ * The element associated with this constructor, or `null` if the AST structure has not been
+ * resolved or if this constructor could not be resolved.
+ */
+ ConstructorElement element;
+
+ /**
+ * Initialize a newly created constructor declaration.
+ *
+ * @param externalKeyword the token for the 'external' keyword
+ * @param comment the documentation comment associated with this constructor
+ * @param metadata the annotations associated with this constructor
+ * @param constKeyword the token for the 'const' keyword
+ * @param factoryKeyword the token for the 'factory' keyword
+ * @param returnType the return type of the constructor
+ * @param period the token for the period before the constructor name
+ * @param name the name of the constructor
+ * @param parameters the parameters associated with the constructor
+ * @param separator the token for the colon or equals before the initializers
+ * @param initializers the initializers associated with the constructor
+ * @param redirectedConstructor the name of the constructor to which this constructor will be
+ * redirected
+ * @param body the body of the constructor
+ */
+ ConstructorDeclaration(Comment comment, List<Annotation> metadata, this.externalKeyword, this.constKeyword, this.factoryKeyword, Identifier returnType, this.period, SimpleIdentifier name, FormalParameterList parameters, this.separator, List<ConstructorInitializer> initializers, ConstructorName redirectedConstructor, FunctionBody body) : super(comment, metadata) {
+ this._initializers = new NodeList<ConstructorInitializer>(this);
+ this._returnType = becomeParentOf(returnType);
+ this._name = becomeParentOf(name);
+ this._parameters = becomeParentOf(parameters);
+ this._initializers.addAll(initializers);
+ this._redirectedConstructor = becomeParentOf(redirectedConstructor);
+ this._body = becomeParentOf(body);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitConstructorDeclaration(this);
+
+ /**
+ * Return the body of the constructor, or `null` if the constructor does not have a body.
+ *
+ * @return the body of the constructor
+ */
+ FunctionBody get body => _body;
+
+ @override
+ Token get endToken {
+ if (_body != null) {
+ return _body.endToken;
+ } else if (!_initializers.isEmpty) {
+ return _initializers.endToken;
+ }
+ return _parameters.endToken;
+ }
+
+ /**
+ * Return the initializers associated with the constructor.
+ *
+ * @return the initializers associated with the constructor
+ */
+ NodeList<ConstructorInitializer> get initializers => _initializers;
+
+ /**
+ * Return the name of the constructor, or `null` if the constructor being declared is
+ * unnamed.
+ *
+ * @return the name of the constructor
+ */
+ SimpleIdentifier get name => _name;
+
+ /**
+ * Return the parameters associated with the constructor.
+ *
+ * @return the parameters associated with the constructor
+ */
+ FormalParameterList get parameters => _parameters;
+
+ /**
+ * Return the name of the constructor to which this constructor will be redirected, or
+ * `null` if this is not a redirecting factory constructor.
+ *
+ * @return the name of the constructor to which this constructor will be redirected
+ */
+ ConstructorName get redirectedConstructor => _redirectedConstructor;
+
+ /**
+ * Return the type of object being created. This can be different than the type in which the
+ * constructor is being declared if the constructor is the implementation of a factory
+ * constructor.
+ *
+ * @return the type of object being created
+ */
+ Identifier get returnType => _returnType;
+
+ /**
+ * Set the body of the constructor to the given function body.
+ *
+ * @param functionBody the body of the constructor
+ */
+ void set body(FunctionBody functionBody) {
+ _body = becomeParentOf(functionBody);
+ }
+
+ /**
+ * Set the name of the constructor to the given identifier.
+ *
+ * @param identifier the name of the constructor
+ */
+ void set name(SimpleIdentifier identifier) {
+ _name = becomeParentOf(identifier);
+ }
+
+ /**
+ * Set the parameters associated with the constructor to the given list of parameters.
+ *
+ * @param parameters the parameters associated with the constructor
+ */
+ void set parameters(FormalParameterList parameters) {
+ this._parameters = becomeParentOf(parameters);
+ }
+
+ /**
+ * Set the name of the constructor to which this constructor will be redirected to the given
+ * constructor name.
+ *
+ * @param redirectedConstructor the name of the constructor to which this constructor will be
+ * redirected
+ */
+ void set redirectedConstructor(ConstructorName redirectedConstructor) {
+ this._redirectedConstructor = becomeParentOf(redirectedConstructor);
+ }
+
+ /**
+ * Set the type of object being created to the given type name.
+ *
+ * @param typeName the type of object being created
+ */
+ void set returnType(Identifier typeName) {
+ _returnType = becomeParentOf(typeName);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_returnType, visitor);
+ safelyVisitChild(_name, visitor);
+ safelyVisitChild(_parameters, visitor);
+ _initializers.accept(visitor);
+ safelyVisitChild(_redirectedConstructor, visitor);
+ safelyVisitChild(_body, visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata {
+ Token leftMost = _leftMost([externalKeyword, constKeyword, factoryKeyword]);
+ if (leftMost != null) {
+ return leftMost;
+ }
+ return _returnType.beginToken;
+ }
+
+ /**
+ * Return the left-most of the given tokens, or `null` if there are no tokens given or if
+ * all of the given tokens are `null`.
+ *
+ * @param tokens the tokens being compared to find the left-most token
+ * @return the left-most of the given tokens
+ */
+ Token _leftMost(List<Token> tokens) {
+ Token leftMost = null;
+ int offset = 2147483647;
+ for (Token token in tokens) {
+ if (token != null && token.offset < offset) {
+ leftMost = token;
+ }
+ }
+ return leftMost;
+ }
+}
+
+/**
+ * Instances of the class `ConstructorFieldInitializer` represent the initialization of a
+ * field within a constructor's initialization list.
+ *
+ * <pre>
+ * fieldInitializer ::=
+ * ('this' '.')? [SimpleIdentifier] '=' [Expression]
+ * </pre>
+ */
+class ConstructorFieldInitializer extends ConstructorInitializer {
+ /**
+ * The token for the 'this' keyword, or `null` if there is no 'this' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The token for the period after the 'this' keyword, or `null` if there is no 'this'
+ * keyword.
+ */
+ Token period;
+
+ /**
+ * The name of the field being initialized.
+ */
+ SimpleIdentifier _fieldName;
+
+ /**
+ * The token for the equal sign between the field name and the expression.
+ */
+ Token equals;
+
+ /**
+ * The expression computing the value to which the field will be initialized.
+ */
+ Expression _expression;
+
+ /**
+ * Initialize a newly created field initializer to initialize the field with the given name to the
+ * value of the given expression.
+ *
+ * @param keyword the token for the 'this' keyword
+ * @param period the token for the period after the 'this' keyword
+ * @param fieldName the name of the field being initialized
+ * @param equals the token for the equal sign between the field name and the expression
+ * @param expression the expression computing the value to which the field will be initialized
+ */
+ ConstructorFieldInitializer(this.keyword, this.period, SimpleIdentifier fieldName, this.equals, Expression expression) {
+ this._fieldName = becomeParentOf(fieldName);
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitConstructorFieldInitializer(this);
+
+ @override
+ Token get beginToken {
+ if (keyword != null) {
+ return keyword;
+ }
+ return _fieldName.beginToken;
+ }
+
+ @override
+ Token get endToken => _expression.endToken;
+
+ /**
+ * Return the expression computing the value to which the field will be initialized.
+ *
+ * @return the expression computing the value to which the field will be initialized
+ */
+ Expression get expression => _expression;
+
+ /**
+ * Return the name of the field being initialized.
+ *
+ * @return the name of the field being initialized
+ */
+ SimpleIdentifier get fieldName => _fieldName;
+
+ /**
+ * Set the expression computing the value to which the field will be initialized to the given
+ * expression.
+ *
+ * @param expression the expression computing the value to which the field will be initialized
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the name of the field being initialized to the given identifier.
+ *
+ * @param identifier the name of the field being initialized
+ */
+ void set fieldName(SimpleIdentifier identifier) {
+ _fieldName = becomeParentOf(identifier);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_fieldName, visitor);
+ safelyVisitChild(_expression, visitor);
+ }
+}
+
+/**
+ * Instances of the class `ConstructorInitializer` defines the behavior of nodes that can
+ * occur in the initializer list of a constructor declaration.
+ *
+ * <pre>
+ * constructorInitializer ::=
+ * [SuperConstructorInvocation]
+ * | [ConstructorFieldInitializer]
+ * </pre>
+ */
+abstract class ConstructorInitializer extends AstNode {
+}
+
+/**
+ * Instances of the class `ConstructorName` represent the name of the constructor.
+ *
+ * <pre>
+ * constructorName:
+ * type ('.' identifier)?
+ * </pre>
+ */
+class ConstructorName extends AstNode {
+ /**
+ * The name of the type defining the constructor.
+ */
+ TypeName _type;
+
+ /**
+ * The token for the period before the constructor name, or `null` if the specified
+ * constructor is the unnamed constructor.
+ */
+ Token period;
+
+ /**
+ * The name of the constructor, or `null` if the specified constructor is the unnamed
+ * constructor.
+ */
+ SimpleIdentifier _name;
+
+ /**
+ * The element associated with this constructor name based on static type information, or
+ * `null` if the AST structure has not been resolved or if this constructor name could not
+ * be resolved.
+ */
+ ConstructorElement _staticElement;
+
+ /**
+ * Initialize a newly created constructor name.
+ *
+ * @param type the name of the type defining the constructor
+ * @param period the token for the period before the constructor name
+ * @param name the name of the constructor
+ */
+ ConstructorName(TypeName type, this.period, SimpleIdentifier name) {
+ this._type = becomeParentOf(type);
+ this._name = becomeParentOf(name);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitConstructorName(this);
+
+ @override
+ Token get beginToken => _type.beginToken;
+
+ @override
+ Token get endToken {
+ if (_name != null) {
+ return _name.endToken;
+ }
+ return _type.endToken;
+ }
+
+ /**
+ * Return the name of the constructor, or `null` if the specified constructor is the unnamed
+ * constructor.
+ *
+ * @return the name of the constructor
+ */
+ SimpleIdentifier get name => _name;
+
+ /**
+ * Return the element associated with this constructor name based on static type information, or
+ * `null` if the AST structure has not been resolved or if this constructor name could not
+ * be resolved.
+ *
+ * @return the element associated with this constructor name
+ */
+ ConstructorElement get staticElement => _staticElement;
+
+ /**
+ * Return the name of the type defining the constructor.
+ *
+ * @return the name of the type defining the constructor
+ */
+ TypeName get type => _type;
+
+ /**
+ * Set the name of the constructor to the given name.
+ *
+ * @param name the name of the constructor
+ */
+ void set name(SimpleIdentifier name) {
+ this._name = becomeParentOf(name);
+ }
+
+ /**
+ * Set the element associated with this constructor name based on static type information to the
+ * given element.
+ *
+ * @param element the element to be associated with this constructor name
+ */
+ void set staticElement(ConstructorElement element) {
+ _staticElement = element;
+ }
+
+ /**
+ * Set the name of the type defining the constructor to the given type name.
+ *
+ * @param type the name of the type defining the constructor
+ */
+ void set type(TypeName type) {
+ this._type = becomeParentOf(type);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_type, visitor);
+ safelyVisitChild(_name, visitor);
+ }
+}
+
+/**
+ * Instances of the class `ContinueStatement` represent a continue statement.
+ *
+ * <pre>
+ * continueStatement ::=
+ * 'continue' [SimpleIdentifier]? ';'
+ * </pre>
+ */
+class ContinueStatement extends Statement {
+ /**
+ * The token representing the 'continue' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The label associated with the statement, or `null` if there is no label.
+ */
+ SimpleIdentifier _label;
+
+ /**
+ * The semicolon terminating the statement.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created continue statement.
+ *
+ * @param keyword the token representing the 'continue' keyword
+ * @param label the label associated with the statement
+ * @param semicolon the semicolon terminating the statement
+ */
+ ContinueStatement(this.keyword, SimpleIdentifier label, this.semicolon) {
+ this._label = becomeParentOf(label);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitContinueStatement(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ @override
+ Token get endToken => semicolon;
+
+ /**
+ * Return the label associated with the statement, or `null` if there is no label.
+ *
+ * @return the label associated with the statement
+ */
+ SimpleIdentifier get label => _label;
+
+ /**
+ * Set the label associated with the statement to the given label.
+ *
+ * @param identifier the label associated with the statement
+ */
+ void set label(SimpleIdentifier identifier) {
+ _label = becomeParentOf(identifier);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_label, visitor);
+ }
+}
+
+/**
+ * The abstract class `Declaration` defines the behavior common to nodes that represent the
+ * declaration of a name. Each declared name is visible within a name scope.
+ */
+abstract class Declaration extends AnnotatedNode {
+ /**
+ * Initialize a newly created declaration.
+ *
+ * @param comment the documentation comment associated with this declaration
+ * @param metadata the annotations associated with this declaration
+ */
+ Declaration(Comment comment, List<Annotation> metadata) : super(comment, metadata);
+
+ /**
+ * Return the element associated with this declaration, or `null` if either this node
+ * corresponds to a list of declarations or if the AST structure has not been resolved.
+ *
+ * @return the element associated with this declaration
+ */
+ Element get element;
+}
+
+/**
+ * Instances of the class `DeclaredIdentifier` represent the declaration of a single
+ * identifier.
+ *
+ * <pre>
+ * declaredIdentifier ::=
+ * ([Annotation] finalConstVarOrType [SimpleIdentifier]
+ * </pre>
+ */
+class DeclaredIdentifier extends Declaration {
+ /**
+ * The token representing either the 'final', 'const' or 'var' keyword, or `null` if no
+ * keyword was used.
+ */
+ Token keyword;
+
+ /**
+ * The name of the declared type of the parameter, or `null` if the parameter does not have
+ * a declared type.
+ */
+ TypeName _type;
+
+ /**
+ * The name of the variable being declared.
+ */
+ SimpleIdentifier _identifier;
+
+ /**
+ * Initialize a newly created formal parameter.
+ *
+ * @param comment the documentation comment associated with this parameter
+ * @param metadata the annotations associated with this parameter
+ * @param keyword the token representing either the 'final', 'const' or 'var' keyword
+ * @param type the name of the declared type of the parameter
+ * @param identifier the name of the parameter being declared
+ */
+ DeclaredIdentifier(Comment comment, List<Annotation> metadata, this.keyword, TypeName type, SimpleIdentifier identifier) : super(comment, metadata) {
+ this._type = becomeParentOf(type);
+ this._identifier = becomeParentOf(identifier);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitDeclaredIdentifier(this);
+
+ @override
+ LocalVariableElement get element {
+ SimpleIdentifier identifier = this.identifier;
+ if (identifier == null) {
+ return null;
+ }
+ return identifier.staticElement as LocalVariableElement;
+ }
+
+ @override
+ Token get endToken => _identifier.endToken;
+
+ /**
+ * Return the name of the variable being declared.
+ *
+ * @return the name of the variable being declared
+ */
+ SimpleIdentifier get identifier => _identifier;
+
+ /**
+ * Return the name of the declared type of the parameter, or `null` if the parameter does
+ * not have a declared type.
+ *
+ * @return the name of the declared type of the parameter
+ */
+ TypeName get type => _type;
+
+ /**
+ * Return `true` if this variable was declared with the 'const' modifier.
+ *
+ * @return `true` if this variable was declared with the 'const' modifier
+ */
+ bool get isConst => (keyword is KeywordToken) && (keyword as KeywordToken).keyword == Keyword.CONST;
+
+ /**
+ * Return `true` if this variable was declared with the 'final' modifier. Variables that are
+ * declared with the 'const' modifier will return `false` even though they are implicitly
+ * final.
+ *
+ * @return `true` if this variable was declared with the 'final' modifier
+ */
+ bool get isFinal => (keyword is KeywordToken) && (keyword as KeywordToken).keyword == Keyword.FINAL;
+
+ /**
+ * Set the name of the variable being declared to the given name.
+ *
+ * @param identifier the new name of the variable being declared
+ */
+ void set identifier(SimpleIdentifier identifier) {
+ this._identifier = becomeParentOf(identifier);
+ }
+
+ /**
+ * Set the name of the declared type of the parameter to the given type name.
+ *
+ * @param typeName the name of the declared type of the parameter
+ */
+ void set type(TypeName typeName) {
+ _type = becomeParentOf(typeName);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_type, visitor);
+ safelyVisitChild(_identifier, visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata {
+ if (keyword != null) {
+ return keyword;
+ } else if (_type != null) {
+ return _type.beginToken;
+ }
+ return _identifier.beginToken;
+ }
+}
+
+/**
+ * Instances of the class `DefaultFormalParameter` represent a formal parameter with a default
+ * value. There are two kinds of parameters that are both represented by this class: named formal
+ * parameters and positional formal parameters.
+ *
+ * <pre>
+ * defaultFormalParameter ::=
+ * [NormalFormalParameter] ('=' [Expression])?
+ *
+ * defaultNamedParameter ::=
+ * [NormalFormalParameter] (':' [Expression])?
+ * </pre>
+ */
+class DefaultFormalParameter extends FormalParameter {
+ /**
+ * The formal parameter with which the default value is associated.
+ */
+ NormalFormalParameter _parameter;
+
+ /**
+ * The kind of this parameter.
+ */
+ ParameterKind kind;
+
+ /**
+ * The token separating the parameter from the default value, or `null` if there is no
+ * default value.
+ */
+ Token separator;
+
+ /**
+ * The expression computing the default value for the parameter, or `null` if there is no
+ * default value.
+ */
+ Expression _defaultValue;
+
+ /**
+ * Initialize a newly created default formal parameter.
+ *
+ * @param parameter the formal parameter with which the default value is associated
+ * @param kind the kind of this parameter
+ * @param separator the token separating the parameter from the default value
+ * @param defaultValue the expression computing the default value for the parameter
+ */
+ DefaultFormalParameter(NormalFormalParameter parameter, this.kind, this.separator, Expression defaultValue) {
+ this._parameter = becomeParentOf(parameter);
+ this._defaultValue = becomeParentOf(defaultValue);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitDefaultFormalParameter(this);
+
+ @override
+ Token get beginToken => _parameter.beginToken;
+
+ /**
+ * Return the expression computing the default value for the parameter, or `null` if there
+ * is no default value.
+ *
+ * @return the expression computing the default value for the parameter
+ */
+ Expression get defaultValue => _defaultValue;
+
+ @override
+ Token get endToken {
+ if (_defaultValue != null) {
+ return _defaultValue.endToken;
+ }
+ return _parameter.endToken;
+ }
+
+ @override
+ SimpleIdentifier get identifier => _parameter.identifier;
+
+ /**
+ * Return the formal parameter with which the default value is associated.
+ *
+ * @return the formal parameter with which the default value is associated
+ */
+ NormalFormalParameter get parameter => _parameter;
+
+ @override
+ bool get isConst => _parameter != null && _parameter.isConst;
+
+ @override
+ bool get isFinal => _parameter != null && _parameter.isFinal;
+
+ /**
+ * Set the expression computing the default value for the parameter to the given expression.
+ *
+ * @param expression the expression computing the default value for the parameter
+ */
+ void set defaultValue(Expression expression) {
+ _defaultValue = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the formal parameter with which the default value is associated to the given parameter.
+ *
+ * @param formalParameter the formal parameter with which the default value is associated
+ */
+ void set parameter(NormalFormalParameter formalParameter) {
+ _parameter = becomeParentOf(formalParameter);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_parameter, visitor);
+ safelyVisitChild(_defaultValue, visitor);
+ }
+}
+
+/**
+ * This recursive Ast visitor is used to run over [Expression]s to determine if the expression
+ * is composed by at least one deferred [PrefixedIdentifier].
+ *
+ * @see PrefixedIdentifier#isDeferred()
+ */
+class DeferredLibraryReferenceDetector extends RecursiveAstVisitor<Object> {
+ bool _result = false;
+
+ /**
+ * Return the result, `true` if the visitor found a [PrefixedIdentifier] that returned
+ * `true` to the [PrefixedIdentifier#isDeferred] query.
+ *
+ * @return `true` if the visitor found a [PrefixedIdentifier] that returned
+ * `true` to the [PrefixedIdentifier#isDeferred] query
+ */
+ bool get result => _result;
+
+ @override
+ Object visitPrefixedIdentifier(PrefixedIdentifier node) {
+ // If result is already true, skip.
+ if (!_result) {
+ // Set result to true if isDeferred() is true
+ if (node.isDeferred) {
+ _result = true;
+ }
+ }
+ return null;
+ }
+}
+
+/**
+ * The abstract class `Directive` defines the behavior common to nodes that represent a
+ * directive.
+ *
+ * <pre>
+ * directive ::=
+ * [ExportDirective]
+ * | [ImportDirective]
+ * | [LibraryDirective]
+ * | [PartDirective]
+ * | [PartOfDirective]
+ * </pre>
+ */
+abstract class Directive extends AnnotatedNode {
+ /**
+ * The element associated with this directive, or `null` if the AST structure has not been
+ * resolved or if this directive could not be resolved.
+ */
+ Element _element;
+
+ /**
+ * Initialize a newly create directive.
+ *
+ * @param comment the documentation comment associated with this directive
+ * @param metadata the annotations associated with the directive
+ */
+ Directive(Comment comment, List<Annotation> metadata) : super(comment, metadata);
+
+ /**
+ * Return the element associated with this directive, or `null` if the AST structure has not
+ * been resolved or if this directive could not be resolved. Examples of the latter case include a
+ * directive that contains an invalid URL or a URL that does not exist.
+ *
+ * @return the element associated with this directive
+ */
+ Element get element => _element;
+
+ /**
+ * Return the token representing the keyword that introduces this directive ('import', 'export',
+ * 'library' or 'part').
+ *
+ * @return the token representing the keyword that introduces this directive
+ */
+ Token get keyword;
+
+ /**
+ * Set the element associated with this directive to the given element.
+ *
+ * @param element the element associated with this directive
+ */
+ void set element(Element element) {
+ this._element = element;
+ }
+}
+
+/**
+ * Instances of the class `DoStatement` represent a do statement.
+ *
+ * <pre>
+ * doStatement ::=
+ * 'do' [Statement] 'while' '(' [Expression] ')' ';'
+ * </pre>
+ */
+class DoStatement extends Statement {
+ /**
+ * The token representing the 'do' keyword.
+ */
+ Token doKeyword;
+
+ /**
+ * The body of the loop.
+ */
+ Statement _body;
+
+ /**
+ * The token representing the 'while' keyword.
+ */
+ Token whileKeyword;
+
+ /**
+ * The left parenthesis.
+ */
+ Token _leftParenthesis;
+
+ /**
+ * The condition that determines when the loop will terminate.
+ */
+ Expression _condition;
+
+ /**
+ * The right parenthesis.
+ */
+ Token _rightParenthesis;
+
+ /**
+ * The semicolon terminating the statement.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created do loop.
+ *
+ * @param doKeyword the token representing the 'do' keyword
+ * @param body the body of the loop
+ * @param whileKeyword the token representing the 'while' keyword
+ * @param leftParenthesis the left parenthesis
+ * @param condition the condition that determines when the loop will terminate
+ * @param rightParenthesis the right parenthesis
+ * @param semicolon the semicolon terminating the statement
+ */
+ DoStatement(this.doKeyword, Statement body, this.whileKeyword, Token leftParenthesis, Expression condition, Token rightParenthesis, this.semicolon) {
+ this._body = becomeParentOf(body);
+ this._leftParenthesis = leftParenthesis;
+ this._condition = becomeParentOf(condition);
+ this._rightParenthesis = rightParenthesis;
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitDoStatement(this);
+
+ @override
+ Token get beginToken => doKeyword;
+
+ /**
+ * Return the body of the loop.
+ *
+ * @return the body of the loop
+ */
+ Statement get body => _body;
+
+ /**
+ * Return the condition that determines when the loop will terminate.
+ *
+ * @return the condition that determines when the loop will terminate
+ */
+ Expression get condition => _condition;
+
+ @override
+ Token get endToken => semicolon;
+
+ /**
+ * Return the left parenthesis.
+ *
+ * @return the left parenthesis
+ */
+ Token get leftParenthesis => _leftParenthesis;
+
+ /**
+ * Return the right parenthesis.
+ *
+ * @return the right parenthesis
+ */
+ Token get rightParenthesis => _rightParenthesis;
+
+ /**
+ * Set the body of the loop to the given statement.
+ *
+ * @param statement the body of the loop
+ */
+ void set body(Statement statement) {
+ _body = becomeParentOf(statement);
+ }
+
+ /**
+ * Set the condition that determines when the loop will terminate to the given expression.
+ *
+ * @param expression the condition that determines when the loop will terminate
+ */
+ void set condition(Expression expression) {
+ _condition = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the left parenthesis to the given token.
+ *
+ * @param parenthesis the left parenthesis
+ */
+ void set leftParenthesis(Token parenthesis) {
+ _leftParenthesis = parenthesis;
+ }
+
+ /**
+ * Set the right parenthesis to the given token.
+ *
+ * @param parenthesis the right parenthesis
+ */
+ void set rightParenthesis(Token parenthesis) {
+ _rightParenthesis = parenthesis;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_body, visitor);
+ safelyVisitChild(_condition, visitor);
+ }
+}
+
+/**
+ * Instances of the class `DoubleLiteral` represent a floating point literal expression.
+ *
+ * <pre>
+ * doubleLiteral ::=
+ * decimalDigit+ ('.' decimalDigit*)? exponent?
+ * | '.' decimalDigit+ exponent?
+ *
+ * exponent ::=
+ * ('e' | 'E') ('+' | '-')? decimalDigit+
+ * </pre>
+ */
+class DoubleLiteral extends Literal {
+ /**
+ * The token representing the literal.
+ */
+ Token literal;
+
+ /**
+ * The value of the literal.
+ */
+ double value = 0.0;
+
+ /**
+ * Initialize a newly created floating point literal.
+ *
+ * @param literal the token representing the literal
+ * @param value the value of the literal
+ */
+ DoubleLiteral(this.literal, this.value);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitDoubleLiteral(this);
+
+ @override
+ Token get beginToken => literal;
+
+ @override
+ Token get endToken => literal;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * Instances of the class `ElementLocator` locate the [Element]
+ * associated with a given [AstNode].
+ */
+class ElementLocator {
+ /**
+ * Locate the [Element] associated with the given [AstNode].
+ *
+ * @param node the node (not `null`)
+ * @return the associated element, or `null` if none is found
+ */
+ static Element locate(AstNode node) {
+ ElementLocator_ElementMapper mapper = new ElementLocator_ElementMapper();
+ return node.accept(mapper);
+ }
+
+ /**
+ * Locate the [Element] associated with the given [AstNode] and offset.
+ *
+ * @param node the node (not `null`)
+ * @param offset the offset relative to source
+ * @return the associated element, or `null` if none is found
+ */
+ static Element locateWithOffset(AstNode node, int offset) {
+ if (node == null) {
+ return null;
+ }
+ // try to get Element from node
+ {
+ Element nodeElement = locate(node);
+ if (nodeElement != null) {
+ return nodeElement;
+ }
+ }
+ // try to get Angular specific Element
+ {
+ Element element = null;
+ if (element != null) {
+ return element;
+ }
+ }
+ // try to get Polymer specific Element
+ {
+ Element element = null;
+ if (element != null) {
+ return element;
+ }
+ }
+ // no Element
+ return null;
+ }
+}
+
+/**
+ * Visitor that maps nodes to elements.
+ */
+class ElementLocator_ElementMapper extends GeneralizingAstVisitor<Element> {
+ @override
+ Element visitAnnotation(Annotation node) => node.element;
+
+ @override
+ Element visitAssignmentExpression(AssignmentExpression node) => node.bestElement;
+
+ @override
+ Element visitBinaryExpression(BinaryExpression node) => node.bestElement;
+
+ @override
+ Element visitClassDeclaration(ClassDeclaration node) => node.element;
+
+ @override
+ Element visitCompilationUnit(CompilationUnit node) => node.element;
+
+ @override
+ Element visitConstructorDeclaration(ConstructorDeclaration node) => node.element;
+
+ @override
+ Element visitFunctionDeclaration(FunctionDeclaration node) => node.element;
+
+ @override
+ Element visitIdentifier(Identifier node) {
+ AstNode parent = node.parent;
+ // Type name in Annotation
+ if (parent is Annotation) {
+ Annotation annotation = parent;
+ if (identical(annotation.name, node) && annotation.constructorName == null) {
+ return annotation.element;
+ }
+ }
+ // Type name in InstanceCreationExpression
+ {
+ AstNode typeNameCandidate = parent;
+ // new prefix.node[.constructorName]()
+ if (typeNameCandidate is PrefixedIdentifier) {
+ PrefixedIdentifier prefixedIdentifier = typeNameCandidate as PrefixedIdentifier;
+ if (identical(prefixedIdentifier.identifier, node)) {
+ typeNameCandidate = prefixedIdentifier.parent;
+ }
+ }
+ // new typeName[.constructorName]()
+ if (typeNameCandidate is TypeName) {
+ TypeName typeName = typeNameCandidate as TypeName;
+ if (typeName.parent is ConstructorName) {
+ ConstructorName constructorName = typeName.parent as ConstructorName;
+ return constructorName.staticElement;
+ }
+ }
+ }
+ // Extra work to map Constructor Declarations to their associated Constructor Elements
+ if (parent is ConstructorDeclaration) {
+ ConstructorDeclaration decl = parent;
+ Identifier returnType = decl.returnType;
+ if (identical(returnType, node)) {
+ SimpleIdentifier name = decl.name;
+ if (name != null) {
+ return name.bestElement;
+ }
+ Element element = node.bestElement;
+ if (element is ClassElement) {
+ return element.unnamedConstructor;
+ }
+ }
+ }
+ if (parent is LibraryIdentifier) {
+ AstNode grandParent = parent.parent;
+ if (grandParent is PartOfDirective) {
+ Element element = grandParent.element;
+ if (element is LibraryElement) {
+ return element.definingCompilationUnit;
+ }
+ }
+ }
+ return node.bestElement;
+ }
+
+ @override
+ Element visitImportDirective(ImportDirective node) => node.element;
+
+ @override
+ Element visitIndexExpression(IndexExpression node) => node.bestElement;
+
+ @override
+ Element visitInstanceCreationExpression(InstanceCreationExpression node) => node.staticElement;
+
+ @override
+ Element visitLibraryDirective(LibraryDirective node) => node.element;
+
+ @override
+ Element visitMethodDeclaration(MethodDeclaration node) => node.element;
+
+ @override
+ Element visitMethodInvocation(MethodInvocation node) => node.methodName.bestElement;
+
+ @override
+ Element visitPostfixExpression(PostfixExpression node) => node.bestElement;
+
+ @override
+ Element visitPrefixedIdentifier(PrefixedIdentifier node) => node.bestElement;
+
+ @override
+ Element visitPrefixExpression(PrefixExpression node) => node.bestElement;
+
+ @override
+ Element visitStringLiteral(StringLiteral node) {
+ AstNode parent = node.parent;
+ if (parent is UriBasedDirective) {
+ return parent.uriElement;
+ }
+ return null;
+ }
+
+ @override
+ Element visitVariableDeclaration(VariableDeclaration node) => node.element;
+}
+
+/**
+ * Instances of the class `EmptyFunctionBody` represent an empty function body, which can only
+ * appear in constructors or abstract methods.
+ *
+ * <pre>
+ * emptyFunctionBody ::=
+ * ';'
+ * </pre>
+ */
+class EmptyFunctionBody extends FunctionBody {
+ /**
+ * The token representing the semicolon that marks the end of the function body.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created function body.
+ *
+ * @param semicolon the token representing the semicolon that marks the end of the function body
+ */
+ EmptyFunctionBody(this.semicolon);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitEmptyFunctionBody(this);
+
+ @override
+ Token get beginToken => semicolon;
+
+ @override
+ Token get endToken => semicolon;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * Instances of the class `EmptyStatement` represent an empty statement.
+ *
+ * <pre>
+ * emptyStatement ::=
+ * ';'
+ * </pre>
+ */
+class EmptyStatement extends Statement {
+ /**
+ * The semicolon terminating the statement.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created empty statement.
+ *
+ * @param semicolon the semicolon terminating the statement
+ */
+ EmptyStatement(this.semicolon);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitEmptyStatement(this);
+
+ @override
+ Token get beginToken => semicolon;
+
+ @override
+ Token get endToken => semicolon;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * Instances of the class `EnumConstantDeclaration` represent the declaration of an enum
+ * constant.
+ */
+class EnumConstantDeclaration extends Declaration {
+ /**
+ * The name of the constant.
+ */
+ SimpleIdentifier _name;
+
+ /**
+ * Initialize a newly created enum constant declaration.
+ *
+ * @param comment the documentation comment associated with this declaration
+ * @param metadata the annotations associated with this declaration
+ * @param name the name of the constant
+ */
+ EnumConstantDeclaration(Comment comment, List<Annotation> metadata, SimpleIdentifier name) : super(comment, metadata) {
+ this._name = becomeParentOf(name);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitEnumConstantDeclaration(this);
+
+ @override
+ FieldElement get element => _name == null ? null : (_name.staticElement as FieldElement);
+
+ @override
+ Token get endToken => _name.endToken;
+
+ /**
+ * Return the name of the constant.
+ *
+ * @return the name of the constant
+ */
+ SimpleIdentifier get name => _name;
+
+ /**
+ * Set the name of the constant to the given name.
+ *
+ * @param name the name of the constant
+ */
+ void set name(SimpleIdentifier name) {
+ this._name = becomeParentOf(name);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata => _name.beginToken;
+}
+
+/**
+ * Instances of the class `EnumDeclaration` represent the declaration of an enumeration.
+ *
+ * <pre>
+ * enumType ::=
+ * metadata 'enum' [SimpleIdentifier] '{' [SimpleIdentifier] (',' [SimpleIdentifier])* (',')? '}'
+ * </pre>
+ */
+class EnumDeclaration extends CompilationUnitMember {
+ /**
+ * The 'enum' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The name of the enumeration.
+ */
+ SimpleIdentifier _name;
+
+ /**
+ * The left curly bracket.
+ */
+ Token leftBracket;
+
+ /**
+ * The enumeration constants being declared.
+ */
+ NodeList<EnumConstantDeclaration> _constants;
+
+ /**
+ * The right curly bracket.
+ */
+ Token rightBracket;
+
+ /**
+ * Initialize a newly created enumeration declaration.
+ *
+ * @param comment the documentation comment associated with this member
+ * @param metadata the annotations associated with this member
+ * @param keyword the 'enum' keyword
+ * @param name the name of the enumeration
+ * @param leftBracket the left curly bracket
+ * @param constants the enumeration constants being declared
+ * @param rightBracket the right curly bracket
+ */
+ EnumDeclaration(Comment comment, List<Annotation> metadata, this.keyword, SimpleIdentifier name, this.leftBracket, List<EnumConstantDeclaration> constants, this.rightBracket) : super(comment, metadata) {
+ this._constants = new NodeList<EnumConstantDeclaration>(this);
+ this._name = becomeParentOf(name);
+ this._constants.addAll(constants);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitEnumDeclaration(this);
+
+ /**
+ * Return the enumeration constants being declared.
+ *
+ * @return the enumeration constants being declared
+ */
+ NodeList<EnumConstantDeclaration> get constants => _constants;
+
+ @override
+ ClassElement get element => _name != null ? (_name.staticElement as ClassElement) : null;
+
+ @override
+ Token get endToken => rightBracket;
+
+ /**
+ * Return the name of the enumeration.
+ *
+ * @return the name of the enumeration
+ */
+ SimpleIdentifier get name => _name;
+
+ /**
+ * set the name of the enumeration to the given identifier.
+ *
+ * @param name the name of the enumeration
+ */
+ void set name(SimpleIdentifier name) {
+ this._name = becomeParentOf(name);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata => keyword;
+}
+
+/**
+ * Ephemeral identifiers are created as needed to mimic the presence of an empty identifier.
+ */
+class EphemeralIdentifier extends SimpleIdentifier {
+ EphemeralIdentifier(AstNode parent, int location) : super(new StringToken(TokenType.IDENTIFIER, "", location)) {
+ parent.becomeParentOf(this);
+ }
+}
+
+/**
+ * Instances of the class `ExportDirective` represent an export directive.
+ *
+ * <pre>
+ * exportDirective ::=
+ * [Annotation] 'export' [StringLiteral] [Combinator]* ';'
+ * </pre>
+ */
+class ExportDirective extends NamespaceDirective {
+ /**
+ * Initialize a newly created export directive.
+ *
+ * @param comment the documentation comment associated with this directive
+ * @param metadata the annotations associated with the directive
+ * @param keyword the token representing the 'export' keyword
+ * @param libraryUri the URI of the library being exported
+ * @param combinators the combinators used to control which names are exported
+ * @param semicolon the semicolon terminating the directive
+ */
+ ExportDirective(Comment comment, List<Annotation> metadata, Token keyword, StringLiteral libraryUri, List<Combinator> combinators, Token semicolon) : super(comment, metadata, keyword, libraryUri, combinators, semicolon);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitExportDirective(this);
+
+ @override
+ ExportElement get element => super.element as ExportElement;
+
+ @override
+ LibraryElement get uriElement {
+ ExportElement exportElement = element;
+ if (exportElement != null) {
+ return exportElement.exportedLibrary;
+ }
+ return null;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ combinators.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `Expression` defines the behavior common to nodes that represent an
+ * expression.
+ *
+ * <pre>
+ * expression ::=
+ * [AssignmentExpression]
+ * | [ConditionalExpression] cascadeSection*
+ * | [ThrowExpression]
+ * </pre>
+ */
+abstract class Expression extends AstNode {
+ /**
+ * An empty array of expressions.
+ */
+ static List<Expression> EMPTY_ARRAY = new List<Expression>(0);
+
+ /**
+ * The static type of this expression, or `null` if the AST structure has not been resolved.
+ */
+ DartType staticType;
+
+ /**
+ * The propagated type of this expression, or `null` if type propagation has not been
+ * performed on the AST structure.
+ */
+ DartType propagatedType;
+
+ /**
+ * Return the best parameter element information available for this expression. If type
+ * propagation was able to find a better parameter element than static analysis, that type will be
+ * returned. Otherwise, the result of static analysis will be returned.
+ *
+ * @return the parameter element representing the parameter to which the value of this expression
+ * will be bound
+ */
+ ParameterElement get bestParameterElement {
+ ParameterElement propagatedElement = propagatedParameterElement;
+ if (propagatedElement != null) {
+ return propagatedElement;
+ }
+ return staticParameterElement;
+ }
+
+ /**
+ * Return the best type information available for this expression. If type propagation was able to
+ * find a better type than static analysis, that type will be returned. Otherwise, the result of
+ * static analysis will be returned. If no type analysis has been performed, then the type
+ * 'dynamic' will be returned.
+ *
+ * @return the best type information available for this expression
+ */
+ DartType get bestType {
+ if (propagatedType != null) {
+ return propagatedType;
+ } else if (staticType != null) {
+ return staticType;
+ }
+ return DynamicTypeImpl.instance;
+ }
+
+ /**
+ * Return the precedence of this expression. The precedence is a positive integer value that
+ * defines how the source code is parsed into an AST. For example `a * b + c` is parsed as
+ * `(a * b) + c` because the precedence of `*` is greater than the precedence of
+ * `+`.
+ *
+ * You should not assume that returned values will stay the same, they might change as result of
+ * specification change. Only relative order should be used.
+ *
+ * @return the precedence of this expression
+ */
+ int get precedence;
+
+ /**
+ * If this expression is an argument to an invocation, and the AST structure has been resolved,
+ * and the function being invoked is known based on propagated type information, and this
+ * expression corresponds to one of the parameters of the function being invoked, then return the
+ * parameter element representing the parameter to which the value of this expression will be
+ * bound. Otherwise, return `null`.
+ *
+ * @return the parameter element representing the parameter to which the value of this expression
+ * will be bound
+ */
+ ParameterElement get propagatedParameterElement {
+ AstNode parent = this.parent;
+ if (parent is ArgumentList) {
+ return parent.getPropagatedParameterElementFor(this);
+ } else if (parent is IndexExpression) {
+ IndexExpression indexExpression = parent;
+ if (identical(indexExpression.index, this)) {
+ return indexExpression.propagatedParameterElementForIndex;
+ }
+ } else if (parent is BinaryExpression) {
+ BinaryExpression binaryExpression = parent;
+ if (identical(binaryExpression.rightOperand, this)) {
+ return binaryExpression.propagatedParameterElementForRightOperand;
+ }
+ } else if (parent is AssignmentExpression) {
+ AssignmentExpression assignmentExpression = parent;
+ if (identical(assignmentExpression.rightHandSide, this)) {
+ return assignmentExpression.propagatedParameterElementForRightHandSide;
+ }
+ } else if (parent is PrefixExpression) {
+ return parent.propagatedParameterElementForOperand;
+ } else if (parent is PostfixExpression) {
+ return parent.propagatedParameterElementForOperand;
+ }
+ return null;
+ }
+
+ /**
+ * If this expression is an argument to an invocation, and the AST structure has been resolved,
+ * and the function being invoked is known based on static type information, and this expression
+ * corresponds to one of the parameters of the function being invoked, then return the parameter
+ * element representing the parameter to which the value of this expression will be bound.
+ * Otherwise, return `null`.
+ *
+ * @return the parameter element representing the parameter to which the value of this expression
+ * will be bound
+ */
+ ParameterElement get staticParameterElement {
+ AstNode parent = this.parent;
+ if (parent is ArgumentList) {
+ return parent.getStaticParameterElementFor(this);
+ } else if (parent is IndexExpression) {
+ IndexExpression indexExpression = parent;
+ if (identical(indexExpression.index, this)) {
+ return indexExpression.staticParameterElementForIndex;
+ }
+ } else if (parent is BinaryExpression) {
+ BinaryExpression binaryExpression = parent;
+ if (identical(binaryExpression.rightOperand, this)) {
+ return binaryExpression.staticParameterElementForRightOperand;
+ }
+ } else if (parent is AssignmentExpression) {
+ AssignmentExpression assignmentExpression = parent;
+ if (identical(assignmentExpression.rightHandSide, this)) {
+ return assignmentExpression.staticParameterElementForRightHandSide;
+ }
+ } else if (parent is PrefixExpression) {
+ return parent.staticParameterElementForOperand;
+ } else if (parent is PostfixExpression) {
+ return parent.staticParameterElementForOperand;
+ }
+ return null;
+ }
+
+ /**
+ * Return `true` if this expression is syntactically valid for the LHS of an
+ * [AssignmentExpression].
+ *
+ * @return `true` if this expression matches the `assignableExpression` production
+ */
+ bool get isAssignable => false;
+}
+
+/**
+ * Instances of the class `ExpressionFunctionBody` represent a function body consisting of a
+ * single expression.
+ *
+ * <pre>
+ * expressionFunctionBody ::=
+ * 'async'? '=>' [Expression] ';'
+ * </pre>
+ */
+class ExpressionFunctionBody extends FunctionBody {
+ /**
+ * The token representing the 'async' keyword, or `null` if there is no such keyword.
+ */
+ Token keyword;
+
+ /**
+ * The token introducing the expression that represents the body of the function.
+ */
+ Token functionDefinition;
+
+ /**
+ * The expression representing the body of the function.
+ */
+ Expression _expression;
+
+ /**
+ * The semicolon terminating the statement.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created function body consisting of a block of statements.
+ *
+ * @param keyword the token representing the 'async' keyword
+ * @param functionDefinition the token introducing the expression that represents the body of the
+ * function
+ * @param expression the expression representing the body of the function
+ * @param semicolon the semicolon terminating the statement
+ */
+ ExpressionFunctionBody(this.keyword, this.functionDefinition, Expression expression, this.semicolon) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitExpressionFunctionBody(this);
+
+ @override
+ Token get beginToken => functionDefinition;
+
+ @override
+ Token get endToken {
+ if (semicolon != null) {
+ return semicolon;
+ }
+ return _expression.endToken;
+ }
+
+ /**
+ * Return the expression representing the body of the function.
+ *
+ * @return the expression representing the body of the function
+ */
+ Expression get expression => _expression;
+
+ @override
+ bool get isAsynchronous => keyword != null;
+
+ @override
+ bool get isSynchronous => keyword == null;
+
+ /**
+ * Set the expression representing the body of the function to the given expression.
+ *
+ * @param expression the expression representing the body of the function
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_expression, visitor);
+ }
+}
+
+/**
+ * Instances of the class `ExpressionStatement` wrap an expression as a statement.
+ *
+ * <pre>
+ * expressionStatement ::=
+ * [Expression]? ';'
+ * </pre>
+ */
+class ExpressionStatement extends Statement {
+ /**
+ * The expression that comprises the statement.
+ */
+ Expression _expression;
+
+ /**
+ * The semicolon terminating the statement, or `null` if the expression is a function
+ * expression and therefore isn't followed by a semicolon.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created expression statement.
+ *
+ * @param expression the expression that comprises the statement
+ * @param semicolon the semicolon terminating the statement
+ */
+ ExpressionStatement(Expression expression, this.semicolon) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitExpressionStatement(this);
+
+ @override
+ Token get beginToken => _expression.beginToken;
+
+ @override
+ Token get endToken {
+ if (semicolon != null) {
+ return semicolon;
+ }
+ return _expression.endToken;
+ }
+
+ /**
+ * Return the expression that comprises the statement.
+ *
+ * @return the expression that comprises the statement
+ */
+ Expression get expression => _expression;
+
+ @override
+ bool get isSynthetic => _expression.isSynthetic && semicolon.isSynthetic;
+
+ /**
+ * Set the expression that comprises the statement to the given expression.
+ *
+ * @param expression the expression that comprises the statement
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_expression, visitor);
+ }
+}
+
+/**
+ * Instances of the class `ExtendsClause` represent the "extends" clause in a class
+ * declaration.
+ *
+ * <pre>
+ * extendsClause ::=
+ * 'extends' [TypeName]
+ * </pre>
+ */
+class ExtendsClause extends AstNode {
+ /**
+ * The token representing the 'extends' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The name of the class that is being extended.
+ */
+ TypeName _superclass;
+
+ /**
+ * Initialize a newly created extends clause.
+ *
+ * @param keyword the token representing the 'extends' keyword
+ * @param superclass the name of the class that is being extended
+ */
+ ExtendsClause(this.keyword, TypeName superclass) {
+ this._superclass = becomeParentOf(superclass);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitExtendsClause(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ @override
+ Token get endToken => _superclass.endToken;
+
+ /**
+ * Return the name of the class that is being extended.
+ *
+ * @return the name of the class that is being extended
+ */
+ TypeName get superclass => _superclass;
+
+ /**
+ * Set the name of the class that is being extended to the given name.
+ *
+ * @param name the name of the class that is being extended
+ */
+ void set superclass(TypeName name) {
+ _superclass = becomeParentOf(name);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_superclass, visitor);
+ }
+}
+
+/**
+ * Instances of the class `FieldDeclaration` represent the declaration of one or more fields
+ * of the same type.
+ *
+ * <pre>
+ * fieldDeclaration ::=
+ * 'static'? [VariableDeclarationList] ';'
+ * </pre>
+ */
+class FieldDeclaration extends ClassMember {
+ /**
+ * The token representing the 'static' keyword, or `null` if the fields are not static.
+ */
+ Token staticKeyword;
+
+ /**
+ * The fields being declared.
+ */
+ VariableDeclarationList _fieldList;
+
+ /**
+ * The semicolon terminating the declaration.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created field declaration.
+ *
+ * @param comment the documentation comment associated with this field
+ * @param metadata the annotations associated with this field
+ * @param staticKeyword the token representing the 'static' keyword
+ * @param fieldList the fields being declared
+ * @param semicolon the semicolon terminating the declaration
+ */
+ FieldDeclaration(Comment comment, List<Annotation> metadata, this.staticKeyword, VariableDeclarationList fieldList, this.semicolon) : super(comment, metadata) {
+ this._fieldList = becomeParentOf(fieldList);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitFieldDeclaration(this);
+
+ @override
+ Element get element => null;
+
+ @override
+ Token get endToken => semicolon;
+
+ /**
+ * Return the fields being declared.
+ *
+ * @return the fields being declared
+ */
+ VariableDeclarationList get fields => _fieldList;
+
+ /**
+ * Return `true` if the fields are static.
+ *
+ * @return `true` if the fields are declared to be static
+ */
+ bool get isStatic => staticKeyword != null;
+
+ /**
+ * Set the fields being declared to the given list of variables.
+ *
+ * @param fieldList the fields being declared
+ */
+ void set fields(VariableDeclarationList fieldList) {
+ this._fieldList = becomeParentOf(fieldList);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_fieldList, visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata {
+ if (staticKeyword != null) {
+ return staticKeyword;
+ }
+ return _fieldList.beginToken;
+ }
+}
+
+/**
+ * Instances of the class `FieldFormalParameter` represent a field formal parameter.
+ *
+ * <pre>
+ * fieldFormalParameter ::=
+ * ('final' [TypeName] | 'const' [TypeName] | 'var' | [TypeName])? 'this' '.' [SimpleIdentifier] [FormalParameterList]?
+ * </pre>
+ */
+class FieldFormalParameter extends NormalFormalParameter {
+ /**
+ * The token representing either the 'final', 'const' or 'var' keyword, or `null` if no
+ * keyword was used.
+ */
+ Token keyword;
+
+ /**
+ * The name of the declared type of the parameter, or `null` if the parameter does not have
+ * a declared type.
+ */
+ TypeName _type;
+
+ /**
+ * The token representing the 'this' keyword.
+ */
+ Token thisToken;
+
+ /**
+ * The token representing the period.
+ */
+ Token period;
+
+ /**
+ * The parameters of the function-typed parameter, or `null` if this is not a function-typed
+ * field formal parameter.
+ */
+ FormalParameterList _parameters;
+
+ /**
+ * Initialize a newly created formal parameter.
+ *
+ * @param comment the documentation comment associated with this parameter
+ * @param metadata the annotations associated with this parameter
+ * @param keyword the token representing either the 'final', 'const' or 'var' keyword
+ * @param type the name of the declared type of the parameter
+ * @param thisToken the token representing the 'this' keyword
+ * @param period the token representing the period
+ * @param identifier the name of the parameter being declared
+ * @param parameters the parameters of the function-typed parameter, or `null` if this is
+ * not a function-typed field formal parameter
+ */
+ FieldFormalParameter(Comment comment, List<Annotation> metadata, this.keyword, TypeName type, this.thisToken, this.period, SimpleIdentifier identifier, FormalParameterList parameters) : super(comment, metadata, identifier) {
+ this._type = becomeParentOf(type);
+ this._parameters = becomeParentOf(parameters);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitFieldFormalParameter(this);
+
+ @override
+ Token get beginToken {
+ if (keyword != null) {
+ return keyword;
+ } else if (_type != null) {
+ return _type.beginToken;
+ }
+ return thisToken;
+ }
+
+ @override
+ Token get endToken => identifier.endToken;
+
+ /**
+ * Return the parameters of the function-typed parameter, or `null` if this is not a
+ * function-typed field formal parameter.
+ *
+ * @return the parameters of the function-typed parameter
+ */
+ FormalParameterList get parameters => _parameters;
+
+ /**
+ * Return the name of the declared type of the parameter, or `null` if the parameter does
+ * not have a declared type. Note that if this is a function-typed field formal parameter this is
+ * the return type of the function.
+ *
+ * @return the name of the declared type of the parameter
+ */
+ TypeName get type => _type;
+
+ @override
+ bool get isConst => (keyword is KeywordToken) && (keyword as KeywordToken).keyword == Keyword.CONST;
+
+ @override
+ bool get isFinal => (keyword is KeywordToken) && (keyword as KeywordToken).keyword == Keyword.FINAL;
+
+ /**
+ * Set the parameters of the function-typed parameter to the given parameters.
+ *
+ * @param parameters the parameters of the function-typed parameter
+ */
+ void set parameters(FormalParameterList parameters) {
+ this._parameters = becomeParentOf(parameters);
+ }
+
+ /**
+ * Set the name of the declared type of the parameter to the given type name.
+ *
+ * @param typeName the name of the declared type of the parameter
+ */
+ void set type(TypeName typeName) {
+ _type = becomeParentOf(typeName);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_type, visitor);
+ safelyVisitChild(identifier, visitor);
+ safelyVisitChild(_parameters, visitor);
+ }
+}
+
+/**
+ * Instances of the class `ForEachStatement` represent a for-each statement.
+ *
+ * <pre>
+ * forEachStatement ::=
+ * 'await'? 'for' '(' [DeclaredIdentifier] 'in' [Expression] ')' [Block]
+ * | 'await'? 'for' '(' [SimpleIdentifier] 'in' [Expression] ')' [Block]
+ * </pre>
+ */
+class ForEachStatement extends Statement {
+ /**
+ * The token representing the 'await' keyword, or `null` if there is no 'await' keyword.
+ */
+ Token awaitKeyword;
+
+ /**
+ * The token representing the 'for' keyword.
+ */
+ Token forKeyword;
+
+ /**
+ * The left parenthesis.
+ */
+ Token leftParenthesis;
+
+ /**
+ * The declaration of the loop variable, or `null` if the loop variable is a simple
+ * identifier.
+ */
+ DeclaredIdentifier _loopVariable;
+
+ /**
+ * The loop variable, or `null` if the loop variable is declared in the 'for'.
+ */
+ SimpleIdentifier _identifier;
+
+ /**
+ * The token representing the 'in' keyword.
+ */
+ Token inKeyword;
+
+ /**
+ * The expression evaluated to produce the iterator.
+ */
+ Expression _iterator;
+
+ /**
+ * The right parenthesis.
+ */
+ Token rightParenthesis;
+
+ /**
+ * The body of the loop.
+ */
+ Statement _body;
+
+ /**
+ * Initialize a newly created for-each statement.
+ *
+ * @param awaitKeyword the token representing the 'await' keyword
+ * @param forKeyword the token representing the 'for' keyword
+ * @param leftParenthesis the left parenthesis
+ * @param loopVariable the declaration of the loop variable
+ * @param iterator the expression evaluated to produce the iterator
+ * @param rightParenthesis the right parenthesis
+ * @param body the body of the loop
+ */
+ ForEachStatement.con1(this.awaitKeyword, this.forKeyword, this.leftParenthesis, DeclaredIdentifier loopVariable, this.inKeyword, Expression iterator, this.rightParenthesis, Statement body) {
+ this._loopVariable = becomeParentOf(loopVariable);
+ this._iterator = becomeParentOf(iterator);
+ this._body = becomeParentOf(body);
+ }
+
+ /**
+ * Initialize a newly created for-each statement.
+ *
+ * @param awaitKeyword the token representing the 'await' keyword
+ * @param forKeyword the token representing the 'for' keyword
+ * @param leftParenthesis the left parenthesis
+ * @param identifier the loop variable
+ * @param iterator the expression evaluated to produce the iterator
+ * @param rightParenthesis the right parenthesis
+ * @param body the body of the loop
+ */
+ ForEachStatement.con2(this.awaitKeyword, this.forKeyword, this.leftParenthesis, SimpleIdentifier identifier, this.inKeyword, Expression iterator, this.rightParenthesis, Statement body) {
+ this._identifier = becomeParentOf(identifier);
+ this._iterator = becomeParentOf(iterator);
+ this._body = becomeParentOf(body);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitForEachStatement(this);
+
+ @override
+ Token get beginToken => forKeyword;
+
+ /**
+ * Return the body of the loop.
+ *
+ * @return the body of the loop
+ */
+ Statement get body => _body;
+
+ @override
+ Token get endToken => _body.endToken;
+
+ /**
+ * Return the loop variable, or `null` if the loop variable is declared in the 'for'.
+ *
+ * @return the loop variable
+ */
+ SimpleIdentifier get identifier => _identifier;
+
+ /**
+ * Return the expression evaluated to produce the iterator.
+ *
+ * @return the expression evaluated to produce the iterator
+ */
+ Expression get iterator => _iterator;
+
+ /**
+ * Return the declaration of the loop variable, or `null` if the loop variable is a simple
+ * identifier.
+ *
+ * @return the declaration of the loop variable
+ */
+ DeclaredIdentifier get loopVariable => _loopVariable;
+
+ /**
+ * Set the body of the loop to the given block.
+ *
+ * @param body the body of the loop
+ */
+ void set body(Statement body) {
+ this._body = becomeParentOf(body);
+ }
+
+ /**
+ * Set the loop variable to the given variable.
+ *
+ * @param identifier the loop variable
+ */
+ void set identifier(SimpleIdentifier identifier) {
+ this._identifier = becomeParentOf(identifier);
+ }
+
+ /**
+ * Set the expression evaluated to produce the iterator to the given expression.
+ *
+ * @param expression the expression evaluated to produce the iterator
+ */
+ void set iterator(Expression expression) {
+ _iterator = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the declaration of the loop variable to the given variable.
+ *
+ * @param variable the declaration of the loop variable
+ */
+ void set loopVariable(DeclaredIdentifier variable) {
+ _loopVariable = becomeParentOf(variable);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_loopVariable, visitor);
+ safelyVisitChild(_identifier, visitor);
+ safelyVisitChild(_iterator, visitor);
+ safelyVisitChild(_body, visitor);
+ }
+}
+
+/**
+ * Instances of the class `ForStatement` represent a for statement.
+ *
+ * <pre>
+ * forStatement ::=
+ * 'for' '(' forLoopParts ')' [Statement]
+ *
+ * forLoopParts ::=
+ * forInitializerStatement ';' [Expression]? ';' [Expression]?
+ *
+ * forInitializerStatement ::=
+ * [DefaultFormalParameter]
+ * | [Expression]?
+ * </pre>
+ */
+class ForStatement extends Statement {
+ /**
+ * The token representing the 'for' keyword.
+ */
+ Token forKeyword;
+
+ /**
+ * The left parenthesis.
+ */
+ Token leftParenthesis;
+
+ /**
+ * The declaration of the loop variables, or `null` if there are no variables. Note that a
+ * for statement cannot have both a variable list and an initialization expression, but can
+ * validly have neither.
+ */
+ VariableDeclarationList _variableList;
+
+ /**
+ * The initialization expression, or `null` if there is no initialization expression. Note
+ * that a for statement cannot have both a variable list and an initialization expression, but can
+ * validly have neither.
+ */
+ Expression _initialization;
+
+ /**
+ * The semicolon separating the initializer and the condition.
+ */
+ Token leftSeparator;
+
+ /**
+ * The condition used to determine when to terminate the loop, or `null` if there is no
+ * condition.
+ */
+ Expression _condition;
+
+ /**
+ * The semicolon separating the condition and the updater.
+ */
+ Token rightSeparator;
+
+ /**
+ * The list of expressions run after each execution of the loop body.
+ */
+ NodeList<Expression> _updaters;
+
+ /**
+ * The right parenthesis.
+ */
+ Token rightParenthesis;
+
+ /**
+ * The body of the loop.
+ */
+ Statement _body;
+
+ /**
+ * Initialize a newly created for statement.
+ *
+ * @param forKeyword the token representing the 'for' keyword
+ * @param leftParenthesis the left parenthesis
+ * @param variableList the declaration of the loop variables
+ * @param initialization the initialization expression
+ * @param leftSeparator the semicolon separating the initializer and the condition
+ * @param condition the condition used to determine when to terminate the loop
+ * @param rightSeparator the semicolon separating the condition and the updater
+ * @param updaters the list of expressions run after each execution of the loop body
+ * @param rightParenthesis the right parenthesis
+ * @param body the body of the loop
+ */
+ ForStatement(this.forKeyword, this.leftParenthesis, VariableDeclarationList variableList, Expression initialization, this.leftSeparator, Expression condition, this.rightSeparator, List<Expression> updaters, this.rightParenthesis, Statement body) {
+ this._updaters = new NodeList<Expression>(this);
+ this._variableList = becomeParentOf(variableList);
+ this._initialization = becomeParentOf(initialization);
+ this._condition = becomeParentOf(condition);
+ this._updaters.addAll(updaters);
+ this._body = becomeParentOf(body);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitForStatement(this);
+
+ @override
+ Token get beginToken => forKeyword;
+
+ /**
+ * Return the body of the loop.
+ *
+ * @return the body of the loop
+ */
+ Statement get body => _body;
+
+ /**
+ * Return the condition used to determine when to terminate the loop, or `null` if there is
+ * no condition.
+ *
+ * @return the condition used to determine when to terminate the loop
+ */
+ Expression get condition => _condition;
+
+ @override
+ Token get endToken => _body.endToken;
+
+ /**
+ * Return the initialization expression, or `null` if there is no initialization expression.
+ *
+ * @return the initialization expression
+ */
+ Expression get initialization => _initialization;
+
+ /**
+ * Return the list of expressions run after each execution of the loop body.
+ *
+ * @return the list of expressions run after each execution of the loop body
+ */
+ NodeList<Expression> get updaters => _updaters;
+
+ /**
+ * Return the declaration of the loop variables, or `null` if there are no variables.
+ *
+ * @return the declaration of the loop variables, or `null` if there are no variables
+ */
+ VariableDeclarationList get variables => _variableList;
+
+ /**
+ * Set the body of the loop to the given statement.
+ *
+ * @param body the body of the loop
+ */
+ void set body(Statement body) {
+ this._body = becomeParentOf(body);
+ }
+
+ /**
+ * Set the condition used to determine when to terminate the loop to the given expression.
+ *
+ * @param expression the condition used to determine when to terminate the loop
+ */
+ void set condition(Expression expression) {
+ _condition = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the initialization expression to the given expression.
+ *
+ * @param initialization the initialization expression
+ */
+ void set initialization(Expression initialization) {
+ this._initialization = becomeParentOf(initialization);
+ }
+
+ /**
+ * Set the declaration of the loop variables to the given parameter.
+ *
+ * @param variableList the declaration of the loop variables
+ */
+ void set variables(VariableDeclarationList variableList) {
+ this._variableList = becomeParentOf(variableList);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_variableList, visitor);
+ safelyVisitChild(_initialization, visitor);
+ safelyVisitChild(_condition, visitor);
+ _updaters.accept(visitor);
+ safelyVisitChild(_body, visitor);
+ }
+}
+
+/**
+ * The abstract class `FormalParameter` defines the behavior of objects representing a
+ * parameter to a function.
+ *
+ * <pre>
+ * formalParameter ::=
+ * [NormalFormalParameter]
+ * | [DefaultFormalParameter]
+ * | [DefaultFormalParameter]
+ * </pre>
+ */
+abstract class FormalParameter extends AstNode {
+ /**
+ * Return the element representing this parameter, or `null` if this parameter has not been
+ * resolved.
+ *
+ * @return the element representing this parameter
+ */
+ ParameterElement get element {
+ SimpleIdentifier identifier = this.identifier;
+ if (identifier == null) {
+ return null;
+ }
+ return identifier.staticElement as ParameterElement;
+ }
+
+ /**
+ * Return the name of the parameter being declared.
+ *
+ * @return the name of the parameter being declared
+ */
+ SimpleIdentifier get identifier;
+
+ /**
+ * Return the kind of this parameter.
+ *
+ * @return the kind of this parameter
+ */
+ ParameterKind get kind;
+
+ /**
+ * Return `true` if this parameter was declared with the 'const' modifier.
+ *
+ * @return `true` if this parameter was declared with the 'const' modifier
+ */
+ bool get isConst;
+
+ /**
+ * Return `true` if this parameter was declared with the 'final' modifier. Parameters that
+ * are declared with the 'const' modifier will return `false` even though they are
+ * implicitly final.
+ *
+ * @return `true` if this parameter was declared with the 'final' modifier
+ */
+ bool get isFinal;
+}
+
+/**
+ * Instances of the class `FormalParameterList` represent the formal parameter list of a
+ * method declaration, function declaration, or function type alias.
+ *
+ * While the grammar requires all optional formal parameters to follow all of the normal formal
+ * parameters and at most one grouping of optional formal parameters, this class does not enforce
+ * those constraints. All parameters are flattened into a single list, which can have any or all
+ * kinds of parameters (normal, named, and positional) in any order.
+ *
+ * <pre>
+ * formalParameterList ::=
+ * '(' ')'
+ * | '(' normalFormalParameters (',' optionalFormalParameters)? ')'
+ * | '(' optionalFormalParameters ')'
+ *
+ * normalFormalParameters ::=
+ * [NormalFormalParameter] (',' [NormalFormalParameter])*
+ *
+ * optionalFormalParameters ::=
+ * optionalPositionalFormalParameters
+ * | namedFormalParameters
+ *
+ * optionalPositionalFormalParameters ::=
+ * '[' [DefaultFormalParameter] (',' [DefaultFormalParameter])* ']'
+ *
+ * namedFormalParameters ::=
+ * '{' [DefaultFormalParameter] (',' [DefaultFormalParameter])* '}'
+ * </pre>
+ */
+class FormalParameterList extends AstNode {
+ /**
+ * The left parenthesis.
+ */
+ Token _leftParenthesis;
+
+ /**
+ * The parameters associated with the method.
+ */
+ NodeList<FormalParameter> _parameters;
+
+ /**
+ * The left square bracket ('[') or left curly brace ('{') introducing the optional parameters, or
+ * `null` if there are no optional parameters.
+ */
+ Token _leftDelimiter;
+
+ /**
+ * The right square bracket (']') or right curly brace ('}') introducing the optional parameters,
+ * or `null` if there are no optional parameters.
+ */
+ Token _rightDelimiter;
+
+ /**
+ * The right parenthesis.
+ */
+ Token _rightParenthesis;
+
+ /**
+ * Initialize a newly created parameter list.
+ *
+ * @param leftParenthesis the left parenthesis
+ * @param parameters the parameters associated with the method
+ * @param leftDelimiter the left delimiter introducing the optional parameters
+ * @param rightDelimiter the right delimiter introducing the optional parameters
+ * @param rightParenthesis the right parenthesis
+ */
+ FormalParameterList(Token leftParenthesis, List<FormalParameter> parameters, Token leftDelimiter, Token rightDelimiter, Token rightParenthesis) {
+ this._parameters = new NodeList<FormalParameter>(this);
+ this._leftParenthesis = leftParenthesis;
+ this._parameters.addAll(parameters);
+ this._leftDelimiter = leftDelimiter;
+ this._rightDelimiter = rightDelimiter;
+ this._rightParenthesis = rightParenthesis;
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitFormalParameterList(this);
+
+ @override
+ Token get beginToken => _leftParenthesis;
+
+ @override
+ Token get endToken => _rightParenthesis;
+
+ /**
+ * Return the left square bracket ('[') or left curly brace ('{') introducing the optional
+ * parameters, or `null` if there are no optional parameters.
+ *
+ * @return the left square bracket ('[') or left curly brace ('{') introducing the optional
+ * parameters
+ */
+ Token get leftDelimiter => _leftDelimiter;
+
+ /**
+ * Return the left parenthesis.
+ *
+ * @return the left parenthesis
+ */
+ Token get leftParenthesis => _leftParenthesis;
+
+ /**
+ * Return an array containing the elements representing the parameters in this list. The array
+ * will contain `null`s if the parameters in this list have not been resolved.
+ *
+ * @return the elements representing the parameters in this list
+ */
+ List<ParameterElement> get parameterElements {
+ int count = _parameters.length;
+ List<ParameterElement> types = new List<ParameterElement>(count);
+ for (int i = 0; i < count; i++) {
+ types[i] = _parameters[i].element;
+ }
+ return types;
+ }
+
+ /**
+ * Return the parameters associated with the method.
+ *
+ * @return the parameters associated with the method
+ */
+ NodeList<FormalParameter> get parameters => _parameters;
+
+ /**
+ * Return the right square bracket (']') or right curly brace ('}') introducing the optional
+ * parameters, or `null` if there are no optional parameters.
+ *
+ * @return the right square bracket (']') or right curly brace ('}') introducing the optional
+ * parameters
+ */
+ Token get rightDelimiter => _rightDelimiter;
+
+ /**
+ * Return the right parenthesis.
+ *
+ * @return the right parenthesis
+ */
+ Token get rightParenthesis => _rightParenthesis;
+
+ /**
+ * Set the left square bracket ('[') or left curly brace ('{') introducing the optional parameters
+ * to the given token.
+ *
+ * @param bracket the left delimiter introducing the optional parameters
+ */
+ void set leftDelimiter(Token bracket) {
+ _leftDelimiter = bracket;
+ }
+
+ /**
+ * Set the left parenthesis to the given token.
+ *
+ * @param parenthesis the left parenthesis
+ */
+ void set leftParenthesis(Token parenthesis) {
+ _leftParenthesis = parenthesis;
+ }
+
+ /**
+ * Set the right square bracket (']') or right curly brace ('}') introducing the optional
+ * parameters to the given token.
+ *
+ * @param bracket the right delimiter introducing the optional parameters
+ */
+ void set rightDelimiter(Token bracket) {
+ _rightDelimiter = bracket;
+ }
+
+ /**
+ * Set the right parenthesis to the given token.
+ *
+ * @param parenthesis the right parenthesis
+ */
+ void set rightParenthesis(Token parenthesis) {
+ _rightParenthesis = parenthesis;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _parameters.accept(visitor);
+ }
+}
+
+/**
+ * The abstract class `FunctionBody` defines the behavior common to objects representing the
+ * body of a function or method.
+ *
+ * <pre>
+ * functionBody ::=
+ * [BlockFunctionBody]
+ * | [EmptyFunctionBody]
+ * | [ExpressionFunctionBody]
+ * </pre>
+ */
+abstract class FunctionBody extends AstNode {
+ /**
+ * Return `true` if this function body is asynchronous.
+ *
+ * @return `true` if this function body is asynchronous
+ */
+ bool get isAsynchronous => false;
+
+ /**
+ * Return `true` if this function body is a generator.
+ *
+ * @return `true` if this function body is a generator
+ */
+ bool get isGenerator => false;
+
+ /**
+ * Return `true` if this function body is synchronous.
+ *
+ * @return `true` if this function body is synchronous
+ */
+ bool get isSynchronous => true;
+}
+
+/**
+ * Instances of the class `FunctionDeclaration` wrap a [FunctionExpression] as a top-level declaration.
+ *
+ * <pre>
+ * functionDeclaration ::=
+ * 'external' functionSignature
+ * | functionSignature [FunctionBody]
+ *
+ * functionSignature ::=
+ * [Type]? ('get' | 'set')? [SimpleIdentifier] [FormalParameterList]
+ * </pre>
+ */
+class FunctionDeclaration extends CompilationUnitMember {
+ /**
+ * The token representing the 'external' keyword, or `null` if this is not an external
+ * function.
+ */
+ Token externalKeyword;
+
+ /**
+ * The return type of the function, or `null` if no return type was declared.
+ */
+ TypeName _returnType;
+
+ /**
+ * The token representing the 'get' or 'set' keyword, or `null` if this is a function
+ * declaration rather than a property declaration.
+ */
+ Token propertyKeyword;
+
+ /**
+ * The name of the function, or `null` if the function is not named.
+ */
+ SimpleIdentifier _name;
+
+ /**
+ * The function expression being wrapped.
+ */
+ FunctionExpression _functionExpression;
+
+ /**
+ * Initialize a newly created function declaration.
+ *
+ * @param comment the documentation comment associated with this function
+ * @param metadata the annotations associated with this function
+ * @param externalKeyword the token representing the 'external' keyword
+ * @param returnType the return type of the function
+ * @param propertyKeyword the token representing the 'get' or 'set' keyword
+ * @param name the name of the function
+ * @param functionExpression the function expression being wrapped
+ */
+ FunctionDeclaration(Comment comment, List<Annotation> metadata, this.externalKeyword, TypeName returnType, this.propertyKeyword, SimpleIdentifier name, FunctionExpression functionExpression) : super(comment, metadata) {
+ this._returnType = becomeParentOf(returnType);
+ this._name = becomeParentOf(name);
+ this._functionExpression = becomeParentOf(functionExpression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitFunctionDeclaration(this);
+
+ @override
+ ExecutableElement get element => _name != null ? (_name.staticElement as ExecutableElement) : null;
+
+ @override
+ Token get endToken => _functionExpression.endToken;
+
+ /**
+ * Return the function expression being wrapped.
+ *
+ * @return the function expression being wrapped
+ */
+ FunctionExpression get functionExpression => _functionExpression;
+
+ /**
+ * Return the name of the function, or `null` if the function is not named.
+ *
+ * @return the name of the function
+ */
+ SimpleIdentifier get name => _name;
+
+ /**
+ * Return the return type of the function, or `null` if no return type was declared.
+ *
+ * @return the return type of the function
+ */
+ TypeName get returnType => _returnType;
+
+ /**
+ * Return `true` if this function declares a getter.
+ *
+ * @return `true` if this function declares a getter
+ */
+ bool get isGetter => propertyKeyword != null && (propertyKeyword as KeywordToken).keyword == Keyword.GET;
+
+ /**
+ * Return `true` if this function declares a setter.
+ *
+ * @return `true` if this function declares a setter
+ */
+ bool get isSetter => propertyKeyword != null && (propertyKeyword as KeywordToken).keyword == Keyword.SET;
+
+ /**
+ * Set the function expression being wrapped to the given function expression.
+ *
+ * @param functionExpression the function expression being wrapped
+ */
+ void set functionExpression(FunctionExpression functionExpression) {
+ this._functionExpression = becomeParentOf(functionExpression);
+ }
+
+ /**
+ * Set the name of the function to the given identifier.
+ *
+ * @param identifier the name of the function
+ */
+ void set name(SimpleIdentifier identifier) {
+ this._name = becomeParentOf(identifier);
+ }
+
+ /**
+ * Set the return type of the function to the given name.
+ *
+ * @param returnType the return type of the function
+ */
+ void set returnType(TypeName returnType) {
+ this._returnType = becomeParentOf(returnType);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_returnType, visitor);
+ safelyVisitChild(_name, visitor);
+ safelyVisitChild(_functionExpression, visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata {
+ if (externalKeyword != null) {
+ return externalKeyword;
+ }
+ if (_returnType != null) {
+ return _returnType.beginToken;
+ } else if (propertyKeyword != null) {
+ return propertyKeyword;
+ } else if (_name != null) {
+ return _name.beginToken;
+ }
+ return _functionExpression.beginToken;
+ }
+}
+
+/**
+ * Instances of the class `FunctionDeclarationStatement` wrap a [FunctionDeclaration
+ ] as a statement.
+ */
+class FunctionDeclarationStatement extends Statement {
+ /**
+ * The function declaration being wrapped.
+ */
+ FunctionDeclaration _functionDeclaration;
+
+ /**
+ * Initialize a newly created function declaration statement.
+ *
+ * @param functionDeclaration the the function declaration being wrapped
+ */
+ FunctionDeclarationStatement(FunctionDeclaration functionDeclaration) {
+ this._functionDeclaration = becomeParentOf(functionDeclaration);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitFunctionDeclarationStatement(this);
+
+ @override
+ Token get beginToken => _functionDeclaration.beginToken;
+
+ @override
+ Token get endToken => _functionDeclaration.endToken;
+
+ /**
+ * Return the function declaration being wrapped.
+ *
+ * @return the function declaration being wrapped
+ */
+ FunctionDeclaration get functionDeclaration => _functionDeclaration;
+
+ /**
+ * Set the function declaration being wrapped to the given function declaration.
+ *
+ * @param functionDeclaration the function declaration being wrapped
+ */
+ void set functionDeclaration(FunctionDeclaration functionDeclaration) {
+ this._functionDeclaration = becomeParentOf(functionDeclaration);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_functionDeclaration, visitor);
+ }
+}
+
+/**
+ * Instances of the class `FunctionExpression` represent a function expression.
+ *
+ * <pre>
+ * functionExpression ::=
+ * [FormalParameterList] [FunctionBody]
+ * </pre>
+ */
+class FunctionExpression extends Expression {
+ /**
+ * The parameters associated with the function.
+ */
+ FormalParameterList _parameters;
+
+ /**
+ * The body of the function, or `null` if this is an external function.
+ */
+ FunctionBody _body;
+
+ /**
+ * The element associated with the function, or `null` if the AST structure has not been
+ * resolved.
+ */
+ ExecutableElement element;
+
+ /**
+ * Initialize a newly created function declaration.
+ *
+ * @param parameters the parameters associated with the function
+ * @param body the body of the function
+ */
+ FunctionExpression(FormalParameterList parameters, FunctionBody body) {
+ this._parameters = becomeParentOf(parameters);
+ this._body = becomeParentOf(body);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitFunctionExpression(this);
+
+ @override
+ Token get beginToken {
+ if (_parameters != null) {
+ return _parameters.beginToken;
+ } else if (_body != null) {
+ return _body.beginToken;
+ }
+ // This should never be reached because external functions must be named, hence either the body
+ // or the name should be non-null.
+ throw new IllegalStateException("Non-external functions must have a body");
+ }
+
+ /**
+ * Return the body of the function, or `null` if this is an external function.
+ *
+ * @return the body of the function
+ */
+ FunctionBody get body => _body;
+
+ @override
+ Token get endToken {
+ if (_body != null) {
+ return _body.endToken;
+ } else if (_parameters != null) {
+ return _parameters.endToken;
+ }
+ // This should never be reached because external functions must be named, hence either the body
+ // or the name should be non-null.
+ throw new IllegalStateException("Non-external functions must have a body");
+ }
+
+ /**
+ * Return the parameters associated with the function.
+ *
+ * @return the parameters associated with the function
+ */
+ FormalParameterList get parameters => _parameters;
+
+ @override
+ int get precedence => 16;
+
+ /**
+ * Set the body of the function to the given function body.
+ *
+ * @param functionBody the body of the function
+ */
+ void set body(FunctionBody functionBody) {
+ _body = becomeParentOf(functionBody);
+ }
+
+ /**
+ * Set the parameters associated with the function to the given list of parameters.
+ *
+ * @param parameters the parameters associated with the function
+ */
+ void set parameters(FormalParameterList parameters) {
+ this._parameters = becomeParentOf(parameters);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_parameters, visitor);
+ safelyVisitChild(_body, visitor);
+ }
+}
+
+/**
+ * Instances of the class `FunctionExpressionInvocation` represent the invocation of a
+ * function resulting from evaluating an expression. Invocations of methods and other forms of
+ * functions are represented by [MethodInvocation] nodes. Invocations of
+ * getters and setters are represented by either [PrefixedIdentifier] or
+ * [PropertyAccess] nodes.
+ *
+ * <pre>
+ * functionExpressionInvoction ::=
+ * [Expression] [ArgumentList]
+ * </pre>
+ */
+class FunctionExpressionInvocation extends Expression {
+ /**
+ * The expression producing the function being invoked.
+ */
+ Expression _function;
+
+ /**
+ * The list of arguments to the function.
+ */
+ ArgumentList _argumentList;
+
+ /**
+ * The element associated with the function being invoked based on static type information, or
+ * `null` if the AST structure has not been resolved or the function could not be resolved.
+ */
+ ExecutableElement staticElement;
+
+ /**
+ * The element associated with the function being invoked based on propagated type information, or
+ * `null` if the AST structure has not been resolved or the function could not be resolved.
+ */
+ ExecutableElement _propagatedElement;
+
+ /**
+ * Initialize a newly created function expression invocation.
+ *
+ * @param function the expression producing the function being invoked
+ * @param argumentList the list of arguments to the method
+ */
+ FunctionExpressionInvocation(Expression function, ArgumentList argumentList) {
+ this._function = becomeParentOf(function);
+ this._argumentList = becomeParentOf(argumentList);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitFunctionExpressionInvocation(this);
+
+ /**
+ * Return the list of arguments to the method.
+ *
+ * @return the list of arguments to the method
+ */
+ ArgumentList get argumentList => _argumentList;
+
+ @override
+ Token get beginToken => _function.beginToken;
+
+ /**
+ * Return the best element available for the function being invoked. If resolution was able to
+ * find a better element based on type propagation, that element will be returned. Otherwise, the
+ * element found using the result of static analysis will be returned. If resolution has not been
+ * performed, then `null` will be returned.
+ *
+ * @return the best element available for this function
+ */
+ ExecutableElement get bestElement {
+ ExecutableElement element = propagatedElement;
+ if (element == null) {
+ element = staticElement;
+ }
+ return element;
+ }
+
+ @override
+ Token get endToken => _argumentList.endToken;
+
+ /**
+ * Return the expression producing the function being invoked.
+ *
+ * @return the expression producing the function being invoked
+ */
+ Expression get function => _function;
+
+ @override
+ int get precedence => 15;
+
+ /**
+ * Return the element associated with the function being invoked based on propagated type
+ * information, or `null` if the AST structure has not been resolved or the function could
+ * not be resolved. One common example of the latter case is an expression whose value can change
+ * over time.
+ *
+ * @return the element associated with the function being invoked
+ */
+ ExecutableElement get propagatedElement => _propagatedElement;
+
+ /**
+ * Set the list of arguments to the method to the given list.
+ *
+ * @param argumentList the list of arguments to the method
+ */
+ void set argumentList(ArgumentList argumentList) {
+ this._argumentList = becomeParentOf(argumentList);
+ }
+
+ /**
+ * Set the expression producing the function being invoked to the given expression.
+ *
+ * @param function the expression producing the function being invoked
+ */
+ void set function(Expression function) {
+ this._function = becomeParentOf(function);
+ }
+
+ /**
+ * Set the element associated with the function being invoked based on propagated type information
+ * to the given element.
+ *
+ * @param element the element to be associated with the function being invoked
+ */
+ void set propagatedElement(ExecutableElement element) {
+ _propagatedElement = element;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_function, visitor);
+ safelyVisitChild(_argumentList, visitor);
+ }
+}
+
+/**
+ * Instances of the class `FunctionTypeAlias` represent a function type alias.
+ *
+ * <pre>
+ * functionTypeAlias ::=
+ * functionPrefix [TypeParameterList]? [FormalParameterList] ';'
+ *
+ * functionPrefix ::=
+ * [TypeName]? [SimpleIdentifier]
+ * </pre>
+ */
+class FunctionTypeAlias extends TypeAlias {
+ /**
+ * The name of the return type of the function type being defined, or `null` if no return
+ * type was given.
+ */
+ TypeName _returnType;
+
+ /**
+ * The name of the function type being declared.
+ */
+ SimpleIdentifier _name;
+
+ /**
+ * The type parameters for the function type, or `null` if the function type does not have
+ * any type parameters.
+ */
+ TypeParameterList _typeParameters;
+
+ /**
+ * The parameters associated with the function type.
+ */
+ FormalParameterList _parameters;
+
+ /**
+ * Initialize a newly created function type alias.
+ *
+ * @param comment the documentation comment associated with this type alias
+ * @param metadata the annotations associated with this type alias
+ * @param keyword the token representing the 'typedef' keyword
+ * @param returnType the name of the return type of the function type being defined
+ * @param name the name of the type being declared
+ * @param typeParameters the type parameters for the type
+ * @param parameters the parameters associated with the function
+ * @param semicolon the semicolon terminating the declaration
+ */
+ FunctionTypeAlias(Comment comment, List<Annotation> metadata, Token keyword, TypeName returnType, SimpleIdentifier name, TypeParameterList typeParameters, FormalParameterList parameters, Token semicolon) : super(comment, metadata, keyword, semicolon) {
+ this._returnType = becomeParentOf(returnType);
+ this._name = becomeParentOf(name);
+ this._typeParameters = becomeParentOf(typeParameters);
+ this._parameters = becomeParentOf(parameters);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitFunctionTypeAlias(this);
+
+ @override
+ FunctionTypeAliasElement get element => _name != null ? (_name.staticElement as FunctionTypeAliasElement) : null;
+
+ /**
+ * Return the name of the function type being declared.
+ *
+ * @return the name of the function type being declared
+ */
+ SimpleIdentifier get name => _name;
+
+ /**
+ * Return the parameters associated with the function type.
+ *
+ * @return the parameters associated with the function type
+ */
+ FormalParameterList get parameters => _parameters;
+
+ /**
+ * Return the name of the return type of the function type being defined, or `null` if no
+ * return type was given.
+ *
+ * @return the name of the return type of the function type being defined
+ */
+ TypeName get returnType => _returnType;
+
+ /**
+ * Return the type parameters for the function type, or `null` if the function type does not
+ * have any type parameters.
+ *
+ * @return the type parameters for the function type
+ */
+ TypeParameterList get typeParameters => _typeParameters;
+
+ /**
+ * Set the name of the function type being declared to the given identifier.
+ *
+ * @param name the name of the function type being declared
+ */
+ void set name(SimpleIdentifier name) {
+ this._name = becomeParentOf(name);
+ }
+
+ /**
+ * Set the parameters associated with the function type to the given list of parameters.
+ *
+ * @param parameters the parameters associated with the function type
+ */
+ void set parameters(FormalParameterList parameters) {
+ this._parameters = becomeParentOf(parameters);
+ }
+
+ /**
+ * Set the name of the return type of the function type being defined to the given type name.
+ *
+ * @param typeName the name of the return type of the function type being defined
+ */
+ void set returnType(TypeName typeName) {
+ _returnType = becomeParentOf(typeName);
+ }
+
+ /**
+ * Set the type parameters for the function type to the given list of parameters.
+ *
+ * @param typeParameters the type parameters for the function type
+ */
+ void set typeParameters(TypeParameterList typeParameters) {
+ this._typeParameters = becomeParentOf(typeParameters);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_returnType, visitor);
+ safelyVisitChild(_name, visitor);
+ safelyVisitChild(_typeParameters, visitor);
+ safelyVisitChild(_parameters, visitor);
+ }
+}
+
+/**
+ * Instances of the class `FunctionTypedFormalParameter` represent a function-typed formal
+ * parameter.
+ *
+ * <pre>
+ * functionSignature ::=
+ * [TypeName]? [SimpleIdentifier] [FormalParameterList]
+ * </pre>
+ */
+class FunctionTypedFormalParameter extends NormalFormalParameter {
+ /**
+ * The return type of the function, or `null` if the function does not have a return type.
+ */
+ TypeName _returnType;
+
+ /**
+ * The parameters of the function-typed parameter.
+ */
+ FormalParameterList _parameters;
+
+ /**
+ * Initialize a newly created formal parameter.
+ *
+ * @param comment the documentation comment associated with this parameter
+ * @param metadata the annotations associated with this parameter
+ * @param returnType the return type of the function, or `null` if the function does not
+ * have a return type
+ * @param identifier the name of the function-typed parameter
+ * @param parameters the parameters of the function-typed parameter
+ */
+ FunctionTypedFormalParameter(Comment comment, List<Annotation> metadata, TypeName returnType, SimpleIdentifier identifier, FormalParameterList parameters) : super(comment, metadata, identifier) {
+ this._returnType = becomeParentOf(returnType);
+ this._parameters = becomeParentOf(parameters);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitFunctionTypedFormalParameter(this);
+
+ @override
+ Token get beginToken {
+ if (_returnType != null) {
+ return _returnType.beginToken;
+ }
+ return identifier.beginToken;
+ }
+
+ @override
+ Token get endToken => _parameters.endToken;
+
+ /**
+ * Return the parameters of the function-typed parameter.
+ *
+ * @return the parameters of the function-typed parameter
+ */
+ FormalParameterList get parameters => _parameters;
+
+ /**
+ * Return the return type of the function, or `null` if the function does not have a return
+ * type.
+ *
+ * @return the return type of the function
+ */
+ TypeName get returnType => _returnType;
+
+ @override
+ bool get isConst => false;
+
+ @override
+ bool get isFinal => false;
+
+ /**
+ * Set the parameters of the function-typed parameter to the given parameters.
+ *
+ * @param parameters the parameters of the function-typed parameter
+ */
+ void set parameters(FormalParameterList parameters) {
+ this._parameters = becomeParentOf(parameters);
+ }
+
+ /**
+ * Set the return type of the function to the given type.
+ *
+ * @param returnType the return type of the function
+ */
+ void set returnType(TypeName returnType) {
+ this._returnType = becomeParentOf(returnType);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_returnType, visitor);
+ safelyVisitChild(identifier, visitor);
+ safelyVisitChild(_parameters, visitor);
+ }
+}
+
+/**
+ * Instances of the class `GeneralizingAstVisitor` implement an AST visitor that will
+ * recursively visit all of the nodes in an AST structure (like instances of the class
+ * [RecursiveAstVisitor]). In addition, when a node of a specific type is visited not only
+ * will the visit method for that specific type of node be invoked, but additional methods for the
+ * superclasses of that node will also be invoked. For example, using an instance of this class to
+ * visit a [Block] will cause the method [visitBlock] to be invoked but will
+ * also cause the methods [visitStatement] and [visitNode] to be
+ * subsequently invoked. This allows visitors to be written that visit all statements without
+ * needing to override the visit method for each of the specific subclasses of [Statement].
+ *
+ * Subclasses that override a visit method must either invoke the overridden visit method or
+ * explicitly invoke the more general visit method. Failure to do so will cause the visit methods
+ * for superclasses of the node to not be invoked and will cause the children of the visited node to
+ * not be visited.
+ */
+class GeneralizingAstVisitor<R> implements AstVisitor<R> {
+ @override
+ R visitAdjacentStrings(AdjacentStrings node) => visitStringLiteral(node);
+
+ R visitAnnotatedNode(AnnotatedNode node) => visitNode(node);
+
+ @override
+ R visitAnnotation(Annotation node) => visitNode(node);
+
+ @override
+ R visitArgumentList(ArgumentList node) => visitNode(node);
+
+ @override
+ R visitAsExpression(AsExpression node) => visitExpression(node);
+
+ @override
+ R visitAssertStatement(AssertStatement node) => visitStatement(node);
+
+ @override
+ R visitAssignmentExpression(AssignmentExpression node) => visitExpression(node);
+
+ @override
+ R visitAwaitExpression(AwaitExpression node) => visitExpression(node);
+
+ @override
+ R visitBinaryExpression(BinaryExpression node) => visitExpression(node);
+
+ @override
+ R visitBlock(Block node) => visitStatement(node);
+
+ @override
+ R visitBlockFunctionBody(BlockFunctionBody node) => visitFunctionBody(node);
+
+ @override
+ R visitBooleanLiteral(BooleanLiteral node) => visitLiteral(node);
+
+ @override
+ R visitBreakStatement(BreakStatement node) => visitStatement(node);
+
+ @override
+ R visitCascadeExpression(CascadeExpression node) => visitExpression(node);
+
+ @override
+ R visitCatchClause(CatchClause node) => visitNode(node);
+
+ @override
+ R visitClassDeclaration(ClassDeclaration node) => visitCompilationUnitMember(node);
+
+ R visitClassMember(ClassMember node) => visitDeclaration(node);
+
+ @override
+ R visitClassTypeAlias(ClassTypeAlias node) => visitTypeAlias(node);
+
+ R visitCombinator(Combinator node) => visitNode(node);
+
+ @override
+ R visitComment(Comment node) => visitNode(node);
+
+ @override
+ R visitCommentReference(CommentReference node) => visitNode(node);
+
+ @override
+ R visitCompilationUnit(CompilationUnit node) => visitNode(node);
+
+ R visitCompilationUnitMember(CompilationUnitMember node) => visitDeclaration(node);
+
+ @override
+ R visitConditionalExpression(ConditionalExpression node) => visitExpression(node);
+
+ @override
+ R visitConstructorDeclaration(ConstructorDeclaration node) => visitClassMember(node);
+
+ @override
+ R visitConstructorFieldInitializer(ConstructorFieldInitializer node) => visitConstructorInitializer(node);
+
+ R visitConstructorInitializer(ConstructorInitializer node) => visitNode(node);
+
+ @override
+ R visitConstructorName(ConstructorName node) => visitNode(node);
+
+ @override
+ R visitContinueStatement(ContinueStatement node) => visitStatement(node);
+
+ R visitDeclaration(Declaration node) => visitAnnotatedNode(node);
+
+ @override
+ R visitDeclaredIdentifier(DeclaredIdentifier node) => visitDeclaration(node);
+
+ @override
+ R visitDefaultFormalParameter(DefaultFormalParameter node) => visitFormalParameter(node);
+
+ R visitDirective(Directive node) => visitAnnotatedNode(node);
+
+ @override
+ R visitDoStatement(DoStatement node) => visitStatement(node);
+
+ @override
+ R visitDoubleLiteral(DoubleLiteral node) => visitLiteral(node);
+
+ @override
+ R visitEmptyFunctionBody(EmptyFunctionBody node) => visitFunctionBody(node);
+
+ @override
+ R visitEmptyStatement(EmptyStatement node) => visitStatement(node);
+
+ @override
+ R visitEnumConstantDeclaration(EnumConstantDeclaration node) => visitDeclaration(node);
+
+ @override
+ R visitEnumDeclaration(EnumDeclaration node) => visitCompilationUnitMember(node);
+
+ @override
+ R visitExportDirective(ExportDirective node) => visitNamespaceDirective(node);
+
+ R visitExpression(Expression node) => visitNode(node);
+
+ @override
+ R visitExpressionFunctionBody(ExpressionFunctionBody node) => visitFunctionBody(node);
+
+ @override
+ R visitExpressionStatement(ExpressionStatement node) => visitStatement(node);
+
+ @override
+ R visitExtendsClause(ExtendsClause node) => visitNode(node);
+
+ @override
+ R visitFieldDeclaration(FieldDeclaration node) => visitClassMember(node);
+
+ @override
+ R visitFieldFormalParameter(FieldFormalParameter node) => visitNormalFormalParameter(node);
+
+ @override
+ R visitForEachStatement(ForEachStatement node) => visitStatement(node);
+
+ R visitFormalParameter(FormalParameter node) => visitNode(node);
+
+ @override
+ R visitFormalParameterList(FormalParameterList node) => visitNode(node);
+
+ @override
+ R visitForStatement(ForStatement node) => visitStatement(node);
+
+ R visitFunctionBody(FunctionBody node) => visitNode(node);
+
+ @override
+ R visitFunctionDeclaration(FunctionDeclaration node) => visitCompilationUnitMember(node);
+
+ @override
+ R visitFunctionDeclarationStatement(FunctionDeclarationStatement node) => visitStatement(node);
+
+ @override
+ R visitFunctionExpression(FunctionExpression node) => visitExpression(node);
+
+ @override
+ R visitFunctionExpressionInvocation(FunctionExpressionInvocation node) => visitExpression(node);
+
+ @override
+ R visitFunctionTypeAlias(FunctionTypeAlias node) => visitTypeAlias(node);
+
+ @override
+ R visitFunctionTypedFormalParameter(FunctionTypedFormalParameter node) => visitNormalFormalParameter(node);
+
+ @override
+ R visitHideCombinator(HideCombinator node) => visitCombinator(node);
+
+ R visitIdentifier(Identifier node) => visitExpression(node);
+
+ @override
+ R visitIfStatement(IfStatement node) => visitStatement(node);
+
+ @override
+ R visitImplementsClause(ImplementsClause node) => visitNode(node);
+
+ @override
+ R visitImportDirective(ImportDirective node) => visitNamespaceDirective(node);
+
+ @override
+ R visitIndexExpression(IndexExpression node) => visitExpression(node);
+
+ @override
+ R visitInstanceCreationExpression(InstanceCreationExpression node) => visitExpression(node);
+
+ @override
+ R visitIntegerLiteral(IntegerLiteral node) => visitLiteral(node);
+
+ R visitInterpolationElement(InterpolationElement node) => visitNode(node);
+
+ @override
+ R visitInterpolationExpression(InterpolationExpression node) => visitInterpolationElement(node);
+
+ @override
+ R visitInterpolationString(InterpolationString node) => visitInterpolationElement(node);
+
+ @override
+ R visitIsExpression(IsExpression node) => visitExpression(node);
+
+ @override
+ R visitLabel(Label node) => visitNode(node);
+
+ @override
+ R visitLabeledStatement(LabeledStatement node) => visitStatement(node);
+
+ @override
+ R visitLibraryDirective(LibraryDirective node) => visitDirective(node);
+
+ @override
+ R visitLibraryIdentifier(LibraryIdentifier node) => visitIdentifier(node);
+
+ @override
+ R visitListLiteral(ListLiteral node) => visitTypedLiteral(node);
+
+ R visitLiteral(Literal node) => visitExpression(node);
+
+ @override
+ R visitMapLiteral(MapLiteral node) => visitTypedLiteral(node);
+
+ @override
+ R visitMapLiteralEntry(MapLiteralEntry node) => visitNode(node);
+
+ @override
+ R visitMethodDeclaration(MethodDeclaration node) => visitClassMember(node);
+
+ @override
+ R visitMethodInvocation(MethodInvocation node) => visitExpression(node);
+
+ @override
+ R visitNamedExpression(NamedExpression node) => visitExpression(node);
+
+ R visitNamespaceDirective(NamespaceDirective node) => visitUriBasedDirective(node);
+
+ @override
+ R visitNativeClause(NativeClause node) => visitNode(node);
+
+ @override
+ R visitNativeFunctionBody(NativeFunctionBody node) => visitFunctionBody(node);
+
+ R visitNode(AstNode node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ R visitNormalFormalParameter(NormalFormalParameter node) => visitFormalParameter(node);
+
+ @override
+ R visitNullLiteral(NullLiteral node) => visitLiteral(node);
+
+ @override
+ R visitParenthesizedExpression(ParenthesizedExpression node) => visitExpression(node);
+
+ @override
+ R visitPartDirective(PartDirective node) => visitUriBasedDirective(node);
+
+ @override
+ R visitPartOfDirective(PartOfDirective node) => visitDirective(node);
+
+ @override
+ R visitPostfixExpression(PostfixExpression node) => visitExpression(node);
+
+ @override
+ R visitPrefixedIdentifier(PrefixedIdentifier node) => visitIdentifier(node);
+
+ @override
+ R visitPrefixExpression(PrefixExpression node) => visitExpression(node);
+
+ @override
+ R visitPropertyAccess(PropertyAccess node) => visitExpression(node);
+
+ @override
+ R visitRedirectingConstructorInvocation(RedirectingConstructorInvocation node) => visitConstructorInitializer(node);
+
+ @override
+ R visitRethrowExpression(RethrowExpression node) => visitExpression(node);
+
+ @override
+ R visitReturnStatement(ReturnStatement node) => visitStatement(node);
+
+ @override
+ R visitScriptTag(ScriptTag scriptTag) => visitNode(scriptTag);
+
+ @override
+ R visitShowCombinator(ShowCombinator node) => visitCombinator(node);
+
+ @override
+ R visitSimpleFormalParameter(SimpleFormalParameter node) => visitNormalFormalParameter(node);
+
+ @override
+ R visitSimpleIdentifier(SimpleIdentifier node) => visitIdentifier(node);
+
+ @override
+ R visitSimpleStringLiteral(SimpleStringLiteral node) => visitStringLiteral(node);
+
+ R visitStatement(Statement node) => visitNode(node);
+
+ @override
+ R visitStringInterpolation(StringInterpolation node) => visitStringLiteral(node);
+
+ R visitStringLiteral(StringLiteral node) => visitLiteral(node);
+
+ @override
+ R visitSuperConstructorInvocation(SuperConstructorInvocation node) => visitConstructorInitializer(node);
+
+ @override
+ R visitSuperExpression(SuperExpression node) => visitExpression(node);
+
+ @override
+ R visitSwitchCase(SwitchCase node) => visitSwitchMember(node);
+
+ @override
+ R visitSwitchDefault(SwitchDefault node) => visitSwitchMember(node);
+
+ R visitSwitchMember(SwitchMember node) => visitNode(node);
+
+ @override
+ R visitSwitchStatement(SwitchStatement node) => visitStatement(node);
+
+ @override
+ R visitSymbolLiteral(SymbolLiteral node) => visitLiteral(node);
+
+ @override
+ R visitThisExpression(ThisExpression node) => visitExpression(node);
+
+ @override
+ R visitThrowExpression(ThrowExpression node) => visitExpression(node);
+
+ @override
+ R visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node) => visitCompilationUnitMember(node);
+
+ @override
+ R visitTryStatement(TryStatement node) => visitStatement(node);
+
+ R visitTypeAlias(TypeAlias node) => visitCompilationUnitMember(node);
+
+ @override
+ R visitTypeArgumentList(TypeArgumentList node) => visitNode(node);
+
+ R visitTypedLiteral(TypedLiteral node) => visitLiteral(node);
+
+ @override
+ R visitTypeName(TypeName node) => visitNode(node);
+
+ @override
+ R visitTypeParameter(TypeParameter node) => visitNode(node);
+
+ @override
+ R visitTypeParameterList(TypeParameterList node) => visitNode(node);
+
+ R visitUriBasedDirective(UriBasedDirective node) => visitDirective(node);
+
+ @override
+ R visitVariableDeclaration(VariableDeclaration node) => visitDeclaration(node);
+
+ @override
+ R visitVariableDeclarationList(VariableDeclarationList node) => visitNode(node);
+
+ @override
+ R visitVariableDeclarationStatement(VariableDeclarationStatement node) => visitStatement(node);
+
+ @override
+ R visitWhileStatement(WhileStatement node) => visitStatement(node);
+
+ @override
+ R visitWithClause(WithClause node) => visitNode(node);
+
+ @override
+ R visitYieldStatement(YieldStatement node) => visitStatement(node);
+}
+
+class GeneralizingAstVisitor_BreadthFirstVisitor extends GeneralizingAstVisitor<Object> {
+ final BreadthFirstVisitor BreadthFirstVisitor_this;
+
+ GeneralizingAstVisitor_BreadthFirstVisitor(this.BreadthFirstVisitor_this) : super();
+
+ @override
+ Object visitNode(AstNode node) {
+ BreadthFirstVisitor_this._queue.add(node);
+ return null;
+ }
+}
+
+/**
+ * Instances of the class `HideCombinator` represent a combinator that restricts the names
+ * being imported to those that are not in a given list.
+ *
+ * <pre>
+ * hideCombinator ::=
+ * 'hide' [SimpleIdentifier] (',' [SimpleIdentifier])*
+ * </pre>
+ */
+class HideCombinator extends Combinator {
+ /**
+ * The list of names from the library that are hidden by this combinator.
+ */
+ NodeList<SimpleIdentifier> _hiddenNames;
+
+ /**
+ * Initialize a newly created import show combinator.
+ *
+ * @param keyword the comma introducing the combinator
+ * @param hiddenNames the list of names from the library that are hidden by this combinator
+ */
+ HideCombinator(Token keyword, List<SimpleIdentifier> hiddenNames) : super(keyword) {
+ this._hiddenNames = new NodeList<SimpleIdentifier>(this);
+ this._hiddenNames.addAll(hiddenNames);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitHideCombinator(this);
+
+ @override
+ Token get endToken => _hiddenNames.endToken;
+
+ /**
+ * Return the list of names from the library that are hidden by this combinator.
+ *
+ * @return the list of names from the library that are hidden by this combinator
+ */
+ NodeList<SimpleIdentifier> get hiddenNames => _hiddenNames;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _hiddenNames.accept(visitor);
+ }
+}
+
+/**
+ * The abstract class `Identifier` defines the behavior common to nodes that represent an
+ * identifier.
+ *
+ * <pre>
+ * identifier ::=
+ * [SimpleIdentifier]
+ * | [PrefixedIdentifier]
+ * </pre>
+ */
+abstract class Identifier extends Expression {
+ /**
+ * Return `true` if the given name is visible only within the library in which it is
+ * declared.
+ *
+ * @param name the name being tested
+ * @return `true` if the given name is private
+ */
+ static bool isPrivateName(String name) => StringUtilities.startsWithChar(name, 0x5F);
+
+ /**
+ * Return the best element available for this operator. If resolution was able to find a better
+ * element based on type propagation, that element will be returned. Otherwise, the element found
+ * using the result of static analysis will be returned. If resolution has not been performed,
+ * then `null` will be returned.
+ *
+ * @return the best element available for this operator
+ */
+ Element get bestElement;
+
+ /**
+ * Return the lexical representation of the identifier.
+ *
+ * @return the lexical representation of the identifier
+ */
+ String get name;
+
+ /**
+ * Return the element associated with this identifier based on propagated type information, or
+ * `null` if the AST structure has not been resolved or if this identifier could not be
+ * resolved. One example of the latter case is an identifier that is not defined within the scope
+ * in which it appears.
+ *
+ * @return the element associated with this identifier
+ */
+ Element get propagatedElement;
+
+ /**
+ * Return the element associated with this identifier based on static type information, or
+ * `null` if the AST structure has not been resolved or if this identifier could not be
+ * resolved. One example of the latter case is an identifier that is not defined within the scope
+ * in which it appears
+ *
+ * @return the element associated with the operator
+ */
+ Element get staticElement;
+
+ @override
+ bool get isAssignable => true;
+}
+
+/**
+ * Instances of the class `IfStatement` represent an if statement.
+ *
+ * <pre>
+ * ifStatement ::=
+ * 'if' '(' [Expression] ')' [Statement] ('else' [Statement])?
+ * </pre>
+ */
+class IfStatement extends Statement {
+ /**
+ * The token representing the 'if' keyword.
+ */
+ Token ifKeyword;
+
+ /**
+ * The left parenthesis.
+ */
+ Token leftParenthesis;
+
+ /**
+ * The condition used to determine which of the statements is executed next.
+ */
+ Expression _condition;
+
+ /**
+ * The right parenthesis.
+ */
+ Token rightParenthesis;
+
+ /**
+ * The statement that is executed if the condition evaluates to `true`.
+ */
+ Statement _thenStatement;
+
+ /**
+ * The token representing the 'else' keyword, or `null` if there is no else statement.
+ */
+ Token elseKeyword;
+
+ /**
+ * The statement that is executed if the condition evaluates to `false`, or `null` if
+ * there is no else statement.
+ */
+ Statement _elseStatement;
+
+ /**
+ * Initialize a newly created if statement.
+ *
+ * @param ifKeyword the token representing the 'if' keyword
+ * @param leftParenthesis the left parenthesis
+ * @param condition the condition used to determine which of the statements is executed next
+ * @param rightParenthesis the right parenthesis
+ * @param thenStatement the statement that is executed if the condition evaluates to `true`
+ * @param elseKeyword the token representing the 'else' keyword
+ * @param elseStatement the statement that is executed if the condition evaluates to `false`
+ */
+ IfStatement(this.ifKeyword, this.leftParenthesis, Expression condition, this.rightParenthesis, Statement thenStatement, this.elseKeyword, Statement elseStatement) {
+ this._condition = becomeParentOf(condition);
+ this._thenStatement = becomeParentOf(thenStatement);
+ this._elseStatement = becomeParentOf(elseStatement);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitIfStatement(this);
+
+ @override
+ Token get beginToken => ifKeyword;
+
+ /**
+ * Return the condition used to determine which of the statements is executed next.
+ *
+ * @return the condition used to determine which statement is executed next
+ */
+ Expression get condition => _condition;
+
+ /**
+ * Return the statement that is executed if the condition evaluates to `false`, or
+ * `null` if there is no else statement.
+ *
+ * @return the statement that is executed if the condition evaluates to `false`
+ */
+ Statement get elseStatement => _elseStatement;
+
+ @override
+ Token get endToken {
+ if (_elseStatement != null) {
+ return _elseStatement.endToken;
+ }
+ return _thenStatement.endToken;
+ }
+
+ /**
+ * Return the statement that is executed if the condition evaluates to `true`.
+ *
+ * @return the statement that is executed if the condition evaluates to `true`
+ */
+ Statement get thenStatement => _thenStatement;
+
+ /**
+ * Set the condition used to determine which of the statements is executed next to the given
+ * expression.
+ *
+ * @param expression the condition used to determine which statement is executed next
+ */
+ void set condition(Expression expression) {
+ _condition = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the statement that is executed if the condition evaluates to `false` to the given
+ * statement.
+ *
+ * @param statement the statement that is executed if the condition evaluates to `false`
+ */
+ void set elseStatement(Statement statement) {
+ _elseStatement = becomeParentOf(statement);
+ }
+
+ /**
+ * Set the statement that is executed if the condition evaluates to `true` to the given
+ * statement.
+ *
+ * @param statement the statement that is executed if the condition evaluates to `true`
+ */
+ void set thenStatement(Statement statement) {
+ _thenStatement = becomeParentOf(statement);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_condition, visitor);
+ safelyVisitChild(_thenStatement, visitor);
+ safelyVisitChild(_elseStatement, visitor);
+ }
+}
+
+/**
+ * Instances of the class `ImplementsClause` represent the "implements" clause in an class
+ * declaration.
+ *
+ * <pre>
+ * implementsClause ::=
+ * 'implements' [TypeName] (',' [TypeName])*
+ * </pre>
+ */
+class ImplementsClause extends AstNode {
+ /**
+ * The token representing the 'implements' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The interfaces that are being implemented.
+ */
+ NodeList<TypeName> _interfaces;
+
+ /**
+ * Initialize a newly created implements clause.
+ *
+ * @param keyword the token representing the 'implements' keyword
+ * @param interfaces the interfaces that are being implemented
+ */
+ ImplementsClause(this.keyword, List<TypeName> interfaces) {
+ this._interfaces = new NodeList<TypeName>(this);
+ this._interfaces.addAll(interfaces);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitImplementsClause(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ @override
+ Token get endToken => _interfaces.endToken;
+
+ /**
+ * Return the list of the interfaces that are being implemented.
+ *
+ * @return the list of the interfaces that are being implemented
+ */
+ NodeList<TypeName> get interfaces => _interfaces;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _interfaces.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `ImportDirective` represent an import directive.
+ *
+ * <pre>
+ * importDirective ::=
+ * [Annotation] 'import' [StringLiteral] ('as' identifier)? [Combinator]* ';'
+ * | [Annotation] 'import' [StringLiteral] 'deferred' 'as' identifier [Combinator]* ';'
+ * </pre>
+ */
+class ImportDirective extends NamespaceDirective {
+ static Comparator<ImportDirective> COMPARATOR = (ImportDirective import1, ImportDirective import2) {
+ //
+ // uri
+ //
+ StringLiteral uri1 = import1.uri;
+ StringLiteral uri2 = import2.uri;
+ String uriStr1 = uri1.stringValue;
+ String uriStr2 = uri2.stringValue;
+ if (uriStr1 != null || uriStr2 != null) {
+ if (uriStr1 == null) {
+ return -1;
+ } else if (uriStr2 == null) {
+ return 1;
+ } else {
+ int compare = uriStr1.compareTo(uriStr2);
+ if (compare != 0) {
+ return compare;
+ }
+ }
+ }
+ //
+ // as
+ //
+ SimpleIdentifier prefix1 = import1.prefix;
+ SimpleIdentifier prefix2 = import2.prefix;
+ String prefixStr1 = prefix1 != null ? prefix1.name : null;
+ String prefixStr2 = prefix2 != null ? prefix2.name : null;
+ if (prefixStr1 != null || prefixStr2 != null) {
+ if (prefixStr1 == null) {
+ return -1;
+ } else if (prefixStr2 == null) {
+ return 1;
+ } else {
+ int compare = prefixStr1.compareTo(prefixStr2);
+ if (compare != 0) {
+ return compare;
+ }
+ }
+ }
+ //
+ // hides and shows
+ //
+ NodeList<Combinator> combinators1 = import1.combinators;
+ List<String> allHides1 = new List<String>();
+ List<String> allShows1 = new List<String>();
+ for (Combinator combinator in combinators1) {
+ if (combinator is HideCombinator) {
+ NodeList<SimpleIdentifier> hides = combinator.hiddenNames;
+ for (SimpleIdentifier simpleIdentifier in hides) {
+ allHides1.add(simpleIdentifier.name);
+ }
+ } else {
+ NodeList<SimpleIdentifier> shows = (combinator as ShowCombinator).shownNames;
+ for (SimpleIdentifier simpleIdentifier in shows) {
+ allShows1.add(simpleIdentifier.name);
+ }
+ }
+ }
+ NodeList<Combinator> combinators2 = import2.combinators;
+ List<String> allHides2 = new List<String>();
+ List<String> allShows2 = new List<String>();
+ for (Combinator combinator in combinators2) {
+ if (combinator is HideCombinator) {
+ NodeList<SimpleIdentifier> hides = combinator.hiddenNames;
+ for (SimpleIdentifier simpleIdentifier in hides) {
+ allHides2.add(simpleIdentifier.name);
+ }
+ } else {
+ NodeList<SimpleIdentifier> shows = (combinator as ShowCombinator).shownNames;
+ for (SimpleIdentifier simpleIdentifier in shows) {
+ allShows2.add(simpleIdentifier.name);
+ }
+ }
+ }
+ // test lengths of combinator lists first
+ if (allHides1.length != allHides2.length) {
+ return allHides1.length - allHides2.length;
+ }
+ if (allShows1.length != allShows2.length) {
+ return allShows1.length - allShows2.length;
+ }
+ // next ensure that the lists are equivalent
+ if (!javaCollectionContainsAll(allHides1, allHides2)) {
+ return -1;
+ }
+ if (!javaCollectionContainsAll(allShows1, allShows2)) {
+ return -1;
+ }
+ return 0;
+ };
+
+ /**
+ * The token representing the 'deferred' token, or `null` if the imported is not deferred.
+ */
+ Token deferredToken;
+
+ /**
+ * The token representing the 'as' token, or `null` if the imported names are not prefixed.
+ */
+ Token asToken;
+
+ /**
+ * The prefix to be used with the imported names, or `null` if the imported names are not
+ * prefixed.
+ */
+ SimpleIdentifier _prefix;
+
+ /**
+ * Initialize a newly created import directive.
+ *
+ * @param comment the documentation comment associated with this directive
+ * @param metadata the annotations associated with the directive
+ * @param keyword the token representing the 'import' keyword
+ * @param libraryUri the URI of the library being imported
+ * @param deferredToken the token representing the 'deferred' token
+ * @param asToken the token representing the 'as' token
+ * @param prefix the prefix to be used with the imported names
+ * @param combinators the combinators used to control how names are imported
+ * @param semicolon the semicolon terminating the directive
+ */
+ ImportDirective(Comment comment, List<Annotation> metadata, Token keyword, StringLiteral libraryUri, this.deferredToken, this.asToken, SimpleIdentifier prefix, List<Combinator> combinators, Token semicolon) : super(comment, metadata, keyword, libraryUri, combinators, semicolon) {
+ this._prefix = becomeParentOf(prefix);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitImportDirective(this);
+
+ @override
+ ImportElement get element => super.element as ImportElement;
+
+ /**
+ * Return the prefix to be used with the imported names, or `null` if the imported names are
+ * not prefixed.
+ *
+ * @return the prefix to be used with the imported names
+ */
+ SimpleIdentifier get prefix => _prefix;
+
+ @override
+ LibraryElement get uriElement {
+ ImportElement element = this.element;
+ if (element == null) {
+ return null;
+ }
+ return element.importedLibrary;
+ }
+
+ /**
+ * Set the prefix to be used with the imported names to the given identifier.
+ *
+ * @param prefix the prefix to be used with the imported names
+ */
+ void set prefix(SimpleIdentifier prefix) {
+ this._prefix = becomeParentOf(prefix);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_prefix, visitor);
+ combinators.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `IncrementalAstCloner` implement an object that will clone any AST
+ * structure that it visits. The cloner will clone the structure, replacing the specified ASTNode
+ * with a new ASTNode, mapping the old token stream to a new token stream, and preserving resolution
+ * results.
+ */
+class IncrementalAstCloner implements AstVisitor<AstNode> {
+ /**
+ * The node to be replaced during the cloning process.
+ */
+ final AstNode _oldNode;
+
+ /**
+ * The replacement node used during the cloning process.
+ */
+ final AstNode _newNode;
+
+ /**
+ * A mapping of old tokens to new tokens used during the cloning process.
+ */
+ final TokenMap _tokenMap;
+
+ /**
+ * Construct a new instance that will replace `oldNode` with `newNode` in the process
+ * of cloning an existing AST structure.
+ *
+ * @param oldNode the node to be replaced
+ * @param newNode the replacement node
+ * @param tokenMap a mapping of old tokens to new tokens (not `null`)
+ */
+ IncrementalAstCloner(this._oldNode, this._newNode, this._tokenMap);
+
+ @override
+ AdjacentStrings visitAdjacentStrings(AdjacentStrings node) => new AdjacentStrings(_cloneNodeList(node.strings));
+
+ @override
+ Annotation visitAnnotation(Annotation node) {
+ Annotation copy = new Annotation(_mapToken(node.atSign), _cloneNode(node.name), _mapToken(node.period), _cloneNode(node.constructorName), _cloneNode(node.arguments));
+ copy.element = node.element;
+ return copy;
+ }
+
+ @override
+ ArgumentList visitArgumentList(ArgumentList node) => new ArgumentList(_mapToken(node.leftParenthesis), _cloneNodeList(node.arguments), _mapToken(node.rightParenthesis));
+
+ @override
+ AsExpression visitAsExpression(AsExpression node) {
+ AsExpression copy = new AsExpression(_cloneNode(node.expression), _mapToken(node.asOperator), _cloneNode(node.type));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ AstNode visitAssertStatement(AssertStatement node) => new AssertStatement(_mapToken(node.keyword), _mapToken(node.leftParenthesis), _cloneNode(node.condition), _mapToken(node.rightParenthesis), _mapToken(node.semicolon));
+
+ @override
+ AssignmentExpression visitAssignmentExpression(AssignmentExpression node) {
+ AssignmentExpression copy = new AssignmentExpression(_cloneNode(node.leftHandSide), _mapToken(node.operator), _cloneNode(node.rightHandSide));
+ copy.propagatedElement = node.propagatedElement;
+ copy.propagatedType = node.propagatedType;
+ copy.staticElement = node.staticElement;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ AwaitExpression visitAwaitExpression(AwaitExpression node) => new AwaitExpression(_mapToken(node.awaitKeyword), _cloneNode(node.expression));
+
+ @override
+ BinaryExpression visitBinaryExpression(BinaryExpression node) {
+ BinaryExpression copy = new BinaryExpression(_cloneNode(node.leftOperand), _mapToken(node.operator), _cloneNode(node.rightOperand));
+ copy.propagatedElement = node.propagatedElement;
+ copy.propagatedType = node.propagatedType;
+ copy.staticElement = node.staticElement;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ Block visitBlock(Block node) => new Block(_mapToken(node.leftBracket), _cloneNodeList(node.statements), _mapToken(node.rightBracket));
+
+ @override
+ BlockFunctionBody visitBlockFunctionBody(BlockFunctionBody node) => new BlockFunctionBody(_mapToken(node.keyword), _mapToken(node.star), _cloneNode(node.block));
+
+ @override
+ BooleanLiteral visitBooleanLiteral(BooleanLiteral node) {
+ BooleanLiteral copy = new BooleanLiteral(_mapToken(node.literal), node.value);
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ BreakStatement visitBreakStatement(BreakStatement node) => new BreakStatement(_mapToken(node.keyword), _cloneNode(node.label), _mapToken(node.semicolon));
+
+ @override
+ CascadeExpression visitCascadeExpression(CascadeExpression node) {
+ CascadeExpression copy = new CascadeExpression(_cloneNode(node.target), _cloneNodeList(node.cascadeSections));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ CatchClause visitCatchClause(CatchClause node) => new CatchClause(_mapToken(node.onKeyword), _cloneNode(node.exceptionType), _mapToken(node.catchKeyword), _mapToken(node.leftParenthesis), _cloneNode(node.exceptionParameter), _mapToken(node.comma), _cloneNode(node.stackTraceParameter), _mapToken(node.rightParenthesis), _cloneNode(node.body));
+
+ @override
+ ClassDeclaration visitClassDeclaration(ClassDeclaration node) {
+ ClassDeclaration copy = new ClassDeclaration(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.abstractKeyword), _mapToken(node.classKeyword), _cloneNode(node.name), _cloneNode(node.typeParameters), _cloneNode(node.extendsClause), _cloneNode(node.withClause), _cloneNode(node.implementsClause), _mapToken(node.leftBracket), _cloneNodeList(node.members), _mapToken(node.rightBracket));
+ copy.nativeClause = _cloneNode(node.nativeClause);
+ return copy;
+ }
+
+ @override
+ ClassTypeAlias visitClassTypeAlias(ClassTypeAlias node) => new ClassTypeAlias(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.keyword), _cloneNode(node.name), _cloneNode(node.typeParameters), _mapToken(node.equals), _mapToken(node.abstractKeyword), _cloneNode(node.superclass), _cloneNode(node.withClause), _cloneNode(node.implementsClause), _mapToken(node.semicolon));
+
+ @override
+ Comment visitComment(Comment node) {
+ if (node.isDocumentation) {
+ return Comment.createDocumentationCommentWithReferences(_mapTokens(node.tokens), _cloneNodeList(node.references));
+ } else if (node.isBlock) {
+ return Comment.createBlockComment(_mapTokens(node.tokens));
+ }
+ return Comment.createEndOfLineComment(_mapTokens(node.tokens));
+ }
+
+ @override
+ CommentReference visitCommentReference(CommentReference node) => new CommentReference(_mapToken(node.newKeyword), _cloneNode(node.identifier));
+
+ @override
+ CompilationUnit visitCompilationUnit(CompilationUnit node) {
+ CompilationUnit copy = new CompilationUnit(_mapToken(node.beginToken), _cloneNode(node.scriptTag), _cloneNodeList(node.directives), _cloneNodeList(node.declarations), _mapToken(node.endToken));
+ copy.lineInfo = node.lineInfo;
+ copy.element = node.element;
+ return copy;
+ }
+
+ @override
+ ConditionalExpression visitConditionalExpression(ConditionalExpression node) {
+ ConditionalExpression copy = new ConditionalExpression(_cloneNode(node.condition), _mapToken(node.question), _cloneNode(node.thenExpression), _mapToken(node.colon), _cloneNode(node.elseExpression));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ ConstructorDeclaration visitConstructorDeclaration(ConstructorDeclaration node) {
+ ConstructorDeclaration copy = new ConstructorDeclaration(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.externalKeyword), _mapToken(node.constKeyword), _mapToken(node.factoryKeyword), _cloneNode(node.returnType), _mapToken(node.period), _cloneNode(node.name), _cloneNode(node.parameters), _mapToken(node.separator), _cloneNodeList(node.initializers), _cloneNode(node.redirectedConstructor), _cloneNode(node.body));
+ copy.element = node.element;
+ return copy;
+ }
+
+ @override
+ ConstructorFieldInitializer visitConstructorFieldInitializer(ConstructorFieldInitializer node) => new ConstructorFieldInitializer(_mapToken(node.keyword), _mapToken(node.period), _cloneNode(node.fieldName), _mapToken(node.equals), _cloneNode(node.expression));
+
+ @override
+ ConstructorName visitConstructorName(ConstructorName node) {
+ ConstructorName copy = new ConstructorName(_cloneNode(node.type), _mapToken(node.period), _cloneNode(node.name));
+ copy.staticElement = node.staticElement;
+ return copy;
+ }
+
+ @override
+ ContinueStatement visitContinueStatement(ContinueStatement node) => new ContinueStatement(_mapToken(node.keyword), _cloneNode(node.label), _mapToken(node.semicolon));
+
+ @override
+ DeclaredIdentifier visitDeclaredIdentifier(DeclaredIdentifier node) => new DeclaredIdentifier(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.keyword), _cloneNode(node.type), _cloneNode(node.identifier));
+
+ @override
+ DefaultFormalParameter visitDefaultFormalParameter(DefaultFormalParameter node) => new DefaultFormalParameter(_cloneNode(node.parameter), node.kind, _mapToken(node.separator), _cloneNode(node.defaultValue));
+
+ @override
+ DoStatement visitDoStatement(DoStatement node) => new DoStatement(_mapToken(node.doKeyword), _cloneNode(node.body), _mapToken(node.whileKeyword), _mapToken(node.leftParenthesis), _cloneNode(node.condition), _mapToken(node.rightParenthesis), _mapToken(node.semicolon));
+
+ @override
+ DoubleLiteral visitDoubleLiteral(DoubleLiteral node) {
+ DoubleLiteral copy = new DoubleLiteral(_mapToken(node.literal), node.value);
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ EmptyFunctionBody visitEmptyFunctionBody(EmptyFunctionBody node) => new EmptyFunctionBody(_mapToken(node.semicolon));
+
+ @override
+ EmptyStatement visitEmptyStatement(EmptyStatement node) => new EmptyStatement(_mapToken(node.semicolon));
+
+ @override
+ AstNode visitEnumConstantDeclaration(EnumConstantDeclaration node) => new EnumConstantDeclaration(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _cloneNode(node.name));
+
+ @override
+ AstNode visitEnumDeclaration(EnumDeclaration node) => new EnumDeclaration(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.keyword), _cloneNode(node.name), _mapToken(node.leftBracket), _cloneNodeList(node.constants), _mapToken(node.rightBracket));
+
+ @override
+ ExportDirective visitExportDirective(ExportDirective node) {
+ ExportDirective copy = new ExportDirective(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.keyword), _cloneNode(node.uri), _cloneNodeList(node.combinators), _mapToken(node.semicolon));
+ copy.element = node.element;
+ return copy;
+ }
+
+ @override
+ ExpressionFunctionBody visitExpressionFunctionBody(ExpressionFunctionBody node) => new ExpressionFunctionBody(_mapToken(node.keyword), _mapToken(node.functionDefinition), _cloneNode(node.expression), _mapToken(node.semicolon));
+
+ @override
+ ExpressionStatement visitExpressionStatement(ExpressionStatement node) => new ExpressionStatement(_cloneNode(node.expression), _mapToken(node.semicolon));
+
+ @override
+ ExtendsClause visitExtendsClause(ExtendsClause node) => new ExtendsClause(_mapToken(node.keyword), _cloneNode(node.superclass));
+
+ @override
+ FieldDeclaration visitFieldDeclaration(FieldDeclaration node) => new FieldDeclaration(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.staticKeyword), _cloneNode(node.fields), _mapToken(node.semicolon));
+
+ @override
+ FieldFormalParameter visitFieldFormalParameter(FieldFormalParameter node) => new FieldFormalParameter(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.keyword), _cloneNode(node.type), _mapToken(node.thisToken), _mapToken(node.period), _cloneNode(node.identifier), _cloneNode(node.parameters));
+
+ @override
+ ForEachStatement visitForEachStatement(ForEachStatement node) {
+ DeclaredIdentifier loopVariable = node.loopVariable;
+ if (loopVariable == null) {
+ return new ForEachStatement.con2(_mapToken(node.awaitKeyword), _mapToken(node.forKeyword), _mapToken(node.leftParenthesis), _cloneNode(node.identifier), _mapToken(node.inKeyword), _cloneNode(node.iterator), _mapToken(node.rightParenthesis), _cloneNode(node.body));
+ }
+ return new ForEachStatement.con1(_mapToken(node.awaitKeyword), _mapToken(node.forKeyword), _mapToken(node.leftParenthesis), _cloneNode(loopVariable), _mapToken(node.inKeyword), _cloneNode(node.iterator), _mapToken(node.rightParenthesis), _cloneNode(node.body));
+ }
+
+ @override
+ FormalParameterList visitFormalParameterList(FormalParameterList node) => new FormalParameterList(_mapToken(node.leftParenthesis), _cloneNodeList(node.parameters), _mapToken(node.leftDelimiter), _mapToken(node.rightDelimiter), _mapToken(node.rightParenthesis));
+
+ @override
+ ForStatement visitForStatement(ForStatement node) => new ForStatement(_mapToken(node.forKeyword), _mapToken(node.leftParenthesis), _cloneNode(node.variables), _cloneNode(node.initialization), _mapToken(node.leftSeparator), _cloneNode(node.condition), _mapToken(node.rightSeparator), _cloneNodeList(node.updaters), _mapToken(node.rightParenthesis), _cloneNode(node.body));
+
+ @override
+ FunctionDeclaration visitFunctionDeclaration(FunctionDeclaration node) => new FunctionDeclaration(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.externalKeyword), _cloneNode(node.returnType), _mapToken(node.propertyKeyword), _cloneNode(node.name), _cloneNode(node.functionExpression));
+
+ @override
+ FunctionDeclarationStatement visitFunctionDeclarationStatement(FunctionDeclarationStatement node) => new FunctionDeclarationStatement(_cloneNode(node.functionDeclaration));
+
+ @override
+ FunctionExpression visitFunctionExpression(FunctionExpression node) {
+ FunctionExpression copy = new FunctionExpression(_cloneNode(node.parameters), _cloneNode(node.body));
+ copy.element = node.element;
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ FunctionExpressionInvocation visitFunctionExpressionInvocation(FunctionExpressionInvocation node) {
+ FunctionExpressionInvocation copy = new FunctionExpressionInvocation(_cloneNode(node.function), _cloneNode(node.argumentList));
+ copy.propagatedElement = node.propagatedElement;
+ copy.propagatedType = node.propagatedType;
+ copy.staticElement = node.staticElement;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ FunctionTypeAlias visitFunctionTypeAlias(FunctionTypeAlias node) => new FunctionTypeAlias(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.keyword), _cloneNode(node.returnType), _cloneNode(node.name), _cloneNode(node.typeParameters), _cloneNode(node.parameters), _mapToken(node.semicolon));
+
+ @override
+ FunctionTypedFormalParameter visitFunctionTypedFormalParameter(FunctionTypedFormalParameter node) => new FunctionTypedFormalParameter(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _cloneNode(node.returnType), _cloneNode(node.identifier), _cloneNode(node.parameters));
+
+ @override
+ HideCombinator visitHideCombinator(HideCombinator node) => new HideCombinator(_mapToken(node.keyword), _cloneNodeList(node.hiddenNames));
+
+ @override
+ IfStatement visitIfStatement(IfStatement node) => new IfStatement(_mapToken(node.ifKeyword), _mapToken(node.leftParenthesis), _cloneNode(node.condition), _mapToken(node.rightParenthesis), _cloneNode(node.thenStatement), _mapToken(node.elseKeyword), _cloneNode(node.elseStatement));
+
+ @override
+ ImplementsClause visitImplementsClause(ImplementsClause node) => new ImplementsClause(_mapToken(node.keyword), _cloneNodeList(node.interfaces));
+
+ @override
+ ImportDirective visitImportDirective(ImportDirective node) => new ImportDirective(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.keyword), _cloneNode(node.uri), _mapToken(node.deferredToken), _mapToken(node.asToken), _cloneNode(node.prefix), _cloneNodeList(node.combinators), _mapToken(node.semicolon));
+
+ @override
+ IndexExpression visitIndexExpression(IndexExpression node) {
+ Token period = _mapToken(node.period);
+ IndexExpression copy;
+ if (period == null) {
+ copy = new IndexExpression.forTarget(_cloneNode(node.target), _mapToken(node.leftBracket), _cloneNode(node.index), _mapToken(node.rightBracket));
+ } else {
+ copy = new IndexExpression.forCascade(period, _mapToken(node.leftBracket), _cloneNode(node.index), _mapToken(node.rightBracket));
+ }
+ copy.auxiliaryElements = node.auxiliaryElements;
+ copy.propagatedElement = node.propagatedElement;
+ copy.propagatedType = node.propagatedType;
+ copy.staticElement = node.staticElement;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ InstanceCreationExpression visitInstanceCreationExpression(InstanceCreationExpression node) {
+ InstanceCreationExpression copy = new InstanceCreationExpression(_mapToken(node.keyword), _cloneNode(node.constructorName), _cloneNode(node.argumentList));
+ copy.propagatedType = node.propagatedType;
+ copy.staticElement = node.staticElement;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ IntegerLiteral visitIntegerLiteral(IntegerLiteral node) {
+ IntegerLiteral copy = new IntegerLiteral(_mapToken(node.literal), node.value);
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ InterpolationExpression visitInterpolationExpression(InterpolationExpression node) => new InterpolationExpression(_mapToken(node.leftBracket), _cloneNode(node.expression), _mapToken(node.rightBracket));
+
+ @override
+ InterpolationString visitInterpolationString(InterpolationString node) => new InterpolationString(_mapToken(node.contents), node.value);
+
+ @override
+ IsExpression visitIsExpression(IsExpression node) {
+ IsExpression copy = new IsExpression(_cloneNode(node.expression), _mapToken(node.isOperator), _mapToken(node.notOperator), _cloneNode(node.type));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ Label visitLabel(Label node) => new Label(_cloneNode(node.label), _mapToken(node.colon));
+
+ @override
+ LabeledStatement visitLabeledStatement(LabeledStatement node) => new LabeledStatement(_cloneNodeList(node.labels), _cloneNode(node.statement));
+
+ @override
+ LibraryDirective visitLibraryDirective(LibraryDirective node) => new LibraryDirective(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.libraryToken), _cloneNode(node.name), _mapToken(node.semicolon));
+
+ @override
+ LibraryIdentifier visitLibraryIdentifier(LibraryIdentifier node) {
+ LibraryIdentifier copy = new LibraryIdentifier(_cloneNodeList(node.components));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ ListLiteral visitListLiteral(ListLiteral node) {
+ ListLiteral copy = new ListLiteral(_mapToken(node.constKeyword), _cloneNode(node.typeArguments), _mapToken(node.leftBracket), _cloneNodeList(node.elements), _mapToken(node.rightBracket));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ MapLiteral visitMapLiteral(MapLiteral node) {
+ MapLiteral copy = new MapLiteral(_mapToken(node.constKeyword), _cloneNode(node.typeArguments), _mapToken(node.leftBracket), _cloneNodeList(node.entries), _mapToken(node.rightBracket));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ MapLiteralEntry visitMapLiteralEntry(MapLiteralEntry node) => new MapLiteralEntry(_cloneNode(node.key), _mapToken(node.separator), _cloneNode(node.value));
+
+ @override
+ MethodDeclaration visitMethodDeclaration(MethodDeclaration node) => new MethodDeclaration(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.externalKeyword), _mapToken(node.modifierKeyword), _cloneNode(node.returnType), _mapToken(node.propertyKeyword), _mapToken(node.operatorKeyword), _cloneNode(node.name), _cloneNode(node.parameters), _cloneNode(node.body));
+
+ @override
+ MethodInvocation visitMethodInvocation(MethodInvocation node) {
+ MethodInvocation copy = new MethodInvocation(_cloneNode(node.target), _mapToken(node.period), _cloneNode(node.methodName), _cloneNode(node.argumentList));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ NamedExpression visitNamedExpression(NamedExpression node) {
+ NamedExpression copy = new NamedExpression(_cloneNode(node.name), _cloneNode(node.expression));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ AstNode visitNativeClause(NativeClause node) => new NativeClause(_mapToken(node.keyword), _cloneNode(node.name));
+
+ @override
+ NativeFunctionBody visitNativeFunctionBody(NativeFunctionBody node) => new NativeFunctionBody(_mapToken(node.nativeToken), _cloneNode(node.stringLiteral), _mapToken(node.semicolon));
+
+ @override
+ NullLiteral visitNullLiteral(NullLiteral node) {
+ NullLiteral copy = new NullLiteral(_mapToken(node.literal));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ ParenthesizedExpression visitParenthesizedExpression(ParenthesizedExpression node) {
+ ParenthesizedExpression copy = new ParenthesizedExpression(_mapToken(node.leftParenthesis), _cloneNode(node.expression), _mapToken(node.rightParenthesis));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ PartDirective visitPartDirective(PartDirective node) {
+ PartDirective copy = new PartDirective(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.partToken), _cloneNode(node.uri), _mapToken(node.semicolon));
+ copy.element = node.element;
+ return copy;
+ }
+
+ @override
+ PartOfDirective visitPartOfDirective(PartOfDirective node) {
+ PartOfDirective copy = new PartOfDirective(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.partToken), _mapToken(node.ofToken), _cloneNode(node.libraryName), _mapToken(node.semicolon));
+ copy.element = node.element;
+ return copy;
+ }
+
+ @override
+ PostfixExpression visitPostfixExpression(PostfixExpression node) {
+ PostfixExpression copy = new PostfixExpression(_cloneNode(node.operand), _mapToken(node.operator));
+ copy.propagatedElement = node.propagatedElement;
+ copy.propagatedType = node.propagatedType;
+ copy.staticElement = node.staticElement;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ PrefixedIdentifier visitPrefixedIdentifier(PrefixedIdentifier node) {
+ PrefixedIdentifier copy = new PrefixedIdentifier(_cloneNode(node.prefix), _mapToken(node.period), _cloneNode(node.identifier));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ PrefixExpression visitPrefixExpression(PrefixExpression node) {
+ PrefixExpression copy = new PrefixExpression(_mapToken(node.operator), _cloneNode(node.operand));
+ copy.propagatedElement = node.propagatedElement;
+ copy.propagatedType = node.propagatedType;
+ copy.staticElement = node.staticElement;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ PropertyAccess visitPropertyAccess(PropertyAccess node) {
+ PropertyAccess copy = new PropertyAccess(_cloneNode(node.target), _mapToken(node.operator), _cloneNode(node.propertyName));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ RedirectingConstructorInvocation visitRedirectingConstructorInvocation(RedirectingConstructorInvocation node) {
+ RedirectingConstructorInvocation copy = new RedirectingConstructorInvocation(_mapToken(node.keyword), _mapToken(node.period), _cloneNode(node.constructorName), _cloneNode(node.argumentList));
+ copy.staticElement = node.staticElement;
+ return copy;
+ }
+
+ @override
+ RethrowExpression visitRethrowExpression(RethrowExpression node) {
+ RethrowExpression copy = new RethrowExpression(_mapToken(node.keyword));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ ReturnStatement visitReturnStatement(ReturnStatement node) => new ReturnStatement(_mapToken(node.keyword), _cloneNode(node.expression), _mapToken(node.semicolon));
+
+ @override
+ ScriptTag visitScriptTag(ScriptTag node) => new ScriptTag(_mapToken(node.scriptTag));
+
+ @override
+ ShowCombinator visitShowCombinator(ShowCombinator node) => new ShowCombinator(_mapToken(node.keyword), _cloneNodeList(node.shownNames));
+
+ @override
+ SimpleFormalParameter visitSimpleFormalParameter(SimpleFormalParameter node) => new SimpleFormalParameter(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _mapToken(node.keyword), _cloneNode(node.type), _cloneNode(node.identifier));
+
+ @override
+ SimpleIdentifier visitSimpleIdentifier(SimpleIdentifier node) {
+ Token mappedToken = _mapToken(node.token);
+ if (mappedToken == null) {
+ // This only happens for SimpleIdentifiers created by the parser as part of scanning
+ // documentation comments (the tokens for those identifiers are not in the original token
+ // stream and hence do not get copied). This extra check can be removed if the scanner is
+ // changed to scan documentation comments for the parser.
+ mappedToken = node.token;
+ }
+ SimpleIdentifier copy = new SimpleIdentifier(mappedToken);
+ copy.auxiliaryElements = node.auxiliaryElements;
+ copy.propagatedElement = node.propagatedElement;
+ copy.propagatedType = node.propagatedType;
+ copy.staticElement = node.staticElement;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ SimpleStringLiteral visitSimpleStringLiteral(SimpleStringLiteral node) {
+ SimpleStringLiteral copy = new SimpleStringLiteral(_mapToken(node.literal), node.value);
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ StringInterpolation visitStringInterpolation(StringInterpolation node) {
+ StringInterpolation copy = new StringInterpolation(_cloneNodeList(node.elements));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ SuperConstructorInvocation visitSuperConstructorInvocation(SuperConstructorInvocation node) {
+ SuperConstructorInvocation copy = new SuperConstructorInvocation(_mapToken(node.keyword), _mapToken(node.period), _cloneNode(node.constructorName), _cloneNode(node.argumentList));
+ copy.staticElement = node.staticElement;
+ return copy;
+ }
+
+ @override
+ SuperExpression visitSuperExpression(SuperExpression node) {
+ SuperExpression copy = new SuperExpression(_mapToken(node.keyword));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ SwitchCase visitSwitchCase(SwitchCase node) => new SwitchCase(_cloneNodeList(node.labels), _mapToken(node.keyword), _cloneNode(node.expression), _mapToken(node.colon), _cloneNodeList(node.statements));
+
+ @override
+ SwitchDefault visitSwitchDefault(SwitchDefault node) => new SwitchDefault(_cloneNodeList(node.labels), _mapToken(node.keyword), _mapToken(node.colon), _cloneNodeList(node.statements));
+
+ @override
+ SwitchStatement visitSwitchStatement(SwitchStatement node) => new SwitchStatement(_mapToken(node.keyword), _mapToken(node.leftParenthesis), _cloneNode(node.expression), _mapToken(node.rightParenthesis), _mapToken(node.leftBracket), _cloneNodeList(node.members), _mapToken(node.rightBracket));
+
+ @override
+ AstNode visitSymbolLiteral(SymbolLiteral node) {
+ SymbolLiteral copy = new SymbolLiteral(_mapToken(node.poundSign), _mapTokens(node.components));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ ThisExpression visitThisExpression(ThisExpression node) {
+ ThisExpression copy = new ThisExpression(_mapToken(node.keyword));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ ThrowExpression visitThrowExpression(ThrowExpression node) {
+ ThrowExpression copy = new ThrowExpression(_mapToken(node.keyword), _cloneNode(node.expression));
+ copy.propagatedType = node.propagatedType;
+ copy.staticType = node.staticType;
+ return copy;
+ }
+
+ @override
+ TopLevelVariableDeclaration visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node) => new TopLevelVariableDeclaration(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _cloneNode(node.variables), _mapToken(node.semicolon));
+
+ @override
+ TryStatement visitTryStatement(TryStatement node) => new TryStatement(_mapToken(node.tryKeyword), _cloneNode(node.body), _cloneNodeList(node.catchClauses), _mapToken(node.finallyKeyword), _cloneNode(node.finallyBlock));
+
+ @override
+ TypeArgumentList visitTypeArgumentList(TypeArgumentList node) => new TypeArgumentList(_mapToken(node.leftBracket), _cloneNodeList(node.arguments), _mapToken(node.rightBracket));
+
+ @override
+ TypeName visitTypeName(TypeName node) {
+ TypeName copy = new TypeName(_cloneNode(node.name), _cloneNode(node.typeArguments));
+ copy.type = node.type;
+ return copy;
+ }
+
+ @override
+ TypeParameter visitTypeParameter(TypeParameter node) => new TypeParameter(_cloneNode(node.documentationComment), _cloneNodeList(node.metadata), _cloneNode(node.name), _mapToken(node.keyword), _cloneNode(node.bound));
+
+ @override
+ TypeParameterList visitTypeParameterList(TypeParameterList node) => new TypeParameterList(_mapToken(node.leftBracket), _cloneNodeList(node.typeParameters), _mapToken(node.rightBracket));
+
+ @override
+ VariableDeclaration visitVariableDeclaration(VariableDeclaration node) => new VariableDeclaration(null, _cloneNodeList(node.metadata), _cloneNode(node.name), _mapToken(node.equals), _cloneNode(node.initializer));
+
+ @override
+ VariableDeclarationList visitVariableDeclarationList(VariableDeclarationList node) => new VariableDeclarationList(null, _cloneNodeList(node.metadata), _mapToken(node.keyword), _cloneNode(node.type), _cloneNodeList(node.variables));
+
+ @override
+ VariableDeclarationStatement visitVariableDeclarationStatement(VariableDeclarationStatement node) => new VariableDeclarationStatement(_cloneNode(node.variables), _mapToken(node.semicolon));
+
+ @override
+ WhileStatement visitWhileStatement(WhileStatement node) => new WhileStatement(_mapToken(node.keyword), _mapToken(node.leftParenthesis), _cloneNode(node.condition), _mapToken(node.rightParenthesis), _cloneNode(node.body));
+
+ @override
+ WithClause visitWithClause(WithClause node) => new WithClause(_mapToken(node.withKeyword), _cloneNodeList(node.mixinTypes));
+
+ @override
+ YieldStatement visitYieldStatement(YieldStatement node) => new YieldStatement(_mapToken(node.yieldKeyword), _mapToken(node.star), _cloneNode(node.expression), _mapToken(node.semicolon));
+
+ AstNode _cloneNode(AstNode node) {
+ if (node == null) {
+ return null;
+ }
+ if (identical(node, _oldNode)) {
+ return _newNode;
+ }
+ return node.accept(this) as AstNode;
+ }
+
+ List _cloneNodeList(NodeList nodes) {
+ List clonedNodes = new List();
+ for (AstNode node in nodes) {
+ clonedNodes.add(_cloneNode(node));
+ }
+ return clonedNodes;
+ }
+
+ Token _mapToken(Token oldToken) {
+ if (oldToken == null) {
+ return null;
+ }
+ return _tokenMap.get(oldToken);
+ }
+
+ List<Token> _mapTokens(List<Token> oldTokens) {
+ List<Token> newTokens = new List<Token>(oldTokens.length);
+ for (int index = 0; index < newTokens.length; index++) {
+ newTokens[index] = _mapToken(oldTokens[index]);
+ }
+ return newTokens;
+ }
+}
+
+/**
+ * Instances of the class `IndexExpression` represent an index expression.
+ *
+ * <pre>
+ * indexExpression ::=
+ * [Expression] '[' [Expression] ']'
+ * </pre>
+ */
+class IndexExpression extends Expression {
+ /**
+ * The expression used to compute the object being indexed, or `null` if this index
+ * expression is part of a cascade expression.
+ */
+ Expression _target;
+
+ /**
+ * The period ("..") before a cascaded index expression, or `null` if this index expression
+ * is not part of a cascade expression.
+ */
+ Token period;
+
+ /**
+ * The left square bracket.
+ */
+ Token _leftBracket;
+
+ /**
+ * The expression used to compute the index.
+ */
+ Expression _index;
+
+ /**
+ * The right square bracket.
+ */
+ Token _rightBracket;
+
+ /**
+ * The element associated with the operator based on the static type of the target, or
+ * `null` if the AST structure has not been resolved or if the operator could not be
+ * resolved.
+ */
+ MethodElement _staticElement;
+
+ /**
+ * The element associated with the operator based on the propagated type of the target, or
+ * `null` if the AST structure has not been resolved or if the operator could not be
+ * resolved.
+ */
+ MethodElement _propagatedElement;
+
+ /**
+ * If this expression is both in a getter and setter context, the [AuxiliaryElements] will
+ * be set to hold onto the static and propagated information. The auxiliary element will hold onto
+ * the elements from the getter context.
+ */
+ AuxiliaryElements auxiliaryElements = null;
+
+ /**
+ * Initialize a newly created index expression.
+ *
+ * @param target the expression used to compute the object being indexed
+ * @param leftBracket the left square bracket
+ * @param index the expression used to compute the index
+ * @param rightBracket the right square bracket
+ */
+ IndexExpression.forTarget(Expression target, Token leftBracket, Expression index, Token rightBracket) {
+ this._target = becomeParentOf(target);
+ this._leftBracket = leftBracket;
+ this._index = becomeParentOf(index);
+ this._rightBracket = rightBracket;
+ }
+
+ /**
+ * Initialize a newly created index expression.
+ *
+ * @param period the period ("..") before a cascaded index expression
+ * @param leftBracket the left square bracket
+ * @param index the expression used to compute the index
+ * @param rightBracket the right square bracket
+ */
+ IndexExpression.forCascade(this.period, Token leftBracket, Expression index, Token rightBracket) {
+ this._leftBracket = leftBracket;
+ this._index = becomeParentOf(index);
+ this._rightBracket = rightBracket;
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitIndexExpression(this);
+
+ @override
+ Token get beginToken {
+ if (_target != null) {
+ return _target.beginToken;
+ }
+ return period;
+ }
+
+ /**
+ * Return the best element available for this operator. If resolution was able to find a better
+ * element based on type propagation, that element will be returned. Otherwise, the element found
+ * using the result of static analysis will be returned. If resolution has not been performed,
+ * then `null` will be returned.
+ *
+ * @return the best element available for this operator
+ */
+ MethodElement get bestElement {
+ MethodElement element = propagatedElement;
+ if (element == null) {
+ element = staticElement;
+ }
+ return element;
+ }
+
+ @override
+ Token get endToken => _rightBracket;
+
+ /**
+ * Return the expression used to compute the index.
+ *
+ * @return the expression used to compute the index
+ */
+ Expression get index => _index;
+
+ /**
+ * Return the left square bracket.
+ *
+ * @return the left square bracket
+ */
+ Token get leftBracket => _leftBracket;
+
+ @override
+ int get precedence => 15;
+
+ /**
+ * Return the element associated with the operator based on the propagated type of the target, or
+ * `null` if the AST structure has not been resolved or if the operator could not be
+ * resolved. One example of the latter case is an operator that is not defined for the type of the
+ * target.
+ *
+ * @return the element associated with this operator
+ */
+ MethodElement get propagatedElement => _propagatedElement;
+
+ /**
+ * Return the expression used to compute the object being indexed. If this index expression is not
+ * part of a cascade expression, then this is the same as [getTarget]. If this index
+ * expression is part of a cascade expression, then the target expression stored with the cascade
+ * expression is returned.
+ *
+ * @return the expression used to compute the object being indexed
+ * @see #getTarget()
+ */
+ Expression get realTarget {
+ if (isCascaded) {
+ AstNode ancestor = parent;
+ while (ancestor is! CascadeExpression) {
+ if (ancestor == null) {
+ return _target;
+ }
+ ancestor = ancestor.parent;
+ }
+ return (ancestor as CascadeExpression).target;
+ }
+ return _target;
+ }
+
+ /**
+ * Return the right square bracket.
+ *
+ * @return the right square bracket
+ */
+ Token get rightBracket => _rightBracket;
+
+ /**
+ * Return the element associated with the operator based on the static type of the target, or
+ * `null` if the AST structure has not been resolved or if the operator could not be
+ * resolved. One example of the latter case is an operator that is not defined for the type of the
+ * target.
+ *
+ * @return the element associated with the operator
+ */
+ MethodElement get staticElement => _staticElement;
+
+ /**
+ * Return the expression used to compute the object being indexed, or `null` if this index
+ * expression is part of a cascade expression.
+ *
+ * @return the expression used to compute the object being indexed
+ * @see #getRealTarget()
+ */
+ Expression get target => _target;
+
+ /**
+ * Return `true` if this expression is computing a right-hand value.
+ *
+ * Note that [inGetterContext] and [inSetterContext] are not opposites, nor are
+ * they mutually exclusive. In other words, it is possible for both methods to return `true`
+ * when invoked on the same node.
+ *
+ * @return `true` if this expression is in a context where the operator '[]' will be invoked
+ */
+ bool inGetterContext() {
+ AstNode parent = this.parent;
+ if (parent is AssignmentExpression) {
+ AssignmentExpression assignment = parent;
+ if (identical(assignment.leftHandSide, this) && assignment.operator.type == TokenType.EQ) {
+ return false;
+ }
+ }
+ return true;
+ }
+
+ /**
+ * Return `true` if this expression is computing a left-hand value.
+ *
+ * Note that [inGetterContext] and [inSetterContext] are not opposites, nor are
+ * they mutually exclusive. In other words, it is possible for both methods to return `true`
+ * when invoked on the same node.
+ *
+ * @return `true` if this expression is in a context where the operator '[]=' will be
+ * invoked
+ */
+ bool inSetterContext() {
+ AstNode parent = this.parent;
+ if (parent is PrefixExpression) {
+ return parent.operator.type.isIncrementOperator;
+ } else if (parent is PostfixExpression) {
+ return true;
+ } else if (parent is AssignmentExpression) {
+ return identical(parent.leftHandSide, this);
+ }
+ return false;
+ }
+
+ @override
+ bool get isAssignable => true;
+
+ /**
+ * Return `true` if this expression is cascaded. If it is, then the target of this
+ * expression is not stored locally but is stored in the nearest ancestor that is a
+ * [CascadeExpression].
+ *
+ * @return `true` if this expression is cascaded
+ */
+ bool get isCascaded => period != null;
+
+ /**
+ * Set the expression used to compute the index to the given expression.
+ *
+ * @param expression the expression used to compute the index
+ */
+ void set index(Expression expression) {
+ _index = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the left square bracket to the given token.
+ *
+ * @param bracket the left square bracket
+ */
+ void set leftBracket(Token bracket) {
+ _leftBracket = bracket;
+ }
+
+ /**
+ * Set the element associated with the operator based on the propagated type of the target to the
+ * given element.
+ *
+ * @param element the element to be associated with this operator
+ */
+ void set propagatedElement(MethodElement element) {
+ _propagatedElement = element;
+ }
+
+ /**
+ * Set the right square bracket to the given token.
+ *
+ * @param bracket the right square bracket
+ */
+ void set rightBracket(Token bracket) {
+ _rightBracket = bracket;
+ }
+
+ /**
+ * Set the element associated with the operator based on the static type of the target to the
+ * given element.
+ *
+ * @param element the static element to be associated with the operator
+ */
+ void set staticElement(MethodElement element) {
+ _staticElement = element;
+ }
+
+ /**
+ * Set the expression used to compute the object being indexed to the given expression.
+ *
+ * @param expression the expression used to compute the object being indexed
+ */
+ void set target(Expression expression) {
+ _target = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_target, visitor);
+ safelyVisitChild(_index, visitor);
+ }
+
+ /**
+ * If the AST structure has been resolved, and the function being invoked is known based on
+ * propagated type information, then return the parameter element representing the parameter to
+ * which the value of the index expression will be bound. Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getPropagatedParameterElement].
+ *
+ * @return the parameter element representing the parameter to which the value of the index
+ * expression will be bound
+ */
+ ParameterElement get propagatedParameterElementForIndex {
+ if (_propagatedElement == null) {
+ return null;
+ }
+ List<ParameterElement> parameters = _propagatedElement.parameters;
+ if (parameters.length < 1) {
+ return null;
+ }
+ return parameters[0];
+ }
+
+ /**
+ * If the AST structure has been resolved, and the function being invoked is known based on static
+ * type information, then return the parameter element representing the parameter to which the
+ * value of the index expression will be bound. Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getStaticParameterElement].
+ *
+ * @return the parameter element representing the parameter to which the value of the index
+ * expression will be bound
+ */
+ ParameterElement get staticParameterElementForIndex {
+ if (_staticElement == null) {
+ return null;
+ }
+ List<ParameterElement> parameters = _staticElement.parameters;
+ if (parameters.length < 1) {
+ return null;
+ }
+ return parameters[0];
+ }
+}
+
+/**
+ * Instances of the class `InstanceCreationExpression` represent an instance creation
+ * expression.
+ *
+ * <pre>
+ * newExpression ::=
+ * ('new' | 'const') [TypeName] ('.' [SimpleIdentifier])? [ArgumentList]
+ * </pre>
+ */
+class InstanceCreationExpression extends Expression {
+ /**
+ * The keyword used to indicate how an object should be created.
+ */
+ Token keyword;
+
+ /**
+ * The name of the constructor to be invoked.
+ */
+ ConstructorName _constructorName;
+
+ /**
+ * The list of arguments to the constructor.
+ */
+ ArgumentList _argumentList;
+
+ /**
+ * The element associated with the constructor based on static type information, or `null`
+ * if the AST structure has not been resolved or if the constructor could not be resolved.
+ */
+ ConstructorElement staticElement;
+
+ /**
+ * The result of evaluating this expression, if it is constant.
+ */
+ EvaluationResultImpl _result;
+
+ /**
+ * Initialize a newly created instance creation expression.
+ *
+ * @param keyword the keyword used to indicate how an object should be created
+ * @param constructorName the name of the constructor to be invoked
+ * @param argumentList the list of arguments to the constructor
+ */
+ InstanceCreationExpression(this.keyword, ConstructorName constructorName, ArgumentList argumentList) {
+ this._constructorName = becomeParentOf(constructorName);
+ this._argumentList = becomeParentOf(argumentList);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitInstanceCreationExpression(this);
+
+ /**
+ * Return the list of arguments to the constructor.
+ *
+ * @return the list of arguments to the constructor
+ */
+ ArgumentList get argumentList => _argumentList;
+
+ @override
+ Token get beginToken => keyword;
+
+ /**
+ * Return the name of the constructor to be invoked.
+ *
+ * @return the name of the constructor to be invoked
+ */
+ ConstructorName get constructorName => _constructorName;
+
+ @override
+ Token get endToken => _argumentList.endToken;
+
+ /**
+ * Return the result of evaluating this constant as a compile-time constant expression, or
+ * `null` if this variable is not a 'const' expression or an error prevented the result from
+ * being computed.
+ *
+ * @return the result of evaluating this constant
+ */
+ EvaluationResultImpl get evaluationResult => _result;
+
+ @override
+ int get precedence => 15;
+
+ /**
+ * Return `true` if this creation expression is used to invoke a constant constructor.
+ *
+ * @return `true` if this creation expression is used to invoke a constant constructor
+ */
+ bool get isConst => keyword is KeywordToken && (keyword as KeywordToken).keyword == Keyword.CONST;
+
+ /**
+ * Set the list of arguments to the constructor to the given list.
+ *
+ * @param argumentList the list of arguments to the constructor
+ */
+ void set argumentList(ArgumentList argumentList) {
+ this._argumentList = becomeParentOf(argumentList);
+ }
+
+ /**
+ * Set the name of the constructor to be invoked to the given name.
+ *
+ * @param constructorName the name of the constructor to be invoked
+ */
+ void set constructorName(ConstructorName constructorName) {
+ this._constructorName = becomeParentOf(constructorName);
+ }
+
+ /**
+ * Set the result of evaluating this expression as a compile-time constant expression to the given
+ * result.
+ *
+ * @param result the result of evaluating this expression
+ */
+ void set evaluationResult(EvaluationResultImpl result) {
+ this._result = result;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_constructorName, visitor);
+ safelyVisitChild(_argumentList, visitor);
+ }
+}
+
+/**
+ * Instances of the class `IntegerLiteral` represent an integer literal expression.
+ *
+ * <pre>
+ * integerLiteral ::=
+ * decimalIntegerLiteral
+ * | hexidecimalIntegerLiteral
+ *
+ * decimalIntegerLiteral ::=
+ * decimalDigit+
+ *
+ * hexidecimalIntegerLiteral ::=
+ * '0x' hexidecimalDigit+
+ * | '0X' hexidecimalDigit+
+ * </pre>
+ */
+class IntegerLiteral extends Literal {
+ /**
+ * The token representing the literal.
+ */
+ Token literal;
+
+ /**
+ * The value of the literal.
+ */
+ int value = 0;
+
+ /**
+ * Initialize a newly created integer literal.
+ *
+ * @param literal the token representing the literal
+ * @param value the value of the literal
+ */
+ IntegerLiteral(this.literal, this.value);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitIntegerLiteral(this);
+
+ @override
+ Token get beginToken => literal;
+
+ @override
+ Token get endToken => literal;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * The abstract class `InterpolationElement` defines the behavior common to elements within a
+ * [StringInterpolation].
+ *
+ * <pre>
+ * interpolationElement ::=
+ * [InterpolationExpression]
+ * | [InterpolationString]
+ * </pre>
+ */
+abstract class InterpolationElement extends AstNode {
+}
+
+/**
+ * Instances of the class `InterpolationExpression` represent an expression embedded in a
+ * string interpolation.
+ *
+ * <pre>
+ * interpolationExpression ::=
+ * '$' [SimpleIdentifier]
+ * | '$' '{' [Expression] '}'
+ * </pre>
+ */
+class InterpolationExpression extends InterpolationElement {
+ /**
+ * The token used to introduce the interpolation expression; either '$' if the expression is a
+ * simple identifier or '${' if the expression is a full expression.
+ */
+ Token leftBracket;
+
+ /**
+ * The expression to be evaluated for the value to be converted into a string.
+ */
+ Expression _expression;
+
+ /**
+ * The right curly bracket, or `null` if the expression is an identifier without brackets.
+ */
+ Token rightBracket;
+
+ /**
+ * Initialize a newly created interpolation expression.
+ *
+ * @param leftBracket the left curly bracket
+ * @param expression the expression to be evaluated for the value to be converted into a string
+ * @param rightBracket the right curly bracket
+ */
+ InterpolationExpression(this.leftBracket, Expression expression, this.rightBracket) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitInterpolationExpression(this);
+
+ @override
+ Token get beginToken => leftBracket;
+
+ @override
+ Token get endToken {
+ if (rightBracket != null) {
+ return rightBracket;
+ }
+ return _expression.endToken;
+ }
+
+ /**
+ * Return the expression to be evaluated for the value to be converted into a string.
+ *
+ * @return the expression to be evaluated for the value to be converted into a string
+ */
+ Expression get expression => _expression;
+
+ /**
+ * Set the expression to be evaluated for the value to be converted into a string to the given
+ * expression.
+ *
+ * @param expression the expression to be evaluated for the value to be converted into a string
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_expression, visitor);
+ }
+}
+
+/**
+ * Instances of the class `InterpolationString` represent a non-empty substring of an
+ * interpolated string.
+ *
+ * <pre>
+ * interpolationString ::=
+ * characters
+ * </pre>
+ */
+class InterpolationString extends InterpolationElement {
+ /**
+ * The characters that will be added to the string.
+ */
+ Token _contents;
+
+ /**
+ * The value of the literal.
+ */
+ String _value;
+
+ /**
+ * Initialize a newly created string of characters that are part of a string interpolation.
+ *
+ * @param the characters that will be added to the string
+ * @param value the value of the literal
+ */
+ InterpolationString(Token contents, String value) {
+ this._contents = contents;
+ this._value = value;
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitInterpolationString(this);
+
+ @override
+ Token get beginToken => _contents;
+
+ /**
+ * Return the characters that will be added to the string.
+ *
+ * @return the characters that will be added to the string
+ */
+ Token get contents => _contents;
+
+ @override
+ Token get endToken => _contents;
+
+ /**
+ * Return the value of the literal.
+ *
+ * @return the value of the literal
+ */
+ String get value => _value;
+
+ /**
+ * Set the characters that will be added to the string to those in the given string.
+ *
+ * @param string the characters that will be added to the string
+ */
+ void set contents(Token string) {
+ _contents = string;
+ }
+
+ /**
+ * Set the value of the literal to the given string.
+ *
+ * @param string the value of the literal
+ */
+ void set value(String string) {
+ _value = string;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * Instances of the class `IsExpression` represent an is expression.
+ *
+ * <pre>
+ * isExpression ::=
+ * [Expression] 'is' '!'? [TypeName]
+ * </pre>
+ */
+class IsExpression extends Expression {
+ /**
+ * The expression used to compute the value whose type is being tested.
+ */
+ Expression _expression;
+
+ /**
+ * The is operator.
+ */
+ Token isOperator;
+
+ /**
+ * The not operator, or `null` if the sense of the test is not negated.
+ */
+ Token notOperator;
+
+ /**
+ * The name of the type being tested for.
+ */
+ TypeName _type;
+
+ /**
+ * Initialize a newly created is expression.
+ *
+ * @param expression the expression used to compute the value whose type is being tested
+ * @param isOperator the is operator
+ * @param notOperator the not operator, or `null` if the sense of the test is not negated
+ * @param type the name of the type being tested for
+ */
+ IsExpression(Expression expression, this.isOperator, this.notOperator, TypeName type) {
+ this._expression = becomeParentOf(expression);
+ this._type = becomeParentOf(type);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitIsExpression(this);
+
+ @override
+ Token get beginToken => _expression.beginToken;
+
+ @override
+ Token get endToken => _type.endToken;
+
+ /**
+ * Return the expression used to compute the value whose type is being tested.
+ *
+ * @return the expression used to compute the value whose type is being tested
+ */
+ Expression get expression => _expression;
+
+ @override
+ int get precedence => 7;
+
+ /**
+ * Return the name of the type being tested for.
+ *
+ * @return the name of the type being tested for
+ */
+ TypeName get type => _type;
+
+ /**
+ * Set the expression used to compute the value whose type is being tested to the given
+ * expression.
+ *
+ * @param expression the expression used to compute the value whose type is being tested
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the name of the type being tested for to the given name.
+ *
+ * @param name the name of the type being tested for
+ */
+ void set type(TypeName name) {
+ this._type = becomeParentOf(name);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_expression, visitor);
+ safelyVisitChild(_type, visitor);
+ }
+}
+
+/**
+ * Instances of the class `Label` represent a label.
+ *
+ * <pre>
+ * label ::=
+ * [SimpleIdentifier] ':'
+ * </pre>
+ */
+class Label extends AstNode {
+ /**
+ * The label being associated with the statement.
+ */
+ SimpleIdentifier _label;
+
+ /**
+ * The colon that separates the label from the statement.
+ */
+ Token colon;
+
+ /**
+ * Initialize a newly created label.
+ *
+ * @param label the label being applied
+ * @param colon the colon that separates the label from whatever follows
+ */
+ Label(SimpleIdentifier label, this.colon) {
+ this._label = becomeParentOf(label);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitLabel(this);
+
+ @override
+ Token get beginToken => _label.beginToken;
+
+ @override
+ Token get endToken => colon;
+
+ /**
+ * Return the label being associated with the statement.
+ *
+ * @return the label being associated with the statement
+ */
+ SimpleIdentifier get label => _label;
+
+ /**
+ * Set the label being associated with the statement to the given label.
+ *
+ * @param label the label being associated with the statement
+ */
+ void set label(SimpleIdentifier label) {
+ this._label = becomeParentOf(label);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_label, visitor);
+ }
+}
+
+/**
+ * Instances of the class `LabeledStatement` represent a statement that has a label associated
+ * with them.
+ *
+ * <pre>
+ * labeledStatement ::=
+ * [Label]+ [Statement]
+ * </pre>
+ */
+class LabeledStatement extends Statement {
+ /**
+ * The labels being associated with the statement.
+ */
+ NodeList<Label> _labels;
+
+ /**
+ * The statement with which the labels are being associated.
+ */
+ Statement _statement;
+
+ /**
+ * Initialize a newly created labeled statement.
+ *
+ * @param labels the labels being associated with the statement
+ * @param statement the statement with which the labels are being associated
+ */
+ LabeledStatement(List<Label> labels, Statement statement) {
+ this._labels = new NodeList<Label>(this);
+ this._labels.addAll(labels);
+ this._statement = becomeParentOf(statement);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitLabeledStatement(this);
+
+ @override
+ Token get beginToken {
+ if (!_labels.isEmpty) {
+ return _labels.beginToken;
+ }
+ return _statement.beginToken;
+ }
+
+ @override
+ Token get endToken => _statement.endToken;
+
+ /**
+ * Return the labels being associated with the statement.
+ *
+ * @return the labels being associated with the statement
+ */
+ NodeList<Label> get labels => _labels;
+
+ /**
+ * Return the statement with which the labels are being associated.
+ *
+ * @return the statement with which the labels are being associated
+ */
+ Statement get statement => _statement;
+
+ /**
+ * Set the statement with which the labels are being associated to the given statement.
+ *
+ * @param statement the statement with which the labels are being associated
+ */
+ void set statement(Statement statement) {
+ this._statement = becomeParentOf(statement);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _labels.accept(visitor);
+ safelyVisitChild(_statement, visitor);
+ }
+}
+
+/**
+ * Instances of the class `LibraryDirective` represent a library directive.
+ *
+ * <pre>
+ * libraryDirective ::=
+ * [Annotation] 'library' [Identifier] ';'
+ * </pre>
+ */
+class LibraryDirective extends Directive {
+ /**
+ * The token representing the 'library' token.
+ */
+ Token libraryToken;
+
+ /**
+ * The name of the library being defined.
+ */
+ LibraryIdentifier _name;
+
+ /**
+ * The semicolon terminating the directive.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created library directive.
+ *
+ * @param comment the documentation comment associated with this directive
+ * @param metadata the annotations associated with the directive
+ * @param libraryToken the token representing the 'library' token
+ * @param name the name of the library being defined
+ * @param semicolon the semicolon terminating the directive
+ */
+ LibraryDirective(Comment comment, List<Annotation> metadata, this.libraryToken, LibraryIdentifier name, this.semicolon) : super(comment, metadata) {
+ this._name = becomeParentOf(name);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitLibraryDirective(this);
+
+ @override
+ Token get endToken => semicolon;
+
+ @override
+ Token get keyword => libraryToken;
+
+ /**
+ * Return the name of the library being defined.
+ *
+ * @return the name of the library being defined
+ */
+ LibraryIdentifier get name => _name;
+
+ /**
+ * Set the name of the library being defined to the given name.
+ *
+ * @param name the name of the library being defined
+ */
+ void set name(LibraryIdentifier name) {
+ this._name = becomeParentOf(name);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_name, visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata => libraryToken;
+}
+
+/**
+ * Instances of the class `LibraryIdentifier` represent the identifier for a library.
+ *
+ * <pre>
+ * libraryIdentifier ::=
+ * [SimpleIdentifier] ('.' [SimpleIdentifier])*
+ * </pre>
+ */
+class LibraryIdentifier extends Identifier {
+ /**
+ * The components of the identifier.
+ */
+ NodeList<SimpleIdentifier> _components;
+
+ /**
+ * Initialize a newly created prefixed identifier.
+ *
+ * @param components the components of the identifier
+ */
+ LibraryIdentifier(List<SimpleIdentifier> components) {
+ this._components = new NodeList<SimpleIdentifier>(this);
+ this._components.addAll(components);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitLibraryIdentifier(this);
+
+ @override
+ Token get beginToken => _components.beginToken;
+
+ @override
+ Element get bestElement => staticElement;
+
+ /**
+ * Return the components of the identifier.
+ *
+ * @return the components of the identifier
+ */
+ NodeList<SimpleIdentifier> get components => _components;
+
+ @override
+ Token get endToken => _components.endToken;
+
+ @override
+ String get name {
+ JavaStringBuilder builder = new JavaStringBuilder();
+ bool needsPeriod = false;
+ for (SimpleIdentifier identifier in _components) {
+ if (needsPeriod) {
+ builder.append(".");
+ } else {
+ needsPeriod = true;
+ }
+ builder.append(identifier.name);
+ }
+ return builder.toString();
+ }
+
+ @override
+ int get precedence => 15;
+
+ @override
+ Element get propagatedElement => null;
+
+ @override
+ Element get staticElement => null;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _components.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `ListLiteral` represent a list literal.
+ *
+ * <pre>
+ * listLiteral ::=
+ * 'const'? ('<' [TypeName] '>')? '[' ([Expression] ','?)? ']'
+ * </pre>
+ */
+class ListLiteral extends TypedLiteral {
+ /**
+ * The left square bracket.
+ */
+ Token _leftBracket;
+
+ /**
+ * The expressions used to compute the elements of the list.
+ */
+ NodeList<Expression> _elements;
+
+ /**
+ * The right square bracket.
+ */
+ Token _rightBracket;
+
+ /**
+ * Initialize a newly created list literal.
+ *
+ * @param constKeyword the token representing the 'const' keyword
+ * @param typeArguments the type argument associated with this literal, or `null` if no type
+ * arguments were declared
+ * @param leftBracket the left square bracket
+ * @param elements the expressions used to compute the elements of the list
+ * @param rightBracket the right square bracket
+ */
+ ListLiteral(Token constKeyword, TypeArgumentList typeArguments, Token leftBracket, List<Expression> elements, Token rightBracket) : super(constKeyword, typeArguments) {
+ this._elements = new NodeList<Expression>(this);
+ this._leftBracket = leftBracket;
+ this._elements.addAll(elements);
+ this._rightBracket = rightBracket;
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitListLiteral(this);
+
+ @override
+ Token get beginToken {
+ Token token = constKeyword;
+ if (token != null) {
+ return token;
+ }
+ TypeArgumentList typeArguments = this.typeArguments;
+ if (typeArguments != null) {
+ return typeArguments.beginToken;
+ }
+ return _leftBracket;
+ }
+
+ /**
+ * Return the expressions used to compute the elements of the list.
+ *
+ * @return the expressions used to compute the elements of the list
+ */
+ NodeList<Expression> get elements => _elements;
+
+ @override
+ Token get endToken => _rightBracket;
+
+ /**
+ * Return the left square bracket.
+ *
+ * @return the left square bracket
+ */
+ Token get leftBracket => _leftBracket;
+
+ /**
+ * Return the right square bracket.
+ *
+ * @return the right square bracket
+ */
+ Token get rightBracket => _rightBracket;
+
+ /**
+ * Set the left square bracket to the given token.
+ *
+ * @param bracket the left square bracket
+ */
+ void set leftBracket(Token bracket) {
+ _leftBracket = bracket;
+ }
+
+ /**
+ * Set the right square bracket to the given token.
+ *
+ * @param bracket the right square bracket
+ */
+ void set rightBracket(Token bracket) {
+ _rightBracket = bracket;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ _elements.accept(visitor);
+ }
+}
+
+/**
+ * The abstract class `Literal` defines the behavior common to nodes that represent a literal
+ * expression.
+ *
+ * <pre>
+ * literal ::=
+ * [BooleanLiteral]
+ * | [DoubleLiteral]
+ * | [IntegerLiteral]
+ * | [ListLiteral]
+ * | [MapLiteral]
+ * | [NullLiteral]
+ * | [StringLiteral]
+ * </pre>
+ */
+abstract class Literal extends Expression {
+ @override
+ int get precedence => 16;
+}
+
+/**
+ * Instances of the class `MapLiteral` represent a literal map.
+ *
+ * <pre>
+ * mapLiteral ::=
+ * 'const'? ('<' [TypeName] (',' [TypeName])* '>')? '{' ([MapLiteralEntry] (',' [MapLiteralEntry])* ','?)? '}'
+ * </pre>
+ */
+class MapLiteral extends TypedLiteral {
+ /**
+ * The left curly bracket.
+ */
+ Token _leftBracket;
+
+ /**
+ * The entries in the map.
+ */
+ NodeList<MapLiteralEntry> _entries;
+
+ /**
+ * The right curly bracket.
+ */
+ Token _rightBracket;
+
+ /**
+ * Initialize a newly created map literal.
+ *
+ * @param constKeyword the token representing the 'const' keyword
+ * @param typeArguments the type argument associated with this literal, or `null` if no type
+ * arguments were declared
+ * @param leftBracket the left curly bracket
+ * @param entries the entries in the map
+ * @param rightBracket the right curly bracket
+ */
+ MapLiteral(Token constKeyword, TypeArgumentList typeArguments, Token leftBracket, List<MapLiteralEntry> entries, Token rightBracket) : super(constKeyword, typeArguments) {
+ this._entries = new NodeList<MapLiteralEntry>(this);
+ this._leftBracket = leftBracket;
+ this._entries.addAll(entries);
+ this._rightBracket = rightBracket;
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitMapLiteral(this);
+
+ @override
+ Token get beginToken {
+ Token token = constKeyword;
+ if (token != null) {
+ return token;
+ }
+ TypeArgumentList typeArguments = this.typeArguments;
+ if (typeArguments != null) {
+ return typeArguments.beginToken;
+ }
+ return _leftBracket;
+ }
+
+ @override
+ Token get endToken => _rightBracket;
+
+ /**
+ * Return the entries in the map.
+ *
+ * @return the entries in the map
+ */
+ NodeList<MapLiteralEntry> get entries => _entries;
+
+ /**
+ * Return the left curly bracket.
+ *
+ * @return the left curly bracket
+ */
+ Token get leftBracket => _leftBracket;
+
+ /**
+ * Return the right curly bracket.
+ *
+ * @return the right curly bracket
+ */
+ Token get rightBracket => _rightBracket;
+
+ /**
+ * Set the left curly bracket to the given token.
+ *
+ * @param bracket the left curly bracket
+ */
+ void set leftBracket(Token bracket) {
+ _leftBracket = bracket;
+ }
+
+ /**
+ * Set the right curly bracket to the given token.
+ *
+ * @param bracket the right curly bracket
+ */
+ void set rightBracket(Token bracket) {
+ _rightBracket = bracket;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ _entries.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `MapLiteralEntry` represent a single key/value pair in a map
+ * literal.
+ *
+ * <pre>
+ * mapLiteralEntry ::=
+ * [Expression] ':' [Expression]
+ * </pre>
+ */
+class MapLiteralEntry extends AstNode {
+ /**
+ * The expression computing the key with which the value will be associated.
+ */
+ Expression _key;
+
+ /**
+ * The colon that separates the key from the value.
+ */
+ Token separator;
+
+ /**
+ * The expression computing the value that will be associated with the key.
+ */
+ Expression _value;
+
+ /**
+ * Initialize a newly created map literal entry.
+ *
+ * @param key the expression computing the key with which the value will be associated
+ * @param separator the colon that separates the key from the value
+ * @param value the expression computing the value that will be associated with the key
+ */
+ MapLiteralEntry(Expression key, this.separator, Expression value) {
+ this._key = becomeParentOf(key);
+ this._value = becomeParentOf(value);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitMapLiteralEntry(this);
+
+ @override
+ Token get beginToken => _key.beginToken;
+
+ @override
+ Token get endToken => _value.endToken;
+
+ /**
+ * Return the expression computing the key with which the value will be associated.
+ *
+ * @return the expression computing the key with which the value will be associated
+ */
+ Expression get key => _key;
+
+ /**
+ * Return the expression computing the value that will be associated with the key.
+ *
+ * @return the expression computing the value that will be associated with the key
+ */
+ Expression get value => _value;
+
+ /**
+ * Set the expression computing the key with which the value will be associated to the given
+ * string.
+ *
+ * @param string the expression computing the key with which the value will be associated
+ */
+ void set key(Expression string) {
+ _key = becomeParentOf(string);
+ }
+
+ /**
+ * Set the expression computing the value that will be associated with the key to the given
+ * expression.
+ *
+ * @param expression the expression computing the value that will be associated with the key
+ */
+ void set value(Expression expression) {
+ _value = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_key, visitor);
+ safelyVisitChild(_value, visitor);
+ }
+}
+
+/**
+ * Instances of the class `MethodDeclaration` represent a method declaration.
+ *
+ * <pre>
+ * methodDeclaration ::=
+ * methodSignature [FunctionBody]
+ *
+ * methodSignature ::=
+ * 'external'? ('abstract' | 'static')? [Type]? ('get' | 'set')? methodName
+ * [FormalParameterList]
+ *
+ * methodName ::=
+ * [SimpleIdentifier]
+ * | 'operator' [SimpleIdentifier]
+ * </pre>
+ */
+class MethodDeclaration extends ClassMember {
+ /**
+ * The token for the 'external' keyword, or `null` if the constructor is not external.
+ */
+ Token externalKeyword;
+
+ /**
+ * The token representing the 'abstract' or 'static' keyword, or `null` if neither modifier
+ * was specified.
+ */
+ Token modifierKeyword;
+
+ /**
+ * The return type of the method, or `null` if no return type was declared.
+ */
+ TypeName _returnType;
+
+ /**
+ * The token representing the 'get' or 'set' keyword, or `null` if this is a method
+ * declaration rather than a property declaration.
+ */
+ Token propertyKeyword;
+
+ /**
+ * The token representing the 'operator' keyword, or `null` if this method does not declare
+ * an operator.
+ */
+ Token operatorKeyword;
+
+ /**
+ * The name of the method.
+ */
+ SimpleIdentifier _name;
+
+ /**
+ * The parameters associated with the method, or `null` if this method declares a getter.
+ */
+ FormalParameterList _parameters;
+
+ /**
+ * The body of the method.
+ */
+ FunctionBody _body;
+
+ /**
+ * Initialize a newly created method declaration.
+ *
+ * @param externalKeyword the token for the 'external' keyword
+ * @param comment the documentation comment associated with this method
+ * @param metadata the annotations associated with this method
+ * @param modifierKeyword the token representing the 'abstract' or 'static' keyword
+ * @param returnType the return type of the method
+ * @param propertyKeyword the token representing the 'get' or 'set' keyword
+ * @param operatorKeyword the token representing the 'operator' keyword
+ * @param name the name of the method
+ * @param parameters the parameters associated with the method, or `null` if this method
+ * declares a getter
+ * @param body the body of the method
+ */
+ MethodDeclaration(Comment comment, List<Annotation> metadata, this.externalKeyword, this.modifierKeyword, TypeName returnType, this.propertyKeyword, this.operatorKeyword, SimpleIdentifier name, FormalParameterList parameters, FunctionBody body) : super(comment, metadata) {
+ this._returnType = becomeParentOf(returnType);
+ this._name = becomeParentOf(name);
+ this._parameters = becomeParentOf(parameters);
+ this._body = becomeParentOf(body);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitMethodDeclaration(this);
+
+ /**
+ * Return the body of the method.
+ *
+ * @return the body of the method
+ */
+ FunctionBody get body => _body;
+
+ /**
+ * Return the element associated with this method, or `null` if the AST structure has not
+ * been resolved. The element can either be a [MethodElement], if this represents the
+ * declaration of a normal method, or a [PropertyAccessorElement] if this represents the
+ * declaration of either a getter or a setter.
+ *
+ * @return the element associated with this method
+ */
+ @override
+ ExecutableElement get element => _name != null ? (_name.staticElement as ExecutableElement) : null;
+
+ @override
+ Token get endToken => _body.endToken;
+
+ /**
+ * Return the name of the method.
+ *
+ * @return the name of the method
+ */
+ SimpleIdentifier get name => _name;
+
+ /**
+ * Return the parameters associated with the method, or `null` if this method declares a
+ * getter.
+ *
+ * @return the parameters associated with the method
+ */
+ FormalParameterList get parameters => _parameters;
+
+ /**
+ * Return the return type of the method, or `null` if no return type was declared.
+ *
+ * @return the return type of the method
+ */
+ TypeName get returnType => _returnType;
+
+ /**
+ * Return `true` if this method is declared to be an abstract method.
+ *
+ * @return `true` if this method is declared to be an abstract method
+ */
+ bool get isAbstract => externalKeyword == null && (_body is EmptyFunctionBody);
+
+ /**
+ * Return `true` if this method declares a getter.
+ *
+ * @return `true` if this method declares a getter
+ */
+ bool get isGetter => propertyKeyword != null && (propertyKeyword as KeywordToken).keyword == Keyword.GET;
+
+ /**
+ * Return `true` if this method declares an operator.
+ *
+ * @return `true` if this method declares an operator
+ */
+ bool get isOperator => operatorKeyword != null;
+
+ /**
+ * Return `true` if this method declares a setter.
+ *
+ * @return `true` if this method declares a setter
+ */
+ bool get isSetter => propertyKeyword != null && (propertyKeyword as KeywordToken).keyword == Keyword.SET;
+
+ /**
+ * Return `true` if this method is declared to be a static method.
+ *
+ * @return `true` if this method is declared to be a static method
+ */
+ bool get isStatic => modifierKeyword != null && (modifierKeyword as KeywordToken).keyword == Keyword.STATIC;
+
+ /**
+ * Set the body of the method to the given function body.
+ *
+ * @param functionBody the body of the method
+ */
+ void set body(FunctionBody functionBody) {
+ _body = becomeParentOf(functionBody);
+ }
+
+ /**
+ * Set the name of the method to the given identifier.
+ *
+ * @param identifier the name of the method
+ */
+ void set name(SimpleIdentifier identifier) {
+ _name = becomeParentOf(identifier);
+ }
+
+ /**
+ * Set the parameters associated with the method to the given list of parameters.
+ *
+ * @param parameters the parameters associated with the method
+ */
+ void set parameters(FormalParameterList parameters) {
+ this._parameters = becomeParentOf(parameters);
+ }
+
+ /**
+ * Set the return type of the method to the given type name.
+ *
+ * @param typeName the return type of the method
+ */
+ void set returnType(TypeName typeName) {
+ _returnType = becomeParentOf(typeName);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_returnType, visitor);
+ safelyVisitChild(_name, visitor);
+ safelyVisitChild(_parameters, visitor);
+ safelyVisitChild(_body, visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata {
+ if (modifierKeyword != null) {
+ return modifierKeyword;
+ } else if (_returnType != null) {
+ return _returnType.beginToken;
+ } else if (propertyKeyword != null) {
+ return propertyKeyword;
+ } else if (operatorKeyword != null) {
+ return operatorKeyword;
+ }
+ return _name.beginToken;
+ }
+}
+
+/**
+ * Instances of the class `MethodInvocation` represent the invocation of either a function or
+ * a method. Invocations of functions resulting from evaluating an expression are represented by
+ * [FunctionExpressionInvocation] nodes. Invocations of getters
+ * and setters are represented by either [PrefixedIdentifier] or
+ * [PropertyAccess] nodes.
+ *
+ * <pre>
+ * methodInvoction ::=
+ * ([Expression] '.')? [SimpleIdentifier] [ArgumentList]
+ * </pre>
+ */
+class MethodInvocation extends Expression {
+ /**
+ * The expression producing the object on which the method is defined, or `null` if there is
+ * no target (that is, the target is implicitly `this`).
+ */
+ Expression _target;
+
+ /**
+ * The period that separates the target from the method name, or `null` if there is no
+ * target.
+ */
+ Token period;
+
+ /**
+ * The name of the method being invoked.
+ */
+ SimpleIdentifier _methodName;
+
+ /**
+ * The list of arguments to the method.
+ */
+ ArgumentList _argumentList;
+
+ /**
+ * Initialize a newly created method invocation.
+ *
+ * @param target the expression producing the object on which the method is defined
+ * @param period the period that separates the target from the method name
+ * @param methodName the name of the method being invoked
+ * @param argumentList the list of arguments to the method
+ */
+ MethodInvocation(Expression target, this.period, SimpleIdentifier methodName, ArgumentList argumentList) {
+ this._target = becomeParentOf(target);
+ this._methodName = becomeParentOf(methodName);
+ this._argumentList = becomeParentOf(argumentList);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitMethodInvocation(this);
+
+ /**
+ * Return the list of arguments to the method.
+ *
+ * @return the list of arguments to the method
+ */
+ ArgumentList get argumentList => _argumentList;
+
+ @override
+ Token get beginToken {
+ if (_target != null) {
+ return _target.beginToken;
+ } else if (period != null) {
+ return period;
+ }
+ return _methodName.beginToken;
+ }
+
+ @override
+ Token get endToken => _argumentList.endToken;
+
+ /**
+ * Return the name of the method being invoked.
+ *
+ * @return the name of the method being invoked
+ */
+ SimpleIdentifier get methodName => _methodName;
+
+ @override
+ int get precedence => 15;
+
+ /**
+ * Return the expression used to compute the receiver of the invocation. If this invocation is not
+ * part of a cascade expression, then this is the same as [getTarget]. If this invocation
+ * is part of a cascade expression, then the target stored with the cascade expression is
+ * returned.
+ *
+ * @return the expression used to compute the receiver of the invocation
+ * @see #getTarget()
+ */
+ Expression get realTarget {
+ if (isCascaded) {
+ AstNode ancestor = parent;
+ while (ancestor is! CascadeExpression) {
+ if (ancestor == null) {
+ return _target;
+ }
+ ancestor = ancestor.parent;
+ }
+ return (ancestor as CascadeExpression).target;
+ }
+ return _target;
+ }
+
+ /**
+ * Return the expression producing the object on which the method is defined, or `null` if
+ * there is no target (that is, the target is implicitly `this`) or if this method
+ * invocation is part of a cascade expression.
+ *
+ * @return the expression producing the object on which the method is defined
+ * @see #getRealTarget()
+ */
+ Expression get target => _target;
+
+ /**
+ * Return `true` if this expression is cascaded. If it is, then the target of this
+ * expression is not stored locally but is stored in the nearest ancestor that is a
+ * [CascadeExpression].
+ *
+ * @return `true` if this expression is cascaded
+ */
+ bool get isCascaded => period != null && period.type == TokenType.PERIOD_PERIOD;
+
+ /**
+ * Set the list of arguments to the method to the given list.
+ *
+ * @param argumentList the list of arguments to the method
+ */
+ void set argumentList(ArgumentList argumentList) {
+ this._argumentList = becomeParentOf(argumentList);
+ }
+
+ /**
+ * Set the name of the method being invoked to the given identifier.
+ *
+ * @param identifier the name of the method being invoked
+ */
+ void set methodName(SimpleIdentifier identifier) {
+ _methodName = becomeParentOf(identifier);
+ }
+
+ /**
+ * Set the expression producing the object on which the method is defined to the given expression.
+ *
+ * @param expression the expression producing the object on which the method is defined
+ */
+ void set target(Expression expression) {
+ _target = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_target, visitor);
+ safelyVisitChild(_methodName, visitor);
+ safelyVisitChild(_argumentList, visitor);
+ }
+}
+
+/**
+ * Instances of the class `NamedExpression` represent an expression that has a name associated
+ * with it. They are used in method invocations when there are named parameters.
+ *
+ * <pre>
+ * namedExpression ::=
+ * [Label] [Expression]
+ * </pre>
+ */
+class NamedExpression extends Expression {
+ /**
+ * The name associated with the expression.
+ */
+ Label _name;
+
+ /**
+ * The expression with which the name is associated.
+ */
+ Expression _expression;
+
+ /**
+ * Initialize a newly created named expression.
+ *
+ * @param name the name associated with the expression
+ * @param expression the expression with which the name is associated
+ */
+ NamedExpression(Label name, Expression expression) {
+ this._name = becomeParentOf(name);
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitNamedExpression(this);
+
+ @override
+ Token get beginToken => _name.beginToken;
+
+ /**
+ * Return the element representing the parameter being named by this expression, or `null`
+ * if the AST structure has not been resolved or if there is no parameter with the same name as
+ * this expression.
+ *
+ * @return the element representing the parameter being named by this expression
+ */
+ ParameterElement get element {
+ Element element = _name.label.staticElement;
+ if (element is ParameterElement) {
+ return element;
+ }
+ return null;
+ }
+
+ @override
+ Token get endToken => _expression.endToken;
+
+ /**
+ * Return the expression with which the name is associated.
+ *
+ * @return the expression with which the name is associated
+ */
+ Expression get expression => _expression;
+
+ /**
+ * Return the name associated with the expression.
+ *
+ * @return the name associated with the expression
+ */
+ Label get name => _name;
+
+ @override
+ int get precedence => 0;
+
+ /**
+ * Set the expression with which the name is associated to the given expression.
+ *
+ * @param expression the expression with which the name is associated
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the name associated with the expression to the given identifier.
+ *
+ * @param identifier the name associated with the expression
+ */
+ void set name(Label identifier) {
+ _name = becomeParentOf(identifier);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_name, visitor);
+ safelyVisitChild(_expression, visitor);
+ }
+}
+
+/**
+ * The abstract class `NamespaceDirective` defines the behavior common to nodes that represent
+ * a directive that impacts the namespace of a library.
+ *
+ * <pre>
+ * directive ::=
+ * [ExportDirective]
+ * | [ImportDirective]
+ * </pre>
+ */
+abstract class NamespaceDirective extends UriBasedDirective {
+ /**
+ * The token representing the 'import' or 'export' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The combinators used to control which names are imported or exported.
+ */
+ NodeList<Combinator> _combinators;
+
+ /**
+ * The semicolon terminating the directive.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created namespace directive.
+ *
+ * @param comment the documentation comment associated with this directive
+ * @param metadata the annotations associated with the directive
+ * @param keyword the token representing the 'import' or 'export' keyword
+ * @param libraryUri the URI of the library being imported or exported
+ * @param combinators the combinators used to control which names are imported or exported
+ * @param semicolon the semicolon terminating the directive
+ */
+ NamespaceDirective(Comment comment, List<Annotation> metadata, this.keyword, StringLiteral libraryUri, List<Combinator> combinators, this.semicolon) : super(comment, metadata, libraryUri) {
+ this._combinators = new NodeList<Combinator>(this);
+ this._combinators.addAll(combinators);
+ }
+
+ /**
+ * Return the combinators used to control how names are imported or exported.
+ *
+ * @return the combinators used to control how names are imported or exported
+ */
+ NodeList<Combinator> get combinators => _combinators;
+
+ @override
+ Token get endToken => semicolon;
+
+ @override
+ LibraryElement get uriElement;
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata => keyword;
+}
+
+/**
+ * Instances of the class `NativeClause` represent the "native" clause in an class
+ * declaration.
+ *
+ * <pre>
+ * nativeClause ::=
+ * 'native' [StringLiteral]
+ * </pre>
+ */
+class NativeClause extends AstNode {
+ /**
+ * The token representing the 'native' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The name of the native object that implements the class.
+ */
+ StringLiteral _name;
+
+ /**
+ * Initialize a newly created native clause.
+ *
+ * @param keyword the token representing the 'native' keyword
+ * @param name the name of the native object that implements the class.
+ */
+ NativeClause(this.keyword, StringLiteral name) {
+ this._name = becomeParentOf(name);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitNativeClause(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ @override
+ Token get endToken => _name.endToken;
+
+ /**
+ * Return the name of the native object that implements the class.
+ *
+ * @return the name of the native object that implements the class
+ */
+ StringLiteral get name => _name;
+
+ /**
+ * Sets the name of the native object that implements the class.
+ *
+ * @param name the name of the native object that implements the class.
+ */
+ void set name(StringLiteral name) {
+ this._name = becomeParentOf(name);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_name, visitor);
+ }
+}
+
+/**
+ * Instances of the class `NativeFunctionBody` represent a function body that consists of a
+ * native keyword followed by a string literal.
+ *
+ * <pre>
+ * nativeFunctionBody ::=
+ * 'native' [SimpleStringLiteral] ';'
+ * </pre>
+ */
+class NativeFunctionBody extends FunctionBody {
+ /**
+ * The token representing 'native' that marks the start of the function body.
+ */
+ final Token nativeToken;
+
+ /**
+ * The string literal, after the 'native' token.
+ */
+ StringLiteral _stringLiteral;
+
+ /**
+ * The token representing the semicolon that marks the end of the function body.
+ */
+ final Token semicolon;
+
+ /**
+ * Initialize a newly created function body consisting of the 'native' token, a string literal,
+ * and a semicolon.
+ *
+ * @param nativeToken the token representing 'native' that marks the start of the function body
+ * @param stringLiteral the string literal
+ * @param semicolon the token representing the semicolon that marks the end of the function body
+ */
+ NativeFunctionBody(this.nativeToken, StringLiteral stringLiteral, this.semicolon) {
+ this._stringLiteral = becomeParentOf(stringLiteral);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitNativeFunctionBody(this);
+
+ @override
+ Token get beginToken => nativeToken;
+
+ @override
+ Token get endToken => semicolon;
+
+ /**
+ * Return the string literal representing the string after the 'native' token.
+ *
+ * @return the string literal representing the string after the 'native' token
+ */
+ StringLiteral get stringLiteral => _stringLiteral;
+
+ /**
+ * Set the string literal representing the string after the 'native' token to the given string.
+ *
+ * @param stringLiteral the string literal representing the string after the 'native' token
+ */
+ void set stringLiteral(StringLiteral stringLiteral) {
+ this._stringLiteral = becomeParentOf(stringLiteral);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_stringLiteral, visitor);
+ }
+}
+
+/**
+ * Instances of the class `NodeLocator` locate the [AstNode] associated with a
+ * source range, given the AST structure built from the source. More specifically, they will return
+ * the [AstNode] with the shortest length whose source range completely encompasses
+ * the specified range.
+ */
+class NodeLocator extends UnifyingAstVisitor<Object> {
+ /**
+ * The start offset of the range used to identify the node.
+ */
+ int _startOffset = 0;
+
+ /**
+ * The end offset of the range used to identify the node.
+ */
+ int _endOffset = 0;
+
+ /**
+ * The element that was found that corresponds to the given source range, or `null` if there
+ * is no such element.
+ */
+ AstNode _foundNode;
+
+ /**
+ * Initialize a newly created locator to locate one or more [AstNode] by locating
+ * the node within an AST structure that corresponds to the given offset in the source.
+ *
+ * @param offset the offset used to identify the node
+ */
+ NodeLocator.con1(int offset) : this.con2(offset, offset);
+
+ /**
+ * Initialize a newly created locator to locate one or more [AstNode] by locating
+ * the node within an AST structure that corresponds to the given range of characters in the
+ * source.
+ *
+ * @param start the start offset of the range used to identify the node
+ * @param end the end offset of the range used to identify the node
+ */
+ NodeLocator.con2(int start, int end) {
+ this._startOffset = start;
+ this._endOffset = end;
+ }
+
+ /**
+ * Return the node that was found that corresponds to the given source range, or `null` if
+ * there is no such node.
+ *
+ * @return the node that was found
+ */
+ AstNode get foundNode => _foundNode;
+
+ /**
+ * Search within the given AST node for an identifier representing a [DartElement] in the specified source range. Return the element that was found, or `null` if
+ * no element was found.
+ *
+ * @param node the AST node within which to search
+ * @return the element that was found
+ */
+ AstNode searchWithin(AstNode node) {
+ if (node == null) {
+ return null;
+ }
+ try {
+ node.accept(this);
+ } on NodeLocator_NodeFoundException catch (exception) {
+ } catch (exception) {
+ AnalysisEngine.instance.logger.logInformation2("Unable to locate element at offset (${_startOffset} - ${_endOffset})", exception);
+ return null;
+ }
+ return _foundNode;
+ }
+
+ @override
+ Object visitNode(AstNode node) {
+ int start = node.offset;
+ int end = start + node.length;
+ if (end < _startOffset) {
+ return null;
+ }
+ if (start > _endOffset) {
+ return null;
+ }
+ try {
+ node.visitChildren(this);
+ } on NodeLocator_NodeFoundException catch (exception) {
+ throw exception;
+ } catch (exception) {
+ // Ignore the exception and proceed in order to visit the rest of the structure.
+ AnalysisEngine.instance.logger.logInformation2("Exception caught while traversing an AST structure.", exception);
+ }
+ if (start <= _startOffset && _endOffset <= end) {
+ _foundNode = node;
+ throw new NodeLocator_NodeFoundException();
+ }
+ return null;
+ }
+}
+
+/**
+ * Instances of the class `NodeFoundException` are used to cancel visiting after a node has
+ * been found.
+ */
+class NodeLocator_NodeFoundException extends RuntimeException {
+ static int _serialVersionUID = 1;
+}
+
+/**
+ * Instances of the class `NodeReplacer` implement an object that will replace one child node
+ * in an AST node with another node.
+ */
+class NodeReplacer implements AstVisitor<bool> {
+ /**
+ * Replace the old node with the new node in the AST structure containing the old node.
+ *
+ * @param oldNode
+ * @param newNode
+ * @return `true` if the replacement was successful
+ * @throws IllegalArgumentException if either node is `null`, if the old node does not have
+ * a parent node, or if the AST structure has been corrupted
+ */
+ static bool replace(AstNode oldNode, AstNode newNode) {
+ if (oldNode == null || newNode == null) {
+ throw new IllegalArgumentException("The old and new nodes must be non-null");
+ } else if (identical(oldNode, newNode)) {
+ return true;
+ }
+ AstNode parent = oldNode.parent;
+ if (parent == null) {
+ throw new IllegalArgumentException("The old node is not a child of another node");
+ }
+ NodeReplacer replacer = new NodeReplacer(oldNode, newNode);
+ return parent.accept(replacer);
+ }
+
+ final AstNode _oldNode;
+
+ final AstNode _newNode;
+
+ NodeReplacer(this._oldNode, this._newNode);
+
+ @override
+ bool visitAdjacentStrings(AdjacentStrings node) {
+ if (_replaceInList(node.strings)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ bool visitAnnotatedNode(AnnotatedNode node) {
+ if (identical(node.documentationComment, _oldNode)) {
+ node.documentationComment = _newNode as Comment;
+ return true;
+ } else if (_replaceInList(node.metadata)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitAnnotation(Annotation node) {
+ if (identical(node.arguments, _oldNode)) {
+ node.arguments = _newNode as ArgumentList;
+ return true;
+ } else if (identical(node.constructorName, _oldNode)) {
+ node.constructorName = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.name, _oldNode)) {
+ node.name = _newNode as Identifier;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitArgumentList(ArgumentList node) {
+ if (_replaceInList(node.arguments)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitAsExpression(AsExpression node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ } else if (identical(node.type, _oldNode)) {
+ node.type = _newNode as TypeName;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitAssertStatement(AssertStatement node) {
+ if (identical(node.condition, _oldNode)) {
+ node.condition = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitAssignmentExpression(AssignmentExpression node) {
+ if (identical(node.leftHandSide, _oldNode)) {
+ node.leftHandSide = _newNode as Expression;
+ return true;
+ } else if (identical(node.rightHandSide, _oldNode)) {
+ node.rightHandSide = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitAwaitExpression(AwaitExpression node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitBinaryExpression(BinaryExpression node) {
+ if (identical(node.leftOperand, _oldNode)) {
+ node.leftOperand = _newNode as Expression;
+ return true;
+ } else if (identical(node.rightOperand, _oldNode)) {
+ node.rightOperand = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitBlock(Block node) {
+ if (_replaceInList(node.statements)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitBlockFunctionBody(BlockFunctionBody node) {
+ if (identical(node.block, _oldNode)) {
+ node.block = _newNode as Block;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitBooleanLiteral(BooleanLiteral node) => visitNode(node);
+
+ @override
+ bool visitBreakStatement(BreakStatement node) {
+ if (identical(node.label, _oldNode)) {
+ node.label = _newNode as SimpleIdentifier;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitCascadeExpression(CascadeExpression node) {
+ if (identical(node.target, _oldNode)) {
+ node.target = _newNode as Expression;
+ return true;
+ } else if (_replaceInList(node.cascadeSections)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitCatchClause(CatchClause node) {
+ if (identical(node.exceptionType, _oldNode)) {
+ node.exceptionType = _newNode as TypeName;
+ return true;
+ } else if (identical(node.exceptionParameter, _oldNode)) {
+ node.exceptionParameter = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.stackTraceParameter, _oldNode)) {
+ node.stackTraceParameter = _newNode as SimpleIdentifier;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitClassDeclaration(ClassDeclaration node) {
+ if (identical(node.name, _oldNode)) {
+ node.name = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.typeParameters, _oldNode)) {
+ node.typeParameters = _newNode as TypeParameterList;
+ return true;
+ } else if (identical(node.extendsClause, _oldNode)) {
+ node.extendsClause = _newNode as ExtendsClause;
+ return true;
+ } else if (identical(node.withClause, _oldNode)) {
+ node.withClause = _newNode as WithClause;
+ return true;
+ } else if (identical(node.implementsClause, _oldNode)) {
+ node.implementsClause = _newNode as ImplementsClause;
+ return true;
+ } else if (identical(node.nativeClause, _oldNode)) {
+ node.nativeClause = _newNode as NativeClause;
+ return true;
+ } else if (_replaceInList(node.members)) {
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitClassTypeAlias(ClassTypeAlias node) {
+ if (identical(node.name, _oldNode)) {
+ node.name = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.typeParameters, _oldNode)) {
+ node.typeParameters = _newNode as TypeParameterList;
+ return true;
+ } else if (identical(node.superclass, _oldNode)) {
+ node.superclass = _newNode as TypeName;
+ return true;
+ } else if (identical(node.withClause, _oldNode)) {
+ node.withClause = _newNode as WithClause;
+ return true;
+ } else if (identical(node.implementsClause, _oldNode)) {
+ node.implementsClause = _newNode as ImplementsClause;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitComment(Comment node) {
+ if (_replaceInList(node.references)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitCommentReference(CommentReference node) {
+ if (identical(node.identifier, _oldNode)) {
+ node.identifier = _newNode as Identifier;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitCompilationUnit(CompilationUnit node) {
+ if (identical(node.scriptTag, _oldNode)) {
+ node.scriptTag = _newNode as ScriptTag;
+ return true;
+ } else if (_replaceInList(node.directives)) {
+ return true;
+ } else if (_replaceInList(node.declarations)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitConditionalExpression(ConditionalExpression node) {
+ if (identical(node.condition, _oldNode)) {
+ node.condition = _newNode as Expression;
+ return true;
+ } else if (identical(node.thenExpression, _oldNode)) {
+ node.thenExpression = _newNode as Expression;
+ return true;
+ } else if (identical(node.elseExpression, _oldNode)) {
+ node.elseExpression = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitConstructorDeclaration(ConstructorDeclaration node) {
+ if (identical(node.returnType, _oldNode)) {
+ node.returnType = _newNode as Identifier;
+ return true;
+ } else if (identical(node.name, _oldNode)) {
+ node.name = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.parameters, _oldNode)) {
+ node.parameters = _newNode as FormalParameterList;
+ return true;
+ } else if (identical(node.redirectedConstructor, _oldNode)) {
+ node.redirectedConstructor = _newNode as ConstructorName;
+ return true;
+ } else if (identical(node.body, _oldNode)) {
+ node.body = _newNode as FunctionBody;
+ return true;
+ } else if (_replaceInList(node.initializers)) {
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitConstructorFieldInitializer(ConstructorFieldInitializer node) {
+ if (identical(node.fieldName, _oldNode)) {
+ node.fieldName = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitConstructorName(ConstructorName node) {
+ if (identical(node.type, _oldNode)) {
+ node.type = _newNode as TypeName;
+ return true;
+ } else if (identical(node.name, _oldNode)) {
+ node.name = _newNode as SimpleIdentifier;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitContinueStatement(ContinueStatement node) {
+ if (identical(node.label, _oldNode)) {
+ node.label = _newNode as SimpleIdentifier;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitDeclaredIdentifier(DeclaredIdentifier node) {
+ if (identical(node.type, _oldNode)) {
+ node.type = _newNode as TypeName;
+ return true;
+ } else if (identical(node.identifier, _oldNode)) {
+ node.identifier = _newNode as SimpleIdentifier;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitDefaultFormalParameter(DefaultFormalParameter node) {
+ if (identical(node.parameter, _oldNode)) {
+ node.parameter = _newNode as NormalFormalParameter;
+ return true;
+ } else if (identical(node.defaultValue, _oldNode)) {
+ node.defaultValue = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitDoStatement(DoStatement node) {
+ if (identical(node.body, _oldNode)) {
+ node.body = _newNode as Statement;
+ return true;
+ } else if (identical(node.condition, _oldNode)) {
+ node.condition = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitDoubleLiteral(DoubleLiteral node) => visitNode(node);
+
+ @override
+ bool visitEmptyFunctionBody(EmptyFunctionBody node) => visitNode(node);
+
+ @override
+ bool visitEmptyStatement(EmptyStatement node) => visitNode(node);
+
+ @override
+ bool visitEnumConstantDeclaration(EnumConstantDeclaration node) {
+ if (identical(node.name, _oldNode)) {
+ node.name = _newNode as SimpleIdentifier;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitEnumDeclaration(EnumDeclaration node) {
+ if (identical(node.name, _oldNode)) {
+ node.name = _newNode as SimpleIdentifier;
+ return true;
+ } else if (_replaceInList(node.constants)) {
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitExportDirective(ExportDirective node) => visitNamespaceDirective(node);
+
+ @override
+ bool visitExpressionFunctionBody(ExpressionFunctionBody node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitExpressionStatement(ExpressionStatement node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitExtendsClause(ExtendsClause node) {
+ if (identical(node.superclass, _oldNode)) {
+ node.superclass = _newNode as TypeName;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitFieldDeclaration(FieldDeclaration node) {
+ if (identical(node.fields, _oldNode)) {
+ node.fields = _newNode as VariableDeclarationList;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitFieldFormalParameter(FieldFormalParameter node) {
+ if (identical(node.type, _oldNode)) {
+ node.type = _newNode as TypeName;
+ return true;
+ } else if (identical(node.parameters, _oldNode)) {
+ node.parameters = _newNode as FormalParameterList;
+ return true;
+ }
+ return visitNormalFormalParameter(node);
+ }
+
+ @override
+ bool visitForEachStatement(ForEachStatement node) {
+ if (identical(node.loopVariable, _oldNode)) {
+ node.loopVariable = _newNode as DeclaredIdentifier;
+ return true;
+ } else if (identical(node.identifier, _oldNode)) {
+ node.identifier = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.iterator, _oldNode)) {
+ node.iterator = _newNode as Expression;
+ return true;
+ } else if (identical(node.body, _oldNode)) {
+ node.body = _newNode as Statement;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitFormalParameterList(FormalParameterList node) {
+ if (_replaceInList(node.parameters)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitForStatement(ForStatement node) {
+ if (identical(node.variables, _oldNode)) {
+ node.variables = _newNode as VariableDeclarationList;
+ return true;
+ } else if (identical(node.initialization, _oldNode)) {
+ node.initialization = _newNode as Expression;
+ return true;
+ } else if (identical(node.condition, _oldNode)) {
+ node.condition = _newNode as Expression;
+ return true;
+ } else if (identical(node.body, _oldNode)) {
+ node.body = _newNode as Statement;
+ return true;
+ } else if (_replaceInList(node.updaters)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitFunctionDeclaration(FunctionDeclaration node) {
+ if (identical(node.returnType, _oldNode)) {
+ node.returnType = _newNode as TypeName;
+ return true;
+ } else if (identical(node.name, _oldNode)) {
+ node.name = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.functionExpression, _oldNode)) {
+ node.functionExpression = _newNode as FunctionExpression;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitFunctionDeclarationStatement(FunctionDeclarationStatement node) {
+ if (identical(node.functionDeclaration, _oldNode)) {
+ node.functionDeclaration = _newNode as FunctionDeclaration;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitFunctionExpression(FunctionExpression node) {
+ if (identical(node.parameters, _oldNode)) {
+ node.parameters = _newNode as FormalParameterList;
+ return true;
+ } else if (identical(node.body, _oldNode)) {
+ node.body = _newNode as FunctionBody;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitFunctionExpressionInvocation(FunctionExpressionInvocation node) {
+ if (identical(node.function, _oldNode)) {
+ node.function = _newNode as Expression;
+ return true;
+ } else if (identical(node.argumentList, _oldNode)) {
+ node.argumentList = _newNode as ArgumentList;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitFunctionTypeAlias(FunctionTypeAlias node) {
+ if (identical(node.returnType, _oldNode)) {
+ node.returnType = _newNode as TypeName;
+ return true;
+ } else if (identical(node.name, _oldNode)) {
+ node.name = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.typeParameters, _oldNode)) {
+ node.typeParameters = _newNode as TypeParameterList;
+ return true;
+ } else if (identical(node.parameters, _oldNode)) {
+ node.parameters = _newNode as FormalParameterList;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitFunctionTypedFormalParameter(FunctionTypedFormalParameter node) {
+ if (identical(node.returnType, _oldNode)) {
+ node.returnType = _newNode as TypeName;
+ return true;
+ } else if (identical(node.parameters, _oldNode)) {
+ node.parameters = _newNode as FormalParameterList;
+ return true;
+ }
+ return visitNormalFormalParameter(node);
+ }
+
+ @override
+ bool visitHideCombinator(HideCombinator node) {
+ if (_replaceInList(node.hiddenNames)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitIfStatement(IfStatement node) {
+ if (identical(node.condition, _oldNode)) {
+ node.condition = _newNode as Expression;
+ return true;
+ } else if (identical(node.thenStatement, _oldNode)) {
+ node.thenStatement = _newNode as Statement;
+ return true;
+ } else if (identical(node.elseStatement, _oldNode)) {
+ node.elseStatement = _newNode as Statement;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitImplementsClause(ImplementsClause node) {
+ if (_replaceInList(node.interfaces)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitImportDirective(ImportDirective node) {
+ if (identical(node.prefix, _oldNode)) {
+ node.prefix = _newNode as SimpleIdentifier;
+ return true;
+ }
+ return visitNamespaceDirective(node);
+ }
+
+ @override
+ bool visitIndexExpression(IndexExpression node) {
+ if (identical(node.target, _oldNode)) {
+ node.target = _newNode as Expression;
+ return true;
+ } else if (identical(node.index, _oldNode)) {
+ node.index = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitInstanceCreationExpression(InstanceCreationExpression node) {
+ if (identical(node.constructorName, _oldNode)) {
+ node.constructorName = _newNode as ConstructorName;
+ return true;
+ } else if (identical(node.argumentList, _oldNode)) {
+ node.argumentList = _newNode as ArgumentList;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitIntegerLiteral(IntegerLiteral node) => visitNode(node);
+
+ @override
+ bool visitInterpolationExpression(InterpolationExpression node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitInterpolationString(InterpolationString node) => visitNode(node);
+
+ @override
+ bool visitIsExpression(IsExpression node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ } else if (identical(node.type, _oldNode)) {
+ node.type = _newNode as TypeName;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitLabel(Label node) {
+ if (identical(node.label, _oldNode)) {
+ node.label = _newNode as SimpleIdentifier;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitLabeledStatement(LabeledStatement node) {
+ if (identical(node.statement, _oldNode)) {
+ node.statement = _newNode as Statement;
+ return true;
+ } else if (_replaceInList(node.labels)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitLibraryDirective(LibraryDirective node) {
+ if (identical(node.name, _oldNode)) {
+ node.name = _newNode as LibraryIdentifier;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitLibraryIdentifier(LibraryIdentifier node) {
+ if (_replaceInList(node.components)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitListLiteral(ListLiteral node) {
+ if (_replaceInList(node.elements)) {
+ return true;
+ }
+ return visitTypedLiteral(node);
+ }
+
+ @override
+ bool visitMapLiteral(MapLiteral node) {
+ if (_replaceInList(node.entries)) {
+ return true;
+ }
+ return visitTypedLiteral(node);
+ }
+
+ @override
+ bool visitMapLiteralEntry(MapLiteralEntry node) {
+ if (identical(node.key, _oldNode)) {
+ node.key = _newNode as Expression;
+ return true;
+ } else if (identical(node.value, _oldNode)) {
+ node.value = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitMethodDeclaration(MethodDeclaration node) {
+ if (identical(node.returnType, _oldNode)) {
+ node.returnType = _newNode as TypeName;
+ return true;
+ } else if (identical(node.name, _oldNode)) {
+ node.name = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.parameters, _oldNode)) {
+ node.parameters = _newNode as FormalParameterList;
+ return true;
+ } else if (identical(node.body, _oldNode)) {
+ node.body = _newNode as FunctionBody;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitMethodInvocation(MethodInvocation node) {
+ if (identical(node.target, _oldNode)) {
+ node.target = _newNode as Expression;
+ return true;
+ } else if (identical(node.methodName, _oldNode)) {
+ node.methodName = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.argumentList, _oldNode)) {
+ node.argumentList = _newNode as ArgumentList;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitNamedExpression(NamedExpression node) {
+ if (identical(node.name, _oldNode)) {
+ node.name = _newNode as Label;
+ return true;
+ } else if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ bool visitNamespaceDirective(NamespaceDirective node) {
+ if (_replaceInList(node.combinators)) {
+ return true;
+ }
+ return visitUriBasedDirective(node);
+ }
+
+ @override
+ bool visitNativeClause(NativeClause node) {
+ if (identical(node.name, _oldNode)) {
+ node.name = _newNode as StringLiteral;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitNativeFunctionBody(NativeFunctionBody node) {
+ if (identical(node.stringLiteral, _oldNode)) {
+ node.stringLiteral = _newNode as StringLiteral;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ bool visitNode(AstNode node) {
+ throw new IllegalArgumentException("The old node is not a child of it's parent");
+ }
+
+ bool visitNormalFormalParameter(NormalFormalParameter node) {
+ if (identical(node.documentationComment, _oldNode)) {
+ node.documentationComment = _newNode as Comment;
+ return true;
+ } else if (identical(node.identifier, _oldNode)) {
+ node.identifier = _newNode as SimpleIdentifier;
+ return true;
+ } else if (_replaceInList(node.metadata)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitNullLiteral(NullLiteral node) => visitNode(node);
+
+ @override
+ bool visitParenthesizedExpression(ParenthesizedExpression node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitPartDirective(PartDirective node) => visitUriBasedDirective(node);
+
+ @override
+ bool visitPartOfDirective(PartOfDirective node) {
+ if (identical(node.libraryName, _oldNode)) {
+ node.libraryName = _newNode as LibraryIdentifier;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitPostfixExpression(PostfixExpression node) {
+ if (identical(node.operand, _oldNode)) {
+ node.operand = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitPrefixedIdentifier(PrefixedIdentifier node) {
+ if (identical(node.prefix, _oldNode)) {
+ node.prefix = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.identifier, _oldNode)) {
+ node.identifier = _newNode as SimpleIdentifier;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitPrefixExpression(PrefixExpression node) {
+ if (identical(node.operand, _oldNode)) {
+ node.operand = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitPropertyAccess(PropertyAccess node) {
+ if (identical(node.target, _oldNode)) {
+ node.target = _newNode as Expression;
+ return true;
+ } else if (identical(node.propertyName, _oldNode)) {
+ node.propertyName = _newNode as SimpleIdentifier;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitRedirectingConstructorInvocation(RedirectingConstructorInvocation node) {
+ if (identical(node.constructorName, _oldNode)) {
+ node.constructorName = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.argumentList, _oldNode)) {
+ node.argumentList = _newNode as ArgumentList;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitRethrowExpression(RethrowExpression node) => visitNode(node);
+
+ @override
+ bool visitReturnStatement(ReturnStatement node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitScriptTag(ScriptTag scriptTag) => visitNode(scriptTag);
+
+ @override
+ bool visitShowCombinator(ShowCombinator node) {
+ if (_replaceInList(node.shownNames)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitSimpleFormalParameter(SimpleFormalParameter node) {
+ if (identical(node.type, _oldNode)) {
+ node.type = _newNode as TypeName;
+ return true;
+ }
+ return visitNormalFormalParameter(node);
+ }
+
+ @override
+ bool visitSimpleIdentifier(SimpleIdentifier node) => visitNode(node);
+
+ @override
+ bool visitSimpleStringLiteral(SimpleStringLiteral node) => visitNode(node);
+
+ @override
+ bool visitStringInterpolation(StringInterpolation node) {
+ if (_replaceInList(node.elements)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitSuperConstructorInvocation(SuperConstructorInvocation node) {
+ if (identical(node.constructorName, _oldNode)) {
+ node.constructorName = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.argumentList, _oldNode)) {
+ node.argumentList = _newNode as ArgumentList;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitSuperExpression(SuperExpression node) => visitNode(node);
+
+ @override
+ bool visitSwitchCase(SwitchCase node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ }
+ return visitSwitchMember(node);
+ }
+
+ @override
+ bool visitSwitchDefault(SwitchDefault node) => visitSwitchMember(node);
+
+ bool visitSwitchMember(SwitchMember node) {
+ if (_replaceInList(node.labels)) {
+ return true;
+ } else if (_replaceInList(node.statements)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitSwitchStatement(SwitchStatement node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ } else if (_replaceInList(node.members)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitSymbolLiteral(SymbolLiteral node) => visitNode(node);
+
+ @override
+ bool visitThisExpression(ThisExpression node) => visitNode(node);
+
+ @override
+ bool visitThrowExpression(ThrowExpression node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node) {
+ if (identical(node.variables, _oldNode)) {
+ node.variables = _newNode as VariableDeclarationList;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitTryStatement(TryStatement node) {
+ if (identical(node.body, _oldNode)) {
+ node.body = _newNode as Block;
+ return true;
+ } else if (identical(node.finallyBlock, _oldNode)) {
+ node.finallyBlock = _newNode as Block;
+ return true;
+ } else if (_replaceInList(node.catchClauses)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitTypeArgumentList(TypeArgumentList node) {
+ if (_replaceInList(node.arguments)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ bool visitTypedLiteral(TypedLiteral node) {
+ if (identical(node.typeArguments, _oldNode)) {
+ node.typeArguments = _newNode as TypeArgumentList;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitTypeName(TypeName node) {
+ if (identical(node.name, _oldNode)) {
+ node.name = _newNode as Identifier;
+ return true;
+ } else if (identical(node.typeArguments, _oldNode)) {
+ node.typeArguments = _newNode as TypeArgumentList;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitTypeParameter(TypeParameter node) {
+ if (identical(node.name, _oldNode)) {
+ node.name = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.bound, _oldNode)) {
+ node.bound = _newNode as TypeName;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitTypeParameterList(TypeParameterList node) {
+ if (_replaceInList(node.typeParameters)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ bool visitUriBasedDirective(UriBasedDirective node) {
+ if (identical(node.uri, _oldNode)) {
+ node.uri = _newNode as StringLiteral;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitVariableDeclaration(VariableDeclaration node) {
+ if (identical(node.name, _oldNode)) {
+ node.name = _newNode as SimpleIdentifier;
+ return true;
+ } else if (identical(node.initializer, _oldNode)) {
+ node.initializer = _newNode as Expression;
+ return true;
+ }
+ return visitAnnotatedNode(node);
+ }
+
+ @override
+ bool visitVariableDeclarationList(VariableDeclarationList node) {
+ if (identical(node.type, _oldNode)) {
+ node.type = _newNode as TypeName;
+ return true;
+ } else if (_replaceInList(node.variables)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitVariableDeclarationStatement(VariableDeclarationStatement node) {
+ if (identical(node.variables, _oldNode)) {
+ node.variables = _newNode as VariableDeclarationList;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitWhileStatement(WhileStatement node) {
+ if (identical(node.condition, _oldNode)) {
+ node.condition = _newNode as Expression;
+ return true;
+ } else if (identical(node.body, _oldNode)) {
+ node.body = _newNode as Statement;
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitWithClause(WithClause node) {
+ if (_replaceInList(node.mixinTypes)) {
+ return true;
+ }
+ return visitNode(node);
+ }
+
+ @override
+ bool visitYieldStatement(YieldStatement node) {
+ if (identical(node.expression, _oldNode)) {
+ node.expression = _newNode as Expression;
+ }
+ return visitNode(node);
+ }
+
+ bool _replaceInList(NodeList list) {
+ int count = list.length;
+ for (int i = 0; i < count; i++) {
+ if (identical(_oldNode, list[i])) {
+ javaListSet(list, i, _newNode);
+ return true;
+ }
+ }
+ return false;
+ }
+}
+
+/**
+ * The abstract class `NormalFormalParameter` defines the behavior common to formal parameters
+ * that are required (are not optional).
+ *
+ * <pre>
+ * normalFormalParameter ::=
+ * [FunctionTypedFormalParameter]
+ * | [FieldFormalParameter]
+ * | [SimpleFormalParameter]
+ * </pre>
+ */
+abstract class NormalFormalParameter extends FormalParameter {
+ /**
+ * The documentation comment associated with this parameter, or `null` if this parameter
+ * does not have a documentation comment associated with it.
+ */
+ Comment _comment;
+
+ /**
+ * The annotations associated with this parameter.
+ */
+ NodeList<Annotation> _metadata;
+
+ /**
+ * The name of the parameter being declared.
+ */
+ SimpleIdentifier _identifier;
+
+ /**
+ * Initialize a newly created formal parameter.
+ *
+ * @param comment the documentation comment associated with this parameter
+ * @param metadata the annotations associated with this parameter
+ * @param identifier the name of the parameter being declared
+ */
+ NormalFormalParameter(Comment comment, List<Annotation> metadata, SimpleIdentifier identifier) {
+ this._metadata = new NodeList<Annotation>(this);
+ this._comment = becomeParentOf(comment);
+ this._metadata.addAll(metadata);
+ this._identifier = becomeParentOf(identifier);
+ }
+
+ /**
+ * Return the documentation comment associated with this parameter, or `null` if this
+ * parameter does not have a documentation comment associated with it.
+ *
+ * @return the documentation comment associated with this parameter
+ */
+ Comment get documentationComment => _comment;
+
+ @override
+ SimpleIdentifier get identifier => _identifier;
+
+ @override
+ ParameterKind get kind {
+ AstNode parent = this.parent;
+ if (parent is DefaultFormalParameter) {
+ return parent.kind;
+ }
+ return ParameterKind.REQUIRED;
+ }
+
+ /**
+ * Return the annotations associated with this parameter.
+ *
+ * @return the annotations associated with this parameter
+ */
+ NodeList<Annotation> get metadata => _metadata;
+
+ /**
+ * Set the documentation comment associated with this parameter to the given comment
+ *
+ * @param comment the documentation comment to be associated with this parameter
+ */
+ void set documentationComment(Comment comment) {
+ this._comment = becomeParentOf(comment);
+ }
+
+ /**
+ * Set the name of the parameter being declared to the given identifier.
+ *
+ * @param identifier the name of the parameter being declared
+ */
+ void set identifier(SimpleIdentifier identifier) {
+ this._identifier = becomeParentOf(identifier);
+ }
+
+ /**
+ * Set the metadata associated with this node to the given metadata.
+ *
+ * @param metadata the metadata to be associated with this node
+ */
+ void set metadata(List<Annotation> metadata) {
+ this._metadata.clear();
+ this._metadata.addAll(metadata);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ //
+ // Note that subclasses are responsible for visiting the identifier because they often need to
+ // visit other nodes before visiting the identifier.
+ //
+ if (_commentIsBeforeAnnotations()) {
+ safelyVisitChild(_comment, visitor);
+ _metadata.accept(visitor);
+ } else {
+ for (AstNode child in sortedCommentAndAnnotations) {
+ child.accept(visitor);
+ }
+ }
+ }
+
+ /**
+ * Return `true` if the comment is lexically before any annotations.
+ *
+ * @return `true` if the comment is lexically before any annotations
+ */
+ bool _commentIsBeforeAnnotations() {
+ if (_comment == null || _metadata.isEmpty) {
+ return true;
+ }
+ Annotation firstAnnotation = _metadata[0];
+ return _comment.offset < firstAnnotation.offset;
+ }
+
+ /**
+ * Return an array containing the comment and annotations associated with this parameter, sorted
+ * in lexical order.
+ *
+ * @return the comment and annotations associated with this parameter in the order in which they
+ * appeared in the original source
+ */
+ List<AstNode> get sortedCommentAndAnnotations {
+ List<AstNode> childList = new List<AstNode>();
+ childList.add(_comment);
+ childList.addAll(_metadata);
+ List<AstNode> children = new List.from(childList);
+ children.sort(AstNode.LEXICAL_ORDER);
+ return children;
+ }
+}
+
+/**
+ * Instances of the class `NullLiteral` represent a null literal expression.
+ *
+ * <pre>
+ * nullLiteral ::=
+ * 'null'
+ * </pre>
+ */
+class NullLiteral extends Literal {
+ /**
+ * The token representing the literal.
+ */
+ Token literal;
+
+ /**
+ * Initialize a newly created null literal.
+ *
+ * @param token the token representing the literal
+ */
+ NullLiteral(Token token) {
+ this.literal = token;
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitNullLiteral(this);
+
+ @override
+ Token get beginToken => literal;
+
+ @override
+ Token get endToken => literal;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * Instances of the class `ParenthesizedExpression` represent a parenthesized expression.
+ *
+ * <pre>
+ * parenthesizedExpression ::=
+ * '(' [Expression] ')'
+ * </pre>
+ */
+class ParenthesizedExpression extends Expression {
+ /**
+ * The left parenthesis.
+ */
+ Token _leftParenthesis;
+
+ /**
+ * The expression within the parentheses.
+ */
+ Expression _expression;
+
+ /**
+ * The right parenthesis.
+ */
+ Token _rightParenthesis;
+
+ /**
+ * Initialize a newly created parenthesized expression.
+ *
+ * @param leftParenthesis the left parenthesis
+ * @param expression the expression within the parentheses
+ * @param rightParenthesis the right parenthesis
+ */
+ ParenthesizedExpression(Token leftParenthesis, Expression expression, Token rightParenthesis) {
+ this._leftParenthesis = leftParenthesis;
+ this._expression = becomeParentOf(expression);
+ this._rightParenthesis = rightParenthesis;
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitParenthesizedExpression(this);
+
+ @override
+ Token get beginToken => _leftParenthesis;
+
+ @override
+ Token get endToken => _rightParenthesis;
+
+ /**
+ * Return the expression within the parentheses.
+ *
+ * @return the expression within the parentheses
+ */
+ Expression get expression => _expression;
+
+ /**
+ * Return the left parenthesis.
+ *
+ * @return the left parenthesis
+ */
+ Token get leftParenthesis => _leftParenthesis;
+
+ @override
+ int get precedence => 15;
+
+ /**
+ * Return the right parenthesis.
+ *
+ * @return the right parenthesis
+ */
+ Token get rightParenthesis => _rightParenthesis;
+
+ /**
+ * Set the expression within the parentheses to the given expression.
+ *
+ * @param expression the expression within the parentheses
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the left parenthesis to the given token.
+ *
+ * @param parenthesis the left parenthesis
+ */
+ void set leftParenthesis(Token parenthesis) {
+ _leftParenthesis = parenthesis;
+ }
+
+ /**
+ * Set the right parenthesis to the given token.
+ *
+ * @param parenthesis the right parenthesis
+ */
+ void set rightParenthesis(Token parenthesis) {
+ _rightParenthesis = parenthesis;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_expression, visitor);
+ }
+}
+
+/**
+ * Instances of the class `PartDirective` represent a part directive.
+ *
+ * <pre>
+ * partDirective ::=
+ * [Annotation] 'part' [StringLiteral] ';'
+ * </pre>
+ */
+class PartDirective extends UriBasedDirective {
+ /**
+ * The token representing the 'part' token.
+ */
+ Token partToken;
+
+ /**
+ * The semicolon terminating the directive.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created part directive.
+ *
+ * @param comment the documentation comment associated with this directive
+ * @param metadata the annotations associated with the directive
+ * @param partToken the token representing the 'part' token
+ * @param partUri the URI of the part being included
+ * @param semicolon the semicolon terminating the directive
+ */
+ PartDirective(Comment comment, List<Annotation> metadata, this.partToken, StringLiteral partUri, this.semicolon) : super(comment, metadata, partUri);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitPartDirective(this);
+
+ @override
+ Token get endToken => semicolon;
+
+ @override
+ Token get keyword => partToken;
+
+ @override
+ CompilationUnitElement get uriElement => element as CompilationUnitElement;
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata => partToken;
+}
+
+/**
+ * Instances of the class `PartOfDirective` represent a part-of directive.
+ *
+ * <pre>
+ * partOfDirective ::=
+ * [Annotation] 'part' 'of' [Identifier] ';'
+ * </pre>
+ */
+class PartOfDirective extends Directive {
+ /**
+ * The token representing the 'part' token.
+ */
+ Token partToken;
+
+ /**
+ * The token representing the 'of' token.
+ */
+ Token ofToken;
+
+ /**
+ * The name of the library that the containing compilation unit is part of.
+ */
+ LibraryIdentifier _libraryName;
+
+ /**
+ * The semicolon terminating the directive.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created part-of directive.
+ *
+ * @param comment the documentation comment associated with this directive
+ * @param metadata the annotations associated with the directive
+ * @param partToken the token representing the 'part' token
+ * @param ofToken the token representing the 'of' token
+ * @param libraryName the name of the library that the containing compilation unit is part of
+ * @param semicolon the semicolon terminating the directive
+ */
+ PartOfDirective(Comment comment, List<Annotation> metadata, this.partToken, this.ofToken, LibraryIdentifier libraryName, this.semicolon) : super(comment, metadata) {
+ this._libraryName = becomeParentOf(libraryName);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitPartOfDirective(this);
+
+ @override
+ Token get endToken => semicolon;
+
+ @override
+ Token get keyword => partToken;
+
+ /**
+ * Return the name of the library that the containing compilation unit is part of.
+ *
+ * @return the name of the library that the containing compilation unit is part of
+ */
+ LibraryIdentifier get libraryName => _libraryName;
+
+ /**
+ * Set the name of the library that the containing compilation unit is part of to the given name.
+ *
+ * @param libraryName the name of the library that the containing compilation unit is part of
+ */
+ void set libraryName(LibraryIdentifier libraryName) {
+ this._libraryName = becomeParentOf(libraryName);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_libraryName, visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata => partToken;
+}
+
+/**
+ * Instances of the class `PostfixExpression` represent a postfix unary expression.
+ *
+ * <pre>
+ * postfixExpression ::=
+ * [Expression] [Token]
+ * </pre>
+ */
+class PostfixExpression extends Expression {
+ /**
+ * The expression computing the operand for the operator.
+ */
+ Expression _operand;
+
+ /**
+ * The postfix operator being applied to the operand.
+ */
+ Token operator;
+
+ /**
+ * The element associated with this the operator based on the propagated type of the operand, or
+ * `null` if the AST structure has not been resolved, if the operator is not user definable,
+ * or if the operator could not be resolved.
+ */
+ MethodElement _propagatedElement;
+
+ /**
+ * The element associated with the operator based on the static type of the operand, or
+ * `null` if the AST structure has not been resolved, if the operator is not user definable,
+ * or if the operator could not be resolved.
+ */
+ MethodElement _staticElement;
+
+ /**
+ * Initialize a newly created postfix expression.
+ *
+ * @param operand the expression computing the operand for the operator
+ * @param operator the postfix operator being applied to the operand
+ */
+ PostfixExpression(Expression operand, this.operator) {
+ this._operand = becomeParentOf(operand);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitPostfixExpression(this);
+
+ @override
+ Token get beginToken => _operand.beginToken;
+
+ /**
+ * Return the best element available for this operator. If resolution was able to find a better
+ * element based on type propagation, that element will be returned. Otherwise, the element found
+ * using the result of static analysis will be returned. If resolution has not been performed,
+ * then `null` will be returned.
+ *
+ * @return the best element available for this operator
+ */
+ MethodElement get bestElement {
+ MethodElement element = propagatedElement;
+ if (element == null) {
+ element = staticElement;
+ }
+ return element;
+ }
+
+ @override
+ Token get endToken => operator;
+
+ /**
+ * Return the expression computing the operand for the operator.
+ *
+ * @return the expression computing the operand for the operator
+ */
+ Expression get operand => _operand;
+
+ @override
+ int get precedence => 15;
+
+ /**
+ * Return the element associated with the operator based on the propagated type of the operand, or
+ * `null` if the AST structure has not been resolved, if the operator is not user definable,
+ * or if the operator could not be resolved. One example of the latter case is an operator that is
+ * not defined for the type of the operand.
+ *
+ * @return the element associated with the operator
+ */
+ MethodElement get propagatedElement => _propagatedElement;
+
+ /**
+ * Return the element associated with the operator based on the static type of the operand, or
+ * `null` if the AST structure has not been resolved, if the operator is not user definable,
+ * or if the operator could not be resolved. One example of the latter case is an operator that is
+ * not defined for the type of the operand.
+ *
+ * @return the element associated with the operator
+ */
+ MethodElement get staticElement => _staticElement;
+
+ /**
+ * Set the expression computing the operand for the operator to the given expression.
+ *
+ * @param expression the expression computing the operand for the operator
+ */
+ void set operand(Expression expression) {
+ _operand = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the element associated with the operator based on the propagated type of the operand to the
+ * given element.
+ *
+ * @param element the element to be associated with the operator
+ */
+ void set propagatedElement(MethodElement element) {
+ _propagatedElement = element;
+ }
+
+ /**
+ * Set the element associated with the operator based on the static type of the operand to the
+ * given element.
+ *
+ * @param element the element to be associated with the operator
+ */
+ void set staticElement(MethodElement element) {
+ _staticElement = element;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_operand, visitor);
+ }
+
+ /**
+ * If the AST structure has been resolved, and the function being invoked is known based on
+ * propagated type information, then return the parameter element representing the parameter to
+ * which the value of the operand will be bound. Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getPropagatedParameterElement].
+ *
+ * @return the parameter element representing the parameter to which the value of the right
+ * operand will be bound
+ */
+ ParameterElement get propagatedParameterElementForOperand {
+ if (_propagatedElement == null) {
+ return null;
+ }
+ List<ParameterElement> parameters = _propagatedElement.parameters;
+ if (parameters.length < 1) {
+ return null;
+ }
+ return parameters[0];
+ }
+
+ /**
+ * If the AST structure has been resolved, and the function being invoked is known based on static
+ * type information, then return the parameter element representing the parameter to which the
+ * value of the operand will be bound. Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getStaticParameterElement].
+ *
+ * @return the parameter element representing the parameter to which the value of the right
+ * operand will be bound
+ */
+ ParameterElement get staticParameterElementForOperand {
+ if (_staticElement == null) {
+ return null;
+ }
+ List<ParameterElement> parameters = _staticElement.parameters;
+ if (parameters.length < 1) {
+ return null;
+ }
+ return parameters[0];
+ }
+}
+
+/**
+ * Instances of the class `PrefixExpression` represent a prefix unary expression.
+ *
+ * <pre>
+ * prefixExpression ::=
+ * [Token] [Expression]
+ * </pre>
+ */
+class PrefixExpression extends Expression {
+ /**
+ * The prefix operator being applied to the operand.
+ */
+ Token operator;
+
+ /**
+ * The expression computing the operand for the operator.
+ */
+ Expression _operand;
+
+ /**
+ * The element associated with the operator based on the static type of the operand, or
+ * `null` if the AST structure has not been resolved, if the operator is not user definable,
+ * or if the operator could not be resolved.
+ */
+ MethodElement _staticElement;
+
+ /**
+ * The element associated with the operator based on the propagated type of the operand, or
+ * `null` if the AST structure has not been resolved, if the operator is not user definable,
+ * or if the operator could not be resolved.
+ */
+ MethodElement _propagatedElement;
+
+ /**
+ * Initialize a newly created prefix expression.
+ *
+ * @param operator the prefix operator being applied to the operand
+ * @param operand the expression computing the operand for the operator
+ */
+ PrefixExpression(this.operator, Expression operand) {
+ this._operand = becomeParentOf(operand);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitPrefixExpression(this);
+
+ @override
+ Token get beginToken => operator;
+
+ /**
+ * Return the best element available for this operator. If resolution was able to find a better
+ * element based on type propagation, that element will be returned. Otherwise, the element found
+ * using the result of static analysis will be returned. If resolution has not been performed,
+ * then `null` will be returned.
+ *
+ * @return the best element available for this operator
+ */
+ MethodElement get bestElement {
+ MethodElement element = propagatedElement;
+ if (element == null) {
+ element = staticElement;
+ }
+ return element;
+ }
+
+ @override
+ Token get endToken => _operand.endToken;
+
+ /**
+ * Return the expression computing the operand for the operator.
+ *
+ * @return the expression computing the operand for the operator
+ */
+ Expression get operand => _operand;
+
+ @override
+ int get precedence => 14;
+
+ /**
+ * Return the element associated with the operator based on the propagated type of the operand, or
+ * `null` if the AST structure has not been resolved, if the operator is not user definable,
+ * or if the operator could not be resolved. One example of the latter case is an operator that is
+ * not defined for the type of the operand.
+ *
+ * @return the element associated with the operator
+ */
+ MethodElement get propagatedElement => _propagatedElement;
+
+ /**
+ * Return the element associated with the operator based on the static type of the operand, or
+ * `null` if the AST structure has not been resolved, if the operator is not user definable,
+ * or if the operator could not be resolved. One example of the latter case is an operator that is
+ * not defined for the type of the operand.
+ *
+ * @return the element associated with the operator
+ */
+ MethodElement get staticElement => _staticElement;
+
+ /**
+ * Set the expression computing the operand for the operator to the given expression.
+ *
+ * @param expression the expression computing the operand for the operator
+ */
+ void set operand(Expression expression) {
+ _operand = becomeParentOf(expression);
+ }
+
+ /**
+ * Set the element associated with the operator based on the propagated type of the operand to the
+ * given element.
+ *
+ * @param element the element to be associated with the operator
+ */
+ void set propagatedElement(MethodElement element) {
+ _propagatedElement = element;
+ }
+
+ /**
+ * Set the element associated with the operator based on the static type of the operand to the
+ * given element.
+ *
+ * @param element the static element to be associated with the operator
+ */
+ void set staticElement(MethodElement element) {
+ _staticElement = element;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_operand, visitor);
+ }
+
+ /**
+ * If the AST structure has been resolved, and the function being invoked is known based on
+ * propagated type information, then return the parameter element representing the parameter to
+ * which the value of the operand will be bound. Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getPropagatedParameterElement].
+ *
+ * @return the parameter element representing the parameter to which the value of the right
+ * operand will be bound
+ */
+ ParameterElement get propagatedParameterElementForOperand {
+ if (_propagatedElement == null) {
+ return null;
+ }
+ List<ParameterElement> parameters = _propagatedElement.parameters;
+ if (parameters.length < 1) {
+ return null;
+ }
+ return parameters[0];
+ }
+
+ /**
+ * If the AST structure has been resolved, and the function being invoked is known based on static
+ * type information, then return the parameter element representing the parameter to which the
+ * value of the operand will be bound. Otherwise, return `null`.
+ *
+ * This method is only intended to be used by [Expression#getStaticParameterElement].
+ *
+ * @return the parameter element representing the parameter to which the value of the right
+ * operand will be bound
+ */
+ ParameterElement get staticParameterElementForOperand {
+ if (_staticElement == null) {
+ return null;
+ }
+ List<ParameterElement> parameters = _staticElement.parameters;
+ if (parameters.length < 1) {
+ return null;
+ }
+ return parameters[0];
+ }
+}
+
+/**
+ * Instances of the class `PrefixedIdentifier` represent either an identifier that is prefixed
+ * or an access to an object property where the target of the property access is a simple
+ * identifier.
+ *
+ * <pre>
+ * prefixedIdentifier ::=
+ * [SimpleIdentifier] '.' [SimpleIdentifier]
+ * </pre>
+ */
+class PrefixedIdentifier extends Identifier {
+ /**
+ * The prefix associated with the library in which the identifier is defined.
+ */
+ SimpleIdentifier _prefix;
+
+ /**
+ * The period used to separate the prefix from the identifier.
+ */
+ Token period;
+
+ /**
+ * The identifier being prefixed.
+ */
+ SimpleIdentifier _identifier;
+
+ /**
+ * Initialize a newly created prefixed identifier.
+ *
+ * @param prefix the identifier being prefixed
+ * @param period the period used to separate the prefix from the identifier
+ * @param identifier the prefix associated with the library in which the identifier is defined
+ */
+ PrefixedIdentifier(SimpleIdentifier prefix, this.period, SimpleIdentifier identifier) {
+ this._prefix = becomeParentOf(prefix);
+ this._identifier = becomeParentOf(identifier);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitPrefixedIdentifier(this);
+
+ @override
+ Token get beginToken => _prefix.beginToken;
+
+ @override
+ Element get bestElement {
+ if (_identifier == null) {
+ return null;
+ }
+ return _identifier.bestElement;
+ }
+
+ @override
+ Token get endToken => _identifier.endToken;
+
+ /**
+ * Return the identifier being prefixed.
+ *
+ * @return the identifier being prefixed
+ */
+ SimpleIdentifier get identifier => _identifier;
+
+ @override
+ String get name => "${_prefix.name}.${_identifier.name}";
+
+ @override
+ int get precedence => 15;
+
+ /**
+ * Return the prefix associated with the library in which the identifier is defined.
+ *
+ * @return the prefix associated with the library in which the identifier is defined
+ */
+ SimpleIdentifier get prefix => _prefix;
+
+ @override
+ Element get propagatedElement {
+ if (_identifier == null) {
+ return null;
+ }
+ return _identifier.propagatedElement;
+ }
+
+ @override
+ Element get staticElement {
+ if (_identifier == null) {
+ return null;
+ }
+ return _identifier.staticElement;
+ }
+
+ /**
+ * Return `true` if this type is a deferred type.
+ *
+ * 15.1 Static Types: A type <i>T</i> is deferred iff it is of the form </i>p.T</i> where <i>p</i>
+ * is a deferred prefix.
+ *
+ * @return `true` if this type is a deferred type
+ */
+ bool get isDeferred {
+ Element element = _prefix.staticElement;
+ if (element is! PrefixElement) {
+ return false;
+ }
+ PrefixElement prefixElement = element as PrefixElement;
+ List<ImportElement> imports = prefixElement.enclosingElement.getImportsWithPrefix(prefixElement);
+ if (imports.length != 1) {
+ return false;
+ }
+ return imports[0].isDeferred;
+ }
+
+ /**
+ * Set the identifier being prefixed to the given identifier.
+ *
+ * @param identifier the identifier being prefixed
+ */
+ void set identifier(SimpleIdentifier identifier) {
+ this._identifier = becomeParentOf(identifier);
+ }
+
+ /**
+ * Set the prefix associated with the library in which the identifier is defined to the given
+ * identifier.
+ *
+ * @param identifier the prefix associated with the library in which the identifier is defined
+ */
+ void set prefix(SimpleIdentifier identifier) {
+ _prefix = becomeParentOf(identifier);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_prefix, visitor);
+ safelyVisitChild(_identifier, visitor);
+ }
+}
+
+/**
+ * Instances of the class `PropertyAccess` represent the access of a property of an object.
+ *
+ * Note, however, that accesses to properties of objects can also be represented as
+ * [PrefixedIdentifier] nodes in cases where the target is also a simple
+ * identifier.
+ *
+ * <pre>
+ * propertyAccess ::=
+ * [Expression] '.' [SimpleIdentifier]
+ * </pre>
+ */
+class PropertyAccess extends Expression {
+ /**
+ * The expression computing the object defining the property being accessed.
+ */
+ Expression _target;
+
+ /**
+ * The property access operator.
+ */
+ Token operator;
+
+ /**
+ * The name of the property being accessed.
+ */
+ SimpleIdentifier _propertyName;
+
+ /**
+ * Initialize a newly created property access expression.
+ *
+ * @param target the expression computing the object defining the property being accessed
+ * @param operator the property access operator
+ * @param propertyName the name of the property being accessed
+ */
+ PropertyAccess(Expression target, this.operator, SimpleIdentifier propertyName) {
+ this._target = becomeParentOf(target);
+ this._propertyName = becomeParentOf(propertyName);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitPropertyAccess(this);
+
+ @override
+ Token get beginToken {
+ if (_target != null) {
+ return _target.beginToken;
+ }
+ return operator;
+ }
+
+ @override
+ Token get endToken => _propertyName.endToken;
+
+ @override
+ int get precedence => 15;
+
+ /**
+ * Return the name of the property being accessed.
+ *
+ * @return the name of the property being accessed
+ */
+ SimpleIdentifier get propertyName => _propertyName;
+
+ /**
+ * Return the expression used to compute the receiver of the invocation. If this invocation is not
+ * part of a cascade expression, then this is the same as [getTarget]. If this invocation
+ * is part of a cascade expression, then the target stored with the cascade expression is
+ * returned.
+ *
+ * @return the expression used to compute the receiver of the invocation
+ * @see #getTarget()
+ */
+ Expression get realTarget {
+ if (isCascaded) {
+ AstNode ancestor = parent;
+ while (ancestor is! CascadeExpression) {
+ if (ancestor == null) {
+ return _target;
+ }
+ ancestor = ancestor.parent;
+ }
+ return (ancestor as CascadeExpression).target;
+ }
+ return _target;
+ }
+
+ /**
+ * Return the expression computing the object defining the property being accessed, or
+ * `null` if this property access is part of a cascade expression.
+ *
+ * @return the expression computing the object defining the property being accessed
+ * @see #getRealTarget()
+ */
+ Expression get target => _target;
+
+ @override
+ bool get isAssignable => true;
+
+ /**
+ * Return `true` if this expression is cascaded. If it is, then the target of this
+ * expression is not stored locally but is stored in the nearest ancestor that is a
+ * [CascadeExpression].
+ *
+ * @return `true` if this expression is cascaded
+ */
+ bool get isCascaded => operator != null && operator.type == TokenType.PERIOD_PERIOD;
+
+ /**
+ * Set the name of the property being accessed to the given identifier.
+ *
+ * @param identifier the name of the property being accessed
+ */
+ void set propertyName(SimpleIdentifier identifier) {
+ _propertyName = becomeParentOf(identifier);
+ }
+
+ /**
+ * Set the expression computing the object defining the property being accessed to the given
+ * expression.
+ *
+ * @param expression the expression computing the object defining the property being accessed
+ */
+ void set target(Expression expression) {
+ _target = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_target, visitor);
+ safelyVisitChild(_propertyName, visitor);
+ }
+}
+
+/**
+ * Instances of the class `RecursiveAstVisitor` implement an AST visitor that will recursively
+ * visit all of the nodes in an AST structure. For example, using an instance of this class to visit
+ * a [Block] will also cause all of the statements in the block to be visited.
+ *
+ * Subclasses that override a visit method must either invoke the overridden visit method or must
+ * explicitly ask the visited node to visit its children. Failure to do so will cause the children
+ * of the visited node to not be visited.
+ */
+class RecursiveAstVisitor<R> implements AstVisitor<R> {
+ @override
+ R visitAdjacentStrings(AdjacentStrings node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitAnnotation(Annotation node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitArgumentList(ArgumentList node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitAsExpression(AsExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitAssertStatement(AssertStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitAssignmentExpression(AssignmentExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitAwaitExpression(AwaitExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitBinaryExpression(BinaryExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitBlock(Block node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitBlockFunctionBody(BlockFunctionBody node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitBooleanLiteral(BooleanLiteral node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitBreakStatement(BreakStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitCascadeExpression(CascadeExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitCatchClause(CatchClause node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitClassDeclaration(ClassDeclaration node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitClassTypeAlias(ClassTypeAlias node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitComment(Comment node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitCommentReference(CommentReference node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitCompilationUnit(CompilationUnit node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitConditionalExpression(ConditionalExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitConstructorDeclaration(ConstructorDeclaration node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitConstructorFieldInitializer(ConstructorFieldInitializer node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitConstructorName(ConstructorName node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitContinueStatement(ContinueStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitDeclaredIdentifier(DeclaredIdentifier node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitDefaultFormalParameter(DefaultFormalParameter node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitDoStatement(DoStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitDoubleLiteral(DoubleLiteral node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitEmptyFunctionBody(EmptyFunctionBody node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitEmptyStatement(EmptyStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitEnumConstantDeclaration(EnumConstantDeclaration node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitEnumDeclaration(EnumDeclaration node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitExportDirective(ExportDirective node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitExpressionFunctionBody(ExpressionFunctionBody node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitExpressionStatement(ExpressionStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitExtendsClause(ExtendsClause node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitFieldDeclaration(FieldDeclaration node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitFieldFormalParameter(FieldFormalParameter node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitForEachStatement(ForEachStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitFormalParameterList(FormalParameterList node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitForStatement(ForStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitFunctionDeclaration(FunctionDeclaration node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitFunctionDeclarationStatement(FunctionDeclarationStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitFunctionExpression(FunctionExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitFunctionExpressionInvocation(FunctionExpressionInvocation node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitFunctionTypeAlias(FunctionTypeAlias node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitFunctionTypedFormalParameter(FunctionTypedFormalParameter node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitHideCombinator(HideCombinator node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitIfStatement(IfStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitImplementsClause(ImplementsClause node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitImportDirective(ImportDirective node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitIndexExpression(IndexExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitInstanceCreationExpression(InstanceCreationExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitIntegerLiteral(IntegerLiteral node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitInterpolationExpression(InterpolationExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitInterpolationString(InterpolationString node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitIsExpression(IsExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitLabel(Label node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitLabeledStatement(LabeledStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitLibraryDirective(LibraryDirective node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitLibraryIdentifier(LibraryIdentifier node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitListLiteral(ListLiteral node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitMapLiteral(MapLiteral node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitMapLiteralEntry(MapLiteralEntry node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitMethodDeclaration(MethodDeclaration node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitMethodInvocation(MethodInvocation node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitNamedExpression(NamedExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitNativeClause(NativeClause node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitNativeFunctionBody(NativeFunctionBody node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitNullLiteral(NullLiteral node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitParenthesizedExpression(ParenthesizedExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitPartDirective(PartDirective node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitPartOfDirective(PartOfDirective node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitPostfixExpression(PostfixExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitPrefixedIdentifier(PrefixedIdentifier node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitPrefixExpression(PrefixExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitPropertyAccess(PropertyAccess node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitRedirectingConstructorInvocation(RedirectingConstructorInvocation node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitRethrowExpression(RethrowExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitReturnStatement(ReturnStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitScriptTag(ScriptTag node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitShowCombinator(ShowCombinator node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitSimpleFormalParameter(SimpleFormalParameter node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitSimpleIdentifier(SimpleIdentifier node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitSimpleStringLiteral(SimpleStringLiteral node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitStringInterpolation(StringInterpolation node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitSuperConstructorInvocation(SuperConstructorInvocation node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitSuperExpression(SuperExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitSwitchCase(SwitchCase node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitSwitchDefault(SwitchDefault node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitSwitchStatement(SwitchStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitSymbolLiteral(SymbolLiteral node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitThisExpression(ThisExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitThrowExpression(ThrowExpression node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitTryStatement(TryStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitTypeArgumentList(TypeArgumentList node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitTypeName(TypeName node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitTypeParameter(TypeParameter node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitTypeParameterList(TypeParameterList node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitVariableDeclaration(VariableDeclaration node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitVariableDeclarationList(VariableDeclarationList node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitVariableDeclarationStatement(VariableDeclarationStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitWhileStatement(WhileStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitWithClause(WithClause node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitYieldStatement(YieldStatement node) {
+ node.visitChildren(this);
+ return null;
+ }
+}
+
+/**
+ * Instances of the class `RedirectingConstructorInvocation` represent the invocation of a
+ * another constructor in the same class from within a constructor's initialization list.
+ *
+ * <pre>
+ * redirectingConstructorInvocation ::=
+ * 'this' ('.' identifier)? arguments
+ * </pre>
+ */
+class RedirectingConstructorInvocation extends ConstructorInitializer {
+ /**
+ * The token for the 'this' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The token for the period before the name of the constructor that is being invoked, or
+ * `null` if the unnamed constructor is being invoked.
+ */
+ Token period;
+
+ /**
+ * The name of the constructor that is being invoked, or `null` if the unnamed constructor
+ * is being invoked.
+ */
+ SimpleIdentifier _constructorName;
+
+ /**
+ * The list of arguments to the constructor.
+ */
+ ArgumentList _argumentList;
+
+ /**
+ * The element associated with the constructor based on static type information, or `null`
+ * if the AST structure has not been resolved or if the constructor could not be resolved.
+ */
+ ConstructorElement staticElement;
+
+ /**
+ * Initialize a newly created redirecting invocation to invoke the constructor with the given name
+ * with the given arguments.
+ *
+ * @param keyword the token for the 'this' keyword
+ * @param period the token for the period before the name of the constructor that is being invoked
+ * @param constructorName the name of the constructor that is being invoked
+ * @param argumentList the list of arguments to the constructor
+ */
+ RedirectingConstructorInvocation(this.keyword, this.period, SimpleIdentifier constructorName, ArgumentList argumentList) {
+ this._constructorName = becomeParentOf(constructorName);
+ this._argumentList = becomeParentOf(argumentList);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitRedirectingConstructorInvocation(this);
+
+ /**
+ * Return the list of arguments to the constructor.
+ *
+ * @return the list of arguments to the constructor
+ */
+ ArgumentList get argumentList => _argumentList;
+
+ @override
+ Token get beginToken => keyword;
+
+ /**
+ * Return the name of the constructor that is being invoked, or `null` if the unnamed
+ * constructor is being invoked.
+ *
+ * @return the name of the constructor that is being invoked
+ */
+ SimpleIdentifier get constructorName => _constructorName;
+
+ @override
+ Token get endToken => _argumentList.endToken;
+
+ /**
+ * Set the list of arguments to the constructor to the given list.
+ *
+ * @param argumentList the list of arguments to the constructor
+ */
+ void set argumentList(ArgumentList argumentList) {
+ this._argumentList = becomeParentOf(argumentList);
+ }
+
+ /**
+ * Set the name of the constructor that is being invoked to the given identifier.
+ *
+ * @param identifier the name of the constructor that is being invoked
+ */
+ void set constructorName(SimpleIdentifier identifier) {
+ _constructorName = becomeParentOf(identifier);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_constructorName, visitor);
+ safelyVisitChild(_argumentList, visitor);
+ }
+}
+
+/**
+ * Instances of the class `RethrowExpression` represent a rethrow expression.
+ *
+ * <pre>
+ * rethrowExpression ::=
+ * 'rethrow'
+ * </pre>
+ */
+class RethrowExpression extends Expression {
+ /**
+ * The token representing the 'rethrow' keyword.
+ */
+ Token keyword;
+
+ /**
+ * Initialize a newly created rethrow expression.
+ *
+ * @param keyword the token representing the 'rethrow' keyword
+ */
+ RethrowExpression(this.keyword);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitRethrowExpression(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ @override
+ Token get endToken => keyword;
+
+ @override
+ int get precedence => 0;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * Instances of the class `ReturnStatement` represent a return statement.
+ *
+ * <pre>
+ * returnStatement ::=
+ * 'return' [Expression]? ';'
+ * </pre>
+ */
+class ReturnStatement extends Statement {
+ /**
+ * The token representing the 'return' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The expression computing the value to be returned, or `null` if no explicit value was
+ * provided.
+ */
+ Expression _expression;
+
+ /**
+ * The semicolon terminating the statement.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created return statement.
+ *
+ * @param keyword the token representing the 'return' keyword
+ * @param expression the expression computing the value to be returned
+ * @param semicolon the semicolon terminating the statement
+ */
+ ReturnStatement(this.keyword, Expression expression, this.semicolon) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitReturnStatement(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ @override
+ Token get endToken => semicolon;
+
+ /**
+ * Return the expression computing the value to be returned, or `null` if no explicit value
+ * was provided.
+ *
+ * @return the expression computing the value to be returned
+ */
+ Expression get expression => _expression;
+
+ /**
+ * Set the expression computing the value to be returned to the given expression.
+ *
+ * @param expression the expression computing the value to be returned
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_expression, visitor);
+ }
+}
+
+/**
+ * Traverse the AST from initial child node to successive parents, building a collection of local
+ * variable and parameter names visible to the initial child node. In case of name shadowing, the
+ * first name seen is the most specific one so names are not redefined.
+ *
+ * Completion test code coverage is 95%. The two basic blocks that are not executed cannot be
+ * executed. They are included for future reference.
+ */
+class ScopedNameFinder extends GeneralizingAstVisitor<Object> {
+ Declaration _declarationNode;
+
+ AstNode _immediateChild;
+
+ Map<String, SimpleIdentifier> _locals = new HashMap<String, SimpleIdentifier>();
+
+ final int _position;
+
+ bool _referenceIsWithinLocalFunction = false;
+
+ ScopedNameFinder(this._position);
+
+ Declaration get declaration => _declarationNode;
+
+ Map<String, SimpleIdentifier> get locals => _locals;
+
+ @override
+ Object visitBlock(Block node) {
+ _checkStatements(node.statements);
+ return super.visitBlock(node);
+ }
+
+ @override
+ Object visitCatchClause(CatchClause node) {
+ _addToScope(node.exceptionParameter);
+ _addToScope(node.stackTraceParameter);
+ return super.visitCatchClause(node);
+ }
+
+ @override
+ Object visitConstructorDeclaration(ConstructorDeclaration node) {
+ if (!identical(_immediateChild, node.parameters)) {
+ _addParameters(node.parameters.parameters);
+ }
+ _declarationNode = node;
+ return null;
+ }
+
+ @override
+ Object visitFieldDeclaration(FieldDeclaration node) {
+ _declarationNode = node;
+ return null;
+ }
+
+ @override
+ Object visitForEachStatement(ForEachStatement node) {
+ DeclaredIdentifier loopVariable = node.loopVariable;
+ if (loopVariable != null) {
+ _addToScope(loopVariable.identifier);
+ }
+ return super.visitForEachStatement(node);
+ }
+
+ @override
+ Object visitForStatement(ForStatement node) {
+ if (!identical(_immediateChild, node.variables) && node.variables != null) {
+ _addVariables(node.variables.variables);
+ }
+ return super.visitForStatement(node);
+ }
+
+ @override
+ Object visitFunctionDeclaration(FunctionDeclaration node) {
+ if (node.parent is! FunctionDeclarationStatement) {
+ _declarationNode = node;
+ return null;
+ }
+ return super.visitFunctionDeclaration(node);
+ }
+
+ @override
+ Object visitFunctionDeclarationStatement(FunctionDeclarationStatement node) {
+ _referenceIsWithinLocalFunction = true;
+ return super.visitFunctionDeclarationStatement(node);
+ }
+
+ @override
+ Object visitFunctionExpression(FunctionExpression node) {
+ if (node.parameters != null && !identical(_immediateChild, node.parameters)) {
+ _addParameters(node.parameters.parameters);
+ }
+ return super.visitFunctionExpression(node);
+ }
+
+ @override
+ Object visitMethodDeclaration(MethodDeclaration node) {
+ _declarationNode = node;
+ if (node.parameters == null) {
+ return null;
+ }
+ if (!identical(_immediateChild, node.parameters)) {
+ _addParameters(node.parameters.parameters);
+ }
+ return null;
+ }
+
+ @override
+ Object visitNode(AstNode node) {
+ _immediateChild = node;
+ AstNode parent = node.parent;
+ if (parent != null) {
+ parent.accept(this);
+ }
+ return null;
+ }
+
+ @override
+ Object visitSwitchMember(SwitchMember node) {
+ _checkStatements(node.statements);
+ return super.visitSwitchMember(node);
+ }
+
+ @override
+ Object visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node) {
+ _declarationNode = node;
+ return null;
+ }
+
+ @override
+ Object visitTypeAlias(TypeAlias node) {
+ _declarationNode = node;
+ return null;
+ }
+
+ void _addParameters(NodeList<FormalParameter> vars) {
+ for (FormalParameter var2 in vars) {
+ _addToScope(var2.identifier);
+ }
+ }
+
+ void _addToScope(SimpleIdentifier identifier) {
+ if (identifier != null && _isInRange(identifier)) {
+ String name = identifier.name;
+ if (!_locals.containsKey(name)) {
+ _locals[name] = identifier;
+ }
+ }
+ }
+
+ void _addVariables(NodeList<VariableDeclaration> vars) {
+ for (VariableDeclaration var2 in vars) {
+ _addToScope(var2.name);
+ }
+ }
+
+ /**
+ * Some statements define names that are visible downstream. There aren't many of these.
+ *
+ * @param statements the list of statements to check for name definitions
+ */
+ void _checkStatements(List<Statement> statements) {
+ for (Statement stmt in statements) {
+ if (identical(stmt, _immediateChild)) {
+ return;
+ }
+ if (stmt is VariableDeclarationStatement) {
+ _addVariables(stmt.variables.variables);
+ } else if (stmt is FunctionDeclarationStatement && !_referenceIsWithinLocalFunction) {
+ _addToScope(stmt.functionDeclaration.name);
+ }
+ }
+ }
+
+ bool _isInRange(AstNode node) {
+ if (_position < 0) {
+ // if source position is not set then all nodes are in range
+ return true;
+ }
+ return node.end < _position;
+ }
+}
+
+/**
+ * Instances of the class `ScriptTag` represent the script tag that can optionally occur at
+ * the beginning of a compilation unit.
+ *
+ * <pre>
+ * scriptTag ::=
+ * '#!' (~NEWLINE)* NEWLINE
+ * </pre>
+ */
+class ScriptTag extends AstNode {
+ /**
+ * The token representing this script tag.
+ */
+ Token scriptTag;
+
+ /**
+ * Initialize a newly created script tag.
+ *
+ * @param scriptTag the token representing this script tag
+ */
+ ScriptTag(this.scriptTag);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitScriptTag(this);
+
+ @override
+ Token get beginToken => scriptTag;
+
+ @override
+ Token get endToken => scriptTag;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * Instances of the class `ShowCombinator` represent a combinator that restricts the names
+ * being imported to those in a given list.
+ *
+ * <pre>
+ * showCombinator ::=
+ * 'show' [SimpleIdentifier] (',' [SimpleIdentifier])*
+ * </pre>
+ */
+class ShowCombinator extends Combinator {
+ /**
+ * The list of names from the library that are made visible by this combinator.
+ */
+ NodeList<SimpleIdentifier> _shownNames;
+
+ /**
+ * Initialize a newly created import show combinator.
+ *
+ * @param keyword the comma introducing the combinator
+ * @param shownNames the list of names from the library that are made visible by this combinator
+ */
+ ShowCombinator(Token keyword, List<SimpleIdentifier> shownNames) : super(keyword) {
+ this._shownNames = new NodeList<SimpleIdentifier>(this);
+ this._shownNames.addAll(shownNames);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitShowCombinator(this);
+
+ @override
+ Token get endToken => _shownNames.endToken;
+
+ /**
+ * Return the list of names from the library that are made visible by this combinator.
+ *
+ * @return the list of names from the library that are made visible by this combinator
+ */
+ NodeList<SimpleIdentifier> get shownNames => _shownNames;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _shownNames.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `SimpleAstVisitor` implement an AST visitor that will do nothing
+ * when visiting an AST node. It is intended to be a superclass for classes that use the visitor
+ * pattern primarily as a dispatch mechanism (and hence don't need to recursively visit a whole
+ * structure) and that only need to visit a small number of node types.
+ */
+class SimpleAstVisitor<R> implements AstVisitor<R> {
+ @override
+ R visitAdjacentStrings(AdjacentStrings node) => null;
+
+ @override
+ R visitAnnotation(Annotation node) => null;
+
+ @override
+ R visitArgumentList(ArgumentList node) => null;
+
+ @override
+ R visitAsExpression(AsExpression node) => null;
+
+ @override
+ R visitAssertStatement(AssertStatement node) => null;
+
+ @override
+ R visitAssignmentExpression(AssignmentExpression node) => null;
+
+ @override
+ R visitAwaitExpression(AwaitExpression node) => null;
+
+ @override
+ R visitBinaryExpression(BinaryExpression node) => null;
+
+ @override
+ R visitBlock(Block node) => null;
+
+ @override
+ R visitBlockFunctionBody(BlockFunctionBody node) => null;
+
+ @override
+ R visitBooleanLiteral(BooleanLiteral node) => null;
+
+ @override
+ R visitBreakStatement(BreakStatement node) => null;
+
+ @override
+ R visitCascadeExpression(CascadeExpression node) => null;
+
+ @override
+ R visitCatchClause(CatchClause node) => null;
+
+ @override
+ R visitClassDeclaration(ClassDeclaration node) => null;
+
+ @override
+ R visitClassTypeAlias(ClassTypeAlias node) => null;
+
+ @override
+ R visitComment(Comment node) => null;
+
+ @override
+ R visitCommentReference(CommentReference node) => null;
+
+ @override
+ R visitCompilationUnit(CompilationUnit node) => null;
+
+ @override
+ R visitConditionalExpression(ConditionalExpression node) => null;
+
+ @override
+ R visitConstructorDeclaration(ConstructorDeclaration node) => null;
+
+ @override
+ R visitConstructorFieldInitializer(ConstructorFieldInitializer node) => null;
+
+ @override
+ R visitConstructorName(ConstructorName node) => null;
+
+ @override
+ R visitContinueStatement(ContinueStatement node) => null;
+
+ @override
+ R visitDeclaredIdentifier(DeclaredIdentifier node) => null;
+
+ @override
+ R visitDefaultFormalParameter(DefaultFormalParameter node) => null;
+
+ @override
+ R visitDoStatement(DoStatement node) => null;
+
+ @override
+ R visitDoubleLiteral(DoubleLiteral node) => null;
+
+ @override
+ R visitEmptyFunctionBody(EmptyFunctionBody node) => null;
+
+ @override
+ R visitEmptyStatement(EmptyStatement node) => null;
+
+ @override
+ R visitEnumConstantDeclaration(EnumConstantDeclaration node) => null;
+
+ @override
+ R visitEnumDeclaration(EnumDeclaration node) => null;
+
+ @override
+ R visitExportDirective(ExportDirective node) => null;
+
+ @override
+ R visitExpressionFunctionBody(ExpressionFunctionBody node) => null;
+
+ @override
+ R visitExpressionStatement(ExpressionStatement node) => null;
+
+ @override
+ R visitExtendsClause(ExtendsClause node) => null;
+
+ @override
+ R visitFieldDeclaration(FieldDeclaration node) => null;
+
+ @override
+ R visitFieldFormalParameter(FieldFormalParameter node) => null;
+
+ @override
+ R visitForEachStatement(ForEachStatement node) => null;
+
+ @override
+ R visitFormalParameterList(FormalParameterList node) => null;
+
+ @override
+ R visitForStatement(ForStatement node) => null;
+
+ @override
+ R visitFunctionDeclaration(FunctionDeclaration node) => null;
+
+ @override
+ R visitFunctionDeclarationStatement(FunctionDeclarationStatement node) => null;
+
+ @override
+ R visitFunctionExpression(FunctionExpression node) => null;
+
+ @override
+ R visitFunctionExpressionInvocation(FunctionExpressionInvocation node) => null;
+
+ @override
+ R visitFunctionTypeAlias(FunctionTypeAlias node) => null;
+
+ @override
+ R visitFunctionTypedFormalParameter(FunctionTypedFormalParameter node) => null;
+
+ @override
+ R visitHideCombinator(HideCombinator node) => null;
+
+ @override
+ R visitIfStatement(IfStatement node) => null;
+
+ @override
+ R visitImplementsClause(ImplementsClause node) => null;
+
+ @override
+ R visitImportDirective(ImportDirective node) => null;
+
+ @override
+ R visitIndexExpression(IndexExpression node) => null;
+
+ @override
+ R visitInstanceCreationExpression(InstanceCreationExpression node) => null;
+
+ @override
+ R visitIntegerLiteral(IntegerLiteral node) => null;
+
+ @override
+ R visitInterpolationExpression(InterpolationExpression node) => null;
+
+ @override
+ R visitInterpolationString(InterpolationString node) => null;
+
+ @override
+ R visitIsExpression(IsExpression node) => null;
+
+ @override
+ R visitLabel(Label node) => null;
+
+ @override
+ R visitLabeledStatement(LabeledStatement node) => null;
+
+ @override
+ R visitLibraryDirective(LibraryDirective node) => null;
+
+ @override
+ R visitLibraryIdentifier(LibraryIdentifier node) => null;
+
+ @override
+ R visitListLiteral(ListLiteral node) => null;
+
+ @override
+ R visitMapLiteral(MapLiteral node) => null;
+
+ @override
+ R visitMapLiteralEntry(MapLiteralEntry node) => null;
+
+ @override
+ R visitMethodDeclaration(MethodDeclaration node) => null;
+
+ @override
+ R visitMethodInvocation(MethodInvocation node) => null;
+
+ @override
+ R visitNamedExpression(NamedExpression node) => null;
+
+ @override
+ R visitNativeClause(NativeClause node) => null;
+
+ @override
+ R visitNativeFunctionBody(NativeFunctionBody node) => null;
+
+ @override
+ R visitNullLiteral(NullLiteral node) => null;
+
+ @override
+ R visitParenthesizedExpression(ParenthesizedExpression node) => null;
+
+ @override
+ R visitPartDirective(PartDirective node) => null;
+
+ @override
+ R visitPartOfDirective(PartOfDirective node) => null;
+
+ @override
+ R visitPostfixExpression(PostfixExpression node) => null;
+
+ @override
+ R visitPrefixedIdentifier(PrefixedIdentifier node) => null;
+
+ @override
+ R visitPrefixExpression(PrefixExpression node) => null;
+
+ @override
+ R visitPropertyAccess(PropertyAccess node) => null;
+
+ @override
+ R visitRedirectingConstructorInvocation(RedirectingConstructorInvocation node) => null;
+
+ @override
+ R visitRethrowExpression(RethrowExpression node) => null;
+
+ @override
+ R visitReturnStatement(ReturnStatement node) => null;
+
+ @override
+ R visitScriptTag(ScriptTag node) => null;
+
+ @override
+ R visitShowCombinator(ShowCombinator node) => null;
+
+ @override
+ R visitSimpleFormalParameter(SimpleFormalParameter node) => null;
+
+ @override
+ R visitSimpleIdentifier(SimpleIdentifier node) => null;
+
+ @override
+ R visitSimpleStringLiteral(SimpleStringLiteral node) => null;
+
+ @override
+ R visitStringInterpolation(StringInterpolation node) => null;
+
+ @override
+ R visitSuperConstructorInvocation(SuperConstructorInvocation node) => null;
+
+ @override
+ R visitSuperExpression(SuperExpression node) => null;
+
+ @override
+ R visitSwitchCase(SwitchCase node) => null;
+
+ @override
+ R visitSwitchDefault(SwitchDefault node) => null;
+
+ @override
+ R visitSwitchStatement(SwitchStatement node) => null;
+
+ @override
+ R visitSymbolLiteral(SymbolLiteral node) => null;
+
+ @override
+ R visitThisExpression(ThisExpression node) => null;
+
+ @override
+ R visitThrowExpression(ThrowExpression node) => null;
+
+ @override
+ R visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node) => null;
+
+ @override
+ R visitTryStatement(TryStatement node) => null;
+
+ @override
+ R visitTypeArgumentList(TypeArgumentList node) => null;
+
+ @override
+ R visitTypeName(TypeName node) => null;
+
+ @override
+ R visitTypeParameter(TypeParameter node) => null;
+
+ @override
+ R visitTypeParameterList(TypeParameterList node) => null;
+
+ @override
+ R visitVariableDeclaration(VariableDeclaration node) => null;
+
+ @override
+ R visitVariableDeclarationList(VariableDeclarationList node) => null;
+
+ @override
+ R visitVariableDeclarationStatement(VariableDeclarationStatement node) => null;
+
+ @override
+ R visitWhileStatement(WhileStatement node) => null;
+
+ @override
+ R visitWithClause(WithClause node) => null;
+
+ @override
+ R visitYieldStatement(YieldStatement node) => null;
+}
+
+/**
+ * Instances of the class `SimpleFormalParameter` represent a simple formal parameter.
+ *
+ * <pre>
+ * simpleFormalParameter ::=
+ * ('final' [TypeName] | 'var' | [TypeName])? [SimpleIdentifier]
+ * </pre>
+ */
+class SimpleFormalParameter extends NormalFormalParameter {
+ /**
+ * The token representing either the 'final', 'const' or 'var' keyword, or `null` if no
+ * keyword was used.
+ */
+ Token keyword;
+
+ /**
+ * The name of the declared type of the parameter, or `null` if the parameter does not have
+ * a declared type.
+ */
+ TypeName _type;
+
+ /**
+ * Initialize a newly created formal parameter.
+ *
+ * @param comment the documentation comment associated with this parameter
+ * @param metadata the annotations associated with this parameter
+ * @param keyword the token representing either the 'final', 'const' or 'var' keyword
+ * @param type the name of the declared type of the parameter
+ * @param identifier the name of the parameter being declared
+ */
+ SimpleFormalParameter(Comment comment, List<Annotation> metadata, this.keyword, TypeName type, SimpleIdentifier identifier) : super(comment, metadata, identifier) {
+ this._type = becomeParentOf(type);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitSimpleFormalParameter(this);
+
+ @override
+ Token get beginToken {
+ NodeList<Annotation> metadata = this.metadata;
+ if (!metadata.isEmpty) {
+ return metadata.beginToken;
+ } else if (keyword != null) {
+ return keyword;
+ } else if (_type != null) {
+ return _type.beginToken;
+ }
+ return identifier.beginToken;
+ }
+
+ @override
+ Token get endToken => identifier.endToken;
+
+ /**
+ * Return the name of the declared type of the parameter, or `null` if the parameter does
+ * not have a declared type.
+ *
+ * @return the name of the declared type of the parameter
+ */
+ TypeName get type => _type;
+
+ @override
+ bool get isConst => (keyword is KeywordToken) && (keyword as KeywordToken).keyword == Keyword.CONST;
+
+ @override
+ bool get isFinal => (keyword is KeywordToken) && (keyword as KeywordToken).keyword == Keyword.FINAL;
+
+ /**
+ * Set the name of the declared type of the parameter to the given type name.
+ *
+ * @param typeName the name of the declared type of the parameter
+ */
+ void set type(TypeName typeName) {
+ _type = becomeParentOf(typeName);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_type, visitor);
+ safelyVisitChild(identifier, visitor);
+ }
+}
+
+/**
+ * Instances of the class `SimpleIdentifier` represent a simple identifier.
+ *
+ * <pre>
+ * simpleIdentifier ::=
+ * initialCharacter internalCharacter*
+ *
+ * initialCharacter ::= '_' | '$' | letter
+ *
+ * internalCharacter ::= '_' | '$' | letter | digit
+ * </pre>
+ */
+class SimpleIdentifier extends Identifier {
+ /**
+ * The token representing the identifier.
+ */
+ Token token;
+
+ /**
+ * The element associated with this identifier based on static type information, or `null`
+ * if the AST structure has not been resolved or if this identifier could not be resolved.
+ */
+ Element _staticElement;
+
+ /**
+ * The element associated with this identifier based on propagated type information, or
+ * `null` if the AST structure has not been resolved or if this identifier could not be
+ * resolved.
+ */
+ Element _propagatedElement;
+
+ /**
+ * If this expression is both in a getter and setter context, the [AuxiliaryElements] will
+ * be set to hold onto the static and propagated information. The auxiliary element will hold onto
+ * the elements from the getter context.
+ */
+ AuxiliaryElements auxiliaryElements = null;
+
+ /**
+ * Initialize a newly created identifier.
+ *
+ * @param token the token representing the identifier
+ */
+ SimpleIdentifier(this.token);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitSimpleIdentifier(this);
+
+ @override
+ Token get beginToken => token;
+
+ @override
+ Element get bestElement {
+ if (_propagatedElement == null) {
+ return _staticElement;
+ }
+ return _propagatedElement;
+ }
+
+ @override
+ Token get endToken => token;
+
+ @override
+ String get name => token.lexeme;
+
+ @override
+ int get precedence => 16;
+
+ @override
+ Element get propagatedElement => _propagatedElement;
+
+ @override
+ Element get staticElement => _staticElement;
+
+ /**
+ * Return `true` if this identifier is the name being declared in a declaration.
+ *
+ * @return `true` if this identifier is the name being declared in a declaration
+ */
+ bool inDeclarationContext() {
+ AstNode parent = this.parent;
+ if (parent is CatchClause) {
+ CatchClause clause = parent;
+ return identical(this, clause.exceptionParameter) || identical(this, clause.stackTraceParameter);
+ } else if (parent is ClassDeclaration) {
+ return identical(this, parent.name);
+ } else if (parent is ClassTypeAlias) {
+ return identical(this, parent.name);
+ } else if (parent is ConstructorDeclaration) {
+ return identical(this, parent.name);
+ } else if (parent is DeclaredIdentifier) {
+ return identical(this, parent.identifier);
+ } else if (parent is FunctionDeclaration) {
+ return identical(this, parent.name);
+ } else if (parent is FunctionTypeAlias) {
+ return identical(this, parent.name);
+ } else if (parent is Label) {
+ return identical(this, parent.label) && (parent.parent is LabeledStatement);
+ } else if (parent is MethodDeclaration) {
+ return identical(this, parent.name);
+ } else if (parent is FunctionTypedFormalParameter || parent is SimpleFormalParameter) {
+ return identical(this, (parent as NormalFormalParameter).identifier);
+ } else if (parent is TypeParameter) {
+ return identical(this, parent.name);
+ } else if (parent is VariableDeclaration) {
+ return identical(this, parent.name);
+ }
+ return false;
+ }
+
+ /**
+ * Return `true` if this expression is computing a right-hand value.
+ *
+ * Note that [inGetterContext] and [inSetterContext] are not opposites, nor are
+ * they mutually exclusive. In other words, it is possible for both methods to return `true`
+ * when invoked on the same node.
+ *
+ * @return `true` if this expression is in a context where a getter will be invoked
+ */
+ bool inGetterContext() {
+ AstNode parent = this.parent;
+ AstNode target = this;
+ // skip prefix
+ if (parent is PrefixedIdentifier) {
+ PrefixedIdentifier prefixed = parent as PrefixedIdentifier;
+ if (identical(prefixed.prefix, this)) {
+ return true;
+ }
+ parent = prefixed.parent;
+ target = prefixed;
+ } else if (parent is PropertyAccess) {
+ PropertyAccess access = parent as PropertyAccess;
+ if (identical(access.target, this)) {
+ return true;
+ }
+ parent = access.parent;
+ target = access;
+ }
+ // skip label
+ if (parent is Label) {
+ return false;
+ }
+ // analyze usage
+ if (parent is AssignmentExpression) {
+ AssignmentExpression expr = parent as AssignmentExpression;
+ if (identical(expr.leftHandSide, target) && expr.operator.type == TokenType.EQ) {
+ return false;
+ }
+ }
+ return true;
+ }
+
+ /**
+ * Return `true` if this expression is computing a left-hand value.
+ *
+ * Note that [inGetterContext] and [inSetterContext] are not opposites, nor are
+ * they mutually exclusive. In other words, it is possible for both methods to return `true`
+ * when invoked on the same node.
+ *
+ * @return `true` if this expression is in a context where a setter will be invoked
+ */
+ bool inSetterContext() {
+ AstNode parent = this.parent;
+ AstNode target = this;
+ // skip prefix
+ if (parent is PrefixedIdentifier) {
+ PrefixedIdentifier prefixed = parent as PrefixedIdentifier;
+ // if this is the prefix, then return false
+ if (identical(prefixed.prefix, this)) {
+ return false;
+ }
+ parent = prefixed.parent;
+ target = prefixed;
+ } else if (parent is PropertyAccess) {
+ PropertyAccess access = parent as PropertyAccess;
+ if (identical(access.target, this)) {
+ return false;
+ }
+ parent = access.parent;
+ target = access;
+ }
+ // analyze usage
+ if (parent is PrefixExpression) {
+ return (parent as PrefixExpression).operator.type.isIncrementOperator;
+ } else if (parent is PostfixExpression) {
+ return true;
+ } else if (parent is AssignmentExpression) {
+ return identical((parent as AssignmentExpression).leftHandSide, target);
+ }
+ return false;
+ }
+
+ /**
+ * Returns `true` if this identifier is the "name" part of a prefixed identifier or a method
+ * invocation.
+ *
+ * @return `true` if this identifier is the "name" part of a prefixed identifier or a method
+ * invocation
+ */
+ bool get isQualified {
+ AstNode parent = this.parent;
+ if (parent is PrefixedIdentifier) {
+ return identical(parent.identifier, this);
+ }
+ if (parent is PropertyAccess) {
+ return identical(parent.propertyName, this);
+ }
+ if (parent is MethodInvocation) {
+ MethodInvocation invocation = parent;
+ return identical(invocation.methodName, this) && invocation.realTarget != null;
+ }
+ return false;
+ }
+
+ @override
+ bool get isSynthetic => token.isSynthetic;
+
+ /**
+ * Set the element associated with this identifier based on propagated type information to the
+ * given element.
+ *
+ * @param element the element to be associated with this identifier
+ */
+ void set propagatedElement(Element element) {
+ _propagatedElement = _validateElement(element);
+ }
+
+ /**
+ * Set the element associated with this identifier based on static type information to the given
+ * element.
+ *
+ * @param element the element to be associated with this identifier
+ */
+ void set staticElement(Element element) {
+ _staticElement = _validateElement(element);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+
+ /**
+ * Return the given element if it is valid, or report the problem and return `null` if it is
+ * not appropriate.
+ *
+ * @param parent the parent of the element, used for reporting when there is a problem
+ * @param isValid `true` if the element is appropriate
+ * @param element the element to be associated with this identifier
+ * @return the element to be associated with this identifier
+ */
+ Element _returnOrReportElement(AstNode parent, bool isValid, Element element) {
+ if (!isValid) {
+ AnalysisEngine.instance.logger.logInformation2("Internal error: attempting to set the name of a ${parent.runtimeType.toString()} to a ${element.runtimeType.toString()}", new JavaException());
+ return null;
+ }
+ return element;
+ }
+
+ /**
+ * Return the given element if it is an appropriate element based on the parent of this
+ * identifier, or `null` if it is not appropriate.
+ *
+ * @param element the element to be associated with this identifier
+ * @return the element to be associated with this identifier
+ */
+ Element _validateElement(Element element) {
+ if (element == null) {
+ return null;
+ }
+ AstNode parent = this.parent;
+ if (parent is ClassDeclaration && identical(parent.name, this)) {
+ return _returnOrReportElement(parent, element is ClassElement, element);
+ } else if (parent is ClassTypeAlias && identical(parent.name, this)) {
+ return _returnOrReportElement(parent, element is ClassElement, element);
+ } else if (parent is DeclaredIdentifier && identical(parent.identifier, this)) {
+ return _returnOrReportElement(parent, element is LocalVariableElement, element);
+ } else if (parent is FormalParameter && identical(parent.identifier, this)) {
+ return _returnOrReportElement(parent, element is ParameterElement, element);
+ } else if (parent is FunctionDeclaration && identical(parent.name, this)) {
+ return _returnOrReportElement(parent, element is ExecutableElement, element);
+ } else if (parent is FunctionTypeAlias && identical(parent.name, this)) {
+ return _returnOrReportElement(parent, element is FunctionTypeAliasElement, element);
+ } else if (parent is MethodDeclaration && identical(parent.name, this)) {
+ return _returnOrReportElement(parent, element is ExecutableElement, element);
+ } else if (parent is TypeParameter && identical(parent.name, this)) {
+ return _returnOrReportElement(parent, element is TypeParameterElement, element);
+ } else if (parent is VariableDeclaration && identical(parent.name, this)) {
+ return _returnOrReportElement(parent, element is VariableElement, element);
+ }
+ return element;
+ }
+}
+
+/**
+ * Instances of the class `SimpleStringLiteral` represent a string literal expression that
+ * does not contain any interpolations.
+ *
+ * <pre>
+ * simpleStringLiteral ::=
+ * rawStringLiteral
+ * | basicStringLiteral
+ *
+ * rawStringLiteral ::=
+ * 'r' basicStringLiteral
+ *
+ * simpleStringLiteral ::=
+ * multiLineStringLiteral
+ * | singleLineStringLiteral
+ *
+ * multiLineStringLiteral ::=
+ * "'''" characters "'''"
+ * | '"""' characters '"""'
+ *
+ * singleLineStringLiteral ::=
+ * "'" characters "'"
+ * '"' characters '"'
+ * </pre>
+ */
+class SimpleStringLiteral extends StringLiteral {
+ /**
+ * The token representing the literal.
+ */
+ Token literal;
+
+ /**
+ * The value of the literal.
+ */
+ String _value;
+
+ /**
+ * The toolkit specific element associated with this literal, or `null`.
+ */
+ Element _toolkitElement;
+
+ /**
+ * Initialize a newly created simple string literal.
+ *
+ * @param literal the token representing the literal
+ * @param value the value of the literal
+ */
+ SimpleStringLiteral(this.literal, String value) {
+ this._value = StringUtilities.intern(value);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitSimpleStringLiteral(this);
+
+ @override
+ Token get beginToken => literal;
+
+ @override
+ Token get endToken => literal;
+
+ /**
+ * Return the toolkit specific, non-Dart, element associated with this literal, or `null`.
+ *
+ * @return the element associated with this literal
+ */
+ Element get toolkitElement => _toolkitElement;
+
+ /**
+ * Return the value of the literal.
+ *
+ * @return the value of the literal
+ */
+ String get value => _value;
+
+ /**
+ * Return the offset of the first value character.
+ *
+ * @return the offset of the first value character
+ */
+ int get valueOffset {
+ int valueOffset = 0;
+ if (isRaw) {
+ valueOffset += 1;
+ }
+ if (isMultiline) {
+ valueOffset += 3;
+ } else {
+ valueOffset += 1;
+ }
+ return offset + valueOffset;
+ }
+
+ /**
+ * Return `true` if this string literal is a multi-line string.
+ *
+ * @return `true` if this string literal is a multi-line string
+ */
+ bool get isMultiline {
+ String lexeme = literal.lexeme;
+ if (lexeme.length < 6) {
+ return false;
+ }
+ return StringUtilities.endsWith3(lexeme, 0x22, 0x22, 0x22) || StringUtilities.endsWith3(lexeme, 0x27, 0x27, 0x27);
+ }
+
+ /**
+ * Return `true` if this string literal is a raw string.
+ *
+ * @return `true` if this string literal is a raw string
+ */
+ bool get isRaw => literal.lexeme.codeUnitAt(0) == 0x72;
+
+ @override
+ bool get isSynthetic => literal.isSynthetic;
+
+ /**
+ * Set the toolkit specific, non-Dart, element associated with this literal.
+ *
+ * @param element the toolkit specific element to be associated with this literal
+ */
+ void set toolkitElement(Element element) {
+ _toolkitElement = element;
+ }
+
+ /**
+ * Set the value of the literal to the given string.
+ *
+ * @param string the value of the literal
+ */
+ void set value(String string) {
+ _value = StringUtilities.intern(_value);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+
+ @override
+ void appendStringValue(JavaStringBuilder builder) {
+ builder.append(value);
+ }
+}
+
+/**
+ * Instances of the class `Statement` defines the behavior common to nodes that represent a
+ * statement.
+ *
+ * <pre>
+ * statement ::=
+ * [Block]
+ * | [VariableDeclarationStatement]
+ * | [ForStatement]
+ * | [ForEachStatement]
+ * | [WhileStatement]
+ * | [DoStatement]
+ * | [SwitchStatement]
+ * | [IfStatement]
+ * | [TryStatement]
+ * | [BreakStatement]
+ * | [ContinueStatement]
+ * | [ReturnStatement]
+ * | [ExpressionStatement]
+ * | [FunctionDeclarationStatement]
+ * </pre>
+ */
+abstract class Statement extends AstNode {
+}
+
+/**
+ * Instances of the class `StringInterpolation` represent a string interpolation literal.
+ *
+ * <pre>
+ * stringInterpolation ::=
+ * ''' [InterpolationElement]* '''
+ * | '"' [InterpolationElement]* '"'
+ * </pre>
+ */
+class StringInterpolation extends StringLiteral {
+ /**
+ * The elements that will be composed to produce the resulting string.
+ */
+ NodeList<InterpolationElement> _elements;
+
+ /**
+ * Initialize a newly created string interpolation expression.
+ *
+ * @param elements the elements that will be composed to produce the resulting string
+ */
+ StringInterpolation(List<InterpolationElement> elements) {
+ this._elements = new NodeList<InterpolationElement>(this);
+ this._elements.addAll(elements);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitStringInterpolation(this);
+
+ @override
+ Token get beginToken => _elements.beginToken;
+
+ /**
+ * Return the elements that will be composed to produce the resulting string.
+ *
+ * @return the elements that will be composed to produce the resulting string
+ */
+ NodeList<InterpolationElement> get elements => _elements;
+
+ @override
+ Token get endToken => _elements.endToken;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _elements.accept(visitor);
+ }
+
+ @override
+ void appendStringValue(JavaStringBuilder builder) {
+ throw new IllegalArgumentException();
+ }
+}
+
+/**
+ * Instances of the class `StringLiteral` represent a string literal expression.
+ *
+ * <pre>
+ * stringLiteral ::=
+ * [SimpleStringLiteral]
+ * | [AdjacentStrings]
+ * | [StringInterpolation]
+ * </pre>
+ */
+abstract class StringLiteral extends Literal {
+ /**
+ * Return the value of the string literal, or `null` if the string is not a constant string
+ * without any string interpolation.
+ *
+ * @return the value of the string literal
+ */
+ String get stringValue {
+ JavaStringBuilder builder = new JavaStringBuilder();
+ try {
+ appendStringValue(builder);
+ } on IllegalArgumentException catch (exception) {
+ return null;
+ }
+ return builder.toString();
+ }
+
+ /**
+ * Append the value of the given string literal to the given string builder.
+ *
+ * @param builder the builder to which the string's value is to be appended
+ * @throws IllegalArgumentException if the string is not a constant string without any string
+ * interpolation
+ */
+ void appendStringValue(JavaStringBuilder builder);
+}
+
+/**
+ * Instances of the class `SuperConstructorInvocation` represent the invocation of a
+ * superclass' constructor from within a constructor's initialization list.
+ *
+ * <pre>
+ * superInvocation ::=
+ * 'super' ('.' [SimpleIdentifier])? [ArgumentList]
+ * </pre>
+ */
+class SuperConstructorInvocation extends ConstructorInitializer {
+ /**
+ * The token for the 'super' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The token for the period before the name of the constructor that is being invoked, or
+ * `null` if the unnamed constructor is being invoked.
+ */
+ Token period;
+
+ /**
+ * The name of the constructor that is being invoked, or `null` if the unnamed constructor
+ * is being invoked.
+ */
+ SimpleIdentifier _constructorName;
+
+ /**
+ * The list of arguments to the constructor.
+ */
+ ArgumentList _argumentList;
+
+ /**
+ * The element associated with the constructor based on static type information, or `null`
+ * if the AST structure has not been resolved or if the constructor could not be resolved.
+ */
+ ConstructorElement staticElement;
+
+ /**
+ * Initialize a newly created super invocation to invoke the inherited constructor with the given
+ * name with the given arguments.
+ *
+ * @param keyword the token for the 'super' keyword
+ * @param period the token for the period before the name of the constructor that is being invoked
+ * @param constructorName the name of the constructor that is being invoked
+ * @param argumentList the list of arguments to the constructor
+ */
+ SuperConstructorInvocation(this.keyword, this.period, SimpleIdentifier constructorName, ArgumentList argumentList) {
+ this._constructorName = becomeParentOf(constructorName);
+ this._argumentList = becomeParentOf(argumentList);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitSuperConstructorInvocation(this);
+
+ /**
+ * Return the list of arguments to the constructor.
+ *
+ * @return the list of arguments to the constructor
+ */
+ ArgumentList get argumentList => _argumentList;
+
+ @override
+ Token get beginToken => keyword;
+
+ /**
+ * Return the name of the constructor that is being invoked, or `null` if the unnamed
+ * constructor is being invoked.
+ *
+ * @return the name of the constructor that is being invoked
+ */
+ SimpleIdentifier get constructorName => _constructorName;
+
+ @override
+ Token get endToken => _argumentList.endToken;
+
+ /**
+ * Set the list of arguments to the constructor to the given list.
+ *
+ * @param argumentList the list of arguments to the constructor
+ */
+ void set argumentList(ArgumentList argumentList) {
+ this._argumentList = becomeParentOf(argumentList);
+ }
+
+ /**
+ * Set the name of the constructor that is being invoked to the given identifier.
+ *
+ * @param identifier the name of the constructor that is being invoked
+ */
+ void set constructorName(SimpleIdentifier identifier) {
+ _constructorName = becomeParentOf(identifier);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_constructorName, visitor);
+ safelyVisitChild(_argumentList, visitor);
+ }
+}
+
+/**
+ * Instances of the class `SuperExpression` represent a super expression.
+ *
+ * <pre>
+ * superExpression ::=
+ * 'super'
+ * </pre>
+ */
+class SuperExpression extends Expression {
+ /**
+ * The token representing the keyword.
+ */
+ Token keyword;
+
+ /**
+ * Initialize a newly created super expression.
+ *
+ * @param keyword the token representing the keyword
+ */
+ SuperExpression(this.keyword);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitSuperExpression(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ @override
+ Token get endToken => keyword;
+
+ @override
+ int get precedence => 16;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * Instances of the class `SwitchCase` represent the case in a switch statement.
+ *
+ * <pre>
+ * switchCase ::=
+ * [SimpleIdentifier]* 'case' [Expression] ':' [Statement]*
+ * </pre>
+ */
+class SwitchCase extends SwitchMember {
+ /**
+ * The expression controlling whether the statements will be executed.
+ */
+ Expression _expression;
+
+ /**
+ * Initialize a newly created switch case.
+ *
+ * @param labels the labels associated with the switch member
+ * @param keyword the token representing the 'case' or 'default' keyword
+ * @param expression the expression controlling whether the statements will be executed
+ * @param colon the colon separating the keyword or the expression from the statements
+ * @param statements the statements that will be executed if this switch member is selected
+ */
+ SwitchCase(List<Label> labels, Token keyword, Expression expression, Token colon, List<Statement> statements) : super(labels, keyword, colon, statements) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitSwitchCase(this);
+
+ /**
+ * Return the expression controlling whether the statements will be executed.
+ *
+ * @return the expression controlling whether the statements will be executed
+ */
+ Expression get expression => _expression;
+
+ /**
+ * Set the expression controlling whether the statements will be executed to the given expression.
+ *
+ * @param expression the expression controlling whether the statements will be executed
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ labels.accept(visitor);
+ safelyVisitChild(_expression, visitor);
+ statements.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `SwitchDefault` represent the default case in a switch statement.
+ *
+ * <pre>
+ * switchDefault ::=
+ * [SimpleIdentifier]* 'default' ':' [Statement]*
+ * </pre>
+ */
+class SwitchDefault extends SwitchMember {
+ /**
+ * Initialize a newly created switch default.
+ *
+ * @param labels the labels associated with the switch member
+ * @param keyword the token representing the 'case' or 'default' keyword
+ * @param colon the colon separating the keyword or the expression from the statements
+ * @param statements the statements that will be executed if this switch member is selected
+ */
+ SwitchDefault(List<Label> labels, Token keyword, Token colon, List<Statement> statements) : super(labels, keyword, colon, statements);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitSwitchDefault(this);
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ labels.accept(visitor);
+ statements.accept(visitor);
+ }
+}
+
+/**
+ * The abstract class `SwitchMember` defines the behavior common to objects representing
+ * elements within a switch statement.
+ *
+ * <pre>
+ * switchMember ::=
+ * switchCase
+ * | switchDefault
+ * </pre>
+ */
+abstract class SwitchMember extends AstNode {
+ /**
+ * The labels associated with the switch member.
+ */
+ NodeList<Label> _labels;
+
+ /**
+ * The token representing the 'case' or 'default' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The colon separating the keyword or the expression from the statements.
+ */
+ Token colon;
+
+ /**
+ * The statements that will be executed if this switch member is selected.
+ */
+ NodeList<Statement> _statements;
+
+ /**
+ * Initialize a newly created switch member.
+ *
+ * @param labels the labels associated with the switch member
+ * @param keyword the token representing the 'case' or 'default' keyword
+ * @param colon the colon separating the keyword or the expression from the statements
+ * @param statements the statements that will be executed if this switch member is selected
+ */
+ SwitchMember(List<Label> labels, this.keyword, this.colon, List<Statement> statements) {
+ this._labels = new NodeList<Label>(this);
+ this._statements = new NodeList<Statement>(this);
+ this._labels.addAll(labels);
+ this._statements.addAll(statements);
+ }
+
+ @override
+ Token get beginToken {
+ if (!_labels.isEmpty) {
+ return _labels.beginToken;
+ }
+ return keyword;
+ }
+
+ @override
+ Token get endToken {
+ if (!_statements.isEmpty) {
+ return _statements.endToken;
+ }
+ return colon;
+ }
+
+ /**
+ * Return the labels associated with the switch member.
+ *
+ * @return the labels associated with the switch member
+ */
+ NodeList<Label> get labels => _labels;
+
+ /**
+ * Return the statements that will be executed if this switch member is selected.
+ *
+ * @return the statements that will be executed if this switch member is selected
+ */
+ NodeList<Statement> get statements => _statements;
+}
+
+/**
+ * Instances of the class `SwitchStatement` represent a switch statement.
+ *
+ * <pre>
+ * switchStatement ::=
+ * 'switch' '(' [Expression] ')' '{' [SwitchCase]* [SwitchDefault]? '}'
+ * </pre>
+ */
+class SwitchStatement extends Statement {
+ /**
+ * The token representing the 'switch' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The left parenthesis.
+ */
+ Token leftParenthesis;
+
+ /**
+ * The expression used to determine which of the switch members will be selected.
+ */
+ Expression _expression;
+
+ /**
+ * The right parenthesis.
+ */
+ Token rightParenthesis;
+
+ /**
+ * The left curly bracket.
+ */
+ Token leftBracket;
+
+ /**
+ * The switch members that can be selected by the expression.
+ */
+ NodeList<SwitchMember> _members;
+
+ /**
+ * The right curly bracket.
+ */
+ Token rightBracket;
+
+ /**
+ * Initialize a newly created switch statement.
+ *
+ * @param keyword the token representing the 'switch' keyword
+ * @param leftParenthesis the left parenthesis
+ * @param expression the expression used to determine which of the switch members will be selected
+ * @param rightParenthesis the right parenthesis
+ * @param leftBracket the left curly bracket
+ * @param members the switch members that can be selected by the expression
+ * @param rightBracket the right curly bracket
+ */
+ SwitchStatement(this.keyword, this.leftParenthesis, Expression expression, this.rightParenthesis, this.leftBracket, List<SwitchMember> members, this.rightBracket) {
+ this._members = new NodeList<SwitchMember>(this);
+ this._expression = becomeParentOf(expression);
+ this._members.addAll(members);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitSwitchStatement(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ @override
+ Token get endToken => rightBracket;
+
+ /**
+ * Return the expression used to determine which of the switch members will be selected.
+ *
+ * @return the expression used to determine which of the switch members will be selected
+ */
+ Expression get expression => _expression;
+
+ /**
+ * Return the switch members that can be selected by the expression.
+ *
+ * @return the switch members that can be selected by the expression
+ */
+ NodeList<SwitchMember> get members => _members;
+
+ /**
+ * Set the expression used to determine which of the switch members will be selected to the given
+ * expression.
+ *
+ * @param expression the expression used to determine which of the switch members will be selected
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_expression, visitor);
+ _members.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `SymbolLiteral` represent a symbol literal expression.
+ *
+ * <pre>
+ * symbolLiteral ::=
+ * '#' (operator | (identifier ('.' identifier)*))
+ * </pre>
+ */
+class SymbolLiteral extends Literal {
+ /**
+ * The token introducing the literal.
+ */
+ Token poundSign;
+
+ /**
+ * The components of the literal.
+ */
+ final List<Token> components;
+
+ /**
+ * Initialize a newly created symbol literal.
+ *
+ * @param poundSign the token introducing the literal
+ * @param components the components of the literal
+ */
+ SymbolLiteral(this.poundSign, this.components);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitSymbolLiteral(this);
+
+ @override
+ Token get beginToken => poundSign;
+
+ @override
+ Token get endToken => components[components.length - 1];
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * Instances of the class `ThisExpression` represent a this expression.
+ *
+ * <pre>
+ * thisExpression ::=
+ * 'this'
+ * </pre>
+ */
+class ThisExpression extends Expression {
+ /**
+ * The token representing the keyword.
+ */
+ Token keyword;
+
+ /**
+ * Initialize a newly created this expression.
+ *
+ * @param keyword the token representing the keyword
+ */
+ ThisExpression(this.keyword);
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitThisExpression(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ @override
+ Token get endToken => keyword;
+
+ @override
+ int get precedence => 16;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ }
+}
+
+/**
+ * Instances of the class `ThrowExpression` represent a throw expression.
+ *
+ * <pre>
+ * throwExpression ::=
+ * 'throw' [Expression]
+ * </pre>
+ */
+class ThrowExpression extends Expression {
+ /**
+ * The token representing the 'throw' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The expression computing the exception to be thrown.
+ */
+ Expression _expression;
+
+ /**
+ * Initialize a newly created throw expression.
+ *
+ * @param keyword the token representing the 'throw' keyword
+ * @param expression the expression computing the exception to be thrown
+ */
+ ThrowExpression(this.keyword, Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitThrowExpression(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ @override
+ Token get endToken {
+ if (_expression != null) {
+ return _expression.endToken;
+ }
+ return keyword;
+ }
+
+ /**
+ * Return the expression computing the exception to be thrown.
+ *
+ * @return the expression computing the exception to be thrown
+ */
+ Expression get expression => _expression;
+
+ @override
+ int get precedence => 0;
+
+ /**
+ * Set the expression computing the exception to be thrown to the given expression.
+ *
+ * @param expression the expression computing the exception to be thrown
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_expression, visitor);
+ }
+}
+
+/**
+ * Instances of the class `ToSourceVisitor` write a source representation of a visited AST
+ * node (and all of it's children) to a writer.
+ */
+class ToSourceVisitor implements AstVisitor<Object> {
+ /**
+ * The writer to which the source is to be written.
+ */
+ final PrintWriter _writer;
+
+ /**
+ * Initialize a newly created visitor to write source code representing the visited nodes to the
+ * given writer.
+ *
+ * @param writer the writer to which the source is to be written
+ */
+ ToSourceVisitor(this._writer);
+
+ @override
+ Object visitAdjacentStrings(AdjacentStrings node) {
+ _visitNodeListWithSeparator(node.strings, " ");
+ return null;
+ }
+
+ @override
+ Object visitAnnotation(Annotation node) {
+ _writer.print('@');
+ _visitNode(node.name);
+ _visitNodeWithPrefix(".", node.constructorName);
+ _visitNode(node.arguments);
+ return null;
+ }
+
+ @override
+ Object visitArgumentList(ArgumentList node) {
+ _writer.print('(');
+ _visitNodeListWithSeparator(node.arguments, ", ");
+ _writer.print(')');
+ return null;
+ }
+
+ @override
+ Object visitAsExpression(AsExpression node) {
+ _visitNode(node.expression);
+ _writer.print(" as ");
+ _visitNode(node.type);
+ return null;
+ }
+
+ @override
+ Object visitAssertStatement(AssertStatement node) {
+ _writer.print("assert (");
+ _visitNode(node.condition);
+ _writer.print(");");
+ return null;
+ }
+
+ @override
+ Object visitAssignmentExpression(AssignmentExpression node) {
+ _visitNode(node.leftHandSide);
+ _writer.print(' ');
+ _writer.print(node.operator.lexeme);
+ _writer.print(' ');
+ _visitNode(node.rightHandSide);
+ return null;
+ }
+
+ @override
+ Object visitAwaitExpression(AwaitExpression node) {
+ _writer.print("await ");
+ _visitNode(node.expression);
+ _writer.print(";");
+ return null;
+ }
+
+ @override
+ Object visitBinaryExpression(BinaryExpression node) {
+ _visitNode(node.leftOperand);
+ _writer.print(' ');
+ _writer.print(node.operator.lexeme);
+ _writer.print(' ');
+ _visitNode(node.rightOperand);
+ return null;
+ }
+
+ @override
+ Object visitBlock(Block node) {
+ _writer.print('{');
+ _visitNodeListWithSeparator(node.statements, " ");
+ _writer.print('}');
+ return null;
+ }
+
+ @override
+ Object visitBlockFunctionBody(BlockFunctionBody node) {
+ Token keyword = node.keyword;
+ if (keyword != null) {
+ _writer.print(keyword.lexeme);
+ if (node.star != null) {
+ _writer.print('*');
+ }
+ _writer.print(' ');
+ }
+ _visitNode(node.block);
+ return null;
+ }
+
+ @override
+ Object visitBooleanLiteral(BooleanLiteral node) {
+ _writer.print(node.literal.lexeme);
+ return null;
+ }
+
+ @override
+ Object visitBreakStatement(BreakStatement node) {
+ _writer.print("break");
+ _visitNodeWithPrefix(" ", node.label);
+ _writer.print(";");
+ return null;
+ }
+
+ @override
+ Object visitCascadeExpression(CascadeExpression node) {
+ _visitNode(node.target);
+ _visitNodeList(node.cascadeSections);
+ return null;
+ }
+
+ @override
+ Object visitCatchClause(CatchClause node) {
+ _visitNodeWithPrefix("on ", node.exceptionType);
+ if (node.catchKeyword != null) {
+ if (node.exceptionType != null) {
+ _writer.print(' ');
+ }
+ _writer.print("catch (");
+ _visitNode(node.exceptionParameter);
+ _visitNodeWithPrefix(", ", node.stackTraceParameter);
+ _writer.print(") ");
+ } else {
+ _writer.print(" ");
+ }
+ _visitNode(node.body);
+ return null;
+ }
+
+ @override
+ Object visitClassDeclaration(ClassDeclaration node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _visitTokenWithSuffix(node.abstractKeyword, " ");
+ _writer.print("class ");
+ _visitNode(node.name);
+ _visitNode(node.typeParameters);
+ _visitNodeWithPrefix(" ", node.extendsClause);
+ _visitNodeWithPrefix(" ", node.withClause);
+ _visitNodeWithPrefix(" ", node.implementsClause);
+ _writer.print(" {");
+ _visitNodeListWithSeparator(node.members, " ");
+ _writer.print("}");
+ return null;
+ }
+
+ @override
+ Object visitClassTypeAlias(ClassTypeAlias node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ if (node.abstractKeyword != null) {
+ _writer.print("abstract ");
+ }
+ _writer.print("class ");
+ _visitNode(node.name);
+ _visitNode(node.typeParameters);
+ _writer.print(" = ");
+ _visitNode(node.superclass);
+ _visitNodeWithPrefix(" ", node.withClause);
+ _visitNodeWithPrefix(" ", node.implementsClause);
+ _writer.print(";");
+ return null;
+ }
+
+ @override
+ Object visitComment(Comment node) => null;
+
+ @override
+ Object visitCommentReference(CommentReference node) => null;
+
+ @override
+ Object visitCompilationUnit(CompilationUnit node) {
+ ScriptTag scriptTag = node.scriptTag;
+ NodeList<Directive> directives = node.directives;
+ _visitNode(scriptTag);
+ String prefix = scriptTag == null ? "" : " ";
+ _visitNodeListWithSeparatorAndPrefix(prefix, directives, " ");
+ prefix = scriptTag == null && directives.isEmpty ? "" : " ";
+ _visitNodeListWithSeparatorAndPrefix(prefix, node.declarations, " ");
+ return null;
+ }
+
+ @override
+ Object visitConditionalExpression(ConditionalExpression node) {
+ _visitNode(node.condition);
+ _writer.print(" ? ");
+ _visitNode(node.thenExpression);
+ _writer.print(" : ");
+ _visitNode(node.elseExpression);
+ return null;
+ }
+
+ @override
+ Object visitConstructorDeclaration(ConstructorDeclaration node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _visitTokenWithSuffix(node.externalKeyword, " ");
+ _visitTokenWithSuffix(node.constKeyword, " ");
+ _visitTokenWithSuffix(node.factoryKeyword, " ");
+ _visitNode(node.returnType);
+ _visitNodeWithPrefix(".", node.name);
+ _visitNode(node.parameters);
+ _visitNodeListWithSeparatorAndPrefix(" : ", node.initializers, ", ");
+ _visitNodeWithPrefix(" = ", node.redirectedConstructor);
+ _visitFunctionWithPrefix(" ", node.body);
+ return null;
+ }
+
+ @override
+ Object visitConstructorFieldInitializer(ConstructorFieldInitializer node) {
+ _visitTokenWithSuffix(node.keyword, ".");
+ _visitNode(node.fieldName);
+ _writer.print(" = ");
+ _visitNode(node.expression);
+ return null;
+ }
+
+ @override
+ Object visitConstructorName(ConstructorName node) {
+ _visitNode(node.type);
+ _visitNodeWithPrefix(".", node.name);
+ return null;
+ }
+
+ @override
+ Object visitContinueStatement(ContinueStatement node) {
+ _writer.print("continue");
+ _visitNodeWithPrefix(" ", node.label);
+ _writer.print(";");
+ return null;
+ }
+
+ @override
+ Object visitDeclaredIdentifier(DeclaredIdentifier node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _visitTokenWithSuffix(node.keyword, " ");
+ _visitNodeWithSuffix(node.type, " ");
+ _visitNode(node.identifier);
+ return null;
+ }
+
+ @override
+ Object visitDefaultFormalParameter(DefaultFormalParameter node) {
+ _visitNode(node.parameter);
+ if (node.separator != null) {
+ _writer.print(" ");
+ _writer.print(node.separator.lexeme);
+ _visitNodeWithPrefix(" ", node.defaultValue);
+ }
+ return null;
+ }
+
+ @override
+ Object visitDoStatement(DoStatement node) {
+ _writer.print("do ");
+ _visitNode(node.body);
+ _writer.print(" while (");
+ _visitNode(node.condition);
+ _writer.print(");");
+ return null;
+ }
+
+ @override
+ Object visitDoubleLiteral(DoubleLiteral node) {
+ _writer.print(node.literal.lexeme);
+ return null;
+ }
+
+ @override
+ Object visitEmptyFunctionBody(EmptyFunctionBody node) {
+ _writer.print(';');
+ return null;
+ }
+
+ @override
+ Object visitEmptyStatement(EmptyStatement node) {
+ _writer.print(';');
+ return null;
+ }
+
+ @override
+ Object visitEnumConstantDeclaration(EnumConstantDeclaration node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _visitNode(node.name);
+ return null;
+ }
+
+ @override
+ Object visitEnumDeclaration(EnumDeclaration node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _writer.print("enum ");
+ _visitNode(node.name);
+ _writer.print(" {");
+ _visitNodeListWithSeparator(node.constants, ", ");
+ _writer.print("}");
+ return null;
+ }
+
+ @override
+ Object visitExportDirective(ExportDirective node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _writer.print("export ");
+ _visitNode(node.uri);
+ _visitNodeListWithSeparatorAndPrefix(" ", node.combinators, " ");
+ _writer.print(';');
+ return null;
+ }
+
+ @override
+ Object visitExpressionFunctionBody(ExpressionFunctionBody node) {
+ Token keyword = node.keyword;
+ if (keyword != null) {
+ _writer.print(keyword.lexeme);
+ _writer.print(' ');
+ }
+ _writer.print("=> ");
+ _visitNode(node.expression);
+ if (node.semicolon != null) {
+ _writer.print(';');
+ }
+ return null;
+ }
+
+ @override
+ Object visitExpressionStatement(ExpressionStatement node) {
+ _visitNode(node.expression);
+ _writer.print(';');
+ return null;
+ }
+
+ @override
+ Object visitExtendsClause(ExtendsClause node) {
+ _writer.print("extends ");
+ _visitNode(node.superclass);
+ return null;
+ }
+
+ @override
+ Object visitFieldDeclaration(FieldDeclaration node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _visitTokenWithSuffix(node.staticKeyword, " ");
+ _visitNode(node.fields);
+ _writer.print(";");
+ return null;
+ }
+
+ @override
+ Object visitFieldFormalParameter(FieldFormalParameter node) {
+ _visitTokenWithSuffix(node.keyword, " ");
+ _visitNodeWithSuffix(node.type, " ");
+ _writer.print("this.");
+ _visitNode(node.identifier);
+ _visitNode(node.parameters);
+ return null;
+ }
+
+ @override
+ Object visitForEachStatement(ForEachStatement node) {
+ DeclaredIdentifier loopVariable = node.loopVariable;
+ if (node.awaitKeyword != null) {
+ _writer.print("await ");
+ }
+ _writer.print("for (");
+ if (loopVariable == null) {
+ _visitNode(node.identifier);
+ } else {
+ _visitNode(loopVariable);
+ }
+ _writer.print(" in ");
+ _visitNode(node.iterator);
+ _writer.print(") ");
+ _visitNode(node.body);
+ return null;
+ }
+
+ @override
+ Object visitFormalParameterList(FormalParameterList node) {
+ String groupEnd = null;
+ _writer.print('(');
+ NodeList<FormalParameter> parameters = node.parameters;
+ int size = parameters.length;
+ for (int i = 0; i < size; i++) {
+ FormalParameter parameter = parameters[i];
+ if (i > 0) {
+ _writer.print(", ");
+ }
+ if (groupEnd == null && parameter is DefaultFormalParameter) {
+ if (parameter.kind == ParameterKind.NAMED) {
+ groupEnd = "}";
+ _writer.print('{');
+ } else {
+ groupEnd = "]";
+ _writer.print('[');
+ }
+ }
+ parameter.accept(this);
+ }
+ if (groupEnd != null) {
+ _writer.print(groupEnd);
+ }
+ _writer.print(')');
+ return null;
+ }
+
+ @override
+ Object visitForStatement(ForStatement node) {
+ Expression initialization = node.initialization;
+ _writer.print("for (");
+ if (initialization != null) {
+ _visitNode(initialization);
+ } else {
+ _visitNode(node.variables);
+ }
+ _writer.print(";");
+ _visitNodeWithPrefix(" ", node.condition);
+ _writer.print(";");
+ _visitNodeListWithSeparatorAndPrefix(" ", node.updaters, ", ");
+ _writer.print(") ");
+ _visitNode(node.body);
+ return null;
+ }
+
+ @override
+ Object visitFunctionDeclaration(FunctionDeclaration node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _visitNodeWithSuffix(node.returnType, " ");
+ _visitTokenWithSuffix(node.propertyKeyword, " ");
+ _visitNode(node.name);
+ _visitNode(node.functionExpression);
+ return null;
+ }
+
+ @override
+ Object visitFunctionDeclarationStatement(FunctionDeclarationStatement node) {
+ _visitNode(node.functionDeclaration);
+ return null;
+ }
+
+ @override
+ Object visitFunctionExpression(FunctionExpression node) {
+ _visitNode(node.parameters);
+ _writer.print(' ');
+ _visitNode(node.body);
+ return null;
+ }
+
+ @override
+ Object visitFunctionExpressionInvocation(FunctionExpressionInvocation node) {
+ _visitNode(node.function);
+ _visitNode(node.argumentList);
+ return null;
+ }
+
+ @override
+ Object visitFunctionTypeAlias(FunctionTypeAlias node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _writer.print("typedef ");
+ _visitNodeWithSuffix(node.returnType, " ");
+ _visitNode(node.name);
+ _visitNode(node.typeParameters);
+ _visitNode(node.parameters);
+ _writer.print(";");
+ return null;
+ }
+
+ @override
+ Object visitFunctionTypedFormalParameter(FunctionTypedFormalParameter node) {
+ _visitNodeWithSuffix(node.returnType, " ");
+ _visitNode(node.identifier);
+ _visitNode(node.parameters);
+ return null;
+ }
+
+ @override
+ Object visitHideCombinator(HideCombinator node) {
+ _writer.print("hide ");
+ _visitNodeListWithSeparator(node.hiddenNames, ", ");
+ return null;
+ }
+
+ @override
+ Object visitIfStatement(IfStatement node) {
+ _writer.print("if (");
+ _visitNode(node.condition);
+ _writer.print(") ");
+ _visitNode(node.thenStatement);
+ _visitNodeWithPrefix(" else ", node.elseStatement);
+ return null;
+ }
+
+ @override
+ Object visitImplementsClause(ImplementsClause node) {
+ _writer.print("implements ");
+ _visitNodeListWithSeparator(node.interfaces, ", ");
+ return null;
+ }
+
+ @override
+ Object visitImportDirective(ImportDirective node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _writer.print("import ");
+ _visitNode(node.uri);
+ if (node.deferredToken != null) {
+ _writer.print(" deferred");
+ }
+ _visitNodeWithPrefix(" as ", node.prefix);
+ _visitNodeListWithSeparatorAndPrefix(" ", node.combinators, " ");
+ _writer.print(';');
+ return null;
+ }
+
+ @override
+ Object visitIndexExpression(IndexExpression node) {
+ if (node.isCascaded) {
+ _writer.print("..");
+ } else {
+ _visitNode(node.target);
+ }
+ _writer.print('[');
+ _visitNode(node.index);
+ _writer.print(']');
+ return null;
+ }
+
+ @override
+ Object visitInstanceCreationExpression(InstanceCreationExpression node) {
+ _visitTokenWithSuffix(node.keyword, " ");
+ _visitNode(node.constructorName);
+ _visitNode(node.argumentList);
+ return null;
+ }
+
+ @override
+ Object visitIntegerLiteral(IntegerLiteral node) {
+ _writer.print(node.literal.lexeme);
+ return null;
+ }
+
+ @override
+ Object visitInterpolationExpression(InterpolationExpression node) {
+ if (node.rightBracket != null) {
+ _writer.print("\${");
+ _visitNode(node.expression);
+ _writer.print("}");
+ } else {
+ _writer.print("\$");
+ _visitNode(node.expression);
+ }
+ return null;
+ }
+
+ @override
+ Object visitInterpolationString(InterpolationString node) {
+ _writer.print(node.contents.lexeme);
+ return null;
+ }
+
+ @override
+ Object visitIsExpression(IsExpression node) {
+ _visitNode(node.expression);
+ if (node.notOperator == null) {
+ _writer.print(" is ");
+ } else {
+ _writer.print(" is! ");
+ }
+ _visitNode(node.type);
+ return null;
+ }
+
+ @override
+ Object visitLabel(Label node) {
+ _visitNode(node.label);
+ _writer.print(":");
+ return null;
+ }
+
+ @override
+ Object visitLabeledStatement(LabeledStatement node) {
+ _visitNodeListWithSeparatorAndSuffix(node.labels, " ", " ");
+ _visitNode(node.statement);
+ return null;
+ }
+
+ @override
+ Object visitLibraryDirective(LibraryDirective node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _writer.print("library ");
+ _visitNode(node.name);
+ _writer.print(';');
+ return null;
+ }
+
+ @override
+ Object visitLibraryIdentifier(LibraryIdentifier node) {
+ _writer.print(node.name);
+ return null;
+ }
+
+ @override
+ Object visitListLiteral(ListLiteral node) {
+ if (node.constKeyword != null) {
+ _writer.print(node.constKeyword.lexeme);
+ _writer.print(' ');
+ }
+ _visitNodeWithSuffix(node.typeArguments, " ");
+ _writer.print("[");
+ _visitNodeListWithSeparator(node.elements, ", ");
+ _writer.print("]");
+ return null;
+ }
+
+ @override
+ Object visitMapLiteral(MapLiteral node) {
+ if (node.constKeyword != null) {
+ _writer.print(node.constKeyword.lexeme);
+ _writer.print(' ');
+ }
+ _visitNodeWithSuffix(node.typeArguments, " ");
+ _writer.print("{");
+ _visitNodeListWithSeparator(node.entries, ", ");
+ _writer.print("}");
+ return null;
+ }
+
+ @override
+ Object visitMapLiteralEntry(MapLiteralEntry node) {
+ _visitNode(node.key);
+ _writer.print(" : ");
+ _visitNode(node.value);
+ return null;
+ }
+
+ @override
+ Object visitMethodDeclaration(MethodDeclaration node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _visitTokenWithSuffix(node.externalKeyword, " ");
+ _visitTokenWithSuffix(node.modifierKeyword, " ");
+ _visitNodeWithSuffix(node.returnType, " ");
+ _visitTokenWithSuffix(node.propertyKeyword, " ");
+ _visitTokenWithSuffix(node.operatorKeyword, " ");
+ _visitNode(node.name);
+ if (!node.isGetter) {
+ _visitNode(node.parameters);
+ }
+ _visitFunctionWithPrefix(" ", node.body);
+ return null;
+ }
+
+ @override
+ Object visitMethodInvocation(MethodInvocation node) {
+ if (node.isCascaded) {
+ _writer.print("..");
+ } else {
+ _visitNodeWithSuffix(node.target, ".");
+ }
+ _visitNode(node.methodName);
+ _visitNode(node.argumentList);
+ return null;
+ }
+
+ @override
+ Object visitNamedExpression(NamedExpression node) {
+ _visitNode(node.name);
+ _visitNodeWithPrefix(" ", node.expression);
+ return null;
+ }
+
+ @override
+ Object visitNativeClause(NativeClause node) {
+ _writer.print("native ");
+ _visitNode(node.name);
+ return null;
+ }
+
+ @override
+ Object visitNativeFunctionBody(NativeFunctionBody node) {
+ _writer.print("native ");
+ _visitNode(node.stringLiteral);
+ _writer.print(';');
+ return null;
+ }
+
+ @override
+ Object visitNullLiteral(NullLiteral node) {
+ _writer.print("null");
+ return null;
+ }
+
+ @override
+ Object visitParenthesizedExpression(ParenthesizedExpression node) {
+ _writer.print('(');
+ _visitNode(node.expression);
+ _writer.print(')');
+ return null;
+ }
+
+ @override
+ Object visitPartDirective(PartDirective node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _writer.print("part ");
+ _visitNode(node.uri);
+ _writer.print(';');
+ return null;
+ }
+
+ @override
+ Object visitPartOfDirective(PartOfDirective node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _writer.print("part of ");
+ _visitNode(node.libraryName);
+ _writer.print(';');
+ return null;
+ }
+
+ @override
+ Object visitPostfixExpression(PostfixExpression node) {
+ _visitNode(node.operand);
+ _writer.print(node.operator.lexeme);
+ return null;
+ }
+
+ @override
+ Object visitPrefixedIdentifier(PrefixedIdentifier node) {
+ _visitNode(node.prefix);
+ _writer.print('.');
+ _visitNode(node.identifier);
+ return null;
+ }
+
+ @override
+ Object visitPrefixExpression(PrefixExpression node) {
+ _writer.print(node.operator.lexeme);
+ _visitNode(node.operand);
+ return null;
+ }
+
+ @override
+ Object visitPropertyAccess(PropertyAccess node) {
+ if (node.isCascaded) {
+ _writer.print("..");
+ } else {
+ _visitNode(node.target);
+ _writer.print('.');
+ }
+ _visitNode(node.propertyName);
+ return null;
+ }
+
+ @override
+ Object visitRedirectingConstructorInvocation(RedirectingConstructorInvocation node) {
+ _writer.print("this");
+ _visitNodeWithPrefix(".", node.constructorName);
+ _visitNode(node.argumentList);
+ return null;
+ }
+
+ @override
+ Object visitRethrowExpression(RethrowExpression node) {
+ _writer.print("rethrow");
+ return null;
+ }
+
+ @override
+ Object visitReturnStatement(ReturnStatement node) {
+ Expression expression = node.expression;
+ if (expression == null) {
+ _writer.print("return;");
+ } else {
+ _writer.print("return ");
+ expression.accept(this);
+ _writer.print(";");
+ }
+ return null;
+ }
+
+ @override
+ Object visitScriptTag(ScriptTag node) {
+ _writer.print(node.scriptTag.lexeme);
+ return null;
+ }
+
+ @override
+ Object visitShowCombinator(ShowCombinator node) {
+ _writer.print("show ");
+ _visitNodeListWithSeparator(node.shownNames, ", ");
+ return null;
+ }
+
+ @override
+ Object visitSimpleFormalParameter(SimpleFormalParameter node) {
+ _visitTokenWithSuffix(node.keyword, " ");
+ _visitNodeWithSuffix(node.type, " ");
+ _visitNode(node.identifier);
+ return null;
+ }
+
+ @override
+ Object visitSimpleIdentifier(SimpleIdentifier node) {
+ _writer.print(node.token.lexeme);
+ return null;
+ }
+
+ @override
+ Object visitSimpleStringLiteral(SimpleStringLiteral node) {
+ _writer.print(node.literal.lexeme);
+ return null;
+ }
+
+ @override
+ Object visitStringInterpolation(StringInterpolation node) {
+ _visitNodeList(node.elements);
+ return null;
+ }
+
+ @override
+ Object visitSuperConstructorInvocation(SuperConstructorInvocation node) {
+ _writer.print("super");
+ _visitNodeWithPrefix(".", node.constructorName);
+ _visitNode(node.argumentList);
+ return null;
+ }
+
+ @override
+ Object visitSuperExpression(SuperExpression node) {
+ _writer.print("super");
+ return null;
+ }
+
+ @override
+ Object visitSwitchCase(SwitchCase node) {
+ _visitNodeListWithSeparatorAndSuffix(node.labels, " ", " ");
+ _writer.print("case ");
+ _visitNode(node.expression);
+ _writer.print(": ");
+ _visitNodeListWithSeparator(node.statements, " ");
+ return null;
+ }
+
+ @override
+ Object visitSwitchDefault(SwitchDefault node) {
+ _visitNodeListWithSeparatorAndSuffix(node.labels, " ", " ");
+ _writer.print("default: ");
+ _visitNodeListWithSeparator(node.statements, " ");
+ return null;
+ }
+
+ @override
+ Object visitSwitchStatement(SwitchStatement node) {
+ _writer.print("switch (");
+ _visitNode(node.expression);
+ _writer.print(") {");
+ _visitNodeListWithSeparator(node.members, " ");
+ _writer.print("}");
+ return null;
+ }
+
+ @override
+ Object visitSymbolLiteral(SymbolLiteral node) {
+ _writer.print("#");
+ List<Token> components = node.components;
+ for (int i = 0; i < components.length; i++) {
+ if (i > 0) {
+ _writer.print(".");
+ }
+ _writer.print(components[i].lexeme);
+ }
+ return null;
+ }
+
+ @override
+ Object visitThisExpression(ThisExpression node) {
+ _writer.print("this");
+ return null;
+ }
+
+ @override
+ Object visitThrowExpression(ThrowExpression node) {
+ _writer.print("throw ");
+ _visitNode(node.expression);
+ return null;
+ }
+
+ @override
+ Object visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node) {
+ _visitNodeWithSuffix(node.variables, ";");
+ return null;
+ }
+
+ @override
+ Object visitTryStatement(TryStatement node) {
+ _writer.print("try ");
+ _visitNode(node.body);
+ _visitNodeListWithSeparatorAndPrefix(" ", node.catchClauses, " ");
+ _visitNodeWithPrefix(" finally ", node.finallyBlock);
+ return null;
+ }
+
+ @override
+ Object visitTypeArgumentList(TypeArgumentList node) {
+ _writer.print('<');
+ _visitNodeListWithSeparator(node.arguments, ", ");
+ _writer.print('>');
+ return null;
+ }
+
+ @override
+ Object visitTypeName(TypeName node) {
+ _visitNode(node.name);
+ _visitNode(node.typeArguments);
+ return null;
+ }
+
+ @override
+ Object visitTypeParameter(TypeParameter node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _visitNode(node.name);
+ _visitNodeWithPrefix(" extends ", node.bound);
+ return null;
+ }
+
+ @override
+ Object visitTypeParameterList(TypeParameterList node) {
+ _writer.print('<');
+ _visitNodeListWithSeparator(node.typeParameters, ", ");
+ _writer.print('>');
+ return null;
+ }
+
+ @override
+ Object visitVariableDeclaration(VariableDeclaration node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _visitNode(node.name);
+ _visitNodeWithPrefix(" = ", node.initializer);
+ return null;
+ }
+
+ @override
+ Object visitVariableDeclarationList(VariableDeclarationList node) {
+ _visitNodeListWithSeparatorAndSuffix(node.metadata, " ", " ");
+ _visitTokenWithSuffix(node.keyword, " ");
+ _visitNodeWithSuffix(node.type, " ");
+ _visitNodeListWithSeparator(node.variables, ", ");
+ return null;
+ }
+
+ @override
+ Object visitVariableDeclarationStatement(VariableDeclarationStatement node) {
+ _visitNode(node.variables);
+ _writer.print(";");
+ return null;
+ }
+
+ @override
+ Object visitWhileStatement(WhileStatement node) {
+ _writer.print("while (");
+ _visitNode(node.condition);
+ _writer.print(") ");
+ _visitNode(node.body);
+ return null;
+ }
+
+ @override
+ Object visitWithClause(WithClause node) {
+ _writer.print("with ");
+ _visitNodeListWithSeparator(node.mixinTypes, ", ");
+ return null;
+ }
+
+ @override
+ Object visitYieldStatement(YieldStatement node) {
+ if (node.star != null) {
+ _writer.print("yield* ");
+ } else {
+ _writer.print("yield ");
+ }
+ _visitNode(node.expression);
+ _writer.print(";");
+ return null;
+ }
+
+ /**
+ * Visit the given function body, printing the prefix before if given body is not empty.
+ *
+ * @param prefix the prefix to be printed if there is a node to visit
+ * @param body the function body to be visited
+ */
+ void _visitFunctionWithPrefix(String prefix, FunctionBody body) {
+ if (body is! EmptyFunctionBody) {
+ _writer.print(prefix);
+ }
+ _visitNode(body);
+ }
+
+ /**
+ * Safely visit the given node.
+ *
+ * @param node the node to be visited
+ */
+ void _visitNode(AstNode node) {
+ if (node != null) {
+ node.accept(this);
+ }
+ }
+
+ /**
+ * Print a list of nodes without any separation.
+ *
+ * @param nodes the nodes to be printed
+ * @param separator the separator to be printed between adjacent nodes
+ */
+ void _visitNodeList(NodeList<AstNode> nodes) {
+ _visitNodeListWithSeparator(nodes, "");
+ }
+
+ /**
+ * Print a list of nodes, separated by the given separator.
+ *
+ * @param nodes the nodes to be printed
+ * @param separator the separator to be printed between adjacent nodes
+ */
+ void _visitNodeListWithSeparator(NodeList<AstNode> nodes, String separator) {
+ if (nodes != null) {
+ int size = nodes.length;
+ for (int i = 0; i < size; i++) {
+ if (i > 0) {
+ _writer.print(separator);
+ }
+ nodes[i].accept(this);
+ }
+ }
+ }
+
+ /**
+ * Print a list of nodes, separated by the given separator.
+ *
+ * @param prefix the prefix to be printed if the list is not empty
+ * @param nodes the nodes to be printed
+ * @param separator the separator to be printed between adjacent nodes
+ */
+ void _visitNodeListWithSeparatorAndPrefix(String prefix, NodeList<AstNode> nodes, String separator) {
+ if (nodes != null) {
+ int size = nodes.length;
+ if (size > 0) {
+ _writer.print(prefix);
+ for (int i = 0; i < size; i++) {
+ if (i > 0) {
+ _writer.print(separator);
+ }
+ nodes[i].accept(this);
+ }
+ }
+ }
+ }
+
+ /**
+ * Print a list of nodes, separated by the given separator.
+ *
+ * @param nodes the nodes to be printed
+ * @param separator the separator to be printed between adjacent nodes
+ * @param suffix the suffix to be printed if the list is not empty
+ */
+ void _visitNodeListWithSeparatorAndSuffix(NodeList<AstNode> nodes, String separator, String suffix) {
+ if (nodes != null) {
+ int size = nodes.length;
+ if (size > 0) {
+ for (int i = 0; i < size; i++) {
+ if (i > 0) {
+ _writer.print(separator);
+ }
+ nodes[i].accept(this);
+ }
+ _writer.print(suffix);
+ }
+ }
+ }
+
+ /**
+ * Safely visit the given node, printing the prefix before the node if it is non-`null`.
+ *
+ * @param prefix the prefix to be printed if there is a node to visit
+ * @param node the node to be visited
+ */
+ void _visitNodeWithPrefix(String prefix, AstNode node) {
+ if (node != null) {
+ _writer.print(prefix);
+ node.accept(this);
+ }
+ }
+
+ /**
+ * Safely visit the given node, printing the suffix after the node if it is non-`null`.
+ *
+ * @param suffix the suffix to be printed if there is a node to visit
+ * @param node the node to be visited
+ */
+ void _visitNodeWithSuffix(AstNode node, String suffix) {
+ if (node != null) {
+ node.accept(this);
+ _writer.print(suffix);
+ }
+ }
+
+ /**
+ * Safely visit the given node, printing the suffix after the node if it is non-`null`.
+ *
+ * @param suffix the suffix to be printed if there is a node to visit
+ * @param node the node to be visited
+ */
+ void _visitTokenWithSuffix(Token token, String suffix) {
+ if (token != null) {
+ _writer.print(token.lexeme);
+ _writer.print(suffix);
+ }
+ }
+}
+
+/**
+ * Instances of the class `TopLevelVariableDeclaration` represent the declaration of one or
+ * more top-level variables of the same type.
+ *
+ * <pre>
+ * topLevelVariableDeclaration ::=
+ * ('final' | 'const') type? staticFinalDeclarationList ';'
+ * | variableDeclaration ';'
+ * </pre>
+ */
+class TopLevelVariableDeclaration extends CompilationUnitMember {
+ /**
+ * The top-level variables being declared.
+ */
+ VariableDeclarationList _variableList;
+
+ /**
+ * The semicolon terminating the declaration.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created top-level variable declaration.
+ *
+ * @param comment the documentation comment associated with this variable
+ * @param metadata the annotations associated with this variable
+ * @param variableList the top-level variables being declared
+ * @param semicolon the semicolon terminating the declaration
+ */
+ TopLevelVariableDeclaration(Comment comment, List<Annotation> metadata, VariableDeclarationList variableList, this.semicolon) : super(comment, metadata) {
+ this._variableList = becomeParentOf(variableList);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitTopLevelVariableDeclaration(this);
+
+ @override
+ Element get element => null;
+
+ @override
+ Token get endToken => semicolon;
+
+ /**
+ * Return the top-level variables being declared.
+ *
+ * @return the top-level variables being declared
+ */
+ VariableDeclarationList get variables => _variableList;
+
+ /**
+ * Set the top-level variables being declared to the given list of variables.
+ *
+ * @param variableList the top-level variables being declared
+ */
+ void set variables(VariableDeclarationList variableList) {
+ this._variableList = becomeParentOf(variableList);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_variableList, visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata => _variableList.beginToken;
+}
+
+/**
+ * Instances of the class `TryStatement` represent a try statement.
+ *
+ * <pre>
+ * tryStatement ::=
+ * 'try' [Block] ([CatchClause]+ finallyClause? | finallyClause)
+ *
+ * finallyClause ::=
+ * 'finally' [Block]
+ * </pre>
+ */
+class TryStatement extends Statement {
+ /**
+ * The token representing the 'try' keyword.
+ */
+ Token tryKeyword;
+
+ /**
+ * The body of the statement.
+ */
+ Block _body;
+
+ /**
+ * The catch clauses contained in the try statement.
+ */
+ NodeList<CatchClause> _catchClauses;
+
+ /**
+ * The token representing the 'finally' keyword, or `null` if the statement does not contain
+ * a finally clause.
+ */
+ Token finallyKeyword;
+
+ /**
+ * The finally block contained in the try statement, or `null` if the statement does not
+ * contain a finally clause.
+ */
+ Block _finallyBlock;
+
+ /**
+ * Initialize a newly created try statement.
+ *
+ * @param tryKeyword the token representing the 'try' keyword
+ * @param body the body of the statement
+ * @param catchClauses the catch clauses contained in the try statement
+ * @param finallyKeyword the token representing the 'finally' keyword
+ * @param finallyBlock the finally block contained in the try statement
+ */
+ TryStatement(this.tryKeyword, Block body, List<CatchClause> catchClauses, this.finallyKeyword, Block finallyBlock) {
+ this._catchClauses = new NodeList<CatchClause>(this);
+ this._body = becomeParentOf(body);
+ this._catchClauses.addAll(catchClauses);
+ this._finallyBlock = becomeParentOf(finallyBlock);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitTryStatement(this);
+
+ @override
+ Token get beginToken => tryKeyword;
+
+ /**
+ * Return the body of the statement.
+ *
+ * @return the body of the statement
+ */
+ Block get body => _body;
+
+ /**
+ * Return the catch clauses contained in the try statement.
+ *
+ * @return the catch clauses contained in the try statement
+ */
+ NodeList<CatchClause> get catchClauses => _catchClauses;
+
+ @override
+ Token get endToken {
+ if (_finallyBlock != null) {
+ return _finallyBlock.endToken;
+ } else if (finallyKeyword != null) {
+ return finallyKeyword;
+ } else if (!_catchClauses.isEmpty) {
+ return _catchClauses.endToken;
+ }
+ return _body.endToken;
+ }
+
+ /**
+ * Return the finally block contained in the try statement, or `null` if the statement does
+ * not contain a finally clause.
+ *
+ * @return the finally block contained in the try statement
+ */
+ Block get finallyBlock => _finallyBlock;
+
+ /**
+ * Set the body of the statement to the given block.
+ *
+ * @param block the body of the statement
+ */
+ void set body(Block block) {
+ _body = becomeParentOf(block);
+ }
+
+ /**
+ * Set the finally block contained in the try statement to the given block.
+ *
+ * @param block the finally block contained in the try statement
+ */
+ void set finallyBlock(Block block) {
+ _finallyBlock = becomeParentOf(block);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_body, visitor);
+ _catchClauses.accept(visitor);
+ safelyVisitChild(_finallyBlock, visitor);
+ }
+}
+
+/**
+ * The abstract class `TypeAlias` defines the behavior common to declarations of type aliases.
+ *
+ * <pre>
+ * typeAlias ::=
+ * 'typedef' typeAliasBody
+ *
+ * typeAliasBody ::=
+ * classTypeAlias
+ * | functionTypeAlias
+ * </pre>
+ */
+abstract class TypeAlias extends CompilationUnitMember {
+ /**
+ * The token representing the 'typedef' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The semicolon terminating the declaration.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created type alias.
+ *
+ * @param comment the documentation comment associated with this type alias
+ * @param metadata the annotations associated with this type alias
+ * @param keyword the token representing the 'typedef' keyword
+ * @param semicolon the semicolon terminating the declaration
+ */
+ TypeAlias(Comment comment, List<Annotation> metadata, this.keyword, this.semicolon) : super(comment, metadata);
+
+ @override
+ Token get endToken => semicolon;
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata => keyword;
+}
+
+/**
+ * Instances of the class `TypeArgumentList` represent a list of type arguments.
+ *
+ * <pre>
+ * typeArguments ::=
+ * '<' typeName (',' typeName)* '>'
+ * </pre>
+ */
+class TypeArgumentList extends AstNode {
+ /**
+ * The left bracket.
+ */
+ Token leftBracket;
+
+ /**
+ * The type arguments associated with the type.
+ */
+ NodeList<TypeName> _arguments;
+
+ /**
+ * The right bracket.
+ */
+ Token rightBracket;
+
+ /**
+ * Initialize a newly created list of type arguments.
+ *
+ * @param leftBracket the left bracket
+ * @param arguments the type arguments associated with the type
+ * @param rightBracket the right bracket
+ */
+ TypeArgumentList(this.leftBracket, List<TypeName> arguments, this.rightBracket) {
+ this._arguments = new NodeList<TypeName>(this);
+ this._arguments.addAll(arguments);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitTypeArgumentList(this);
+
+ /**
+ * Return the type arguments associated with the type.
+ *
+ * @return the type arguments associated with the type
+ */
+ NodeList<TypeName> get arguments => _arguments;
+
+ @override
+ Token get beginToken => leftBracket;
+
+ @override
+ Token get endToken => rightBracket;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _arguments.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `TypeName` represent the name of a type, which can optionally
+ * include type arguments.
+ *
+ * <pre>
+ * typeName ::=
+ * [Identifier] typeArguments?
+ * </pre>
+ */
+class TypeName extends AstNode {
+ /**
+ * The name of the type.
+ */
+ Identifier _name;
+
+ /**
+ * The type arguments associated with the type, or `null` if there are no type arguments.
+ */
+ TypeArgumentList _typeArguments;
+
+ /**
+ * The type being named, or `null` if the AST structure has not been resolved.
+ */
+ DartType type;
+
+ /**
+ * Initialize a newly created type name.
+ *
+ * @param name the name of the type
+ * @param typeArguments the type arguments associated with the type, or `null` if there are
+ * no type arguments
+ */
+ TypeName(Identifier name, TypeArgumentList typeArguments) {
+ this._name = becomeParentOf(name);
+ this._typeArguments = becomeParentOf(typeArguments);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitTypeName(this);
+
+ @override
+ Token get beginToken => _name.beginToken;
+
+ @override
+ Token get endToken {
+ if (_typeArguments != null) {
+ return _typeArguments.endToken;
+ }
+ return _name.endToken;
+ }
+
+ /**
+ * Return the name of the type.
+ *
+ * @return the name of the type
+ */
+ Identifier get name => _name;
+
+ /**
+ * Return the type arguments associated with the type, or `null` if there are no type
+ * arguments.
+ *
+ * @return the type arguments associated with the type
+ */
+ TypeArgumentList get typeArguments => _typeArguments;
+
+ /**
+ * Return `true` if this type is a deferred type.
+ *
+ * 15.1 Static Types: A type <i>T</i> is deferred iff it is of the form </i>p.T</i> where <i>p</i>
+ * is a deferred prefix.
+ *
+ * @return `true` if this type is a deferred type
+ */
+ bool get isDeferred {
+ Identifier identifier = name;
+ if (identifier is! PrefixedIdentifier) {
+ return false;
+ }
+ return (identifier as PrefixedIdentifier).isDeferred;
+ }
+
+ @override
+ bool get isSynthetic => _name.isSynthetic && _typeArguments == null;
+
+ /**
+ * Set the name of the type to the given identifier.
+ *
+ * @param identifier the name of the type
+ */
+ void set name(Identifier identifier) {
+ _name = becomeParentOf(identifier);
+ }
+
+ /**
+ * Set the type arguments associated with the type to the given type arguments.
+ *
+ * @param typeArguments the type arguments associated with the type
+ */
+ void set typeArguments(TypeArgumentList typeArguments) {
+ this._typeArguments = becomeParentOf(typeArguments);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_name, visitor);
+ safelyVisitChild(_typeArguments, visitor);
+ }
+}
+
+/**
+ * Instances of the class `TypeParameter` represent a type parameter.
+ *
+ * <pre>
+ * typeParameter ::=
+ * [SimpleIdentifier] ('extends' [TypeName])?
+ * </pre>
+ */
+class TypeParameter extends Declaration {
+ /**
+ * The name of the type parameter.
+ */
+ SimpleIdentifier _name;
+
+ /**
+ * The token representing the 'extends' keyword, or `null` if there was no explicit upper
+ * bound.
+ */
+ Token keyword;
+
+ /**
+ * The name of the upper bound for legal arguments, or `null` if there was no explicit upper
+ * bound.
+ */
+ TypeName _bound;
+
+ /**
+ * Initialize a newly created type parameter.
+ *
+ * @param comment the documentation comment associated with the type parameter
+ * @param metadata the annotations associated with the type parameter
+ * @param name the name of the type parameter
+ * @param keyword the token representing the 'extends' keyword
+ * @param bound the name of the upper bound for legal arguments
+ */
+ TypeParameter(Comment comment, List<Annotation> metadata, SimpleIdentifier name, this.keyword, TypeName bound) : super(comment, metadata) {
+ this._name = becomeParentOf(name);
+ this._bound = becomeParentOf(bound);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitTypeParameter(this);
+
+ /**
+ * Return the name of the upper bound for legal arguments, or `null` if there was no
+ * explicit upper bound.
+ *
+ * @return the name of the upper bound for legal arguments
+ */
+ TypeName get bound => _bound;
+
+ @override
+ TypeParameterElement get element => _name != null ? (_name.staticElement as TypeParameterElement) : null;
+
+ @override
+ Token get endToken {
+ if (_bound == null) {
+ return _name.endToken;
+ }
+ return _bound.endToken;
+ }
+
+ /**
+ * Return the name of the type parameter.
+ *
+ * @return the name of the type parameter
+ */
+ SimpleIdentifier get name => _name;
+
+ /**
+ * Set the name of the upper bound for legal arguments to the given type name.
+ *
+ * @param typeName the name of the upper bound for legal arguments
+ */
+ void set bound(TypeName typeName) {
+ _bound = becomeParentOf(typeName);
+ }
+
+ /**
+ * Set the name of the type parameter to the given identifier.
+ *
+ * @param identifier the name of the type parameter
+ */
+ void set name(SimpleIdentifier identifier) {
+ _name = becomeParentOf(identifier);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_name, visitor);
+ safelyVisitChild(_bound, visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata => _name.beginToken;
+}
+
+/**
+ * Instances of the class `TypeParameterList` represent type parameters within a declaration.
+ *
+ * <pre>
+ * typeParameterList ::=
+ * '<' [TypeParameter] (',' [TypeParameter])* '>'
+ * </pre>
+ */
+class TypeParameterList extends AstNode {
+ /**
+ * The left angle bracket.
+ */
+ final Token leftBracket;
+
+ /**
+ * The type parameters in the list.
+ */
+ NodeList<TypeParameter> _typeParameters;
+
+ /**
+ * The right angle bracket.
+ */
+ final Token rightBracket;
+
+ /**
+ * Initialize a newly created list of type parameters.
+ *
+ * @param leftBracket the left angle bracket
+ * @param typeParameters the type parameters in the list
+ * @param rightBracket the right angle bracket
+ */
+ TypeParameterList(this.leftBracket, List<TypeParameter> typeParameters, this.rightBracket) {
+ this._typeParameters = new NodeList<TypeParameter>(this);
+ this._typeParameters.addAll(typeParameters);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitTypeParameterList(this);
+
+ @override
+ Token get beginToken => leftBracket;
+
+ @override
+ Token get endToken => rightBracket;
+
+ /**
+ * Return the type parameters for the type.
+ *
+ * @return the type parameters for the type
+ */
+ NodeList<TypeParameter> get typeParameters => _typeParameters;
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _typeParameters.accept(visitor);
+ }
+}
+
+/**
+ * The abstract class `TypedLiteral` defines the behavior common to literals that have a type
+ * associated with them.
+ *
+ * <pre>
+ * listLiteral ::=
+ * [ListLiteral]
+ * | [MapLiteral]
+ * </pre>
+ */
+abstract class TypedLiteral extends Literal {
+ /**
+ * The token representing the 'const' keyword, or `null` if the literal is not a constant.
+ */
+ Token constKeyword;
+
+ /**
+ * The type argument associated with this literal, or `null` if no type arguments were
+ * declared.
+ */
+ TypeArgumentList _typeArguments;
+
+ /**
+ * Initialize a newly created typed literal.
+ *
+ * @param constKeyword the token representing the 'const' keyword
+ * @param typeArguments the type argument associated with this literal, or `null` if no type
+ * arguments were declared
+ */
+ TypedLiteral(this.constKeyword, TypeArgumentList typeArguments) {
+ this._typeArguments = becomeParentOf(typeArguments);
+ }
+
+ /**
+ * Return the type argument associated with this literal, or `null` if no type arguments
+ * were declared.
+ *
+ * @return the type argument associated with this literal
+ */
+ TypeArgumentList get typeArguments => _typeArguments;
+
+ /**
+ * Set the type argument associated with this literal to the given arguments.
+ *
+ * @param typeArguments the type argument associated with this literal
+ */
+ void set typeArguments(TypeArgumentList typeArguments) {
+ this._typeArguments = becomeParentOf(typeArguments);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_typeArguments, visitor);
+ }
+}
+
+/**
+ * Instances of the class `UnifyingAstVisitor` implement an AST visitor that will recursively
+ * visit all of the nodes in an AST structure (like instances of the class
+ * [RecursiveAstVisitor]). In addition, every node will also be visited by using a single
+ * unified [visitNode] method.
+ *
+ * Subclasses that override a visit method must either invoke the overridden visit method or
+ * explicitly invoke the more general [visitNode] method. Failure to do so will
+ * cause the children of the visited node to not be visited.
+ */
+class UnifyingAstVisitor<R> implements AstVisitor<R> {
+ @override
+ R visitAdjacentStrings(AdjacentStrings node) => visitNode(node);
+
+ @override
+ R visitAnnotation(Annotation node) => visitNode(node);
+
+ @override
+ R visitArgumentList(ArgumentList node) => visitNode(node);
+
+ @override
+ R visitAsExpression(AsExpression node) => visitNode(node);
+
+ @override
+ R visitAssertStatement(AssertStatement node) => visitNode(node);
+
+ @override
+ R visitAssignmentExpression(AssignmentExpression node) => visitNode(node);
+
+ @override
+ R visitAwaitExpression(AwaitExpression node) => visitNode(node);
+
+ @override
+ R visitBinaryExpression(BinaryExpression node) => visitNode(node);
+
+ @override
+ R visitBlock(Block node) => visitNode(node);
+
+ @override
+ R visitBlockFunctionBody(BlockFunctionBody node) => visitNode(node);
+
+ @override
+ R visitBooleanLiteral(BooleanLiteral node) => visitNode(node);
+
+ @override
+ R visitBreakStatement(BreakStatement node) => visitNode(node);
+
+ @override
+ R visitCascadeExpression(CascadeExpression node) => visitNode(node);
+
+ @override
+ R visitCatchClause(CatchClause node) => visitNode(node);
+
+ @override
+ R visitClassDeclaration(ClassDeclaration node) => visitNode(node);
+
+ @override
+ R visitClassTypeAlias(ClassTypeAlias node) => visitNode(node);
+
+ @override
+ R visitComment(Comment node) => visitNode(node);
+
+ @override
+ R visitCommentReference(CommentReference node) => visitNode(node);
+
+ @override
+ R visitCompilationUnit(CompilationUnit node) => visitNode(node);
+
+ @override
+ R visitConditionalExpression(ConditionalExpression node) => visitNode(node);
+
+ @override
+ R visitConstructorDeclaration(ConstructorDeclaration node) => visitNode(node);
+
+ @override
+ R visitConstructorFieldInitializer(ConstructorFieldInitializer node) => visitNode(node);
+
+ @override
+ R visitConstructorName(ConstructorName node) => visitNode(node);
+
+ @override
+ R visitContinueStatement(ContinueStatement node) => visitNode(node);
+
+ @override
+ R visitDeclaredIdentifier(DeclaredIdentifier node) => visitNode(node);
+
+ @override
+ R visitDefaultFormalParameter(DefaultFormalParameter node) => visitNode(node);
+
+ @override
+ R visitDoStatement(DoStatement node) => visitNode(node);
+
+ @override
+ R visitDoubleLiteral(DoubleLiteral node) => visitNode(node);
+
+ @override
+ R visitEmptyFunctionBody(EmptyFunctionBody node) => visitNode(node);
+
+ @override
+ R visitEmptyStatement(EmptyStatement node) => visitNode(node);
+
+ @override
+ R visitEnumConstantDeclaration(EnumConstantDeclaration node) => visitNode(node);
+
+ @override
+ R visitEnumDeclaration(EnumDeclaration node) => visitNode(node);
+
+ @override
+ R visitExportDirective(ExportDirective node) => visitNode(node);
+
+ @override
+ R visitExpressionFunctionBody(ExpressionFunctionBody node) => visitNode(node);
+
+ @override
+ R visitExpressionStatement(ExpressionStatement node) => visitNode(node);
+
+ @override
+ R visitExtendsClause(ExtendsClause node) => visitNode(node);
+
+ @override
+ R visitFieldDeclaration(FieldDeclaration node) => visitNode(node);
+
+ @override
+ R visitFieldFormalParameter(FieldFormalParameter node) => visitNode(node);
+
+ @override
+ R visitForEachStatement(ForEachStatement node) => visitNode(node);
+
+ @override
+ R visitFormalParameterList(FormalParameterList node) => visitNode(node);
+
+ @override
+ R visitForStatement(ForStatement node) => visitNode(node);
+
+ @override
+ R visitFunctionDeclaration(FunctionDeclaration node) => visitNode(node);
+
+ @override
+ R visitFunctionDeclarationStatement(FunctionDeclarationStatement node) => visitNode(node);
+
+ @override
+ R visitFunctionExpression(FunctionExpression node) => visitNode(node);
+
+ @override
+ R visitFunctionExpressionInvocation(FunctionExpressionInvocation node) => visitNode(node);
+
+ @override
+ R visitFunctionTypeAlias(FunctionTypeAlias node) => visitNode(node);
+
+ @override
+ R visitFunctionTypedFormalParameter(FunctionTypedFormalParameter node) => visitNode(node);
+
+ @override
+ R visitHideCombinator(HideCombinator node) => visitNode(node);
+
+ @override
+ R visitIfStatement(IfStatement node) => visitNode(node);
+
+ @override
+ R visitImplementsClause(ImplementsClause node) => visitNode(node);
+
+ @override
+ R visitImportDirective(ImportDirective node) => visitNode(node);
+
+ @override
+ R visitIndexExpression(IndexExpression node) => visitNode(node);
+
+ @override
+ R visitInstanceCreationExpression(InstanceCreationExpression node) => visitNode(node);
+
+ @override
+ R visitIntegerLiteral(IntegerLiteral node) => visitNode(node);
+
+ @override
+ R visitInterpolationExpression(InterpolationExpression node) => visitNode(node);
+
+ @override
+ R visitInterpolationString(InterpolationString node) => visitNode(node);
+
+ @override
+ R visitIsExpression(IsExpression node) => visitNode(node);
+
+ @override
+ R visitLabel(Label node) => visitNode(node);
+
+ @override
+ R visitLabeledStatement(LabeledStatement node) => visitNode(node);
+
+ @override
+ R visitLibraryDirective(LibraryDirective node) => visitNode(node);
+
+ @override
+ R visitLibraryIdentifier(LibraryIdentifier node) => visitNode(node);
+
+ @override
+ R visitListLiteral(ListLiteral node) => visitNode(node);
+
+ @override
+ R visitMapLiteral(MapLiteral node) => visitNode(node);
+
+ @override
+ R visitMapLiteralEntry(MapLiteralEntry node) => visitNode(node);
+
+ @override
+ R visitMethodDeclaration(MethodDeclaration node) => visitNode(node);
+
+ @override
+ R visitMethodInvocation(MethodInvocation node) => visitNode(node);
+
+ @override
+ R visitNamedExpression(NamedExpression node) => visitNode(node);
+
+ @override
+ R visitNativeClause(NativeClause node) => visitNode(node);
+
+ @override
+ R visitNativeFunctionBody(NativeFunctionBody node) => visitNode(node);
+
+ R visitNode(AstNode node) {
+ node.visitChildren(this);
+ return null;
+ }
+
+ @override
+ R visitNullLiteral(NullLiteral node) => visitNode(node);
+
+ @override
+ R visitParenthesizedExpression(ParenthesizedExpression node) => visitNode(node);
+
+ @override
+ R visitPartDirective(PartDirective node) => visitNode(node);
+
+ @override
+ R visitPartOfDirective(PartOfDirective node) => visitNode(node);
+
+ @override
+ R visitPostfixExpression(PostfixExpression node) => visitNode(node);
+
+ @override
+ R visitPrefixedIdentifier(PrefixedIdentifier node) => visitNode(node);
+
+ @override
+ R visitPrefixExpression(PrefixExpression node) => visitNode(node);
+
+ @override
+ R visitPropertyAccess(PropertyAccess node) => visitNode(node);
+
+ @override
+ R visitRedirectingConstructorInvocation(RedirectingConstructorInvocation node) => visitNode(node);
+
+ @override
+ R visitRethrowExpression(RethrowExpression node) => visitNode(node);
+
+ @override
+ R visitReturnStatement(ReturnStatement node) => visitNode(node);
+
+ @override
+ R visitScriptTag(ScriptTag scriptTag) => visitNode(scriptTag);
+
+ @override
+ R visitShowCombinator(ShowCombinator node) => visitNode(node);
+
+ @override
+ R visitSimpleFormalParameter(SimpleFormalParameter node) => visitNode(node);
+
+ @override
+ R visitSimpleIdentifier(SimpleIdentifier node) => visitNode(node);
+
+ @override
+ R visitSimpleStringLiteral(SimpleStringLiteral node) => visitNode(node);
+
+ @override
+ R visitStringInterpolation(StringInterpolation node) => visitNode(node);
+
+ @override
+ R visitSuperConstructorInvocation(SuperConstructorInvocation node) => visitNode(node);
+
+ @override
+ R visitSuperExpression(SuperExpression node) => visitNode(node);
+
+ @override
+ R visitSwitchCase(SwitchCase node) => visitNode(node);
+
+ @override
+ R visitSwitchDefault(SwitchDefault node) => visitNode(node);
+
+ @override
+ R visitSwitchStatement(SwitchStatement node) => visitNode(node);
+
+ @override
+ R visitSymbolLiteral(SymbolLiteral node) => visitNode(node);
+
+ @override
+ R visitThisExpression(ThisExpression node) => visitNode(node);
+
+ @override
+ R visitThrowExpression(ThrowExpression node) => visitNode(node);
+
+ @override
+ R visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node) => visitNode(node);
+
+ @override
+ R visitTryStatement(TryStatement node) => visitNode(node);
+
+ @override
+ R visitTypeArgumentList(TypeArgumentList node) => visitNode(node);
+
+ @override
+ R visitTypeName(TypeName node) => visitNode(node);
+
+ @override
+ R visitTypeParameter(TypeParameter node) => visitNode(node);
+
+ @override
+ R visitTypeParameterList(TypeParameterList node) => visitNode(node);
+
+ @override
+ R visitVariableDeclaration(VariableDeclaration node) => visitNode(node);
+
+ @override
+ R visitVariableDeclarationList(VariableDeclarationList node) => visitNode(node);
+
+ @override
+ R visitVariableDeclarationStatement(VariableDeclarationStatement node) => visitNode(node);
+
+ @override
+ R visitWhileStatement(WhileStatement node) => visitNode(node);
+
+ @override
+ R visitWithClause(WithClause node) => visitNode(node);
+
+ @override
+ R visitYieldStatement(YieldStatement node) => visitNode(node);
+}
+
+/**
+ * The abstract class `UriBasedDirective` defines the behavior common to nodes that represent
+ * a directive that references a URI.
+ *
+ * <pre>
+ * uriBasedDirective ::=
+ * [ExportDirective]
+ * | [ImportDirective]
+ * | [PartDirective]
+ * </pre>
+ */
+abstract class UriBasedDirective extends Directive {
+ /**
+ * The URI referenced by this directive.
+ */
+ StringLiteral _uri;
+
+ /**
+ * The prefix of a URI using the `dart-ext` scheme to reference a native code library.
+ */
+ static String _DART_EXT_SCHEME = "dart-ext:";
+
+ /**
+ * The content of the URI.
+ */
+ String uriContent;
+
+ /**
+ * The source to which the URI was resolved.
+ */
+ Source source;
+
+ /**
+ * Initialize a newly create URI-based directive.
+ *
+ * @param comment the documentation comment associated with this directive
+ * @param metadata the annotations associated with the directive
+ * @param uri the URI referenced by this directive
+ */
+ UriBasedDirective(Comment comment, List<Annotation> metadata, StringLiteral uri) : super(comment, metadata) {
+ this._uri = becomeParentOf(uri);
+ }
+
+ /**
+ * Return the URI referenced by this directive.
+ *
+ * @return the URI referenced by this directive
+ */
+ StringLiteral get uri => _uri;
+
+ /**
+ * Return the element associated with the URI of this directive, or `null` if the AST
+ * structure has not been resolved or if the URI could not be resolved. Examples of the latter
+ * case include a directive that contains an invalid URL or a URL that does not exist.
+ *
+ * @return the element associated with this directive
+ */
+ Element get uriElement;
+
+ /**
+ * Set the URI referenced by this directive to the given URI.
+ *
+ * @param uri the URI referenced by this directive
+ */
+ void set uri(StringLiteral uri) {
+ this._uri = becomeParentOf(uri);
+ }
+
+ /**
+ * Validate the given directive, but do not check for existence.
+ *
+ * @return a code indicating the problem if there is one, or `null` no problem
+ */
+ UriValidationCode validate() {
+ StringLiteral uriLiteral = uri;
+ if (uriLiteral is StringInterpolation) {
+ return UriValidationCode.URI_WITH_INTERPOLATION;
+ }
+ String uriContent = this.uriContent;
+ if (uriContent == null) {
+ return UriValidationCode.INVALID_URI;
+ }
+ if (this is ImportDirective && uriContent.startsWith(_DART_EXT_SCHEME)) {
+ return UriValidationCode.URI_WITH_DART_EXT_SCHEME;
+ }
+ try {
+ parseUriWithException(Uri.encodeFull(uriContent));
+ } on URISyntaxException catch (exception) {
+ return UriValidationCode.INVALID_URI;
+ }
+ return null;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_uri, visitor);
+ }
+}
+
+/**
+ * Validation codes returned by [UriBasedDirective#validate].
+ */
+class UriValidationCode extends Enum<UriValidationCode> {
+ static const UriValidationCode INVALID_URI = const UriValidationCode('INVALID_URI', 0);
+
+ static const UriValidationCode URI_WITH_INTERPOLATION = const UriValidationCode('URI_WITH_INTERPOLATION', 1);
+
+ static const UriValidationCode URI_WITH_DART_EXT_SCHEME = const UriValidationCode('URI_WITH_DART_EXT_SCHEME', 2);
+
+ static const List<UriValidationCode> values = const [
+ INVALID_URI,
+ URI_WITH_INTERPOLATION,
+ URI_WITH_DART_EXT_SCHEME];
+
+ const UriValidationCode(String name, int ordinal) : super(name, ordinal);
+}
+
+/**
+ * Instances of the class `VariableDeclaration` represent an identifier that has an initial
+ * value associated with it. Instances of this class are always children of the class
+ * [VariableDeclarationList].
+ *
+ * <pre>
+ * variableDeclaration ::=
+ * [SimpleIdentifier] ('=' [Expression])?
+ * </pre>
+ */
+class VariableDeclaration extends Declaration {
+ /**
+ * The name of the variable being declared.
+ */
+ SimpleIdentifier _name;
+
+ /**
+ * The equal sign separating the variable name from the initial value, or `null` if the
+ * initial value was not specified.
+ */
+ Token equals;
+
+ /**
+ * The expression used to compute the initial value for the variable, or `null` if the
+ * initial value was not specified.
+ */
+ Expression _initializer;
+
+ /**
+ * Initialize a newly created variable declaration.
+ *
+ * @param comment the documentation comment associated with this declaration
+ * @param metadata the annotations associated with this member
+ * @param name the name of the variable being declared
+ * @param equals the equal sign separating the variable name from the initial value
+ * @param initializer the expression used to compute the initial value for the variable
+ */
+ VariableDeclaration(Comment comment, List<Annotation> metadata, SimpleIdentifier name, this.equals, Expression initializer) : super(comment, metadata) {
+ this._name = becomeParentOf(name);
+ this._initializer = becomeParentOf(initializer);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitVariableDeclaration(this);
+
+ /**
+ * This overridden implementation of getDocumentationComment() looks in the grandparent node for
+ * dartdoc comments if no documentation is specifically available on the node.
+ */
+ @override
+ Comment get documentationComment {
+ Comment comment = super.documentationComment;
+ if (comment == null) {
+ if (parent != null && parent.parent != null) {
+ AstNode node = parent.parent;
+ if (node is AnnotatedNode) {
+ return node.documentationComment;
+ }
+ }
+ }
+ return comment;
+ }
+
+ @override
+ VariableElement get element => _name != null ? (_name.staticElement as VariableElement) : null;
+
+ @override
+ Token get endToken {
+ if (_initializer != null) {
+ return _initializer.endToken;
+ }
+ return _name.endToken;
+ }
+
+ /**
+ * Return the expression used to compute the initial value for the variable, or `null` if
+ * the initial value was not specified.
+ *
+ * @return the expression used to compute the initial value for the variable
+ */
+ Expression get initializer => _initializer;
+
+ /**
+ * Return the name of the variable being declared.
+ *
+ * @return the name of the variable being declared
+ */
+ SimpleIdentifier get name => _name;
+
+ /**
+ * Return `true` if this variable was declared with the 'const' modifier.
+ *
+ * @return `true` if this variable was declared with the 'const' modifier
+ */
+ bool get isConst {
+ AstNode parent = this.parent;
+ return parent is VariableDeclarationList && parent.isConst;
+ }
+
+ /**
+ * Return `true` if this variable was declared with the 'final' modifier. Variables that are
+ * declared with the 'const' modifier will return `false` even though they are implicitly
+ * final.
+ *
+ * @return `true` if this variable was declared with the 'final' modifier
+ */
+ bool get isFinal {
+ AstNode parent = this.parent;
+ return parent is VariableDeclarationList && parent.isFinal;
+ }
+
+ /**
+ * Set the expression used to compute the initial value for the variable to the given expression.
+ *
+ * @param initializer the expression used to compute the initial value for the variable
+ */
+ void set initializer(Expression initializer) {
+ this._initializer = becomeParentOf(initializer);
+ }
+
+ /**
+ * Set the name of the variable being declared to the given identifier.
+ *
+ * @param name the name of the variable being declared
+ */
+ void set name(SimpleIdentifier name) {
+ this._name = becomeParentOf(name);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_name, visitor);
+ safelyVisitChild(_initializer, visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata => _name.beginToken;
+}
+
+/**
+ * Instances of the class `VariableDeclarationList` represent the declaration of one or more
+ * variables of the same type.
+ *
+ * <pre>
+ * variableDeclarationList ::=
+ * finalConstVarOrType [VariableDeclaration] (',' [VariableDeclaration])*
+ *
+ * finalConstVarOrType ::=
+ * | 'final' [TypeName]?
+ * | 'const' [TypeName]?
+ * | 'var'
+ * | [TypeName]
+ * </pre>
+ */
+class VariableDeclarationList extends AnnotatedNode {
+ /**
+ * The token representing the 'final', 'const' or 'var' keyword, or `null` if no keyword was
+ * included.
+ */
+ Token keyword;
+
+ /**
+ * The type of the variables being declared, or `null` if no type was provided.
+ */
+ TypeName _type;
+
+ /**
+ * A list containing the individual variables being declared.
+ */
+ NodeList<VariableDeclaration> _variables;
+
+ /**
+ * Initialize a newly created variable declaration list.
+ *
+ * @param comment the documentation comment associated with this declaration list
+ * @param metadata the annotations associated with this declaration list
+ * @param keyword the token representing the 'final', 'const' or 'var' keyword
+ * @param type the type of the variables being declared
+ * @param variables a list containing the individual variables being declared
+ */
+ VariableDeclarationList(Comment comment, List<Annotation> metadata, this.keyword, TypeName type, List<VariableDeclaration> variables) : super(comment, metadata) {
+ this._variables = new NodeList<VariableDeclaration>(this);
+ this._type = becomeParentOf(type);
+ this._variables.addAll(variables);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitVariableDeclarationList(this);
+
+ @override
+ Token get endToken => _variables.endToken;
+
+ /**
+ * Return the type of the variables being declared, or `null` if no type was provided.
+ *
+ * @return the type of the variables being declared
+ */
+ TypeName get type => _type;
+
+ /**
+ * Return a list containing the individual variables being declared.
+ *
+ * @return a list containing the individual variables being declared
+ */
+ NodeList<VariableDeclaration> get variables => _variables;
+
+ /**
+ * Return `true` if the variables in this list were declared with the 'const' modifier.
+ *
+ * @return `true` if the variables in this list were declared with the 'const' modifier
+ */
+ bool get isConst => keyword is KeywordToken && (keyword as KeywordToken).keyword == Keyword.CONST;
+
+ /**
+ * Return `true` if the variables in this list were declared with the 'final' modifier.
+ * Variables that are declared with the 'const' modifier will return `false` even though
+ * they are implicitly final.
+ *
+ * @return `true` if the variables in this list were declared with the 'final' modifier
+ */
+ bool get isFinal => keyword is KeywordToken && (keyword as KeywordToken).keyword == Keyword.FINAL;
+
+ /**
+ * Set the type of the variables being declared to the given type name.
+ *
+ * @param typeName the type of the variables being declared
+ */
+ void set type(TypeName typeName) {
+ _type = becomeParentOf(typeName);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ super.visitChildren(visitor);
+ safelyVisitChild(_type, visitor);
+ _variables.accept(visitor);
+ }
+
+ @override
+ Token get firstTokenAfterCommentAndMetadata {
+ if (keyword != null) {
+ return keyword;
+ } else if (_type != null) {
+ return _type.beginToken;
+ }
+ return _variables.beginToken;
+ }
+}
+
+/**
+ * Instances of the class `VariableDeclarationStatement` represent a list of variables that
+ * are being declared in a context where a statement is required.
+ *
+ * <pre>
+ * variableDeclarationStatement ::=
+ * [VariableDeclarationList] ';'
+ * </pre>
+ */
+class VariableDeclarationStatement extends Statement {
+ /**
+ * The variables being declared.
+ */
+ VariableDeclarationList _variableList;
+
+ /**
+ * The semicolon terminating the statement.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created variable declaration statement.
+ *
+ * @param variableList the fields being declared
+ * @param semicolon the semicolon terminating the statement
+ */
+ VariableDeclarationStatement(VariableDeclarationList variableList, this.semicolon) {
+ this._variableList = becomeParentOf(variableList);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitVariableDeclarationStatement(this);
+
+ @override
+ Token get beginToken => _variableList.beginToken;
+
+ @override
+ Token get endToken => semicolon;
+
+ /**
+ * Return the variables being declared.
+ *
+ * @return the variables being declared
+ */
+ VariableDeclarationList get variables => _variableList;
+
+ /**
+ * Set the variables being declared to the given list of variables.
+ *
+ * @param variableList the variables being declared
+ */
+ void set variables(VariableDeclarationList variableList) {
+ this._variableList = becomeParentOf(variableList);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_variableList, visitor);
+ }
+}
+
+/**
+ * Instances of the class `WhileStatement` represent a while statement.
+ *
+ * <pre>
+ * whileStatement ::=
+ * 'while' '(' [Expression] ')' [Statement]
+ * </pre>
+ */
+class WhileStatement extends Statement {
+ /**
+ * The token representing the 'while' keyword.
+ */
+ Token keyword;
+
+ /**
+ * The left parenthesis.
+ */
+ Token leftParenthesis;
+
+ /**
+ * The expression used to determine whether to execute the body of the loop.
+ */
+ Expression _condition;
+
+ /**
+ * The right parenthesis.
+ */
+ Token rightParenthesis;
+
+ /**
+ * The body of the loop.
+ */
+ Statement _body;
+
+ /**
+ * Initialize a newly created while statement.
+ *
+ * @param keyword the token representing the 'while' keyword
+ * @param leftParenthesis the left parenthesis
+ * @param condition the expression used to determine whether to execute the body of the loop
+ * @param rightParenthesis the right parenthesis
+ * @param body the body of the loop
+ */
+ WhileStatement(this.keyword, this.leftParenthesis, Expression condition, this.rightParenthesis, Statement body) {
+ this._condition = becomeParentOf(condition);
+ this._body = becomeParentOf(body);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitWhileStatement(this);
+
+ @override
+ Token get beginToken => keyword;
+
+ /**
+ * Return the body of the loop.
+ *
+ * @return the body of the loop
+ */
+ Statement get body => _body;
+
+ /**
+ * Return the expression used to determine whether to execute the body of the loop.
+ *
+ * @return the expression used to determine whether to execute the body of the loop
+ */
+ Expression get condition => _condition;
+
+ @override
+ Token get endToken => _body.endToken;
+
+ /**
+ * Set the body of the loop to the given statement.
+ *
+ * @param statement the body of the loop
+ */
+ void set body(Statement statement) {
+ _body = becomeParentOf(statement);
+ }
+
+ /**
+ * Set the expression used to determine whether to execute the body of the loop to the given
+ * expression.
+ *
+ * @param expression the expression used to determine whether to execute the body of the loop
+ */
+ void set condition(Expression expression) {
+ _condition = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_condition, visitor);
+ safelyVisitChild(_body, visitor);
+ }
+}
+
+/**
+ * Instances of the class `WithClause` represent the with clause in a class declaration.
+ *
+ * <pre>
+ * withClause ::=
+ * 'with' [TypeName] (',' [TypeName])*
+ * </pre>
+ */
+class WithClause extends AstNode {
+ /**
+ * The token representing the 'with' keyword.
+ */
+ Token _withKeyword;
+
+ /**
+ * The names of the mixins that were specified.
+ */
+ NodeList<TypeName> _mixinTypes;
+
+ /**
+ * Initialize a newly created with clause.
+ *
+ * @param withKeyword the token representing the 'with' keyword
+ * @param mixinTypes the names of the mixins that were specified
+ */
+ WithClause(Token withKeyword, List<TypeName> mixinTypes) {
+ this._mixinTypes = new NodeList<TypeName>(this);
+ this._withKeyword = withKeyword;
+ this._mixinTypes.addAll(mixinTypes);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitWithClause(this);
+
+ @override
+ Token get beginToken => _withKeyword;
+
+ @override
+ Token get endToken => _mixinTypes.endToken;
+
+ /**
+ * Return the names of the mixins that were specified.
+ *
+ * @return the names of the mixins that were specified
+ */
+ NodeList<TypeName> get mixinTypes => _mixinTypes;
+
+ /**
+ * Return the token representing the 'with' keyword.
+ *
+ * @return the token representing the 'with' keyword
+ */
+ Token get withKeyword => _withKeyword;
+
+ /**
+ * Set the token representing the 'with' keyword to the given token.
+ *
+ * @param withKeyword the token representing the 'with' keyword
+ */
+ void set mixinKeyword(Token withKeyword) {
+ this._withKeyword = withKeyword;
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ _mixinTypes.accept(visitor);
+ }
+}
+
+/**
+ * Instances of the class `YieldStatement` implement a yield statement.
+ */
+class YieldStatement extends Statement {
+ /**
+ * The 'yield' keyword.
+ */
+ Token yieldKeyword;
+
+ /**
+ * The star optionally following the 'yield' keyword.
+ */
+ Token star;
+
+ /**
+ * The expression whose value will be yielded.
+ */
+ Expression _expression;
+
+ /**
+ * The semicolon following the expression.
+ */
+ Token semicolon;
+
+ /**
+ * Initialize a newly created yield expression.
+ *
+ * @param yieldKeyword the 'yield' keyword
+ * @param star the star following the 'yield' keyword
+ * @param expression the expression whose value will be yielded
+ * @param semicolon the semicolon following the expression
+ */
+ YieldStatement(this.yieldKeyword, this.star, Expression expression, this.semicolon) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ accept(AstVisitor visitor) => visitor.visitYieldStatement(this);
+
+ @override
+ Token get beginToken {
+ if (yieldKeyword != null) {
+ return yieldKeyword;
+ }
+ return _expression.beginToken;
+ }
+
+ @override
+ Token get endToken {
+ if (semicolon != null) {
+ return semicolon;
+ }
+ return _expression.endToken;
+ }
+
+ /**
+ * Return the expression whose value will be yielded.
+ *
+ * @return the expression whose value will be yielded
+ */
+ Expression get expression => _expression;
+
+ /**
+ * Set the expression whose value will be yielded to the given expression.
+ *
+ * @param expression the expression whose value will be yielded
+ */
+ void set expression(Expression expression) {
+ this._expression = becomeParentOf(expression);
+ }
+
+ @override
+ void visitChildren(AstVisitor visitor) {
+ safelyVisitChild(_expression, visitor);
+ }
+}
+/**
+ * Instances of the class {@code NodeList} represent a list of AST nodes that have a common parent.
+ */
+class NodeList<E extends AstNode> extends Object with ListMixin<E> {
+ /**
+ * Create an empty list with the given owner. This is a convenience method that allows the
+ * compiler to determine the correct value of the type argument [E] without needing to
+ * explicitly specify it.
+ *
+ * @param owner the node that is the parent of each of the elements in the list
+ * @return the list that was created
+ */
+ static NodeList create(AstNode owner) => new NodeList(owner);
+
+ /**
+ * The node that is the parent of each of the elements in the list.
+ */
+ AstNode owner;
+
+ /**
+ * The elements contained in the list.
+ */
+ List<E> _elements = <E> [];
+
+ /**
+ * Initialize a newly created list of nodes to be empty.
+ *
+ * @param owner the node that is the parent of each of the elements in the list
+ */
+ NodeList(this.owner);
+
+ /**
+ * Use the given visitor to visit each of the nodes in this list.
+ *
+ * @param visitor the visitor to be used to visit the elements of this list
+ */
+ accept(AstVisitor visitor) {
+ var length = _elements.length;
+ for (var i = 0; i < length; i++) {
+ _elements[i].accept(visitor);
+ }
+ }
+ void add(E node) {
+ insert(length, node);
+ }
+ void insert(int index, E node) {
+ int length = _elements.length;
+ if (index < 0 || index > length) {
+ throw new RangeError("Index: ${index}, Size: ${_elements.length}");
+ }
+ owner.becomeParentOf(node);
+ if (length == 0) {
+ _elements = <E> [node];
+ } else {
+ _elements.insert(index, node);
+ }
+ }
+ bool addAll(Iterable<E> nodes) {
+ if (nodes != null && !nodes.isEmpty) {
+ _elements.addAll(nodes);
+ for (E node in nodes) {
+ owner.becomeParentOf(node);
+ }
+ return true;
+ }
+ return false;
+ }
+ E operator[](int index) {
+ if (index < 0 || index >= _elements.length) {
+ throw new RangeError("Index: ${index}, Size: ${_elements.length}");
+ }
+ return _elements[index] as E;
+ }
+
+ /**
+ * Return the first token included in this node's source range.
+ *
+ * @return the first token included in this node's source range
+ */
+ Token get beginToken {
+ if (_elements.length == 0) {
+ return null;
+ }
+ return _elements[0].beginToken;
+ }
+
+ /**
+ * Return the last token included in this node list's source range.
+ *
+ * @return the last token included in this node list's source range
+ */
+ Token get endToken {
+ if (_elements.length == 0) {
+ return null;
+ }
+ return _elements[_elements.length - 1].endToken;
+ }
+ E removeAt(int index) {
+ if (index < 0 || index >= _elements.length) {
+ throw new RangeError("Index: ${index}, Size: ${_elements.length}");
+ }
+ E removedNode = _elements[index] as E;
+ int length = _elements.length;
+ if (length == 1) {
+ _elements = AstNode.EMPTY_ARRAY;
+ return removedNode;
+ }
+ _elements.removeAt(index);
+ return removedNode;
+ }
+ void operator[]=(int index, E node) {
+ if (index < 0 || index >= _elements.length) {
+ throw new RangeError("Index: ${index}, Size: ${_elements.length}");
+ }
+ owner.becomeParentOf(node);
+ _elements[index] = node;
+ }
+ void clear() {
+ _elements = <E> [];
+ }
+ int get length => _elements.length;
+ void set length(int value) {
+ throw new UnsupportedError("Cannot resize NodeList.");
+ }
+}

Powered by Google App Engine
This is Rietveld 408576698