@vived/host 4.2.0 → 4.4.0

package/dist/esm/ZSpaceHost/PMs/EmulateZSpacePM.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmulateZSpacePM.js","sourceRoot":"","sources":["../../../../src/ZSpaceHost/PMs/EmulateZSpacePM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,OAAgB,eAAgB,SAAQ,WAAoB;IAGhE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,eAAe,CAAC,IAAI,EACpB,UAAU,CACX,CAAC;IACJ,CAAC;;AAPM,oBAAI,GAAG,iBAAiB,CAAC;AAUlC,MAAM,UAAU,mBAAmB,CAAC,SAAoB;IACtD,OAAO,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,kBAAmB,SAAQ,eAAe;IAG9C,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAQD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QAPjC,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO;YAEzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC,CAAC;QAKA,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,YAAY,CAClC,gBAAgB,CAAC,IAAI,CACtB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,CACR,0EAA0E,CAC3E,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { ZSpaceHostEntity } from \"../Entities\";\r\n\r\nexport abstract class EmulateZSpacePM extends AppObjectPM<boolean> {\r\n  static type = \"EmulateZSpacePM\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<EmulateZSpacePM>(\r\n      EmulateZSpacePM.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeEmulateZSpacePM(appObject: AppObject): EmulateZSpacePM {\r\n  return new EmulateZSpacePMImp(appObject);\r\n}\r\n\r\nclass EmulateZSpacePMImp extends EmulateZSpacePM {\r\n  private zSpace?: ZSpaceHostEntity;\r\n\r\n  vmsAreEqual(a: boolean, b: boolean): boolean {\r\n    return a === b;\r\n  }\r\n\r\n  private onEntityChange = () => {\r\n    if (!this.zSpace) return;\r\n\r\n    this.doUpdateView(this.zSpace.emulate);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, EmulateZSpacePM.type);\r\n\r\n    this.zSpace = appObject.getComponent<ZSpaceHostEntity>(\r\n      ZSpaceHostEntity.type\r\n    );\r\n    if (!this.zSpace) {\r\n      this.error(\r\n        \"PM Has been added to an app object that does not have a ZSpaceHostEntity\"\r\n      );\r\n      return;\r\n    }\r\n    this.zSpace.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"EmulateZSpacePM.js","sourceRoot":"","sources":["../../../../src/ZSpaceHost/PMs/EmulateZSpacePM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,OAAgB,eAAgB,SAAQ,WAAoB;IAGhE;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,eAAe,CAAC,IAAI,EACpB,UAAU,CACX,CAAC;IACJ,CAAC;;AAZM,oBAAI,GAAG,iBAAiB,CAAC;AAelC;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAoB;IACtD,OAAO,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,kBAAmB,SAAQ,eAAe;IAC9C,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED,IAAY,MAAM;QAChB,OAAO,IAAI,CAAC,kBAAkB,CAAmB,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAQD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QAPjC,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO;YAEzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC,CAAC;QAKA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CACR,0EAA0E,CAC3E,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { ZSpaceHostEntity } from \"../Entities\";\r\n\r\n/**\r\n * EmulateZSpacePM is a singleton Presentation Manager that provides a boolean view model\r\n * indicating whether zSpace emulation is currently enabled.\r\n *\r\n * This PM allows UI components to observe and (through controllers) control whether\r\n * zSpace features should be emulated when actual zSpace hardware is not available.\r\n *\r\n * Usage in UI components:\r\n * 1. Via direct PM access (not recommended for UI components):\r\n *    const pm = EmulateZSpacePM.get(appObjects);\r\n *    pm?.addView((isEmulating) => { updateUIBasedOn(isEmulating); });\r\n *\r\n * 2. Via adapter (recommended for React/UI components):\r\n *    import { emulateZSpacePMAdapter } from \"../Adapters\";\r\n *\r\n *    // In a React component:\r\n *    const [isEmulating, setIsEmulating] = useState(emulateZSpacePMAdapter.defaultVM);\r\n *\r\n *    useEffect(() => {\r\n *      emulateZSpacePMAdapter.subscribe(appObjects, setIsEmulating);\r\n *      return () => emulateZSpacePMAdapter.unsubscribe(appObjects, setIsEmulating);\r\n *    }, [appObjects]);\r\n *\r\n * 3. To toggle emulation state (in a controller or UI event handler):\r\n *    import { toggleEmulateZSpace } from \"../Controllers\";\r\n *\r\n *    // When handling a UI event:\r\n *    const handleToggleEmulation = () => {\r\n *      toggleEmulateZSpace(appObjects);\r\n *    };\r\n *\r\n * Emulation is useful during development or when testing on systems without zSpace hardware.\r\n * When emulation is enabled, many zSpace-specific UI features can still be tested.\r\n */\r\nexport abstract class EmulateZSpacePM extends AppObjectPM<boolean> {\r\n  static type = \"EmulateZSpacePM\";\r\n\r\n  /**\r\n   * Get the singleton instance of EmulateZSpacePM\r\n   * @param appObjects - The AppObjectRepo instance\r\n   * @returns The EmulateZSpacePM instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<EmulateZSpacePM>(\r\n      EmulateZSpacePM.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create the EmulateZSpacePM\r\n * For internal use only - external code should use EmulateZSpacePM.get()\r\n *\r\n * @param appObject - The AppObject to attach the PM to\r\n * @returns A new EmulateZSpacePM instance\r\n */\r\nexport function makeEmulateZSpacePM(appObject: AppObject): EmulateZSpacePM {\r\n  return new EmulateZSpacePMImp(appObject);\r\n}\r\n\r\nclass EmulateZSpacePMImp extends EmulateZSpacePM {\r\n  vmsAreEqual(a: boolean, b: boolean): boolean {\r\n    return a === b;\r\n  }\r\n\r\n  private get zSpace() {\r\n    return this.getCachedSingleton<ZSpaceHostEntity>(ZSpaceHostEntity.type);\r\n  }\r\n\r\n  private onEntityChange = () => {\r\n    if (!this.zSpace) return;\r\n\r\n    this.doUpdateView(this.zSpace.emulate);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, EmulateZSpacePM.type);\r\n\r\n    const zSpace = this.zSpace;\r\n    if (!zSpace) {\r\n      this.error(\r\n        \"PM Has been added to an app object that does not have a ZSpaceHostEntity\"\r\n      );\r\n      return;\r\n    }\r\n    zSpace.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

package/dist/esm/ZSpaceHost/PMs/ZSpaceIsActivePM.js

@@ -1,11 +1,50 @@
 import { getSingletonComponent, AppObjectPM } from "@vived/core";
 import { ZSpaceHostEntity } from "../Entities/ZSpaceHost";
+/**
+ * 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 class ZSpaceIsActivePM extends AppObjectPM {
+    /**
+     * Get the singleton instance of ZSpaceIsActivePM
+     * @param appObjects - The AppObjectRepo instance
+     * @returns The ZSpaceIsActivePM instance or undefined if not found
+     */
     static get(appObjects) {
         return getSingletonComponent(ZSpaceIsActivePM.type, appObjects);
     }
 }
 ZSpaceIsActivePM.type = "ZSpaceIsActivePM";
+/**
+ * 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 function makeZSpaceIsActivePM(appObject) {
     return new ZSpaceIsActivePMImp(appObject);
 }
@@ -13,6 +52,9 @@ class ZSpaceIsActivePMImp extends ZSpaceIsActivePM {
     vmsAreEqual(a, b) {
         return a === b;
     }
+    get zSpace() {
+        return this.getCachedSingleton(ZSpaceHostEntity.type);
+    }
     constructor(appObject) {
         super(appObject, ZSpaceIsActivePM.type);
         this.onEntityChange = () => {
@@ -20,12 +62,12 @@ class ZSpaceIsActivePMImp extends ZSpaceIsActivePM {
                 return;
             this.doUpdateView(this.zSpace.isActive);
         };
-        this.zSpace = appObject.getComponent(ZSpaceHostEntity.type);
-        if (!this.zSpace) {
+        const zSpace = this.zSpace;
+        if (!zSpace) {
             this.error("PM Has been added to an app object that does not have a ZSpaceHostEntity");
             return;
         }
-        this.zSpace.addChangeObserver(this.onEntityChange);
+        zSpace.addChangeObserver(this.onEntityChange);
         this.onEntityChange();
         this.appObjects.registerSingleton(this);
     }

package/dist/esm/ZSpaceHost/PMs/ZSpaceIsActivePM.js.map

@@ -1 +1 @@
-{"version":3,"file":"ZSpaceIsActivePM.js","sourceRoot":"","sources":["../../../../src/ZSpaceHost/PMs/ZSpaceIsActivePM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,OAAgB,gBAAiB,SAAQ,WAAoB;IAGjE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,gBAAgB,CAAC,IAAI,EACrB,UAAU,CACX,CAAC;IACJ,CAAC;;AAPM,qBAAI,GAAG,kBAAkB,CAAC;AAUnC,MAAM,UAAU,oBAAoB,CAAC,SAAoB;IACvD,OAAO,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,mBAAoB,SAAQ,gBAAgB;IAGhD,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAQD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAPlC,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO;YAEzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC,CAAC;QAKA,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,YAAY,CAClC,gBAAgB,CAAC,IAAI,CACtB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,CACR,0EAA0E,CAC3E,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { ZSpaceHostEntity } from \"../Entities/ZSpaceHost\";\r\n\r\nexport abstract class ZSpaceIsActivePM extends AppObjectPM<boolean> {\r\n  static type = \"ZSpaceIsActivePM\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<ZSpaceIsActivePM>(\r\n      ZSpaceIsActivePM.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeZSpaceIsActivePM(appObject: AppObject): ZSpaceIsActivePM {\r\n  return new ZSpaceIsActivePMImp(appObject);\r\n}\r\n\r\nclass ZSpaceIsActivePMImp extends ZSpaceIsActivePM {\r\n  private zSpace?: ZSpaceHostEntity;\r\n\r\n  vmsAreEqual(a: boolean, b: boolean): boolean {\r\n    return a === b;\r\n  }\r\n\r\n  private onEntityChange = () => {\r\n    if (!this.zSpace) return;\r\n\r\n    this.doUpdateView(this.zSpace.isActive);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ZSpaceIsActivePM.type);\r\n\r\n    this.zSpace = appObject.getComponent<ZSpaceHostEntity>(\r\n      ZSpaceHostEntity.type\r\n    );\r\n    if (!this.zSpace) {\r\n      this.error(\r\n        \"PM Has been added to an app object that does not have a ZSpaceHostEntity\"\r\n      );\r\n      return;\r\n    }\r\n    this.zSpace.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ZSpaceIsActivePM.js","sourceRoot":"","sources":["../../../../src/ZSpaceHost/PMs/ZSpaceIsActivePM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAgB,gBAAiB,SAAQ,WAAoB;IAGjE;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,gBAAgB,CAAC,IAAI,EACrB,UAAU,CACX,CAAC;IACJ,CAAC;;AAZM,qBAAI,GAAG,kBAAkB,CAAC;AAenC;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAoB;IACvD,OAAO,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,mBAAoB,SAAQ,gBAAgB;IAChD,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED,IAAY,MAAM;QAChB,OAAO,IAAI,CAAC,kBAAkB,CAAmB,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAQD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAPlC,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO;YAEzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC,CAAC;QAKA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CACR,0EAA0E,CAC3E,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { ZSpaceHostEntity } from \"../Entities/ZSpaceHost\";\r\n\r\n/**\r\n * ZSpaceIsActivePM is a singleton Presentation Manager that provides a boolean view model\r\n * indicating whether zSpace is currently active.\r\n *\r\n * This PM observes ZSpaceHostEntity and updates its view model when the isActive property changes.\r\n *\r\n * Usage in UI components:\r\n * 1. Via direct PM access (not recommended for UI components):\r\n *    const pm = ZSpaceIsActivePM.get(appObjects);\r\n *    pm?.addView((isActive) => { updateUIBasedOn(isActive); });\r\n *\r\n * 2. Via adapter (recommended for React/UI components):\r\n *    import { zSpaceIsActivePMAdapter } from \"../Adapters\";\r\n *\r\n *    // In a React component:\r\n *    const [isZSpaceActive, setIsZSpaceActive] = useState(zSpaceIsActivePMAdapter.defaultVM);\r\n *\r\n *    useEffect(() => {\r\n *      zSpaceIsActivePMAdapter.subscribe(appObjects, setIsZSpaceActive);\r\n *      return () => zSpaceIsActivePMAdapter.unsubscribe(appObjects, setIsZSpaceActive);\r\n *    }, [appObjects]);\r\n *\r\n * When zSpace is active, UI components may want to:\r\n * - Display 3D content differently\r\n * - Show zSpace-specific controls\r\n * - Adjust UI layouts for stereoscopic viewing\r\n */\r\nexport abstract class ZSpaceIsActivePM extends AppObjectPM<boolean> {\r\n  static type = \"ZSpaceIsActivePM\";\r\n\r\n  /**\r\n   * Get the singleton instance of ZSpaceIsActivePM\r\n   * @param appObjects - The AppObjectRepo instance\r\n   * @returns The ZSpaceIsActivePM instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<ZSpaceIsActivePM>(\r\n      ZSpaceIsActivePM.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create the ZSpaceIsActivePM\r\n * For internal use only - external code should use ZSpaceIsActivePM.get()\r\n *\r\n * @param appObject - The AppObject to attach the PM to\r\n * @returns A new ZSpaceIsActivePM instance\r\n */\r\nexport function makeZSpaceIsActivePM(appObject: AppObject): ZSpaceIsActivePM {\r\n  return new ZSpaceIsActivePMImp(appObject);\r\n}\r\n\r\nclass ZSpaceIsActivePMImp extends ZSpaceIsActivePM {\r\n  vmsAreEqual(a: boolean, b: boolean): boolean {\r\n    return a === b;\r\n  }\r\n\r\n  private get zSpace() {\r\n    return this.getCachedSingleton<ZSpaceHostEntity>(ZSpaceHostEntity.type);\r\n  }\r\n\r\n  private onEntityChange = () => {\r\n    if (!this.zSpace) return;\r\n\r\n    this.doUpdateView(this.zSpace.isActive);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ZSpaceIsActivePM.type);\r\n\r\n    const zSpace = this.zSpace;\r\n    if (!zSpace) {\r\n      this.error(\r\n        \"PM Has been added to an app object that does not have a ZSpaceHostEntity\"\r\n      );\r\n      return;\r\n    }\r\n    zSpace.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

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

@@ -1,5 +1,43 @@
 import { getSingletonComponent, 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 class StartZSpaceUC extends AppObjectUC {
+    /**
+     * Get the singleton instance of StartZSpaceUC
+     * @param appObjects - The AppObjectRepo instance
+     * @returns The StartZSpaceUC instance or undefined if not found
+     */
     static get(appObjects) {
         return getSingletonComponent(StartZSpaceUC.type, appObjects);
     }

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/Apps/Adapters/activeAppPMAdapter.d.ts

@@ -1,4 +1,24 @@
 import { SingletonPmAdapter } from "@vived/core";
 import { ActiveAppVM } from "../PMs/ActiveAppPM";
+/**
+ * Adapter for the ActiveAppPM singleton presentation manager.
+ *
+ * This adapter provides a simple interface for framework components to connect with
+ * the ActiveAppPM presentation manager, which provides information about the currently
+ * active/selected app in the system.
+ *
+ * Usage in components:
+ * ```
+ * // React component example
+ * const [activeAppVm, setActiveAppVm] = useState(activeAppPMAdapter.defaultVM);
+ *
+ * useEffect(() => {
+ *   activeAppPMAdapter.subscribe(appObjects, setActiveAppVm);
+ *   return () => activeAppPMAdapter.unsubscribe(appObjects, setActiveAppVm);
+ * }, [appObjects]);
+ * ```
+ *
+ * @type {SingletonPmAdapter<ActiveAppVM>} Singleton adapter that provides the active app information
+ */
 export declare const activeAppPMAdapter: SingletonPmAdapter<ActiveAppVM>;
 //# sourceMappingURL=activeAppPMAdapter.d.ts.map

package/dist/types/Apps/Adapters/activeAppPMAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activeAppPMAdapter.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Adapters/activeAppPMAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAEL,WAAW,EAEZ,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,kBAAkB,EAAE,kBAAkB,CAAC,WAAW,CA2B9D,CAAC"}
+{"version":3,"file":"activeAppPMAdapter.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Adapters/activeAppPMAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAEL,WAAW,EAEZ,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBAAkB,CAAC,WAAW,CA6C9D,CAAC"}

package/dist/types/Apps/Adapters/appListPMAdapter.d.ts

@@ -1,3 +1,22 @@
 import { SingletonPmAdapter } from "@vived/core";
+/**
+ * Adapter for the AppsListPM singleton presentation manager.
+ *
+ * This adapter provides a simple interface for framework components to connect with
+ * the AppsListPM presentation manager, which provides a list of available app IDs.
+ *
+ * Usage in components:
+ * ```
+ * // React component example
+ * const [appIds, setAppIds] = useState(appListPMAdapter.defaultVM);
+ *
+ * useEffect(() => {
+ *   appListPMAdapter.subscribe(appObjects, setAppIds);
+ *   return () => appListPMAdapter.unsubscribe(appObjects, setAppIds);
+ * }, [appObjects]);
+ * ```
+ *
+ * @type {SingletonPmAdapter<string[]>} Singleton adapter that provides a list of app IDs
+ */
 export declare const appListPMAdapter: SingletonPmAdapter<string[]>;
 //# sourceMappingURL=appListPMAdapter.d.ts.map

package/dist/types/Apps/Adapters/appListPMAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appListPMAdapter.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appListPMAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGhE,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,CAAC,MAAM,EAAE,CAkBzD,CAAC"}
+{"version":3,"file":"appListPMAdapter.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appListPMAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,CAAC,MAAM,EAAE,CAoCzD,CAAC"}

package/dist/types/Apps/Adapters/appPMAdapter.d.ts

@@ -1,4 +1,23 @@
 import { PmAdapter } from "@vived/core";
 import { AppVM } from "../PMs/AppPM";
+/**
+ * Adapter for the AppPM presentation manager.
+ *
+ * This adapter provides a simple interface for framework components to connect with
+ * the AppPM presentation manager, which provides details about a specific app.
+ *
+ * Usage in components:
+ * ```
+ * // React component example
+ * const [vm, setVm] = useState(appPMAdapter.defaultVM);
+ *
+ * useEffect(() => {
+ *   appPMAdapter.subscribe(appId, appObjects, setVm);
+ *   return () => appPMAdapter.unsubscribe(appId, appObjects, setVm);
+ * }, [appId, appObjects]);
+ * ```
+ *
+ * @type {PmAdapter<AppVM>} Non-singleton adapter that requires an app ID
+ */
 export declare const appPMAdapter: PmAdapter<AppVM>;
 //# sourceMappingURL=appPMAdapter.d.ts.map

package/dist/types/Apps/Adapters/appPMAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appPMAdapter.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appPMAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAS,KAAK,EAAgB,MAAM,cAAc,CAAC;AAE1D,eAAO,MAAM,YAAY,EAAE,SAAS,CAAC,KAAK,CA0BzC,CAAC"}
+{"version":3,"file":"appPMAdapter.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appPMAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAS,KAAK,EAAgB,MAAM,cAAc,CAAC;AAE1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,CAAC,KAAK,CA8CzC,CAAC"}

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

@@ -1,3 +1,17 @@
+/**
+ * Presentation Manager Adapters for the Apps Module
+ *
+ * This module exports adapters that provide a simplified interface between
+ * Framework components (Views) and Domain Presentation Managers.
+ *
+ * Available adapters:
+ *
+ * - activeAppPMAdapter: Singleton adapter for accessing the currently active app
+ * - appListPMAdapter: Singleton adapter for accessing the list of available apps
+ * - appPMAdapter: Non-singleton adapter for accessing details about a specific app by ID
+ *
+ * @module Apps/Adapters
+ */
 export * from "./activeAppPMAdapter";
 export * from "./appListPMAdapter";
 export * from "./appPMAdapter";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/types/Apps/Controllers/updateApp.d.ts

@@ -1,3 +1,22 @@
 import { AppObjectRepo } from "@vived/core";
+/**
+ * Controller function to update an app to its latest version.
+ *
+ * This controller is used to trigger the app update process. It finds the
+ * appropriate UpdateAppUC by the app's ID and calls its updateApp method.
+ *
+ * Usage in views:
+ * ```typescript
+ * import { updateApp } from "../Controllers/updateApp";
+ *
+ * // In a React component
+ * const handleUpdateClick = () => {
+ *   updateApp(appId, appObjects);
+ * };
+ * ```
+ *
+ * @param id - The ID of the app to update
+ * @param appObjects - The app object repository
+ */
 export declare function updateApp(id: string, appObjects: AppObjectRepo): void;
 //# sourceMappingURL=updateApp.d.ts.map

package/dist/types/Apps/Controllers/updateApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateApp.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Controllers/updateApp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,QAQ9D"}
+{"version":3,"file":"updateApp.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Controllers/updateApp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,QAQ9D"}

package/dist/types/Apps/Entities/AppEntity.d.ts

@@ -1,11 +1,29 @@
 import { AppObject, AppObjectEntity, AppObjectRepo, Version } from "@vived/core";
+/**
+ * Enum representing the possible states of an application
+ *
+ * @enum {string}
+ * @property {string} INIT - Initial state before app loading starts
+ * @property {string} LOADING - App is currently loading resources
+ * @property {string} READY - App is loaded and ready to use
+ * @property {string} ERROR - App encountered an error during loading
+ */
 export declare enum AppState {
     INIT = "INIT",
     LOADING = "LOADING",
     READY = "READY",
     ERROR = "ERROR"
 }
+/**
+ * AppEntity - Core entity representing an application in the system
+ *
+ * This abstract class defines the properties and behaviors of an application.
+ * It manages app state, versioning, mounting status, and error handling.
+ *
+ * @extends AppObjectEntity from @vived/core
+ */
 export declare abstract class AppEntity extends AppObjectEntity {
+    /** Type identifier for the AppEntity component */
     static type: string;
     static get(id: string, appObjects: AppObjectRepo): AppEntity | undefined;
     abstract get id(): string;
@@ -24,5 +42,11 @@ export declare abstract class AppEntity extends AppObjectEntity {
     abstract styles: string[];
     abstract mountedVersion: Version | undefined;
 }
+/**
+ * Factory function to create a new AppEntity instance
+ *
+ * @param appObject - The app object to attach the entity to
+ * @returns A concrete implementation of AppEntity
+ */
 export declare function makeAppEntity(appObject: AppObject): AppEntity;
 //# sourceMappingURL=AppEntity.d.ts.map

package/dist/types/Apps/Entities/AppEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppEntity.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Entities/AppEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EACf,aAAa,EACb,OAAO,EACR,MAAM,aAAa,CAAC;AAErB,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,8BAAsB,SAAU,SAAQ,eAAe;IACrD,MAAM,CAAC,IAAI,SAAe;IAE1B,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa;IAahD,QAAQ,KAAK,EAAE,IAAI,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,KAAK,aAAa,IAAI,OAAO,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,KAAK,iBAAiB,IAAI,OAAO,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9C;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAE7D"}
+{"version":3,"file":"AppEntity.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Entities/AppEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EACf,aAAa,EACb,OAAO,EACR,MAAM,aAAa,CAAC;AAErB;;;;;;;;GAQG;AACH,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED;;;;;;;GAOG;AACH,8BAAsB,SAAU,SAAQ,eAAe;IACrD,kDAAkD;IAClD,MAAM,CAAC,IAAI,SAAe;IAE1B,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa;IAahD,QAAQ,KAAK,EAAE,IAAI,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,KAAK,aAAa,IAAI,OAAO,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,KAAK,iBAAiB,IAAI,OAAO,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAE7D"}

package/dist/types/Apps/Entities/AppRepo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppRepo.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Entities/AppRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAiB,MAAM,aAAa,CAAC;AAEvD,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,8BAAsB,aAAc,SAAQ,mBAAmB,CAAC,SAAS,CAAC;IACxE,MAAM,CAAC,IAAI,SAAmB;IAE9B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;IAIpC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAEzC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAE1C,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;CACpC;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAE/D"}
+{"version":3,"file":"AppRepo.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Entities/AppRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,aAAa,EAEd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAiB,MAAM,aAAa,CAAC;AAEvD,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,8BAAsB,aAAc,SAAQ,mBAAmB,CAAC,SAAS,CAAC;IACxE,MAAM,CAAC,IAAI,SAAmB;IAE9B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;IAIpC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAEzC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAE1C,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;CACpC;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAE/D"}

package/dist/types/Apps/PMs/ActiveAppPM.d.ts

@@ -1,11 +1,36 @@
 import { AppObjectPM, AppObjectRepo } from "@vived/core";
+/**
+ * Interface defining the view model for the active application
+ *
+ * @property {string} id - The ID of the currently active app
+ * @property {string[]} stylesheets - List of stylesheet URLs for the active app
+ */
 export interface ActiveAppVM {
     id: string;
     stylesheets: string[];
 }
+/**
+ * Default values for the ActiveAppVM
+ */
 export declare const defaultActiveAppVM: ActiveAppVM;
+/**
+ * ActiveAppPM - Presentation model that manages the currently active application
+ *
+ * This singleton PM tracks which app is currently active in the system and provides
+ * access to information about that app, such as its stylesheets. The UI layer can
+ * subscribe to changes in the active app through this PM.
+ *
+ * @extends AppObjectPM<ActiveAppVM>
+ */
 export declare abstract class ActiveAppPM extends AppObjectPM<ActiveAppVM> {
+    /** Type identifier for the ActiveAppPM component */
     static type: string;
+    /**
+     * Gets the singleton instance of ActiveAppPM from the app objects repository
+     *
+     * @param appObjects - Repository containing app objects
+     * @returns The singleton ActiveAppPM instance
+     */
     static get(appObjects: AppObjectRepo): ActiveAppPM | undefined;
 }
 //# sourceMappingURL=ActiveAppPM.d.ts.map

package/dist/types/Apps/PMs/ActiveAppPM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActiveAppPM.d.ts","sourceRoot":"","sources":["../../../../src/Apps/PMs/ActiveAppPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,kBAAkB,EAAE,WAGhC,CAAC;AAEF,8BAAsB,WAAY,SAAQ,WAAW,CAAC,WAAW,CAAC;IAChE,MAAM,CAAC,IAAI,SAAiB;IAE5B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAGrC"}
+{"version":3,"file":"ActiveAppPM.d.ts","sourceRoot":"","sources":["../../../../src/Apps/PMs/ActiveAppPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAGhC,CAAC;AAEF;;;;;;;;GAQG;AACH,8BAAsB,WAAY,SAAQ,WAAW,CAAC,WAAW,CAAC;IAChE,oDAAoD;IACpD,MAAM,CAAC,IAAI,SAAiB;IAE5B;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAGrC"}