Move some of analyzer's code generation utilities into front_end.

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';
 
 /**
  * Embedded stylesheet
  */
 final String stylesheet = '''
 body {
@@ skipping 107 matching lines @@
     new GeneratedFile('doc/api.html', (String pkgPath) {
   ToHtmlVisitor visitor = new ToHtmlVisitor(readApi(pkgPath));
   dom.Document document = new dom.Document();
   document.append(new dom.DocumentType('html', null, null));
   for (dom.Node node in visitor.collectHtml(visitor.visitApi)) {
     document.append(node);
   }
   return document.outerHtml;
 });
 
+String _toTitleCase(String str) {
+  if (str.isEmpty) return str;
+  return str.substring(0, 1).toUpperCase() + str.substring(1);
+}
+
 /**
  * Visitor that records the mapping from HTML elements to various kinds of API
  * nodes.
  */
 class ApiMappings extends HierarchicalApiVisitor {
   Map<dom.Element, Domain> domains = <dom.Element, Domain>{};
 
   ApiMappings(Api api) : super(api);
 
   @override
@@ skipping 109 matching lines @@
           generateNotificationsIndex(domain.notifications);
         }
       });
     } else if (domain.notifications.length > 0) {
       element('div', {'class': 'subindex'}, () {
         generateNotificationsIndex(domain.notifications);
       });
     }
   }
 
-  void generateTableOfContents() {
-    ul(() {
-      writeln();
-
-      for (var domain in api.domains.where((domain) => !domain.experimental)) {
-        write('      ');
-        li(() {
-          link('domain_${domain.name}', () {
-            write(_toTitleCase(domain.name));
-          });
-        });
-        writeln();
-      }
-    });
-  }
-
   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 43 matching lines @@
       for (var request in requests) {
         element(
             'li',
             {},
             () => link(
                 'request_${request.longMethod}', () => write(request.method)));
       }
     });
   }
 
+  void generateTableOfContents() {
+    ul(() {
+      writeln();
+
+      for (var domain in api.domains.where((domain) => !domain.experimental)) {
+        write('      ');
+        li(() {
+          link('domain_${domain.name}', () {
+            write(_toTitleCase(domain.name));
+          });
+        });
+        writeln();
+      }
+    });
+  }
+
   void generateTypesIndex(Set<String> types) {
     h3(() {
       write("Types");
       write(' (');
       link('types', () => write('\u2191'));
       write(')');
     });
     element('div', {'class': 'subindex'}, () {
       element('ul', {}, () {
         for (var type in types) {
@@ skipping 55 matching lines @@
         }
         switch (node.localName) {
           case 'domain':
             visitDomain(apiMappings.domains[node]);
             break;
           case 'head':
             head(() {
               translateHtml(node, squashParagraphs: squashParagraphs);
               element('link', {
                 'rel': 'stylesheet',
-                'href': 'https://fonts.googleapis.com/css?family=Source+Code+Pro|Roboto:500,400italic,300,400',
+                'href':
+                    'https://fonts.googleapis.com/css?family=Source+Code+Pro|Roboto:500,400italic,300,400',
                 'type': 'text/css'
-                });
+              });
               element('style', {}, () {
                 writeln(stylesheet);
               });
             });
             break;
           case 'refactorings':
             visitRefactorings(api.refactorings);
             break;
           case 'types':
             visitTypes(api.types);
@@ skipping 341 matching lines @@
     bool verticalBarNeeded = false;
     for (TypeDecl choice in typeUnion.choices) {
       if (verticalBarNeeded) {
         write(' | ');
       }
       visitTypeDecl(choice);
       verticalBarNeeded = true;
     }
   }
 }
-
-String _toTitleCase(String str) {
-  if (str.isEmpty) return str;
-  return str.substring(0, 1).toUpperCase() + str.substring(1);
-}