@vived/host 4.1.0 → 4.3.0

package/README.md

@@ -0,0 +1,105 @@
+# @vived/host
+
+A comprehensive TypeScript package providing core components for hosting VIVED Learning applications.
+
+## Overview
+
+The `@vived/host` package delivers common AppObject components for VIVED Host applications. It functions as the foundation for applications that host VIVED Apps through our plugin architecture, providing infrastructure for app lifecycle management, asset handling, UI components, state management, and more.
+
+## Installation
+
+```bash
+npm install @vived/host
+```
+
+This package has a peer dependency on `@vived/core` which must also be installed:
+
+```bash
+npm install @vived/core
+```
+
+## Key Features
+
+- **App Lifecycle Management**: Load, start, stop, and update VIVED applications
+- **Asset Management**: Create, edit, archive, and manage digital assets
+- **Sandbox Environment**: Development environment with inspection tools
+- **Dialog System**: UI components for alerts, confirmations, and user input
+- **State Machine**: Manage application state transitions and persistence
+- **Event Handling**: Dispatch and handle events between host and apps
+- **Theme Support**: Light/dark theme management with consistent color schemes
+- **ZSpace Integration**: Support for zSpace 3D hardware environments
+- **Logging**: Error reporting and log management tools
+
+## Architecture
+
+This package follows the AppObject Architecture pattern with components organized by feature:
+
+- **Entities**: Core business objects and data models
+- **Use Cases (UCs)**: Business logic for operations and workflows
+- **Presentation Managers (PMs)**: Bridge domain logic with UI components
+- **Controllers**: Handle user inputs and direct operations
+- **Adapters**: Interface between components and external systems
+
+## Modules
+
+The package includes the following key modules:
+
+- **Apps**: App mounting, versioning, and lifecycle management
+- **AppSandbox**: Dev tools, inspector integration, and isolated execution
+- **Assets**: Asset creation, editing, archiving, and management
+- **Dialog**: Alert, confirmation, spinner, and editor components
+- **StateMachine**: State transitions, editing, and navigation capabilities
+- **Dispatcher**: Event dispatching between host and apps
+- **VivedAPI**: Backend service communication and authentication
+- **ZSpaceHost**: 3D hardware integration support
+
+## Usage Example
+
+```typescript
+import { 
+  setupAppSandbox, 
+  setupAssetsForSandbox,
+  setupStateMachineForSandbox 
+} from '@vived/host';
+import { AppObjectRepo } from '@vived/core';
+
+// Create app objects repository
+const appObjects = new AppObjectRepo();
+
+// Set up sandbox environment
+setupAppSandbox(appObjects);
+setupAssetsForSandbox(appObjects);
+setupStateMachineForSandbox(appObjects);
+
+// Configure and use components...
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests (watch mode)
+npm test
+
+# Run tests (single run)
+npm run testOnce
+
+# Build package (ESM and CJS)
+npm run build
+
+# Lint code
+npm run lint
+
+# Format code
+npm run format
+```
+
+## License
+
+ISC
+
+## Further Documentation
+
+For more information about the AppObject Architecture and component patterns, please see the internal documentation.

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

@@ -2,8 +2,38 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.activeAppPMAdapter = void 0;
 const ActiveAppPM_1 = require("../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
+ */
 exports.activeAppPMAdapter = {
+    /**
+     * Default view model to use before the actual data is loaded
+     * or when the presentation manager isn't available
+     */
     defaultVM: ActiveAppPM_1.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_1.ActiveAppPM.get(appObjects);
         if (!pm) {
@@ -12,6 +42,12 @@ exports.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_1.ActiveAppPM.get(appObjects);
         if (!pm) {

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

@@ -1 +1 @@
-{"version":3,"file":"activeAppPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/activeAppPMAdapter.ts"],"names":[],"mappings":";;;AACA,oDAI4B;AAEf,QAAA,kBAAkB,GAAoC;IACjE,SAAS,EAAE,gCAAkB;IAC7B,SAAS,EAAE,CAAC,UAAyB,EAAE,KAAgC,EAAE,EAAE;QACzE,MAAM,EAAE,GAAG,yBAAW,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,yBAAW,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,oDAI4B;AAE5B;;;;;;;;;;;;;;;;;;;GAmBG;AACU,QAAA,kBAAkB,GAAoC;IACjE;;;OAGG;IACH,SAAS,EAAE,gCAAkB;IAE7B;;;;;OAKG;IACH,SAAS,EAAE,CAAC,UAAyB,EAAE,KAAgC,EAAE,EAAE;QACzE,MAAM,EAAE,GAAG,yBAAW,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,yBAAW,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/cjs/Apps/Adapters/appListPMAdapter.js

@@ -2,8 +2,37 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.appListPMAdapter = void 0;
 const AppsListPM_1 = require("../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
+ */
 exports.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_1.AppsListPM.get(appObjects);
         if (!pm) {
@@ -12,6 +41,12 @@ exports.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_1.AppsListPM.get(appObjects);
         if (!pm) {

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

@@ -1 +1 @@
-{"version":3,"file":"appListPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appListPMAdapter.ts"],"names":[],"mappings":";;;AACA,kDAA+C;AAElC,QAAA,gBAAgB,GAAiC;IAC5D,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,CAAC,UAAyB,EAAE,KAA6B,EAAE,EAAE;QACtE,MAAM,EAAE,GAAG,uBAAU,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,uBAAU,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,kDAA+C;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,gBAAgB,GAAiC;IAC5D;;;OAGG;IACH,SAAS,EAAE,EAAE;IAEb;;;;;OAKG;IACH,SAAS,EAAE,CAAC,UAAyB,EAAE,KAA6B,EAAE,EAAE;QACtE,MAAM,EAAE,GAAG,uBAAU,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,uBAAU,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/cjs/Apps/Adapters/appPMAdapter.js

@@ -2,8 +2,38 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.appPMAdapter = void 0;
 const AppPM_1 = require("../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
+ */
 exports.appPMAdapter = {
+    /**
+     * Default view model to use before the actual data is loaded
+     * or when the presentation manager isn't available
+     */
     defaultVM: AppPM_1.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_1.AppPM.get(id, appObjects);
         if (!pm) {
@@ -12,6 +42,13 @@ exports.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_1.AppPM.get(id, appObjects);
         if (!pm) {

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

@@ -1 +1 @@
-{"version":3,"file":"appPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appPMAdapter.ts"],"names":[],"mappings":";;;AACA,wCAA0D;AAE7C,QAAA,YAAY,GAAqB;IAC5C,SAAS,EAAE,oBAAY;IACvB,SAAS,EAAE,CACT,EAAU,EACV,UAAyB,EACzB,KAA0B,EAC1B,EAAE;QACF,MAAM,EAAE,GAAG,aAAK,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,aAAK,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,wCAA0D;AAE1D;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,YAAY,GAAqB;IAC5C;;;OAGG;IACH,SAAS,EAAE,oBAAY;IAEvB;;;;;;OAMG;IACH,SAAS,EAAE,CACT,EAAU,EACV,UAAyB,EACzB,KAA0B,EAC1B,EAAE;QACF,MAAM,EAAE,GAAG,aAAK,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,aAAK,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/cjs/Apps/Adapters/index.js

@@ -1,4 +1,18 @@
 "use strict";
+/**
+ * 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
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);

package/dist/cjs/Apps/Adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,qDAAmC;AACnC,iDAA+B","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,uDAAqC;AACrC,qDAAmC;AACnC,iDAA+B","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/cjs/Apps/Controllers/updateApp.js

@@ -2,6 +2,25 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateApp = updateApp;
 const UpdateAppUC_1 = require("../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
+ */
 function updateApp(id, appObjects) {
     const uc = UpdateAppUC_1.UpdateAppUC.getByID(id, appObjects);
     if (!uc) {

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

@@ -1 +1 @@
-{"version":3,"file":"updateApp.js","sourceRoot":"","sources":["../../../../src/Apps/Controllers/updateApp.ts"],"names":[],"mappings":";;AAGA,8BAQC;AAVD,oDAAiD;AAEjD,SAAgB,SAAS,CAAC,EAAU,EAAE,UAAyB;IAC7D,MAAM,EAAE,GAAG,yBAAW,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":";;AAsBA,8BAQC;AA7BD,oDAAiD;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,SAAS,CAAC,EAAU,EAAE,UAAyB;IAC7D,MAAM,EAAE,GAAG,yBAAW,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/cjs/Apps/Entities/AppEntity.js

@@ -3,6 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppEntity = exports.AppState = void 0;
 exports.makeAppEntity = makeAppEntity;
 const core_1 = require("@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
+ */
 var AppState;
 (function (AppState) {
     AppState["INIT"] = "INIT";
@@ -10,6 +19,14 @@ var AppState;
     AppState["READY"] = "READY";
     AppState["ERROR"] = "ERROR";
 })(AppState || (exports.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
+ */
 class AppEntity extends core_1.AppObjectEntity {
     static get(id, appObjects) {
         const ao = appObjects.get(id);
@@ -21,7 +38,14 @@ class AppEntity extends core_1.AppObjectEntity {
     }
 }
 exports.AppEntity = AppEntity;
+/** 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
+ */
 function makeAppEntity(appObject) {
     return new AppEntityImp(appObject);
 }

package/dist/cjs/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/cjs/Apps/Entities/AppRepo.js

@@ -12,7 +12,7 @@ var AppReleaseStage;
 })(AppReleaseStage || (exports.AppReleaseStage = AppReleaseStage = {}));
 class AppRepoEntity extends core_1.AppObjectEntityRepo {
     static get(appObjects) {
-        return (0, core_1.getSingletonComponent)(AppRepoEntity.type, appObjects);
+        return appObjects.getSingleton(AppRepoEntity.type);
     }
 }
 exports.AppRepoEntity = AppRepoEntity;

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

@@ -1 +1 @@
-{"version":3,"file":"AppRepo.js","sourceRoot":"","sources":["../../../../src/Apps/Entities/AppRepo.ts"],"names":[],"mappings":";;;AA+BA,kCAEC;AAjCD,sCAIqB;AACrB,2CAAuD;AAEvD,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,gCAAa,CAAA;IACb,kCAAe,CAAA;AACjB,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B;AAED,MAAsB,aAAc,SAAQ,0BAA8B;IAGxE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9E,CAAC;;AALH,sCAgBC;AAfQ,kBAAI,GAAG,eAAe,CAAC;AAiBhC,SAAgB,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,IAAA,yBAAa,EAAC,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":";;;AAgCA,kCAEC;AAlCD,sCAKqB;AACrB,2CAAuD;AAEvD,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,gCAAa,CAAA;IACb,kCAAe,CAAA;AACjB,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B;AAED,MAAsB,aAAc,SAAQ,0BAA8B;IAGxE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,UAAU,CAAC,YAAY,CAAgB,aAAa,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;;AALH,sCAgBC;AAfQ,kBAAI,GAAG,eAAe,CAAC;AAiBhC,SAAgB,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,IAAA,yBAAa,EAAC,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/cjs/Apps/PMs/ActiveAppPM.js

@@ -2,15 +2,34 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActiveAppPM = exports.defaultActiveAppVM = void 0;
 const core_1 = require("@vived/core");
+/**
+ * Default values for the ActiveAppVM
+ */
 exports.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>
+ */
 class ActiveAppPM extends core_1.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);
     }
 }
 exports.ActiveAppPM = ActiveAppPM;
+/** Type identifier for the ActiveAppPM component */
 ActiveAppPM.type = "ActiveAppPM";
 //# sourceMappingURL=ActiveAppPM.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ActiveAppPM.js","sourceRoot":"","sources":["../../../../src/Apps/PMs/ActiveAppPM.ts"],"names":[],"mappings":";;;AAAA,sCAAyD;AAO5C,QAAA,kBAAkB,GAAgB;IAC7C,EAAE,EAAE,EAAE;IACN,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAsB,WAAY,SAAQ,kBAAwB;IAGhE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,UAAU,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;;AALH,kCAMC;AALQ,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,sCAAyD;AAazD;;GAEG;AACU,QAAA,kBAAkB,GAAgB;IAC7C,EAAE,EAAE,EAAE;IACN,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAsB,WAAY,SAAQ,kBAAwB;IAIhE;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,UAAU,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;;AAZH,kCAaC;AAZC,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/cjs/Apps/PMs/AppPM.js

@@ -4,13 +4,36 @@ exports.AppPM = exports.defaultAppVM = void 0;
 exports.makeAppPM = makeAppPM;
 const core_1 = require("@vived/core");
 const AppEntity_1 = require("../Entities/AppEntity");
+/**
+ * Default empty AppVM for initialization
+ */
 exports.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`
+ */
 class AppPM extends core_1.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) {
@@ -21,13 +44,34 @@ class AppPM extends core_1.AppObjectPM {
 }
 exports.AppPM = AppPM;
 AppPM.type = "AppPM";
+/**
+ * Creates a new AppPM instance
+ *
+ * @param appObject - The app object to associate with this PM
+ * @returns A new AppPM instance
+ */
 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_1.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;
@@ -37,8 +81,17 @@ class AppPMImp extends AppPM {
             return false;
         return true;
     }
+    /**
+     * Creates a new AppPM instance
+     *
+     * @param appObject - The app object to associate with this PM
+     */
     constructor(appObject) {
         super(appObject, AppPM.type);
+        /**
+         * Observer callback that updates the view model when the entity changes
+         * Transforms entity data into view model format
+         */
         this.onEntityChange = () => {
             if (!this.app)
                 return;

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

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