@intellectif/lk-core 1.4.0 → 1.6.0

package/dist/{registry-DVi0LR_i.cjs → registry-Ih5n4PVZ.cjs}

@@ -157,6 +157,20 @@ const MediaTrackSchema = zod_v4.strictObject({
 	default: zod_v4.boolean().optional()
 });
 const MAX_TRACKS = 12;
+/** The most turns a recording's `script` may hold. */
+const SCRIPT_MAX_TURNS = 500;
+/**
+* One speaker's turn in an author-only `script`. Loose, as content is: a host
+* may keep its own fields on a turn (the voice it cast, a direction for it).
+* Unlike a track's, both fields are required, so a misspelt one is still
+* caught.
+*/
+const ScriptTurnSchema = zod_v4.looseObject({
+	speaker: maxUnits(zod_v4.string(), 60).refine((speaker) => speaker.trim().length > 0, { error: "A script turn needs a speaker." }),
+	text: zod_v4.string().refine((text) => text.trim().length > 0, { error: "A script turn needs words." })
+});
+/** An author-only `script`: one turn or more, in the order they are spoken. */
+const ScriptSchema = zod_v4.array(ScriptTurnSchema).min(1).max(500);
 /** `poster` on anything but a video: an image with nothing to stand in for. */
 function posterFits(m) {
 	return m.poster === void 0 || m.type === "video";
@@ -199,7 +213,9 @@ const MediaSchema = zod_v4.looseObject({
 	captionsUrl: MediaUrlSchema.optional(),
 	tracks: zod_v4.array(MediaTrackSchema).min(1).max(MAX_TRACKS).optional(),
 	poster: MediaUrlSchema.optional(),
-	playback: MediaPlaybackSchema.optional()
+	playback: MediaPlaybackSchema.optional(),
+	transcript: zod_v4.string().optional(),
+	script: ScriptSchema.optional()
 }).refine((m) => m.type !== "image" && m.type !== "embed" || typeof m.alt === "string" && m.alt.length > 0, {
 	error: "image and embed media require non-empty alt text (WCAG 1.1.1 / 4.1.2).",
 	path: ["alt"]
@@ -2755,6 +2771,97 @@ function countWords(text) {
 	if (trimmed === "") return 0;
 	return trimmed.split(/\s+/).length;
 }
+/** A label as labels are compared: composed, trimmed, its spacing collapsed, lower-cased. */
+function levelKey(label) {
+	return label.normalize("NFC").trim().replace(/\s+/gu, " ").toLowerCase();
+}
+/**
+* The levels in `value`, or the first reason they cannot be used. `null` or
+* absent means the criterion has no levels, which is not a problem: it is
+* judged on a score.
+*
+* Each element and each field is read once, so a getter cannot pass the check
+* with one value and hand the grader another. The levels come back as written.
+*/
+function readRubricLevels(value) {
+	if (value === void 0 || value === null) return {
+		ok: true,
+		levels: null
+	};
+	if (!Array.isArray(value)) return {
+		ok: false,
+		problem: "not-a-list"
+	};
+	const count = value.length;
+	if (count < 2) return {
+		ok: false,
+		problem: "too-few"
+	};
+	if (count > 10) return {
+		ok: false,
+		problem: "too-many"
+	};
+	const levels = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (let index = 0; index < count; index += 1) {
+		const entry = value[index];
+		if (typeof entry !== "object" || entry === null || Array.isArray(entry)) return {
+			ok: false,
+			problem: "not-a-level",
+			index
+		};
+		const record = entry;
+		const label = record.label;
+		const description = record.description;
+		if (typeof label !== "string" || label.trim() === "") return {
+			ok: false,
+			problem: "no-label",
+			index
+		};
+		if (description !== void 0 && typeof description !== "string") return {
+			ok: false,
+			problem: "bad-description",
+			index
+		};
+		const key = levelKey(label);
+		if (seen.has(key)) return {
+			ok: false,
+			problem: "duplicate-label",
+			index
+		};
+		seen.add(key);
+		levels.push({
+			label,
+			...description !== void 0 ? { description } : {}
+		});
+	}
+	return {
+		ok: true,
+		levels
+	};
+}
+/**
+* How far level probabilities may sum from 1 and still be a distribution:
+* rounding in a grader's output, not a different judgement.
+*/
+const LEVEL_PROBABILITY_TOLERANCE = 1e-6;
+/**
+* `values` as a distribution over `count` levels whose likeliest is level
+* `chosen`, a tie for likeliest included: each a finite number from 0 to 1,
+* together 1 within {@link LEVEL_PROBABILITY_TOLERANCE}. `null` when they are
+* not one.
+*
+* The AI check refuses a reply whose probabilities are not a distribution, and
+* calibration and routing read a grade's the same way, so probabilities the
+* check let through are never ignored downstream. Each element is read once,
+* a hole as `undefined`, into the copy returned.
+*/
+function levelDistribution(values, count, chosen) {
+	const read = Array.from(values);
+	if (read.length !== count || !read.every((p) => typeof p === "number" && p >= 0 && p <= 1)) return null;
+	const sum = read.reduce((total, p) => total + p, 0);
+	return Math.abs(sum - 1) <= 1e-6 && read[chosen] === Math.max(...read) ? read : null;
+}
 //#endregion
 //#region src/scoring/strategies/all-or-nothing.ts
 /**
@@ -2971,7 +3078,11 @@ const ITEM_FINDING_SEVERITY = {
 	gs_bank_no_distractor: "warning",
 	gs_answer_in_passage: "warning",
 	wr_criterion_name_duplicate: "warning",
+	wr_levels_unreadable: "warning",
 	ra_text_long_for_time: "warning",
+	media_transcript_unused: "advice",
+	media_script_differs: "warning",
+	media_transcript_differs: "warning",
 	set_key_position_same: "warning"
 };
 function finding(code, path, message) {
@@ -3221,14 +3332,38 @@ function critiqueGapSelect(draft) {
 	});
 	return findings;
 }
+/** Why a criterion's levels cannot be graded on, said to the author. */
+const LEVELS_PROBLEM = {
+	"not-a-list": (criterion) => `Criterion ${criterion}'s levels are not a list`,
+	"too-few": (criterion) => `Criterion ${criterion} has fewer than 2 levels`,
+	"too-many": (criterion) => `Criterion ${criterion} has more than 10 levels`,
+	"not-a-level": (criterion, level) => `Level ${level} of criterion ${criterion} is not a level`,
+	"no-label": (criterion, level) => `Level ${level} of criterion ${criterion} has no label`,
+	"bad-description": (criterion, level) => `Level ${level} of criterion ${criterion} has a description that is not text`,
+	"duplicate-label": (criterion, level) => `Level ${level} of criterion ${criterion} has the label of an earlier level`
+};
 function critiqueWrittenResponse(draft) {
 	const rubric = isRecord(draft.rubric) ? draft.rubric : void 0;
-	return duplicates(rubric === void 0 ? [] : listOf(rubric.criteria), (criterion) => isRecord(criterion) ? written(criterion.name) : void 0).map(({ first, second }) => finding("wr_criterion_name_duplicate", [
+	const criteria = rubric === void 0 ? [] : listOf(rubric.criteria);
+	const names = duplicates(criteria, (criterion) => isRecord(criterion) ? written(criterion.name) : void 0).map(({ first, second }) => finding("wr_criterion_name_duplicate", [
 		"rubric",
 		"criteria",
 		second,
 		"name"
 	], `Criteria ${ordinal(first)} and ${ordinal(second)} have the same name. Feedback and grades name a criterion, so one of them cannot be told apart.`));
+	const levels = criteria.flatMap((criterion, index) => {
+		if (!isRecord(criterion)) return [];
+		const read = readRubricLevels(criterion.levels);
+		if (read.ok) return [];
+		const level = ordinal(read.index ?? 0);
+		return [finding("wr_levels_unreadable", [
+			"rubric",
+			"criteria",
+			index,
+			"levels"
+		], `${LEVELS_PROBLEM[read.problem](ordinal(index), level)}, so a grader cannot judge against them.`)];
+	});
+	return [...names, ...levels];
 }
 /** 150 words a minute: a fluent adult reading aloud. A learner is slower. */
 const WORDS_PER_SECOND = 2.5;
@@ -3616,7 +3751,9 @@ const MultipleChoiceOptionMediaSchema = zod_v4.looseObject({
 	type: zod_v4.enum(["image", "audio"]),
 	url: MediaUrlSchema,
 	alt: zod_v4.string().min(1).optional(),
-	captionsUrl: MediaUrlSchema.optional()
+	captionsUrl: MediaUrlSchema.optional(),
+	transcript: zod_v4.string().optional(),
+	script: ScriptSchema.optional()
 }).refine((media) => media.type !== "image" || media.alt !== void 0 && media.alt !== "", {
 	error: "An image option requires a non-empty `alt`.",
 	path: ["alt"]
@@ -4410,7 +4547,11 @@ const WrittenResponseRubricSchema = zod_v4.looseObject({
 const RedactedWrittenResponseRubricCriterionSchema = zod_v4.strictObject({
 	name: zod_v4.string().min(1),
 	description: zod_v4.string().optional(),
-	weight: zod_v4.number().min(0)
+	weight: zod_v4.number().min(0),
+	levels: zod_v4.array(zod_v4.strictObject({
+		label: zod_v4.string().min(1),
+		description: zod_v4.string().optional()
+	})).min(2).max(10).optional()
 });
 const RedactedWrittenResponseRubricSchema = zod_v4.strictObject({
 	label: zod_v4.string().optional(),
@@ -4852,8 +4993,49 @@ function defineActivityType(descriptor) {
 	return descriptor;
 }
 //#endregion
+//#region src/registry/keep-when.ts
+/**
+* A nested field policy that keeps its field only when the field's value
+* passes a test. Internal: the symbol is never exported, so no host policy can
+* carry one, and `FieldPolicy`'s string keys never see it.
+*
+* It can only drop a field the policy would otherwise emit, never emit one it
+* would drop, so redaction stays fail-closed. It exists for a field
+* `validateActivity` does not check in 1.x — a rubric criterion's `levels` —
+* whose malformed values would otherwise reach the strict redacted schema and
+* make `redact()` throw on content it accepted before.
+*/
+const KEEP_WHEN = Symbol("lk.keepWhen");
+/** `policy`, kept only for values `test` accepts. */
+function keepWhen(policy, test) {
+	const guarded = {
+		...policy,
+		[KEEP_WHEN]: test
+	};
+	return Object.freeze(guarded);
+}
+/** The test a nested policy keeps its field by, when it has one. */
+function guardOf(policy) {
+	return policy[KEEP_WHEN];
+}
+//#endregion
 //#region src/registry/builtins.ts
 /**
+* Where the built-in types keep their files (`mediaSlots`). Every type has its
+* `media`; dictation and read-aloud add a slower recording; a multiple-choice
+* option may carry a picture or a recording of its own.
+*/
+const MAIN_MEDIA = [{ path: ["media"] }];
+const MAIN_AND_SLOW_MEDIA = [{ path: ["media"] }, { path: ["slowMedia"] }];
+function multipleChoiceMediaSlots(data) {
+	const options = Array.isArray(data.options) ? data.options : [];
+	return [...MAIN_MEDIA, ...options.map((_, index) => ({ path: [
+		"options",
+		index,
+		"media"
+	] }))];
+}
+/**
 * Field-sensitivity policies for the built-in types (R7). Fail-closed:
 * anything not listed here is dropped by `redact()`. `scoringStrategy` is
 * answer-key everywhere — MC `partial` penalises wrong selections while
@@ -4873,10 +5055,11 @@ function defineActivityType(descriptor) {
 * documents ("a field the policy does not classify is removed") stopped at the
 * media boundary. It no longer does.
 *
-* Everything here is public by necessity: the client is the thing that renders
-* and enforces the policy, and "1 play remaining" is text the learner has to
-* read. None of it is an answer key — a listening paper's answer key is
-* `stimulus.transcript`, which stays `author-only`.
+* Public by necessity, except what the recording says: the client is the thing
+* that renders and enforces the policy, and "1 play remaining" is text the
+* learner has to read. `transcript` and `script` are the exception, and
+* `author-only`: what a listening question's recording says is that question's
+* answer, as `stimulus.transcript` is a listening paper's.
 */
 const MEDIA_FIELD_POLICY = {
 	type: "public",
@@ -4897,7 +5080,9 @@ const MEDIA_FIELD_POLICY = {
 		seek: "public",
 		rate: "public",
 		nativeControlHints: "public"
-	}
+	},
+	transcript: "author-only",
+	script: "author-only"
 };
 const SHARED_PUBLIC_FIELDS = {
 	schemaVersion: "public",
@@ -4967,7 +5152,9 @@ const MULTIPLE_CHOICE_FIELD_POLICY = {
 			type: "public",
 			url: "public",
 			alt: "public",
-			captionsUrl: "public"
+			captionsUrl: "public",
+			transcript: "author-only",
+			script: "author-only"
 		}
 	}
 };
@@ -5069,7 +5256,11 @@ const RUBRIC_FIELD_POLICY = {
 	criteria: {
 		name: "public",
 		description: "public",
-		weight: "public"
+		weight: "public",
+		levels: keepWhen({
+			label: "public",
+			description: "public"
+		}, (value) => readRubricLevels(value).ok)
 	}
 };
 const WRITTEN_RESPONSE_FIELD_POLICY = {
@@ -5103,7 +5294,8 @@ const multipleChoiceType = defineActivityType({
 		"option-deselected",
 		"submitted"
 	],
-	authoring: multipleChoiceAuthoring
+	authoring: multipleChoiceAuthoring,
+	mediaSlots: multipleChoiceMediaSlots
 });
 /** Built-in Fill-in-the-Blanks descriptor. */
 const fillInTheBlanksType = defineActivityType({
@@ -5126,7 +5318,8 @@ const fillInTheBlanksType = defineActivityType({
 		"hint-requested",
 		"submitted"
 	],
-	authoring: fillInTheBlanksAuthoring
+	authoring: fillInTheBlanksAuthoring,
+	mediaSlots: () => MAIN_MEDIA
 });
 /**
 * Built-in Written Response descriptor. Grading is DEFERRED: submissions are
@@ -5158,7 +5351,8 @@ const writtenResponseType = defineActivityType({
 		correctResponsesPattern: () => []
 	},
 	interactions: ["text-changed", "submitted"],
-	authoring: writtenResponseAuthoring
+	authoring: writtenResponseAuthoring,
+	mediaSlots: () => MAIN_MEDIA
 });
 /** Built-in Gap Select descriptor. */
 const gapSelectType = defineActivityType({
@@ -5177,7 +5371,8 @@ const gapSelectType = defineActivityType({
 		correctResponsesPattern: (data) => [data.gaps.map((gap) => `${gap.id}[.]${gap.correctChoiceId}`).join("[,]")]
 	},
 	interactions: ["gap-selected", "submitted"],
-	authoring: gapSelectAuthoring
+	authoring: gapSelectAuthoring,
+	mediaSlots: () => MAIN_MEDIA
 });
 /**
 * Built-in Dictation descriptor. Graded synchronously: the score is the
@@ -5204,7 +5399,8 @@ const dictationType = defineActivityType({
 		"hint-requested",
 		"submitted"
 	],
-	authoring: dictationAuthoring
+	authoring: dictationAuthoring,
+	mediaSlots: () => MAIN_AND_SLOW_MEDIA
 });
 /**
 * Read Aloud, the type with no answer key at all.
@@ -5285,7 +5481,8 @@ const readAloudType = defineActivityType({
 		"recording-uploaded",
 		"submitted"
 	],
-	authoring: readAloudAuthoring
+	authoring: readAloudAuthoring,
+	mediaSlots: () => MAIN_AND_SLOW_MEDIA
 });
 /**
 * The SDK's own types, by type: what the registry is created holding
@@ -5413,10 +5610,10 @@ function isStandardSchema(value) {
 * A schema's own JSON Schema, when it implements the Standard JSON Schema
 * converter (`'~standard'.jsonSchema`) — zod 4.6 does — or `undefined`.
 */
-function standardJsonSchemaOf(schema) {
+function standardJsonSchemaOf(schema, target = "draft-07") {
 	const converter = schema["~standard"].jsonSchema;
 	if (typeof converter?.output !== "function") return;
-	const generated = converter.output({ target: "draft-07" });
+	const generated = converter.output({ target });
 	return generated !== null && typeof generated === "object" && !Array.isArray(generated) ? generated : void 0;
 }
 //#endregion
@@ -5551,6 +5748,12 @@ Object.defineProperty(exports, "GapSelectDataSchema", {
 		return GapSelectDataSchema;
 	}
 });
+Object.defineProperty(exports, "LEVEL_PROBABILITY_TOLERANCE", {
+	enumerable: true,
+	get: function() {
+		return LEVEL_PROBABILITY_TOLERANCE;
+	}
+});
 Object.defineProperty(exports, "MEDIA_FIELD_POLICY", {
 	enumerable: true,
 	get: function() {
@@ -5617,6 +5820,12 @@ Object.defineProperty(exports, "RedactedScoringError", {
 		return RedactedScoringError;
 	}
 });
+Object.defineProperty(exports, "SCRIPT_MAX_TURNS", {
+	enumerable: true,
+	get: function() {
+		return SCRIPT_MAX_TURNS;
+	}
+});
 Object.defineProperty(exports, "SPEECH_ASSESSMENT_MAX_TEXT_LENGTH", {
 	enumerable: true,
 	get: function() {
@@ -5635,6 +5844,12 @@ Object.defineProperty(exports, "STEP", {
 		return STEP;
 	}
 });
+Object.defineProperty(exports, "ScriptSchema", {
+	enumerable: true,
+	get: function() {
+		return ScriptSchema;
+	}
+});
 Object.defineProperty(exports, "UnknownActivityTypeError", {
 	enumerable: true,
 	get: function() {
@@ -5731,6 +5946,12 @@ Object.defineProperty(exports, "fillInTheBlanksType", {
 		return fillInTheBlanksType;
 	}
 });
+Object.defineProperty(exports, "finding", {
+	enumerable: true,
+	get: function() {
+		return finding;
+	}
+});
 Object.defineProperty(exports, "fold", {
 	enumerable: true,
 	get: function() {
@@ -5755,6 +5976,12 @@ Object.defineProperty(exports, "groupCaptionsField", {
 		return groupCaptionsField;
 	}
 });
+Object.defineProperty(exports, "guardOf", {
+	enumerable: true,
+	get: function() {
+		return guardOf;
+	}
+});
 Object.defineProperty(exports, "isBuiltInActivityType", {
 	enumerable: true,
 	get: function() {
@@ -5803,6 +6030,18 @@ Object.defineProperty(exports, "keyPositionFinding", {
 		return keyPositionFinding;
 	}
 });
+Object.defineProperty(exports, "levelDistribution", {
+	enumerable: true,
+	get: function() {
+		return levelDistribution;
+	}
+});
+Object.defineProperty(exports, "levelKey", {
+	enumerable: true,
+	get: function() {
+		return levelKey;
+	}
+});
 Object.defineProperty(exports, "levenshteinDistance", {
 	enumerable: true,
 	get: function() {
@@ -5863,6 +6102,12 @@ Object.defineProperty(exports, "readAloudType", {
 		return readAloudType;
 	}
 });
+Object.defineProperty(exports, "readRubricLevels", {
+	enumerable: true,
+	get: function() {
+		return readRubricLevels;
+	}
+});
 Object.defineProperty(exports, "readSchema", {
 	enumerable: true,
 	get: function() {
@@ -5912,4 +6157,4 @@ Object.defineProperty(exports, "writtenResponseType", {
 	}
 });
 
-//# sourceMappingURL=registry-DVi0LR_i.cjs.map
+//# sourceMappingURL=registry-Ih5n4PVZ.cjs.map