Add annotations on native fields and methods

sdk/lib/html/scripts/generator.py

 #!/usr/bin/python
 # 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.
 
 """This module provides shared functionality for systems to generate
 Dart APIs from the IDL database."""
 
 import copy
 import re
@@ skipping 575 matching lines @@
 # Annotations to be placed on members.  The table is indexed by the IDL
 # interface and member name, and by IDL return or field type name.  Both are
 # used to assemble the annotations:
 #
 #   INTERFACE.MEMBER: annotations for member.
 #   +TYPE:            add annotations only if there are member annotations.
 #   TYPE:             add regardless of member annotations.
 
 dart2js_annotations = {
 
+    'CanvasRenderingContext2D.createImageData':
+      "@Creates('ImageData|=Object')",
+
+    'CanvasRenderingContext2D.getImageData':
+      "@Creates('ImageData|=Object')",
+
+    'CanvasRenderingContext2D.webkitGetImageDataHD':
+      "@Creates('ImageData|=Object')",
+
+    'DOMWindow.openDatabase': "@Creates('Database') @Creates('DatabaseSync')",
+
+    'FileReader.result': "@Creates('String|ArrayBuffer|Null')",
+
     # Rather than have the result of an IDBRequest as a union over all possible
     # results, we mark the result as instantiating any classes, and mark
     # each operation with the classes that it could cause to be asynchronously
     # instantiated.
     'IDBRequest.result':  "@Creates('Null')",
 
     # The source is usually a participant in the operation that generated the
     # IDBRequest.
     'IDBRequest.source':  "@Creates('Null')",
 
@@ skipping 17 matching lines @@
       '@_annotation_Returns_SerializedScriptValue',
 
     'IDBCursor.key': "@_annotation_Creates_IDBKey @_annotation_Returns_IDBKey",
 
     '+IDBRequest': "@Returns('IDBRequest') @Creates('IDBRequest')",
 
     '+IDBOpenDBRequest': "@Returns('IDBRequest') @Creates('IDBRequest')",
     '+IDBVersionChangeRequest': "@Returns('IDBRequest') @Creates('IDBRequest')",
 
 
-    'FileReader.result': "@Creates('String|ArrayBuffer|Null')",
+    'MessageEvent.ports': "@Creates('=List')",
 
-    'CanvasRenderingContext2D.createImageData':
-      "@Creates('ImageData|=Object')",
-
-    'CanvasRenderingContext2D.getImageData':
-      "@Creates('ImageData|=Object')",
-
-    'CanvasRenderingContext2D.webkitGetImageDataHD':
-      "@Creates('ImageData|=Object')",
+    'SQLResultSetRowList.item': "@Creates('=Object')",
 
     'XMLHttpRequest.response':
       "@Creates('ArrayBuffer|Blob|Document|=Object|=List|String|num')",
-
-    'SQLResultSetRowList.item': "@Creates('=Object')",
 }
 
 def FindAnnotations(idl_type, interface_name, member_name):
   ann1 = dart2js_annotations.get("%s.%s" % (interface_name, member_name))
   if ann1:
     ann2 = dart2js_annotations.get('+' + idl_type)
     if ann2:
       return ann2 + ' ' + ann1
     ann2 = dart2js_annotations.get(idl_type)
     if ann2:
@@ skipping 126 matching lines @@
     self._dart_interface_name = dart_interface_name
     self._type_registry = type_registry
 
   def dart_type(self):
     if self.list_item_type() and not self.has_generated_interface():
       return 'List<%s>' % self._type_registry.TypeInfo(self._data.item_type).dart_type()
     return self._data.dart_type or self._dart_interface_name
 
   def narrow_dart_type(self):
     if self.list_item_type():
-      return self.idl_type()
+      return self.implementation_name()
     # TODO(podivilov): only primitive and collection types should override
     # dart_type.
     if self._data.dart_type != None:
       return self.dart_type()
     if IsPureInterface(self.idl_type()):
       return self.idl_type()
     return self.interface_name()
 
   def interface_name(self):
     return self._dart_interface_name
@@ skipping 392 matching lines @@
                                   self)
 
     if type_data.clazz == 'SVGTearOff':
       dart_interface_name = self._renamer.RenameInterface(
           self._database.GetInterface(type_name))
       return SVGTearOffIDLTypeInfo(
           type_name, type_data, dart_interface_name, self)
 
     class_name = '%sIDLTypeInfo' % type_data.clazz
     return globals()[class_name](type_name, type_data)