@vived/host 4.2.0 → 4.4.0

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";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Apps/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Apps/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC"}

package/dist/types/ChallengeResults/Adapters/challengeScoreListAdapter.d.ts

@@ -0,0 +1,4 @@
+import { SingletonPmAdapter } from "@vived/core";
+import { SlideScoreVM } from "../PMs/ChallengeScoreListPM";
+export declare const challengeScoreListAdapter: SingletonPmAdapter<SlideScoreVM[]>;
+//# sourceMappingURL=challengeScoreListAdapter.d.ts.map

package/dist/types/ChallengeResults/Adapters/challengeScoreListAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"challengeScoreListAdapter.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/challengeScoreListAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAEL,YAAY,EACb,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,yBAAyB,EAAE,kBAAkB,CAAC,YAAY,EAAE,CAsBxE,CAAC"}

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

@@ -1,3 +1,4 @@
 export * from "./challengeResultsListAdapter";
 export * from "./hasChallengeResultsPMAdapter";
+export * from "./challengeScoreListAdapter";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC"}

package/dist/types/ChallengeResults/Entities/ChallengeResults.d.ts

@@ -35,6 +35,7 @@ export declare abstract class ChallengeResultsEntity extends AppObjectEntity {
     abstract submitScoreResult: (slideID: string, score: number, maxScore: number, tries: number, message: string) => void;
     abstract submitProgressResult: (slideID: string, maxProgress: number, message: string) => void;
     abstract getResultForSlide: (slideID: string) => ChallengeResult | undefined;
+    abstract getScoreForSlide: (slideID: string) => number;
     static get(appObjects: AppObjectRepo): ChallengeResultsEntity | undefined;
 }
 export declare function makeChallengeResults(appObject: AppObject): ChallengeResultsEntity;

package/dist/types/ChallengeResults/Entities/ChallengeResults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChallengeResults.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Entities/ChallengeResults.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,UAAU,GACV,SAAS,GACT,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,UAAU,EACN,sBAAsB,GACtB,2BAA2B,GAC3B,0BAA0B,GAC1B,wBAAwB,GACxB,2BAA2B,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8BAAsB,sBAAuB,SAAQ,eAAe;IAClE,MAAM,CAAC,IAAI,SAA4B;IAEvC,QAAQ,KAAK,OAAO,IAAI,eAAe,EAAE,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,mBAAmB,EAAE,CAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,iBAAiB,EAAE,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IAE7E,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,GACnB,sBAAsB,CAExB"}
+{"version":3,"file":"ChallengeResults.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Entities/ChallengeResults.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,UAAU,GACV,SAAS,GACT,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,UAAU,EACN,sBAAsB,GACtB,2BAA2B,GAC3B,0BAA0B,GAC1B,wBAAwB,GACxB,2BAA2B,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8BAAsB,sBAAuB,SAAQ,eAAe;IAClE,MAAM,CAAC,IAAI,SAA4B;IAEvC,QAAQ,KAAK,OAAO,IAAI,eAAe,EAAE,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,mBAAmB,EAAE,CAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,iBAAiB,EAAE,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IAE7E,QAAQ,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAEvD,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,GACnB,sBAAsB,CAExB"}

package/dist/types/ChallengeResults/Mocks/MockChallengeScoreListPM.d.ts

@@ -0,0 +1,8 @@
+import { AppObject, AppObjectRepo } from "@vived/core";
+import { ChallengeScoreListPM } from "../PMs/ChallengeScoreListPM";
+export declare class MockChallengeScoreListPM extends ChallengeScoreListPM {
+    vmsAreEqual: jest.Mock<any, any, any>;
+    constructor(appObject: AppObject);
+}
+export declare function makeMockChallengeScoreListPM(appObjects: AppObjectRepo): MockChallengeScoreListPM;
+//# sourceMappingURL=MockChallengeScoreListPM.d.ts.map

package/dist/types/ChallengeResults/Mocks/MockChallengeScoreListPM.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockChallengeScoreListPM.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Mocks/MockChallengeScoreListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,oBAAoB,EAErB,MAAM,6BAA6B,CAAC;AAErC,qBAAa,wBAAyB,SAAQ,oBAAoB;IAChE,WAAW,2BAIP;gBAEQ,SAAS,EAAE,SAAS;CAIjC;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,aAAa,GACxB,wBAAwB,CAI1B"}

package/dist/types/ChallengeResults/Mocks/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./ChallengeResultsListPMMock";
 export * from "./MockHasChallengeResultsPM";
+export * from "./MockChallengeScoreListPM";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/ChallengeResults/Mocks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Mocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/Mocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC"}

package/dist/types/ChallengeResults/PMs/ChallengeScoreListPM.d.ts

@@ -0,0 +1,12 @@
+import { AppObject, AppObjectPM, AppObjectRepo } from "@vived/core";
+export interface SlideScoreVM {
+    id: string;
+    displayName: string;
+    score: number;
+}
+export declare abstract class ChallengeScoreListPM extends AppObjectPM<SlideScoreVM[]> {
+    static readonly type = "ChallengeScoreListPM";
+    static get(appObjects: AppObjectRepo): ChallengeScoreListPM | undefined;
+}
+export declare function makeChallengeScoreListPM(appObject: AppObject): ChallengeScoreListPM;
+//# sourceMappingURL=ChallengeScoreListPM.d.ts.map

package/dist/types/ChallengeResults/PMs/ChallengeScoreListPM.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChallengeScoreListPM.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/PMs/ChallengeScoreListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,aAAa,EAEd,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8BAAsB,oBAAqB,SAAQ,WAAW,CAAC,YAAY,EAAE,CAAC;IAC5E,MAAM,CAAC,QAAQ,CAAC,IAAI,0BAA0B;IAE9C,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,GACnB,oBAAoB,CAEtB"}

package/dist/types/ChallengeResults/PMs/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./ChallengeResultsListPM";
 export * from "./HasChallengeResultsPM";
+export * from "./ChallengeScoreListPM";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/ChallengeResults/PMs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/PMs/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ChallengeResults/PMs/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}

package/dist/types/Handler/UCs/SubmitResultHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubmitResultHandler.d.ts","sourceRoot":"","sources":["../../../../src/Handler/UCs/SubmitResultHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,EAEL,cAAc,EAGf,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,UAAU,GACV,aAAa,CAAC;AAClB,MAAM,MAAM,OAAO,GACf,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,gBAAgB,CAAC;AAErB,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,KAChB,IAAI,CAAC;AAEV,8BAAsB,mBACpB,SAAQ,WACR,YAAW,cAAc;IACzB,MAAM,CAAC,QAAQ,CAAC,IAAI,yBAAyB;IAE7C,QAAQ,CAAC,WAAW,oBAAoB;IAExC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACtE;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,mBAAmB,CAErB"}
+{"version":3,"file":"SubmitResultHandler.d.ts","sourceRoot":"","sources":["../../../../src/Handler/UCs/SubmitResultHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAOrD,OAAO,EAEL,cAAc,EAGf,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,UAAU,GACV,aAAa,CAAC;AAClB,MAAM,MAAM,OAAO,GACf,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,gBAAgB,CAAC;AAErB,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,KAChB,IAAI,CAAC;AAEV,8BAAsB,mBACpB,SAAQ,WACR,YAAW,cAAc;IAEzB,MAAM,CAAC,QAAQ,CAAC,IAAI,yBAAyB;IAE7C,QAAQ,CAAC,WAAW,oBAAoB;IAExC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACtE;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,mBAAmB,CAErB"}

package/dist/types/Snackbar/Adapters/snackbarAdapter.d.ts

@@ -1,4 +1,8 @@
 import { SingletonPmAdapter } from "@vived/core";
 import { SnackbarVM } from "../PMs/SnackbarPM";
+/**
+ * Adapter for connecting UI components to the Snackbar system
+ * Follows the SingletonPmAdapter pattern for reactive state management
+ */
 export declare const snackbarAdapter: SingletonPmAdapter<SnackbarVM>;
 //# sourceMappingURL=snackbarAdapter.d.ts.map

package/dist/types/Snackbar/Adapters/snackbarAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snackbarAdapter.d.ts","sourceRoot":"","sources":["../../../../src/Snackbar/Adapters/snackbarAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAc,UAAU,EAAqB,MAAM,mBAAmB,CAAC;AAE9E,eAAO,MAAM,eAAe,EAAE,kBAAkB,CAAC,UAAU,CAkB1D,CAAC"}
+{"version":3,"file":"snackbarAdapter.d.ts","sourceRoot":"","sources":["../../../../src/Snackbar/Adapters/snackbarAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAc,UAAU,EAAqB,MAAM,mBAAmB,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,kBAAkB,CAAC,UAAU,CAiC1D,CAAC"}

package/dist/types/Snackbar/Controllers/callActiveSnackbarAction.d.ts

@@ -1,3 +1,9 @@
 import { AppObjectRepo } from "@vived/core";
+/**
+ * Executes the action of the currently active snackbar, if it has one
+ * Also dismisses the snackbar after executing the action
+ *
+ * @param appObjects The application object repository
+ */
 export declare function callActiveSnackbarAction(appObjects: AppObjectRepo): void;
 //# sourceMappingURL=callActiveSnackbarAction.d.ts.map

package/dist/types/Snackbar/Controllers/callActiveSnackbarAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"callActiveSnackbarAction.d.ts","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/callActiveSnackbarAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,aAAa,QAUjE"}
+{"version":3,"file":"callActiveSnackbarAction.d.ts","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/callActiveSnackbarAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CAUxE"}

package/dist/types/Snackbar/Controllers/dismissActiveSnackbar.d.ts

@@ -1,3 +1,8 @@
 import { AppObjectRepo } from "@vived/core";
+/**
+ * Dismisses the currently active snackbar, if any exists
+ *
+ * @param appObjects The application object repository
+ */
 export declare function dismissActiveSnackbar(appObjects: AppObjectRepo): void;
 //# sourceMappingURL=dismissActiveSnackbar.d.ts.map

package/dist/types/Snackbar/Controllers/dismissActiveSnackbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dismissActiveSnackbar.d.ts","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/dismissActiveSnackbar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,aAAa,QAU9D"}
+{"version":3,"file":"dismissActiveSnackbar.d.ts","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/dismissActiveSnackbar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CAUrE"}

package/dist/types/Snackbar/Controllers/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./callActiveSnackbarAction";
 export * from "./dismissActiveSnackbar";
+export * from "./makeSnackbar";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/Snackbar/Controllers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC"}

package/dist/types/Snackbar/Controllers/makeSnackbar.d.ts

@@ -0,0 +1,12 @@
+import { AppObjectRepo } from "@vived/core";
+import { SnackbarAction } from "../Entities/SnackbarRepo";
+/**
+ * Creates and displays a new snackbar notification
+ *
+ * @param appObjects The application object repository
+ * @param message The message to display in the snackbar
+ * @param snackbarAction Optional action button configuration with text and callback
+ * @param durationInSeconds Optional duration in seconds before auto-dismissing (defaults to 4 seconds)
+ */
+export declare function makeSnackbar(appObjects: AppObjectRepo, message: string, snackbarAction?: SnackbarAction, durationInSeconds?: number): void;
+//# sourceMappingURL=makeSnackbar.d.ts.map

package/dist/types/Snackbar/Controllers/makeSnackbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeSnackbar.d.ts","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/makeSnackbar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAgB,MAAM,0BAA0B,CAAC;AAExE;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,cAAc,EAC/B,iBAAiB,CAAC,EAAE,MAAM,GACzB,IAAI,CAON"}

package/dist/types/Snackbar/Entities/SnackbarRepo.d.ts

@@ -1,21 +1,66 @@
 import { AppObject, AppObjectEntity, AppObjectRepo } from "@vived/core";
+/**
+ * Represents a snackbar notification with a message, duration, and optional action
+ */
 export interface Snackbar {
+    /** The text message to display in the snackbar */
     message: string;
+    /** How long the snackbar should be displayed before auto-dismissing (in seconds) */
     durationInSeconds: number;
+    /** Optional action button and callback for the snackbar */
     snackbarAction?: SnackbarAction;
 }
+/**
+ * Represents an action button for a snackbar
+ */
 export interface SnackbarAction {
+    /** The text to display on the action button */
     actionButtonText: string;
+    /** Callback function to execute when the action button is clicked */
     action: () => void;
 }
+/**
+ * Observer type for snackbar state changes
+ */
 export type SnackbarObserver = (snackbar: Snackbar | undefined) => void;
+/**
+ * Repository for managing snackbar notifications
+ * Handles creating, displaying, and dismissing snackbars
+ */
 export declare abstract class SnackbarRepo extends AppObjectEntity {
     static type: string;
+    /**
+     * Gets the singleton instance of SnackbarRepo
+     * @param appObjects The application object repository
+     * @returns The SnackbarRepo instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): SnackbarRepo | undefined;
+    /**
+     * Creates and displays a new snackbar notification
+     * @param message The message to display
+     * @param snackbarAction Optional action button and callback
+     * @param durationInSeconds Optional duration in seconds before auto-dismissing
+     */
     abstract makeSnackbar(message: string, snackbarAction?: SnackbarAction, durationInSeconds?: number): void;
+    /**
+     * Gets the currently active snackbar, if any
+     * @returns The current snackbar or undefined if none is active
+     */
     abstract getCurrentSnackbar(): Snackbar | undefined;
+    /**
+     * Dismisses the currently active snackbar, if any
+     */
     abstract dismissActiveSnackbar(): void;
+    /**
+     * Executes the action of the currently active snackbar, if it has one
+     * Also dismisses the snackbar after executing the action
+     */
     abstract callActiveSnackbarAction(): void;
 }
+/**
+ * Creates a new SnackbarRepo instance
+ * @param appObject The application object
+ * @returns A new SnackbarRepo instance
+ */
 export declare function makeSnackbarRepo(appObject: AppObject): SnackbarRepo;
 //# sourceMappingURL=SnackbarRepo.d.ts.map

package/dist/types/Snackbar/Entities/SnackbarRepo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SnackbarRepo.d.ts","sourceRoot":"","sources":["../../../../src/Snackbar/Entities/SnackbarRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EACf,aAAa,EAEd,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,KAAK,IAAI,CAAC;AAExE,8BAAsB,YAAa,SAAQ,eAAe;IACxD,MAAM,CAAC,IAAI,SAAkB;IAE7B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;IAIpC,QAAQ,CAAC,YAAY,CACnB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,cAAc,EAC/B,iBAAiB,CAAC,EAAE,MAAM,GACzB,IAAI;IACP,QAAQ,CAAC,kBAAkB,IAAI,QAAQ,GAAG,SAAS;IACnD,QAAQ,CAAC,qBAAqB,IAAI,IAAI;IACtC,QAAQ,CAAC,wBAAwB,IAAI,IAAI;CAC1C;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY,CAEnE"}
+{"version":3,"file":"SnackbarRepo.d.ts","sourceRoot":"","sources":["../../../../src/Snackbar/Entities/SnackbarRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EACf,aAAa,EAEd,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,KAAK,IAAI,CAAC;AAExE;;;GAGG;AACH,8BAAsB,YAAa,SAAQ,eAAe;IACxD,MAAM,CAAC,IAAI,SAAkB;IAE7B;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;IAIpC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CACnB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,cAAc,EAC/B,iBAAiB,CAAC,EAAE,MAAM,GACzB,IAAI;IAEP;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,IAAI,QAAQ,GAAG,SAAS;IAEnD;;OAEG;IACH,QAAQ,CAAC,qBAAqB,IAAI,IAAI;IAEtC;;;OAGG;IACH,QAAQ,CAAC,wBAAwB,IAAI,IAAI;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY,CAEnE"}