@vived/host 4.3.0 → 4.4.1

package/dist/esm/ZSpaceHost/UCs/StartZSpace/StartZSpaceUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"StartZSpaceUC.js","sourceRoot":"","sources":["../../../../../src/ZSpaceHost/UCs/StartZSpace/StartZSpaceUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAiB,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,OAAgB,aAAc,SAAQ,WAAW;IAKrD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9E,CAAC;;AANM,kBAAI,GAAG,eAAe,CAAC","sourcesContent":["import { getSingletonComponent, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\n\r\nexport abstract class StartZSpaceUC extends AppObjectUC {\r\n  static type = \"StartZSpaceUC\";\r\n\r\n  abstract startZSpace(): Promise<void>;\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<StartZSpaceUC>(StartZSpaceUC.type, appObjects);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"StartZSpaceUC.js","sourceRoot":"","sources":["../../../../../src/ZSpaceHost/UCs/StartZSpace/StartZSpaceUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAiB,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,OAAgB,aAAc,SAAQ,WAAW;IAUrD;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9E,CAAC;;AAhBM,kBAAI,GAAG,eAAe,CAAC","sourcesContent":["import { getSingletonComponent, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\n\r\n/**\r\n * StartZSpaceUC is a singleton Use Case responsible for starting a zSpace session.\r\n *\r\n * This Use Case handles:\r\n * 1. Setting up and initializing the zSpace XR session\r\n * 2. Updating the ZSpaceHostEntity to reflect the active state\r\n * 3. Handling errors in the setup process\r\n *\r\n * Usage:\r\n * ```typescript\r\n * // In a controller or UI event handler:\r\n * const startZSpace = async (appObjects) => {\r\n *   const uc = StartZSpaceUC.get(appObjects);\r\n *   if (!uc) {\r\n *     console.error(\"StartZSpaceUC not found\");\r\n *     return;\r\n *   }\r\n *\r\n *   try {\r\n *     await uc.startZSpace();\r\n *     console.log(\"zSpace session started successfully\");\r\n *   } catch (error) {\r\n *     console.error(\"Failed to start zSpace session:\", error);\r\n *   }\r\n * };\r\n * ```\r\n *\r\n * Important notes:\r\n * - This is an asynchronous operation and may take some time to complete\r\n * - Success/failure is indicated by the Promise resolution/rejection\r\n * - When successful, ZSpaceHostEntity.isActive will be set to true\r\n * - UI components should observe ZSpaceIsActivePM to react to state changes\r\n */\r\nexport abstract class StartZSpaceUC extends AppObjectUC {\r\n  static type = \"StartZSpaceUC\";\r\n\r\n  /**\r\n   * Start the zSpace session\r\n   * @returns A Promise that resolves when the session has started successfully,\r\n   *          or rejects with an error if the session could not be started\r\n   */\r\n  abstract startZSpace(): Promise<void>;\r\n\r\n  /**\r\n   * Get the singleton instance of StartZSpaceUC\r\n   * @param appObjects - The AppObjectRepo instance\r\n   * @returns The StartZSpaceUC instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<StartZSpaceUC>(StartZSpaceUC.type, appObjects);\r\n  }\r\n}\r\n"]}

package/dist/esm/ZSpaceHost/UCs/StopZSpace/StopZSpaceUC.js

@@ -1,5 +1,41 @@
 import { getSingletonComponent, AppObjectUC } from "@vived/core";
+/**
+ * StopZSpaceUC is a singleton Use Case responsible for stopping an active zSpace session.
+ *
+ * This Use Case handles:
+ * 1. Properly ending the current zSpace XR session
+ * 2. Cleaning up resources associated with the session
+ * 3. Updating the ZSpaceHostEntity to reflect the inactive state
+ *
+ * Usage:
+ * ```typescript
+ * // In a controller or UI event handler:
+ * const stopZSpace = (appObjects) => {
+ *   const uc = StopZSpaceUC.get(appObjects);
+ *   if (!uc) {
+ *     console.error("StopZSpaceUC not found");
+ *     return;
+ *   }
+ *
+ *   uc.stopZSpace();
+ *   console.log("zSpace session stopped");
+ * };
+ * ```
+ *
+ * Important notes:
+ * - This is a synchronous operation and completes immediately
+ * - When called, ZSpaceHostEntity.isActive will be set to false
+ * - UI components should observe ZSpaceIsActivePM to react to state changes
+ * - This should be called when the application no longer needs zSpace features
+ * - It's good practice to call this before application shutdown or when
+ *   transitioning to a non-zSpace part of the application
+ */
 export class StopZSpaceUC extends AppObjectUC {
+    /**
+     * Get the singleton instance of StopZSpaceUC
+     * @param appObjects - The AppObjectRepo instance
+     * @returns The StopZSpaceUC instance or undefined if not found
+     */
     static get(appObjects) {
         return getSingletonComponent(StopZSpaceUC.type, appObjects);
     }

package/dist/esm/ZSpaceHost/UCs/StopZSpace/StopZSpaceUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"StopZSpaceUC.js","sourceRoot":"","sources":["../../../../../src/ZSpaceHost/UCs/StopZSpace/StopZSpaceUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAiB,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,OAAgB,YAAa,SAAQ,WAAW;IAKpD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAe,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5E,CAAC;;AANM,iBAAI,GAAG,cAAc,CAAC","sourcesContent":["import { getSingletonComponent, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\n\r\nexport abstract class StopZSpaceUC extends AppObjectUC {\r\n  static type = \"StopZSpaceUC\";\r\n\r\n  abstract stopZSpace(): void;\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<StopZSpaceUC>(StopZSpaceUC.type, appObjects);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"StopZSpaceUC.js","sourceRoot":"","sources":["../../../../../src/ZSpaceHost/UCs/StopZSpace/StopZSpaceUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAiB,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,OAAgB,YAAa,SAAQ,WAAW;IASpD;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAe,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5E,CAAC;;AAfM,iBAAI,GAAG,cAAc,CAAC","sourcesContent":["import { getSingletonComponent, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\n\r\n/**\r\n * StopZSpaceUC is a singleton Use Case responsible for stopping an active zSpace session.\r\n *\r\n * This Use Case handles:\r\n * 1. Properly ending the current zSpace XR session\r\n * 2. Cleaning up resources associated with the session\r\n * 3. Updating the ZSpaceHostEntity to reflect the inactive state\r\n *\r\n * Usage:\r\n * ```typescript\r\n * // In a controller or UI event handler:\r\n * const stopZSpace = (appObjects) => {\r\n *   const uc = StopZSpaceUC.get(appObjects);\r\n *   if (!uc) {\r\n *     console.error(\"StopZSpaceUC not found\");\r\n *     return;\r\n *   }\r\n *\r\n *   uc.stopZSpace();\r\n *   console.log(\"zSpace session stopped\");\r\n * };\r\n * ```\r\n *\r\n * Important notes:\r\n * - This is a synchronous operation and completes immediately\r\n * - When called, ZSpaceHostEntity.isActive will be set to false\r\n * - UI components should observe ZSpaceIsActivePM to react to state changes\r\n * - This should be called when the application no longer needs zSpace features\r\n * - It's good practice to call this before application shutdown or when\r\n *   transitioning to a non-zSpace part of the application\r\n */\r\nexport abstract class StopZSpaceUC extends AppObjectUC {\r\n  static type = \"StopZSpaceUC\";\r\n\r\n  /**\r\n   * Stop the active zSpace session\r\n   * This method completes synchronously and does not return a value\r\n   */\r\n  abstract stopZSpace(): void;\r\n\r\n  /**\r\n   * Get the singleton instance of StopZSpaceUC\r\n   * @param appObjects - The AppObjectRepo instance\r\n   * @returns The StopZSpaceUC instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<StopZSpaceUC>(StopZSpaceUC.type, appObjects);\r\n  }\r\n}\r\n"]}

package/dist/esm/ZSpaceHost/UCs/checkForZSpaceSupport.js

@@ -1,4 +1,40 @@
 import { ZSpaceHostEntity } from "../Entities/ZSpaceHost";
+/**
+ * Checks if the current browser environment supports WebXR and zSpace hardware
+ *
+ * This utility function:
+ * 1. Checks if navigator.xr is available (WebXR API support)
+ * 2. Tests if 'immersive-vr' sessions are supported (required for zSpace)
+ * 3. Updates the ZSpaceHostEntity.isSupported property based on results
+ *
+ * Usage:
+ * ```typescript
+ * // Typically called during application initialization:
+ * import { checkForWebXRSupport } from "@vived/host/ZSpaceHost/UCs";
+ *
+ * async function initializeApp(appObjects) {
+ *   // Check for zSpace hardware support
+ *   await checkForWebXRSupport(appObjects);
+ *
+ *   // Get the current support status
+ *   const zSpace = ZSpaceHostEntity.get(appObjects);
+ *   if (zSpace?.isSupported) {
+ *     console.log("zSpace hardware is supported");
+ *   } else {
+ *     console.log("zSpace hardware is not supported, using fallback mode");
+ *   }
+ * }
+ * ```
+ *
+ * Important notes:
+ * - This function should be called during application initialization
+ * - It returns a Promise that resolves when the check is complete
+ * - To observe changes in support status, use the ZSpaceIsActivePM
+ * - If hardware is not supported, you may want to enable emulation mode
+ *
+ * @param appObjects - The AppObjectRepo instance
+ * @returns A Promise that resolves when the check is complete
+ */
 export function checkForWebXRSupport(appObjects) {
     return new Promise((resolve) => {
         const zSpace = ZSpaceHostEntity.get(appObjects);

package/dist/esm/ZSpaceHost/UCs/checkForZSpaceSupport.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkForZSpaceSupport.js","sourceRoot":"","sources":["../../../../src/ZSpaceHost/UCs/checkForZSpaceSupport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,UAAU,oBAAoB,CAAC,UAAyB;IAC5D,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,UAAU,CAAC,WAAW,CACpB,sBAAsB,EACtB,iCAAiC,CAClC,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAS,SAAiB,CAAC,EAAE,CAAC;QAEtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;YAC3B,OAAO,EAAE,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,kBAAkB,CAAC,cAAc,CAAC;iBAClC,IAAI,CAAC,CAAC,WAAoB,EAAE,EAAE;gBAC7B,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;gBACjC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE;gBACV,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;gBAC3B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACP,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { ZSpaceHostEntity } from \"../Entities/ZSpaceHost\";\r\n\r\nexport function checkForWebXRSupport(appObjects: AppObjectRepo): Promise<void> {\r\n  return new Promise<void>((resolve) => {\r\n    const zSpace = ZSpaceHostEntity.get(appObjects);\r\n    if (!zSpace) {\r\n      appObjects.submitError(\r\n        \"checkForWebXRSupport\",\r\n        \"Unable to find ZSpaceHostEntity\"\r\n      );\r\n      return;\r\n    }\r\n\r\n    const xr: any = (navigator as any).xr;\r\n\r\n    if (!xr) {\r\n      zSpace.isSupported = false;\r\n      resolve();\r\n    } else {\r\n      xr.isSessionSupported(\"immersive-vr\")\r\n        .then((isSupported: boolean) => {\r\n          zSpace.isSupported = isSupported;\r\n          resolve();\r\n        })\r\n        .catch(() => {\r\n          zSpace.isSupported = false;\r\n          resolve();\r\n        });\r\n    }\r\n  });\r\n}\r\n"]}
+{"version":3,"file":"checkForZSpaceSupport.js","sourceRoot":"","sources":["../../../../src/ZSpaceHost/UCs/checkForZSpaceSupport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAyB;IAC5D,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,UAAU,CAAC,WAAW,CACpB,sBAAsB,EACtB,iCAAiC,CAClC,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAS,SAAiB,CAAC,EAAE,CAAC;QAEtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;YAC3B,OAAO,EAAE,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,kBAAkB,CAAC,cAAc,CAAC;iBAClC,IAAI,CAAC,CAAC,WAAoB,EAAE,EAAE;gBAC7B,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;gBACjC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE;gBACV,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;gBAC3B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACP,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { ZSpaceHostEntity } from \"../Entities/ZSpaceHost\";\r\n\r\n/**\r\n * Checks if the current browser environment supports WebXR and zSpace hardware\r\n *\r\n * This utility function:\r\n * 1. Checks if navigator.xr is available (WebXR API support)\r\n * 2. Tests if 'immersive-vr' sessions are supported (required for zSpace)\r\n * 3. Updates the ZSpaceHostEntity.isSupported property based on results\r\n *\r\n * Usage:\r\n * ```typescript\r\n * // Typically called during application initialization:\r\n * import { checkForWebXRSupport } from \"@vived/host/ZSpaceHost/UCs\";\r\n *\r\n * async function initializeApp(appObjects) {\r\n *   // Check for zSpace hardware support\r\n *   await checkForWebXRSupport(appObjects);\r\n *\r\n *   // Get the current support status\r\n *   const zSpace = ZSpaceHostEntity.get(appObjects);\r\n *   if (zSpace?.isSupported) {\r\n *     console.log(\"zSpace hardware is supported\");\r\n *   } else {\r\n *     console.log(\"zSpace hardware is not supported, using fallback mode\");\r\n *   }\r\n * }\r\n * ```\r\n *\r\n * Important notes:\r\n * - This function should be called during application initialization\r\n * - It returns a Promise that resolves when the check is complete\r\n * - To observe changes in support status, use the ZSpaceIsActivePM\r\n * - If hardware is not supported, you may want to enable emulation mode\r\n *\r\n * @param appObjects - The AppObjectRepo instance\r\n * @returns A Promise that resolves when the check is complete\r\n */\r\nexport function checkForWebXRSupport(appObjects: AppObjectRepo): Promise<void> {\r\n  return new Promise<void>((resolve) => {\r\n    const zSpace = ZSpaceHostEntity.get(appObjects);\r\n    if (!zSpace) {\r\n      appObjects.submitError(\r\n        \"checkForWebXRSupport\",\r\n        \"Unable to find ZSpaceHostEntity\"\r\n      );\r\n      return;\r\n    }\r\n\r\n    const xr: any = (navigator as any).xr;\r\n\r\n    if (!xr) {\r\n      zSpace.isSupported = false;\r\n      resolve();\r\n    } else {\r\n      xr.isSessionSupported(\"immersive-vr\")\r\n        .then((isSupported: boolean) => {\r\n          zSpace.isSupported = isSupported;\r\n          resolve();\r\n        })\r\n        .catch(() => {\r\n          zSpace.isSupported = false;\r\n          resolve();\r\n        });\r\n    }\r\n  });\r\n}\r\n"]}

package/dist/esm/ZSpaceHost/index.js

@@ -1,3 +1,71 @@
+/**
+ * ZSpaceHost Module
+ * -----------------
+ *
+ * This module provides integration with zSpace stereoscopic 3D hardware through WebXR.
+ * It allows applications to detect, start, stop, and monitor zSpace sessions,
+ * as well as provide emulation when real hardware isn't available.
+ *
+ * Typical usage flow:
+ *
+ * 1. Initialization:
+ *    ```typescript
+ *    import { checkForWebXRSupport } from "@vived/host/ZSpaceHost/UCs";
+ *
+ *    // During app initialization
+ *    await checkForWebXRSupport(appObjects);
+ *    ```
+ *
+ * 2. Starting/Stopping zSpace:
+ *    ```typescript
+ *    import { StartZSpaceUC, StopZSpaceUC } from "@vived/host/ZSpaceHost/UCs";
+ *
+ *    // Start zSpace
+ *    const startUC = StartZSpaceUC.get(appObjects);
+ *    await startUC?.startZSpace();
+ *
+ *    // Stop zSpace
+ *    const stopUC = StopZSpaceUC.get(appObjects);
+ *    stopUC?.stopZSpace();
+ *    ```
+ *
+ * 3. Checking Status:
+ *    ```typescript
+ *    import { ZSpaceHostEntity } from "@vived/host/ZSpaceHost/Entities";
+ *
+ *    const zSpace = ZSpaceHostEntity.get(appObjects);
+ *    if (zSpace?.isSupported) {
+ *      console.log("zSpace hardware is supported");
+ *    }
+ *    if (zSpace?.isActive) {
+ *      console.log("zSpace is currently active");
+ *    }
+ *    ```
+ *
+ * 4. UI Integration (React example):
+ *    ```typescript
+ *    import { zSpaceIsActivePMAdapter } from "@vived/host/ZSpaceHost/Adapters";
+ *
+ *    function ZSpaceStatusIndicator() {
+ *      const appObjects = useAppObjects();
+ *      const [isActive, setIsActive] = useState(false);
+ *
+ *      useEffect(() => {
+ *        zSpaceIsActivePMAdapter.subscribe(appObjects, setIsActive);
+ *        return () => zSpaceIsActivePMAdapter.unsubscribe(appObjects, setIsActive);
+ *      }, [appObjects]);
+ *
+ *      return <div>zSpace is {isActive ? "active" : "inactive"}</div>;
+ *    }
+ *    ```
+ *
+ * Key components:
+ * - Entities/ZSpaceHost: Core entity storing zSpace state
+ * - UCs/StartZSpace: Use case to initialize and start zSpace
+ * - UCs/StopZSpace: Use case to stop active zSpace session
+ * - PMs/ZSpaceIsActivePM: Presentation manager for active state
+ * - PMs/EmulateZSpacePM: Presentation manager for emulation control
+ */
 export * from "./Adapters";
 export * from "./Controllers";
 export * from "./Entities";

package/dist/esm/ZSpaceHost/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ZSpaceHost/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC","sourcesContent":["export * from \"./Adapters\";\r\nexport * from \"./Controllers\";\r\nexport * from \"./Entities\";\r\nexport * from \"./Factories\";\r\nexport * from \"./Mocks\";\r\nexport * from \"./PMs\";\r\nexport * from \"./UCs\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ZSpaceHost/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC","sourcesContent":["/**\r\n * ZSpaceHost Module\r\n * -----------------\r\n *\r\n * This module provides integration with zSpace stereoscopic 3D hardware through WebXR.\r\n * It allows applications to detect, start, stop, and monitor zSpace sessions,\r\n * as well as provide emulation when real hardware isn't available.\r\n *\r\n * Typical usage flow:\r\n *\r\n * 1. Initialization:\r\n *    ```typescript\r\n *    import { checkForWebXRSupport } from \"@vived/host/ZSpaceHost/UCs\";\r\n *\r\n *    // During app initialization\r\n *    await checkForWebXRSupport(appObjects);\r\n *    ```\r\n *\r\n * 2. Starting/Stopping zSpace:\r\n *    ```typescript\r\n *    import { StartZSpaceUC, StopZSpaceUC } from \"@vived/host/ZSpaceHost/UCs\";\r\n *\r\n *    // Start zSpace\r\n *    const startUC = StartZSpaceUC.get(appObjects);\r\n *    await startUC?.startZSpace();\r\n *\r\n *    // Stop zSpace\r\n *    const stopUC = StopZSpaceUC.get(appObjects);\r\n *    stopUC?.stopZSpace();\r\n *    ```\r\n *\r\n * 3. Checking Status:\r\n *    ```typescript\r\n *    import { ZSpaceHostEntity } from \"@vived/host/ZSpaceHost/Entities\";\r\n *\r\n *    const zSpace = ZSpaceHostEntity.get(appObjects);\r\n *    if (zSpace?.isSupported) {\r\n *      console.log(\"zSpace hardware is supported\");\r\n *    }\r\n *    if (zSpace?.isActive) {\r\n *      console.log(\"zSpace is currently active\");\r\n *    }\r\n *    ```\r\n *\r\n * 4. UI Integration (React example):\r\n *    ```typescript\r\n *    import { zSpaceIsActivePMAdapter } from \"@vived/host/ZSpaceHost/Adapters\";\r\n *\r\n *    function ZSpaceStatusIndicator() {\r\n *      const appObjects = useAppObjects();\r\n *      const [isActive, setIsActive] = useState(false);\r\n *\r\n *      useEffect(() => {\r\n *        zSpaceIsActivePMAdapter.subscribe(appObjects, setIsActive);\r\n *        return () => zSpaceIsActivePMAdapter.unsubscribe(appObjects, setIsActive);\r\n *      }, [appObjects]);\r\n *\r\n *      return <div>zSpace is {isActive ? \"active\" : \"inactive\"}</div>;\r\n *    }\r\n *    ```\r\n *\r\n * Key components:\r\n * - Entities/ZSpaceHost: Core entity storing zSpace state\r\n * - UCs/StartZSpace: Use case to initialize and start zSpace\r\n * - UCs/StopZSpace: Use case to stop active zSpace session\r\n * - PMs/ZSpaceIsActivePM: Presentation manager for active state\r\n * - PMs/EmulateZSpacePM: Presentation manager for emulation control\r\n */\r\n\r\nexport * from \"./Adapters\";\r\nexport * from \"./Controllers\";\r\nexport * from \"./Entities\";\r\nexport * from \"./Factories\";\r\nexport * from \"./Mocks\";\r\nexport * from \"./PMs\";\r\nexport * from \"./UCs\";\r\n"]}

package/dist/types/ChallengeResults/Adapters/challengeScoreListAdapter.d.ts

@@ -0,0 +1,4 @@
+import { SingletonPmAdapter } from "@vived/core";
+import { SlideScoreVM } from "../PMs/ChallengeScoreListPM";
+export declare const challengeScoreListAdapter: SingletonPmAdapter<SlideScoreVM[]>;
+//# sourceMappingURL=challengeScoreListAdapter.d.ts.map

package/dist/types/ChallengeResults/Adapters/challengeScoreListAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"challengeScoreListAdapter.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/challengeScoreListAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAEL,YAAY,EACb,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,yBAAyB,EAAE,kBAAkB,CAAC,YAAY,EAAE,CAsBxE,CAAC"}

package/dist/types/ChallengeResults/Adapters/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./challengeResultsListAdapter";
 export * from "./hasChallengeResultsPMAdapter";
+export * from "./challengeScoreListAdapter";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/ChallengeResults/Adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC"}

package/dist/types/ChallengeResults/Entities/ChallengeResults.d.ts

@@ -35,6 +35,7 @@ export declare abstract class ChallengeResultsEntity extends AppObjectEntity {
     abstract submitScoreResult: (slideID: string, score: number, maxScore: number, tries: number, message: string) => void;
     abstract submitProgressResult: (slideID: string, maxProgress: number, message: string) => void;
     abstract getResultForSlide: (slideID: string) => ChallengeResult | undefined;
+    abstract getScoreForSlide: (slideID: string) => number;
     static get(appObjects: AppObjectRepo): ChallengeResultsEntity | undefined;
 }
 export declare function makeChallengeResults(appObject: AppObject): ChallengeResultsEntity;

package/dist/types/ChallengeResults/Entities/ChallengeResults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChallengeResults.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Entities/ChallengeResults.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,UAAU,GACV,SAAS,GACT,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,UAAU,EACN,sBAAsB,GACtB,2BAA2B,GAC3B,0BAA0B,GAC1B,wBAAwB,GACxB,2BAA2B,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8BAAsB,sBAAuB,SAAQ,eAAe;IAClE,MAAM,CAAC,IAAI,SAA4B;IAEvC,QAAQ,KAAK,OAAO,IAAI,eAAe,EAAE,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,mBAAmB,EAAE,CAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,iBAAiB,EAAE,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IAE7E,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,GACnB,sBAAsB,CAExB"}
+{"version":3,"file":"ChallengeResults.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Entities/ChallengeResults.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,UAAU,GACV,SAAS,GACT,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,UAAU,EACN,sBAAsB,GACtB,2BAA2B,GAC3B,0BAA0B,GAC1B,wBAAwB,GACxB,2BAA2B,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8BAAsB,sBAAuB,SAAQ,eAAe;IAClE,MAAM,CAAC,IAAI,SAA4B;IAEvC,QAAQ,KAAK,OAAO,IAAI,eAAe,EAAE,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,mBAAmB,EAAE,CAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,iBAAiB,EAAE,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IAE7E,QAAQ,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAEvD,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,GACnB,sBAAsB,CAExB"}

package/dist/types/ChallengeResults/Factories/setupChallengeResults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setupChallengeResults.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Factories/setupChallengeResults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAwB,MAAM,aAAa,CAAC;AAG3E,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,aAAa,GACxB,sBAAsB,CAUxB"}
+{"version":3,"file":"setupChallengeResults.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Factories/setupChallengeResults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAwB,MAAM,aAAa,CAAC;AAG3E,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,aAAa,GACxB,sBAAsB,CAWxB"}

package/dist/types/ChallengeResults/Mocks/MockChallengeScoreListPM.d.ts

@@ -0,0 +1,8 @@
+import { AppObject, AppObjectRepo } from "@vived/core";
+import { ChallengeScoreListPM } from "../PMs/ChallengeScoreListPM";
+export declare class MockChallengeScoreListPM extends ChallengeScoreListPM {
+    vmsAreEqual: jest.Mock<any, any, any>;
+    constructor(appObject: AppObject);
+}
+export declare function makeMockChallengeScoreListPM(appObjects: AppObjectRepo): MockChallengeScoreListPM;
+//# sourceMappingURL=MockChallengeScoreListPM.d.ts.map

package/dist/types/ChallengeResults/Mocks/MockChallengeScoreListPM.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockChallengeScoreListPM.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Mocks/MockChallengeScoreListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,oBAAoB,EAErB,MAAM,6BAA6B,CAAC;AAErC,qBAAa,wBAAyB,SAAQ,oBAAoB;IAChE,WAAW,2BAIP;gBAEQ,SAAS,EAAE,SAAS;CAIjC;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,aAAa,GACxB,wBAAwB,CAI1B"}

package/dist/types/ChallengeResults/Mocks/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./ChallengeResultsListPMMock";
 export * from "./MockHasChallengeResultsPM";
+export * from "./MockChallengeScoreListPM";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/ChallengeResults/Mocks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Mocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Mocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC"}

package/dist/types/ChallengeResults/PMs/ChallengeScoreListPM.d.ts

@@ -0,0 +1,12 @@
+import { AppObject, AppObjectPM, AppObjectRepo } from "@vived/core";
+export interface SlideScoreVM {
+    id: string;
+    displayName: string;
+    score: number;
+}
+export declare abstract class ChallengeScoreListPM extends AppObjectPM<SlideScoreVM[]> {
+    static readonly type = "ChallengeScoreListPM";
+    static get(appObjects: AppObjectRepo): ChallengeScoreListPM | undefined;
+}
+export declare function makeChallengeScoreListPM(appObject: AppObject): ChallengeScoreListPM;
+//# sourceMappingURL=ChallengeScoreListPM.d.ts.map

package/dist/types/ChallengeResults/PMs/ChallengeScoreListPM.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChallengeScoreListPM.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/PMs/ChallengeScoreListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,aAAa,EAEd,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8BAAsB,oBAAqB,SAAQ,WAAW,CAAC,YAAY,EAAE,CAAC;IAC5E,MAAM,CAAC,QAAQ,CAAC,IAAI,0BAA0B;IAE9C,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,GACnB,oBAAoB,CAEtB"}

package/dist/types/ChallengeResults/PMs/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./ChallengeResultsListPM";
 export * from "./HasChallengeResultsPM";
+export * from "./ChallengeScoreListPM";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/ChallengeResults/PMs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/PMs/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/PMs/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}

package/dist/types/Handler/UCs/SubmitResultHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubmitResultHandler.d.ts","sourceRoot":"","sources":["../../../../src/Handler/UCs/SubmitResultHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,EAEL,cAAc,EAGf,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,UAAU,GACV,aAAa,CAAC;AAClB,MAAM,MAAM,OAAO,GACf,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,gBAAgB,CAAC;AAErB,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,KAChB,IAAI,CAAC;AAEV,8BAAsB,mBACpB,SAAQ,WACR,YAAW,cAAc;IACzB,MAAM,CAAC,QAAQ,CAAC,IAAI,yBAAyB;IAE7C,QAAQ,CAAC,WAAW,oBAAoB;IAExC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACtE;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,mBAAmB,CAErB"}
+{"version":3,"file":"SubmitResultHandler.d.ts","sourceRoot":"","sources":["../../../../src/Handler/UCs/SubmitResultHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAOrD,OAAO,EAEL,cAAc,EAGf,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,UAAU,GACV,aAAa,CAAC;AAClB,MAAM,MAAM,OAAO,GACf,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,gBAAgB,CAAC;AAErB,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,KAChB,IAAI,CAAC;AAEV,8BAAsB,mBACpB,SAAQ,WACR,YAAW,cAAc;IAEzB,MAAM,CAAC,QAAQ,CAAC,IAAI,yBAAyB;IAE7C,QAAQ,CAAC,WAAW,oBAAoB;IAExC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACtE;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,mBAAmB,CAErB"}

package/dist/types/ZSpaceHost/Entities/ZSpaceHost.d.ts

@@ -1,14 +1,59 @@
 import { AppObject, AppObjectEntity, AppObjectRepo } from "@vived/core";
+/**
+ * ZSpaceHostEntity is a singleton entity that manages the state and functionality
+ * for zSpace integration in VIVED applications.
+ *
+ * This entity handles:
+ * 1. zSpace feature detection (isSupported)
+ * 2. Emulation mode toggling (emulate)
+ * 3. Active state management (isActive)
+ * 4. XR Session management
+ *
+ * Usage:
+ * - To check if zSpace is available: ZSpaceHostEntity.get(appObjects)?.isSupported
+ * - To check if zSpace is active: ZSpaceHostEntity.get(appObjects)?.isActive
+ * - To enable/disable emulation: ZSpaceHostEntity.get(appObjects).emulate = true/false
+ *
+ * Important: This is a singleton entity - only one instance exists in the application.
+ * Always access via ZSpaceHostEntity.get(appObjects) rather than creating new instances.
+ */
 export declare abstract class ZSpaceHostEntity extends AppObjectEntity {
     static type: string;
+    /**
+     * Whether zSpace hardware is supported in the current environment
+     */
     abstract get isSupported(): boolean;
     abstract set isSupported(val: boolean);
+    /**
+     * Whether to emulate zSpace hardware when not available
+     * When true, the system will simulate zSpace capabilities
+     */
     abstract get emulate(): boolean;
     abstract set emulate(val: boolean);
+    /**
+     * Whether zSpace is currently active
+     * This is true when either real zSpace hardware is active
+     * or when emulation is enabled
+     */
     abstract get isActive(): boolean;
     abstract set isActive(val: boolean);
+    /**
+     * The current XR Session if zSpace is active
+     */
     abstract session: XRSession | undefined;
+    /**
+     * Get the singleton ZSpaceHostEntity instance
+     * @param appObjects - The AppObjectRepo instance
+     * @returns The ZSpaceHostEntity instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): ZSpaceHostEntity | undefined;
 }
+/**
+ * Factory function to create the ZSpaceHostEntity
+ * For internal use only - external code should use ZSpaceHostEntity.get()
+ *
+ * @param appObject - The AppObject to attach the entity to
+ * @returns A new ZSpaceHostEntity instance
+ */
 export declare function makeZSpaceHostEntity(appObject: AppObject): ZSpaceHostEntity;
 //# sourceMappingURL=ZSpaceHost.d.ts.map

package/dist/types/ZSpaceHost/Entities/ZSpaceHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZSpaceHost.d.ts","sourceRoot":"","sources":["../../../../src/ZSpaceHost/Entities/ZSpaceHost.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,8BAAsB,gBAAiB,SAAQ,eAAe;IAC5D,MAAM,CAAC,IAAI,SAAsB;IAEjC,QAAQ,KAAK,WAAW,IAAI,OAAO,CAAC;IACpC,QAAQ,KAAK,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE;IAEvC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC;IAChC,QAAQ,KAAK,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE;IAEnC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;IACjC,QAAQ,KAAK,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE;IAEpC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAExC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAE3E"}
+{"version":3,"file":"ZSpaceHost.d.ts","sourceRoot":"","sources":["../../../../src/ZSpaceHost/Entities/ZSpaceHost.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;GAiBG;AACH,8BAAsB,gBAAiB,SAAQ,eAAe;IAC5D,MAAM,CAAC,IAAI,SAAsB;IAEjC;;OAEG;IACH,QAAQ,KAAK,WAAW,IAAI,OAAO,CAAC;IACpC,QAAQ,KAAK,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE;IAEvC;;;OAGG;IACH,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC;IAChC,QAAQ,KAAK,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE;IAEnC;;;;OAIG;IACH,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;IACjC,QAAQ,KAAK,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE;IAEpC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAExC;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAE3E"}

package/dist/types/ZSpaceHost/PMs/EmulateZSpacePM.d.ts

@@ -1,7 +1,53 @@
 import { AppObject, AppObjectPM, AppObjectRepo } from "@vived/core";
+/**
+ * EmulateZSpacePM is a singleton Presentation Manager that provides a boolean view model
+ * indicating whether zSpace emulation is currently enabled.
+ *
+ * This PM allows UI components to observe and (through controllers) control whether
+ * zSpace features should be emulated when actual zSpace hardware is not available.
+ *
+ * Usage in UI components:
+ * 1. Via direct PM access (not recommended for UI components):
+ *    const pm = EmulateZSpacePM.get(appObjects);
+ *    pm?.addView((isEmulating) => { updateUIBasedOn(isEmulating); });
+ *
+ * 2. Via adapter (recommended for React/UI components):
+ *    import { emulateZSpacePMAdapter } from "../Adapters";
+ *
+ *    // In a React component:
+ *    const [isEmulating, setIsEmulating] = useState(emulateZSpacePMAdapter.defaultVM);
+ *
+ *    useEffect(() => {
+ *      emulateZSpacePMAdapter.subscribe(appObjects, setIsEmulating);
+ *      return () => emulateZSpacePMAdapter.unsubscribe(appObjects, setIsEmulating);
+ *    }, [appObjects]);
+ *
+ * 3. To toggle emulation state (in a controller or UI event handler):
+ *    import { toggleEmulateZSpace } from "../Controllers";
+ *
+ *    // When handling a UI event:
+ *    const handleToggleEmulation = () => {
+ *      toggleEmulateZSpace(appObjects);
+ *    };
+ *
+ * Emulation is useful during development or when testing on systems without zSpace hardware.
+ * When emulation is enabled, many zSpace-specific UI features can still be tested.
+ */
 export declare abstract class EmulateZSpacePM extends AppObjectPM<boolean> {
     static type: string;
+    /**
+     * Get the singleton instance of EmulateZSpacePM
+     * @param appObjects - The AppObjectRepo instance
+     * @returns The EmulateZSpacePM instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): EmulateZSpacePM | undefined;
 }
+/**
+ * Factory function to create the EmulateZSpacePM
+ * For internal use only - external code should use EmulateZSpacePM.get()
+ *
+ * @param appObject - The AppObject to attach the PM to
+ * @returns A new EmulateZSpacePM instance
+ */
 export declare function makeEmulateZSpacePM(appObject: AppObject): EmulateZSpacePM;
 //# sourceMappingURL=EmulateZSpacePM.d.ts.map

package/dist/types/ZSpaceHost/PMs/EmulateZSpacePM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EmulateZSpacePM.d.ts","sourceRoot":"","sources":["../../../../src/ZSpaceHost/PMs/EmulateZSpacePM.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,WAAW,EACX,aAAa,EACd,MAAM,aAAa,CAAC;AAGrB,8BAAsB,eAAgB,SAAQ,WAAW,CAAC,OAAO,CAAC;IAChE,MAAM,CAAC,IAAI,SAAqB;IAEhC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,eAAe,CAEzE"}
+{"version":3,"file":"EmulateZSpacePM.d.ts","sourceRoot":"","sources":["../../../../src/ZSpaceHost/PMs/EmulateZSpacePM.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,WAAW,EACX,aAAa,EACd,MAAM,aAAa,CAAC;AAGrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,8BAAsB,eAAgB,SAAQ,WAAW,CAAC,OAAO,CAAC;IAChE,MAAM,CAAC,IAAI,SAAqB;IAEhC;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,eAAe,CAEzE"}

package/dist/types/ZSpaceHost/PMs/ZSpaceIsActivePM.d.ts

@@ -1,7 +1,46 @@
 import { AppObject, AppObjectPM, AppObjectRepo } from "@vived/core";
+/**
+ * ZSpaceIsActivePM is a singleton Presentation Manager that provides a boolean view model
+ * indicating whether zSpace is currently active.
+ *
+ * This PM observes ZSpaceHostEntity and updates its view model when the isActive property changes.
+ *
+ * Usage in UI components:
+ * 1. Via direct PM access (not recommended for UI components):
+ *    const pm = ZSpaceIsActivePM.get(appObjects);
+ *    pm?.addView((isActive) => { updateUIBasedOn(isActive); });
+ *
+ * 2. Via adapter (recommended for React/UI components):
+ *    import { zSpaceIsActivePMAdapter } from "../Adapters";
+ *
+ *    // In a React component:
+ *    const [isZSpaceActive, setIsZSpaceActive] = useState(zSpaceIsActivePMAdapter.defaultVM);
+ *
+ *    useEffect(() => {
+ *      zSpaceIsActivePMAdapter.subscribe(appObjects, setIsZSpaceActive);
+ *      return () => zSpaceIsActivePMAdapter.unsubscribe(appObjects, setIsZSpaceActive);
+ *    }, [appObjects]);
+ *
+ * When zSpace is active, UI components may want to:
+ * - Display 3D content differently
+ * - Show zSpace-specific controls
+ * - Adjust UI layouts for stereoscopic viewing
+ */
 export declare abstract class ZSpaceIsActivePM extends AppObjectPM<boolean> {
     static type: string;
+    /**
+     * Get the singleton instance of ZSpaceIsActivePM
+     * @param appObjects - The AppObjectRepo instance
+     * @returns The ZSpaceIsActivePM instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): ZSpaceIsActivePM | undefined;
 }
+/**
+ * Factory function to create the ZSpaceIsActivePM
+ * For internal use only - external code should use ZSpaceIsActivePM.get()
+ *
+ * @param appObject - The AppObject to attach the PM to
+ * @returns A new ZSpaceIsActivePM instance
+ */
 export declare function makeZSpaceIsActivePM(appObject: AppObject): ZSpaceIsActivePM;
 //# sourceMappingURL=ZSpaceIsActivePM.d.ts.map

package/dist/types/ZSpaceHost/PMs/ZSpaceIsActivePM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZSpaceIsActivePM.d.ts","sourceRoot":"","sources":["../../../../src/ZSpaceHost/PMs/ZSpaceIsActivePM.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,WAAW,EACX,aAAa,EACd,MAAM,aAAa,CAAC;AAGrB,8BAAsB,gBAAiB,SAAQ,WAAW,CAAC,OAAO,CAAC;IACjE,MAAM,CAAC,IAAI,SAAsB;IAEjC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAE3E"}
+{"version":3,"file":"ZSpaceIsActivePM.d.ts","sourceRoot":"","sources":["../../../../src/ZSpaceHost/PMs/ZSpaceIsActivePM.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,WAAW,EACX,aAAa,EACd,MAAM,aAAa,CAAC;AAGrB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,8BAAsB,gBAAiB,SAAQ,WAAW,CAAC,OAAO,CAAC;IACjE,MAAM,CAAC,IAAI,SAAsB;IAEjC;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAE3E"}

package/dist/types/ZSpaceHost/UCs/StartZSpace/StartZSpaceUC.d.ts

@@ -1,7 +1,50 @@
 import { AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * StartZSpaceUC is a singleton Use Case responsible for starting a zSpace session.
+ *
+ * This Use Case handles:
+ * 1. Setting up and initializing the zSpace XR session
+ * 2. Updating the ZSpaceHostEntity to reflect the active state
+ * 3. Handling errors in the setup process
+ *
+ * Usage:
+ * ```typescript
+ * // In a controller or UI event handler:
+ * const startZSpace = async (appObjects) => {
+ *   const uc = StartZSpaceUC.get(appObjects);
+ *   if (!uc) {
+ *     console.error("StartZSpaceUC not found");
+ *     return;
+ *   }
+ *
+ *   try {
+ *     await uc.startZSpace();
+ *     console.log("zSpace session started successfully");
+ *   } catch (error) {
+ *     console.error("Failed to start zSpace session:", error);
+ *   }
+ * };
+ * ```
+ *
+ * Important notes:
+ * - This is an asynchronous operation and may take some time to complete
+ * - Success/failure is indicated by the Promise resolution/rejection
+ * - When successful, ZSpaceHostEntity.isActive will be set to true
+ * - UI components should observe ZSpaceIsActivePM to react to state changes
+ */
 export declare abstract class StartZSpaceUC extends AppObjectUC {
     static type: string;
+    /**
+     * Start the zSpace session
+     * @returns A Promise that resolves when the session has started successfully,
+     *          or rejects with an error if the session could not be started
+     */
     abstract startZSpace(): Promise<void>;
+    /**
+     * Get the singleton instance of StartZSpaceUC
+     * @param appObjects - The AppObjectRepo instance
+     * @returns The StartZSpaceUC instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): StartZSpaceUC | undefined;
 }
 //# sourceMappingURL=StartZSpaceUC.d.ts.map

package/dist/types/ZSpaceHost/UCs/StartZSpace/StartZSpaceUC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StartZSpaceUC.d.ts","sourceRoot":"","sources":["../../../../../src/ZSpaceHost/UCs/StartZSpace/StartZSpaceUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhF,8BAAsB,aAAc,SAAQ,WAAW;IACrD,MAAM,CAAC,IAAI,SAAmB;IAE9B,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAErC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAGrC"}
+{"version":3,"file":"StartZSpaceUC.d.ts","sourceRoot":"","sources":["../../../../../src/ZSpaceHost/UCs/StartZSpace/StartZSpaceUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,8BAAsB,aAAc,SAAQ,WAAW;IACrD,MAAM,CAAC,IAAI,SAAmB;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAErC;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAGrC"}

package/dist/types/ZSpaceHost/UCs/StopZSpace/StopZSpaceUC.d.ts

@@ -1,7 +1,47 @@
 import { AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * StopZSpaceUC is a singleton Use Case responsible for stopping an active zSpace session.
+ *
+ * This Use Case handles:
+ * 1. Properly ending the current zSpace XR session
+ * 2. Cleaning up resources associated with the session
+ * 3. Updating the ZSpaceHostEntity to reflect the inactive state
+ *
+ * Usage:
+ * ```typescript
+ * // In a controller or UI event handler:
+ * const stopZSpace = (appObjects) => {
+ *   const uc = StopZSpaceUC.get(appObjects);
+ *   if (!uc) {
+ *     console.error("StopZSpaceUC not found");
+ *     return;
+ *   }
+ *
+ *   uc.stopZSpace();
+ *   console.log("zSpace session stopped");
+ * };
+ * ```
+ *
+ * Important notes:
+ * - This is a synchronous operation and completes immediately
+ * - When called, ZSpaceHostEntity.isActive will be set to false
+ * - UI components should observe ZSpaceIsActivePM to react to state changes
+ * - This should be called when the application no longer needs zSpace features
+ * - It's good practice to call this before application shutdown or when
+ *   transitioning to a non-zSpace part of the application
+ */
 export declare abstract class StopZSpaceUC extends AppObjectUC {
     static type: string;
+    /**
+     * Stop the active zSpace session
+     * This method completes synchronously and does not return a value
+     */
     abstract stopZSpace(): void;
+    /**
+     * Get the singleton instance of StopZSpaceUC
+     * @param appObjects - The AppObjectRepo instance
+     * @returns The StopZSpaceUC instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): StopZSpaceUC | undefined;
 }
 //# sourceMappingURL=StopZSpaceUC.d.ts.map

package/dist/types/ZSpaceHost/UCs/StopZSpace/StopZSpaceUC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StopZSpaceUC.d.ts","sourceRoot":"","sources":["../../../../../src/ZSpaceHost/UCs/StopZSpace/StopZSpaceUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhF,8BAAsB,YAAa,SAAQ,WAAW;IACpD,MAAM,CAAC,IAAI,SAAkB;IAE7B,QAAQ,CAAC,UAAU,IAAI,IAAI;IAE3B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAGrC"}
+{"version":3,"file":"StopZSpaceUC.d.ts","sourceRoot":"","sources":["../../../../../src/ZSpaceHost/UCs/StopZSpace/StopZSpaceUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,8BAAsB,YAAa,SAAQ,WAAW;IACpD,MAAM,CAAC,IAAI,SAAkB;IAE7B;;;OAGG;IACH,QAAQ,CAAC,UAAU,IAAI,IAAI;IAE3B;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAGrC"}