Elements. Remove V1 Element.

Change-Id: Icf4941f3ff2765ea0d5fd7728604c77607327595
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/423447
Commit-Queue: Konstantin Shcheglov <[email protected]>
Reviewed-by: Brian Wilkerson <[email protected]>

Author: scheglov

pkg/analyzer/api.txt

@@ -2981,56 +2981,6 @@ package:analyzer/dart/element/element.dart:
   DirectiveUriWithUnit (class extends DirectiveUriWithSource):
     new (constructor: DirectiveUriWithUnit Function())
     libraryFragment (getter: LibraryFragment, experimental)
-  Element (class extends Object implements AnalysisTarget, deprecated):
-    new (constructor: Element Function())
-    context (getter: AnalysisContext@2)
-    declaration (getter: Element?, deprecated)
-    displayName (getter: String)
-    documentationComment (getter: String?)
-    enclosingElement3 (getter: Element?, deprecated)
-    hasAlwaysThrows (getter: bool)
-    hasDeprecated (getter: bool)
-    hasDoNotStore (getter: bool)
-    hasDoNotSubmit (getter: bool)
-    hasFactory (getter: bool)
-    hasImmutable (getter: bool)
-    hasInternal (getter: bool)
-    hasIsTest (getter: bool)
-    hasIsTestGroup (getter: bool)
-    hasJS (getter: bool)
-    hasLiteral (getter: bool)
-    hasMustBeConst (getter: bool)
-    hasMustBeOverridden (getter: bool)
-    hasMustCallSuper (getter: bool)
-    hasNonVirtual (getter: bool)
-    hasOptionalTypeArgs (getter: bool)
-    hasOverride (getter: bool)
-    hasProtected (getter: bool)
-    hasRedeclare (getter: bool)
-    hasReopen (getter: bool)
-    hasRequired (getter: bool)
-    hasSealed (getter: bool)
-    hasUseResult (getter: bool)
-    hasVisibleForOverriding (getter: bool)
-    hasVisibleForTemplate (getter: bool)
-    hasVisibleForTesting (getter: bool)
-    hasVisibleOutsideTemplate (getter: bool)
-    id (getter: int)
-    isPrivate (getter: bool)
-    isPublic (getter: bool)
-    isSynthetic (getter: bool)
-    kind (getter: ElementKind)
-    location (getter: ElementLocation?)
-    metadata (getter: List<ElementAnnotation>)
-    name (getter: String?)
-    nameLength (getter: int)
-    nameOffset (getter: int)
-    nonSynthetic (getter: Element, deprecated)
-    session (getter: AnalysisSession?)
-    sinceSdkVersion (getter: Version?)
-    source (getter: Source?)
-    getDisplayString (method: String Function({bool multiline, bool withNullability}))
-    getExtendedDisplayName (method: String Function(String?))
   ElementAnnotation (class extends Object implements ConstantEvaluationTarget):
     new (constructor: ElementAnnotation Function())
     constantEvaluationErrors (getter: List<AnalysisError>?)

pkg/analyzer/lib/dart/element/element.dart

@@ -36,18 +36,11 @@
 /// represented by an element.
 library;
 
-import 'package:analyzer/dart/analysis/session.dart';
 import 'package:analyzer/dart/constant/value.dart';
 import 'package:analyzer/dart/element/element2.dart';
-import 'package:analyzer/dart/element/nullability_suffix.dart';
 import 'package:analyzer/error/error.dart';
 import 'package:analyzer/source/source.dart';
 import 'package:analyzer/src/dart/constant/evaluation.dart';
-import 'package:analyzer/src/dart/element/element.dart'
-    show elementModelDeprecationMsg;
-import 'package:analyzer/src/generated/engine.dart' show AnalysisContext;
-// ignore: deprecated_member_use_from_same_package
-import 'package:analyzer/src/task/api/model.dart' show AnalysisTarget;
 import 'package:meta/meta.dart';
 import 'package:pub_semver/pub_semver.dart';
 
@@ -98,263 +91,6 @@ abstract class DirectiveUriWithUnit extends DirectiveUriWithSource {
   LibraryFragment get libraryFragment;
 }
 
-/// The base class for all of the elements in the element model. Generally
-/// speaking, the element model is a semantic model of the program that
-/// represents things that are declared with a name and hence can be referenced
-/// elsewhere in the code.
-///
-/// There are two exceptions to the general case. First, there are elements in
-/// the element model that are created for the convenience of various kinds of
-/// analysis but that do not have any corresponding declaration within the
-/// source code. Such elements are marked as being <i>synthetic</i>. Examples of
-/// synthetic elements include
-/// * default constructors in classes that do not define any explicit
-///   constructors,
-/// * getters and setters that are induced by explicit field declarations,
-/// * fields that are induced by explicit declarations of getters and setters,
-///   and
-/// * functions representing the initialization expression for a variable.
-///
-/// Second, there are elements in the element model that do not have a name.
-/// These correspond to unnamed functions and exist in order to more accurately
-/// represent the semantic structure of the program.
-///
-/// Clients may not extend, implement or mix-in this class.
-@Deprecated(elementModelDeprecationMsg)
-abstract class Element implements AnalysisTarget {
-  /// The analysis context in which this element is defined.
-  AnalysisContext get context;
-
-  /// The declaration of this element.
-  ///
-  /// If the element is a view on an element, e.g. a method from an interface
-  /// type, with substituted type parameters, return the corresponding element
-  /// from the class, without any substitutions. If this element is already a
-  /// declaration (or a synthetic element, e.g. a synthetic property accessor),
-  /// return itself.
-  @Deprecated(elementModelDeprecationMsg)
-  Element? get declaration;
-
-  /// The display name of this element, possibly the empty string if the
-  /// element does not have a name.
-  ///
-  /// In most cases the name and the display name are the same. Differences
-  /// though are cases such as setters where the name of some setter `set f(x)`
-  /// is `f=`, instead of `f`.
-  String get displayName;
-
-  /// The content of the documentation comment (including delimiters) for this
-  /// element, or `null` if this element does not or cannot have documentation.
-  String? get documentationComment;
-
-  /// The element that either physically or logically encloses this element.
-  ///
-  /// For [LibraryElement] returns `null`, because libraries are the top-level
-  /// elements in the model.
-  ///
-  /// For [CompilationUnitElement] returns the [CompilationUnitElement] that
-  /// uses `part` directive to include this element, or `null` if this element
-  /// is the defining unit of the library.
-  @Deprecated('Use Element2.enclosingElement2 instead or '
-      'Fragment.enclosingFragment instead')
-  Element? get enclosingElement3;
-
-  /// Whether the element has an annotation of the form `@alwaysThrows`.
-  bool get hasAlwaysThrows;
-
-  /// Whether the element has an annotation of the form `@deprecated`
-  /// or `@Deprecated('..')`.
-  bool get hasDeprecated;
-
-  /// Whether the element has an annotation of the form `@doNotStore`.
-  bool get hasDoNotStore;
-
-  /// Whether the element has an annotation of the form `@doNotSubmit`.
-  bool get hasDoNotSubmit;
-
-  /// Whether the element has an annotation of the form `@factory`.
-  bool get hasFactory;
-
-  /// Whether the element has an annotation of the form `@immutable`.
-  bool get hasImmutable;
-
-  /// Whether the element has an annotation of the form `@internal`.
-  bool get hasInternal;
-
-  /// Whether the element has an annotation of the form `@isTest`.
-  bool get hasIsTest;
-
-  /// Whether the element has an annotation of the form `@isTestGroup`.
-  bool get hasIsTestGroup;
-
-  /// Whether the element has an annotation of the form `@JS(..)`.
-  bool get hasJS;
-
-  /// Whether the element has an annotation of the form `@literal`.
-  bool get hasLiteral;
-
-  /// Whether the element has an annotation of the form `@mustBeConst`.
-  bool get hasMustBeConst;
-
-  /// Whether the element has an annotation of the form `@mustBeOverridden`.
-  bool get hasMustBeOverridden;
-
-  /// Whether the element has an annotation of the form `@mustCallSuper`.
-  bool get hasMustCallSuper;
-
-  /// Whether the element has an annotation of the form `@nonVirtual`.
-  bool get hasNonVirtual;
-
-  /// Whether the element has an annotation of the form `@optionalTypeArgs`.
-  bool get hasOptionalTypeArgs;
-
-  /// Whether the element has an annotation of the form `@override`.
-  bool get hasOverride;
-
-  /// Whether the element has an annotation of the form `@protected`.
-  bool get hasProtected;
-
-  /// Whether the element has an annotation of the form `@redeclare`.
-  bool get hasRedeclare;
-
-  /// Whether the element has an annotation of the form `@reopen`.
-  bool get hasReopen;
-
-  /// Whether the element has an annotation of the form `@required`.
-  bool get hasRequired;
-
-  /// Whether the element has an annotation of the form `@sealed`.
-  bool get hasSealed;
-
-  /// Whether the element has an annotation of the form `@useResult`
-  /// or `@UseResult('..')`.
-  bool get hasUseResult;
-
-  /// Whether the element has an annotation of the form `@visibleForOverriding`.
-  bool get hasVisibleForOverriding;
-
-  /// Whether the element has an annotation of the form `@visibleForTemplate`.
-  bool get hasVisibleForTemplate;
-
-  /// Whether the element has an annotation of the form `@visibleForTesting`.
-  bool get hasVisibleForTesting;
-
-  /// Whether the element has an annotation of the form
-  /// `@visibleOutsideTemplate`.
-  bool get hasVisibleOutsideTemplate;
-
-  /// The unique integer identifier of this element.
-  int get id;
-
-  /// Whether the element is private.
-  ///
-  /// Private elements are visible only within the library in which they are
-  /// declared.
-  bool get isPrivate;
-
-  /// Whether the element is public.
-  ///
-  /// Public elements are visible within any library that imports the library
-  /// in which they are declared.
-  bool get isPublic;
-
-  /// Whether the element is synthetic.
-  ///
-  /// A synthetic element is an element that is not represented in the source
-  /// code explicitly, but is implied by the source code, such as the default
-  /// constructor for a class that does not explicitly define any constructors.
-  bool get isSynthetic;
-
-  /// The kind of element that this is.
-  ElementKind get kind;
-
-  /// The location of this element in the element model.
-  ///
-  /// The object can be used to locate this element at a later time.
-  ElementLocation? get location;
-
-  /// All of the metadata associated with this element.
-  ///
-  /// The array will be empty if the element does not have any metadata or if
-  /// the library containing this element has not yet been resolved.
-  List<ElementAnnotation> get metadata;
-
-  /// The name of this element, or `null` if this element does not have a name.
-  String? get name;
-
-  /// The length of the name of this element in the file that contains the
-  /// declaration of this element, or `0` if this element does not have a name.
-  int get nameLength;
-
-  /// The offset of the name of this element in the file that contains the
-  /// declaration of this element, or `-1` if this element is synthetic, does
-  /// not have a name, or otherwise does not have an offset.
-  int get nameOffset;
-
-  /// The non-synthetic element that caused this element to be created.
-  ///
-  /// If this element is not synthetic, then the element itself is returned.
-  ///
-  /// If this element is synthetic, then the corresponding non-synthetic
-  /// element is returned. For example, for a synthetic getter of a
-  /// non-synthetic field the field is returned; for a synthetic constructor
-  /// the enclosing class is returned.
-  @Deprecated(elementModelDeprecationMsg)
-  Element get nonSynthetic;
-
-  /// The analysis session in which this element is defined.
-  AnalysisSession? get session;
-
-  /// The version where this SDK API was added.
-  ///
-  /// A `@Since()` annotation can be applied to a library declaration,
-  /// any public declaration in a library, or in a class, or to an optional
-  /// parameter, etc.
-  ///
-  /// The returned version is "effective", so that if a library is annotated
-  /// then all elements of the library inherit it; or if a class is annotated
-  /// then all members and constructors of the class inherit it.
-  ///
-  /// If multiple `@Since()` annotations apply to the same element, the latest
-  /// version takes precedence.
-  ///
-  /// Returns `null` if the element is not declared in SDK, or does not have
-  /// a `@Since()` annotation applicable to it.
-  Version? get sinceSdkVersion;
-
-  @override
-  Source? get source;
-
-  /// Returns the presentation of this element as it should appear when
-  /// presented to users.
-  ///
-  /// If [withNullability] is `true`, then [NullabilitySuffix.question] and
-  /// [NullabilitySuffix.star] in types will be represented as `?` and `*`.
-  /// [NullabilitySuffix.none] does not have any explicit presentation.
-  ///
-  /// If [withNullability] is `false`, nullability suffixes will not be
-  /// included into the presentation.
-  ///
-  /// If [multiline] is `true`, the string may be wrapped over multiple lines
-  /// with newlines to improve formatting. For example function signatures may
-  /// be formatted as if they had trailing commas.
-  ///
-  /// Clients should not depend on the content of the returned value as it will
-  /// be changed if doing so would improve the UX.
-  String getDisplayString({
-    @Deprecated('Only non-nullable by default mode is supported')
-    bool withNullability = true,
-    bool multiline = false,
-  });
-
-  /// Returns a display name for the given element that includes the path to the
-  /// compilation unit in which the type is defined. If [shortName] is `null`
-  /// then [displayName] will be used as the name of this element. Otherwise
-  /// the provided name will be used.
-  // TODO(brianwilkerson): Make the parameter optional.
-  String getExtendedDisplayName(String? shortName);
-}
-
 /// A single annotation associated with an element.
 ///
 /// Clients may not extend, implement or mix-in this class.