@intellectif/lk-core 1.5.0 → 1.7.0

package/dist/{registry-Ce00A_OW.cjs → registry-hzrkTeIT.cjs}

@@ -1,4 +1,4 @@
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -19,11 +19,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
-//#endregion
 let zod_v4 = require("zod/v4");
 zod_v4 = __toESM(zod_v4, 1);
 let zod_v4_core = require("zod/v4/core");
-//#region src/schemas/ai.ts
+// src/schemas/ai.ts
 /**
 * What an author allows AI to do for one item: see `ActivityAiPermissions`.
 * Loose like every content schema, so a key a later release adds survives an
@@ -33,8 +32,7 @@ const AiPermissionsSchema = zod_v4.looseObject({
 	explanations: zod_v4.boolean().optional(),
 	hints: zod_v4.boolean().optional()
 });
-//#endregion
-//#region src/schemas/feedback.ts
+// src/schemas/feedback.ts
 /**
 * Optional authored "overall feedback" shown after submission, selected by
 * whether the learner passed (h5p-style overall feedback). Both fields are
@@ -44,8 +42,7 @@ const FeedbackSchema = zod_v4.looseObject({
 	correct: zod_v4.string().min(1).optional(),
 	incorrect: zod_v4.string().min(1).optional()
 });
-//#endregion
-//#region src/schemas/text-length.ts
+// src/schemas/text-length.ts
 /**
 * `schema`, refusing a string longer than `max` UTF-16 code units — its
 * JavaScript `length`, the unit these limits have always counted in.
@@ -68,8 +65,7 @@ function maxUnits(schema, max) {
 		});
 	}).meta({ maxLength: max });
 }
-//#endregion
-//#region src/schemas/media.ts
+// src/schemas/media.ts
 /**
 * Optional media attached to an activity, rendered above the question or
 * passage — e.g. a recording to listen to, or an embedded video to watch
@@ -157,6 +153,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 +209,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"]
@@ -251,8 +263,7 @@ const RedactedMediaSchema = zod_v4.strictObject({
 	error: "embed media requires an absolute http(s) provider URL. data:, blob:, and relative URLs are not allowed for embeds — the embed iframe runs with allow-scripts, and a data:/same-origin document there is an XSS vector.",
 	path: ["url"]
 }).refine(posterFits, POSTER_FITS).refine(tracksFit, TRACKS_FIT).refine(tracksAreDistinct, TRACKS_DISTINCT);
-//#endregion
-//#region src/schemas/fill-in-the-blanks.ts
+// src/schemas/fill-in-the-blanks.ts
 /**
 * Matches `{{ blank_id }}` placeholders in a passage, capturing the trimmed id.
 * Exported for the draft checks in `authoring/`, which must read a passage
@@ -260,6 +271,12 @@ const RedactedMediaSchema = zod_v4.strictObject({
 */
 const PLACEHOLDER_RE = /\{\{\s*([^{}]+?)\s*\}\}/g;
 /**
+* The instructions of an item with a passage: plain text, with no `{{id}}`
+* placeholder. Blanks and gaps live in the passage only, and one written here
+* would be shown to the learner as it stands. Shared by Gap Select.
+*/
+const PassageInstructionsSchema = zod_v4.string().refine((text) => text.match(PLACEHOLDER_RE) === null, { error: "The instructions are plain text: a {{id}} placeholder belongs in the passage, where its blank or gap is." });
+/**
 * Zod schema for a `TextMatchPolicy` — the opt-in matching tolerances a blank
 * may declare. Every default reproduces the v1 trim + case-fold semantics.
 */
@@ -307,6 +324,7 @@ const FillInTheBlanksDataSchema = zod_v4.looseObject({
 	type: zod_v4.literal("fill-in-the-blanks"),
 	id: zod_v4.string().min(1),
 	title: zod_v4.string().min(1),
+	instructions: PassageInstructionsSchema.optional(),
 	passage: zod_v4.string().min(1),
 	passageHtml: zod_v4.string().optional(),
 	blanks: zod_v4.array(BlankConfigSchema).min(1),
@@ -338,8 +356,7 @@ const FillInTheBlanksDataSchema = zod_v4.looseObject({
 	error: "Each blank id must appear exactly once in blanks[] and have exactly one matching {{id}} placeholder in the passage, and vice versa.",
 	path: ["passage"]
 });
-//#endregion
-//#region src/answer-leak.ts
+// src/answer-leak.ts
 /**
 * Whether a text gives an answer away: the rule an AI hint is held to, and the
 * one the item critic holds an author's own hint, title and passage to.
@@ -426,8 +443,7 @@ function revealsAnswer(text, answer, passage, position) {
 	if (before === void 0 && after === void 0) return containsWords(words, needle);
 	return before !== void 0 && containsWords(words, [before, ...needle]) || after !== void 0 && containsWords(words, [...needle, after]);
 }
-//#endregion
-//#region src/built-in-types.ts
+// src/built-in-types.ts
 /**
 * The activity types the SDK ships, in one closed list.
 *
@@ -463,8 +479,7 @@ function isBuiltInActivityType(type) {
 * @internal
 */
 function everyBuiltInTypeHandled(_value) {}
-//#endregion
-//#region src/scoring/dictation/edit-distance.ts
+// src/scoring/dictation/edit-distance.ts
 /**
 * The code points of `text`, as numbers. A surrogate pair is one code point; a
 * lone surrogate iterates as one code point too — deterministic, never thrown.
@@ -516,8 +531,7 @@ function similarity(a, b) {
 	const max = Math.max(codePoints(a).length, codePoints(b).length);
 	return max === 0 ? 0 : (max - editDistance(a, b)) / max;
 }
-//#endregion
-//#region src/validation-scope.ts
+// src/validation-scope.ts
 /**
 * Work shared for the length of one outermost validation call.
 *
@@ -556,8 +570,7 @@ function scopeCache(key, create) {
 	}
 	return value;
 }
-//#endregion
-//#region src/scoring/dictation/unicode-joining.ts
+// src/scoring/dictation/unicode-joining.ts
 /**
 * Unicode data the dictation normaliser reads when it decides whether a joiner
 * changes how the text is drawn (see `normalize.ts`): the viramas, and which
@@ -775,8 +788,7 @@ const JOINS_BACKWARD = [
 	[69577, 69578],
 	[125184, 125251]
 ];
-//#endregion
-//#region src/scoring/dictation/normalize.ts
+// src/scoring/dictation/normalize.ts
 /**
 * The longest transcript a dictation accepts, in code points, before and after
 * its equivalences are applied — and its rules may not grow it past twice
@@ -1736,8 +1748,7 @@ function searchReveal(forms, candidate) {
 		return fields.some((field) => containsPhrase(field, phrase));
 	});
 }
-//#endregion
-//#region src/scoring/dictation/align.ts
+// src/scoring/dictation/align.ts
 /**
 * The words the scorer can emit a detail for, one list per candidate — index 0
 * is the transcript, index n is `acceptedTranscripts[n − 1]` — each word in the
@@ -1936,8 +1947,7 @@ function alignWords(reference, attempt) {
 	}
 	return words;
 }
-//#endregion
-//#region src/errors.ts
+// src/errors.ts
 /** Thrown when activity data fails schema validation at a component boundary. */
 var ActivitySchemaError = class extends Error {
 	activityType;
@@ -1991,8 +2001,7 @@ var DeferredScoringError = class extends Error {
 		this.name = "DeferredScoringError";
 	}
 };
-//#endregion
-//#region src/schemas/after-issues.ts
+// src/schemas/after-issues.ts
 /**
 * A check zod runs even when another field was refused. An ordinary check is
 * skipped once any issue has been reported, so an author fixing a recording's
@@ -2029,8 +2038,7 @@ function parsedFields(payload) {
 		refused
 	};
 }
-//#endregion
-//#region src/schemas/dictation.ts
+// src/schemas/dictation.ts
 /**
 * Zod schema for the slower second recording of a dictation. Loose like every
 * content schema (a sidecar survives), audio only, and — deliberately — with no
@@ -2212,8 +2220,7 @@ function groupCaptionsField(group, written) {
 }
 /** The message every validator gives for {@link groupCaptionsRevealDictation}. */
 const GROUP_CAPTIONS_REVEAL_DICTATION = "The stimulus recording carries captions, and a dictation in this group plays that recording: the captions are the answer. Remove the captions, or give the dictation its own recording.";
-//#endregion
-//#region src/authoring/issues.ts
+// src/authoring/issues.ts
 /**
 * Every issue code the SDK's draft checks can report, with its severity.
 *
@@ -2549,8 +2556,7 @@ function coveredPathsOf(reported) {
 	}
 	return covered;
 }
-//#endregion
-//#region src/authoring/dictation.ts
+// src/authoring/dictation.ts
 /**
 * Draft support for `dictation`.
 *
@@ -2740,8 +2746,7 @@ function checkTolerance(tolerance) {
 	}
 	return issues;
 }
-//#endregion
-//#region src/count-words.ts
+// src/count-words.ts
 /**
 * Canonical word counter for written-response bounds: tokens are
 * maximal runs of non-whitespace (split on `\s+`), so hyphenated forms
@@ -2846,8 +2851,7 @@ function levelDistribution(values, count, chosen) {
 	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
+// src/scoring/strategies/all-or-nothing.ts
 /**
 * All-or-nothing scoring: full credit only when every item is correct.
 *
@@ -2857,8 +2861,7 @@ function levelDistribution(values, count, chosen) {
 function allOrNothingStrategy(correctItems) {
 	return correctItems.every((isCorrect) => isCorrect) ? 1 : 0;
 }
-//#endregion
-//#region src/scoring/strategies/partial.ts
+// src/scoring/strategies/partial.ts
 /**
 * Partial-credit scoring for Multiple Choice — balanced/symmetric scheme.
 *
@@ -2898,8 +2901,7 @@ function partialStrategy(correctSelected, incorrectSelected, totalCorrect, total
 function partialBlankStrategy(correctBlanks, totalBlanks) {
 	return correctBlanks / totalBlanks;
 }
-//#endregion
-//#region src/scoring/text-match.ts
+// src/scoring/text-match.ts
 /** Combining marks (any script) removed for diacritic folding after NFD decomposition. */
 const COMBINING_MARKS_RE = /\p{M}/gu;
 /**
@@ -2992,8 +2994,7 @@ function matchText(input, accepted, policy = {}) {
 		via: "none"
 	};
 }
-//#endregion
-//#region src/scoring/activity-scorers/fill-in-the-blanks.ts
+// src/scoring/activity-scorers/fill-in-the-blanks.ts
 /**
 * Resolves the effective match policy for a blank. The legacy
 * `caseSensitive` / `trimWhitespace` flags map onto the baseline policy
@@ -3037,8 +3038,7 @@ function scoreFillInTheBlanks(data, response) {
 		details
 	};
 }
-//#endregion
-//#region src/authoring/findings.ts
+// src/authoring/findings.ts
 /**
 * Every finding code the SDK's item critic can report, with its severity.
 *
@@ -3064,6 +3064,9 @@ const ITEM_FINDING_SEVERITY = {
 	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) {
@@ -3088,8 +3091,7 @@ function normaliseFinding(found) {
 		severity: documented ?? (found.severity === "advice" ? "advice" : "warning")
 	};
 }
-//#endregion
-//#region src/authoring/critique.ts
+// src/authoring/critique.ts
 /**
 * The built-in item critic: what an experienced item writer points out on
 * review, as far as a rule can see it without a model.
@@ -3372,8 +3374,7 @@ function keyPositionFinding(items, path) {
 	if (positions.length < KEY_POSITION_MINIMUM || !positions.every((at) => at === positions[0])) return [];
 	return [finding("set_key_position_same", path, `In all ${positions.length} single-answer questions the right option is option ${ordinal(positions[0])}. Vary its position, or shuffle the options.`)];
 }
-//#endregion
-//#region src/authoring/fill-in-the-blanks.ts
+// src/authoring/fill-in-the-blanks.ts
 /**
 * Draft support for `fill-in-the-blanks`.
 *
@@ -3505,8 +3506,7 @@ function pairsOneToOne$1(placeholders, blanks) {
 	if (placeholders.size !== blankIds.length) return false;
 	return blankIds.every((id) => typeof id === "string" && placeholders.get(id) === 1);
 }
-//#endregion
-//#region src/authoring/gap-select.ts
+// src/authoring/gap-select.ts
 /** Mirrors `GapSelectChoiceSchema` arrays: `.min(2)` on both a gap's own list and a bank. */
 const MIN_CHOICES = 2;
 /**
@@ -3704,8 +3704,7 @@ function pairsOneToOne(placeholders, gaps) {
 	if (new Set(ids).size !== ids.length || placeholders.size !== ids.length) return false;
 	return ids.every((id) => typeof id === "string" && placeholders.get(id) === 1);
 }
-//#endregion
-//#region src/schemas/multiple-choice.ts
+// src/schemas/multiple-choice.ts
 /**
 * Zod schema for a single Multiple Choice option. Loose: unknown keys are
 * preserved through validation (forward-compat / consumer sidecars — B7).
@@ -3732,7 +3731,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"]
@@ -3767,6 +3768,7 @@ const MultipleChoiceDataSchema = zod_v4.looseObject({
 	type: zod_v4.literal("multiple-choice"),
 	id: zod_v4.string().min(1),
 	title: zod_v4.string().min(1),
+	instructions: zod_v4.string().optional(),
 	question: zod_v4.string().min(1),
 	questionHtml: zod_v4.string().optional(),
 	mode: zod_v4.enum(["single", "multi"]),
@@ -3796,8 +3798,7 @@ const MultipleChoiceDataSchema = zod_v4.looseObject({
 	error: "Option ids must be unique within the activity.",
 	path: ["options"]
 });
-//#endregion
-//#region src/authoring/multiple-choice.ts
+// src/authoring/multiple-choice.ts
 /** Mirrors `MultipleChoiceDataSchema`: `options` is `.min(2).max(26)`. */
 const MIN_OPTIONS = 2;
 const MAX_OPTIONS = 26;
@@ -3900,8 +3901,7 @@ function checkOptionMedia(media, index, ordinal) {
 	if (kind === "video" || kind === "embed") return [issue("mc_option_media_kind", [...path, "type"], `Option ${ordinal} carries ${kind === "embed" ? "an embedded player" : "a video"}, which cannot be an option: its controls swallow the click that selects the answer. Use a picture or a recording.`)];
 	return checkMedia(media, path, MultipleChoiceOptionMediaSchema);
 }
-//#endregion
-//#region src/scoring/speech/limits.ts
+// src/scoring/speech/limits.ts
 /**
 * The longest reference text a read-aloud item accepts, in code points, before
 * and after normalisation. It is the dictation transcript cap on purpose: the
@@ -3951,8 +3951,7 @@ const SPEECH_ASSESSMENT_MAX_WORDS = 1e3;
 * read-aloud item comes near it.
 */
 const SPEECH_ASSESSMENT_MAX_TEXT_LENGTH = DICTATION_MAX_TEXT_LENGTH;
-//#endregion
-//#region src/scoring/speech/locale.ts
+// src/scoring/speech/locale.ts
 /**
 * A BCP 47 tag in the one spelling read-aloud accepts: a lowercase language of
 * two or three letters, an optional title-case script, and a region of two
@@ -3968,8 +3967,7 @@ const SPEECH_ASSESSMENT_MAX_TEXT_LENGTH = DICTATION_MAX_TEXT_LENGTH;
 * Internal: the content schema and the assessment validator share it.
 */
 const CANONICAL_LOCALE_RE = /^[a-z]{2,3}(?:-[A-Z][a-z]{3})?-(?:[A-Z]{2}|[0-9]{3})$/;
-//#endregion
-//#region src/schemas/read-aloud.ts
+// src/schemas/read-aloud.ts
 /** The dimensions a read-aloud grade can be made of, in the order they are documented. */
 const READ_ALOUD_DIMENSIONS = [
 	"accuracy",
@@ -4122,8 +4120,7 @@ const ReadAloudDataSchema = zod_v4.looseObject({
 		if (minSeconds !== void 0 && minSeconds >= maxSeconds) report(["recording", "minSeconds"], minSeconds, "The shortest take must be shorter than the longest.");
 	}
 }));
-//#endregion
-//#region src/authoring/read-aloud.ts
+// src/authoring/read-aloud.ts
 /**
 * Draft support for `read-aloud`.
 *
@@ -4286,8 +4283,7 @@ function checkSlowRecording(draft) {
 	if (typeof slow.url === "string" && slow.url !== "" && slow.url === media.url) issues.push(issue("ra_slow_media_same_recording", ["slowMedia", "url"], "The slow model recording is the same file as the recording. Point it at the slower reading."));
 	return issues;
 }
-//#endregion
-//#region src/authoring/written-response.ts
+// src/authoring/written-response.ts
 /**
 * Draft support for `written-response`.
 *
@@ -4375,8 +4371,7 @@ function checkCriteria(criteria) {
 	else if (totalWeight === Number.POSITIVE_INFINITY) issues.push(issue("wr_rubric_weights_too_large", ["rubric", "criteria"], "The rubric weights add up to more than can be calculated with. Use smaller weights."));
 	return issues;
 }
-//#endregion
-//#region src/schemas/gap-select.ts
+// src/schemas/gap-select.ts
 /**
 * Zod schema for one selectable choice. Loose, like every other schema here:
 * unknown keys are preserved so a consumer sidecar survives validation.
@@ -4440,6 +4435,7 @@ const GapSelectDataSchema = zod_v4.looseObject({
 	type: zod_v4.literal("gap-select"),
 	id: zod_v4.string().min(1),
 	title: zod_v4.string().min(1),
+	instructions: PassageInstructionsSchema.optional(),
 	passage: zod_v4.string().min(1),
 	passageHtml: zod_v4.string().optional(),
 	gaps: zod_v4.array(GapSelectGapSchema).min(1),
@@ -4500,8 +4496,7 @@ const GapSelectDataSchema = zod_v4.looseObject({
 	error: "Each gap needs unique choice ids and a `correctChoiceId` that is one of the choices it offers.",
 	path: ["gaps"]
 });
-//#endregion
-//#region src/schemas/written-response.ts
+// src/schemas/written-response.ts
 /** Zod schema for a single rubric criterion. Loose: unknown keys preserved. */
 const WrittenResponseRubricCriterionSchema = zod_v4.looseObject({
 	name: zod_v4.string().min(1),
@@ -4572,8 +4567,7 @@ const WrittenResponseDataSchema = zod_v4.looseObject({
 	error: "maxWords must be greater than or equal to minWords.",
 	path: ["maxWords"]
 });
-//#endregion
-//#region src/schemas/redacted.ts
+// src/schemas/redacted.ts
 /**
 * Schemas for REDACTED activity data — the learner-safe projection `redact()`
 * produces (R7). Deliberately STRICT (`z.strictObject`), the opposite of the
@@ -4637,6 +4631,7 @@ const RedactedMultipleChoiceOptionSchema = zod_v4.strictObject({
 const RedactedMultipleChoiceDataSchema = zod_v4.strictObject({
 	...redactedBase,
 	type: zod_v4.literal("multiple-choice"),
+	instructions: zod_v4.string().optional(),
 	question: zod_v4.string().min(1),
 	questionHtml: zod_v4.string().optional(),
 	mode: zod_v4.enum(["single", "multi"]),
@@ -4652,6 +4647,7 @@ const RedactedBlankConfigSchema = zod_v4.strictObject({
 const RedactedFillInTheBlanksDataSchema = zod_v4.strictObject({
 	...redactedBase,
 	type: zod_v4.literal("fill-in-the-blanks"),
+	instructions: zod_v4.string().optional(),
 	passage: zod_v4.string().min(1),
 	passageHtml: zod_v4.string().optional(),
 	blanks: zod_v4.array(RedactedBlankConfigSchema).min(1)
@@ -4690,6 +4686,7 @@ const RedactedGapSelectGapSchema = zod_v4.strictObject({
 const RedactedGapSelectDataSchema = zod_v4.strictObject({
 	...redactedBase,
 	type: zod_v4.literal("gap-select"),
+	instructions: zod_v4.string().optional(),
 	passage: zod_v4.string().min(1),
 	passageHtml: zod_v4.string().optional(),
 	gaps: zod_v4.array(RedactedGapSelectGapSchema).min(1),
@@ -4815,8 +4812,7 @@ const RedactedReadAloudDataSchema = zod_v4.strictObject({
 		path: ["slowMedia", "url"]
 	});
 });
-//#endregion
-//#region src/scoring/activity-scorers/dictation.ts
+// src/scoring/activity-scorers/dictation.ts
 /**
 * Scores a Dictation response: the character-level similarity of what the
 * learner typed to the transcript, over the whole sentence.
@@ -4855,8 +4851,7 @@ function scoreDictation(data, response) {
 		details
 	};
 }
-//#endregion
-//#region src/scoring/activity-scorers/gap-select.ts
+// src/scoring/activity-scorers/gap-select.ts
 /**
 * The choices a gap offers: its own list, or the bank it names.
 *
@@ -4910,8 +4905,7 @@ function scoreGapSelect(data, response) {
 		details
 	};
 }
-//#endregion
-//#region src/scoring/activity-scorers/multiple-choice.ts
+// src/scoring/activity-scorers/multiple-choice.ts
 /**
 * Scores a Multiple Choice response. Pure; trusts its typed inputs (validation
 * is the component boundary's job). Options are looked up by id; an unknown
@@ -4955,8 +4949,7 @@ function scoreMultipleChoice(data, response) {
 		details
 	};
 }
-//#endregion
-//#region src/registry/define.ts
+// src/registry/define.ts
 /**
 * Identity helper that gives full type inference when authoring a descriptor:
 *
@@ -4971,8 +4964,7 @@ function scoreMultipleChoice(data, response) {
 function defineActivityType(descriptor) {
 	return descriptor;
 }
-//#endregion
-//#region src/registry/keep-when.ts
+// 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
@@ -4997,8 +4989,22 @@ function keepWhen(policy, test) {
 function guardOf(policy) {
 	return policy[KEEP_WHEN];
 }
-//#endregion
-//#region src/registry/builtins.ts
+// 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
@@ -5019,10 +5025,11 @@ function guardOf(policy) {
 * 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",
@@ -5043,7 +5050,9 @@ const MEDIA_FIELD_POLICY = {
 		seek: "public",
 		rate: "public",
 		nativeControlHints: "public"
-	}
+	},
+	transcript: "author-only",
+	script: "author-only"
 };
 const SHARED_PUBLIC_FIELDS = {
 	schemaVersion: "public",
@@ -5098,6 +5107,7 @@ const TEXT_MATCH_FIELD_POLICY = {
 };
 const MULTIPLE_CHOICE_FIELD_POLICY = {
 	...SHARED_PUBLIC_FIELDS,
+	instructions: "public",
 	question: "public",
 	questionHtml: "public",
 	mode: "public",
@@ -5113,7 +5123,9 @@ const MULTIPLE_CHOICE_FIELD_POLICY = {
 			type: "public",
 			url: "public",
 			alt: "public",
-			captionsUrl: "public"
+			captionsUrl: "public",
+			transcript: "author-only",
+			script: "author-only"
 		}
 	}
 };
@@ -5130,6 +5142,7 @@ const MULTIPLE_CHOICE_FIELD_POLICY = {
 */
 const GAP_SELECT_FIELD_POLICY = {
 	...SHARED_PUBLIC_FIELDS,
+	instructions: "public",
 	passage: "public",
 	passageHtml: "public",
 	presentation: "public",
@@ -5156,6 +5169,7 @@ const GAP_SELECT_FIELD_POLICY = {
 };
 const FILL_IN_THE_BLANKS_FIELD_POLICY = {
 	...SHARED_PUBLIC_FIELDS,
+	instructions: "public",
 	passage: "public",
 	passageHtml: "public",
 	scoringStrategy: "answer-key",
@@ -5253,7 +5267,8 @@ const multipleChoiceType = defineActivityType({
 		"option-deselected",
 		"submitted"
 	],
-	authoring: multipleChoiceAuthoring
+	authoring: multipleChoiceAuthoring,
+	mediaSlots: multipleChoiceMediaSlots
 });
 /** Built-in Fill-in-the-Blanks descriptor. */
 const fillInTheBlanksType = defineActivityType({
@@ -5276,7 +5291,8 @@ const fillInTheBlanksType = defineActivityType({
 		"hint-requested",
 		"submitted"
 	],
-	authoring: fillInTheBlanksAuthoring
+	authoring: fillInTheBlanksAuthoring,
+	mediaSlots: () => MAIN_MEDIA
 });
 /**
 * Built-in Written Response descriptor. Grading is DEFERRED: submissions are
@@ -5308,7 +5324,8 @@ const writtenResponseType = defineActivityType({
 		correctResponsesPattern: () => []
 	},
 	interactions: ["text-changed", "submitted"],
-	authoring: writtenResponseAuthoring
+	authoring: writtenResponseAuthoring,
+	mediaSlots: () => MAIN_MEDIA
 });
 /** Built-in Gap Select descriptor. */
 const gapSelectType = defineActivityType({
@@ -5327,7 +5344,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
@@ -5354,7 +5372,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.
@@ -5435,7 +5454,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
@@ -5452,8 +5472,7 @@ const BUILT_IN_DESCRIPTORS = {
 	dictation: dictationType,
 	"read-aloud": readAloudType
 };
-//#endregion
-//#region src/schemas/read-schema.ts
+// src/schemas/read-schema.ts
 /**
 * How every entry point reads a schema — `validateActivity`, `validateDraft`,
 * `validateItemGroup`, `redact`, `assertRedacted` — so a schema is read one way
@@ -5563,14 +5582,13 @@ 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
-//#region src/registry/registry.ts
+// src/registry/registry.ts
 /**
 * Module-scoped default registry (deliberate — no registry instances until a
 * second consumer exists), created holding the SDK's own types.
@@ -5616,7 +5634,6 @@ function getActivityTypeDescriptor(type) {
 function registeredActivityTypes() {
 	return [...registry.keys()];
 }
-//#endregion
 Object.defineProperty(exports, "ActivitySchemaError", {
 	enumerable: true,
 	get: function() {
@@ -5773,6 +5790,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() {
@@ -5791,6 +5814,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() {
@@ -5887,6 +5916,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() {
@@ -6092,4 +6127,4 @@ Object.defineProperty(exports, "writtenResponseType", {
 	}
 });
 
-//# sourceMappingURL=registry-Ce00A_OW.cjs.map
+//# sourceMappingURL=registry-hzrkTeIT.cjs.map