haxefoundation / html-externs Goto Github PK

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

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

See HaxeFoundation/dox#133

Would it be possible to fix this?

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

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".

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

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

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)

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

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

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?

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

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