Support evaluation of expressions in context of a stack frame

runtime/include/dart_debugger_api.h

 // Copyright (c) 2011, 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.
 
 #ifndef INCLUDE_DART_DEBUGGER_API_H_
 #define INCLUDE_DART_DEBUGGER_API_H_
 
 #include "include/dart_api.h"
 
 typedef struct _Dart_Breakpoint* Dart_Breakpoint;
@@ skipping 487 matching lines @@
  *
  * \return A handle to an array containing variable names and
  * corresponding values. Variable names are at array offsets 2*n,
  * values at offset 2*n+1.
  */
 DART_EXPORT Dart_Handle Dart_GetGlobalVariables(intptr_t library_id);
 
 
 /**
  * Execute the expression given in string \expr in the context
+ * of stack frame \activation_frame.
+ */
+DART_EXPORT Dart_Handle Dart_ActivationFrameEvaluate(
+                            Dart_ActivationFrame activation_frame,
+                            Dart_Handle expr_in);
+
+
+/**
+ * Execute the expression given in string \expr in the context
  * of \target.
  *
  * Requires there to be a current isolate.
  *
  * The expression is evaluated in the context of \target.
  * If \target is a Dart object, the expression is evaluated as if
  * it were an instance method of the class of the object.
  * If \target is a Class, the expression is evaluated as if it
  * were a static method of that class.
- * TODO(hausner): add 'library' execution context.
+ * If \target is a Library, the expression is evaluated as if it
+ * were a top-level function in that library.
  * 
  * \return A handle to the computed value, or an error object if
  * the compilation of the expression fails, or if the evaluation throws
  * an error.
  */
 DART_EXPORT Dart_Handle Dart_EvaluateExpr(Dart_Handle target,
                                           Dart_Handle expr);
 
 
 /**
@@ skipping 182 matching lines @@
 
 
 /**
  * Returns the isolate id for an isolate.
  *
  * \return The Dart_IsolateId value corresponding to the isolate.
  */
 DART_EXPORT Dart_IsolateId Dart_GetIsolateId(Dart_Isolate isolate);
 
 #endif  // INCLUDE_DART_DEBUGGER_API_H_