@pie-element/multiple-choice 14.0.4-next.20261011174919 → 14.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/author/defaults.d.ts +60 -58
- package/dist/author/index.d.ts +19 -11
- package/dist/author/index.js +6 -1
- package/dist/author/main.d.ts +30 -19
- package/dist/author/main.js +121 -133
- package/dist/author/utils.d.ts +2 -1
- package/dist/browser/author/index.js +15 -23
- package/dist/browser/author/index.js.map +1 -1
- package/dist/browser/controller/index.js +9 -8
- package/dist/browser/controller/index.js.map +1 -1
- package/dist/browser/editor-runtime/author/index.js +15 -23
- package/dist/browser/editor-runtime/author/index.js.map +1 -1
- package/dist/browser/editor-runtime/controller/index.js +9 -8
- package/dist/browser/editor-runtime/controller/index.js.map +1 -1
- package/dist/controller/defaults.d.ts +13 -13
- package/dist/controller/index.d.ts +103 -32
- package/dist/controller/index.js +9 -8
- package/dist/controller/utils.d.ts +3 -2
- package/dist/index.d.ts +1 -0
- package/dist/schemas/configuration.schema.json +447 -0
- package/dist/schemas/model.schema.json +567 -0
- package/dist/schemas/session.schema.json +30 -0
- package/dist/types.d.ts +243 -0
- package/package.json +18 -14
|
@@ -77,13 +77,13 @@ function p(e, t, n) {
|
|
|
77
77
|
//#endregion
|
|
78
78
|
//#region src/controller/index.ts
|
|
79
79
|
var m = (e, t, n) => (r) => {
|
|
80
|
-
let
|
|
80
|
+
let i = t?.role, a = t?.mode, o = {
|
|
81
81
|
label: r.label,
|
|
82
82
|
value: r.value
|
|
83
83
|
};
|
|
84
84
|
if (i === "instructor" && (a === "view" || a === "evaluate") ? o.rationale = e.rationaleEnabled ? r.rationale : null : o.rationale = null, a === "evaluate" && (o.correct = !!r.correct, e.feedbackEnabled)) {
|
|
85
85
|
let e = r.feedback && r.feedback.type || "none";
|
|
86
|
-
e === "default" ? o.feedback = n[r.correct ? "correct" : "incorrect"] : e === "custom" && (o.feedback = r.feedback
|
|
86
|
+
e === "default" ? o.feedback = n[r.correct ? "correct" : "incorrect"] : e === "custom" && (o.feedback = r.feedback?.value);
|
|
87
87
|
}
|
|
88
88
|
return o;
|
|
89
89
|
};
|
|
@@ -107,7 +107,8 @@ async function _(e, t, n, i) {
|
|
|
107
107
|
incorrect: "Incorrect"
|
|
108
108
|
}, a.defaultFeedback), s = (a.choices || []).map(m(a, n, o));
|
|
109
109
|
d(a, t, n) || (s = await u(s, t, i, "value"));
|
|
110
|
-
let c =
|
|
110
|
+
let { role: c, mode: l } = n;
|
|
111
|
+
return {
|
|
111
112
|
disabled: n.mode !== "gather",
|
|
112
113
|
mode: n.mode,
|
|
113
114
|
prompt: a.promptEnabled ? a.prompt : null,
|
|
@@ -132,13 +133,13 @@ async function _(e, t, n, i) {
|
|
|
132
133
|
keyboardEventsEnabled: a.keyboardEventsEnabled,
|
|
133
134
|
autoplayAudioEnabled: a.autoplayAudioEnabled,
|
|
134
135
|
completeAudioEnabled: a.completeAudioEnabled,
|
|
135
|
-
customAudioButton: a.customAudioButton
|
|
136
|
-
|
|
137
|
-
|
|
136
|
+
customAudioButton: a.customAudioButton,
|
|
137
|
+
teacherInstructions: c === "instructor" && (l === "view" || l === "evaluate") && a.teacherInstructionsEnabled ? a.teacherInstructions : null
|
|
138
|
+
};
|
|
138
139
|
}
|
|
139
140
|
var v = (e, n) => {
|
|
140
141
|
if (!n || t(n)) return 0;
|
|
141
|
-
let r = n
|
|
142
|
+
let r = n?.value || [], i = (e.choices || []).filter((e) => e.correct), a = r.reduce((e, t) => e + +!!i.find((e) => e.value === t), 0);
|
|
142
143
|
i.length < r.length && (a -= r.length - i.length, a < 0 && (a = 0));
|
|
143
144
|
let o = i.length ? a / i.length : 0;
|
|
144
145
|
return parseFloat(o.toFixed(2));
|
|
@@ -191,7 +192,7 @@ var x = (e, t) => new Promise((n) => {
|
|
|
191
192
|
r && (u = !0, d++), S(a) ? o.slice(t + 1).some((e) => e.label === a) && (s[i] = "Content should be unique.") : s[i] = "Content should not be empty.", n.rationale?.required && !S(l) && (c[i] = "This field is required.");
|
|
192
193
|
});
|
|
193
194
|
let f = (r || []).length;
|
|
194
|
-
if (f < i ? l.answerChoices = `There should be at least ${i} choices defined.` : f > a && (l.answerChoices = `No more than ${a} choices should be defined.`), !u) l.correctResponse = "No correct response defined.";
|
|
195
|
+
if (f < i ? l.answerChoices = `There should be at least ${i} choices defined.` : a !== void 0 && f > a && (l.answerChoices = `No more than ${a} choices should be defined.`), !u) l.correctResponse = "No correct response defined.";
|
|
195
196
|
else {
|
|
196
197
|
let { maxSelections: t, choiceMode: n } = e;
|
|
197
198
|
n !== "radio" && t != null && d > t && (l.correctResponse = `The number of correct answers (${d}) exceeds max selections (${t}). Students won't be able to select all correct answers.`);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../../../../src/controller/utils.ts","../../../../src/controller/defaults.ts","../../../../../../shared/controller-utils/dist/index.js","../../../../src/controller/index.ts"],"sourcesContent":["// @ts-nocheck\n\nimport { isEqual } from '@pie-element/shared-lodash';\n\nexport const getCorrectResponse = (choices) =>\n choices\n .filter((c) => c.correct)\n .map((c) => c.value)\n .sort();\n\nexport const isResponseCorrect = (question, session) => {\n let correctResponse = getCorrectResponse(question.choices);\n return session && isEqual((session.value || []).sort(), correctResponse);\n};\n","// @ts-nocheck\n\nexport default {\n choiceMode: 'checkbox',\n choicePrefix: 'letters',\n choices: [],\n choicesLayout: 'vertical',\n feedbackEnabled: false,\n gridColumns: 2,\n lockChoiceOrder: true,\n partialScoring: true,\n prompt: '',\n promptEnabled: true,\n rationale: '',\n rationaleEnabled: true,\n scoringType: 'auto',\n studentInstructionsEnabled: true,\n teacherInstructions: '',\n teacherInstructionsEnabled: true,\n toolbarEditorPosition: 'bottom',\n selectedAnswerBackgroundColor: 'initial',\n selectedAnswerStrokeColor: 'initial',\n selectedAnswerStrokeWidth: 'initial',\n hoverAnswerBackgroundColor: 'initial',\n hoverAnswerStrokeColor: 'initial',\n hoverAnswerStrokeWidth: 'initial',\n keyboardEventsEnabled: false,\n};\n","//#region \\0rolldown/runtime.js\nvar e = Object.defineProperty, t = (t, n) => {\n\tlet r = {};\n\tfor (var i in t) e(r, i, {\n\t\tget: t[i],\n\t\tenumerable: !0\n\t});\n\treturn n || e(r, Symbol.toStringTag, { value: \"Module\" }), r;\n};\n//#endregion\n//#region src/persistence.ts\nfunction n(e) {\n\treturn Array.isArray(e) ? e.filter((e) => e != null) : [];\n}\nfunction r(e) {\n\tlet t = [...e];\n\tfor (let e = t.length - 1; e > 0; e--) {\n\t\tlet n = Math.floor(Math.random() * (e + 1));\n\t\t[t[e], t[n]] = [t[n], t[e]];\n\t}\n\treturn t;\n}\nfunction i(e) {\n\treturn e == null ? !0 : Array.isArray(e) ? e.length === 0 : typeof e == \"object\" && Object.keys(e).length === 0;\n}\nasync function a(e, t, a, o = \"value\") {\n\tlet s = n(t?.data?.shuffledValues ?? t?.shuffledValues ?? []);\n\tif (!t) {\n\t\tconsole.warn(\"Unable to save shuffled choices because there's no session.\");\n\t\treturn;\n\t}\n\tif (!i(s)) return n(s.map((t) => e.find((e) => e[o] === t)));\n\tlet c = r(e);\n\tif (a && typeof a == \"function\") try {\n\t\tlet e = n(c.map((e) => e[o]));\n\t\ti(e) ? console.error(`shuffledValues is an empty array - refusing to call updateSession. shuffledChoices: ${JSON.stringify(c)}, key: ${o}`) : await a(t.id, t.element, { shuffledValues: e });\n\t} catch (e) {\n\t\tconsole.warn(\"Unable to save shuffled order for choices\"), console.error(e);\n\t}\n\telse console.warn(\"Unable to save shuffled choices, shuffle will happen every time.\");\n\treturn c;\n}\nfunction o(e, t, n) {\n\treturn !!(e.lockChoiceOrder || n?.[\"@pie-element\"]?.lockChoiceOrder);\n}\n//#endregion\n//#region src/partial-scoring.ts\nvar s = /* @__PURE__ */ t({ enabled: () => c });\nfunction c(e, t, n) {\n\treturn e?.partialScoring === !1 || t?.partialScoring === !1 ? !1 : typeof n != \"boolean\" || n;\n}\n//#endregion\nexport { a as getShuffledChoices, o as lockChoices, s as partialScoring };\n","// @ts-nocheck\n\n/* eslint-disable no-console */\nimport { isEmpty } from '@pie-element/shared-lodash';\nimport { isResponseCorrect } from './utils.js';\nimport defaults from './defaults.js';\nimport { lockChoices, partialScoring, getShuffledChoices } from '@pie-element/shared-controller-utils';\n\nconst prepareChoice = (model, env, defaultFeedback) => (choice) => {\n const { role, mode } = env || {};\n const out = {\n label: choice.label,\n value: choice.value,\n };\n\n if (role === 'instructor' && (mode === 'view' || mode === 'evaluate')) {\n out.rationale = model.rationaleEnabled ? choice.rationale : null;\n } else {\n out.rationale = null;\n }\n\n if (mode === 'evaluate') {\n out.correct = !!choice.correct;\n\n if (model.feedbackEnabled) {\n const feedbackType = (choice.feedback && choice.feedback.type) || 'none';\n\n if (feedbackType === 'default') {\n out.feedback = defaultFeedback[choice.correct ? 'correct' : 'incorrect'];\n } else if (feedbackType === 'custom') {\n out.feedback = choice.feedback.value;\n }\n }\n }\n\n return out;\n};\n\nexport function createDefaultModel(model = {}) {\n return new Promise((resolve) => resolve({ ...defaults, ...model }));\n}\n\nexport const normalize = (question) => {\n const { verticalMode, choicesLayout, ...questionProps } = question || {};\n\n return {\n ...defaults,\n ...questionProps,\n // This is used for offering support for old models which have the property verticalMode\n // Same thing is set in authoring : packages/multiple-choice/configure/src/index.jsx - createDefaultModel\n choicesLayout: choicesLayout || (verticalMode === false && 'horizontal') || defaults.choicesLayout,\n };\n};\n\n/**\n *\n * @param {*} question\n * @param {*} session\n * @param {*} env\n * @param {*} updateSession - optional - a function that will set the properties passed into it on the session.\n */\nexport async function model(question, session, env, updateSession) {\n const normalizedQuestion = normalize(question);\n\n const defaultFeedback = Object.assign(\n { correct: 'Correct', incorrect: 'Incorrect' },\n normalizedQuestion.defaultFeedback,\n );\n\n let choices = (normalizedQuestion.choices || []).map(prepareChoice(normalizedQuestion, env, defaultFeedback));\n\n const lockChoiceOrder = lockChoices(normalizedQuestion, session, env);\n\n if (!lockChoiceOrder) {\n choices = await getShuffledChoices(choices, session, updateSession, 'value');\n }\n\n const out = {\n disabled: env.mode !== 'gather',\n mode: env.mode,\n prompt: normalizedQuestion.promptEnabled ? normalizedQuestion.prompt : null,\n choicesLayout: normalizedQuestion.choicesLayout,\n gridColumns: normalizedQuestion.gridColumns,\n choiceMode: normalizedQuestion.choiceMode,\n keyMode: normalizedQuestion.choicePrefix,\n choices,\n responseCorrect: env.mode === 'evaluate' ? isResponseCorrect(normalizedQuestion, session) : undefined,\n language: normalizedQuestion.language,\n extraCSSRules: normalizedQuestion.extraCSSRules,\n fontSizeFactor: normalizedQuestion.fontSizeFactor,\n isSelectionButtonBelow: normalizedQuestion.isSelectionButtonBelow,\n selectedAnswerBackgroundColor: normalizedQuestion.selectedAnswerBackgroundColor || 'initial',\n selectedAnswerStrokeColor: normalizedQuestion.selectedAnswerStrokeColor || 'initial',\n selectedAnswerStrokeWidth: normalizedQuestion.selectedAnswerStrokeWidth || 'initial',\n hoverAnswerBackgroundColor: normalizedQuestion.hoverAnswerBackgroundColor || 'initial',\n hoverAnswerStrokeColor: normalizedQuestion.hoverAnswerStrokeColor || 'initial',\n hoverAnswerStrokeWidth: normalizedQuestion.hoverAnswerStrokeWidth || 'initial',\n minSelections: normalizedQuestion.minSelections,\n maxSelections: normalizedQuestion.maxSelections,\n keyboardEventsEnabled: normalizedQuestion.keyboardEventsEnabled,\n autoplayAudioEnabled: normalizedQuestion.autoplayAudioEnabled,\n completeAudioEnabled: normalizedQuestion.completeAudioEnabled,\n customAudioButton: normalizedQuestion.customAudioButton,\n };\n\n const { role, mode } = env || {};\n\n if (role === 'instructor' && (mode === 'view' || mode === 'evaluate')) {\n out.teacherInstructions = normalizedQuestion.teacherInstructionsEnabled\n ? normalizedQuestion.teacherInstructions\n : null;\n } else {\n out.teacherInstructions = null;\n }\n\n return out;\n}\n\nexport const getScore = (config, session) => {\n if (!session || isEmpty(session)) {\n return 0;\n }\n\n const selectedChoices = session.value || [];\n const correctChoices = (config.choices || []).filter((ch) => ch.correct);\n\n let score = selectedChoices.reduce(\n (acc, selectedChoice) => acc + (correctChoices.find((ch) => ch.value === selectedChoice) ? 1 : 0),\n 0,\n );\n\n if (correctChoices.length < selectedChoices.length) {\n score -= selectedChoices.length - correctChoices.length;\n\n if (score < 0) {\n score = 0;\n }\n }\n\n const str = correctChoices.length ? score / correctChoices.length : 0;\n\n return parseFloat(str.toFixed(2));\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 selected = session?.value || [];\n \n const questionType = model.choiceMode === 'radio' ? 'multiple-choice (radio)' : 'multiple-select (checkbox)';\n traceLog.push(`Question type: ${questionType}.`);\n \n if (selected.length) {\n traceLog.push(`Student selected ${selected.length} answer(s): ${selected.join(', ')}.`);\n } else {\n traceLog.push('Student did not select any answers.');\n }\n\n const correctChoices = (model.choices || []).filter((c) => c.correct);\n const correctValues = correctChoices.map((c) => c.value);\n traceLog.push(`${correctChoices.length} correct answer(s) are defined for this question.`);\n \n if (selected.length) {\n const correctSelected = selected.filter((v) => correctValues.includes(v));\n const incorrectSelected = selected.filter((v) => !correctValues.includes(v));\n traceLog.push(\n `Student selected ${correctSelected.length} correct and ${incorrectSelected.length} incorrect answer(s).`\n );\n }\n\n const partialScoringEnabled = partialScoring.enabled(model, env) && model.choiceMode !== 'radio';\n const scoringMethod = partialScoringEnabled ? 'partial scoring' : 'all-or-nothing scoring';\n traceLog.push(`Score calculated using ${scoringMethod}.`);\n\n const score = getScore(model, session);\n traceLog.push(`Final score: ${score}.`);\n\n return traceLog;\n};\n\n/**\n *\n * The score is partial by default for checkbox mode, allOrNothing for radio mode.\n * To disable partial scoring for checkbox mode you either set model.partialScoring = false or env.partialScoring = false. the value in `env` will\n * override the value in `model`.\n * @param {Object} model - the main model\n * @param {*} session\n * @param {Object} env\n */\nexport function outcome(model, session, env) {\n return new Promise((resolve) => {\n if (!session || isEmpty(session)) {\n resolve({ score: 0, empty: true, traceLog: ['Student did not select any answers. Score is 0.'] });\n } else {\n const traceLog = getLogTrace(model, session, env);\n const score = getScore(model, session);\n const partialScoringEnabled = partialScoring.enabled(model, env) && model.choiceMode !== 'radio';\n\n resolve({ \n score: partialScoringEnabled ? score : score === 1 ? 1 : 0, \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 { choices } = question || { choices: [] };\n\n resolve({\n id: '1',\n value: choices.filter((c) => c.correct).map((c) => c.value),\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 { choices } = model;\n const { minAnswerChoices = 2, maxAnswerChoices } = config;\n const reversedChoices = [...(choices || [])].reverse();\n const choicesErrors = {};\n const rationaleErrors = {};\n const errors = {};\n\n ['teacherInstructions', 'prompt'].forEach((field) => {\n if (config[field]?.required && !getContent(model[field])) {\n errors[field] = 'This field is required.';\n }\n });\n\n let hasCorrectResponse = false;\n let correctCount = 0;\n\n reversedChoices.forEach((choice, index) => {\n const { correct, value, label, rationale } = choice;\n\n if (correct) {\n hasCorrectResponse = true;\n correctCount++;\n }\n\n if (!getContent(label)) {\n choicesErrors[value] = 'Content should not be empty.';\n } else {\n const identicalAnswer = reversedChoices.slice(index + 1).some((c) => c.label === label);\n\n if (identicalAnswer) {\n choicesErrors[value] = 'Content should be unique.';\n }\n }\n\n if (config.rationale?.required && !getContent(rationale)) {\n rationaleErrors[value] = 'This field is required.';\n }\n });\n\n const nbOfChoices = (choices || []).length;\n\n if (nbOfChoices < minAnswerChoices) {\n errors.answerChoices = `There should be at least ${minAnswerChoices} choices defined.`;\n } else if (nbOfChoices > maxAnswerChoices) {\n errors.answerChoices = `No more than ${maxAnswerChoices} choices should be defined.`;\n }\n\n if (!hasCorrectResponse) {\n errors.correctResponse = 'No correct response defined.';\n } else {\n const { maxSelections, choiceMode } = model;\n\n if (choiceMode !== 'radio' && maxSelections != null && correctCount > maxSelections) {\n errors.correctResponse = `The number of correct answers (${correctCount}) exceeds max selections (${maxSelections}). Students won't be able to select all correct answers.`;\n }\n }\n\n if (!isEmpty(choicesErrors)) {\n errors.choices = choicesErrors;\n }\n\n if (!isEmpty(rationaleErrors)) {\n errors.rationale = rationaleErrors;\n }\n\n return errors;\n};\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../../../../src/controller/utils.ts","../../../../src/controller/defaults.ts","../../../../../../shared/controller-utils/dist/index.js","../../../../src/controller/index.ts"],"sourcesContent":["import { isEqual } from '@pie-element/shared-lodash';\nimport type { Choice, MultipleChoiceModel, MultipleChoiceSession } from '../types.js';\n\nexport const getCorrectResponse = (choices: Choice[]) =>\n choices\n .filter((c) => c.correct)\n .map((c) => c.value)\n .sort();\n\nexport const isResponseCorrect = (question: MultipleChoiceModel, session: MultipleChoiceSession | undefined) => {\n let correctResponse = getCorrectResponse(question.choices);\n return session && isEqual((session.value || []).sort(), correctResponse);\n};\n","import type { MultipleChoiceModel } from '../types.js';\n\nexport default {\n choiceMode: 'checkbox',\n choicePrefix: 'letters',\n choices: [],\n choicesLayout: 'vertical',\n feedbackEnabled: false,\n gridColumns: 2,\n lockChoiceOrder: true,\n partialScoring: true,\n prompt: '',\n promptEnabled: true,\n rationale: '',\n rationaleEnabled: true,\n scoringType: 'auto',\n studentInstructionsEnabled: true,\n teacherInstructions: '',\n teacherInstructionsEnabled: true,\n toolbarEditorPosition: 'bottom',\n selectedAnswerBackgroundColor: 'initial',\n selectedAnswerStrokeColor: 'initial',\n selectedAnswerStrokeWidth: 'initial',\n hoverAnswerBackgroundColor: 'initial',\n hoverAnswerStrokeColor: 'initial',\n hoverAnswerStrokeWidth: 'initial',\n keyboardEventsEnabled: false,\n} satisfies Omit<MultipleChoiceModel, 'id' | 'element'>;\n","//#region \\0rolldown/runtime.js\nvar e = Object.defineProperty, t = (t, n) => {\n\tlet r = {};\n\tfor (var i in t) e(r, i, {\n\t\tget: t[i],\n\t\tenumerable: !0\n\t});\n\treturn n || e(r, Symbol.toStringTag, { value: \"Module\" }), r;\n};\n//#endregion\n//#region src/persistence.ts\nfunction n(e) {\n\treturn Array.isArray(e) ? e.filter((e) => e != null) : [];\n}\nfunction r(e) {\n\tlet t = [...e];\n\tfor (let e = t.length - 1; e > 0; e--) {\n\t\tlet n = Math.floor(Math.random() * (e + 1));\n\t\t[t[e], t[n]] = [t[n], t[e]];\n\t}\n\treturn t;\n}\nfunction i(e) {\n\treturn e == null ? !0 : Array.isArray(e) ? e.length === 0 : typeof e == \"object\" && Object.keys(e).length === 0;\n}\nasync function a(e, t, a, o = \"value\") {\n\tlet s = n(t?.data?.shuffledValues ?? t?.shuffledValues ?? []);\n\tif (!t) {\n\t\tconsole.warn(\"Unable to save shuffled choices because there's no session.\");\n\t\treturn;\n\t}\n\tif (!i(s)) return n(s.map((t) => e.find((e) => e[o] === t)));\n\tlet c = r(e);\n\tif (a && typeof a == \"function\") try {\n\t\tlet e = n(c.map((e) => e[o]));\n\t\ti(e) ? console.error(`shuffledValues is an empty array - refusing to call updateSession. shuffledChoices: ${JSON.stringify(c)}, key: ${o}`) : await a(t.id, t.element, { shuffledValues: e });\n\t} catch (e) {\n\t\tconsole.warn(\"Unable to save shuffled order for choices\"), console.error(e);\n\t}\n\telse console.warn(\"Unable to save shuffled choices, shuffle will happen every time.\");\n\treturn c;\n}\nfunction o(e, t, n) {\n\treturn !!(e.lockChoiceOrder || n?.[\"@pie-element\"]?.lockChoiceOrder);\n}\n//#endregion\n//#region src/partial-scoring.ts\nvar s = /* @__PURE__ */ t({ enabled: () => c });\nfunction c(e, t, n) {\n\treturn e?.partialScoring === !1 || t?.partialScoring === !1 ? !1 : typeof n != \"boolean\" || n;\n}\n//#endregion\nexport { a as getShuffledChoices, o as lockChoices, s as partialScoring };\n","/* eslint-disable no-console */\nimport { isEmpty } from '@pie-element/shared-lodash';\nimport type { PieEnvironment, PieUpdateSession } from '@pie-element/shared-types';\nimport { isResponseCorrect } from './utils.js';\nimport defaults from './defaults.js';\nimport { lockChoices, partialScoring, getShuffledChoices } from '@pie-element/shared-controller-utils';\nimport type {\n Choice,\n MultipleChoiceConfiguration,\n MultipleChoiceModel,\n MultipleChoiceSession,\n} from '../types.js';\n\ntype DefaultFeedback = { correct: string; incorrect: string };\n\n/** A choice as the delivery view receives it. */\ntype ChoiceView = {\n label: string;\n value: string;\n rationale?: string | null;\n correct?: boolean;\n feedback?: string;\n};\n\n/** Errors `validate()` reports, keyed by field; `choices` and `rationale` are keyed by choice value. */\nexport type MultipleChoiceValidationErrors = {\n teacherInstructions?: string;\n prompt?: string;\n answerChoices?: string;\n correctResponse?: string;\n choices?: Record<string, string>;\n rationale?: Record<string, string>;\n};\n\nconst prepareChoice =\n (model: MultipleChoiceModel, env: PieEnvironment | undefined, defaultFeedback: DefaultFeedback) =>\n (choice: Choice): ChoiceView => {\n const role = env?.role;\n const mode = env?.mode;\n const out: ChoiceView = {\n label: choice.label,\n value: choice.value,\n };\n\n if (role === 'instructor' && (mode === 'view' || mode === 'evaluate')) {\n out.rationale = model.rationaleEnabled ? choice.rationale : null;\n } else {\n out.rationale = null;\n }\n\n if (mode === 'evaluate') {\n out.correct = !!choice.correct;\n\n if (model.feedbackEnabled) {\n const feedbackType = (choice.feedback && choice.feedback.type) || 'none';\n\n if (feedbackType === 'default') {\n out.feedback = defaultFeedback[choice.correct ? 'correct' : 'incorrect'];\n } else if (feedbackType === 'custom') {\n out.feedback = choice.feedback?.value;\n }\n }\n }\n\n return out;\n};\n\nexport function createDefaultModel(model: Partial<MultipleChoiceModel> = {}) {\n return new Promise<Partial<MultipleChoiceModel>>((resolve) => resolve({ ...defaults, ...model }));\n}\n\nexport const normalize = (question: MultipleChoiceModel) => {\n const { verticalMode, choicesLayout, ...questionProps } = question || {};\n\n return {\n ...defaults,\n ...questionProps,\n // This is used for offering support for old models which have the property verticalMode\n // Same thing is set in authoring : packages/multiple-choice/configure/src/index.jsx - createDefaultModel\n choicesLayout: choicesLayout || (verticalMode === false && 'horizontal') || defaults.choicesLayout,\n };\n};\n\n/**\n *\n * @param {*} question\n * @param {*} session\n * @param {*} env\n * @param {*} updateSession - optional - a function that will set the properties passed into it on the session.\n */\nexport async function model(\n question: MultipleChoiceModel,\n session: MultipleChoiceSession | undefined,\n env: PieEnvironment,\n updateSession?: PieUpdateSession,\n) {\n const normalizedQuestion = normalize(question);\n\n const defaultFeedback = Object.assign(\n { correct: 'Correct', incorrect: 'Incorrect' },\n normalizedQuestion.defaultFeedback,\n );\n\n let choices: ChoiceView[] | undefined = (normalizedQuestion.choices || []).map(prepareChoice(normalizedQuestion, env, defaultFeedback));\n\n const lockChoiceOrder = lockChoices(normalizedQuestion, session, env);\n\n if (!lockChoiceOrder) {\n choices = await getShuffledChoices(choices, session, updateSession, 'value');\n }\n\n const { role, mode } = env;\n\n const out = {\n disabled: env.mode !== 'gather',\n mode: env.mode,\n prompt: normalizedQuestion.promptEnabled ? normalizedQuestion.prompt : null,\n choicesLayout: normalizedQuestion.choicesLayout,\n gridColumns: normalizedQuestion.gridColumns,\n choiceMode: normalizedQuestion.choiceMode,\n keyMode: normalizedQuestion.choicePrefix,\n choices,\n responseCorrect: env.mode === 'evaluate' ? isResponseCorrect(normalizedQuestion, session) : undefined,\n language: normalizedQuestion.language,\n extraCSSRules: normalizedQuestion.extraCSSRules,\n fontSizeFactor: normalizedQuestion.fontSizeFactor,\n isSelectionButtonBelow: normalizedQuestion.isSelectionButtonBelow,\n selectedAnswerBackgroundColor: normalizedQuestion.selectedAnswerBackgroundColor || 'initial',\n selectedAnswerStrokeColor: normalizedQuestion.selectedAnswerStrokeColor || 'initial',\n selectedAnswerStrokeWidth: normalizedQuestion.selectedAnswerStrokeWidth || 'initial',\n hoverAnswerBackgroundColor: normalizedQuestion.hoverAnswerBackgroundColor || 'initial',\n hoverAnswerStrokeColor: normalizedQuestion.hoverAnswerStrokeColor || 'initial',\n hoverAnswerStrokeWidth: normalizedQuestion.hoverAnswerStrokeWidth || 'initial',\n minSelections: normalizedQuestion.minSelections,\n maxSelections: normalizedQuestion.maxSelections,\n keyboardEventsEnabled: normalizedQuestion.keyboardEventsEnabled,\n autoplayAudioEnabled: normalizedQuestion.autoplayAudioEnabled,\n completeAudioEnabled: normalizedQuestion.completeAudioEnabled,\n customAudioButton: normalizedQuestion.customAudioButton,\n teacherInstructions:\n role === 'instructor' && (mode === 'view' || mode === 'evaluate') && normalizedQuestion.teacherInstructionsEnabled\n ? normalizedQuestion.teacherInstructions\n : null,\n };\n\n return out;\n}\n\nexport const getScore = (config: MultipleChoiceModel, session: MultipleChoiceSession | undefined) => {\n if (!session || isEmpty(session)) {\n return 0;\n }\n\n const selectedChoices = session?.value || [];\n const correctChoices = (config.choices || []).filter((ch) => ch.correct);\n\n let score = selectedChoices.reduce(\n (acc, selectedChoice) => acc + (correctChoices.find((ch) => ch.value === selectedChoice) ? 1 : 0),\n 0,\n );\n\n if (correctChoices.length < selectedChoices.length) {\n score -= selectedChoices.length - correctChoices.length;\n\n if (score < 0) {\n score = 0;\n }\n }\n\n const str = correctChoices.length ? score / correctChoices.length : 0;\n\n return parseFloat(str.toFixed(2));\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 = (\n model: MultipleChoiceModel,\n session: MultipleChoiceSession | undefined,\n env: PieEnvironment,\n) => {\n const traceLog: string[] = [];\n const selected = session?.value || [];\n \n const questionType = model.choiceMode === 'radio' ? 'multiple-choice (radio)' : 'multiple-select (checkbox)';\n traceLog.push(`Question type: ${questionType}.`);\n \n if (selected.length) {\n traceLog.push(`Student selected ${selected.length} answer(s): ${selected.join(', ')}.`);\n } else {\n traceLog.push('Student did not select any answers.');\n }\n\n const correctChoices = (model.choices || []).filter((c) => c.correct);\n const correctValues = correctChoices.map((c) => c.value);\n traceLog.push(`${correctChoices.length} correct answer(s) are defined for this question.`);\n \n if (selected.length) {\n const correctSelected = selected.filter((v) => correctValues.includes(v));\n const incorrectSelected = selected.filter((v) => !correctValues.includes(v));\n traceLog.push(\n `Student selected ${correctSelected.length} correct and ${incorrectSelected.length} incorrect answer(s).`\n );\n }\n\n const partialScoringEnabled = partialScoring.enabled(model, env) && model.choiceMode !== 'radio';\n const scoringMethod = partialScoringEnabled ? 'partial scoring' : 'all-or-nothing scoring';\n traceLog.push(`Score calculated using ${scoringMethod}.`);\n\n const score = getScore(model, session);\n traceLog.push(`Final score: ${score}.`);\n\n return traceLog;\n};\n\n/**\n *\n * The score is partial by default for checkbox mode, allOrNothing for radio mode.\n * To disable partial scoring for checkbox mode you either set model.partialScoring = false or env.partialScoring = false. the value in `env` will\n * override the value in `model`.\n * @param {Object} model - the main model\n * @param {*} session\n * @param {Object} env\n */\nexport function outcome(model: MultipleChoiceModel, session: MultipleChoiceSession | undefined, env: PieEnvironment) {\n return new Promise<{ score: number; empty: boolean; traceLog: string[] }>((resolve) => {\n if (!session || isEmpty(session)) {\n resolve({ score: 0, empty: true, traceLog: ['Student did not select any answers. Score is 0.'] });\n } else {\n const traceLog = getLogTrace(model, session, env);\n const score = getScore(model, session);\n const partialScoringEnabled = partialScoring.enabled(model, env) && model.choiceMode !== 'radio';\n\n resolve({ \n score: partialScoringEnabled ? score : score === 1 ? 1 : 0, \n empty: false, \n traceLog \n });\n }\n });\n}\n\nexport const createCorrectResponseSession = (question: MultipleChoiceModel, env: PieEnvironment) => {\n return new Promise<MultipleChoiceSession | null>((resolve) => {\n if (env.mode !== 'evaluate' && env.role === 'instructor') {\n const { choices } = question || { choices: [] };\n\n resolve({\n id: '1',\n value: choices.filter((c) => c.correct).map((c) => c.value),\n });\n } else {\n resolve(null);\n }\n });\n};\n\n// remove all html tags except img, iframe and source tag for audio\nconst getContent = (html: string | undefined) => (html || '').replace(/(<(?!img|iframe|source)([^>]+)>)/gi, '');\n\nexport const validate = (\n model: Partial<MultipleChoiceModel> = {},\n config: MultipleChoiceConfiguration = {},\n): MultipleChoiceValidationErrors => {\n const { choices } = model;\n const { minAnswerChoices = 2, maxAnswerChoices } = config;\n const reversedChoices = [...(choices || [])].reverse();\n const choicesErrors: Record<string, string> = {};\n const rationaleErrors: Record<string, string> = {};\n const errors: MultipleChoiceValidationErrors = {};\n\n (['teacherInstructions', 'prompt'] as const).forEach((field) => {\n if (config[field]?.required && !getContent(model[field])) {\n errors[field] = 'This field is required.';\n }\n });\n\n let hasCorrectResponse = false;\n let correctCount = 0;\n\n reversedChoices.forEach((choice, index) => {\n const { correct, value, label, rationale } = choice;\n\n if (correct) {\n hasCorrectResponse = true;\n correctCount++;\n }\n\n if (!getContent(label)) {\n choicesErrors[value] = 'Content should not be empty.';\n } else {\n const identicalAnswer = reversedChoices.slice(index + 1).some((c) => c.label === label);\n\n if (identicalAnswer) {\n choicesErrors[value] = 'Content should be unique.';\n }\n }\n\n if (config.rationale?.required && !getContent(rationale)) {\n rationaleErrors[value] = 'This field is required.';\n }\n });\n\n const nbOfChoices = (choices || []).length;\n\n if (nbOfChoices < minAnswerChoices) {\n errors.answerChoices = `There should be at least ${minAnswerChoices} choices defined.`;\n } else if (maxAnswerChoices !== undefined && nbOfChoices > maxAnswerChoices) {\n errors.answerChoices = `No more than ${maxAnswerChoices} choices should be defined.`;\n }\n\n if (!hasCorrectResponse) {\n errors.correctResponse = 'No correct response defined.';\n } else {\n const { maxSelections, choiceMode } = model;\n\n if (choiceMode !== 'radio' && maxSelections != null && correctCount > maxSelections) {\n errors.correctResponse = `The number of correct answers (${correctCount}) exceeds max selections (${maxSelections}). Students won't be able to select all correct answers.`;\n }\n }\n\n if (!isEmpty(choicesErrors)) {\n errors.choices = choicesErrors;\n }\n\n if (!isEmpty(rationaleErrors)) {\n errors.rationale = rationaleErrors;\n }\n\n return errors;\n};\n"],"mappings":";;AAGA,IAAa,KAAsB,MACjC,EACG,QAAQ,MAAM,EAAE,OAAO,CAAC,CACxB,KAAK,MAAM,EAAE,KAAK,CAAC,CACnB,KAAK,GAEG,KAAqB,GAA+B,MAA+C;CAC9G,IAAI,IAAkB,EAAmB,EAAS,OAAO;CACzD,OAAO,KAAW,GAAS,EAAQ,SAAS,CAAC,EAAA,CAAG,KAAK,GAAG,CAAe;AACzE,GCVA,IAAe;CACb,YAAY;CACZ,cAAc;CACd,SAAS,CAAC;CACV,eAAe;CACf,iBAAiB;CACjB,aAAa;CACb,iBAAiB;CACjB,gBAAgB;CAChB,QAAQ;CACR,eAAe;CACf,WAAW;CACX,kBAAkB;CAClB,aAAa;CACb,4BAA4B;CAC5B,qBAAqB;CACrB,4BAA4B;CAC5B,uBAAuB;CACvB,+BAA+B;CAC/B,2BAA2B;CAC3B,2BAA2B;CAC3B,4BAA4B;CAC5B,wBAAwB;CACxB,wBAAwB;CACxB,uBAAuB;AACzB,GC1BI,IAAI,OAAO,gBAAgB,KAAK,GAAG,MAAM;CAC5C,IAAI,IAAI,CAAC;CACT,KAAK,IAAI,KAAK,GAAG,EAAE,GAAG,GAAG;EACxB,KAAK,EAAE;EACP,YAAY,CAAC;CACd,CAAC;CACD,OAAO,KAAK,EAAE,GAAG,OAAO,aAAa,EAAE,OAAO,SAAS,CAAC,GAAG;AAC5D;AAGA,SAAS,EAAE,GAAG;CACb,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,QAAQ,MAAM,KAAK,IAAI,IAAI,CAAC;AACzD;AACA,SAAS,EAAE,GAAG;CACb,IAAI,IAAI,CAAC,GAAG,CAAC;CACb,KAAK,IAAI,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,KAAK;EACtC,IAAI,IAAI,KAAK,MAAM,KAAK,OAAO,KAAK,IAAI,EAAE;EAC1C,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE;CAC3B;CACA,OAAO;AACR;AACA,SAAS,EAAE,GAAG;CACb,OAAO,KAAK,OAAO,CAAC,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAE,WAAW,IAAI,OAAO,KAAK,YAAY,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW;AAC/G;AACA,eAAe,EAAE,GAAG,GAAG,GAAG,IAAI,SAAS;CACtC,IAAI,IAAI,EAAE,GAAG,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,CAAC;CAC5D,IAAI,CAAC,GAAG;EACP,QAAQ,KAAK,6DAA6D;EAC1E;CACD;CACA,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3D,IAAI,IAAI,EAAE,CAAC;CACX,IAAI,KAAK,OAAO,KAAK,YAAY,IAAI;EACpC,IAAI,IAAI,EAAE,EAAE,KAAK,MAAM,EAAE,EAAE,CAAC;EAC5B,EAAE,CAAC,IAAI,QAAQ,MAAM,uFAAuF,KAAK,UAAU,CAAC,EAAE,SAAS,GAAG,IAAI,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC7L,SAAS,GAAG;EACX,QAAQ,KAAK,2CAA2C,GAAG,QAAQ,MAAM,CAAC;CAC3E;MACK,QAAQ,KAAK,kEAAkE;CACpF,OAAO;AACR;AACA,SAAS,EAAE,GAAG,GAAG,GAAG;CACnB,OAAO,CAAC,EAAE,EAAE,mBAAmB,IAAI,eAAe,EAAE;AACrD;AAGA,IAAI,IAAoB,kBAAE,EAAE,eAAe,EAAE,CAAC;AAC9C,SAAS,EAAE,GAAG,GAAG,GAAG;CACnB,OAAO,GAAG,mBAAmB,CAAC,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,aAAa;AAC7F;;;AChBA,IAAM,KACH,GAA4B,GAAiC,OAC7D,MAA+B;CAChC,IAAM,IAAO,GAAK,MACZ,IAAO,GAAK,MACZ,IAAkB;EACtB,OAAO,EAAO;EACd,OAAO,EAAO;CAChB;CAQA,IANI,MAAS,iBAAiB,MAAS,UAAU,MAAS,cACxD,EAAI,YAAY,EAAM,mBAAmB,EAAO,YAAY,OAE5D,EAAI,YAAY,MAGd,MAAS,eACX,EAAI,UAAU,CAAC,CAAC,EAAO,SAEnB,EAAM,kBAAiB;EACzB,IAAM,IAAgB,EAAO,YAAY,EAAO,SAAS,QAAS;EAElE,AAAI,MAAiB,YACnB,EAAI,WAAW,EAAgB,EAAO,UAAU,YAAY,eACnD,MAAiB,aAC1B,EAAI,WAAW,EAAO,UAAU;CAEpC;CAGF,OAAO;AACT;AAEA,SAAgB,EAAmB,IAAsC,CAAC,GAAG;CAC3E,OAAO,IAAI,SAAuC,MAAY,EAAQ;EAAE,GAAG;EAAU,GAAG;CAAM,CAAC,CAAC;AAClG;AAEA,IAAa,KAAa,MAAkC;CAC1D,IAAM,EAAE,iBAAc,kBAAe,GAAG,MAAkB,KAAY,CAAC;CAEvE,OAAO;EACL,GAAG;EACH,GAAG;EAGH,eAAe,KAAkB,MAAiB,MAAS,gBAAiB,EAAS;CACvF;AACF;AASA,eAAsB,EACpB,GACA,GACA,GACA,GACA;CACA,IAAM,IAAqB,EAAU,CAAQ,GAEvC,IAAkB,OAAO,OAC7B;EAAE,SAAS;EAAW,WAAW;CAAY,GAC7C,EAAmB,eACrB,GAEI,KAAqC,EAAmB,WAAW,CAAC,EAAA,CAAG,IAAI,EAAc,GAAoB,GAAK,CAAe,CAAC;CAItI,AAFwB,EAAY,GAAoB,GAAS,CAE5D,MACH,IAAU,MAAM,EAAmB,GAAS,GAAS,GAAe,OAAO;CAG7E,IAAM,EAAE,SAAM,YAAS;CAkCvB,OAAO;EA/BL,UAAU,EAAI,SAAS;EACvB,MAAM,EAAI;EACV,QAAQ,EAAmB,gBAAgB,EAAmB,SAAS;EACvE,eAAe,EAAmB;EAClC,aAAa,EAAmB;EAChC,YAAY,EAAmB;EAC/B,SAAS,EAAmB;EAC5B;EACA,iBAAiB,EAAI,SAAS,aAAa,EAAkB,GAAoB,CAAO,IAAI,KAAA;EAC5F,UAAU,EAAmB;EAC7B,eAAe,EAAmB;EAClC,gBAAgB,EAAmB;EACnC,wBAAwB,EAAmB;EAC3C,+BAA+B,EAAmB,iCAAiC;EACnF,2BAA2B,EAAmB,6BAA6B;EAC3E,2BAA2B,EAAmB,6BAA6B;EAC3E,4BAA4B,EAAmB,8BAA8B;EAC7E,wBAAwB,EAAmB,0BAA0B;EACrE,wBAAwB,EAAmB,0BAA0B;EACrE,eAAe,EAAmB;EAClC,eAAe,EAAmB;EAClC,uBAAuB,EAAmB;EAC1C,sBAAsB,EAAmB;EACzC,sBAAsB,EAAmB;EACzC,mBAAmB,EAAmB;EACtC,qBACE,MAAS,iBAAiB,MAAS,UAAU,MAAS,eAAe,EAAmB,6BACpF,EAAmB,sBACnB;CAGD;AACT;AAEA,IAAa,KAAY,GAA6B,MAA+C;CACnG,IAAI,CAAC,KAAW,EAAQ,CAAO,GAC7B,OAAO;CAGT,IAAM,IAAkB,GAAS,SAAS,CAAC,GACrC,KAAkB,EAAO,WAAW,CAAC,EAAA,CAAG,QAAQ,MAAO,EAAG,OAAO,GAEnE,IAAQ,EAAgB,QACzB,GAAK,MAAmB,IAAO,KAAe,MAAM,MAAO,EAAG,UAAU,CAAc,GACvF,CACF;CAEA,AAAI,EAAe,SAAS,EAAgB,WAC1C,KAAS,EAAgB,SAAS,EAAe,QAE7C,IAAQ,MACV,IAAQ;CAIZ,IAAM,IAAM,EAAe,SAAS,IAAQ,EAAe,SAAS;CAEpE,OAAO,WAAW,EAAI,QAAQ,CAAC,CAAC;AAClC,GASa,KACX,GACA,GACA,MACG;CACH,IAAM,IAAqB,CAAC,GACtB,IAAW,GAAS,SAAS,CAAC,GAE9B,IAAe,EAAM,eAAe,UAAU,4BAA4B;CAGhF,AAFA,EAAS,KAAK,kBAAkB,EAAa,EAAE,GAE3C,EAAS,SACX,EAAS,KAAK,oBAAoB,EAAS,OAAO,cAAc,EAAS,KAAK,IAAI,EAAE,EAAE,IAEtF,EAAS,KAAK,qCAAqC;CAGrD,IAAM,KAAkB,EAAM,WAAW,CAAC,EAAA,CAAG,QAAQ,MAAM,EAAE,OAAO,GAC9D,IAAgB,EAAe,KAAK,MAAM,EAAE,KAAK;CAGvD,IAFA,EAAS,KAAK,GAAG,EAAe,OAAO,kDAAkD,GAErF,EAAS,QAAQ;EACnB,IAAM,IAAkB,EAAS,QAAQ,MAAM,EAAc,SAAS,CAAC,CAAC,GAClE,IAAoB,EAAS,QAAQ,MAAM,CAAC,EAAc,SAAS,CAAC,CAAC;EAC3E,EAAS,KACP,oBAAoB,EAAgB,OAAO,eAAe,EAAkB,OAAO,sBACrF;CACF;CAGA,IAAM,IADwB,EAAe,QAAQ,GAAO,CAAG,KAAK,EAAM,eAAe,UAC3C,oBAAoB;CAClE,EAAS,KAAK,0BAA0B,EAAc,EAAE;CAExD,IAAM,IAAQ,EAAS,GAAO,CAAO;CAGrC,OAFA,EAAS,KAAK,gBAAgB,EAAM,EAAE,GAE/B;AACT;AAWA,SAAgB,EAAQ,GAA4B,GAA4C,GAAqB;CACnH,OAAO,IAAI,SAAgE,MAAY;EACrF,IAAI,CAAC,KAAW,EAAQ,CAAO,GAC7B,EAAQ;GAAE,OAAO;GAAG,OAAO;GAAM,UAAU,CAAC,iDAAiD;EAAE,CAAC;OAC3F;GACL,IAAM,IAAW,EAAY,GAAO,GAAS,CAAG,GAC1C,IAAQ,EAAS,GAAO,CAAO;GAGrC,EAAQ;IACN,OAH4B,EAAe,QAAQ,GAAO,CAAG,KAAK,EAAM,eAAe,UAGxD,IAAQ,QAAU;IACjD,OAAO;IACP;GACF,CAAC;EACH;CACF,CAAC;AACH;AAEA,IAAa,KAAgC,GAA+B,MACnE,IAAI,SAAuC,MAAY;CAC5D,IAAI,EAAI,SAAS,cAAc,EAAI,SAAS,cAAc;EACxD,IAAM,EAAE,eAAY,KAAY,EAAE,SAAS,CAAC,EAAE;EAE9C,EAAQ;GACN,IAAI;GACJ,OAAO,EAAQ,QAAQ,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,MAAM,EAAE,KAAK;EAC5D,CAAC;CACH,OACE,EAAQ,IAAI;AAEhB,CAAC,GAIG,KAAc,OAA8B,KAAQ,GAAA,CAAI,QAAQ,sCAAsC,EAAE,GAEjG,KACX,IAAsC,CAAC,GACvC,IAAsC,CAAC,MACJ;CACnC,IAAM,EAAE,eAAY,GACd,EAAE,sBAAmB,GAAG,wBAAqB,GAC7C,IAAkB,CAAC,GAAI,KAAW,CAAC,CAAE,CAAC,CAAC,QAAQ,GAC/C,IAAwC,CAAC,GACzC,IAA0C,CAAC,GAC3C,IAAyC,CAAC;CAEhD,CAAE,uBAAuB,QAAQ,CAAC,CAAW,SAAS,MAAU;EAC9D,AAAI,EAAO,EAAM,EAAE,YAAY,CAAC,EAAW,EAAM,EAAM,MACrD,EAAO,KAAS;CAEpB,CAAC;CAED,IAAI,IAAqB,IACrB,IAAe;CAEnB,EAAgB,SAAS,GAAQ,MAAU;EACzC,IAAM,EAAE,YAAS,UAAO,UAAO,iBAAc;EAiB7C,AAfI,MACF,IAAqB,IACrB,MAGG,EAAW,CAAK,IAGK,EAAgB,MAAM,IAAQ,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,UAAU,CAE7E,MACF,EAAc,KAAS,+BALzB,EAAc,KAAS,gCASrB,EAAO,WAAW,YAAY,CAAC,EAAW,CAAS,MACrD,EAAgB,KAAS;CAE7B,CAAC;CAED,IAAM,KAAe,KAAW,CAAC,EAAA,CAAG;CAQpC,IANI,IAAc,IAChB,EAAO,gBAAgB,4BAA4B,EAAiB,qBAC3D,MAAqB,KAAA,KAAa,IAAc,MACzD,EAAO,gBAAgB,gBAAgB,EAAiB,+BAGtD,CAAC,GACH,EAAO,kBAAkB;MACpB;EACL,IAAM,EAAE,kBAAe,kBAAe;EAEtC,AAAI,MAAe,WAAW,KAAiB,QAAQ,IAAe,MACpE,EAAO,kBAAkB,kCAAkC,EAAa,4BAA4B,EAAc;CAEtH;CAUA,OARK,EAAQ,CAAa,MACxB,EAAO,UAAU,IAGd,EAAQ,CAAe,MAC1B,EAAO,YAAY,IAGd;AACT"}
|
|
@@ -1,27 +1,27 @@
|
|
|
1
1
|
declare const _default: {
|
|
2
|
-
choiceMode:
|
|
3
|
-
choicePrefix:
|
|
2
|
+
choiceMode: "checkbox";
|
|
3
|
+
choicePrefix: "letters";
|
|
4
4
|
choices: never[];
|
|
5
|
-
choicesLayout:
|
|
6
|
-
feedbackEnabled:
|
|
5
|
+
choicesLayout: "vertical";
|
|
6
|
+
feedbackEnabled: false;
|
|
7
7
|
gridColumns: number;
|
|
8
|
-
lockChoiceOrder:
|
|
9
|
-
partialScoring:
|
|
8
|
+
lockChoiceOrder: true;
|
|
9
|
+
partialScoring: true;
|
|
10
10
|
prompt: string;
|
|
11
|
-
promptEnabled:
|
|
11
|
+
promptEnabled: true;
|
|
12
12
|
rationale: string;
|
|
13
|
-
rationaleEnabled:
|
|
14
|
-
scoringType:
|
|
15
|
-
studentInstructionsEnabled:
|
|
13
|
+
rationaleEnabled: true;
|
|
14
|
+
scoringType: "auto";
|
|
15
|
+
studentInstructionsEnabled: true;
|
|
16
16
|
teacherInstructions: string;
|
|
17
|
-
teacherInstructionsEnabled:
|
|
18
|
-
toolbarEditorPosition:
|
|
17
|
+
teacherInstructionsEnabled: true;
|
|
18
|
+
toolbarEditorPosition: "bottom";
|
|
19
19
|
selectedAnswerBackgroundColor: string;
|
|
20
20
|
selectedAnswerStrokeColor: string;
|
|
21
21
|
selectedAnswerStrokeWidth: string;
|
|
22
22
|
hoverAnswerBackgroundColor: string;
|
|
23
23
|
hoverAnswerStrokeColor: string;
|
|
24
24
|
hoverAnswerStrokeWidth: string;
|
|
25
|
-
keyboardEventsEnabled:
|
|
25
|
+
keyboardEventsEnabled: false;
|
|
26
26
|
};
|
|
27
27
|
export default _default;
|
|
@@ -1,5 +1,70 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
1
|
+
import type { PieEnvironment, PieUpdateSession } from '@pie-element/shared-types';
|
|
2
|
+
import type { Choice, MultipleChoiceConfiguration, MultipleChoiceModel, MultipleChoiceSession } from '../types.js';
|
|
3
|
+
/** A choice as the delivery view receives it. */
|
|
4
|
+
type ChoiceView = {
|
|
5
|
+
label: string;
|
|
6
|
+
value: string;
|
|
7
|
+
rationale?: string | null;
|
|
8
|
+
correct?: boolean;
|
|
9
|
+
feedback?: string;
|
|
10
|
+
};
|
|
11
|
+
/** Errors `validate()` reports, keyed by field; `choices` and `rationale` are keyed by choice value. */
|
|
12
|
+
export type MultipleChoiceValidationErrors = {
|
|
13
|
+
teacherInstructions?: string;
|
|
14
|
+
prompt?: string;
|
|
15
|
+
answerChoices?: string;
|
|
16
|
+
correctResponse?: string;
|
|
17
|
+
choices?: Record<string, string>;
|
|
18
|
+
rationale?: Record<string, string>;
|
|
19
|
+
};
|
|
20
|
+
export declare function createDefaultModel(model?: Partial<MultipleChoiceModel>): Promise<Partial<MultipleChoiceModel>>;
|
|
21
|
+
export declare const normalize: (question: MultipleChoiceModel) => {
|
|
22
|
+
choicesLayout: "grid" | "horizontal" | "vertical";
|
|
23
|
+
choiceMode: "checkbox" | "radio";
|
|
24
|
+
choicePrefix: "letters" | "numbers" | "none";
|
|
25
|
+
choices: Choice[];
|
|
26
|
+
prompt: string;
|
|
27
|
+
promptEnabled: boolean;
|
|
28
|
+
gridColumns: number;
|
|
29
|
+
toolbarEditorPosition: "bottom" | "top";
|
|
30
|
+
selectedAnswerBackgroundColor: string;
|
|
31
|
+
selectedAnswerStrokeColor: string;
|
|
32
|
+
selectedAnswerStrokeWidth: string;
|
|
33
|
+
hoverAnswerBackgroundColor: string;
|
|
34
|
+
hoverAnswerStrokeColor: string;
|
|
35
|
+
hoverAnswerStrokeWidth: string;
|
|
36
|
+
lockChoiceOrder: boolean;
|
|
37
|
+
minSelections?: number;
|
|
38
|
+
maxSelections?: number;
|
|
39
|
+
partialScoring: boolean;
|
|
40
|
+
scoringType: "auto" | "rubric";
|
|
41
|
+
studentInstructions?: string;
|
|
42
|
+
teacherInstructions: string;
|
|
43
|
+
feedbackEnabled: boolean;
|
|
44
|
+
defaultFeedback?: {
|
|
45
|
+
correct?: string;
|
|
46
|
+
incorrect?: string;
|
|
47
|
+
};
|
|
48
|
+
rationaleEnabled: boolean;
|
|
49
|
+
rationale: string;
|
|
50
|
+
spellCheckEnabled?: boolean;
|
|
51
|
+
studentInstructionsEnabled: boolean;
|
|
52
|
+
teacherInstructionsEnabled: boolean;
|
|
53
|
+
accessibilityLabelsEnabled?: boolean;
|
|
54
|
+
rubricEnabled?: boolean;
|
|
55
|
+
language?: string;
|
|
56
|
+
isSelectionButtonBelow?: boolean;
|
|
57
|
+
fontSizeFactor?: number;
|
|
58
|
+
autoplayAudioEnabled?: boolean;
|
|
59
|
+
completeAudioEnabled?: boolean;
|
|
60
|
+
customAudioButton?: import("@pie-element/shared-types").CustomAudioButton;
|
|
61
|
+
keyboardEventsEnabled: boolean;
|
|
62
|
+
extraCSSRules?: import("@pie-element/shared-types").ExtraCSSRules;
|
|
63
|
+
limitChoicesNumber?: boolean;
|
|
64
|
+
id: string;
|
|
65
|
+
element: string;
|
|
66
|
+
accessibilityCatalogs?: import("@pie-element/shared-types").AccessibilityCatalog[];
|
|
67
|
+
};
|
|
3
68
|
/**
|
|
4
69
|
*
|
|
5
70
|
* @param {*} question
|
|
@@ -7,34 +72,35 @@ export declare const normalize: (question: any) => any;
|
|
|
7
72
|
* @param {*} env
|
|
8
73
|
* @param {*} updateSession - optional - a function that will set the properties passed into it on the session.
|
|
9
74
|
*/
|
|
10
|
-
export declare function model(question:
|
|
75
|
+
export declare function model(question: MultipleChoiceModel, session: MultipleChoiceSession | undefined, env: PieEnvironment, updateSession?: PieUpdateSession): Promise<{
|
|
11
76
|
disabled: boolean;
|
|
12
|
-
mode:
|
|
13
|
-
prompt:
|
|
14
|
-
choicesLayout:
|
|
15
|
-
gridColumns:
|
|
16
|
-
choiceMode:
|
|
17
|
-
keyMode:
|
|
18
|
-
choices:
|
|
19
|
-
responseCorrect:
|
|
20
|
-
language:
|
|
21
|
-
extraCSSRules:
|
|
22
|
-
fontSizeFactor:
|
|
23
|
-
isSelectionButtonBelow:
|
|
24
|
-
selectedAnswerBackgroundColor:
|
|
25
|
-
selectedAnswerStrokeColor:
|
|
26
|
-
selectedAnswerStrokeWidth:
|
|
27
|
-
hoverAnswerBackgroundColor:
|
|
28
|
-
hoverAnswerStrokeColor:
|
|
29
|
-
hoverAnswerStrokeWidth:
|
|
30
|
-
minSelections:
|
|
31
|
-
maxSelections:
|
|
32
|
-
keyboardEventsEnabled:
|
|
33
|
-
autoplayAudioEnabled:
|
|
34
|
-
completeAudioEnabled:
|
|
35
|
-
customAudioButton:
|
|
77
|
+
mode: "gather" | "view" | "evaluate";
|
|
78
|
+
prompt: string | null;
|
|
79
|
+
choicesLayout: "grid" | "horizontal" | "vertical";
|
|
80
|
+
gridColumns: number;
|
|
81
|
+
choiceMode: "checkbox" | "radio";
|
|
82
|
+
keyMode: "none" | "letters" | "numbers";
|
|
83
|
+
choices: ChoiceView[] | undefined;
|
|
84
|
+
responseCorrect: boolean | undefined;
|
|
85
|
+
language: string | undefined;
|
|
86
|
+
extraCSSRules: import("@pie-element/shared-types").ExtraCSSRules | undefined;
|
|
87
|
+
fontSizeFactor: number | undefined;
|
|
88
|
+
isSelectionButtonBelow: boolean | undefined;
|
|
89
|
+
selectedAnswerBackgroundColor: string;
|
|
90
|
+
selectedAnswerStrokeColor: string;
|
|
91
|
+
selectedAnswerStrokeWidth: string;
|
|
92
|
+
hoverAnswerBackgroundColor: string;
|
|
93
|
+
hoverAnswerStrokeColor: string;
|
|
94
|
+
hoverAnswerStrokeWidth: string;
|
|
95
|
+
minSelections: number | undefined;
|
|
96
|
+
maxSelections: number | undefined;
|
|
97
|
+
keyboardEventsEnabled: boolean;
|
|
98
|
+
autoplayAudioEnabled: boolean | undefined;
|
|
99
|
+
completeAudioEnabled: boolean | undefined;
|
|
100
|
+
customAudioButton: import("@pie-element/shared-types").CustomAudioButton | undefined;
|
|
101
|
+
teacherInstructions: string | null;
|
|
36
102
|
}>;
|
|
37
|
-
export declare const getScore: (config:
|
|
103
|
+
export declare const getScore: (config: MultipleChoiceModel, session: MultipleChoiceSession | undefined) => number;
|
|
38
104
|
/**
|
|
39
105
|
* Generates detailed trace log for scoring evaluation
|
|
40
106
|
* @param {Object} model - the question model
|
|
@@ -42,7 +108,7 @@ export declare const getScore: (config: any, session: any) => number;
|
|
|
42
108
|
* @param {Object} env - the environment
|
|
43
109
|
* @returns {Array} traceLog - array of trace messages
|
|
44
110
|
*/
|
|
45
|
-
export declare const getLogTrace: (model:
|
|
111
|
+
export declare const getLogTrace: (model: MultipleChoiceModel, session: MultipleChoiceSession | undefined, env: PieEnvironment) => string[];
|
|
46
112
|
/**
|
|
47
113
|
*
|
|
48
114
|
* The score is partial by default for checkbox mode, allOrNothing for radio mode.
|
|
@@ -52,6 +118,11 @@ export declare const getLogTrace: (model: any, session: any, env: any) => string
|
|
|
52
118
|
* @param {*} session
|
|
53
119
|
* @param {Object} env
|
|
54
120
|
*/
|
|
55
|
-
export declare function outcome(model:
|
|
56
|
-
|
|
57
|
-
|
|
121
|
+
export declare function outcome(model: MultipleChoiceModel, session: MultipleChoiceSession | undefined, env: PieEnvironment): Promise<{
|
|
122
|
+
score: number;
|
|
123
|
+
empty: boolean;
|
|
124
|
+
traceLog: string[];
|
|
125
|
+
}>;
|
|
126
|
+
export declare const createCorrectResponseSession: (question: MultipleChoiceModel, env: PieEnvironment) => Promise<MultipleChoiceSession | null>;
|
|
127
|
+
export declare const validate: (model?: Partial<MultipleChoiceModel>, config?: MultipleChoiceConfiguration) => MultipleChoiceValidationErrors;
|
|
128
|
+
export {};
|
package/dist/controller/index.js
CHANGED
|
@@ -4,13 +4,13 @@ import { isEmpty as n } from "@pie-element/shared-lodash";
|
|
|
4
4
|
import { getShuffledChoices as r, lockChoices as i, partialScoring as a } from "@pie-element/shared-controller-utils";
|
|
5
5
|
//#region src/controller/index.ts
|
|
6
6
|
var o = (e, t, n) => (r) => {
|
|
7
|
-
let
|
|
7
|
+
let i = t?.role, a = t?.mode, o = {
|
|
8
8
|
label: r.label,
|
|
9
9
|
value: r.value
|
|
10
10
|
};
|
|
11
11
|
if (i === "instructor" && (a === "view" || a === "evaluate") ? o.rationale = e.rationaleEnabled ? r.rationale : null : o.rationale = null, a === "evaluate" && (o.correct = !!r.correct, e.feedbackEnabled)) {
|
|
12
12
|
let e = r.feedback && r.feedback.type || "none";
|
|
13
|
-
e === "default" ? o.feedback = n[r.correct ? "correct" : "incorrect"] : e === "custom" && (o.feedback = r.feedback
|
|
13
|
+
e === "default" ? o.feedback = n[r.correct ? "correct" : "incorrect"] : e === "custom" && (o.feedback = r.feedback?.value);
|
|
14
14
|
}
|
|
15
15
|
return o;
|
|
16
16
|
};
|
|
@@ -34,7 +34,8 @@ async function l(t, n, a, s) {
|
|
|
34
34
|
incorrect: "Incorrect"
|
|
35
35
|
}, l.defaultFeedback), d = (l.choices || []).map(o(l, a, u));
|
|
36
36
|
i(l, n, a) || (d = await r(d, n, s, "value"));
|
|
37
|
-
let f =
|
|
37
|
+
let { role: f, mode: p } = a;
|
|
38
|
+
return {
|
|
38
39
|
disabled: a.mode !== "gather",
|
|
39
40
|
mode: a.mode,
|
|
40
41
|
prompt: l.promptEnabled ? l.prompt : null,
|
|
@@ -59,13 +60,13 @@ async function l(t, n, a, s) {
|
|
|
59
60
|
keyboardEventsEnabled: l.keyboardEventsEnabled,
|
|
60
61
|
autoplayAudioEnabled: l.autoplayAudioEnabled,
|
|
61
62
|
completeAudioEnabled: l.completeAudioEnabled,
|
|
62
|
-
customAudioButton: l.customAudioButton
|
|
63
|
-
|
|
64
|
-
|
|
63
|
+
customAudioButton: l.customAudioButton,
|
|
64
|
+
teacherInstructions: f === "instructor" && (p === "view" || p === "evaluate") && l.teacherInstructionsEnabled ? l.teacherInstructions : null
|
|
65
|
+
};
|
|
65
66
|
}
|
|
66
67
|
var u = (e, t) => {
|
|
67
68
|
if (!t || n(t)) return 0;
|
|
68
|
-
let r = t
|
|
69
|
+
let r = t?.value || [], i = (e.choices || []).filter((e) => e.correct), a = r.reduce((e, t) => e + +!!i.find((e) => e.value === t), 0);
|
|
69
70
|
i.length < r.length && (a -= r.length - i.length, a < 0 && (a = 0));
|
|
70
71
|
let o = i.length ? a / i.length : 0;
|
|
71
72
|
return parseFloat(o.toFixed(2));
|
|
@@ -118,7 +119,7 @@ var p = (e, t) => new Promise((n) => {
|
|
|
118
119
|
r && (u = !0, d++), m(a) ? o.slice(n + 1).some((e) => e.label === a) && (s[i] = "Content should be unique.") : s[i] = "Content should not be empty.", t.rationale?.required && !m(l) && (c[i] = "This field is required.");
|
|
119
120
|
});
|
|
120
121
|
let f = (r || []).length;
|
|
121
|
-
if (f < i ? l.answerChoices = `There should be at least ${i} choices defined.` : f > a && (l.answerChoices = `No more than ${a} choices should be defined.`), !u) l.correctResponse = "No correct response defined.";
|
|
122
|
+
if (f < i ? l.answerChoices = `There should be at least ${i} choices defined.` : a !== void 0 && f > a && (l.answerChoices = `No more than ${a} choices should be defined.`), !u) l.correctResponse = "No correct response defined.";
|
|
122
123
|
else {
|
|
123
124
|
let { maxSelections: t, choiceMode: n } = e;
|
|
124
125
|
n !== "radio" && t != null && d > t && (l.correctResponse = `The number of correct answers (${d}) exceeds max selections (${t}). Students won't be able to select all correct answers.`);
|
|
@@ -1,2 +1,3 @@
|
|
|
1
|
-
|
|
2
|
-
export declare const
|
|
1
|
+
import type { Choice, MultipleChoiceModel, MultipleChoiceSession } from '../types.js';
|
|
2
|
+
export declare const getCorrectResponse: (choices: Choice[]) => string[];
|
|
3
|
+
export declare const isResponseCorrect: (question: MultipleChoiceModel, session: MultipleChoiceSession | undefined) => boolean | undefined;
|
package/dist/index.d.ts
CHANGED