@intellectif/lk-core 1.6.0 → 1.7.0

package/dist/{ai-writing-C4YRVrFi.cjs → ai-writing-DrPTV3R2.cjs}

@@ -1,7 +1,7 @@
-const require_registry = require("./registry-Ih5n4PVZ.cjs");
-const require_scoring = require("./scoring-CaPS6q8b.cjs");
-const require_item_group = require("./item-group-CQRbb8Rx.cjs");
-//#region src/ai-material.ts
+const require_registry = require("./registry-hzrkTeIT.cjs");
+const require_scoring = require("./scoring-CtkCFyFT.cjs");
+const require_item_group = require("./item-group-8P3WFuUK.cjs");
+// 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.
@@ -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: require_registry.numberedPassage(item.passage),
 				blanks: require_registry.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: require_registry.numberedPassage(item.passage),
 				gaps: require_registry.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. */
@@ -865,8 +870,7 @@ function checkSound(raw, fact) {
 		heard: instead.symbol
 	};
 }
-//#endregion
-//#region src/media-refs.ts
+// src/media-refs.ts
 const MAIN_KINDS = [
 	"audio",
 	"video",
@@ -1035,8 +1039,7 @@ function transcriptOf(holder) {
 	if (!isRecord$3(holder)) return null;
 	return ownText(holder) ?? (isRecord$3(holder.media) ? ownText(holder.media) : null);
 }
-//#endregion
-//#region src/authoring/recordings.ts
+// 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) {
@@ -1099,8 +1102,7 @@ function stimulusFindings(stimulus) {
 		script: stimulus.script
 	}, ["stimulus"]), ...holderFindings(stimulus.media, ["stimulus", "media"])];
 }
-//#endregion
-//#region src/authoring/item-group.ts
+// src/authoring/item-group.ts
 /**
 * A new, empty reading or listening testlet for an editor to start from.
 *
@@ -1494,8 +1496,7 @@ function checkItems(draft) {
 	for (const id of repeated) issues.push(require_registry.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.
 *
@@ -1652,8 +1653,7 @@ function critiqueDraft(type, draft) {
 	const critique = descriptor.authoring?.critique;
 	return require_registry.withValidationScope(() => [...critique === void 0 ? [] : critique(draft), ...recordingFindings(draft)]).map(require_registry.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. */
@@ -1701,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() === "" ? [] : [{
@@ -1825,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. */
@@ -1918,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",
@@ -1950,6 +1949,7 @@ const FIELDS = {
 const WRITES = {
 	"multiple-choice": [
 		"title",
+		"instructions",
 		"question",
 		"mode",
 		"options",
@@ -1957,12 +1957,14 @@ const WRITES = {
 	],
 	"fill-in-the-blanks": [
 		"title",
+		"instructions",
 		"passage",
 		"blanks",
 		"feedback"
 	],
 	"gap-select": [
 		"title",
+		"instructions",
 		"passage",
 		"gaps",
 		"feedback"
@@ -2100,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) => {
@@ -2119,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 : {};
@@ -2132,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);
@@ -2152,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 {
@@ -2530,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.
@@ -2674,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.
@@ -2999,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
@@ -3170,7 +3174,6 @@ function checkAiWritingFeedback(raw, request) {
 		}
 	};
 }
-//#endregion
 Object.defineProperty(exports, "AI_COACHING_MAX_TIP_LENGTH", {
 	enumerable: true,
 	get: function() {
@@ -3454,4 +3457,4 @@ Object.defineProperty(exports, "validateItemGroupDraft", {
 	}
 });
 
-//# sourceMappingURL=ai-writing-C4YRVrFi.cjs.map
+//# sourceMappingURL=ai-writing-DrPTV3R2.cjs.map