@pie-element/match-list 8.0.4-next.20261011174919 → 8.0.4

package/dist/browser/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  config: {\n    answers: [],\n    prompt: '',\n    prompts: [],\n    shuffled: false,\n  },\n};\n","// @ts-nocheck\n\nimport { isEmpty } from '@pie-element/shared-lodash';\nimport { getFeedbackForCorrectness } from '@pie-element/shared-feedback';\nimport { lockChoices, getShuffledChoices, partialScoring } from '@pie-element/shared-controller-utils';\nimport debug from 'debug';\n\nconst log = debug('@pie-element:match-list:controller');\n\nimport defaults from './defaults.js';\n\nconst getResponseCorrectness = (model, answers, env) => {\n  const isPartialScoring = partialScoring.enabled(model, env);\n  const prompts = model.prompts;\n\n  if (!answers || Object.keys(answers).length === 0) {\n    return 'unanswered';\n  }\n\n  const totalCorrectAnswers = getTotalCorrect(model);\n  const correctAnswers = getCorrectSelected(prompts, answers);\n\n  if (totalCorrectAnswers === correctAnswers) {\n    return 'correct';\n  } else if (correctAnswers === 0) {\n    return 'incorrect';\n  } else if (isPartialScoring) {\n    return 'partial';\n  }\n\n  return 'incorrect';\n};\n\nconst getCorrectness = (question, env, answers) => {\n  if (env.mode === 'evaluate') {\n    return getResponseCorrectness(question, answers, env);\n  }\n};\n\nconst getCorrectSelected = (prompts = [], answers) => {\n  let correctAnswers = 0;\n\n  prompts.forEach((p) => {\n    if (p.relatedAnswer === answers[p.id]) {\n      correctAnswers += 1;\n    }\n  });\n\n  return correctAnswers;\n};\n\nconst getTotalCorrect = (question) => {\n  return question && question.prompts ? question.prompts.length : 0;\n};\n\nconst getPartialScore = (question, answers) => {\n  const count = getCorrectSelected(question && question.prompts, answers);\n  const totalCorrect = getTotalCorrect(question);\n\n  return parseFloat((count / totalCorrect).toFixed(2));\n};\n\nconst getOutComeScore = (question, env, answers) => {\n  const correctness = getCorrectness(question, env, answers);\n\n  return correctness === 'correct' ? 1 : correctness === 'partial' && true ? getPartialScore(question, answers) : 0;\n};\n\n/**\n * Generates detailed trace log for match-list scoring evaluation\n * @param {Object} question\n * @param {Object} session\n * @param {Object} env\n * @returns {Array<string>} traceLog\n */\nexport const getLogTrace = (question, session, env) => {\n  const traceLog = [];\n\n  const prompts = question?.prompts || [];\n  const answers = session?.value || {};\n\n  if (!answers || Object.keys(answers).length === 0) {\n    traceLog.push('Student did not provide any answer.');\n    return traceLog;\n  }\n\n  const totalPrompts = prompts.length;\n  traceLog.push(`Match-list item contains ${totalPrompts} question(s).`);\n\n  let correctCount = 0;\n  let answeredCount = 0;\n\n  prompts.forEach((prompt) => {\n    const expectedAnswer = prompt.relatedAnswer;\n    const studentAnswer = answers[prompt.id];\n\n    if (studentAnswer !== undefined) {\n      answeredCount += 1;\n\n      if (studentAnswer === expectedAnswer) {\n        correctCount += 1;\n        traceLog.push(`Question ${prompt.id}: correctly matched.`);\n      } else {\n        traceLog.push(\n          `Question ${prompt.id}: incorrectly matched (selected '${studentAnswer}', expected '${expectedAnswer}').`,\n        );\n      }\n    } else {\n      traceLog.push(`Question ${prompt.id}: no answer provided.`);\n    }\n  });\n\n  traceLog.push(\n    `Student correctly matched ${correctCount} out of ${totalPrompts} question(s).`,\n  );\n\n  const partialScoringEnabled = partialScoring.enabled(question, env);\n\n  if (partialScoringEnabled) {\n    traceLog.push('Score calculated using partial scoring.');\n    traceLog.push(\n      'Score is the number of correct matches divided by the total number of questions.',\n    );\n  } else {\n    traceLog.push('Score calculated using all-or-nothing scoring.');\n    traceLog.push(\n      'Student must match all questions correctly to receive full credit.',\n    );\n  }\n\n  const rawScore = getOutComeScore(question, env, answers);\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  return new Promise((resolve) => {\n    if (env.mode !== 'evaluate') {\n      resolve({ score: undefined, completed: undefined, logTrace: [] });\n    } else {\n      if (!session || isEmpty(session)) {\n        resolve({ score: 0, empty: true, logTrace: ['Student did not provide any answer.'] });\n      } else {\n        const out = {\n          score: getOutComeScore(question, env, session.value),\n          empty: false,\n          logTrace: getLogTrace(question, session, env),\n        };\n\n        resolve(out);\n      }\n    }\n  });\n};\n\nexport function createDefaultModel(model = {}) {\n  return new Promise((resolve) => {\n    resolve({\n      ...defaults,\n      ...model,\n    });\n  });\n}\n\nexport const normalize = (model) => ({ ...defaults, ...model });\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  question = normalize(question);\n  const correctness = getCorrectness(question, env, session && session.value);\n  const correctResponse = {};\n  const score = `${getOutComeScore(question, env, session && session.value) * 100}%`;\n  const correctInfo = {\n    score,\n    correctness,\n  };\n\n  const shuffledValues = {};\n  let prompts = question.prompts;\n  let answers = question.answers;\n\n  const us = (part) => (id, element, update) => {\n    return new Promise((resolve) => {\n      shuffledValues[part] = update.shuffledValues;\n      resolve();\n    });\n  };\n\n  const lockChoiceOrder = lockChoices(question, session, env);\n\n  if (!lockChoiceOrder) {\n    prompts = await getShuffledChoices(\n      prompts,\n      { shuffledValues: ((session && session.shuffledValues) || {}).prompts },\n      us('prompts'),\n      'id',\n    );\n    answers = await getShuffledChoices(\n      answers,\n      { shuffledValues: ((session && session.shuffledValues) || {}).answers },\n      us('answers'),\n      'id',\n    );\n  }\n\n  if (!isEmpty(shuffledValues)) {\n    if (updateSession && typeof updateSession === 'function') {\n      updateSession(session.id, session.element, {\n        shuffledValues,\n      }).catch((e) => {\n        // eslint-disable-next-line no-console\n        console.error('update session failed', e);\n      });\n    }\n  }\n\n  if (question && prompts) {\n    prompts.forEach((prompt) => {\n      correctResponse[prompt.id] = prompt.relatedAnswer;\n    });\n  }\n\n  const feedback =\n    env.mode === 'evaluate'\n      ? await getFeedbackForCorrectness(correctInfo.correctness, question.feedback)\n      : undefined;\n\n  const base = {\n    config: {\n      ...question,\n      prompts,\n      answers,\n    },\n    correctness: correctInfo,\n    feedback,\n    mode: env.mode,\n  };\n\n  if (env.role === 'instructor' && (env.mode === 'view' || env.mode === 'evaluate')) {\n    base.rationale = question.rationale;\n  } else {\n    base.rationale = null;\n  }\n\n  const out = Object.assign(base, {\n    correctResponse,\n  });\n\n  log('out: ', out);\n  return out;\n}\n\nexport const createCorrectResponseSession = (question, env) => {\n  return new Promise((resolve) => {\n    if (env.mode !== 'evaluate' && env.role === 'instructor') {\n      const { prompts, answers } = question;\n      const value = {};\n\n      prompts.forEach((p) => {\n        if (answers.filter((a) => a.id === p.relatedAnswer).length) {\n          value[p.id] = p.relatedAnswer;\n        }\n      });\n\n      resolve({\n        value,\n        id: '1',\n      });\n    } else {\n      resolve(null);\n    }\n  });\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 { MatchListAnswer, MatchListModel, MatchListPrompt } from '../types.js';\n\nexport default {\n  config: {\n    answers: [] as MatchListAnswer[],\n    prompt: '',\n    prompts: [] as MatchListPrompt[],\n    shuffled: false,\n  },\n} satisfies Omit<MatchListModel, 'id' | 'element'>;\n","import { isEmpty } from '@pie-element/shared-lodash';\nimport { getFeedbackForCorrectness, type Correctness, type Feedback } from '@pie-element/shared-feedback';\nimport { lockChoices, getShuffledChoices, partialScoring } from '@pie-element/shared-controller-utils';\nimport type { PieEnvironment, PieUpdateSession } from '@pie-element/shared-types';\nimport debug from 'debug';\n\nconst log = debug('@pie-element:match-list:controller');\n\nimport defaults from './defaults.js';\nimport type { MatchListAnswer, MatchListModel, MatchListPrompt, MatchListSession } from '../types.js';\n\ntype SessionValue = NonNullable<MatchListSession['value']>;\n\nexport type MatchListOutcome = { score?: number; empty?: boolean; completed?: boolean; logTrace: string[] };\n\nexport type ModelView = {\n  config: MatchListModel & { prompts: MatchListPrompt[] | undefined; answers: MatchListAnswer[] | undefined };\n  correctness: { score: string; correctness: Correctness | undefined };\n  feedback: string | undefined;\n  mode: PieEnvironment['mode'];\n  rationale?: string | null;\n  correctResponse: Record<string, string | number>;\n};\n\nconst getResponseCorrectness = (\n  model: MatchListModel,\n  answers: SessionValue | undefined,\n  env: PieEnvironment,\n): Correctness => {\n  const isPartialScoring = partialScoring.enabled(model, env);\n  const prompts = model.prompts;\n\n  if (!answers || Object.keys(answers).length === 0) {\n    return 'unanswered';\n  }\n\n  const totalCorrectAnswers = getTotalCorrect(model);\n  const correctAnswers = getCorrectSelected(prompts, answers);\n\n  if (totalCorrectAnswers === correctAnswers) {\n    return 'correct';\n  } else if (correctAnswers === 0) {\n    return 'incorrect';\n  } else if (isPartialScoring) {\n    return 'partial';\n  }\n\n  return 'incorrect';\n};\n\nconst getCorrectness = (question: MatchListModel, env: PieEnvironment, answers: SessionValue | undefined) => {\n  if (env.mode === 'evaluate') {\n    return getResponseCorrectness(question, answers, env);\n  }\n};\n\nconst getCorrectSelected = (prompts: MatchListPrompt[] = [], answers: SessionValue) => {\n  let correctAnswers = 0;\n\n  prompts.forEach((p) => {\n    if (p.relatedAnswer === answers[p.id]) {\n      correctAnswers += 1;\n    }\n  });\n\n  return correctAnswers;\n};\n\nconst getTotalCorrect = (question: MatchListModel) => {\n  return question && question.prompts ? question.prompts.length : 0;\n};\n\nconst getPartialScore = (question: MatchListModel, answers: SessionValue) => {\n  const count = getCorrectSelected(question && question.prompts, answers);\n  const totalCorrect = getTotalCorrect(question);\n\n  return parseFloat((count / totalCorrect).toFixed(2));\n};\n\nconst getOutComeScore = (question: MatchListModel, env: PieEnvironment, answers: SessionValue | undefined) => {\n  const correctness = getCorrectness(question, env, answers);\n\n  return correctness === 'correct' ? 1 : correctness === 'partial' && true ? getPartialScore(question, answers!) : 0;\n};\n\n/**\n * Generates detailed trace log for match-list scoring evaluation\n */\nexport const getLogTrace = (\n  question: MatchListModel,\n  session: MatchListSession | undefined,\n  env: PieEnvironment,\n): string[] => {\n  const traceLog: string[] = [];\n\n  const prompts = question?.prompts || [];\n  const answers = session?.value || {};\n\n  if (!answers || Object.keys(answers).length === 0) {\n    traceLog.push('Student did not provide any answer.');\n    return traceLog;\n  }\n\n  const totalPrompts = prompts.length;\n  traceLog.push(`Match-list item contains ${totalPrompts} question(s).`);\n\n  let correctCount = 0;\n  let answeredCount = 0;\n\n  prompts.forEach((prompt) => {\n    const expectedAnswer = prompt.relatedAnswer;\n    const studentAnswer = answers[prompt.id];\n\n    if (studentAnswer !== undefined) {\n      answeredCount += 1;\n\n      if (studentAnswer === expectedAnswer) {\n        correctCount += 1;\n        traceLog.push(`Question ${prompt.id}: correctly matched.`);\n      } else {\n        traceLog.push(\n          `Question ${prompt.id}: incorrectly matched (selected '${studentAnswer}', expected '${expectedAnswer}').`,\n        );\n      }\n    } else {\n      traceLog.push(`Question ${prompt.id}: no answer provided.`);\n    }\n  });\n\n  traceLog.push(\n    `Student correctly matched ${correctCount} out of ${totalPrompts} question(s).`,\n  );\n\n  const partialScoringEnabled = partialScoring.enabled(question, env);\n\n  if (partialScoringEnabled) {\n    traceLog.push('Score calculated using partial scoring.');\n    traceLog.push(\n      'Score is the number of correct matches divided by the total number of questions.',\n    );\n  } else {\n    traceLog.push('Score calculated using all-or-nothing scoring.');\n    traceLog.push(\n      'Student must match all questions correctly to receive full credit.',\n    );\n  }\n\n  const rawScore = getOutComeScore(question, env, answers);\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: MatchListModel, session: MatchListSession | undefined, env: PieEnvironment) => {\n  return new Promise<MatchListOutcome>((resolve) => {\n    if (env.mode !== 'evaluate') {\n      resolve({ score: undefined, completed: undefined, logTrace: [] });\n    } else {\n      if (!session || isEmpty(session)) {\n        resolve({ score: 0, empty: true, logTrace: ['Student did not provide any answer.'] });\n      } else {\n        const out = {\n          score: getOutComeScore(question, env, session!.value),\n          empty: false,\n          logTrace: getLogTrace(question, session, env),\n        };\n\n        resolve(out);\n      }\n    }\n  });\n};\n\nexport function createDefaultModel(model: Partial<MatchListModel> = {}) {\n  return new Promise<Omit<MatchListModel, 'id' | 'element'> & Partial<MatchListModel>>((resolve) => {\n    resolve({\n      ...defaults,\n      ...model,\n    });\n  });\n}\n\nexport const normalize = (model: MatchListModel): MatchListModel => ({ ...defaults, ...model });\n\n/**\n * @param updateSession - optional - a function that will set the properties passed into it on the session.\n */\nexport async function model(\n  question: MatchListModel,\n  session: MatchListSession | undefined,\n  env: PieEnvironment,\n  updateSession?: PieUpdateSession,\n): Promise<ModelView> {\n  question = normalize(question);\n  const correctness = getCorrectness(question, env, session && session.value);\n  const correctResponse: Record<string, string | number> = {};\n  const score = `${getOutComeScore(question, env, session && session.value) * 100}%`;\n  const correctInfo = {\n    score,\n    correctness,\n  };\n\n  const shuffledValues: NonNullable<MatchListSession['shuffledValues']> = {};\n  let prompts = question.prompts;\n  let answers = question.answers;\n\n  const us = (part: 'prompts' | 'answers'): PieUpdateSession => (_id, _element, update) => {\n    return new Promise((resolve) => {\n      shuffledValues[part] = update.shuffledValues as (string | number)[];\n      resolve();\n    });\n  };\n\n  const lockChoiceOrder = lockChoices(question, session as { id?: string; element?: string } | undefined, env);\n\n  if (!lockChoiceOrder) {\n    prompts = await getShuffledChoices(\n      prompts!,\n      { shuffledValues: ((session && session.shuffledValues) || {}).prompts as string[] | undefined },\n      us('prompts'),\n      'id',\n    );\n    answers = await getShuffledChoices(\n      answers!,\n      { shuffledValues: ((session && session.shuffledValues) || {}).answers as string[] | undefined },\n      us('answers'),\n      'id',\n    );\n  }\n\n  if (!isEmpty(shuffledValues)) {\n    if (updateSession && typeof updateSession === 'function') {\n      updateSession(session!.id as string, session!.element as string, {\n        shuffledValues,\n      }).catch((e: unknown) => {\n        // eslint-disable-next-line no-console\n        console.error('update session failed', e);\n      });\n    }\n  }\n\n  if (question && prompts) {\n    prompts.forEach((prompt) => {\n      correctResponse[prompt.id] = prompt.relatedAnswer;\n    });\n  }\n\n  const feedback =\n    env.mode === 'evaluate'\n      ? await getFeedbackForCorrectness(correctInfo.correctness!, question.feedback as Partial<Feedback>)\n      : undefined;\n\n  const base: Omit<ModelView, 'correctResponse'> = {\n    config: {\n      ...question,\n      prompts,\n      answers,\n    },\n    correctness: correctInfo,\n    feedback,\n    mode: env.mode,\n  };\n\n  if (env.role === 'instructor' && (env.mode === 'view' || env.mode === 'evaluate')) {\n    base.rationale = question.rationale;\n  } else {\n    base.rationale = null;\n  }\n\n  const out = Object.assign(base, {\n    correctResponse,\n  });\n\n  log('out: ', out);\n  return out;\n}\n\nexport const createCorrectResponseSession = (question: MatchListModel, env: PieEnvironment) => {\n  return new Promise<MatchListSession | null>((resolve) => {\n    if (env.mode !== 'evaluate' && env.role === 'instructor') {\n      const { prompts, answers } = question;\n      const value: SessionValue = {};\n\n      prompts!.forEach((p) => {\n        if (answers!.filter((a) => a.id === p.relatedAnswer).length) {\n          value[p.id] = p.relatedAnswer;\n        }\n      });\n\n      resolve({\n        value,\n        id: '1',\n      });\n    } else {\n      resolve(null);\n    }\n  });\n};\n"],"mappings":"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"}

package/dist/controller/defaults.d.ts

@@ -1,9 +1,10 @@
+import type { MatchListAnswer, MatchListPrompt } from '../types.js';
 declare const _default: {
     config: {
-        answers: never[];
+        answers: MatchListAnswer[];
         prompt: string;
-        prompts: never[];
-        shuffled: boolean;
+        prompts: MatchListPrompt[];
+        shuffled: false;
     };
 };
 export default _default;

package/dist/controller/index.d.ts

@@ -1,30 +1,35 @@
+import { type Correctness } from '@pie-element/shared-feedback';
+import type { PieEnvironment, PieUpdateSession } from '@pie-element/shared-types';
+import type { MatchListAnswer, MatchListModel, MatchListPrompt, MatchListSession } from '../types.js';
+export type MatchListOutcome = {
+    score?: number;
+    empty?: boolean;
+    completed?: boolean;
+    logTrace: string[];
+};
+export type ModelView = {
+    config: MatchListModel & {
+        prompts: MatchListPrompt[] | undefined;
+        answers: MatchListAnswer[] | undefined;
+    };
+    correctness: {
+        score: string;
+        correctness: Correctness | undefined;
+    };
+    feedback: string | undefined;
+    mode: PieEnvironment['mode'];
+    rationale?: string | null;
+    correctResponse: Record<string, string | number>;
+};
 /**
  * Generates detailed trace log for match-list scoring evaluation
- * @param {Object} question
- * @param {Object} session
- * @param {Object} env
- * @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 normalize: (model: any) => any;
+export declare const getLogTrace: (question: MatchListModel, session: MatchListSession | undefined, env: PieEnvironment) => string[];
+export declare const outcome: (question: MatchListModel, session: MatchListSession | undefined, env: PieEnvironment) => Promise<MatchListOutcome>;
+export declare function createDefaultModel(model?: Partial<MatchListModel>): Promise<Omit<MatchListModel, "id" | "element"> & Partial<MatchListModel>>;
+export declare const normalize: (model: MatchListModel) => MatchListModel;
 /**
- *
- * @param {*} question
- * @param {*} session
- * @param {*} env
- * @param {*} updateSession - optional - a function that will set the properties passed into it on the session.
+ * @param updateSession - optional - a function that will set the properties passed into it on the session.
  */
-export declare function model(question: any, session: any, env: any, updateSession: any): Promise<{
-    config: any;
-    correctness: {
-        score: string;
-        correctness: string | undefined;
-    };
-    feedback: string | undefined;
-    mode: any;
-} & {
-    correctResponse: {};
-}>;
-export declare const createCorrectResponseSession: (question: any, env: any) => Promise<unknown>;
+export declare function model(question: MatchListModel, session: MatchListSession | undefined, env: PieEnvironment, updateSession?: PieUpdateSession): Promise<ModelView>;
+export declare const createCorrectResponseSession: (question: MatchListModel, env: PieEnvironment) => Promise<MatchListSession | null>;

package/dist/index.d.ts

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

package/dist/schemas/model.schema.json

@@ -0,0 +1,435 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cdn.jsdelivr.net/npm/@pie-element/match-list@8.0.4/dist/schemas/model.schema.json",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Identifier to identify the Pie Element in html markup, Must be unique within a pie item config."
+    },
+    "element": {
+      "type": "string",
+      "description": "The html Element tag name: the key in the item config's `elements` map, e.g. \"multiple-choice\""
+    },
+    "accessibilityCatalogs": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/AccessibilityCatalog"
+      },
+      "description": "QTI-aligned accessibility catalogs whose cards dock to content nodes by `data-catalog-idref`"
+    },
+    "prompt": {
+      "type": "string",
+      "description": "The question prompt or item stem"
+    },
+    "prompts": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/MatchListPrompt"
+      },
+      "description": "The question prompts that are going to be displayed. The default model carries none."
+    },
+    "answers": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/MatchListAnswer"
+      },
+      "description": "The answer rows that are going to be displayed. The default model carries none."
+    },
+    "lockChoiceOrder": {
+      "type": "boolean",
+      "description": "Indicates if answers should be locked in order according to the model or if they should be shuffed true - order is respected according to model false - order is shuffled"
+    },
+    "duplicates": {
+      "type": "boolean",
+      "description": "Indicates if duplicates are allowed"
+    },
+    "partialScoring": {
+      "type": "boolean",
+      "description": "Indicates if partial scoring should be used. Scoring treats an absent value as enabled."
+    },
+    "feedback": {
+      "$ref": "#/definitions/MatchListFeedback",
+      "description": "Feedback shown in evaluate mode"
+    },
+    "rationale": {
+      "type": "string",
+      "description": "Indicates rationale for correct answer; shown to instructors in view and evaluate mode"
+    },
+    "language": {
+      "type": "string",
+      "description": "Indicates the language of the component Supported options: en, es, en_US, en-US, es_ES, es-ES, es_MX, es-MX"
+    },
+    "config": {
+      "type": "object",
+      "properties": {
+        "answers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MatchListAnswer"
+          }
+        },
+        "prompt": {
+          "type": "string"
+        },
+        "prompts": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MatchListPrompt"
+          }
+        },
+        "shuffled": {
+          "type": "boolean"
+        }
+      },
+      "description": "Not read by this element: the controller defaults nest their values under this key, so the default model carries it, and the controller reads `prompts`, `answers` and `prompt` from the root"
+    }
+  },
+  "required": [
+    "element",
+    "id"
+  ],
+  "description": "Model for the `@pie-element/match-list` Interaction",
+  "definitions": {
+    "AccessibilityCatalog": {
+      "type": "object",
+      "properties": {
+        "identifier": {
+          "type": "string"
+        },
+        "cards": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CatalogCard"
+          }
+        }
+      },
+      "required": [
+        "identifier",
+        "cards"
+      ]
+    },
+    "CatalogCard": {
+      "type": "object",
+      "properties": {
+        "catalog": {
+          "type": "string"
+        },
+        "language": {
+          "type": "string"
+        },
+        "content": {
+          "type": "string"
+        },
+        "payload": {
+          "$ref": "#/definitions/CatalogCardPayload"
+        }
+      },
+      "required": [
+        "catalog"
+      ],
+      "description": "QTI-aligned accessibility catalog entry: one alternate representation of a content node, docked to it by `data-catalog-idref`.\n\nMaps onto QTI 3's `qti-card`. `catalog` is QTI's `@support` and is the only discriminant — there is deliberately no second `kind` field. `language` is the card entry's `xml:lang`. QTI's single content slot is represented by exactly one of two fields, never both, with nothing mirrored between them:\n\n- `content` — the string form, for alternates a string can express: SSML for   `spoken`, plain text for `simplified-language`.\n- `payload` — the structured form, for what a string cannot express. Today   only a signing video.\n\nOne generic payload slot rather than a field per accommodation (`signLanguage`, `braille`, …), which is the shape pie-players canonicalises and the shape this repo now follows. A field per accommodation makes every new structured alternate a breaking widening of this type in every consumer that reads cards, and it gives the same fact two names across repos — which produced a real bug: a card carrying `signLanguage` rendered its video in the player and was simultaneously reported as carrying no payload by the player's \"what alternates exist\" path, because only one of the two read paths knew about the alias.\n\n`catalog` is a bare `string` because the vocabulary is open-ended and unknown tokens must be ignored rather than rejected. TypeScript therefore cannot express \"a `sign-language` card must carry a payload\", so a `{ catalog: 'sign-language', content: '<url>' }` object still satisfies this type. That legacy bare-URL form is not supported: runtime validation on the consuming side must reject it rather than render the URL as visible text. Narrow with `isSignLanguageCard`."
+    },
+    "CatalogCardPayload": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/SignLanguageCardPayload"
+        },
+        {
+          "$ref": "#/definitions/SpokenAudioCardPayload"
+        }
+      ],
+      "description": "The structured forms a card's `payload` may take.\n\nWhich one applies is decided by the card's `catalog`, so this union carries no discriminant of its own — a second discriminant could contradict the first. Consumers select a card by catalog type and then validate the payload structurally, which they must do regardless: catalog data is authored, wire-facing and untrusted."
+    },
+    "SignLanguageCardPayload": {
+      "type": "object",
+      "properties": {
+        "signLang": {
+          "type": "string",
+          "description": "Language tag for the signed translation — BCP 47, which admits ISO 639-3 subtags for languages with no 639-1/2 code. \"ase\" is ASL, matching QTI 3 `xml:lang`.\n\nThis is the language of the *adaptation*, not the item's base content language (AfA/PNP's `languageOfAdaptation`). The distinction is load bearing: a Spanish item's signed alternate is LSM, not ASL, so `signLang` must never be inferred from the item or assessment content language.\n\nOptional, and redundant on almost every card. The card's `language` states the same code and is the only field pie-players resolves a card on — resolution runs before anything knows the card is a signing card, so it can only key on the generic field — and the player falls back to it when this is absent. Author it only where the two differ: a card tagged with the item's content language (`language: 'en-US'`, `signLang: 'ase'`) so resolution reaches it by the default-language rung. The pie-api-aws importer emits `language` alone."
+        },
+        "media": {
+          "$ref": "#/definitions/MediaAssetRef"
+        },
+        "fragment": {
+          "$ref": "#/definitions/MediaFragmentRange"
+        }
+      },
+      "required": [
+        "media"
+      ],
+      "description": "Payload for a `sign-language` catalog card: a signed translation of the content node the card is docked to."
+    },
+    "MediaAssetRef": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "number",
+          "const": 1
+        },
+        "id": {
+          "type": "string"
+        },
+        "kind": {
+          "$ref": "#/definitions/MediaKind"
+        },
+        "sources": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MediaSource"
+          }
+        },
+        "poster": {
+          "type": "string"
+        },
+        "thumbnail": {
+          "type": "string"
+        },
+        "durationSeconds": {
+          "type": "number"
+        },
+        "tracks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TextTrackRef"
+          }
+        },
+        "transcript": {
+          "$ref": "#/definitions/TranscriptRef"
+        },
+        "label": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "lang": {
+          "type": "string",
+          "description": "Language of the asset itself, as authored metadata. Sign-language cards leave it unset: the card's `language` already states the adaptation language, and a second copy is a second thing to keep in agreement."
+        }
+      },
+      "required": [
+        "version",
+        "id",
+        "kind",
+        "sources"
+      ],
+      "description": "Reference to a media asset and its playable encodings.\n\nStructurally mirrors the `MediaAssetRef` in the pie-players `media-asset-contract` PRD. The two definitions are deliberately kept as separate declarations rather than a shared package dependency: this repo owns the item-model side of the contract, pie-players owns the player side, and both read the same authored JSON, so structural typing is sufficient for interop. Fixture parity — not a package edge — is what pins them together.\n\nSign-language catalog cards were the first consumer and use only the core source fields. The optional presentation, track, and transcript metadata is declared for broader consumers such as video stimuli; it remains meaningless for a signing clip, where captions would duplicate the text already on screen."
+    },
+    "MediaKind": {
+      "type": "string",
+      "enum": [
+        "image",
+        "audio",
+        "video",
+        "other"
+      ]
+    },
+    "MediaSource": {
+      "type": "object",
+      "properties": {
+        "src": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "description": "MIME type, e.g. \"video/mp4\"."
+        },
+        "width": {
+          "type": "number"
+        },
+        "height": {
+          "type": "number"
+        },
+        "bitrate": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "src"
+      ],
+      "description": "One playable encoding of a media asset."
+    },
+    "TextTrackRef": {
+      "type": "object",
+      "properties": {
+        "src": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "captions",
+            "subtitles",
+            "descriptions",
+            "chapters",
+            "metadata"
+          ]
+        },
+        "lang": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "default": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "src",
+        "kind",
+        "lang",
+        "label"
+      ],
+      "description": "One authored text track associated with an audio or video asset."
+    },
+    "TranscriptRef": {
+      "type": "object",
+      "properties": {
+        "src": {
+          "type": "string"
+        },
+        "html": {
+          "type": "string"
+        },
+        "plainText": {
+          "type": "string"
+        },
+        "lang": {
+          "type": "string"
+        }
+      },
+      "description": "Inline or externally hosted transcript content for a media asset."
+    },
+    "MediaFragmentRange": {
+      "type": "object",
+      "properties": {
+        "startSeconds": {
+          "type": "number"
+        },
+        "endSeconds": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "startSeconds"
+      ],
+      "description": "A time slice within a media asset, so one recording can serve several content nodes. Mirrors QTI 3's Media Fragments URI usage."
+    },
+    "SpokenAudioCardPayload": {
+      "type": "object",
+      "properties": {
+        "media": {
+          "$ref": "#/definitions/MediaAssetRef"
+        },
+        "fragment": {
+          "$ref": "#/definitions/MediaFragmentRange"
+        }
+      },
+      "required": [
+        "media"
+      ],
+      "description": "Payload for a `spoken` catalog card that is a recording rather than a script.\n\nQTI 3 treats recorded audio and synthesized speech as the same support: both are `spoken`, so this is not a new accommodation, it is the other form the existing one can take. A node commonly carries both this and a `content` card in the same language — the script is both what the audio was generated from and the fallback for when the audio cannot play; pie-players resolves between them with `CatalogLookupOptions.form`.\n\nNo `kind` discriminant, for the same reason `SignLanguageCardPayload` has none: the card's `catalog` already says what this is."
+    },
+    "MatchListPrompt": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": [
+            "string",
+            "number"
+          ],
+          "description": "Identifier for a question prompt"
+        },
+        "title": {
+          "type": "string",
+          "description": "Text that will be displayed in the question prompt row"
+        },
+        "relatedAnswer": {
+          "type": [
+            "string",
+            "number"
+          ],
+          "description": "Id for the correct answer for this question prompt"
+        }
+      },
+      "required": [
+        "id",
+        "title",
+        "relatedAnswer"
+      ],
+      "description": "Multiple question prompts"
+    },
+    "MatchListAnswer": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": [
+            "string",
+            "number"
+          ],
+          "description": "Identifier for an answer row; the response counts as complete only when every placed id is a number"
+        },
+        "title": {
+          "type": "string",
+          "description": "Text that will be displayed in the answer row"
+        }
+      },
+      "required": [
+        "id",
+        "title"
+      ],
+      "description": "Multiple answers"
+    },
+    "MatchListFeedback": {
+      "type": "object",
+      "properties": {
+        "correct": {
+          "$ref": "#/definitions/MatchListFeedbackType",
+          "description": "Indicates the configuration for feedback when answer is correct"
+        },
+        "incorrect": {
+          "$ref": "#/definitions/MatchListFeedbackType",
+          "description": "Indicates the configuration for feedback when answer is incorrect"
+        },
+        "partial": {
+          "$ref": "#/definitions/MatchListFeedbackType",
+          "description": "Indicates the configuration for feedback when answer is partially correct"
+        },
+        "unanswered": {
+          "$ref": "#/definitions/MatchListFeedbackType",
+          "description": "Indicates the configuration for feedback when there is no answer"
+        }
+      },
+      "description": "Feedback for each correctness level; a level left out gets its default message"
+    },
+    "MatchListFeedbackType": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "default",
+            "none",
+            "custom"
+          ],
+          "description": "Indicates the feedback type"
+        },
+        "default": {
+          "type": "string",
+          "description": "Indicates the feedback value"
+        },
+        "custom": {
+          "type": "string",
+          "description": "Indicates the feedback custom value"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "description": "Feedback for one correctness level. A `custom` type without `custom` text shows the default message."
+    }
+  },
+  "additionalProperties": false
+}

package/dist/schemas/session.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cdn.jsdelivr.net/npm/@pie-element/match-list@8.0.4/dist/schemas/session.schema.json",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Identifier of the session"
+    },
+    "element": {
+      "type": "string",
+      "description": "The element the session belongs to"
+    },
+    "value": {
+      "type": "object",
+      "additionalProperties": {
+        "type": [
+          "string",
+          "number"
+        ]
+      },
+      "description": "The answer placed in each response area: the answer's `id`, keyed by the prompt's `id`"
+    },
+    "shuffledValues": {
+      "type": "object",
+      "properties": {
+        "prompts": {
+          "type": "array",
+          "items": {
+            "type": [
+              "string",
+              "number"
+            ]
+          }
+        },
+        "answers": {
+          "type": "array",
+          "items": {
+            "type": [
+              "string",
+              "number"
+            ]
+          }
+        }
+      },
+      "description": "Prompt and answer ids in the order they were shuffled for this learner, when choice order is not locked"
+    }
+  },
+  "definitions": {}
+}

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+import type { PieModel } from '@pie-element/shared-types';
+/** Multiple question prompts */
+export interface MatchListPrompt {
+    /** Identifier for a question prompt */
+    id: string | number;
+    /** Text that will be displayed in the question prompt row */
+    title: string;
+    /** Id for the correct answer for this question prompt */
+    relatedAnswer: string | number;
+}
+/** Multiple answers */
+export interface MatchListAnswer {
+    /** Identifier for an answer row; the response counts as complete only when every placed id is a number */
+    id: string | number;
+    /** Text that will be displayed in the answer row */
+    title: string;
+}
+/**
+ * Feedback for one correctness level. A `custom` type without `custom` text shows the default
+ * message.
+ */
+export interface MatchListFeedbackType {
+    /** Indicates the feedback type */
+    type: 'default' | 'none' | 'custom';
+    /** Indicates the feedback value */
+    default?: string;
+    /** Indicates the feedback custom value */
+    custom?: string;
+}
+/** Feedback for each correctness level; a level left out gets its default message */
+export interface MatchListFeedback {
+    /** Indicates the configuration for feedback when answer is correct */
+    correct?: MatchListFeedbackType;
+    /** Indicates the configuration for feedback when answer is incorrect */
+    incorrect?: MatchListFeedbackType;
+    /** Indicates the configuration for feedback when answer is partially correct */
+    partial?: MatchListFeedbackType;
+    /** Indicates the configuration for feedback when there is no answer */
+    unanswered?: MatchListFeedbackType;
+}
+/** Model for the `@pie-element/match-list` Interaction */
+export interface MatchListModel extends PieModel {
+    /**  The question prompt or item stem*/
+    prompt?: string;
+    /** The question prompts that are going to be displayed. The default model carries none. */
+    prompts?: MatchListPrompt[];
+    /** The answer rows that are going to be displayed. The default model carries none. */
+    answers?: MatchListAnswer[];
+    /**
+     * Indicates if answers should be locked in order according to the model or if they should be shuffed
+     * true - order is respected according to model
+     * false - order is shuffled
+     */
+    lockChoiceOrder?: boolean;
+    /** Indicates if duplicates are allowed */
+    duplicates?: boolean;
+    /** Indicates if partial scoring should be used. Scoring treats an absent value as enabled. */
+    partialScoring?: boolean;
+    /** Feedback shown in evaluate mode */
+    feedback?: MatchListFeedback;
+    /** Indicates rationale for correct answer; shown to instructors in view and evaluate mode */
+    rationale?: string;
+    /**
+     * Indicates the language of the component
+     * Supported options: en, es, en_US, en-US, es_ES, es-ES, es_MX, es-MX
+     */
+    language?: string;
+    /**
+     * Not read by this element: the controller defaults nest their values under this key, so the
+     * default model carries it, and the controller reads `prompts`, `answers` and `prompt` from the root
+     */
+    config?: {
+        answers?: MatchListAnswer[];
+        prompt?: string;
+        prompts?: MatchListPrompt[];
+        shuffled?: boolean;
+    };
+}
+export interface MatchListSession {
+    /** Identifier of the session */
+    id?: string;
+    /** The element the session belongs to */
+    element?: string;
+    /** The answer placed in each response area: the answer's `id`, keyed by the prompt's `id` */
+    value?: Record<string, string | number>;
+    /** Prompt and answer ids in the order they were shuffled for this learner, when choice order is not locked */
+    shuffledValues?: {
+        prompts?: (string | number)[];
+        answers?: (string | number)[];
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pie-element/match-list",
-  "version": "8.0.4-next.20261011174919",
+  "version": "8.0.4",
   "description": "",
   "repository": {
     "type": "git",
@@ -13,19 +13,20 @@
     "@emotion/react": "^11.14.0",
     "@mui/icons-material": "^7.3.4",
     "@mui/material": "^7.3.4",
-    "@pie-element/shared-utils": "0.1.4-next.20261008072957",
-    "@pie-lib/correct-answer-toggle": "5.0.4-next.20261011174919",
-    "@pie-lib/drag": "5.0.4-next.20261009061152",
-    "@pie-lib/render-ui": "8.0.4-next.20261009061152",
+    "@pie-element/shared-utils": "0.1.4",
+    "@pie-lib/correct-answer-toggle": "5.0.4",
+    "@pie-lib/drag": "5.0.4",
+    "@pie-lib/render-ui": "8.0.4",
     "debug": "^4.1.1",
     "prop-types": "^15.8.1",
-    "@pie-element/shared-lodash": "0.1.3-next.20261006160832",
-    "@pie-element/shared-feedback": "0.1.3-next.20261006160832",
-    "@pie-element/shared-controller-utils": "0.1.2-next.20261002215153",
-    "@pie-element/shared-player-events": "0.1.2-next.20261002215153",
-    "@pie-element/shared-math-rendering-mathjax": "0.1.5-next.20261009061152",
+    "@pie-element/shared-lodash": "0.1.2",
+    "@pie-element/shared-feedback": "0.1.2",
+    "@pie-element/shared-controller-utils": "0.1.2",
+    "@pie-element/shared-player-events": "0.1.1",
+    "@pie-element/shared-math-rendering-mathjax": "0.1.5",
     "react": "^18.2.0",
-    "react-dom": "^18.2.0"
+    "react-dom": "^18.2.0",
+    "@pie-element/shared-types": "0.2.1"
   },
   "exports": {
     ".": {
@@ -56,6 +57,8 @@
       "types": "./dist/runtime-support.d.ts",
       "default": "./dist/runtime-support.js"
     },
+    "./schemas/model.schema.json": "./dist/schemas/model.schema.json",
+    "./schemas/session.schema.json": "./dist/schemas/session.schema.json",
     "./package.json": "./package.json"
   },
   "type": "module",
@@ -67,7 +70,7 @@
   ],
   "sideEffects": false,
   "scripts": {
-    "build": "bun x vite build && bun x vite build --config ../../../tools/vite/element-browser.config.ts && bun x vite build --config vite.config.iife.ts && bun x tsc --emitDeclarationOnly",
+    "build": "bun x vite build && bun x vite build --config ../../../tools/vite/element-browser.config.ts && bun x vite build --config vite.config.iife.ts && bun x tsc --emitDeclarationOnly && bun ../../../tools/schemas/build.ts",
     "dev": "bun x vite",
     "demo": "bun x vite --mode demo",
     "test": "bun x vitest run"