Add the ability to deprecate Flatbuffer fields.

pkg/analyzer/tool/summary/idl_model.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 contains a set of concrete classes representing an in-memory
  * semantic model of the IDL used to code generate summary serialization and
  * deserialization code.
  */
 library analyzer.tool.summary.idl_model;
 
 /**
  * Information about a single class defined in the IDL.
  */
 class ClassDeclaration extends Declaration {
   /**
-   * Fields defined in the class.
+   * All fields defined in the class, including deprecated ones.
    */
-  final List<FieldDeclaration> fields = <FieldDeclaration>[];
+  final List<FieldDeclaration> allFields = <FieldDeclaration>[];
 
   /**
    * Indicates whether the class has the `topLevel` annotation.
    */
   final bool isTopLevel;
 
   /**
    * If [isTopLevel] is `true` and a file identifier was specified for this
    * class, the file identifier string.  Otheswise `null`.
    */
   final String fileIdentifier;
 
   ClassDeclaration(
       String documentation, String name, this.isTopLevel, this.fileIdentifier)
       : super(documentation, name);
+
+  /**
+   * Get the non-deprecated fields defined in the class.
+   */
+  Iterable<FieldDeclaration> get fields =>
+      allFields.where((FieldDeclaration field) => !field.isDeprecated);
 }
 
 /**
  * Information about a declaration in the IDL.
  */
 class Declaration {
   /**
    * The optional documentation, may be `null`.
    */
   final String documentation;
@@ skipping 34 matching lines @@
   /**
    * The file of the field.
    */
   final FieldType type;
 
   /**
    * The id of the field.
    */
   final int id;
 
-  FieldDeclaration(String documentation, String name, this.type, this.id)
+  /**
+   * Indicates whether the field is deprecated.
+   */
+  final bool isDeprecated;
+
+  FieldDeclaration(
+      String documentation, String name, this.type, this.id, this.isDeprecated)
       : super(documentation, name);
 }
 
 /**
  * Information about the type of a class field defined in the IDL.
  */
 class FieldType {
   /**
    * Type of the field (e.g. 'int').
    */
@@ skipping 15 matching lines @@
   /**
    * Classes defined in the IDL.
    */
   final Map<String, ClassDeclaration> classes = <String, ClassDeclaration>{};
 
   /**
    * Enums defined in the IDL.
    */
   final Map<String, EnumDeclaration> enums = <String, EnumDeclaration>{};
 }