@vived/host 4.2.0 → 4.4.0

package/dist/esm/Apps/Adapters/appListPMAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"appListPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appListPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAiC;IAC5D,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,CAAC,UAAyB,EAAE,KAA6B,EAAE,EAAE;QACtE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,kBAAkB,EAAE,2BAA2B,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,WAAW,EAAE,CAAC,UAAyB,EAAE,KAA6B,EAAE,EAAE;QACxE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,kBAAkB,EAAE,2BAA2B,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, SingletonPmAdapter } from \"@vived/core\";\r\nimport { AppsListPM } from \"../PMs/AppsListPM\";\r\n\r\nexport const appListPMAdapter: SingletonPmAdapter<string[]> = {\r\n  defaultVM: [],\r\n  subscribe: (appObjects: AppObjectRepo, setVM: (vm: string[]) => void) => {\r\n    const pm = AppsListPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appListPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n  unsubscribe: (appObjects: AppObjectRepo, setVM: (vm: string[]) => void) => {\r\n    const pm = AppsListPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appListPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}
+{"version":3,"file":"appListPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appListPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiC;IAC5D;;;OAGG;IACH,SAAS,EAAE,EAAE;IAEb;;;;;OAKG;IACH,SAAS,EAAE,CAAC,UAAyB,EAAE,KAA6B,EAAE,EAAE;QACtE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,kBAAkB,EAAE,2BAA2B,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,WAAW,EAAE,CAAC,UAAyB,EAAE,KAA6B,EAAE,EAAE;QACxE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,kBAAkB,EAAE,2BAA2B,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, SingletonPmAdapter } from \"@vived/core\";\r\nimport { AppsListPM } from \"../PMs/AppsListPM\";\r\n\r\n/**\r\n * Adapter for the AppsListPM singleton presentation manager.\r\n *\r\n * This adapter provides a simple interface for framework components to connect with\r\n * the AppsListPM presentation manager, which provides a list of available app IDs.\r\n *\r\n * Usage in components:\r\n * ```\r\n * // React component example\r\n * const [appIds, setAppIds] = useState(appListPMAdapter.defaultVM);\r\n *\r\n * useEffect(() => {\r\n *   appListPMAdapter.subscribe(appObjects, setAppIds);\r\n *   return () => appListPMAdapter.unsubscribe(appObjects, setAppIds);\r\n * }, [appObjects]);\r\n * ```\r\n *\r\n * @type {SingletonPmAdapter<string[]>} Singleton adapter that provides a list of app IDs\r\n */\r\nexport const appListPMAdapter: SingletonPmAdapter<string[]> = {\r\n  /**\r\n   * Default view model to use before the actual data is loaded\r\n   * or when the presentation manager isn't available\r\n   */\r\n  defaultVM: [],\r\n\r\n  /**\r\n   * Subscribes a view callback to the apps list presentation manager\r\n   *\r\n   * @param appObjects - The app object repository\r\n   * @param setVM - Callback function that will receive view model updates (array of app IDs)\r\n   */\r\n  subscribe: (appObjects: AppObjectRepo, setVM: (vm: string[]) => void) => {\r\n    const pm = AppsListPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appListPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n\r\n  /**\r\n   * Unsubscribes a view callback from the apps list presentation manager\r\n   *\r\n   * @param appObjects - The app object repository\r\n   * @param setVM - The callback function to remove\r\n   */\r\n  unsubscribe: (appObjects: AppObjectRepo, setVM: (vm: string[]) => void) => {\r\n    const pm = AppsListPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appListPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}

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

@@ -1,6 +1,36 @@
 import { AppPM, defaultAppVM } 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 const appPMAdapter = {
+    /**
+     * Default view model to use before the actual data is loaded
+     * or when the presentation manager isn't available
+     */
     defaultVM: defaultAppVM,
+    /**
+     * Subscribes a view callback to the app presentation manager
+     *
+     * @param id - ID of the specific app to subscribe to
+     * @param appObjects - The app object repository
+     * @param setVM - Callback function that will receive view model updates
+     */
     subscribe: (id, appObjects, setVM) => {
         const pm = AppPM.get(id, appObjects);
         if (!pm) {
@@ -9,6 +39,13 @@ export const appPMAdapter = {
         }
         pm.addView(setVM);
     },
+    /**
+     * Unsubscribes a view callback from the app presentation manager
+     *
+     * @param id - ID of the specific app to unsubscribe from
+     * @param appObjects - The app object repository
+     * @param setVM - The callback function to remove
+     */
     unsubscribe: (id, appObjects, setVM) => {
         const pm = AppPM.get(id, appObjects);
         if (!pm) {

package/dist/esm/Apps/Adapters/appPMAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"appPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAS,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,CACT,EAAU,EACV,UAAyB,EACzB,KAA0B,EAC1B,EAAE;QACF,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,WAAW,EAAE,CACX,EAAU,EACV,UAAyB,EACzB,KAA0B,EAC1B,EAAE;QACF,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, PmAdapter } from \"@vived/core\";\r\nimport { AppPM, AppVM, defaultAppVM } from \"../PMs/AppPM\";\r\n\r\nexport const appPMAdapter: PmAdapter<AppVM> = {\r\n  defaultVM: defaultAppVM,\r\n  subscribe: (\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: AppVM) => void\r\n  ) => {\r\n    const pm = AppPM.get(id, appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n  unsubscribe: (\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: AppVM) => void\r\n  ) => {\r\n    const pm = AppPM.get(id, appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}
+{"version":3,"file":"appPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAS,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C;;;OAGG;IACH,SAAS,EAAE,YAAY;IAEvB;;;;;;OAMG;IACH,SAAS,EAAE,CACT,EAAU,EACV,UAAyB,EACzB,KAA0B,EAC1B,EAAE;QACF,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,WAAW,EAAE,CACX,EAAU,EACV,UAAyB,EACzB,KAA0B,EAC1B,EAAE;QACF,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, PmAdapter } from \"@vived/core\";\r\nimport { AppPM, AppVM, defaultAppVM } from \"../PMs/AppPM\";\r\n\r\n/**\r\n * Adapter for the AppPM presentation manager.\r\n *\r\n * This adapter provides a simple interface for framework components to connect with\r\n * the AppPM presentation manager, which provides details about a specific app.\r\n *\r\n * Usage in components:\r\n * ```\r\n * // React component example\r\n * const [vm, setVm] = useState(appPMAdapter.defaultVM);\r\n *\r\n * useEffect(() => {\r\n *   appPMAdapter.subscribe(appId, appObjects, setVm);\r\n *   return () => appPMAdapter.unsubscribe(appId, appObjects, setVm);\r\n * }, [appId, appObjects]);\r\n * ```\r\n *\r\n * @type {PmAdapter<AppVM>} Non-singleton adapter that requires an app ID\r\n */\r\nexport const appPMAdapter: PmAdapter<AppVM> = {\r\n  /**\r\n   * Default view model to use before the actual data is loaded\r\n   * or when the presentation manager isn't available\r\n   */\r\n  defaultVM: defaultAppVM,\r\n\r\n  /**\r\n   * Subscribes a view callback to the app presentation manager\r\n   *\r\n   * @param id - ID of the specific app to subscribe to\r\n   * @param appObjects - The app object repository\r\n   * @param setVM - Callback function that will receive view model updates\r\n   */\r\n  subscribe: (\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: AppVM) => void\r\n  ) => {\r\n    const pm = AppPM.get(id, appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n\r\n  /**\r\n   * Unsubscribes a view callback from the app presentation manager\r\n   *\r\n   * @param id - ID of the specific app to unsubscribe from\r\n   * @param appObjects - The app object repository\r\n   * @param setVM - The callback function to remove\r\n   */\r\n  unsubscribe: (\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: AppVM) => void\r\n  ) => {\r\n    const pm = AppPM.get(id, appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}

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":"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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\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"]}