@pie-element/select-text 14.0.4-next.20261011174919 → 14.0.4

package/dist/browser/editor-runtime/controller/index.js

@@ -101,7 +101,7 @@ var f = {
 	return r.length > 0 ? "partially-correct" : "incorrect";
 }, _ = (e, t) => (t || []).filter((t) => e.findIndex((e) => e.correct && m(e, t)) !== -1), v = (e, t, r) => {
 	if (!t || n(t)) return 0;
-	let i = _(e.tokens, t.selectedTokens).length, a = (e.tokens || []).filter((e) => e.correct === !0), o = i - (t.selectedTokens && t.selectedTokens.length > a.length ? t.selectedTokens && t.selectedTokens.length - i : 0), s = o < 0 ? 0 : o;
+	let i = _(e.tokens, t.selectedTokens).length, a = (e.tokens || []).filter((e) => e.correct === !0), o = i - (t.selectedTokens && t.selectedTokens.length > a.length && t.selectedTokens ? t.selectedTokens.length - i : 0), s = o < 0 ? 0 : o;
 	return r.length ? parseFloat((s / r.length).toFixed(2)) : 0;
 }, y = (e, t, n) => {
 	let r = [], i = t?.selectedTokens || [], a = e?.tokens || [];
@@ -194,7 +194,7 @@ var S = (e) => ({
 		t[n]?.required && !E(e[n]) && (o[n] = "This field is required.");
 	});
 	let c = (n || []).reduce((e, t) => t.correct ? e + 1 : e, 0);
-	return s < r ? o.tokensError = `There should be at least ${r} tokens defined.` : s > i && (o.tokensError = `No more than ${i} tokens should be defined.`), c < 1 ? o.selectionsError = "There should be at least 1 token selected." : c > a && (o.selectionsError = `No more than ${a} tokens should be selected.`), o;
+	return s < r ? o.tokensError = `There should be at least ${r} tokens defined.` : i !== void 0 && s > i && (o.tokensError = `No more than ${i} tokens should be defined.`), c < 1 ? o.selectionsError = "There should be at least 1 token selected." : a !== void 0 && c > a && (o.selectionsError = `No more than ${a} tokens should be selected.`), o;
 };
 //#endregion
 export { T as createCorrectResponseSession, x as createDefaultModel, g as getCorrectness, y as getLogTrace, v as getPartialScore, w as model, C as normalize, S as normalizeSession, b as outcome, D as validate };

package/dist/browser/editor-runtime/controller/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../../shared/feedback/dist/index.js","../../../../../../shared/controller-utils/dist/index.js","../../../../src/controller/defaults.ts","../../../../src/controller/index.ts"],"sourcesContent":["//#region src/defaults.ts\nvar e = {\n\tcorrect: {\n\t\ttype: \"default\",\n\t\tdefault: \"Correct\",\n\t\tcustom: \"Correct\"\n\t},\n\tincorrect: {\n\t\ttype: \"default\",\n\t\tdefault: \"Incorrect\",\n\t\tcustom: \"Incorrect\"\n\t},\n\tpartial: {\n\t\ttype: \"default\",\n\t\tdefault: \"Nearly\",\n\t\tcustom: \"Nearly\"\n\t},\n\tunanswered: {\n\t\ttype: \"default\",\n\t\tdefault: \"You have not entered a response\",\n\t\tcustom: \"You have not entered a response\"\n\t}\n};\n//#endregion\n//#region src/utils.ts\nfunction t(e) {\n\treturn e === \"partially-correct\" ? \"partial\" : e;\n}\n//#endregion\n//#region src/index.ts\nfunction n(n, r) {\n\tlet i = {\n\t\t...e,\n\t\t...r\n\t}, a = t(n), o = e[a] || {}, s = i[a] || o;\n\treturn {\n\t\tconfig: s,\n\t\tfallback: o[s.type || \"default\"]\n\t};\n}\nfunction r(e, t = {}) {\n\treturn new Promise((r) => {\n\t\tlet { config: a, fallback: o } = n(e, t);\n\t\ti(a, o).then(r);\n\t});\n}\nfunction i(e, t) {\n\treturn new Promise((n) => {\n\t\tif (!e || e.type === \"none\") {\n\t\t\tn(void 0);\n\t\t\treturn;\n\t\t}\n\t\tn(e[e.type] || t);\n\t});\n}\nfunction a(e, t = {}) {\n\tlet { config: r, fallback: i } = n(e, t);\n\treturn o(r, i);\n}\nfunction o(e, t) {\n\tif (!(!e || e.type === \"none\")) return e[e.type] || t;\n}\n//#endregion\nexport { e as defaultFeedback, o as getActualFeedback, a as getActualFeedbackForCorrectness, i as getFeedback, r as getFeedbackForCorrectness, t as normalizeCorrectness };\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\nexport default {\n  feedbackEnabled: false,\n  highlightChoices: false,\n  maxSelections: 0,\n  mode: 'sentence',\n  partialScoring: false,\n  prompt: '',\n  promptEnabled: true,\n  rationale: '',\n  rationaleEnabled: true,\n  scoringType: 'auto',\n  studentInstructionsEnabled: true,\n  teacherInstructions: '',\n  teacherInstructionsEnabled: true,\n  text: '',\n  tokens: [],\n  toolbarEditorPosition: 'bottom',\n};\n","// @ts-nocheck\n\nimport debug from 'debug';\nimport { isEmpty } from '@pie-element/shared-lodash';\nimport { getFeedbackForCorrectness } from '@pie-element/shared-feedback';\nimport { partialScoring } from '@pie-element/shared-controller-utils';\nimport defaults from './defaults.js';\n\nconst log = debug('@pie-element:select-text:controller');\n\nconst equalTokens = (token1 = {}, token2 = {}) =>\n  (token1?.start === token2?.start && token1?.end === token2?.end) ||\n  // this case is used for the cases when the token's start & end were recalculated\n  (token1?.start === token2?.oldStart && token1?.end === token2?.oldEnd);\n\nconst normalizeTokens = (tokens = [], selectedTokens = [], evaluateMode = false) =>\n  (tokens || []).map((token) => {\n    const isCorrect = !!token.correct;\n    // search if correct token is missing from session\n    const isMissing = isCorrect && !(selectedTokens || []).find((selectedToken) => equalTokens(token, selectedToken));\n\n    return {\n      ...token,\n      correct: evaluateMode ? isCorrect : undefined,\n      isMissing: evaluateMode ? isMissing : undefined,\n    };\n  });\n\nexport const getCorrectness = (tokens, selected) => {\n  const correct = tokens.filter((t) => t.correct === true);\n\n  if (correct.length === 0) {\n    return 'unknown';\n  }\n\n  const correctSelected = getCorrectSelected(tokens, selected);\n\n  if (correctSelected.length === selected.length) {\n    if (correctSelected.length === correct.length) {\n      return 'correct';\n    } else if (correctSelected.length > 0) {\n      return 'partially-correct';\n    }\n  }\n\n  if (correctSelected.length > 0) {\n    return 'partially-correct';\n  }\n\n  return 'incorrect';\n};\n\nconst getCorrectSelected = (tokens, selected) =>\n  (selected || []).filter((s) => tokens.findIndex((token) => token.correct && equalTokens(token, s)) !== -1);\n\nexport const getPartialScore = (question, session, totalCorrect) => {\n  if (!session || isEmpty(session)) {\n    return 0;\n  }\n\n  const correctCount = getCorrectSelected(question.tokens, session.selectedTokens).length;\n  const correctTokens = (question.tokens || []).filter((t) => t.correct === true);\n  const extraSelected = session.selectedTokens ? session.selectedTokens.length > correctTokens.length : 0;\n  const incorrectCount = extraSelected ? session.selectedTokens && session.selectedTokens.length - correctCount : 0;\n  const count = correctCount - incorrectCount;\n  const positiveCount = count < 0 ? 0 : count;\n\n  return totalCorrect.length ? parseFloat((positiveCount / totalCorrect.length).toFixed(2)) : 0;\n};\n\n/**\n * Generates detailed trace log for select-text scoring evaluation\n * @param {Object} question - the question model\n * @param {Object} session - the student session\n * @param {Object} env - the environment\n * @returns {Array<string>} traceLog\n */\nexport const getLogTrace = (question, session, env) => {\n  const traceLog = [];\n\n  const selectedTokens = session?.selectedTokens || [];\n  const tokens = question?.tokens || [];\n\n  if (selectedTokens.length === 0) {\n    traceLog.push('Student did not select any token.');\n    return traceLog;\n  }\n\n  traceLog.push(`Student selected ${selectedTokens.length} token(s).`);\n\n  let totalCorrectTokens = 0;\n  let correctSelected = 0;\n  let missingCount = 0;\n\n  for (let i = 0; i < tokens.length; i++) {\n    const token = tokens[i];\n    if (token.correct) {\n      totalCorrectTokens++;\n      const matched = selectedTokens.some((s) => equalTokens(token, s));\n      if (matched) {\n        correctSelected++;\n      } else {\n        missingCount++;\n      }\n    }\n  }\n\n  const incorrectSelected = selectedTokens.length - correctSelected;\n\n  if (correctSelected > 0) {\n    traceLog.push(`${correctSelected} correct token(s) selected.`);\n  }\n\n  if (incorrectSelected > 0) {\n    traceLog.push(`${incorrectSelected} incorrect token(s) selected.`);\n  }\n\n  if (missingCount > 0) {\n    traceLog.push(`${missingCount} required correct token(s) were not selected.`);\n  }\n\n  const partialScoringEnabled = partialScoring.enabled(question, env, true);\n\n  if (partialScoringEnabled) {\n    traceLog.push('Score calculated using partial scoring.');\n    traceLog.push(\n      'Score is based on the number of correct minus incorrect selections, divided by the total number of correct tokens.',\n    );\n\n    if (incorrectSelected > 0 && selectedTokens.length > totalCorrectTokens) {\n      traceLog.push(\n        'Extra selected tokens beyond the correct set reduce the score.',\n      );\n    }\n  } else {\n    traceLog.push('Score calculated using all-or-nothing scoring.');\n    traceLog.push(\n      'Student must select all correct tokens and no incorrect tokens to receive full credit.',\n    );\n  }\n\n  const rawScore = getPartialScore(question, session, tokens.filter((t) => t.correct));\n  const finalScore = partialScoringEnabled ? rawScore : rawScore === 1 ? 1 : 0;\n\n  traceLog.push(`Final score: ${finalScore}.`);\n\n  return traceLog;\n};\n\nexport const outcome = (question, session, env) =>\n  new Promise((resolve) => {\n    if (!session || isEmpty(session)) {\n      resolve({ score: 0, empty: true, logTrace: ['Student did not select any token.'] });\n    }\n\n    session = normalizeSession(session);\n\n    if (env.mode !== 'evaluate') {\n      resolve({ score: undefined, completed: undefined, logTrace: [] });\n    } else {\n      const enabled = partialScoring.enabled(question, env, true);\n      const totalCorrect = question.tokens.filter((t) => t.correct);\n      const score = getPartialScore(question, session, totalCorrect);\n      resolve({\n        score: enabled ? score : score === 1 ? 1 : 0,\n        logTrace: getLogTrace(question, session, env),\n      });\n    }\n  });\n\nexport function createDefaultModel(model = {}) {\n  return new Promise((resolve) => {\n    resolve({ ...defaults, ...model });\n  });\n}\n\nexport const normalizeSession = (session) => ({ selectedTokens: [], ...session });\n\nexport const normalize = (question) => ({ ...defaults, ...question });\n\nexport const model = (question, session, env) => {\n  session = session || { selectedToken: [] };\n  session.selectedTokens = session.selectedTokens || [];\n  const normalizedQuestion = normalize(question);\n\n  return new Promise((resolve) => {\n    log('[model]', 'normalizedQuestion: ', normalizedQuestion);\n    log('[model]', 'session: ', session);\n\n    const tokens = normalizeTokens(normalizedQuestion.tokens, session.selectedTokens, env.mode === 'evaluate');\n    log('[model] tokens:', tokens);\n\n    const correctness =\n      env.mode === 'evaluate' ? getCorrectness(normalizedQuestion.tokens, session.selectedTokens) : undefined;\n\n    const fb =\n      env.mode === 'evaluate' && normalizedQuestion.feedbackEnabled\n        ? getFeedbackForCorrectness(correctness, normalizedQuestion.feedback)\n        : Promise.resolve(undefined);\n\n    fb.then((feedback) => {\n      const out = {\n        tokens,\n        highlightChoices: normalizedQuestion.highlightChoices,\n        prompt: normalizedQuestion.promptEnabled ? normalizedQuestion.prompt : null,\n        text: normalizedQuestion.text,\n        disabled: env.mode !== 'gather',\n        maxSelections: normalizedQuestion.maxSelections,\n        correctness,\n        env,\n        feedback,\n        incorrect: env.mode === 'evaluate' ? correctness !== 'correct' : undefined,\n        language: normalizedQuestion.language,\n        extraCSSRules: normalizedQuestion.extraCSSRules,\n      };\n\n      if (env.role === 'instructor' && (env.mode === 'view' || env.mode === 'evaluate')) {\n        out.rationale = normalizedQuestion.rationaleEnabled ? normalizedQuestion.rationale : null;\n        out.teacherInstructions = normalizedQuestion.teacherInstructionsEnabled\n          ? normalizedQuestion.teacherInstructions\n          : null;\n      } else {\n        out.rationale = null;\n        out.teacherInstructions = null;\n      }\n\n      resolve(out);\n    });\n  });\n};\n\nexport const createCorrectResponseSession = (question, env) => {\n  return new Promise((resolve) => {\n    if (env.mode !== 'evaluate' && env.role === 'instructor') {\n      const { tokens } = question;\n      const selectedTokens = tokens.filter((t) => t.correct);\n\n      resolve({\n        id: '1',\n        selectedTokens,\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 { tokens } = model;\n  const { minTokens = 2, maxTokens, maxSelections } = config;\n  const errors = {};\n  const nbOfTokens = (tokens || []).length;\n\n  ['teacherInstructions', 'prompt', 'rationale'].forEach((field) => {\n    if (config[field]?.required && !getContent(model[field])) {\n      errors[field] = 'This field is required.';\n    }\n  });\n\n  const nbOfSelections = (tokens || []).reduce((acc, token) => (token.correct ? acc + 1 : acc), 0);\n\n  if (nbOfTokens < minTokens) {\n    errors.tokensError = `There should be at least ${minTokens} tokens defined.`;\n  } else if (nbOfTokens > maxTokens) {\n    errors.tokensError = `No more than ${maxTokens} tokens should be defined.`;\n  }\n\n  if (nbOfSelections < 1) {\n    errors.selectionsError = 'There should be at least 1 token selected.';\n  } else if (nbOfSelections > maxSelections) {\n    errors.selectionsError = `No more than ${maxSelections} tokens should be selected.`;\n  }\n\n  return errors;\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../../shared/feedback/dist/index.js","../../../../../../shared/controller-utils/dist/index.js","../../../../src/controller/defaults.ts","../../../../src/controller/index.ts"],"sourcesContent":["//#region src/defaults.ts\nvar e = {\n\tcorrect: {\n\t\ttype: \"default\",\n\t\tdefault: \"Correct\",\n\t\tcustom: \"Correct\"\n\t},\n\tincorrect: {\n\t\ttype: \"default\",\n\t\tdefault: \"Incorrect\",\n\t\tcustom: \"Incorrect\"\n\t},\n\tpartial: {\n\t\ttype: \"default\",\n\t\tdefault: \"Nearly\",\n\t\tcustom: \"Nearly\"\n\t},\n\tunanswered: {\n\t\ttype: \"default\",\n\t\tdefault: \"You have not entered a response\",\n\t\tcustom: \"You have not entered a response\"\n\t}\n};\n//#endregion\n//#region src/utils.ts\nfunction t(e) {\n\treturn e === \"partially-correct\" ? \"partial\" : e;\n}\n//#endregion\n//#region src/index.ts\nfunction n(n, r) {\n\tlet i = {\n\t\t...e,\n\t\t...r\n\t}, a = t(n), o = e[a] || {}, s = i[a] || o;\n\treturn {\n\t\tconfig: s,\n\t\tfallback: o[s.type || \"default\"]\n\t};\n}\nfunction r(e, t = {}) {\n\treturn new Promise((r) => {\n\t\tlet { config: a, fallback: o } = n(e, t);\n\t\ti(a, o).then(r);\n\t});\n}\nfunction i(e, t) {\n\treturn new Promise((n) => {\n\t\tif (!e || e.type === \"none\") {\n\t\t\tn(void 0);\n\t\t\treturn;\n\t\t}\n\t\tn(e[e.type] || t);\n\t});\n}\nfunction a(e, t = {}) {\n\tlet { config: r, fallback: i } = n(e, t);\n\treturn o(r, i);\n}\nfunction o(e, t) {\n\tif (!(!e || e.type === \"none\")) return e[e.type] || t;\n}\n//#endregion\nexport { e as defaultFeedback, o as getActualFeedback, a as getActualFeedbackForCorrectness, i as getFeedback, r as getFeedbackForCorrectness, t as normalizeCorrectness };\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","import type { SelectTextModel, TextToken } from '../types.js';\n\nexport default {\n  feedbackEnabled: false,\n  highlightChoices: false,\n  maxSelections: 0,\n  mode: 'sentence',\n  partialScoring: false,\n  prompt: '',\n  promptEnabled: true,\n  rationale: '',\n  rationaleEnabled: true,\n  scoringType: 'auto',\n  studentInstructionsEnabled: true,\n  teacherInstructions: '',\n  teacherInstructionsEnabled: true,\n  text: '',\n  tokens: [] as TextToken[],\n  toolbarEditorPosition: 'bottom',\n} satisfies Omit<SelectTextModel, 'id' | 'element'>;\n","import debug from 'debug';\nimport { isEmpty } from '@pie-element/shared-lodash';\nimport { getFeedbackForCorrectness, type Correctness, type Feedback } from '@pie-element/shared-feedback';\nimport { partialScoring } from '@pie-element/shared-controller-utils';\nimport type { ExtraCSSRules, PieEnvironment } from '@pie-element/shared-types';\nimport defaults from './defaults.js';\nimport type { SelectTextConfiguration, SelectTextModel, SelectTextSession, TextToken } from '../types.js';\n\nconst log = debug('@pie-element:select-text:controller');\n\ntype ResponseCorrectness = 'unknown' | 'correct' | 'partially-correct' | 'incorrect';\n\n/** A token as the delivery view receives it; `correct` and `isMissing` are set in evaluate mode only. */\ntype TokenView = Omit<TextToken, 'correct'> & { correct: boolean | undefined; isMissing: boolean | undefined };\n\n/** The model the delivery view receives. */\ntype ModelView = {\n  tokens: TokenView[];\n  highlightChoices?: boolean;\n  prompt: string | null | undefined;\n  text: string;\n  disabled: boolean;\n  maxSelections?: number;\n  correctness: ResponseCorrectness | undefined;\n  env: PieEnvironment;\n  feedback: string | undefined;\n  incorrect: boolean | undefined;\n  language?: string;\n  extraCSSRules?: ExtraCSSRules;\n  rationale?: string | null;\n  teacherInstructions?: string | null;\n};\n\ntype Outcome = { score: number | undefined; empty?: boolean; completed?: undefined; logTrace: string[] };\n\n/** Errors `validate()` reports, keyed by field. */\nexport type SelectTextValidationErrors = {\n  teacherInstructions?: string;\n  prompt?: string;\n  rationale?: string;\n  tokensError?: string;\n  selectionsError?: string;\n};\n\n/** The session `model()` works on; without a session it starts from one carrying `selectedToken`. */\ntype ModelSession = SelectTextSession & { selectedToken?: TextToken[] };\n\nconst equalTokens = (token1: Partial<TextToken> = {}, token2: Partial<TextToken> = {}) =>\n  (token1?.start === token2?.start && token1?.end === token2?.end) ||\n  // this case is used for the cases when the token's start & end were recalculated\n  (token1?.start === token2?.oldStart && token1?.end === token2?.oldEnd);\n\nconst normalizeTokens = (tokens: TextToken[] = [], selectedTokens: TextToken[] = [], evaluateMode = false): TokenView[] =>\n  (tokens || []).map((token) => {\n    const isCorrect = !!token.correct;\n    // search if correct token is missing from session\n    const isMissing = isCorrect && !(selectedTokens || []).find((selectedToken) => equalTokens(token, selectedToken));\n\n    return {\n      ...token,\n      correct: evaluateMode ? isCorrect : undefined,\n      isMissing: evaluateMode ? isMissing : undefined,\n    };\n  });\n\nexport const getCorrectness = (tokens: TextToken[], selected: TextToken[]): ResponseCorrectness => {\n  const correct = tokens.filter((t) => t.correct === true);\n\n  if (correct.length === 0) {\n    return 'unknown';\n  }\n\n  const correctSelected = getCorrectSelected(tokens, selected);\n\n  if (correctSelected.length === selected.length) {\n    if (correctSelected.length === correct.length) {\n      return 'correct';\n    } else if (correctSelected.length > 0) {\n      return 'partially-correct';\n    }\n  }\n\n  if (correctSelected.length > 0) {\n    return 'partially-correct';\n  }\n\n  return 'incorrect';\n};\n\nconst getCorrectSelected = (tokens: TextToken[], selected: TextToken[] | undefined) =>\n  (selected || []).filter((s) => tokens.findIndex((token) => token.correct && equalTokens(token, s)) !== -1);\n\nexport const getPartialScore = (\n  question: SelectTextModel,\n  session: SelectTextSession | undefined,\n  totalCorrect: TextToken[],\n) => {\n  if (!session || isEmpty(session)) {\n    return 0;\n  }\n\n  const correctCount = getCorrectSelected(question.tokens, session.selectedTokens).length;\n  const correctTokens = (question.tokens || []).filter((t) => t.correct === true);\n  const extraSelected = session.selectedTokens ? session.selectedTokens.length > correctTokens.length : 0;\n  const incorrectCount = extraSelected && session.selectedTokens ? session.selectedTokens.length - correctCount : 0;\n  const count = correctCount - incorrectCount;\n  const positiveCount = count < 0 ? 0 : count;\n\n  return totalCorrect.length ? parseFloat((positiveCount / totalCorrect.length).toFixed(2)) : 0;\n};\n\n/**\n * Generates detailed trace log for select-text scoring evaluation\n * @param {Object} question - the question model\n * @param {Object} session - the student session\n * @param {Object} env - the environment\n * @returns {Array<string>} traceLog\n */\nexport const getLogTrace = (question: SelectTextModel, session: SelectTextSession | undefined, env: PieEnvironment) => {\n  const traceLog: string[] = [];\n\n  const selectedTokens = session?.selectedTokens || [];\n  const tokens = question?.tokens || [];\n\n  if (selectedTokens.length === 0) {\n    traceLog.push('Student did not select any token.');\n    return traceLog;\n  }\n\n  traceLog.push(`Student selected ${selectedTokens.length} token(s).`);\n\n  let totalCorrectTokens = 0;\n  let correctSelected = 0;\n  let missingCount = 0;\n\n  for (let i = 0; i < tokens.length; i++) {\n    const token = tokens[i];\n    if (token.correct) {\n      totalCorrectTokens++;\n      const matched = selectedTokens.some((s) => equalTokens(token, s));\n      if (matched) {\n        correctSelected++;\n      } else {\n        missingCount++;\n      }\n    }\n  }\n\n  const incorrectSelected = selectedTokens.length - correctSelected;\n\n  if (correctSelected > 0) {\n    traceLog.push(`${correctSelected} correct token(s) selected.`);\n  }\n\n  if (incorrectSelected > 0) {\n    traceLog.push(`${incorrectSelected} incorrect token(s) selected.`);\n  }\n\n  if (missingCount > 0) {\n    traceLog.push(`${missingCount} required correct token(s) were not selected.`);\n  }\n\n  const partialScoringEnabled = partialScoring.enabled(question, env, true);\n\n  if (partialScoringEnabled) {\n    traceLog.push('Score calculated using partial scoring.');\n    traceLog.push(\n      'Score is based on the number of correct minus incorrect selections, divided by the total number of correct tokens.',\n    );\n\n    if (incorrectSelected > 0 && selectedTokens.length > totalCorrectTokens) {\n      traceLog.push(\n        'Extra selected tokens beyond the correct set reduce the score.',\n      );\n    }\n  } else {\n    traceLog.push('Score calculated using all-or-nothing scoring.');\n    traceLog.push(\n      'Student must select all correct tokens and no incorrect tokens to receive full credit.',\n    );\n  }\n\n  const rawScore = getPartialScore(question, session, tokens.filter((t) => t.correct));\n  const finalScore = partialScoringEnabled ? rawScore : rawScore === 1 ? 1 : 0;\n\n  traceLog.push(`Final score: ${finalScore}.`);\n\n  return traceLog;\n};\n\nexport const outcome = (question: SelectTextModel, session: SelectTextSession | undefined, env: PieEnvironment) =>\n  new Promise<Outcome>((resolve) => {\n    if (!session || isEmpty(session)) {\n      resolve({ score: 0, empty: true, logTrace: ['Student did not select any token.'] });\n    }\n\n    session = normalizeSession(session);\n\n    if (env.mode !== 'evaluate') {\n      resolve({ score: undefined, completed: undefined, logTrace: [] });\n    } else {\n      const enabled = partialScoring.enabled(question, env, true);\n      const totalCorrect = question.tokens.filter((t) => t.correct);\n      const score = getPartialScore(question, session, totalCorrect);\n      resolve({\n        score: enabled ? score : score === 1 ? 1 : 0,\n        logTrace: getLogTrace(question, session, env),\n      });\n    }\n  });\n\nexport function createDefaultModel(model: Partial<SelectTextModel> = {}) {\n  return new Promise<Partial<SelectTextModel>>((resolve) => {\n    resolve({ ...defaults, ...model });\n  });\n}\n\nexport const normalizeSession = (session: SelectTextSession | undefined) => ({\n  selectedTokens: [] as TextToken[],\n  ...session,\n});\n\nexport const normalize = (question: SelectTextModel) => ({ ...defaults, ...question });\n\nexport const model = (question: SelectTextModel, session: ModelSession | null | undefined, env: PieEnvironment) => {\n  session = session || { selectedToken: [] };\n  session.selectedTokens = session.selectedTokens || [];\n  const normalizedQuestion = normalize(question);\n\n  return new Promise<ModelView>((resolve) => {\n    log('[model]', 'normalizedQuestion: ', normalizedQuestion);\n    log('[model]', 'session: ', session);\n\n    const tokens = normalizeTokens(normalizedQuestion.tokens, session.selectedTokens, env.mode === 'evaluate');\n    log('[model] tokens:', tokens);\n\n    const correctness =\n      env.mode === 'evaluate' ? getCorrectness(normalizedQuestion.tokens, session.selectedTokens as TextToken[]) : undefined;\n\n    const fb =\n      env.mode === 'evaluate' && normalizedQuestion.feedbackEnabled\n        ? getFeedbackForCorrectness(correctness as Correctness, normalizedQuestion.feedback as Partial<Feedback>)\n        : Promise.resolve(undefined);\n\n    fb.then((feedback) => {\n      const out: ModelView = {\n        tokens,\n        highlightChoices: normalizedQuestion.highlightChoices,\n        prompt: normalizedQuestion.promptEnabled ? normalizedQuestion.prompt : null,\n        text: normalizedQuestion.text,\n        disabled: env.mode !== 'gather',\n        maxSelections: normalizedQuestion.maxSelections,\n        correctness,\n        env,\n        feedback,\n        incorrect: env.mode === 'evaluate' ? correctness !== 'correct' : undefined,\n        language: normalizedQuestion.language,\n        extraCSSRules: normalizedQuestion.extraCSSRules,\n      };\n\n      if (env.role === 'instructor' && (env.mode === 'view' || env.mode === 'evaluate')) {\n        out.rationale = normalizedQuestion.rationaleEnabled ? normalizedQuestion.rationale : null;\n        out.teacherInstructions = normalizedQuestion.teacherInstructionsEnabled\n          ? normalizedQuestion.teacherInstructions\n          : null;\n      } else {\n        out.rationale = null;\n        out.teacherInstructions = null;\n      }\n\n      resolve(out);\n    });\n  });\n};\n\nexport const createCorrectResponseSession = (question: SelectTextModel, env: PieEnvironment) => {\n  return new Promise<SelectTextSession | null>((resolve) => {\n    if (env.mode !== 'evaluate' && env.role === 'instructor') {\n      const { tokens } = question;\n      const selectedTokens = tokens.filter((t) => t.correct);\n\n      resolve({\n        id: '1',\n        selectedTokens,\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<SelectTextModel> = {},\n  config: SelectTextConfiguration = {},\n): SelectTextValidationErrors => {\n  const { tokens } = model;\n  const { minTokens = 2, maxTokens, maxSelections } = config;\n  const errors: SelectTextValidationErrors = {};\n  const nbOfTokens = (tokens || []).length;\n\n  (['teacherInstructions', 'prompt', 'rationale'] as const).forEach((field) => {\n    if (config[field]?.required && !getContent(model[field])) {\n      errors[field] = 'This field is required.';\n    }\n  });\n\n  const nbOfSelections = (tokens || []).reduce((acc, token) => (token.correct ? acc + 1 : acc), 0);\n\n  if (nbOfTokens < minTokens) {\n    errors.tokensError = `There should be at least ${minTokens} tokens defined.`;\n  } else if (maxTokens !== undefined && nbOfTokens > maxTokens) {\n    errors.tokensError = `No more than ${maxTokens} tokens should be defined.`;\n  }\n\n  if (nbOfSelections < 1) {\n    errors.selectionsError = 'There should be at least 1 token selected.';\n  } else if (maxSelections !== undefined && nbOfSelections > maxSelections) {\n    errors.selectionsError = `No more than ${maxSelections} tokens should be selected.`;\n  }\n\n  return errors;\n};\n"],"mappings":"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"}

package/dist/controller/defaults.d.ts

@@ -1,19 +1,20 @@
+import type { TextToken } from '../types.js';
 declare const _default: {
-    feedbackEnabled: boolean;
-    highlightChoices: boolean;
+    feedbackEnabled: false;
+    highlightChoices: false;
     maxSelections: number;
-    mode: string;
-    partialScoring: boolean;
+    mode: "sentence";
+    partialScoring: false;
     prompt: string;
-    promptEnabled: boolean;
+    promptEnabled: true;
     rationale: string;
-    rationaleEnabled: boolean;
-    scoringType: string;
-    studentInstructionsEnabled: boolean;
+    rationaleEnabled: true;
+    scoringType: "auto";
+    studentInstructionsEnabled: true;
     teacherInstructions: string;
-    teacherInstructionsEnabled: boolean;
+    teacherInstructionsEnabled: true;
     text: string;
-    tokens: never[];
-    toolbarEditorPosition: string;
+    tokens: TextToken[];
+    toolbarEditorPosition: "bottom";
 };
 export default _default;

package/dist/controller/index.d.ts

@@ -1,5 +1,48 @@
-export declare const getCorrectness: (tokens: any, selected: any) => "unknown" | "correct" | "partially-correct" | "incorrect";
-export declare const getPartialScore: (question: any, session: any, totalCorrect: any) => number;
+import type { ExtraCSSRules, PieEnvironment } from '@pie-element/shared-types';
+import type { SelectTextConfiguration, SelectTextModel, SelectTextSession, TextToken } from '../types.js';
+type ResponseCorrectness = 'unknown' | 'correct' | 'partially-correct' | 'incorrect';
+/** A token as the delivery view receives it; `correct` and `isMissing` are set in evaluate mode only. */
+type TokenView = Omit<TextToken, 'correct'> & {
+    correct: boolean | undefined;
+    isMissing: boolean | undefined;
+};
+/** The model the delivery view receives. */
+type ModelView = {
+    tokens: TokenView[];
+    highlightChoices?: boolean;
+    prompt: string | null | undefined;
+    text: string;
+    disabled: boolean;
+    maxSelections?: number;
+    correctness: ResponseCorrectness | undefined;
+    env: PieEnvironment;
+    feedback: string | undefined;
+    incorrect: boolean | undefined;
+    language?: string;
+    extraCSSRules?: ExtraCSSRules;
+    rationale?: string | null;
+    teacherInstructions?: string | null;
+};
+type Outcome = {
+    score: number | undefined;
+    empty?: boolean;
+    completed?: undefined;
+    logTrace: string[];
+};
+/** Errors `validate()` reports, keyed by field. */
+export type SelectTextValidationErrors = {
+    teacherInstructions?: string;
+    prompt?: string;
+    rationale?: string;
+    tokensError?: string;
+    selectionsError?: string;
+};
+/** The session `model()` works on; without a session it starts from one carrying `selectedToken`. */
+type ModelSession = SelectTextSession & {
+    selectedToken?: TextToken[];
+};
+export declare const getCorrectness: (tokens: TextToken[], selected: TextToken[]) => ResponseCorrectness;
+export declare const getPartialScore: (question: SelectTextModel, session: SelectTextSession | undefined, totalCorrect: TextToken[]) => number;
 /**
  * Generates detailed trace log for select-text scoring evaluation
  * @param {Object} question - the question model
@@ -7,11 +50,42 @@ export declare const getPartialScore: (question: any, session: any, totalCorrect
  * @param {Object} env - the environment
  * @returns {Array<string>} traceLog
  */
-export declare const getLogTrace: (question: any, session: any, env: any) => string[];
-export declare const outcome: (question: any, session: any, env: any) => Promise<unknown>;
-export declare function createDefaultModel(model?: {}): Promise<unknown>;
-export declare const normalizeSession: (session: any) => any;
-export declare const normalize: (question: any) => any;
-export declare const model: (question: any, session: any, env: any) => Promise<unknown>;
-export declare const createCorrectResponseSession: (question: any, env: any) => Promise<unknown>;
-export declare const validate: (model?: {}, config?: {}) => {};
+export declare const getLogTrace: (question: SelectTextModel, session: SelectTextSession | undefined, env: PieEnvironment) => string[];
+export declare const outcome: (question: SelectTextModel, session: SelectTextSession | undefined, env: PieEnvironment) => Promise<Outcome>;
+export declare function createDefaultModel(model?: Partial<SelectTextModel>): Promise<Partial<SelectTextModel>>;
+export declare const normalizeSession: (session: SelectTextSession | undefined) => {
+    id?: string;
+    element?: string;
+    selectedTokens: TextToken[];
+};
+export declare const normalize: (question: SelectTextModel) => {
+    maxSelections: number;
+    mode: "sentence" | "words" | "paragraphs" | "word" | "paragraph" | "";
+    partialScoring: boolean;
+    feedback?: import("../types.js").ComplexFeedbackType;
+    tokens: TextToken[];
+    text: string;
+    prompt: string;
+    promptEnabled: boolean;
+    highlightChoices: boolean;
+    rationale: string;
+    scoringType: "auto" | "rubric";
+    studentInstructions?: string;
+    teacherInstructions: string;
+    feedbackEnabled: boolean;
+    rationaleEnabled: boolean;
+    studentInstructionsEnabled: boolean;
+    teacherInstructionsEnabled: boolean;
+    spellCheckEnabled?: boolean;
+    toolbarEditorPosition: "bottom" | "top";
+    rubricEnabled?: boolean;
+    language?: string;
+    extraCSSRules?: ExtraCSSRules;
+    id: string;
+    element: string;
+    accessibilityCatalogs?: import("@pie-element/shared-types").AccessibilityCatalog[];
+};
+export declare const model: (question: SelectTextModel, session: ModelSession | null | undefined, env: PieEnvironment) => Promise<ModelView>;
+export declare const createCorrectResponseSession: (question: SelectTextModel, env: PieEnvironment) => Promise<SelectTextSession | null>;
+export declare const validate: (model?: Partial<SelectTextModel>, config?: SelectTextConfiguration) => SelectTextValidationErrors;
+export {};

package/dist/controller/index.js

@@ -22,7 +22,7 @@ var a = t("@pie-element:select-text:controller"), o = (e = {}, t = {}) => e?.sta
 	return r.length > 0 ? "partially-correct" : "incorrect";
 }, l = (e, t) => (t || []).filter((t) => e.findIndex((e) => e.correct && o(e, t)) !== -1), u = (e, t, r) => {
 	if (!t || n(t)) return 0;
-	let i = l(e.tokens, t.selectedTokens).length, a = (e.tokens || []).filter((e) => e.correct === !0), o = i - (t.selectedTokens && t.selectedTokens.length > a.length ? t.selectedTokens && t.selectedTokens.length - i : 0), s = o < 0 ? 0 : o;
+	let i = l(e.tokens, t.selectedTokens).length, a = (e.tokens || []).filter((e) => e.correct === !0), o = i - (t.selectedTokens && t.selectedTokens.length > a.length && t.selectedTokens ? t.selectedTokens.length - i : 0), s = o < 0 ? 0 : o;
 	return r.length ? parseFloat((s / r.length).toFixed(2)) : 0;
 }, d = (e, t, n) => {
 	let r = [], a = t?.selectedTokens || [], s = e?.tokens || [];
@@ -115,7 +115,7 @@ var m = (e) => ({
 		t[n]?.required && !v(e[n]) && (o[n] = "This field is required.");
 	});
 	let c = (n || []).reduce((e, t) => t.correct ? e + 1 : e, 0);
-	return s < r ? o.tokensError = `There should be at least ${r} tokens defined.` : s > i && (o.tokensError = `No more than ${i} tokens should be defined.`), c < 1 ? o.selectionsError = "There should be at least 1 token selected." : c > a && (o.selectionsError = `No more than ${a} tokens should be selected.`), o;
+	return s < r ? o.tokensError = `There should be at least ${r} tokens defined.` : i !== void 0 && s > i && (o.tokensError = `No more than ${i} tokens should be defined.`), c < 1 ? o.selectionsError = "There should be at least 1 token selected." : a !== void 0 && c > a && (o.selectionsError = `No more than ${a} tokens should be selected.`), o;
 };
 //#endregion
 export { _ as createCorrectResponseSession, p as createDefaultModel, c as getCorrectness, d as getLogTrace, u as getPartialScore, g as model, h as normalize, m as normalizeSession, f as outcome, y as validate };

package/dist/index.d.ts

@@ -1 +1,2 @@
 export { default } from './delivery/index.js';
+export type * from './types.js';