Three.js: Types for WebXR interfaces

[PalashBansal96]

Description of the problem

The WebXR API with typescript doesn't have an open types declaration file.
Some repositories including model-viewer and babylon.js have created their own, but it's not present in three.
It would really be helpful if it can be added.

Links:

• model-viewer: https://github.com/google/model-viewer/blob/master/packages/model-viewer/src/types/webxr.ts
• babylon.js: https://github.com/BabylonJS/Babylon.js/blob/master/src/LibDeclarations/webxr.d.ts

Three.js version

• [x] Dev
• [x] r119

[mrdoob]

It would really be helpful if it can be added.

Can you describe how it would be useful?

[PalashBansal96]

The documentation related to WebXR is pretty limited, so it's hard for a beginner to get around how to use the API. In the hit-test example for AR, we are using the functions getReferenceSpace, getSession, and frame.getHitTestResults which in WebXRManager.d.ts are typed as any. And there is no documentation mentioned in three that point what they are exactly and what can be done with them.
Also, the second parameter in the render function is an XRFrame object, which is just mentioned just in the r112 changelog.

If the types are mentioned in the declaration file, it gives a better way to understand what we are working with(wrt WebXR API) and what to google about further. Especially when using IDE autocomplete to explore the API.
Plus, I think these kinds of declaration files provide a good starting point to look for features to learn about.

[DefinitelyMaybe]

oh right. would you like to make a PR with the changes you'd like to see in there?

[PalashBansal96]

Sure, will do.

[mrdoob]

Thanks!

[PalashBansal96]

Created a PR for this #20150