@intellectif/lk-core 0.12.0 → 0.13.1

package/dist/{index-CRKtWP5G.d.ts → index-BiIvdASA.d.ts}

@@ -1,4 +1,4 @@
-import { A as ActivityData, c as ActivityMedia, z as ValidationResult, e as ActivityType, a as ActivityDataMap } from './activity-B2QxK15j.js';
+import { A as ActivityData, c as ActivityMedia, P as ValidationResult, e as ActivityType, a as ActivityDataMap } from './activity-DfAmJ1sl.js';
 import { z } from 'zod/v4';
 
 /** What a stimulus primarily is. Drives validation and layout, never scoring. */
@@ -134,6 +134,94 @@ interface SequenceSlot<TItem = ActivityData> {
     group?: SequenceSlotGroup;
 }
 
+/**
+ * Zod schema for the slower second recording of a dictation. Loose like every
+ * content schema (a sidecar survives), audio only, and — deliberately — with no
+ * `captionsUrl` and no `playback` of its own; the activity-level guards below
+ * refuse both if an author writes them anyway.
+ */
+declare const DictationSlowMediaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"audio">;
+    url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+    alt: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/**
+ * Zod schema for one whole-word rewrite rule. Both halves are bounded: `to`
+ * because a rule expands text, `from` because it is compiled into the pattern
+ * every attempt is searched with.
+ */
+declare const DictationEquivalenceSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, z.core.$loose>;
+/** Zod schema for a dictation's grading tolerances. At most `DICTATION_MAX_EQUIVALENCES` rules. */
+declare const DictationToleranceSchema: z.ZodObject<{
+    equivalences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+declare const DictationDataSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    type: z.ZodLiteral<"dictation">;
+    id: z.ZodString;
+    title: z.ZodString;
+    transcript: z.ZodString;
+    acceptedTranscripts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    media: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<{
+            image: "image";
+            audio: "audio";
+            video: "video";
+            embed: "embed";
+        }>;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
+        playback: z.ZodOptional<z.ZodObject<{
+            controls: z.ZodOptional<z.ZodEnum<{
+                native: "native";
+                minimal: "minimal";
+            }>>;
+            maxPlays: z.ZodOptional<z.ZodNumber>;
+            seek: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                allow: "allow";
+            }>>;
+            rate: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                fixed: "fixed";
+            }>>;
+            nativeControlHints: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "hide-download": "hide-download";
+                "hide-rate": "hide-rate";
+            }>>>;
+        }, z.core.$strict>>;
+    }, z.core.$loose>>;
+    slowMedia: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    hints: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodLiteral<"progressive-words">;
+    }, z.core.$loose>>;
+    tolerance: z.ZodOptional<z.ZodObject<{
+        equivalences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+    feedback: z.ZodOptional<z.ZodObject<{
+        correct: z.ZodOptional<z.ZodString>;
+        incorrect: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    passThreshold: z.ZodOptional<z.ZodNumber>;
+    locale: z.ZodOptional<z.ZodString>;
+    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
+}, z.core.$loose>;
+
 /**
  * Optional authored "overall feedback" shown after submission, selected by
  * whether the learner passed (h5p-style overall feedback). Both fields are
@@ -230,8 +318,8 @@ declare const FillInTheBlanksDataSchema: z.ZodObject<{
         feedback: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
     scoringStrategy: z.ZodEnum<{
-        "all-or-nothing": "all-or-nothing";
         partial: "partial";
+        "all-or-nothing": "all-or-nothing";
     }>;
     media: z.ZodOptional<z.ZodObject<{
         type: z.ZodEnum<{
@@ -270,7 +358,7 @@ declare const FillInTheBlanksDataSchema: z.ZodObject<{
     passThreshold: z.ZodOptional<z.ZodNumber>;
     locale: z.ZodOptional<z.ZodString>;
     learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
 }, z.core.$loose>;
 
 /**
@@ -347,8 +435,8 @@ declare const GapSelectDataSchema: z.ZodObject<{
         }, z.core.$loose>>;
     }, z.core.$loose>>>;
     scoringStrategy: z.ZodEnum<{
-        "all-or-nothing": "all-or-nothing";
         partial: "partial";
+        "all-or-nothing": "all-or-nothing";
     }>;
     presentation: z.ZodOptional<z.ZodLiteral<"dropdown">>;
     shuffleChoices: z.ZodOptional<z.ZodBoolean>;
@@ -389,7 +477,7 @@ declare const GapSelectDataSchema: z.ZodObject<{
     passThreshold: z.ZodOptional<z.ZodNumber>;
     locale: z.ZodOptional<z.ZodString>;
     learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
 }, z.core.$loose>;
 
 /**
@@ -566,7 +654,10 @@ declare const RedactedStimulusSchema: z.ZodObject<{
 /**
  * Strict learner-safe item group. Items are left opaque here — each is proven
  * learner-safe by `assertRedacted` against its OWN type's redacted schema,
- * which is the only place that knowledge lives.
+ * which is the only place that knowledge lives. The one exception is the one
+ * rule that spans the container and an item: a captioned stimulus recording
+ * played to a dictation is not learner-safe, because the captions are the
+ * dictation's answer.
  */
 declare const RedactedItemGroupSchema: z.ZodObject<{
     redacted: z.ZodLiteral<true>;
@@ -669,6 +760,17 @@ declare const itemGroupJsonSchema: z.core.JSONSchema.JSONSchema;
  * for the other types.
  */
 declare const gapSelectJsonSchema: z.core.JSONSchema.JSONSchema;
+/**
+ * JSON Schema (Draft 7) representation of the Dictation activity data
+ * contract. Structural contract, plus the raw length caps JSON Schema can
+ * state in code points as zod counts them — `maxLength` 2000 on a transcript
+ * and an accepted transcript, 200 on a rule's `from` and `to`. The twelve
+ * semantic guards — a transcript that survives normalisation, the caps after
+ * equivalences are applied, distinct candidates, audio only, the
+ * slow-recording rules, no captions, no transcript in the title — are
+ * Zod-only, as they are for the other types.
+ */
+declare const dictationJsonSchema: z.core.JSONSchema.JSONSchema;
 declare const multipleChoiceJsonSchema: z.core.JSONSchema.JSONSchema;
 /**
  * JSON Schema (Draft 7) representation of the Fill-in-the-Blanks activity data
@@ -970,8 +1072,8 @@ declare const MultipleChoiceDataSchema: z.ZodObject<{
         }, z.core.$loose>>;
     }, z.core.$loose>>;
     scoringStrategy: z.ZodEnum<{
-        "all-or-nothing": "all-or-nothing";
         partial: "partial";
+        "all-or-nothing": "all-or-nothing";
     }>;
     media: z.ZodOptional<z.ZodObject<{
         type: z.ZodEnum<{
@@ -1011,7 +1113,7 @@ declare const MultipleChoiceDataSchema: z.ZodObject<{
     shuffle: z.ZodOptional<z.ZodBoolean>;
     locale: z.ZodOptional<z.ZodString>;
     learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
 }, z.core.$loose>;
 
 /** A redacted Multiple Choice option: id and display text only — no `isCorrect`, no feedback. */
@@ -1115,7 +1217,7 @@ declare const RedactedMultipleChoiceDataSchema: z.ZodObject<{
     passThreshold: z.ZodOptional<z.ZodNumber>;
     locale: z.ZodOptional<z.ZodString>;
     learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
 }, z.core.$strict>;
 /** A redacted blank: id and hint only — no accepted answers, no matching rules, no feedback. */
 declare const RedactedBlankConfigSchema: z.ZodObject<{
@@ -1171,7 +1273,7 @@ declare const RedactedFillInTheBlanksDataSchema: z.ZodObject<{
     passThreshold: z.ZodOptional<z.ZodNumber>;
     locale: z.ZodOptional<z.ZodString>;
     learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
 }, z.core.$strict>;
 /** A redacted choice: exactly what it always was. Which one is correct was never stored here. */
 declare const RedactedGapSelectChoiceSchema: z.ZodObject<{
@@ -1271,7 +1373,7 @@ declare const RedactedGapSelectDataSchema: z.ZodObject<{
     passThreshold: z.ZodOptional<z.ZodNumber>;
     locale: z.ZodOptional<z.ZodString>;
     learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
 }, z.core.$strict>;
 /**
  * Redacted Written Response data: the prompt, word bounds and rubric are
@@ -1333,7 +1435,78 @@ declare const RedactedWrittenResponseDataSchema: z.ZodObject<{
     passThreshold: z.ZodOptional<z.ZodNumber>;
     locale: z.ZodOptional<z.ZodString>;
     learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
+}, z.core.$strict>;
+/** A redacted slow recording: unchanged — it is public, and it never carried captions or a policy. */
+declare const RedactedDictationSlowMediaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"audio">;
+    url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+    alt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Redacted Dictation data: the recording(s) and the hint mode survive; the
+ * transcript, the accepted alternatives and the tolerance — the whole answer
+ * key — do not. A `progressive-words` hint mode reveals nothing by itself: the
+ * words it would reveal are the transcript, and that is gone.
+ *
+ * Three rules of the content schema are repeated here, because a projection
+ * built by hand never passed through it: captions on the recording ARE the
+ * answer, so a payload carrying them is not learner-safe; a slow recording
+ * beside a play budget is an unbudgeted copy of the budgeted content; and so is
+ * a slow recording with no recording beside it, which in a group sits beside a
+ * stimulus recording that may be budgeted.
+ */
+declare const RedactedDictationDataSchema: z.ZodObject<{
+    type: z.ZodLiteral<"dictation">;
+    slowMedia: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    hints: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodLiteral<"progressive-words">;
+    }, z.core.$strict>>;
+    /** Marker distinguishing a redacted projection from full activity data. */
+    redacted: z.ZodLiteral<true>;
+    /** Slot identity, carried through redaction so the client and the plan agree. */
+    slotKey: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<"1.0">;
+    id: z.ZodString;
+    title: z.ZodString;
+    media: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<{
+            image: "image";
+            audio: "audio";
+            video: "video";
+            embed: "embed";
+        }>;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
+        playback: z.ZodOptional<z.ZodObject<{
+            controls: z.ZodOptional<z.ZodEnum<{
+                native: "native";
+                minimal: "minimal";
+            }>>;
+            maxPlays: z.ZodOptional<z.ZodNumber>;
+            seek: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                allow: "allow";
+            }>>;
+            rate: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                fixed: "fixed";
+            }>>;
+            nativeControlHints: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "hide-download": "hide-download";
+                "hide-rate": "hide-rate";
+            }>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    passThreshold: z.ZodOptional<z.ZodNumber>;
+    locale: z.ZodOptional<z.ZodString>;
+    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
 }, z.core.$strict>;
 /**
  * The learner-safe SHAPE of each built-in type, derived from the strict schema
@@ -1369,6 +1542,10 @@ type RedactedGapSelectBank = z.infer<typeof RedactedGapSelectBankSchema>;
 type RedactedGapSelectGap = z.infer<typeof RedactedGapSelectGapSchema>;
 /** A Gap Select item the learner can still answer: choices intact, answer key gone. */
 type RedactedGapSelectData = z.infer<typeof RedactedGapSelectDataSchema>;
+/** The slower recording of a dictation, unchanged by redaction. */
+type RedactedDictationSlowMedia = z.infer<typeof RedactedDictationSlowMediaSchema>;
+/** A Dictation item with its transcript, accepted alternatives and tolerances removed. */
+type RedactedDictationData = z.infer<typeof RedactedDictationDataSchema>;
 /**
  * Discriminated union of every built-in redacted activity. Narrow it on
  * `type`, exactly as you would {@link ActivityData}:
@@ -1381,7 +1558,7 @@ type RedactedGapSelectData = z.infer<typeof RedactedGapSelectDataSchema>;
  * }
  * ```
  */
-type RedactedActivity = RedactedMultipleChoiceData | RedactedFillInTheBlanksData | RedactedWrittenResponseData | RedactedGapSelectData;
+type RedactedActivity = RedactedMultipleChoiceData | RedactedFillInTheBlanksData | RedactedWrittenResponseData | RedactedGapSelectData | RedactedDictationData;
 
 /** Zod schema for a single rubric criterion. Loose: unknown keys preserved. */
 declare const WrittenResponseRubricCriterionSchema: z.ZodObject<{
@@ -1461,7 +1638,7 @@ declare const WrittenResponseDataSchema: z.ZodObject<{
     passThreshold: z.ZodOptional<z.ZodNumber>;
     locale: z.ZodOptional<z.ZodString>;
     learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<1 | 2 | 3 | 4 | 5>>;
 }, z.core.$loose>;
 
 /**
@@ -1478,4 +1655,4 @@ declare const WrittenResponseDataSchema: z.ZodObject<{
  */
 declare function validateActivity<T extends ActivityType>(type: T, data: unknown): ValidationResult<ActivityDataMap[T]>;
 
-export { itemGroupJsonSchema as $, type RedactedMultipleChoiceOption as A, BlankConfigSchema as B, type RedactedMultipleChoiceOptionMedia as C, RedactedMultipleChoiceOptionMediaSchema as D, RedactedMultipleChoiceOptionSchema as E, FeedbackSchema as F, GapSelectBankSchema as G, type RedactedStimulus as H, type ItemGroup as I, RedactedStimulusSchema as J, type RedactedWrittenResponseData as K, RedactedWrittenResponseDataSchema as L, MediaPlaybackSchema as M, NativeControlHintSchema as N, type SequenceSlot as O, type SequenceSlotGroup as P, type Stimulus as Q, type RedactedActivity as R, type SequenceEntry as S, type StimulusKind as T, StimulusSchema as U, TextMatchPolicySchema as V, WrittenResponseDataSchema as W, WrittenResponseRubricCriterionSchema as X, WrittenResponseRubricSchema as Y, fillInTheBlanksJsonSchema as Z, gapSelectJsonSchema as _, FillInTheBlanksDataSchema as a, jsonSchemaFor as a0, multipleChoiceJsonSchema as a1, stimulusJsonSchema as a2, validateActivity as a3, validateItemGroup as a4, writtenResponseJsonSchema as a5, GapSelectChoiceSchema as b, GapSelectDataSchema as c, GapSelectGapSchema as d, ItemGroupSchema as e, MediaSchema as f, MediaUrlSchema as g, MultipleChoiceDataSchema as h, MultipleChoiceOptionMediaSchema as i, MultipleChoiceOptionSchema as j, type RedactedBlankConfig as k, RedactedBlankConfigSchema as l, type RedactedFillInTheBlanksData as m, RedactedFillInTheBlanksDataSchema as n, type RedactedGapSelectBank as o, RedactedGapSelectBankSchema as p, type RedactedGapSelectChoice as q, RedactedGapSelectChoiceSchema as r, type RedactedGapSelectData as s, RedactedGapSelectDataSchema as t, type RedactedGapSelectGap as u, RedactedGapSelectGapSchema as v, RedactedItemGroupSchema as w, RedactedMediaSchema as x, type RedactedMultipleChoiceData as y, RedactedMultipleChoiceDataSchema as z };
+export { type StimulusKind as $, RedactedGapSelectDataSchema as A, BlankConfigSchema as B, type RedactedGapSelectGap as C, DictationDataSchema as D, RedactedGapSelectGapSchema as E, FeedbackSchema as F, GapSelectBankSchema as G, RedactedItemGroupSchema as H, type ItemGroup as I, RedactedMediaSchema as J, type RedactedMultipleChoiceData as K, RedactedMultipleChoiceDataSchema as L, MediaPlaybackSchema as M, NativeControlHintSchema as N, type RedactedMultipleChoiceOption as O, type RedactedMultipleChoiceOptionMedia as P, RedactedMultipleChoiceOptionMediaSchema as Q, type RedactedActivity as R, RedactedMultipleChoiceOptionSchema as S, type RedactedStimulus as T, RedactedStimulusSchema as U, type RedactedWrittenResponseData as V, RedactedWrittenResponseDataSchema as W, type SequenceEntry as X, type SequenceSlot as Y, type SequenceSlotGroup as Z, type Stimulus as _, DictationEquivalenceSchema as a, StimulusSchema as a0, TextMatchPolicySchema as a1, WrittenResponseDataSchema as a2, WrittenResponseRubricCriterionSchema as a3, WrittenResponseRubricSchema as a4, dictationJsonSchema as a5, fillInTheBlanksJsonSchema as a6, gapSelectJsonSchema as a7, itemGroupJsonSchema as a8, jsonSchemaFor as a9, multipleChoiceJsonSchema as aa, stimulusJsonSchema as ab, validateActivity as ac, validateItemGroup as ad, writtenResponseJsonSchema as ae, DictationSlowMediaSchema as b, DictationToleranceSchema as c, FillInTheBlanksDataSchema as d, GapSelectChoiceSchema as e, GapSelectDataSchema as f, GapSelectGapSchema as g, ItemGroupSchema as h, MediaSchema as i, MediaUrlSchema as j, MultipleChoiceDataSchema as k, MultipleChoiceOptionMediaSchema as l, MultipleChoiceOptionSchema as m, type RedactedBlankConfig as n, RedactedBlankConfigSchema as o, type RedactedDictationData as p, RedactedDictationDataSchema as q, type RedactedDictationSlowMedia as r, RedactedDictationSlowMediaSchema as s, type RedactedFillInTheBlanksData as t, RedactedFillInTheBlanksDataSchema as u, type RedactedGapSelectBank as v, RedactedGapSelectBankSchema as w, type RedactedGapSelectChoice as x, RedactedGapSelectChoiceSchema as y, type RedactedGapSelectData as z };