@pie-element/image-cloze-association 9.1.2-next.4 → 9.2.0-next.0

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [9.2.0-next.0](https://github.com/pie-framework/pie-elements/compare/@pie-element/image-cloze-association@9.1.2-next.5...@pie-element/image-cloze-association@9.2.0-next.0) (2026-03-18)
+
+### Bug Fixes
+
+- test - include trace log in score response for empty placements ([4a46588](https://github.com/pie-framework/pie-elements/commit/4a46588819250b6efb11b458ed415c6346e70c94))
+
+### Features
+
+- **image-cloze-association:** add trace log for scoring in outcome function PD-5437 ([c9e8e27](https://github.com/pie-framework/pie-elements/commit/c9e8e279113f144b9f316b2de833dbf9264884fd))
+
+## [9.1.2-next.5](https://github.com/pie-framework/pie-elements/compare/@pie-element/image-cloze-association@9.1.2-next.4...@pie-element/image-cloze-association@9.1.2-next.5) (2026-03-12)
+
+### Bug Fixes
+
+- bump libs, update mathquill, switch interface PD-5791 ([686a7c0](https://github.com/pie-framework/pie-elements/commit/686a7c0d41ff82f5ddad7cecd93cc0c18324a81b))
+
 ## [9.1.2-next.4](https://github.com/pie-framework/pie-elements/compare/@pie-element/image-cloze-association@9.1.2-next.3...@pie-element/image-cloze-association@9.1.2-next.4) (2026-03-09)
 
 ### Bug Fixes

package/configure/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.1.1-next.4](https://github.com/pie-framework/pie-elements/compare/@pie-element/image-cloze-association-configure@8.1.1-next.3...@pie-element/image-cloze-association-configure@8.1.1-next.4) (2026-03-12)
+
+### Bug Fixes
+
+- bump libs, update mathquill, switch interface PD-5791 ([686a7c0](https://github.com/pie-framework/pie-elements/commit/686a7c0d41ff82f5ddad7cecd93cc0c18324a81b))
+
 ## [8.1.1-next.3](https://github.com/pie-framework/pie-elements/compare/@pie-element/image-cloze-association-configure@8.1.1-next.2...@pie-element/image-cloze-association-configure@8.1.1-next.3) (2026-03-06)
 
 **Note:** Version bump only for package @pie-element/image-cloze-association-configure

package/configure/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pie-element/image-cloze-association-configure",
   "private": true,
-  "version": "8.1.1-next.3",
+  "version": "8.1.1-next.4",
   "description": "",
   "main": "lib/index.js",
   "module": "src/index.js",
@@ -12,8 +12,8 @@
     "@mui/icons-material": "^7.3.4",
     "@mui/material": "^7.3.4",
     "@pie-framework/pie-configure-events": "^1.3.0",
-    "@pie-lib/config-ui": "12.2.0-next.13",
-    "@pie-lib/editable-html-tip-tap": "1.2.0-next.13",
+    "@pie-lib/config-ui": "12.2.0-next.17",
+    "@pie-lib/editable-html-tip-tap": "1.2.0-next.16",
     "debug": "^4.1.1",
     "prop-types": "^15.8.1",
     "react": "18.3.1",

package/controller/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [7.2.0-next.0](https://github.com/pie-framework/pie-elements/compare/@pie-element/image-cloze-association-controller@7.1.1-next.1...@pie-element/image-cloze-association-controller@7.2.0-next.0) (2026-03-18)
+
+### Bug Fixes
+
+- test - include trace log in score response for empty placements ([4a46588](https://github.com/pie-framework/pie-elements/commit/4a46588819250b6efb11b458ed415c6346e70c94))
+
+### Features
+
+- **image-cloze-association:** add trace log for scoring in outcome function PD-5437 ([c9e8e27](https://github.com/pie-framework/pie-elements/commit/c9e8e279113f144b9f316b2de833dbf9264884fd))
+
 ## [7.1.1-next.1](https://github.com/pie-framework/pie-elements/compare/@pie-element/image-cloze-association-controller@7.1.0-next.1...@pie-element/image-cloze-association-controller@7.1.1-next.1) (2026-02-26)
 
 **Note:** Version bump only for package @pie-element/image-cloze-association-controller

package/controller/lib/index.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.validate = exports.outcome = exports.normalize = exports.model = exports.isResponseCorrect = exports.getPartialScore = exports.createCorrectResponseSession = void 0;
+exports.validate = exports.outcome = exports.normalize = exports.model = exports.isResponseCorrect = exports.getPartialScore = exports.getLogTrace = exports.createCorrectResponseSession = void 0;
 var _debug = _interopRequireDefault(require("debug"));
 var _humps = require("humps");
 var _controllerUtils = require("@pie-lib/controller-utils");
@@ -173,20 +173,82 @@ const getScore = (config, session, env = {}) => {
   const correct = isDefaultOrAltResponseCorrect(config, session);
   return isPartialScoring ? getPartialScore(config, session) : correct ? 1 : 0;
 };
+
+/**
+ * Generates detailed trace log for scoring evaluation
+ * @param {Object} model - the question model
+ * @param {Object} session - the student session
+ * @param {Object} env - the environment
+ * @returns {Array} traceLog - array of trace messages
+ */
+const getLogTrace = (model, session, env) => {
+  const traceLog = [];
+  const {
+    answers
+  } = session || {};
+  const validResponse = model.validation?.validResponse?.value || [];
+  const totalContainers = validResponse.length;
+  traceLog.push(`${totalContainers} placement container(s) defined in this question.`);
+  if (answers && answers.length > 0) {
+    traceLog.push(`Student placed ${answers.length} image(s) into placement containers.`);
+    const answersByContainer = {};
+    answers.forEach(answer => {
+      if (!answersByContainer[answer.containerIndex]) {
+        answersByContainer[answer.containerIndex] = [];
+      }
+      answersByContainer[answer.containerIndex].push(answer.value);
+    });
+    validResponse.forEach((container, containerIndex) => {
+      const correctImages = container.images || [];
+      const studentImages = answersByContainer[containerIndex] || [];
+      if (correctImages.length > 0) {
+        if (studentImages.length === 0) {
+          traceLog.push(`Container ${containerIndex + 1}: student left empty (should contain ${correctImages.length} image(s)).`);
+        } else {
+          const correctCount = studentImages.filter(img => correctImages.includes(img)).length;
+          const incorrectCount = studentImages.length - correctCount;
+          if (correctCount > 0 && incorrectCount === 0) {
+            traceLog.push(`Container ${containerIndex + 1}: student placed ${correctCount} correct image(s).`);
+          } else if (correctCount === 0 && incorrectCount > 0) {
+            traceLog.push(`Container ${containerIndex + 1}: student placed ${incorrectCount} incorrect image(s).`);
+          } else {
+            traceLog.push(`Container ${containerIndex + 1}: student placed ${correctCount} correct and ${incorrectCount} incorrect image(s).`);
+          }
+        }
+      }
+    });
+  } else {
+    traceLog.push('Student did not place any images into placement containers.');
+  }
+  const altResponses = model.validation?.altResponses || [];
+  if (altResponses.length > 0) {
+    traceLog.push(`${altResponses.length} alternate response combination(s) are accepted for this question.`);
+  }
+  const partialScoringEnabled = _controllerUtils.partialScoring.enabled(model, env);
+  const scoringMethod = partialScoringEnabled ? 'partial scoring' : 'all-or-nothing scoring';
+  traceLog.push(`Score calculated using ${scoringMethod}.`);
+  const score = getScore(model, session, env);
+  traceLog.push(`Final score: ${score}.`);
+  return traceLog;
+};
+exports.getLogTrace = getLogTrace;
 const outcome = (config, session, env = {}) => {
   return new Promise(resolve => {
     log('outcome...');
     if (!session || (0, _lodashEs.isEmpty)(session)) {
       resolve({
         score: 0,
-        empty: true
+        empty: true,
+        traceLog: ['Student did not place any images into placement containers. Score is 0.']
       });
-    }
-    const configCamelized = (0, _humps.camelizeKeys)(config);
-    if (session.answers || []) {
+    } else {
+      const configCamelized = (0, _humps.camelizeKeys)(config);
+      const traceLog = getLogTrace(configCamelized, session, env);
       const score = getScore(configCamelized, session, env);
       resolve({
-        score
+        score,
+        empty: false,
+        traceLog
       });
     }
   });

package/controller/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_debug","_interopRequireDefault","require","_humps","_controllerUtils","_lodashEs","_defaults","_utils","log","debug","normalize","question","defaults","exports","model","session","env","questionNormalized","questionCamelized","camelizeKeys","Promise","resolve","shouldIncludeCorrectResponse","mode","responseAreasToBeFilled","possibleResponses","completeResponses","hasUnplacedChoices","getCompleteResponseDetails","validation","out","disabled","responseCorrect","getScore","undefined","shuffle","possible_responses","role","teacherInstructions","teacherInstructionsEnabled","rationale","isResponseCorrect","correctResponses","responses","cloneDeep","isCorrect","totalValidResponses","isEmpty","forEach","value","images","length","answers","answer","index","containerIndex","indexOf","splice","keepNonEmptyResponses","filtered","filter","response","isDefaultOrAltResponseCorrect","altResponses","validResponse","altResponse","getDeductionPerContainer","valid","totalStack","item","incorrectStack","maxValid","ignored","slice","getPartialScore","maxResponsePerZone","correctAnswers","incorrectAnswers","all","getAllUniqueCorrectness","deductionList","id","nonEmptyResponses","denominator","str","toFixed","parseFloat","config","isPartialScoring","partialScoring","enabled","correct","outcome","score","empty","configCamelized","createCorrectResponseSession","valid_response","container","i","v","push","getInnerText","html","replaceAll","getContent","replace","validate","errors","field","required"],"sources":["../src/index.js"],"sourcesContent":["import debug from 'debug';\nimport { camelizeKeys } from 'humps';\nimport { partialScoring } from '@pie-lib/controller-utils';\nimport { cloneDeep, isEmpty, shuffle } from 'lodash-es';\n\nimport defaults from './defaults';\nimport { getAllUniqueCorrectness, getCompleteResponseDetails } from './utils';\n\nconst log = debug('pie-elements:image-cloze-association:controller');\n\nexport const normalize = (question) => ({ ...defaults, ...question });\n\nexport const model = (question, session, env) => {\n  const questionNormalized = normalize(question);\n  const questionCamelized = camelizeKeys(questionNormalized);\n\n  return new Promise((resolve) => {\n    const shouldIncludeCorrectResponse = env.mode === 'evaluate';\n\n    const {\n      responseAreasToBeFilled,\n      possibleResponses: completeResponses,\n      hasUnplacedChoices,\n    } = getCompleteResponseDetails(questionCamelized.validation, questionCamelized.possibleResponses);\n\n    const out = {\n      disabled: env.mode !== 'gather',\n      mode: env.mode,\n      ...questionCamelized,\n      responseCorrect: shouldIncludeCorrectResponse ? getScore(questionCamelized, session) === 1 : undefined,\n      validation: shouldIncludeCorrectResponse ? questionCamelized.validation : undefined,\n      responseAreasToBeFilled,\n      completeResponses,\n      hasUnplacedChoices,\n    };\n\n    if (questionNormalized.shuffle) {\n      out.possibleResponses = shuffle(questionNormalized.possible_responses);\n    }\n\n    if (env.role === 'instructor' && (env.mode === 'view' || env.mode === 'evaluate')) {\n      out.teacherInstructions = questionCamelized.teacherInstructionsEnabled\n        ? questionCamelized.teacherInstructions\n        : null;\n      out.rationale = questionCamelized.rationale ? questionCamelized.rationale : null;\n    } else {\n      out.teacherInstructions = null;\n      out.rationale = null;\n    }\n\n    resolve(out);\n  });\n};\n\nexport const isResponseCorrect = (correctResponses, session) => {\n  const responses = cloneDeep(correctResponses);\n  let isCorrect = true;\n  let totalValidResponses = 0;\n\n  if (!session || isEmpty(session)) {\n    return false;\n  }\n\n  responses.forEach((value) => (totalValidResponses += (value.images || []).length));\n\n  if (session.answers && totalValidResponses === session.answers.length) {\n    session.answers.forEach((answer) => {\n      const index = (responses[answer.containerIndex]?.images || []).indexOf(answer.value);\n\n      if (index >= 0) {\n        // remove response from correct responses array to ensure that duplicates are evaluated correctly\n        responses[answer.containerIndex].images.splice(index, 1);\n      } else {\n        isCorrect = false;\n      }\n    });\n  } else {\n    isCorrect = false;\n  }\n\n  return isCorrect;\n};\n\n// This applies for correct responses that have empty values\nconst keepNonEmptyResponses = (responses) => {\n  const filtered = responses.filter((response) => response.images && response.images.length);\n  return cloneDeep(filtered);\n};\n\n// This applies for items that don't support partial scoring.\nconst isDefaultOrAltResponseCorrect = (question, session) => {\n  const {\n    validation: { altResponses },\n  } = question;\n  let {\n    validation: {\n      validResponse: { value },\n    },\n  } = question;\n\n  let isCorrect = isResponseCorrect(value, session);\n\n  // Look for correct answers in alternate responses.\n  if (!isCorrect && altResponses && altResponses.length) {\n    altResponses.forEach((altResponse) => {\n      if (isResponseCorrect(altResponse.value, session)) {\n        isCorrect = true;\n      }\n    });\n  }\n  return isCorrect;\n};\n\n// Deduct only the items that exceeded the maximum valid response per container.\nconst getDeductionPerContainer = (containerIndex, answers, valid) => {\n  const totalStack = answers.filter((item) => item.containerIndex === containerIndex);\n  const incorrectStack = totalStack.filter((item) => !item.isCorrect);\n  const maxValid = (valid.value[containerIndex].images || []).length;\n\n  if (totalStack.length > maxValid) {\n    const ignored = totalStack.length - maxValid;\n    return incorrectStack.slice(-ignored);\n  }\n  return [];\n};\n\nexport const getPartialScore = (question, session) => {\n  const {\n    validation: { validResponse },\n    maxResponsePerZone,\n  } = question;\n  let correctAnswers = 0;\n  let incorrectAnswers = 0;\n  let possibleResponses = 0;\n\n  if (!session || isEmpty(session)) {\n    return 0;\n  }\n\n  validResponse.value.forEach((value) => (possibleResponses += (value.images || []).length));\n\n  if (session.answers && session.answers.length) {\n    const all = getAllUniqueCorrectness(session.answers, validResponse.value);\n    correctAnswers = all.filter((item) => item.isCorrect).length;\n    incorrectAnswers = all.filter((item) => !item.isCorrect).length;\n\n    // deduction rules: https://docs.google.com/document/d/1Oprm8Qs5fg_Dwoj2pNpsfu4D63QgCZgvcqTgeaVel7I/edit\n    session.answers.forEach((answer) => {\n      if (maxResponsePerZone > 1) {\n        const deductionList = getDeductionPerContainer(answer.containerIndex, all, validResponse);\n\n        if (deductionList.length) {\n          deductionList.forEach((item) => {\n            if (item.id === answer.id) {\n              correctAnswers -= 1;\n            }\n          });\n        }\n      }\n    });\n\n    if (!maxResponsePerZone || maxResponsePerZone <= 1) {\n      correctAnswers -= incorrectAnswers;\n    }\n  } else {\n    correctAnswers = 0;\n  }\n  // negative values will implicitly make the score equal to zero\n  correctAnswers = correctAnswers < 0 ? 0 : correctAnswers;\n\n  // use length of validResponse since some containers can be left empty\n  const nonEmptyResponses = keepNonEmptyResponses(validResponse.value);\n  const denominator = maxResponsePerZone > 1 ? possibleResponses : (nonEmptyResponses || []).length;\n  const str = (correctAnswers / denominator).toFixed(2);\n\n  return parseFloat(str);\n};\n\nconst getScore = (config, session, env = {}) => {\n  const isPartialScoring = partialScoring.enabled(config, env);\n  const correct = isDefaultOrAltResponseCorrect(config, session);\n\n  return isPartialScoring ? getPartialScore(config, session) : correct ? 1 : 0;\n};\n\nexport const outcome = (config, session, env = {}) => {\n  return new Promise((resolve) => {\n    log('outcome...');\n    if (!session || isEmpty(session)) {\n      resolve({ score: 0, empty: true });\n    }\n\n    const configCamelized = camelizeKeys(config);\n\n    if (session.answers || []) {\n      const score = getScore(configCamelized, session, env);\n      resolve({ score });\n    }\n  });\n};\n\nexport const createCorrectResponseSession = (question, env) => {\n  return new Promise((resolve) => {\n    if (env.mode !== 'evaluate' && env.role === 'instructor') {\n      const {\n        validation: {\n          valid_response: { value },\n        },\n      } = question;\n      const answers = [];\n\n      if (value) {\n        value.forEach((container, i) => {\n          (container.images || []).forEach((v) => {\n            answers.push({\n              value: v,\n              containerIndex: i,\n            });\n          });\n        });\n      }\n\n      resolve({\n        answers,\n        id: '1',\n      });\n    } else {\n      resolve(null);\n    }\n  });\n};\n\n// remove all html tags\nconst getInnerText = (html) => (html || '').replaceAll(/<[^>]*>/g, '');\n\n// remove all html tags except img, iframe and source tag for audio\nconst getContent = (html) => (html || '').replace(/(<(?!img|iframe|source)([^>]+)>)/gi, '');\n\nexport const validate = (model = {}, config = {}) => {\n  const errors = {};\n\n  ['teacherInstructions'].forEach((field) => {\n    if (config[field]?.required && !getContent(model[field])) {\n      errors[field] = 'This field is required.';\n    }\n  });\n\n  return errors;\n};\n"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AACA,IAAAE,gBAAA,GAAAF,OAAA;AACA,IAAAG,SAAA,GAAAH,OAAA;AAEA,IAAAI,SAAA,GAAAL,sBAAA,CAAAC,OAAA;AACA,IAAAK,MAAA,GAAAL,OAAA;AAEA,MAAMM,GAAG,GAAG,IAAAC,cAAK,EAAC,iDAAiD,CAAC;AAE7D,MAAMC,SAAS,GAAIC,QAAQ,KAAM;EAAE,GAAGC,iBAAQ;EAAE,GAAGD;AAAS,CAAC,CAAC;AAACE,OAAA,CAAAH,SAAA,GAAAA,SAAA;AAE/D,MAAMI,KAAK,GAAGA,CAACH,QAAQ,EAAEI,OAAO,EAAEC,GAAG,KAAK;EAC/C,MAAMC,kBAAkB,GAAGP,SAAS,CAACC,QAAQ,CAAC;EAC9C,MAAMO,iBAAiB,GAAG,IAAAC,mBAAY,EAACF,kBAAkB,CAAC;EAE1D,OAAO,IAAIG,OAAO,CAAEC,OAAO,IAAK;IAC9B,MAAMC,4BAA4B,GAAGN,GAAG,CAACO,IAAI,KAAK,UAAU;IAE5D,MAAM;MACJC,uBAAuB;MACvBC,iBAAiB,EAAEC,iBAAiB;MACpCC;IACF,CAAC,GAAG,IAAAC,iCAA0B,EAACV,iBAAiB,CAACW,UAAU,EAAEX,iBAAiB,CAACO,iBAAiB,CAAC;IAEjG,MAAMK,GAAG,GAAG;MACVC,QAAQ,EAAEf,GAAG,CAACO,IAAI,KAAK,QAAQ;MAC/BA,IAAI,EAAEP,GAAG,CAACO,IAAI;MACd,GAAGL,iBAAiB;MACpBc,eAAe,EAAEV,4BAA4B,GAAGW,QAAQ,CAACf,iBAAiB,EAAEH,OAAO,CAAC,KAAK,CAAC,GAAGmB,SAAS;MACtGL,UAAU,EAAEP,4BAA4B,GAAGJ,iBAAiB,CAACW,UAAU,GAAGK,SAAS;MACnFV,uBAAuB;MACvBE,iBAAiB;MACjBC;IACF,CAAC;IAED,IAAIV,kBAAkB,CAACkB,OAAO,EAAE;MAC9BL,GAAG,CAACL,iBAAiB,GAAG,IAAAU,iBAAO,EAAClB,kBAAkB,CAACmB,kBAAkB,CAAC;IACxE;IAEA,IAAIpB,GAAG,CAACqB,IAAI,KAAK,YAAY,KAAKrB,GAAG,CAACO,IAAI,KAAK,MAAM,IAAIP,GAAG,CAACO,IAAI,KAAK,UAAU,CAAC,EAAE;MACjFO,GAAG,CAACQ,mBAAmB,GAAGpB,iBAAiB,CAACqB,0BAA0B,GAClErB,iBAAiB,CAACoB,mBAAmB,GACrC,IAAI;MACRR,GAAG,CAACU,SAAS,GAAGtB,iBAAiB,CAACsB,SAAS,GAAGtB,iBAAiB,CAACsB,SAAS,GAAG,IAAI;IAClF,CAAC,MAAM;MACLV,GAAG,CAACQ,mBAAmB,GAAG,IAAI;MAC9BR,GAAG,CAACU,SAAS,GAAG,IAAI;IACtB;IAEAnB,OAAO,CAACS,GAAG,CAAC;EACd,CAAC,CAAC;AACJ,CAAC;AAACjB,OAAA,CAAAC,KAAA,GAAAA,KAAA;AAEK,MAAM2B,iBAAiB,GAAGA,CAACC,gBAAgB,EAAE3B,OAAO,KAAK;EAC9D,MAAM4B,SAAS,GAAG,IAAAC,mBAAS,EAACF,gBAAgB,CAAC;EAC7C,IAAIG,SAAS,GAAG,IAAI;EACpB,IAAIC,mBAAmB,GAAG,CAAC;EAE3B,IAAI,CAAC/B,OAAO,IAAI,IAAAgC,iBAAO,EAAChC,OAAO,CAAC,EAAE;IAChC,OAAO,KAAK;EACd;EAEA4B,SAAS,CAACK,OAAO,CAAEC,KAAK,IAAMH,mBAAmB,IAAI,CAACG,KAAK,CAACC,MAAM,IAAI,EAAE,EAAEC,MAAO,CAAC;EAElF,IAAIpC,OAAO,CAACqC,OAAO,IAAIN,mBAAmB,KAAK/B,OAAO,CAACqC,OAAO,CAACD,MAAM,EAAE;IACrEpC,OAAO,CAACqC,OAAO,CAACJ,OAAO,CAAEK,MAAM,IAAK;MAClC,MAAMC,KAAK,GAAG,CAACX,SAAS,CAACU,MAAM,CAACE,cAAc,CAAC,EAAEL,MAAM,IAAI,EAAE,EAAEM,OAAO,CAACH,MAAM,CAACJ,KAAK,CAAC;MAEpF,IAAIK,KAAK,IAAI,CAAC,EAAE;QACd;QACAX,SAAS,CAACU,MAAM,CAACE,cAAc,CAAC,CAACL,MAAM,CAACO,MAAM,CAACH,KAAK,EAAE,CAAC,CAAC;MAC1D,CAAC,MAAM;QACLT,SAAS,GAAG,KAAK;MACnB;IACF,CAAC,CAAC;EACJ,CAAC,MAAM;IACLA,SAAS,GAAG,KAAK;EACnB;EAEA,OAAOA,SAAS;AAClB,CAAC;;AAED;AAAAhC,OAAA,CAAA4B,iBAAA,GAAAA,iBAAA;AACA,MAAMiB,qBAAqB,GAAIf,SAAS,IAAK;EAC3C,MAAMgB,QAAQ,GAAGhB,SAAS,CAACiB,MAAM,CAAEC,QAAQ,IAAKA,QAAQ,CAACX,MAAM,IAAIW,QAAQ,CAACX,MAAM,CAACC,MAAM,CAAC;EAC1F,OAAO,IAAAP,mBAAS,EAACe,QAAQ,CAAC;AAC5B,CAAC;;AAED;AACA,MAAMG,6BAA6B,GAAGA,CAACnD,QAAQ,EAAEI,OAAO,KAAK;EAC3D,MAAM;IACJc,UAAU,EAAE;MAAEkC;IAAa;EAC7B,CAAC,GAAGpD,QAAQ;EACZ,IAAI;IACFkB,UAAU,EAAE;MACVmC,aAAa,EAAE;QAAEf;MAAM;IACzB;EACF,CAAC,GAAGtC,QAAQ;EAEZ,IAAIkC,SAAS,GAAGJ,iBAAiB,CAACQ,KAAK,EAAElC,OAAO,CAAC;;EAEjD;EACA,IAAI,CAAC8B,SAAS,IAAIkB,YAAY,IAAIA,YAAY,CAACZ,MAAM,EAAE;IACrDY,YAAY,CAACf,OAAO,CAAEiB,WAAW,IAAK;MACpC,IAAIxB,iBAAiB,CAACwB,WAAW,CAAChB,KAAK,EAAElC,OAAO,CAAC,EAAE;QACjD8B,SAAS,GAAG,IAAI;MAClB;IACF,CAAC,CAAC;EACJ;EACA,OAAOA,SAAS;AAClB,CAAC;;AAED;AACA,MAAMqB,wBAAwB,GAAGA,CAACX,cAAc,EAAEH,OAAO,EAAEe,KAAK,KAAK;EACnE,MAAMC,UAAU,GAAGhB,OAAO,CAACQ,MAAM,CAAES,IAAI,IAAKA,IAAI,CAACd,cAAc,KAAKA,cAAc,CAAC;EACnF,MAAMe,cAAc,GAAGF,UAAU,CAACR,MAAM,CAAES,IAAI,IAAK,CAACA,IAAI,CAACxB,SAAS,CAAC;EACnE,MAAM0B,QAAQ,GAAG,CAACJ,KAAK,CAAClB,KAAK,CAACM,cAAc,CAAC,CAACL,MAAM,IAAI,EAAE,EAAEC,MAAM;EAElE,IAAIiB,UAAU,CAACjB,MAAM,GAAGoB,QAAQ,EAAE;IAChC,MAAMC,OAAO,GAAGJ,UAAU,CAACjB,MAAM,GAAGoB,QAAQ;IAC5C,OAAOD,cAAc,CAACG,KAAK,CAAC,CAACD,OAAO,CAAC;EACvC;EACA,OAAO,EAAE;AACX,CAAC;AAEM,MAAME,eAAe,GAAGA,CAAC/D,QAAQ,EAAEI,OAAO,KAAK;EACpD,MAAM;IACJc,UAAU,EAAE;MAAEmC;IAAc,CAAC;IAC7BW;EACF,CAAC,GAAGhE,QAAQ;EACZ,IAAIiE,cAAc,GAAG,CAAC;EACtB,IAAIC,gBAAgB,GAAG,CAAC;EACxB,IAAIpD,iBAAiB,GAAG,CAAC;EAEzB,IAAI,CAACV,OAAO,IAAI,IAAAgC,iBAAO,EAAChC,OAAO,CAAC,EAAE;IAChC,OAAO,CAAC;EACV;EAEAiD,aAAa,CAACf,KAAK,CAACD,OAAO,CAAEC,KAAK,IAAMxB,iBAAiB,IAAI,CAACwB,KAAK,CAACC,MAAM,IAAI,EAAE,EAAEC,MAAO,CAAC;EAE1F,IAAIpC,OAAO,CAACqC,OAAO,IAAIrC,OAAO,CAACqC,OAAO,CAACD,MAAM,EAAE;IAC7C,MAAM2B,GAAG,GAAG,IAAAC,8BAAuB,EAAChE,OAAO,CAACqC,OAAO,EAAEY,aAAa,CAACf,KAAK,CAAC;IACzE2B,cAAc,GAAGE,GAAG,CAAClB,MAAM,CAAES,IAAI,IAAKA,IAAI,CAACxB,SAAS,CAAC,CAACM,MAAM;IAC5D0B,gBAAgB,GAAGC,GAAG,CAAClB,MAAM,CAAES,IAAI,IAAK,CAACA,IAAI,CAACxB,SAAS,CAAC,CAACM,MAAM;;IAE/D;IACApC,OAAO,CAACqC,OAAO,CAACJ,OAAO,CAAEK,MAAM,IAAK;MAClC,IAAIsB,kBAAkB,GAAG,CAAC,EAAE;QAC1B,MAAMK,aAAa,GAAGd,wBAAwB,CAACb,MAAM,CAACE,cAAc,EAAEuB,GAAG,EAAEd,aAAa,CAAC;QAEzF,IAAIgB,aAAa,CAAC7B,MAAM,EAAE;UACxB6B,aAAa,CAAChC,OAAO,CAAEqB,IAAI,IAAK;YAC9B,IAAIA,IAAI,CAACY,EAAE,KAAK5B,MAAM,CAAC4B,EAAE,EAAE;cACzBL,cAAc,IAAI,CAAC;YACrB;UACF,CAAC,CAAC;QACJ;MACF;IACF,CAAC,CAAC;IAEF,IAAI,CAACD,kBAAkB,IAAIA,kBAAkB,IAAI,CAAC,EAAE;MAClDC,cAAc,IAAIC,gBAAgB;IACpC;EACF,CAAC,MAAM;IACLD,cAAc,GAAG,CAAC;EACpB;EACA;EACAA,cAAc,GAAGA,cAAc,GAAG,CAAC,GAAG,CAAC,GAAGA,cAAc;;EAExD;EACA,MAAMM,iBAAiB,GAAGxB,qBAAqB,CAACM,aAAa,CAACf,KAAK,CAAC;EACpE,MAAMkC,WAAW,GAAGR,kBAAkB,GAAG,CAAC,GAAGlD,iBAAiB,GAAG,CAACyD,iBAAiB,IAAI,EAAE,EAAE/B,MAAM;EACjG,MAAMiC,GAAG,GAAG,CAACR,cAAc,GAAGO,WAAW,EAAEE,OAAO,CAAC,CAAC,CAAC;EAErD,OAAOC,UAAU,CAACF,GAAG,CAAC;AACxB,CAAC;AAACvE,OAAA,CAAA6D,eAAA,GAAAA,eAAA;AAEF,MAAMzC,QAAQ,GAAGA,CAACsD,MAAM,EAAExE,OAAO,EAAEC,GAAG,GAAG,CAAC,CAAC,KAAK;EAC9C,MAAMwE,gBAAgB,GAAGC,+BAAc,CAACC,OAAO,CAACH,MAAM,EAAEvE,GAAG,CAAC;EAC5D,MAAM2E,OAAO,GAAG7B,6BAA6B,CAACyB,MAAM,EAAExE,OAAO,CAAC;EAE9D,OAAOyE,gBAAgB,GAAGd,eAAe,CAACa,MAAM,EAAExE,OAAO,CAAC,GAAG4E,OAAO,GAAG,CAAC,GAAG,CAAC;AAC9E,CAAC;AAEM,MAAMC,OAAO,GAAGA,CAACL,MAAM,EAAExE,OAAO,EAAEC,GAAG,GAAG,CAAC,CAAC,KAAK;EACpD,OAAO,IAAII,OAAO,CAAEC,OAAO,IAAK;IAC9Bb,GAAG,CAAC,YAAY,CAAC;IACjB,IAAI,CAACO,OAAO,IAAI,IAAAgC,iBAAO,EAAChC,OAAO,CAAC,EAAE;MAChCM,OAAO,CAAC;QAAEwE,KAAK,EAAE,CAAC;QAAEC,KAAK,EAAE;MAAK,CAAC,CAAC;IACpC;IAEA,MAAMC,eAAe,GAAG,IAAA5E,mBAAY,EAACoE,MAAM,CAAC;IAE5C,IAAIxE,OAAO,CAACqC,OAAO,IAAI,EAAE,EAAE;MACzB,MAAMyC,KAAK,GAAG5D,QAAQ,CAAC8D,eAAe,EAAEhF,OAAO,EAAEC,GAAG,CAAC;MACrDK,OAAO,CAAC;QAAEwE;MAAM,CAAC,CAAC;IACpB;EACF,CAAC,CAAC;AACJ,CAAC;AAAChF,OAAA,CAAA+E,OAAA,GAAAA,OAAA;AAEK,MAAMI,4BAA4B,GAAGA,CAACrF,QAAQ,EAAEK,GAAG,KAAK;EAC7D,OAAO,IAAII,OAAO,CAAEC,OAAO,IAAK;IAC9B,IAAIL,GAAG,CAACO,IAAI,KAAK,UAAU,IAAIP,GAAG,CAACqB,IAAI,KAAK,YAAY,EAAE;MACxD,MAAM;QACJR,UAAU,EAAE;UACVoE,cAAc,EAAE;YAAEhD;UAAM;QAC1B;MACF,CAAC,GAAGtC,QAAQ;MACZ,MAAMyC,OAAO,GAAG,EAAE;MAElB,IAAIH,KAAK,EAAE;QACTA,KAAK,CAACD,OAAO,CAAC,CAACkD,SAAS,EAAEC,CAAC,KAAK;UAC9B,CAACD,SAAS,CAAChD,MAAM,IAAI,EAAE,EAAEF,OAAO,CAAEoD,CAAC,IAAK;YACtChD,OAAO,CAACiD,IAAI,CAAC;cACXpD,KAAK,EAAEmD,CAAC;cACR7C,cAAc,EAAE4C;YAClB,CAAC,CAAC;UACJ,CAAC,CAAC;QACJ,CAAC,CAAC;MACJ;MAEA9E,OAAO,CAAC;QACN+B,OAAO;QACP6B,EAAE,EAAE;MACN,CAAC,CAAC;IACJ,CAAC,MAAM;MACL5D,OAAO,CAAC,IAAI,CAAC;IACf;EACF,CAAC,CAAC;AACJ,CAAC;;AAED;AAAAR,OAAA,CAAAmF,4BAAA,GAAAA,4BAAA;AACA,MAAMM,YAAY,GAAIC,IAAI,IAAK,CAACA,IAAI,IAAI,EAAE,EAAEC,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC;;AAEtE;AACA,MAAMC,UAAU,GAAIF,IAAI,IAAK,CAACA,IAAI,IAAI,EAAE,EAAEG,OAAO,CAAC,oCAAoC,EAAE,EAAE,CAAC;AAEpF,MAAMC,QAAQ,GAAGA,CAAC7F,KAAK,GAAG,CAAC,CAAC,EAAEyE,MAAM,GAAG,CAAC,CAAC,KAAK;EACnD,MAAMqB,MAAM,GAAG,CAAC,CAAC;EAEjB,CAAC,qBAAqB,CAAC,CAAC5D,OAAO,CAAE6D,KAAK,IAAK;IACzC,IAAItB,MAAM,CAACsB,KAAK,CAAC,EAAEC,QAAQ,IAAI,CAACL,UAAU,CAAC3F,KAAK,CAAC+F,KAAK,CAAC,CAAC,EAAE;MACxDD,MAAM,CAACC,KAAK,CAAC,GAAG,yBAAyB;IAC3C;EACF,CAAC,CAAC;EAEF,OAAOD,MAAM;AACf,CAAC;AAAC/F,OAAA,CAAA8F,QAAA,GAAAA,QAAA","ignoreList":[]}
+{"version":3,"file":"index.js","names":["_debug","_interopRequireDefault","require","_humps","_controllerUtils","_lodashEs","_defaults","_utils","log","debug","normalize","question","defaults","exports","model","session","env","questionNormalized","questionCamelized","camelizeKeys","Promise","resolve","shouldIncludeCorrectResponse","mode","responseAreasToBeFilled","possibleResponses","completeResponses","hasUnplacedChoices","getCompleteResponseDetails","validation","out","disabled","responseCorrect","getScore","undefined","shuffle","possible_responses","role","teacherInstructions","teacherInstructionsEnabled","rationale","isResponseCorrect","correctResponses","responses","cloneDeep","isCorrect","totalValidResponses","isEmpty","forEach","value","images","length","answers","answer","index","containerIndex","indexOf","splice","keepNonEmptyResponses","filtered","filter","response","isDefaultOrAltResponseCorrect","altResponses","validResponse","altResponse","getDeductionPerContainer","valid","totalStack","item","incorrectStack","maxValid","ignored","slice","getPartialScore","maxResponsePerZone","correctAnswers","incorrectAnswers","all","getAllUniqueCorrectness","deductionList","id","nonEmptyResponses","denominator","str","toFixed","parseFloat","config","isPartialScoring","partialScoring","enabled","correct","getLogTrace","traceLog","totalContainers","push","answersByContainer","container","correctImages","studentImages","correctCount","img","includes","incorrectCount","partialScoringEnabled","scoringMethod","score","outcome","empty","configCamelized","createCorrectResponseSession","valid_response","i","v","getInnerText","html","replaceAll","getContent","replace","validate","errors","field","required"],"sources":["../src/index.js"],"sourcesContent":["import debug from 'debug';\nimport { camelizeKeys } from 'humps';\nimport { partialScoring } from '@pie-lib/controller-utils';\nimport { cloneDeep, isEmpty, shuffle } from 'lodash-es';\n\nimport defaults from './defaults';\nimport { getAllUniqueCorrectness, getCompleteResponseDetails } from './utils';\n\nconst log = debug('pie-elements:image-cloze-association:controller');\n\nexport const normalize = (question) => ({ ...defaults, ...question });\n\nexport const model = (question, session, env) => {\n  const questionNormalized = normalize(question);\n  const questionCamelized = camelizeKeys(questionNormalized);\n\n  return new Promise((resolve) => {\n    const shouldIncludeCorrectResponse = env.mode === 'evaluate';\n\n    const {\n      responseAreasToBeFilled,\n      possibleResponses: completeResponses,\n      hasUnplacedChoices,\n    } = getCompleteResponseDetails(questionCamelized.validation, questionCamelized.possibleResponses);\n\n    const out = {\n      disabled: env.mode !== 'gather',\n      mode: env.mode,\n      ...questionCamelized,\n      responseCorrect: shouldIncludeCorrectResponse ? getScore(questionCamelized, session) === 1 : undefined,\n      validation: shouldIncludeCorrectResponse ? questionCamelized.validation : undefined,\n      responseAreasToBeFilled,\n      completeResponses,\n      hasUnplacedChoices,\n    };\n\n    if (questionNormalized.shuffle) {\n      out.possibleResponses = shuffle(questionNormalized.possible_responses);\n    }\n\n    if (env.role === 'instructor' && (env.mode === 'view' || env.mode === 'evaluate')) {\n      out.teacherInstructions = questionCamelized.teacherInstructionsEnabled\n        ? questionCamelized.teacherInstructions\n        : null;\n      out.rationale = questionCamelized.rationale ? questionCamelized.rationale : null;\n    } else {\n      out.teacherInstructions = null;\n      out.rationale = null;\n    }\n\n    resolve(out);\n  });\n};\n\nexport const isResponseCorrect = (correctResponses, session) => {\n  const responses = cloneDeep(correctResponses);\n  let isCorrect = true;\n  let totalValidResponses = 0;\n\n  if (!session || isEmpty(session)) {\n    return false;\n  }\n\n  responses.forEach((value) => (totalValidResponses += (value.images || []).length));\n\n  if (session.answers && totalValidResponses === session.answers.length) {\n    session.answers.forEach((answer) => {\n      const index = (responses[answer.containerIndex]?.images || []).indexOf(answer.value);\n\n      if (index >= 0) {\n        // remove response from correct responses array to ensure that duplicates are evaluated correctly\n        responses[answer.containerIndex].images.splice(index, 1);\n      } else {\n        isCorrect = false;\n      }\n    });\n  } else {\n    isCorrect = false;\n  }\n\n  return isCorrect;\n};\n\n// This applies for correct responses that have empty values\nconst keepNonEmptyResponses = (responses) => {\n  const filtered = responses.filter((response) => response.images && response.images.length);\n  return cloneDeep(filtered);\n};\n\n// This applies for items that don't support partial scoring.\nconst isDefaultOrAltResponseCorrect = (question, session) => {\n  const {\n    validation: { altResponses },\n  } = question;\n  let {\n    validation: {\n      validResponse: { value },\n    },\n  } = question;\n\n  let isCorrect = isResponseCorrect(value, session);\n\n  // Look for correct answers in alternate responses.\n  if (!isCorrect && altResponses && altResponses.length) {\n    altResponses.forEach((altResponse) => {\n      if (isResponseCorrect(altResponse.value, session)) {\n        isCorrect = true;\n      }\n    });\n  }\n  return isCorrect;\n};\n\n// Deduct only the items that exceeded the maximum valid response per container.\nconst getDeductionPerContainer = (containerIndex, answers, valid) => {\n  const totalStack = answers.filter((item) => item.containerIndex === containerIndex);\n  const incorrectStack = totalStack.filter((item) => !item.isCorrect);\n  const maxValid = (valid.value[containerIndex].images || []).length;\n\n  if (totalStack.length > maxValid) {\n    const ignored = totalStack.length - maxValid;\n    return incorrectStack.slice(-ignored);\n  }\n  return [];\n};\n\nexport const getPartialScore = (question, session) => {\n  const {\n    validation: { validResponse },\n    maxResponsePerZone,\n  } = question;\n  let correctAnswers = 0;\n  let incorrectAnswers = 0;\n  let possibleResponses = 0;\n\n  if (!session || isEmpty(session)) {\n    return 0;\n  }\n\n  validResponse.value.forEach((value) => (possibleResponses += (value.images || []).length));\n\n  if (session.answers && session.answers.length) {\n    const all = getAllUniqueCorrectness(session.answers, validResponse.value);\n    correctAnswers = all.filter((item) => item.isCorrect).length;\n    incorrectAnswers = all.filter((item) => !item.isCorrect).length;\n\n    // deduction rules: https://docs.google.com/document/d/1Oprm8Qs5fg_Dwoj2pNpsfu4D63QgCZgvcqTgeaVel7I/edit\n    session.answers.forEach((answer) => {\n      if (maxResponsePerZone > 1) {\n        const deductionList = getDeductionPerContainer(answer.containerIndex, all, validResponse);\n\n        if (deductionList.length) {\n          deductionList.forEach((item) => {\n            if (item.id === answer.id) {\n              correctAnswers -= 1;\n            }\n          });\n        }\n      }\n    });\n\n    if (!maxResponsePerZone || maxResponsePerZone <= 1) {\n      correctAnswers -= incorrectAnswers;\n    }\n  } else {\n    correctAnswers = 0;\n  }\n  // negative values will implicitly make the score equal to zero\n  correctAnswers = correctAnswers < 0 ? 0 : correctAnswers;\n\n  // use length of validResponse since some containers can be left empty\n  const nonEmptyResponses = keepNonEmptyResponses(validResponse.value);\n  const denominator = maxResponsePerZone > 1 ? possibleResponses : (nonEmptyResponses || []).length;\n  const str = (correctAnswers / denominator).toFixed(2);\n\n  return parseFloat(str);\n};\n\nconst getScore = (config, session, env = {}) => {\n  const isPartialScoring = partialScoring.enabled(config, env);\n  const correct = isDefaultOrAltResponseCorrect(config, session);\n\n  return isPartialScoring ? getPartialScore(config, session) : correct ? 1 : 0;\n};\n\n/**\n * Generates detailed trace log for scoring evaluation\n * @param {Object} model - the question model\n * @param {Object} session - the student session\n * @param {Object} env - the environment\n * @returns {Array} traceLog - array of trace messages\n */\nexport const getLogTrace = (model, session, env) => {\n  const traceLog = [];\n  const { answers } = session || {};\n  \n  const validResponse = model.validation?.validResponse?.value || [];\n  const totalContainers = validResponse.length;\n  traceLog.push(`${totalContainers} placement container(s) defined in this question.`);\n\n  if (answers && answers.length > 0) {\n    traceLog.push(`Student placed ${answers.length} image(s) into placement containers.`);\n    \n    const answersByContainer = {};\n    answers.forEach((answer) => {\n      if (!answersByContainer[answer.containerIndex]) {\n        answersByContainer[answer.containerIndex] = [];\n      }\n      answersByContainer[answer.containerIndex].push(answer.value);\n    });\n    \n    validResponse.forEach((container, containerIndex) => {\n      const correctImages = container.images || [];\n      const studentImages = answersByContainer[containerIndex] || [];\n      \n      if (correctImages.length > 0) {\n        if (studentImages.length === 0) {\n          traceLog.push(`Container ${containerIndex + 1}: student left empty (should contain ${correctImages.length} image(s)).`);\n        } else {\n          const correctCount = studentImages.filter(img => correctImages.includes(img)).length;\n          const incorrectCount = studentImages.length - correctCount;\n          \n          if (correctCount > 0 && incorrectCount === 0) {\n            traceLog.push(`Container ${containerIndex + 1}: student placed ${correctCount} correct image(s).`);\n          } else if (correctCount === 0 && incorrectCount > 0) {\n            traceLog.push(`Container ${containerIndex + 1}: student placed ${incorrectCount} incorrect image(s).`);\n          } else {\n            traceLog.push(`Container ${containerIndex + 1}: student placed ${correctCount} correct and ${incorrectCount} incorrect image(s).`);\n          }\n        }\n      }\n    });\n  } else {\n    traceLog.push('Student did not place any images into placement containers.');\n  }\n\n  const altResponses = model.validation?.altResponses || [];\n  if (altResponses.length > 0) {\n    traceLog.push(`${altResponses.length} alternate response combination(s) are accepted for this question.`);\n  }\n\n  const partialScoringEnabled = partialScoring.enabled(model, env);\n  const scoringMethod = partialScoringEnabled ? 'partial scoring' : 'all-or-nothing scoring';\n  traceLog.push(`Score calculated using ${scoringMethod}.`);\n\n  const score = getScore(model, session, env);\n  traceLog.push(`Final score: ${score}.`);\n\n  return traceLog;\n}\n\nexport const outcome = (config, session, env = {}) => {\n  return new Promise((resolve) => {\n    log('outcome...');\n    if (!session || isEmpty(session)) {\n      resolve({ \n        score: 0, \n        empty: true, \n        traceLog: ['Student did not place any images into placement containers. Score is 0.'] \n      });\n    } else {\n      const configCamelized = camelizeKeys(config);\n      const traceLog = getLogTrace(configCamelized, session, env);\n      const score = getScore(configCamelized, session, env);\n      \n      resolve({ \n        score, \n        empty: false,\n        traceLog \n      });\n    }\n  });\n};\n\nexport const createCorrectResponseSession = (question, env) => {\n  return new Promise((resolve) => {\n    if (env.mode !== 'evaluate' && env.role === 'instructor') {\n      const {\n        validation: {\n          valid_response: { value },\n        },\n      } = question;\n      const answers = [];\n\n      if (value) {\n        value.forEach((container, i) => {\n          (container.images || []).forEach((v) => {\n            answers.push({\n              value: v,\n              containerIndex: i,\n            });\n          });\n        });\n      }\n\n      resolve({\n        answers,\n        id: '1',\n      });\n    } else {\n      resolve(null);\n    }\n  });\n};\n\n// remove all html tags\nconst getInnerText = (html) => (html || '').replaceAll(/<[^>]*>/g, '');\n\n// remove all html tags except img, iframe and source tag for audio\nconst getContent = (html) => (html || '').replace(/(<(?!img|iframe|source)([^>]+)>)/gi, '');\n\nexport const validate = (model = {}, config = {}) => {\n  const errors = {};\n\n  ['teacherInstructions'].forEach((field) => {\n    if (config[field]?.required && !getContent(model[field])) {\n      errors[field] = 'This field is required.';\n    }\n  });\n\n  return errors;\n};\n"],"mappings":"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","ignoreList":[]}

package/controller/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pie-element/image-cloze-association-controller",
   "private": true,
-  "version": "7.1.1-next.1",
+  "version": "7.2.0-next.0",
   "description": "",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"

package/controller/src/__tests__/index.test.js

@@ -135,7 +135,7 @@ describe('controller', () => {
     const returnOutcome = (session) => {
       it(`returns score of 0 and empty: true if session is ${JSON.stringify(session)}`, async () => {
         const result = await outcome(question, session);
-        expect(result).toEqual({ score: 0, empty: true });
+        expect(result).toEqual({ score: 0, empty: true, traceLog: ['Student did not place any images into placement containers. Score is 0.'] });
       });
     };
 

package/controller/src/index.js

@@ -183,18 +183,91 @@ const getScore = (config, session, env = {}) => {
   return isPartialScoring ? getPartialScore(config, session) : correct ? 1 : 0;
 };
 
+/**
+ * Generates detailed trace log for scoring evaluation
+ * @param {Object} model - the question model
+ * @param {Object} session - the student session
+ * @param {Object} env - the environment
+ * @returns {Array} traceLog - array of trace messages
+ */
+export const getLogTrace = (model, session, env) => {
+  const traceLog = [];
+  const { answers } = session || {};
+  
+  const validResponse = model.validation?.validResponse?.value || [];
+  const totalContainers = validResponse.length;
+  traceLog.push(`${totalContainers} placement container(s) defined in this question.`);
+
+  if (answers && answers.length > 0) {
+    traceLog.push(`Student placed ${answers.length} image(s) into placement containers.`);
+    
+    const answersByContainer = {};
+    answers.forEach((answer) => {
+      if (!answersByContainer[answer.containerIndex]) {
+        answersByContainer[answer.containerIndex] = [];
+      }
+      answersByContainer[answer.containerIndex].push(answer.value);
+    });
+    
+    validResponse.forEach((container, containerIndex) => {
+      const correctImages = container.images || [];
+      const studentImages = answersByContainer[containerIndex] || [];
+      
+      if (correctImages.length > 0) {
+        if (studentImages.length === 0) {
+          traceLog.push(`Container ${containerIndex + 1}: student left empty (should contain ${correctImages.length} image(s)).`);
+        } else {
+          const correctCount = studentImages.filter(img => correctImages.includes(img)).length;
+          const incorrectCount = studentImages.length - correctCount;
+          
+          if (correctCount > 0 && incorrectCount === 0) {
+            traceLog.push(`Container ${containerIndex + 1}: student placed ${correctCount} correct image(s).`);
+          } else if (correctCount === 0 && incorrectCount > 0) {
+            traceLog.push(`Container ${containerIndex + 1}: student placed ${incorrectCount} incorrect image(s).`);
+          } else {
+            traceLog.push(`Container ${containerIndex + 1}: student placed ${correctCount} correct and ${incorrectCount} incorrect image(s).`);
+          }
+        }
+      }
+    });
+  } else {
+    traceLog.push('Student did not place any images into placement containers.');
+  }
+
+  const altResponses = model.validation?.altResponses || [];
+  if (altResponses.length > 0) {
+    traceLog.push(`${altResponses.length} alternate response combination(s) are accepted for this question.`);
+  }
+
+  const partialScoringEnabled = partialScoring.enabled(model, env);
+  const scoringMethod = partialScoringEnabled ? 'partial scoring' : 'all-or-nothing scoring';
+  traceLog.push(`Score calculated using ${scoringMethod}.`);
+
+  const score = getScore(model, session, env);
+  traceLog.push(`Final score: ${score}.`);
+
+  return traceLog;
+}
+
 export const outcome = (config, session, env = {}) => {
   return new Promise((resolve) => {
     log('outcome...');
     if (!session || isEmpty(session)) {
-      resolve({ score: 0, empty: true });
-    }
-
-    const configCamelized = camelizeKeys(config);
-
-    if (session.answers || []) {
+      resolve({ 
+        score: 0, 
+        empty: true, 
+        traceLog: ['Student did not place any images into placement containers. Score is 0.'] 
+      });
+    } else {
+      const configCamelized = camelizeKeys(config);
+      const traceLog = getLogTrace(configCamelized, session, env);
       const score = getScore(configCamelized, session, env);
-      resolve({ score });
+      
+      resolve({ 
+        score, 
+        empty: false,
+        traceLog 
+      });
     }
   });
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pie-element/image-cloze-association",
   "repository": "pie-framework/pie-elements",
-  "version": "9.1.2-next.4",
+  "version": "9.2.0-next.0",
   "description": "",
   "publishConfig": {
     "access": "public"
@@ -26,7 +26,7 @@
   },
   "author": "pie framework developers",
   "license": "ISC",
-  "gitHead": "a8b257ceb051bf973d80b1ae19138ae99117346b",
+  "gitHead": "c4198b2dfd0bfa1847c515a0c95c39147398395c",
   "scripts": {
     "postpublish": "../../scripts/postpublish"
   },