dart2js: Refactoring, documentation, and a few bugfixes in Namer class.

tests/html/custom_element_method_clash_test.dart

+// Copyright (c) 2015, 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.
+
+library custom_elements_method_clash;
+
+import 'dart:html';
+import 'package:unittest/unittest.dart';
+
+class CustomElement extends HtmlElement {
+  factory CustomElement() => new Element.tag('x-custom');
+
+  CustomElement.created() : super.created() {
+  }
+
+  // Try to clash with native 'appendChild' method.
+  void appendChild() { 
+    throw 'Gotcha!';
+  }
+}
+
+main() {
+  document.registerElement('x-custom', CustomElement);
+  CustomElement custom = new CustomElement();
+  document.body.children.add(custom);
+
+  // Will call appendChild in JS.
+  custom.children.add(new DivElement()..text = 'Hello world!'); 
+
+  try {
+    custom.appendChild(); // Make sure method is not tree shaken.
+    fail('appendChild did not throw');
+  } catch(e) {
+    expect(e, equals('Gotcha!'));
+  }
+}