belowjs 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -5,6 +5,9 @@ All notable changes to BelowJS will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.0] - 2025-11-09
+- Desktop Quest Link streaming support, best tried with the drag-and-drop viewer (<https://patrick-morrison.github.io/belowjs/examples/dragdrop/>).
+
 ## [1.2.0] - 2025-09-10
 
 ### Changed

package/README.md

@@ -6,7 +6,7 @@
 
 📖 **[Full Documentation & Examples](https://patrick-morrison.github.io/belowjs/)**
 
-> **Current Version:** `1.2.0` - Memory-hardened release with Safari/iOS loading fixes.
+> **Current Version:** `1.3.0` - Quest Link stability patch for WebXR optional features.
 
 **Dive Shipwrecks in Virtual Reality**
 
@@ -59,11 +59,11 @@ This gives you a complete VR-ready 3D viewer with dive lighting, measurement too
     {
         "imports": {
             "three": "https://cdn.jsdelivr.net/npm/three@0.179.1/+esm",
-            "belowjs": "https://cdn.jsdelivr.net/npm/belowjs@1.2.0/dist/belowjs.js"
+            "belowjs": "https://cdn.jsdelivr.net/npm/belowjs@1.3.0/dist/belowjs.js"
         }
     }
     </script>
-    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/belowjs@1.2.0/dist/belowjs.css">
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/belowjs@1.3.0/dist/belowjs.css">
     <style>
         body, html { margin: 0; padding: 0; overflow: hidden; }
     </style>
@@ -112,7 +112,7 @@ npm install && npm run build
 ### Live Examples
 
 - [Basic Viewer](https://patrick-morrison.github.io/belowjs/examples/basic/) — Full-featured multi-model viewer
-- [Drag & Drop](https://patrick-morrison.github.io/belowjs/examples/dragdrop/) — File loader with custom UI
+- [Drag & Drop](https://patrick-morrison.github.io/belowjs/examples/dragdrop/) — File loader with custom UI; recommended path for Meta Quest Link desktop streaming
 - [Embed Viewer](https://patrick-morrison.github.io/belowjs/examples/embed/) — Lightweight iframe-ready viewer
 
 ## Installation

package/dist/belowjs.js

@@ -3924,12 +3924,7 @@ class nn {
     try {
       this.waitForVRCSS().then(() => {
         const e = {
-          optionalFeatures: [
-            "hand-tracking",
-            "local-floor",
-            "bounded-floor",
-            "layers"
-          ]
+          optionalFeatures: this.getOptionalFeatures()
         };
         this.vrButton = Ee.createButton(this.renderer, e), this.vrButton.innerHTML = '<span class="vr-icon">🥽</span>ENTER VR', this.vrButton.className = "vr-button--glass vr-button-available", this.vrButton.disabled = !1, this.vrButton.style.cssText = `
           position: fixed !important;
@@ -3948,6 +3943,38 @@ class nn {
       console.error("❌ VR button creation failed:", e);
     }
   }
+  getOptionalFeatures() {
+    const e = ["hand-tracking", "local-floor"];
+    try {
+      this.supportsBoundedFloor() && e.push("bounded-floor");
+    } catch (t) {
+      console.warn("VR optional feature detection failed:", t);
+    }
+    return e;
+  }
+  supportsBoundedFloor() {
+    if (typeof navigator > "u" || this.isPolyfilledXR())
+      return !1;
+    const e = navigator.xr;
+    return e ? Array.isArray(e.supportedReferenceSpaceTypes) ? e.supportedReferenceSpaceTypes.includes("bounded-floor") : typeof window < "u" && typeof window.XRBoundedReferenceSpace < "u" : !1;
+  }
+  isPolyfilledXR() {
+    if (typeof window < "u" && typeof window.WebXRPolyfill < "u")
+      return !0;
+    if (typeof navigator > "u" || !navigator.xr)
+      return !1;
+    const e = navigator.xr, t = e.constructor && e.constructor.name;
+    if (t && t.toLowerCase().includes("polyfill"))
+      return !0;
+    try {
+      const i = e.requestSession && e.requestSession.toString();
+      if (typeof i == "string" && !i.includes("[native code]"))
+        return !0;
+    } catch {
+      return !0;
+    }
+    return !1;
+  }
   styleVRButton() {
     const e = () => {
       const t = document.querySelector("button.vr-button--glass") || document.querySelector("button") || this.vrButton;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "belowjs",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "A modular Three.js library for creating immersive underwater/dive model viewers with VR support",
   "main": "dist/belowjs.js",
   "module": "dist/belowjs.js",