Begin generating code for summary serialization/deserialization.

pkg/analyzer/tool/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 is not
  * executed directly; instead it is parsed and transformed into code that
  * implements the summary format.
  *
  * The code generation process introduces the following non-typical semantics:
@@ skipping 86 matching lines @@
   List<int> importDependencies;
 
   /**
    * For each reference in [UnlinkedLibrary.references], information about how
    * that reference is resolved.
    */
   List<PrelinkedReference> references;
 }
 
 /**
+ * Information about the resolution of an [UnlinkedReference].
+ */
+class PrelinkedReference {
+  /**
+   * Index into [UnlinkedLibrary.dependencies] indicating which imported library
+   * declares the entity being referred to.
+   */
+  int dependency;
+
+  /**
+   * The kind of the entity being referred to.
+   */
+  PrelinkedReferenceKind kind;
+}
+
+/**
  * Enum used to indicate the kind of entity referred to by a
  * [PrelinkedReference].
  */
 enum PrelinkedReferenceKind {
   /**
    * The entity is a class or enum.
    */
   classOrEnum,
 
   /**
    * The entity is a typedef.
    */
   typedef,
 
   /**
    * The entity is a variable or executable.
    */
   other,
 
   /**
    * The entity being referred to does not exist.
    */
   unresolved
 }
 
 /**
- * Information about the resolution of an [UnlinkedReference].
- */
-class PrelinkedReference {
-  /**
-   * Index into [UnlinkedLibrary.dependencies] indicating which imported library
-   * declares the entity being referred to.
-   */
-  int dependency;
-
-  /**
-   * The kind of the entity being referred to.
-   */
-  PrelinkedReferenceKind kind;
-}
-
-/**
  * Unlinked summary information about a class declaration.
  */
 class UnlinkedClass {
   /**
    * Name of the class.
    */
   String name;
 
   /**
    * Index into [UnlinkedLibrary.units] indicating which compilation unit the
@@ skipping 46 matching lines @@
 }
 
 /**
  * Unlinked summary information about a `show` or `hide` combinator in an
  * import or export declaration.
  */
 class UnlinkedCombinator {
   /**
    * List of names which are shown.  Empty if this is a `hide` combinator.
    */
-  List<String> shows;
+  List<UnlinkedCombinatorName> shows;
 
   /**
    * List of names which are hidden.  Empty if this is a `show` combinator.
    */
-  List<String> hides;
+  List<UnlinkedCombinatorName> hides;
 }
 
 /**
+ * Unlinked summary information about a single name in a `show` or `hide`
+ * combinator.
+ */
+class UnlinkedCombinatorName {
+  /**
+   * The name itself.
+   */
+  String name;
+}
+
+/**
  * Unlinked summary information about an enum declaration.
  */
 class UnlinkedEnum {
   /**
    * Name of the enum type.
    */
   String name;
 
   /**
    * Values listed in the enum declaration, in declaration order.
@@ skipping 13 matching lines @@
  * declaration.
  */
 class UnlinkedEnumValue {
   /**
    * Name of the enumerated value.
    */
   String name;
 }
 
 /**
- * Enum used to indicate the kind of an executable.
- */
-enum UnlinkedExecutableKind {
-  /**
-   * Executable is a function or method.
-   */
-  functionOrMethod,
-
-  /**
-   * Executable is a getter.
-   */
-  getter,
-
-  /**
-   * Executable is a setter.
-   */
-  setter,
-
-  /**
-   * Executable is a constructor.
-   */
-  constructor
-}
-
-/**
  * Unlinked summary information about a function, method, getter, or setter
  * declaration.
  */
 class UnlinkedExecutable {
   /**
    * Name of the executable.  For setters, this includes the trailing "=".  For
    * named constructors, this excludes the class name and excludes the ".".
    * For unnamed constructors, this is the empty string.
    */
   String name;
@@ skipping 51 matching lines @@
    */
   bool isConst;
 
   /**
    * Indicates whether the executable is declared using the `factory` keyword.
    */
   bool isFactory;
 }
 
 /**
+ * Enum used to indicate the kind of an executable.
+ */
+enum UnlinkedExecutableKind {
+  /**
+   * Executable is a function or method.
+   */
+  functionOrMethod,
+
+  /**
+   * Executable is a getter.
+   */
+  getter,
+
+  /**
+   * Executable is a setter.
+   */
+  setter,
+
+  /**
+   * Executable is a constructor.
+   */
+  constructor
+}
+
+/**
  * Unlinked summary information about an export declaration.
  */
 class UnlinkedExport {
   /**
    * URI used in the source code to reference the exported library.
    */
   String uri;
 
   /**
    * Combinators contained in this import declaration.
@@ skipping 98 matching lines @@
   List<UnlinkedVariable> variables;
 
   /**
    * Prefixes introduced by import declarations.  The first element in this
    * array is a pseudo-prefix used by references made with no prefix.
    */
   List<UnlinkedPrefix> prefixes;
 }
 
 /**
- * Enum used to indicate the kind of a parameter.
- */
-enum UnlinkedParamKind {
-  /**
-   * Parameter is required.
-   */
-  required,
-
-  /**
-   * Parameter is positional optional (enclosed in `[]`)
-   */
-  positional,
-
-  /**
-   * Parameter is named optional (enclosed in `{}`)
-   */
-  named
-}
-
-/**
  * Unlinked summary information about a function parameter.
  */
 class UnlinkedParam {
   /**
    * Name of the parameter.
    */
   String name;
 
   /**
    * If [isFunctionTyped] is `true`, the declared return type.  If
@@ skipping 19 matching lines @@
    */
   bool isFunctionTyped;
 
   /**
    * Indicates whether this is an initializing formal parameter (i.e. it is
    * declared using `this.` syntax).
    */
   bool isInitializingFormal;
 }
 
+/**
+ * Enum used to indicate the kind of a parameter.
+ */
+enum UnlinkedParamKind {
+  /**
+   * Parameter is required.
+   */
+  required,
+
+  /**
+   * Parameter is positional optional (enclosed in `[]`)
+   */
+  positional,
+
+  /**
+   * Parameter is named optional (enclosed in `{}`)
+   */
+  named
+}
+
 class UnlinkedPrefix {
   /**
    * The name of the prefix, or the empty string in the case of the
    * pseudo-prefix which represents "no prefix".
    */
   String name;
 }
 
 /**
  * Unlinked summary information about a name referred to in one library that
@@ skipping 143 matching lines @@
   /**
    * Indicates whether the variable is declared using the `final` keyword.
    */
   bool isFinal;
 
   /**
    * Indicates whether the variable is declared using the `const` keyword.
    */
   bool isConst;
 }