@intellectif/lk-core 0.16.0 → 0.17.0

package/dist/{chunk-F7UOLKWV.cjs → chunk-D4TOPSHV.cjs}

@@ -1,42 +1,205 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/errors.ts
-var ActivitySchemaError = class extends Error {
-  constructor(activityType, errors) {
-    super(`Invalid activity data for type "${activityType}"`);
-    this.activityType = activityType;
-    this.errors = errors;
-    this.name = "ActivitySchemaError";
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/schemas/ai.ts
+var _v4 = require('zod/v4');
+var AiPermissionsSchema = _v4.z.looseObject({
+  explanations: _v4.z.boolean().optional(),
+  hints: _v4.z.boolean().optional()
+});
+
+// src/schemas/feedback.ts
+
+var FeedbackSchema = _v4.z.looseObject({
+  correct: _v4.z.string().min(1).optional(),
+  incorrect: _v4.z.string().min(1).optional()
+});
+
+// src/schemas/media.ts
+
+var MediaUrlSchema = _v4.z.union([
+  _v4.z.url().refine((value) => /^(https?|data|blob):/i.test(value), {
+    error: "Absolute media URLs must use the https:, http:, data:, or blob: scheme."
+  }),
+  _v4.z.string().regex(/^\/(?!\/)\S*$/, {
+    error: 'Relative media URLs must be root-relative (a single leading "/").'
+  })
+]);
+var NativeControlHintSchema = _v4.z.enum(["hide-download", "hide-rate"]);
+var MediaPlaybackSchema = _v4.z.strictObject({
+  /**
+   * `native` (the resolved default) renders today's `<audio controls>`
+   * unchanged. `minimal` — resolved automatically whenever any enforcement
+   * field is set — replaces the browser bar with the SDK transport:
+   * play/pause, elapsed/total, mute, volume, optional speed, optional
+   * scrubber, and a live plays-remaining status.
+   */
+  controls: _v4.z.enum(["native", "minimal"]).optional(),
+  /**
+   * How many times the recording may be STARTED. A play is consumed when
+   * playback begins from anywhere other than where it last stopped, so
+   * pausing, resuming, and paging between the questions of one listening
+   * group are all free. Enforced in `practice` and `exam`; never in `review`.
+   */
+  maxPlays: _v4.z.number().int().min(1).max(20).optional(),
+  /** `none` renders no scrubber and reverts an out-of-band seek to the high-water mark. */
+  seek: _v4.z.enum(["allow", "none"]).optional(),
+  /** `fixed` renders no speed control and snaps `playbackRate` back to 1. */
+  rate: _v4.z.enum(["allow", "fixed"]).optional(),
+  /** Advisory only. See {@link NativeControlHintSchema}. */
+  nativeControlHints: _v4.z.array(NativeControlHintSchema).min(1).max(2).optional()
+});
+var MediaTrackSchema = _v4.z.strictObject({
+  kind: _v4.z.enum(["captions", "subtitles"]),
+  src: MediaUrlSchema,
+  srclang: _v4.z.string().regex(/^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$/, {
+    error: 'srclang must be a BCP 47 language tag, such as "en", "es" or "pt-BR".'
+  }),
+  label: _v4.z.string().max(60).refine((label) => label.trim().length > 0, { error: "A track label must not be empty." }),
+  default: _v4.z.boolean().optional()
+});
+var MAX_TRACKS = 12;
+function posterFits(m) {
+  return m.poster === void 0 || m.type === "video";
+}
+function tracksFit(m) {
+  return m.tracks === void 0 || m.type === "audio" || m.type === "video";
+}
+function tracksAreDistinct(m) {
+  if (m.tracks === void 0) {
+    return true;
   }
-  
-  
+  const defaults = m.tracks.filter((track) => track.default === true).length;
+  const keys = new Set(m.tracks.map((track) => `${track.kind}:${track.srclang.toLowerCase()}`));
+  return defaults <= 1 && keys.size === m.tracks.length;
+}
+var POSTER_FITS = { error: "poster is for video media only.", path: ["poster"] };
+var TRACKS_FIT = { error: "tracks are for audio and video media only.", path: ["tracks"] };
+var TRACKS_DISTINCT = {
+  error: "tracks: at most one may be the default, and no two may share a kind and a language \u2014 a menu listing one language twice cannot say which one it plays.",
+  path: ["tracks"]
 };
-var UnknownActivityTypeError = class extends Error {
-  constructor(activityType) {
-    super(`Activity type "${activityType}" is not registered`);
-    this.activityType = activityType;
-    this.name = "UnknownActivityTypeError";
+var MediaSchema = _v4.z.looseObject({
+  type: _v4.z.enum(["image", "audio", "video", "embed"]),
+  url: MediaUrlSchema,
+  alt: _v4.z.string().min(1).optional(),
+  captionsUrl: MediaUrlSchema.optional(),
+  tracks: _v4.z.array(MediaTrackSchema).min(1).max(MAX_TRACKS).optional(),
+  poster: MediaUrlSchema.optional(),
+  playback: MediaPlaybackSchema.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"]
   }
-  
-};
-var RedactedScoringError = class extends Error {
-  constructor(activityType) {
-    super(
-      `Activity data for "${activityType}" carries no answer key (it looks redacted), so it cannot be scored. Score against the full activity data server-side. evaluate() answers this input without throwing, but it never grades it.`
-    );
-    this.activityType = activityType;
-    this.name = "RedactedScoringError";
+).refine((m) => m.type !== "embed" || /^https?:\/\//i.test(m.url), {
+  error: "embed media requires an absolute http(s) provider URL. data:, blob:, and relative URLs are not allowed for embeds \u2014 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).refine((m) => m.playback === void 0 || m.type === "audio", {
+  error: "playback policy is supported on audio media only. An embed is a provider iframe the SDK cannot control at all (it has no reliable JS API for a third-party player); an image has nothing to play; video is deliberately deferred, because a video transport must also own fullscreen and Picture-in-Picture and the SDK will not pretend to govern those yet.",
+  path: ["playback"]
+}).refine(
+  (m) => _optionalChain([m, 'access', _2 => _2.playback, 'optionalAccess', _3 => _3.controls]) !== "native" || m.playback.maxPlays === void 0 && m.playback.seek !== "none" && m.playback.rate !== "fixed",
+  {
+    error: 'controls: "native" cannot carry maxPlays, seek: "none" or rate: "fixed". The browser\'s own bar keeps its play button enabled after a budget is spent, and keeps a scrubber that would move and then silently snap back \u2014 a control that looks operable and does nothing (WCAG 3.2.2 / 4.1.3). Omit `controls` and the SDK transport is used automatically, or use nativeControlHints for a cosmetic hint.',
+    path: ["playback", "controls"]
   }
-  
-};
-var DeferredScoringError = class extends Error {
-  constructor(activityType) {
-    super(
-      `Activity type "${activityType}" is graded asynchronously and has no synchronous score. Use evaluate() \u2014 it returns { status: 'deferred' } for this type.`
-    );
-    this.activityType = activityType;
-    this.name = "DeferredScoringError";
+).refine((m) => _optionalChain([m, 'access', _4 => _4.playback, 'optionalAccess', _5 => _5.maxPlays]) === void 0 || m.playback.seek !== "allow", {
+  error: 'maxPlays cannot be combined with seek: "allow". A play is consumed when playback starts from somewhere other than where it stopped, so scrubbing back mid-play would replay the whole recording without spending anything. Omit `seek` \u2014 it resolves to "none" under a budget.',
+  path: ["playback", "seek"]
+}).refine(
+  (m) => _optionalChain([m, 'access', _6 => _6.playback, 'optionalAccess', _7 => _7.controls]) !== "minimal" || m.playback.maxPlays !== void 0 || m.playback.seek === "none" || m.playback.rate === "fixed",
+  {
+    error: 'controls: "minimal" with nothing to enforce trades the browser\'s localized, familiar control bar for the SDK\'s, and buys nothing. Set maxPlays, seek: "none" or rate: "fixed", or omit `controls`.',
+    path: ["playback", "controls"]
   }
-  
-};
+).refine(
+  (m) => _optionalChain([m, 'access', _8 => _8.playback, 'optionalAccess', _9 => _9.nativeControlHints]) === void 0 || m.playback.controls !== "minimal" && m.playback.maxPlays === void 0 && m.playback.seek !== "none" && m.playback.rate !== "fixed",
+  {
+    error: "nativeControlHints only affects the browser's own control bar, and an enforcing policy replaces that bar with the SDK transport \u2014 so the hints would be silently inert. Use them on an otherwise unrestricted recording, or drop them.",
+    path: ["playback", "nativeControlHints"]
+  }
+);
+var RedactedMediaSchema = _v4.z.strictObject({
+  type: _v4.z.enum(["image", "audio", "video", "embed"]),
+  url: MediaUrlSchema,
+  alt: _v4.z.string().min(1).optional(),
+  captionsUrl: MediaUrlSchema.optional(),
+  tracks: _v4.z.array(MediaTrackSchema).min(1).max(MAX_TRACKS).optional(),
+  poster: MediaUrlSchema.optional(),
+  playback: MediaPlaybackSchema.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"]
+  }
+).refine((m) => m.type !== "embed" || /^https?:\/\//i.test(m.url), {
+  error: "embed media requires an absolute http(s) provider URL. data:, blob:, and relative URLs are not allowed for embeds \u2014 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);
+
+// src/schemas/fill-in-the-blanks.ts
+
+var PLACEHOLDER_RE = /\{\{\s*([^{}]+?)\s*\}\}/g;
+var TextMatchPolicySchema = _v4.z.looseObject({
+  caseSensitive: _v4.z.boolean().optional(),
+  trim: _v4.z.boolean().optional(),
+  normalize: _v4.z.enum(["none", "NFC", "NFKC"]).optional(),
+  foldDiacritics: _v4.z.boolean().optional(),
+  collapseInnerWhitespace: _v4.z.boolean().optional(),
+  ignorePunctuation: _v4.z.boolean().optional(),
+  levenshtein: _v4.z.number().int().min(0).optional(),
+  locale: _v4.z.string().optional()
+});
+var BlankConfigSchema = _v4.z.looseObject({
+  id: _v4.z.string().min(1),
+  acceptedAnswers: _v4.z.array(
+    _v4.z.string().min(1).refine((answer) => answer.trim().length > 0, {
+      error: "Accepted answers must contain non-whitespace characters."
+    })
+  ).min(1),
+  caseSensitive: _v4.z.boolean().optional(),
+  trimWhitespace: _v4.z.boolean().optional(),
+  match: TextMatchPolicySchema.optional(),
+  hint: _v4.z.string().optional(),
+  feedback: _v4.z.string().optional()
+});
+var FillInTheBlanksDataSchema = _v4.z.looseObject({
+  schemaVersion: _v4.z.literal("1.0"),
+  type: _v4.z.literal("fill-in-the-blanks"),
+  id: _v4.z.string().min(1),
+  title: _v4.z.string().min(1),
+  passage: _v4.z.string().min(1),
+  passageHtml: _v4.z.string().optional(),
+  blanks: _v4.z.array(BlankConfigSchema).min(1),
+  scoringStrategy: _v4.z.enum(["all-or-nothing", "partial"]),
+  media: MediaSchema.optional(),
+  feedback: FeedbackSchema.optional(),
+  passThreshold: _v4.z.number().min(0).max(1).optional(),
+  locale: _v4.z.string().optional(),
+  learningObjectives: _v4.z.array(_v4.z.string()).optional(),
+  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional(),
+  ai: AiPermissionsSchema.optional()
+}).refine(
+  (data) => {
+    const placeholderCounts2 = /* @__PURE__ */ new Map();
+    for (const match of data.passage.matchAll(PLACEHOLDER_RE)) {
+      const id = match[1];
+      placeholderCounts2.set(id, (_nullishCoalesce(placeholderCounts2.get(id), () => ( 0))) + 1);
+    }
+    const blankIds = data.blanks.map((blank) => blank.id);
+    if (new Set(blankIds).size !== blankIds.length) {
+      return false;
+    }
+    if (placeholderCounts2.size !== blankIds.length) {
+      return false;
+    }
+    return blankIds.every((id) => placeholderCounts2.get(id) === 1);
+  },
+  {
+    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"]
+  }
+);
 
 // src/validation-scope.ts
 var active = null;
@@ -523,9 +686,9 @@ function keepsInContext(points, index) {
     const after = letterAfter(points, index);
     return before !== void 0 && after !== void 0 && inRanges(before, JOINS_FORWARD) && inRanges(after, JOINS_BACKWARD);
   }
-  const previousPoint = _optionalChain([previous, 'optionalAccess', _2 => _2.codePointAt, 'call', _3 => _3(0)]);
+  const previousPoint = _optionalChain([previous, 'optionalAccess', _10 => _10.codePointAt, 'call', _11 => _11(0)]);
   if (point === MONGOLIAN_VOWEL_SEPARATOR) {
-    return (isMongolianLetterOrMark(previousPoint) || isMongolianSelector(previousPoint)) && isMongolianLetterOrMark(_optionalChain([points, 'access', _4 => _4[index + 1], 'optionalAccess', _5 => _5.codePointAt, 'call', _6 => _6(0)]));
+    return (isMongolianLetterOrMark(previousPoint) || isMongolianSelector(previousPoint)) && isMongolianLetterOrMark(_optionalChain([points, 'access', _12 => _12[index + 1], 'optionalAccess', _13 => _13.codePointAt, 'call', _14 => _14(0)]));
   }
   return isMongolianLetterOrMark(previousPoint);
 }
@@ -690,14 +853,14 @@ function containsPhrase(text, phrase) {
   return false;
 }
 function compileRules(tolerance) {
-  const equivalences = _optionalChain([tolerance, 'optionalAccess', _7 => _7.equivalences]);
+  const equivalences = _optionalChain([tolerance, 'optionalAccess', _15 => _15.equivalences]);
   if (!Array.isArray(equivalences)) {
     return { rules: [], signature: "[]" };
   }
   const rules = [];
   for (const rule of equivalences.slice(0, DICTATION_MAX_EQUIVALENCES)) {
-    const rawFrom = _optionalChain([rule, 'optionalAccess', _8 => _8.from]);
-    const rawTo = _optionalChain([rule, 'optionalAccess', _9 => _9.to]);
+    const rawFrom = _optionalChain([rule, 'optionalAccess', _16 => _16.from]);
+    const rawTo = _optionalChain([rule, 'optionalAccess', _17 => _17.to]);
     if (typeof rawFrom !== "string" || typeof rawTo !== "string" || isLongerThan(rawFrom, DICTATION_MAX_EQUIVALENCE_LENGTH) || isLongerThan(rawTo, DICTATION_MAX_EQUIVALENCE_LENGTH)) {
       continue;
     }
@@ -766,10 +929,10 @@ function scopedMap(key, signature) {
 var PRE_STRIP_TEXTS = /* @__PURE__ */ Symbol("dictation pre-strip texts");
 function boundedPreStrip(text) {
   const memo = scopeCache(PRE_STRIP_TEXTS, () => /* @__PURE__ */ new Map());
-  let result = _optionalChain([memo, 'optionalAccess', _10 => _10.get, 'call', _11 => _11(text)]);
+  let result = _optionalChain([memo, 'optionalAccess', _18 => _18.get, 'call', _19 => _19(text)]);
   if (result === void 0) {
     result = bounded(preStripNormalize(text));
-    _optionalChain([memo, 'optionalAccess', _12 => _12.set, 'call', _13 => _13(text, result)]);
+    _optionalChain([memo, 'optionalAccess', _20 => _20.set, 'call', _21 => _21(text, result)]);
   }
   return result;
 }
@@ -781,8 +944,8 @@ function workingText(text, compiled, preStripped = boundedPreStrip(text)) {
     return preStripped;
   }
   const memo = scopeCache(WORKING_TEXTS, () => /* @__PURE__ */ new Map());
-  let known = _optionalChain([memo, 'optionalAccess', _14 => _14.get, 'call', _15 => _15(compiled.signature)]);
-  const remembered = _optionalChain([known, 'optionalAccess', _16 => _16.get, 'call', _17 => _17(text)]);
+  let known = _optionalChain([memo, 'optionalAccess', _22 => _22.get, 'call', _23 => _23(compiled.signature)]);
+  const remembered = _optionalChain([known, 'optionalAccess', _24 => _24.get, 'call', _25 => _25(text)]);
   if (remembered !== void 0) {
     return remembered;
   }
@@ -820,7 +983,7 @@ function readingOf(written, working) {
   if (source === "") {
     return NOTHING_TO_REVEAL;
   }
-  const long = (_nullishCoalesce(_optionalChain([source, 'access', _18 => _18.match, 'call', _19 => _19(UNSPACED_LETTERS_RE), 'optionalAccess', _20 => _20.length]), () => ( 0))) >= UNSPACED_REVEAL_MIN_CHARACTERS;
+  const long = (_nullishCoalesce(_optionalChain([source, 'access', _26 => _26.match, 'call', _27 => _27(UNSPACED_LETTERS_RE), 'optionalAccess', _28 => _28.length]), () => ( 0))) >= UNSPACED_REVEAL_MIN_CHARACTERS;
   const { before, after } = phraseOf(source, long ? "none" : "visible");
   const forms = [
     writtenStripped,
@@ -883,7 +1046,7 @@ function dictationNormalizer(tolerance) {
 }
 function revealsCandidate(forms, candidate) {
   const memo = scopeCache(REVEALS, () => /* @__PURE__ */ new WeakMap());
-  const known = _optionalChain([memo, 'optionalAccess', _21 => _21.get, 'call', _22 => _22(forms), 'optionalAccess', _23 => _23.get, 'call', _24 => _24(candidate)]);
+  const known = _optionalChain([memo, 'optionalAccess', _29 => _29.get, 'call', _30 => _30(forms), 'optionalAccess', _31 => _31.get, 'call', _32 => _32(candidate)]);
   if (known !== void 0) {
     return known;
   }
@@ -912,137 +1075,236 @@ function searchReveal(forms, candidate) {
   });
 }
 
-// src/schemas/feedback.ts
-var _v4 = require('zod/v4');
-var FeedbackSchema = _v4.z.looseObject({
-  correct: _v4.z.string().min(1).optional(),
-  incorrect: _v4.z.string().min(1).optional()
-});
-
-// src/schemas/media.ts
-
-var MediaUrlSchema = _v4.z.union([
-  _v4.z.url().refine((value) => /^(https?|data|blob):/i.test(value), {
-    error: "Absolute media URLs must use the https:, http:, data:, or blob: scheme."
-  }),
-  _v4.z.string().regex(/^\/(?!\/)\S*$/, {
-    error: 'Relative media URLs must be root-relative (a single leading "/").'
-  })
-]);
-var NativeControlHintSchema = _v4.z.enum(["hide-download", "hide-rate"]);
-var MediaPlaybackSchema = _v4.z.strictObject({
-  /**
-   * `native` (the resolved default) renders today's `<audio controls>`
-   * unchanged. `minimal` — resolved automatically whenever any enforcement
-   * field is set — replaces the browser bar with the SDK transport:
-   * play/pause, elapsed/total, mute, volume, optional speed, optional
-   * scrubber, and a live plays-remaining status.
-   */
-  controls: _v4.z.enum(["native", "minimal"]).optional(),
-  /**
-   * How many times the recording may be STARTED. A play is consumed when
-   * playback begins from anywhere other than where it last stopped, so
-   * pausing, resuming, and paging between the questions of one listening
-   * group are all free. Enforced in `practice` and `exam`; never in `review`.
-   */
-  maxPlays: _v4.z.number().int().min(1).max(20).optional(),
-  /** `none` renders no scrubber and reverts an out-of-band seek to the high-water mark. */
-  seek: _v4.z.enum(["allow", "none"]).optional(),
-  /** `fixed` renders no speed control and snaps `playbackRate` back to 1. */
-  rate: _v4.z.enum(["allow", "fixed"]).optional(),
-  /** Advisory only. See {@link NativeControlHintSchema}. */
-  nativeControlHints: _v4.z.array(NativeControlHintSchema).min(1).max(2).optional()
-});
-var MediaTrackSchema = _v4.z.strictObject({
-  kind: _v4.z.enum(["captions", "subtitles"]),
-  src: MediaUrlSchema,
-  srclang: _v4.z.string().regex(/^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$/, {
-    error: 'srclang must be a BCP 47 language tag, such as "en", "es" or "pt-BR".'
-  }),
-  label: _v4.z.string().max(60).refine((label) => label.trim().length > 0, { error: "A track label must not be empty." }),
-  default: _v4.z.boolean().optional()
-});
-var MAX_TRACKS = 12;
-function posterFits(m) {
-  return m.poster === void 0 || m.type === "video";
+// src/scoring/dictation/edit-distance.ts
+function codePoints(text) {
+  return Array.from(text, (character) => character.codePointAt(0));
 }
-function tracksFit(m) {
-  return m.tracks === void 0 || m.type === "audio" || m.type === "video";
+function editDistance(a, b) {
+  if (a === b) {
+    return 0;
+  }
+  let left = codePoints(a);
+  let right = codePoints(b);
+  if (left.length < right.length) {
+    [left, right] = [right, left];
+  }
+  if (right.length === 0) {
+    return left.length;
+  }
+  let previous = new Uint32Array(right.length + 1);
+  let current = new Uint32Array(right.length + 1);
+  for (let j = 0; j <= right.length; j += 1) {
+    previous[j] = j;
+  }
+  for (let i = 1; i <= left.length; i += 1) {
+    current[0] = i;
+    const leftPoint = left[i - 1];
+    for (let j = 1; j <= right.length; j += 1) {
+      const deletion = previous[j] + 1;
+      const insertion = current[j - 1] + 1;
+      const substitution = previous[j - 1] + (leftPoint === right[j - 1] ? 0 : 1);
+      current[j] = Math.min(deletion, insertion, substitution);
+    }
+    [previous, current] = [current, previous];
+  }
+  return previous[right.length];
 }
-function tracksAreDistinct(m) {
-  if (m.tracks === void 0) {
-    return true;
+function similarity(a, b) {
+  const max = Math.max(codePoints(a).length, codePoints(b).length);
+  return max === 0 ? 0 : (max - editDistance(a, b)) / max;
+}
+
+// src/scoring/dictation/align.ts
+function dictationReferenceWords(data) {
+  return rawCandidates(data).map(
+    (candidate) => tokensOf(normalizeCandidate(candidate, data)).map((word, index) => ({
+      itemId: `w${index + 1}`,
+      word
+    }))
+  );
+}
+function alignDictation(data, text) {
+  const raw = typeof text === "string" ? text : "";
+  const capped = truncateCodePoints(raw, DICTATION_MAX_TEXT_LENGTH);
+  const { text: normalized, cut } = normalizeDictationTextBounded(capped, data.tolerance);
+  const attempt = cutAt(normalized, DICTATION_MAX_TEXT_LENGTH);
+  const truncated = cut || capped.length < raw.length || attempt.length < normalized.length;
+  const candidates = [];
+  rawCandidates(data).forEach((candidate, index) => {
+    const candidateText = normalizeCandidate(candidate, data);
+    if (candidateText !== "") {
+      candidates.push({ index, text: candidateText });
+    }
+  });
+  if (candidates.length === 0) {
+    return { candidateIndex: -1, reference: "", attempt, truncated, similarity: 0, words: [] };
   }
-  const defaults = m.tracks.filter((track) => track.default === true).length;
-  const keys = new Set(m.tracks.map((track) => `${track.kind}:${track.srclang.toLowerCase()}`));
-  return defaults <= 1 && keys.size === m.tracks.length;
+  let chosen = candidates[0];
+  let best = similarity(chosen.text, attempt);
+  for (const candidate of candidates.slice(1)) {
+    const candidateSimilarity = similarity(candidate.text, attempt);
+    if (candidateSimilarity > best) {
+      best = candidateSimilarity;
+      chosen = candidate;
+    }
+  }
+  return {
+    candidateIndex: chosen.index,
+    reference: chosen.text,
+    attempt,
+    truncated,
+    similarity: best,
+    words: alignWords(tokensOf(chosen.text), tokensOf(attempt))
+  };
 }
-var POSTER_FITS = { error: "poster is for video media only.", path: ["poster"] };
-var TRACKS_FIT = { error: "tracks are for audio and video media only.", path: ["tracks"] };
-var TRACKS_DISTINCT = {
-  error: "tracks: at most one may be the default, and no two may share a kind and a language \u2014 a menu listing one language twice cannot say which one it plays.",
-  path: ["tracks"]
+function rawCandidates(data) {
+  return [
+    data.transcript,
+    ...Array.isArray(data.acceptedTranscripts) ? data.acceptedTranscripts.slice(0, DICTATION_MAX_ACCEPTED_TRANSCRIPTS) : []
+  ];
+}
+function normalizeCandidate(candidate, data) {
+  return typeof candidate === "string" ? cutAt(
+    normalizeDictationText(
+      truncateCodePoints(candidate, DICTATION_MAX_TRANSCRIPT_LENGTH),
+      data.tolerance
+    ),
+    DICTATION_MAX_TRANSCRIPT_LENGTH
+  ) : "";
+}
+function cutAt(normalized, max) {
+  const cut = truncateCodePoints(normalized, max);
+  return cut.endsWith(" ") ? cut.slice(0, -1) : cut;
+}
+function tokensOf(normalized) {
+  return normalized === "" ? [] : normalized.split(" ");
+}
+var STEP = {
+  /** A reference element paired with an attempt element — equal or substituted. */
+  pair: 0,
+  /** A reference element the attempt lacks. */
+  missing: 1,
+  /** An attempt element the reference lacks. */
+  extra: 2
 };
-var MediaSchema = _v4.z.looseObject({
-  type: _v4.z.enum(["image", "audio", "video", "embed"]),
-  url: MediaUrlSchema,
-  alt: _v4.z.string().min(1).optional(),
-  captionsUrl: MediaUrlSchema.optional(),
-  tracks: _v4.z.array(MediaTrackSchema).min(1).max(MAX_TRACKS).optional(),
-  poster: MediaUrlSchema.optional(),
-  playback: MediaPlaybackSchema.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"]
+function alignSequences(reference, attempt) {
+  const rows = reference.length;
+  const columns = attempt.length;
+  const width = columns + 1;
+  const steps = new Uint8Array((rows + 1) * width);
+  let previous = new Uint32Array(width);
+  let current = new Uint32Array(width);
+  for (let j2 = 0; j2 <= columns; j2 += 1) {
+    previous[j2] = j2;
+    steps[j2] = STEP.extra;
   }
-).refine((m) => m.type !== "embed" || /^https?:\/\//i.test(m.url), {
-  error: "embed media requires an absolute http(s) provider URL. data:, blob:, and relative URLs are not allowed for embeds \u2014 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).refine((m) => m.playback === void 0 || m.type === "audio", {
-  error: "playback policy is supported on audio media only. An embed is a provider iframe the SDK cannot control at all (it has no reliable JS API for a third-party player); an image has nothing to play; video is deliberately deferred, because a video transport must also own fullscreen and Picture-in-Picture and the SDK will not pretend to govern those yet.",
-  path: ["playback"]
-}).refine(
-  (m) => _optionalChain([m, 'access', _25 => _25.playback, 'optionalAccess', _26 => _26.controls]) !== "native" || m.playback.maxPlays === void 0 && m.playback.seek !== "none" && m.playback.rate !== "fixed",
-  {
-    error: 'controls: "native" cannot carry maxPlays, seek: "none" or rate: "fixed". The browser\'s own bar keeps its play button enabled after a budget is spent, and keeps a scrubber that would move and then silently snap back \u2014 a control that looks operable and does nothing (WCAG 3.2.2 / 4.1.3). Omit `controls` and the SDK transport is used automatically, or use nativeControlHints for a cosmetic hint.',
-    path: ["playback", "controls"]
+  for (let i2 = 1; i2 <= rows; i2 += 1) {
+    current[0] = i2;
+    steps[i2 * width] = STEP.missing;
+    const referenceItem = reference[i2 - 1];
+    for (let j2 = 1; j2 <= columns; j2 += 1) {
+      const paired = previous[j2 - 1] + (referenceItem === attempt[j2 - 1] ? 0 : 1);
+      const missing = previous[j2] + 1;
+      const extra = current[j2 - 1] + 1;
+      const cost = Math.min(paired, missing, extra);
+      current[j2] = cost;
+      steps[i2 * width + j2] = paired === cost ? STEP.pair : missing === cost ? STEP.missing : STEP.extra;
+    }
+    [previous, current] = [current, previous];
   }
-).refine((m) => _optionalChain([m, 'access', _27 => _27.playback, 'optionalAccess', _28 => _28.maxPlays]) === void 0 || m.playback.seek !== "allow", {
-  error: 'maxPlays cannot be combined with seek: "allow". A play is consumed when playback starts from somewhere other than where it stopped, so scrubbing back mid-play would replay the whole recording without spending anything. Omit `seek` \u2014 it resolves to "none" under a budget.',
-  path: ["playback", "seek"]
-}).refine(
-  (m) => _optionalChain([m, 'access', _29 => _29.playback, 'optionalAccess', _30 => _30.controls]) !== "minimal" || m.playback.maxPlays !== void 0 || m.playback.seek === "none" || m.playback.rate === "fixed",
-  {
-    error: 'controls: "minimal" with nothing to enforce trades the browser\'s localized, familiar control bar for the SDK\'s, and buys nothing. Set maxPlays, seek: "none" or rate: "fixed", or omit `controls`.',
-    path: ["playback", "controls"]
+  const path = [];
+  let i = rows;
+  let j = columns;
+  while (i > 0 || j > 0) {
+    const step = steps[i * width + j];
+    if (step === STEP.pair) {
+      i -= 1;
+      j -= 1;
+    } else if (step === STEP.missing) {
+      i -= 1;
+    } else {
+      j -= 1;
+    }
+    path.push({ step, referenceIndex: i, attemptIndex: j });
   }
-).refine(
-  (m) => _optionalChain([m, 'access', _31 => _31.playback, 'optionalAccess', _32 => _32.nativeControlHints]) === void 0 || m.playback.controls !== "minimal" && m.playback.maxPlays === void 0 && m.playback.seek !== "none" && m.playback.rate !== "fixed",
-  {
-    error: "nativeControlHints only affects the browser's own control bar, and an enforcing policy replaces that bar with the SDK transport \u2014 so the hints would be silently inert. Use them on an otherwise unrestricted recording, or drop them.",
-    path: ["playback", "nativeControlHints"]
+  return path.reverse();
+}
+function alignWords(reference, attempt) {
+  const words = [];
+  let ordinal = 0;
+  for (const { step, referenceIndex, attemptIndex } of alignSequences(reference, attempt)) {
+    if (step === STEP.extra) {
+      words.push({
+        reference: "",
+        attempt: attempt[attemptIndex],
+        similarity: 0,
+        status: "extra"
+      });
+      continue;
+    }
+    ordinal += 1;
+    const referenceWord = reference[referenceIndex];
+    if (step === STEP.missing) {
+      words.push({
+        itemId: `w${ordinal}`,
+        reference: referenceWord,
+        attempt: "",
+        similarity: 0,
+        status: "missing"
+      });
+      continue;
+    }
+    const attemptWord = attempt[attemptIndex];
+    words.push({
+      itemId: `w${ordinal}`,
+      reference: referenceWord,
+      attempt: attemptWord,
+      similarity: similarity(referenceWord, attemptWord),
+      status: referenceWord === attemptWord ? "correct" : "incorrect"
+    });
   }
-);
-var RedactedMediaSchema = _v4.z.strictObject({
-  type: _v4.z.enum(["image", "audio", "video", "embed"]),
-  url: MediaUrlSchema,
-  alt: _v4.z.string().min(1).optional(),
-  captionsUrl: MediaUrlSchema.optional(),
-  tracks: _v4.z.array(MediaTrackSchema).min(1).max(MAX_TRACKS).optional(),
-  poster: MediaUrlSchema.optional(),
-  playback: MediaPlaybackSchema.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"]
+  return words;
+}
+
+// src/errors.ts
+var ActivitySchemaError = class extends Error {
+  constructor(activityType, errors) {
+    super(`Invalid activity data for type "${activityType}"`);
+    this.activityType = activityType;
+    this.errors = errors;
+    this.name = "ActivitySchemaError";
   }
-).refine((m) => m.type !== "embed" || /^https?:\/\//i.test(m.url), {
-  error: "embed media requires an absolute http(s) provider URL. data:, blob:, and relative URLs are not allowed for embeds \u2014 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);
+  
+  
+};
+var UnknownActivityTypeError = class extends Error {
+  constructor(activityType) {
+    super(`Activity type "${activityType}" is not registered`);
+    this.activityType = activityType;
+    this.name = "UnknownActivityTypeError";
+  }
+  
+};
+var RedactedScoringError = class extends Error {
+  constructor(activityType) {
+    super(
+      `Activity data for "${activityType}" carries no answer key (it looks redacted), so it cannot be scored. Score against the full activity data server-side. evaluate() answers this input without throwing, but it never grades it.`
+    );
+    this.activityType = activityType;
+    this.name = "RedactedScoringError";
+  }
+  
+};
+var DeferredScoringError = class extends Error {
+  constructor(activityType) {
+    super(
+      `Activity type "${activityType}" is graded asynchronously and has no synchronous score. Use evaluate() \u2014 it returns { status: 'deferred' } for this type.`
+    );
+    this.activityType = activityType;
+    this.name = "DeferredScoringError";
+  }
+  
+};
 
 // src/schemas/dictation.ts
 
@@ -1106,7 +1368,8 @@ var DictationDataShape = _v4.z.looseObject({
   passThreshold: _v4.z.number().min(0).max(1).optional(),
   locale: _v4.z.string().optional(),
   learningObjectives: _v4.z.array(_v4.z.string()).optional(),
-  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional()
+  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional(),
+  ai: AiPermissionsSchema.optional()
 });
 var DictationDataSchema = DictationDataShape.check(
   checkEvenAfterIssues((ctx) => {
@@ -1229,115 +1492,52 @@ var DictationDataSchema = DictationDataShape.check(
     for (const [path, value] of shown) {
       if (value === void 0) {
         continue;
-      }
-      const { tooLong, forms } = normalizer.shown(value);
-      if (tooLong) {
-        report(
-          path,
-          value,
-          `The title and the recording descriptions are searched for the transcript before they are shown: each is at most ${WORKING_LENGTH} characters, before and after the equivalences are applied, and the equivalences may not grow it past that on the way.`
-        );
-      } else if (candidates.some((candidate) => revealsCandidate(forms, candidate))) {
-        report(
-          path,
-          value,
-          'The title and the recording descriptions are shown to the learner before they type: they must not contain the transcript. Describe the recording ("Recording, normal speed"), never transcribe it.'
-        );
-      }
-    }
-  })
-);
-var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-function captionFieldsOf(media, written = (captionsUrl) => captionsUrl !== void 0) {
-  if (!isObject(media)) {
-    return [];
-  }
-  const fields = [];
-  if (written(media.captionsUrl)) {
-    fields.push("captionsUrl");
-  }
-  if (Array.isArray(media.tracks) && media.tracks.length > 0) {
-    fields.push("tracks");
-  }
-  return fields;
-}
-function groupCaptionsField(group, written) {
-  if (!isObject(group) || !isObject(group.stimulus) || !Array.isArray(group.items)) {
-    return void 0;
-  }
-  const [field] = captionFieldsOf(group.stimulus.media, written);
-  if (field === void 0) {
-    return void 0;
-  }
-  const played = group.items.some(
-    (item) => isObject(item) && item.type === "dictation" && item.media === void 0
-  );
-  return played ? field : void 0;
-}
-var 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.";
-
-// src/schemas/fill-in-the-blanks.ts
-
-var PLACEHOLDER_RE = /\{\{\s*([^{}]+?)\s*\}\}/g;
-var TextMatchPolicySchema = _v4.z.looseObject({
-  caseSensitive: _v4.z.boolean().optional(),
-  trim: _v4.z.boolean().optional(),
-  normalize: _v4.z.enum(["none", "NFC", "NFKC"]).optional(),
-  foldDiacritics: _v4.z.boolean().optional(),
-  collapseInnerWhitespace: _v4.z.boolean().optional(),
-  ignorePunctuation: _v4.z.boolean().optional(),
-  levenshtein: _v4.z.number().int().min(0).optional(),
-  locale: _v4.z.string().optional()
-});
-var BlankConfigSchema = _v4.z.looseObject({
-  id: _v4.z.string().min(1),
-  acceptedAnswers: _v4.z.array(
-    _v4.z.string().min(1).refine((answer) => answer.trim().length > 0, {
-      error: "Accepted answers must contain non-whitespace characters."
-    })
-  ).min(1),
-  caseSensitive: _v4.z.boolean().optional(),
-  trimWhitespace: _v4.z.boolean().optional(),
-  match: TextMatchPolicySchema.optional(),
-  hint: _v4.z.string().optional(),
-  feedback: _v4.z.string().optional()
-});
-var FillInTheBlanksDataSchema = _v4.z.looseObject({
-  schemaVersion: _v4.z.literal("1.0"),
-  type: _v4.z.literal("fill-in-the-blanks"),
-  id: _v4.z.string().min(1),
-  title: _v4.z.string().min(1),
-  passage: _v4.z.string().min(1),
-  passageHtml: _v4.z.string().optional(),
-  blanks: _v4.z.array(BlankConfigSchema).min(1),
-  scoringStrategy: _v4.z.enum(["all-or-nothing", "partial"]),
-  media: MediaSchema.optional(),
-  feedback: FeedbackSchema.optional(),
-  passThreshold: _v4.z.number().min(0).max(1).optional(),
-  locale: _v4.z.string().optional(),
-  learningObjectives: _v4.z.array(_v4.z.string()).optional(),
-  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional()
-}).refine(
-  (data) => {
-    const placeholderCounts2 = /* @__PURE__ */ new Map();
-    for (const match of data.passage.matchAll(PLACEHOLDER_RE)) {
-      const id = match[1];
-      placeholderCounts2.set(id, (_nullishCoalesce(placeholderCounts2.get(id), () => ( 0))) + 1);
-    }
-    const blankIds = data.blanks.map((blank) => blank.id);
-    if (new Set(blankIds).size !== blankIds.length) {
-      return false;
-    }
-    if (placeholderCounts2.size !== blankIds.length) {
-      return false;
+      }
+      const { tooLong, forms } = normalizer.shown(value);
+      if (tooLong) {
+        report(
+          path,
+          value,
+          `The title and the recording descriptions are searched for the transcript before they are shown: each is at most ${WORKING_LENGTH} characters, before and after the equivalences are applied, and the equivalences may not grow it past that on the way.`
+        );
+      } else if (candidates.some((candidate) => revealsCandidate(forms, candidate))) {
+        report(
+          path,
+          value,
+          'The title and the recording descriptions are shown to the learner before they type: they must not contain the transcript. Describe the recording ("Recording, normal speed"), never transcribe it.'
+        );
+      }
     }
-    return blankIds.every((id) => placeholderCounts2.get(id) === 1);
-  },
-  {
-    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"]
-  }
+  })
 );
+var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function captionFieldsOf(media, written = (captionsUrl) => captionsUrl !== void 0) {
+  if (!isObject(media)) {
+    return [];
+  }
+  const fields = [];
+  if (written(media.captionsUrl)) {
+    fields.push("captionsUrl");
+  }
+  if (Array.isArray(media.tracks) && media.tracks.length > 0) {
+    fields.push("tracks");
+  }
+  return fields;
+}
+function groupCaptionsField(group, written) {
+  if (!isObject(group) || !isObject(group.stimulus) || !Array.isArray(group.items)) {
+    return void 0;
+  }
+  const [field] = captionFieldsOf(group.stimulus.media, written);
+  if (field === void 0) {
+    return void 0;
+  }
+  const played = group.items.some(
+    (item) => isObject(item) && item.type === "dictation" && item.media === void 0
+  );
+  return played ? field : void 0;
+}
+var 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.";
 
 // src/schemas/multiple-choice.ts
 
@@ -1379,7 +1579,8 @@ var MultipleChoiceDataSchema = _v4.z.looseObject({
   shuffle: _v4.z.boolean().optional(),
   locale: _v4.z.string().optional(),
   learningObjectives: _v4.z.array(_v4.z.string()).optional(),
-  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional()
+  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional(),
+  ai: AiPermissionsSchema.optional()
 }).refine((data) => data.options.some((option) => option.isCorrect), {
   error: "At least one option must be marked correct.",
   path: ["options"]
@@ -1453,7 +1654,8 @@ var ReadAloudDataShape = _v4.z.looseObject({
   passThreshold: _v4.z.number().min(0).max(1).optional(),
   feedback: FeedbackSchema.optional(),
   learningObjectives: _v4.z.array(_v4.z.string()).optional(),
-  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional()
+  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional(),
+  ai: AiPermissionsSchema.optional()
 });
 var ReadAloudDataSchema = ReadAloudDataShape.check(
   checkEvenAfterIssues2((ctx) => {
@@ -1619,7 +1821,8 @@ var GapSelectDataSchema = _v4.z.looseObject({
   passThreshold: _v4.z.number().min(0).max(1).optional(),
   locale: _v4.z.string().optional(),
   learningObjectives: _v4.z.array(_v4.z.string()).optional(),
-  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional()
+  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional(),
+  ai: AiPermissionsSchema.optional()
 }).refine(
   (data) => {
     const ids = (_nullishCoalesce(data.banks, () => ( []))).map((bank) => bank.id);
@@ -1708,7 +1911,8 @@ var WrittenResponseDataSchema = _v4.z.looseObject({
   passThreshold: _v4.z.number().min(0).max(1).optional(),
   locale: _v4.z.string().optional(),
   learningObjectives: _v4.z.array(_v4.z.string()).optional(),
-  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional()
+  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional(),
+  ai: AiPermissionsSchema.optional()
 }).refine((data) => data.maxWords >= data.minWords, {
   error: "maxWords must be greater than or equal to minWords.",
   path: ["maxWords"]
@@ -1728,7 +1932,8 @@ var redactedBase = {
   passThreshold: _v4.z.number().min(0).max(1).optional(),
   locale: _v4.z.string().optional(),
   learningObjectives: _v4.z.array(_v4.z.string()).optional(),
-  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional()
+  difficultyLevel: _v4.z.literal([1, 2, 3, 4, 5]).optional(),
+  ai: _v4.z.strictObject({ explanations: _v4.z.boolean().optional(), hints: _v4.z.boolean().optional() }).optional()
 };
 var RedactedMultipleChoiceOptionMediaSchema = _v4.z.strictObject({
   type: _v4.z.enum(["image", "audio"]),
@@ -1887,197 +2092,6 @@ var RedactedReadAloudDataSchema = _v4.z.strictObject({
   }
 });
 
-// src/scoring/dictation/edit-distance.ts
-function codePoints(text) {
-  return Array.from(text, (character) => character.codePointAt(0));
-}
-function editDistance(a, b) {
-  if (a === b) {
-    return 0;
-  }
-  let left = codePoints(a);
-  let right = codePoints(b);
-  if (left.length < right.length) {
-    [left, right] = [right, left];
-  }
-  if (right.length === 0) {
-    return left.length;
-  }
-  let previous = new Uint32Array(right.length + 1);
-  let current = new Uint32Array(right.length + 1);
-  for (let j = 0; j <= right.length; j += 1) {
-    previous[j] = j;
-  }
-  for (let i = 1; i <= left.length; i += 1) {
-    current[0] = i;
-    const leftPoint = left[i - 1];
-    for (let j = 1; j <= right.length; j += 1) {
-      const deletion = previous[j] + 1;
-      const insertion = current[j - 1] + 1;
-      const substitution = previous[j - 1] + (leftPoint === right[j - 1] ? 0 : 1);
-      current[j] = Math.min(deletion, insertion, substitution);
-    }
-    [previous, current] = [current, previous];
-  }
-  return previous[right.length];
-}
-function similarity(a, b) {
-  const max = Math.max(codePoints(a).length, codePoints(b).length);
-  return max === 0 ? 0 : (max - editDistance(a, b)) / max;
-}
-
-// src/scoring/dictation/align.ts
-function dictationReferenceWords(data) {
-  return rawCandidates(data).map(
-    (candidate) => tokensOf(normalizeCandidate(candidate, data)).map((word, index) => ({
-      itemId: `w${index + 1}`,
-      word
-    }))
-  );
-}
-function alignDictation(data, text) {
-  const raw = typeof text === "string" ? text : "";
-  const capped = truncateCodePoints(raw, DICTATION_MAX_TEXT_LENGTH);
-  const { text: normalized, cut } = normalizeDictationTextBounded(capped, data.tolerance);
-  const attempt = cutAt(normalized, DICTATION_MAX_TEXT_LENGTH);
-  const truncated = cut || capped.length < raw.length || attempt.length < normalized.length;
-  const candidates = [];
-  rawCandidates(data).forEach((candidate, index) => {
-    const candidateText = normalizeCandidate(candidate, data);
-    if (candidateText !== "") {
-      candidates.push({ index, text: candidateText });
-    }
-  });
-  if (candidates.length === 0) {
-    return { candidateIndex: -1, reference: "", attempt, truncated, similarity: 0, words: [] };
-  }
-  let chosen = candidates[0];
-  let best = similarity(chosen.text, attempt);
-  for (const candidate of candidates.slice(1)) {
-    const candidateSimilarity = similarity(candidate.text, attempt);
-    if (candidateSimilarity > best) {
-      best = candidateSimilarity;
-      chosen = candidate;
-    }
-  }
-  return {
-    candidateIndex: chosen.index,
-    reference: chosen.text,
-    attempt,
-    truncated,
-    similarity: best,
-    words: alignWords(tokensOf(chosen.text), tokensOf(attempt))
-  };
-}
-function rawCandidates(data) {
-  return [
-    data.transcript,
-    ...Array.isArray(data.acceptedTranscripts) ? data.acceptedTranscripts.slice(0, DICTATION_MAX_ACCEPTED_TRANSCRIPTS) : []
-  ];
-}
-function normalizeCandidate(candidate, data) {
-  return typeof candidate === "string" ? cutAt(
-    normalizeDictationText(
-      truncateCodePoints(candidate, DICTATION_MAX_TRANSCRIPT_LENGTH),
-      data.tolerance
-    ),
-    DICTATION_MAX_TRANSCRIPT_LENGTH
-  ) : "";
-}
-function cutAt(normalized, max) {
-  const cut = truncateCodePoints(normalized, max);
-  return cut.endsWith(" ") ? cut.slice(0, -1) : cut;
-}
-function tokensOf(normalized) {
-  return normalized === "" ? [] : normalized.split(" ");
-}
-var STEP = {
-  /** A reference element paired with an attempt element — equal or substituted. */
-  pair: 0,
-  /** A reference element the attempt lacks. */
-  missing: 1,
-  /** An attempt element the reference lacks. */
-  extra: 2
-};
-function alignSequences(reference, attempt) {
-  const rows = reference.length;
-  const columns = attempt.length;
-  const width = columns + 1;
-  const steps = new Uint8Array((rows + 1) * width);
-  let previous = new Uint32Array(width);
-  let current = new Uint32Array(width);
-  for (let j2 = 0; j2 <= columns; j2 += 1) {
-    previous[j2] = j2;
-    steps[j2] = STEP.extra;
-  }
-  for (let i2 = 1; i2 <= rows; i2 += 1) {
-    current[0] = i2;
-    steps[i2 * width] = STEP.missing;
-    const referenceItem = reference[i2 - 1];
-    for (let j2 = 1; j2 <= columns; j2 += 1) {
-      const paired = previous[j2 - 1] + (referenceItem === attempt[j2 - 1] ? 0 : 1);
-      const missing = previous[j2] + 1;
-      const extra = current[j2 - 1] + 1;
-      const cost = Math.min(paired, missing, extra);
-      current[j2] = cost;
-      steps[i2 * width + j2] = paired === cost ? STEP.pair : missing === cost ? STEP.missing : STEP.extra;
-    }
-    [previous, current] = [current, previous];
-  }
-  const path = [];
-  let i = rows;
-  let j = columns;
-  while (i > 0 || j > 0) {
-    const step = steps[i * width + j];
-    if (step === STEP.pair) {
-      i -= 1;
-      j -= 1;
-    } else if (step === STEP.missing) {
-      i -= 1;
-    } else {
-      j -= 1;
-    }
-    path.push({ step, referenceIndex: i, attemptIndex: j });
-  }
-  return path.reverse();
-}
-function alignWords(reference, attempt) {
-  const words = [];
-  let ordinal = 0;
-  for (const { step, referenceIndex, attemptIndex } of alignSequences(reference, attempt)) {
-    if (step === STEP.extra) {
-      words.push({
-        reference: "",
-        attempt: attempt[attemptIndex],
-        similarity: 0,
-        status: "extra"
-      });
-      continue;
-    }
-    ordinal += 1;
-    const referenceWord = reference[referenceIndex];
-    if (step === STEP.missing) {
-      words.push({
-        itemId: `w${ordinal}`,
-        reference: referenceWord,
-        attempt: "",
-        similarity: 0,
-        status: "missing"
-      });
-      continue;
-    }
-    const attemptWord = attempt[attemptIndex];
-    words.push({
-      itemId: `w${ordinal}`,
-      reference: referenceWord,
-      attempt: attemptWord,
-      similarity: similarity(referenceWord, attemptWord),
-      status: referenceWord === attemptWord ? "correct" : "incorrect"
-    });
-  }
-  return words;
-}
-
 // src/scoring/text-match.ts
 var COMBINING_MARKS_RE = /\p{M}/gu;
 var PUNCTUATION_RE2 = /\p{P}/gu;
@@ -2202,6 +2216,7 @@ var DRAFT_ISSUE_SEVERITY = {
   scoring_strategy_required: "incomplete",
   pass_threshold_invalid: "invalid",
   difficulty_level_invalid: "invalid",
+  ai_permissions_invalid: "invalid",
   feedback_empty: "incomplete",
   redacted_data: "invalid",
   media_type_required: "incomplete",
@@ -2436,6 +2451,30 @@ function checkSharedOptional(draft) {
       )
     );
   }
+  const ai = draft.ai;
+  if (!isUnset(ai)) {
+    if (!isRecord(ai)) {
+      issues.push(
+        issue(
+          "ai_permissions_invalid",
+          ["ai"],
+          "AI permissions must be an object of on/off flags, such as { hints: false }."
+        )
+      );
+    } else {
+      for (const key of ["explanations", "hints"]) {
+        if (!isUnset(ai[key]) && typeof ai[key] !== "boolean") {
+          issues.push(
+            issue(
+              "ai_permissions_invalid",
+              ["ai", key],
+              "Set this to true or false, or remove it."
+            )
+          );
+        }
+      }
+    }
+  }
   const feedback = draft.feedback;
   if (isRecord(feedback)) {
     for (const key of ["correct", "incorrect"]) {
@@ -4075,7 +4114,11 @@ var SHARED_PUBLIC_FIELDS = {
   passThreshold: "public",
   locale: "public",
   learningObjectives: "public",
-  difficultyLevel: "public"
+  difficultyLevel: "public",
+  // What an author allows AI to do for the item. Public, field by field: a
+  // review that explains an answer must still honour an author who said no,
+  // and an unclassified key parked inside it must not ride along.
+  ai: { explanations: "public", hints: "public" }
 };
 var FEEDBACK_FIELD_POLICY = {
   correct: "answer-key",
@@ -4437,5 +4480,7 @@ registerActivityType(readAloudType);
 
 
 
-exports.ActivitySchemaError = ActivitySchemaError; exports.UnknownActivityTypeError = UnknownActivityTypeError; exports.RedactedScoringError = RedactedScoringError; exports.DeferredScoringError = DeferredScoringError; exports.withValidationScope = withValidationScope; exports.DICTATION_MAX_TRANSCRIPT_LENGTH = DICTATION_MAX_TRANSCRIPT_LENGTH; exports.DICTATION_MAX_TEXT_LENGTH = DICTATION_MAX_TEXT_LENGTH; exports.DICTATION_MAX_EQUIVALENCE_LENGTH = DICTATION_MAX_EQUIVALENCE_LENGTH; exports.DICTATION_MAX_EQUIVALENCES = DICTATION_MAX_EQUIVALENCES; exports.DICTATION_MAX_ACCEPTED_TRANSCRIPTS = DICTATION_MAX_ACCEPTED_TRANSCRIPTS; exports.codePointLength = codePointLength; exports.normalizeDictationText = normalizeDictationText; exports.FeedbackSchema = FeedbackSchema; exports.MediaUrlSchema = MediaUrlSchema; exports.NativeControlHintSchema = NativeControlHintSchema; exports.MediaPlaybackSchema = MediaPlaybackSchema; exports.MediaTrackSchema = MediaTrackSchema; exports.MediaSchema = MediaSchema; exports.RedactedMediaSchema = RedactedMediaSchema; exports.DictationSlowMediaSchema = DictationSlowMediaSchema; exports.DictationEquivalenceSchema = DictationEquivalenceSchema; exports.DictationToleranceSchema = DictationToleranceSchema; exports.DictationDataSchema = DictationDataSchema; exports.groupCaptionsField = groupCaptionsField; exports.GROUP_CAPTIONS_REVEAL_DICTATION = GROUP_CAPTIONS_REVEAL_DICTATION; exports.DRAFT_ISSUE_SEVERITY = DRAFT_ISSUE_SEVERITY; exports.issue = issue; exports.isRecord = isRecord; exports.refusesEmpty = refusesEmpty; exports.isUnset = isUnset; exports.isUnwritten = isUnwritten; exports.isMissingId = isMissingId; exports.checkMedia = checkMedia; exports.covers = covers; exports.pathKey = pathKey; exports.coveredPathsOf = coveredPathsOf; exports.TextMatchPolicySchema = TextMatchPolicySchema; exports.BlankConfigSchema = BlankConfigSchema; exports.FillInTheBlanksDataSchema = FillInTheBlanksDataSchema; exports.MultipleChoiceOptionMediaSchema = MultipleChoiceOptionMediaSchema; exports.MultipleChoiceOptionSchema = MultipleChoiceOptionSchema; exports.MultipleChoiceDataSchema = MultipleChoiceDataSchema; exports.READ_ALOUD_MAX_REFERENCE_LENGTH = READ_ALOUD_MAX_REFERENCE_LENGTH; exports.READ_ALOUD_MAX_SECONDS = READ_ALOUD_MAX_SECONDS; exports.READ_ALOUD_MAX_TAKES = READ_ALOUD_MAX_TAKES; exports.READ_ALOUD_MAX_DIMENSION_WEIGHT = READ_ALOUD_MAX_DIMENSION_WEIGHT; exports.SPEECH_ASSESSMENT_MAX_WORDS = SPEECH_ASSESSMENT_MAX_WORDS; exports.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH = SPEECH_ASSESSMENT_MAX_TEXT_LENGTH; exports.CANONICAL_LOCALE_RE = CANONICAL_LOCALE_RE; exports.ReadAloudSlowMediaSchema = ReadAloudSlowMediaSchema; exports.ReadAloudDataSchema = ReadAloudDataSchema; exports.countWords = countWords; exports.GapSelectChoiceSchema = GapSelectChoiceSchema; exports.GapSelectBankSchema = GapSelectBankSchema; exports.GapSelectGapSchema = GapSelectGapSchema; exports.GapSelectDataSchema = GapSelectDataSchema; exports.WrittenResponseRubricCriterionSchema = WrittenResponseRubricCriterionSchema; exports.WrittenResponseRubricSchema = WrittenResponseRubricSchema; exports.WrittenResponseDataSchema = WrittenResponseDataSchema; exports.RedactedMultipleChoiceOptionMediaSchema = RedactedMultipleChoiceOptionMediaSchema; exports.RedactedMultipleChoiceOptionSchema = RedactedMultipleChoiceOptionSchema; exports.RedactedMultipleChoiceDataSchema = RedactedMultipleChoiceDataSchema; exports.RedactedBlankConfigSchema = RedactedBlankConfigSchema; exports.RedactedFillInTheBlanksDataSchema = RedactedFillInTheBlanksDataSchema; exports.RedactedGapSelectChoiceSchema = RedactedGapSelectChoiceSchema; exports.RedactedGapSelectBankSchema = RedactedGapSelectBankSchema; exports.RedactedGapSelectGapSchema = RedactedGapSelectGapSchema; exports.RedactedGapSelectDataSchema = RedactedGapSelectDataSchema; exports.RedactedWrittenResponseDataSchema = RedactedWrittenResponseDataSchema; exports.RedactedDictationSlowMediaSchema = RedactedDictationSlowMediaSchema; exports.RedactedDictationDataSchema = RedactedDictationDataSchema; exports.RedactedReadAloudDataSchema = RedactedReadAloudDataSchema; exports.dictationReferenceWords = dictationReferenceWords; exports.alignDictation = alignDictation; exports.STEP = STEP; exports.alignSequences = alignSequences; exports.levenshteinDistance = levenshteinDistance; exports.matchText = matchText; exports.defineActivityType = defineActivityType; exports.registerActivityType = registerActivityType; exports.getActivityTypeDescriptor = getActivityTypeDescriptor; exports.registeredActivityTypes = registeredActivityTypes; exports.MEDIA_FIELD_POLICY = MEDIA_FIELD_POLICY; exports.multipleChoiceType = multipleChoiceType; exports.fillInTheBlanksType = fillInTheBlanksType; exports.writtenResponseType = writtenResponseType; exports.gapSelectType = gapSelectType; exports.dictationType = dictationType; exports.readAloudType = readAloudType;
-//# sourceMappingURL=chunk-F7UOLKWV.cjs.map
+
+
+exports.AiPermissionsSchema = AiPermissionsSchema; exports.FeedbackSchema = FeedbackSchema; exports.MediaUrlSchema = MediaUrlSchema; exports.NativeControlHintSchema = NativeControlHintSchema; exports.MediaPlaybackSchema = MediaPlaybackSchema; exports.MediaTrackSchema = MediaTrackSchema; exports.MediaSchema = MediaSchema; exports.RedactedMediaSchema = RedactedMediaSchema; exports.PLACEHOLDER_RE = PLACEHOLDER_RE; exports.TextMatchPolicySchema = TextMatchPolicySchema; exports.BlankConfigSchema = BlankConfigSchema; exports.FillInTheBlanksDataSchema = FillInTheBlanksDataSchema; exports.withValidationScope = withValidationScope; exports.DICTATION_MAX_TRANSCRIPT_LENGTH = DICTATION_MAX_TRANSCRIPT_LENGTH; exports.DICTATION_MAX_TEXT_LENGTH = DICTATION_MAX_TEXT_LENGTH; exports.DICTATION_MAX_EQUIVALENCE_LENGTH = DICTATION_MAX_EQUIVALENCE_LENGTH; exports.DICTATION_MAX_EQUIVALENCES = DICTATION_MAX_EQUIVALENCES; exports.DICTATION_MAX_ACCEPTED_TRANSCRIPTS = DICTATION_MAX_ACCEPTED_TRANSCRIPTS; exports.codePointLength = codePointLength; exports.normalizeDictationText = normalizeDictationText; exports.dictationReferenceWords = dictationReferenceWords; exports.alignDictation = alignDictation; exports.STEP = STEP; exports.alignSequences = alignSequences; exports.ActivitySchemaError = ActivitySchemaError; exports.UnknownActivityTypeError = UnknownActivityTypeError; exports.RedactedScoringError = RedactedScoringError; exports.DeferredScoringError = DeferredScoringError; exports.DictationSlowMediaSchema = DictationSlowMediaSchema; exports.DictationEquivalenceSchema = DictationEquivalenceSchema; exports.DictationToleranceSchema = DictationToleranceSchema; exports.DictationDataSchema = DictationDataSchema; exports.groupCaptionsField = groupCaptionsField; exports.GROUP_CAPTIONS_REVEAL_DICTATION = GROUP_CAPTIONS_REVEAL_DICTATION; exports.DRAFT_ISSUE_SEVERITY = DRAFT_ISSUE_SEVERITY; exports.issue = issue; exports.isRecord = isRecord; exports.refusesEmpty = refusesEmpty; exports.isUnset = isUnset; exports.isUnwritten = isUnwritten; exports.isMissingId = isMissingId; exports.checkMedia = checkMedia; exports.covers = covers; exports.pathKey = pathKey; exports.coveredPathsOf = coveredPathsOf; exports.MultipleChoiceOptionMediaSchema = MultipleChoiceOptionMediaSchema; exports.MultipleChoiceOptionSchema = MultipleChoiceOptionSchema; exports.MultipleChoiceDataSchema = MultipleChoiceDataSchema; exports.READ_ALOUD_MAX_REFERENCE_LENGTH = READ_ALOUD_MAX_REFERENCE_LENGTH; exports.READ_ALOUD_MAX_SECONDS = READ_ALOUD_MAX_SECONDS; exports.READ_ALOUD_MAX_TAKES = READ_ALOUD_MAX_TAKES; exports.READ_ALOUD_MAX_DIMENSION_WEIGHT = READ_ALOUD_MAX_DIMENSION_WEIGHT; exports.SPEECH_ASSESSMENT_MAX_WORDS = SPEECH_ASSESSMENT_MAX_WORDS; exports.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH = SPEECH_ASSESSMENT_MAX_TEXT_LENGTH; exports.CANONICAL_LOCALE_RE = CANONICAL_LOCALE_RE; exports.ReadAloudSlowMediaSchema = ReadAloudSlowMediaSchema; exports.ReadAloudDataSchema = ReadAloudDataSchema; exports.countWords = countWords; exports.GapSelectChoiceSchema = GapSelectChoiceSchema; exports.GapSelectBankSchema = GapSelectBankSchema; exports.GapSelectGapSchema = GapSelectGapSchema; exports.GapSelectDataSchema = GapSelectDataSchema; exports.WrittenResponseRubricCriterionSchema = WrittenResponseRubricCriterionSchema; exports.WrittenResponseRubricSchema = WrittenResponseRubricSchema; exports.WrittenResponseDataSchema = WrittenResponseDataSchema; exports.RedactedMultipleChoiceOptionMediaSchema = RedactedMultipleChoiceOptionMediaSchema; exports.RedactedMultipleChoiceOptionSchema = RedactedMultipleChoiceOptionSchema; exports.RedactedMultipleChoiceDataSchema = RedactedMultipleChoiceDataSchema; exports.RedactedBlankConfigSchema = RedactedBlankConfigSchema; exports.RedactedFillInTheBlanksDataSchema = RedactedFillInTheBlanksDataSchema; exports.RedactedGapSelectChoiceSchema = RedactedGapSelectChoiceSchema; exports.RedactedGapSelectBankSchema = RedactedGapSelectBankSchema; exports.RedactedGapSelectGapSchema = RedactedGapSelectGapSchema; exports.RedactedGapSelectDataSchema = RedactedGapSelectDataSchema; exports.RedactedWrittenResponseDataSchema = RedactedWrittenResponseDataSchema; exports.RedactedDictationSlowMediaSchema = RedactedDictationSlowMediaSchema; exports.RedactedDictationDataSchema = RedactedDictationDataSchema; exports.RedactedReadAloudDataSchema = RedactedReadAloudDataSchema; exports.levenshteinDistance = levenshteinDistance; exports.matchText = matchText; exports.defineActivityType = defineActivityType; exports.registerActivityType = registerActivityType; exports.getActivityTypeDescriptor = getActivityTypeDescriptor; exports.registeredActivityTypes = registeredActivityTypes; exports.MEDIA_FIELD_POLICY = MEDIA_FIELD_POLICY; exports.multipleChoiceType = multipleChoiceType; exports.fillInTheBlanksType = fillInTheBlanksType; exports.writtenResponseType = writtenResponseType; exports.gapSelectType = gapSelectType; exports.dictationType = dictationType; exports.readAloudType = readAloudType;
+//# sourceMappingURL=chunk-D4TOPSHV.cjs.map