Leverage WebXR types in public API (playcanvas#6713)

package.json

@@ -98,7 +98,7 @@
     "README*.md"
   ],
   "dependencies": {
-    "@types/webxr": "^0.5.15",
+    "@types/webxr": "^0.5.16",
     "@webgpu/types": "^0.1.40"
   },
   "devDependencies": {

src/framework/app-base.js

@@ -129,7 +129,7 @@ class AppBase extends EventHandler {
      *
      * @callback MakeTickCallback
      * @param {number} [timestamp] - The timestamp supplied by requestAnimationFrame.
-     * @param {*} [frame] - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} [frame] - XRFrame from requestAnimationFrame callback.
      * @returns {void}
      */
 
@@ -2110,7 +2110,7 @@ const makeTick = function (_app) {
     const application = _app;
     /**
      * @param {number} [timestamp] - The timestamp supplied by requestAnimationFrame.
-     * @param {*} [frame] - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} [frame] - XRFrame from requestAnimationFrame callback.
      */
     return function (timestamp, frame) {
         if (!application.graphicsDevice)

src/framework/input/element-input.js

@@ -313,7 +313,7 @@ class ElementSelectEvent extends ElementInputEvent {
     /**
      * Create an instance of a ElementSelectEvent.
      *
-     * @param {object} event - The XRInputSourceEvent that was originally raised.
+     * @param {XRInputSourceEvent} event - The XRInputSourceEvent that was originally raised.
      * @param {import('../components/element/component.js').ElementComponent} element - The
      * ElementComponent that this event was originally raised on.
      * @param {import('../components/camera/component.js').CameraComponent} camera - The

src/framework/xr/xr-anchor.js

@@ -127,7 +127,7 @@ class XrAnchor extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @ignore
      */
     update(frame) {

src/framework/xr/xr-anchors.js

@@ -382,7 +382,7 @@ class XrAnchors extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @ignore
      */
     update(frame) {

src/framework/xr/xr-hand.js

@@ -147,7 +147,7 @@ class XrHand extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @ignore
      */
     update(frame) {

src/framework/xr/xr-hit-test-source.js

@@ -89,7 +89,7 @@ class XrHitTestSource extends EventHandler {
      * Create a new XrHitTestSource instance.
      *
      * @param {import('./xr-manager.js').XrManager} manager - WebXR Manager.
-     * @param {*} xrHitTestSource - XRHitTestSource object that is created by WebXR API.
+     * @param {XRHitTestSource} xrHitTestSource - XRHitTestSource object that is created by WebXR API.
      * @param {boolean} transient - True if XRHitTestSource created for input source profile.
      * @param {null|import('./xr-input-source.js').XrInputSource} inputSource - Input Source for which hit test is created for, or null.
      * @ignore
@@ -127,7 +127,7 @@ class XrHitTestSource extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @ignore
      */
     update(frame) {

src/framework/xr/xr-hit-test.js

@@ -337,7 +337,7 @@ class XrHitTest extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @ignore
      */
     update(frame) {

src/framework/xr/xr-image-tracking.js

@@ -157,7 +157,7 @@ class XrImageTracking extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @ignore
      */
     update(frame) {

src/framework/xr/xr-input-source.js

@@ -299,8 +299,7 @@ class XrInputSource extends EventHandler {
      * Create a new XrInputSource instance.
      *
      * @param {import('./xr-manager.js').XrManager} manager - WebXR Manager.
-     * @param {*} xrInputSource - [XRInputSource](https://developer.mozilla.org/en-US/docs/Web/API/XRInputSource)
-     * object that is created by WebXR API.
+     * @param {XRInputSource} xrInputSource - A WebXR input source.
      * @ignore
      */
     constructor(manager, xrInputSource) {
@@ -328,7 +327,7 @@ class XrInputSource extends EventHandler {
     /**
      * XRInputSource object that is associated with this input source.
      *
-     * @type {object}
+     * @type {XRInputSource}
      */
     get inputSource() {
         return this._xrInputSource;
@@ -469,7 +468,7 @@ class XrInputSource extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @ignore
      */
     update(frame) {

src/framework/xr/xr-input.js

@@ -303,7 +303,7 @@ class XrInput extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @ignore
      */
     update(frame) {

src/framework/xr/xr-joint.js

@@ -127,7 +127,7 @@ class XrJoint {
     }
 
     /**
-     * @param {*} pose - XRJointPose of this joint.
+     * @param {XRJointPose} pose - XRJointPose of this joint.
      * @ignore
      */
     update(pose) {

src/framework/xr/xr-light-estimation.js

@@ -191,7 +191,7 @@ class XrLightEstimation extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @ignore
      */
     update(frame) {

src/framework/xr/xr-manager.js

@@ -851,7 +851,7 @@ class XrManager extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      *
      * @returns {boolean} True if update was successful, false otherwise.
      * @ignore

src/framework/xr/xr-plane-detection.js

@@ -143,7 +143,7 @@ class XrPlaneDetection extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @ignore
      */
     update(frame) {

src/framework/xr/xr-plane.js

@@ -102,7 +102,7 @@ class XrPlane extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @ignore
      */
     update(frame) {

src/framework/xr/xr-tracked-image.js

@@ -75,7 +75,7 @@ class XrTrackedImage extends EventHandler {
     _emulated = false;
 
     /**
-     * @type {*}
+     * @type {XRPose|null}
      * @ignore
      */
     _pose = null;

src/framework/xr/xr-views.js

@@ -204,7 +204,7 @@ class XrViews extends EventHandler {
     }
 
     /**
-     * @param {*} frame - XRFrame from requestAnimationFrame callback.
+     * @param {XRFrame} frame - XRFrame from requestAnimationFrame callback.
      * @param {XRView} xrView - XRView from WebXR API.
      * @ignore
      */