@pie-element/mc-populated-blank 0.2.13 → 0.3.0-next.10

package/dist/browser/controller/index.js

@@ -0,0 +1,209 @@
+import { t as e } from "../layoutLimits-Bp17YP2V.js";
+//#region src/controller/defaults.ts
+var t = "{{blank}}", n = { model: {
+	prompt: "",
+	promptEnabled: !0,
+	interactionMode: "populate_blank",
+	layoutProfile: "",
+	choiceLayout: "",
+	layoutProfilePresets: {},
+	layoutLimits: { ...e },
+	audioButtonSkin: null,
+	audioButtonSkinsByLocale: {},
+	sentenceHtml: "",
+	template: "",
+	choiceMode: "text",
+	choices: [],
+	choiceGroupLabel: "",
+	correctChoiceId: "",
+	hasAudio: !1,
+	autoplayAudioEnabled: !1,
+	completeAudioEnabled: !1,
+	audioUrl: "",
+	audioTranscript: "",
+	locale: "",
+	teacherInstructions: "",
+	teacherInstructionsEnabled: !0
+} }, r = {
+	model: {
+		...n.model,
+		prompt: "<p><strong>Demo prompt</strong></p>",
+		template: `<p>The answer is ${t}.</p>`,
+		choices: [
+			{
+				id: "c1",
+				labelHtml: "<p>Option A</p>"
+			},
+			{
+				id: "c2",
+				labelHtml: "<p>Option B</p>"
+			},
+			{
+				id: "c3",
+				labelHtml: "<p>Option C</p>"
+			}
+		],
+		correctChoiceId: "c2"
+	},
+	configuration: { prompt: {
+		label: "Prompt",
+		settings: !0
+	} }
+}, i = (e) => !!e && typeof e == "object" && !Array.isArray(e) && Object.keys(e).length === 0;
+function a(e) {
+	return e ? (e.match(/\{\{blank\}\}/g) || []).length : 0;
+}
+var o = (e, t) => {
+	if (!t?.choiceId) return "unanswered";
+	let n = e?.correctChoiceId || "";
+	return t.choiceId === n ? "correct" : "incorrect";
+}, s = (e, t) => +(o(e, t) === "correct"), c = (e, t, n) => new Promise((r) => {
+	if (!t || i(t)) {
+		r({
+			score: 0,
+			empty: !0,
+			traceLog: ["Student did not select any answers. Score is 0."]
+		});
+		return;
+	}
+	t = f(t);
+	let a = d(e);
+	if (o(a, t) === "unanswered") {
+		r({
+			score: 0,
+			empty: !0,
+			traceLog: ["Student did not select any answers. Score is 0."]
+		});
+		return;
+	}
+	let c = s(a, t);
+	r({
+		score: c,
+		empty: !1,
+		traceLog: [
+			`Mode: ${n?.mode || "unknown"}.`,
+			`Student selected choice: ${t.choiceId}.`,
+			`Correct choice: ${a.correctChoiceId || "none"}.`,
+			`Final score: ${c}.`
+		]
+	});
+}), l = (t, n = {}) => ({
+	...t,
+	...n,
+	layoutLimits: {
+		...e,
+		...n?.layoutLimits || {}
+	}
+}), u = (e = {}) => l(r.model, e), d = (e = {}) => {
+	let { shuffle: t, ...r } = e || {};
+	return {
+		...l(n.model, r),
+		lockChoiceOrder: typeof r.lockChoiceOrder == "boolean" ? r.lockChoiceOrder : t !== !0
+	};
+}, f = (e) => ({ ...e }), p = (e, t) => e?.lockChoiceOrder || t?.["@pie-element"]?.lockChoiceOrder ? !0 : t?.role === "instructor";
+function m(e) {
+	let t = [...e];
+	for (let e = t.length - 1; e > 0; e--) {
+		let n = Math.floor(Math.random() * (e + 1));
+		[t[e], t[n]] = [t[n], t[e]];
+	}
+	return t;
+}
+var h = ({ id: e, labelHtml: t, imageUrl: n, imageAlt: r }) => ({
+	id: e,
+	...t === void 0 ? {} : { labelHtml: t },
+	...n === void 0 ? {} : { imageUrl: n },
+	...r === void 0 ? {} : { imageAlt: r }
+}), g = (e) => Array.isArray(e?.data?.shuffledValues) ? e.data.shuffledValues : Array.isArray(e?.shuffledValues) ? e.shuffledValues : [], _ = (e, t, n) => {
+	let r = t.map((t) => e.find((e) => e?.[n] === t)).filter((e) => !!e);
+	if (r.length === e.length) return r;
+	let i = new Set(r.map((e) => e[n])), a = e.filter((e) => !i.has(e?.[n]));
+	return [...r, ...a];
+}, v = async (e, t, n, r) => {
+	let i = Array.isArray(e?.choices) ? [...e.choices] : [];
+	if (!i.length || p(e, n || {})) return i;
+	let a = g(t);
+	if (a.length) return _(i, a, "id");
+	let o = m(i);
+	if (r && typeof r == "function" && t?.id && t?.element) {
+		let e = o.map((e) => e?.id).filter(Boolean);
+		e.length && await r(t.id, t.element, { shuffledValues: e });
+	}
+	return o;
+}, y = async (t, n, r, i) => {
+	let a = n || {}, s = r || {}, c = d(t), l = (await v(c, a, s, i)).filter((e) => !!e && typeof e == "object").map(h), u = {
+		prompt: c.promptEnabled ? c.prompt : null,
+		interactionMode: c.interactionMode || "populate_blank",
+		layoutProfile: c.layoutProfile || "",
+		choiceLayout: c.choiceLayout || "",
+		layoutProfilePresets: c.layoutProfilePresets && typeof c.layoutProfilePresets == "object" ? c.layoutProfilePresets : {},
+		layoutLimits: c.layoutLimits || { ...e },
+		audioButtonSkin: c.audioButtonSkin && typeof c.audioButtonSkin == "object" ? c.audioButtonSkin : null,
+		audioButtonSkinsByLocale: c.audioButtonSkinsByLocale && typeof c.audioButtonSkinsByLocale == "object" ? c.audioButtonSkinsByLocale : {},
+		sentenceHtml: c.sentenceHtml || null,
+		template: c.template,
+		choiceMode: c.choiceMode,
+		choices: l,
+		choiceGroupLabel: c.choiceGroupLabel || "",
+		hasAudio: c.hasAudio,
+		autoplayAudioEnabled: !!c.autoplayAudioEnabled,
+		completeAudioEnabled: !!c.completeAudioEnabled,
+		audioUrl: c.hasAudio ? c.audioUrl : null,
+		audioTranscript: c.hasAudio ? c.audioTranscript : null,
+		customType: c.customType || "",
+		useFeatureButtonAudio: typeof c.useFeatureButtonAudio == "boolean" ? c.useFeatureButtonAudio : void 0,
+		locale: c.locale || "",
+		language: c.language || c.locale || void 0,
+		disabled: s.mode !== "gather",
+		mode: s.mode
+	};
+	if (s.mode === "evaluate") {
+		let e = o(c, a);
+		u.correctness = e, u.responseCorrect = e === "correct", u.correctChoiceId = c.correctChoiceId;
+	}
+	return s.role === "instructor" && (s.mode === "view" || s.mode === "evaluate") ? u.teacherInstructions = c.teacherInstructionsEnabled ? c.teacherInstructions : null : u.teacherInstructions = null, u;
+}, b = (e, t) => new Promise((n) => {
+	t.mode !== "evaluate" && t.role === "instructor" ? n({
+		id: "1",
+		choiceId: e?.correctChoiceId || ""
+	}) : n(null);
+}), x = (e) => (e || "").replace(/(<(?!img|iframe|source)([^>]+)>)/gi, "").trim(), S = (e = {}, n = {}) => {
+	let r = {}, { minAnswerChoices: i = 2, maxAnswerChoices: o } = n;
+	(e.promptEnabled || n.prompt?.required) && !x(e.prompt) && (r.prompt = "This field is required."), n.teacherInstructions?.required && !x(e.teacherInstructions) && (r.teacherInstructions = "This field is required.");
+	let s = e.interactionMode || "populate_blank", c = a(e.template || "");
+	s === "audio_mc_only" ? c > 0 && (r.template = `Template cannot contain ${t} in audio-only mode`) : s === "populate_blank" ? c === 0 ? r.template = `Template must contain exactly one ${t} placeholder` : c > 1 && (r.template = `Template must contain only one ${t} placeholder`) : r.interactionMode = "Unknown interaction mode";
+	let l = Array.isArray(e.choices) ? e.choices : [];
+	l.length < i ? r.answerChoices = `There should be at least ${i} choices defined.` : o != null && l.length > o && (r.answerChoices = `No more than ${o} choices should be defined.`);
+	let u = e.choiceMode || "text", d = {}, f = /* @__PURE__ */ new Set(), p = /* @__PURE__ */ new Set();
+	l.forEach((e, t) => {
+		let n = e?.id || String(t);
+		if (!e?.id) {
+			d[n] = "Choice needs an id.";
+			return;
+		}
+		if (f.has(e.id)) {
+			d[n] = "Choice id should be unique.";
+			return;
+		}
+		if (f.add(e.id), u === "text") {
+			let t = x(e.labelHtml);
+			t ? p.has(t) && (d[n] = "Content should be unique.") : d[n] = "Content should not be empty.", p.add(t);
+		} else e.imageUrl?.trim() ? e.imageAlt?.trim() || (d[n] = "Image alt text is required.") : d[n] = "An image is required.";
+	}), Object.keys(d).length && (r.choices = d);
+	let m = e.correctChoiceId;
+	m ? l.some((e) => e?.id === m) || (r.correctResponse = "The correct response must be one of the choices.") : r.correctResponse = "No correct response defined.", e.hasAudio && (e.audioUrl?.trim() || (r.audioUrl = "A playable audio URL is required when audio is enabled"));
+	let h = e?.layoutLimits;
+	if (h && typeof h == "object") for (let e of /* @__PURE__ */ "blankStandaloneWidthRem.blankWideWidthRem.blankUnderlineWidthPx.blankUnderlineWideWidthPx.horizontalChoiceWidthPx.horizontalChoiceWidthVw.horizontalChoiceTileMinHeightRem.horizontalChoiceContentMinHeightRem.choiceImageMaxHeightRem.choiceImageMaxWidthRem.listenButtonSizePx.stimulusMinColumnPx.textMinColumnPx.legendMaxChars.choiceGroupGapRem.choiceRowGapRem.toggleButtonGapRem.horizontalChoiceRadioTopMarginRem.audioBlankTemplateMarginTopRem.audioBlankTemplateMarginBottomRem.audioInstructionsMaxWidthPx.narrowHorizontalChoiceMaxWidthPx.stimulusGridColumnGapRem.stimulusGridRowGapRem.stimulusSentenceMarginTopRem.stimulusChoicesMarginTopRem.tokenGridColumnGapRem.tokenGridRowGapRem.tokenTemplateMarginTopRem.tokenInlineTokenGapRem.tokenChoicesMarginTopRem.inlineGridColumnGapRem.inlineGridRowGapRem.inlineTemplateMarginTopRem.inlineChoicesMarginTopRem".split(".")) {
+		if (h[e] === void 0 || h[e] === null) continue;
+		let t = Number(h[e]);
+		if (!Number.isFinite(t) || t <= 0) {
+			r.layoutLimits = `${e} must be a positive number when provided`;
+			break;
+		}
+	}
+	return r;
+};
+//#endregion
+export { a as countBlankTokens, b as createCorrectResponseSession, u as createDefaultModel, o as getCorrectness, s as getPartialScore, y as model, d as normalize, f as normalizeSession, c as outcome, S as validate };
+
+//# sourceMappingURL=index.js.map

package/dist/browser/controller/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/controller/defaults.ts","../../../src/author/defaults.ts","../../../src/controller/index.ts"],"sourcesContent":["import { DEFAULT_LAYOUT_LIMITS } from '../shared/layoutLimits';\n\nexport { DEFAULT_LAYOUT_LIMITS };\n\n/** Token authors must include exactly once in `template` (HTML). */\nexport const BLANK_TOKEN = '{{blank}}';\n\n/**\n * The values `normalize` fills in for fields an item leaves out. They carry no\n * content and no `id` or `element`: those come from the item config, and a\n * default here would stand in for a field the author never set.\n */\nexport default {\n  model: {\n    prompt: '',\n    promptEnabled: true,\n    interactionMode: 'populate_blank' as const,\n    layoutProfile: '',\n    choiceLayout: '',\n    layoutProfilePresets: {},\n    layoutLimits: { ...DEFAULT_LAYOUT_LIMITS },\n    audioButtonSkin: null,\n    audioButtonSkinsByLocale: {},\n    sentenceHtml: '',\n    template: '',\n    choiceMode: 'text' as const,\n    choices: [],\n    choiceGroupLabel: '',\n    correctChoiceId: '',\n    hasAudio: false,\n    autoplayAudioEnabled: false,\n    completeAudioEnabled: false,\n    audioUrl: '',\n    audioTranscript: '',\n    locale: '',\n    teacherInstructions: '',\n    teacherInstructionsEnabled: true,\n  },\n};\n","import controllerDefaults, { BLANK_TOKEN } from '../controller/defaults';\n\n/** The model a new item starts from: a valid question an author edits in place. */\nexport default {\n  model: {\n    ...controllerDefaults.model,\n    prompt: '<p><strong>Demo prompt</strong></p>',\n    template: `<p>The answer is ${BLANK_TOKEN}.</p>`,\n    choices: [\n      { id: 'c1', labelHtml: '<p>Option A</p>' },\n      { id: 'c2', labelHtml: '<p>Option B</p>' },\n      { id: 'c3', labelHtml: '<p>Option C</p>' },\n    ],\n    correctChoiceId: 'c2',\n  },\n  configuration: {\n    prompt: {\n      label: 'Prompt',\n      settings: true,\n    },\n  },\n};\n","import authorDefaults from '../author/defaults';\nimport defaults, { BLANK_TOKEN, DEFAULT_LAYOUT_LIMITS } from './defaults';\nimport type {\n  McpbChoice,\n  McpbQuestion,\n  McpbSession,\n  McpbEnv,\n  McpbCorrectness,\n} from '../shared/types';\n\nconst isEmptyObject = (value: unknown): boolean =>\n  !!value &&\n  typeof value === 'object' &&\n  !Array.isArray(value) &&\n  Object.keys(value as Record<string, unknown>).length === 0;\n\nexport function countBlankTokens(template: string): number {\n  if (!template) return 0;\n  const re = /\\{\\{blank\\}\\}/g;\n  return (template.match(re) || []).length;\n}\n\nexport const getCorrectness = (question: McpbQuestion, session: McpbSession): McpbCorrectness => {\n  if (!session?.choiceId) {\n    return 'unanswered';\n  }\n  const correct = question?.correctChoiceId || '';\n  if (session.choiceId === correct) {\n    return 'correct';\n  }\n  return 'incorrect';\n};\n\n/** One blank, one key: an answered session scores 1 only when it picked the key. */\nexport const getPartialScore = (question: McpbQuestion, session: McpbSession) =>\n  getCorrectness(question, session) === 'correct' ? 1 : 0;\n\nexport const outcome = (question: McpbQuestion, session: McpbSession, env: McpbEnv) =>\n  new Promise((resolve) => {\n    if (!session || isEmptyObject(session)) {\n      resolve({\n        score: 0,\n        empty: true,\n        traceLog: ['Student did not select any answers. Score is 0.'],\n      });\n      return;\n    }\n\n    session = normalizeSession(session);\n    const normalizedQuestion = normalize(question);\n    const correctness = getCorrectness(normalizedQuestion, session);\n\n    if (correctness === 'unanswered') {\n      resolve({\n        score: 0,\n        empty: true,\n        traceLog: ['Student did not select any answers. Score is 0.'],\n      });\n      return;\n    }\n\n    const score = getPartialScore(normalizedQuestion, session);\n    const traceLog = [\n      `Mode: ${env?.mode || 'unknown'}.`,\n      `Student selected choice: ${session.choiceId}.`,\n      `Correct choice: ${normalizedQuestion.correctChoiceId || 'none'}.`,\n      `Final score: ${score}.`,\n    ];\n    resolve({ score, empty: false, traceLog });\n  });\n\nconst withDefaults = (base: McpbQuestion, model: McpbQuestion = {}) => ({\n  ...base,\n  ...model,\n  layoutLimits: {\n    ...DEFAULT_LAYOUT_LIMITS,\n    ...(model?.layoutLimits || {}),\n  },\n});\n\n/** The authoring starting point: a question that passes `validate()` as it stands. */\nexport const createDefaultModel = (model: McpbQuestion = {}) =>\n  withDefaults(authorDefaults.model, model);\n\n/**\n * What `model()` and `outcome()` read: the item's own fields, with neutral\n * values for the rest. Starter content here would reach a learner as the\n * item's prompt or choices.\n */\nexport const normalize = (question: McpbQuestion = {}) => {\n  const { shuffle, ...rest } = question || {};\n  return {\n    ...withDefaults(defaults.model, rest),\n    // `lockChoiceOrder` alone decides the order, as in multiple-choice. Older items\n    // spell an unlocked order `shuffle: true`, which counts only when it is unset.\n    lockChoiceOrder:\n      typeof rest.lockChoiceOrder === 'boolean' ? rest.lockChoiceOrder : shuffle !== true,\n  };\n};\n\nexport const normalizeSession = (s: McpbSession): McpbSession => ({ ...s });\n\nconst shouldLockChoices = (question: McpbQuestion, env: McpbEnv) => {\n  if (question?.lockChoiceOrder) return true;\n  if (env?.['@pie-element']?.lockChoiceOrder) return true;\n  return env?.role === 'instructor';\n};\n\nfunction shuffleArray<T>(items: T[]): T[] {\n  const out = [...items];\n  for (let i = out.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1));\n    [out[i], out[j]] = [out[j], out[i]];\n  }\n  return out;\n}\n\n/**\n * The fields delivery renders. An imported choice can carry more, such as a\n * correctness flag or feedback, which must not reach a learner's browser.\n */\nconst toDeliveryChoice = ({ id, labelHtml, imageUrl, imageAlt }: McpbChoice): McpbChoice => ({\n  id,\n  ...(labelHtml !== undefined ? { labelHtml } : {}),\n  ...(imageUrl !== undefined ? { imageUrl } : {}),\n  ...(imageAlt !== undefined ? { imageAlt } : {}),\n});\n\nconst getStoredShuffle = (session: McpbSession): string[] =>\n  Array.isArray(session?.data?.shuffledValues)\n    ? session.data.shuffledValues\n    : Array.isArray(session?.shuffledValues)\n      ? session.shuffledValues\n      : [];\n\nconst applyShuffledValues = (\n  choices: McpbChoice[],\n  shuffledValues: string[],\n  choiceKey: keyof McpbChoice\n) => {\n  const orderedChoices = shuffledValues\n    .map((value) => choices.find((choice) => choice?.[choiceKey] === value))\n    .filter((c): c is McpbChoice => !!c);\n\n  if (orderedChoices.length === choices.length) {\n    return orderedChoices;\n  }\n\n  const orderedValues = new Set(orderedChoices.map((choice) => choice[choiceKey]));\n  const leftovers = choices.filter((choice) => !orderedValues.has(choice?.[choiceKey]));\n  return [...orderedChoices, ...leftovers];\n};\n\ntype UpdateSessionFn = (\n  id: string,\n  element: string,\n  data: { shuffledValues: string[] }\n) => Promise<void>;\n\nconst getOrderedChoices = async (\n  question: McpbQuestion,\n  session: McpbSession,\n  env: McpbEnv,\n  updateSession?: UpdateSessionFn\n) => {\n  const choices = Array.isArray(question?.choices) ? [...question.choices] : [];\n  if (!choices.length || shouldLockChoices(question, env || {})) {\n    return choices;\n  }\n\n  const shuffledValues = getStoredShuffle(session);\n  if (shuffledValues.length) {\n    return applyShuffledValues(choices, shuffledValues, 'id');\n  }\n\n  const shuffledChoices = shuffleArray(choices);\n\n  if (updateSession && typeof updateSession === 'function' && session?.id && session?.element) {\n    const shuffledIds = shuffledChoices.map((choice) => choice?.id).filter(Boolean);\n    if (shuffledIds.length) {\n      await updateSession(session.id, session.element, { shuffledValues: shuffledIds });\n    }\n  }\n\n  return shuffledChoices;\n};\n\nexport const model = async (\n  question: McpbQuestion,\n  session: McpbSession | null,\n  env: McpbEnv | null,\n  updateSession?: UpdateSessionFn\n) => {\n  const safeSession: McpbSession = session || {};\n  const safeEnv: McpbEnv = env || {};\n  const normalizedQuestion = normalize(question);\n  const choices = (await getOrderedChoices(normalizedQuestion, safeSession, safeEnv, updateSession))\n    .filter((c): c is McpbChoice => !!c && typeof c === 'object')\n    .map(toDeliveryChoice);\n\n  const out: Record<string, unknown> = {\n    prompt: normalizedQuestion.promptEnabled ? normalizedQuestion.prompt : null,\n    interactionMode: normalizedQuestion.interactionMode || 'populate_blank',\n    layoutProfile: normalizedQuestion.layoutProfile || '',\n    choiceLayout: normalizedQuestion.choiceLayout || '',\n    layoutProfilePresets:\n      normalizedQuestion.layoutProfilePresets &&\n      typeof normalizedQuestion.layoutProfilePresets === 'object'\n        ? normalizedQuestion.layoutProfilePresets\n        : {},\n    layoutLimits: normalizedQuestion.layoutLimits || { ...DEFAULT_LAYOUT_LIMITS },\n    audioButtonSkin:\n      normalizedQuestion.audioButtonSkin && typeof normalizedQuestion.audioButtonSkin === 'object'\n        ? normalizedQuestion.audioButtonSkin\n        : null,\n    audioButtonSkinsByLocale:\n      normalizedQuestion.audioButtonSkinsByLocale &&\n      typeof normalizedQuestion.audioButtonSkinsByLocale === 'object'\n        ? normalizedQuestion.audioButtonSkinsByLocale\n        : {},\n    sentenceHtml: normalizedQuestion.sentenceHtml || null,\n    template: normalizedQuestion.template,\n    choiceMode: normalizedQuestion.choiceMode,\n    choices,\n    choiceGroupLabel: normalizedQuestion.choiceGroupLabel || '',\n    hasAudio: normalizedQuestion.hasAudio,\n    autoplayAudioEnabled: !!normalizedQuestion.autoplayAudioEnabled,\n    completeAudioEnabled: !!normalizedQuestion.completeAudioEnabled,\n    audioUrl: normalizedQuestion.hasAudio ? normalizedQuestion.audioUrl : null,\n    audioTranscript: normalizedQuestion.hasAudio ? normalizedQuestion.audioTranscript : null,\n    customType: normalizedQuestion.customType || '',\n    useFeatureButtonAudio:\n      typeof normalizedQuestion.useFeatureButtonAudio === 'boolean'\n        ? normalizedQuestion.useFeatureButtonAudio\n        : undefined,\n    locale: normalizedQuestion.locale || '',\n    language: normalizedQuestion.language || normalizedQuestion.locale || undefined,\n    disabled: safeEnv.mode !== 'gather',\n    mode: safeEnv.mode,\n  };\n\n  if (safeEnv.mode === 'evaluate') {\n    const correctness = getCorrectness(normalizedQuestion, safeSession);\n    out.correctness = correctness;\n    out.responseCorrect = correctness === 'correct';\n    out.correctChoiceId = normalizedQuestion.correctChoiceId;\n  }\n\n  if (safeEnv.role === 'instructor' && (safeEnv.mode === 'view' || safeEnv.mode === 'evaluate')) {\n    out.teacherInstructions = normalizedQuestion.teacherInstructionsEnabled\n      ? normalizedQuestion.teacherInstructions\n      : null;\n  } else {\n    out.teacherInstructions = null;\n  }\n\n  return out;\n};\n\nexport const createCorrectResponseSession = (question: McpbQuestion, env: McpbEnv) => {\n  return new Promise((resolve) => {\n    if (env.mode !== 'evaluate' && env.role === 'instructor') {\n      // The player sets `id` and `element` on the entry from the item config.\n      resolve({\n        id: '1',\n        choiceId: question?.correctChoiceId || '',\n      });\n    } else {\n      resolve(null);\n    }\n  });\n};\n\n/** Markup with its tags removed, keeping media an author can answer from. */\nconst getContent = (html?: string) =>\n  (html || '').replace(/(<(?!img|iframe|source)([^>]+)>)/gi, '').trim();\n\ntype ValidateConfig = {\n  minAnswerChoices?: number;\n  maxAnswerChoices?: number;\n  prompt?: { required?: boolean };\n  teacherInstructions?: { required?: boolean };\n};\n\n/**\n * Authoring errors in multiple-choice's shape: a message per field, and under\n * `choices` a message per choice keyed by its id.\n */\nexport const validate = (question: McpbQuestion = {}, config: ValidateConfig = {}) => {\n  const errors: Record<string, string | Record<string, string>> = {};\n  const { minAnswerChoices = 2, maxAnswerChoices } = config;\n\n  if ((question.promptEnabled || config.prompt?.required) && !getContent(question.prompt)) {\n    errors.prompt = 'This field is required.';\n  }\n\n  if (config.teacherInstructions?.required && !getContent(question.teacherInstructions)) {\n    errors.teacherInstructions = 'This field is required.';\n  }\n\n  const interactionMode = question.interactionMode || 'populate_blank';\n  const template = question.template || '';\n  const n = countBlankTokens(template);\n  if (interactionMode === 'audio_mc_only') {\n    if (n > 0) {\n      errors.template = `Template cannot contain ${BLANK_TOKEN} in audio-only mode`;\n    }\n  } else if (interactionMode === 'populate_blank') {\n    if (n === 0) {\n      errors.template = `Template must contain exactly one ${BLANK_TOKEN} placeholder`;\n    } else if (n > 1) {\n      errors.template = `Template must contain only one ${BLANK_TOKEN} placeholder`;\n    }\n  } else {\n    errors.interactionMode = 'Unknown interaction mode';\n  }\n\n  const choices = Array.isArray(question.choices) ? question.choices : [];\n  if (choices.length < minAnswerChoices) {\n    errors.answerChoices = `There should be at least ${minAnswerChoices} choices defined.`;\n  } else if (maxAnswerChoices != null && choices.length > maxAnswerChoices) {\n    errors.answerChoices = `No more than ${maxAnswerChoices} choices should be defined.`;\n  }\n\n  const mode = question.choiceMode || 'text';\n  const choicesErrors: Record<string, string> = {};\n  const seenIds = new Set<string>();\n  const seenLabels = new Set<string>();\n  choices.forEach((c, i) => {\n    const key = c?.id || String(i);\n    if (!c?.id) {\n      choicesErrors[key] = 'Choice needs an id.';\n      return;\n    }\n    // The session stores the picked id, so two choices sharing one cannot be told apart.\n    if (seenIds.has(c.id)) {\n      choicesErrors[key] = 'Choice id should be unique.';\n      return;\n    }\n    seenIds.add(c.id);\n    if (mode === 'text') {\n      const label = getContent(c.labelHtml);\n      if (!label) {\n        choicesErrors[key] = 'Content should not be empty.';\n      } else if (seenLabels.has(label)) {\n        choicesErrors[key] = 'Content should be unique.';\n      }\n      seenLabels.add(label);\n    } else if (!c.imageUrl?.trim()) {\n      choicesErrors[key] = 'An image is required.';\n    } else if (!c.imageAlt?.trim()) {\n      choicesErrors[key] = 'Image alt text is required.';\n    }\n  });\n  if (Object.keys(choicesErrors).length) {\n    errors.choices = choicesErrors;\n  }\n\n  const correct = question.correctChoiceId;\n  if (!correct) {\n    errors.correctResponse = 'No correct response defined.';\n  } else if (!choices.some((c) => c?.id === correct)) {\n    errors.correctResponse = 'The correct response must be one of the choices.';\n  }\n\n  if (question.hasAudio) {\n    const hasAudioUrl = !!question.audioUrl?.trim();\n    if (!hasAudioUrl) {\n      errors.audioUrl = 'A playable audio URL is required when audio is enabled';\n    }\n  }\n\n  const limits = question?.layoutLimits;\n  if (limits && typeof limits === 'object') {\n    const numericLimitKeys = [\n      'blankStandaloneWidthRem',\n      'blankWideWidthRem',\n      'blankUnderlineWidthPx',\n      'blankUnderlineWideWidthPx',\n      'horizontalChoiceWidthPx',\n      'horizontalChoiceWidthVw',\n      'horizontalChoiceTileMinHeightRem',\n      'horizontalChoiceContentMinHeightRem',\n      'choiceImageMaxHeightRem',\n      'choiceImageMaxWidthRem',\n      'listenButtonSizePx',\n      'stimulusMinColumnPx',\n      'textMinColumnPx',\n      'legendMaxChars',\n      'choiceGroupGapRem',\n      'choiceRowGapRem',\n      'toggleButtonGapRem',\n      'horizontalChoiceRadioTopMarginRem',\n      'audioBlankTemplateMarginTopRem',\n      'audioBlankTemplateMarginBottomRem',\n      'audioInstructionsMaxWidthPx',\n      'narrowHorizontalChoiceMaxWidthPx',\n      'stimulusGridColumnGapRem',\n      'stimulusGridRowGapRem',\n      'stimulusSentenceMarginTopRem',\n      'stimulusChoicesMarginTopRem',\n      'tokenGridColumnGapRem',\n      'tokenGridRowGapRem',\n      'tokenTemplateMarginTopRem',\n      'tokenInlineTokenGapRem',\n      'tokenChoicesMarginTopRem',\n      'inlineGridColumnGapRem',\n      'inlineGridRowGapRem',\n      'inlineTemplateMarginTopRem',\n      'inlineChoicesMarginTopRem',\n    ] as const;\n    for (const key of numericLimitKeys) {\n      if (limits[key] === undefined || limits[key] === null) continue;\n      const value = Number(limits[key]);\n      if (!Number.isFinite(value) || value <= 0) {\n        errors.layoutLimits = `${key} must be a positive number when provided`;\n        break;\n      }\n    }\n  }\n\n  return errors;\n};\n"],"mappings":"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"}