@intellectif/lk-core 0.12.0 → 0.13.1

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { ScoredItem } from './scoring.js';
-export { AssessmentScore, AssessmentSectionInput, Band, CompositionPolicy, DEFAULT_PASS_THRESHOLD, PassFailureReason, RoundingMode, RoundingPolicy, SectionScore, classifyBand, composeAssessmentScore, computePassThreshold, evaluate, gte, roundGrade, score } from './scoring.js';
-import { r as ItemOutcome, A as ActivityData, L as LearnerResponse, V as ValidationError, e as ActivityType, a as ActivityDataMap, C as CriterionScore, k as GradeRecord, N as NativeControlHint, c as ActivityMedia, x as ScoringResult, D as DeferredScoringPartial, F as FillInTheBlanksData, f as FillInTheBlanksLearnerResponse, M as MultipleChoiceData, t as MultipleChoiceLearnerResponse, W as WrittenResponseData, E as WrittenResponseLearnerResponse } from './activity-B2QxK15j.js';
-export { b as ActivityFeedback, d as ActivityResult, B as BlankConfig, G as GapSelectBank, g as GapSelectChoice, h as GapSelectData, i as GapSelectGap, j as GapSelectLearnerResponse, l as Grader, m as GraderKind, n as GraderUsage, o as GradingState, I as InlineCorrection, p as InteractionEvent, q as InteractionKind, s as LearnerResponseMap, u as MultipleChoiceOption, v as MultipleChoiceOptionMedia, S as ScoringDetail, w as ScoringOutcome, T as TextMatchPolicy, y as TextMatchResult, z as ValidationResult, H as WrittenResponseRubric, J as WrittenResponseRubricCriterion, X as XAPIActor, K as XAPIConfig, O as XAPIContext, P as XAPIContextActivities, Q as XAPIError, R as XAPIObject, U as XAPIResult, Y as XAPIScore, Z as XAPIStatement, _ as XAPIVerbObject, $ as levenshteinDistance, a0 as matchText } from './activity-B2QxK15j.js';
-import { O as SequenceSlot, S as SequenceEntry, I as ItemGroup } from './index-CRKtWP5G.js';
-export { B as BlankConfigSchema, F as FeedbackSchema, a as FillInTheBlanksDataSchema, G as GapSelectBankSchema, b as GapSelectChoiceSchema, c as GapSelectDataSchema, d as GapSelectGapSchema, e as ItemGroupSchema, M as MediaPlaybackSchema, f as MediaSchema, g as MediaUrlSchema, h as MultipleChoiceDataSchema, i as MultipleChoiceOptionMediaSchema, j as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as RedactedActivity, k as RedactedBlankConfig, l as RedactedBlankConfigSchema, m as RedactedFillInTheBlanksData, n as RedactedFillInTheBlanksDataSchema, o as RedactedGapSelectBank, p as RedactedGapSelectBankSchema, q as RedactedGapSelectChoice, r as RedactedGapSelectChoiceSchema, s as RedactedGapSelectData, t as RedactedGapSelectDataSchema, u as RedactedGapSelectGap, v as RedactedGapSelectGapSchema, w as RedactedItemGroupSchema, x as RedactedMediaSchema, y as RedactedMultipleChoiceData, z as RedactedMultipleChoiceDataSchema, A as RedactedMultipleChoiceOption, C as RedactedMultipleChoiceOptionMedia, D as RedactedMultipleChoiceOptionMediaSchema, E as RedactedMultipleChoiceOptionSchema, H as RedactedStimulus, J as RedactedStimulusSchema, K as RedactedWrittenResponseData, L as RedactedWrittenResponseDataSchema, P as SequenceSlotGroup, Q as Stimulus, T as StimulusKind, U as StimulusSchema, V as TextMatchPolicySchema, W as WrittenResponseDataSchema, X as WrittenResponseRubricCriterionSchema, Y as WrittenResponseRubricSchema, Z as fillInTheBlanksJsonSchema, _ as gapSelectJsonSchema, $ as itemGroupJsonSchema, a0 as jsonSchemaFor, a1 as multipleChoiceJsonSchema, a2 as stimulusJsonSchema, a3 as validateActivity, a4 as validateItemGroup, a5 as writtenResponseJsonSchema } from './index-CRKtWP5G.js';
+export { AssessmentScore, AssessmentSectionInput, Band, CompositionPolicy, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, DictationAlignment, DictationCharOp, DictationReference, DictationWordAlignment, PassFailureReason, RoundingMode, RoundingPolicy, ScoringOptions, SectionScore, alignDictation, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, gte, roundGrade, score } from './scoring.js';
+import { w as ItemOutcome, A as ActivityData, L as LearnerResponse, V as ValidationError, e as ActivityType, a as ActivityDataMap, C as CriterionScore, p as GradeRecord, N as NativeControlHint, c as ActivityMedia, K as ScoringResult, D as DeferredScoringPartial, f as DictationData, h as DictationLearnerResponse, F as FillInTheBlanksData, k as FillInTheBlanksLearnerResponse, m as GapSelectData, o as GapSelectLearnerResponse, y as MultipleChoiceData, z as MultipleChoiceLearnerResponse, W as WrittenResponseData, Q as WrittenResponseLearnerResponse } from './activity-DfAmJ1sl.js';
+export { b as ActivityFeedback, d as ActivityResult, B as BlankConfig, g as DictationEquivalence, i as DictationSlowMedia, j as DictationTolerance, G as GapSelectBank, l as GapSelectChoice, n as GapSelectGap, q as Grader, r as GraderKind, s as GraderUsage, t as GradingState, I as InlineCorrection, u as InteractionEvent, v as InteractionKind, x as LearnerResponseMap, M as MediaPlaybackPolicy, E as MultipleChoiceOption, H as MultipleChoiceOptionMedia, S as ScoringDetail, J as ScoringOutcome, T as TextMatchPolicy, O as TextMatchResult, P as ValidationResult, R as WrittenResponseRubric, U as WrittenResponseRubricCriterion, X as XAPIActor, Y as XAPIConfig, Z as XAPIContext, _ as XAPIContextActivities, $ as XAPIError, a0 as XAPIObject, a1 as XAPIResult, a2 as XAPIScore, a3 as XAPIStatement, a4 as XAPIVerbObject, a5 as levenshteinDistance, a6 as matchText } from './activity-DfAmJ1sl.js';
+import { Y as SequenceSlot, X as SequenceEntry, I as ItemGroup } from './index-BiIvdASA.js';
+export { B as BlankConfigSchema, D as DictationDataSchema, a as DictationEquivalenceSchema, b as DictationSlowMediaSchema, c as DictationToleranceSchema, F as FeedbackSchema, d as FillInTheBlanksDataSchema, G as GapSelectBankSchema, e as GapSelectChoiceSchema, f as GapSelectDataSchema, g as GapSelectGapSchema, h as ItemGroupSchema, M as MediaPlaybackSchema, i as MediaSchema, j as MediaUrlSchema, k as MultipleChoiceDataSchema, l as MultipleChoiceOptionMediaSchema, m as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as RedactedActivity, n as RedactedBlankConfig, o as RedactedBlankConfigSchema, p as RedactedDictationData, q as RedactedDictationDataSchema, r as RedactedDictationSlowMedia, s as RedactedDictationSlowMediaSchema, t as RedactedFillInTheBlanksData, u as RedactedFillInTheBlanksDataSchema, v as RedactedGapSelectBank, w as RedactedGapSelectBankSchema, x as RedactedGapSelectChoice, y as RedactedGapSelectChoiceSchema, z as RedactedGapSelectData, A as RedactedGapSelectDataSchema, C as RedactedGapSelectGap, E as RedactedGapSelectGapSchema, H as RedactedItemGroupSchema, J as RedactedMediaSchema, K as RedactedMultipleChoiceData, L as RedactedMultipleChoiceDataSchema, O as RedactedMultipleChoiceOption, P as RedactedMultipleChoiceOptionMedia, Q as RedactedMultipleChoiceOptionMediaSchema, S as RedactedMultipleChoiceOptionSchema, T as RedactedStimulus, U as RedactedStimulusSchema, V as RedactedWrittenResponseData, W as RedactedWrittenResponseDataSchema, Z as SequenceSlotGroup, _ as Stimulus, $ as StimulusKind, a0 as StimulusSchema, a1 as TextMatchPolicySchema, a2 as WrittenResponseDataSchema, a3 as WrittenResponseRubricCriterionSchema, a4 as WrittenResponseRubricSchema, a5 as dictationJsonSchema, a6 as fillInTheBlanksJsonSchema, a7 as gapSelectJsonSchema, a8 as itemGroupJsonSchema, a9 as jsonSchemaFor, aa as multipleChoiceJsonSchema, ab as stimulusJsonSchema, ac as validateActivity, ad as validateItemGroup, ae as writtenResponseJsonSchema } from './index-BiIvdASA.js';
 import { z } from 'zod/v4';
 export { AnsweredStatementParams, CompletedStatementParams, SubmittedStatementParams, XAPIObjectParams, XAPIStatementParams, XAPIVerb, XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor } from './xapi.js';
 
@@ -413,6 +413,11 @@ declare function createItemGroupDraft(context: DraftContext): ItemGroup;
  *
  * The group is `complete` only when the container passes, every item passes its
  * own schema, and every item is itself `complete`.
+ *
+ * @throws the error a registered item type's `checkDraft` or schema throws, as
+ *   `validateDraft` does for that item on its own. Only an unregistered type is
+ *   turned into an issue: a fault in a type's own code is not a problem with the
+ *   draft, and reporting it as an unknown type would hide it.
  */
 declare function validateItemGroupDraft(draft: unknown): DraftValidationResult<ItemGroup>;
 
@@ -1082,6 +1087,14 @@ declare const fillInTheBlanksType: ActivityTypeDescriptor<FillInTheBlanksData, F
  * count is informational, never trusted.
  */
 declare const writtenResponseType: ActivityTypeDescriptor<WrittenResponseData, WrittenResponseLearnerResponse>;
+/** Built-in Gap Select descriptor. */
+declare const gapSelectType: ActivityTypeDescriptor<GapSelectData, GapSelectLearnerResponse>;
+/**
+ * Built-in Dictation descriptor. Graded synchronously: the score is the
+ * character-level similarity of the typed text to the transcript, a pure
+ * computation identical in a browser and on a server.
+ */
+declare const dictationType: ActivityTypeDescriptor<DictationData, DictationLearnerResponse>;
 
 /**
  * Seeded, deterministic shuffling — the ONE algorithm every presentation-order
@@ -1182,4 +1195,4 @@ interface ThemeTokens {
     '--lk-transition-base': string;
 }
 
-export { ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CriterionScore, DeferredScoringError, DeferredScoringPartial, type DraftComplete, type DraftContext, type DraftIssue, type DraftNotComplete, type DraftSeverity, type DraftValidationResult, type FieldPolicy, FillInTheBlanksData, FillInTheBlanksLearnerResponse, type FlattenSequenceOptions, type GradeFromRubricOptions, GradeRecord, ItemGroup, ItemOutcome, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedPlaybackPolicy, type ResponseDiffEntry, ScoredItem, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, assertRedacted, assertRedactedItemGroup, canonicalJson, contentHash, countWords, createDraft, createItemGroupDraft, defineActivityType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };
+export { ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CriterionScore, DeferredScoringError, DeferredScoringPartial, DictationData, DictationLearnerResponse, type DraftComplete, type DraftContext, type DraftIssue, type DraftNotComplete, type DraftSeverity, type DraftValidationResult, type FieldPolicy, FillInTheBlanksData, FillInTheBlanksLearnerResponse, type FlattenSequenceOptions, GapSelectData, GapSelectLearnerResponse, type GradeFromRubricOptions, GradeRecord, ItemGroup, ItemOutcome, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedPlaybackPolicy, type ResponseDiffEntry, ScoredItem, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, assertRedacted, assertRedactedItemGroup, canonicalJson, contentHash, countWords, createDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };

package/dist/index.js

@@ -3,6 +3,7 @@ import {
   classifyBand,
   composeAssessmentScore,
   computePassThreshold,
+  diffDictationChars,
   evaluate,
   gradeFromRubric,
   gte,
@@ -10,19 +11,20 @@ import {
   outcomeFromGrade,
   roundGrade,
   score
-} from "./chunk-RK2NVTHZ.js";
+} from "./chunk-FGN4LLSP.js";
 import {
   XAPIVerb,
   XAPI_VERB_DISPLAY,
   validateXAPIStatement,
   xAPIBuilder,
   xapiDefinitionFor
-} from "./chunk-UQPNJP2O.js";
+} from "./chunk-PYP3HCRQ.js";
 import {
   ItemGroupSchema,
   RedactedItemGroupSchema,
   RedactedStimulusSchema,
   StimulusSchema,
+  dictationJsonSchema,
   fillInTheBlanksJsonSchema,
   gapSelectJsonSchema,
   itemGroupJsonSchema,
@@ -32,14 +34,24 @@ import {
   validateActivity,
   validateItemGroup,
   writtenResponseJsonSchema
-} from "./chunk-7JMMPE7O.js";
+} from "./chunk-Y36S3X3L.js";
 import {
   ActivitySchemaError,
   BlankConfigSchema,
+  DICTATION_MAX_ACCEPTED_TRANSCRIPTS,
+  DICTATION_MAX_EQUIVALENCES,
+  DICTATION_MAX_EQUIVALENCE_LENGTH,
+  DICTATION_MAX_TEXT_LENGTH,
+  DICTATION_MAX_TRANSCRIPT_LENGTH,
   DRAFT_ISSUE_SEVERITY,
   DeferredScoringError,
+  DictationDataSchema,
+  DictationEquivalenceSchema,
+  DictationSlowMediaSchema,
+  DictationToleranceSchema,
   FeedbackSchema,
   FillInTheBlanksDataSchema,
+  GROUP_CAPTIONS_REVEAL_DICTATION,
   GapSelectBankSchema,
   GapSelectChoiceSchema,
   GapSelectDataSchema,
@@ -53,6 +65,8 @@ import {
   MultipleChoiceOptionSchema,
   NativeControlHintSchema,
   RedactedBlankConfigSchema,
+  RedactedDictationDataSchema,
+  RedactedDictationSlowMediaSchema,
   RedactedFillInTheBlanksDataSchema,
   RedactedGapSelectBankSchema,
   RedactedGapSelectChoiceSchema,
@@ -69,12 +83,18 @@ import {
   WrittenResponseDataSchema,
   WrittenResponseRubricCriterionSchema,
   WrittenResponseRubricSchema,
+  alignDictation,
   checkMedia,
   countWords,
+  coveredPathsOf,
   covers,
   defineActivityType,
+  dictationReferenceWords,
+  dictationType,
   fillInTheBlanksType,
+  gapSelectType,
   getActivityTypeDescriptor,
+  groupCaptionsRevealDictation,
   isMissingId,
   isRecord,
   isUnset,
@@ -83,11 +103,13 @@ import {
   levenshteinDistance,
   matchText,
   multipleChoiceType,
+  pathKey,
   refusesEmpty,
   registerActivityType,
   registeredActivityTypes,
+  withValidationScope,
   writtenResponseType
-} from "./chunk-FVN37GIH.js";
+} from "./chunk-XKKKWKRH.js";
 
 // src/content-hash.ts
 function canonicalJson(value, seen = /* @__PURE__ */ new Set()) {
@@ -616,6 +638,9 @@ function createItemGroupDraft(context) {
   };
 }
 function validateItemGroupDraft(draft) {
+  return withValidationScope(() => validateItemGroupDraftInScope(draft));
+}
+function validateItemGroupDraftInScope(draft) {
   const issues = [];
   if (!isRecord(draft)) {
     issues.push(
@@ -636,6 +661,15 @@ function validateItemGroupDraft(draft) {
     );
   }
   issues.push(...checkItems(draft));
+  if (groupCaptionsRevealDictation(draft, (captionsUrl) => !isUnwritten(captionsUrl))) {
+    issues.push(
+      issue(
+        "dc_captions_not_allowed",
+        ["stimulus", "media", "captionsUrl"],
+        GROUP_CAPTIONS_REVEAL_DICTATION
+      )
+    );
+  }
   const parsed = ItemGroupSchema.safeParse(draft, { reportInput: true });
   if (!parsed.success) {
     for (const schemaIssue of parsed.error.issues) {
@@ -824,7 +858,10 @@ function checkItems(draft) {
     let result;
     try {
       result = validateDraft(item.type, item);
-    } catch {
+    } catch (error) {
+      if (!(error instanceof UnknownActivityTypeError) || error.activityType !== item.type) {
+        throw error;
+      }
       issues.push(
         issue(
           "ig_item_type_unknown",
@@ -848,6 +885,9 @@ function checkItems(draft) {
 
 // src/authoring/index.ts
 function validateDraft(type, draft) {
+  return withValidationScope(() => validateDraftInScope(type, draft));
+}
+function validateDraftInScope(type, draft) {
   const descriptor = getActivityTypeDescriptor(type);
   if (descriptor === void 0) {
     throw new UnknownActivityTypeError(String(type));
@@ -856,10 +896,11 @@ function validateDraft(type, draft) {
   const issues = [...reported];
   const parsed = descriptor.schema.safeParse(draft, { reportInput: true });
   if (!parsed.success) {
+    const covered = coveredPathsOf(reported);
     const reportedEmpty = /* @__PURE__ */ new Set();
     for (const schemaIssue of parsed.error.issues) {
       const path = schemaIssue.path.map(String);
-      if (reported.some((known) => covers(known.path, path))) {
+      if (covered.has(pathKey(path))) {
         continue;
       }
       if (path.length > 0 && refusesEmpty(draft, schemaIssue)) {
@@ -1145,7 +1186,16 @@ export {
   ActivitySchemaError,
   BlankConfigSchema,
   DEFAULT_PASS_THRESHOLD,
+  DICTATION_MAX_ACCEPTED_TRANSCRIPTS,
+  DICTATION_MAX_EQUIVALENCES,
+  DICTATION_MAX_EQUIVALENCE_LENGTH,
+  DICTATION_MAX_TEXT_LENGTH,
+  DICTATION_MAX_TRANSCRIPT_LENGTH,
   DeferredScoringError,
+  DictationDataSchema,
+  DictationEquivalenceSchema,
+  DictationSlowMediaSchema,
+  DictationToleranceSchema,
   FeedbackSchema,
   FillInTheBlanksDataSchema,
   GapSelectBankSchema,
@@ -1161,6 +1211,8 @@ export {
   MultipleChoiceOptionSchema,
   NativeControlHintSchema,
   RedactedBlankConfigSchema,
+  RedactedDictationDataSchema,
+  RedactedDictationSlowMediaSchema,
   RedactedFillInTheBlanksDataSchema,
   RedactedGapSelectBankSchema,
   RedactedGapSelectChoiceSchema,
@@ -1182,6 +1234,7 @@ export {
   WrittenResponseRubricSchema,
   XAPIVerb,
   XAPI_VERB_DISPLAY,
+  alignDictation,
   assertRedacted,
   assertRedactedItemGroup,
   canonicalJson,
@@ -1193,6 +1246,10 @@ export {
   createDraft,
   createItemGroupDraft,
   defineActivityType,
+  dictationJsonSchema,
+  dictationReferenceWords,
+  dictationType,
+  diffDictationChars,
   diffResponses,
   entryKeyOf,
   evaluate,
@@ -1201,6 +1258,7 @@ export {
   fingerprint,
   flattenSequence,
   gapSelectJsonSchema,
+  gapSelectType,
   getActivityTypeDescriptor,
   gradeFromRubric,
   gte,