record that Gamepad.buttons creates GamepadButtons

tools/dom/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 json
@@ skipping 1118 matching lines @@
       if 'ImplementedAs' in interface.ext_attrs:
         return interface.ext_attrs['ImplementedAs']
     return super(InterfaceIDLTypeInfo, self).native_type()
 
   def has_generated_interface(self):
     return not self._data.suppress_interface
 
   def list_item_type(self):
     return self._data.item_type
 
+  def list_item_type_nullable(self):
+    return self._data.item_type_nullable
+
   def merged_interface(self):
     # All constants, attributes, and operations of merged interface should be
     # added to this interface. Merged idl interface does not have corresponding
     # Dart generated interface, and all references to merged idl interface
     # (e.g. parameter types, return types, parent interfaces) should be replaced
     # with this interface. There are two important restrictions:
     # 1) Merged and target interfaces shouldn't have common members, otherwise
     # there would be duplicated declarations in generated Dart code.
     # 2) Merged interface should be direct child of target interface, so the
     # children of merged interface are not affected by the merge.
@@ skipping 234 matching lines @@
     return '%s.get()', 'RefPtr<%s>' % self._idl_type, 'DartUtilities', 'dartTo%s' % self._idl_type
 
 
 class TypeData(object):
   def __init__(self, clazz, dart_type=None, native_type=None,
                merged_interface=None, merged_into=None,
                custom_to_dart=False, custom_to_native=False,
                conversion_includes=None,
                webcore_getter_name='getAttribute',
                webcore_setter_name='setAttribute',
-               item_type=None, suppress_interface=False):
+               item_type=None, item_type_nullable=False,
+               suppress_interface=False):
     self.clazz = clazz
     self.dart_type = dart_type
     self.native_type = native_type
     self.merged_interface = merged_interface
     self.merged_into = merged_into
     self.custom_to_dart = custom_to_dart
     self.custom_to_native = custom_to_native
     self.conversion_includes = conversion_includes
     self.webcore_getter_name = webcore_getter_name
     self.webcore_setter_name = webcore_setter_name
     self.item_type = item_type
+    self.item_type_nullable = item_type_nullable
     self.suppress_interface = suppress_interface
 
 
 def TypedListTypeData(item_type):
   return TypeData(clazz='TypedList', item_type=item_type)
 
 
 _idl_type_registry = monitored.Dict('generator._idl_type_registry', {
     'boolean': TypeData(clazz='Primitive', dart_type='bool', native_type='bool',
                         webcore_getter_name='hasAttribute',
@@ skipping 66 matching lines @@
     'CSSValueList': TypeData(clazz='Interface',
         item_type='CSSValue', suppress_interface=True),
     'MimeTypeArray': TypeData(clazz='Interface', item_type='MimeType'),
     'PluginArray': TypeData(clazz='Interface', item_type='Plugin'),
     'DOMStringList': TypeData(clazz='Interface', item_type='DOMString',
         dart_type='List<String>', custom_to_native=True),
     'FileList': TypeData(clazz='Interface', item_type='File',
         dart_type='List<File>'),
     'Future': TypeData(clazz='Interface', dart_type='Future'),
     'GamepadList': TypeData(clazz='Interface', item_type='Gamepad',
-        suppress_interface=True),
+        item_type_nullable=True, suppress_interface=True),
     'GLenum': TypeData(clazz='Primitive', dart_type='int',
         native_type='unsigned'),
     'GLboolean': TypeData(clazz='Primitive', dart_type='bool',
         native_type='bool'),
     'GLbitfield': TypeData(clazz='Primitive', dart_type='int',
         native_type='unsigned'),
     'GLshort': TypeData(clazz='Primitive', dart_type='int', native_type='short'),
     'GLint': TypeData(clazz='Primitive', dart_type='int',
         native_type='long'),
     'GLsizei': TypeData(clazz='Primitive', dart_type='int',
@@ skipping 195 matching lines @@
             return_type == 'Rectangle')
 
 def wrap_return_type_blink(return_type, type_name, type_registry):
     """Returns True if we should wrap the returned value. This checks
     a number of different variations, calling the more basic functions
     above."""
     return (wrap_unwrap_type_blink(return_type, type_registry) or
             wrap_unwrap_type_blink(type_name, type_registry) or
             wrap_type_blink(return_type, type_registry) or
             wrap_unwrap_list_blink(return_type, type_registry))