@plasius/gpu-xr 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## 0.1.0 - 2026-02-10
+
+- Initial scaffold for `@plasius/gpu-xr`.
+- Added framework-agnostic WebXR support probing and session lifecycle APIs.
+- Added unit tests, demo, and ADR documentation.

package/LICENSE

@@ -0,0 +1,203 @@
+Copyright 2025 Plasius LTD
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1.  Definitions.
+
+    "License" shall mean the terms and conditions for use, reproduction,
+    and distribution as defined by Sections 1 through 9 of this document.
+
+    "Licensor" shall mean the copyright owner or entity authorized by
+    the copyright owner that is granting the License.
+
+    "Legal Entity" shall mean the union of the acting entity and all
+    other entities that control, are controlled by, or are under common
+    control with that entity. For the purposes of this definition,
+    "control" means (i) the power, direct or indirect, to cause the
+    direction or management of such entity, whether by contract or
+    otherwise, or (ii) ownership of fifty percent (50%) or more of the
+    outstanding shares, or (iii) beneficial ownership of such entity.
+
+    "You" (or "Your") shall mean an individual or Legal Entity
+    exercising permissions granted by this License.
+
+    "Source" form shall mean the preferred form for making modifications,
+    including but not limited to software source code, documentation
+    source, and configuration files.
+
+    "Object" form shall mean any form resulting from mechanical
+    transformation or translation of a Source form, including but
+    not limited to compiled object code, generated documentation,
+    and conversions to other media types.
+
+    "Work" shall mean the work of authorship, whether in Source or
+    Object form, made available under the License, as indicated by a
+    copyright notice that is included in or attached to the work
+    (an example is provided in the Appendix below).
+
+    "Derivative Works" shall mean any work, whether in Source or Object
+    form, that is based on (or derived from) the Work and for which the
+    editorial revisions, annotations, elaborations, or other modifications
+    represent, as a whole, an original work of authorship. For the purposes
+    of this License, Derivative Works shall not include works that remain
+    separable from, or merely link (or bind by name) to the interfaces of,
+    the Work and Derivative Works thereof.
+
+    "Contribution" shall mean any work of authorship, including
+    the original version of the Work and any modifications or additions
+    to that Work or Derivative Works thereof, that is intentionally
+    submitted to Licensor for inclusion in the Work by the copyright owner
+    or by an individual or Legal Entity authorized to submit on behalf of
+    the copyright owner. For the purposes of this definition, "submitted"
+    means any form of electronic, verbal, or written communication sent
+    to the Licensor or its representatives, including but not limited to
+    communication on electronic mailing lists, source code control systems,
+    and issue tracking systems that are managed by, or on behalf of, the
+    Licensor for the purpose of discussing and improving the Work, but
+    excluding communication that is conspicuously marked or otherwise
+    designated in writing by the copyright owner as "Not a Contribution."
+
+    "Contributor" shall mean Licensor and any individual or Legal Entity
+    on behalf of whom a Contribution has been received by Licensor and
+    subsequently incorporated within the Work.
+
+2.  Grant of Copyright License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    copyright license to reproduce, prepare Derivative Works of,
+    publicly display, publicly perform, sublicense, and distribute the
+    Work and such Derivative Works in Source or Object form.
+
+3.  Grant of Patent License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    (except as stated in this section) patent license to make, have made,
+    use, offer to sell, sell, import, and otherwise transfer the Work,
+    where such license applies only to those patent claims licensable
+    by such Contributor that are necessarily infringed by their
+    Contribution(s) alone or by combination of their Contribution(s)
+    with the Work to which such Contribution(s) was submitted. If You
+    institute patent litigation against any entity (including a
+    cross-claim or counterclaim in a lawsuit) alleging that the Work
+    or a Contribution incorporated within the Work constitutes direct
+    or contributory patent infringement, then any patent licenses
+    granted to You under this License for that Work shall terminate
+    as of the date such litigation is filed.
+
+4.  Redistribution. You may reproduce and distribute copies of the
+    Work or Derivative Works thereof in any medium, with or without
+    modifications, and in Source or Object form, provided that You
+    meet the following conditions:
+
+    (a) You must give any other recipients of the Work or
+    Derivative Works a copy of this License; and
+
+    (b) You must cause any modified files to carry prominent notices
+    stating that You changed the files; and
+
+    (c) You must retain, in the Source form of any Derivative Works
+    that You distribute, all copyright, patent, trademark, and
+    attribution notices from the Source form of the Work,
+    excluding those notices that do not pertain to any part of
+    the Derivative Works; and
+
+    (d) If the Work includes a "NOTICE" text file as part of its
+    distribution, then any Derivative Works that You distribute must
+    include a readable copy of the attribution notices contained
+    within such NOTICE file, excluding those notices that do not
+    pertain to any part of the Derivative Works, in at least one
+    of the following places: within a NOTICE text file distributed
+    as part of the Derivative Works; within the Source form or
+    documentation, if provided along with the Derivative Works; or,
+    within a display generated by the Derivative Works, if and
+    wherever such third-party notices normally appear. The contents
+    of the NOTICE file are for informational purposes only and
+    do not modify the License. You may add Your own attribution
+    notices within Derivative Works that You distribute, alongside
+    or as an addendum to the NOTICE text from the Work, provided
+    that such additional attribution notices cannot be construed
+    as modifying the License.
+
+    You may add Your own copyright statement to Your modifications and
+    may provide additional or different license terms and conditions
+    for use, reproduction, or distribution of Your modifications, or
+    for any such Derivative Works as a whole, provided Your use,
+    reproduction, and distribution of the Work otherwise complies with
+    the conditions stated in this License.
+
+5.  Submission of Contributions. Unless You explicitly state otherwise,
+    any Contribution intentionally submitted for inclusion in the Work
+    by You to the Licensor shall be under the terms and conditions of
+    this License, without any additional terms or conditions.
+    Notwithstanding the above, nothing herein shall supersede or modify
+    the terms of any separate license agreement you may have executed
+    with Licensor regarding such Contributions.
+
+6.  Trademarks. This License does not grant permission to use the trade
+    names, trademarks, service marks, or product names of the Licensor,
+    except as required for reasonable and customary use in describing the
+    origin of the Work and reproducing the content of the NOTICE file.
+
+7.  Disclaimer of Warranty. Unless required by applicable law or
+    agreed to in writing, Licensor provides the Work (and each
+    Contributor provides its Contributions) on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+    implied, including, without limitation, any warranties or conditions
+    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+    PARTICULAR PURPOSE. You are solely responsible for determining the
+    appropriateness of using or redistributing the Work and assume any
+    risks associated with Your exercise of permissions under this License.
+
+8.  Limitation of Liability. In no event and under no legal theory,
+    whether in tort (including negligence), contract, or otherwise,
+    unless required by applicable law (such as deliberate and grossly
+    negligent acts) or agreed to in writing, shall any Contributor be
+    liable to You for damages, including any direct, indirect, special,
+    incidental, or consequential damages of any character arising as a
+    result of this License or out of the use or inability to use the
+    Work (including but not limited to damages for loss of goodwill,
+    work stoppage, computer failure or malfunction, or any and all
+    other commercial damages or losses), even if such Contributor
+    has been advised of the possibility of such damages.
+
+9.  Accepting Warranty or Additional Liability. While redistributing
+    the Work or Derivative Works thereof, You may choose to offer,
+    and charge a fee for, acceptance of support, warranty, indemnity,
+    or other liability obligations and/or rights consistent with this
+    License. However, in accepting such obligations, You may act only
+    on Your own behalf and on Your sole responsibility, not on behalf
+    of any other Contributor, and only if You agree to indemnify,
+    defend, and hold each Contributor harmless for any liability
+    incurred by, or claims asserted against, such Contributor by reason
+    of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,59 @@
+# @plasius/gpu-xr
+
+[![npm version](https://img.shields.io/npm/v/@plasius/gpu-xr)](https://www.npmjs.com/package/@plasius/gpu-xr)
+[![license](https://img.shields.io/github/license/Plasius-LTD/gpu-xr)](./LICENSE)
+
+Framework-agnostic WebXR session management for Plasius GPU rendering projects.
+This package isolates VR session lifecycle and capability probing so app layers can
+replace Three.js and still keep immersive workflows.
+
+Apache-2.0. ESM + CJS builds.
+
+## Install
+
+```sh
+npm install @plasius/gpu-xr
+```
+
+## Usage
+
+```js
+import { createXrManager } from "@plasius/gpu-xr";
+
+const xr = createXrManager();
+await xr.probeSupport(["immersive-vr"]);
+
+const session = await xr.enterVr({
+  optionalFeatures: ["depth-sensing", "layers"],
+});
+
+// ... bind WebGPU render state to the session ...
+
+await xr.exitSession();
+```
+
+## API
+
+- `isXrModeSupported(mode, options)`
+- `requestXrSession(options)`
+- `createXrStore(initialState)`
+- `createXrManager(options)`
+- `mergeXrSessionInit(base, override)`
+- `defaultVrSessionInit`
+
+## Demo
+
+Run the demo server from the repo root:
+
+```sh
+cd gpu-xr
+npm run demo
+```
+
+Then open `http://localhost:8000/gpu-xr/demo/`.
+
+## Files
+
+- `src/index.js`: XR runtime/session manager and store.
+- `tests/package.test.js`: Unit tests for support probing and lifecycle handling.
+- `docs/adrs/*`: XR architecture decisions.

package/dist/index.cjs

@@ -0,0 +1,312 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.js
+var index_exports = {};
+__export(index_exports, {
+  createXrManager: () => createXrManager,
+  createXrStore: () => createXrStore,
+  defaultVrSessionInit: () => defaultVrSessionInit,
+  isXrModeSupported: () => isXrModeSupported,
+  mergeXrSessionInit: () => mergeXrSessionInit,
+  requestXrSession: () => requestXrSession,
+  xrReferenceSpaceTypes: () => xrReferenceSpaceTypes,
+  xrSessionModes: () => xrSessionModes
+});
+module.exports = __toCommonJS(index_exports);
+var DEFAULT_VR_SESSION_INIT = Object.freeze({
+  requiredFeatures: ["local-floor"],
+  optionalFeatures: ["bounded-floor", "hand-tracking", "layers"]
+});
+var xrSessionModes = Object.freeze([
+  "inline",
+  "immersive-vr",
+  "immersive-ar"
+]);
+var xrReferenceSpaceTypes = Object.freeze([
+  "viewer",
+  "local",
+  "local-floor",
+  "bounded-floor",
+  "unbounded"
+]);
+function toStringArray(values) {
+  if (!Array.isArray(values)) {
+    return [];
+  }
+  return values.filter((value) => typeof value === "string").map((value) => value.trim()).filter(Boolean);
+}
+function dedupeStrings(values) {
+  return [...new Set(toStringArray(values))];
+}
+function readNavigator(navigatorOverride) {
+  const currentNavigator = navigatorOverride ?? globalThis.navigator;
+  if (!currentNavigator || typeof currentNavigator !== "object") {
+    throw new Error(
+      "WebXR navigator unavailable. Provide a browser navigator with navigator.xr."
+    );
+  }
+  return currentNavigator;
+}
+function readXrSystem(navigatorOverride) {
+  const currentNavigator = readNavigator(navigatorOverride);
+  const xr = currentNavigator.xr;
+  if (!xr || typeof xr !== "object") {
+    throw new Error(
+      "WebXR runtime unavailable. navigator.xr is missing in this environment."
+    );
+  }
+  return xr;
+}
+function assertSessionMode(mode) {
+  if (!xrSessionModes.includes(mode)) {
+    const available = xrSessionModes.join(", ");
+    throw new Error(
+      `Unknown XR session mode "${mode}". Available modes: ${available}.`
+    );
+  }
+}
+function mergeXrSessionInit(base = {}, override = {}) {
+  const requiredFeatures = dedupeStrings([
+    ...toStringArray(base.requiredFeatures),
+    ...toStringArray(override.requiredFeatures)
+  ]);
+  const optionalFeatures = dedupeStrings([
+    ...toStringArray(base.optionalFeatures),
+    ...toStringArray(override.optionalFeatures)
+  ]);
+  const merged = {
+    ...base,
+    ...override,
+    requiredFeatures,
+    optionalFeatures
+  };
+  if (requiredFeatures.length === 0) {
+    delete merged.requiredFeatures;
+  }
+  if (optionalFeatures.length === 0) {
+    delete merged.optionalFeatures;
+  }
+  return merged;
+}
+async function isXrModeSupported(mode = "immersive-vr", options = {}) {
+  assertSessionMode(mode);
+  const { navigator: navigatorOverride } = options;
+  let xr;
+  try {
+    xr = readXrSystem(navigatorOverride);
+  } catch {
+    return false;
+  }
+  if (typeof xr.isSessionSupported !== "function") {
+    return false;
+  }
+  try {
+    return Boolean(await xr.isSessionSupported(mode));
+  } catch {
+    return false;
+  }
+}
+async function requestXrSession(options = {}) {
+  const {
+    mode = "immersive-vr",
+    sessionInit = {},
+    baseSessionInit = DEFAULT_VR_SESSION_INIT,
+    navigator: navigatorOverride
+  } = options;
+  assertSessionMode(mode);
+  const xr = readXrSystem(navigatorOverride);
+  if (typeof xr.requestSession !== "function") {
+    throw new Error("WebXR requestSession API unavailable.");
+  }
+  const init = mergeXrSessionInit(baseSessionInit, sessionInit);
+  return xr.requestSession(mode, init);
+}
+function createXrStore(initialState = {}) {
+  const listeners = /* @__PURE__ */ new Set();
+  let state = {
+    activeSession: null,
+    mode: null,
+    isEntering: false,
+    lastError: null,
+    supportedModes: {},
+    ...initialState
+  };
+  const notify = () => {
+    for (const listener of listeners) {
+      listener(state);
+    }
+  };
+  return {
+    getSnapshot() {
+      return state;
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    set(partialState) {
+      state = {
+        ...state,
+        ...partialState
+      };
+      notify();
+    },
+    reset() {
+      state = {
+        activeSession: null,
+        mode: null,
+        isEntering: false,
+        lastError: null,
+        supportedModes: {},
+        ...initialState
+      };
+      notify();
+    }
+  };
+}
+function createXrManager(options = {}) {
+  const {
+    navigator: navigatorOverride,
+    defaultMode = "immersive-vr",
+    baseSessionInit = DEFAULT_VR_SESSION_INIT,
+    onSessionStart,
+    onSessionEnd
+  } = options;
+  assertSessionMode(defaultMode);
+  const store = createXrStore();
+  let activeSessionEndHandler = null;
+  const detachSessionEndHandler = () => {
+    const { activeSession } = store.getSnapshot();
+    if (activeSession && activeSessionEndHandler && typeof activeSession.removeEventListener === "function") {
+      activeSession.removeEventListener("end", activeSessionEndHandler);
+    }
+    activeSessionEndHandler = null;
+  };
+  const handleSessionEnded = () => {
+    detachSessionEndHandler();
+    store.set({
+      activeSession: null,
+      mode: null,
+      isEntering: false
+    });
+    if (typeof onSessionEnd === "function") {
+      onSessionEnd();
+    }
+  };
+  const attachSessionEndHandler = (session) => {
+    if (!session || typeof session.addEventListener !== "function") {
+      return;
+    }
+    activeSessionEndHandler = handleSessionEnded;
+    session.addEventListener("end", activeSessionEndHandler);
+  };
+  const getState = () => store.getSnapshot();
+  const subscribe = (listener) => store.subscribe(listener);
+  const probeSupport = async (modes = [defaultMode]) => {
+    const supportedModes = {};
+    for (const mode of modes) {
+      assertSessionMode(mode);
+      supportedModes[mode] = await isXrModeSupported(mode, {
+        navigator: navigatorOverride
+      });
+    }
+    store.set({ supportedModes });
+    return supportedModes;
+  };
+  const enterSession = async (mode = defaultMode, sessionInit = {}) => {
+    assertSessionMode(mode);
+    const existing = store.getSnapshot().activeSession;
+    if (existing) {
+      return existing;
+    }
+    store.set({ isEntering: true, lastError: null });
+    try {
+      const session = await requestXrSession({
+        mode,
+        sessionInit,
+        baseSessionInit,
+        navigator: navigatorOverride
+      });
+      attachSessionEndHandler(session);
+      store.set({
+        activeSession: session,
+        mode,
+        isEntering: false,
+        lastError: null
+      });
+      if (typeof onSessionStart === "function") {
+        onSessionStart(session, mode);
+      }
+      return session;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error ?? "Unknown XR error");
+      store.set({
+        isEntering: false,
+        lastError: message
+      });
+      throw error;
+    }
+  };
+  const enterVr = async (sessionInit = {}) => {
+    return enterSession("immersive-vr", sessionInit);
+  };
+  const exitSession = async () => {
+    const { activeSession } = store.getSnapshot();
+    if (!activeSession) {
+      return false;
+    }
+    if (typeof activeSession.end === "function") {
+      await activeSession.end();
+    }
+    if (store.getSnapshot().activeSession) {
+      handleSessionEnded();
+    }
+    return true;
+  };
+  const dispose = async () => {
+    await exitSession();
+    detachSessionEndHandler();
+    store.reset();
+  };
+  return {
+    store,
+    getState,
+    subscribe,
+    probeSupport,
+    enterSession,
+    enterVr,
+    exitSession,
+    dispose
+  };
+}
+var defaultVrSessionInit = DEFAULT_VR_SESSION_INIT;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createXrManager,
+  createXrStore,
+  defaultVrSessionInit,
+  isXrModeSupported,
+  mergeXrSessionInit,
+  requestXrSession,
+  xrReferenceSpaceTypes,
+  xrSessionModes
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.js"],"sourcesContent":["const DEFAULT_VR_SESSION_INIT = Object.freeze({\n  requiredFeatures: [\"local-floor\"],\n  optionalFeatures: [\"bounded-floor\", \"hand-tracking\", \"layers\"],\n});\n\nexport const xrSessionModes = Object.freeze([\n  \"inline\",\n  \"immersive-vr\",\n  \"immersive-ar\",\n]);\n\nexport const xrReferenceSpaceTypes = Object.freeze([\n  \"viewer\",\n  \"local\",\n  \"local-floor\",\n  \"bounded-floor\",\n  \"unbounded\",\n]);\n\nfunction toStringArray(values) {\n  if (!Array.isArray(values)) {\n    return [];\n  }\n  return values\n    .filter((value) => typeof value === \"string\")\n    .map((value) => value.trim())\n    .filter(Boolean);\n}\n\nfunction dedupeStrings(values) {\n  return [...new Set(toStringArray(values))];\n}\n\nfunction readNavigator(navigatorOverride) {\n  const currentNavigator = navigatorOverride ?? globalThis.navigator;\n  if (!currentNavigator || typeof currentNavigator !== \"object\") {\n    throw new Error(\n      \"WebXR navigator unavailable. Provide a browser navigator with navigator.xr.\"\n    );\n  }\n  return currentNavigator;\n}\n\nfunction readXrSystem(navigatorOverride) {\n  const currentNavigator = readNavigator(navigatorOverride);\n  const xr = currentNavigator.xr;\n  if (!xr || typeof xr !== \"object\") {\n    throw new Error(\n      \"WebXR runtime unavailable. navigator.xr is missing in this environment.\"\n    );\n  }\n  return xr;\n}\n\nfunction assertSessionMode(mode) {\n  if (!xrSessionModes.includes(mode)) {\n    const available = xrSessionModes.join(\", \");\n    throw new Error(\n      `Unknown XR session mode \\\"${mode}\\\". Available modes: ${available}.`\n    );\n  }\n}\n\nexport function mergeXrSessionInit(base = {}, override = {}) {\n  const requiredFeatures = dedupeStrings([\n    ...toStringArray(base.requiredFeatures),\n    ...toStringArray(override.requiredFeatures),\n  ]);\n\n  const optionalFeatures = dedupeStrings([\n    ...toStringArray(base.optionalFeatures),\n    ...toStringArray(override.optionalFeatures),\n  ]);\n\n  const merged = {\n    ...base,\n    ...override,\n    requiredFeatures,\n    optionalFeatures,\n  };\n\n  if (requiredFeatures.length === 0) {\n    delete merged.requiredFeatures;\n  }\n\n  if (optionalFeatures.length === 0) {\n    delete merged.optionalFeatures;\n  }\n\n  return merged;\n}\n\nexport async function isXrModeSupported(\n  mode = \"immersive-vr\",\n  options = {}\n) {\n  assertSessionMode(mode);\n\n  const { navigator: navigatorOverride } = options;\n  let xr;\n  try {\n    xr = readXrSystem(navigatorOverride);\n  } catch {\n    return false;\n  }\n\n  if (typeof xr.isSessionSupported !== \"function\") {\n    return false;\n  }\n\n  try {\n    return Boolean(await xr.isSessionSupported(mode));\n  } catch {\n    return false;\n  }\n}\n\nexport async function requestXrSession(options = {}) {\n  const {\n    mode = \"immersive-vr\",\n    sessionInit = {},\n    baseSessionInit = DEFAULT_VR_SESSION_INIT,\n    navigator: navigatorOverride,\n  } = options;\n\n  assertSessionMode(mode);\n\n  const xr = readXrSystem(navigatorOverride);\n\n  if (typeof xr.requestSession !== \"function\") {\n    throw new Error(\"WebXR requestSession API unavailable.\");\n  }\n\n  const init = mergeXrSessionInit(baseSessionInit, sessionInit);\n  return xr.requestSession(mode, init);\n}\n\nexport function createXrStore(initialState = {}) {\n  const listeners = new Set();\n  let state = {\n    activeSession: null,\n    mode: null,\n    isEntering: false,\n    lastError: null,\n    supportedModes: {},\n    ...initialState,\n  };\n\n  const notify = () => {\n    for (const listener of listeners) {\n      listener(state);\n    }\n  };\n\n  return {\n    getSnapshot() {\n      return state;\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    set(partialState) {\n      state = {\n        ...state,\n        ...partialState,\n      };\n      notify();\n    },\n    reset() {\n      state = {\n        activeSession: null,\n        mode: null,\n        isEntering: false,\n        lastError: null,\n        supportedModes: {},\n        ...initialState,\n      };\n      notify();\n    },\n  };\n}\n\nexport function createXrManager(options = {}) {\n  const {\n    navigator: navigatorOverride,\n    defaultMode = \"immersive-vr\",\n    baseSessionInit = DEFAULT_VR_SESSION_INIT,\n    onSessionStart,\n    onSessionEnd,\n  } = options;\n\n  assertSessionMode(defaultMode);\n\n  const store = createXrStore();\n  let activeSessionEndHandler = null;\n\n  const detachSessionEndHandler = () => {\n    const { activeSession } = store.getSnapshot();\n    if (\n      activeSession &&\n      activeSessionEndHandler &&\n      typeof activeSession.removeEventListener === \"function\"\n    ) {\n      activeSession.removeEventListener(\"end\", activeSessionEndHandler);\n    }\n    activeSessionEndHandler = null;\n  };\n\n  const handleSessionEnded = () => {\n    detachSessionEndHandler();\n    store.set({\n      activeSession: null,\n      mode: null,\n      isEntering: false,\n    });\n    if (typeof onSessionEnd === \"function\") {\n      onSessionEnd();\n    }\n  };\n\n  const attachSessionEndHandler = (session) => {\n    if (!session || typeof session.addEventListener !== \"function\") {\n      return;\n    }\n    activeSessionEndHandler = handleSessionEnded;\n    session.addEventListener(\"end\", activeSessionEndHandler);\n  };\n\n  const getState = () => store.getSnapshot();\n\n  const subscribe = (listener) => store.subscribe(listener);\n\n  const probeSupport = async (modes = [defaultMode]) => {\n    const supportedModes = {};\n    for (const mode of modes) {\n      assertSessionMode(mode);\n      supportedModes[mode] = await isXrModeSupported(mode, {\n        navigator: navigatorOverride,\n      });\n    }\n    store.set({ supportedModes });\n    return supportedModes;\n  };\n\n  const enterSession = async (mode = defaultMode, sessionInit = {}) => {\n    assertSessionMode(mode);\n\n    const existing = store.getSnapshot().activeSession;\n    if (existing) {\n      return existing;\n    }\n\n    store.set({ isEntering: true, lastError: null });\n\n    try {\n      const session = await requestXrSession({\n        mode,\n        sessionInit,\n        baseSessionInit,\n        navigator: navigatorOverride,\n      });\n\n      attachSessionEndHandler(session);\n\n      store.set({\n        activeSession: session,\n        mode,\n        isEntering: false,\n        lastError: null,\n      });\n\n      if (typeof onSessionStart === \"function\") {\n        onSessionStart(session, mode);\n      }\n\n      return session;\n    } catch (error) {\n      const message =\n        error instanceof Error ? error.message : String(error ?? \"Unknown XR error\");\n      store.set({\n        isEntering: false,\n        lastError: message,\n      });\n      throw error;\n    }\n  };\n\n  const enterVr = async (sessionInit = {}) => {\n    return enterSession(\"immersive-vr\", sessionInit);\n  };\n\n  const exitSession = async () => {\n    const { activeSession } = store.getSnapshot();\n    if (!activeSession) {\n      return false;\n    }\n\n    if (typeof activeSession.end === \"function\") {\n      await activeSession.end();\n    }\n\n    // Fallback for test fakes or runtimes that do not emit an end event.\n    if (store.getSnapshot().activeSession) {\n      handleSessionEnded();\n    }\n\n    return true;\n  };\n\n  const dispose = async () => {\n    await exitSession();\n    detachSessionEndHandler();\n    store.reset();\n  };\n\n  return {\n    store,\n    getState,\n    subscribe,\n    probeSupport,\n    enterSession,\n    enterVr,\n    exitSession,\n    dispose,\n  };\n}\n\nexport const defaultVrSessionInit = DEFAULT_VR_SESSION_INIT;\n"],"mappings":"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","names":[]}