Experimental `getDiagnostics` request (#24480).

pkg/analysis_server/tool/spec/from_html.dart

 // 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.
 
 /**
  * Code for reading an HTML API description.
  */
 library from.html;
 
 import 'dart:io';
@@ skipping 122 matching lines @@
  *   <notification event="...">...</notification> <!-- zero or more -->
  * </domain>
  *
  * Child elements can occur in any order.
  */
 Domain domainFromHtml(dom.Element html) {
   checkName(html, 'domain');
   String name = html.attributes['name'];
   String context = name ?? 'domain';
   bool experimental = html.attributes['experimental'] == 'true';
-  checkAttributes(html, ['name'], context, optionalAttributes: ['experimental']);
+  checkAttributes(html, ['name'], context,
+      optionalAttributes: ['experimental']);
   List<Request> requests = <Request>[];
   List<Notification> notifications = <Notification>[];
   recurse(html, context, {
     'request': (dom.Element child) {
       requests.add(requestFromHtml(child, context));
     },
     'notification': (dom.Element child) {
       notifications.add(notificationFromHtml(child, context));
     }
   });
-  return new Domain(name, experimental, requests, notifications, html);
+  return new Domain(name, requests, notifications, html,
+      experimental: experimental);
 }
 
 dom.Element getAncestor(dom.Element html, String name, String context) {
   dom.Element ancestor = html.parent;
   while (ancestor != null) {
     if (ancestor.localName == name) {
       return ancestor;
     }
     ancestor = ancestor.parent;
   }
@@ skipping 249 matching lines @@
  * </type>
  *
  * Where TYPE is any HTML that can be parsed by [typeDeclFromHtml].
  *
  * Child elements can occur in any order.
  */
 TypeDefinition typeDefinitionFromHtml(dom.Element html) {
   checkName(html, 'type');
   String name = html.attributes['name'];
   String context = name != null ? name : 'type';
-  checkAttributes(html, ['name'], context);
+  checkAttributes(html, ['name'], context, optionalAttributes: ['experimental']);
   TypeDecl type = processContentsAsType(html, context);
-  return new TypeDefinition(name, type, html);
+  bool experimental = html.attributes['experimental'] == 'true';
+  return new TypeDefinition(name, type, html, experimental: experimental);
 }
 
 /**
  * Create a [TypeEnum] from an HTML description.
  */
 TypeEnum typeEnumFromHtml(dom.Element html, String context) {
   checkName(html, 'enum', context);
   checkAttributes(html, [], context);
   List<TypeEnumValue> values = <TypeEnumValue>[];
   recurse(html, context, {
@@ skipping 70 matching lines @@
   String value = html.attributes['value'];
   TypeDecl type = processContentsAsType(html, context);
   return new TypeObjectField(name, type, html,
       optional: optional, value: value);
 }
 
 /**
  * Create a [TypeObject] from an HTML description.
  */
 TypeObject typeObjectFromHtml(dom.Element html, String context) {
-  checkAttributes(html, [], context);
+  checkAttributes(html, [], context,  optionalAttributes: ['experimental']);
   List<TypeObjectField> fields = <TypeObjectField>[];
   recurse(html, context, {
     'field': (dom.Element child) {
       fields.add(typeObjectFieldFromHtml(child, context));
     }
   });
-  return new TypeObject(fields, html);
+  bool experimental = html.attributes['experimental'] == 'true';
+  return new TypeObject(fields, html, experimental: experimental);
 }
 
 /**
  * Create a [Types] object from an HTML representation such as:
  *
  * <types>
  *   <type name="...">...</type> <!-- zero or more -->
  * </types>
  */
 Types typesFromHtml(dom.Element html) {
   checkName(html, 'types');
   String context = 'types';
   checkAttributes(html, [], context);
   Map<String, TypeDefinition> types = <String, TypeDefinition>{};
   recurse(html, context, {
     'type': (dom.Element child) {
       TypeDefinition typeDefinition = typeDefinitionFromHtml(child);
       types[typeDefinition.name] = typeDefinition;
     }
   });
   return new Types(types, html);
 }
 
 typedef void ElementProcessor(dom.Element element);
 
 typedef void TextProcessor(dom.Text text);