@vived/host 4.2.0 → 4.3.0

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

@@ -1,18 +1,45 @@
 import { AppObjectPM, getSingletonComponent } from "@vived/core";
 import { SnackbarRepo } from "../Entities/SnackbarRepo";
+/**
+ * Presentation Manager for snackbar notifications
+ * Transforms data from SnackbarRepo into view models for UI components
+ */
 export class SnackbarPM extends 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 getSingletonComponent(SnackbarPM.type, appObjects);
     }
 }
 SnackbarPM.type = "SnackbarPM";
+/**
+ * Creates a new SnackbarPM instance
+ * @param appObject The application object
+ * @returns A new SnackbarPM instance
+ */
 export 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.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;
@@ -22,31 +49,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
+ */
 export const defaultSnackbarVM = {
     message: undefined,
     durationInSeconds: 0,

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

@@ -1 +1 @@
-{"version":3,"file":"SnackbarPM.js","sourceRoot":"","sources":["../../../../src/Snackbar/PMs/SnackbarPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EAEX,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAQxD,MAAM,OAAgB,UAAW,SAAQ,WAAuB;IAG9D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAJM,eAAI,GAAG,YAAY,CAAC;AAO7B,MAAM,UAAU,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,YAAY,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;AAED,MAAM,CAAC,MAAM,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":"AAAA,OAAO,EAEL,WAAW,EAEX,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAexD;;;GAGG;AACH,MAAM,OAAgB,UAAW,SAAQ,WAAuB;IAG9D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AATM,eAAI,GAAG,YAAY,CAAC;AAY7B;;;;GAIG;AACH,MAAM,UAAU,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,YAAY,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;AACH,MAAM,CAAC,MAAM,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/types/Apps/Adapters/activeAppPMAdapter.d.ts

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,14 +1,51 @@
 import { AppObject, AppObjectPM, AppObjectRepo } from "@vived/core";
+/**
+ * View Model for App information
+ * Represents the data needed by the view to display an app
+ */
 export interface AppVM {
+    /** Unique identifier for the app */
     id: string;
+    /** Display name of the app */
     name: string;
+    /** Description text for the app */
     description: string;
+    /** URL to the app's thumbnail or preview image */
     imageURL: string;
 }
+/**
+ * Default empty AppVM for initialization
+ */
 export declare const defaultAppVM: AppVM;
+/**
+ * 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 declare abstract class AppPM extends AppObjectPM<AppVM> {
     static type: string;
+    /**
+     * 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: string, appObjects: AppObjectRepo): AppPM | undefined;
 }
+/**
+ * Creates a new AppPM instance
+ *
+ * @param appObject - The app object to associate with this PM
+ * @returns A new AppPM instance
+ */
 export declare function makeAppPM(appObject: AppObject): AppPM;
 //# sourceMappingURL=AppPM.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AppPM.d.ts","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGpE,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,YAAY,EAAE,KAK1B,CAAC;AAEF,8BAAsB,KAAM,SAAQ,WAAW,CAAC,KAAK,CAAC;IACpD,MAAM,CAAC,IAAI,SAAW;IAEtB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa;CAQjD;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,KAAK,CAErD"}
+{"version":3,"file":"AppPM.d.ts","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGpE;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,KAK1B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,8BAAsB,KAAM,SAAQ,WAAW,CAAC,KAAK,CAAC;IACpD,MAAM,CAAC,IAAI,SAAW;IAEtB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa;CAQjD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,KAAK,CAErD"}

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

@@ -1,7 +1,28 @@
 import { AppObject, AppObjectPM, AppObjectRepo } from "@vived/core";
+/**
+ * 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 declare abstract class AppsListPM extends AppObjectPM<string[]> {
     static type: string;
+    /**
+     * Gets the singleton instance of AppsListPM.
+     *
+     * @param appObjects - The app object repository
+     * @returns The AppsListPM instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): AppsListPM | undefined;
 }
-export declare function makeAppListPM(appObject: AppObject): AppsListPM;
+/**
+ * Factory function to create a new AppsListPM instance.
+ *
+ * @param appObject - The app object to attach the PM to
+ * @returns A new AppsListPM instance
+ */
+export declare function makeAppsListPM(appObject: AppObject): AppsListPM;
 //# sourceMappingURL=AppsListPM.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AppsListPM.d.ts","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppsListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGpE,8BAAsB,UAAW,SAAQ,WAAW,CAAC,MAAM,EAAE,CAAC;IAC5D,MAAM,CAAC,IAAI,SAAgB;IAE3B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAGrC;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAE9D"}
+{"version":3,"file":"AppsListPM.d.ts","sourceRoot":"","sources":["../../../../src/Apps/PMs/AppsListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGpE;;;;;;;;GAQG;AACH,8BAAsB,UAAW,SAAQ,WAAW,CAAC,MAAM,EAAE,CAAC;IAC5D,MAAM,CAAC,IAAI,SAAgB;IAE3B;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAGrC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAE/D"}

package/dist/types/Apps/UCs/Mounters/MounterUC.d.ts

@@ -1,13 +1,69 @@
 import { AppObject, AppObjectRepo, AppObjectUC, Version, VIVEDApp_3 } from "@vived/core";
+/**
+ * Abstract base class for app mounting use cases.
+ *
+ * The MounterUC is responsible for loading, initializing, and managing app
+ * lifecycle. It handles script loading, version management, and communication
+ * setup between the host and app.
+ *
+ * @extends AppObjectUC from @vived/core
+ */
 export declare abstract class MounterUC extends AppObjectUC {
     static type: string;
+    /**
+     * Mounts a specific version of the app.
+     *
+     * @param majorVersion - The major version number
+     * @param minorVersion - The minor version number
+     * @returns A promise that resolves when the app is mounted
+     */
     abstract mount(majorVersion: number, minorVersion: number): Promise<void>;
+    /**
+     * Mounts the latest available version of the app.
+     *
+     * @returns A promise that resolves when the app is mounted
+     */
     abstract mountLatestVersion(): Promise<void>;
+    /**
+     * Unmounts the app, removing it from the runtime environment.
+     */
     abstract unmount(): void;
+    /**
+     * Loads a script into the document.
+     *
+     * @param scriptURL - URL of the script to load
+     * @param appIDWithVersion - Versioned ID of the app
+     * @returns A promise that resolves when the script is loaded
+     */
     abstract loadScriptIntoDocument(scriptURL: string, appIDWithVersion: string): Promise<void>;
+    /**
+     * Gets the app interface for a specific version.
+     *
+     * @param version - The version to get the interface for
+     * @returns The app interface or undefined if not found
+     */
     abstract getAppInterface(version: Version): VIVEDApp_3 | undefined;
+    /**
+     * Retrieves the MounterUC component from an app object.
+     *
+     * @param appObject - The app object to get the component from
+     * @returns The MounterUC component or undefined if not found
+     */
     static get(appObject: AppObject): MounterUC | undefined;
+    /**
+     * Retrieves the MounterUC component by app object ID.
+     *
+     * @param id - The ID of the app object
+     * @param appObjects - The app object repository
+     * @returns The MounterUC component or undefined if not found
+     */
     static getById(id: string, appObjects: AppObjectRepo): MounterUC | undefined;
 }
+/**
+ * Factory function to create a new MounterUC instance.
+ *
+ * @param appObject - The app object to attach the mounter to
+ * @returns A new MounterUC instance
+ */
 export declare function makeMounterUC(appObject: AppObject): MounterUC;
 //# sourceMappingURL=MounterUC.d.ts.map

package/dist/types/Apps/UCs/Mounters/MounterUC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MounterUC.d.ts","sourceRoot":"","sources":["../../../../../src/Apps/UCs/Mounters/MounterUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,WAAW,EACX,OAAO,EACP,UAAU,EACX,MAAM,aAAa,CAAC;AAOrB,8BAAsB,SAAU,SAAQ,WAAW;IACjD,MAAM,CAAC,IAAI,SAAe;IAE1B,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACzE,QAAQ,CAAC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAC5C,QAAQ,CAAC,OAAO,IAAI,IAAI;IACxB,QAAQ,CAAC,sBAAsB,CAC7B,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC;IAChB,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS;IAElE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS;IAI/B,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa;CAIrD;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAE7D"}
+{"version":3,"file":"MounterUC.d.ts","sourceRoot":"","sources":["../../../../../src/Apps/UCs/Mounters/MounterUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,WAAW,EACX,OAAO,EACP,UAAU,EACX,MAAM,aAAa,CAAC;AAOrB;;;;;;;;GAQG;AACH,8BAAsB,SAAU,SAAQ,WAAW;IACjD,MAAM,CAAC,IAAI,SAAe;IAE1B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEzE;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,IAAI;IAExB;;;;;;OAMG;IACH,QAAQ,CAAC,sBAAsB,CAC7B,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS;IAElE;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS;IAI/B;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa;CAIrD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAE7D"}

package/dist/types/Apps/UCs/Mounters/SandboxMounterUC.d.ts

@@ -1,4 +1,13 @@
 import { AppObject } from "@vived/core";
 import { MounterUC } from "./MounterUC";
+/**
+ * Factory function to create a sandbox mounter for apps.
+ *
+ * The sandbox mounter is designed to mount apps in a sandboxed environment,
+ * providing isolation and security for app execution.
+ *
+ * @param appObject - The app object to attach the mounter to
+ * @returns A new SandboxMounterUC instance
+ */
 export declare function makeSandboxMounter(appObject: AppObject): MounterUC;
 //# sourceMappingURL=SandboxMounterUC.d.ts.map

package/dist/types/Apps/UCs/Mounters/SandboxMounterUC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxMounterUC.d.ts","sourceRoot":"","sources":["../../../../../src/Apps/UCs/Mounters/SandboxMounterUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAQ7D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAElE"}
+{"version":3,"file":"SandboxMounterUC.d.ts","sourceRoot":"","sources":["../../../../../src/Apps/UCs/Mounters/SandboxMounterUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAQ7D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAElE"}

package/dist/types/Apps/UCs/StartAppUC.d.ts

@@ -1,10 +1,56 @@
 import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * StartAppUC - Use case for starting an application in the host environment
+ *
+ * This use case is responsible for initializing and starting an application
+ * within the VIVED Learning platform. It handles setting up the application container,
+ * initializing the app with the appropriate state, and dispatching necessary configurations.
+ *
+ * The StartAppUC coordinates between several subsystems:
+ * - State Machine: Provides the current application state
+ * - Dispatcher: Communicates with the app via message passing
+ * - AppSandbox: Provides development features when enabled
+ *
+ * @extends AppObjectUC from @vived/core
+ */
 export declare abstract class StartAppUC extends AppObjectUC {
+    /** Type identifier for the StartAppUC component */
     static type: string;
+    /**
+     * Abstract method that starts the application
+     *
+     * @param container - HTML element that will contain the app
+     */
     abstract start(container: HTMLElement): void;
+    /**
+     * Gets a StartAppUC instance from an app object
+     *
+     * @param appObject - App object to get the StartAppUC from
+     * @returns StartAppUC instance if found, undefined otherwise
+     */
     static get(appObject: AppObject): StartAppUC | undefined;
+    /**
+     * Gets a StartAppUC instance by app ID
+     *
+     * @param id - ID of the app to start
+     * @param appObjects - Repository containing app objects
+     * @returns StartAppUC instance if found, undefined otherwise
+     */
     static getByID(id: string, appObjects: AppObjectRepo): StartAppUC | undefined;
+    /**
+     * Convenience method to start an app by ID
+     *
+     * @param container - HTML element to mount the app in
+     * @param id - ID of the app to start
+     * @param appObjects - Repository containing app objects
+     */
     static startByID(container: HTMLElement, id: string, appObjects: AppObjectRepo): void;
 }
+/**
+ * Factory function to create a new StartAppUC instance
+ *
+ * @param appObject - The app object to attach the use case to
+ * @returns A concrete implementation of StartAppUC
+ */
 export declare function makeStartAppUC(appObject: AppObject): StartAppUC;
 //# sourceMappingURL=StartAppUC.d.ts.map

package/dist/types/Apps/UCs/StartAppUC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StartAppUC.d.ts","sourceRoot":"","sources":["../../../../src/Apps/UCs/StartAppUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAepE,8BAAsB,UAAW,SAAQ,WAAW;IAClD,MAAM,CAAC,IAAI,SAAgB;IAE3B,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IAE5C,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS;IAWxD,MAAM,CAAC,OAAO,CACZ,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,GACxB,UAAU,GAAG,SAAS;IAczB,MAAM,CAAC,SAAS,CACd,SAAS,EAAE,WAAW,EACtB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa;CAI5B;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAE/D"}
+{"version":3,"file":"StartAppUC.d.ts","sourceRoot":"","sources":["../../../../src/Apps/UCs/StartAppUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAepE;;;;;;;;;;;;;GAaG;AACH,8BAAsB,UAAW,SAAQ,WAAW;IAClD,mDAAmD;IACnD,MAAM,CAAC,IAAI,SAAgB;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IAE5C;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS;IAWxD;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CACZ,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,GACxB,UAAU,GAAG,SAAS;IAczB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CACd,SAAS,EAAE,WAAW,EACtB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAE/D"}