@intellectif/lk-core 0.7.1 → 0.8.0

package/dist/{index-BfLwCMXN.d.cts → index-Kc53zVgY.d.ts}

@@ -1,4 +1,4 @@
-import { A as ActivityData, c as ActivityMedia, t as ValidationResult, e as ActivityType, a as ActivityDataMap } from './activity-DARHcrz_.cjs';
+import { A as ActivityData, c as ActivityMedia, t as ValidationResult, e as ActivityType, a as ActivityDataMap } from './activity-CPtJUBek.js';
 import { z } from 'zod/v4';
 
 /** What a stimulus primarily is. Drives validation and layout, never scoring. */
@@ -243,6 +243,25 @@ declare const FillInTheBlanksDataSchema: z.ZodObject<{
         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>>;
     feedback: z.ZodOptional<z.ZodObject<{
         correct: z.ZodOptional<z.ZodString>;
@@ -285,6 +304,25 @@ declare const StimulusSchema: z.ZodObject<{
         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>>;
     transcript: z.ZodOptional<z.ZodString>;
     locale: z.ZodOptional<z.ZodString>;
@@ -324,6 +362,25 @@ declare const ItemGroupSchema: z.ZodObject<{
             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>>;
         transcript: z.ZodOptional<z.ZodString>;
         locale: z.ZodOptional<z.ZodString>;
@@ -364,7 +421,26 @@ declare const RedactedStimulusSchema: z.ZodObject<{
         url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
         alt: z.ZodOptional<z.ZodString>;
         captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
-    }, z.core.$loose>>;
+        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>>;
     locale: z.ZodOptional<z.ZodString>;
     attribution: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
@@ -402,7 +478,26 @@ declare const RedactedItemGroupSchema: z.ZodObject<{
             url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
             alt: z.ZodOptional<z.ZodString>;
             captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
-        }, z.core.$loose>>;
+            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>>;
         locale: z.ZodOptional<z.ZodString>;
         attribution: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
@@ -494,6 +589,70 @@ declare function jsonSchemaFor(type: string): Record<string, unknown>;
  * vector in every consuming app.
  */
 declare const MediaUrlSchema: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+/**
+ * Hints to the BROWSER'S OWN control bar, emitted as `controlsList` tokens.
+ *
+ * They remove a button, never a capability, and only in engines that implement
+ * `controlsList` at all. `hide-download` does NOT prevent a download — the URL
+ * is in the page and the bytes are in the network panel. If a recording must
+ * not be kept, issue a short-lived signed URL; that is the consuming
+ * application's control, not the SDK's.
+ *
+ * Meaningful only alongside the native bar: there is nothing to hint at once
+ * the SDK owns the transport.
+ */
+declare const NativeControlHintSchema: z.ZodEnum<{
+    "hide-download": "hide-download";
+    "hide-rate": "hide-rate";
+}>;
+/**
+ * How an audio recording may be played.
+ *
+ * STRICT on purpose: an unknown key here is an authoring error. {@link
+ * MediaSchema} is loose, so without this a typo one level down (`maxPlay`,
+ * `seeking`) would be silently accepted and the whole policy would quietly do
+ * nothing on an exam that believed it was enforced.
+ *
+ * Nothing here is required together with anything else — `{ maxPlays: 2 }` is a
+ * complete, valid policy, because `controls` and `seek` RESOLVE to the only
+ * values that can keep that promise. The refinements below reject only a
+ * combination an author wrote **explicitly** that the renderer cannot honour.
+ */
+declare const MediaPlaybackSchema: z.ZodObject<{
+    /**
+     * `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: z.ZodOptional<z.ZodEnum<{
+        native: "native";
+        minimal: "minimal";
+    }>>;
+    /**
+     * 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: z.ZodOptional<z.ZodNumber>;
+    /** `none` renders no scrubber and reverts an out-of-band seek to the high-water mark. */
+    seek: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        allow: "allow";
+    }>>;
+    /** `fixed` renders no speed control and snaps `playbackRate` back to 1. */
+    rate: z.ZodOptional<z.ZodEnum<{
+        allow: "allow";
+        fixed: "fixed";
+    }>>;
+    /** Advisory only. See {@link NativeControlHintSchema}. */
+    nativeControlHints: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "hide-download": "hide-download";
+        "hide-rate": "hide-rate";
+    }>>>;
+}, z.core.$strict>;
 declare const MediaSchema: z.ZodObject<{
     type: z.ZodEnum<{
         image: "image";
@@ -504,7 +663,97 @@ declare const MediaSchema: z.ZodObject<{
     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<{
+        /**
+         * `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: z.ZodOptional<z.ZodEnum<{
+            native: "native";
+            minimal: "minimal";
+        }>>;
+        /**
+         * 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: z.ZodOptional<z.ZodNumber>;
+        /** `none` renders no scrubber and reverts an out-of-band seek to the high-water mark. */
+        seek: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            allow: "allow";
+        }>>;
+        /** `fixed` renders no speed control and snaps `playbackRate` back to 1. */
+        rate: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            fixed: "fixed";
+        }>>;
+        /** Advisory only. See {@link NativeControlHintSchema}. */
+        nativeControlHints: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "hide-download": "hide-download";
+            "hide-rate": "hide-rate";
+        }>>>;
+    }, z.core.$strict>>;
 }, z.core.$loose>;
+/**
+ * The strict counterpart of {@link MediaSchema}, for the redacted shapes.
+ *
+ * `RedactedActivityDataSchema` and `RedactedStimulusSchema` are `strictObject`
+ * precisely so an unknown key is a validation failure rather than a
+ * passthrough — but they embedded the LOOSE `MediaSchema`, so the strictness
+ * stopped at the media boundary and `media.secretAnswerHint` passed
+ * `assertRedacted`. This closes it.
+ */
+declare const RedactedMediaSchema: 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<{
+        /**
+         * `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: z.ZodOptional<z.ZodEnum<{
+            native: "native";
+            minimal: "minimal";
+        }>>;
+        /**
+         * 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: z.ZodOptional<z.ZodNumber>;
+        /** `none` renders no scrubber and reverts an out-of-band seek to the high-water mark. */
+        seek: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            allow: "allow";
+        }>>;
+        /** `fixed` renders no speed control and snaps `playbackRate` back to 1. */
+        rate: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            fixed: "fixed";
+        }>>;
+        /** Advisory only. See {@link NativeControlHintSchema}. */
+        nativeControlHints: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "hide-download": "hide-download";
+            "hide-rate": "hide-rate";
+        }>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 
 /**
  * Zod schema for a single Multiple Choice option. Loose: unknown keys are
@@ -562,6 +811,25 @@ declare const MultipleChoiceDataSchema: z.ZodObject<{
         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>>;
     feedback: z.ZodOptional<z.ZodObject<{
         correct: z.ZodOptional<z.ZodString>;
@@ -616,7 +884,26 @@ declare const RedactedMultipleChoiceDataSchema: z.ZodObject<{
         url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
         alt: z.ZodOptional<z.ZodString>;
         captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
-    }, z.core.$loose>>;
+        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>>;
@@ -653,7 +940,26 @@ declare const RedactedFillInTheBlanksDataSchema: z.ZodObject<{
         url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
         alt: z.ZodOptional<z.ZodString>;
         captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
-    }, z.core.$loose>>;
+        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>>;
@@ -696,7 +1002,26 @@ declare const RedactedWrittenResponseDataSchema: z.ZodObject<{
         url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
         alt: z.ZodOptional<z.ZodString>;
         captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
-    }, z.core.$loose>>;
+        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>>;
@@ -791,6 +1116,25 @@ declare const WrittenResponseDataSchema: z.ZodObject<{
         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>>;
     feedback: z.ZodOptional<z.ZodObject<{
         correct: z.ZodOptional<z.ZodString>;
@@ -816,4 +1160,4 @@ declare const WrittenResponseDataSchema: z.ZodObject<{
  */
 declare function validateActivity<T extends ActivityType>(type: T, data: unknown): ValidationResult<ActivityDataMap[T]>;
 
-export { itemGroupJsonSchema as A, BlankConfigSchema as B, jsonSchemaFor as C, multipleChoiceJsonSchema as D, stimulusJsonSchema as E, FeedbackSchema as F, validateActivity as G, validateItemGroup as H, type ItemGroup as I, writtenResponseJsonSchema as J, MediaSchema as M, type RedactedActivity as R, type SequenceEntry as S, TextMatchPolicySchema as T, WrittenResponseDataSchema as W, FillInTheBlanksDataSchema as a, ItemGroupSchema as b, MediaUrlSchema as c, MultipleChoiceDataSchema as d, MultipleChoiceOptionSchema as e, type RedactedBlankConfig as f, RedactedBlankConfigSchema as g, type RedactedFillInTheBlanksData as h, RedactedFillInTheBlanksDataSchema as i, RedactedItemGroupSchema as j, type RedactedMultipleChoiceData as k, RedactedMultipleChoiceDataSchema as l, type RedactedMultipleChoiceOption as m, RedactedMultipleChoiceOptionSchema as n, type RedactedStimulus as o, RedactedStimulusSchema as p, type RedactedWrittenResponseData as q, RedactedWrittenResponseDataSchema as r, type SequenceSlot as s, type SequenceSlotGroup as t, type Stimulus as u, type StimulusKind as v, StimulusSchema as w, WrittenResponseRubricCriterionSchema as x, WrittenResponseRubricSchema as y, fillInTheBlanksJsonSchema as z };
+export { WrittenResponseRubricSchema as A, BlankConfigSchema as B, fillInTheBlanksJsonSchema as C, itemGroupJsonSchema as D, jsonSchemaFor as E, FeedbackSchema as F, multipleChoiceJsonSchema as G, stimulusJsonSchema as H, type ItemGroup as I, validateActivity as J, validateItemGroup as K, writtenResponseJsonSchema as L, MediaPlaybackSchema as M, NativeControlHintSchema as N, type RedactedActivity as R, type SequenceEntry as S, TextMatchPolicySchema as T, WrittenResponseDataSchema as W, FillInTheBlanksDataSchema as a, ItemGroupSchema as b, MediaSchema as c, MediaUrlSchema as d, MultipleChoiceDataSchema as e, MultipleChoiceOptionSchema as f, type RedactedBlankConfig as g, RedactedBlankConfigSchema as h, type RedactedFillInTheBlanksData as i, RedactedFillInTheBlanksDataSchema as j, RedactedItemGroupSchema as k, RedactedMediaSchema as l, type RedactedMultipleChoiceData as m, RedactedMultipleChoiceDataSchema as n, type RedactedMultipleChoiceOption as o, RedactedMultipleChoiceOptionSchema as p, type RedactedStimulus as q, RedactedStimulusSchema as r, type RedactedWrittenResponseData as s, RedactedWrittenResponseDataSchema as t, type SequenceSlot as u, type SequenceSlotGroup as v, type Stimulus as w, type StimulusKind as x, StimulusSchema as y, WrittenResponseRubricCriterionSchema as z };