@vived/host 4.2.0 → 4.4.0

package/dist/cjs/Apps/UCs/StartAppUC.js

@@ -6,7 +6,27 @@ const core_1 = require("@vived/core");
 const AppSandbox_1 = require("../../AppSandbox");
 const Dispatcher_1 = require("../../Dispatcher");
 const Entities_1 = require("../../StateMachine/Entities");
+/**
+ * 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
+ */
 class StartAppUC extends core_1.AppObjectUC {
+    /**
+     * 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) {
         const asset = appObject.getComponent(StartAppUC.type);
         if (!asset) {
@@ -14,6 +34,13 @@ class StartAppUC extends core_1.AppObjectUC {
         }
         return asset;
     }
+    /**
+     * 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, appObjects) {
         const appObject = appObjects.get(id);
         if (!appObject) {
@@ -22,15 +49,34 @@ class StartAppUC extends core_1.AppObjectUC {
         }
         return StartAppUC.get(appObject);
     }
+    /**
+     * 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, id, appObjects) {
         StartAppUC.getByID(id, appObjects)?.start(container);
     }
 }
 exports.StartAppUC = StartAppUC;
+/** Type identifier for the StartAppUC component */
 StartAppUC.type = "StartAppUC";
+/**
+ * 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
+ */
 function makeStartAppUC(appObject) {
     return new StartAppUCImp(appObject);
 }
+/**
+ * Concrete implementation of StartAppUC
+ * Uses dependency injection to access required components
+ * Handles the app starting process
+ */
 class StartAppUCImp extends StartAppUC {
     get stateMachine() {
         return this.getCachedSingleton(Entities_1.HostStateMachine.type);

package/dist/cjs/Apps/UCs/StartAppUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"StartAppUC.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/StartAppUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport { AppSandboxEntity } from \"../../AppSandbox\";\r\nimport {\r\n  DispatchEnableFeatureUC,\r\n  DispatchIsAuthoringUC,\r\n  DispatchSetStateUC,\r\n  DispatchStartAppUC,\r\n  DispatchStateDTO,\r\n  DispatchThemeUC\r\n} from \"../../Dispatcher\";\r\nimport {\r\n  HostEditingStateEntity,\r\n  HostStateMachine\r\n} from \"../../StateMachine/Entities\";\r\n\r\nexport abstract class StartAppUC extends AppObjectUC {\r\n  static type = \"StartAppUC\";\r\n\r\n  abstract start(container: HTMLElement): void;\r\n\r\n  static get(appObject: AppObject): StartAppUC | undefined {\r\n    const asset = appObject.getComponent<StartAppUC>(StartAppUC.type);\r\n    if (!asset) {\r\n      appObject.appObjectRepo.submitWarning(\r\n        \"StartAppUC.get\",\r\n        \"Unable to find StartAppUC on app object \" + appObject.id\r\n      );\r\n    }\r\n    return asset;\r\n  }\r\n\r\n  static getByID(\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ): StartAppUC | undefined {\r\n    const appObject = appObjects.get(id);\r\n\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"StartAppUC.getByID\",\r\n        \"Unable to find App Object by id \" + id\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return StartAppUC.get(appObject);\r\n  }\r\n\r\n  static startByID(\r\n    container: HTMLElement,\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ) {\r\n    StartAppUC.getByID(id, appObjects)?.start(container);\r\n  }\r\n}\r\n\r\nexport function makeStartAppUC(appObject: AppObject): StartAppUC {\r\n  return new StartAppUCImp(appObject);\r\n}\r\n\r\nclass StartAppUCImp extends StartAppUC {\r\n  private get stateMachine() {\r\n    return this.getCachedSingleton<HostStateMachine>(HostStateMachine.type);\r\n  }\r\n\r\n  private get editStateEntity() {\r\n    return this.getCachedSingleton<HostEditingStateEntity>(\r\n      HostEditingStateEntity.type\r\n    );\r\n  }\r\n\r\n  private get dispatchStart() {\r\n    return this.getCachedLocalComponent<DispatchStartAppUC>(\r\n      DispatchStartAppUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchSetState() {\r\n    return this.getCachedLocalComponent<DispatchSetStateUC>(\r\n      DispatchSetStateUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchSetIsAuthoring() {\r\n    return this.getCachedLocalComponent<DispatchIsAuthoringUC>(\r\n      DispatchIsAuthoringUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchThemeColors() {\r\n    return this.getCachedLocalComponent<DispatchThemeUC>(DispatchThemeUC.type);\r\n  }\r\n\r\n  private get dispatchEnableFeature() {\r\n    return this.getCachedLocalComponent<DispatchEnableFeatureUC>(\r\n      DispatchEnableFeatureUC.type\r\n    );\r\n  }\r\n\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  start = (container: HTMLElement) => {\r\n    if (!this.stateMachine) return;\r\n    if (!this.dispatchStart) return;\r\n    if (!this.editStateEntity) return;\r\n    if (!this.sandbox) return;\r\n\r\n    this.dispatchStart.doDispatch(container);\r\n\r\n    let state;\r\n    if (this.stateMachine.activeState) {\r\n      state = this.stateMachine.getStateByID(this.stateMachine.activeState)\r\n        ?.stateData;\r\n    }\r\n\r\n    const hideNavigation = this.stateMachine.states.length <= 1;\r\n    const hasNextSlide = this.stateMachine.nextState !== undefined;\r\n    const hasPreviousSlide = this.stateMachine.previousState !== undefined;\r\n    const dto: DispatchStateDTO = {\r\n      finalState: state,\r\n      hideNavigation,\r\n      hasNextSlide,\r\n      hasPreviousSlide\r\n    };\r\n    this.dispatchSetState?.doDispatch(dto);\r\n\r\n    let isAuthoring = this.editStateEntity.isEditing;\r\n    if (this.stateMachine.activeState === undefined) {\r\n      isAuthoring = true;\r\n    }\r\n    this.dispatchSetIsAuthoring?.doDispatch(isAuthoring);\r\n\r\n    this.dispatchThemeColors?.doDispatch();\r\n\r\n    if (this.sandbox.enableDevFeatures) {\r\n      this.sandbox.devFeatures.forEach((feature) => {\r\n        this.dispatchEnableFeature?.doDispatch(feature);\r\n      });\r\n    }\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, StartAppUC.type);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"StartAppUC.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/StartAppUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport { AppSandboxEntity } from \"../../AppSandbox\";\r\nimport {\r\n  DispatchEnableFeatureUC,\r\n  DispatchIsAuthoringUC,\r\n  DispatchSetStateUC,\r\n  DispatchStartAppUC,\r\n  DispatchStateDTO,\r\n  DispatchThemeUC\r\n} from \"../../Dispatcher\";\r\nimport {\r\n  HostEditingStateEntity,\r\n  HostStateMachine\r\n} from \"../../StateMachine/Entities\";\r\n\r\n/**\r\n * StartAppUC - Use case for starting an application in the host environment\r\n * \r\n * This use case is responsible for initializing and starting an application\r\n * within the VIVED Learning platform. It handles setting up the application container,\r\n * initializing the app with the appropriate state, and dispatching necessary configurations.\r\n * \r\n * The StartAppUC coordinates between several subsystems:\r\n * - State Machine: Provides the current application state\r\n * - Dispatcher: Communicates with the app via message passing\r\n * - AppSandbox: Provides development features when enabled\r\n * \r\n * @extends AppObjectUC from @vived/core\r\n */\r\nexport abstract class StartAppUC extends AppObjectUC {\r\n  /** Type identifier for the StartAppUC component */\r\n  static type = \"StartAppUC\";\r\n\r\n  /**\r\n   * Abstract method that starts the application\r\n   * \r\n   * @param container - HTML element that will contain the app\r\n   */\r\n  abstract start(container: HTMLElement): void;\r\n\r\n  /**\r\n   * Gets a StartAppUC instance from an app object\r\n   * \r\n   * @param appObject - App object to get the StartAppUC from\r\n   * @returns StartAppUC instance if found, undefined otherwise\r\n   */\r\n  static get(appObject: AppObject): StartAppUC | undefined {\r\n    const asset = appObject.getComponent<StartAppUC>(StartAppUC.type);\r\n    if (!asset) {\r\n      appObject.appObjectRepo.submitWarning(\r\n        \"StartAppUC.get\",\r\n        \"Unable to find StartAppUC on app object \" + appObject.id\r\n      );\r\n    }\r\n    return asset;\r\n  }\r\n\r\n  /**\r\n   * Gets a StartAppUC instance by app ID\r\n   * \r\n   * @param id - ID of the app to start\r\n   * @param appObjects - Repository containing app objects\r\n   * @returns StartAppUC instance if found, undefined otherwise\r\n   */\r\n  static getByID(\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ): StartAppUC | undefined {\r\n    const appObject = appObjects.get(id);\r\n\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"StartAppUC.getByID\",\r\n        \"Unable to find App Object by id \" + id\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return StartAppUC.get(appObject);\r\n  }\r\n\r\n  /**\r\n   * Convenience method to start an app by ID\r\n   * \r\n   * @param container - HTML element to mount the app in\r\n   * @param id - ID of the app to start\r\n   * @param appObjects - Repository containing app objects\r\n   */\r\n  static startByID(\r\n    container: HTMLElement,\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ) {\r\n    StartAppUC.getByID(id, appObjects)?.start(container);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new StartAppUC instance\r\n * \r\n * @param appObject - The app object to attach the use case to\r\n * @returns A concrete implementation of StartAppUC\r\n */\r\nexport function makeStartAppUC(appObject: AppObject): StartAppUC {\r\n  return new StartAppUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of StartAppUC\r\n * Uses dependency injection to access required components\r\n * Handles the app starting process\r\n */\r\nclass StartAppUCImp extends StartAppUC {\r\n  private get stateMachine() {\r\n    return this.getCachedSingleton<HostStateMachine>(HostStateMachine.type);\r\n  }\r\n\r\n  private get editStateEntity() {\r\n    return this.getCachedSingleton<HostEditingStateEntity>(\r\n      HostEditingStateEntity.type\r\n    );\r\n  }\r\n\r\n  private get dispatchStart() {\r\n    return this.getCachedLocalComponent<DispatchStartAppUC>(\r\n      DispatchStartAppUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchSetState() {\r\n    return this.getCachedLocalComponent<DispatchSetStateUC>(\r\n      DispatchSetStateUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchSetIsAuthoring() {\r\n    return this.getCachedLocalComponent<DispatchIsAuthoringUC>(\r\n      DispatchIsAuthoringUC.type\r\n    );\r\n  }\r\n\r\n  private get dispatchThemeColors() {\r\n    return this.getCachedLocalComponent<DispatchThemeUC>(DispatchThemeUC.type);\r\n  }\r\n\r\n  private get dispatchEnableFeature() {\r\n    return this.getCachedLocalComponent<DispatchEnableFeatureUC>(\r\n      DispatchEnableFeatureUC.type\r\n    );\r\n  }\r\n\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  start = (container: HTMLElement) => {\r\n    if (!this.stateMachine) return;\r\n    if (!this.dispatchStart) return;\r\n    if (!this.editStateEntity) return;\r\n    if (!this.sandbox) return;\r\n\r\n    this.dispatchStart.doDispatch(container);\r\n\r\n    let state;\r\n    if (this.stateMachine.activeState) {\r\n      state = this.stateMachine.getStateByID(this.stateMachine.activeState)\r\n        ?.stateData;\r\n    }\r\n\r\n    const hideNavigation = this.stateMachine.states.length <= 1;\r\n    const hasNextSlide = this.stateMachine.nextState !== undefined;\r\n    const hasPreviousSlide = this.stateMachine.previousState !== undefined;\r\n    const dto: DispatchStateDTO = {\r\n      finalState: state,\r\n      hideNavigation,\r\n      hasNextSlide,\r\n      hasPreviousSlide\r\n    };\r\n    this.dispatchSetState?.doDispatch(dto);\r\n\r\n    let isAuthoring = this.editStateEntity.isEditing;\r\n    if (this.stateMachine.activeState === undefined) {\r\n      isAuthoring = true;\r\n    }\r\n    this.dispatchSetIsAuthoring?.doDispatch(isAuthoring);\r\n\r\n    this.dispatchThemeColors?.doDispatch();\r\n\r\n    if (this.sandbox.enableDevFeatures) {\r\n      this.sandbox.devFeatures.forEach((feature) => {\r\n        this.dispatchEnableFeature?.doDispatch(feature);\r\n      });\r\n    }\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, StartAppUC.type);\r\n  }\r\n}\r\n"]}

package/dist/cjs/Apps/UCs/StopAppUC.js

@@ -4,7 +4,21 @@ exports.StopAppUC = void 0;
 exports.makeStopAppUC = makeStopAppUC;
 const core_1 = require("@vived/core");
 const Dispatcher_1 = require("../../Dispatcher");
+/**
+ * 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
+ */
 class StopAppUC extends core_1.AppObjectUC {
+    /**
+     * 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) {
         const asset = appObject.getComponent(StopAppUC.type);
         if (!asset) {
@@ -12,6 +26,13 @@ class StopAppUC extends core_1.AppObjectUC {
         }
         return asset;
     }
+    /**
+     * 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, appObjects) {
         const appObject = appObjects.get(id);
         if (!appObject) {
@@ -20,22 +41,48 @@ class StopAppUC extends core_1.AppObjectUC {
         }
         return StopAppUC.get(appObject);
     }
+    /**
+     * 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, appObjects) {
         StopAppUC.getByID(id, appObjects)?.stop();
     }
 }
 exports.StopAppUC = StopAppUC;
 StopAppUC.type = "StopAppUC";
+/**
+ * Factory function to create a new StopAppUC instance.
+ *
+ * @param appObject - The App Object to attach the component to
+ * @returns A new StopAppUC instance
+ */
 function makeStopAppUC(appObject) {
     return new StartAppUCImp(appObject);
 }
+/**
+ * Concrete implementation of the StopAppUC abstract class.
+ */
 class StartAppUCImp extends StopAppUC {
+    /**
+     * Gets the dispatch component that sends the stop command to the app.
+     */
     get dispatchStop() {
         return this.getCachedLocalComponent(Dispatcher_1.DispatchStopAppUC.type);
     }
+    /**
+     * Stops the app by triggering the dispatch mechanism.
+     */
     stop() {
         this.dispatchStop?.doDispatch();
     }
+    /**
+     * Creates a new instance of the StopAppUC implementation.
+     *
+     * @param appObject - The App Object to attach to
+     */
     constructor(appObject) {
         super(appObject, StopAppUC.type);
     }

package/dist/cjs/Apps/UCs/StopAppUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"StopAppUC.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/StopAppUC.ts"],"names":[],"mappings":";;;AAsCA,sCAEC;AAxCD,sCAAoE;AACpE,iDAAqD;AAErD,MAAsB,SAAU,SAAQ,kBAAW;IAKjD,MAAM,CAAC,GAAG,CAAC,SAAoB;QAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,YAAY,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,CAAC,aAAa,CAAC,aAAa,CACnC,eAAe,EACf,0CAA0C,GAAG,SAAS,CAAC,EAAE,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,EAAU,EAAE,UAAyB;QAClD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAErC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,aAAa,CACtB,mBAAmB,EACnB,kCAAkC,GAAG,EAAE,CACxC,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,EAAU,EAAE,UAAyB;QACnD,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;;AAhCH,8BAiCC;AAhCQ,cAAI,GAAG,WAAW,CAAC;AAkC5B,SAAgB,aAAa,CAAC,SAAoB;IAChD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,SAAS;IACnC,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,uBAAuB,CACjC,8BAAiB,CAAC,IAAI,CACvB,CAAC;IACJ,CAAC;IAED,IAAI;QACF,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,CAAC;IAClC,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport { DispatchStopAppUC } from \"../../Dispatcher\";\r\n\r\nexport abstract class StopAppUC extends AppObjectUC {\r\n  static type = \"StopAppUC\";\r\n\r\n  abstract stop(): void;\r\n\r\n  static get(appObject: AppObject): StopAppUC | undefined {\r\n    const asset = appObject.getComponent<StopAppUC>(StopAppUC.type);\r\n    if (!asset) {\r\n      appObject.appObjectRepo.submitWarning(\r\n        \"StopAppUC.get\",\r\n        \"Unable to find StartAppUC on app object \" + appObject.id\r\n      );\r\n    }\r\n    return asset;\r\n  }\r\n\r\n  static getByID(id: string, appObjects: AppObjectRepo): StopAppUC | undefined {\r\n    const appObject = appObjects.get(id);\r\n\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"StopAppUC.getByID\",\r\n        \"Unable to find App Object by id \" + id\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return StopAppUC.get(appObject);\r\n  }\r\n\r\n  static stopByID(id: string, appObjects: AppObjectRepo) {\r\n    StopAppUC.getByID(id, appObjects)?.stop();\r\n  }\r\n}\r\n\r\nexport function makeStopAppUC(appObject: AppObject): StopAppUC {\r\n  return new StartAppUCImp(appObject);\r\n}\r\n\r\nclass StartAppUCImp extends StopAppUC {\r\n  private get dispatchStop() {\r\n    return this.getCachedLocalComponent<DispatchStopAppUC>(\r\n      DispatchStopAppUC.type\r\n    );\r\n  }\r\n\r\n  stop(): void {\r\n    this.dispatchStop?.doDispatch();\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, StopAppUC.type);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"StopAppUC.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/StopAppUC.ts"],"names":[],"mappings":";;;AA0EA,sCAEC;AA5ED,sCAAoE;AACpE,iDAAqD;AAErD;;;;;;;GAOG;AACH,MAAsB,SAAU,SAAQ,kBAAW;IAQjD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,SAAoB;QAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,YAAY,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,CAAC,aAAa,CAAC,aAAa,CACnC,eAAe,EACf,0CAA0C,GAAG,SAAS,CAAC,EAAE,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,EAAU,EAAE,UAAyB;QAClD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAErC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,aAAa,CACtB,mBAAmB,EACnB,kCAAkC,GAAG,EAAE,CACxC,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,EAAU,EAAE,UAAyB;QACnD,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;;AAtDH,8BAuDC;AAtDQ,cAAI,GAAG,WAAW,CAAC;AAwD5B;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,SAAoB;IAChD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,aAAc,SAAQ,SAAS;IACnC;;OAEG;IACH,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,uBAAuB,CACjC,8BAAiB,CAAC,IAAI,CACvB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport { DispatchStopAppUC } from \"../../Dispatcher\";\r\n\r\n/**\r\n * Use Case for stopping an application.\r\n *\r\n * This class provides functionality to stop a running app through the dispatcher\r\n * system. It acts as a bridge between controllers and the dispatch mechanism.\r\n *\r\n * @extends AppObjectUC from @vived/core\r\n */\r\nexport abstract class StopAppUC extends AppObjectUC {\r\n  static type = \"StopAppUC\";\r\n\r\n  /**\r\n   * Stops the application associated with this Use Case.\r\n   */\r\n  abstract stop(): void;\r\n\r\n  /**\r\n   * Retrieves the StopAppUC component from a specific App Object.\r\n   *\r\n   * @param appObject - The App Object to get the component from\r\n   * @returns The StopAppUC component or undefined if not found\r\n   */\r\n  static get(appObject: AppObject): StopAppUC | undefined {\r\n    const asset = appObject.getComponent<StopAppUC>(StopAppUC.type);\r\n    if (!asset) {\r\n      appObject.appObjectRepo.submitWarning(\r\n        \"StopAppUC.get\",\r\n        \"Unable to find StartAppUC on app object \" + appObject.id\r\n      );\r\n    }\r\n    return asset;\r\n  }\r\n\r\n  /**\r\n   * Retrieves the StopAppUC component by App Object ID.\r\n   *\r\n   * @param id - The ID of the App Object\r\n   * @param appObjects - The App Object repository\r\n   * @returns The StopAppUC component or undefined if not found\r\n   */\r\n  static getByID(id: string, appObjects: AppObjectRepo): StopAppUC | undefined {\r\n    const appObject = appObjects.get(id);\r\n\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"StopAppUC.getByID\",\r\n        \"Unable to find App Object by id \" + id\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return StopAppUC.get(appObject);\r\n  }\r\n\r\n  /**\r\n   * Convenience method to stop an app by its ID.\r\n   *\r\n   * @param id - The ID of the app to stop\r\n   * @param appObjects - The App Object repository\r\n   */\r\n  static stopByID(id: string, appObjects: AppObjectRepo) {\r\n    StopAppUC.getByID(id, appObjects)?.stop();\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new StopAppUC instance.\r\n *\r\n * @param appObject - The App Object to attach the component to\r\n * @returns A new StopAppUC instance\r\n */\r\nexport function makeStopAppUC(appObject: AppObject): StopAppUC {\r\n  return new StartAppUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of the StopAppUC abstract class.\r\n */\r\nclass StartAppUCImp extends StopAppUC {\r\n  /**\r\n   * Gets the dispatch component that sends the stop command to the app.\r\n   */\r\n  private get dispatchStop() {\r\n    return this.getCachedLocalComponent<DispatchStopAppUC>(\r\n      DispatchStopAppUC.type\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Stops the app by triggering the dispatch mechanism.\r\n   */\r\n  stop(): void {\r\n    this.dispatchStop?.doDispatch();\r\n  }\r\n\r\n  /**\r\n   * Creates a new instance of the StopAppUC implementation.\r\n   *\r\n   * @param appObject - The App Object to attach to\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, StopAppUC.type);\r\n  }\r\n}\r\n"]}

package/dist/cjs/Apps/UCs/formAppIDWithVersion.js

@@ -1,6 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formAppIDWithVersion = formAppIDWithVersion;
+/**
+ * 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)
+ */
 function formAppIDWithVersion(app, version) {
     const versionString = version.baseVersionString.split(".").join("_");
     return `${app.id}-${versionString}`;

package/dist/cjs/Apps/UCs/formAppIDWithVersion.js.map

@@ -1 +1 @@
-{"version":3,"file":"formAppIDWithVersion.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/formAppIDWithVersion.ts"],"names":[],"mappings":";;AAGA,oDAGC;AAHD,SAAgB,oBAAoB,CAAC,GAAc,EAAE,OAAgB;IACnE,MAAM,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrE,OAAO,GAAG,GAAG,CAAC,EAAE,IAAI,aAAa,EAAE,CAAC;AACtC,CAAC","sourcesContent":["import { Version } from \"@vived/core\";\r\nimport { AppEntity } from \"../Entities\";\r\n\r\nexport function formAppIDWithVersion(app: AppEntity, version: Version) {\r\n  const versionString = version.baseVersionString.split(\".\").join(\"_\");\r\n  return `${app.id}-${versionString}`;\r\n}\r\n"]}
+{"version":3,"file":"formAppIDWithVersion.js","sourceRoot":"","sources":["../../../../src/Apps/UCs/formAppIDWithVersion.ts"],"names":[],"mappings":";;AAqBA,oDAGC;AArBD;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,oBAAoB,CAAC,GAAc,EAAE,OAAgB;IACnE,MAAM,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrE,OAAO,GAAG,GAAG,CAAC,EAAE,IAAI,aAAa,EAAE,CAAC;AACtC,CAAC","sourcesContent":["import { Version } from \"@vived/core\";\r\nimport { AppEntity } from \"../Entities\";\r\n\r\n/**\r\n * Creates a versioned ID for an app by combining the app ID with its version.\r\n *\r\n * This utility function forms a unique identifier that includes both the app ID\r\n * and version information. This is used to identify specific versions of apps,\r\n * particularly when loading scripts into the DOM or accessing app interfaces from\r\n * the window object.\r\n *\r\n * The version is formatted by replacing periods with underscores to create a\r\n * valid JavaScript identifier (e.g., \"1.2.3\" becomes \"1_2_3\").\r\n *\r\n * @param app - The app entity\r\n * @param version - The version to include in the ID\r\n * @returns A string in the format \"{appId}-{version_with_underscores}\"\r\n * @example\r\n * // Returns \"myApp-1_2_3\" for app.id=\"myApp\" and version=\"1.2.3\"\r\n * formAppIDWithVersion(app, version)\r\n */\r\nexport function formAppIDWithVersion(app: AppEntity, version: Version) {\r\n  const versionString = version.baseVersionString.split(\".\").join(\"_\");\r\n  return `${app.id}-${versionString}`;\r\n}\r\n"]}

package/dist/cjs/Apps/index.js

@@ -1,4 +1,23 @@
 "use strict";
+/**
+ * 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
+ */
 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/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Apps/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,gDAA8B;AAC9B,6CAA2B;AAC3B,0CAAwB;AACxB,wCAAsB;AACtB,wCAAsB","sourcesContent":["export * from \"./Adapters\";\r\nexport * from \"./Controllers\";\r\nexport * from \"./Entities\";\r\nexport * from \"./Mocks\";\r\nexport * from \"./PMs\";\r\nexport * from \"./UCs\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Apps/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;;;;;;;;;;;AAEH,6CAA2B;AAC3B,gDAA8B;AAC9B,6CAA2B;AAC3B,0CAAwB;AACxB,wCAAsB;AACtB,wCAAsB","sourcesContent":["/**\r\n * Apps Module - Core module for managing application lifecycle in the VIVED Learning platform\r\n * \r\n * This module handles app loading, mounting, starting, stopping, and state management.\r\n * It follows a clean architecture pattern with the following layers:\r\n * \r\n * - Entities: Core domain models (AppEntity, AppRepo)\r\n * - PMs (Presentation Models): Business logic and state management\r\n * - UCs (Use Cases): Implementation of specific operations\r\n * - Adapters: Connect PMs to UI components\r\n * - Controllers: Entry points for UI interactions\r\n * \r\n * To use this module, typically you would:\r\n * 1. Load an app using the AppEntity\r\n * 2. Mount the app using MounterUC\r\n * 3. Start the app using StartAppUC\r\n * 4. Manage app state via the AppPM or ActiveAppPM\r\n * 5. Stop the app using StopAppUC when done\r\n */\r\n\r\nexport * from \"./Adapters\";\r\nexport * from \"./Controllers\";\r\nexport * from \"./Entities\";\r\nexport * from \"./Mocks\";\r\nexport * from \"./PMs\";\r\nexport * from \"./UCs\";\r\n"]}

package/dist/cjs/ChallengeResults/Adapters/challengeScoreListAdapter.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.challengeScoreListAdapter = void 0;
+const ChallengeScoreListPM_1 = require("../PMs/ChallengeScoreListPM");
+exports.challengeScoreListAdapter = {
+    defaultVM: [],
+    subscribe: (appObjects, setVM) => {
+        const pm = ChallengeScoreListPM_1.ChallengeScoreListPM.get(appObjects);
+        if (!pm) {
+            appObjects.submitError("challengeScoreListAdapter", "Unable to find ChallengeScoreListPM");
+            return;
+        }
+        pm.addView(setVM);
+    },
+    unsubscribe: (appObjects, setVM) => {
+        ChallengeScoreListPM_1.ChallengeScoreListPM.get(appObjects)?.removeView(setVM);
+    }
+};
+//# sourceMappingURL=challengeScoreListAdapter.js.map

package/dist/cjs/ChallengeResults/Adapters/challengeScoreListAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"challengeScoreListAdapter.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/challengeScoreListAdapter.ts"],"names":[],"mappings":";;;AACA,sEAGqC;AAExB,QAAA,yBAAyB,GAAuC;IAC3E,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,CACT,UAAyB,EACzB,KAAmC,EACnC,EAAE;QACF,MAAM,EAAE,GAAG,2CAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,2BAA2B,EAC3B,qCAAqC,CACtC,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,WAAW,EAAE,CACX,UAAyB,EACzB,KAAmC,EACnC,EAAE;QACF,2CAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, SingletonPmAdapter } from \"@vived/core\";\r\nimport {\r\n  ChallengeScoreListPM,\r\n  SlideScoreVM\r\n} from \"../PMs/ChallengeScoreListPM\";\r\n\r\nexport const challengeScoreListAdapter: SingletonPmAdapter<SlideScoreVM[]> = {\r\n  defaultVM: [],\r\n  subscribe: (\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: SlideScoreVM[]) => void\r\n  ) => {\r\n    const pm = ChallengeScoreListPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"challengeScoreListAdapter\",\r\n        \"Unable to find ChallengeScoreListPM\"\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: SlideScoreVM[]) => void\r\n  ) => {\r\n    ChallengeScoreListPM.get(appObjects)?.removeView(setVM);\r\n  }\r\n};\r\n"]}

package/dist/cjs/ChallengeResults/Adapters/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./challengeResultsListAdapter"), exports);
 __exportStar(require("./hasChallengeResultsPMAdapter"), exports);
+__exportStar(require("./challengeScoreListAdapter"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,iEAA+C","sourcesContent":["export * from \"./challengeResultsListAdapter\";\r\nexport * from \"./hasChallengeResultsPMAdapter\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Adapters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,iEAA+C;AAC/C,8DAA4C","sourcesContent":["export * from \"./challengeResultsListAdapter\";\r\nexport * from \"./hasChallengeResultsPMAdapter\";\r\nexport * from \"./challengeScoreListAdapter\";\r\n"]}

package/dist/cjs/ChallengeResults/Entities/ChallengeResults.js

@@ -83,6 +83,41 @@ class ChallengeResultsImp extends ChallengeResultsEntity {
         this.getResultForSlide = (slideID) => {
             return this.resultLookup.get(slideID);
         };
+        this.getScoreForSlide = (slideID) => {
+            const result = this.getResultForSlide(slideID);
+            if (!result) {
+                return 0;
+            }
+            switch (result.type) {
+                case "HIT": {
+                    const hitData = result.resultData;
+                    return hitData.success ? 1 : 0;
+                }
+                case "MULTIHIT": {
+                    const multiHitData = result.resultData;
+                    const total = multiHitData.hits + multiHitData.unanswered;
+                    return total > 0 ? multiHitData.hits / total : 0;
+                }
+                case "QUALITY": {
+                    const qualityData = result.resultData;
+                    return qualityData.maxStars > 0
+                        ? qualityData.stars / qualityData.maxStars
+                        : 0;
+                }
+                case "SCORE": {
+                    const scoreData = result.resultData;
+                    return scoreData.maxScore > 0
+                        ? scoreData.score / scoreData.maxScore
+                        : 0;
+                }
+                case "PROGRESS": {
+                    const progressData = result.resultData;
+                    return progressData.maxProgress;
+                }
+                default:
+                    return 0;
+            }
+        };
         this.submitProgressResult = (slideID, maxProgress, message) => {
             const currentResult = this.getResultForSlide(slideID);
             if (currentResult &&

package/dist/cjs/ChallengeResults/Entities/ChallengeResults.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChallengeResults.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Entities/ChallengeResults.ts"],"names":[],"mappings":";;;AAuGA,oDAIC;AA3GD,sCAKqB;AA8CrB,MAAsB,sBAAuB,SAAQ,sBAAe;IA4ClE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAC1B,sBAAsB,CAAC,IAAI,EAC3B,UAAU,CACX,CAAC;IACJ,CAAC;;AAjDH,wDAkDC;AAjDQ,2BAAI,GAAG,wBAAwB,CAAC;AAmDzC,SAAgB,oBAAoB,CAClC,SAAoB;IAEpB,OAAO,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,mBAAoB,SAAQ,sBAAsB;IAGtD,IAAI,OAAO;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IA+HD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QApIxC,iBAAY,GAAG,IAAI,GAAG,EAA2B,CAAC;QAM1D,oBAAe,GAAG,CAChB,OAAe,EACf,OAAgB,EAChB,KAAa,EACb,OAAe,EACT,EAAE;YACR,MAAM,UAAU,GAA2B;gBACzC,OAAO;aACR,CAAC;YACF,MAAM,MAAM,GAAoB;gBAC9B,OAAO;gBACP,OAAO;gBACP,UAAU;gBACV,KAAK;gBACL,IAAI,EAAE,KAAK;aACZ,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF,yBAAoB,GAAG,CACrB,OAAe,EACf,IAAY,EACZ,MAAc,EACd,UAAkB,EAClB,KAAa,EACb,OAAe,EACT,EAAE;YACR,MAAM,UAAU,GAAgC;gBAC9C,IAAI;gBACJ,MAAM;gBACN,UAAU;aACX,CAAC;YACF,MAAM,MAAM,GAAoB;gBAC9B,OAAO;gBACP,OAAO;gBACP,UAAU;gBACV,KAAK;gBACL,IAAI,EAAE,UAAU;aACjB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF,wBAAmB,GAAG,CACpB,OAAe,EACf,KAAa,EACb,QAAgB,EAChB,KAAa,EACb,OAAe,EACT,EAAE;YACR,MAAM,UAAU,GAA+B;gBAC7C,KAAK;gBACL,QAAQ;aACT,CAAC;YACF,MAAM,MAAM,GAAoB;gBAC9B,OAAO;gBACP,OAAO;gBACP,UAAU;gBACV,KAAK;gBACL,IAAI,EAAE,SAAS;aAChB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF,sBAAiB,GAAG,CAClB,OAAe,EACf,KAAa,EACb,QAAgB,EAChB,KAAa,EACb,OAAe,EACT,EAAE;YACR,MAAM,UAAU,GAA6B;gBAC3C,KAAK;gBACL,QAAQ;aACT,CAAC;YACF,MAAM,MAAM,GAAoB;gBAC9B,OAAO;gBACP,OAAO;gBACP,UAAU;gBACV,KAAK;gBACL,IAAI,EAAE,OAAO;aACd,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF,sBAAiB,GAAG,CAAC,OAAe,EAA+B,EAAE;YACnE,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,yBAAoB,GAAG,CACrB,OAAe,EACf,WAAmB,EACnB,OAAe,EACT,EAAE;YACR,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACtD,IACE,aAAa;gBACZ,aAAa,CAAC,UAA0C,CAAC,WAAW;oBACnE,WAAW,EACb,CAAC;gBACD,OAAO;YACT,CAAC;YAED,MAAM,UAAU,GAAgC;gBAC9C,WAAW;aACZ,CAAC;YACF,MAAM,MAAM,GAAoB;gBAC9B,OAAO;gBACP,OAAO;gBACP,UAAU;gBACV,KAAK,EAAE,CAAC;gBACR,IAAI,EAAE,UAAU;aACjB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\n\r\nexport type ChallengeResultType =\r\n  | \"HIT\"\r\n  | \"MULTIHIT\"\r\n  | \"QUALITY\"\r\n  | \"SCORE\"\r\n  | \"PROGRESS\";\r\n\r\nexport interface ChallengeResult {\r\n  slideID: string;\r\n  tries: number;\r\n  message: string;\r\n  type: ChallengeResultType;\r\n  resultData:\r\n    | ChallengeResultHitData\r\n    | ChallengeResultMultiHitData\r\n    | ChallengeResultQualityData\r\n    | ChallengeResultScoreData\r\n    | ChallengeResultProgressData;\r\n}\r\n\r\nexport interface ChallengeResultHitData {\r\n  success: boolean;\r\n}\r\n\r\nexport interface ChallengeResultProgressData {\r\n  maxProgress: number;\r\n}\r\n\r\nexport interface ChallengeResultMultiHitData {\r\n  hits: number;\r\n  misses: number;\r\n  unanswered: number;\r\n}\r\n\r\nexport interface ChallengeResultQualityData {\r\n  stars: number;\r\n  maxStars: number;\r\n}\r\n\r\nexport interface ChallengeResultScoreData {\r\n  score: number;\r\n  maxScore: number;\r\n}\r\n\r\nexport abstract class ChallengeResultsEntity extends AppObjectEntity {\r\n  static type = \"ChallengeResultsEntity\";\r\n\r\n  abstract get results(): ChallengeResult[];\r\n  abstract submitHitResult: (\r\n    slideID: string,\r\n    success: boolean,\r\n    tries: number,\r\n    message: string\r\n  ) => void;\r\n\r\n  abstract submitMultiHitResult: (\r\n    slideID: string,\r\n    hits: number,\r\n    misses: number,\r\n    unanswered: number,\r\n    tries: number,\r\n    message: string\r\n  ) => void;\r\n\r\n  abstract submitQualityResult: (\r\n    slideID: string,\r\n    stars: number,\r\n    maxStars: number,\r\n    tries: number,\r\n    message: string\r\n  ) => void;\r\n\r\n  abstract submitScoreResult: (\r\n    slideID: string,\r\n    score: number,\r\n    maxScore: number,\r\n    tries: number,\r\n    message: string\r\n  ) => void;\r\n\r\n  abstract submitProgressResult: (\r\n    slideID: string,\r\n    maxProgress: number,\r\n    message: string\r\n  ) => void;\r\n\r\n  abstract getResultForSlide: (slideID: string) => ChallengeResult | undefined;\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<ChallengeResultsEntity>(\r\n      ChallengeResultsEntity.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeChallengeResults(\r\n  appObject: AppObject\r\n): ChallengeResultsEntity {\r\n  return new ChallengeResultsImp(appObject);\r\n}\r\n\r\nclass ChallengeResultsImp extends ChallengeResultsEntity {\r\n  private resultLookup = new Map<string, ChallengeResult>();\r\n\r\n  get results(): ChallengeResult[] {\r\n    return Array.from(this.resultLookup.values());\r\n  }\r\n\r\n  submitHitResult = (\r\n    slideID: string,\r\n    success: boolean,\r\n    tries: number,\r\n    message: string\r\n  ): void => {\r\n    const resultData: ChallengeResultHitData = {\r\n      success\r\n    };\r\n    const result: ChallengeResult = {\r\n      slideID,\r\n      message,\r\n      resultData,\r\n      tries,\r\n      type: \"HIT\"\r\n    };\r\n\r\n    this.resultLookup.set(slideID, result);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  submitMultiHitResult = (\r\n    slideID: string,\r\n    hits: number,\r\n    misses: number,\r\n    unanswered: number,\r\n    tries: number,\r\n    message: string\r\n  ): void => {\r\n    const resultData: ChallengeResultMultiHitData = {\r\n      hits,\r\n      misses,\r\n      unanswered\r\n    };\r\n    const result: ChallengeResult = {\r\n      slideID,\r\n      message,\r\n      resultData,\r\n      tries,\r\n      type: \"MULTIHIT\"\r\n    };\r\n\r\n    this.resultLookup.set(slideID, result);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  submitQualityResult = (\r\n    slideID: string,\r\n    stars: number,\r\n    maxStars: number,\r\n    tries: number,\r\n    message: string\r\n  ): void => {\r\n    const resultData: ChallengeResultQualityData = {\r\n      stars,\r\n      maxStars\r\n    };\r\n    const result: ChallengeResult = {\r\n      slideID,\r\n      message,\r\n      resultData,\r\n      tries,\r\n      type: \"QUALITY\"\r\n    };\r\n\r\n    this.resultLookup.set(slideID, result);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  submitScoreResult = (\r\n    slideID: string,\r\n    score: number,\r\n    maxScore: number,\r\n    tries: number,\r\n    message: string\r\n  ): void => {\r\n    const resultData: ChallengeResultScoreData = {\r\n      score,\r\n      maxScore\r\n    };\r\n    const result: ChallengeResult = {\r\n      slideID,\r\n      message,\r\n      resultData,\r\n      tries,\r\n      type: \"SCORE\"\r\n    };\r\n\r\n    this.resultLookup.set(slideID, result);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  getResultForSlide = (slideID: string): ChallengeResult | undefined => {\r\n    return this.resultLookup.get(slideID);\r\n  };\r\n\r\n  submitProgressResult = (\r\n    slideID: string,\r\n    maxProgress: number,\r\n    message: string\r\n  ): void => {\r\n    const currentResult = this.getResultForSlide(slideID);\r\n    if (\r\n      currentResult &&\r\n      (currentResult.resultData as ChallengeResultProgressData).maxProgress >\r\n        maxProgress\r\n    ) {\r\n      return;\r\n    }\r\n\r\n    const resultData: ChallengeResultProgressData = {\r\n      maxProgress\r\n    };\r\n    const result: ChallengeResult = {\r\n      slideID,\r\n      message,\r\n      resultData,\r\n      tries: 1,\r\n      type: \"PROGRESS\"\r\n    };\r\n\r\n    this.resultLookup.set(slideID, result);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ChallengeResultsEntity.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ChallengeResults.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Entities/ChallengeResults.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\n\r\nexport type ChallengeResultType =\r\n  | \"HIT\"\r\n  | \"MULTIHIT\"\r\n  | \"QUALITY\"\r\n  | \"SCORE\"\r\n  | \"PROGRESS\";\r\n\r\nexport interface ChallengeResult {\r\n  slideID: string;\r\n  tries: number;\r\n  message: string;\r\n  type: ChallengeResultType;\r\n  resultData:\r\n    | ChallengeResultHitData\r\n    | ChallengeResultMultiHitData\r\n    | ChallengeResultQualityData\r\n    | ChallengeResultScoreData\r\n    | ChallengeResultProgressData;\r\n}\r\n\r\nexport interface ChallengeResultHitData {\r\n  success: boolean;\r\n}\r\n\r\nexport interface ChallengeResultProgressData {\r\n  maxProgress: number;\r\n}\r\n\r\nexport interface ChallengeResultMultiHitData {\r\n  hits: number;\r\n  misses: number;\r\n  unanswered: number;\r\n}\r\n\r\nexport interface ChallengeResultQualityData {\r\n  stars: number;\r\n  maxStars: number;\r\n}\r\n\r\nexport interface ChallengeResultScoreData {\r\n  score: number;\r\n  maxScore: number;\r\n}\r\n\r\nexport abstract class ChallengeResultsEntity extends AppObjectEntity {\r\n  static type = \"ChallengeResultsEntity\";\r\n\r\n  abstract get results(): ChallengeResult[];\r\n  abstract submitHitResult: (\r\n    slideID: string,\r\n    success: boolean,\r\n    tries: number,\r\n    message: string\r\n  ) => void;\r\n\r\n  abstract submitMultiHitResult: (\r\n    slideID: string,\r\n    hits: number,\r\n    misses: number,\r\n    unanswered: number,\r\n    tries: number,\r\n    message: string\r\n  ) => void;\r\n\r\n  abstract submitQualityResult: (\r\n    slideID: string,\r\n    stars: number,\r\n    maxStars: number,\r\n    tries: number,\r\n    message: string\r\n  ) => void;\r\n\r\n  abstract submitScoreResult: (\r\n    slideID: string,\r\n    score: number,\r\n    maxScore: number,\r\n    tries: number,\r\n    message: string\r\n  ) => void;\r\n\r\n  abstract submitProgressResult: (\r\n    slideID: string,\r\n    maxProgress: number,\r\n    message: string\r\n  ) => void;\r\n\r\n  abstract getResultForSlide: (slideID: string) => ChallengeResult | undefined;\r\n\r\n  abstract getScoreForSlide: (slideID: string) => number;\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<ChallengeResultsEntity>(\r\n      ChallengeResultsEntity.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeChallengeResults(\r\n  appObject: AppObject\r\n): ChallengeResultsEntity {\r\n  return new ChallengeResultsImp(appObject);\r\n}\r\n\r\nclass ChallengeResultsImp extends ChallengeResultsEntity {\r\n  private resultLookup = new Map<string, ChallengeResult>();\r\n\r\n  get results(): ChallengeResult[] {\r\n    return Array.from(this.resultLookup.values());\r\n  }\r\n\r\n  submitHitResult = (\r\n    slideID: string,\r\n    success: boolean,\r\n    tries: number,\r\n    message: string\r\n  ): void => {\r\n    const resultData: ChallengeResultHitData = {\r\n      success\r\n    };\r\n    const result: ChallengeResult = {\r\n      slideID,\r\n      message,\r\n      resultData,\r\n      tries,\r\n      type: \"HIT\"\r\n    };\r\n\r\n    this.resultLookup.set(slideID, result);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  submitMultiHitResult = (\r\n    slideID: string,\r\n    hits: number,\r\n    misses: number,\r\n    unanswered: number,\r\n    tries: number,\r\n    message: string\r\n  ): void => {\r\n    const resultData: ChallengeResultMultiHitData = {\r\n      hits,\r\n      misses,\r\n      unanswered\r\n    };\r\n    const result: ChallengeResult = {\r\n      slideID,\r\n      message,\r\n      resultData,\r\n      tries,\r\n      type: \"MULTIHIT\"\r\n    };\r\n\r\n    this.resultLookup.set(slideID, result);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  submitQualityResult = (\r\n    slideID: string,\r\n    stars: number,\r\n    maxStars: number,\r\n    tries: number,\r\n    message: string\r\n  ): void => {\r\n    const resultData: ChallengeResultQualityData = {\r\n      stars,\r\n      maxStars\r\n    };\r\n    const result: ChallengeResult = {\r\n      slideID,\r\n      message,\r\n      resultData,\r\n      tries,\r\n      type: \"QUALITY\"\r\n    };\r\n\r\n    this.resultLookup.set(slideID, result);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  submitScoreResult = (\r\n    slideID: string,\r\n    score: number,\r\n    maxScore: number,\r\n    tries: number,\r\n    message: string\r\n  ): void => {\r\n    const resultData: ChallengeResultScoreData = {\r\n      score,\r\n      maxScore\r\n    };\r\n    const result: ChallengeResult = {\r\n      slideID,\r\n      message,\r\n      resultData,\r\n      tries,\r\n      type: \"SCORE\"\r\n    };\r\n\r\n    this.resultLookup.set(slideID, result);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  getResultForSlide = (slideID: string): ChallengeResult | undefined => {\r\n    return this.resultLookup.get(slideID);\r\n  };\r\n\r\n  getScoreForSlide = (slideID: string): number => {\r\n    const result = this.getResultForSlide(slideID);\r\n    if (!result) {\r\n      return 0;\r\n    }\r\n\r\n    switch (result.type) {\r\n      case \"HIT\": {\r\n        const hitData = result.resultData as ChallengeResultHitData;\r\n        return hitData.success ? 1 : 0;\r\n      }\r\n      case \"MULTIHIT\": {\r\n        const multiHitData = result.resultData as ChallengeResultMultiHitData;\r\n        const total = multiHitData.hits + multiHitData.unanswered;\r\n        return total > 0 ? multiHitData.hits / total : 0;\r\n      }\r\n      case \"QUALITY\": {\r\n        const qualityData = result.resultData as ChallengeResultQualityData;\r\n        return qualityData.maxStars > 0\r\n          ? qualityData.stars / qualityData.maxStars\r\n          : 0;\r\n      }\r\n      case \"SCORE\": {\r\n        const scoreData = result.resultData as ChallengeResultScoreData;\r\n        return scoreData.maxScore > 0\r\n          ? scoreData.score / scoreData.maxScore\r\n          : 0;\r\n      }\r\n      case \"PROGRESS\": {\r\n        const progressData = result.resultData as ChallengeResultProgressData;\r\n        return progressData.maxProgress;\r\n      }\r\n      default:\r\n        return 0;\r\n    }\r\n  };\r\n\r\n  submitProgressResult = (\r\n    slideID: string,\r\n    maxProgress: number,\r\n    message: string\r\n  ): void => {\r\n    const currentResult = this.getResultForSlide(slideID);\r\n    if (\r\n      currentResult &&\r\n      (currentResult.resultData as ChallengeResultProgressData).maxProgress >\r\n        maxProgress\r\n    ) {\r\n      return;\r\n    }\r\n\r\n    const resultData: ChallengeResultProgressData = {\r\n      maxProgress\r\n    };\r\n    const result: ChallengeResult = {\r\n      slideID,\r\n      message,\r\n      resultData,\r\n      tries: 1,\r\n      type: \"PROGRESS\"\r\n    };\r\n\r\n    this.resultLookup.set(slideID, result);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ChallengeResultsEntity.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

package/dist/cjs/ChallengeResults/Mocks/MockChallengeScoreListPM.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockChallengeScoreListPM = void 0;
+exports.makeMockChallengeScoreListPM = makeMockChallengeScoreListPM;
+const ChallengeScoreListPM_1 = require("../PMs/ChallengeScoreListPM");
+class MockChallengeScoreListPM extends ChallengeScoreListPM_1.ChallengeScoreListPM {
+    constructor(appObject) {
+        super(appObject, ChallengeScoreListPM_1.ChallengeScoreListPM.type);
+        this.vmsAreEqual = jest
+            .fn()
+            .mockImplementation((a, b) => true);
+        this.appObjects.registerSingleton(this);
+    }
+}
+exports.MockChallengeScoreListPM = MockChallengeScoreListPM;
+function makeMockChallengeScoreListPM(appObjects) {
+    return new MockChallengeScoreListPM(appObjects.getOrCreate("MockChallengeScoreListPM"));
+}
+//# sourceMappingURL=MockChallengeScoreListPM.js.map

package/dist/cjs/ChallengeResults/Mocks/MockChallengeScoreListPM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockChallengeScoreListPM.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Mocks/MockChallengeScoreListPM.ts"],"names":[],"mappings":";;;AAmBA,oEAMC;AAxBD,sEAGqC;AAErC,MAAa,wBAAyB,SAAQ,2CAAoB;IAOhE,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,2CAAoB,CAAC,IAAI,CAAC,CAAC;QAP9C,gBAAW,GAAG,IAAI;aACf,EAAE,EAAE;aACJ,kBAAkB,CACjB,CAAC,CAAiB,EAAE,CAAiB,EAAW,EAAE,CAAC,IAAI,CACxD,CAAC;QAIF,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF;AAXD,4DAWC;AAED,SAAgB,4BAA4B,CAC1C,UAAyB;IAEzB,OAAO,IAAI,wBAAwB,CACjC,UAAU,CAAC,WAAW,CAAC,0BAA0B,CAAC,CACnD,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport {\r\n  ChallengeScoreListPM,\r\n  SlideScoreVM\r\n} from \"../PMs/ChallengeScoreListPM\";\r\n\r\nexport class MockChallengeScoreListPM extends ChallengeScoreListPM {\r\n  vmsAreEqual = jest\r\n    .fn()\r\n    .mockImplementation(\r\n      (a: SlideScoreVM[], b: SlideScoreVM[]): boolean => true\r\n    );\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ChallengeScoreListPM.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n\r\nexport function makeMockChallengeScoreListPM(\r\n  appObjects: AppObjectRepo\r\n): MockChallengeScoreListPM {\r\n  return new MockChallengeScoreListPM(\r\n    appObjects.getOrCreate(\"MockChallengeScoreListPM\")\r\n  );\r\n}\r\n"]}

package/dist/cjs/ChallengeResults/Mocks/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ChallengeResultsListPMMock"), exports);
 __exportStar(require("./MockHasChallengeResultsPM"), exports);
+__exportStar(require("./MockChallengeScoreListPM"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/ChallengeResults/Mocks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Mocks/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA4C;AAC5C,8DAA2C","sourcesContent":["export * from \"./ChallengeResultsListPMMock\"\r\nexport * from \"./MockHasChallengeResultsPM\""]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/Mocks/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,8DAA4C;AAC5C,6DAA2C","sourcesContent":["export * from \"./ChallengeResultsListPMMock\";\r\nexport * from \"./MockHasChallengeResultsPM\";\r\nexport * from \"./MockChallengeScoreListPM\";\r\n"]}

package/dist/cjs/ChallengeResults/PMs/ChallengeScoreListPM.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChallengeScoreListPM = void 0;
+exports.makeChallengeScoreListPM = makeChallengeScoreListPM;
+const core_1 = require("@vived/core");
+const HostStateMachine_1 = require("../../StateMachine/Entities/HostStateMachine");
+const ChallengeResults_1 = require("../Entities/ChallengeResults");
+class ChallengeScoreListPM extends core_1.AppObjectPM {
+    static get(appObjects) {
+        return (0, core_1.getSingletonComponent)(ChallengeScoreListPM.type, appObjects);
+    }
+}
+exports.ChallengeScoreListPM = ChallengeScoreListPM;
+ChallengeScoreListPM.type = "ChallengeScoreListPM";
+function makeChallengeScoreListPM(appObject) {
+    return new ChallengeScoreListPMImp(appObject);
+}
+class ChallengeScoreListPMImp extends ChallengeScoreListPM {
+    get challengeResults() {
+        return this.getCachedSingleton(ChallengeResults_1.ChallengeResultsEntity.type);
+    }
+    get stateMachine() {
+        return this.getCachedSingleton(HostStateMachine_1.HostStateMachine.type);
+    }
+    vmsAreEqual(a, b) {
+        if (a.length !== b.length)
+            return false;
+        for (let i = 0; i < a.length; i++) {
+            if (a[i].id !== b[i].id)
+                return false;
+            if (a[i].displayName !== b[i].displayName)
+                return false;
+            if (a[i].score !== b[i].score)
+                return false;
+        }
+        return true;
+    }
+    constructor(appObject) {
+        super(appObject, ChallengeScoreListPM.type);
+        this.onEntityChange = () => {
+            if (!this.challengeResults || !this.stateMachine)
+                return;
+            const slideScores = [];
+            // Get all states from state machine
+            const stateIds = this.stateMachine.states;
+            // Process each state
+            stateIds.forEach((slideId, index) => {
+                // Skip slides that don't have a result
+                if (!this.challengeResults.getResultForSlide(slideId))
+                    return;
+                const state = this.stateMachine.getStateByID(slideId);
+                if (state) {
+                    // Get score for this slide using the method from ChallengeResults
+                    const score = this.challengeResults.getScoreForSlide(slideId);
+                    // Format the display name
+                    const displayName = `Slide ${index + 1}: ${state.name}`;
+                    // Add to results
+                    slideScores.push({
+                        id: slideId,
+                        displayName,
+                        score
+                    });
+                }
+            });
+            this.doUpdateView(slideScores);
+        };
+        // Initialize with empty array
+        this.doUpdateView([]);
+        // Subscribe to changes in entities
+        this.challengeResults?.addChangeObserver(this.onEntityChange);
+        this.stateMachine?.addChangeObserver(this.onEntityChange);
+        // Initial update
+        this.onEntityChange();
+        // Register as singleton
+        this.appObjects.registerSingleton(this);
+    }
+}
+//# sourceMappingURL=ChallengeScoreListPM.js.map

package/dist/cjs/ChallengeResults/PMs/ChallengeScoreListPM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChallengeScoreListPM.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/PMs/ChallengeScoreListPM.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo,\r\n  getSingletonComponent\r\n} from \"@vived/core\";\r\nimport { HostStateMachine } from \"../../StateMachine/Entities/HostStateMachine\";\r\nimport { ChallengeResultsEntity } from \"../Entities/ChallengeResults\";\r\n\r\nexport interface SlideScoreVM {\r\n  id: string;\r\n  displayName: string;\r\n  score: number;\r\n}\r\n\r\nexport abstract class ChallengeScoreListPM extends AppObjectPM<SlideScoreVM[]> {\r\n  static readonly type = \"ChallengeScoreListPM\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<ChallengeScoreListPM>(\r\n      ChallengeScoreListPM.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeChallengeScoreListPM(\r\n  appObject: AppObject\r\n): ChallengeScoreListPM {\r\n  return new ChallengeScoreListPMImp(appObject);\r\n}\r\n\r\nclass ChallengeScoreListPMImp extends ChallengeScoreListPM {\r\n  private get challengeResults() {\r\n    return this.getCachedSingleton<ChallengeResultsEntity>(\r\n      ChallengeResultsEntity.type\r\n    );\r\n  }\r\n\r\n  private get stateMachine() {\r\n    return this.getCachedSingleton<HostStateMachine>(HostStateMachine.type);\r\n  }\r\n\r\n  vmsAreEqual(a: SlideScoreVM[], b: SlideScoreVM[]): boolean {\r\n    if (a.length !== b.length) return false;\r\n\r\n    for (let i = 0; i < a.length; i++) {\r\n      if (a[i].id !== b[i].id) return false;\r\n      if (a[i].displayName !== b[i].displayName) return false;\r\n      if (a[i].score !== b[i].score) return false;\r\n    }\r\n    return true;\r\n  }\r\n\r\n  onEntityChange = (): void => {\r\n    if (!this.challengeResults || !this.stateMachine) return;\r\n\r\n    const slideScores: SlideScoreVM[] = [];\r\n\r\n    // Get all states from state machine\r\n    const stateIds = this.stateMachine.states;\r\n\r\n    // Process each state\r\n    stateIds.forEach((slideId, index) => {\r\n      // Skip slides that don't have a result\r\n      if (!this.challengeResults!.getResultForSlide(slideId)) return;\r\n\r\n      const state = this.stateMachine!.getStateByID(slideId);\r\n      if (state) {\r\n        // Get score for this slide using the method from ChallengeResults\r\n        const score = this.challengeResults!.getScoreForSlide(slideId);\r\n\r\n        // Format the display name\r\n        const displayName = `Slide ${index + 1}: ${state.name}`;\r\n\r\n        // Add to results\r\n        slideScores.push({\r\n          id: slideId,\r\n          displayName,\r\n          score\r\n        });\r\n      }\r\n    });\r\n\r\n    this.doUpdateView(slideScores);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ChallengeScoreListPM.type);\r\n\r\n    // Initialize with empty array\r\n    this.doUpdateView([]);\r\n\r\n    // Subscribe to changes in entities\r\n    this.challengeResults?.addChangeObserver(this.onEntityChange);\r\n    this.stateMachine?.addChangeObserver(this.onEntityChange);\r\n\r\n    // Initial update\r\n    this.onEntityChange();\r\n\r\n    // Register as singleton\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

package/dist/cjs/ChallengeResults/PMs/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ChallengeResultsListPM"), exports);
 __exportStar(require("./HasChallengeResultsPM"), exports);
+__exportStar(require("./ChallengeScoreListPM"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/ChallengeResults/PMs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/PMs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAwC;AACxC,0DAAuC","sourcesContent":["export * from \"./ChallengeResultsListPM\"\r\nexport * from \"./HasChallengeResultsPM\""]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ChallengeResults/PMs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,0DAAwC;AACxC,yDAAuC","sourcesContent":["export * from \"./ChallengeResultsListPM\";\r\nexport * from \"./HasChallengeResultsPM\";\r\nexport * from \"./ChallengeScoreListPM\";\r\n"]}

package/dist/cjs/Handler/UCs/SubmitResultHandler.js

@@ -84,6 +84,14 @@ class SubmitResultHandlerImp extends SubmitResultHandler {
     }
     constructor(appObject) {
         super(appObject, SubmitResultHandler.type);
+        // Map result types to challenge responses
+        this.resultTypeToResponseMap = {
+            HIT_V1: StateMachine_1.ChallengeResponse.HIT,
+            MULTIHIT_V1: StateMachine_1.ChallengeResponse.MULTIHIT,
+            QUALITY_V1: StateMachine_1.ChallengeResponse.QUALITY,
+            SCORE_V1: StateMachine_1.ChallengeResponse.SCORE,
+            PROGRESS_V1: StateMachine_1.ChallengeResponse.PROGRESS
+        };
         this.action = (type, result, description) => {
             if (!this.challengeResults || !this.stateMachine) {
                 this.error("Missing Component");
@@ -93,25 +101,32 @@ class SubmitResultHandlerImp extends SubmitResultHandler {
                 this.warn("Cannot store result because there is no active slide");
                 return;
             }
-            const currentSlide = this.stateMachine.activeState;
-            let tries = this.challengeResults.getResultForSlide(currentSlide)?.tries ?? 0;
+            const currentSlideId = this.stateMachine.activeState;
+            const currentStateEntity = this.stateMachine.getStateByID(currentSlideId);
+            if (!currentStateEntity) {
+                this.warn("Cannot find active state entity");
+                return;
+            }
+            // Set the expected response based on the result type
+            currentStateEntity.expectedResponse = this.resultTypeToResponseMap[type];
+            let tries = this.challengeResults.getResultForSlide(currentSlideId)?.tries ?? 0;
             if (type !== "PROGRESS_V1") {
                 tries += 1;
             }
             if (type === "HIT_V1") {
-                this.handleHitV1(result, tries, currentSlide, description);
+                this.handleHitV1(result, tries, currentSlideId, description);
             }
             else if (type === "MULTIHIT_V1") {
-                this.handleMultiHitV1(result, tries, currentSlide, description);
+                this.handleMultiHitV1(result, tries, currentSlideId, description);
             }
             else if (type === "QUALITY_V1") {
-                this.handleQualityV1(result, tries, currentSlide, description);
+                this.handleQualityV1(result, tries, currentSlideId, description);
             }
             else if (type === "SCORE_V1") {
-                this.handleScoreV1(result, tries, currentSlide, description);
+                this.handleScoreV1(result, tries, currentSlideId, description);
             }
             else if (type === "PROGRESS_V1") {
-                this.handleProgressV1(result, currentSlide, description);
+                this.handleProgressV1(result, currentSlideId, description);
             }
         };
         this.handleRequest = (version, payload) => {