iwer 0.0.2 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Meta Platforms, Inc. and affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# Immersive Web Emulation Runtime
+
+The Immersive Web Emulation Runtime (IWER) is a TypeScript-based tool designed to enable the running of WebXR applications in modern browsers without requiring native WebXR support. By emulating the WebXR Device API, IWER provides developers with the ability to test and run WebXR projects across a wide range of devices, ensuring compatibility and enhancing the development process.
+
+## Documentation
+
+For detailed information about using IWER, including concepts, guides, and API references, please visit our documentation site:
+
+- [IWER Documentation](https://meta-quest.github.io/immersive-web-emulation-runtime)
+
+## License
+
+IWER is licensed under the MIT License. For more details, see the [LICENSE](https://github.com/meta-quest/immersive-web-emulation-runtime/blob/main/LICENSE) file in this repository.
+
+## Contributing
+
+Your contributions are welcome! Please feel free to submit issues and pull requests. Before contributing, make sure to review our [Contributing Guidelines](https://github.com/meta-quest/immersive-web-emulation-runtime/blob/main/CONTRIBUTING.md) and [Code of Conduct](https://github.com/meta-quest/immersive-web-emulation-runtime/blob/main/CODE_OF_CONDUCT.md).

package/build/iwer.js

@@ -1281,6 +1281,12 @@
     };
   })();
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$k = Symbol('@immersive-web-emulation-runtime/xr-space');
   class XRSpace extends EventTarget {
       constructor(parentSpace, offsetMatrix) {
@@ -1325,6 +1331,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   /**
    * Wrapper class for gl-matrix vec3
    * Minimal interoperable interface to Vector3 in Three.js and Babylon.js
@@ -1452,6 +1464,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$j = Symbol('@immersive-web-emulation-runtime/gamepad');
   var GamepadMappingType;
   (function (GamepadMappingType) {
@@ -1578,6 +1596,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   var XRHandedness;
   (function (XRHandedness) {
       XRHandedness["None"] = "none";
@@ -1629,6 +1653,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   class XRInputSourceEvent extends Event {
       constructor(type, eventInitDict) {
           super(type, eventInitDict);
@@ -1643,6 +1673,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$h = Symbol('@immersive-web-emulation-runtime/xr-tracked-input');
   const DEFAULT_TRANSFORM = {
       [XRHandedness.Left]: {
@@ -1726,6 +1762,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   class XRController extends XRTrackedInput {
       constructor(controllerConfig, handedness, globalSpace) {
           if (!controllerConfig.layout[handedness]) {
@@ -1804,6 +1846,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$g = Symbol('@immersive-web-emulation-runtime/xr-view');
   var XREye;
   (function (XREye) {
@@ -1843,6 +1891,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   var XRHandJoint;
   (function (XRHandJoint) {
       XRHandJoint["Wrist"] = "wrist";
@@ -1874,6 +1928,12 @@
   class XRHand extends Map {
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$f = Symbol('@immersive-web-emulation-runtime/xr-joint-space');
   class XRJointSpace extends XRSpace {
       constructor(jointName, parentSpace, offsetMatrix) {
@@ -1885,6 +1945,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const pinchHandPose = {
       jointTransforms: {
           wrist: {
@@ -2122,6 +2188,12 @@
       ],
   };
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const pointHandPose = {
       jointTransforms: {
           wrist: {
@@ -2358,6 +2430,12 @@
       ],
   };
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const relaxedHandPose = {
       jointTransforms: {
           wrist: {
@@ -2594,6 +2672,12 @@
       ],
   };
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const oculusHandConfig = {
       profileId: 'oculus-hand',
       fallbackProfileIds: [
@@ -2717,6 +2801,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$d = Symbol('@immersive-web-emulation-runtime/xr-pose');
   class XRPose {
       constructor(transform, emulatedPosition = false, linearVelocity = undefined, angularVelocity = undefined) {
@@ -2741,6 +2831,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$c = Symbol('@immersive-web-emulation-runtime/xr-joint-pose');
   class XRJointPose extends XRPose {
       constructor(transform, radius, emulatedPosition = false, linearVelocity = undefined, angularVelocity = undefined) {
@@ -2752,6 +2848,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   class PolyfillDOMPointReadOnly {
       constructor(x = 0, y = 0, z = 0, w = 1) {
           this.x = x;
@@ -2778,6 +2880,12 @@
       ? globalThis.DOMPointReadOnly
       : PolyfillDOMPointReadOnly;
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$b = Symbol('@immersive-web-emulation-runtime/xr-rigid-transform');
   class XRRigidTransform {
       constructor(position, orientation) {
@@ -2830,6 +2938,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$a = Symbol('@immersive-web-emulation-runtime/xr-viewer-pose');
   class XRViewerPose extends XRPose {
       constructor(transform, views, emulatedPosition = false, linearVelocity = undefined, angularVelocity = undefined) {
@@ -2843,6 +2957,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$9 = Symbol('@immersive-web-emulation-runtime/xr-frame');
   const spaceGlobalMatrix = create$3();
   const baseSpaceGlobalMatrix = create$3();
@@ -2951,6 +3071,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   class XRInputSourcesChangeEvent extends Event {
       constructor(type, eventInitDict) {
           super(type, eventInitDict);
@@ -2969,6 +3095,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   var _a;
   const PRIVATE$8 = Symbol('@immersive-web-emulation-runtime/xr-reference-space');
   var XRReferenceSpaceType;
@@ -3010,6 +3142,12 @@
   }
   _a = PRIVATE$8;
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$7 = Symbol('@immersive-web-emulation-runtime/xr-render-state');
   class XRRenderState {
       constructor(init = {}, oldState) {
@@ -3036,6 +3174,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   class XRSessionEvent extends Event {
       constructor(type, eventInitDict) {
           super(type, eventInitDict);
@@ -3046,6 +3190,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   var XRVisibilityState;
   (function (XRVisibilityState) {
       XRVisibilityState["Visible"] = "visible";
@@ -3255,6 +3405,7 @@
           return this[PRIVATE$6].isSystemKeyboardSupported;
       }
       updateRenderState(state = {}) {
+          var _a, _b, _c, _d;
           if (this[PRIVATE$6].ended) {
               throw new DOMException('XRSession has already ended.', 'InvalidStateError');
           }
@@ -3266,7 +3417,21 @@
               this[PRIVATE$6].mode !== XRSessionMode.Inline) {
               throw new DOMException('InlineVerticalFieldOfView must not be set for an immersive session', 'InvalidStateError');
           }
-          this[PRIVATE$6].pendingRenderState = new XRRenderState(state, this[PRIVATE$6].renderState);
+          const compoundStateInit = {
+              baseLayer: state.baseLayer ||
+                  ((_a = this[PRIVATE$6].pendingRenderState) === null || _a === void 0 ? void 0 : _a.baseLayer) ||
+                  undefined,
+              depthFar: state.depthFar ||
+                  ((_b = this[PRIVATE$6].pendingRenderState) === null || _b === void 0 ? void 0 : _b.depthFar) ||
+                  undefined,
+              depthNear: state.depthNear ||
+                  ((_c = this[PRIVATE$6].pendingRenderState) === null || _c === void 0 ? void 0 : _c.depthNear) ||
+                  undefined,
+              inlineVerticalFieldOfView: state.inlineVerticalFieldOfView ||
+                  ((_d = this[PRIVATE$6].pendingRenderState) === null || _d === void 0 ? void 0 : _d.inlineVerticalFieldOfView) ||
+                  undefined,
+          };
+          this[PRIVATE$6].pendingRenderState = new XRRenderState(compoundStateInit, this[PRIVATE$6].renderState);
       }
       // the nominal frame rate updates are emulated, no actual update to the
       // display frame rate of the device will be executed
@@ -3495,6 +3660,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   class XRLayer extends EventTarget {
   }
   const PRIVATE$5 = Symbol('@immersive-web-emulation-runtime/XRWebGLLayer');
@@ -3559,6 +3730,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$4 = Symbol('@immersive-web-emulation-runtime/action-player');
   class ActionPlayer {
       constructor(refSpace, recording, ipd) {
@@ -3749,8 +3926,14 @@
       }
   }
 
-  const VERSION = "0.0.2";
+  const VERSION = "1.0.1";
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   class XRReferenceSpaceEvent extends Event {
       constructor(type, eventInitDict) {
           super(type, eventInitDict);
@@ -3762,6 +3945,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$3 = Symbol('@immersive-web-emulation-runtime/xr-system');
   class XRSystem extends EventTarget {
       constructor(device) {
@@ -3825,6 +4014,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE$2 = Symbol('@immersive-web-emulation-runtime/xr-viewport');
   class XRViewport {
       constructor(x, y, width, height) {
@@ -3844,6 +4039,12 @@
       }
   }
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   var WebXRFeatures;
   (function (WebXRFeatures) {
       WebXRFeatures["Viewer"] = "viewer";
@@ -3913,6 +4114,7 @@
               supportedFrameRates: deviceConfig.supportedFrameRates,
               isSystemKeyboardSupported: deviceConfig.isSystemKeyboardSupported,
               internalNominalFrameRate: deviceConfig.internalNominalFrameRate,
+              userAgent: deviceConfig.userAgent,
               position: (_b = deviceOptions.headsetPosition) !== null && _b !== void 0 ? _b : DEFAULTS.headsetPosition.clone(),
               quaternion: (_c = deviceOptions.headsetQuaternion) !== null && _c !== void 0 ? _c : DEFAULTS.headsetQuaternion.clone(),
               stereoEnabled: (_d = deviceOptions.stereoEnabled) !== null && _d !== void 0 ? _d : DEFAULTS.stereoEnabled,
@@ -4033,6 +4235,12 @@
               value: new XRSystem(this),
               configurable: true,
           });
+          Object.defineProperty(navigator, 'userAgent', {
+              value: this[PRIVATE$1].userAgent,
+              writable: false,
+              configurable: false,
+              enumerable: true,
+          });
           globalObject['XRSystem'] = XRSystem;
           globalObject['XRSession'] = XRSession;
           globalObject['XRRenderState'] = XRRenderState;
@@ -4187,7 +4395,12 @@
       }
   }
 
-  // value pulled from https://felixtrz.github.io/webxr-device-config/
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const gamepadConfigLeft = {
       mapping: GamepadMappingType.XRStandard,
       buttons: [
@@ -4337,6 +4550,12 @@
       },
   };
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const oculusQuest1 = {
       name: 'Oculus Quest 1',
       controllerConfig: oculusTouchV2,
@@ -4358,6 +4577,7 @@
       supportedFrameRates: [72, 80, 90],
       isSystemKeyboardSupported: true,
       internalNominalFrameRate: 72,
+      userAgent: 'Mozilla/5.0 (X11; Linux x86_64; Quest 1) AppleWebKit/537.36 (KHTML, like Gecko) OculusBrowser/33.0.0.x.x.x Chrome/126.0.6478.122 VR Safari/537.36',
   };
   const metaQuest2 = {
       name: 'Meta Quest 2',
@@ -4382,6 +4602,7 @@
       supportedFrameRates: [72, 80, 90, 120],
       isSystemKeyboardSupported: true,
       internalNominalFrameRate: 72,
+      userAgent: 'Mozilla/5.0 (X11; Linux x86_64; Quest 2) AppleWebKit/537.36 (KHTML, like Gecko) OculusBrowser/33.0.0.x.x.x Chrome/126.0.6478.122 VR Safari/537.36',
   };
   const metaQuestPro = {
       name: 'Meta Quest Pro',
@@ -4406,6 +4627,7 @@
       supportedFrameRates: [72, 80, 90, 120],
       isSystemKeyboardSupported: true,
       internalNominalFrameRate: 90,
+      userAgent: 'Mozilla/5.0 (X11; Linux x86_64; Quest Pro) AppleWebKit/537.36 (KHTML, like Gecko) OculusBrowser/33.0.0.x.x.x Chrome/126.0.6478.122 VR Safari/537.36',
   };
   const metaQuest3 = {
       name: 'Meta Quest 3',
@@ -4431,8 +4653,15 @@
       supportedFrameRates: [72, 80, 90, 120],
       isSystemKeyboardSupported: true,
       internalNominalFrameRate: 90,
+      userAgent: 'Mozilla/5.0 (X11; Linux x86_64; Quest 3) AppleWebKit/537.36 (KHTML, like Gecko) OculusBrowser/33.0.0.x.x.x Chrome/126.0.6478.122 VR Safari/537.36',
   };
 
+  /**
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
   const PRIVATE = Symbol('@immersive-web-emulation-runtime/action-recorder');
   const compress = (arr) => {
       const out = [];