First half of the new HTML json docs.

utils/apidoc/html_diff.dart

 // Copyright (c) 2012, 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.
 
 /**
  * A script to assist in documenting the difference between the dart:html API
  * and the old DOM API.
  */
 library html_diff;
 
 import 'dart:io';
 import 'dart:async';
 import '../../sdk/lib/html/html_common/metadata.dart';
+import 'lib/metadata.dart';
 
 // TODO(rnystrom): Use "package:" URL (#4968).
 import '../../sdk/lib/_internal/dartdoc/lib/dartdoc.dart';
 import '../../sdk/lib/_internal/compiler/implementation/mirrors/mirrors.dart';
 import '../../sdk/lib/_internal/compiler/implementation/mirrors/mirrors_util.dart';
 
 // TODO(amouravski): There is currently magic that looks at dart:* libraries
 // rather than the declared library names. This changed due to recent syntax
 // changes. We should only need to look at the library 'html'.
 const List<String> HTML_LIBRARY_NAMES = const [
@@ skipping 121 matching lines @@
   }
 
   /**
    * Returns the `@DomName` type values that correspond to
    * [htmlType] from `dart:html`. This can be the empty list if no
    * correspondence is found.
    */
   List<String> htmlToDomTypes(ClassMirror htmlType) {
     if (htmlType.simpleName == null) return <String>[];
 
-    final domNameMetadata = _findMetadata(htmlType.metadata, 'DomName');
+    final domNameMetadata = findMetadata(htmlType.metadata, 'DomName');
     if (domNameMetadata != null) {
       var domNames = <String>[];
       var tags = deprecatedFutureValue(domNameMetadata.getField('name'));
       for (var s in tags.reflectee.split(',')) {
         domNames.add(s.trim());
       }
 
       if (domNames.length == 1 && domNames[0] == 'none') return <String>[];
       return domNames;
     }
     return <String>[];
   }
 
   /**
    * Returns the `@DomName` member values that correspond to
    * [htmlMember] from `dart:html`. This can be the empty set if no
    * correspondence is found.  [domTypes] are the
    * `@DomName` type values that correspond to [htmlMember]'s
    * defining type.
    */
   Set<String> htmlToDomMembers(MemberMirror htmlMember, List<String> domTypes) {
     if (htmlMember.isPrivate) return new Set();
 
-    final domNameMetadata = _findMetadata(htmlMember.metadata, 'DomName');
+    final domNameMetadata = findMetadata(htmlMember.metadata, 'DomName');
     if (domNameMetadata != null) {
       var domNames = <String>[];
       var tags = deprecatedFutureValue(domNameMetadata.getField('name'));
       for (var s in tags.reflectee.split(',')) {
         domNames.add(s.trim());
       }
 
       if (domNames.length == 1 && domNames[0] == 'none') return new Set();
       final members = new Set();
       domNames.forEach((name) {
@@ skipping 36 matching lines @@
       defaultTypes.forEach((t) { members.add('$t.$name'); });
       return members;
     }
 
     if (name.split('.').length != 2) {
       warn('invalid member name ${name}');
       return new Set();
     }
     return new Set.from([name]);
   }
-
-}
-
-/// Returns the metadata for the given string or null if not found.
-InstanceMirror _findMetadata(List<InstanceMirror> metadataList, String find) {
-  return metadataList.firstMatching(
-      (metadata) => metadata.type.simpleName == find,
-      orElse: () => null);
-}
+}