Add Element.nameOffset and LibraryElement.nameLength to summaries.

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 198 matching lines @@
 /**
  * Unlinked summary information about a class declaration.
  */
 class UnlinkedClass {
   /**
    * Name of the class.
    */
   String name;
 
   /**
+   * Offset of the class name relative to the beginning of the file.
+   */
+  @informative
+  int nameOffset;
+
+  /**
    * Type parameters of the class, if any.
    */
   List<UnlinkedTypeParam> 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).
    */
   UnlinkedTypeRef supertype;
@@ skipping 54 matching lines @@
 /**
  * Unlinked summary information about an enum declaration.
  */
 class UnlinkedEnum {
   /**
    * Name of the enum type.
    */
   String name;
 
   /**
+   * Offset of the enum name relative to the beginning of the file.
+   */
+  @informative
+  int nameOffset;
+
+  /**
    * Values listed in the enum declaration, in declaration order.
    */
   List<UnlinkedEnumValue> values;
 }
 
 /**
  * Unlinked summary information about a single enumerated value in an enum
  * declaration.
  */
 class UnlinkedEnumValue {
   /**
    * Name of the enumerated value.
    */
   String name;
+
+  /**
+   * Offset of the enum value name relative to the beginning of the file.
+   */
+  @informative
+  int nameOffset;
 }
 
 /**
  * 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;
 
   /**
+   * Offset of the executable name relative to the beginning of the file.  For
+   * named constructors, this excludes the class name and excludes the ".".
+   * For unnamed constructors, this is the offset of the class name (i.e. the
+   * offset of the second "C" in "class C { C(); }").
+   */
+  @informative
+  int nameOffset;
+
+  /**
    * Type parameters of the executable, if any.  Empty if support for generic
    * method syntax is disabled.
    */
   List<UnlinkedTypeParam> typeParameters;
 
   /**
    * Declared return type of the executable.  Absent if the return type is
    * `void` or the executable is a constructor.  Note that when strong mode is
    * enabled, the actual return type may be different due to type inference.
    */
@@ skipping 72 matching lines @@
    */
   constructor
 }
 
 /**
  * Unlinked summary information about an export declaration (stored outside
  * [UnlinkedPublicNamespace]).
  */
 class UnlinkedExportNonPublic {
   /**
+   * Offset of the "export" keyword.
+   */
+  @informative
+  int offset;
+
+  /**
    * Offset of the URI string (including quotes) relative to the beginning of
    * the file.
    */
   @informative
   int uriOffset;
 
   /**
    * End of the URI string (including quotes) relative to the beginning of the
    * file.
    */
@@ skipping 62 matching lines @@
    */
   @informative
   int uriOffset;
 
   /**
    * End of the URI string (including quotes) relative to the beginning of the
    * file.  If [isImplicit] is true, zero.
    */
   @informative
   int uriEnd;
+
+  /**
+   * Offset of the prefix name relative to the beginning of the file, or zero
+   * if there is no prefix.
+   */
+  @informative
+  int prefixOffset;
 }
 
 /**
  * Unlinked summary information about a function parameter.
  */
 class UnlinkedParam {
   /**
    * Name of the parameter.
    */
   String name;
 
   /**
+   * Offset of the parameter name relative to the beginning of the file.
+   */
+  @informative
+  int nameOffset;
+
+  /**
    * If [isFunctionTyped] is `true`, the declared return type.  If
    * [isFunctionTyped] is `false`, the declared type.  Absent if
    * [isFunctionTyped] is `true` and the declared return type is `void`.  Note
    * that when strong mode is enabled, the actual type may be different due to
    * type inference.
    */
   UnlinkedTypeRef type;
 
   /**
    * If [isFunctionTyped] is `true`, the parameters of the function type.
@@ skipping 141 matching lines @@
 /**
  * Unlinked summary information about a typedef declaration.
  */
 class UnlinkedTypedef {
   /**
    * Name of the typedef.
    */
   String name;
 
   /**
+   * Offset of the typedef name relative to the beginning of the file.
+   */
+  @informative
+  int nameOffset;
+
+  /**
    * Type parameters of the typedef, if any.
    */
   List<UnlinkedTypeParam> typeParameters;
 
   /**
    * Return type of the typedef.  Absent if the return type is `void`.
    */
   UnlinkedTypeRef returnType;
 
   /**
    * Parameters of the executable, if any.
    */
   List<UnlinkedParam> parameters;
 }
 
 /**
  * Unlinked summary information about a type parameter declaration.
  */
 class UnlinkedTypeParam {
   /**
    * Name of the type parameter.
    */
   String name;
 
   /**
+   * Offset of the type parameter name relative to the beginning of the file.
+   */
+  @informative
+  int nameOffset;
+
+  /**
    * Bound of the type parameter, if a bound is explicitly declared.  Otherwise
    * null.
    */
   UnlinkedTypeRef bound;
 }
 
 /**
  * Unlinked summary information about a reference to a type.
  */
 class UnlinkedTypeRef {
@@ skipping 41 matching lines @@
  * Unlinked summary information about a compilation unit ("part file").
  */
 @topLevel
 class UnlinkedUnit {
   /**
    * Name of the library (from a "library" declaration, if present).
    */
   String libraryName;
 
   /**
+   * Offset of the library name relative to the beginning of the file (or 0 if
+   * the library has no name).
+   */
+  @informative
+  int libraryNameOffset;
+
+  /**
+   * Length of the library name as it appears in the source code (or 0 if the
+   * library has no name).
+   */
+  @informative
+  int libraryNameLength;
+
+  /**
    * Unlinked public namespace of this compilation unit.
    */
   UnlinkedPublicNamespace publicNamespace;
 
   /**
    * Top level and prefixed names referred to by this compilation unit.  The
    * zeroth element of this array is always populated and always represents a
    * reference to the pseudo-type "dynamic".
    */
   List<UnlinkedReference> references;
@@ skipping 44 matching lines @@
  * Unlinked summary information about a top level variable, local variable, or
  * a field.
  */
 class UnlinkedVariable {
   /**
    * Name of the variable.
    */
   String name;
 
   /**
+   * Offset of the variable name relative to the beginning of the file.
+   */
+  @informative
+  int nameOffset;
+
+  /**
    * Declared type of the variable.  Note that when strong mode is enabled, the
    * actual type of the variable may be different due to type inference.
    */
   UnlinkedTypeRef type;
 
   /**
    * Indicates whether the variable is declared using the `static` keyword.
    *
    * Note that for top level variables, this flag is false, since they are not
    * declared using the `static` keyword (even though they are considered
    * static for semantic purposes).
    */
   bool isStatic;
 
   /**
    * Indicates whether the variable is declared using the `final` keyword.
    */
   bool isFinal;
 
   /**
    * Indicates whether the variable is declared using the `const` keyword.
    */
   bool isConst;
 
   /**
    * Indicates whether this variable lacks an explicit type declaration.
    */
   bool hasImplicitType;
 }