Add support for the new function-type syntax.

pkg/compiler/lib/src/parser/parser.dart

 // Copyright (c) 2012, 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.
 
 library dart2js.parser;
 
 import '../common.dart';
 import '../tokens/keyword.dart' show Keyword;
 import '../tokens/precedence.dart' show PrecedenceInfo;
 import '../tokens/precedence_constants.dart'
@@ skipping 344 matching lines @@
       period = token;
       token = parseIdentifier(token.next);
     }
     token = parseArgumentsOpt(token);
     listener.endMetadata(atToken, period, token);
     return token;
   }
 
   Token parseTypedef(Token token) {
     Token typedefKeyword = token;
-    listener.beginFunctionTypeAlias(token);
-    token = parseReturnTypeOpt(token.next);
-    token = parseIdentifier(token);
-    token = parseTypeVariablesOpt(token);
-    token = parseFormalParameters(token);
-    listener.endFunctionTypeAlias(typedefKeyword, token);
+    listener.beginTypedef(token);
+    Token equals;
+    if (optional('=', peekAfterType(token.next))) {
+      token = parseIdentifier(token.next);
+      token = parseTypeVariablesOpt(token);
+      equals = expect('=', token);
+      token = parseType(equals);
+    } else {
+      token = parseReturnTypeOpt(token.next);
+      token = parseIdentifier(token);
+      token = parseTypeVariablesOpt(token);
+      token = parseFormalParameters(token);
+    }
+    listener.endTypedef(typedefKeyword, equals, token);
     return expect(';', token);
   }
 
   Token parseMixinApplication(Token token) {
     listener.beginMixinApplication(token);
     token = parseType(token);
     token = expect('with', token);
     token = parseTypeList(token);
     listener.endMixinApplication();
     return token;
   }
 
-  Token parseReturnTypeOpt(Token token) {
+  Token parseReturnTypeOpt(Token token, {bool allowFunctionType: true}) {
     if (identical(token.stringValue, 'void')) {
       listener.handleVoidKeyword(token);
       return token.next;
+    } else if (!allowFunctionType && isGeneralizedFunctionType(token)) {
+      listener.handleNoType(token);
+      return token;
     } else {
       return parseTypeOpt(token);
     }
   }
 
   Token parseFormalParametersOpt(Token token) {
     if (optional('(', token)) {
       return parseFormalParameters(token);
     } else {
       listener.handleNoFormalParameters(token);
       return token;
     }
   }
 
-  Token parseFormalParameters(Token token) {
+  /// Parses the formal parameter list of a function.
+  ///
+  /// If [inFunctionType] is true, then the names may be omitted (except for
+  /// named arguments). If it is false, then the types may be omitted.
+  Token parseFormalParameters(Token token, {bool inFunctionType: false}) {
     Token begin = token;
     listener.beginFormalParameters(begin);
     expect('(', token);
     int parameterCount = 0;
     do {
       token = token.next;
       if (optional(')', token)) {
         break;
       }
       ++parameterCount;
       String value = token.stringValue;
       if (identical(value, '[')) {
-        token = parseOptionalFormalParameters(token, false);
+        token = parseOptionalFormalParameters(
+            token, false, inFunctionType: inFunctionType);
         break;
       } else if (identical(value, '{')) {
-        token = parseOptionalFormalParameters(token, true);
+        token = parseOptionalFormalParameters(
+            token, true, inFunctionType: inFunctionType);
         break;
       }
-      token = parseFormalParameter(token, FormalParameterType.REQUIRED);
+      token = parseFormalParameter(token, FormalParameterType.REQUIRED,
+          inFunctionType: inFunctionType);
     } while (optional(',', token));
     listener.endFormalParameters(parameterCount, begin, token);
     return expect(')', token);
   }
 
-  Token parseFormalParameter(Token token, FormalParameterType type) {
+  Token parseFormalParameter(Token token, FormalParameterType type,
+      {bool inFunctionType}) {
     token = parseMetadataStar(token, forParameter: true);
     listener.beginFormalParameter(token);
     token = parseModifiers(token);
-    // TODO(ahe): Validate that there are formal parameters if void.
-    token = parseReturnTypeOpt(token);
+    bool isNamedParameter = type == FormalParameterType.NAMED;
+
     Token thisKeyword = null;
-    if (optional('this', token)) {
-      thisKeyword = token;
-      // TODO(ahe): Validate field initializers are only used in
-      // constructors, and not for function-typed arguments.
-      token = expect('.', token.next);
+    if (inFunctionType && isNamedParameter) {
+      token = parseTypeOpt(token);
+      token = parseIdentifier(token);
+    } else if (inFunctionType) {
+      token = parseType(token);
+      if (token.isIdentifier()) {
+        token = parseIdentifier(token);
+      } else {
+        listener.handleNoName(token);
+      }
+    } else {
+      // TODO(ahe): Validate that there are formal parameters if void.
+      token = parseReturnTypeOpt(token);
+      if (optional('this', token)) {
+        thisKeyword = token;
+        // TODO(ahe): Validate field initializers are only used in
+        // constructors, and not for function-typed arguments.
+        token = expect('.', token.next);
+      }
+      token = parseIdentifier(token);
     }
-    token = parseIdentifier(token);
-    if (optional('(', token)) {
-      listener.handleNoTypeVariables(token);
-      token = parseFormalParameters(token);
-      listener.handleFunctionTypedFormalParameter(token);
-    } else if (optional('<', token)) {
-      token = parseTypeVariablesOpt(token);
-      token = parseFormalParameters(token);
-      listener.handleFunctionTypedFormalParameter(token);
+
+    // Generalized function types don't allow inline function types.
+    // The following isn't allowed:
+    //    int Function(int bar(String x)).

[Siggi Cherem (dart-lang), 2016/12/29 22:46:57]

should we report an error instead in that case?

(e.g. check that the next token is not '(' or '<' when inFunctionType is true)?

[floitsch, 2016/12/30 14:55:47]

In some sense that's what's happening. Just automatically by the parser.
Example output:

Error: 'void' is a reserved word and can't be used here.
Try using a different name.
typedef F = Function(void f());
                     ^^^^
Error: Expected ')' before this.
typedef F = Function(f());
                      ^

+    if (!inFunctionType) {
+      if (optional('(', token)) {
+        listener.handleNoTypeVariables(token);
+        token = parseFormalParameters(token);
+        listener.handleFunctionTypedFormalParameter(token);
+      } else if (optional('<', token)) {
+        token = parseTypeVariablesOpt(token);
+        token = parseFormalParameters(token);
+        listener.handleFunctionTypedFormalParameter(token);
+      }
     }
     String value = token.stringValue;
     if ((identical('=', value)) || (identical(':', value))) {
       // TODO(ahe): Validate that these are only used for optional parameters.
       Token equal = token;
       token = parseExpression(token.next);
       listener.handleValuedFormalParameter(equal, token);
       if (type.isRequired) {
         listener.reportError(
             equal, MessageKind.REQUIRED_PARAMETER_WITH_DEFAULT);
       } else if (type.isPositional && identical(':', value)) {
         listener.reportError(
             equal, MessageKind.POSITIONAL_PARAMETER_WITH_EQUALS);
       }
     }
     listener.endFormalParameter(thisKeyword);
     return token;
   }
 
-  Token parseOptionalFormalParameters(Token token, bool isNamed) {
+  Token parseOptionalFormalParameters(Token token, bool isNamed,
+      {bool inFunctionType}) {
     Token begin = token;
     listener.beginOptionalFormalParameters(begin);
     assert((isNamed && optional('{', token)) || optional('[', token));
     int parameterCount = 0;
     do {
       token = token.next;
       if (isNamed && optional('}', token)) {
         break;
       } else if (!isNamed && optional(']', token)) {
         break;
       }
       var type =
           isNamed ? FormalParameterType.NAMED : FormalParameterType.POSITIONAL;
-      token = parseFormalParameter(token, type);
+      token =
+          parseFormalParameter(token, type, inFunctionType: inFunctionType);
       ++parameterCount;
     } while (optional(',', token));
     if (parameterCount == 0) {
       listener.reportError(
           token,
           isNamed
               ? MessageKind.EMPTY_NAMED_PARAMETER_LIST
               : MessageKind.EMPTY_OPTIONAL_PARAMETER_LIST);
     }
     listener.endOptionalFormalParameters(parameterCount, begin, token);
     if (isNamed) {
       return expect('}', token);
     } else {
       return expect(']', token);
     }
   }
 
   Token parseTypeOpt(Token token) {
+    if (isGeneralizedFunctionType(token)) {
+      // Function type without return type.
+      return parseType(token);
+    }
     Token peek = peekAfterIfType(token);
     if (peek != null && (peek.isIdentifier() || optional('this', peek))) {
       return parseType(token);
     }
     listener.handleNoType(token);
     return token;
   }
 
   bool isValidTypeReference(Token token) {
     final kind = token.kind;
@@ skipping 283 matching lines @@
         value2 == stringValue ||
         value3 == stringValue ||
         value4 == stringValue;
   }
 
   bool notEofOrValue(String value, Token token) {
     return !identical(token.kind, EOF_TOKEN) &&
         !identical(value, token.stringValue);
   }
 
+  bool isGeneralizedFunctionType(Token token) {
+    // TODO(floitsch): don't use string comparison, but the keyword-state
+    // table is currently not set up to deal with upper-case characters.
+    return (optional('<', token.next) || optional('(', token.next)) &&
+        token.value == "Function";
+  }
+
   Token parseType(Token token) {
     Token begin = token;
-    if (isValidTypeReference(token)) {
-      token = parseIdentifier(token);
-      token = parseQualifiedRestOpt(token);
+    if (isGeneralizedFunctionType(token)) {
+      // A function type without return type.
+      // Push the non-existing return type first. The loop below will
+      // generate the full type.
+      listener.handleNoType(token);
     } else {
-      token = listener.expectedType(token);
+      if (isValidTypeReference(token)) {
+        if (isGeneralizedFunctionType(token)) {

[Siggi Cherem (dart-lang), 2016/12/29 22:46:58]

is this branch ever executed?

[floitsch, 2016/12/30 14:55:47]

Nope. that was old code that I didn't clean up.
Good catch. thanks.
done.

+          // A function type without return type.
+          return parseFunctionType(token);
+        } else {
+          token = parseIdentifier(token);
+          token = parseQualifiedRestOpt(token);
+        }
+      } else {
+        token = listener.expectedType(token);
+      }
+      token = parseTypeArgumentsOpt(token);
+      listener.endType(begin, token);
     }
-    token = parseTypeArgumentsOpt(token);
-    listener.endType(begin, token);
+
+    // While we see a `Function(` treat the pushed type as return type.
+    // For example: `int Function() Function(int) Function(String x)`.
+    while (isGeneralizedFunctionType(token)) {
+      token = parseFunctionType(token);
+    }
     return token;
   }
 
+  /// Parses a generalized function type.
+  ///
+  /// The return type must already be pushed.
+  Token parseFunctionType(Token token) {
+    // TODO(floitsch): don't use string comparison, but the keyword-state
+    // table is currently not set up to deal with upper-case characters.
+    if (token.value != "Function") {
+      return listener.expected("Function", token);
+    }
+    Token functionToken = token;
+    token = token.next;
+    token = parseTypeVariablesOpt(token);
+    token = parseFormalParameters(token, inFunctionType: true);
+    listener.endFunctionType(functionToken, token);
+    return token;
+  }
+
   Token parseTypeArgumentsOpt(Token token) {
     return parseStuff(
         token,
         (t) => listener.beginTypeArguments(t),
         (t) => parseType(t),
         (c, bt, et) => listener.endTypeArguments(c, bt, et),
         (t) => listener.handleNoTypeArguments(t));
   }
 
   Token parseTypeVariablesOpt(Token token) {
@@ skipping 313 matching lines @@
         identifiers = identifiers.prepend(token);
         return identifiers;
       } else if (value == '=' || value == ';' || value == ',') {
         // A field or abstract getter.
         identifiers = identifiers.prepend(token);
         return identifiers;
       } else if (isGetter) {
         hasName = true;
       }
       identifiers = identifiers.prepend(token);
-      if (isValidTypeReference(token)) {
-        // type ...
-        if (optional('.', token.next)) {
-          // type '.' ...
-          if (token.next.next.isIdentifier()) {
-            // type '.' identifier
-            token = token.next.next;
+
+      if (!isGeneralizedFunctionType(token)) {
+        // Read a potential return type.
+        if (isValidTypeReference(token)) {
+          // type ...
+          if (optional('.', token.next)) {
+            // type '.' ...
+            if (token.next.next.isIdentifier()) {
+              // type '.' identifier
+              token = token.next.next;
+            }
+          }
+          if (optional('<', token.next)) {
+            if (token.next is BeginGroupToken) {
+              BeginGroupToken beginGroup = token.next;
+              if (beginGroup.endGroup == null) {
+                listener.unmatched(beginGroup);
+              }
+              token = beginGroup.endGroup;
+            }
           }
         }
-        if (optional('<', token.next)) {
-          if (token.next is BeginGroupToken) {
-            BeginGroupToken beginGroup = token.next;
+        token = token.next;
+      }
+      while (isGeneralizedFunctionType(token)) {
+        token = token.next;
+        if (optional('<', token)) {
+          if (token is BeginGroupToken) {
+            BeginGroupToken beginGroup = token;
             if (beginGroup.endGroup == null) {
               listener.unmatched(beginGroup);
             }
-            token = beginGroup.endGroup;
+            token = beginGroup.endGroup.next;
           }
         }
+        if (!optional('(', token)) {
+          if (optional(';', token)) {
+            listener.recoverableError(token, "expected '('");
+          }
+          token = listener.unexpected(token);
+        }
+        if (token is BeginGroupToken) {
+          BeginGroupToken beginGroup = token;
+          if (beginGroup.endGroup == null) {
+            listener.unmatched(beginGroup);
+          }
+          token = beginGroup.endGroup.next;
+        }
       }
-      token = token.next;
     }
     return const Link<Token>();
   }
 
   Token parseVariableInitializerOpt(Token token) {
     if (optional('=', token)) {
       Token assignment = token;
       listener.beginInitializer(token);
       token = parseExpression(token.next);
       listener.endInitializer(assignment);
@@ skipping 82 matching lines @@
     return token;
   }
 
   /**
    * Returns the first token after the type starting at [token].
    * This method assumes that [token] is an identifier (or void).
    * Use [peekAfterIfType] if [token] isn't known to be an identifier.
    */
   Token peekAfterType(Token token) {
     // We are looking at "identifier ...".
-    Token peek = token.next;
-    if (identical(peek.kind, PERIOD_TOKEN)) {
-      if (peek.next.isIdentifier()) {
-        // Look past a library prefix.
-        peek = peek.next.next;
+    Token peek = token;
+    if (!isGeneralizedFunctionType(token)) {
+      peek = token.next;

[Siggi Cherem (dart-lang), 2016/12/29 22:46:58]

suggestion: consider introducing 2 functions to make it simpler to follow:
 - peekAfterNominalType (for what used to be peekAfterType)
 - peekAfterFunctionType (for the new code)

[floitsch, 2016/12/30 14:55:48]

Done.

+      if (identical(peek.kind, PERIOD_TOKEN)) {
+        if (peek.next.isIdentifier()) {
+          // Look past a library prefix.
+          peek = peek.next.next;
+        }
+      }
+      // We are looking at "qualified ...".
+      if (identical(peek.kind, LT_TOKEN)) {
+        // Possibly generic type.
+        // We are looking at "qualified '<'".
+        BeginGroupToken beginGroupToken = peek;
+        Token gtToken = beginGroupToken.endGroup;
+        if (gtToken != null) {
+          // We are looking at "qualified '<' ... '>' ...".
+          peek = gtToken.next;
+        }
       }
     }
-    // We are looking at "qualified ...".
-    if (identical(peek.kind, LT_TOKEN)) {
-      // Possibly generic type.
-      // We are looking at "qualified '<'".
-      BeginGroupToken beginGroupToken = peek;
-      Token gtToken = beginGroupToken.endGroup;
-      if (gtToken != null) {
-        // We are looking at "qualified '<' ... '>' ...".
-        return gtToken.next;
+
+    // We might have just skipped over the return value of the function type.
+    // Check again, if we are now at a function type position.
+    if (isGeneralizedFunctionType(peek)) {

[Siggi Cherem (dart-lang), 2016/12/29 22:46:58]

do we need a loop here, like you had in parseType?

If so, then let's definitely add the helper functions. I imagine the code would
look more like:

Token peekAfterType(Token token) {
  Token peek = !isGeneralizedFunctionType(token)
      ? peekAfterNominalType(token)
      : token;

  // We are looking at "type Function ..."
  while (isGeneralizedFunctionType(peek)) {
    peek = peekAfterFunctionType(peek);
  }

  return peek;

[floitsch, 2016/12/30 14:55:48]

I'm not sure the loop is necessary, but I don't want to prove it isn't. It's
definitely cleaner and less error-prone doing the loop.
Code looks better now.
thanks.
done.

+      peek = peek.next;  // Skip over the Function.

[Siggi Cherem (dart-lang), 2016/12/29 22:46:57]

nit: reword "the Function" to "the `Function` token"

[floitsch, 2016/12/30 14:55:47]

Done.

+      if (identical(peek.kind, LT_TOKEN)) {

[Siggi Cherem (dart-lang), 2016/12/29 22:46:58]

consider adding here and below comments describing what we are looking at
(similar to those above):

  // We are looking at "type Function '<' ... '>' ..."
  // We are looking at "type Function type-args '(' ... ')' ..."

[floitsch, 2016/12/30 14:55:48]

Done.

+        BeginGroupToken beginGroupToken = peek;
+        Token closeToken = beginGroupToken.endGroup;
+        if (closeToken != null) {
+          peek = closeToken.next;
+        }
+      }
+
+      // There must be an open paren to be valid, but we are not checking here.
+      if (identical(peek.kind, OPEN_PAREN_TOKEN)) {
+        BeginGroupToken beginGroupToken = peek;
+        Token closeToken = beginGroupToken.endGroup;
+        if (closeToken != null) {
+          peek = closeToken.next;
+        }
       }
     }
     return peek;
   }
 
   /**
    * If [token] is the start of a type, returns the token after that type.
    * If [token] is not the start of a type, null is returned.
    */
   Token peekAfterIfType(Token token) {
@@ skipping 524 matching lines @@
 
   Token parseExpressionStatementOrDeclaration(Token token) {
     assert(token.isIdentifier() || identical(token.stringValue, 'void'));
     Token identifier = peekIdentifierAfterType(token);
     if (identifier != null) {
       assert(identifier.isIdentifier());
       Token afterId = identifier.next;
       int afterIdKind = afterId.kind;
       if (identical(afterIdKind, EQ_TOKEN) ||
           identical(afterIdKind, SEMICOLON_TOKEN) ||
-          identical(afterIdKind, COMMA_TOKEN)) {
+          identical(afterIdKind, COMMA_TOKEN) ||
+          isGeneralizedFunctionType(identifier)) {

[Siggi Cherem (dart-lang), 2016/12/29 22:46:58]

why do we need this case? could this be handled by the changes to peekAfterType?

[floitsch, 2016/12/30 14:55:48]

Yes. thanks for figuring this out.
I should have paid more attention when I ran into this issue in my tests.

         // We are looking at "type identifier" followed by '=', ';', ','.
         return parseVariablesDeclaration(token);
       } else if (identical(afterIdKind, OPEN_PAREN_TOKEN)) {
         // We are looking at "type identifier '('".
         BeginGroupToken beginParen = afterId;
         Token endParen = beginParen.endGroup;
         // TODO(eernst): Check for NPE as described in issue 26252.
         Token afterParens = endParen.next;
         if (optional('{', afterParens) ||
             optional('=>', afterParens) ||
@@ skipping 1127 matching lines @@
     }
     listener.handleContinueStatement(hasTarget, continueKeyword, token);
     return expectSemicolon(token);
   }
 
   Token parseEmptyStatement(Token token) {
     listener.handleEmptyStatement(token);
     return expectSemicolon(token);
   }
 }