Move interface merging info to type registry.

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 618 matching lines @@
 
   def interface_name(self):
     raise NotImplementedError()
 
   def implementation_name(self):
     raise NotImplementedError()
 
   def has_generated_interface(self):
     raise NotImplementedError()
 
+  def merged_interface(self):
+    return None
+
+  def merged_into(self):
+    return None
+
   def native_type(self):
     return self._data.native_type or self._idl_type
 
   def bindings_class(self):
     return 'Dart%s' % self.idl_type()
 
   def vector_to_dart_template_parameter(self):
     return self.bindings_class()
 
   def requires_v8_scope(self):
@@ skipping 86 matching lines @@
 
   def interface_name(self):
     return self._dart_interface_name
 
   def implementation_name(self):
     return ImplementationClassNameForInterfaceName(self._dart_interface_name)
 
   def has_generated_interface(self):
     return True
 
+  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.
+    # As a consequence, target interface implementation and its direct children
+    # interface implementations should implement merged attribute accessors and
+    # operations. For example, SVGElement and Element implementation classes
+    # should implement HTMLElement.insertAdjacentElement(),
+    # HTMLElement.innerHTML, etc.
+    return self._data.merged_interface
+
+  def merged_into(self):
+    return self._data.merged_into
+
 
 class CallbackIDLTypeInfo(IDLTypeInfo):
   def __init__(self, idl_type, data):
     super(CallbackIDLTypeInfo, self).__init__(idl_type, data)
 
 
 # Type info for DOM types that are converted to dart lists and therefore whose
 # actual interface generation should be suppressed. For type information, we
 # still generate the implementations though, so these types should not be
 # suppressed entirely.
@@ skipping 142 matching lines @@
       conversion_cast = 'static_cast<%s*>(%s)'
     conversion_cast = conversion_cast % (self.native_type(), value)
     return 'Dart%s::toDart(%s)' % (self._idl_type, conversion_cast)
 
   def argument_expression(self, name, interface_name):
     return name if interface_name.endswith('List') else '%s->propertyReference()' % name
 
 
 class TypeData(object):
   def __init__(self, clazz, dart_type=None, native_type=None,
+               merged_interface=None, merged_into=None,
                custom_to_dart=None, custom_to_native=None,
                conversion_includes=None,
                webcore_getter_name='getAttribute',
                webcore_setter_name='setAttribute',
                requires_v8_scope=False,
                item_type=None):
     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.requires_v8_scope = requires_v8_scope
     self.item_type = item_type
 
 
 _idl_type_registry = {
@@ skipping 45 matching lines @@
     'WebKitFlags': TypeData(clazz='Primitive', dart_type='Object'),
 
     'sequence': TypeData(clazz='Primitive', dart_type='List'),
     'void': TypeData(clazz='Primitive', dart_type='void'),
 
     'CSSRule': TypeData(clazz='Interface', conversion_includes=['CSSImportRule']),
     'DOMException': TypeData(clazz='Interface', native_type='DOMCoreException'),
     'DOMStringList': TypeData(clazz='Interface', dart_type='List<String>', custom_to_native=True),
     'DOMStringMap': TypeData(clazz='Interface', dart_type='Map<String, String>'),
     'DOMWindow': TypeData(clazz='Interface', custom_to_dart=True),
-    'Element': TypeData(clazz='Interface', custom_to_dart=True),
+    'Document': TypeData(clazz='Interface', merged_interface='HTMLDocument'),
+    'Element': TypeData(clazz='Interface', merged_interface='HTMLElement',
+        custom_to_dart=True),
     'EventListener': TypeData(clazz='Interface', custom_to_native=True),
     'EventTarget': TypeData(clazz='Interface', custom_to_native=True),
-    'HTMLElement': TypeData(clazz='Interface', custom_to_dart=True),
+    'HTMLDocument': TypeData(clazz='Interface', merged_into='Document'),
+    'HTMLElement': TypeData(clazz='Interface', merged_into='Element',
+        custom_to_dart=True),
     'IDBAny': TypeData(clazz='Interface', dart_type='Dynamic', custom_to_native=True),
     'IDBKey': TypeData(clazz='Interface', dart_type='Dynamic', custom_to_native=True),
     'MutationRecordArray': TypeData(clazz='Interface',  # C++ pass by pointer.
         native_type='MutationRecordArray', dart_type='List<MutationRecord>'),
     'StyleSheet': TypeData(clazz='Interface', conversion_includes=['CSSStyleSheet']),
     'SVGElement': TypeData(clazz='Interface', custom_to_dart=True),
 
     'ClientRectList': TypeData(clazz='ListLike', item_type='ClientRect'),
     'CSSRuleList': TypeData(clazz='ListLike', item_type='CSSRule'),
     'CSSValueList': TypeData(clazz='ListLike', item_type='CSSValue'),
@@ skipping 77 matching lines @@
             self._database.GetInterface(type_name))
       else:
         dart_interface_name = type_name
       return InterfaceIDLTypeInfo(type_name, type_data, dart_interface_name)
 
     if type_data.clazz == 'ListLike':
       return ListLikeIDLTypeInfo(type_name, type_data, self.TypeInfo(type_data.item_type))
 
     class_name = '%sIDLTypeInfo' % type_data.clazz
     return globals()[class_name](type_name, type_data)