@vived/host 4.2.0 → 4.3.0

package/dist/cjs/Snackbar/Factories/setupSnackbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"setupSnackbar.js","sourceRoot":"","sources":["../../../../src/Snackbar/Factories/setupSnackbar.ts"],"names":[],"mappings":";;AAIA,sCAQC;AAXD,0CAA+C;AAC/C,gCAAwC;AAExC,SAAgB,aAAa,CAAC,UAAyB;IACrD,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE9C,WAAW;IACX,IAAA,2BAAgB,EAAC,EAAE,CAAC,CAAC;IAErB,MAAM;IACN,IAAA,oBAAc,EAAC,EAAE,CAAC,CAAC;AACrB,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { makeSnackbarRepo } from \"../Entities\";\r\nimport { makeSnackbarPM } from \"../PMs\";\r\n\r\nexport function setupSnackbar(appObjects: AppObjectRepo) {\r\n  const ao = appObjects.getOrCreate(\"Snackbar\");\r\n\r\n  // Entities\r\n  makeSnackbarRepo(ao);\r\n\r\n  // PMs\r\n  makeSnackbarPM(ao);\r\n}\r\n"]}
+{"version":3,"file":"setupSnackbar.js","sourceRoot":"","sources":["../../../../src/Snackbar/Factories/setupSnackbar.ts"],"names":[],"mappings":";;AAUA,sCAQC;AAjBD,0CAA+C;AAC/C,gCAAwC;AAExC;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,UAAyB;IACrD,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE9C,WAAW;IACX,IAAA,2BAAgB,EAAC,EAAE,CAAC,CAAC;IAErB,MAAM;IACN,IAAA,oBAAc,EAAC,EAAE,CAAC,CAAC;AACrB,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { makeSnackbarRepo } from \"../Entities\";\r\nimport { makeSnackbarPM } from \"../PMs\";\r\n\r\n/**\r\n * Sets up the Snackbar feature by creating its entity and presentation manager\r\n * This is the main entry point for initializing the Snackbar system\r\n * \r\n * @param appObjects The application object repository\r\n */\r\nexport function setupSnackbar(appObjects: AppObjectRepo): void {\r\n  const ao = appObjects.getOrCreate(\"Snackbar\");\r\n\r\n  // Entities\r\n  makeSnackbarRepo(ao);\r\n\r\n  // PMs\r\n  makeSnackbarPM(ao);\r\n}\r\n"]}

package/dist/cjs/Snackbar/PMs/SnackbarPM.js

@@ -4,20 +4,47 @@ exports.defaultSnackbarVM = exports.SnackbarPM = void 0;
 exports.makeSnackbarPM = makeSnackbarPM;
 const core_1 = require("@vived/core");
 const SnackbarRepo_1 = require("../Entities/SnackbarRepo");
+/**
+ * Presentation Manager for snackbar notifications
+ * Transforms data from SnackbarRepo into view models for UI components
+ */
 class SnackbarPM extends core_1.AppObjectPM {
+    /**
+     * Gets the singleton instance of SnackbarPM
+     * @param appObjects The application object repository
+     * @returns The SnackbarPM instance or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(SnackbarPM.type, appObjects);
     }
 }
 exports.SnackbarPM = SnackbarPM;
 SnackbarPM.type = "SnackbarPM";
+/**
+ * Creates a new SnackbarPM instance
+ * @param appObject The application object
+ * @returns A new SnackbarPM instance
+ */
 function makeSnackbarPM(appObject) {
     return new SnackbarPMImp(appObject);
 }
+/**
+ * Implementation of SnackbarPM
+ * Manages the view model transformation and updates
+ */
 class SnackbarPMImp extends SnackbarPM {
+    /**
+     * Gets the cached singleton instance of SnackbarRepo
+     */
     get snackbarRepo() {
         return this.getCachedSingleton(SnackbarRepo_1.SnackbarRepo.type);
     }
+    /**
+     * Compares two view models for equality
+     * @param a First view model
+     * @param b Second view model
+     * @returns True if the view models are equal, false otherwise
+     */
     vmsAreEqual(a, b) {
         if (a.message !== b.message)
             return false;
@@ -27,31 +54,42 @@ class SnackbarPMImp extends SnackbarPM {
             return false;
         return true;
     }
+    /**
+     * Updates the view model based on the current snackbar state
+     * Called whenever the snackbar repository changes
+     */
+    updateView() {
+        let model = {
+            message: undefined,
+            durationInSeconds: 0,
+            actionButtonText: undefined
+        };
+        const snackbar = this.snackbarRepo?.getCurrentSnackbar();
+        if (snackbar) {
+            model = {
+                message: snackbar.message,
+                durationInSeconds: snackbar.durationInSeconds,
+                actionButtonText: snackbar.snackbarAction
+                    ? snackbar.snackbarAction.actionButtonText
+                    : undefined
+            };
+        }
+        this.doUpdateView(model);
+    }
+    /**
+     * Creates a new SnackbarPMImp instance
+     * @param appObject The application object
+     */
     constructor(appObject) {
         super(appObject, SnackbarPM.type);
-        this.updateView = () => {
-            let model = {
-                message: undefined,
-                durationInSeconds: 0,
-                actionButtonText: undefined
-            };
-            const snackbar = this.snackbarRepo?.getCurrentSnackbar();
-            if (snackbar) {
-                model = {
-                    message: snackbar.message,
-                    durationInSeconds: snackbar.durationInSeconds,
-                    actionButtonText: snackbar.snackbarAction
-                        ? snackbar.snackbarAction.actionButtonText
-                        : undefined
-                };
-            }
-            this.doUpdateView(model);
-        };
         this.updateView(); // Initialize the lastVM
-        this.snackbarRepo?.addChangeObserver(this.updateView);
+        this.snackbarRepo?.addChangeObserver(this.updateView.bind(this));
         this.appObjects.registerSingleton(this);
     }
 }
+/**
+ * Default empty view model used when no snackbar is active
+ */
 exports.defaultSnackbarVM = {
     message: undefined,
     durationInSeconds: 0,

package/dist/cjs/Snackbar/PMs/SnackbarPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"SnackbarPM.js","sourceRoot":"","sources":["../../../../src/Snackbar/PMs/SnackbarPM.ts"],"names":[],"mappings":";;;AAsBA,wCAEC;AAxBD,sCAKqB;AACrB,2DAAwD;AAQxD,MAAsB,UAAW,SAAQ,kBAAuB;IAG9D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AALH,gCAMC;AALQ,eAAI,GAAG,YAAY,CAAC;AAO7B,SAAgB,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,UAAU;IACpC,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAe,2BAAY,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,WAAW,CAAC,CAAa,EAAE,CAAa;QACtC,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,CAAC,CAAC,iBAAiB,KAAK,CAAC,CAAC,iBAAiB;YAAE,OAAO,KAAK,CAAC;QAC9D,IAAI,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC,gBAAgB;YAAE,OAAO,KAAK,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAwBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAvB5B,eAAU,GAAG,GAAS,EAAE;YAC9B,IAAI,KAAK,GAAe;gBACtB,OAAO,EAAE,SAAS;gBAClB,iBAAiB,EAAE,CAAC;gBACpB,gBAAgB,EAAE,SAAS;aAC5B,CAAC;YAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,kBAAkB,EAAE,CAAC;YAEzD,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,GAAG;oBACN,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;oBAC7C,gBAAgB,EAAE,QAAQ,CAAC,cAAc;wBACvC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,gBAAgB;wBAC1C,CAAC,CAAC,SAAS;iBACd,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC;QAKA,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,wBAAwB;QAC3C,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF;AAEY,QAAA,iBAAiB,GAAe;IAC3C,OAAO,EAAE,SAAS;IAClB,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,SAAS;CAC5B,CAAC","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo,\r\n  getSingletonComponent\r\n} from \"@vived/core\";\r\nimport { SnackbarRepo } from \"../Entities/SnackbarRepo\";\r\n\r\nexport interface SnackbarVM {\r\n  message: string | undefined;\r\n  durationInSeconds: number;\r\n  actionButtonText: string | undefined;\r\n}\r\n\r\nexport abstract class SnackbarPM extends AppObjectPM<SnackbarVM> {\r\n  static type = \"SnackbarPM\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<SnackbarPM>(SnackbarPM.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeSnackbarPM(appObject: AppObject): SnackbarPM {\r\n  return new SnackbarPMImp(appObject);\r\n}\r\n\r\nclass SnackbarPMImp extends SnackbarPM {\r\n  private get snackbarRepo() {\r\n    return this.getCachedSingleton<SnackbarRepo>(SnackbarRepo.type);\r\n  }\r\n\r\n  vmsAreEqual(a: SnackbarVM, b: SnackbarVM): boolean {\r\n    if (a.message !== b.message) return false;\r\n    if (a.durationInSeconds !== b.durationInSeconds) return false;\r\n    if (a.actionButtonText !== b.actionButtonText) return false;\r\n    return true;\r\n  }\r\n\r\n  private updateView = (): void => {\r\n    let model: SnackbarVM = {\r\n      message: undefined,\r\n      durationInSeconds: 0,\r\n      actionButtonText: undefined\r\n    };\r\n\r\n    const snackbar = this.snackbarRepo?.getCurrentSnackbar();\r\n\r\n    if (snackbar) {\r\n      model = {\r\n        message: snackbar.message,\r\n        durationInSeconds: snackbar.durationInSeconds,\r\n        actionButtonText: snackbar.snackbarAction\r\n          ? snackbar.snackbarAction.actionButtonText\r\n          : undefined\r\n      };\r\n    }\r\n\r\n    this.doUpdateView(model);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, SnackbarPM.type);\r\n\r\n    this.updateView(); // Initialize the lastVM\r\n    this.snackbarRepo?.addChangeObserver(this.updateView);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n\r\nexport const defaultSnackbarVM: SnackbarVM = {\r\n  message: undefined,\r\n  durationInSeconds: 0,\r\n  actionButtonText: undefined\r\n};\r\n"]}
+{"version":3,"file":"SnackbarPM.js","sourceRoot":"","sources":["../../../../src/Snackbar/PMs/SnackbarPM.ts"],"names":[],"mappings":";;;AA2CA,wCAEC;AA7CD,sCAKqB;AACrB,2DAAwD;AAexD;;;GAGG;AACH,MAAsB,UAAW,SAAQ,kBAAuB;IAG9D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAVH,gCAWC;AAVQ,eAAI,GAAG,YAAY,CAAC;AAY7B;;;;GAIG;AACH,SAAgB,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,aAAc,SAAQ,UAAU;IACpC;;OAEG;IACH,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAe,2BAAY,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,CAAa,EAAE,CAAa;QACtC,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,CAAC,CAAC,iBAAiB,KAAK,CAAC,CAAC,iBAAiB;YAAE,OAAO,KAAK,CAAC;QAC9D,IAAI,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC,gBAAgB;YAAE,OAAO,KAAK,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACK,UAAU;QAChB,IAAI,KAAK,GAAe;YACtB,OAAO,EAAE,SAAS;YAClB,iBAAiB,EAAE,CAAC;YACpB,gBAAgB,EAAE,SAAS;SAC5B,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,kBAAkB,EAAE,CAAC;QAEzD,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,GAAG;gBACN,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;gBAC7C,gBAAgB,EAAE,QAAQ,CAAC,cAAc;oBACvC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,gBAAgB;oBAC1C,CAAC,CAAC,SAAS;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAElC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,wBAAwB;QAC3C,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;GAEG;AACU,QAAA,iBAAiB,GAAe;IAC3C,OAAO,EAAE,SAAS;IAClB,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,SAAS;CAC5B,CAAC","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo,\r\n  getSingletonComponent\r\n} from \"@vived/core\";\r\nimport { SnackbarRepo } from \"../Entities/SnackbarRepo\";\r\n\r\n/**\r\n * View model for snackbar UI components\r\n * Contains only the properties needed for display\r\n */\r\nexport interface SnackbarVM {\r\n  /** Message to display in the snackbar (undefined when no active snackbar) */\r\n  message: string | undefined;\r\n  /** Duration in seconds before the snackbar auto-dismisses */\r\n  durationInSeconds: number;\r\n  /** Text for the action button (undefined when no action) */\r\n  actionButtonText: string | undefined;\r\n}\r\n\r\n/**\r\n * Presentation Manager for snackbar notifications\r\n * Transforms data from SnackbarRepo into view models for UI components\r\n */\r\nexport abstract class SnackbarPM extends AppObjectPM<SnackbarVM> {\r\n  static type = \"SnackbarPM\";\r\n\r\n  /**\r\n   * Gets the singleton instance of SnackbarPM\r\n   * @param appObjects The application object repository\r\n   * @returns The SnackbarPM instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<SnackbarPM>(SnackbarPM.type, appObjects);\r\n  }\r\n}\r\n\r\n/**\r\n * Creates a new SnackbarPM instance\r\n * @param appObject The application object\r\n * @returns A new SnackbarPM instance\r\n */\r\nexport function makeSnackbarPM(appObject: AppObject): SnackbarPM {\r\n  return new SnackbarPMImp(appObject);\r\n}\r\n\r\n/**\r\n * Implementation of SnackbarPM\r\n * Manages the view model transformation and updates\r\n */\r\nclass SnackbarPMImp extends SnackbarPM {\r\n  /**\r\n   * Gets the cached singleton instance of SnackbarRepo\r\n   */\r\n  private get snackbarRepo() {\r\n    return this.getCachedSingleton<SnackbarRepo>(SnackbarRepo.type);\r\n  }\r\n\r\n  /**\r\n   * Compares two view models for equality\r\n   * @param a First view model\r\n   * @param b Second view model\r\n   * @returns True if the view models are equal, false otherwise\r\n   */\r\n  vmsAreEqual(a: SnackbarVM, b: SnackbarVM): boolean {\r\n    if (a.message !== b.message) return false;\r\n    if (a.durationInSeconds !== b.durationInSeconds) return false;\r\n    if (a.actionButtonText !== b.actionButtonText) return false;\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Updates the view model based on the current snackbar state\r\n   * Called whenever the snackbar repository changes\r\n   */\r\n  private updateView(): void {\r\n    let model: SnackbarVM = {\r\n      message: undefined,\r\n      durationInSeconds: 0,\r\n      actionButtonText: undefined\r\n    };\r\n\r\n    const snackbar = this.snackbarRepo?.getCurrentSnackbar();\r\n\r\n    if (snackbar) {\r\n      model = {\r\n        message: snackbar.message,\r\n        durationInSeconds: snackbar.durationInSeconds,\r\n        actionButtonText: snackbar.snackbarAction\r\n          ? snackbar.snackbarAction.actionButtonText\r\n          : undefined\r\n      };\r\n    }\r\n\r\n    this.doUpdateView(model);\r\n  }\r\n\r\n  /**\r\n   * Creates a new SnackbarPMImp instance\r\n   * @param appObject The application object\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, SnackbarPM.type);\r\n\r\n    this.updateView(); // Initialize the lastVM\r\n    this.snackbarRepo?.addChangeObserver(this.updateView.bind(this));\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n\r\n/**\r\n * Default empty view model used when no snackbar is active\r\n */\r\nexport const defaultSnackbarVM: SnackbarVM = {\r\n  message: undefined,\r\n  durationInSeconds: 0,\r\n  actionButtonText: undefined\r\n};\r\n"]}

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

@@ -1,6 +1,36 @@
 import { ActiveAppPM, defaultActiveAppVM } from "../PMs/ActiveAppPM";
+/**
+ * Adapter for the ActiveAppPM singleton presentation manager.
+ *
+ * This adapter provides a simple interface for framework components to connect with
+ * the ActiveAppPM presentation manager, which provides information about the currently
+ * active/selected app in the system.
+ *
+ * Usage in components:
+ * ```
+ * // React component example
+ * const [activeAppVm, setActiveAppVm] = useState(activeAppPMAdapter.defaultVM);
+ *
+ * useEffect(() => {
+ *   activeAppPMAdapter.subscribe(appObjects, setActiveAppVm);
+ *   return () => activeAppPMAdapter.unsubscribe(appObjects, setActiveAppVm);
+ * }, [appObjects]);
+ * ```
+ *
+ * @type {SingletonPmAdapter<ActiveAppVM>} Singleton adapter that provides the active app information
+ */
 export const activeAppPMAdapter = {
+    /**
+     * Default view model to use before the actual data is loaded
+     * or when the presentation manager isn't available
+     */
     defaultVM: defaultActiveAppVM,
+    /**
+     * Subscribes a view callback to the active app presentation manager
+     *
+     * @param appObjects - The app object repository
+     * @param setVM - Callback function that will receive view model updates
+     */
     subscribe: (appObjects, setVM) => {
         const pm = ActiveAppPM.get(appObjects);
         if (!pm) {
@@ -9,6 +39,12 @@ export const activeAppPMAdapter = {
         }
         pm.addView(setVM);
     },
+    /**
+     * Unsubscribes a view callback from the active app presentation manager
+     *
+     * @param appObjects - The app object repository
+     * @param setVM - The callback function to remove
+     */
     unsubscribe: (appObjects, setVM) => {
         const pm = ActiveAppPM.get(appObjects);
         if (!pm) {

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

@@ -1 +1 @@
-{"version":3,"file":"activeAppPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/activeAppPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EAEX,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,kBAAkB,GAAoC;IACjE,SAAS,EAAE,kBAAkB;IAC7B,SAAS,EAAE,CAAC,UAAyB,EAAE,KAAgC,EAAE,EAAE;QACzE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,oBAAoB,EACpB,4BAA4B,CAC7B,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,WAAW,EAAE,CACX,UAAyB,EACzB,KAAgC,EAChC,EAAE;QACF,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,oBAAoB,EACpB,4BAA4B,CAC7B,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, SingletonPmAdapter } from \"@vived/core\";\r\nimport {\r\n  ActiveAppPM,\r\n  ActiveAppVM,\r\n  defaultActiveAppVM\r\n} from \"../PMs/ActiveAppPM\";\r\n\r\nexport const activeAppPMAdapter: SingletonPmAdapter<ActiveAppVM> = {\r\n  defaultVM: defaultActiveAppVM,\r\n  subscribe: (appObjects: AppObjectRepo, setVM: (vm: ActiveAppVM) => void) => {\r\n    const pm = ActiveAppPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"activeAppPMAdapter\",\r\n        \"Unable to find ActiveAppPM\"\r\n      );\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n  unsubscribe: (\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: ActiveAppVM) => void\r\n  ) => {\r\n    const pm = ActiveAppPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"activeAppPMAdapter\",\r\n        \"Unable to find ActiveAppPM\"\r\n      );\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}
+{"version":3,"file":"activeAppPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/activeAppPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EAEX,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAoC;IACjE;;;OAGG;IACH,SAAS,EAAE,kBAAkB;IAE7B;;;;;OAKG;IACH,SAAS,EAAE,CAAC,UAAyB,EAAE,KAAgC,EAAE,EAAE;QACzE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,oBAAoB,EACpB,4BAA4B,CAC7B,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,WAAW,EAAE,CACX,UAAyB,EACzB,KAAgC,EAChC,EAAE;QACF,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,oBAAoB,EACpB,4BAA4B,CAC7B,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, SingletonPmAdapter } from \"@vived/core\";\r\nimport {\r\n  ActiveAppPM,\r\n  ActiveAppVM,\r\n  defaultActiveAppVM\r\n} from \"../PMs/ActiveAppPM\";\r\n\r\n/**\r\n * Adapter for the ActiveAppPM singleton presentation manager.\r\n *\r\n * This adapter provides a simple interface for framework components to connect with\r\n * the ActiveAppPM presentation manager, which provides information about the currently\r\n * active/selected app in the system.\r\n *\r\n * Usage in components:\r\n * ```\r\n * // React component example\r\n * const [activeAppVm, setActiveAppVm] = useState(activeAppPMAdapter.defaultVM);\r\n *\r\n * useEffect(() => {\r\n *   activeAppPMAdapter.subscribe(appObjects, setActiveAppVm);\r\n *   return () => activeAppPMAdapter.unsubscribe(appObjects, setActiveAppVm);\r\n * }, [appObjects]);\r\n * ```\r\n *\r\n * @type {SingletonPmAdapter<ActiveAppVM>} Singleton adapter that provides the active app information\r\n */\r\nexport const activeAppPMAdapter: SingletonPmAdapter<ActiveAppVM> = {\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: defaultActiveAppVM,\r\n\r\n  /**\r\n   * Subscribes a view callback to the active app presentation manager\r\n   *\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: (appObjects: AppObjectRepo, setVM: (vm: ActiveAppVM) => void) => {\r\n    const pm = ActiveAppPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"activeAppPMAdapter\",\r\n        \"Unable to find ActiveAppPM\"\r\n      );\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n\r\n  /**\r\n   * Unsubscribes a view callback from the active app 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: (\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: ActiveAppVM) => void\r\n  ) => {\r\n    const pm = ActiveAppPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"activeAppPMAdapter\",\r\n        \"Unable to find ActiveAppPM\"\r\n      );\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}

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

@@ -1,6 +1,35 @@
 import { AppsListPM } from "../PMs/AppsListPM";
+/**
+ * Adapter for the AppsListPM singleton presentation manager.
+ *
+ * This adapter provides a simple interface for framework components to connect with
+ * the AppsListPM presentation manager, which provides a list of available app IDs.
+ *
+ * Usage in components:
+ * ```
+ * // React component example
+ * const [appIds, setAppIds] = useState(appListPMAdapter.defaultVM);
+ *
+ * useEffect(() => {
+ *   appListPMAdapter.subscribe(appObjects, setAppIds);
+ *   return () => appListPMAdapter.unsubscribe(appObjects, setAppIds);
+ * }, [appObjects]);
+ * ```
+ *
+ * @type {SingletonPmAdapter<string[]>} Singleton adapter that provides a list of app IDs
+ */
 export const appListPMAdapter = {
+    /**
+     * Default view model to use before the actual data is loaded
+     * or when the presentation manager isn't available
+     */
     defaultVM: [],
+    /**
+     * Subscribes a view callback to the apps list presentation manager
+     *
+     * @param appObjects - The app object repository
+     * @param setVM - Callback function that will receive view model updates (array of app IDs)
+     */
     subscribe: (appObjects, setVM) => {
         const pm = AppsListPM.get(appObjects);
         if (!pm) {
@@ -9,6 +38,12 @@ export const appListPMAdapter = {
         }
         pm.addView(setVM);
     },
+    /**
+     * Unsubscribes a view callback from the apps list presentation manager
+     *
+     * @param appObjects - The app object repository
+     * @param setVM - The callback function to remove
+     */
     unsubscribe: (appObjects, setVM) => {
         const pm = AppsListPM.get(appObjects);
         if (!pm) {

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;