@intellectif/lk-core 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @intellectif/lk-core
 
+## 0.16.0
+
+### Minor Changes
+
+- 7992fac: A dictation's captions are refused whatever form they take: `tracks` count as captions, as
+  `captionsUrl` always did.
+
+  **This tightens validation.** A dictation whose `media` or `slowMedia` carries a non-empty `tracks`
+  list, and a group whose stimulus carries one while a dictation without its own recording plays that
+  stimulus, were valid until now — and were not safe. A caption track transcribes the words a dictation
+  asks the learner to type; a subtitle track translates them, which gives them away just as surely.
+  Redaction keeps tracks, because on any other recording they are what a learner is meant to see, so
+  before this release such a track reached an exam client.
+
+  `validateActivity`, `validateItemGroup`, `assertRedacted`, `assertRedactedItemGroup`, `redact()` and
+  `redactItemGroup()` now refuse it with the message they give for `captionsUrl`, at `media.tracks`,
+  `slowMedia.tracks` or `stimulus.media.tracks`; `validateDraft` and `validateItemGroupDraft` report
+  `dc_captions_not_allowed` there. With both `captionsUrl` and `tracks` on a group's stimulus, the one
+  refusal stays at `stimulus.media.captionsUrl`, where it has always been. Check stored content before
+  upgrading: remove the tracks, or give the dictation a recording of its own without them.
+
+  Also:
+
+  - `ThemeTokens` gains four optional tokens for the interactive video's caption lines:
+    `--lk-iv-caption-color`, `--lk-iv-caption-secondary-color`, `--lk-iv-caption-secondary-scale` and
+    `--lk-iv-caption-gap`.
+  - The `video-captions-changed` interaction is documented with its new payload: `srclang` for the
+    first caption line and `secondary` for the second, each `null` when none shows.
+
 ## 0.15.0
 
 ### Minor Changes

package/dist/{activity-C7cR8U9n.d.cts → activity-DcxtpX7Z.d.cts}

@@ -1315,7 +1315,11 @@ type InteractionKind = 'option-selected' | 'option-deselected' | 'blank-filled'
  | 'video-quiz-opened'
 /** Interactive video: one question of an open quiz was shown (`cueId`, `slotId`). */
  | 'video-quiz-question-shown' | 'video-quiz-skipped' | 'video-quiz-closed'
-/** Interactive video: captions turned on (the track's `srclang`) or off (`null`). */
+/**
+ * Interactive video: the captions a learner chose. `payload.srclang` is the
+ * primary line's language, or `null` with captions off; `payload.secondary` is
+ * the second line's, or `null` with none showing. Fires when either changes.
+ */
  | 'video-captions-changed' | 'video-fullscreen-changed' | 'video-pip-changed' | (string & {});
 /** Fired by activity components on every discrete learner interaction. */
 interface InteractionEvent {

package/dist/{activity-C7cR8U9n.d.ts → activity-DcxtpX7Z.d.ts}

@@ -1315,7 +1315,11 @@ type InteractionKind = 'option-selected' | 'option-deselected' | 'blank-filled'
  | 'video-quiz-opened'
 /** Interactive video: one question of an open quiz was shown (`cueId`, `slotId`). */
  | 'video-quiz-question-shown' | 'video-quiz-skipped' | 'video-quiz-closed'
-/** Interactive video: captions turned on (the track's `srclang`) or off (`null`). */
+/**
+ * Interactive video: the captions a learner chose. `payload.srclang` is the
+ * primary line's language, or `null` with captions off; `payload.secondary` is
+ * the second line's, or `null` with none showing. Fires when either changes.
+ */
  | 'video-captions-changed' | 'video-fullscreen-changed' | 'video-pip-changed' | (string & {});
 /** Fired by activity components on every discrete learner interaction. */
 interface InteractionEvent {

package/dist/{chunk-5KWF34LJ.cjs → chunk-6P6XK2LI.cjs}

@@ -14,7 +14,7 @@
 
 
 
-var _chunkQFWEF5STcjs = require('./chunk-QFWEF5ST.cjs');
+var _chunkF7UOLKWVcjs = require('./chunk-F7UOLKWV.cjs');
 
 // src/is-redacted.ts
 function isRedacted(data) {
@@ -299,12 +299,12 @@ function composeAssessmentScore(sections, policy) {
 function diffDictationChars(reference, attempt) {
   const referencePoints = Array.from(reference);
   const attemptPoints = Array.from(attempt);
-  return _chunkQFWEF5STcjs.alignSequences.call(void 0, referencePoints, attemptPoints).map(
+  return _chunkF7UOLKWVcjs.alignSequences.call(void 0, referencePoints, attemptPoints).map(
     ({ step, referenceIndex, attemptIndex }) => {
-      if (step === _chunkQFWEF5STcjs.STEP.missing) {
+      if (step === _chunkF7UOLKWVcjs.STEP.missing) {
         return { op: "missing", reference: referencePoints[referenceIndex], attempt: "" };
       }
-      if (step === _chunkQFWEF5STcjs.STEP.extra) {
+      if (step === _chunkF7UOLKWVcjs.STEP.extra) {
         return { op: "extra", reference: "", attempt: attemptPoints[attemptIndex] };
       }
       const referencePoint = referencePoints[referenceIndex];
@@ -326,14 +326,14 @@ function heardTokens(words) {
   const tokens = [];
   let length = 0;
   for (const [wordIndex, word] of words.entries()) {
-    const normalized = _chunkQFWEF5STcjs.normalizeDictationText.call(void 0, word.text);
+    const normalized = _chunkF7UOLKWVcjs.normalizeDictationText.call(void 0, word.text);
     if (normalized === "") {
       continue;
     }
     const inserted = word.error === "insertion";
     for (const text of normalized.split(" ")) {
-      length += _chunkQFWEF5STcjs.codePointLength.call(void 0, text) + (length === 0 ? 0 : 1);
-      if (!inserted && length <= _chunkQFWEF5STcjs.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH) {
+      length += _chunkF7UOLKWVcjs.codePointLength.call(void 0, text) + (length === 0 ? 0 : 1);
+      if (!inserted && length <= _chunkF7UOLKWVcjs.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH) {
         tokens.push({ text, wordIndex });
       }
     }
@@ -384,7 +384,7 @@ var SpeechAssessmentSchema = _v4.z.strictObject({
   assessmentVersion: _v4.z.literal("1.0"),
   status: _v4.z.enum(["assessed", "no_speech"]),
   task: _v4.z.enum(["scripted", "unscripted"]),
-  locale: _v4.z.string().regex(_chunkQFWEF5STcjs.CANONICAL_LOCALE_RE),
+  locale: _v4.z.string().regex(_chunkF7UOLKWVcjs.CANONICAL_LOCALE_RE),
   referenceText: _v4.z.string().max(8e3).optional(),
   recordingKey: _v4.z.string().min(1).max(1024).optional(),
   assessor: AssessorSchema,
@@ -399,7 +399,7 @@ var SpeechAssessmentSchema = _v4.z.strictObject({
   recognizedText: _v4.z.string().max(8e3).optional(),
   miscue: _v4.z.enum(["assessor", "none"]),
   phonemeAlphabet: _v4.z.enum(["ipa", "sapi"]).optional(),
-  words: _v4.z.array(WordSchema).max(_chunkQFWEF5STcjs.SPEECH_ASSESSMENT_MAX_WORDS),
+  words: _v4.z.array(WordSchema).max(_chunkF7UOLKWVcjs.SPEECH_ASSESSMENT_MAX_WORDS),
   prosody: _v4.z.strictObject({ monotoneConfidence: Confidence.optional() }).optional(),
   signal: _v4.z.strictObject({ snrDb: _v4.z.number().optional() }).optional()
 });
@@ -421,21 +421,21 @@ function rawTextLength(words) {
 }
 function totalTextErrors(words) {
   const raw = rawTextLength(words);
-  if (raw > _chunkQFWEF5STcjs.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH) {
+  if (raw > _chunkF7UOLKWVcjs.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH) {
     return [
       {
         path: ["words"],
-        message: `The words of an assessment carry ${raw} characters between them, and at most ${_chunkQFWEF5STcjs.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH} can be aligned against the text of an item.`,
+        message: `The words of an assessment carry ${raw} characters between them, and at most ${_chunkF7UOLKWVcjs.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH} can be aligned against the text of an item.`,
         code: "too_big"
       }
     ];
   }
   const normalized = heardTokens(words).length;
-  if (normalized > _chunkQFWEF5STcjs.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH) {
+  if (normalized > _chunkF7UOLKWVcjs.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH) {
     return [
       {
         path: ["words"],
-        message: `The words of an assessment spell ${normalized} characters between them once they are normalised, and at most ${_chunkQFWEF5STcjs.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH} can be aligned against the text of an item. One character can stand for several.`,
+        message: `The words of an assessment spell ${normalized} characters between them once they are normalised, and at most ${_chunkF7UOLKWVcjs.SPEECH_ASSESSMENT_MAX_TEXT_LENGTH} can be aligned against the text of an item. One character can stand for several.`,
         code: "too_big"
       }
     ];
@@ -505,16 +505,16 @@ function alignReadAloud(data, assessment) {
   return alignValidated(data, checked.data);
 }
 function alignValidated(data, assessment) {
-  const reference = _chunkQFWEF5STcjs.dictationReferenceWords.call(void 0, {
+  const reference = _chunkF7UOLKWVcjs.dictationReferenceWords.call(void 0, {
     transcript: data.referenceText
   })[0];
   const heard = heardTokens(assessment.words).tokens;
   const entries = [];
-  for (const { step, referenceIndex, attemptIndex } of _chunkQFWEF5STcjs.alignSequences.call(void 0, 
+  for (const { step, referenceIndex, attemptIndex } of _chunkF7UOLKWVcjs.alignSequences.call(void 0, 
     reference.map((word) => word.word),
     heard.map((token) => token.text)
   )) {
-    if (step === _chunkQFWEF5STcjs.STEP.extra) {
+    if (step === _chunkF7UOLKWVcjs.STEP.extra) {
       const token2 = heard[attemptIndex];
       entries.push({
         reference: "",
@@ -526,7 +526,7 @@ function alignValidated(data, assessment) {
       continue;
     }
     const referenceWord = reference[referenceIndex];
-    if (step === _chunkQFWEF5STcjs.STEP.missing) {
+    if (step === _chunkF7UOLKWVcjs.STEP.missing) {
       entries.push({
         itemId: referenceWord.itemId,
         reference: referenceWord.word,
@@ -579,7 +579,7 @@ function placeInsertions(assessment, entries) {
       reference: "",
       // Every insertion is accounted for, including one whose text normalises
       // to nothing: a reader of `wordIndex` must find each word it looks for.
-      heard: _chunkQFWEF5STcjs.normalizeDictationText.call(void 0, word.text),
+      heard: _chunkF7UOLKWVcjs.normalizeDictationText.call(void 0, word.text),
       state: "inserted",
       ...accuracyOf(word),
       wordIndex
@@ -616,9 +616,9 @@ function readResponseRecording(value) {
 function spokenWordCount(assessment) {
   const recognized = assessment.recognizedText;
   if (recognized !== void 0 && recognized.trim() !== "") {
-    return _chunkQFWEF5STcjs.countWords.call(void 0, recognized);
+    return _chunkF7UOLKWVcjs.countWords.call(void 0, recognized);
   }
-  return _chunkQFWEF5STcjs.countWords.call(void 0, 
+  return _chunkF7UOLKWVcjs.countWords.call(void 0, 
     assessment.words.filter((word) => word.error !== "omission" && word.error !== "insertion").map((word) => word.text).join(" ")
   );
 }
@@ -642,9 +642,9 @@ function gradeReadAloud(data, response, assessment, options) {
     );
   }
   const rounding = roundingPolicyOf(_optionalChain([options, 'optionalAccess', _6 => _6.rounding]));
-  const parsed = _chunkQFWEF5STcjs.ReadAloudDataSchema.safeParse(data);
+  const parsed = _chunkF7UOLKWVcjs.ReadAloudDataSchema.safeParse(data);
   if (!parsed.success) {
-    throw new (0, _chunkQFWEF5STcjs.ActivitySchemaError)(
+    throw new (0, _chunkF7UOLKWVcjs.ActivitySchemaError)(
       "read-aloud",
       parsed.error.issues.map((issue) => ({
         path: issue.path.map(String),
@@ -654,7 +654,7 @@ function gradeReadAloud(data, response, assessment, options) {
     );
   }
   if (isRedacted(data) || isRedacted(parsed.data)) {
-    throw new (0, _chunkQFWEF5STcjs.RedactedScoringError)("read-aloud");
+    throw new (0, _chunkF7UOLKWVcjs.RedactedScoringError)("read-aloud");
   }
   const item = parsed.data;
   const checkedResponse = readResponseRecording(response);
@@ -807,7 +807,7 @@ function gradeReadAloud(data, response, assessment, options) {
   };
 }
 function referenceWordsOf(data) {
-  return _chunkQFWEF5STcjs.dictationReferenceWords.call(void 0, { transcript: data.referenceText })[0];
+  return _chunkF7UOLKWVcjs.dictationReferenceWords.call(void 0, { transcript: data.referenceText })[0];
 }
 
 // src/scoring/speech/wav.ts
@@ -949,19 +949,19 @@ function outcomeFromUnscorable(result) {
 // src/scoring/index.ts
 function score(activityType, activityData, learnerResponse, options) {
   const rounding = roundingPolicyOf(_optionalChain([options, 'optionalAccess', _9 => _9.rounding]));
-  const descriptor = _chunkQFWEF5STcjs.getActivityTypeDescriptor.call(void 0, activityType);
+  const descriptor = _chunkF7UOLKWVcjs.getActivityTypeDescriptor.call(void 0, activityType);
   if (descriptor === void 0) {
-    throw new (0, _chunkQFWEF5STcjs.UnknownActivityTypeError)(String(activityType));
+    throw new (0, _chunkF7UOLKWVcjs.UnknownActivityTypeError)(String(activityType));
   }
   if (descriptor.scoring.kind === "deferred") {
-    throw new (0, _chunkQFWEF5STcjs.DeferredScoringError)(descriptor.type);
+    throw new (0, _chunkF7UOLKWVcjs.DeferredScoringError)(descriptor.type);
   }
   if (isRedacted(activityData)) {
-    throw new (0, _chunkQFWEF5STcjs.RedactedScoringError)(descriptor.type);
+    throw new (0, _chunkF7UOLKWVcjs.RedactedScoringError)(descriptor.type);
   }
   const result = descriptor.scoring.score(activityData, learnerResponse);
   if (!Number.isFinite(result.score)) {
-    throw new (0, _chunkQFWEF5STcjs.RedactedScoringError)(descriptor.type);
+    throw new (0, _chunkF7UOLKWVcjs.RedactedScoringError)(descriptor.type);
   }
   const passed = computePassThreshold(activityData, result.score, rounding);
   return { ...result, passed, feedback: _nullishCoalesce(result.feedback, () => ( selectFeedback(activityData, passed))) };
@@ -969,7 +969,7 @@ function score(activityType, activityData, learnerResponse, options) {
 function evaluate(data, response, options) {
   const rounding = roundingPolicyOf(_optionalChain([options, 'optionalAccess', _10 => _10.rounding]));
   const type = data.type;
-  const descriptor = typeof type === "string" ? _chunkQFWEF5STcjs.getActivityTypeDescriptor.call(void 0, type) : void 0;
+  const descriptor = typeof type === "string" ? _chunkF7UOLKWVcjs.getActivityTypeDescriptor.call(void 0, type) : void 0;
   if (descriptor === void 0) {
     return {
       status: "unscorable",
@@ -1031,4 +1031,4 @@ function evaluate(data, response, options) {
 
 
 exports.roundGrade = roundGrade; exports.gte = gte; exports.classifyBand = classifyBand; exports.DEFAULT_PASS_THRESHOLD = DEFAULT_PASS_THRESHOLD; exports.computePassThreshold = computePassThreshold; exports.gradeFromRubric = gradeFromRubric; exports.outcomeFromGrade = outcomeFromGrade; exports.hasGrade = hasGrade; exports.composeAssessmentScore = composeAssessmentScore; exports.diffDictationChars = diffDictationChars; exports.validateSpeechAssessment = validateSpeechAssessment; exports.alignReadAloud = alignReadAloud; exports.gradeReadAloud = gradeReadAloud; exports.inspectWav = inspectWav; exports.outcomeFromUnscorable = outcomeFromUnscorable; exports.score = score; exports.evaluate = evaluate;
-//# sourceMappingURL=chunk-5KWF34LJ.cjs.map
+//# sourceMappingURL=chunk-6P6XK2LI.cjs.map