@intellectif/lk-core 1.5.0 → 1.7.0

package/dist/{ai-writing-D8PdhJJz.js → ai-writing-B7oMCt66.js}

@@ -1,7 +1,7 @@
-import { B as covers, F as readRubricLevels, G as issue, H as isRecord$5, I as countWords, K as pathKey, L as DRAFT_ISSUE_SEVERITY, M as LEVEL_PROBABILITY_TOLERANCE, N as levelDistribution, O as keyPositionFinding, P as levelKey, R as checkMedia, U as isUnset, V as isMissingId, W as isUnwritten, X as groupCaptionsField, Y as GROUP_CAPTIONS_REVEAL_DICTATION, _t as fold, a as readSchema, bt as revealsAnswer, et as UnknownActivityTypeError, ft as withValidationScope, gt as containsWords, k as normaliseFinding, nt as alignDictation, q as refusesEmpty, t as getActivityTypeDescriptor, vt as numberedPassage, yt as placeholderOrder, z as coveredPathsOf } from "./registry-DaZRpqjW.js";
-import { F as isGradeInRange, _ as gradeFromRubric, c as validateSpeechAssessment, r as score, s as alignReadAloud } from "./scoring-BKNNTz-s.js";
-import { a as INTERACTIVE_VIDEO_ITEM_TYPES, i as validateItemGroup, t as ItemGroupSchema, u as isInteractiveVideoItemType } from "./item-group-DdSUCUjM.js";
-//#region src/ai-material.ts
+import { A as normaliseFinding, B as coveredPathsOf, F as levelKey, G as isUnwritten, H as isMissingId, I as readRubricLevels, J as refusesEmpty, K as issue, L as countWords, N as LEVEL_PROBABILITY_TOLERANCE, O as keyPositionFinding, P as levelDistribution, R as DRAFT_ISSUE_SEVERITY, U as isRecord$6, V as covers, W as isUnset, X as GROUP_CAPTIONS_REVEAL_DICTATION, Z as groupCaptionsField, _t as containsWords, a as readSchema, bt as placeholderOrder, k as finding, pt as withValidationScope, q as pathKey, rt as alignDictation, t as getActivityTypeDescriptor, tt as UnknownActivityTypeError, vt as fold, xt as revealsAnswer, yt as numberedPassage, z as checkMedia } from "./registry-D92hz9iA.js";
+import { F as isGradeInRange, _ as gradeFromRubric, c as validateSpeechAssessment, r as score, s as alignReadAloud } from "./scoring-DD1GHcLI.js";
+import { a as INTERACTIVE_VIDEO_ITEM_TYPES, i as validateItemGroup, t as ItemGroupSchema, u as isInteractiveVideoItemType } from "./item-group-CeDk7mfM.js";
+// src/ai-material.ts
 /**
 * What a model is told about the group a question sits in: the material the
 * learner reads and sees beside it.
@@ -28,7 +28,7 @@ const MEDIA_TYPES = {
 	video: true,
 	embed: true
 };
-const isRecord$4 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRecord$5 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /** A string with something in it, as written; otherwise nothing. */
 const filled = (value) => typeof value === "string" && value.trim() !== "" ? value : void 0;
 /**
@@ -62,17 +62,17 @@ function cut(text) {
 * and a signed address must not end up in a prompt. Each field is read once.
 */
 function materialFacts(group) {
-	if (!isRecord$4(group)) return null;
+	if (!isRecord$5(group)) return null;
 	const stimulus = group.stimulus;
-	if (!isRecord$4(stimulus)) return null;
+	if (!isRecord$5(stimulus)) return null;
 	const kind = stimulus.kind;
 	if (typeof kind !== "string" || !Object.hasOwn(KINDS$2, kind)) return null;
 	const title = filled(stimulus.title) ?? filled(group.title);
 	const body = filled(stimulus.body);
 	const text = body === void 0 ? void 0 : cut(body);
 	const rawMedia = stimulus.media;
-	const mediaType = isRecord$4(rawMedia) ? rawMedia.type : void 0;
-	const alt = isRecord$4(rawMedia) ? filled(rawMedia.alt) : void 0;
+	const mediaType = isRecord$5(rawMedia) ? rawMedia.type : void 0;
+	const alt = isRecord$5(rawMedia) ? filled(rawMedia.alt) : void 0;
 	const media = typeof mediaType === "string" && Object.hasOwn(MEDIA_TYPES, mediaType) ? {
 		type: mediaType,
 		...alt !== void 0 ? { alt } : {}
@@ -89,8 +89,7 @@ function materialFacts(group) {
 		...locale !== void 0 ? { locale } : {}
 	};
 }
-//#endregion
-//#region src/ai-text.ts
+// src/ai-text.ts
 /**
 * How the SDK reads text a model wrote, before a learner does. Internal: shared
 * by the AI checks, and exported by none of the package's entry points.
@@ -178,8 +177,7 @@ function folded(text) {
 }
 /** A quote as it is searched for: folded, and without the spaces around it. */
 const needle = (quote) => folded(quote).chars.trim();
-//#endregion
-//#region src/ai.ts
+// src/ai.ts
 /**
 * The activity types the SDK builds facts for, and which of them take hints.
 * A dictation takes none: its answer is the whole sentence, and it has
@@ -284,6 +282,11 @@ const base = (data) => ({
 	title: data.title,
 	...typeof data.locale === "string" ? { locale: data.locale } : {}
 });
+/** The item's instructions, trimmed; nothing for none, or for blank ones the learner never sees. */
+function instructionsOf$1(data) {
+	const text = data.instructions;
+	return typeof text === "string" && text.trim() !== "" ? { instructions: text.trim() } : {};
+}
 /**
 * The facts a model is given about one item and one answer. `details` are the
 * SDK's per-part verdicts — from its own scorer, or from a server's outcome in
@@ -303,6 +306,7 @@ function buildAiFacts(data, response, details) {
 			return {
 				...base(data),
 				activityType: "multiple-choice",
+				...instructionsOf$1(data),
 				question: item.question,
 				mode: item.mode,
 				options: item.options.map((option) => {
@@ -328,6 +332,7 @@ function buildAiFacts(data, response, details) {
 			return {
 				...base(data),
 				activityType: "fill-in-the-blanks",
+				...instructionsOf$1(data),
 				passage: numberedPassage(item.passage),
 				blanks: placeholderOrder(item.passage).map((id, index) => {
 					const blank = blanks.get(id);
@@ -353,6 +358,7 @@ function buildAiFacts(data, response, details) {
 			return {
 				...base(data),
 				activityType: "gap-select",
+				...instructionsOf$1(data),
 				passage: numberedPassage(item.passage),
 				gaps: placeholderOrder(item.passage).map((id, index) => {
 					const gap = gaps.get(id);
@@ -596,8 +602,7 @@ function hintRevealsAnswer(facts, hint) {
 		default: return true;
 	}
 }
-//#endregion
-//#region src/ai-coaching.ts
+// src/ai-coaching.ts
 /** The most words one coaching may work on. More is refused, not cut. */
 const AI_COACHING_MAX_WORDS = 20;
 /** The longest tip for one word, in code points. */
@@ -742,7 +747,7 @@ function aiCoachingRequest(input) {
 		...learnerLocale !== void 0 ? { learnerLocale } : {}
 	};
 }
-const isRecord$3 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRecord$4 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /** A symbol as it is compared: composed, and without the spaces around it. */
 const symbolKey = (symbol) => symbol.normalize("NFC").trim();
 /**
@@ -791,7 +796,7 @@ function checkAiCoaching(raw, request) {
 		});
 		const seen = /* @__PURE__ */ new Set();
 		for (const entry of entries) {
-			if (!isRecord$3(entry) || typeof entry.itemId !== "string" || typeof entry.tip !== "string") return {
+			if (!isRecord$4(entry) || typeof entry.itemId !== "string" || typeof entry.tip !== "string") return {
 				ok: false,
 				refusal: "malformed"
 			};
@@ -839,7 +844,7 @@ function checkAiCoaching(raw, request) {
 /** A sound a model names, checked against the sounds the engine reported for the word. */
 function checkSound(raw, fact) {
 	if (raw === void 0 || raw === null) return;
-	if (!isRecord$3(raw) || typeof raw.expected !== "string" || raw.heard !== void 0 && raw.heard !== null && typeof raw.heard !== "string") return {
+	if (!isRecord$4(raw) || typeof raw.expected !== "string" || raw.heard !== void 0 && raw.heard !== null && typeof raw.heard !== "string") return {
 		ok: false,
 		refusal: "malformed"
 	};
@@ -865,8 +870,239 @@ function checkSound(raw, fact) {
 		heard: instead.symbol
 	};
 }
-//#endregion
-//#region src/authoring/item-group.ts
+// src/media-refs.ts
+const MAIN_KINDS = [
+	"audio",
+	"video",
+	"image",
+	"embed"
+];
+function isRecord$3(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function valueAt(root, path) {
+	let at = root;
+	for (const key of path) {
+		if (typeof key === "number" ? !Array.isArray(at) : !isRecord$3(at)) return;
+		at = at[key];
+	}
+	return at;
+}
+/** Where `item` keeps its files: what its type declares, or its `media` alone. */
+function slotsOf(item) {
+	const declared = typeof item.type === "string" ? getActivityTypeDescriptor(item.type)?.mediaSlots : void 0;
+	if (declared === void 0) return [{ path: ["media"] }];
+	const slots = declared(item);
+	return Array.isArray(slots) ? slots : [];
+}
+function holderRefs(holder, path, kindOfSlot, owner) {
+	if (!isRecord$3(holder)) return [];
+	const main = typeof holder.type === "string" && MAIN_KINDS.includes(holder.type) ? holder.type : kindOfSlot;
+	const refs = [];
+	const add = (field, kind, url) => {
+		refs.push({
+			path: [...path, ...field],
+			kind,
+			url,
+			holder,
+			...owner
+		});
+	};
+	if (main !== void 0) add(["url"], main, typeof holder.url === "string" ? holder.url : null);
+	if (typeof holder.captionsUrl === "string") add(["captionsUrl"], "captions", holder.captionsUrl);
+	if (Array.isArray(holder.tracks)) holder.tracks.forEach((track, index) => {
+		if (isRecord$3(track) && typeof track.src === "string") refs.push({
+			path: [
+				...path,
+				"tracks",
+				index,
+				"src"
+			],
+			kind: "track",
+			url: track.src,
+			holder: track,
+			...owner,
+			...typeof track.srclang === "string" ? { srclang: track.srclang } : {}
+		});
+	});
+	if (typeof holder.poster === "string") add(["poster"], "poster", holder.poster);
+	return refs;
+}
+function activityRefs(item, base) {
+	if (!isRecord$3(item)) return [];
+	const owner = typeof item.id === "string" ? { activityId: item.id } : {};
+	return slotsOf(item).flatMap((slot) => holderRefs(valueAt(item, slot.path), [...base, ...slot.path], slot.kind, owner));
+}
+/**
+* Every media address in one piece of content: a loose activity or an item
+* group (its stimulus first, then each item in authored order), as a
+* `SequenceEntry` holds them. Drafts are read too.
+*
+* For each activity the walker reads the places its type keeps files: an
+* item's `media`, each multiple-choice option's `media`, and dictation's and
+* read-aloud's `slowMedia`. In each it lists the main file, `captionsUrl`,
+* every track's `src` and `poster`. A type you register declares its own with
+* `mediaSlots`; without that, its `media` is read.
+*
+* A main file with no address yet is listed with `url: null`, so a recording
+* still to be made has a place in the list. Not read: addresses inside an
+* `…Html` sidecar (the SDK does not parse HTML) and a learner's recordings,
+* which are responses rather than content.
+*
+* ```ts
+* const files = listMediaRefs(entry).filter((ref) => ref.url !== null);
+* ```
+*/
+function listMediaRefs(entry) {
+	if (!isRecord$3(entry)) return [];
+	if (entry.type !== "item-group") return activityRefs(entry, []);
+	const refs = [];
+	const stimulus = entry.stimulus;
+	if (isRecord$3(stimulus)) {
+		const owner = typeof stimulus.id === "string" ? { stimulusId: stimulus.id } : {};
+		refs.push(...holderRefs(stimulus.media, ["stimulus", "media"], void 0, owner));
+	}
+	if (Array.isArray(entry.items)) entry.items.forEach((item, index) => {
+		refs.push(...activityRefs(item, ["items", index]));
+	});
+	return refs;
+}
+/** A deep copy of a JSON value. Content is plain data; a cycle cannot be copied. */
+function copyOf(value, seen) {
+	if (typeof value !== "object" || value === null) return value;
+	if (seen.has(value)) throw new TypeError("mapMediaRefs: the content contains a circular reference.");
+	seen.add(value);
+	try {
+		if (Array.isArray(value)) return value.map((element) => copyOf(element, seen));
+		const copy = {};
+		for (const [key, field] of Object.entries(value)) copy[key] = copyOf(field, seen);
+		return copy;
+	} finally {
+		seen.delete(value);
+	}
+}
+/**
+* A copy of `entry` with each address {@link listMediaRefs} finds replaced
+* by what `fn` returns for it: files moved into a new folder structure, or an
+* export's file names pointed at where an import stored them. Nothing else
+* changes, and `entry` is never modified: with `(ref) => ref.url`, the copy is
+* deep-equal to it, with the same `canonicalJson`.
+*
+* For a main file with no address yet (`url: null`), a string attaches one
+* and `null` leaves it empty. For an address that is there, `fn` must return
+* a string: removing a file is not mapping.
+*
+* The copy validates as the original did when every address `fn` returns is
+* one the media rule accepts: `https:`, `http:`, `data:`, `blob:`, or
+* root-relative (`/…`). A bundle-relative `media/part1.mp3` is refused.
+*
+* @throws TypeError when `fn` returns something other than a string or
+*   `null`, or `null` for an address that is there, or when `entry` is circular.
+*/
+function mapMediaRefs(entry, fn) {
+	const refs = listMediaRefs(entry);
+	const copy = copyOf(entry, /* @__PURE__ */ new Set());
+	for (const ref of refs) {
+		const next = fn(ref);
+		if (next === null) {
+			if (ref.url !== null) throw new TypeError(`mapMediaRefs: ${ref.path.join(".")} has a file; returning null would remove it, which is not mapping.`);
+			continue;
+		}
+		if (typeof next !== "string") throw new TypeError(`mapMediaRefs: the function must return a string or null for ${ref.path.join(".")}, not ${typeof next}.`);
+		if (next === ref.url) continue;
+		const holder = valueAt(copy, ref.path.slice(0, -1));
+		holder[ref.path[ref.path.length - 1]] = next;
+	}
+	return copy;
+}
+/** A holder's own text: its transcript, else its script as "Speaker: text" lines. */
+function ownText(holder) {
+	if (typeof holder.transcript === "string" && holder.transcript.trim() !== "") return holder.transcript;
+	const turns = Array.isArray(holder.script) ? holder.script.flatMap((turn) => isRecord$3(turn) && typeof turn.speaker === "string" && typeof turn.text === "string" && turn.text.trim() !== "" ? [`${turn.speaker.trim()}: ${turn.text.trim()}`] : []) : [];
+	return turns.length > 0 ? turns.join("\n") : null;
+}
+/**
+* The author-side text of a recording: its `transcript`, or else its
+* `script` as one "Speaker: text" line per turn. `null` when it has neither.
+*
+* `holder` is a media object, a stimulus, or an activity. A stimulus or an
+* activity is read for its own text first and then for its `media`'s; a
+* stimulus keeps both at its own level. Author-only: pass it to the author's
+* requests (`aiDraftsRequest`'s `source`, a critique), never to a learner's.
+*
+* ```ts
+* const text = transcriptOf(item.media);
+* if (text !== null) aiDraftsRequest({ types: ['multiple-choice'], source: { kind: 'transcript', text } });
+* ```
+*/
+function transcriptOf(holder) {
+	if (!isRecord$3(holder)) return null;
+	return ownText(holder) ?? (isRecord$3(holder.media) ? ownText(holder.media) : null);
+}
+// src/authoring/recordings.ts
+const written$1 = (value) => typeof value === "string" && value.trim() !== "";
+/** The script's turns that have a speaker and words, or none. */
+function turnsOf(script) {
+	return Array.isArray(script) ? script.flatMap((turn) => isRecord$6(turn) && typeof turn.speaker === "string" && written$1(turn.text) ? [{
+		speaker: turn.speaker,
+		text: turn.text
+	}] : []) : [];
+}
+const escaped = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/** A transcript's words, with each `Speaker:` label of the script's speakers taken out. */
+function transcriptWords(transcript, speakers) {
+	const labels = [...new Set(speakers.map((speaker) => speaker.trim()).filter(written$1))];
+	const unlabelled = labels.length === 0 ? transcript : transcript.replace(new RegExp(`(^|\\s)(?:${labels.map(escaped).join("|")})\\s*:`, "giu"), "$1");
+	return fold(unlabelled);
+}
+/** What a recording says, as words: its transcript, or else its script's turns. */
+function spokenWords(holder) {
+	const turns = turnsOf(holder.script);
+	if (written$1(holder.transcript)) return transcriptWords(holder.transcript, turns.map((turn) => turn.speaker));
+	return turns.length > 0 ? fold(turns.map((turn) => turn.text).join(" ")) : null;
+}
+const sameWords = (a, b) => a.length === b.length && a.every((word, index) => word === b[index]);
+/** One object's own rules: text on media with nothing to say, and a transcript its script contradicts. */
+function holderFindings(holder, path) {
+	if (!isRecord$6(holder)) return [];
+	const findings = [];
+	const turns = turnsOf(holder.script);
+	if ((written$1(holder.transcript) || turns.length > 0) && (holder.type === "image" || holder.type === "embed")) findings.push(finding("media_transcript_unused", [...path, written$1(holder.transcript) ? "transcript" : "script"], `A transcript or a script on ${holder.type === "image" ? "a picture" : "an embedded player"} has nothing to describe, and nothing reads it. Put it on the recording it belongs to.`));
+	if (written$1(holder.transcript) && turns.length > 0) {
+		const fromTranscript = transcriptWords(holder.transcript, turns.map((turn) => turn.speaker));
+		if (!sameWords(fromTranscript, fold(turns.map((turn) => turn.text).join(" ")))) findings.push(finding("media_script_differs", [...path, "script"], "The script and the transcript say different words. AI facts read the transcript, and a voice reads the script: make them say the same."));
+	}
+	return findings;
+}
+/** The field a type's own recording reads out, for the types that have one. */
+const SPOKEN_FIELD = {
+	dictation: "transcript",
+	"read-aloud": "referenceText"
+};
+/**
+* An item's recording rules, at every place its type keeps media. A
+* dictation's and a read-aloud's own text is what their recording says, so a
+* recording that says other words is reported too.
+*/
+function recordingFindings(item) {
+	const findings = listMediaRefs(item).filter((ref) => ref.path[ref.path.length - 1] === "url").flatMap((ref) => holderFindings(ref.holder, ref.path.slice(0, -1)));
+	const field = typeof item.type === "string" ? SPOKEN_FIELD[item.type] : void 0;
+	const media = item.media;
+	if (field === void 0 || !isRecord$6(media)) return findings;
+	const said = spokenWords(media);
+	const accepted = [item[field], ...item.type === "dictation" && Array.isArray(item.acceptedTranscripts) ? item.acceptedTranscripts : []].filter(written$1);
+	if (said !== null && accepted.length > 0 && !accepted.some((text) => sameWords(said, fold(text)))) findings.push(finding("media_transcript_differs", ["media", written$1(media.transcript) ? "transcript" : "script"], `The recording's transcript says different words from the item's \`${field}\`, which is what the recording is meant to say.`));
+	return findings;
+}
+/** A group's material: its own transcript against its script, and its media's rules. */
+function stimulusFindings(stimulus) {
+	if (!isRecord$6(stimulus)) return [];
+	return [...holderFindings({
+		transcript: stimulus.transcript,
+		script: stimulus.script
+	}, ["stimulus"]), ...holderFindings(stimulus.media, ["stimulus", "media"])];
+}
+// src/authoring/item-group.ts
 /**
 * A new, empty reading or listening testlet for an editor to start from.
 *
@@ -961,9 +1197,13 @@ function createInteractiveVideoDraft(context) {
 * {@link validateItemGroupDraft} already reports it.
 */
 function critiqueItemGroupDraft(draft) {
-	if (!isRecord$5(draft)) return [];
+	if (!isRecord$6(draft)) return [];
 	const items = Array.isArray(draft.items) ? draft.items : [];
-	return withValidationScope(() => [...items.flatMap((item, index) => repathed(critiqueItem(item), ["items", index])), ...keyPositionFinding(items, ["items"])]);
+	return withValidationScope(() => [
+		...stimulusFindings(draft.stimulus),
+		...items.flatMap((item, index) => repathed(critiqueItem(item), ["items", index])),
+		...keyPositionFinding(items, ["items"])
+	]);
 }
 /**
 * The item critic over a question set, as `<ActivitySequence>` takes one: each
@@ -973,11 +1213,11 @@ function critiqueItemGroupDraft(draft) {
 * skipped.
 */
 function critiqueDrafts(entries) {
-	return withValidationScope(() => [...entries.flatMap((entry, index) => repathed(isRecord$5(entry) && entry.type === "item-group" ? critiqueItemGroupDraft(entry) : critiqueItem(entry), [index])), ...keyPositionFinding(entries, [])]);
+	return withValidationScope(() => [...entries.flatMap((entry, index) => repathed(isRecord$6(entry) && entry.type === "item-group" ? critiqueItemGroupDraft(entry) : critiqueItem(entry), [index])), ...keyPositionFinding(entries, [])]);
 }
 /** One item's findings, or none for an item the critic cannot place. */
 function critiqueItem(item) {
-	if (!isRecord$5(item) || typeof item.type !== "string") return [];
+	if (!isRecord$6(item) || typeof item.type !== "string") return [];
 	if (getActivityTypeDescriptor(item.type) === void 0) return [];
 	return critiqueDraft(item.type, item);
 }
@@ -990,7 +1230,7 @@ function validateItemGroupDraft(draft) {
 }
 function validateItemGroupDraftInScope(draft) {
 	const issues = [];
-	if (!isRecord$5(draft)) {
+	if (!isRecord$6(draft)) {
 		issues.push(issue("ig_not_an_object", [], "A group must be an object with a stimulus and its items."));
 		return {
 			status: "invalid",
@@ -998,7 +1238,7 @@ function validateItemGroupDraftInScope(draft) {
 		};
 	}
 	issues.push(...checkGroupIdentity(draft));
-	if (isRecord$5(draft.stimulus)) issues.push(...checkStimulus(draft.stimulus));
+	if (isRecord$6(draft.stimulus)) issues.push(...checkStimulus(draft.stimulus));
 	else if (isUnset(draft.stimulus)) issues.push(issue("ig_stimulus_required", ["stimulus"], "Add the passage, recording or image the questions are about."));
 	issues.push(...checkItems(draft));
 	if (draft.timeline !== void 0 && draft.timeline !== null) issues.push(...checkTimeline(draft));
@@ -1048,10 +1288,10 @@ function validateItemGroupDraftInScope(draft) {
 function checkTimeline(draft) {
 	const issues = [];
 	const timeline = draft.timeline;
-	if (!isRecord$5(timeline)) return issues;
-	const stimulus = isRecord$5(draft.stimulus) ? draft.stimulus : void 0;
+	if (!isRecord$6(timeline)) return issues;
+	const stimulus = isRecord$6(draft.stimulus) ? draft.stimulus : void 0;
 	if (stimulus !== void 0 && !isUnwritten(stimulus.kind) && stimulus.kind !== "video") issues.push(issue("ig_timeline_stimulus_kind", ["stimulus", "kind"], "An interactive video needs a video: quizzes open at moments of it."));
-	else if (stimulus !== void 0 && isRecord$5(stimulus.media) && !isUnwritten(stimulus.media.type) && stimulus.media.type !== "video") issues.push(issue("ig_timeline_stimulus_kind", [
+	else if (stimulus !== void 0 && isRecord$6(stimulus.media) && !isUnwritten(stimulus.media.type) && stimulus.media.type !== "video") issues.push(issue("ig_timeline_stimulus_kind", [
 		"stimulus",
 		"media",
 		"type"
@@ -1060,7 +1300,7 @@ function checkTimeline(draft) {
 	const items = Array.isArray(draft.items) ? draft.items : [];
 	const itemIndexById = /* @__PURE__ */ new Map();
 	items.forEach((item, index) => {
-		if (!isRecord$5(item)) return;
+		if (!isRecord$6(item)) return;
 		if (typeof item.id === "string" && item.id !== "") itemIndexById.set(item.id, index);
 		const type = item.type;
 		if (typeof type === "string" && type !== "" && type !== "item-group" && !isInteractiveVideoItemType(type) && getActivityTypeDescriptor(type) !== void 0) issues.push(issue("ig_timeline_item_type", [
@@ -1078,7 +1318,7 @@ function checkTimeline(draft) {
 	const quizIds = /* @__PURE__ */ new Set();
 	const placed = /* @__PURE__ */ new Set();
 	cues.forEach((cue, cueIndex) => {
-		if (!isRecord$5(cue)) return;
+		if (!isRecord$6(cue)) return;
 		const at = (field, ...rest) => [
 			"timeline",
 			"cues",
@@ -1109,7 +1349,7 @@ function checkTimeline(draft) {
 	const chapters = Array.isArray(timeline.chapters) ? timeline.chapters : [];
 	let previousAt;
 	chapters.forEach((chapter, index) => {
-		if (!isRecord$5(chapter)) return;
+		if (!isRecord$6(chapter)) return;
 		if (isUnwritten(chapter.title)) issues.push(issue("ig_timeline_chapter_title", [
 			"timeline",
 			"chapters",
@@ -1170,14 +1410,14 @@ function checkStimulus(stimulus) {
 	if (isUnwritten(kind)) issues.push(issue("ig_stimulus_kind_required", at("kind"), "Choose what the questions are about: a text, a recording, a video, an image, or a mix."));
 	else if (typeof kind !== "string" || !KINDS$1.has(kind)) {
 		if (typeof kind === "string") issues.push(issue("ig_stimulus_kind_invalid", at("kind"), `"${kind}" is not a stimulus kind. Use text, audio, video, image or mixed.`));
-		if (isRecord$5(stimulus.media)) issues.push(...checkMedia(stimulus.media, at("media")));
+		if (isRecord$6(stimulus.media)) issues.push(...checkMedia(stimulus.media, at("media")));
 		return issues;
 	}
 	const hasBody = typeof stimulus.body === "string" && stimulus.body.trim() !== "";
 	const htmlPresent = !isUnset(stimulus.bodyHtml);
 	if (!hasBody && (kind === "text" || kind === "mixed" || htmlPresent)) issues.push(issue("ig_stimulus_body_required", at("body"), isUnwritten(stimulus.bodyHtml) ? "Write the passage." : "Write the passage as plain text too. The rich-text version is shown only where a sanitiser is supplied."));
 	if (kind !== "text" && isUnset(stimulus.media)) issues.push(issue("ig_stimulus_media_required", at("media"), "Add the recording, video or image."));
-	else if (isRecord$5(stimulus.media)) {
+	else if (isRecord$6(stimulus.media)) {
 		const allowed = MEDIA_FOR_KIND[kind];
 		const mediaType = stimulus.media.type;
 		if (allowed !== void 0 && typeof mediaType === "string" && !allowed.includes(mediaType)) issues.push(issue("ig_stimulus_media_kind", at("media", "type"), `A "${kind}" stimulus cannot carry ${mediaType} media. Use ${allowed.join(" or ")}.`));
@@ -1204,7 +1444,7 @@ function checkItems(draft) {
 	const seen = /* @__PURE__ */ new Set();
 	const repeated = /* @__PURE__ */ new Set();
 	for (const [index, item] of items.entries()) {
-		if (!isRecord$5(item)) continue;
+		if (!isRecord$6(item)) continue;
 		const ordinal = index + 1;
 		if (isMissingId(item.id)) issues.push(issue("ig_item_id_required", [
 			"items",
@@ -1256,8 +1496,7 @@ function checkItems(draft) {
 	for (const id of repeated) issues.push(issue("ig_item_id_duplicate", ["items"], `More than one question has the id "${id}".`));
 	return issues;
 }
-//#endregion
-//#region src/authoring/index.ts
+// src/authoring/index.ts
 /**
 * Tells a draft that is not finished from a draft that is wrong.
 *
@@ -1301,7 +1540,7 @@ function validateDraft(type, draft) {
 function validateDraftInScope(type, draft) {
 	const descriptor = getActivityTypeDescriptor(type);
 	if (descriptor === void 0) throw new UnknownActivityTypeError(String(type));
-	const reported = isRecord$5(draft) && descriptor.authoring?.checkDraft !== void 0 ? descriptor.authoring.checkDraft(draft).map(normalise) : [];
+	const reported = isRecord$6(draft) && descriptor.authoring?.checkDraft !== void 0 ? descriptor.authoring.checkDraft(draft).map(normalise) : [];
 	const issues = [...reported];
 	const parsed = readSchema(descriptor.schema, draft, `Activity type "${descriptor.type}"`, { reportInput: true });
 	if (!parsed.success) {
@@ -1410,12 +1649,11 @@ function normalise(found) {
 function critiqueDraft(type, draft) {
 	const descriptor = getActivityTypeDescriptor(type);
 	if (descriptor === void 0) throw new UnknownActivityTypeError(String(type));
+	if (!isRecord$6(draft)) return [];
 	const critique = descriptor.authoring?.critique;
-	if (!isRecord$5(draft) || critique === void 0) return [];
-	return withValidationScope(() => critique(draft)).map(normaliseFinding);
+	return withValidationScope(() => [...critique === void 0 ? [] : critique(draft), ...recordingFindings(draft)]).map(normaliseFinding);
 }
-//#endregion
-//#region src/ai-critique.ts
+// src/ai-critique.ts
 /** The most findings one critique may carry. More is refused, not cut. */
 const AI_CRITIQUE_MAX_FINDINGS = 20;
 /** The longest message or quote in a finding, in code points. */
@@ -1448,6 +1686,10 @@ const NOT_WORDS = /* @__PURE__ */ new Set([
 	"bankId",
 	"url",
 	"captionsUrl",
+	"src",
+	"srclang",
+	"poster",
+	"speaker",
 	"match",
 	"playback",
 	"recording",
@@ -1459,10 +1701,10 @@ const NOT_WORDS = /* @__PURE__ */ new Set([
 	"timeline"
 ]);
 /**
-* Every string an author wrote into an item, with its path: the question, the
-* options, the passage, the answers, the hints, the feedback, a picture's
-* `alt`. Settings, ids and addresses are left out, and so is any `…Html`
-* sidecar: the plain field beside it holds the same words.
+* Every string an author wrote into an item, with its path: the instructions,
+* the question, the options, the passage, the answers, the hints, the
+* feedback, a picture's `alt`. Settings, ids and addresses are left out, and
+* so is any `…Html` sidecar: the plain field beside it holds the same words.
 */
 function fieldsOf(value, path = []) {
 	if (typeof value === "string") return value.trim() === "" ? [] : [{
@@ -1583,8 +1825,7 @@ function checkAiCritique(raw, request) {
 		}
 	};
 }
-//#endregion
-//#region src/ai-drafts.ts
+// src/ai-drafts.ts
 /** The most drafts one request may ask for, and the most a reply may hold when it names no count. */
 const AI_DRAFTS_MAX_COUNT = 50;
 /** The most repair passes `generateDrafts` makes. */
@@ -1676,7 +1917,7 @@ const FIELDS = {
 	},
 	transcript: text("What the learner hears and types: words from the source, as they are said there."),
 	referenceText: text("What the learner reads aloud: a sentence or two from the source."),
-	instructions: text("Optional. How to read it, shown to the learner."),
+	instructions: text("Optional. The task, shown to the learner before the item: what to do (\"Complete the sentence. Use ONE word.\"), or how to read it aloud. Never part of the text the learner answers."),
 	prompt: text("The writing task, as plain text."),
 	minWords: {
 		type: "integer",
@@ -1708,6 +1949,7 @@ const FIELDS = {
 const WRITES = {
 	"multiple-choice": [
 		"title",
+		"instructions",
 		"question",
 		"mode",
 		"options",
@@ -1715,12 +1957,14 @@ const WRITES = {
 	],
 	"fill-in-the-blanks": [
 		"title",
+		"instructions",
 		"passage",
 		"blanks",
 		"feedback"
 	],
 	"gap-select": [
 		"title",
+		"instructions",
 		"passage",
 		"gaps",
 		"feedback"
@@ -1858,10 +2102,16 @@ function feedbackOf(entry) {
 		...incorrect !== void 0 ? { incorrect } : {}
 	} };
 }
+/** The instructions a model wrote for the learner, when it wrote any. */
+function instructionsOf(entry) {
+	const instructions = written(entry.instructions);
+	return instructions !== void 0 ? { instructions } : {};
+}
 /** A type's content, read from what a model wrote. */
 function contentOf(type, entry, newId) {
 	switch (type) {
 		case "multiple-choice": return {
+			...instructionsOf(entry),
 			question: stringOf(entry.question),
 			...typeof entry.mode === "string" ? { mode: entry.mode } : {},
 			options: listOf(entry.options).map((option) => {
@@ -1877,6 +2127,7 @@ function contentOf(type, entry, newId) {
 			...feedbackOf(entry)
 		};
 		case "fill-in-the-blanks": return {
+			...instructionsOf(entry),
 			passage: stringOf(entry.passage),
 			blanks: listOf(entry.blanks).map((blank, index) => {
 				const fields = isRecord$1(blank) ? blank : {};
@@ -1890,6 +2141,7 @@ function contentOf(type, entry, newId) {
 			...feedbackOf(entry)
 		};
 		case "gap-select": return {
+			...instructionsOf(entry),
 			passage: stringOf(entry.passage),
 			gaps: listOf(entry.gaps).map((gap, index) => {
 				const marked = listOf(isRecord$1(gap) ? gap.choices : void 0);
@@ -1910,14 +2162,11 @@ function contentOf(type, entry, newId) {
 			transcript: stringOf(entry.transcript),
 			...feedbackOf(entry)
 		};
-		case "read-aloud": {
-			const instructions = written(entry.instructions);
-			return {
-				referenceText: stringOf(entry.referenceText),
-				...instructions !== void 0 ? { instructions } : {},
-				...feedbackOf(entry)
-			};
-		}
+		case "read-aloud": return {
+			referenceText: stringOf(entry.referenceText),
+			...instructionsOf(entry),
+			...feedbackOf(entry)
+		};
 		default: {
 			const criteria = listOf(isRecord$1(entry.rubric) ? entry.rubric.criteria : void 0);
 			return {
@@ -2288,8 +2537,7 @@ function interactiveVideoFromDrafts(input) {
 		findings: critiqueItemGroupDraft(group)
 	};
 }
-//#endregion
-//#region src/ai-written.ts
+// src/ai-written.ts
 /**
 * What the AI features about a written response share: reading a model's text
 * fields, and finding each correction's quote in the learner's text.
@@ -2432,8 +2680,7 @@ function checkCorrections(raw, text) {
 		corrections
 	};
 }
-//#endregion
-//#region src/ai-grading.ts
+// src/ai-grading.ts
 /**
 * How far a model's level probabilities may sum from 1 and still be a
 * distribution: rounding in a model's output, not a different judgement.
@@ -2757,8 +3004,7 @@ function checkAiGrading(raw, request) {
 		}
 	};
 }
-//#endregion
-//#region src/ai-writing.ts
+// src/ai-writing.ts
 /**
 * The request for feedback on a draft, or `null` when there is none to give:
 * not a written response, an author who switched explanations off (writing
@@ -2928,7 +3174,6 @@ function checkAiWritingFeedback(raw, request) {
 		}
 	};
 }
-//#endregion
-export { checkAiCoaching as A, checkAiExplanation as B, createItemGroupDraft as C, AI_COACHING_MAX_TIP_LENGTH as D, validateItemGroupDraft as E, aiExplanationRequest as F, hintRevealsAnswer as H, aiGradeOf as I, aiHintRequest as L, AI_HINT_TYPES as M, AI_TEXT_MAX_LENGTH as N, AI_COACHING_MAX_WORDS as O, aiAllowedByContent as P, aiSupports as R, createInteractiveVideoDraft as S, critiqueItemGroupDraft as T, readAiTextResult as U, checkAiHint as V, AI_MATERIAL_MAX_LENGTH as W, aiCritiqueRequest as _, checkAiGrading as a, critiqueDraft as b, AI_DRAFTS_MAX_COUNT as c, aiDraftsRequest as d, checkAiDrafts as f, AI_CRITIQUE_MAX_FINDINGS as g, AI_CRITIQUE_MAX_FIELD_LENGTH as h, aiGradingRequest as i, AI_EXPLANATION_TYPES as j, aiCoachingRequest as k, AI_DRAFTS_MAX_REPAIRS as l, interactiveVideoFromDrafts as m, checkAiWritingFeedback as n, AI_WRITING_MAX_CORRECTIONS as o, generateDrafts as p, AI_GRADING_PROBABILITY_TOLERANCE as r, AI_WRITING_MAX_FIELD_LENGTH as s, aiWritingFeedbackRequest as t, aiDraftsRepairRequest as u, checkAiCritique as v, critiqueDrafts as w, validateDraft as x, createDraft as y, buildAiFacts as z };
+export { AI_COACHING_MAX_TIP_LENGTH as A, aiHintRequest as B, createItemGroupDraft as C, listMediaRefs as D, validateItemGroupDraft as E, AI_HINT_TYPES as F, hintRevealsAnswer as G, buildAiFacts as H, AI_TEXT_MAX_LENGTH as I, readAiTextResult as K, aiAllowedByContent as L, aiCoachingRequest as M, checkAiCoaching as N, mapMediaRefs as O, AI_EXPLANATION_TYPES as P, aiExplanationRequest as R, createInteractiveVideoDraft as S, critiqueItemGroupDraft as T, checkAiExplanation as U, aiSupports as V, checkAiHint as W, aiCritiqueRequest as _, checkAiGrading as a, critiqueDraft as b, AI_DRAFTS_MAX_COUNT as c, aiDraftsRequest as d, checkAiDrafts as f, AI_CRITIQUE_MAX_FINDINGS as g, AI_CRITIQUE_MAX_FIELD_LENGTH as h, aiGradingRequest as i, AI_COACHING_MAX_WORDS as j, transcriptOf as k, AI_DRAFTS_MAX_REPAIRS as l, interactiveVideoFromDrafts as m, checkAiWritingFeedback as n, AI_WRITING_MAX_CORRECTIONS as o, generateDrafts as p, AI_MATERIAL_MAX_LENGTH as q, AI_GRADING_PROBABILITY_TOLERANCE as r, AI_WRITING_MAX_FIELD_LENGTH as s, aiWritingFeedbackRequest as t, aiDraftsRepairRequest as u, checkAiCritique as v, critiqueDrafts as w, validateDraft as x, createDraft as y, aiGradeOf as z };
 
-//# sourceMappingURL=ai-writing-D8PdhJJz.js.map
+//# sourceMappingURL=ai-writing-B7oMCt66.js.map