haxefoundation / html-externs Goto Github PK

See HaxeFoundation/dox#133

Would it be possible to fix this?

It would be great if we could support the new function type since this would provide richer completion/documentation for the working with JavaScript. I noticed this information is already available in the webidls.

For example; BaseAudioContext webidl:

callback DecodeSuccessCallback = void (AudioBuffer decodedData);
callback DecodeErrorCallback = void (DOMException error);

...

Promise<AudioBuffer> decodeAudioData(ArrayBuffer audioData,
                                         optional DecodeSuccessCallback successCallback,
                                         optional DecodeErrorCallback errorCallback);

Currently we generate:

function decodeAudioData(audioData:js.lib.ArrayBuffer, ?successCallback:AudioBuffer->Void, ?errorCallback:js.html.DOMException->Void):Promise<AudioBuffer>;

This could be improved like this:

function decodeAudioData(audioData:js.lib.ArrayBuffer, ?successCallback:(decodedData:AudioBuffer) -> Void,
		?errorCallback:(error:DOMException) -> Void):Promise<AudioBuffer>;

.. or with typedef

function decodeAudioData(audioData:js.lib.ArrayBuffer, ?successCallback:DecodeSuccessCallback, ?errorCallback:DecodeErrorCallback):Promise<AudioBuffer>;

typedef DecodeSuccessCallback = (decodedData:AudioBuffer) -> Void;
typedef DecodeErrorCallback = (error:DOMException) -> Void;

If the info is not available we can always fallback to the "old syntax".

Things like https://github.com/HaxeFoundation/html-externs/blob/master/webidl/mozilla/Console.webidl#L10 should generate haxe.extern.Rest.

I found this older documentation here:
https://github.com/HaxeFoundation/haxe/blob/a06f9d35ae138be1e163444146354933301697f4/std/js/html/CSSRule.hx

The current looks like this:
https://github.com/HaxeFoundation/haxe/blob/development/std/js/html/CSSRule.hx

Which result in:
http://api.haxe.org/js/html/CSSRule.html

As far as I see, there is no documentation in the full package anymore. Can we get this back?

Might make a lot of sense to hook into this to minimise development effort

https://github.com/microsoft/TSJS-lib-generator

https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/addIceCandidate

Tracking the todolist:

• typed arrays to js.lib
• js.Promise references to js.lib HaxeFoundation/haxe#8282
• Remap any other types that have moved to js.lib
• Add @:pure to typedarray constructors
• class constants on instances with trailing underscore
• Re-order overloads for better type interference (this is a work around for an overload bug)
• Split up either types into abstracts where possible. This one is a bit tricky but worth doing.
• Add missing userVisibleOnly field, see HaxeFoundation/haxe#9027

• Update readme instructions to sync with recent changes
• Tidy and reorganise scripts to make it easy to reproduce

Removing prefixes of type names has caused confusions and issues (see HaxeFoundation/haxe#9085)

Consider rebuilding with original names and moving to another directory (deprecating js.html) if necessary

See HaxeFoundation/haxe#9085 (comment)

The migration guide should be updated to reflect recent changes wrt Element-gate :)

https://developer.mozilla.org/en-US/docs/Web/API/Element/requestFullScreen#Parameters

In haxe 3.2 version, InputElement has no longer valueAsDate field and so, the value can't be interpreted as a date

Could this field be add or maybe there is a reason to avoid using it ?

refers to HaxeFoundation/haxe#5034

Thanks