@vived/host 4.1.0 → 4.3.0

package/dist/esm/Apps/Adapters/index.js

@@ -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/esm/Apps/Adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC","sourcesContent":["export * from \"./activeAppPMAdapter\";\r\nexport * from \"./appListPMAdapter\";\r\nexport * from \"./appPMAdapter\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC","sourcesContent":["/**\r\n * Presentation Manager Adapters for the Apps Module\r\n *\r\n * This module exports adapters that provide a simplified interface between\r\n * Framework components (Views) and Domain Presentation Managers.\r\n *\r\n * Available adapters:\r\n *\r\n * - activeAppPMAdapter: Singleton adapter for accessing the currently active app\r\n * - appListPMAdapter: Singleton adapter for accessing the list of available apps\r\n * - appPMAdapter: Non-singleton adapter for accessing details about a specific app by ID\r\n *\r\n * @module Apps/Adapters\r\n */\r\n\r\nexport * from \"./activeAppPMAdapter\";\r\nexport * from \"./appListPMAdapter\";\r\nexport * from \"./appPMAdapter\";\r\n"]}

package/dist/esm/Apps/Controllers/updateApp.js

@@ -1,4 +1,23 @@
 import { UpdateAppUC } from "../UCs/UpdateAppUC";
+/**
+ * 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 function updateApp(id, appObjects) {
     const uc = UpdateAppUC.getByID(id, appObjects);
     if (!uc) {

package/dist/esm/Apps/Controllers/updateApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"updateApp.js","sourceRoot":"","sources":["../../../../src/Apps/Controllers/updateApp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,UAAyB;IAC7D,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,UAAU,CAAC,WAAW,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IAED,EAAE,CAAC,SAAS,EAAE,CAAC;AACjB,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { UpdateAppUC } from \"../UCs/UpdateAppUC\";\r\n\r\nexport function updateApp(id: string, appObjects: AppObjectRepo) {\r\n  const uc = UpdateAppUC.getByID(id, appObjects);\r\n  if (!uc) {\r\n    appObjects.submitError(\"updateApp\", \"Unable to find UpdateAppUC\");\r\n    return;\r\n  }\r\n\r\n  uc.updateApp();\r\n}\r\n"]}
+{"version":3,"file":"updateApp.js","sourceRoot":"","sources":["../../../../src/Apps/Controllers/updateApp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,UAAyB;IAC7D,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,UAAU,CAAC,WAAW,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IAED,EAAE,CAAC,SAAS,EAAE,CAAC;AACjB,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { UpdateAppUC } from \"../UCs/UpdateAppUC\";\r\n\r\n/**\r\n * Controller function to update an app to its latest version.\r\n *\r\n * This controller is used to trigger the app update process. It finds the\r\n * appropriate UpdateAppUC by the app's ID and calls its updateApp method.\r\n *\r\n * Usage in views:\r\n * ```typescript\r\n * import { updateApp } from \"../Controllers/updateApp\";\r\n *\r\n * // In a React component\r\n * const handleUpdateClick = () => {\r\n *   updateApp(appId, appObjects);\r\n * };\r\n * ```\r\n *\r\n * @param id - The ID of the app to update\r\n * @param appObjects - The app object repository\r\n */\r\nexport function updateApp(id: string, appObjects: AppObjectRepo) {\r\n  const uc = UpdateAppUC.getByID(id, appObjects);\r\n  if (!uc) {\r\n    appObjects.submitError(\"updateApp\", \"Unable to find UpdateAppUC\");\r\n    return;\r\n  }\r\n\r\n  uc.updateApp();\r\n}\r\n"]}

package/dist/esm/Apps/Entities/AppEntity.js

@@ -1,4 +1,13 @@
 import { AppObjectEntity, 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 var AppState;
 (function (AppState) {
     AppState["INIT"] = "INIT";
@@ -6,6 +15,14 @@ export var AppState;
     AppState["READY"] = "READY";
     AppState["ERROR"] = "ERROR";
 })(AppState || (AppState = {}));
+/**
+ * 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 class AppEntity extends AppObjectEntity {
     static get(id, appObjects) {
         const ao = appObjects.get(id);
@@ -16,7 +33,14 @@ export class AppEntity extends AppObjectEntity {
         return ao.getComponent(AppEntity.type);
     }
 }
+/** Type identifier for the AppEntity component */
 AppEntity.type = "AppEntity";
+/**
+ * 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 function makeAppEntity(appObject) {
     return new AppEntityImp(appObject);
 }

package/dist/esm/Apps/Entities/AppEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppEntity.js","sourceRoot":"","sources":["../../../../src/Apps/Entities/AppEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo,\r\n  Version\r\n} from \"@vived/core\";\r\n\r\nexport enum AppState {\r\n  INIT = \"INIT\",\r\n  LOADING = \"LOADING\",\r\n  READY = \"READY\",\r\n  ERROR = \"ERROR\"\r\n}\r\n\r\nexport abstract class AppEntity extends AppObjectEntity {\r\n  static type = \"AppEntity\";\r\n\r\n  static get(id: string, appObjects: AppObjectRepo) {\r\n    const ao = appObjects.get(id);\r\n    if (!ao) {\r\n      appObjects.submitWarning(\r\n        \"AppEntity.get\",\r\n        `Unable to find app object by ID: ${id}`\r\n      );\r\n      return;\r\n    }\r\n\r\n    return ao.getComponent<AppEntity>(AppEntity.type);\r\n  }\r\n\r\n  abstract get id(): string;\r\n  abstract name: string;\r\n  abstract description: string;\r\n  abstract image_url: string;\r\n  abstract versions: Version[];\r\n  abstract get latestVersion(): Version | undefined;\r\n  abstract errorMessage?: string;\r\n  abstract get hasError(): boolean;\r\n  abstract state: AppState;\r\n  abstract assignedToOwner: boolean;\r\n\r\n  abstract get isMounted(): boolean;\r\n  abstract appAssetFolderURL?: string;\r\n  abstract get updateIsAvailable(): boolean | undefined;\r\n  abstract styles: string[];\r\n  abstract mountedVersion: Version | undefined;\r\n}\r\n\r\nexport function makeAppEntity(appObject: AppObject): AppEntity {\r\n  return new AppEntityImp(appObject);\r\n}\r\n\r\nclass AppEntityImp extends AppEntity {\r\n  get id() {\r\n    return this.appObject.id;\r\n  }\r\n\r\n  name: string = \"\";\r\n  description: string = \"\";\r\n  image_url: string = \"\";\r\n\r\n  versions: Version[] = [];\r\n\r\n  get latestVersion(): Version | undefined {\r\n    return Version.GetLatest(this.versions);\r\n  }\r\n\r\n  private _mountedVersion: Version | undefined;\r\n  get mountedVersion() {\r\n    return this._mountedVersion;\r\n  }\r\n  set mountedVersion(val: Version | undefined) {\r\n    if (this._mountedVersion === val) return;\r\n\r\n    this._mountedVersion = val;\r\n    this.notifyOnChange();\r\n  }\r\n\r\n  get updateIsAvailable(): boolean | undefined {\r\n    if (this._mountedVersion === undefined) return undefined;\r\n    if (this.latestVersion === undefined) return undefined;\r\n\r\n    return Version.AreEqual(this._mountedVersion, this.latestVersion)\r\n      ? false\r\n      : true;\r\n  }\r\n\r\n  private _state: AppState = AppState.INIT;\r\n  get state() {\r\n    return this._state;\r\n  }\r\n  set state(val: AppState) {\r\n    this._state = val;\r\n    this.notifyOnChange();\r\n  }\r\n\r\n  private _assignedToOwner: boolean = false;\r\n  get assignedToOwner(): boolean {\r\n    return this._assignedToOwner;\r\n  }\r\n  set assignedToOwner(val: boolean) {\r\n    this._assignedToOwner = val;\r\n    this.notifyOnChange();\r\n  }\r\n\r\n  get isMounted(): boolean {\r\n    return this._mountedVersion === undefined ? false : true;\r\n  }\r\n\r\n  styles: string[] = [];\r\n  appAssetFolderURL: string | undefined;\r\n\r\n  private _errorMsg?: string;\r\n  get errorMessage() {\r\n    return this._errorMsg;\r\n  }\r\n  set errorMessage(val: string | undefined) {\r\n    if (this._errorMsg === val) return;\r\n\r\n    this._errorMsg = val;\r\n    this.notifyOnChange();\r\n  }\r\n  get hasError(): boolean {\r\n    return this._errorMsg === undefined ? false : true;\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppEntity.type);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppEntity.js","sourceRoot":"","sources":["../../../../src/Apps/Entities/AppEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAEf,OAAO,EACR,MAAM,aAAa,CAAC;AAErB;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,+BAAmB,CAAA;IACnB,2BAAe,CAAA;IACf,2BAAe,CAAA;AACjB,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB;AAED;;;;;;;GAOG;AACH,MAAM,OAAgB,SAAU,SAAQ,eAAe;IAIrD,MAAM,CAAC,GAAG,CAAC,EAAU,EAAE,UAAyB;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,aAAa,CACtB,eAAe,EACf,oCAAoC,EAAE,EAAE,CACzC,CAAC;YACF,OAAO;QACT,CAAC;QAED,OAAO,EAAE,CAAC,YAAY,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;;AAdD,kDAAkD;AAC3C,cAAI,GAAG,WAAW,CAAC;AAiC5B;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,SAAoB;IAChD,OAAO,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,YAAa,SAAQ,SAAS;IAClC,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;IAC3B,CAAC;IAQD,IAAI,aAAa;QACf,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAGD,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IACD,IAAI,cAAc,CAAC,GAAwB;QACzC,IAAI,IAAI,CAAC,eAAe,KAAK,GAAG;YAAE,OAAO;QAEzC,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC;QAC3B,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED,IAAI,iBAAiB;QACnB,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACzD,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAEvD,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,aAAa,CAAC;YAC/D,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAGD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,GAAa;QACrB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAClB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAGD,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IACD,IAAI,eAAe,CAAC,GAAY;QAC9B,IAAI,CAAC,gBAAgB,GAAG,GAAG,CAAC;QAC5B,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,CAAC;IAMD,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IACD,IAAI,YAAY,CAAC,GAAuB;QACtC,IAAI,IAAI,CAAC,SAAS,KAAK,GAAG;YAAE,OAAO;QAEnC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACrB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QAtEnC,SAAI,GAAW,EAAE,CAAC;QAClB,gBAAW,GAAW,EAAE,CAAC;QACzB,cAAS,GAAW,EAAE,CAAC;QAEvB,aAAQ,GAAc,EAAE,CAAC;QA0BjB,WAAM,GAAa,QAAQ,CAAC,IAAI,CAAC;QASjC,qBAAgB,GAAY,KAAK,CAAC;QAa1C,WAAM,GAAa,EAAE,CAAC;IAmBtB,CAAC;CACF","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo,\r\n  Version\r\n} from \"@vived/core\";\r\n\r\n/**\r\n * Enum representing the possible states of an application\r\n * \r\n * @enum {string}\r\n * @property {string} INIT - Initial state before app loading starts\r\n * @property {string} LOADING - App is currently loading resources\r\n * @property {string} READY - App is loaded and ready to use\r\n * @property {string} ERROR - App encountered an error during loading\r\n */\r\nexport enum AppState {\r\n  INIT = \"INIT\",\r\n  LOADING = \"LOADING\",\r\n  READY = \"READY\",\r\n  ERROR = \"ERROR\"\r\n}\r\n\r\n/**\r\n * AppEntity - Core entity representing an application in the system\r\n * \r\n * This abstract class defines the properties and behaviors of an application.\r\n * It manages app state, versioning, mounting status, and error handling.\r\n * \r\n * @extends AppObjectEntity from @vived/core\r\n */\r\nexport abstract class AppEntity extends AppObjectEntity {\r\n  /** Type identifier for the AppEntity component */\r\n  static type = \"AppEntity\";\r\n\r\n  static get(id: string, appObjects: AppObjectRepo) {\r\n    const ao = appObjects.get(id);\r\n    if (!ao) {\r\n      appObjects.submitWarning(\r\n        \"AppEntity.get\",\r\n        `Unable to find app object by ID: ${id}`\r\n      );\r\n      return;\r\n    }\r\n\r\n    return ao.getComponent<AppEntity>(AppEntity.type);\r\n  }\r\n\r\n  abstract get id(): string;\r\n  abstract name: string;\r\n  abstract description: string;\r\n  abstract image_url: string;\r\n  abstract versions: Version[];\r\n  abstract get latestVersion(): Version | undefined;\r\n  abstract errorMessage?: string;\r\n  abstract get hasError(): boolean;\r\n  abstract state: AppState;\r\n  abstract assignedToOwner: boolean;\r\n\r\n  abstract get isMounted(): boolean;\r\n  abstract appAssetFolderURL?: string;\r\n  abstract get updateIsAvailable(): boolean | undefined;\r\n  abstract styles: string[];\r\n  abstract mountedVersion: Version | undefined;\r\n}\r\n\r\n/**\r\n * Factory function to create a new AppEntity instance\r\n * \r\n * @param appObject - The app object to attach the entity to\r\n * @returns A concrete implementation of AppEntity\r\n */\r\nexport function makeAppEntity(appObject: AppObject): AppEntity {\r\n  return new AppEntityImp(appObject);\r\n}\r\n\r\nclass AppEntityImp extends AppEntity {\r\n  get id() {\r\n    return this.appObject.id;\r\n  }\r\n\r\n  name: string = \"\";\r\n  description: string = \"\";\r\n  image_url: string = \"\";\r\n\r\n  versions: Version[] = [];\r\n\r\n  get latestVersion(): Version | undefined {\r\n    return Version.GetLatest(this.versions);\r\n  }\r\n\r\n  private _mountedVersion: Version | undefined;\r\n  get mountedVersion() {\r\n    return this._mountedVersion;\r\n  }\r\n  set mountedVersion(val: Version | undefined) {\r\n    if (this._mountedVersion === val) return;\r\n\r\n    this._mountedVersion = val;\r\n    this.notifyOnChange();\r\n  }\r\n\r\n  get updateIsAvailable(): boolean | undefined {\r\n    if (this._mountedVersion === undefined) return undefined;\r\n    if (this.latestVersion === undefined) return undefined;\r\n\r\n    return Version.AreEqual(this._mountedVersion, this.latestVersion)\r\n      ? false\r\n      : true;\r\n  }\r\n\r\n  private _state: AppState = AppState.INIT;\r\n  get state() {\r\n    return this._state;\r\n  }\r\n  set state(val: AppState) {\r\n    this._state = val;\r\n    this.notifyOnChange();\r\n  }\r\n\r\n  private _assignedToOwner: boolean = false;\r\n  get assignedToOwner(): boolean {\r\n    return this._assignedToOwner;\r\n  }\r\n  set assignedToOwner(val: boolean) {\r\n    this._assignedToOwner = val;\r\n    this.notifyOnChange();\r\n  }\r\n\r\n  get isMounted(): boolean {\r\n    return this._mountedVersion === undefined ? false : true;\r\n  }\r\n\r\n  styles: string[] = [];\r\n  appAssetFolderURL: string | undefined;\r\n\r\n  private _errorMsg?: string;\r\n  get errorMessage() {\r\n    return this._errorMsg;\r\n  }\r\n  set errorMessage(val: string | undefined) {\r\n    if (this._errorMsg === val) return;\r\n\r\n    this._errorMsg = val;\r\n    this.notifyOnChange();\r\n  }\r\n  get hasError(): boolean {\r\n    return this._errorMsg === undefined ? false : true;\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppEntity.type);\r\n  }\r\n}\r\n"]}

package/dist/esm/Apps/Entities/AppRepo.js

@@ -1,4 +1,4 @@
-import { AppObjectEntityRepo, getSingletonComponent } from "@vived/core";
+import { AppObjectEntityRepo } from "@vived/core";
 import { makeAppEntity } from "./AppEntity";
 export var AppReleaseStage;
 (function (AppReleaseStage) {
@@ -8,7 +8,7 @@ export var AppReleaseStage;
 })(AppReleaseStage || (AppReleaseStage = {}));
 export class AppRepoEntity extends AppObjectEntityRepo {
     static get(appObjects) {
-        return getSingletonComponent(AppRepoEntity.type, appObjects);
+        return appObjects.getSingleton(AppRepoEntity.type);
     }
 }
 AppRepoEntity.type = "AppRepoEntity";

package/dist/esm/Apps/Entities/AppRepo.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppRepo.js","sourceRoot":"","sources":["../../../../src/Apps/Entities/AppRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,EACJ,qBAAqB,EACrC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAa,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,gCAAa,CAAA;IACb,kCAAe,CAAA;AACjB,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED,MAAM,OAAgB,aAAc,SAAQ,mBAA8B;IAGxE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9E,CAAC;;AAJM,kBAAI,GAAG,eAAe,CAAC;AAiBhC,MAAM,UAAU,WAAW,CAAC,SAAoB;IAC9C,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAW,SAAQ,aAAa;IAuCpC,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;QAvCvC,oBAAe,GAAoB,eAAe,CAAC,OAAO,CAAC;QAE3D,cAAS,GAAG,CAAC,EAAU,EAAa,EAAE;YACpC,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YAC7C,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,WAAW,CAAC;YACrB,CAAC;YAED,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAE3C,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,GAAG,CAAC;QACb,CAAC,CAAC;QAEF,WAAM,GAAG,CAAC,EAAU,EAAyB,EAAE;YAC7C,OAAO,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC;QAEF,eAAU,GAAG,GAAgB,EAAE;YAC7B,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC,CAAC;QAEF,cAAS,GAAG,CAAC,EAAU,EAAQ,EAAE;YAC/B,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC;QAEF,kBAAa,GAAG,GAAS,EAAE;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACnB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,WAAM,GAAG,CAAC,EAAU,EAAW,EAAE;YAC/B,OAAO,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC;QAKA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntityRepo,\r\n  AppObjectRepo, getSingletonComponent\r\n} from \"@vived/core\";\r\nimport { AppEntity, makeAppEntity } from \"./AppEntity\";\r\n\r\nexport enum AppReleaseStage {\r\n  RELEASE = \"RELEASE\",\r\n  BETA = \"BETA\",\r\n  ALPHA = \"ALPHA\"\r\n}\r\n\r\nexport abstract class AppRepoEntity extends AppObjectEntityRepo<AppEntity> {\r\n  static type = \"AppRepoEntity\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<AppRepoEntity>(AppRepoEntity.type, appObjects);\r\n  }\r\n\r\n  abstract createApp: (id: string) => AppEntity;\r\n  abstract getApp: (id: string) => AppEntity | undefined;\r\n  abstract getAllApps: () => AppEntity[];\r\n  abstract deleteApp: (id: string) => void;\r\n  abstract hasApp: (id: string) => boolean;\r\n\r\n  abstract appReleaseStage: AppReleaseStage;\r\n\r\n  abstract deleteAllApps: () => void;\r\n}\r\n\r\nexport function makeAppRepo(appObject: AppObject): AppRepoEntity {\r\n  return new AppRepoImp(appObject);\r\n}\r\n\r\nclass AppRepoImp extends AppRepoEntity {\r\n  appReleaseStage: AppReleaseStage = AppReleaseStage.RELEASE;\r\n\r\n  createApp = (id: string): AppEntity => {\r\n    const existingApp = this.getForAppObject(id);\r\n    if (existingApp) {\r\n      return existingApp;\r\n    }\r\n\r\n    const ao = this.appObjects.getOrCreate(id);\r\n\r\n    const app = makeAppEntity(ao);\r\n    this.add(app);\r\n    return app;\r\n  };\r\n\r\n  getApp = (id: string): AppEntity | undefined => {\r\n    return this.getForAppObject(id);\r\n  };\r\n\r\n  getAllApps = (): AppEntity[] => {\r\n    return this.getAll();\r\n  };\r\n\r\n  deleteApp = (id: string): void => {\r\n    this.removeForAppObject(id);\r\n  };\r\n\r\n  deleteAllApps = (): void => {\r\n    const apps = this.getAllApps();\r\n    apps.forEach((app) => {\r\n      this.deleteApp(app.id);\r\n    });\r\n  };\r\n\r\n  hasApp = (id: string): boolean => {\r\n    return this.hasForAppObject(id);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppRepoEntity.type);\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppRepo.js","sourceRoot":"","sources":["../../../../src/Apps/Entities/AppRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,EAGpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAa,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,gCAAa,CAAA;IACb,kCAAe,CAAA;AACjB,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED,MAAM,OAAgB,aAAc,SAAQ,mBAA8B;IAGxE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,UAAU,CAAC,YAAY,CAAgB,aAAa,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;;AAJM,kBAAI,GAAG,eAAe,CAAC;AAiBhC,MAAM,UAAU,WAAW,CAAC,SAAoB;IAC9C,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAW,SAAQ,aAAa;IAuCpC,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;QAvCvC,oBAAe,GAAoB,eAAe,CAAC,OAAO,CAAC;QAE3D,cAAS,GAAG,CAAC,EAAU,EAAa,EAAE;YACpC,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YAC7C,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,WAAW,CAAC;YACrB,CAAC;YAED,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAE3C,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,GAAG,CAAC;QACb,CAAC,CAAC;QAEF,WAAM,GAAG,CAAC,EAAU,EAAyB,EAAE;YAC7C,OAAO,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC;QAEF,eAAU,GAAG,GAAgB,EAAE;YAC7B,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC,CAAC;QAEF,cAAS,GAAG,CAAC,EAAU,EAAQ,EAAE;YAC/B,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC;QAEF,kBAAa,GAAG,GAAS,EAAE;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACnB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,WAAM,GAAG,CAAC,EAAU,EAAW,EAAE;YAC/B,OAAO,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC;QAKA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntityRepo,\r\n  AppObjectRepo,\r\n  getSingletonComponent\r\n} from \"@vived/core\";\r\nimport { AppEntity, makeAppEntity } from \"./AppEntity\";\r\n\r\nexport enum AppReleaseStage {\r\n  RELEASE = \"RELEASE\",\r\n  BETA = \"BETA\",\r\n  ALPHA = \"ALPHA\"\r\n}\r\n\r\nexport abstract class AppRepoEntity extends AppObjectEntityRepo<AppEntity> {\r\n  static type = \"AppRepoEntity\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return appObjects.getSingleton<AppRepoEntity>(AppRepoEntity.type);\r\n  }\r\n\r\n  abstract createApp: (id: string) => AppEntity;\r\n  abstract getApp: (id: string) => AppEntity | undefined;\r\n  abstract getAllApps: () => AppEntity[];\r\n  abstract deleteApp: (id: string) => void;\r\n  abstract hasApp: (id: string) => boolean;\r\n\r\n  abstract appReleaseStage: AppReleaseStage;\r\n\r\n  abstract deleteAllApps: () => void;\r\n}\r\n\r\nexport function makeAppRepo(appObject: AppObject): AppRepoEntity {\r\n  return new AppRepoImp(appObject);\r\n}\r\n\r\nclass AppRepoImp extends AppRepoEntity {\r\n  appReleaseStage: AppReleaseStage = AppReleaseStage.RELEASE;\r\n\r\n  createApp = (id: string): AppEntity => {\r\n    const existingApp = this.getForAppObject(id);\r\n    if (existingApp) {\r\n      return existingApp;\r\n    }\r\n\r\n    const ao = this.appObjects.getOrCreate(id);\r\n\r\n    const app = makeAppEntity(ao);\r\n    this.add(app);\r\n    return app;\r\n  };\r\n\r\n  getApp = (id: string): AppEntity | undefined => {\r\n    return this.getForAppObject(id);\r\n  };\r\n\r\n  getAllApps = (): AppEntity[] => {\r\n    return this.getAll();\r\n  };\r\n\r\n  deleteApp = (id: string): void => {\r\n    this.removeForAppObject(id);\r\n  };\r\n\r\n  deleteAllApps = (): void => {\r\n    const apps = this.getAllApps();\r\n    apps.forEach((app) => {\r\n      this.deleteApp(app.id);\r\n    });\r\n  };\r\n\r\n  hasApp = (id: string): boolean => {\r\n    return this.hasForAppObject(id);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppRepoEntity.type);\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

package/dist/esm/Apps/PMs/ActiveAppPM.js

@@ -1,12 +1,31 @@
 import { AppObjectPM } from "@vived/core";
+/**
+ * Default values for the ActiveAppVM
+ */
 export const defaultActiveAppVM = {
     id: "",
     stylesheets: []
 };
+/**
+ * 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 class ActiveAppPM extends AppObjectPM {
+    /**
+     * 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) {
         return appObjects.getSingleton(ActiveAppPM.type);
     }
 }
+/** Type identifier for the ActiveAppPM component */
 ActiveAppPM.type = "ActiveAppPM";
 //# sourceMappingURL=ActiveAppPM.js.map

package/dist/esm/Apps/PMs/ActiveAppPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActiveAppPM.js","sourceRoot":"","sources":["../../../../src/Apps/PMs/ActiveAppPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AAOzD,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,EAAE,EAAE,EAAE;IACN,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAM,OAAgB,WAAY,SAAQ,WAAwB;IAGhE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,UAAU,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;;AAJM,gBAAI,GAAG,aAAa,CAAC","sourcesContent":["import { AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\n\r\nexport interface ActiveAppVM {\r\n  id: string;\r\n  stylesheets: string[];\r\n}\r\n\r\nexport const defaultActiveAppVM: ActiveAppVM = {\r\n  id: \"\",\r\n  stylesheets: []\r\n};\r\n\r\nexport abstract class ActiveAppPM extends AppObjectPM<ActiveAppVM> {\r\n  static type = \"ActiveAppPM\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return appObjects.getSingleton<ActiveAppPM>(ActiveAppPM.type);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ActiveAppPM.js","sourceRoot":"","sources":["../../../../src/Apps/PMs/ActiveAppPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AAazD;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,EAAE,EAAE,EAAE;IACN,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,OAAgB,WAAY,SAAQ,WAAwB;IAIhE;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,UAAU,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;;AAXD,oDAAoD;AAC7C,gBAAI,GAAG,aAAa,CAAC","sourcesContent":["import { AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\n\r\n/**\r\n * Interface defining the view model for the active application\r\n * \r\n * @property {string} id - The ID of the currently active app\r\n * @property {string[]} stylesheets - List of stylesheet URLs for the active app\r\n */\r\nexport interface ActiveAppVM {\r\n  id: string;\r\n  stylesheets: string[];\r\n}\r\n\r\n/**\r\n * Default values for the ActiveAppVM\r\n */\r\nexport const defaultActiveAppVM: ActiveAppVM = {\r\n  id: \"\",\r\n  stylesheets: []\r\n};\r\n\r\n/**\r\n * ActiveAppPM - Presentation model that manages the currently active application\r\n * \r\n * This singleton PM tracks which app is currently active in the system and provides\r\n * access to information about that app, such as its stylesheets. The UI layer can\r\n * subscribe to changes in the active app through this PM.\r\n * \r\n * @extends AppObjectPM<ActiveAppVM>\r\n */\r\nexport abstract class ActiveAppPM extends AppObjectPM<ActiveAppVM> {\r\n  /** Type identifier for the ActiveAppPM component */\r\n  static type = \"ActiveAppPM\";\r\n\r\n  /**\r\n   * Gets the singleton instance of ActiveAppPM from the app objects repository\r\n   * \r\n   * @param appObjects - Repository containing app objects\r\n   * @returns The singleton ActiveAppPM instance\r\n   */\r\n  static get(appObjects: AppObjectRepo) {\r\n    return appObjects.getSingleton<ActiveAppPM>(ActiveAppPM.type);\r\n  }\r\n}\r\n"]}

package/dist/esm/Apps/PMs/AppPM.js

@@ -1,12 +1,35 @@
 import { AppObjectPM } from "@vived/core";
 import { AppEntity } from "../Entities/AppEntity";
+/**
+ * Default empty AppVM for initialization
+ */
 export const defaultAppVM = {
     id: "",
     description: "",
     imageURL: "",
     name: ""
 };
+/**
+ * Presentation Manager for App entities
+ *
+ * The AppPM is responsible for:
+ * - Converting the AppEntity data into a view-friendly format (AppVM)
+ * - Notifying the view when app data changes
+ * - Providing comparison utilities for view models
+ *
+ * Usage:
+ * 1. Retrieve an instance with `AppPM.get(appId, appObjects)`
+ * 2. Subscribe to view updates with `pm.addViewUpdateObserver(callback)`
+ * 3. Access current view data with `pm.lastVM`
+ */
 export class AppPM extends AppObjectPM {
+    /**
+     * Retrieves an AppPM instance for a specific app by ID
+     *
+     * @param id - The unique identifier of the app
+     * @param appObjects - The repository of app objects
+     * @returns The AppPM instance or undefined if not found
+     */
     static get(id, appObjects) {
         const ao = appObjects.get(id);
         if (!ao) {
@@ -16,13 +39,34 @@ export class AppPM extends AppObjectPM {
     }
 }
 AppPM.type = "AppPM";
+/**
+ * Creates a new AppPM instance
+ *
+ * @param appObject - The app object to associate with this PM
+ * @returns A new AppPM instance
+ */
 export function makeAppPM(appObject) {
     return new AppPMImp(appObject);
 }
+/**
+ * Implementation of the AppPM abstract class
+ * Handles the connection between AppEntity and view
+ */
 class AppPMImp extends AppPM {
+    /**
+     * Gets the associated AppEntity
+     */
     get app() {
         return this.getCachedLocalComponent(AppEntity.type);
     }
+    /**
+     * Compares two AppVM instances for equality
+     * Used to determine if the view needs to update
+     *
+     * @param a - First AppVM to compare
+     * @param b - Second AppVM to compare
+     * @returns True if view models are equal, false otherwise
+     */
     vmsAreEqual(a, b) {
         if (a.description !== b.description)
             return false;
@@ -32,8 +76,17 @@ class AppPMImp extends AppPM {
             return false;
         return true;
     }
+    /**
+     * Creates a new AppPM instance
+     *
+     * @param appObject - The app object to associate with this PM
+     */
     constructor(appObject) {
         super(appObject, AppPM.type);
+        /**
+         * Observer callback that updates the view model when the entity changes
+         * Transforms entity data into view model format
+         */
         this.onEntityChange = () => {
             if (!this.app)
                 return;

package/dist/esm/Apps/PMs/AppPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppPM.js","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AASlD,MAAM,CAAC,MAAM,YAAY,GAAU;IACjC,EAAE,EAAE,EAAE;IACN,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,OAAgB,KAAM,SAAQ,WAAkB;IAGpD,MAAM,CAAC,GAAG,CAAC,EAAU,EAAE,UAAyB;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO;QACT,CAAC;QAED,OAAO,EAAE,CAAC,YAAY,CAAQ,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;;AATM,UAAI,GAAG,OAAO,CAAC;AAYxB,MAAM,UAAU,SAAS,CAAC,SAAoB;IAC5C,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,QAAS,SAAQ,KAAK;IAC1B,IAAY,GAAG;QACb,OAAO,IAAI,CAAC,uBAAuB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAED,WAAW,CAAC,CAAQ,EAAE,CAAQ;QAC5B,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAClD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACpC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAeD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAdvB,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,OAAO;YAEtB,MAAM,EAAE,GAAU;gBAChB,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW;gBACjC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE;gBACf,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS;gBAC5B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;aACpB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAKA,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AppEntity } from \"../Entities/AppEntity\";\r\n\r\nexport interface AppVM {\r\n  id: string;\r\n  name: string;\r\n  description: string;\r\n  imageURL: string;\r\n}\r\n\r\nexport const defaultAppVM: AppVM = {\r\n  id: \"\",\r\n  description: \"\",\r\n  imageURL: \"\",\r\n  name: \"\"\r\n};\r\n\r\nexport abstract class AppPM extends AppObjectPM<AppVM> {\r\n  static type = \"AppPM\";\r\n\r\n  static get(id: string, appObjects: AppObjectRepo) {\r\n    const ao = appObjects.get(id);\r\n    if (!ao) {\r\n      return;\r\n    }\r\n\r\n    return ao.getComponent<AppPM>(AppPM.type);\r\n  }\r\n}\r\n\r\nexport function makeAppPM(appObject: AppObject): AppPM {\r\n  return new AppPMImp(appObject);\r\n}\r\n\r\nclass AppPMImp extends AppPM {\r\n  private get app() {\r\n    return this.getCachedLocalComponent<AppEntity>(AppEntity.type);\r\n  }\r\n\r\n  vmsAreEqual(a: AppVM, b: AppVM): boolean {\r\n    if (a.description !== b.description) return false;\r\n    if (a.name !== b.name) return false;\r\n    if (a.imageURL !== b.imageURL) return false;\r\n    return true;\r\n  }\r\n\r\n  private onEntityChange = () => {\r\n    if (!this.app) return;\r\n\r\n    const vm: AppVM = {\r\n      description: this.app.description,\r\n      id: this.app.id,\r\n      imageURL: this.app.image_url,\r\n      name: this.app.name\r\n    };\r\n\r\n    this.doUpdateView(vm);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppPM.type);\r\n\r\n    this.app?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppPM.js","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAiBlD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAU;IACjC,EAAE,EAAE,EAAE;IACN,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,EAAE;CACT,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAgB,KAAM,SAAQ,WAAkB;IAGpD;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,EAAU,EAAE,UAAyB;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO;QACT,CAAC;QAED,OAAO,EAAE,CAAC,YAAY,CAAQ,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;;AAhBM,UAAI,GAAG,OAAO,CAAC;AAmBxB;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,SAAoB;IAC5C,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,QAAS,SAAQ,KAAK;IAC1B;;OAEG;IACH,IAAY,GAAG;QACb,OAAO,IAAI,CAAC,uBAAuB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,CAAQ,EAAE,CAAQ;QAC5B,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAClD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACpC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAmBD;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAvB/B;;;WAGG;QACK,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,OAAO;YAEtB,MAAM,EAAE,GAAU;gBAChB,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW;gBACjC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE;gBACf,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS;gBAC5B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;aACpB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAUA,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AppEntity } from \"../Entities/AppEntity\";\r\n\r\n/**\r\n * View Model for App information\r\n * Represents the data needed by the view to display an app\r\n */\r\nexport interface AppVM {\r\n  /** Unique identifier for the app */\r\n  id: string;\r\n  /** Display name of the app */\r\n  name: string;\r\n  /** Description text for the app */\r\n  description: string;\r\n  /** URL to the app's thumbnail or preview image */\r\n  imageURL: string;\r\n}\r\n\r\n/**\r\n * Default empty AppVM for initialization\r\n */\r\nexport const defaultAppVM: AppVM = {\r\n  id: \"\",\r\n  description: \"\",\r\n  imageURL: \"\",\r\n  name: \"\"\r\n};\r\n\r\n/**\r\n * Presentation Manager for App entities\r\n * \r\n * The AppPM is responsible for:\r\n * - Converting the AppEntity data into a view-friendly format (AppVM)\r\n * - Notifying the view when app data changes\r\n * - Providing comparison utilities for view models\r\n * \r\n * Usage:\r\n * 1. Retrieve an instance with `AppPM.get(appId, appObjects)`\r\n * 2. Subscribe to view updates with `pm.addViewUpdateObserver(callback)`\r\n * 3. Access current view data with `pm.lastVM`\r\n */\r\nexport abstract class AppPM extends AppObjectPM<AppVM> {\r\n  static type = \"AppPM\";\r\n\r\n  /**\r\n   * Retrieves an AppPM instance for a specific app by ID\r\n   * \r\n   * @param id - The unique identifier of the app\r\n   * @param appObjects - The repository of app objects\r\n   * @returns The AppPM instance or undefined if not found\r\n   */\r\n  static get(id: string, appObjects: AppObjectRepo) {\r\n    const ao = appObjects.get(id);\r\n    if (!ao) {\r\n      return;\r\n    }\r\n\r\n    return ao.getComponent<AppPM>(AppPM.type);\r\n  }\r\n}\r\n\r\n/**\r\n * Creates a new AppPM instance\r\n * \r\n * @param appObject - The app object to associate with this PM\r\n * @returns A new AppPM instance\r\n */\r\nexport function makeAppPM(appObject: AppObject): AppPM {\r\n  return new AppPMImp(appObject);\r\n}\r\n\r\n/**\r\n * Implementation of the AppPM abstract class\r\n * Handles the connection between AppEntity and view\r\n */\r\nclass AppPMImp extends AppPM {\r\n  /**\r\n   * Gets the associated AppEntity\r\n   */\r\n  private get app() {\r\n    return this.getCachedLocalComponent<AppEntity>(AppEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Compares two AppVM instances for equality\r\n   * Used to determine if the view needs to update\r\n   * \r\n   * @param a - First AppVM to compare\r\n   * @param b - Second AppVM to compare\r\n   * @returns True if view models are equal, false otherwise\r\n   */\r\n  vmsAreEqual(a: AppVM, b: AppVM): boolean {\r\n    if (a.description !== b.description) return false;\r\n    if (a.name !== b.name) return false;\r\n    if (a.imageURL !== b.imageURL) return false;\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Observer callback that updates the view model when the entity changes\r\n   * Transforms entity data into view model format\r\n   */\r\n  private onEntityChange = () => {\r\n    if (!this.app) return;\r\n\r\n    const vm: AppVM = {\r\n      description: this.app.description,\r\n      id: this.app.id,\r\n      imageURL: this.app.image_url,\r\n      name: this.app.name\r\n    };\r\n\r\n    this.doUpdateView(vm);\r\n  };\r\n\r\n  /**\r\n   * Creates a new AppPM instance\r\n   * \r\n   * @param appObject - The app object to associate with this PM\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppPM.type);\r\n\r\n    this.app?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n  }\r\n}\r\n"]}

package/dist/esm/Apps/PMs/AppsListPM.js

@@ -1,18 +1,52 @@
 import { AppObjectPM } from "@vived/core";
 import { AppRepoEntity } from "../Entities";
+/**
+ * Presentation Manager for displaying a list of available apps.
+ *
+ * This singleton PM observes the AppRepoEntity and transforms the list of app entities
+ * into a simple array of app IDs for views to consume. It specifically filters for apps
+ * that are assigned to the current owner/user.
+ *
+ * @extends AppObjectPM<string[]> - The view model is a simple array of app IDs
+ */
 export class AppsListPM extends AppObjectPM {
+    /**
+     * Gets the singleton instance of AppsListPM.
+     *
+     * @param appObjects - The app object repository
+     * @returns The AppsListPM instance or undefined if not found
+     */
     static get(appObjects) {
         return appObjects.getSingleton(AppsListPM.type);
     }
 }
 AppsListPM.type = "AppsListPM";
-export function makeAppListPM(appObject) {
-    return new AppListImp(appObject);
+/**
+ * Factory function to create a new AppsListPM instance.
+ *
+ * @param appObject - The app object to attach the PM to
+ * @returns A new AppsListPM instance
+ */
+export function makeAppsListPM(appObject) {
+    return new AppsListPMImp(appObject);
 }
-class AppListImp extends AppsListPM {
+/**
+ * Concrete implementation of the AppsListPM abstract class.
+ */
+class AppsListPMImp extends AppsListPM {
+    /**
+     * Gets the app repository entity that contains all available apps.
+     */
     get slideApps() {
         return this.getCachedSingleton(AppRepoEntity.type);
     }
+    /**
+     * Compares two app ID arrays for equality.
+     *
+     * @param a - First array of app IDs
+     * @param b - Second array of app IDs
+     * @returns True if the arrays contain the same IDs in the same order
+     */
     vmsAreEqual(a, b) {
         if (a.length !== b.length)
             return false;
@@ -24,8 +58,19 @@ class AppListImp extends AppsListPM {
         });
         return areEqual;
     }
+    /**
+     * Creates a new AppsListPMImp instance.
+     *
+     * @param appObject - The app object to attach to
+     */
     constructor(appObject) {
         super(appObject, AppsListPM.type);
+        /**
+         * Handler for changes in the app repository.
+         *
+         * This filters apps to include only those assigned to the owner
+         * and updates the view model with their IDs.
+         */
         this.onEntityChange = () => {
             if (!this.slideApps)
                 return;

package/dist/esm/Apps/PMs/AppsListPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppsListPM.js","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppsListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAgB,UAAW,SAAQ,WAAqB;IAG5D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,UAAU,CAAC,YAAY,CAAa,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;;AAJM,eAAI,GAAG,YAAY,CAAC;AAO7B,MAAM,UAAU,aAAa,CAAC,SAAoB;IAChD,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAW,SAAQ,UAAU;IACjC,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,aAAa,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,WAAW,CAAC,CAAW,EAAE,CAAW;QAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,QAAQ,GAAG,IAAI,CAAC;QAEpB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjB,IAAI,GAAG,KAAK,GAAG;gBAAE,QAAQ,GAAG,KAAK,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAiBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAhB5B,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;YAC5C,MAAM,GAAG,GAAa,EAAE,CAAC;YAEzB,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACtB,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;oBACxB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvD,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AppRepoEntity } from \"../Entities\";\r\n\r\nexport abstract class AppsListPM extends AppObjectPM<string[]> {\r\n  static type = \"AppsListPM\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return appObjects.getSingleton<AppsListPM>(AppsListPM.type);\r\n  }\r\n}\r\n\r\nexport function makeAppListPM(appObject: AppObject): AppsListPM {\r\n  return new AppListImp(appObject);\r\n}\r\n\r\nclass AppListImp extends AppsListPM {\r\n  private get slideApps() {\r\n    return this.getCachedSingleton<AppRepoEntity>(AppRepoEntity.type);\r\n  }\r\n\r\n  vmsAreEqual(a: string[], b: string[]): boolean {\r\n    if (a.length !== b.length) return false;\r\n    let areEqual = true;\r\n\r\n    a.forEach((aID, i) => {\r\n      const bID = b[i];\r\n      if (aID !== bID) areEqual = false;\r\n    });\r\n    return areEqual;\r\n  }\r\n\r\n  private onEntityChange = () => {\r\n    if (!this.slideApps) return;\r\n\r\n    const allApps = this.slideApps.getAllApps();\r\n    const vms: string[] = [];\r\n\r\n    allApps.forEach((app) => {\r\n      if (app.assignedToOwner) {\r\n        vms.push(app.id);\r\n      }\r\n    });\r\n\r\n    this.doUpdateView(vms);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppsListPM.type);\r\n\r\n    this.slideApps?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppsListPM.js","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppsListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,OAAgB,UAAW,SAAQ,WAAqB;IAG5D;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,UAAU,CAAC,YAAY,CAAa,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;;AAVM,eAAI,GAAG,YAAY,CAAC;AAa7B;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,aAAc,SAAQ,UAAU;IACpC;;OAEG;IACH,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,aAAa,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,CAAW,EAAE,CAAW;QAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,QAAQ,GAAG,IAAI,CAAC;QAEpB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjB,IAAI,GAAG,KAAK,GAAG;gBAAE,QAAQ,GAAG,KAAK,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAuBD;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QA3BpC;;;;;WAKG;QACK,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;YAC5C,MAAM,GAAG,GAAa,EAAE,CAAC;YAEzB,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACtB,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;oBACxB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC;QAUA,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvD,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AppRepoEntity } from \"../Entities\";\r\n\r\n/**\r\n * Presentation Manager for displaying a list of available apps.\r\n *\r\n * This singleton PM observes the AppRepoEntity and transforms the list of app entities\r\n * into a simple array of app IDs for views to consume. It specifically filters for apps\r\n * that are assigned to the current owner/user.\r\n *\r\n * @extends AppObjectPM<string[]> - The view model is a simple array of app IDs\r\n */\r\nexport abstract class AppsListPM extends AppObjectPM<string[]> {\r\n  static type = \"AppsListPM\";\r\n\r\n  /**\r\n   * Gets the singleton instance of AppsListPM.\r\n   *\r\n   * @param appObjects - The app object repository\r\n   * @returns The AppsListPM instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo) {\r\n    return appObjects.getSingleton<AppsListPM>(AppsListPM.type);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new AppsListPM instance.\r\n *\r\n * @param appObject - The app object to attach the PM to\r\n * @returns A new AppsListPM instance\r\n */\r\nexport function makeAppsListPM(appObject: AppObject): AppsListPM {\r\n  return new AppsListPMImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of the AppsListPM abstract class.\r\n */\r\nclass AppsListPMImp extends AppsListPM {\r\n  /**\r\n   * Gets the app repository entity that contains all available apps.\r\n   */\r\n  private get slideApps() {\r\n    return this.getCachedSingleton<AppRepoEntity>(AppRepoEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Compares two app ID arrays for equality.\r\n   *\r\n   * @param a - First array of app IDs\r\n   * @param b - Second array of app IDs\r\n   * @returns True if the arrays contain the same IDs in the same order\r\n   */\r\n  vmsAreEqual(a: string[], b: string[]): boolean {\r\n    if (a.length !== b.length) return false;\r\n    let areEqual = true;\r\n\r\n    a.forEach((aID, i) => {\r\n      const bID = b[i];\r\n      if (aID !== bID) areEqual = false;\r\n    });\r\n    return areEqual;\r\n  }\r\n\r\n  /**\r\n   * Handler for changes in the app repository.\r\n   *\r\n   * This filters apps to include only those assigned to the owner\r\n   * and updates the view model with their IDs.\r\n   */\r\n  private onEntityChange = () => {\r\n    if (!this.slideApps) return;\r\n\r\n    const allApps = this.slideApps.getAllApps();\r\n    const vms: string[] = [];\r\n\r\n    allApps.forEach((app) => {\r\n      if (app.assignedToOwner) {\r\n        vms.push(app.id);\r\n      }\r\n    });\r\n\r\n    this.doUpdateView(vms);\r\n  };\r\n\r\n  /**\r\n   * Creates a new AppsListPMImp instance.\r\n   *\r\n   * @param appObject - The app object to attach to\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppsListPM.type);\r\n\r\n    this.slideApps?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

package/dist/esm/Apps/UCs/Mounters/MounterUC.js

@@ -4,32 +4,85 @@ import { HostHandlerEntity } from "../../../Handler/Entities/HostHandler";
 import { GetAppFromAPIUC } from "../../../VivedAPI/UCs/GetAppFromAPIUC";
 import { AppEntity, AppState } from "../../Entities/AppEntity";
 import { formAppIDWithVersion } from "../formAppIDWithVersion";
+/**
+ * Abstract base class for app mounting use cases.
+ *
+ * The MounterUC is responsible for loading, initializing, and managing app
+ * lifecycle. It handles script loading, version management, and communication
+ * setup between the host and app.
+ *
+ * @extends AppObjectUC from @vived/core
+ */
 export class MounterUC extends AppObjectUC {
+    /**
+     * Retrieves the MounterUC component from an app object.
+     *
+     * @param appObject - The app object to get the component from
+     * @returns The MounterUC component or undefined if not found
+     */
     static get(appObject) {
         return appObject.getComponent(MounterUC.type);
     }
+    /**
+     * Retrieves the MounterUC component by app object ID.
+     *
+     * @param id - The ID of the app object
+     * @param appObjects - The app object repository
+     * @returns The MounterUC component or undefined if not found
+     */
     static getById(id, appObjects) {
         const ao = appObjects.get(id);
         return ao?.getComponent(MounterUC.type);
     }
 }
 MounterUC.type = "MounterUC";
+/**
+ * Factory function to create a new MounterUC instance.
+ *
+ * @param appObject - The app object to attach the mounter to
+ * @returns A new MounterUC instance
+ */
 export function makeMounterUC(appObject) {
     return new MounterUCImp(appObject);
 }
+/**
+ * Concrete implementation of the MounterUC abstract class.
+ *
+ * This implementation provides the standard mounting behavior for loading
+ * and initializing apps, handling script loading, and managing app lifecycle.
+ */
 class MounterUCImp extends MounterUC {
+    /**
+     * Gets the use case for retrieving apps from the API.
+     */
     get getAppFromAPI() {
         return this.getCachedSingleton(GetAppFromAPIUC.type);
     }
+    /**
+     * Gets the app entity representing the app being mounted.
+     */
     get app() {
         return this.getCachedLocalComponent(AppEntity.type);
     }
+    /**
+     * Gets the host handler entity for receiving messages from apps.
+     */
     get hostHandler() {
         return this.getCachedLocalComponent(HostHandlerEntity.type);
     }
+    /**
+     * Gets the host dispatcher entity for sending messages to apps.
+     */
     get hostDispatcher() {
         return this.getCachedLocalComponent(HostDispatchEntity.type);
     }
+    /**
+     * Helper method to find a specific version of the app.
+     *
+     * @param major - Major version number
+     * @param minor - Minor version number
+     * @returns The Version object or undefined if not found
+     */
     getAppVersion(major, minor) {
         if (!this.app) {
             return;
@@ -43,6 +96,11 @@ class MounterUCImp extends MounterUC {
         }
         return appVersion;
     }
+    /**
+     * Mounts the latest available version of the app.
+     *
+     * @returns A promise that resolves when the app is mounted
+     */
     mountLatestVersion() {
         if (!this.app) {
             this.error("Missing Components");
@@ -55,6 +113,12 @@ class MounterUCImp extends MounterUC {
         }
         return this.mount(version.major, version.minor);
     }
+    /**
+     * Parses app entrypoints into scripts and styles.
+     *
+     * @param endpoints - Array of endpoint URLs
+     * @returns Object with separate arrays for scripts and styles
+     */
     parseEndpoints(endpoints) {
         const scripts = [];
         const styles = [];
@@ -74,6 +138,17 @@ class MounterUCImp extends MounterUC {
             styles
         };
     }
+    /**
+     * Waits for an app to report it's ready.
+     *
+     * This method handles special cases for apps that don't properly
+     * report their ready state, as well as the normal case where
+     * apps transition to the READY state.
+     *
+     * @param app - The app entity
+     * @param appVersion - The app version
+     * @returns A promise that resolves when the app is ready
+     */
     waitForAppIsReady(app, appVersion) {
         // Edge cases here
         if (app.id === "app4e48fbaa815a4857821bf7569b003751" &&
@@ -118,9 +193,23 @@ class MounterUCImp extends MounterUC {
             app.addChangeObserver(appObserver);
         });
     }
+    /**
+     * Creates a new MounterUCImp instance.
+     *
+     * @param appObject - The app object to attach to
+     */
     constructor(appObject) {
         super(appObject, MounterUC.type);
+        /**
+         * Tracks script elements added to the document to enable cleanup.
+         */
         this.scriptElements = [];
+        /**
+         * Unmounts the app, removing it from the runtime environment.
+         *
+         * This removes script elements, cleans up global references,
+         * and resets app state.
+         */
         this.unmount = () => {
             if (!this.app)
                 return;
@@ -138,6 +227,17 @@ class MounterUCImp extends MounterUC {
             this.app.mountedVersion = undefined;
             this.app.state = AppState.INIT;
         };
+        /**
+         * Mounts a specific version of the app.
+         *
+         * This method fetches the app from the API, loads scripts,
+         * establishes communication with the app, and waits for the
+         * app to be ready.
+         *
+         * @param majorVersion - The major version number
+         * @param minorVersion - The minor version number
+         * @returns A promise that resolves when the app is mounted
+         */
         this.mount = (majorVersion, minorVersion) => {
             const fetchApp = this.getAppFromAPI;
             if (!fetchApp) {
@@ -197,6 +297,13 @@ class MounterUCImp extends MounterUC {
                 });
             });
         };
+        /**
+         * Loads app scripts and retrieves the app interface.
+         *
+         * @param scripts - Array of script URLs to load
+         * @param version - The app version
+         * @returns A promise that resolves with the app interface
+         */
         this.loadScripts = (scripts, version) => {
             const app = this.app;
             if (!app) {
@@ -229,6 +336,13 @@ class MounterUCImp extends MounterUC {
                 });
             });
         };
+        /**
+         * Loads a script into the document.
+         *
+         * @param scriptURL - URL of the script to load
+         * @param appIDWithVersion - Versioned ID of the app
+         * @returns A promise that resolves when the script is loaded
+         */
         this.loadScriptIntoDocument = (scriptURL, appIDWithVersion) => {
             return new Promise((resolve, reject) => {
                 const aScript = document.createElement("script");
@@ -245,6 +359,12 @@ class MounterUCImp extends MounterUC {
                 document.head.appendChild(aScript);
             });
         };
+        /**
+         * Gets the app interface for a specific version.
+         *
+         * @param version - The version to get the interface for
+         * @returns The app interface or undefined if not found
+         */
         this.getAppInterface = (version) => {
             if (!this.app)
                 return;