@vived/app 6.5.0 → 6.6.0

package/dist/cjs/LabelDrop/Factories/LabelDropFeatureFactory.js

@@ -84,6 +84,7 @@ class LabelDropFeatureFactory extends core_1.DomainFactory {
         (0, UseCases_1.makeLabelDropOnNothingAnimationUC)(this.appObject);
         (0, UseCases_1.makeLabelDropIncorrectAnimationUC)(this.appObject);
         (0, UseCases_1.makeValidateLabelDrop)(this.appObject);
+        (0, UseCases_1.makeSubmitLabelDropResultUC)(this.appObject);
     }
     /**
      * Sets up all presentation models for the LabelDrop Feature.

package/dist/cjs/LabelDrop/Factories/LabelDropFeatureFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"LabelDropFeatureFactory.js","sourceRoot":"","sources":["../../../../src/LabelDrop/Factories/LabelDropFeatureFactory.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DomainFactory,\n  AppObject,\n  AppObjectRepo,\n  Quaternion,\n  Vector3,\n} from \"@vived/core\";\nimport { StylusEntity } from \"../../Stylus\";\nimport { makeTransform3DPM } from \"../../Transform3D\";\nimport { ZSpaceEntity } from \"../../zSpace\";\nimport {\n  makeMouseLabelDropAuthor,\n  makeStylusLabelDrop,\n  makeTouchLabelDropAuthor,\n} from \"../Controller\";\nimport { makeLabelDropRepo } from \"../Entities\";\nimport {\n  makeLabelDropDragItemPM,\n  makeLabelDropEditingIDPM,\n  makeLabelDropListPM,\n  makeLabelDropReviewPM,\n  makeRemainingLabelDropListPM,\n} from \"../PM\";\nimport {\n  ClearEditingLabelDropUCHook,\n  makeDeleteAllLabelDropUC,\n  makeDeleteLabelDropUC,\n  makeDragLabelDropUC,\n  makeDragLabelDropWorldUC,\n  makeEditLabelDropUC,\n  makeLabelDropCorrectAnimationUC,\n  makeLabelDropIncorrectAnimationUC,\n  makeLabelDropOnNothingAnimationUC,\n  makeToggleLabelDropTargetUC,\n  makeValidateLabelDrop,\n  SerializeLabelDrop,\n} from \"../UseCases\";\nimport { makeLabelDropItemFactory } from \"./labelDropItemFactory\";\nimport { LabelDropRepo } from \"../Entities\";\nimport { ChallengeEntity } from \"../../Challenge\";\n\n/**\n * Factory responsible for setting up the LabelDrop Feature domain components.\n *\n * This factory initializes all entities, use cases, presentation models, and controllers\n * required for the LabelDrop Feature functionality. It follows the domain-driven\n * design pattern by organizing components into their respective layers. This factory\n * replaces the complex setupLabelDrop function while maintaining backwards compatibility.\n *\n * The factory creates and configures:\n * - 1 LabelDropRepo entity with labelDropItemFactory configuration\n * - 12 Use Cases for label drop operations including serialization, editing, dragging, and validation\n * - 6 Presentation Models for UI state management and data presentation\n * - 3 Controllers for mouse, touch, and stylus interactions\n * - External dependency management for StylusEntity and ZSpaceEntity\n * - Transform hierarchy setup with proper positioning and scaling\n *\n * @extends DomainFactory\n */\nexport class LabelDropFeatureFactory extends DomainFactory {\n  factoryName = \"LabelDropFeatureFactory\";\n\n  private labelDropEntity: LabelDropRepo | null = null;\n\n  /**\n   * Sets up all entities required for the LabelDrop Feature.\n   *\n   * Initializes the LabelDropRepo entity and configures it with the\n   * labelDropItemFactory for creating individual label drop items.\n   * Uses the \"LabelDrop\" AppObject that was passed to the factory constructor.\n   */\n  setupEntities(): void {\n    // Create the main LabelDropRepo entity\n    this.labelDropEntity = makeLabelDropRepo(this.appObject);\n\n    // Configure the entity with the item factory\n    this.labelDropEntity.labelDropItemFactory = makeLabelDropItemFactory(\n      this.appObject.appObjectRepo,\n    );\n  }\n\n  /**\n   * Sets up all use cases for the LabelDrop Feature.\n   *\n   * Initializes all 12 use cases that define the business operations and\n   * workflows available in the label drop feature. The use cases are created\n   * in the same order as the original setupLabelDrop function to maintain\n   * functional equivalence.\n   *\n   * Use Cases created:\n   * - SerializeLabelDrop: Handles serialization of label drop data\n   * - ClearEditingLabelDropUCHook: Manages clearing editing state\n   * - EditLabelDropUC: Handles label drop editing operations\n   * - DragLabelDropUC: Manages label drop dragging in screen space\n   * - DragLabelDropWorldUC: Manages label drop dragging in world space\n   * - DeleteLabelDropUC: Handles individual label drop deletion\n   * - DeleteAllLabelDropUC: Handles deletion of all label drops\n   * - ToggleLabelDropTargetUC: Manages target toggle operations\n   * - LabelDropCorrectAnimationUC: Handles correct drop animations\n   * - LabelDropOnNothingAnimationUC: Handles drop-on-nothing animations\n   * - LabelDropIncorrectAnimationUC: Handles incorrect drop animations\n   * - ValidateLabelDrop: Handles label drop validation logic\n   */\n  setupUCs(): void {\n    // Create all Use Cases in the same order as original\n    new SerializeLabelDrop(this.appObject);\n    new ClearEditingLabelDropUCHook(this.appObject);\n    makeEditLabelDropUC(this.appObject);\n    makeDragLabelDropUC(this.appObject);\n    makeDragLabelDropWorldUC(this.appObject);\n    makeDeleteLabelDropUC(this.appObject);\n    makeDeleteAllLabelDropUC(this.appObject);\n    makeToggleLabelDropTargetUC(this.appObject);\n    makeLabelDropCorrectAnimationUC(this.appObject);\n    makeLabelDropOnNothingAnimationUC(this.appObject);\n    makeLabelDropIncorrectAnimationUC(this.appObject);\n    makeValidateLabelDrop(this.appObject);\n  }\n\n  /**\n   * Sets up all presentation models for the LabelDrop Feature.\n   *\n   * Initializes all 6 presentation models that handle the view logic and\n   * state management for UI components related to the label drop feature.\n   * These PMs manage the reactive data flow between the domain layer and UI.\n   *\n   * Presentation Models created:\n   * - LabelDropEditingIDPM: Manages the currently editing label drop ID\n   * - RemainingLabelDropListPM: Tracks remaining label drops to be placed\n   * - LabelDropReviewPM: Handles review mode presentation logic\n   * - Transform3DPM: Manages 3D transform presentation for the feature\n   * - LabelDropDragItemPM: Handles drag item presentation state\n   * - LabelDropListPM: Manages the overall list of label drops\n   */\n  setupPMs(): void {\n    // Create all Presentation Models in the same order as original\n    makeLabelDropEditingIDPM(this.appObject);\n    makeRemainingLabelDropListPM(this.appObject);\n    makeLabelDropReviewPM(this.appObject);\n    makeTransform3DPM(this.appObject);\n    makeLabelDropDragItemPM(this.appObject);\n    makeLabelDropListPM(this.appObject);\n  }\n\n  /**\n   * Performs final setup operations after all components are initialized.\n   *\n   * This method handles:\n   * - Creation of the 3 Controllers (Mouse, Touch, Stylus)\n   * - External dependency resolution and configuration\n   * - Transform hierarchy setup for drag operations\n   * - Error handling for missing dependencies\n   *\n   * Controllers created:\n   * - MouseLabelDropAuthor: Handles mouse-based label drop interactions\n   * - TouchLabelDropAuthor: Handles touch-based label drop interactions\n   * - StylusLabelDrop: Handles stylus-based label drop interactions\n   *\n   * External dependencies:\n   * - StylusEntity: Required for stylus-based interactions and drag helper positioning\n   * - ZSpaceEntity: Required for zSpace display integration and drag label positioning\n   */\n  finalSetup(): void {\n    const challengeEntity = ChallengeEntity.get(this.appObjects);\n    if (challengeEntity && this.labelDropEntity) {\n      challengeEntity.registerChallenge(this.labelDropEntity);\n    }\n\n    // Create Controllers\n    makeMouseLabelDropAuthor(this.appObject);\n    makeTouchLabelDropAuthor(this.appObject);\n\n    if (this.appObjects.hasSingleton(StylusEntity.type)) {\n      makeStylusLabelDrop(this.appObject);\n    }\n  }\n}\n\n/**\n * Factory function to create a new LabelDropFeatureFactory.\n *\n * This function follows the same pattern as the original setupLabelDrop function\n * by taking an AppObjectRepo and creating the \"LabelDrop\" AppObject internally.\n * The factory provides the same functionality as the original setupLabelDrop function\n * but follows the Clean Architecture pattern and can be composed with other factories.\n *\n * @param appObjectRepo The AppObjectRepo to create the LabelDrop AppObject from\n * @returns A new LabelDropFeatureFactory instance\n */\nexport function makeLabelDropFeatureFactory(\n  appObjectRepo: AppObjectRepo,\n): LabelDropFeatureFactory {\n  const appObject = appObjectRepo.getOrCreate(\"LabelDrop\");\n  return new LabelDropFeatureFactory(appObject);\n}\n"]}
+{"version":3,"file":"LabelDropFeatureFactory.js","sourceRoot":"","sources":["../../../../src/LabelDrop/Factories/LabelDropFeatureFactory.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  DomainFactory,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  Quaternion,\r\n  Vector3,\r\n} from \"@vived/core\";\r\nimport { StylusEntity } from \"../../Stylus\";\r\nimport { makeTransform3DPM } from \"../../Transform3D\";\r\nimport { ZSpaceEntity } from \"../../zSpace\";\r\nimport {\r\n  makeMouseLabelDropAuthor,\r\n  makeStylusLabelDrop,\r\n  makeTouchLabelDropAuthor,\r\n} from \"../Controller\";\r\nimport { makeLabelDropRepo } from \"../Entities\";\r\nimport {\r\n  makeLabelDropDragItemPM,\r\n  makeLabelDropEditingIDPM,\r\n  makeLabelDropListPM,\r\n  makeLabelDropReviewPM,\r\n  makeRemainingLabelDropListPM,\r\n} from \"../PM\";\r\nimport {\r\n  ClearEditingLabelDropUCHook,\r\n  makeDeleteAllLabelDropUC,\r\n  makeDeleteLabelDropUC,\r\n  makeDragLabelDropUC,\r\n  makeDragLabelDropWorldUC,\r\n  makeEditLabelDropUC,\r\n  makeLabelDropCorrectAnimationUC,\r\n  makeLabelDropIncorrectAnimationUC,\r\n  makeLabelDropOnNothingAnimationUC,\r\n  makeSubmitLabelDropResultUC,\r\n  makeToggleLabelDropTargetUC,\r\n  makeValidateLabelDrop,\r\n  SerializeLabelDrop,\r\n} from \"../UseCases\";\r\nimport { makeLabelDropItemFactory } from \"./labelDropItemFactory\";\r\nimport { LabelDropRepo } from \"../Entities\";\r\nimport { ChallengeEntity } from \"../../Challenge\";\r\n\r\n/**\r\n * Factory responsible for setting up the LabelDrop Feature domain components.\r\n *\r\n * This factory initializes all entities, use cases, presentation models, and controllers\r\n * required for the LabelDrop Feature functionality. It follows the domain-driven\r\n * design pattern by organizing components into their respective layers. This factory\r\n * replaces the complex setupLabelDrop function while maintaining backwards compatibility.\r\n *\r\n * The factory creates and configures:\r\n * - 1 LabelDropRepo entity with labelDropItemFactory configuration\r\n * - 12 Use Cases for label drop operations including serialization, editing, dragging, and validation\r\n * - 6 Presentation Models for UI state management and data presentation\r\n * - 3 Controllers for mouse, touch, and stylus interactions\r\n * - External dependency management for StylusEntity and ZSpaceEntity\r\n * - Transform hierarchy setup with proper positioning and scaling\r\n *\r\n * @extends DomainFactory\r\n */\r\nexport class LabelDropFeatureFactory extends DomainFactory {\r\n  factoryName = \"LabelDropFeatureFactory\";\r\n\r\n  private labelDropEntity: LabelDropRepo | null = null;\r\n\r\n  /**\r\n   * Sets up all entities required for the LabelDrop Feature.\r\n   *\r\n   * Initializes the LabelDropRepo entity and configures it with the\r\n   * labelDropItemFactory for creating individual label drop items.\r\n   * Uses the \"LabelDrop\" AppObject that was passed to the factory constructor.\r\n   */\r\n  setupEntities(): void {\r\n    // Create the main LabelDropRepo entity\r\n    this.labelDropEntity = makeLabelDropRepo(this.appObject);\r\n\r\n    // Configure the entity with the item factory\r\n    this.labelDropEntity.labelDropItemFactory = makeLabelDropItemFactory(\r\n      this.appObject.appObjectRepo,\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the LabelDrop Feature.\r\n   *\r\n   * Initializes all 12 use cases that define the business operations and\r\n   * workflows available in the label drop feature. The use cases are created\r\n   * in the same order as the original setupLabelDrop function to maintain\r\n   * functional equivalence.\r\n   *\r\n   * Use Cases created:\r\n   * - SerializeLabelDrop: Handles serialization of label drop data\r\n   * - ClearEditingLabelDropUCHook: Manages clearing editing state\r\n   * - EditLabelDropUC: Handles label drop editing operations\r\n   * - DragLabelDropUC: Manages label drop dragging in screen space\r\n   * - DragLabelDropWorldUC: Manages label drop dragging in world space\r\n   * - DeleteLabelDropUC: Handles individual label drop deletion\r\n   * - DeleteAllLabelDropUC: Handles deletion of all label drops\r\n   * - ToggleLabelDropTargetUC: Manages target toggle operations\r\n   * - LabelDropCorrectAnimationUC: Handles correct drop animations\r\n   * - LabelDropOnNothingAnimationUC: Handles drop-on-nothing animations\r\n   * - LabelDropIncorrectAnimationUC: Handles incorrect drop animations\r\n   * - ValidateLabelDrop: Handles label drop validation logic\r\n   */\r\n  setupUCs(): void {\r\n    // Create all Use Cases in the same order as original\r\n    new SerializeLabelDrop(this.appObject);\r\n    new ClearEditingLabelDropUCHook(this.appObject);\r\n    makeEditLabelDropUC(this.appObject);\r\n    makeDragLabelDropUC(this.appObject);\r\n    makeDragLabelDropWorldUC(this.appObject);\r\n    makeDeleteLabelDropUC(this.appObject);\r\n    makeDeleteAllLabelDropUC(this.appObject);\r\n    makeToggleLabelDropTargetUC(this.appObject);\r\n    makeLabelDropCorrectAnimationUC(this.appObject);\r\n    makeLabelDropOnNothingAnimationUC(this.appObject);\r\n    makeLabelDropIncorrectAnimationUC(this.appObject);\r\n    makeValidateLabelDrop(this.appObject);\r\n    makeSubmitLabelDropResultUC(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation models for the LabelDrop Feature.\r\n   *\r\n   * Initializes all 6 presentation models that handle the view logic and\r\n   * state management for UI components related to the label drop feature.\r\n   * These PMs manage the reactive data flow between the domain layer and UI.\r\n   *\r\n   * Presentation Models created:\r\n   * - LabelDropEditingIDPM: Manages the currently editing label drop ID\r\n   * - RemainingLabelDropListPM: Tracks remaining label drops to be placed\r\n   * - LabelDropReviewPM: Handles review mode presentation logic\r\n   * - Transform3DPM: Manages 3D transform presentation for the feature\r\n   * - LabelDropDragItemPM: Handles drag item presentation state\r\n   * - LabelDropListPM: Manages the overall list of label drops\r\n   */\r\n  setupPMs(): void {\r\n    // Create all Presentation Models in the same order as original\r\n    makeLabelDropEditingIDPM(this.appObject);\r\n    makeRemainingLabelDropListPM(this.appObject);\r\n    makeLabelDropReviewPM(this.appObject);\r\n    makeTransform3DPM(this.appObject);\r\n    makeLabelDropDragItemPM(this.appObject);\r\n    makeLabelDropListPM(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Performs final setup operations after all components are initialized.\r\n   *\r\n   * This method handles:\r\n   * - Creation of the 3 Controllers (Mouse, Touch, Stylus)\r\n   * - External dependency resolution and configuration\r\n   * - Transform hierarchy setup for drag operations\r\n   * - Error handling for missing dependencies\r\n   *\r\n   * Controllers created:\r\n   * - MouseLabelDropAuthor: Handles mouse-based label drop interactions\r\n   * - TouchLabelDropAuthor: Handles touch-based label drop interactions\r\n   * - StylusLabelDrop: Handles stylus-based label drop interactions\r\n   *\r\n   * External dependencies:\r\n   * - StylusEntity: Required for stylus-based interactions and drag helper positioning\r\n   * - ZSpaceEntity: Required for zSpace display integration and drag label positioning\r\n   */\r\n  finalSetup(): void {\r\n    const challengeEntity = ChallengeEntity.get(this.appObjects);\r\n    if (challengeEntity && this.labelDropEntity) {\r\n      challengeEntity.registerChallenge(this.labelDropEntity);\r\n    }\r\n\r\n    // Create Controllers\r\n    makeMouseLabelDropAuthor(this.appObject);\r\n    makeTouchLabelDropAuthor(this.appObject);\r\n\r\n    if (this.appObjects.hasSingleton(StylusEntity.type)) {\r\n      makeStylusLabelDrop(this.appObject);\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new LabelDropFeatureFactory.\r\n *\r\n * This function follows the same pattern as the original setupLabelDrop function\r\n * by taking an AppObjectRepo and creating the \"LabelDrop\" AppObject internally.\r\n * The factory provides the same functionality as the original setupLabelDrop function\r\n * but follows the Clean Architecture pattern and can be composed with other factories.\r\n *\r\n * @param appObjectRepo The AppObjectRepo to create the LabelDrop AppObject from\r\n * @returns A new LabelDropFeatureFactory instance\r\n */\r\nexport function makeLabelDropFeatureFactory(\r\n  appObjectRepo: AppObjectRepo,\r\n): LabelDropFeatureFactory {\r\n  const appObject = appObjectRepo.getOrCreate(\"LabelDrop\");\r\n  return new LabelDropFeatureFactory(appObject);\r\n}\r\n"]}

package/dist/cjs/LabelDrop/UseCases/SubmitLabelDropResultUC.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubmitLabelDropResultUC = void 0;
+exports.makeSubmitLabelDropResultUC = makeSubmitLabelDropResultUC;
+const core_1 = require("@vived/core");
+const BaseApp_1 = require("../../BaseApp");
+const Challenge_1 = require("../../Challenge");
+const Dispatcher_1 = require("../../Dispatcher");
+const Entities_1 = require("../Entities");
+/**
+ * Submits a Label Drop challenge result to the Host as a MULTIHIT result.
+ *
+ * Mirrors the other challenge submitters (TrySubmitObjectPickUC, SubmitQuestionAnswerUC):
+ * consumption-mode only, and only while Label Drop is the selected challenge. It observes
+ * every Label Drop submission and reports the running tally, so a partial attempt is scored
+ * on slide exit (the Host's MULTIHIT best-hits rule keeps the strongest result). See
+ * docs/prd/label-drop-result.md.
+ *
+ * Tally: hits = items answered correctly; unanswered = items not yet correct
+ * (getRemainingLabelDrops); misses = total tries - hits (each hit's final try is the one
+ * correct drop, so every other object-drop was wrong); description = the slide's text.
+ */
+class SubmitLabelDropResultUC extends core_1.AppObjectUC {
+    static get(appObjects) {
+        return (0, core_1.getSingletonComponent)(SubmitLabelDropResultUC.type, appObjects);
+    }
+}
+exports.SubmitLabelDropResultUC = SubmitLabelDropResultUC;
+SubmitLabelDropResultUC.type = "SubmitLabelDropResultUC";
+function makeSubmitLabelDropResultUC(appObject) {
+    return new SubmitLabelDropResultUCImp(appObject);
+}
+class SubmitLabelDropResultUCImp extends SubmitLabelDropResultUC {
+    get repo() {
+        return this.getCachedSingleton(Entities_1.LabelDropRepo.type);
+    }
+    get baseApp() {
+        return this.getCachedSingleton(BaseApp_1.BaseAppState.type);
+    }
+    get challenge() {
+        return this.getCachedSingleton(Challenge_1.ChallengeEntity.type);
+    }
+    constructor(appObject) {
+        super(appObject, SubmitLabelDropResultUC.type);
+        this.onSubmission = () => {
+            this.submitResult();
+        };
+        this.submitResult = () => {
+            const repo = this.repo;
+            const baseApp = this.baseApp;
+            const challenge = this.challenge;
+            if (!repo || !baseApp || !challenge)
+                return;
+            if (baseApp.isAuthoring)
+                return;
+            if (challenge.selectedChallenge !== "LABEL_DROP")
+                return;
+            const items = repo.getAll();
+            const hits = items.filter((item) => item.answeredCorrectly === true).length;
+            const unanswered = repo.getRemainingLabelDrops().length;
+            const totalTries = items.reduce((sum, item) => sum + item.tries, 0);
+            const misses = totalTries - hits;
+            (0, Dispatcher_1.submitMultiHitResult)({
+                hits,
+                misses,
+                unanswered,
+                description: baseApp.slideText,
+            }, this.appObjects);
+        };
+        this.appObjects.registerSingleton(this);
+        const repo = Entities_1.LabelDropRepo.get(this.appObjects);
+        if (repo) {
+            repo.addLabelDropSubmissionObserver(this.onSubmission);
+        }
+        else {
+            this.warn("SubmitLabelDropResultUC has been set up without a LabelDropRepo to observe");
+        }
+    }
+}
+//# sourceMappingURL=SubmitLabelDropResultUC.js.map

package/dist/cjs/LabelDrop/UseCases/SubmitLabelDropResultUC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubmitLabelDropResultUC.js","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/SubmitLabelDropResultUC.ts"],"names":[],"mappings":";;;AAqCA,kEAIC;AAzCD,sCAKqB;AACrB,2CAA6C;AAC7C,+CAAkD;AAClD,iDAAwD;AACxD,0CAA4C;AAE5C;;;;;;;;;;;;GAYG;AACH,MAAsB,uBAAwB,SAAQ,kBAAW;IAK/D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAC1B,uBAAuB,CAAC,IAAI,EAC5B,UAAU,CACX,CAAC;IACJ,CAAC;;AAVH,0DAWC;AAViB,4BAAI,GAAG,yBAAyB,CAAC;AAYnD,SAAgB,2BAA2B,CACzC,SAAoB;IAEpB,OAAO,IAAI,0BAA0B,CAAC,SAAS,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,0BAA2B,SAAQ,uBAAuB;IAC9D,IAAY,IAAI;QACd,OAAO,IAAI,CAAC,kBAAkB,CAAgB,wBAAa,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAe,sBAAY,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAkB,2BAAe,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IAkCD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAjCzC,iBAAY,GAAG,GAAS,EAAE;YAChC,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC,CAAC;QAEF,iBAAY,GAAG,GAAS,EAAE;YACxB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACvB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS;gBAAE,OAAO;YAE5C,IAAI,OAAO,CAAC,WAAW;gBAAE,OAAO;YAChC,IAAI,SAAS,CAAC,iBAAiB,KAAK,YAAY;gBAAE,OAAO;YAEzD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CACvB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,KAAK,IAAI,CAC1C,CAAC,MAAM,CAAC;YACT,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC,MAAM,CAAC;YACxD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;YAEjC,IAAA,iCAAoB,EAClB;gBACE,IAAI;gBACJ,MAAM;gBACN,UAAU;gBACV,WAAW,EAAE,OAAO,CAAC,SAAS;aAC/B,EACD,IAAI,CAAC,UAAU,CAChB,CAAC;QACJ,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,MAAM,IAAI,GAAG,wBAAa,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CACP,4EAA4E,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;CACF","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC,\r\n  getSingletonComponent,\r\n} from \"@vived/core\";\r\nimport { BaseAppState } from \"../../BaseApp\";\r\nimport { ChallengeEntity } from \"../../Challenge\";\r\nimport { submitMultiHitResult } from \"../../Dispatcher\";\r\nimport { LabelDropRepo } from \"../Entities\";\r\n\r\n/**\r\n * Submits a Label Drop challenge result to the Host as a MULTIHIT result.\r\n *\r\n * Mirrors the other challenge submitters (TrySubmitObjectPickUC, SubmitQuestionAnswerUC):\r\n * consumption-mode only, and only while Label Drop is the selected challenge. It observes\r\n * every Label Drop submission and reports the running tally, so a partial attempt is scored\r\n * on slide exit (the Host's MULTIHIT best-hits rule keeps the strongest result). See\r\n * docs/prd/label-drop-result.md.\r\n *\r\n * Tally: hits = items answered correctly; unanswered = items not yet correct\r\n * (getRemainingLabelDrops); misses = total tries - hits (each hit's final try is the one\r\n * correct drop, so every other object-drop was wrong); description = the slide's text.\r\n */\r\nexport abstract class SubmitLabelDropResultUC extends AppObjectUC {\r\n  static readonly type = \"SubmitLabelDropResultUC\";\r\n\r\n  abstract submitResult(): void;\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<SubmitLabelDropResultUC>(\r\n      SubmitLabelDropResultUC.type,\r\n      appObjects,\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeSubmitLabelDropResultUC(\r\n  appObject: AppObject,\r\n): SubmitLabelDropResultUC {\r\n  return new SubmitLabelDropResultUCImp(appObject);\r\n}\r\n\r\nclass SubmitLabelDropResultUCImp extends SubmitLabelDropResultUC {\r\n  private get repo() {\r\n    return this.getCachedSingleton<LabelDropRepo>(LabelDropRepo.type);\r\n  }\r\n\r\n  private get baseApp() {\r\n    return this.getCachedSingleton<BaseAppState>(BaseAppState.type);\r\n  }\r\n\r\n  private get challenge() {\r\n    return this.getCachedSingleton<ChallengeEntity>(ChallengeEntity.type);\r\n  }\r\n\r\n  private onSubmission = (): void => {\r\n    this.submitResult();\r\n  };\r\n\r\n  submitResult = (): void => {\r\n    const repo = this.repo;\r\n    const baseApp = this.baseApp;\r\n    const challenge = this.challenge;\r\n    if (!repo || !baseApp || !challenge) return;\r\n\r\n    if (baseApp.isAuthoring) return;\r\n    if (challenge.selectedChallenge !== \"LABEL_DROP\") return;\r\n\r\n    const items = repo.getAll();\r\n    const hits = items.filter(\r\n      (item) => item.answeredCorrectly === true,\r\n    ).length;\r\n    const unanswered = repo.getRemainingLabelDrops().length;\r\n    const totalTries = items.reduce((sum, item) => sum + item.tries, 0);\r\n    const misses = totalTries - hits;\r\n\r\n    submitMultiHitResult(\r\n      {\r\n        hits,\r\n        misses,\r\n        unanswered,\r\n        description: baseApp.slideText,\r\n      },\r\n      this.appObjects,\r\n    );\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, SubmitLabelDropResultUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    const repo = LabelDropRepo.get(this.appObjects);\r\n    if (repo) {\r\n      repo.addLabelDropSubmissionObserver(this.onSubmission);\r\n    } else {\r\n      this.warn(\r\n        \"SubmitLabelDropResultUC has been set up without a LabelDropRepo to observe\",\r\n      );\r\n    }\r\n  }\r\n}\r\n"]}

package/dist/cjs/LabelDrop/UseCases/SubmitLabelDropResultUC.test.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@vived/core");
+const BaseAppState_1 = require("../../BaseApp/Entity/BaseAppState");
+const Challenge_1 = require("../../Challenge");
+const Dispatcher_1 = require("../../Dispatcher");
+const Entities_1 = require("../Entities");
+const LabelDropFeatureFactory_1 = require("../Factories/LabelDropFeatureFactory");
+const SubmitLabelDropResultUC_1 = require("./SubmitLabelDropResultUC");
+describe("SubmitLabelDropResultUC", () => {
+    it("Registers as the singleton", () => {
+        const appObjects = (0, core_1.makeAppObjectRepo)();
+        (0, Entities_1.makeLabelDropRepo)(appObjects.getOrCreate("LabelDrop"));
+        const uc = (0, SubmitLabelDropResultUC_1.makeSubmitLabelDropResultUC)(appObjects.getOrCreate("LabelDrop"));
+        expect(SubmitLabelDropResultUC_1.SubmitLabelDropResultUC.get(appObjects)).toBe(uc);
+    });
+    // Wiring / lifecycle: prove the real LabelDropFeatureFactory constructs the UC and hooks
+    // the drop observer. Uses the repo's factory-test idiom (drive the phases directly) rather
+    // than a full setupDomain — finalSetup wires pointer controllers that pull in the input /
+    // framework cluster, which is irrelevant to this UC's wiring.
+    it("is wired by LabelDropFeatureFactory.setupUCs so a drop reports a result to the Host", () => {
+        const appObjects = (0, core_1.makeAppObjectRepo)();
+        // Boundary singletons the feature's UCs read at construction time.
+        const baseApp = (0, BaseAppState_1.makeBaseAppState)(appObjects.getOrCreate("App"));
+        baseApp.isAuthoring = false;
+        baseApp.slideText = "Slide text";
+        const challenge = (0, Challenge_1.makeChallengeEntityMock)(appObjects);
+        challenge.selectedChallenge = "LABEL_DROP";
+        const mockSubmitResult = (0, Dispatcher_1.makeMockSubmitResult)(appObjects);
+        mockSubmitResult.submitMultiHitResult = jest.fn();
+        const factory = (0, LabelDropFeatureFactory_1.makeLabelDropFeatureFactory)(appObjects);
+        factory.setupEntities(); // creates LabelDropRepo
+        factory.setupUCs(); // creates SubmitLabelDropResultUC, which subscribes to the repo
+        const repo = Entities_1.LabelDropRepo.get(appObjects);
+        const item = repo.makeLabelDropItem("a");
+        item.targetIds = ["objA"];
+        repo.submitLabelDrop("a", "objA");
+        expect(mockSubmitResult.submitMultiHitResult).toHaveBeenCalledWith({
+            hits: 1,
+            misses: 0,
+            unanswered: 0,
+            description: "Slide text",
+        });
+    });
+});
+//# sourceMappingURL=SubmitLabelDropResultUC.test.js.map

package/dist/cjs/LabelDrop/UseCases/SubmitLabelDropResultUC.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubmitLabelDropResultUC.test.js","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/SubmitLabelDropResultUC.test.ts"],"names":[],"mappings":";;AAAA,sCAAgD;AAChD,oEAAqE;AACrE,+CAA0D;AAC1D,iDAAwD;AACxD,0CAA+D;AAC/D,kFAAmF;AACnF,uEAGmC;AAEnC,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,UAAU,GAAG,IAAA,wBAAiB,GAAE,CAAC;QACvC,IAAA,4BAAiB,EAAC,UAAU,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;QACvD,MAAM,EAAE,GAAG,IAAA,qDAA2B,EAAC,UAAU,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;QAE5E,MAAM,CAAC,iDAAuB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,yFAAyF;IACzF,2FAA2F;IAC3F,0FAA0F;IAC1F,8DAA8D;IAC9D,EAAE,CAAC,qFAAqF,EAAE,GAAG,EAAE;QAC7F,MAAM,UAAU,GAAG,IAAA,wBAAiB,GAAE,CAAC;QAEvC,mEAAmE;QACnE,MAAM,OAAO,GAAG,IAAA,+BAAgB,EAAC,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC;QAC5B,OAAO,CAAC,SAAS,GAAG,YAAY,CAAC;QAEjC,MAAM,SAAS,GAAG,IAAA,mCAAuB,EAAC,UAAU,CAAC,CAAC;QACtD,SAAS,CAAC,iBAAiB,GAAG,YAAY,CAAC;QAE3C,MAAM,gBAAgB,GAAG,IAAA,iCAAoB,EAAC,UAAU,CAAC,CAAC;QAC1D,gBAAgB,CAAC,oBAAoB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAElD,MAAM,OAAO,GAAG,IAAA,qDAA2B,EAAC,UAAU,CAAC,CAAC;QACxD,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,wBAAwB;QACjD,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,gEAAgE;QAEpF,MAAM,IAAI,GAAG,wBAAa,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC;QAE1B,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAElC,MAAM,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,oBAAoB,CAAC;YACjE,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;YACT,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,YAAY;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { makeAppObjectRepo } from \"@vived/core\";\r\nimport { makeBaseAppState } from \"../../BaseApp/Entity/BaseAppState\";\r\nimport { makeChallengeEntityMock } from \"../../Challenge\";\r\nimport { makeMockSubmitResult } from \"../../Dispatcher\";\r\nimport { LabelDropRepo, makeLabelDropRepo } from \"../Entities\";\r\nimport { makeLabelDropFeatureFactory } from \"../Factories/LabelDropFeatureFactory\";\r\nimport {\r\n  makeSubmitLabelDropResultUC,\r\n  SubmitLabelDropResultUC,\r\n} from \"./SubmitLabelDropResultUC\";\r\n\r\ndescribe(\"SubmitLabelDropResultUC\", () => {\r\n  it(\"Registers as the singleton\", () => {\r\n    const appObjects = makeAppObjectRepo();\r\n    makeLabelDropRepo(appObjects.getOrCreate(\"LabelDrop\"));\r\n    const uc = makeSubmitLabelDropResultUC(appObjects.getOrCreate(\"LabelDrop\"));\r\n\r\n    expect(SubmitLabelDropResultUC.get(appObjects)).toBe(uc);\r\n  });\r\n\r\n  // Wiring / lifecycle: prove the real LabelDropFeatureFactory constructs the UC and hooks\r\n  // the drop observer. Uses the repo's factory-test idiom (drive the phases directly) rather\r\n  // than a full setupDomain — finalSetup wires pointer controllers that pull in the input /\r\n  // framework cluster, which is irrelevant to this UC's wiring.\r\n  it(\"is wired by LabelDropFeatureFactory.setupUCs so a drop reports a result to the Host\", () => {\r\n    const appObjects = makeAppObjectRepo();\r\n\r\n    // Boundary singletons the feature's UCs read at construction time.\r\n    const baseApp = makeBaseAppState(appObjects.getOrCreate(\"App\"));\r\n    baseApp.isAuthoring = false;\r\n    baseApp.slideText = \"Slide text\";\r\n\r\n    const challenge = makeChallengeEntityMock(appObjects);\r\n    challenge.selectedChallenge = \"LABEL_DROP\";\r\n\r\n    const mockSubmitResult = makeMockSubmitResult(appObjects);\r\n    mockSubmitResult.submitMultiHitResult = jest.fn();\r\n\r\n    const factory = makeLabelDropFeatureFactory(appObjects);\r\n    factory.setupEntities(); // creates LabelDropRepo\r\n    factory.setupUCs(); // creates SubmitLabelDropResultUC, which subscribes to the repo\r\n\r\n    const repo = LabelDropRepo.get(appObjects)!;\r\n    const item = repo.makeLabelDropItem(\"a\");\r\n    item.targetIds = [\"objA\"];\r\n\r\n    repo.submitLabelDrop(\"a\", \"objA\");\r\n\r\n    expect(mockSubmitResult.submitMultiHitResult).toHaveBeenCalledWith({\r\n      hits: 1,\r\n      misses: 0,\r\n      unanswered: 0,\r\n      description: \"Slide text\",\r\n    });\r\n  });\r\n});\r\n"]}

package/dist/cjs/LabelDrop/UseCases/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./IncorrectAnimationUC"), exports);
 __exportStar(require("./InitializeLabelDropLabelHook"), exports);
 __exportStar(require("./LabelDropAnimation"), exports);
 __exportStar(require("./SerializeLabelDrop"), exports);
+__exportStar(require("./SubmitLabelDropResultUC"), exports);
 __exportStar(require("./ToggleLabelDropTargetUC"), exports);
 __exportStar(require("./ValidateLabelDrop"), exports);
 __exportStar(require("./labelDropLabelValidator"), exports);

package/dist/cjs/LabelDrop/UseCases/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,uDAAqC;AACrC,yDAAuC;AACvC,sDAAoC;AACpC,oDAAkC;AAClC,yDAAuC;AACvC,6DAA2C;AAC3C,oDAAkC;AAClC,yDAAuC;AACvC,iEAA+C;AAC/C,uDAAqC;AACrC,uDAAqC;AACrC,4DAA0C;AAC1C,sDAAoC;AACpC,4DAA0C","sourcesContent":["export * from \"./ClearEditingLabelDropUCHook\";\nexport * from \"./CorrectAnimationUC\";\nexport * from \"./DeleteAllLabelDropUC\";\nexport * from \"./DeleteLabelDropUC\";\nexport * from \"./DragLabelDropUC\";\nexport * from \"./DragLabelDropWorldUC\";\nexport * from \"./DropOnNothingAnimationUC\";\nexport * from \"./EditLabelDropUC\";\nexport * from \"./IncorrectAnimationUC\";\nexport * from \"./InitializeLabelDropLabelHook\";\nexport * from \"./LabelDropAnimation\";\nexport * from \"./SerializeLabelDrop\";\nexport * from \"./ToggleLabelDropTargetUC\";\nexport * from \"./ValidateLabelDrop\";\nexport * from \"./labelDropLabelValidator\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,uDAAqC;AACrC,yDAAuC;AACvC,sDAAoC;AACpC,oDAAkC;AAClC,yDAAuC;AACvC,6DAA2C;AAC3C,oDAAkC;AAClC,yDAAuC;AACvC,iEAA+C;AAC/C,uDAAqC;AACrC,uDAAqC;AACrC,4DAA0C;AAC1C,4DAA0C;AAC1C,sDAAoC;AACpC,4DAA0C","sourcesContent":["export * from \"./ClearEditingLabelDropUCHook\";\r\nexport * from \"./CorrectAnimationUC\";\r\nexport * from \"./DeleteAllLabelDropUC\";\r\nexport * from \"./DeleteLabelDropUC\";\r\nexport * from \"./DragLabelDropUC\";\r\nexport * from \"./DragLabelDropWorldUC\";\r\nexport * from \"./DropOnNothingAnimationUC\";\r\nexport * from \"./EditLabelDropUC\";\r\nexport * from \"./IncorrectAnimationUC\";\r\nexport * from \"./InitializeLabelDropLabelHook\";\r\nexport * from \"./LabelDropAnimation\";\r\nexport * from \"./SerializeLabelDrop\";\r\nexport * from \"./SubmitLabelDropResultUC\";\r\nexport * from \"./ToggleLabelDropTargetUC\";\r\nexport * from \"./ValidateLabelDrop\";\r\nexport * from \"./labelDropLabelValidator\";\r\n"]}

package/dist/cjs/TestUtils/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./setupFeatureForTesting"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/TestUtils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/TestUtils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC","sourcesContent":["export * from \"./setupFeatureForTesting\";\r\n"]}

package/dist/cjs/TestUtils/setupFeatureForTesting.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * setupFeatureForTesting.ts
+ *
+ * The feature-context test harness for this Feature Library.
+ *
+ * This package has no app-level domain (no `makeDomain`, no single repo), so there is no
+ * global "make the domain" harness. The unit of test context is a **Feature** (or a small
+ * cluster of Features), wired the way a Slide App wires it — through each Feature's
+ * `FeatureFactory` (the current standard), using the same phased orchestration production
+ * uses. See `CLAUDE.md` and `docs/agents/domain.md`.
+ *
+ * Use this for **wiring / lifecycle** tests — proving that a Feature, once really wired,
+ * behaves end-to-end (e.g. a Challenge submits its result when the student leaves the slide).
+ * For pure **logic** tests of a single UC or PM, a hand-wired `makeAppObjectRepo()` rig with
+ * the collaborators mocked at the boundary is lighter and still preferred — see
+ * `src/ObjectPick/UseCases/TrySubmitObjectPickUC.test.ts` as the reference.
+ *
+ * @example
+ *   // LabelDrop's submit path depends on Challenge (for `selectedChallenge`) and the
+ *   // Dispatcher (the Host boundary). List dependencies first, exactly as a Slide App would.
+ *   const { appObjects } = setupFeatureForTesting([
+ *     makeDispatcherFeatureFactory,
+ *     makeChallengeFeatureFactory,
+ *     makeLabelDropFeatureFactory,
+ *   ]);
+ *   // Then act through a Controller / navigation seam and assert through an Adapter VM or a
+ *   // dispatcher mock registered before setup.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupFeatureForTesting = setupFeatureForTesting;
+const core_1 = require("@vived/core");
+/**
+ * Wire one or more Features into a fresh repo for a feature-context test.
+ *
+ * @param featureFactories The `make<Feature>FeatureFactory` functions to wire, in the order a
+ *   Slide App would compose them — a Feature whose `finalSetup` depends on another Feature's
+ *   entities must be listed *after* that Feature.
+ * @param seed Optional callback run *before* the factories are constructed. Use it to stand up
+ *   the boundary singletons a Feature reads at construction time (many Feature UCs resolve
+ *   siblings via `getCachedSingleton`, which THROWS when absent — e.g. `BaseAppState`,
+ *   `ChallengeEntity`). Seed real entities or their Mocks here instead of pulling every
+ *   dependency Feature's factory into the cluster.
+ * @returns `{ appObjects }` — resolve Controllers and Adapters from it to act and assert.
+ */
+function setupFeatureForTesting(featureFactories, seed) {
+    const appObjects = (0, core_1.makeAppObjectRepo)();
+    // The DomainFactoryRepo must exist before the factories are constructed: each
+    // FeatureFactory auto-registers with it in its constructor.
+    const factoryRepo = (0, core_1.makeDomainFactoryRepo)(appObjects);
+    // Stand up boundary singletons the Features read at construction time.
+    if (seed)
+        seed(appObjects);
+    featureFactories.forEach((makeFactory) => makeFactory(appObjects));
+    // Run the same phased orchestration as production — all setupEntities, then all setupUCs,
+    // then all setupPMs, then all finalSetup — so cross-Feature dependencies resolve correctly.
+    factoryRepo.setupDomain();
+    return { appObjects };
+}
+//# sourceMappingURL=setupFeatureForTesting.js.map

package/dist/cjs/TestUtils/setupFeatureForTesting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupFeatureForTesting.js","sourceRoot":"","sources":["../../../src/TestUtils/setupFeatureForTesting.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;AA2BH,wDAoBC;AA7CD,sCAKqB;AAOrB;;;;;;;;;;;;GAYG;AACH,SAAgB,sBAAsB,CACpC,gBAAkE,EAClE,IAA0C;IAE1C,MAAM,UAAU,GAAG,IAAA,wBAAiB,GAAE,CAAC;IAEvC,8EAA8E;IAC9E,4DAA4D;IAC5D,MAAM,WAAW,GAAG,IAAA,4BAAqB,EAAC,UAAU,CAAC,CAAC;IAEtD,uEAAuE;IACvE,IAAI,IAAI;QAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAE3B,gBAAgB,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnE,0FAA0F;IAC1F,4FAA4F;IAC5F,WAAW,CAAC,WAAW,EAAE,CAAC;IAE1B,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC","sourcesContent":["/**\r\n * setupFeatureForTesting.ts\r\n *\r\n * The feature-context test harness for this Feature Library.\r\n *\r\n * This package has no app-level domain (no `makeDomain`, no single repo), so there is no\r\n * global \"make the domain\" harness. The unit of test context is a **Feature** (or a small\r\n * cluster of Features), wired the way a Slide App wires it — through each Feature's\r\n * `FeatureFactory` (the current standard), using the same phased orchestration production\r\n * uses. See `CLAUDE.md` and `docs/agents/domain.md`.\r\n *\r\n * Use this for **wiring / lifecycle** tests — proving that a Feature, once really wired,\r\n * behaves end-to-end (e.g. a Challenge submits its result when the student leaves the slide).\r\n * For pure **logic** tests of a single UC or PM, a hand-wired `makeAppObjectRepo()` rig with\r\n * the collaborators mocked at the boundary is lighter and still preferred — see\r\n * `src/ObjectPick/UseCases/TrySubmitObjectPickUC.test.ts` as the reference.\r\n *\r\n * @example\r\n *   // LabelDrop's submit path depends on Challenge (for `selectedChallenge`) and the\r\n *   // Dispatcher (the Host boundary). List dependencies first, exactly as a Slide App would.\r\n *   const { appObjects } = setupFeatureForTesting([\r\n *     makeDispatcherFeatureFactory,\r\n *     makeChallengeFeatureFactory,\r\n *     makeLabelDropFeatureFactory,\r\n *   ]);\r\n *   // Then act through a Controller / navigation seam and assert through an Adapter VM or a\r\n *   // dispatcher mock registered before setup.\r\n */\r\n\r\nimport {\r\n  AppObjectRepo,\r\n  DomainFactory,\r\n  makeAppObjectRepo,\r\n  makeDomainFactoryRepo,\r\n} from \"@vived/core\";\r\n\r\nexport interface FeatureTestContext {\r\n  /** The live repo, wired through the given FeatureFactories exactly as production does. */\r\n  appObjects: AppObjectRepo;\r\n}\r\n\r\n/**\r\n * Wire one or more Features into a fresh repo for a feature-context test.\r\n *\r\n * @param featureFactories The `make<Feature>FeatureFactory` functions to wire, in the order a\r\n *   Slide App would compose them — a Feature whose `finalSetup` depends on another Feature's\r\n *   entities must be listed *after* that Feature.\r\n * @param seed Optional callback run *before* the factories are constructed. Use it to stand up\r\n *   the boundary singletons a Feature reads at construction time (many Feature UCs resolve\r\n *   siblings via `getCachedSingleton`, which THROWS when absent — e.g. `BaseAppState`,\r\n *   `ChallengeEntity`). Seed real entities or their Mocks here instead of pulling every\r\n *   dependency Feature's factory into the cluster.\r\n * @returns `{ appObjects }` — resolve Controllers and Adapters from it to act and assert.\r\n */\r\nexport function setupFeatureForTesting(\r\n  featureFactories: ((appObjects: AppObjectRepo) => DomainFactory)[],\r\n  seed?: (appObjects: AppObjectRepo) => void,\r\n): FeatureTestContext {\r\n  const appObjects = makeAppObjectRepo();\r\n\r\n  // The DomainFactoryRepo must exist before the factories are constructed: each\r\n  // FeatureFactory auto-registers with it in its constructor.\r\n  const factoryRepo = makeDomainFactoryRepo(appObjects);\r\n\r\n  // Stand up boundary singletons the Features read at construction time.\r\n  if (seed) seed(appObjects);\r\n\r\n  featureFactories.forEach((makeFactory) => makeFactory(appObjects));\r\n\r\n  // Run the same phased orchestration as production — all setupEntities, then all setupUCs,\r\n  // then all setupPMs, then all finalSetup — so cross-Feature dependencies resolve correctly.\r\n  factoryRepo.setupDomain();\r\n\r\n  return { appObjects };\r\n}\r\n"]}

package/dist/esm/LabelDrop/Factories/LabelDropFeatureFactory.js

@@ -4,7 +4,7 @@ import { makeTransform3DPM } from "../../Transform3D";
 import { makeMouseLabelDropAuthor, makeStylusLabelDrop, makeTouchLabelDropAuthor, } from "../Controller";
 import { makeLabelDropRepo } from "../Entities";
 import { makeLabelDropDragItemPM, makeLabelDropEditingIDPM, makeLabelDropListPM, makeLabelDropReviewPM, makeRemainingLabelDropListPM, } from "../PM";
-import { ClearEditingLabelDropUCHook, makeDeleteAllLabelDropUC, makeDeleteLabelDropUC, makeDragLabelDropUC, makeDragLabelDropWorldUC, makeEditLabelDropUC, makeLabelDropCorrectAnimationUC, makeLabelDropIncorrectAnimationUC, makeLabelDropOnNothingAnimationUC, makeToggleLabelDropTargetUC, makeValidateLabelDrop, SerializeLabelDrop, } from "../UseCases";
+import { ClearEditingLabelDropUCHook, makeDeleteAllLabelDropUC, makeDeleteLabelDropUC, makeDragLabelDropUC, makeDragLabelDropWorldUC, makeEditLabelDropUC, makeLabelDropCorrectAnimationUC, makeLabelDropIncorrectAnimationUC, makeLabelDropOnNothingAnimationUC, makeSubmitLabelDropResultUC, makeToggleLabelDropTargetUC, makeValidateLabelDrop, SerializeLabelDrop, } from "../UseCases";
 import { makeLabelDropItemFactory } from "./labelDropItemFactory";
 import { ChallengeEntity } from "../../Challenge";
 /**
@@ -80,6 +80,7 @@ export class LabelDropFeatureFactory extends DomainFactory {
         makeLabelDropOnNothingAnimationUC(this.appObject);
         makeLabelDropIncorrectAnimationUC(this.appObject);
         makeValidateLabelDrop(this.appObject);
+        makeSubmitLabelDropResultUC(this.appObject);
     }
     /**
      * Sets up all presentation models for the LabelDrop Feature.

package/dist/esm/LabelDrop/Factories/LabelDropFeatureFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"LabelDropFeatureFactory.js","sourceRoot":"","sources":["../../../../src/LabelDrop/Factories/LabelDropFeatureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAKd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,OAAO,CAAC;AACf,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,+BAA+B,EAC/B,iCAAiC,EACjC,iCAAiC,EACjC,2BAA2B,EAC3B,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,uBAAwB,SAAQ,aAAa;IAA1D;;QACE,gBAAW,GAAG,yBAAyB,CAAC;QAEhC,oBAAe,GAAyB,IAAI,CAAC;IAkHvD,CAAC;IAhHC;;;;;;OAMG;IACH,aAAa;QACX,uCAAuC;QACvC,IAAI,CAAC,eAAe,GAAG,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEzD,6CAA6C;QAC7C,IAAI,CAAC,eAAe,CAAC,oBAAoB,GAAG,wBAAwB,CAClE,IAAI,CAAC,SAAS,CAAC,aAAa,CAC7B,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ;QACN,qDAAqD;QACrD,IAAI,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,2BAA2B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,2BAA2B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,+BAA+B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,iCAAiC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,iCAAiC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,QAAQ;QACN,+DAA+D;QAC/D,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7C,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU;QACR,MAAM,eAAe,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,eAAe,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1D,CAAC;QAED,qBAAqB;QACrB,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEzC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,2BAA2B,CACzC,aAA4B;IAE5B,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IACzD,OAAO,IAAI,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC","sourcesContent":["import {\n  DomainFactory,\n  AppObject,\n  AppObjectRepo,\n  Quaternion,\n  Vector3,\n} from \"@vived/core\";\nimport { StylusEntity } from \"../../Stylus\";\nimport { makeTransform3DPM } from \"../../Transform3D\";\nimport { ZSpaceEntity } from \"../../zSpace\";\nimport {\n  makeMouseLabelDropAuthor,\n  makeStylusLabelDrop,\n  makeTouchLabelDropAuthor,\n} from \"../Controller\";\nimport { makeLabelDropRepo } from \"../Entities\";\nimport {\n  makeLabelDropDragItemPM,\n  makeLabelDropEditingIDPM,\n  makeLabelDropListPM,\n  makeLabelDropReviewPM,\n  makeRemainingLabelDropListPM,\n} from \"../PM\";\nimport {\n  ClearEditingLabelDropUCHook,\n  makeDeleteAllLabelDropUC,\n  makeDeleteLabelDropUC,\n  makeDragLabelDropUC,\n  makeDragLabelDropWorldUC,\n  makeEditLabelDropUC,\n  makeLabelDropCorrectAnimationUC,\n  makeLabelDropIncorrectAnimationUC,\n  makeLabelDropOnNothingAnimationUC,\n  makeToggleLabelDropTargetUC,\n  makeValidateLabelDrop,\n  SerializeLabelDrop,\n} from \"../UseCases\";\nimport { makeLabelDropItemFactory } from \"./labelDropItemFactory\";\nimport { LabelDropRepo } from \"../Entities\";\nimport { ChallengeEntity } from \"../../Challenge\";\n\n/**\n * Factory responsible for setting up the LabelDrop Feature domain components.\n *\n * This factory initializes all entities, use cases, presentation models, and controllers\n * required for the LabelDrop Feature functionality. It follows the domain-driven\n * design pattern by organizing components into their respective layers. This factory\n * replaces the complex setupLabelDrop function while maintaining backwards compatibility.\n *\n * The factory creates and configures:\n * - 1 LabelDropRepo entity with labelDropItemFactory configuration\n * - 12 Use Cases for label drop operations including serialization, editing, dragging, and validation\n * - 6 Presentation Models for UI state management and data presentation\n * - 3 Controllers for mouse, touch, and stylus interactions\n * - External dependency management for StylusEntity and ZSpaceEntity\n * - Transform hierarchy setup with proper positioning and scaling\n *\n * @extends DomainFactory\n */\nexport class LabelDropFeatureFactory extends DomainFactory {\n  factoryName = \"LabelDropFeatureFactory\";\n\n  private labelDropEntity: LabelDropRepo | null = null;\n\n  /**\n   * Sets up all entities required for the LabelDrop Feature.\n   *\n   * Initializes the LabelDropRepo entity and configures it with the\n   * labelDropItemFactory for creating individual label drop items.\n   * Uses the \"LabelDrop\" AppObject that was passed to the factory constructor.\n   */\n  setupEntities(): void {\n    // Create the main LabelDropRepo entity\n    this.labelDropEntity = makeLabelDropRepo(this.appObject);\n\n    // Configure the entity with the item factory\n    this.labelDropEntity.labelDropItemFactory = makeLabelDropItemFactory(\n      this.appObject.appObjectRepo,\n    );\n  }\n\n  /**\n   * Sets up all use cases for the LabelDrop Feature.\n   *\n   * Initializes all 12 use cases that define the business operations and\n   * workflows available in the label drop feature. The use cases are created\n   * in the same order as the original setupLabelDrop function to maintain\n   * functional equivalence.\n   *\n   * Use Cases created:\n   * - SerializeLabelDrop: Handles serialization of label drop data\n   * - ClearEditingLabelDropUCHook: Manages clearing editing state\n   * - EditLabelDropUC: Handles label drop editing operations\n   * - DragLabelDropUC: Manages label drop dragging in screen space\n   * - DragLabelDropWorldUC: Manages label drop dragging in world space\n   * - DeleteLabelDropUC: Handles individual label drop deletion\n   * - DeleteAllLabelDropUC: Handles deletion of all label drops\n   * - ToggleLabelDropTargetUC: Manages target toggle operations\n   * - LabelDropCorrectAnimationUC: Handles correct drop animations\n   * - LabelDropOnNothingAnimationUC: Handles drop-on-nothing animations\n   * - LabelDropIncorrectAnimationUC: Handles incorrect drop animations\n   * - ValidateLabelDrop: Handles label drop validation logic\n   */\n  setupUCs(): void {\n    // Create all Use Cases in the same order as original\n    new SerializeLabelDrop(this.appObject);\n    new ClearEditingLabelDropUCHook(this.appObject);\n    makeEditLabelDropUC(this.appObject);\n    makeDragLabelDropUC(this.appObject);\n    makeDragLabelDropWorldUC(this.appObject);\n    makeDeleteLabelDropUC(this.appObject);\n    makeDeleteAllLabelDropUC(this.appObject);\n    makeToggleLabelDropTargetUC(this.appObject);\n    makeLabelDropCorrectAnimationUC(this.appObject);\n    makeLabelDropOnNothingAnimationUC(this.appObject);\n    makeLabelDropIncorrectAnimationUC(this.appObject);\n    makeValidateLabelDrop(this.appObject);\n  }\n\n  /**\n   * Sets up all presentation models for the LabelDrop Feature.\n   *\n   * Initializes all 6 presentation models that handle the view logic and\n   * state management for UI components related to the label drop feature.\n   * These PMs manage the reactive data flow between the domain layer and UI.\n   *\n   * Presentation Models created:\n   * - LabelDropEditingIDPM: Manages the currently editing label drop ID\n   * - RemainingLabelDropListPM: Tracks remaining label drops to be placed\n   * - LabelDropReviewPM: Handles review mode presentation logic\n   * - Transform3DPM: Manages 3D transform presentation for the feature\n   * - LabelDropDragItemPM: Handles drag item presentation state\n   * - LabelDropListPM: Manages the overall list of label drops\n   */\n  setupPMs(): void {\n    // Create all Presentation Models in the same order as original\n    makeLabelDropEditingIDPM(this.appObject);\n    makeRemainingLabelDropListPM(this.appObject);\n    makeLabelDropReviewPM(this.appObject);\n    makeTransform3DPM(this.appObject);\n    makeLabelDropDragItemPM(this.appObject);\n    makeLabelDropListPM(this.appObject);\n  }\n\n  /**\n   * Performs final setup operations after all components are initialized.\n   *\n   * This method handles:\n   * - Creation of the 3 Controllers (Mouse, Touch, Stylus)\n   * - External dependency resolution and configuration\n   * - Transform hierarchy setup for drag operations\n   * - Error handling for missing dependencies\n   *\n   * Controllers created:\n   * - MouseLabelDropAuthor: Handles mouse-based label drop interactions\n   * - TouchLabelDropAuthor: Handles touch-based label drop interactions\n   * - StylusLabelDrop: Handles stylus-based label drop interactions\n   *\n   * External dependencies:\n   * - StylusEntity: Required for stylus-based interactions and drag helper positioning\n   * - ZSpaceEntity: Required for zSpace display integration and drag label positioning\n   */\n  finalSetup(): void {\n    const challengeEntity = ChallengeEntity.get(this.appObjects);\n    if (challengeEntity && this.labelDropEntity) {\n      challengeEntity.registerChallenge(this.labelDropEntity);\n    }\n\n    // Create Controllers\n    makeMouseLabelDropAuthor(this.appObject);\n    makeTouchLabelDropAuthor(this.appObject);\n\n    if (this.appObjects.hasSingleton(StylusEntity.type)) {\n      makeStylusLabelDrop(this.appObject);\n    }\n  }\n}\n\n/**\n * Factory function to create a new LabelDropFeatureFactory.\n *\n * This function follows the same pattern as the original setupLabelDrop function\n * by taking an AppObjectRepo and creating the \"LabelDrop\" AppObject internally.\n * The factory provides the same functionality as the original setupLabelDrop function\n * but follows the Clean Architecture pattern and can be composed with other factories.\n *\n * @param appObjectRepo The AppObjectRepo to create the LabelDrop AppObject from\n * @returns A new LabelDropFeatureFactory instance\n */\nexport function makeLabelDropFeatureFactory(\n  appObjectRepo: AppObjectRepo,\n): LabelDropFeatureFactory {\n  const appObject = appObjectRepo.getOrCreate(\"LabelDrop\");\n  return new LabelDropFeatureFactory(appObject);\n}\n"]}
+{"version":3,"file":"LabelDropFeatureFactory.js","sourceRoot":"","sources":["../../../../src/LabelDrop/Factories/LabelDropFeatureFactory.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  DomainFactory,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  Quaternion,\r\n  Vector3,\r\n} from \"@vived/core\";\r\nimport { StylusEntity } from \"../../Stylus\";\r\nimport { makeTransform3DPM } from \"../../Transform3D\";\r\nimport { ZSpaceEntity } from \"../../zSpace\";\r\nimport {\r\n  makeMouseLabelDropAuthor,\r\n  makeStylusLabelDrop,\r\n  makeTouchLabelDropAuthor,\r\n} from \"../Controller\";\r\nimport { makeLabelDropRepo } from \"../Entities\";\r\nimport {\r\n  makeLabelDropDragItemPM,\r\n  makeLabelDropEditingIDPM,\r\n  makeLabelDropListPM,\r\n  makeLabelDropReviewPM,\r\n  makeRemainingLabelDropListPM,\r\n} from \"../PM\";\r\nimport {\r\n  ClearEditingLabelDropUCHook,\r\n  makeDeleteAllLabelDropUC,\r\n  makeDeleteLabelDropUC,\r\n  makeDragLabelDropUC,\r\n  makeDragLabelDropWorldUC,\r\n  makeEditLabelDropUC,\r\n  makeLabelDropCorrectAnimationUC,\r\n  makeLabelDropIncorrectAnimationUC,\r\n  makeLabelDropOnNothingAnimationUC,\r\n  makeSubmitLabelDropResultUC,\r\n  makeToggleLabelDropTargetUC,\r\n  makeValidateLabelDrop,\r\n  SerializeLabelDrop,\r\n} from \"../UseCases\";\r\nimport { makeLabelDropItemFactory } from \"./labelDropItemFactory\";\r\nimport { LabelDropRepo } from \"../Entities\";\r\nimport { ChallengeEntity } from \"../../Challenge\";\r\n\r\n/**\r\n * Factory responsible for setting up the LabelDrop Feature domain components.\r\n *\r\n * This factory initializes all entities, use cases, presentation models, and controllers\r\n * required for the LabelDrop Feature functionality. It follows the domain-driven\r\n * design pattern by organizing components into their respective layers. This factory\r\n * replaces the complex setupLabelDrop function while maintaining backwards compatibility.\r\n *\r\n * The factory creates and configures:\r\n * - 1 LabelDropRepo entity with labelDropItemFactory configuration\r\n * - 12 Use Cases for label drop operations including serialization, editing, dragging, and validation\r\n * - 6 Presentation Models for UI state management and data presentation\r\n * - 3 Controllers for mouse, touch, and stylus interactions\r\n * - External dependency management for StylusEntity and ZSpaceEntity\r\n * - Transform hierarchy setup with proper positioning and scaling\r\n *\r\n * @extends DomainFactory\r\n */\r\nexport class LabelDropFeatureFactory extends DomainFactory {\r\n  factoryName = \"LabelDropFeatureFactory\";\r\n\r\n  private labelDropEntity: LabelDropRepo | null = null;\r\n\r\n  /**\r\n   * Sets up all entities required for the LabelDrop Feature.\r\n   *\r\n   * Initializes the LabelDropRepo entity and configures it with the\r\n   * labelDropItemFactory for creating individual label drop items.\r\n   * Uses the \"LabelDrop\" AppObject that was passed to the factory constructor.\r\n   */\r\n  setupEntities(): void {\r\n    // Create the main LabelDropRepo entity\r\n    this.labelDropEntity = makeLabelDropRepo(this.appObject);\r\n\r\n    // Configure the entity with the item factory\r\n    this.labelDropEntity.labelDropItemFactory = makeLabelDropItemFactory(\r\n      this.appObject.appObjectRepo,\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the LabelDrop Feature.\r\n   *\r\n   * Initializes all 12 use cases that define the business operations and\r\n   * workflows available in the label drop feature. The use cases are created\r\n   * in the same order as the original setupLabelDrop function to maintain\r\n   * functional equivalence.\r\n   *\r\n   * Use Cases created:\r\n   * - SerializeLabelDrop: Handles serialization of label drop data\r\n   * - ClearEditingLabelDropUCHook: Manages clearing editing state\r\n   * - EditLabelDropUC: Handles label drop editing operations\r\n   * - DragLabelDropUC: Manages label drop dragging in screen space\r\n   * - DragLabelDropWorldUC: Manages label drop dragging in world space\r\n   * - DeleteLabelDropUC: Handles individual label drop deletion\r\n   * - DeleteAllLabelDropUC: Handles deletion of all label drops\r\n   * - ToggleLabelDropTargetUC: Manages target toggle operations\r\n   * - LabelDropCorrectAnimationUC: Handles correct drop animations\r\n   * - LabelDropOnNothingAnimationUC: Handles drop-on-nothing animations\r\n   * - LabelDropIncorrectAnimationUC: Handles incorrect drop animations\r\n   * - ValidateLabelDrop: Handles label drop validation logic\r\n   */\r\n  setupUCs(): void {\r\n    // Create all Use Cases in the same order as original\r\n    new SerializeLabelDrop(this.appObject);\r\n    new ClearEditingLabelDropUCHook(this.appObject);\r\n    makeEditLabelDropUC(this.appObject);\r\n    makeDragLabelDropUC(this.appObject);\r\n    makeDragLabelDropWorldUC(this.appObject);\r\n    makeDeleteLabelDropUC(this.appObject);\r\n    makeDeleteAllLabelDropUC(this.appObject);\r\n    makeToggleLabelDropTargetUC(this.appObject);\r\n    makeLabelDropCorrectAnimationUC(this.appObject);\r\n    makeLabelDropOnNothingAnimationUC(this.appObject);\r\n    makeLabelDropIncorrectAnimationUC(this.appObject);\r\n    makeValidateLabelDrop(this.appObject);\r\n    makeSubmitLabelDropResultUC(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation models for the LabelDrop Feature.\r\n   *\r\n   * Initializes all 6 presentation models that handle the view logic and\r\n   * state management for UI components related to the label drop feature.\r\n   * These PMs manage the reactive data flow between the domain layer and UI.\r\n   *\r\n   * Presentation Models created:\r\n   * - LabelDropEditingIDPM: Manages the currently editing label drop ID\r\n   * - RemainingLabelDropListPM: Tracks remaining label drops to be placed\r\n   * - LabelDropReviewPM: Handles review mode presentation logic\r\n   * - Transform3DPM: Manages 3D transform presentation for the feature\r\n   * - LabelDropDragItemPM: Handles drag item presentation state\r\n   * - LabelDropListPM: Manages the overall list of label drops\r\n   */\r\n  setupPMs(): void {\r\n    // Create all Presentation Models in the same order as original\r\n    makeLabelDropEditingIDPM(this.appObject);\r\n    makeRemainingLabelDropListPM(this.appObject);\r\n    makeLabelDropReviewPM(this.appObject);\r\n    makeTransform3DPM(this.appObject);\r\n    makeLabelDropDragItemPM(this.appObject);\r\n    makeLabelDropListPM(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Performs final setup operations after all components are initialized.\r\n   *\r\n   * This method handles:\r\n   * - Creation of the 3 Controllers (Mouse, Touch, Stylus)\r\n   * - External dependency resolution and configuration\r\n   * - Transform hierarchy setup for drag operations\r\n   * - Error handling for missing dependencies\r\n   *\r\n   * Controllers created:\r\n   * - MouseLabelDropAuthor: Handles mouse-based label drop interactions\r\n   * - TouchLabelDropAuthor: Handles touch-based label drop interactions\r\n   * - StylusLabelDrop: Handles stylus-based label drop interactions\r\n   *\r\n   * External dependencies:\r\n   * - StylusEntity: Required for stylus-based interactions and drag helper positioning\r\n   * - ZSpaceEntity: Required for zSpace display integration and drag label positioning\r\n   */\r\n  finalSetup(): void {\r\n    const challengeEntity = ChallengeEntity.get(this.appObjects);\r\n    if (challengeEntity && this.labelDropEntity) {\r\n      challengeEntity.registerChallenge(this.labelDropEntity);\r\n    }\r\n\r\n    // Create Controllers\r\n    makeMouseLabelDropAuthor(this.appObject);\r\n    makeTouchLabelDropAuthor(this.appObject);\r\n\r\n    if (this.appObjects.hasSingleton(StylusEntity.type)) {\r\n      makeStylusLabelDrop(this.appObject);\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new LabelDropFeatureFactory.\r\n *\r\n * This function follows the same pattern as the original setupLabelDrop function\r\n * by taking an AppObjectRepo and creating the \"LabelDrop\" AppObject internally.\r\n * The factory provides the same functionality as the original setupLabelDrop function\r\n * but follows the Clean Architecture pattern and can be composed with other factories.\r\n *\r\n * @param appObjectRepo The AppObjectRepo to create the LabelDrop AppObject from\r\n * @returns A new LabelDropFeatureFactory instance\r\n */\r\nexport function makeLabelDropFeatureFactory(\r\n  appObjectRepo: AppObjectRepo,\r\n): LabelDropFeatureFactory {\r\n  const appObject = appObjectRepo.getOrCreate(\"LabelDrop\");\r\n  return new LabelDropFeatureFactory(appObject);\r\n}\r\n"]}

package/dist/esm/LabelDrop/UseCases/SubmitLabelDropResultUC.js

@@ -0,0 +1,75 @@
+import { AppObjectUC, getSingletonComponent, } from "@vived/core";
+import { BaseAppState } from "../../BaseApp";
+import { ChallengeEntity } from "../../Challenge";
+import { submitMultiHitResult } from "../../Dispatcher";
+import { LabelDropRepo } from "../Entities";
+/**
+ * Submits a Label Drop challenge result to the Host as a MULTIHIT result.
+ *
+ * Mirrors the other challenge submitters (TrySubmitObjectPickUC, SubmitQuestionAnswerUC):
+ * consumption-mode only, and only while Label Drop is the selected challenge. It observes
+ * every Label Drop submission and reports the running tally, so a partial attempt is scored
+ * on slide exit (the Host's MULTIHIT best-hits rule keeps the strongest result). See
+ * docs/prd/label-drop-result.md.
+ *
+ * Tally: hits = items answered correctly; unanswered = items not yet correct
+ * (getRemainingLabelDrops); misses = total tries - hits (each hit's final try is the one
+ * correct drop, so every other object-drop was wrong); description = the slide's text.
+ */
+export class SubmitLabelDropResultUC extends AppObjectUC {
+    static get(appObjects) {
+        return getSingletonComponent(SubmitLabelDropResultUC.type, appObjects);
+    }
+}
+SubmitLabelDropResultUC.type = "SubmitLabelDropResultUC";
+export function makeSubmitLabelDropResultUC(appObject) {
+    return new SubmitLabelDropResultUCImp(appObject);
+}
+class SubmitLabelDropResultUCImp extends SubmitLabelDropResultUC {
+    get repo() {
+        return this.getCachedSingleton(LabelDropRepo.type);
+    }
+    get baseApp() {
+        return this.getCachedSingleton(BaseAppState.type);
+    }
+    get challenge() {
+        return this.getCachedSingleton(ChallengeEntity.type);
+    }
+    constructor(appObject) {
+        super(appObject, SubmitLabelDropResultUC.type);
+        this.onSubmission = () => {
+            this.submitResult();
+        };
+        this.submitResult = () => {
+            const repo = this.repo;
+            const baseApp = this.baseApp;
+            const challenge = this.challenge;
+            if (!repo || !baseApp || !challenge)
+                return;
+            if (baseApp.isAuthoring)
+                return;
+            if (challenge.selectedChallenge !== "LABEL_DROP")
+                return;
+            const items = repo.getAll();
+            const hits = items.filter((item) => item.answeredCorrectly === true).length;
+            const unanswered = repo.getRemainingLabelDrops().length;
+            const totalTries = items.reduce((sum, item) => sum + item.tries, 0);
+            const misses = totalTries - hits;
+            submitMultiHitResult({
+                hits,
+                misses,
+                unanswered,
+                description: baseApp.slideText,
+            }, this.appObjects);
+        };
+        this.appObjects.registerSingleton(this);
+        const repo = LabelDropRepo.get(this.appObjects);
+        if (repo) {
+            repo.addLabelDropSubmissionObserver(this.onSubmission);
+        }
+        else {
+            this.warn("SubmitLabelDropResultUC has been set up without a LabelDropRepo to observe");
+        }
+    }
+}
+//# sourceMappingURL=SubmitLabelDropResultUC.js.map

package/dist/esm/LabelDrop/UseCases/SubmitLabelDropResultUC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubmitLabelDropResultUC.js","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/SubmitLabelDropResultUC.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC,\r\n  getSingletonComponent,\r\n} from \"@vived/core\";\r\nimport { BaseAppState } from \"../../BaseApp\";\r\nimport { ChallengeEntity } from \"../../Challenge\";\r\nimport { submitMultiHitResult } from \"../../Dispatcher\";\r\nimport { LabelDropRepo } from \"../Entities\";\r\n\r\n/**\r\n * Submits a Label Drop challenge result to the Host as a MULTIHIT result.\r\n *\r\n * Mirrors the other challenge submitters (TrySubmitObjectPickUC, SubmitQuestionAnswerUC):\r\n * consumption-mode only, and only while Label Drop is the selected challenge. It observes\r\n * every Label Drop submission and reports the running tally, so a partial attempt is scored\r\n * on slide exit (the Host's MULTIHIT best-hits rule keeps the strongest result). See\r\n * docs/prd/label-drop-result.md.\r\n *\r\n * Tally: hits = items answered correctly; unanswered = items not yet correct\r\n * (getRemainingLabelDrops); misses = total tries - hits (each hit's final try is the one\r\n * correct drop, so every other object-drop was wrong); description = the slide's text.\r\n */\r\nexport abstract class SubmitLabelDropResultUC extends AppObjectUC {\r\n  static readonly type = \"SubmitLabelDropResultUC\";\r\n\r\n  abstract submitResult(): void;\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<SubmitLabelDropResultUC>(\r\n      SubmitLabelDropResultUC.type,\r\n      appObjects,\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeSubmitLabelDropResultUC(\r\n  appObject: AppObject,\r\n): SubmitLabelDropResultUC {\r\n  return new SubmitLabelDropResultUCImp(appObject);\r\n}\r\n\r\nclass SubmitLabelDropResultUCImp extends SubmitLabelDropResultUC {\r\n  private get repo() {\r\n    return this.getCachedSingleton<LabelDropRepo>(LabelDropRepo.type);\r\n  }\r\n\r\n  private get baseApp() {\r\n    return this.getCachedSingleton<BaseAppState>(BaseAppState.type);\r\n  }\r\n\r\n  private get challenge() {\r\n    return this.getCachedSingleton<ChallengeEntity>(ChallengeEntity.type);\r\n  }\r\n\r\n  private onSubmission = (): void => {\r\n    this.submitResult();\r\n  };\r\n\r\n  submitResult = (): void => {\r\n    const repo = this.repo;\r\n    const baseApp = this.baseApp;\r\n    const challenge = this.challenge;\r\n    if (!repo || !baseApp || !challenge) return;\r\n\r\n    if (baseApp.isAuthoring) return;\r\n    if (challenge.selectedChallenge !== \"LABEL_DROP\") return;\r\n\r\n    const items = repo.getAll();\r\n    const hits = items.filter(\r\n      (item) => item.answeredCorrectly === true,\r\n    ).length;\r\n    const unanswered = repo.getRemainingLabelDrops().length;\r\n    const totalTries = items.reduce((sum, item) => sum + item.tries, 0);\r\n    const misses = totalTries - hits;\r\n\r\n    submitMultiHitResult(\r\n      {\r\n        hits,\r\n        misses,\r\n        unanswered,\r\n        description: baseApp.slideText,\r\n      },\r\n      this.appObjects,\r\n    );\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, SubmitLabelDropResultUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    const repo = LabelDropRepo.get(this.appObjects);\r\n    if (repo) {\r\n      repo.addLabelDropSubmissionObserver(this.onSubmission);\r\n    } else {\r\n      this.warn(\r\n        \"SubmitLabelDropResultUC has been set up without a LabelDropRepo to observe\",\r\n      );\r\n    }\r\n  }\r\n}\r\n"]}

package/dist/esm/LabelDrop/UseCases/SubmitLabelDropResultUC.test.js

@@ -0,0 +1,44 @@
+import { makeAppObjectRepo } from "@vived/core";
+import { makeBaseAppState } from "../../BaseApp/Entity/BaseAppState";
+import { makeChallengeEntityMock } from "../../Challenge";
+import { makeMockSubmitResult } from "../../Dispatcher";
+import { LabelDropRepo, makeLabelDropRepo } from "../Entities";
+import { makeLabelDropFeatureFactory } from "../Factories/LabelDropFeatureFactory";
+import { makeSubmitLabelDropResultUC, SubmitLabelDropResultUC, } from "./SubmitLabelDropResultUC";
+describe("SubmitLabelDropResultUC", () => {
+    it("Registers as the singleton", () => {
+        const appObjects = makeAppObjectRepo();
+        makeLabelDropRepo(appObjects.getOrCreate("LabelDrop"));
+        const uc = makeSubmitLabelDropResultUC(appObjects.getOrCreate("LabelDrop"));
+        expect(SubmitLabelDropResultUC.get(appObjects)).toBe(uc);
+    });
+    // Wiring / lifecycle: prove the real LabelDropFeatureFactory constructs the UC and hooks
+    // the drop observer. Uses the repo's factory-test idiom (drive the phases directly) rather
+    // than a full setupDomain — finalSetup wires pointer controllers that pull in the input /
+    // framework cluster, which is irrelevant to this UC's wiring.
+    it("is wired by LabelDropFeatureFactory.setupUCs so a drop reports a result to the Host", () => {
+        const appObjects = makeAppObjectRepo();
+        // Boundary singletons the feature's UCs read at construction time.
+        const baseApp = makeBaseAppState(appObjects.getOrCreate("App"));
+        baseApp.isAuthoring = false;
+        baseApp.slideText = "Slide text";
+        const challenge = makeChallengeEntityMock(appObjects);
+        challenge.selectedChallenge = "LABEL_DROP";
+        const mockSubmitResult = makeMockSubmitResult(appObjects);
+        mockSubmitResult.submitMultiHitResult = jest.fn();
+        const factory = makeLabelDropFeatureFactory(appObjects);
+        factory.setupEntities(); // creates LabelDropRepo
+        factory.setupUCs(); // creates SubmitLabelDropResultUC, which subscribes to the repo
+        const repo = LabelDropRepo.get(appObjects);
+        const item = repo.makeLabelDropItem("a");
+        item.targetIds = ["objA"];
+        repo.submitLabelDrop("a", "objA");
+        expect(mockSubmitResult.submitMultiHitResult).toHaveBeenCalledWith({
+            hits: 1,
+            misses: 0,
+            unanswered: 0,
+            description: "Slide text",
+        });
+    });
+});
+//# sourceMappingURL=SubmitLabelDropResultUC.test.js.map

package/dist/esm/LabelDrop/UseCases/SubmitLabelDropResultUC.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubmitLabelDropResultUC.test.js","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/SubmitLabelDropResultUC.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;QACvC,iBAAiB,CAAC,UAAU,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;QACvD,MAAM,EAAE,GAAG,2BAA2B,CAAC,UAAU,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;QAE5E,MAAM,CAAC,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,yFAAyF;IACzF,2FAA2F;IAC3F,0FAA0F;IAC1F,8DAA8D;IAC9D,EAAE,CAAC,qFAAqF,EAAE,GAAG,EAAE;QAC7F,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;QAEvC,mEAAmE;QACnE,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC;QAC5B,OAAO,CAAC,SAAS,GAAG,YAAY,CAAC;QAEjC,MAAM,SAAS,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;QACtD,SAAS,CAAC,iBAAiB,GAAG,YAAY,CAAC;QAE3C,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAC1D,gBAAgB,CAAC,oBAAoB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAElD,MAAM,OAAO,GAAG,2BAA2B,CAAC,UAAU,CAAC,CAAC;QACxD,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,wBAAwB;QACjD,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,gEAAgE;QAEpF,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC;QAE1B,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAElC,MAAM,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,oBAAoB,CAAC;YACjE,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;YACT,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,YAAY;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { makeAppObjectRepo } from \"@vived/core\";\r\nimport { makeBaseAppState } from \"../../BaseApp/Entity/BaseAppState\";\r\nimport { makeChallengeEntityMock } from \"../../Challenge\";\r\nimport { makeMockSubmitResult } from \"../../Dispatcher\";\r\nimport { LabelDropRepo, makeLabelDropRepo } from \"../Entities\";\r\nimport { makeLabelDropFeatureFactory } from \"../Factories/LabelDropFeatureFactory\";\r\nimport {\r\n  makeSubmitLabelDropResultUC,\r\n  SubmitLabelDropResultUC,\r\n} from \"./SubmitLabelDropResultUC\";\r\n\r\ndescribe(\"SubmitLabelDropResultUC\", () => {\r\n  it(\"Registers as the singleton\", () => {\r\n    const appObjects = makeAppObjectRepo();\r\n    makeLabelDropRepo(appObjects.getOrCreate(\"LabelDrop\"));\r\n    const uc = makeSubmitLabelDropResultUC(appObjects.getOrCreate(\"LabelDrop\"));\r\n\r\n    expect(SubmitLabelDropResultUC.get(appObjects)).toBe(uc);\r\n  });\r\n\r\n  // Wiring / lifecycle: prove the real LabelDropFeatureFactory constructs the UC and hooks\r\n  // the drop observer. Uses the repo's factory-test idiom (drive the phases directly) rather\r\n  // than a full setupDomain — finalSetup wires pointer controllers that pull in the input /\r\n  // framework cluster, which is irrelevant to this UC's wiring.\r\n  it(\"is wired by LabelDropFeatureFactory.setupUCs so a drop reports a result to the Host\", () => {\r\n    const appObjects = makeAppObjectRepo();\r\n\r\n    // Boundary singletons the feature's UCs read at construction time.\r\n    const baseApp = makeBaseAppState(appObjects.getOrCreate(\"App\"));\r\n    baseApp.isAuthoring = false;\r\n    baseApp.slideText = \"Slide text\";\r\n\r\n    const challenge = makeChallengeEntityMock(appObjects);\r\n    challenge.selectedChallenge = \"LABEL_DROP\";\r\n\r\n    const mockSubmitResult = makeMockSubmitResult(appObjects);\r\n    mockSubmitResult.submitMultiHitResult = jest.fn();\r\n\r\n    const factory = makeLabelDropFeatureFactory(appObjects);\r\n    factory.setupEntities(); // creates LabelDropRepo\r\n    factory.setupUCs(); // creates SubmitLabelDropResultUC, which subscribes to the repo\r\n\r\n    const repo = LabelDropRepo.get(appObjects)!;\r\n    const item = repo.makeLabelDropItem(\"a\");\r\n    item.targetIds = [\"objA\"];\r\n\r\n    repo.submitLabelDrop(\"a\", \"objA\");\r\n\r\n    expect(mockSubmitResult.submitMultiHitResult).toHaveBeenCalledWith({\r\n      hits: 1,\r\n      misses: 0,\r\n      unanswered: 0,\r\n      description: \"Slide text\",\r\n    });\r\n  });\r\n});\r\n"]}

package/dist/esm/LabelDrop/UseCases/index.js

@@ -10,6 +10,7 @@ export * from "./IncorrectAnimationUC";
 export * from "./InitializeLabelDropLabelHook";
 export * from "./LabelDropAnimation";
 export * from "./SerializeLabelDrop";
+export * from "./SubmitLabelDropResultUC";
 export * from "./ToggleLabelDropTargetUC";
 export * from "./ValidateLabelDrop";
 export * from "./labelDropLabelValidator";

package/dist/esm/LabelDrop/UseCases/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC","sourcesContent":["export * from \"./ClearEditingLabelDropUCHook\";\nexport * from \"./CorrectAnimationUC\";\nexport * from \"./DeleteAllLabelDropUC\";\nexport * from \"./DeleteLabelDropUC\";\nexport * from \"./DragLabelDropUC\";\nexport * from \"./DragLabelDropWorldUC\";\nexport * from \"./DropOnNothingAnimationUC\";\nexport * from \"./EditLabelDropUC\";\nexport * from \"./IncorrectAnimationUC\";\nexport * from \"./InitializeLabelDropLabelHook\";\nexport * from \"./LabelDropAnimation\";\nexport * from \"./SerializeLabelDrop\";\nexport * from \"./ToggleLabelDropTargetUC\";\nexport * from \"./ValidateLabelDrop\";\nexport * from \"./labelDropLabelValidator\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC","sourcesContent":["export * from \"./ClearEditingLabelDropUCHook\";\r\nexport * from \"./CorrectAnimationUC\";\r\nexport * from \"./DeleteAllLabelDropUC\";\r\nexport * from \"./DeleteLabelDropUC\";\r\nexport * from \"./DragLabelDropUC\";\r\nexport * from \"./DragLabelDropWorldUC\";\r\nexport * from \"./DropOnNothingAnimationUC\";\r\nexport * from \"./EditLabelDropUC\";\r\nexport * from \"./IncorrectAnimationUC\";\r\nexport * from \"./InitializeLabelDropLabelHook\";\r\nexport * from \"./LabelDropAnimation\";\r\nexport * from \"./SerializeLabelDrop\";\r\nexport * from \"./SubmitLabelDropResultUC\";\r\nexport * from \"./ToggleLabelDropTargetUC\";\r\nexport * from \"./ValidateLabelDrop\";\r\nexport * from \"./labelDropLabelValidator\";\r\n"]}

package/dist/esm/TestUtils/index.js

@@ -0,0 +1,2 @@
+export * from "./setupFeatureForTesting";
+//# sourceMappingURL=index.js.map

package/dist/esm/TestUtils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/TestUtils/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC","sourcesContent":["export * from \"./setupFeatureForTesting\";\r\n"]}

package/dist/esm/TestUtils/setupFeatureForTesting.js

@@ -0,0 +1,57 @@
+/**
+ * setupFeatureForTesting.ts
+ *
+ * The feature-context test harness for this Feature Library.
+ *
+ * This package has no app-level domain (no `makeDomain`, no single repo), so there is no
+ * global "make the domain" harness. The unit of test context is a **Feature** (or a small
+ * cluster of Features), wired the way a Slide App wires it — through each Feature's
+ * `FeatureFactory` (the current standard), using the same phased orchestration production
+ * uses. See `CLAUDE.md` and `docs/agents/domain.md`.
+ *
+ * Use this for **wiring / lifecycle** tests — proving that a Feature, once really wired,
+ * behaves end-to-end (e.g. a Challenge submits its result when the student leaves the slide).
+ * For pure **logic** tests of a single UC or PM, a hand-wired `makeAppObjectRepo()` rig with
+ * the collaborators mocked at the boundary is lighter and still preferred — see
+ * `src/ObjectPick/UseCases/TrySubmitObjectPickUC.test.ts` as the reference.
+ *
+ * @example
+ *   // LabelDrop's submit path depends on Challenge (for `selectedChallenge`) and the
+ *   // Dispatcher (the Host boundary). List dependencies first, exactly as a Slide App would.
+ *   const { appObjects } = setupFeatureForTesting([
+ *     makeDispatcherFeatureFactory,
+ *     makeChallengeFeatureFactory,
+ *     makeLabelDropFeatureFactory,
+ *   ]);
+ *   // Then act through a Controller / navigation seam and assert through an Adapter VM or a
+ *   // dispatcher mock registered before setup.
+ */
+import { makeAppObjectRepo, makeDomainFactoryRepo, } from "@vived/core";
+/**
+ * Wire one or more Features into a fresh repo for a feature-context test.
+ *
+ * @param featureFactories The `make<Feature>FeatureFactory` functions to wire, in the order a
+ *   Slide App would compose them — a Feature whose `finalSetup` depends on another Feature's
+ *   entities must be listed *after* that Feature.
+ * @param seed Optional callback run *before* the factories are constructed. Use it to stand up
+ *   the boundary singletons a Feature reads at construction time (many Feature UCs resolve
+ *   siblings via `getCachedSingleton`, which THROWS when absent — e.g. `BaseAppState`,
+ *   `ChallengeEntity`). Seed real entities or their Mocks here instead of pulling every
+ *   dependency Feature's factory into the cluster.
+ * @returns `{ appObjects }` — resolve Controllers and Adapters from it to act and assert.
+ */
+export function setupFeatureForTesting(featureFactories, seed) {
+    const appObjects = makeAppObjectRepo();
+    // The DomainFactoryRepo must exist before the factories are constructed: each
+    // FeatureFactory auto-registers with it in its constructor.
+    const factoryRepo = makeDomainFactoryRepo(appObjects);
+    // Stand up boundary singletons the Features read at construction time.
+    if (seed)
+        seed(appObjects);
+    featureFactories.forEach((makeFactory) => makeFactory(appObjects));
+    // Run the same phased orchestration as production — all setupEntities, then all setupUCs,
+    // then all setupPMs, then all finalSetup — so cross-Feature dependencies resolve correctly.
+    factoryRepo.setupDomain();
+    return { appObjects };
+}
+//# sourceMappingURL=setupFeatureForTesting.js.map

package/dist/esm/TestUtils/setupFeatureForTesting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupFeatureForTesting.js","sourceRoot":"","sources":["../../../src/TestUtils/setupFeatureForTesting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAGL,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAOrB;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACpC,gBAAkE,EAClE,IAA0C;IAE1C,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IAEvC,8EAA8E;IAC9E,4DAA4D;IAC5D,MAAM,WAAW,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAEtD,uEAAuE;IACvE,IAAI,IAAI;QAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAE3B,gBAAgB,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnE,0FAA0F;IAC1F,4FAA4F;IAC5F,WAAW,CAAC,WAAW,EAAE,CAAC;IAE1B,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC","sourcesContent":["/**\r\n * setupFeatureForTesting.ts\r\n *\r\n * The feature-context test harness for this Feature Library.\r\n *\r\n * This package has no app-level domain (no `makeDomain`, no single repo), so there is no\r\n * global \"make the domain\" harness. The unit of test context is a **Feature** (or a small\r\n * cluster of Features), wired the way a Slide App wires it — through each Feature's\r\n * `FeatureFactory` (the current standard), using the same phased orchestration production\r\n * uses. See `CLAUDE.md` and `docs/agents/domain.md`.\r\n *\r\n * Use this for **wiring / lifecycle** tests — proving that a Feature, once really wired,\r\n * behaves end-to-end (e.g. a Challenge submits its result when the student leaves the slide).\r\n * For pure **logic** tests of a single UC or PM, a hand-wired `makeAppObjectRepo()` rig with\r\n * the collaborators mocked at the boundary is lighter and still preferred — see\r\n * `src/ObjectPick/UseCases/TrySubmitObjectPickUC.test.ts` as the reference.\r\n *\r\n * @example\r\n *   // LabelDrop's submit path depends on Challenge (for `selectedChallenge`) and the\r\n *   // Dispatcher (the Host boundary). List dependencies first, exactly as a Slide App would.\r\n *   const { appObjects } = setupFeatureForTesting([\r\n *     makeDispatcherFeatureFactory,\r\n *     makeChallengeFeatureFactory,\r\n *     makeLabelDropFeatureFactory,\r\n *   ]);\r\n *   // Then act through a Controller / navigation seam and assert through an Adapter VM or a\r\n *   // dispatcher mock registered before setup.\r\n */\r\n\r\nimport {\r\n  AppObjectRepo,\r\n  DomainFactory,\r\n  makeAppObjectRepo,\r\n  makeDomainFactoryRepo,\r\n} from \"@vived/core\";\r\n\r\nexport interface FeatureTestContext {\r\n  /** The live repo, wired through the given FeatureFactories exactly as production does. */\r\n  appObjects: AppObjectRepo;\r\n}\r\n\r\n/**\r\n * Wire one or more Features into a fresh repo for a feature-context test.\r\n *\r\n * @param featureFactories The `make<Feature>FeatureFactory` functions to wire, in the order a\r\n *   Slide App would compose them — a Feature whose `finalSetup` depends on another Feature's\r\n *   entities must be listed *after* that Feature.\r\n * @param seed Optional callback run *before* the factories are constructed. Use it to stand up\r\n *   the boundary singletons a Feature reads at construction time (many Feature UCs resolve\r\n *   siblings via `getCachedSingleton`, which THROWS when absent — e.g. `BaseAppState`,\r\n *   `ChallengeEntity`). Seed real entities or their Mocks here instead of pulling every\r\n *   dependency Feature's factory into the cluster.\r\n * @returns `{ appObjects }` — resolve Controllers and Adapters from it to act and assert.\r\n */\r\nexport function setupFeatureForTesting(\r\n  featureFactories: ((appObjects: AppObjectRepo) => DomainFactory)[],\r\n  seed?: (appObjects: AppObjectRepo) => void,\r\n): FeatureTestContext {\r\n  const appObjects = makeAppObjectRepo();\r\n\r\n  // The DomainFactoryRepo must exist before the factories are constructed: each\r\n  // FeatureFactory auto-registers with it in its constructor.\r\n  const factoryRepo = makeDomainFactoryRepo(appObjects);\r\n\r\n  // Stand up boundary singletons the Features read at construction time.\r\n  if (seed) seed(appObjects);\r\n\r\n  featureFactories.forEach((makeFactory) => makeFactory(appObjects));\r\n\r\n  // Run the same phased orchestration as production — all setupEntities, then all setupUCs,\r\n  // then all setupPMs, then all finalSetup — so cross-Feature dependencies resolve correctly.\r\n  factoryRepo.setupDomain();\r\n\r\n  return { appObjects };\r\n}\r\n"]}

package/dist/types/LabelDrop/Factories/LabelDropFeatureFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LabelDropFeatureFactory.d.ts","sourceRoot":"","sources":["../../../../src/LabelDrop/Factories/LabelDropFeatureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,aAAa,EAGd,MAAM,aAAa,CAAC;AAmCrB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,WAAW,SAA6B;IAExC,OAAO,CAAC,eAAe,CAA8B;IAErD;;;;;;OAMG;IACH,aAAa,IAAI,IAAI;IAUrB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,IAAI,IAAI;IAgBhB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,IAAI,IAAI;IAUhB;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,IAAI,IAAI;CAcnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,aAAa,GAC3B,uBAAuB,CAGzB"}
+{"version":3,"file":"LabelDropFeatureFactory.d.ts","sourceRoot":"","sources":["../../../../src/LabelDrop/Factories/LabelDropFeatureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,aAAa,EAGd,MAAM,aAAa,CAAC;AAoCrB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,WAAW,SAA6B;IAExC,OAAO,CAAC,eAAe,CAA8B;IAErD;;;;;;OAMG;IACH,aAAa,IAAI,IAAI;IAUrB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,IAAI,IAAI;IAiBhB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,IAAI,IAAI;IAUhB;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,IAAI,IAAI;CAcnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,aAAa,GAC3B,uBAAuB,CAGzB"}

package/dist/types/LabelDrop/UseCases/SubmitLabelDropResultUC.d.ts

@@ -0,0 +1,21 @@
+import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * Submits a Label Drop challenge result to the Host as a MULTIHIT result.
+ *
+ * Mirrors the other challenge submitters (TrySubmitObjectPickUC, SubmitQuestionAnswerUC):
+ * consumption-mode only, and only while Label Drop is the selected challenge. It observes
+ * every Label Drop submission and reports the running tally, so a partial attempt is scored
+ * on slide exit (the Host's MULTIHIT best-hits rule keeps the strongest result). See
+ * docs/prd/label-drop-result.md.
+ *
+ * Tally: hits = items answered correctly; unanswered = items not yet correct
+ * (getRemainingLabelDrops); misses = total tries - hits (each hit's final try is the one
+ * correct drop, so every other object-drop was wrong); description = the slide's text.
+ */
+export declare abstract class SubmitLabelDropResultUC extends AppObjectUC {
+    static readonly type = "SubmitLabelDropResultUC";
+    abstract submitResult(): void;
+    static get(appObjects: AppObjectRepo): SubmitLabelDropResultUC | undefined;
+}
+export declare function makeSubmitLabelDropResultUC(appObject: AppObject): SubmitLabelDropResultUC;
+//# sourceMappingURL=SubmitLabelDropResultUC.d.ts.map

package/dist/types/LabelDrop/UseCases/SubmitLabelDropResultUC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubmitLabelDropResultUC.d.ts","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/SubmitLabelDropResultUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,WAAW,EAEZ,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;GAYG;AACH,8BAAsB,uBAAwB,SAAQ,WAAW;IAC/D,MAAM,CAAC,QAAQ,CAAC,IAAI,6BAA6B;IAEjD,QAAQ,CAAC,YAAY,IAAI,IAAI;IAE7B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa;CAMrC;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,GACnB,uBAAuB,CAEzB"}

package/dist/types/LabelDrop/UseCases/SubmitLabelDropResultUC.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SubmitLabelDropResultUC.test.d.ts.map

package/dist/types/LabelDrop/UseCases/SubmitLabelDropResultUC.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubmitLabelDropResultUC.test.d.ts","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/SubmitLabelDropResultUC.test.ts"],"names":[],"mappings":""}

package/dist/types/LabelDrop/UseCases/index.d.ts

@@ -10,6 +10,7 @@ export * from "./IncorrectAnimationUC";
 export * from "./InitializeLabelDropLabelHook";
 export * from "./LabelDropAnimation";
 export * from "./SerializeLabelDrop";
+export * from "./SubmitLabelDropResultUC";
 export * from "./ToggleLabelDropTargetUC";
 export * from "./ValidateLabelDrop";
 export * from "./labelDropLabelValidator";

package/dist/types/LabelDrop/UseCases/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/LabelDrop/UseCases/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from "./setupFeatureForTesting";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/TestUtils/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/dist/types/TestUtils/setupFeatureForTesting.d.ts

@@ -0,0 +1,48 @@
+/**
+ * setupFeatureForTesting.ts
+ *
+ * The feature-context test harness for this Feature Library.
+ *
+ * This package has no app-level domain (no `makeDomain`, no single repo), so there is no
+ * global "make the domain" harness. The unit of test context is a **Feature** (or a small
+ * cluster of Features), wired the way a Slide App wires it — through each Feature's
+ * `FeatureFactory` (the current standard), using the same phased orchestration production
+ * uses. See `CLAUDE.md` and `docs/agents/domain.md`.
+ *
+ * Use this for **wiring / lifecycle** tests — proving that a Feature, once really wired,
+ * behaves end-to-end (e.g. a Challenge submits its result when the student leaves the slide).
+ * For pure **logic** tests of a single UC or PM, a hand-wired `makeAppObjectRepo()` rig with
+ * the collaborators mocked at the boundary is lighter and still preferred — see
+ * `src/ObjectPick/UseCases/TrySubmitObjectPickUC.test.ts` as the reference.
+ *
+ * @example
+ *   // LabelDrop's submit path depends on Challenge (for `selectedChallenge`) and the
+ *   // Dispatcher (the Host boundary). List dependencies first, exactly as a Slide App would.
+ *   const { appObjects } = setupFeatureForTesting([
+ *     makeDispatcherFeatureFactory,
+ *     makeChallengeFeatureFactory,
+ *     makeLabelDropFeatureFactory,
+ *   ]);
+ *   // Then act through a Controller / navigation seam and assert through an Adapter VM or a
+ *   // dispatcher mock registered before setup.
+ */
+import { AppObjectRepo, DomainFactory } from "@vived/core";
+export interface FeatureTestContext {
+    /** The live repo, wired through the given FeatureFactories exactly as production does. */
+    appObjects: AppObjectRepo;
+}
+/**
+ * Wire one or more Features into a fresh repo for a feature-context test.
+ *
+ * @param featureFactories The `make<Feature>FeatureFactory` functions to wire, in the order a
+ *   Slide App would compose them — a Feature whose `finalSetup` depends on another Feature's
+ *   entities must be listed *after* that Feature.
+ * @param seed Optional callback run *before* the factories are constructed. Use it to stand up
+ *   the boundary singletons a Feature reads at construction time (many Feature UCs resolve
+ *   siblings via `getCachedSingleton`, which THROWS when absent — e.g. `BaseAppState`,
+ *   `ChallengeEntity`). Seed real entities or their Mocks here instead of pulling every
+ *   dependency Feature's factory into the cluster.
+ * @returns `{ appObjects }` — resolve Controllers and Adapters from it to act and assert.
+ */
+export declare function setupFeatureForTesting(featureFactories: ((appObjects: AppObjectRepo) => DomainFactory)[], seed?: (appObjects: AppObjectRepo) => void): FeatureTestContext;
+//# sourceMappingURL=setupFeatureForTesting.d.ts.map

package/dist/types/TestUtils/setupFeatureForTesting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupFeatureForTesting.d.ts","sourceRoot":"","sources":["../../../src/TestUtils/setupFeatureForTesting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EACL,aAAa,EACb,aAAa,EAGd,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,kBAAkB;IACjC,0FAA0F;IAC1F,UAAU,EAAE,aAAa,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,CAAC,CAAC,UAAU,EAAE,aAAa,KAAK,aAAa,CAAC,EAAE,EAClE,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,GACzC,kBAAkB,CAiBpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vived/app",
-  "version": "6.5.0",
+  "version": "6.6.0",
   "description": "Public package of VIVED App Components",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",