@intellectif/lk-core 0.14.1 → 0.16.0

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

@@ -953,11 +953,43 @@ var MediaPlaybackSchema = _v4.z.strictObject({
   /** 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 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,
@@ -968,7 +1000,7 @@ var MediaSchema = _v4.z.looseObject({
 ).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((m) => m.playback === void 0 || m.type === "audio", {
+}).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(
@@ -998,6 +1030,8 @@ var RedactedMediaSchema = _v4.z.strictObject({
   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,
@@ -1008,7 +1042,7 @@ var RedactedMediaSchema = _v4.z.strictObject({
 ).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/dictation.ts
 
@@ -1174,10 +1208,10 @@ var DictationDataSchema = DictationDataShape.check(
     }
     for (const field of ["media", "slowMedia"]) {
       const recording = data[field];
-      if (_optionalChain([recording, 'optionalAccess', _48 => _48.captionsUrl]) !== void 0) {
+      for (const captions of captionFieldsOf(recording)) {
         report(
-          [field, "captionsUrl"],
-          recording.captionsUrl,
+          [field, captions],
+          _optionalChain([recording, 'optionalAccess', _48 => _48[captions]]),
           "A dictation recording cannot carry captions: the captions are the answer. Offer an accessible alternative as a different item."
         );
       }
@@ -1213,17 +1247,32 @@ var DictationDataSchema = DictationDataShape.check(
     }
   })
 );
-function groupCaptionsRevealDictation(group, hasCaptions = (captionsUrl) => captionsUrl !== void 0) {
-  const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-  if (!isObject(group) || !isObject(group.stimulus) || !isObject(group.stimulus.media)) {
-    return false;
+var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function captionFieldsOf(media, written = (captionsUrl) => captionsUrl !== void 0) {
+  if (!isObject(media)) {
+    return [];
   }
-  if (!hasCaptions(group.stimulus.media.captionsUrl) || !Array.isArray(group.items)) {
-    return false;
+  const fields = [];
+  if (written(media.captionsUrl)) {
+    fields.push("captionsUrl");
+  }
+  if (Array.isArray(media.tracks) && media.tracks.length > 0) {
+    fields.push("tracks");
   }
-  return group.items.some(
+  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.";
 
@@ -1757,12 +1806,12 @@ var RedactedDictationDataSchema = _v4.z.strictObject({
   hints: _v4.z.strictObject({ mode: _v4.z.literal("progressive-words") }).optional()
 }).check((ctx) => {
   const data = ctx.value;
-  if (_optionalChain([data, 'access', _65 => _65.media, 'optionalAccess', _66 => _66.captionsUrl]) !== void 0) {
+  for (const captions of captionFieldsOf(data.media)) {
     ctx.issues.push({
       code: "custom",
-      input: data.media.captionsUrl,
+      input: _optionalChain([data, 'access', _65 => _65.media, 'optionalAccess', _66 => _66[captions]]),
       message: "A dictation recording cannot carry captions: the captions are the answer, so this payload is not learner-safe.",
-      path: ["media", "captionsUrl"]
+      path: ["media", captions]
     });
   }
   if (data.slowMedia !== void 0 && _optionalChain([data, 'access', _67 => _67.media, 'optionalAccess', _68 => _68.playback, 'optionalAccess', _69 => _69.maxPlays]) !== void 0) {
@@ -2203,6 +2252,21 @@ var DRAFT_ISSUE_SEVERITY = {
   ig_item_type_unknown: "invalid",
   ig_item_nested_group: "invalid",
   ig_shuffle_invalid: "invalid",
+  // interactive video (an item group with a timeline)
+  ig_timeline_stimulus_kind: "invalid",
+  ig_timeline_shuffle: "invalid",
+  ig_timeline_quiz_id_required: "incomplete",
+  ig_timeline_quiz_id_duplicate: "invalid",
+  ig_timeline_quiz_time_required: "incomplete",
+  ig_timeline_quiz_time_invalid: "invalid",
+  ig_timeline_quiz_empty: "incomplete",
+  ig_timeline_quiz_unknown_item: "invalid",
+  ig_timeline_item_duplicate: "invalid",
+  ig_timeline_item_unplaced: "incomplete",
+  ig_timeline_item_type: "invalid",
+  ig_timeline_dictation_media: "incomplete",
+  ig_timeline_chapter_order: "invalid",
+  ig_timeline_chapter_title: "incomplete",
   // gap-select
   gs_passage_required: "incomplete",
   gs_gaps_required: "incomplete",
@@ -2607,10 +2671,8 @@ function checkRecording(media) {
       )
     );
   }
-  if (!isUnset(media.captionsUrl)) {
-    issues.push(
-      issue("dc_captions_not_allowed", ["media", "captionsUrl"], CAPTIONS_ARE_THE_ANSWER)
-    );
+  for (const captions of captionFieldsOf(media, (captionsUrl) => !isUnset(captionsUrl))) {
+    issues.push(issue("dc_captions_not_allowed", ["media", captions], CAPTIONS_ARE_THE_ANSWER));
   }
   return issues;
 }
@@ -2635,10 +2697,8 @@ function checkSlowRecording(draft) {
       DictationSlowMediaSchema
     )
   );
-  if (!isUnset(slow.captionsUrl)) {
-    issues.push(
-      issue("dc_captions_not_allowed", ["slowMedia", "captionsUrl"], CAPTIONS_ARE_THE_ANSWER)
-    );
+  for (const captions of captionFieldsOf(slow, (captionsUrl) => !isUnset(captionsUrl))) {
+    issues.push(issue("dc_captions_not_allowed", ["slowMedia", captions], CAPTIONS_ARE_THE_ANSWER));
   }
   if (slow.playback !== void 0) {
     issues.push(
@@ -3984,6 +4044,15 @@ var MEDIA_FIELD_POLICY = {
   url: "public",
   alt: "public",
   captionsUrl: "public",
+  poster: "public",
+  // Applies to every element of the array.
+  tracks: {
+    kind: "public",
+    src: "public",
+    srclang: "public",
+    label: "public",
+    default: "public"
+  },
   playback: {
     controls: "public",
     maxPlays: "public",
@@ -4367,5 +4436,6 @@ 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.MediaSchema = MediaSchema; exports.RedactedMediaSchema = RedactedMediaSchema; exports.DictationSlowMediaSchema = DictationSlowMediaSchema; exports.DictationEquivalenceSchema = DictationEquivalenceSchema; exports.DictationToleranceSchema = DictationToleranceSchema; exports.DictationDataSchema = DictationDataSchema; exports.groupCaptionsRevealDictation = groupCaptionsRevealDictation; 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-VCXIPLEW.cjs.map
+
+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