Re-enable and add new HTML support

pkg/analyzer/lib/src/generated/engine.dart

Index: pkg/analyzer/lib/src/generated/engine.dart
diff --git a/pkg/analyzer/lib/src/generated/engine.dart b/pkg/analyzer/lib/src/generated/engine.dart
index c827d3cbba3713754ef3bc9d2e1569ac3139f0df..b2279241af8e748f423504683fc97a8f472111c3 100644
--- a/pkg/analyzer/lib/src/generated/engine.dart
+++ b/pkg/analyzer/lib/src/generated/engine.dart
@@ -23,6 +23,7 @@ import 'package:analyzer/src/task/manager.dart';
 import 'package:analyzer/src/task/task_dart.dart';
 import 'package:analyzer/task/dart.dart';
 import 'package:analyzer/task/model.dart';
+import 'package:html/dom.dart' show Document;
 import 'package:plugin/manager.dart';
 import 'package:plugin/plugin.dart';
 
@@ -762,6 +763,15 @@ abstract class AnalysisContext {
   CompilationUnit parseCompilationUnit(Source source);
 
   /**
+   * Parse a single HTML [source] to produce a document model.
+   *
+   * Throws an [AnalysisException] if the analysis could not be performed
+   *
+   * <b>Note:</b> This method cannot be used in an async environment.
+   */
+  Document parseDocument(Source source);
+
+  /**
    * Parse a single HTML [source] to produce an AST structure. The resulting
    * HTML AST structure may or may not be resolved, and may have a slightly
    * different structure depending upon whether it is resolved.
@@ -770,6 +780,7 @@ abstract class AnalysisContext {
    *
    * <b>Note:</b> This method cannot be used in an async environment.
    */
+  @deprecated // use parseDocument(source)

[Paul Berry, 2015/06/15 21:34:38]

Rather than use an end-of-line comment, I'd recommend putting a sentence in the
doc comment pointing the client to [parseDocument].  That way it will be seen by
client authors in their autocomplete popups and on the documentation web site.

[Brian Wilkerson, 2015/06/16 16:28:08]

That's probably a good idea. I did it this way to be consistent with every other
place we've marked something as deprecated. I think I'll leave it as is for now
and change them all at once.

   ht.HtmlUnit parseHtmlUnit(Source source);
 
   /**
@@ -2240,6 +2251,11 @@ class AnalysisContextImpl implements InternalAnalysisContext {
       _getDartParseData2(source, DartEntry.PARSED_UNIT, null);
 
   @override
+  Document parseDocument(Source source) {
+    return null;
+  }
+
+  @override
   ht.HtmlUnit parseHtmlUnit(Source source) =>
       _getHtmlParseData(source, HtmlEntry.PARSED_UNIT, null);
 
@@ -4026,18 +4042,6 @@ class AnalysisContextImpl implements InternalAnalysisContext {
     }
   }
 
-  /**
-   * Notify all of the analysis listeners that the errors associated with the
-   * given [source] has been updated to the given [errors].
-   */
-  void _notifyErrors(
-      Source source, List<AnalysisError> errors, LineInfo lineInfo) {
-    int count = _listeners.length;
-    for (int i = 0; i < count; i++) {
-      _listeners[i].computedErrors(this, source, errors, lineInfo);
-    }
-  }
-
 //  /**
 //   * Notify all of the analysis listeners that the given source is no longer included in the set of
 //   * sources that are being analyzed.
@@ -4117,6 +4121,18 @@ class AnalysisContextImpl implements InternalAnalysisContext {
 //  }
 
   /**
+   * Notify all of the analysis listeners that the errors associated with the
+   * given [source] has been updated to the given [errors].
+   */
+  void _notifyErrors(
+      Source source, List<AnalysisError> errors, LineInfo lineInfo) {
+    int count = _listeners.length;
+    for (int i = 0; i < count; i++) {
+      _listeners[i].computedErrors(this, source, errors, lineInfo);
+    }
+  }
+
+  /**
    * Given that the given [source] (with the corresponding [sourceEntry]) has
    * been invalidated, invalidate all of the libraries that depend on it.
    */