@driftengine/xr 4.8.1 → 4.8.2

package/dist/support.d.ts

@@ -35,7 +35,14 @@ export interface XrSupport {
     /** Empty when a session could be entered. A whole sentence otherwise. */
     readonly reason: string;
 }
-/** A context that can be asked to become XR compatible. Both backends' contexts satisfy it. */
+/**
+ * A context that can be asked to become XR compatible: what `probeXrSupport` looks for on the
+ * object it is handed.
+ *
+ * **Not the parameter's type**, which is any object. One optional member makes this a weak type,
+ * and the DOM types do not declare `makeXRCompatible` on `WebGL2RenderingContext`, so typed as this
+ * the context every game draws with failed to compile until it was cast.
+ */
 export interface XrCompatibleContext {
     makeXRCompatible?(): Promise<void>;
 }
@@ -46,6 +53,6 @@ export interface XrCompatibleContext {
  * Without one, `compatible` is false and `reason` says the question was not asked, which is a
  * different thing from asked and refused.
  */
-export declare function probeXrSupport(context?: XrCompatibleContext | null, override?: XrSystem | null): Promise<XrSupport>;
+export declare function probeXrSupport(context?: object | null, override?: XrSystem | null): Promise<XrSupport>;
 /** The best mode this support answer allows, or null when none is worth asking for. */
 export declare function bestMode(support: XrSupport): XrMode | null;

package/dist/support.js

@@ -68,13 +68,15 @@ override) {
     ]);
     let compatible = false;
     let compatibleReason = '';
-    if (context?.makeXRCompatible === undefined) {
+    const offered = (context ?? null);
+    const makeCompatible = typeof offered?.makeXRCompatible === 'function' ? offered.makeXRCompatible.bind(offered) : null;
+    if (makeCompatible === null) {
         compatibleReason =
             'no rendering context was offered, so whether one can be made XR compatible is unasked.';
     }
     else {
         try {
-            await context.makeXRCompatible();
+            await makeCompatible();
             compatible = true;
         }
         catch (error) {
@@ -96,7 +98,7 @@ override) {
      */
     const anyMode = immersiveVr || immersiveAr || inline;
     let reason = '';
-    if (context?.makeXRCompatible !== undefined && !compatible) {
+    if (makeCompatible !== null && !compatible) {
         reason = compatibleReason;
     }
     else if (!anyMode) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftengine/xr",
-  "version": "4.8.1",
+  "version": "4.8.2",
   "description": "WebXR sessions, stereo views, controller input and hand joints, over both backends",
   "license": "Apache-2.0",
   "type": "module",
@@ -30,7 +30,7 @@
     "gl-matrix": "^3.4.3"
   },
   "peerDependencies": {
-    "@driftengine/core": "4.8.1"
+    "@driftengine/core": "4.8.2"
   },
   "author": "Drift Technologies",
   "repository": {

package/src/support.ts

@@ -47,7 +47,14 @@ const NOTHING: XrSupport = {
   reason: 'this browser has no WebXR: navigator.xr is not defined.',
 };
 
-/** A context that can be asked to become XR compatible. Both backends' contexts satisfy it. */
+/**
+ * A context that can be asked to become XR compatible: what `probeXrSupport` looks for on the
+ * object it is handed.
+ *
+ * **Not the parameter's type**, which is any object. One optional member makes this a weak type,
+ * and the DOM types do not declare `makeXRCompatible` on `WebGL2RenderingContext`, so typed as this
+ * the context every game draws with failed to compile until it was cast.
+ */
 export interface XrCompatibleContext {
   makeXRCompatible?(): Promise<void>;
 }
@@ -78,7 +85,7 @@ async function supports(system: XrSystem, mode: XrMode): Promise<boolean> {
  * different thing from asked and refused.
  */
 export async function probeXrSupport(
-  context?: XrCompatibleContext | null,
+  context?: object | null,
   /*
    * The system, overridable for the same reason `enterXr` takes one: a test cannot assign
    * `globalThis.navigator`, which is getter-only, and stubbing a global to ask a question about a
@@ -97,12 +104,15 @@ export async function probeXrSupport(
 
   let compatible = false;
   let compatibleReason = '';
-  if (context?.makeXRCompatible === undefined) {
+  const offered = (context ?? null) as XrCompatibleContext | null;
+  const makeCompatible =
+    typeof offered?.makeXRCompatible === 'function' ? offered.makeXRCompatible.bind(offered) : null;
+  if (makeCompatible === null) {
     compatibleReason =
       'no rendering context was offered, so whether one can be made XR compatible is unasked.';
   } else {
     try {
-      await context.makeXRCompatible();
+      await makeCompatible();
       compatible = true;
     } catch (error) {
       const name = (error as Error)?.name ?? 'Error';
@@ -124,7 +134,7 @@ export async function probeXrSupport(
    */
   const anyMode = immersiveVr || immersiveAr || inline;
   let reason = '';
-  if (context?.makeXRCompatible !== undefined && !compatible) {
+  if (makeCompatible !== null && !compatible) {
     reason = compatibleReason;
   } else if (!anyMode) {
     reason =