Support Package Resolution Configuration files.

pkg/compiler/lib/compiler.dart

 // Copyright (c) 2012, 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 compiler;
 
 import 'dart:async';
+import 'package:package_config/packages.dart';
 import 'src/apiimpl.dart';
 
 // Unless explicitly allowed, passing [:null:] for any argument to the
 // methods of library will result in an Error being thrown.
 
 /**
  * Returns a future that completes to the source corresponding to [uri].
  * If an exception occurs, the future completes with this exception.
  *
  * The source can be represented either as a [:List<int>:] of UTF-8 bytes or as
@@ skipping 33 matching lines @@
  */
 typedef EventSink<String> CompilerOutputProvider(String name,
                                                  String extension);
 
 /**
  * Invoked by the compiler to report diagnostics. If [uri] is
  * [:null:], so are [begin] and [end]. No other arguments may be
  * [:null:]. If [uri] is not [:null:], neither are [begin] and
  * [end]. [uri] indicates the compilation unit from where the
  * diagnostic originates. [begin] and [end] are zero-based character
- * offsets from the beginning of the compilaton unit. [message] is the
+ * offsets from the beginning of the compilation unit. [message] is the
  * diagnostic message, and [kind] indicates indicates what kind of
  * diagnostic it is.
  */
 typedef void DiagnosticHandler(Uri uri, int begin, int end,
                                String message, Diagnostic kind);
 
+/**
+ * Provides a package lookup mechanism in the case that no package root or
+ * package resolution configuration file are explicitly specified.
+ */
+typedef Future<Packages> PackagesDiscoveryProvider(Uri uri);
+
 /// Information resulting from the compilation.
 class CompilationResult {
   /// `true` if the compilation succeeded, that is, compilation didn't fail due
   /// to compile-time errors and/or internal errors.
   final bool isSuccess;
 
   /// The compiler object used for the compilation.
   ///
   /// Note: The type of [compiler] is implementation dependent and may vary.
   /// Use only for debugging and testing.
@@ skipping 18 matching lines @@
  * of libraries.
  */
 Future<CompilationResult> compile(
     Uri script,
     Uri libraryRoot,
     Uri packageRoot,
     CompilerInputProvider inputProvider,
     DiagnosticHandler handler,
     [List<String> options = const [],
      CompilerOutputProvider outputProvider,
-     Map<String, dynamic> environment = const {}]) {
+     Map<String, dynamic> environment = const {},
+     Uri packageConfig,
+     PackagesDiscoveryProvider packagesDiscoveryProvider]) {
   if (!libraryRoot.path.endsWith("/")) {
     throw new ArgumentError("libraryRoot must end with a /");
   }
   if (packageRoot != null && !packageRoot.path.endsWith("/")) {
     throw new ArgumentError("packageRoot must end with a /");
   }
   // TODO(ahe): Consider completing the future with an exception if
   // code is null.
   Compiler compiler = new Compiler(inputProvider,
                                    outputProvider,
                                    handler,
                                    libraryRoot,
                                    packageRoot,
                                    options,
-                                   environment);
+                                   environment,
+                                   packageConfig,
+                                   packagesDiscoveryProvider);
   return compiler.run(script).then((bool success) {
     return new CompilationResult(compiler, isSuccess: success);
   });
 }
 
 /**
  * Kind of diagnostics that the compiler can report.
  */
 class Diagnostic {
   /**
@@ skipping 57 matching lines @@
   final String name;
 
   /**
    * This constructor is not private to support user-defined
    * diagnostic kinds.
    */
   const Diagnostic(this.ordinal, this.name);
 
   String toString() => name;
 }