Make server use the common protocol classes

pkg/analysis_server/tool/spec/to_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 displaying the API as HTML.  This is used both for generating a
  * full description of the API as a web page, and for generating doc comments
  * in generated code.
  */
-library to.html;
-
 import 'dart:convert';
 
 import 'package:analyzer/src/codegen/html.dart';
 import 'package:analyzer/src/codegen/tools.dart';
 import 'package:front_end/src/codegen/tools.dart';
 import 'package:html/dom.dart' as dom;
 
 import 'api.dart';
 import 'from_html.dart';
 
@@ skipping 179 matching lines @@
   void i(void callback()) => element('i', {}, callback);
   void li(void callback()) => element('li', {}, callback);
   void link(String id, void callback(), [Map<dynamic, String> attributes]) {
     attributes ??= {};
     attributes['href'] = '#$id';
     element('a', attributes, callback);
   }
 
   void p(void callback()) => element('p', {}, callback);
   void pre(void callback()) => element('pre', {}, callback);
+  void span(String cls, void callback()) =>
+      element('span', {'class': cls}, callback);
   void title(void callback()) => element('title', {}, callback);
   void tt(void callback()) => element('tt', {}, callback);
   void ul(void callback()) => element('ul', {}, callback);
-  void span(String cls, void callback()) =>
-      element('span', {'class': cls}, callback);
 }
 
 /**
  * Visitor that generates HTML documentation of the API.
  */
 class ToHtmlVisitor extends HierarchicalApiVisitor
     with HtmlMixin, HtmlGenerator {
   /**
    * Set of types defined in the API.
    */
@@ skipping 46 matching lines @@
           generateNotificationsIndex(domain.notifications);
         }
       });
     } else if (domain.notifications.length > 0) {
       element('div', {'class': 'subindex'}, () {
         generateNotificationsIndex(domain.notifications);
       });
     }
   }
 
+  void generateDomainsHeader() {
+    h1(() {
+      write('Domains');
+    });
+  }
+
   void generateIndex() {
     h3(() => write('Domains'));
     for (var domain in api.domains) {
       if (domain.experimental ||
           (domain.requests.length == 0 && domain.notifications == 0)) {
         continue;
       }
       generateDomainIndex(domain);
     }
 
@@ skipping 10 matching lines @@
               'li',
               {},
               () => link('notification_${notification.longEvent}',
                   () => write(notification.event)));
         }
       });
     });
   }
 
   void generateRefactoringsIndex(Iterable<Refactoring> refactorings) {
+    if (refactorings == null) {
+      return;
+    }
     h3(() {
       write("Refactorings");
       write(' (');
       link('refactorings', () => write('\u2191'));
       write(')');
     });
     // TODO: Individual refactorings are not yet hyperlinked.
     element('div', {'class': 'subindex'}, () {
       element('ul', {}, () {
         for (var refactoring in refactorings) {
@@ skipping 15 matching lines @@
           element(
               'li',
               {},
               () => link('request_${request.longMethod}',
                   () => write(request.method)));
         }
       }
     });
   }
 
-  void generateDomainsHeader() {
-    h1(() {
-      write('Domains');
-    });
-  }
-
   void generateTableOfContents() {
     for (var domain in api.domains.where((domain) => !domain.experimental)) {
       writeln();
 
       p(() {
         link('domain_${domain.name}', () {
           write(_toTitleCase(domain.name));
         });
       });
 
@@ skipping 12 matching lines @@
     }
   }
 
   void generateTypesIndex(Set<String> types) {
     h3(() {
       write("Types");
       write(' (');
       link('types', () => write('\u2191'));
       write(')');
     });
+    List<String> sortedTypes = types.toList();
+    sortedTypes.sort();
     element('div', {'class': 'subindex'}, () {
       element('ul', {}, () {
-        for (var type in types) {
+        for (var type in sortedTypes) {
           element('li', {}, () => link('type_$type', () => write(type)));
         }
       });
     });
   }
 
   void javadocParams(TypeObject typeObject) {
     if (typeObject != null) {
       for (TypeObjectField field in typeObject.fields) {
         hangingIndent(() {
@@ skipping 73 matching lines @@
           case 'version':
             translateHtml(node, squashParagraphs: squashParagraphs);
             break;
           case 'toc':
             generateTableOfContents();
             break;
           case 'index':
             generateIndex();
             break;
           default:
-            if (!specialElements.contains(node.localName)) {
+            if (!ApiReader.specialElements.contains(node.localName)) {
               element(node.localName, node.attributes, () {
                 translateHtml(node, squashParagraphs: squashParagraphs);
               });
             }
         }
       } else if (node is dom.Text) {
         String text = node.text;
         write(text);
       }
     }
@@ skipping 195 matching lines @@
     });
   }
 
   @override
   void visitTypeReference(TypeReference typeReference) {}
 
   @override
   void visitTypes(Types types) {
     translateHtml(types.html);
     dl(() {
-      super.visitTypes(types);
+      List<TypeDefinition> sortedTypes = types.toList();
+      sortedTypes.sort((TypeDefinition first, TypeDefinition second) =>
+          first.name.compareTo(second.name));
+      sortedTypes.forEach(visitTypeDefinition);
     });
   }
 }
 
 /**
  * Visitor that generates a compact representation of a type, such as:
  *
  * {
  *   "id": String
  *   "error": optional Error
@@ skipping 101 matching lines @@
     bool verticalBarNeeded = false;
     for (TypeDecl choice in typeUnion.choices) {
       if (verticalBarNeeded) {
         write(' | ');
       }
       visitTypeDecl(choice);
       verticalBarNeeded = true;
     }
   }
 }