Add summary support for annotations.

pkg/analyzer/lib/src/summary/idl.dart

 // Copyright (c) 2015, 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 file is an "idl" style description of the summary format.  It
  * contains abstract classes which declare the interface for reading data from
  * summaries.  It is parsed and transformed into code that implements the
  * summary format.
  *
@@ skipping 422 matching lines @@
   int get nameOffset;
 
   /**
    * Documentation comment for the class, or `null` if there is no
    * documentation comment.
    */
   @informative
   UnlinkedDocumentationComment get documentationComment;
 
   /**
+   * Annotations for this class.
+   */
+  List<UnlinkedConst> get annotations;
+
+  /**
    * Type parameters of the class, if any.
    */
   List<UnlinkedTypeParam> get typeParameters;
 
   /**
    * Supertype of the class, or `null` if either (a) the class doesn't
    * explicitly declare a supertype (and hence has supertype `Object`), or (b)
    * the class *is* `Object` (and hence has no supertype).
    */
   EntityRef get supertype;
@@ skipping 419 matching lines @@
   int get nameOffset;
 
   /**
    * Documentation comment for the enum, or `null` if there is no documentation
    * comment.
    */
   @informative
   UnlinkedDocumentationComment get documentationComment;
 
   /**
+   * Annotations for this enum.
+   */
+  List<UnlinkedConst> get annotations;
+
+  /**
    * Values listed in the enum declaration, in declaration order.
    */
   List<UnlinkedEnumValue> get values;
 }
 
 /**
  * Unlinked summary information about a single enumerated value in an enum
  * declaration.
  */
 abstract class UnlinkedEnumValue extends base.SummaryClass {
@@ skipping 38 matching lines @@
   int get nameOffset;
 
   /**
    * Documentation comment for the executable, or `null` if there is no
    * documentation comment.
    */
   @informative
   UnlinkedDocumentationComment get documentationComment;
 
   /**
+   * Annotations for this executable.
+   */
+  List<UnlinkedConst> get annotations;
+
+  /**
    * Type parameters of the executable, if any.  Empty if support for generic
    * method syntax is disabled.
    */
   List<UnlinkedTypeParam> get typeParameters;
 
   /**
    * Declared return type of the executable.  Absent if the executable is a
    * constructor or the return type is implicit.
    */
   EntityRef get returnType;
@@ skipping 92 matching lines @@
    */
   @informative
   int get uriOffset;
 
   /**
    * End of the URI string (including quotes) relative to the beginning of the
    * file.
    */
   @informative
   int get uriEnd;
+
+  /**
+   * Annotations for this export directive.
+   */
+  List<UnlinkedConst> get annotations;
 }
 
 /**
  * Unlinked summary information about an export declaration (stored inside
  * [UnlinkedPublicNamespace]).
  */
 abstract class UnlinkedExportPublic extends base.SummaryClass {
   /**
    * URI used in the source code to reference the exported library.
    */
@@ skipping 15 matching lines @@
   String get uri;
 
   /**
    * If [isImplicit] is false, offset of the "import" keyword.  If [isImplicit]
    * is true, zero.
    */
   @informative
   int get offset;
 
   /**
+   * Annotations for this import declaration.
+   */
+  List<UnlinkedConst> get annotations;
+
+  /**
    * Index into [UnlinkedUnit.references] of the prefix declared by this
    * import declaration, or zero if this import declaration declares no prefix.
    *
    * Note that multiple imports can declare the same prefix.
    */
   int get prefixReference;
 
   /**
    * Combinators contained in this import declaration.
    */
@@ skipping 40 matching lines @@
    */
   String get name;
 
   /**
    * Offset of the parameter name relative to the beginning of the file.
    */
   @informative
   int get nameOffset;
 
   /**
+   * Annotations for this parameter.
+   */
+  List<UnlinkedConst> get annotations;
+
+  /**
    * If [isFunctionTyped] is `true`, the declared return type.  If
    * [isFunctionTyped] is `false`, the declared type.  Absent if the type is
    * implicit.
    */
   EntityRef get type;
 
   /**
    * If [isFunctionTyped] is `true`, the parameters of the function type.
    */
   List<UnlinkedParam> get parameters;
@@ skipping 64 matching lines @@
    */
   @informative
   int get uriOffset;
 
   /**
    * End of the URI string (including quotes) relative to the beginning of the
    * file.
    */
   @informative
   int get uriEnd;
+
+  /**
+   * Annotations for this part declaration.
+   */
+  List<UnlinkedConst> get annotations;
 }
 
 /**
  * Unlinked summary information about a specific name contributed by a
  * compilation unit to a library's public namespace.
  *
  * TODO(paulberry): some of this information is redundant with information
  * elsewhere in the summary.  Consider reducing the redundancy to reduce
  * summary size.
  */
@@ skipping 89 matching lines @@
   int get nameOffset;
 
   /**
    * Documentation comment for the typedef, or `null` if there is no
    * documentation comment.
    */
   @informative
   UnlinkedDocumentationComment get documentationComment;
 
   /**
+   * Annotations for this typedef.
+   */
+  List<UnlinkedConst> get annotations;
+
+  /**
    * Type parameters of the typedef, if any.
    */
   List<UnlinkedTypeParam> get typeParameters;
 
   /**
    * Return type of the typedef.
    */
   EntityRef get returnType;
 
   /**
@@ skipping 11 matching lines @@
    */
   String get name;
 
   /**
    * Offset of the type parameter name relative to the beginning of the file.
    */
   @informative
   int get nameOffset;
 
   /**
+   * Annotations for this type parameter.
+   */
+  List<UnlinkedConst> get annotations;
+
+  /**
    * Bound of the type parameter, if a bound is explicitly declared.  Otherwise
    * null.
    */
   EntityRef get bound;
 }
 
 /**
  * Unlinked summary information about a compilation unit ("part file").
  */
 @topLevel
@@ skipping 21 matching lines @@
   int get libraryNameLength;
 
   /**
    * Documentation comment for the library, or `null` if there is no
    * documentation comment.
    */
   @informative
   UnlinkedDocumentationComment get libraryDocumentationComment;
 
   /**
+   * Annotations for the library declaration, or the empty list if there is no
+   * library declaration.
+   */
+  List<UnlinkedConst> get libraryAnnotations;
+
+  /**
    * Unlinked public namespace of this compilation unit.
    */
   UnlinkedPublicNamespace get publicNamespace;
 
   /**
    * Top level and prefixed names referred to by this compilation unit.  The
    * zeroth element of this array is always populated and is used to represent
    * the absence of a reference in places where a reference is optional (for
    * example [UnlinkedReference.prefixReference or
    * UnlinkedImport.prefixReference]).
@@ skipping 59 matching lines @@
   int get nameOffset;
 
   /**
    * Documentation comment for the variable, or `null` if there is no
    * documentation comment.
    */
   @informative
   UnlinkedDocumentationComment get documentationComment;
 
   /**
+   * Annotations for this variable.
+   */
+  List<UnlinkedConst> get annotations;
+
+  /**
    * Declared type of the variable.  Absent if the type is implicit.
    */
   EntityRef get type;
 
   /**
    * If [isConst] is true, and the variable has an initializer, the constant
    * expression in the initializer.
    */
   UnlinkedConst get constExpr;
 
@@ skipping 27 matching lines @@
   int get propagatedTypeSlot;
 
   /**
    * If this variable is inferable, nonzero slot id identifying which entry in
    * [LinkedLibrary.types] contains the inferred type for this variable.  If
    * there is no matching entry in [LinkedLibrary.types], then no type was
    * inferred for this variable, so its static type is `dynamic`.
    */
   int get inferredTypeSlot;
 }