Expand overloaded methods and optional parameters in the html library.

sdk/lib/html/dart2js/html_dart2js.dart

 /// The Dart HTML library.
 library dart.dom.html;
 
 import 'dart:async';
 import 'dart:collection';
 import 'dart:_collection-dev' hide Symbol;
 import 'dart:html_common';
 import 'dart:indexed_db';
 import 'dart:isolate';
 import 'dart:json' as json;
@@ skipping 1140 matching lines @@
   @DocsEditable
   @Creates('ImageData|=Object')
   _createImageDataFromImageData_1(imagedata) native;
 
   @DomName('CanvasRenderingContext2D.createLinearGradient')
   @DocsEditable
   CanvasGradient createLinearGradient(num x0, num y0, num x1, num y1) native;
 
   @DomName('CanvasRenderingContext2D.createPattern')
   @DocsEditable
-  CanvasPattern createPattern(canvas_OR_image, String repetitionType) native;
+  CanvasPattern createPattern(CanvasElement canvas, String repetitionType) native;

[blois, 2013/06/18 18:11:21]

I think that all variants should be named, in case we decide to add back the
general one to support the (CanvasElement|ImageElement) scenario.

For example, we should have:

createPatternFromCanvas(CanvasElement canvas, ...)
createPatternFromImage(ImageElement image, ...)

Then if we want to, later we can do:

createPattern(canvasOrImage, ...)

+
+  @JSName('createPattern')
+  @DomName('CanvasRenderingContext2D.createPattern')
+  @DocsEditable
+  CanvasPattern createPatternFromImage(ImageElement image, String repetitionType) native;
 
   @DomName('CanvasRenderingContext2D.createRadialGradient')
   @DocsEditable
   CanvasGradient createRadialGradient(num x0, num y0, num r0, num x1, num y1, num r1) native;
 
   @DomName('CanvasRenderingContext2D.fill')
   @DocsEditable
   void fill([String winding]) native;
 
   @DomName('CanvasRenderingContext2D.fillRect')
@@ skipping 5011 matching lines @@
 // http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#the-datatransferitemlist-interface
 @Experimental
 class DataTransferItemList native "DataTransferItemList" {
 
   @DomName('DataTransferItemList.length')
   @DocsEditable
   final int length;
 
   @DomName('DataTransferItemList.add')
   @DocsEditable
-  void add(data_OR_file, [String type]) native;
+  void add(String data, String type) native;
+
+  @JSName('add')
+  @DomName('DataTransferItemList.add')
+  @DocsEditable
+  void addFile(File file) native;
 
   @DomName('DataTransferItemList.clear')
   @DocsEditable
   void clear() native;
 
   @DomName('DataTransferItemList.item')
   @DocsEditable
   DataTransferItem item(int index) native;
 }
 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
@@ skipping 220 matching lines @@
 
   @DomName('DirectoryEntry.createReader')
   @DocsEditable
   DirectoryReader createReader() native;
 
   @DomName('DirectoryEntry.getDirectory')
   @DocsEditable
   void __getDirectory(String path, {Map options, _EntryCallback successCallback, _ErrorCallback errorCallback}) {
     if (errorCallback != null) {
       var options_1 = convertDartToNative_Dictionary(options);
-      ___getDirectory_1(path, options_1, successCallback, errorCallback);
+      __getDirectory_1(path, options_1, successCallback, errorCallback);
       return;
     }
     if (successCallback != null) {
       var options_2 = convertDartToNative_Dictionary(options);
-      ___getDirectory_2(path, options_2, successCallback);
+      __getDirectory_2(path, options_2, successCallback);
       return;
     }
     if (options != null) {
       var options_3 = convertDartToNative_Dictionary(options);
-      ___getDirectory_3(path, options_3);
+      __getDirectory_3(path, options_3);
       return;
     }
-    ___getDirectory_4(path);
+    __getDirectory_4(path);
     return;
   }
   @JSName('getDirectory')
   @DomName('DirectoryEntry.getDirectory')
   @DocsEditable
-  void ___getDirectory_1(path, options, _EntryCallback successCallback, _ErrorCallback errorCallback) native;
+  void __getDirectory_1(path, options, _EntryCallback successCallback, _ErrorCallback errorCallback) native;
   @JSName('getDirectory')
   @DomName('DirectoryEntry.getDirectory')
   @DocsEditable
-  void ___getDirectory_2(path, options, _EntryCallback successCallback) native;
+  void __getDirectory_2(path, options, _EntryCallback successCallback) native;
   @JSName('getDirectory')
   @DomName('DirectoryEntry.getDirectory')
   @DocsEditable
-  void ___getDirectory_3(path, options) native;
+  void __getDirectory_3(path, options) native;
   @JSName('getDirectory')
   @DomName('DirectoryEntry.getDirectory')
   @DocsEditable
-  void ___getDirectory_4(path) native;
+  void __getDirectory_4(path) native;
 
   @JSName('getDirectory')
   @DomName('DirectoryEntry.getDirectory')
   @DocsEditable
   Future<Entry> _getDirectory(String path, {Map options}) {
     var completer = new Completer<Entry>();
     __getDirectory(path, options : options,
         successCallback : (value) { completer.complete(value); },
         errorCallback : (error) { completer.completeError(error); });
     return completer.future;
   }
 
   @DomName('DirectoryEntry.getFile')
   @DocsEditable
   void __getFile(String path, {Map options, _EntryCallback successCallback, _ErrorCallback errorCallback}) {
     if (errorCallback != null) {
       var options_1 = convertDartToNative_Dictionary(options);
-      ___getFile_1(path, options_1, successCallback, errorCallback);
+      __getFile_1(path, options_1, successCallback, errorCallback);
       return;
     }
     if (successCallback != null) {
       var options_2 = convertDartToNative_Dictionary(options);
-      ___getFile_2(path, options_2, successCallback);
+      __getFile_2(path, options_2, successCallback);
       return;
     }
     if (options != null) {
       var options_3 = convertDartToNative_Dictionary(options);
-      ___getFile_3(path, options_3);
+      __getFile_3(path, options_3);
       return;
     }
-    ___getFile_4(path);
+    __getFile_4(path);
     return;
   }
   @JSName('getFile')
   @DomName('DirectoryEntry.getFile')
   @DocsEditable
-  void ___getFile_1(path, options, _EntryCallback successCallback, _ErrorCallback errorCallback) native;
+  void __getFile_1(path, options, _EntryCallback successCallback, _ErrorCallback errorCallback) native;
   @JSName('getFile')
   @DomName('DirectoryEntry.getFile')
   @DocsEditable
-  void ___getFile_2(path, options, _EntryCallback successCallback) native;
+  void __getFile_2(path, options, _EntryCallback successCallback) native;
   @JSName('getFile')
   @DomName('DirectoryEntry.getFile')
   @DocsEditable
-  void ___getFile_3(path, options) native;
+  void __getFile_3(path, options) native;
   @JSName('getFile')
   @DomName('DirectoryEntry.getFile')
   @DocsEditable
-  void ___getFile_4(path) native;
+  void __getFile_4(path) native;
 
   @JSName('getFile')
   @DomName('DirectoryEntry.getFile')
   @DocsEditable
   Future<Entry> _getFile(String path, {Map options}) {
     var completer = new Completer<Entry>();
     __getFile(path, options : options,
         successCallback : (value) { completer.complete(value); },
         errorCallback : (error) { completer.completeError(error); });
     return completer.future;
@@ skipping 9331 matching lines @@
 class MutationObserver native "MutationObserver,WebKitMutationObserver" {
 
   @DomName('MutationObserver.disconnect')
   @DocsEditable
   void disconnect() native;
 
   @DomName('MutationObserver.observe')
   @DocsEditable
   void _observe(Node target, Map options) {
     var options_1 = convertDartToNative_Dictionary(options);
-    __observe_1(target, options_1);
+    _observe_1(target, options_1);
     return;
   }
   @JSName('observe')
   @DomName('MutationObserver.observe')
   @DocsEditable
-  void __observe_1(Node target, options) native;
+  void _observe_1(Node target, options) native;
 
   @DomName('MutationObserver.takeRecords')
   @DocsEditable
   List<MutationRecord> takeRecords() native;
 
   /**
    * Checks to see if the mutation observer API is supported on the current
    * platform.
    */
   static bool get supported {
@@ skipping 212 matching lines @@
    *
    * Use [MediaStream.supported] to check if this is supported by the current
    * platform. The arguments `audio` and `video` default to `false` (stream does
    * not use audio or video, respectively).
    *
    * Simple example usage:
    *
    *     window.navigator.getUserMedia(audio: true, video: true).then((stream) {
    *       var video = new VideoElement()
    *         ..autoplay = true
-   *         ..src = Url.createObjectUrl(stream);
+   *         ..src = Url.createObjectUrlFromStream(stream);
    *       document.body.append(video);
    *     });
    *
    * The user can also pass in Maps to the audio or video parameters to specify 
    * mandatory and optional constraints for the media stream. Not passing in a 
    * map, but passing in `true` will provide a MediaStream with audio or 
    * video capabilities, but without any additional constraints. The particular
    * constraint names for audio and video are still in flux, but as of this 
    * writing, here is an example providing more constraints.
    *
@@ skipping 2394 matching lines @@
   @DocsEditable
   bool dispatchEvent(Event event) native;
 
   @JSName('removeEventListener')
   @DomName('RTCDataChannel.removeEventListener')
   @DocsEditable
   void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]) native;
 
   @DomName('RTCDataChannel.send')
   @DocsEditable
-  void send(data) native;
+  void send(String data) native;
+
+  @JSName('send')
+  @DomName('RTCDataChannel.send')
+  @DocsEditable
+  void sendBlob(Blob data) native;
+
+  @JSName('send')
+  @DomName('RTCDataChannel.send')
+  @DocsEditable
+  void sendByteBuffer(ByteBuffer data) native;
+
+  @JSName('send')
+  @DomName('RTCDataChannel.send')
+  @DocsEditable
+  void sendTypedData(TypedData data) native;
 
   @DomName('RTCDataChannel.onclose')
   @DocsEditable
   Stream<Event> get onClose => closeEvent.forTarget(this);
 
   @DomName('RTCDataChannel.onerror')
   @DocsEditable
   Stream<Event> get onError => errorEvent.forTarget(this);
 
   @DomName('RTCDataChannel.onmessage')
@@ skipping 276 matching lines @@
 
   @DomName('RTCPeerConnection.close')
   @DocsEditable
   void close() native;
 
   @DomName('RTCPeerConnection.createAnswer')
   @DocsEditable
   void _createAnswer(_RtcSessionDescriptionCallback successCallback, [_RtcErrorCallback failureCallback, Map mediaConstraints]) {
     if (mediaConstraints != null) {
       var mediaConstraints_1 = convertDartToNative_Dictionary(mediaConstraints);
-      __createAnswer_1(successCallback, failureCallback, mediaConstraints_1);
+      _createAnswer_1(successCallback, failureCallback, mediaConstraints_1);
       return;
     }
-    __createAnswer_2(successCallback, failureCallback);
+    _createAnswer_2(successCallback, failureCallback);
     return;
   }
   @JSName('createAnswer')
   @DomName('RTCPeerConnection.createAnswer')
   @DocsEditable
-  void __createAnswer_1(_RtcSessionDescriptionCallback successCallback, _RtcErrorCallback failureCallback, mediaConstraints) native;
+  void _createAnswer_1(_RtcSessionDescriptionCallback successCallback, _RtcErrorCallback failureCallback, mediaConstraints) native;
   @JSName('createAnswer')
   @DomName('RTCPeerConnection.createAnswer')
   @DocsEditable
-  void __createAnswer_2(_RtcSessionDescriptionCallback successCallback, _RtcErrorCallback failureCallback) native;
+  void _createAnswer_2(_RtcSessionDescriptionCallback successCallback, _RtcErrorCallback failureCallback) native;
 
   @JSName('createDTMFSender')
   @DomName('RTCPeerConnection.createDTMFSender')
   @DocsEditable
   RtcDtmfSender createDtmfSender(MediaStreamTrack track) native;
 
   @DomName('RTCPeerConnection.createDataChannel')
   @DocsEditable
   RtcDataChannel createDataChannel(String label, [Map options]) {
     if (options != null) {
       var options_1 = convertDartToNative_Dictionary(options);
       return _createDataChannel_1(label, options_1);
     }
     return _createDataChannel_2(label);
   }
   @JSName('createDataChannel')
   @DomName('RTCPeerConnection.createDataChannel')
   @DocsEditable
   RtcDataChannel _createDataChannel_1(label, options) native;
   @JSName('createDataChannel')
   @DomName('RTCPeerConnection.createDataChannel')
   @DocsEditable
   RtcDataChannel _createDataChannel_2(label) native;
 
   @DomName('RTCPeerConnection.createOffer')
   @DocsEditable
   void _createOffer(_RtcSessionDescriptionCallback successCallback, [_RtcErrorCallback failureCallback, Map mediaConstraints]) {
     if (mediaConstraints != null) {
       var mediaConstraints_1 = convertDartToNative_Dictionary(mediaConstraints);
-      __createOffer_1(successCallback, failureCallback, mediaConstraints_1);
+      _createOffer_1(successCallback, failureCallback, mediaConstraints_1);
       return;
     }
-    __createOffer_2(successCallback, failureCallback);
+    _createOffer_2(successCallback, failureCallback);
     return;
   }
   @JSName('createOffer')
   @DomName('RTCPeerConnection.createOffer')
   @DocsEditable
-  void __createOffer_1(_RtcSessionDescriptionCallback successCallback, _RtcErrorCallback failureCallback, mediaConstraints) native;
+  void _createOffer_1(_RtcSessionDescriptionCallback successCallback, _RtcErrorCallback failureCallback, mediaConstraints) native;
   @JSName('createOffer')
   @DomName('RTCPeerConnection.createOffer')
   @DocsEditable
-  void __createOffer_2(_RtcSessionDescriptionCallback successCallback, _RtcErrorCallback failureCallback) native;
+  void _createOffer_2(_RtcSessionDescriptionCallback successCallback, _RtcErrorCallback failureCallback) native;
 
   @DomName('RTCPeerConnection.dispatchEvent')
   @DocsEditable
   bool dispatchEvent(Event event) native;
 
   @DomName('RTCPeerConnection.getLocalStreams')
   @DocsEditable
   List<MediaStream> getLocalStreams() native;
 
   @DomName('RTCPeerConnection.getRemoteStreams')
@@ skipping 2461 matching lines @@
   void select() native;
 
   @DomName('HTMLTextAreaElement.setCustomValidity')
   @DocsEditable
   void setCustomValidity(String error) native;
 
   @DomName('HTMLTextAreaElement.setRangeText')
   @DocsEditable
   // http://www.whatwg.org/specs/web-apps/current-work/multipage/association-of-controls-and-forms.html#dom-textarea/input-setrangetext
   @Experimental
-  void setRangeText(String replacement, [int start, int end, String selectionMode]) native;
+  void setRangeText(String replacement, {int start, int end, String selectionMode}) native;
 
   @DomName('HTMLTextAreaElement.setSelectionRange')
   @DocsEditable
   void setSelectionRange(int start, int end, [String direction]) native;
 }
 // Copyright (c) 2013, 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 941 matching lines @@
 class UnknownElement extends Element native "HTMLUnknownElement" {
 }
 // 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('URL')
 class Url native "URL" {
 
-  static String createObjectUrl(blob_OR_source_OR_stream) =>
-      JS('String',
-         '(self.URL || self.webkitURL).createObjectURL(#)',
-         blob_OR_source_OR_stream);
+  static String createObjectUrl(MediaSource source) =>
+      JS('String', '(self.URL || self.webkitURL).createObjectURL(#)', source);
+  
+  static String createObjectUrlFromStream(MediaStream stream) =>
+      JS('String', '(self.URL || self.webkitURL).createObjectURL(#)', stream);
+  
+  static String createObjectUrlFromBlob(Blob blob) =>
+      JS('String', '(self.URL || self.webkitURL).createObjectURL(#)', blob);
 
   static void revokeObjectUrl(String url) =>
       JS('void',
          '(self.URL || self.webkitURL).revokeObjectURL(#)', url);
 
 }
 // 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 1133 matching lines @@
   @Returns('Window|=Object')
   final dynamic _get_window;
 
   @DomName('Window.__getter__')
   @DocsEditable
   @Experimental // untriaged
   @Creates('Window|=Object')
   @Returns('Window|=Object')
   WindowBase __getter__(index_OR_name) {
     if ((index_OR_name is int || index_OR_name == null)) {
-      return _convertNativeToDart_Window(___getter___1(index_OR_name));
+      return _convertNativeToDart_Window(__getter___1(index_OR_name));
     }
     if ((index_OR_name is String || index_OR_name == null)) {
-      return _convertNativeToDart_Window(___getter___2(index_OR_name));
+      return _convertNativeToDart_Window(__getter___2(index_OR_name));
     }
     throw new ArgumentError("Incorrect number or type of arguments");
   }
   @JSName('__getter__')
   @DomName('Window.__getter__')
   @DocsEditable
   @Experimental // untriaged
   @Creates('Window|=Object')
   @Returns('Window|=Object')
-  ___getter___1(int index) native;
+  __getter___1(int index) native;
   @JSName('__getter__')
   @DomName('Window.__getter__')
   @DocsEditable
   @Experimental // untriaged
   @Creates('Window|=Object')
   @Returns('Window|=Object')
-  ___getter___2(String name) native;
+  __getter___2(String name) native;
 
   @JSName('addEventListener')
   @DomName('Window.addEventListener')
   @DocsEditable
   void $dom_addEventListener(String type, EventListener listener, [bool useCapture]) native;
 
   @DomName('Window.alert')
   @DocsEditable
   void alert(String message) native;
 
@@ skipping 6382 matching lines @@
       _position = nextPosition;
       return true;
     }
     _current = null;
     _position = _array.length;
     return false;
   }
 
   T get current => _current;
 }