Index: pkg/code_transformers/lib/src/resolver.dart |
diff --git a/pkg/code_transformers/lib/src/resolver.dart b/pkg/code_transformers/lib/src/resolver.dart |
new file mode 100644 |
index 0000000000000000000000000000000000000000..80e385fd4e39db879a03e49a6b13f858735c41af |
--- /dev/null |
+++ b/pkg/code_transformers/lib/src/resolver.dart |
@@ -0,0 +1,81 @@ |
+// Copyright (c) 2014, 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. |
+ |
+library code_transformer.src.resolver; |
+ |
+import 'package:analyzer/src/generated/element.dart'; |
+import 'package:barback/barback.dart'; |
+import 'package:source_maps/refactor.dart'; |
+import 'package:source_maps/span.dart' show SourceFile, Span; |
+ |
+ |
+/// Class for working with a barback based resolved AST. |
+abstract class Resolver { |
+ /// The Dart entry point file where parsing begins. |
+ AssetId get entryPoint; |
+ |
+ /// Gets the resolved Dart library for the entry asset, or null if |
+ /// the AST has not been resolved. |
+ /// |
+ /// If the AST has not been resolved then this normally means that the |
+ /// transformer hosting this needs to be in an earlier phase. |
+ LibraryElement get entryLibrary; |
+ |
+ /// Gets all libraries accessible from the entry point, recursively. |
+ /// |
+ /// This includes all Dart SDK libraries as well. |
+ Iterable<LibraryElement> get libraries; |
+ |
+ /// Finds the first library identified by [libraryName], or null if no |
+ /// library can be found. |
+ LibraryElement getLibraryByName(String libraryName); |
+ |
+ /// Finds the first library identified by [libraryName], or null if no |
+ /// library can be found. |
+ /// |
+ /// [uri] must be an absolute URI of the form |
+ /// `[dart:|package:]path/file.dart`. |
+ LibraryElement getLibraryByUri(Uri uri); |
+ |
+ /// Resolves a fully-qualified type name (library_name.ClassName). |
+ /// |
+ /// This will resolve the first instance of [typeName], because of potential |
+ /// library name conflicts the name is not guaranteed to be unique. |
+ ClassElement getType(String typeName); |
+ |
+ /// Resolves a fully-qualified top-level library variable |
+ /// (library_name.variableName). |
+ /// |
+ /// This will resolve the first instance of [variableName], because of |
+ /// potential library name conflicts the name is not guaranteed to be unique. |
+ Element getLibraryVariable(String variableName); |
+ |
+ /// Resolves a fully-qualified top-level library function |
+ /// (library_name.functionName). |
+ /// |
+ /// This will resolve the first instance of [functionName], because of |
+ /// potential library name conflicts the name is not guaranteed to be unique. |
+ Element getLibraryFunction(String functionName); |
+ |
+ /// Gets an URI appropriate for importing the specified library. |
+ /// |
+ /// Returns null if the library cannot be imported via an absolute URI or |
+ /// from [from] (if provided). |
+ Uri getImportUri(LibraryElement lib, {AssetId from}); |
+ |
+ /// Get the asset ID of the file containing the asset. |
+ AssetId getSourceAssetId(Element element); |
+ |
+ /// Get the source span where the specified element was defined or null if |
+ /// the element came from the Dart SDK. |
+ Span getSourceSpan(Element element); |
+ |
+ /// Creates a text edit transaction for the given element if it is able |
+ /// to be edited, returns null otherwise. |
+ /// |
+ /// The transaction contains the entire text of the source file where the |
+ /// element originated. If the element was from a library part then the |
+ /// source file is the part file rather than the library. |
+ TextEditTransaction createTextEditTransaction(Element element); |
+} |