Refine types of EventTarget

sdk/lib/html/dart2js/html_dart2js.dart

 library html;
 
 import 'dart:html_common';
 import 'dart:isolate';
 import 'dart:json';
 import 'dart:svg' as svg;
 import 'dart:web_audio' as web_audio;
 // 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.
@@ skipping 5999 matching lines @@
 
   /// @domName DirectoryReaderSync.readEntries; @docsEditable true
   @Returns('_EntryArraySync') @Creates('_EntryArraySync')
   List<EntrySync> readEntries() native;
 }
 // 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.
 
 
+/**
+ * Represents an HTML <div> element.
+ *
+ * The [DivElement] is a generic container for content and does not have any
+ * special significance. It is functionally similar to [SpanElement].
+ *
+ * The [DivElement] is a block-level element, as opposed to [SpanElement],
+ * which is an inline-level element.
+ *
+ * Example usage:
+ *
+ *     DivElement div = new DivElement();
+ *     div.text = 'Here's my new DivElem
+ *     document.body.elements.add(elem);
+ *
+ * See also:
+ *
+ * * [HTML <div> element](http://www.w3.org/TR/html-markup/div.html) from W3C.
+ * * [Block-level element](http://www.w3.org/TR/CSS2/visuren.html#block-boxes) from W3C.
+ * * [Inline-level element](http://www.w3.org/TR/CSS2/visuren.html#inline-boxes) from W3C.
+ */
 /// @domName HTMLDivElement; @docsEditable true
 class DivElement extends Element implements Element native "*HTMLDivElement" {
 
   factory DivElement() => document.$dom_createElement("div");
 }
 // 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.
 
 
@@ skipping 18 matching lines @@
   /// @domName Document.body; @docsEditable true
   @JSName('body')
   Element $dom_body;
 
   /// @domName Document.charset; @docsEditable true
   String charset;
 
   /// @domName Document.cookie; @docsEditable true
   String cookie;
 
+  /// Returns the [Window] associated with the document.
   /// @domName Document.defaultView; @docsEditable true
   Window get window => _convertNativeToDart_Window(this._window);
   @JSName('defaultView')
   @Creates('LocalWindow|=Object') @Returns('LocalWindow|=Object')
   final dynamic _window;
 
   /// @domName Document.documentElement; @docsEditable true
   final Element documentElement;
 
   /// @domName Document.domain; @docsEditable true
@@ skipping 1739 matching lines @@
 
   /// @domName Event.cancelable; @docsEditable true
   final bool cancelable;
 
   /// @domName Event.clipboardData; @docsEditable true
   final Clipboard clipboardData;
 
   /// @domName Event.currentTarget; @docsEditable true
   EventTarget get currentTarget => _convertNativeToDart_EventTarget(this._currentTarget);
   @JSName('currentTarget')
-  @Creates('EventTarget|=Object') @Returns('EventTarget|=Object')
+  @Creates('Null') @Returns('EventTarget|=Object')
   final dynamic _currentTarget;
 
   /// @domName Event.defaultPrevented; @docsEditable true
   final bool defaultPrevented;
 
   /// @domName Event.eventPhase; @docsEditable true
   final int eventPhase;
 
   /// @domName Event.returnValue; @docsEditable true
   bool returnValue;
 
   /// @domName Event.target; @docsEditable true
   EventTarget get target => _convertNativeToDart_EventTarget(this._target);
   @JSName('target')
-  @Creates('EventTarget|=Object') @Returns('EventTarget|=Object')
+  @Creates('Node') @Returns('EventTarget|=Object')
   final dynamic _target;
 
   /// @domName Event.timeStamp; @docsEditable true
   final int timeStamp;
 
   /// @domName Event.type; @docsEditable true
   final String type;
 
   /// @domName Event.initEvent; @docsEditable true
   @JSName('initEvent')
@@ skipping 4931 matching lines @@
   final int totalJSHeapSize;
 
   /// @domName MemoryInfo.usedJSHeapSize; @docsEditable true
   final int usedJSHeapSize;
 }
 // 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.
 
 
+/**
+ * An HTML <menu> element.
+ *
+ * A <menu> element represents an unordered list of menu commands.
+ *
+ * See also:
+ *
+ *  * [Menu Element](https://developer.mozilla.org/en-US/docs/HTML/Element/menu) from MDN.
+ *  * [Menu Element](http://www.w3.org/TR/html5/the-menu-element.html#the-menu-element) from the W3C.
+ */
 /// @domName HTMLMenuElement; @docsEditable true
 class MenuElement extends Element implements Element native "*HTMLMenuElement" {
 
   factory MenuElement() => document.$dom_createElement("menu");
 }
 // 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.
 
 
@@ skipping 222 matching lines @@
 
   /// @domName MouseEvent.fromElement; @docsEditable true
   final Node fromElement;
 
   /// @domName MouseEvent.metaKey; @docsEditable true
   final bool metaKey;
 
   /// @domName MouseEvent.relatedTarget; @docsEditable true
   EventTarget get relatedTarget => _convertNativeToDart_EventTarget(this._relatedTarget);
   @JSName('relatedTarget')
-  @Creates('EventTarget|=Object') @Returns('EventTarget|=Object')
+  @Creates('Node') @Returns('EventTarget|=Object')
   final dynamic _relatedTarget;
 
   /// @domName MouseEvent.screenX; @docsEditable true
   final int screenX;
 
   /// @domName MouseEvent.screenY; @docsEditable true
   final int screenY;
 
   /// @domName MouseEvent.shiftKey; @docsEditable true
   final bool shiftKey;
@@ skipping 4378 matching lines @@
 
   /// @domName Touch.screenX; @docsEditable true
   final int screenX;
 
   /// @domName Touch.screenY; @docsEditable true
   final int screenY;
 
   /// @domName Touch.target; @docsEditable true
   EventTarget get target => _convertNativeToDart_EventTarget(this._target);
   @JSName('target')
-  @Creates('EventTarget|=Object') @Returns('EventTarget|=Object')
+  @Creates('Element|Document') @Returns('Element|Document')
   final dynamic _target;
 
   /// @domName Touch.webkitForce; @docsEditable true
   final num webkitForce;
 
   /// @domName Touch.webkitRadiusX; @docsEditable true
   final int webkitRadiusX;
 
   /// @domName Touch.webkitRadiusY; @docsEditable true
   final int webkitRadiusY;
@@ skipping 7620 matching lines @@
     if (length < 0) throw new ArgumentError('length');
     if (start < 0) throw new RangeError.value(start);
     int end = start + length;
     if (end > a.length) throw new RangeError.value(end);
     for (int i = start; i < end; i++) {
       accumulator.add(a[i]);
     }
     return accumulator;
   }
 }