Added ClosureMirror to dart:mirrors. Added Dart_ClosureFunction to the

lib/mirrors/mirrors.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("mirrors");
 
 // The dart:mirrors library provides reflective access for Dart program.
 //
 // For the purposes of the mirrors library, we adopt a naming
 // convention with respect to getters and setters.  Specifically, for
@@ skipping 139 matching lines @@
    * If the [InstanceMirror] reflects an instance it is meaningful to have a
    * local reference to, we provide access to the actual instance here.
    *
    * If you access [reflectee] when [hasReflectee] is false, an
    * exception is thrown.
    */
   final reflectee;
 }
 
 /**
+ * A [ClosureMirror] reflects a closure. Closures are special, because we do not
+ * wish to reflect the internals of a particular closure implementation. And
+ * yet, we need access to details of the closure internals - for example, its
+ * enclosing context and its source code.
+ */
+interface ClosureMirror extends InstanceMirror {
+
+  /**
+   * Return the source code for the closure, if available.
+   */ 
+  String source();
+  
+  /**
+   * Call the closure. The arguments given in the descriptor need to be
+   * ObjectMirrors or values. Asynchronous.
+   */  
+  Future<ObjectMirror> apply(List<Object> positionalArguments,
+                             [Map<String,Object> namedArguments]); 
+
+  /**
+   * Look up the value of name in the scope of the closure. The result is a
+   * mirror on that value. Asynchronous.
+   */
+  Future<ObjectMirror> findInContext(String name);
+
+  /**
+   * Return a mirror on the function of this closure.
+   */
+  MethodMirror function();
+}
+
+/**
  * A [TypeMirror] reflects a Dart language class, interface, typedef
  * or type variable.
  */
 interface TypeMirror extends Mirror {
   /**
    * The library in which this interface is declared.
    */
   final LibraryMirror library;
 }
 
@@ skipping 329 matching lines @@
 
 /**
  * A [MirrorException] is used to indicate errors within the mirrors
  * framework.
  */
 class MirrorException implements Exception {
   const MirrorException(String this._message);
   String toString() => "MirrorException: '$_message'";
   final String _message;
 }