@vived/host 4.1.0 → 4.3.0

package/dist/esm/ThemeColors/Factories/setupTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupTheme.js","sourceRoot":"","sources":["../../../../src/ThemeColors/Factories/setupTheme.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,UAAU,UAAU,CAAC,UAAyB;IAClD,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAE3C,WAAW;IACX,MAAM,KAAK,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAEtC,MAAM;IACN,MAAM,UAAU,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAEtC,MAAM;IACN,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAEtB,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IACjD,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAE/C,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB;AAC1D,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { vivedDarkThemeData, vivedLightThemeData } from \"../Data\";\r\nimport { makeHostThemeEntity } from \"../Entities\";\r\nimport { makeThemeColorsPM } from \"../PM\";\r\nimport { makeSetThemeUC } from \"../UCs\";\r\n\r\nexport function setupTheme(appObjects: AppObjectRepo) {\r\n  const ao = appObjects.getOrCreate(\"Theme\");\r\n\r\n  // Entities\r\n  const theme = makeHostThemeEntity(ao);\r\n\r\n  // UCs\r\n  const setThemeUC = makeSetThemeUC(ao);\r\n\r\n  // PMs\r\n  makeThemeColorsPM(ao);\r\n\r\n  theme.submitScheme(\"light\", vivedLightThemeData);\r\n  theme.submitScheme(\"dark\", vivedDarkThemeData);\r\n\r\n  setThemeUC.setThemeByName(\"light\"); // Hardcoded for now\r\n}\r\n"]}

package/dist/esm/ThemeColors/UCs/SetThemeUC.js

@@ -19,7 +19,7 @@ class SetThemeUCImp extends SetThemeUC {
         this.theme.activeSchemeName = name;
     }
     tryDetectTheme() {
-        if (!this.theme)
+        if (!this.theme || !window.matchMedia)
             return;
         const darkThemeMq = window.matchMedia("(prefers-color-scheme: dark)");
         if (darkThemeMq.matches) {

package/dist/esm/ThemeColors/UCs/SetThemeUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"SetThemeUC.js","sourceRoot":"","sources":["../../../../src/ThemeColors/UCs/SetThemeUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,OAAgB,UAAW,SAAQ,WAAW;IASlD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAVM,eAAI,GAAG,YAAY,CAAC;AAa7B,MAAM,UAAU,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,UAAU;IAIpC,IAAY,KAAK;QACf,OAAO,IAAI,CAAC,kBAAkB,CAAkB,eAAe,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExB,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;IACrC,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExB,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;QACtE,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC;QACnD,CAAC;IACH,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAzBpC,mBAAc,GAAG,OAAO,CAAC;QACzB,kBAAa,GAAG,MAAM,CAAC;QAyBrB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { HostThemeEntity } from \"../Entities\";\r\n\r\nexport abstract class SetThemeUC extends AppObjectUC {\r\n  static type = \"SetThemeUC\";\r\n\r\n  abstract lightThemeName: string;\r\n  abstract darkThemeName: string;\r\n\r\n  abstract setThemeByName(name: string): void;\r\n  abstract tryDetectTheme(): void;\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<SetThemeUC>(SetThemeUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeSetThemeUC(appObject: AppObject): SetThemeUC {\r\n  return new SetThemeUCImp(appObject);\r\n}\r\n\r\nclass SetThemeUCImp extends SetThemeUC {\r\n  lightThemeName = \"light\";\r\n  darkThemeName = \"dark\";\r\n\r\n  private get theme() {\r\n    return this.getCachedSingleton<HostThemeEntity>(HostThemeEntity.type);\r\n  }\r\n\r\n  setThemeByName(name: string): void {\r\n    if (!this.theme) return;\r\n\r\n    this.theme.activeSchemeName = name;\r\n  }\r\n\r\n  tryDetectTheme(): void {\r\n    if (!this.theme) return;\r\n\r\n    const darkThemeMq = window.matchMedia(\"(prefers-color-scheme: dark)\");\r\n    if (darkThemeMq.matches) {\r\n      this.theme.activeSchemeName = this.darkThemeName;\r\n    } else {\r\n      this.theme.activeSchemeName = this.darkThemeName;\r\n    }\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, SetThemeUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SetThemeUC.js","sourceRoot":"","sources":["../../../../src/ThemeColors/UCs/SetThemeUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,OAAgB,UAAW,SAAQ,WAAW;IASlD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAVM,eAAI,GAAG,YAAY,CAAC;AAa7B,MAAM,UAAU,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,UAAU;IAIpC,IAAY,KAAK;QACf,OAAO,IAAI,CAAC,kBAAkB,CAAkB,eAAe,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExB,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;IACrC,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO;QAE9C,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;QACtE,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC;QACnD,CAAC;IACH,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAzBpC,mBAAc,GAAG,OAAO,CAAC;QACzB,kBAAa,GAAG,MAAM,CAAC;QAyBrB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { HostThemeEntity } from \"../Entities\";\r\n\r\nexport abstract class SetThemeUC extends AppObjectUC {\r\n  static type = \"SetThemeUC\";\r\n\r\n  abstract lightThemeName: string;\r\n  abstract darkThemeName: string;\r\n\r\n  abstract setThemeByName(name: string): void;\r\n  abstract tryDetectTheme(): void;\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<SetThemeUC>(SetThemeUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeSetThemeUC(appObject: AppObject): SetThemeUC {\r\n  return new SetThemeUCImp(appObject);\r\n}\r\n\r\nclass SetThemeUCImp extends SetThemeUC {\r\n  lightThemeName = \"light\";\r\n  darkThemeName = \"dark\";\r\n\r\n  private get theme() {\r\n    return this.getCachedSingleton<HostThemeEntity>(HostThemeEntity.type);\r\n  }\r\n\r\n  setThemeByName(name: string): void {\r\n    if (!this.theme) return;\r\n\r\n    this.theme.activeSchemeName = name;\r\n  }\r\n\r\n  tryDetectTheme(): void {\r\n    if (!this.theme || !window.matchMedia) return;\r\n\r\n    const darkThemeMq = window.matchMedia(\"(prefers-color-scheme: dark)\");\r\n    if (darkThemeMq.matches) {\r\n      this.theme.activeSchemeName = this.darkThemeName;\r\n    } else {\r\n      this.theme.activeSchemeName = this.darkThemeName;\r\n    }\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, SetThemeUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\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"}

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

@@ -1,10 +1,46 @@
 import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * Use Case for stopping an application.
+ *
+ * This class provides functionality to stop a running app through the dispatcher
+ * system. It acts as a bridge between controllers and the dispatch mechanism.
+ *
+ * @extends AppObjectUC from @vived/core
+ */
 export declare abstract class StopAppUC extends AppObjectUC {
     static type: string;
+    /**
+     * Stops the application associated with this Use Case.
+     */
     abstract stop(): void;
+    /**
+     * Retrieves the StopAppUC component from a specific App Object.
+     *
+     * @param appObject - The App Object to get the component from
+     * @returns The StopAppUC component or undefined if not found
+     */
     static get(appObject: AppObject): StopAppUC | undefined;
+    /**
+     * Retrieves the StopAppUC component by App Object ID.
+     *
+     * @param id - The ID of the App Object
+     * @param appObjects - The App Object repository
+     * @returns The StopAppUC component or undefined if not found
+     */
     static getByID(id: string, appObjects: AppObjectRepo): StopAppUC | undefined;
+    /**
+     * Convenience method to stop an app by its ID.
+     *
+     * @param id - The ID of the app to stop
+     * @param appObjects - The App Object repository
+     */
     static stopByID(id: string, appObjects: AppObjectRepo): void;
 }
+/**
+ * Factory function to create a new StopAppUC instance.
+ *
+ * @param appObject - The App Object to attach the component to
+ * @returns A new StopAppUC instance
+ */
 export declare function makeStopAppUC(appObject: AppObject): StopAppUC;
 //# sourceMappingURL=StopAppUC.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StopAppUC.d.ts","sourceRoot":"","sources":["../../../../src/Apps/UCs/StopAppUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGpE,8BAAsB,SAAU,SAAQ,WAAW;IACjD,MAAM,CAAC,IAAI,SAAe;IAE1B,QAAQ,CAAC,IAAI,IAAI,IAAI;IAErB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS;IAWvD,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS;IAc5E,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa;CAGtD;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAE7D"}
+{"version":3,"file":"StopAppUC.d.ts","sourceRoot":"","sources":["../../../../src/Apps/UCs/StopAppUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGpE;;;;;;;GAOG;AACH,8BAAsB,SAAU,SAAQ,WAAW;IACjD,MAAM,CAAC,IAAI,SAAe;IAE1B;;OAEG;IACH,QAAQ,CAAC,IAAI,IAAI,IAAI;IAErB;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS;IAWvD;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS;IAc5E;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa;CAGtD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAE7D"}

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

@@ -1,4 +1,22 @@
 import { Version } from "@vived/core";
 import { AppEntity } from "../Entities";
+/**
+ * Creates a versioned ID for an app by combining the app ID with its version.
+ *
+ * This utility function forms a unique identifier that includes both the app ID
+ * and version information. This is used to identify specific versions of apps,
+ * particularly when loading scripts into the DOM or accessing app interfaces from
+ * the window object.
+ *
+ * The version is formatted by replacing periods with underscores to create a
+ * valid JavaScript identifier (e.g., "1.2.3" becomes "1_2_3").
+ *
+ * @param app - The app entity
+ * @param version - The version to include in the ID
+ * @returns A string in the format "{appId}-{version_with_underscores}"
+ * @example
+ * // Returns "myApp-1_2_3" for app.id="myApp" and version="1.2.3"
+ * formAppIDWithVersion(app, version)
+ */
 export declare function formAppIDWithVersion(app: AppEntity, version: Version): string;
 //# sourceMappingURL=formAppIDWithVersion.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"formAppIDWithVersion.d.ts","sourceRoot":"","sources":["../../../../src/Apps/UCs/formAppIDWithVersion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,UAGpE"}
+{"version":3,"file":"formAppIDWithVersion.d.ts","sourceRoot":"","sources":["../../../../src/Apps/UCs/formAppIDWithVersion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,UAGpE"}

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

@@ -1,3 +1,22 @@
+/**
+ * Apps Module - Core module for managing application lifecycle in the VIVED Learning platform
+ *
+ * This module handles app loading, mounting, starting, stopping, and state management.
+ * It follows a clean architecture pattern with the following layers:
+ *
+ * - Entities: Core domain models (AppEntity, AppRepo)
+ * - PMs (Presentation Models): Business logic and state management
+ * - UCs (Use Cases): Implementation of specific operations
+ * - Adapters: Connect PMs to UI components
+ * - Controllers: Entry points for UI interactions
+ *
+ * To use this module, typically you would:
+ * 1. Load an app using the AppEntity
+ * 2. Mount the app using MounterUC
+ * 3. Start the app using StartAppUC
+ * 4. Manage app state via the AppPM or ActiveAppPM
+ * 5. Stop the app using StopAppUC when done
+ */
 export * from "./Adapters";
 export * from "./Controllers";
 export * from "./Entities";