new handleInvalidTopLevelDeclaration event in fasta parser

pkg/front_end/lib/src/fasta/parser/listener.dart

Index: pkg/front_end/lib/src/fasta/parser/listener.dart
diff --git a/pkg/front_end/lib/src/fasta/parser/listener.dart b/pkg/front_end/lib/src/fasta/parser/listener.dart
index 9690f9c09dff5009c77caf5985b0007246beeb2c..cf593707ba667256f50549309facba3f41fc13df 100644
--- a/pkg/front_end/lib/src/fasta/parser/listener.dart
+++ b/pkg/front_end/lib/src/fasta/parser/listener.dart
@@ -712,6 +712,17 @@ class Listener {
     logEvent("TopLevelDeclaration");
   }
 
+  /// Called by the [Parser] when it recovers from an invalid top level
+  /// declaration, where [endToken] is the last token in the declaration
+  /// This is called after the begin/end metadata star events,
+  /// and is followed by [endTopLevelDeclaration].

[ahe, 2017/08/16 13:22:45]

You got this documentation stuff pretty well under control. Nice!

[danrubel, 2017/08/16 13:34:29]

:-)

+  ///
+  /// Substructures:
+  /// - metadata
+  void handleInvalidTopLevelDeclaration(Token endToken) {
+    logEvent("InvalidTopLevelDeclaration");
+  }
+
   /// Marks the beginning of a top level field or method declaration.
   /// Doesn't have a corresponding end event.
   /// See [endTopLevelFields] and [endTopLevelMethod].