Add annotations on native fields and methods

sdk/lib/html/dart2js/html_dart2js.dart

 library html;
 
 import 'dart:isolate';
 import 'dart:json';
 import 'dart:svg' as svg;
 // 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.
 
 // DO NOT EDIT
@@ skipping 1013 matching lines @@
   /** @domName HTMLButtonElement.formMethod */
   String formMethod;
 
   /** @domName HTMLButtonElement.formNoValidate */
   bool formNoValidate;
 
   /** @domName HTMLButtonElement.formTarget */
   String formTarget;
 
   /** @domName HTMLButtonElement.labels */
+  @Returns('_NodeList') @Creates('_NodeList')
   final List<Node> labels;
 
   /** @domName HTMLButtonElement.name */
   String name;
 
   /** @domName HTMLButtonElement.type */
   String type;
 
   /** @domName HTMLButtonElement.validationMessage */
   final String validationMessage;
@@ skipping 76 matching lines @@
 }
 // 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.
 
 
 /// @domName WebKitCSSKeyframesRule
 class CSSKeyframesRule extends CSSRule native "*WebKitCSSKeyframesRule" {
 
   /** @domName WebKitCSSKeyframesRule.cssRules */
+  @Returns('_CSSRuleList') @Creates('_CSSRuleList')

[vsm, 2012/11/20 18:33:46]

Does @Returns imply @Creates?

[sra1, 2012/11/20 19:26:33]

No.  There is no cross-use of the annotations.
I could change that.

   final List<CSSRule> cssRules;
 
   /** @domName WebKitCSSKeyframesRule.name */
   String name;
 
   /** @domName WebKitCSSKeyframesRule.deleteRule */
   void deleteRule(String key) native;
 
   /** @domName WebKitCSSKeyframesRule.findRule */
   CSSKeyframeRule findRule(String key) native;
@@ skipping 114 matching lines @@
 }
 // 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.
 
 
 /// @domName CSSMediaRule
 class CSSMediaRule extends CSSRule native "*CSSMediaRule" {
 
   /** @domName CSSMediaRule.cssRules */
+  @Returns('_CSSRuleList') @Creates('_CSSRuleList')
   final List<CSSRule> cssRules;
 
   /** @domName CSSMediaRule.media */
   final MediaList media;
 
   /** @domName CSSMediaRule.deleteRule */
   void deleteRule(int index) native;
 
   /** @domName CSSMediaRule.insertRule */
   int insertRule(String rule, int index) native;
@@ skipping 3379 matching lines @@
 }
 // 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.
 
 
 /// @domName CSSStyleSheet
 class CSSStyleSheet extends StyleSheet native "*CSSStyleSheet" {
 
   /** @domName CSSStyleSheet.cssRules */
+  @Returns('_CSSRuleList') @Creates('_CSSRuleList')
   final List<CSSRule> cssRules;
 
   /** @domName CSSStyleSheet.ownerRule */
   final CSSRule ownerRule;
 
   /** @domName CSSStyleSheet.rules */
+  @Returns('_CSSRuleList') @Creates('_CSSRuleList')
   final List<CSSRule> rules;
 
   /** @domName CSSStyleSheet.addRule */
   int addRule(String selector, String style, [int index]) native;
 
   /** @domName CSSStyleSheet.deleteRule */
   void deleteRule(int index) native;
 
   /** @domName CSSStyleSheet.insertRule */
   int insertRule(String rule, int index) native;
@@ skipping 517 matching lines @@
 /// @domName Clipboard
 class Clipboard native "*Clipboard" {
 
   /** @domName Clipboard.dropEffect */
   String dropEffect;
 
   /** @domName Clipboard.effectAllowed */
   String effectAllowed;
 
   /** @domName Clipboard.files */
+  @Returns('_FileList') @Creates('_FileList')
   final List<File> files;
 
   /** @domName Clipboard.items */
   final DataTransferItemList items;
 
   /** @domName Clipboard.types */
   final List types;
 
   /** @domName Clipboard.clearData */
   void clearData([String type]) native;
@@ skipping 129 matching lines @@
 
   factory ContentElement() => document.$dom_createElement("content");
 
   /** @domName HTMLContentElement.resetStyleInheritance */
   bool resetStyleInheritance;
 
   /** @domName HTMLContentElement.select */
   String select;
 
   /** @domName HTMLContentElement.getDistributedNodes */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> getDistributedNodes() 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.
 
 
 /// @domName ConvolverNode
 class ConvolverNode extends AudioNode native "*ConvolverNode" {
 
@@ skipping 1066 matching lines @@
 }
 // 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.
 
 
 /// @domName DirectoryReaderSync
 class DirectoryReaderSync native "*DirectoryReaderSync" {
 
   /** @domName DirectoryReaderSync.readEntries */
+  @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.
 
 
 /// @domName HTMLDivElement
 class DivElement extends Element implements Element native "*HTMLDivElement" {
 
@@ skipping 53 matching lines @@
   /** @domName Document.readyState */
   final String readyState;
 
   /** @domName Document.referrer */
   String get $dom_referrer => JS("String", "#.referrer", this);
 
   /** @domName Document.selectedStylesheetSet */
   String selectedStylesheetSet;
 
   /** @domName Document.styleSheets */
-  List<StyleSheet> get $dom_styleSheets => JS("List<StyleSheet>", "#.styleSheets", this);
+  List<StyleSheet> get $dom_styleSheets => JS("_StyleSheetList", "#.styleSheets", this);
 
   /** @domName Document.title */
   String get $dom_title => JS("String", "#.title", this);
 
   /** @domName Document.title */
   void set $dom_title(String value) {
     JS("void", "#.title = #", this, value);
   }
 
   /** @domName Document.webkitFullscreenElement */
@@ skipping 54 matching lines @@
   /** @domName Document.execCommand */
   bool execCommand(String command, bool userInterface, String value) native;
 
   /** @domName Document.getCSSCanvasContext */
   CanvasRenderingContext getCSSCanvasContext(String contextId, String name, int width, int height) native;
 
   /** @domName Document.getElementById */
   Element $dom_getElementById(String elementId) native "getElementById";
 
   /** @domName Document.getElementsByClassName */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> $dom_getElementsByClassName(String tagname) native "getElementsByClassName";
 
   /** @domName Document.getElementsByName */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> $dom_getElementsByName(String elementName) native "getElementsByName";
 
   /** @domName Document.getElementsByTagName */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> $dom_getElementsByTagName(String tagname) native "getElementsByTagName";
 
   /** @domName Document.queryCommandEnabled */
   bool queryCommandEnabled(String command) native;
 
   /** @domName Document.queryCommandIndeterm */
   bool queryCommandIndeterm(String command) native;
 
   /** @domName Document.queryCommandState */
   bool queryCommandState(String command) native;
 
   /** @domName Document.queryCommandSupported */
   bool queryCommandSupported(String command) native;
 
   /** @domName Document.queryCommandValue */
   String queryCommandValue(String command) native;
 
   /** @domName Document.querySelector */
   Element $dom_querySelector(String selectors) native "querySelector";
 
   /** @domName Document.querySelectorAll */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> $dom_querySelectorAll(String selectors) native "querySelectorAll";
 
   /** @domName Document.webkitCancelFullScreen */
   void $dom_webkitCancelFullScreen() native "webkitCancelFullScreen";
 
   /** @domName Document.webkitExitFullscreen */
   void $dom_webkitExitFullscreen() native "webkitExitFullscreen";
 
   /** @domName Document.webkitExitPointerLock */
   void $dom_webkitExitPointerLock() native "webkitExitPointerLock";
@@ skipping 399 matching lines @@
   /**
    * @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent
    */
   ElementEvents get on =>
     new ElementEvents(this);
 
   /** @domName DocumentFragment.querySelector */
   Element $dom_querySelector(String selectors) native "querySelector";
 
   /** @domName DocumentFragment.querySelectorAll */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> $dom_querySelectorAll(String selectors) native "querySelectorAll";
 
 }
 // 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.
 
 
 /// @domName DocumentType
 class DocumentType extends Node native "*DocumentType" {
@@ skipping 668 matching lines @@
   /**
    * Experimental support for [web components][wc]. This field stores a
    * reference to the component implementation. It was inspired by Mozilla's
    * [x-tags][] project. Please note: in the future it may be possible to
    * `extend Element` from your class, in which case this field will be
    * deprecated and will simply return this [Element] object.
    *
    * [wc]: http://dvcs.w3.org/hg/webcomponents/raw-file/tip/explainer/index.html
    * [x-tags]: http://x-tags.org/
    */
+  @Creates('Null')  // Set from Dart code; does not instantiate a native type.
   var xtag;
 
   // TODO(vsm): Implement noSuchMethod or similar for dart2js.
 
   /** @domName Element.insertAdjacentText */
   void insertAdjacentText(String where, String text) {
     if (JS('bool', '!!#.insertAdjacentText', this)) {
       _insertAdjacentText(where, text);
     } else {
       _insertAdjacentNode(where, new Text(text));
@@ skipping 182 matching lines @@
   /** @domName Element.focus */
   void focus() native;
 
   /** @domName Element.getAttribute */
   String $dom_getAttribute(String name) native "getAttribute";
 
   /** @domName Element.getBoundingClientRect */
   ClientRect getBoundingClientRect() native;
 
   /** @domName Element.getClientRects */
+  @Returns('_ClientRectList') @Creates('_ClientRectList')
   List<ClientRect> getClientRects() native;
 
   /** @domName Element.getElementsByClassName */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> $dom_getElementsByClassName(String name) native "getElementsByClassName";
 
   /** @domName Element.getElementsByTagName */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> $dom_getElementsByTagName(String name) native "getElementsByTagName";
 
   /** @domName Element.hasAttribute */
   bool $dom_hasAttribute(String name) native "hasAttribute";
 
   /** @domName Element.querySelector */
   Element $dom_querySelector(String selectors) native "querySelector";
 
   /** @domName Element.querySelectorAll */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> $dom_querySelectorAll(String selectors) native "querySelectorAll";
 
   /** @domName Element.removeAttribute */
   void $dom_removeAttribute(String name) native "removeAttribute";
 
   /** @domName Element.scrollByLines */
   void scrollByLines(int lines) native;
 
   /** @domName Element.scrollByPages */
   void scrollByPages(int pages) native;
@@ skipping 1595 matching lines @@
 
   // -- end List<Node> mixins.
 
   /** @domName HTMLAllCollection.item */
   Node item(int index) native;
 
   /** @domName HTMLAllCollection.namedItem */
   Node namedItem(String name) native;
 
   /** @domName HTMLAllCollection.tags */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> tags(String name) 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.
 
 
 /// @domName HTMLCollection
 class HTMLCollection implements JavaScriptIndexingBehavior, List<Node> native "*HTMLCollection" {
 
@@ skipping 573 matching lines @@
   /**
    * @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent
    */
   IDBDatabaseEvents get on =>
     new IDBDatabaseEvents(this);
 
   /** @domName IDBDatabase.name */
   final String name;
 
   /** @domName IDBDatabase.objectStoreNames */
+  @Returns('_DOMStringList') @Creates('_DOMStringList')
   final List<String> objectStoreNames;
 
   /** @domName IDBDatabase.version */
   final dynamic version;
 
   /** @domName IDBDatabase.addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]) native "addEventListener";
 
   /** @domName IDBDatabase.close */
   void close() native;
@@ skipping 362 matching lines @@
 // BSD-style license that can be found in the LICENSE file.
 
 
 /// @domName IDBObjectStore
 class IDBObjectStore native "*IDBObjectStore" {
 
   /** @domName IDBObjectStore.autoIncrement */
   final bool autoIncrement;
 
   /** @domName IDBObjectStore.indexNames */
+  @Returns('_DOMStringList') @Creates('_DOMStringList')
   final List<String> indexNames;
 
   /** @domName IDBObjectStore.keyPath */
   final dynamic keyPath;
 
   /** @domName IDBObjectStore.name */
   final String name;
 
   /** @domName IDBObjectStore.transaction */
   final IDBTransaction transaction;
@@ skipping 530 matching lines @@
   /** @domName HTMLInputElement.defaultValue */
   String defaultValue;
 
   /** @domName HTMLInputElement.dirName */
   String dirName;
 
   /** @domName HTMLInputElement.disabled */
   bool disabled;
 
   /** @domName HTMLInputElement.files */
+  @Returns('_FileList') @Creates('_FileList')
   List<File> files;
 
   /** @domName HTMLInputElement.form */
   final FormElement form;
 
   /** @domName HTMLInputElement.formAction */
   String formAction;
 
   /** @domName HTMLInputElement.formEnctype */
   String formEnctype;
@@ skipping 10 matching lines @@
   /** @domName HTMLInputElement.height */
   int height;
 
   /** @domName HTMLInputElement.incremental */
   bool incremental;
 
   /** @domName HTMLInputElement.indeterminate */
   bool indeterminate;
 
   /** @domName HTMLInputElement.labels */
+  @Returns('_NodeList') @Creates('_NodeList')
   final List<Node> labels;
 
   /** @domName HTMLInputElement.list */
   final Element list;
 
   /** @domName HTMLInputElement.max */
   String max;
 
   /** @domName HTMLInputElement.maxLength */
   int maxLength;
@@ skipping 52 matching lines @@
   /** @domName HTMLInputElement.value */
   String value;
 
   /** @domName HTMLInputElement.valueAsDate */
   Date valueAsDate;
 
   /** @domName HTMLInputElement.valueAsNumber */
   num valueAsNumber;
 
   /** @domName HTMLInputElement.webkitEntries */
+  @Returns('_EntryArray') @Creates('_EntryArray')
   final List<Entry> webkitEntries;
 
   /** @domName HTMLInputElement.webkitGrammar */
   bool webkitGrammar;
 
   /** @domName HTMLInputElement.webkitSpeech */
   bool webkitSpeech;
 
   /** @domName HTMLInputElement.webkitdirectory */
   bool webkitdirectory;
@@ skipping 463 matching lines @@
   /** @domName HTMLKeygenElement.disabled */
   bool disabled;
 
   /** @domName HTMLKeygenElement.form */
   final FormElement form;
 
   /** @domName HTMLKeygenElement.keytype */
   String keytype;
 
   /** @domName HTMLKeygenElement.labels */
+  @Returns('_NodeList') @Creates('_NodeList')
   final List<Node> labels;
 
   /** @domName HTMLKeygenElement.name */
   String name;
 
   /** @domName HTMLKeygenElement.type */
   final String type;
 
   /** @domName HTMLKeygenElement.validationMessage */
   final String validationMessage;
@@ skipping 135 matching lines @@
 }
 // 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.
 
 
 /// @domName Location
 class LocalLocation implements Location native "*Location" {
 
   /** @domName Location.ancestorOrigins */
+  @Returns('_DOMStringList') @Creates('_DOMStringList')
   final List<String> ancestorOrigins;
 
   /** @domName Location.hash */
   String hash;
 
   /** @domName Location.host */
   String host;
 
   /** @domName Location.hostname */
   String hostname;
@@ skipping 372 matching lines @@
   /** @domName Window.find */
   bool find(String string, bool caseSensitive, bool backwards, bool wrap, bool wholeWord, bool searchInFrames, bool showDialog) native;
 
   /** @domName Window.focus */
   void focus() native;
 
   /** @domName Window.getComputedStyle */
   CSSStyleDeclaration $dom_getComputedStyle(Element element, String pseudoElement) native "getComputedStyle";
 
   /** @domName Window.getMatchedCSSRules */
+  @Returns('_CSSRuleList') @Creates('_CSSRuleList')
   List<CSSRule> getMatchedCSSRules(Element element, String pseudoElement) native;
 
   /** @domName Window.getSelection */
   DOMSelection getSelection() native;
 
   /** @domName Window.matchMedia */
   MediaQueryList matchMedia(String query) native;
 
   /** @domName Window.moveBy */
   void moveBy(num x, num y) native;
 
   /** @domName Window.moveTo */
   void moveTo(num x, num y) native;
 
   /** @domName DOMWindow.openDatabase */
+  @Creates('Database') @Creates('DatabaseSync')

[vsm, 2012/11/20 18:33:46]

FWIW, the first is redundant with the return type.  Does this really create a
DatabaseSync?

[sra1, 2012/11/20 19:26:33]

1. If you give any Creates annotation, you must give them all.  Otherwise you
cant stop the pollution due to a a bad declared return type like Object.

2. The callback has both, which unions to Object, so the callback is causing
pollution.

3. I'm not sure if we can actually get the Sync version so this is conservative,
based on the types.

   Database openDatabase(String name, String version, String displayName, int estimatedSize, [DatabaseCallback creationCallback]) native;
 
   /** @domName Window.postMessage */
   void postMessage(/*SerializedScriptValue*/ message, String targetOrigin, [List messagePorts]) {
     if (?message &&
         !?messagePorts) {
       var message_1 = _convertDartToNative_SerializedScriptValue(message);
       _postMessage_1(message_1, targetOrigin);
       return;
     }
@@ skipping 940 matching lines @@
   dynamic get data => _convertNativeToDart_SerializedScriptValue(this._data);
   dynamic get _data => JS("dynamic", "#.data", this);
 
   /** @domName MessageEvent.lastEventId */
   final String lastEventId;
 
   /** @domName MessageEvent.origin */
   final String origin;
 
   /** @domName MessageEvent.ports */
+  @Creates('=List')

[vsm, 2012/11/20 18:33:46]

What's the significance of the "="?

[sra1, 2012/11/20 19:26:33]

=List is a special hack to name JavaScript Array.
=Object is a special hack to name a plain JS Object.

   final List ports;
 
   /** @domName MessageEvent.source */
   Window get source => _convertNativeToDart_Window(this._source);
   dynamic get _source => JS("dynamic", "#.source", this);
 
   /** @domName MessageEvent.initMessageEvent */
   void initMessageEvent(String typeArg, bool canBubbleArg, bool cancelableArg, Object dataArg, String originArg, String lastEventIdArg, LocalWindow sourceArg, List messagePorts) native;
 
   /** @domName MessageEvent.webkitInitMessageEvent */
@@ skipping 97 matching lines @@
 
 /// @domName HTMLMeterElement
 class MeterElement extends Element implements Element native "*HTMLMeterElement" {
 
   factory MeterElement() => document.$dom_createElement("meter");
 
   /** @domName HTMLMeterElement.high */
   num high;
 
   /** @domName HTMLMeterElement.labels */
+  @Returns('_NodeList') @Creates('_NodeList')
   final List<Node> labels;
 
   /** @domName HTMLMeterElement.low */
   num low;
 
   /** @domName HTMLMeterElement.max */
   num max;
 
   /** @domName HTMLMeterElement.min */
   num min;
@@ skipping 250 matching lines @@
 }
 // 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.
 
 
 /// @domName MutationRecord
 class MutationRecord native "*MutationRecord" {
 
   /** @domName MutationRecord.addedNodes */
+  @Returns('_NodeList') @Creates('_NodeList')
   final List<Node> addedNodes;
 
   /** @domName MutationRecord.attributeName */
   final String attributeName;
 
   /** @domName MutationRecord.attributeNamespace */
   final String attributeNamespace;
 
   /** @domName MutationRecord.nextSibling */
   final Node nextSibling;
 
   /** @domName MutationRecord.oldValue */
   final String oldValue;
 
   /** @domName MutationRecord.previousSibling */
   final Node previousSibling;
 
   /** @domName MutationRecord.removedNodes */
+  @Returns('_NodeList') @Creates('_NodeList')
   final List<Node> removedNodes;
 
   /** @domName MutationRecord.target */
   final Node target;
 
   /** @domName MutationRecord.type */
   final String type;
 }
 // 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
@@ skipping 168 matching lines @@
   /** @domName Navigator.webkitBattery */
   final BatteryManager webkitBattery;
 
   /** @domName Navigator.getStorageUpdates */
   void getStorageUpdates() native;
 
   /** @domName Navigator.javaEnabled */
   bool javaEnabled() native;
 
   /** @domName Navigator.webkitGetGamepads */
+  @Returns('_GamepadList') @Creates('_GamepadList')
   List<Gamepad> webkitGetGamepads() native;
 
   /** @domName Navigator.webkitGetUserMedia */
   void webkitGetUserMedia(Map options, NavigatorUserMediaSuccessCallback successCallback, [NavigatorUserMediaErrorCallback errorCallback]) {
     if (?errorCallback) {
       var options_1 = _convertDartToNative_Dictionary(options);
       _webkitGetUserMedia_1(options_1, successCallback, errorCallback);
       return;
     }
     var options_2 = _convertDartToNative_Dictionary(options);
@@ skipping 216 matching lines @@
   static const int NOTATION_NODE = 12;
 
   static const int PROCESSING_INSTRUCTION_NODE = 7;
 
   static const int TEXT_NODE = 3;
 
   /** @domName Node.attributes */
   NamedNodeMap get $dom_attributes => JS("NamedNodeMap", "#.attributes", this);
 
   /** @domName Node.childNodes */
-  List<Node> get $dom_childNodes => JS("List<Node>", "#.childNodes", this);
+  List<Node> get $dom_childNodes => JS("_NodeList", "#.childNodes", this);
 
   /** @domName Node.firstChild */
   Node get $dom_firstChild => JS("Node", "#.firstChild", this);
 
   /** @domName Node.lastChild */
   Node get $dom_lastChild => JS("Node", "#.lastChild", this);
 
   /** @domName Node.nextSibling */
   Node get nextNode => JS("Node", "#.nextSibling", this);
 
@@ skipping 514 matching lines @@
   /** @domName HTMLOutputElement.defaultValue */
   String defaultValue;
 
   /** @domName HTMLOutputElement.form */
   final FormElement form;
 
   /** @domName HTMLOutputElement.htmlFor */
   DOMSettableTokenList htmlFor;
 
   /** @domName HTMLOutputElement.labels */
+  @Returns('_NodeList') @Creates('_NodeList')
   final List<Node> labels;
 
   /** @domName HTMLOutputElement.name */
   String name;
 
   /** @domName HTMLOutputElement.type */
   final String type;
 
   /** @domName HTMLOutputElement.validationMessage */
   final String validationMessage;
@@ skipping 199 matching lines @@
 
   static const int SDP_PRANSWER = 0x200;
 
   /** @domName PeerConnection00.iceState */
   final int iceState;
 
   /** @domName PeerConnection00.localDescription */
   final SessionDescription localDescription;
 
   /** @domName PeerConnection00.localStreams */
+  @Returns('_MediaStreamList') @Creates('_MediaStreamList')
   final List<MediaStream> localStreams;
 
   /** @domName PeerConnection00.readyState */
   final int readyState;
 
   /** @domName PeerConnection00.remoteDescription */
   final SessionDescription remoteDescription;
 
   /** @domName PeerConnection00.remoteStreams */
+  @Returns('_MediaStreamList') @Creates('_MediaStreamList')
   final List<MediaStream> remoteStreams;
 
   /** @domName PeerConnection00.addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]) native "addEventListener";
 
   /** @domName PeerConnection00.addStream */
   void addStream(MediaStream stream, [Map mediaStreamHints]) {
     if (?mediaStreamHints) {
       var mediaStreamHints_1 = _convertDartToNative_Dictionary(mediaStreamHints);
       _addStream_1(stream, mediaStreamHints_1);
@@ skipping 290 matching lines @@
 // 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.
 
 
 /// @domName HTMLProgressElement
 class ProgressElement extends Element implements Element native "*HTMLProgressElement" {
 
   factory ProgressElement() => document.$dom_createElement("progress");
 
   /** @domName HTMLProgressElement.labels */
+  @Returns('_NodeList') @Creates('_NodeList')
   final List<Node> labels;
 
   /** @domName HTMLProgressElement.max */
   num max;
 
   /** @domName HTMLProgressElement.position */
   final num position;
 
   /** @domName HTMLProgressElement.value */
   num value;
@@ skipping 169 matching lines @@
   RTCPeerConnectionEvents get on =>
     new RTCPeerConnectionEvents(this);
 
   /** @domName RTCPeerConnection.iceState */
   final String iceState;
 
   /** @domName RTCPeerConnection.localDescription */
   final RTCSessionDescription localDescription;
 
   /** @domName RTCPeerConnection.localStreams */
+  @Returns('_MediaStreamList') @Creates('_MediaStreamList')
   final List<MediaStream> localStreams;
 
   /** @domName RTCPeerConnection.readyState */
   final String readyState;
 
   /** @domName RTCPeerConnection.remoteDescription */
   final RTCSessionDescription remoteDescription;
 
   /** @domName RTCPeerConnection.remoteStreams */
+  @Returns('_MediaStreamList') @Creates('_MediaStreamList')
   final List<MediaStream> remoteStreams;
 
   /** @domName RTCPeerConnection.addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]) native "addEventListener";
 
   /** @domName RTCPeerConnection.addIceCandidate */
   void addIceCandidate(RTCIceCandidate candidate) native;
 
   /** @domName RTCPeerConnection.addStream */
   void addStream(MediaStream stream, [Map mediaConstraints]) {
@@ skipping 255 matching lines @@
   /** @domName Range.expand */
   void expand(String unit) native;
 
   /** @domName Range.extractContents */
   DocumentFragment extractContents() native;
 
   /** @domName Range.getBoundingClientRect */
   ClientRect getBoundingClientRect() native;
 
   /** @domName Range.getClientRects */
+  @Returns('_ClientRectList') @Creates('_ClientRectList')
   List<ClientRect> getClientRects() native;
 
   /** @domName Range.insertNode */
   void insertNode(Node newNode) native;
 
   /** @domName Range.intersectsNode */
   bool intersectsNode(Node refNode) native;
 
   /** @domName Range.isPointInRange */
   bool isPointInRange(Node refNode, int offset) native;
@@ skipping 475 matching lines @@
   /** @domName HTMLSelectElement.autofocus */
   bool autofocus;
 
   /** @domName HTMLSelectElement.disabled */
   bool disabled;
 
   /** @domName HTMLSelectElement.form */
   final FormElement form;
 
   /** @domName HTMLSelectElement.labels */
+  @Returns('_NodeList') @Creates('_NodeList')
   final List<Node> labels;
 
   /** @domName HTMLSelectElement.length */
   int length;
 
   /** @domName HTMLSelectElement.multiple */
   bool multiple;
 
   /** @domName HTMLSelectElement.name */
   String name;
@@ skipping 100 matching lines @@
   /** @domName ShadowRoot.resetStyleInheritance */
   bool resetStyleInheritance;
 
   /** @domName ShadowRoot.cloneNode */
   Node clone(bool deep) native "cloneNode";
 
   /** @domName ShadowRoot.getElementById */
   Element $dom_getElementById(String elementId) native "getElementById";
 
   /** @domName ShadowRoot.getElementsByClassName */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> $dom_getElementsByClassName(String className) native "getElementsByClassName";
 
   /** @domName ShadowRoot.getElementsByTagName */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> $dom_getElementsByTagName(String tagName) native "getElementsByTagName";
 
   /** @domName ShadowRoot.getSelection */
   DOMSelection getSelection() native;
 
   static bool get supported =>
       JS('bool', '!!(window.ShadowRoot || window.WebKitShadowRoot)');
 }
 // 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
@@ skipping 318 matching lines @@
 }
 // 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.
 
 
 /// @domName SpeechInputEvent
 class SpeechInputEvent extends Event native "*SpeechInputEvent" {
 
   /** @domName SpeechInputEvent.results */
+  @Returns('_SpeechInputResultList') @Creates('_SpeechInputResultList')
   final List<SpeechInputResult> results;
 }
 // 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.
 
 
 /// @domName SpeechInputResult
 class SpeechInputResult native "*SpeechInputResult" {
 
@@ skipping 129 matching lines @@
 // BSD-style license that can be found in the LICENSE file.
 
 
 /// @domName SpeechRecognitionEvent
 class SpeechRecognitionEvent extends Event native "*SpeechRecognitionEvent" {
 
   /** @domName SpeechRecognitionEvent.result */
   final SpeechRecognitionResult result;
 
   /** @domName SpeechRecognitionEvent.resultHistory */
+  @Returns('_SpeechRecognitionResultList') @Creates('_SpeechRecognitionResultList')
   final List<SpeechRecognitionResult> resultHistory;
 
   /** @domName SpeechRecognitionEvent.resultIndex */
   final int resultIndex;
 }
 // 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 523 matching lines @@
   /** @domName HTMLTextAreaElement.dirName */
   String dirName;
 
   /** @domName HTMLTextAreaElement.disabled */
   bool disabled;
 
   /** @domName HTMLTextAreaElement.form */
   final FormElement form;
 
   /** @domName HTMLTextAreaElement.labels */
+  @Returns('_NodeList') @Creates('_NodeList')
   final List<Node> labels;
 
   /** @domName HTMLTextAreaElement.maxLength */
   int maxLength;
 
   /** @domName HTMLTextAreaElement.name */
   String name;
 
   /** @domName HTMLTextAreaElement.placeholder */
   String placeholder;
@@ skipping 2636 matching lines @@
   /** @domName WebKitNamedFlow.overset */
   final bool overset;
 
   /** @domName WebKitNamedFlow.addEventListener */
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]) native "addEventListener";
 
   /** @domName WebKitNamedFlow.dispatchEvent */
   bool $dom_dispatchEvent(Event event) native "dispatchEvent";
 
   /** @domName WebKitNamedFlow.getContent */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> getContent() native;
 
   /** @domName WebKitNamedFlow.getRegions */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> getRegions() native;
 
   /** @domName WebKitNamedFlow.getRegionsByContent */
+  @Returns('_NodeList') @Creates('_NodeList')
   List<Node> getRegionsByContent(Node contentNode) native;
 
   /** @domName WebKitNamedFlow.removeEventListener */
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]) native "removeEventListener";
 }
 // 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.
 
 // WARNING: Do not edit - generated code.
@@ skipping 1576 matching lines @@
 class _MessageChannelFactoryProvider {
   static MessageChannel createMessageChannel() =>
       JS('MessageChannel', 'new MessageChannel()' );
 }
 // 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.
 
 
 class _MutationObserverFactoryProvider {
-  static MutationObserver createMutationObserver(MutationCallback callback) {
 
-    // This is a hack to cause MutationRecord to appear to be instantiated.
-    //
-    // MutationCallback has a parameter type List<MutationRecord>.  From this we
-    // infer a list is created in the browser, but not the element type, because
-    // other native fields and methods return plain List which is too general
-    // and would imply creating anything.  This statement is a work-around.
-    JS('MutationRecord','0');
-
-    return _createMutationObserver(callback);
-  }
-
-  static MutationObserver _createMutationObserver(MutationCallback callback) native '''
+  @Creates('MutationObserver')
+  @Creates('MutationRecord')
+  static MutationObserver createMutationObserver(MutationCallback callback) native '''
     var constructor =
         window.MutationObserver || window.WebKitMutationObserver ||
         window.MozMutationObserver;
     return new constructor(callback);
   ''';
 
   // TODO(sra): Dart2js inserts a conversion when a Dart function (i.e. an
   // object with a call method) is passed to a native method.  This is so the
   // native code sees a JavaScript function.
   //
@@ skipping 3572 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;
   }
 }