@intellectif/lk-core 1.6.0 → 1.8.0

package/dist/index.js

@@ -1,10 +1,10 @@
-import { A as AI_COACHING_MAX_TIP_LENGTH, B as aiHintRequest, C as createItemGroupDraft, D as listMediaRefs, E as validateItemGroupDraft, F as AI_HINT_TYPES, G as hintRevealsAnswer, H as buildAiFacts, I as AI_TEXT_MAX_LENGTH, K as readAiTextResult, L as aiAllowedByContent, M as aiCoachingRequest, N as checkAiCoaching, O as mapMediaRefs, P as AI_EXPLANATION_TYPES, R as aiExplanationRequest, S as createInteractiveVideoDraft, T as critiqueItemGroupDraft, U as checkAiExplanation, V as aiSupports, W as checkAiHint, _ as aiCritiqueRequest, a as checkAiGrading, b as critiqueDraft, c as AI_DRAFTS_MAX_COUNT, d as aiDraftsRequest, f as checkAiDrafts, g as AI_CRITIQUE_MAX_FINDINGS, h as AI_CRITIQUE_MAX_FIELD_LENGTH, i as aiGradingRequest, j as AI_COACHING_MAX_WORDS, k as transcriptOf, l as AI_DRAFTS_MAX_REPAIRS, m as interactiveVideoFromDrafts, n as checkAiWritingFeedback, o as AI_WRITING_MAX_CORRECTIONS, p as generateDrafts, q as AI_MATERIAL_MAX_LENGTH, r as AI_GRADING_PROBABILITY_TOLERANCE, s as AI_WRITING_MAX_FIELD_LENGTH, t as aiWritingFeedbackRequest, u as aiDraftsRepairRequest, v as checkAiCritique, w as critiqueDrafts, x as validateDraft, y as createDraft, z as aiGradeOf } from "./ai-writing-OJ5m_1EB.js";
-import { $ as DeferredScoringError, C as READ_ALOUD_MAX_TAKES, L as countWords, M as matchText, Q as ActivitySchemaError, S as READ_ALOUD_MAX_SECONDS, T as SPEECH_ASSESSMENT_MAX_WORDS, Tt as SCRIPT_MAX_TURNS, a as readSchema, at as dictationReferenceWords, b as READ_ALOUD_MAX_DIMENSION_WEIGHT, c as dictationType, ct as DICTATION_MAX_EQUIVALENCE_LENGTH, d as multipleChoiceType, et as RedactedScoringError, f as readAloudType, gt as isBuiltInActivityType, h as defineActivityType, j as levenshteinDistance, l as fillInTheBlanksType, lt as DICTATION_MAX_TEXT_LENGTH, m as guardOf, mt as BUILT_IN_ACTIVITY_TYPES, n as registerActivityType, ot as DICTATION_MAX_ACCEPTED_TRANSCRIPTS, p as writtenResponseType, r as registeredActivityTypes, rt as alignDictation, s as MEDIA_FIELD_POLICY, st as DICTATION_MAX_EQUIVALENCES, t as getActivityTypeDescriptor, tt as UnknownActivityTypeError, u as gapSelectType, ut as DICTATION_MAX_TRANSCRIPT_LENGTH, x as READ_ALOUD_MAX_REFERENCE_LENGTH } from "./registry-B23o9UWh.js";
-import { A as DEFAULT_ITEM_SCORING_POLICY, C as contentHash, D as classifyBand, E as computePassThreshold, M as resolveItemScoringPolicy, N as scoreTries, O as gte, P as validateItemScoringPolicy, S as canonicalJson, T as DEFAULT_PASS_THRESHOLD, _ as gradeFromRubric, a as inspectWav, b as calibrationReport, c as validateSpeechAssessment, d as inAuditSample, f as outcomeFromRoutedGrade, g as gradeFromJudgement, h as seededShuffle, i as outcomeFromUnscorable, j as ITEM_SCORING_MAX_RETRIES, k as roundGrade, l as diffDictationChars, m as hashSeed, n as evaluateTries, o as gradeReadAloud, p as routeGrade, r as score, s as alignReadAloud, t as evaluate, u as composeAssessmentScore, v as hasGrade, w as fingerprint, x as graderConfiguration, y as outcomeFromGrade } from "./scoring-CLMdk8i9.js";
-import { a as INTERACTIVE_VIDEO_ITEM_TYPES, c as TIMELINE_MAX_QUIZZES, i as validateItemGroup, l as TIMELINE_MAX_TITLE_LENGTH, n as RedactedItemGroupSchema, o as TIMELINE_MAX_CHAPTERS, s as TIMELINE_MAX_ITEMS, u as isInteractiveVideoItemType } from "./item-group-BbvvH_Ob.js";
-import { a as dictationJsonSchema, c as itemGroupJsonSchema, d as readAloudJsonSchema, f as stimulusJsonSchema, i as contentJsonSchema, l as jsonSchemaFor, n as validateMedia, o as fillInTheBlanksJsonSchema, p as writtenResponseJsonSchema, r as validateOptionMedia, s as gapSelectJsonSchema, t as validateActivity, u as multipleChoiceJsonSchema } from "./schemas-yId-bJhD.js";
-import { a as validateXAPIStatement, i as XAPI_VERB_DISPLAY, n as xapiDefinitionFor, r as XAPIVerb, t as xAPIBuilder } from "./xapi-Cdk9fTvV.js";
-//#region src/delivery.ts
+import { $ as AI_HINT_TYPES, A as createInteractiveVideoDraft, B as sharedAnswers, C as AI_CRITIQUE_MAX_FIELD_LENGTH, D as createDraft, E as checkAiCritique, F as AI_VARIANT_LENGTH_BANDS, G as listMediaRefs, H as structureMisses, I as AI_VARIANT_NEAR_COPY_THRESHOLD, J as AI_COACHING_MAX_TIP_LENGTH, K as mapMediaRefs, L as keysOf, M as critiqueDrafts, N as critiqueItemGroupDraft, O as critiqueDraft, P as validateItemGroupDraft, Q as AI_EXPLANATION_TYPES, R as lengthMisses, S as interactiveVideoFromDrafts, T as aiCritiqueRequest, U as textSimilarity, V as shownScore, W as textsOf, X as aiCoachingRequest, Y as AI_COACHING_MAX_WORDS, Z as checkAiCoaching, _ as AI_DRAFTS_MAX_REPAIRS, a as AI_VARIANTS_MAX_REPAIRS, at as aiSupports, b as checkAiDrafts, c as aiVariantsRequest, ct as checkAiHint, d as AI_GRADING_PROBABILITY_TOLERANCE, dt as AI_MATERIAL_MAX_LENGTH, et as AI_TEXT_MAX_LENGTH, f as aiGradingRequest, g as AI_DRAFTS_MAX_COUNT, h as AI_WRITING_MAX_FIELD_LENGTH, i as AI_VARIANTS_MAX_MATERIAL_LENGTH, it as aiHintRequest, j as createItemGroupDraft, k as validateDraft, l as checkAiVariants, lt as hintRevealsAnswer, m as AI_WRITING_MAX_CORRECTIONS, n as checkAiWritingFeedback, nt as aiExplanationRequest, o as AI_VARIANT_CODE_SEVERITY, ot as buildAiFacts, p as checkAiGrading, q as transcriptOf, r as AI_VARIANTS_MAX_EXEMPLARS, rt as aiGradeOf, s as aiVariantsRepairRequest, st as checkAiExplanation, t as aiWritingFeedbackRequest, tt as aiAllowedByContent, u as generateVariants, ut as readAiTextResult, v as aiDraftsRepairRequest, w as AI_CRITIQUE_MAX_FINDINGS, x as generateDrafts, y as aiDraftsRequest, z as optionSet } from "./ai-writing-DeIV-GfN.js";
+import { $ as ActivitySchemaError, C as READ_ALOUD_MAX_TAKES, M as levenshteinDistance, N as matchText, Ot as SCRIPT_MAX_TURNS, R as countWords, S as READ_ALOUD_MAX_SECONDS, T as SPEECH_ASSESSMENT_MAX_WORDS, _t as isBuiltInActivityType, a as readSchema, b as READ_ALOUD_MAX_DIMENSION_WEIGHT, c as dictationType, ct as DICTATION_MAX_EQUIVALENCES, d as multipleChoiceType, dt as DICTATION_MAX_TRANSCRIPT_LENGTH, et as DeferredScoringError, f as readAloudType, h as defineActivityType, ht as BUILT_IN_ACTIVITY_TYPES, it as alignDictation, l as fillInTheBlanksType, lt as DICTATION_MAX_EQUIVALENCE_LENGTH, m as guardOf, n as registerActivityType, nt as UnknownActivityTypeError, ot as dictationReferenceWords, p as writtenResponseType, r as registeredActivityTypes, s as MEDIA_FIELD_POLICY, st as DICTATION_MAX_ACCEPTED_TRANSCRIPTS, t as getActivityTypeDescriptor, tt as RedactedScoringError, u as gapSelectType, ut as DICTATION_MAX_TEXT_LENGTH, x as READ_ALOUD_MAX_REFERENCE_LENGTH } from "./registry-tkacvJUI.js";
+import { A as DEFAULT_ITEM_SCORING_POLICY, C as contentHash, D as classifyBand, E as computePassThreshold, M as resolveItemScoringPolicy, N as scoreTries, O as gte, P as validateItemScoringPolicy, S as canonicalJson, T as DEFAULT_PASS_THRESHOLD, _ as gradeFromRubric, a as inspectWav, b as calibrationReport, c as validateSpeechAssessment, d as inAuditSample, f as outcomeFromRoutedGrade, g as gradeFromJudgement, h as seededShuffle, i as outcomeFromUnscorable, j as ITEM_SCORING_MAX_RETRIES, k as roundGrade, l as diffDictationChars, m as hashSeed, n as evaluateTries, o as gradeReadAloud, p as routeGrade, r as score, s as alignReadAloud, t as evaluate, u as composeAssessmentScore, v as hasGrade, w as fingerprint, x as graderConfiguration, y as outcomeFromGrade } from "./scoring-DIBmo_cy.js";
+import { a as INTERACTIVE_VIDEO_ITEM_TYPES, c as TIMELINE_MAX_QUIZZES, i as validateItemGroup, l as TIMELINE_MAX_TITLE_LENGTH, n as RedactedItemGroupSchema, o as TIMELINE_MAX_CHAPTERS, s as TIMELINE_MAX_ITEMS, u as isInteractiveVideoItemType } from "./item-group-BceUoxoM.js";
+import { a as dictationJsonSchema, c as itemGroupJsonSchema, d as readAloudJsonSchema, f as stimulusJsonSchema, i as contentJsonSchema, l as jsonSchemaFor, n as validateMedia, o as fillInTheBlanksJsonSchema, p as writtenResponseJsonSchema, r as validateOptionMedia, s as gapSelectJsonSchema, t as validateActivity, u as multipleChoiceJsonSchema } from "./schemas-DM8sN_f0.js";
+import { a as validateXAPIStatement, i as XAPI_VERB_DISPLAY, n as xapiDefinitionFor, r as XAPIVerb, t as xAPIBuilder } from "./xapi-gCAo549Q.js";
+// src/delivery.ts
 /**
 * The policy that restricts nothing: every setting `true`. It is what an absent
 * policy resolves to, and it is exactly the behaviour the SDK had before
@@ -158,8 +158,7 @@ function validateDeliveryPolicy(policy) {
 		data: given
 	};
 }
-//#endregion
-//#region src/item-group.ts
+// src/item-group.ts
 /** Narrows a sequence entry to an item group. */
 function isItemGroup(entry) {
 	return entry.type === "item-group";
@@ -283,8 +282,7 @@ function flattenSequence(entries, options = {}) {
 	}
 	return slots;
 }
-//#endregion
-//#region src/media-budget.ts
+// src/media-budget.ts
 /**
 * The authored-entry prefix of a slot id: `"3"` for both `"3"` and `"3.1"`.
 *
@@ -398,8 +396,7 @@ function restoreMediaPlayLedger(plan, stored) {
 	if (stored.planHash !== plan.planHash) throw new Error(`restoreMediaPlayLedger: this ledger belongs to a different paper (ledger ${stored.planHash}, plan ${plan.planHash}). Restoring it would hold the learner to a play budget from an exam they never sat.`);
 	return serializeMediaPlayLedger(plan, stored.entries, { ...stored.savedAt !== void 0 ? { savedAt: stored.savedAt } : {} });
 }
-//#endregion
-//#region src/attempt-plan.ts
+// src/attempt-plan.ts
 /**
 * The activity as CONTENT, with its slot key removed.
 *
@@ -650,8 +647,7 @@ function scoredItemsFromPlan(plan, outcomes, options = {}) {
 		outcome: Object.hasOwn(outcomes, slot.slotId) ? outcomes[slot.slotId] : missingOutcome(slot, policy)
 	}));
 }
-//#endregion
-//#region src/attempt-state.ts
+// src/attempt-state.ts
 /**
 * A DEEP copy of the responses.
 *
@@ -775,8 +771,7 @@ function diffResponses(before, after) {
 	}
 	return entries;
 }
-//#endregion
-//#region src/redact.ts
+// src/redact.ts
 /** Merges per-call overrides over a registered policy, one level deep. */
 function mergePolicy(base, overrides) {
 	if (overrides === void 0) return base;
@@ -1043,8 +1038,7 @@ function withoutAuthorOnly(entry) {
 		...Array.isArray(items) ? { items: items.map((item) => withoutAuthorOnlyValue(item, policyOf(item?.type))) } : items !== void 0 ? { items } : {}
 	};
 }
-//#endregion
-//#region src/timeline.ts
+// src/timeline.ts
 /**
 * Reads a stored {@link MediaProgress}. Never throws: anything that is not one
 * — a string, a stale shape, an object whose getters throw — answers `null`,
@@ -1098,7 +1092,268 @@ function composeTimelineScore(entryKey, items, policy) {
 		items: own
 	}], policy);
 }
-//#endregion
-export { AI_COACHING_MAX_TIP_LENGTH, AI_COACHING_MAX_WORDS, AI_CRITIQUE_MAX_FIELD_LENGTH, AI_CRITIQUE_MAX_FINDINGS, AI_DRAFTS_MAX_COUNT, AI_DRAFTS_MAX_REPAIRS, AI_EXPLANATION_TYPES, AI_GRADING_PROBABILITY_TOLERANCE, AI_HINT_TYPES, AI_MATERIAL_MAX_LENGTH, AI_TEXT_MAX_LENGTH, AI_WRITING_MAX_CORRECTIONS, AI_WRITING_MAX_FIELD_LENGTH, ActivitySchemaError, BUILT_IN_ACTIVITY_TYPES, DEFAULT_ITEM_SCORING_POLICY, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, DeferredScoringError, INTERACTIVE_VIDEO_ITEM_TYPES, ITEM_SCORING_MAX_RETRIES, OPEN_DELIVERY_POLICY, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, RedactedScoringError, SCRIPT_MAX_TURNS, SPEECH_ASSESSMENT_MAX_WORDS, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, UnknownActivityTypeError, XAPIVerb, XAPI_VERB_DISPLAY, aiAllowedByContent, aiCoachingRequest, aiCritiqueRequest, aiDraftsRepairRequest, aiDraftsRequest, aiExplanationRequest, aiGradeOf, aiGradingRequest, aiHintRequest, aiSupports, aiWritingFeedbackRequest, alignDictation, alignReadAloud, assertRedacted, assertRedactedItemGroup, buildAiFacts, calibrationReport, canonicalJson, checkAiCoaching, checkAiCritique, checkAiDrafts, checkAiExplanation, checkAiGrading, checkAiHint, checkAiWritingFeedback, classifyBand, combineDeliveryPolicies, composeAssessmentScore, composeTimelineScore, computePassThreshold, contentHash, contentJsonSchema, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, critiqueDraft, critiqueDrafts, critiqueItemGroupDraft, defineActivityType, dictationJsonSchema, dictationReferenceWords, dictationType, diffDictationChars, diffResponses, entryKeyOf, evaluate, evaluateTries, fillInTheBlanksJsonSchema, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectJsonSchema, gapSelectType, generateDrafts, getActivityTypeDescriptor, gradeFromJudgement, gradeFromRubric, gradeReadAloud, graderConfiguration, gte, hasGrade, hashSeed, hintRevealsAnswer, inAuditSample, inspectWav, interactiveVideoFromDrafts, isBuiltInActivityType, isInteractiveVideoItemType, isItemGroup, itemGroupJsonSchema, jsonSchemaFor, levenshteinDistance, listMediaRefs, mapMediaRefs, matchText, multipleChoiceJsonSchema, multipleChoiceType, outcomeFromGrade, outcomeFromRoutedGrade, outcomeFromUnscorable, planAttempt, planMediaBudgets, readAiTextResult, readAloudJsonSchema, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolveDeliveryPolicy, resolveItemScoringPolicy, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, roundGrade, routeGrade, score, scoreTries, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusJsonSchema, stimulusMediaKey, transcriptOf, validateActivity, validateDeliveryPolicy, validateDraft, validateItemGroup, validateItemGroupDraft, validateItemScoringPolicy, validateMedia, validateOptionMedia, validateSpeechAssessment, validateXAPIStatement, verifyAttemptPlan, withoutAuthorOnly, writtenResponseJsonSchema, writtenResponseType, xAPIBuilder, xapiDefinitionFor };
+// src/versions.ts
+/**
+* Every code `critiqueVersions` reports, and its severity: a contract, as the
+* critic's codes are. `versions_shared_media` is `advice` for a picture both
+* forms may show, and a `warning` otherwise.
+*/
+const VERSION_FINDING_SEVERITY = {
+	versions_section_mismatch: "invalid",
+	versions_entry_count: "invalid",
+	versions_type_mismatch: "invalid",
+	versions_structure_mismatch: "invalid",
+	versions_objectives_mismatch: "warning",
+	versions_length_out_of_band: "warning",
+	versions_near_copy: "warning",
+	versions_same_key: "warning",
+	versions_shared_media: "warning"
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const listOf = (value) => Array.isArray(value) ? value : [];
+const stringOf = (value) => typeof value === "string" ? value : "";
+const key = (path) => path.join(".");
+function report(code, message, a, b, severity = VERSION_FINDING_SEVERITY[code]) {
+	return {
+		path: [...b ?? a ?? []],
+		message,
+		code,
+		severity,
+		...a !== void 0 ? { a: [...a] } : {},
+		...b !== void 0 ? { b: [...b] } : {}
+	};
+}
+function entriesOf(paper) {
+	return listOf(paper?.sections).flatMap((section, s) => listOf(isRecord(section) ? section.entries : void 0).flatMap((value, index) => isRecord(value) ? [{
+		path: [
+			"sections",
+			String(s),
+			"entries",
+			String(index)
+		],
+		section: s,
+		index,
+		value
+	}] : []));
+}
+/** A group's items, or the entry itself: the slots a learner answers. */
+const itemsOf = (entry) => entry.value.type === "item-group" ? listOf(entry.value.items).flatMap((item, at) => isRecord(item) ? [{
+	path: [
+		...entry.path,
+		"items",
+		String(at)
+	],
+	value: item
+}] : []) : [{
+	path: entry.path,
+	value: entry.value
+}];
+const typeName = (value) => stringOf(value.type) || "no type";
+function pairEntries(aEntries, bEntries, given) {
+	const pairs = [];
+	const takenA = /* @__PURE__ */ new Set();
+	const takenB = /* @__PURE__ */ new Set();
+	const add = (a, b, by) => {
+		pairs.push({
+			a,
+			b,
+			by
+		});
+		takenA.add(key(a.path));
+		takenB.add(key(b.path));
+	};
+	const aByPath = new Map(aEntries.map((one) => [key(one.path), one]));
+	const bByPath = new Map(bEntries.map((one) => [key(one.path), one]));
+	for (const pair of given ?? []) {
+		const a = aByPath.get(key(pair.a.map(String)));
+		const b = bByPath.get(key(pair.b.map(String)));
+		if (a !== void 0 && b !== void 0 && !takenA.has(key(a.path)) && !takenB.has(key(b.path))) add(a, b, "pairs");
+	}
+	for (const a of aEntries) {
+		const slotKey = a.value.slotKey;
+		if (takenA.has(key(a.path)) || typeof slotKey !== "string") continue;
+		const b = bEntries.find((one) => one.value.slotKey === slotKey && !takenB.has(key(one.path)));
+		if (b !== void 0) add(a, b, "slotKey");
+	}
+	for (const a of aEntries) {
+		if (takenA.has(key(a.path))) continue;
+		const b = bEntries.find((one) => one.section === a.section && one.index === a.index && !takenB.has(key(one.path)));
+		if (b !== void 0) add(a, b, "position");
+	}
+	return pairs;
+}
+/** A paired group's items, by their own `slotKey` when both have one, else by position. */
+function pairItems(pair) {
+	const aItems = itemsOf(pair.a);
+	const bItems = itemsOf(pair.b);
+	if (pair.a.value.type !== "item-group" || pair.b.value.type !== "item-group") {
+		const one = aItems[0];
+		const two = bItems[0];
+		return one !== void 0 && two !== void 0 ? [{
+			a: one,
+			b: two,
+			by: pair.by
+		}] : [];
+	}
+	const taken = /* @__PURE__ */ new Set();
+	const pairs = [];
+	aItems.forEach((a) => {
+		const slotKey = a.value.slotKey;
+		const found = typeof slotKey === "string" ? bItems.findIndex((b, index) => b.value.slotKey === slotKey && !taken.has(index)) : -1;
+		if (found !== -1) {
+			taken.add(found);
+			pairs.push({
+				a,
+				b: bItems[found],
+				by: "slotKey"
+			});
+		}
+	});
+	aItems.forEach((a, at) => {
+		if (pairs.some((one) => one.a === a) || at >= bItems.length || taken.has(at)) return;
+		taken.add(at);
+		pairs.push({
+			a,
+			b: bItems[at],
+			by: "position"
+		});
+	});
+	return pairs.sort((x, y) => aItems.indexOf(x.a) - aItems.indexOf(y.a));
+}
+const objectives = (value) => [...listOf(value.learningObjectives).filter((one) => typeof one === "string")].sort().join("\n");
+/**
+* Compares two forms of an exam slot by slot, and the whole of one with the
+* whole of the other: whether they are parallel — the same blueprint, types,
+* structure and scoring (`invalid` when not) — and whether a learner who sat
+* one would meet the other again: a near copy anywhere in the other form, a
+* shared right answer in a paired slot, the same recording (`warning`), or
+* the same picture (`advice` while `allowSharedImages`, its default).
+* Objectives and lengths that differ are warnings.
+*
+* Slots are paired by `pairs` (paths from each paper's root, as
+* `generateVariants`' pairs give them once a host places them), then by
+* `slotKey`, then by position: the same entry of the same section. A paired
+* group's items pair by their own `slotKey`, then by position.
+*
+* It reads content as stored, finished or not, and never throws.
+*/
+function critiqueVersions(a, b, options = {}) {
+	const findings = [];
+	const aSections = listOf(a?.sections);
+	const bSections = listOf(b?.sections);
+	if (aSections.length !== bSections.length) findings.push(report("versions_section_mismatch", `The second form has ${bSections.length} sections; the first has ${aSections.length}.`, void 0, void 0));
+	for (let s = 0; s < Math.min(aSections.length, bSections.length); s += 1) {
+		const one = isRecord(aSections[s]) ? aSections[s] : {};
+		const two = isRecord(bSections[s]) ? bSections[s] : {};
+		const at = ["sections", String(s)];
+		if (one.key !== two.key || one.title !== two.title) findings.push(report("versions_section_mismatch", `Section ${s + 1} is "${stringOf(two.title) || stringOf(two.key)}" in the second form and "${stringOf(one.title) || stringOf(one.key)}" in the first.`, at, at));
+		const aCount = listOf(one.entries).length;
+		const bCount = listOf(two.entries).length;
+		if (aCount !== bCount) findings.push(report("versions_entry_count", `Section ${s + 1} has ${bCount} entries in the second form and ${aCount} in the first.`, [...at, "entries"], [...at, "entries"]));
+	}
+	const aEntries = entriesOf(a);
+	const bEntries = entriesOf(b);
+	const pairs = pairEntries(aEntries, bEntries, options.pairs);
+	let structureMismatches = 0;
+	let paired = 0;
+	const slots = [];
+	for (const pair of pairs) {
+		slots.push({
+			a: pair.a.path,
+			b: pair.b.path,
+			by: pair.by
+		});
+		if (pair.a.value.type !== pair.b.value.type) {
+			structureMismatches += 1;
+			findings.push(report("versions_type_mismatch", `The second form has ${typeName(pair.b.value)} here; the first has ${typeName(pair.a.value)}.`, pair.a.path, pair.b.path));
+			continue;
+		}
+		const misses = structureMisses(pair.a.value, pair.b.value);
+		if (misses.length > 0) structureMismatches += 1;
+		for (const miss of misses) {
+			const code = miss.path[miss.path.length - 1] === "type" ? "versions_type_mismatch" : miss.path.length === 1 && miss.path[0] === "items" ? "versions_entry_count" : "versions_structure_mismatch";
+			findings.push(report(code, miss.message, [...pair.a.path, ...miss.path], [...pair.b.path, ...miss.path]));
+		}
+		for (const miss of lengthMisses(pair.a.value, pair.b.value, options.lengthTolerance)) findings.push(report("versions_length_out_of_band", `${miss.words} words; the first form's has ${miss.exemplarWords}, so ${miss.bounds[0]} to ${miss.bounds[1]}.`, [...pair.a.path, ...miss.path], [...pair.b.path, ...miss.path]));
+		const items = pairItems(pair);
+		if (pair.a.value.type === "item-group") for (const item of items) slots.push({
+			a: item.a.path,
+			b: item.b.path,
+			by: item.by
+		});
+		for (const item of items) {
+			if (item.a.value.type !== item.b.value.type) continue;
+			paired += 1;
+			if ((item.a.value.learningObjectives !== void 0 || item.b.value.learningObjectives !== void 0) && objectives(item.a.value) !== objectives(item.b.value)) findings.push(report("versions_objectives_mismatch", "The two forms test different learning objectives here.", item.a.path, item.b.path));
+			const aKeys = keysOf(item.a.value);
+			for (const slot of keysOf(item.b.value)) {
+				const match = aKeys.find((one) => one.slot === slot.slot);
+				const shared = match !== void 0 ? sharedAnswers(slot, match) : [];
+				if (shared.length > 0) findings.push(report("versions_same_key", `The right answer "${shared[0]}" is the same in both forms: a learner who sat the first scores again by memory.`, [...item.a.path, ...match.path], [...item.b.path, ...slot.path]));
+			}
+		}
+	}
+	const pairedA = new Set(slots.flatMap((slot) => slot.a !== null ? [key(slot.a)] : []));
+	const pairedB = new Set(slots.flatMap((slot) => slot.b !== null ? [key(slot.b)] : []));
+	for (const entry of aEntries) for (const one of entry.value.type === "item-group" ? [{ path: entry.path }, ...itemsOf(entry)] : [entry]) if (!pairedA.has(key(one.path))) slots.push({
+		a: one.path,
+		b: null,
+		by: "position"
+	});
+	for (const entry of bEntries) for (const one of entry.value.type === "item-group" ? [{ path: entry.path }, ...itemsOf(entry)] : [entry]) if (!pairedB.has(key(one.path))) slots.push({
+		a: null,
+		b: one.path,
+		by: "position"
+	});
+	const aTexts = aEntries.flatMap((entry) => textsOf(entry.value).map((text) => ({
+		...text,
+		path: [...entry.path, ...text.path]
+	})));
+	for (const entry of bEntries) for (const text of textsOf(entry.value)) {
+		let best;
+		for (const other of aTexts) {
+			if (other.kind !== text.kind) continue;
+			const score = textSimilarity(other.text, text.text);
+			if (score >= .5 && (best === void 0 || score > best.score)) best = {
+				score,
+				path: other.path
+			};
+		}
+		if (best !== void 0) findings.push(report("versions_near_copy", `This reads like the first form's text here (similarity ${shownScore(best.score)}).`, best.path, [...entry.path, ...text.path]));
+	}
+	const aOptions = aEntries.flatMap((entry) => itemsOf(entry).flatMap((item) => {
+		const set = optionSet(item.value);
+		return set !== null ? [{
+			path: item.path,
+			set: set.join("\n")
+		}] : [];
+	}));
+	for (const entry of bEntries) for (const item of itemsOf(entry)) {
+		const set = optionSet(item.value);
+		const match = set !== null ? aOptions.find((other) => other.set === set.join("\n")) : void 0;
+		if (match !== void 0) findings.push(report("versions_near_copy", "These options are the first form's, in another order.", [...match.path, "options"], [...item.path, "options"]));
+	}
+	const allowImages = options.allowSharedImages !== false;
+	const aFiles = /* @__PURE__ */ new Map();
+	for (const entry of aEntries) for (const ref of listMediaRefs(entry.value)) if (ref.url !== null && ref.url !== "" && !aFiles.has(ref.url)) aFiles.set(ref.url, [...entry.path, ...ref.path.map(String)]);
+	for (const entry of bEntries) for (const ref of listMediaRefs(entry.value)) {
+		const first = ref.url !== null ? aFiles.get(ref.url) : void 0;
+		if (first === void 0) continue;
+		const picture = ref.kind === "image";
+		findings.push(report("versions_shared_media", picture ? "Both forms show this picture." : "Both forms use this file: a learner who sat the first hears or sees it again.", first, [...entry.path, ...ref.path.map(String)], picture && allowImages ? "advice" : "warning"));
+	}
+	const count = (entries) => entries.reduce((sum, entry) => sum + itemsOf(entry).length, 0);
+	return {
+		findings,
+		slots,
+		summary: {
+			aItems: count(aEntries),
+			bItems: count(bEntries),
+			paired,
+			structureMismatches
+		}
+	};
+}
+export { AI_COACHING_MAX_TIP_LENGTH, AI_COACHING_MAX_WORDS, AI_CRITIQUE_MAX_FIELD_LENGTH, AI_CRITIQUE_MAX_FINDINGS, AI_DRAFTS_MAX_COUNT, AI_DRAFTS_MAX_REPAIRS, AI_EXPLANATION_TYPES, AI_GRADING_PROBABILITY_TOLERANCE, AI_HINT_TYPES, AI_MATERIAL_MAX_LENGTH, AI_TEXT_MAX_LENGTH, AI_VARIANTS_MAX_EXEMPLARS, AI_VARIANTS_MAX_MATERIAL_LENGTH, AI_VARIANTS_MAX_REPAIRS, AI_VARIANT_CODE_SEVERITY, AI_VARIANT_LENGTH_BANDS, AI_VARIANT_NEAR_COPY_THRESHOLD, AI_WRITING_MAX_CORRECTIONS, AI_WRITING_MAX_FIELD_LENGTH, ActivitySchemaError, BUILT_IN_ACTIVITY_TYPES, DEFAULT_ITEM_SCORING_POLICY, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, DeferredScoringError, INTERACTIVE_VIDEO_ITEM_TYPES, ITEM_SCORING_MAX_RETRIES, OPEN_DELIVERY_POLICY, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, RedactedScoringError, SCRIPT_MAX_TURNS, SPEECH_ASSESSMENT_MAX_WORDS, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, UnknownActivityTypeError, VERSION_FINDING_SEVERITY, XAPIVerb, XAPI_VERB_DISPLAY, aiAllowedByContent, aiCoachingRequest, aiCritiqueRequest, aiDraftsRepairRequest, aiDraftsRequest, aiExplanationRequest, aiGradeOf, aiGradingRequest, aiHintRequest, aiSupports, aiVariantsRepairRequest, aiVariantsRequest, aiWritingFeedbackRequest, alignDictation, alignReadAloud, assertRedacted, assertRedactedItemGroup, buildAiFacts, calibrationReport, canonicalJson, checkAiCoaching, checkAiCritique, checkAiDrafts, checkAiExplanation, checkAiGrading, checkAiHint, checkAiVariants, checkAiWritingFeedback, classifyBand, combineDeliveryPolicies, composeAssessmentScore, composeTimelineScore, computePassThreshold, contentHash, contentJsonSchema, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, critiqueDraft, critiqueDrafts, critiqueItemGroupDraft, critiqueVersions, defineActivityType, dictationJsonSchema, dictationReferenceWords, dictationType, diffDictationChars, diffResponses, entryKeyOf, evaluate, evaluateTries, fillInTheBlanksJsonSchema, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectJsonSchema, gapSelectType, generateDrafts, generateVariants, getActivityTypeDescriptor, gradeFromJudgement, gradeFromRubric, gradeReadAloud, graderConfiguration, gte, hasGrade, hashSeed, hintRevealsAnswer, inAuditSample, inspectWav, interactiveVideoFromDrafts, isBuiltInActivityType, isInteractiveVideoItemType, isItemGroup, itemGroupJsonSchema, jsonSchemaFor, levenshteinDistance, listMediaRefs, mapMediaRefs, matchText, multipleChoiceJsonSchema, multipleChoiceType, outcomeFromGrade, outcomeFromRoutedGrade, outcomeFromUnscorable, planAttempt, planMediaBudgets, readAiTextResult, readAloudJsonSchema, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolveDeliveryPolicy, resolveItemScoringPolicy, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, roundGrade, routeGrade, score, scoreTries, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusJsonSchema, stimulusMediaKey, transcriptOf, validateActivity, validateDeliveryPolicy, validateDraft, validateItemGroup, validateItemGroupDraft, validateItemScoringPolicy, validateMedia, validateOptionMedia, validateSpeechAssessment, validateXAPIStatement, verifyAttemptPlan, withoutAuthorOnly, writtenResponseJsonSchema, writtenResponseType, xAPIBuilder, xapiDefinitionFor };
 
 //# sourceMappingURL=index.js.map