@intellectif/lk-core 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @intellectif/lk-core
 
+## 0.10.0
+
+### Minor Changes
+
+- a88b3f9: Multiple-choice options can carry a picture or a recording.
+
+  The A1/A2 picture-choice item ("which picture shows a cat?") and the minimal-pair listening item had no expression in the data contract: `media` sat above the question, one asset per activity, so four pictures as four options was not sayable.
+
+  `MultipleChoiceOption.media` adds it, additively — `text` stays required on every option, because it names the option in the accessible name and in the xAPI statement and is what the learner sees when a picture fails to load.
+
+  **Only `image` and `audio` are accepted.** `video` and `embed` are refused by the schema, and not out of caution: both render a control surface that swallows the click meant to select the option, so the learner could not choose it. An option also carries **no `playback` policy** — `maxPlays` binds per slot through a `MediaBudgetBinding`, and nothing has decided whether four recordings in one question share a budget or hold one each, so writing one is an error rather than a promise no renderer keeps.
+
+  A picture renders **inside** the option's label, so clicking it selects the option and its `alt` joins the accessible name. A recording renders **outside** the label, so pressing play does not commit the learner to that answer before they have heard the others. An option with no media renders exactly the markup it always did.
+
+  `alt` follows the rule activity media already uses — required and non-empty for an image, optional for audio. Note that on a picture-choice item the `alt` is part of the item: it can hand a screen-reader user the answer. The SDK requires it so an option is never silently inaccessible and leaves the wording to you; the authoring guide says so plainly.
+
+  Redaction keeps option media intact — it is what the learner picks — and removes only `isCorrect` and per-option `feedback`. Draft checks report an option's media under the codes media already uses (`media_url_required`, `media_alt_required`, `media_url_invalid`), plus one new code, `mc_option_media_kind`, for a refused `video` or `embed`.
+
 ## 0.9.0
 
 ### Minor Changes

package/dist/{activity-CPtJUBek.d.cts → activity-B0zbvu18.d.cts}

@@ -359,6 +359,7 @@ interface ActivityDataMap {
     'multiple-choice': MultipleChoiceData;
     'fill-in-the-blanks': FillInTheBlanksData;
     'written-response': WrittenResponseData;
+    'gap-select': GapSelectData;
 }
 /**
  * The set of activity types supported by learning-kit. Derived from
@@ -447,15 +448,64 @@ interface ActivityFeedback {
     incorrect?: string;
 }
 /** A single selectable option within a Multiple Choice activity. */
+/**
+ * A picture or a recording carried by ONE multiple-choice option — the
+ * A1/A2 picture-choice item, and the minimal-pair listening item.
+ *
+ * Narrower than {@link ActivityMedia}, which sits above the question, and
+ * deliberately so. An option is a click target, and two of the activity-level
+ * kinds cannot be one:
+ *
+ * - **`embed` is refused.** A provider iframe swallows pointer events, so
+ *   clicking the option would play the video instead of selecting the answer.
+ *   The learner could not choose it at all.
+ * - **`video` is refused** for the same reason one step down: a native control
+ *   bar inside the option's label eats the clicks meant for the radio.
+ * - **No `playback` policy.** `maxPlays` binds per slot through a
+ *   `MediaBudgetBinding`, and four recordings in one question raise a question
+ *   nothing has answered yet — whether the budget belongs to the option or to
+ *   the item. Until something asks, an option plays through the browser's own
+ *   bar and counts nothing.
+ *
+ * `alt` follows the same rule {@link ActivityMedia} uses, so there is only one
+ * rule to learn: required and non-empty for an image, optional for audio, where
+ * it becomes the player's accessible label.
+ *
+ * **On an image option, `alt` is part of the item.** It joins the option's
+ * `text` in the radio's accessible name, so on "which picture shows a cat?" an
+ * `alt` of "a cat" hands a screen-reader user the answer that a sighted learner
+ * has to work out. That is a property of picture-choice items, not something a
+ * schema can fix — the SDK requires `alt` so an option is never SILENTLY
+ * inaccessible, and leaves the wording, and the item's validity, to the author.
+ */
+interface MultipleChoiceOptionMedia {
+    /** `image` for a picture-choice option, `audio` for a listening option. */
+    type: 'image' | 'audio';
+    /** Address of the file. Same scheme allow-list as {@link ActivityMedia}. */
+    url: string;
+    /** Required and non-empty for `image`; an optional accessible label for `audio`. */
+    alt?: string;
+    /** WebVTT captions for an audio option, rendered as a `<track>`. */
+    captionsUrl?: string;
+}
 interface MultipleChoiceOption {
     /** Unique identifier for this option within the activity. */
     id: string;
-    /** Display text shown to the learner. */
+    /**
+     * Display text shown to the learner.
+     *
+     * Required even when the option carries {@link media}: it names the option in
+     * the radio's accessible name and in the xAPI statement, and it is what the
+     * learner sees if a picture fails to load. For a pure picture-choice option,
+     * a neutral label ("Picture 1") keeps the naming out of the answer.
+     */
     text: string;
     /** Whether this option is part of the correct answer. */
     isCorrect: boolean;
     /** Optional per-option feedback shown after submission. */
     feedback?: string;
+    /** An optional picture or recording shown as part of this option. */
+    media?: MultipleChoiceOptionMedia;
 }
 /** Data contract for a Multiple Choice activity. */
 interface MultipleChoiceData {
@@ -528,6 +578,116 @@ interface BlankConfig {
     feedback?: string;
 }
 /** Data contract for a Fill-in-the-Blanks activity. */
+/** One selectable option in a Gap Select activity. */
+interface GapSelectChoice {
+    /** Unique identifier within the choice set the gap resolves to. */
+    id: string;
+    /** The text the learner reads in the selector. */
+    text: string;
+}
+/**
+ * A named set of choices several gaps can draw from — a word bank.
+ *
+ * A bank is what makes distractors possible: three gaps sharing a bank of five
+ * choices means every selector offers all five, and two of them answer no gap
+ * at all. That is the difference between a reading-comprehension item and a
+ * sequence of three-way guesses, so it is modelled once here rather than
+ * retrofitted after per-gap lists ship.
+ */
+interface GapSelectBank {
+    /** Unique identifier referenced by {@link GapSelectGap.bankId}. */
+    id: string;
+    /** The choices every gap on this bank offers. */
+    choices: GapSelectChoice[];
+}
+/**
+ * One gap in the passage, matching a `{{gap_id}}` placeholder.
+ *
+ * Its choices come from exactly one place: `choices` for a list of its own, or
+ * `bankId` for a shared word bank. Both, or neither, is an authoring error the
+ * schema rejects — with two sources a reader cannot tell which list the learner
+ * is offered, and the answer key means nothing without one.
+ */
+interface GapSelectGap {
+    /** Unique identifier matching the `{{gap_id}}` placeholder in the passage. */
+    id: string;
+    /** This gap's own choices. Mutually exclusive with {@link bankId}. */
+    choices?: GapSelectChoice[];
+    /** The {@link GapSelectBank} this gap draws from. Mutually exclusive with {@link choices}. */
+    bankId?: string;
+    /** The `id` of the one choice that is correct. Must exist in the resolved choice set. */
+    correctChoiceId: string;
+    /** Optional feedback shown inline next to this gap after submission. */
+    feedback?: string;
+}
+/**
+ * Data contract for a Gap Select activity: a passage whose gaps the learner
+ * fills by choosing from a list rather than typing.
+ *
+ * It is deliberately **not** a mode of {@link FillInTheBlanksData}, though the
+ * passage and its `{{id}}` placeholders are authored the same way. A learner
+ * picking from a selector cannot mistype, so the whole `TextMatchPolicy`
+ * surface — diacritic folding, typo tolerance, locale-aware case — is not just
+ * unused but misleading. Scoring is identity comparison of a choice id.
+ * Redaction inverts too: in Fill-in-the-Blanks the candidate answers ARE the
+ * key, while here the learner must be shown every choice and only
+ * `correctChoiceId` is withheld.
+ */
+interface GapSelectData {
+    schemaVersion: '1.0';
+    type: 'gap-select';
+    /** Unique identifier for this activity. */
+    id: string;
+    /** Human-readable title used in xAPI statements and error boundaries. */
+    title: string;
+    /** Passage text containing `{{gap_id}}` placeholders. */
+    passage: string;
+    /**
+     * Optional sanitised rich-HTML rendering of the passage. Carried and redacted
+     * as learner-visible content; not rendered by the SDK, for the same reason
+     * `FillInTheBlanksData.passageHtml` is not — slicing sanitised HTML at the
+     * placeholders to host the selectors is both lossy and unsafe.
+     */
+    passageHtml?: string;
+    /** Every gap in the passage, one per distinct `{{id}}` placeholder. */
+    gaps: GapSelectGap[];
+    /** Shared word banks. Only needed by gaps that set `bankId`. */
+    banks?: GapSelectBank[];
+    /** Scoring algorithm applied when the learner submits. */
+    scoringStrategy: 'all-or-nothing' | 'partial';
+    /**
+     * How the choices are presented. Only `'dropdown'` exists today, and it is
+     * the default.
+     *
+     * The field is here rather than assumed because a drag-and-drop presentation
+     * is the obvious next request, and WCAG 2.5.7 requires that a drag interface
+     * always keep a non-drag path — so the choice has to be expressible in the
+     * content, not decided by a component prop. `'drag'` is NOT accepted yet:
+     * shipping a value nothing renders would freeze an API this repository has
+     * not validated. Widening the union later is additive.
+     */
+    presentation?: 'dropdown';
+    /**
+     * Whether the SDK shuffles each selector's choices. Off by default.
+     *
+     * Like `MultipleChoiceData.shuffle`, this needs a seed to be reproducible at
+     * a remark — `<ActivitySequence>` refuses to shuffle without one outside
+     * `practice` mode.
+     */
+    shuffleChoices?: boolean;
+    /** Optional media shown above the passage. */
+    media?: ActivityMedia;
+    /** Optional authored overall feedback shown after submission. */
+    feedback?: ActivityFeedback;
+    /** Minimum scaled score [0–1] required to pass. Defaults to {@link DEFAULT_PASS_THRESHOLD} (0.7) when absent. */
+    passThreshold?: number;
+    /** BCP 47 language tag for the activity content. */
+    locale?: string;
+    /** IRI references to learning objectives addressed by this activity. */
+    learningObjectives?: string[];
+    /** Subjective difficulty on a 1–5 scale. */
+    difficultyLevel?: 1 | 2 | 3 | 4 | 5;
+}
 interface FillInTheBlanksData {
     schemaVersion: '1.0';
     type: 'fill-in-the-blanks';
@@ -630,6 +790,7 @@ interface LearnerResponseMap {
     'multiple-choice': MultipleChoiceLearnerResponse;
     'fill-in-the-blanks': FillInTheBlanksLearnerResponse;
     'written-response': WrittenResponseLearnerResponse;
+    'gap-select': GapSelectLearnerResponse;
 }
 /** Union of all learner response shapes. */
 type LearnerResponse = LearnerResponseMap[keyof LearnerResponseMap];
@@ -645,6 +806,20 @@ interface FillInTheBlanksLearnerResponse {
     /** Map of blank ID to the learner's typed answer. */
     answers: Record<string, string>;
 }
+/**
+ * Learner response for a Gap Select activity.
+ *
+ * A gap the learner has not answered is **absent from the map, or holds an
+ * empty string** — the two are equivalent, because a `<select>` whose
+ * placeholder is still showing submits `''`. Neither is a wrong answer: the
+ * scorer reports it as `incorrect-omission`, which is how a blank the learner
+ * never reached is told apart from one they got wrong.
+ */
+interface GapSelectLearnerResponse {
+    type: 'gap-select';
+    /** Map of gap ID to the ID of the choice the learner selected. */
+    selections: Record<string, string>;
+}
 /** Learner response for a Written Response activity. */
 interface WrittenResponseLearnerResponse {
     type: 'written-response';
@@ -845,4 +1020,4 @@ interface InteractionEvent {
     payload: Record<string, unknown>;
 }
 
-export { type ActivityData as A, type BlankConfig as B, type CriterionScore as C, type DeferredScoringPartial as D, type XAPIError as E, type FillInTheBlanksData as F, type GradeRecord as G, type XAPIObject as H, type InlineCorrection as I, type XAPIResult as J, type XAPIScore as K, type LearnerResponse as L, type MultipleChoiceData as M, type NativeControlHint as N, type XAPIStatement as O, type XAPIVerbObject as P, levenshteinDistance as Q, matchText as R, type ScoringDetail as S, type TextMatchPolicy as T, type ValidationError as V, type WrittenResponseData as W, type XAPIActor as X, type ActivityDataMap as a, type ActivityFeedback as b, type ActivityMedia as c, type ActivityResult as d, type ActivityType as e, type FillInTheBlanksLearnerResponse as f, type Grader as g, type GraderKind as h, type GraderUsage as i, type GradingState as j, type InteractionEvent as k, type InteractionKind as l, type ItemOutcome as m, type LearnerResponseMap as n, type MultipleChoiceLearnerResponse as o, type MultipleChoiceOption as p, type ScoringOutcome as q, type ScoringResult as r, type TextMatchResult as s, type ValidationResult as t, type WrittenResponseLearnerResponse as u, type WrittenResponseRubric as v, type WrittenResponseRubricCriterion as w, type XAPIConfig as x, type XAPIContext as y, type XAPIContextActivities as z };
+export { type ActivityData as A, type BlankConfig as B, type CriterionScore as C, type DeferredScoringPartial as D, type XAPIContextActivities as E, type FillInTheBlanksData as F, type GradeRecord as G, type XAPIError as H, type InlineCorrection as I, type XAPIObject as J, type XAPIResult as K, type LearnerResponse as L, type MultipleChoiceData as M, type NativeControlHint as N, type XAPIScore as O, type XAPIStatement as P, type XAPIVerbObject as Q, levenshteinDistance as R, type ScoringDetail as S, type TextMatchPolicy as T, matchText as U, type ValidationError as V, type WrittenResponseData as W, type XAPIActor as X, type ActivityDataMap as a, type ActivityFeedback as b, type ActivityMedia as c, type ActivityResult as d, type ActivityType as e, type FillInTheBlanksLearnerResponse as f, type Grader as g, type GraderKind as h, type GraderUsage as i, type GradingState as j, type InteractionEvent as k, type InteractionKind as l, type ItemOutcome as m, type LearnerResponseMap as n, type MultipleChoiceLearnerResponse as o, type MultipleChoiceOption as p, type MultipleChoiceOptionMedia as q, type ScoringOutcome as r, type ScoringResult as s, type TextMatchResult as t, type ValidationResult as u, type WrittenResponseLearnerResponse as v, type WrittenResponseRubric as w, type WrittenResponseRubricCriterion as x, type XAPIConfig as y, type XAPIContext as z };

package/dist/{activity-CPtJUBek.d.ts → activity-B0zbvu18.d.ts}

@@ -359,6 +359,7 @@ interface ActivityDataMap {
     'multiple-choice': MultipleChoiceData;
     'fill-in-the-blanks': FillInTheBlanksData;
     'written-response': WrittenResponseData;
+    'gap-select': GapSelectData;
 }
 /**
  * The set of activity types supported by learning-kit. Derived from
@@ -447,15 +448,64 @@ interface ActivityFeedback {
     incorrect?: string;
 }
 /** A single selectable option within a Multiple Choice activity. */
+/**
+ * A picture or a recording carried by ONE multiple-choice option — the
+ * A1/A2 picture-choice item, and the minimal-pair listening item.
+ *
+ * Narrower than {@link ActivityMedia}, which sits above the question, and
+ * deliberately so. An option is a click target, and two of the activity-level
+ * kinds cannot be one:
+ *
+ * - **`embed` is refused.** A provider iframe swallows pointer events, so
+ *   clicking the option would play the video instead of selecting the answer.
+ *   The learner could not choose it at all.
+ * - **`video` is refused** for the same reason one step down: a native control
+ *   bar inside the option's label eats the clicks meant for the radio.
+ * - **No `playback` policy.** `maxPlays` binds per slot through a
+ *   `MediaBudgetBinding`, and four recordings in one question raise a question
+ *   nothing has answered yet — whether the budget belongs to the option or to
+ *   the item. Until something asks, an option plays through the browser's own
+ *   bar and counts nothing.
+ *
+ * `alt` follows the same rule {@link ActivityMedia} uses, so there is only one
+ * rule to learn: required and non-empty for an image, optional for audio, where
+ * it becomes the player's accessible label.
+ *
+ * **On an image option, `alt` is part of the item.** It joins the option's
+ * `text` in the radio's accessible name, so on "which picture shows a cat?" an
+ * `alt` of "a cat" hands a screen-reader user the answer that a sighted learner
+ * has to work out. That is a property of picture-choice items, not something a
+ * schema can fix — the SDK requires `alt` so an option is never SILENTLY
+ * inaccessible, and leaves the wording, and the item's validity, to the author.
+ */
+interface MultipleChoiceOptionMedia {
+    /** `image` for a picture-choice option, `audio` for a listening option. */
+    type: 'image' | 'audio';
+    /** Address of the file. Same scheme allow-list as {@link ActivityMedia}. */
+    url: string;
+    /** Required and non-empty for `image`; an optional accessible label for `audio`. */
+    alt?: string;
+    /** WebVTT captions for an audio option, rendered as a `<track>`. */
+    captionsUrl?: string;
+}
 interface MultipleChoiceOption {
     /** Unique identifier for this option within the activity. */
     id: string;
-    /** Display text shown to the learner. */
+    /**
+     * Display text shown to the learner.
+     *
+     * Required even when the option carries {@link media}: it names the option in
+     * the radio's accessible name and in the xAPI statement, and it is what the
+     * learner sees if a picture fails to load. For a pure picture-choice option,
+     * a neutral label ("Picture 1") keeps the naming out of the answer.
+     */
     text: string;
     /** Whether this option is part of the correct answer. */
     isCorrect: boolean;
     /** Optional per-option feedback shown after submission. */
     feedback?: string;
+    /** An optional picture or recording shown as part of this option. */
+    media?: MultipleChoiceOptionMedia;
 }
 /** Data contract for a Multiple Choice activity. */
 interface MultipleChoiceData {
@@ -528,6 +578,116 @@ interface BlankConfig {
     feedback?: string;
 }
 /** Data contract for a Fill-in-the-Blanks activity. */
+/** One selectable option in a Gap Select activity. */
+interface GapSelectChoice {
+    /** Unique identifier within the choice set the gap resolves to. */
+    id: string;
+    /** The text the learner reads in the selector. */
+    text: string;
+}
+/**
+ * A named set of choices several gaps can draw from — a word bank.
+ *
+ * A bank is what makes distractors possible: three gaps sharing a bank of five
+ * choices means every selector offers all five, and two of them answer no gap
+ * at all. That is the difference between a reading-comprehension item and a
+ * sequence of three-way guesses, so it is modelled once here rather than
+ * retrofitted after per-gap lists ship.
+ */
+interface GapSelectBank {
+    /** Unique identifier referenced by {@link GapSelectGap.bankId}. */
+    id: string;
+    /** The choices every gap on this bank offers. */
+    choices: GapSelectChoice[];
+}
+/**
+ * One gap in the passage, matching a `{{gap_id}}` placeholder.
+ *
+ * Its choices come from exactly one place: `choices` for a list of its own, or
+ * `bankId` for a shared word bank. Both, or neither, is an authoring error the
+ * schema rejects — with two sources a reader cannot tell which list the learner
+ * is offered, and the answer key means nothing without one.
+ */
+interface GapSelectGap {
+    /** Unique identifier matching the `{{gap_id}}` placeholder in the passage. */
+    id: string;
+    /** This gap's own choices. Mutually exclusive with {@link bankId}. */
+    choices?: GapSelectChoice[];
+    /** The {@link GapSelectBank} this gap draws from. Mutually exclusive with {@link choices}. */
+    bankId?: string;
+    /** The `id` of the one choice that is correct. Must exist in the resolved choice set. */
+    correctChoiceId: string;
+    /** Optional feedback shown inline next to this gap after submission. */
+    feedback?: string;
+}
+/**
+ * Data contract for a Gap Select activity: a passage whose gaps the learner
+ * fills by choosing from a list rather than typing.
+ *
+ * It is deliberately **not** a mode of {@link FillInTheBlanksData}, though the
+ * passage and its `{{id}}` placeholders are authored the same way. A learner
+ * picking from a selector cannot mistype, so the whole `TextMatchPolicy`
+ * surface — diacritic folding, typo tolerance, locale-aware case — is not just
+ * unused but misleading. Scoring is identity comparison of a choice id.
+ * Redaction inverts too: in Fill-in-the-Blanks the candidate answers ARE the
+ * key, while here the learner must be shown every choice and only
+ * `correctChoiceId` is withheld.
+ */
+interface GapSelectData {
+    schemaVersion: '1.0';
+    type: 'gap-select';
+    /** Unique identifier for this activity. */
+    id: string;
+    /** Human-readable title used in xAPI statements and error boundaries. */
+    title: string;
+    /** Passage text containing `{{gap_id}}` placeholders. */
+    passage: string;
+    /**
+     * Optional sanitised rich-HTML rendering of the passage. Carried and redacted
+     * as learner-visible content; not rendered by the SDK, for the same reason
+     * `FillInTheBlanksData.passageHtml` is not — slicing sanitised HTML at the
+     * placeholders to host the selectors is both lossy and unsafe.
+     */
+    passageHtml?: string;
+    /** Every gap in the passage, one per distinct `{{id}}` placeholder. */
+    gaps: GapSelectGap[];
+    /** Shared word banks. Only needed by gaps that set `bankId`. */
+    banks?: GapSelectBank[];
+    /** Scoring algorithm applied when the learner submits. */
+    scoringStrategy: 'all-or-nothing' | 'partial';
+    /**
+     * How the choices are presented. Only `'dropdown'` exists today, and it is
+     * the default.
+     *
+     * The field is here rather than assumed because a drag-and-drop presentation
+     * is the obvious next request, and WCAG 2.5.7 requires that a drag interface
+     * always keep a non-drag path — so the choice has to be expressible in the
+     * content, not decided by a component prop. `'drag'` is NOT accepted yet:
+     * shipping a value nothing renders would freeze an API this repository has
+     * not validated. Widening the union later is additive.
+     */
+    presentation?: 'dropdown';
+    /**
+     * Whether the SDK shuffles each selector's choices. Off by default.
+     *
+     * Like `MultipleChoiceData.shuffle`, this needs a seed to be reproducible at
+     * a remark — `<ActivitySequence>` refuses to shuffle without one outside
+     * `practice` mode.
+     */
+    shuffleChoices?: boolean;
+    /** Optional media shown above the passage. */
+    media?: ActivityMedia;
+    /** Optional authored overall feedback shown after submission. */
+    feedback?: ActivityFeedback;
+    /** Minimum scaled score [0–1] required to pass. Defaults to {@link DEFAULT_PASS_THRESHOLD} (0.7) when absent. */
+    passThreshold?: number;
+    /** BCP 47 language tag for the activity content. */
+    locale?: string;
+    /** IRI references to learning objectives addressed by this activity. */
+    learningObjectives?: string[];
+    /** Subjective difficulty on a 1–5 scale. */
+    difficultyLevel?: 1 | 2 | 3 | 4 | 5;
+}
 interface FillInTheBlanksData {
     schemaVersion: '1.0';
     type: 'fill-in-the-blanks';
@@ -630,6 +790,7 @@ interface LearnerResponseMap {
     'multiple-choice': MultipleChoiceLearnerResponse;
     'fill-in-the-blanks': FillInTheBlanksLearnerResponse;
     'written-response': WrittenResponseLearnerResponse;
+    'gap-select': GapSelectLearnerResponse;
 }
 /** Union of all learner response shapes. */
 type LearnerResponse = LearnerResponseMap[keyof LearnerResponseMap];
@@ -645,6 +806,20 @@ interface FillInTheBlanksLearnerResponse {
     /** Map of blank ID to the learner's typed answer. */
     answers: Record<string, string>;
 }
+/**
+ * Learner response for a Gap Select activity.
+ *
+ * A gap the learner has not answered is **absent from the map, or holds an
+ * empty string** — the two are equivalent, because a `<select>` whose
+ * placeholder is still showing submits `''`. Neither is a wrong answer: the
+ * scorer reports it as `incorrect-omission`, which is how a blank the learner
+ * never reached is told apart from one they got wrong.
+ */
+interface GapSelectLearnerResponse {
+    type: 'gap-select';
+    /** Map of gap ID to the ID of the choice the learner selected. */
+    selections: Record<string, string>;
+}
 /** Learner response for a Written Response activity. */
 interface WrittenResponseLearnerResponse {
     type: 'written-response';
@@ -845,4 +1020,4 @@ interface InteractionEvent {
     payload: Record<string, unknown>;
 }
 
-export { type ActivityData as A, type BlankConfig as B, type CriterionScore as C, type DeferredScoringPartial as D, type XAPIError as E, type FillInTheBlanksData as F, type GradeRecord as G, type XAPIObject as H, type InlineCorrection as I, type XAPIResult as J, type XAPIScore as K, type LearnerResponse as L, type MultipleChoiceData as M, type NativeControlHint as N, type XAPIStatement as O, type XAPIVerbObject as P, levenshteinDistance as Q, matchText as R, type ScoringDetail as S, type TextMatchPolicy as T, type ValidationError as V, type WrittenResponseData as W, type XAPIActor as X, type ActivityDataMap as a, type ActivityFeedback as b, type ActivityMedia as c, type ActivityResult as d, type ActivityType as e, type FillInTheBlanksLearnerResponse as f, type Grader as g, type GraderKind as h, type GraderUsage as i, type GradingState as j, type InteractionEvent as k, type InteractionKind as l, type ItemOutcome as m, type LearnerResponseMap as n, type MultipleChoiceLearnerResponse as o, type MultipleChoiceOption as p, type ScoringOutcome as q, type ScoringResult as r, type TextMatchResult as s, type ValidationResult as t, type WrittenResponseLearnerResponse as u, type WrittenResponseRubric as v, type WrittenResponseRubricCriterion as w, type XAPIConfig as x, type XAPIContext as y, type XAPIContextActivities as z };
+export { type ActivityData as A, type BlankConfig as B, type CriterionScore as C, type DeferredScoringPartial as D, type XAPIContextActivities as E, type FillInTheBlanksData as F, type GradeRecord as G, type XAPIError as H, type InlineCorrection as I, type XAPIObject as J, type XAPIResult as K, type LearnerResponse as L, type MultipleChoiceData as M, type NativeControlHint as N, type XAPIScore as O, type XAPIStatement as P, type XAPIVerbObject as Q, levenshteinDistance as R, type ScoringDetail as S, type TextMatchPolicy as T, matchText as U, type ValidationError as V, type WrittenResponseData as W, type XAPIActor as X, type ActivityDataMap as a, type ActivityFeedback as b, type ActivityMedia as c, type ActivityResult as d, type ActivityType as e, type FillInTheBlanksLearnerResponse as f, type Grader as g, type GraderKind as h, type GraderUsage as i, type GradingState as j, type InteractionEvent as k, type InteractionKind as l, type ItemOutcome as m, type LearnerResponseMap as n, type MultipleChoiceLearnerResponse as o, type MultipleChoiceOption as p, type MultipleChoiceOptionMedia as q, type ScoringOutcome as r, type ScoringResult as s, type TextMatchResult as t, type ValidationResult as u, type WrittenResponseLearnerResponse as v, type WrittenResponseRubric as w, type WrittenResponseRubricCriterion as x, type XAPIConfig as y, type XAPIContext as z };

package/dist/{chunk-YVZCFUGP.cjs → chunk-3FEAEO3D.cjs}

@@ -6,7 +6,8 @@
 
 
 
-var _chunkCVRALNUKcjs = require('./chunk-CVRALNUK.cjs');
+
+var _chunk7ODQRNR4cjs = require('./chunk-7ODQRNR4.cjs');
 
 // src/schemas/item-group.ts
 var _v4 = require('zod/v4');
@@ -34,7 +35,7 @@ var StimulusSchema = _v4.z.looseObject({
   title: _v4.z.string().optional(),
   body: _v4.z.string().optional(),
   bodyHtml: _v4.z.string().optional(),
-  media: _chunkCVRALNUKcjs.MediaSchema.optional(),
+  media: _chunk7ODQRNR4cjs.MediaSchema.optional(),
   transcript: _v4.z.string().optional(),
   locale: _v4.z.string().optional(),
   attribution: _v4.z.string().optional()
@@ -84,7 +85,7 @@ var RedactedStimulusSchema = _v4.z.strictObject({
   title: _v4.z.string().optional(),
   body: _v4.z.string().optional(),
   bodyHtml: _v4.z.string().optional(),
-  media: _chunkCVRALNUKcjs.RedactedMediaSchema.optional(),
+  media: _chunk7ODQRNR4cjs.RedactedMediaSchema.optional(),
   locale: _v4.z.string().optional(),
   attribution: _v4.z.string().optional()
 });
@@ -114,7 +115,7 @@ function validateItemGroup(data) {
   const errors = [];
   const items = [];
   container.data.items.forEach((item, index) => {
-    const descriptor = _chunkCVRALNUKcjs.getActivityTypeDescriptor.call(void 0, item.type);
+    const descriptor = _chunk7ODQRNR4cjs.getActivityTypeDescriptor.call(void 0, item.type);
     if (descriptor === void 0) {
       errors.push({
         path: ["items", String(index), "type"],
@@ -140,28 +141,31 @@ function validateItemGroup(data) {
 
 var stimulusJsonSchema = _v4.z.toJSONSchema(StimulusSchema, { target: "draft-7" });
 var itemGroupJsonSchema = _v4.z.toJSONSchema(ItemGroupSchema, { target: "draft-7" });
-var multipleChoiceJsonSchema = _v4.z.toJSONSchema(_chunkCVRALNUKcjs.MultipleChoiceDataSchema, {
+var gapSelectJsonSchema = _v4.z.toJSONSchema(_chunk7ODQRNR4cjs.GapSelectDataSchema, {
+  target: "draft-7"
+});
+var multipleChoiceJsonSchema = _v4.z.toJSONSchema(_chunk7ODQRNR4cjs.MultipleChoiceDataSchema, {
   target: "draft-7"
 });
-var fillInTheBlanksJsonSchema = _v4.z.toJSONSchema(_chunkCVRALNUKcjs.FillInTheBlanksDataSchema, {
+var fillInTheBlanksJsonSchema = _v4.z.toJSONSchema(_chunk7ODQRNR4cjs.FillInTheBlanksDataSchema, {
   target: "draft-7"
 });
-var writtenResponseJsonSchema = _v4.z.toJSONSchema(_chunkCVRALNUKcjs.WrittenResponseDataSchema, {
+var writtenResponseJsonSchema = _v4.z.toJSONSchema(_chunk7ODQRNR4cjs.WrittenResponseDataSchema, {
   target: "draft-7"
 });
 function jsonSchemaFor(type) {
-  const descriptor = _chunkCVRALNUKcjs.getActivityTypeDescriptor.call(void 0, type);
+  const descriptor = _chunk7ODQRNR4cjs.getActivityTypeDescriptor.call(void 0, type);
   if (descriptor === void 0) {
-    throw new (0, _chunkCVRALNUKcjs.UnknownActivityTypeError)(type);
+    throw new (0, _chunk7ODQRNR4cjs.UnknownActivityTypeError)(type);
   }
   return _v4.z.toJSONSchema(descriptor.schema, { target: "draft-7" });
 }
 
 // src/schemas/index.ts
 function validateActivity(type, data) {
-  const descriptor = _chunkCVRALNUKcjs.getActivityTypeDescriptor.call(void 0, type);
+  const descriptor = _chunk7ODQRNR4cjs.getActivityTypeDescriptor.call(void 0, type);
   if (descriptor === void 0) {
-    throw new (0, _chunkCVRALNUKcjs.UnknownActivityTypeError)(String(type));
+    throw new (0, _chunk7ODQRNR4cjs.UnknownActivityTypeError)(String(type));
   }
   const result = descriptor.schema.safeParse(data);
   if (result.success) {
@@ -190,5 +194,6 @@ function validateActivity(type, data) {
 
 
 
-exports.StimulusSchema = StimulusSchema; exports.ItemGroupSchema = ItemGroupSchema; exports.RedactedStimulusSchema = RedactedStimulusSchema; exports.RedactedItemGroupSchema = RedactedItemGroupSchema; exports.validateItemGroup = validateItemGroup; exports.stimulusJsonSchema = stimulusJsonSchema; exports.itemGroupJsonSchema = itemGroupJsonSchema; exports.multipleChoiceJsonSchema = multipleChoiceJsonSchema; exports.fillInTheBlanksJsonSchema = fillInTheBlanksJsonSchema; exports.writtenResponseJsonSchema = writtenResponseJsonSchema; exports.jsonSchemaFor = jsonSchemaFor; exports.validateActivity = validateActivity;
-//# sourceMappingURL=chunk-YVZCFUGP.cjs.map
+
+exports.StimulusSchema = StimulusSchema; exports.ItemGroupSchema = ItemGroupSchema; exports.RedactedStimulusSchema = RedactedStimulusSchema; exports.RedactedItemGroupSchema = RedactedItemGroupSchema; exports.validateItemGroup = validateItemGroup; exports.stimulusJsonSchema = stimulusJsonSchema; exports.itemGroupJsonSchema = itemGroupJsonSchema; exports.gapSelectJsonSchema = gapSelectJsonSchema; exports.multipleChoiceJsonSchema = multipleChoiceJsonSchema; exports.fillInTheBlanksJsonSchema = fillInTheBlanksJsonSchema; exports.writtenResponseJsonSchema = writtenResponseJsonSchema; exports.jsonSchemaFor = jsonSchemaFor; exports.validateActivity = validateActivity;
+//# sourceMappingURL=chunk-3FEAEO3D.cjs.map

package/dist/chunk-3FEAEO3D.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/chunk-3FEAEO3D.cjs","../src/schemas/item-group.ts","../src/schemas/json-schema.ts","../src/schemas/index.ts"],"names":["z"],"mappings":"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","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/chunk-3FEAEO3D.cjs","sourcesContent":[null,"import { z } from 'zod/v4';\nimport { getActivityTypeDescriptor } from '../registry/index.js';\nimport type { ActivityData, ValidationError, ValidationResult } from '../types/activity.js';\nimport type { ItemGroup, StimulusKind } from '../types/item-group.js';\nimport { MediaSchema, RedactedMediaSchema } from './media.js';\n\n/**\n * An authored slot key.\n *\n * A `.` is rejected here, not at render time: `flattenSequence` uses the first\n * `.` to separate a group from its item, so a key containing one would produce\n * an ambiguous slot id. `keyOf` already threw on it — this moves the rejection\n * to `validateItemGroup`, where an author finds it, instead of leaving it to\n * surface when a learner opens the paper. Content that would newly fail\n * validation already threw at flatten time, so it can never have been sat.\n */\nconst SlotKeySchema = z\n  .string()\n  .min(1)\n  .refine((key) => !key.includes('.'), {\n    error:\n      'slotKey must not contain \".\" — that character separates a group from its item in a slot id, so a key containing one would make the slot ambiguous.',\n  });\n\nfunction hasBody(stimulus: { body?: string | undefined }): boolean {\n  return typeof stimulus.body === 'string' && stimulus.body.trim().length > 0;\n}\n\n/** Which media types can carry a stimulus of each kind. `text`/`mixed` accept any. */\nfunction mediaFits(kind: StimulusKind, mediaType: string | undefined): boolean {\n  switch (kind) {\n    case 'audio':\n      return mediaType === 'audio';\n    case 'video':\n      return mediaType === 'video' || mediaType === 'embed';\n    case 'image':\n      return mediaType === 'image';\n    default:\n      return true;\n  }\n}\n\n/**\n * Zod schema for a {@link Stimulus}. Loose: unknown keys preserved.\n *\n * The semantic guards exist because a stimulus that does not carry what its\n * `kind` promises is an authoring error that must not reach an exam: an\n * \"audio\" stimulus with no recording renders as a blank panel above six\n * listening questions. Unrepresentable in JSON Schema; dropped from\n * `stimulusJsonSchema` by design.\n */\nexport const StimulusSchema = z\n  .looseObject({\n    id: z.string().min(1),\n    kind: z.enum(['text', 'audio', 'video', 'image', 'mixed']),\n    title: z.string().optional(),\n    body: z.string().optional(),\n    bodyHtml: z.string().optional(),\n    media: MediaSchema.optional(),\n    transcript: z.string().optional(),\n    locale: z.string().optional(),\n    attribution: z.string().optional(),\n  })\n  .refine((stimulus) => stimulus.bodyHtml === undefined || hasBody(stimulus), {\n    error:\n      'bodyHtml requires a plain-text body: it is the accessible fallback rendered when no sanitiser is supplied.',\n    path: ['body'],\n  })\n  .refine(\n    (stimulus) => (stimulus.kind !== 'text' && stimulus.kind !== 'mixed') || hasBody(stimulus),\n    {\n      error: 'A text or mixed stimulus needs a non-empty body.',\n      path: ['body'],\n    },\n  )\n  .refine((stimulus) => stimulus.kind === 'text' || stimulus.media !== undefined, {\n    error: 'An audio, video, image or mixed stimulus needs media.',\n    path: ['media'],\n  })\n  .refine(\n    (stimulus) => stimulus.media === undefined || mediaFits(stimulus.kind, stimulus.media.type),\n    {\n      error:\n        'media.type does not fit the stimulus kind: audio needs audio; video needs video or embed; image needs image.',\n      path: ['media', 'type'],\n    },\n  );\n\n/**\n * The structural minimum of an item as seen by the CONTAINER schema. Each\n * item's own contract is checked against its registered schema by\n * {@link validateItemGroup} — a zod schema cannot dispatch on a registry\n * that consumers extend at runtime.\n */\nconst ItemShapeSchema = z.looseObject({\n  type: z.string().min(1),\n  id: z.string().min(1),\n  slotKey: SlotKeySchema.optional(),\n});\n\n/**\n * Zod schema for an {@link ItemGroup} CONTAINER. Loose: unknown keys\n * preserved. Validates the group's own fields and the stimulus in full, and\n * each item only structurally (`type` and `id`); use {@link validateItemGroup}\n * to validate the items against their registered schemas as well.\n */\nexport const ItemGroupSchema = z\n  .looseObject({\n    schemaVersion: z.literal('1.0'),\n    type: z.literal('item-group'),\n    id: z.string().min(1),\n    title: z.string().optional(),\n    slotKey: SlotKeySchema.optional(),\n    stimulus: StimulusSchema,\n    items: z.array(ItemShapeSchema).min(1),\n    shuffle: z.enum(['none', 'within-group']).optional(),\n  })\n  .refine((group) => group.items.every((item) => item.type !== 'item-group'), {\n    error: 'Item groups do not nest: every item must be an activity.',\n    path: ['items'],\n  })\n  .refine((group) => new Set(group.items.map((item) => item.id)).size === group.items.length, {\n    error: 'Item ids must be unique within a group.',\n    path: ['items'],\n  });\n\n/** The learner-safe shape of a stimulus, derived from the strict schema below. */\nexport type RedactedStimulus = z.infer<typeof RedactedStimulusSchema>;\n\n/** Strict learner-safe stimulus: everything but the author-only `transcript`. */\nexport const RedactedStimulusSchema = z.strictObject({\n  id: z.string().min(1),\n  kind: z.enum(['text', 'audio', 'video', 'image', 'mixed']),\n  title: z.string().optional(),\n  body: z.string().optional(),\n  bodyHtml: z.string().optional(),\n  media: RedactedMediaSchema.optional(),\n  locale: z.string().optional(),\n  attribution: z.string().optional(),\n});\n\n/**\n * Strict learner-safe item group. Items are left opaque here — each is proven\n * learner-safe by `assertRedacted` against its OWN type's redacted schema,\n * which is the only place that knowledge lives.\n */\nexport const RedactedItemGroupSchema = z.strictObject({\n  redacted: z.literal(true),\n  schemaVersion: z.literal('1.0'),\n  type: z.literal('item-group'),\n  id: z.string().min(1),\n  title: z.string().optional(),\n  slotKey: SlotKeySchema.optional(),\n  stimulus: RedactedStimulusSchema,\n  items: z.array(z.unknown()).min(1),\n  shuffle: z.enum(['none', 'within-group']).optional(),\n});\n\nfunction toValidationErrors(\n  issues: readonly { path: PropertyKey[]; message: string; code: string }[],\n  prefix: string[],\n): ValidationError[] {\n  return issues.map((issue) => ({\n    path: [...prefix, ...issue.path.map(String)],\n    message: issue.message,\n    code: issue.code,\n  }));\n}\n\n/**\n * Validates an item group in full: the container and stimulus against\n * {@link ItemGroupSchema}, then every item against the schema registered for\n * its `type`. Errors from items are reported at `items.<index>.…`.\n *\n * Unlike `validateActivity`, an item whose type is not registered is REPORTED\n * (code `unknown_activity_type`) rather than thrown: a group is validated as\n * a whole, and an author fixing a six-item group wants every problem listed,\n * not the first one that happened to throw.\n */\nexport function validateItemGroup(data: unknown): ValidationResult<ItemGroup> {\n  const container = ItemGroupSchema.safeParse(data);\n  if (!container.success) {\n    return { success: false, errors: toValidationErrors(container.error.issues, []) };\n  }\n\n  const errors: ValidationError[] = [];\n  const items: ActivityData[] = [];\n  container.data.items.forEach((item, index) => {\n    const descriptor = getActivityTypeDescriptor(item.type);\n    if (descriptor === undefined) {\n      errors.push({\n        path: ['items', String(index), 'type'],\n        message: `Activity type \"${item.type}\" is not registered`,\n        code: 'unknown_activity_type',\n      });\n      return;\n    }\n    const parsed = descriptor.schema.safeParse(item);\n    if (!parsed.success) {\n      errors.push(...toValidationErrors(parsed.error.issues, ['items', String(index)]));\n      return;\n    }\n    items.push(parsed.data as ActivityData);\n  });\n\n  if (errors.length > 0) {\n    return { success: false, errors };\n  }\n  // zod4 optional outputs are `T | undefined`; the wire type uses exact\n  // optionals. Structurally identical at runtime — the cast is type-level.\n  return { success: true, data: { ...container.data, items } as unknown as ItemGroup };\n}\n","import { z } from 'zod/v4';\nimport { UnknownActivityTypeError } from '../errors.js';\nimport { getActivityTypeDescriptor } from '../registry/index.js';\nimport { FillInTheBlanksDataSchema } from './fill-in-the-blanks.js';\nimport { GapSelectDataSchema } from './gap-select.js';\nimport { ItemGroupSchema, StimulusSchema } from './item-group.js';\nimport { MultipleChoiceDataSchema } from './multiple-choice.js';\nimport { WrittenResponseDataSchema } from './written-response.js';\n\n/**\n * JSON Schema (Draft 7) for a `Stimulus`. Structural contract only — the\n * kind/media/body consistency guards are Zod-only.\n */\nexport const stimulusJsonSchema = z.toJSONSchema(StimulusSchema, { target: 'draft-7' });\n\n/**\n * JSON Schema (Draft 7) for an `ItemGroup` CONTAINER. Items appear as objects\n * with `type` and `id` only; each item's own contract is `jsonSchemaFor(type)`.\n * For an AI generation pipeline, ask for the group and each item separately\n * rather than a single nested schema — that keeps the per-type schema the\n * registry's, not a copy.\n */\nexport const itemGroupJsonSchema = z.toJSONSchema(ItemGroupSchema, { target: 'draft-7' });\n\n/**\n * JSON Schema (Draft 7) representation of the Multiple Choice activity data\n * contract, generated natively by Zod 4. Draft 7 is mandated by Requirement\n * 2.2 for the widest AI-prompt / OpenAPI tooling compatibility. The semantic\n * `.refine()` guards are not representable in JSON Schema and are\n * intentionally omitted — the export captures the *structural* contract only.\n * Since v0.3 the source schemas are loose, so these no longer emit\n * `additionalProperties: false` — the JSON Schema and `validateActivity` now\n * agree on unknown-key handling.\n */\n/**\n * JSON Schema (Draft 7) representation of the Gap Select activity data\n * contract. Structural contract only: the six semantic guards — the\n * passage/gap bijection, id uniqueness, the one-choice-source rule, and an\n * answer key that names a choice the gap offers — are Zod-only, as they are\n * for the other types.\n */\nexport const gapSelectJsonSchema = z.toJSONSchema(GapSelectDataSchema, {\n  target: 'draft-7',\n});\n\nexport const multipleChoiceJsonSchema = z.toJSONSchema(MultipleChoiceDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * JSON Schema (Draft 7) representation of the Fill-in-the-Blanks activity data\n * contract, generated natively by Zod 4. Structural contract only (semantic\n * `.refine()` guards are Zod-only and not representable in JSON Schema).\n */\nexport const fillInTheBlanksJsonSchema = z.toJSONSchema(FillInTheBlanksDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * JSON Schema (Draft 7) representation of the Written Response activity data\n * contract. Structural contract only.\n */\nexport const writtenResponseJsonSchema = z.toJSONSchema(WrittenResponseDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * Derives the JSON Schema (Draft 7) for any REGISTERED activity type — the\n * live, registry-backed replacement for the static per-type exports above,\n * and the building block for AI generation pipelines (R6.1): pass the result\n * as a structured-output schema so a model can only emit valid items.\n *\n * @throws UnknownActivityTypeError when `type` has no registered descriptor.\n */\nexport function jsonSchemaFor(type: string): Record<string, unknown> {\n  const descriptor = getActivityTypeDescriptor(type);\n  if (descriptor === undefined) {\n    throw new UnknownActivityTypeError(type);\n  }\n  return z.toJSONSchema(descriptor.schema as never, { target: 'draft-7' }) as Record<\n    string,\n    unknown\n  >;\n}\n","import { UnknownActivityTypeError } from '../errors.js';\nimport { getActivityTypeDescriptor } from '../registry/index.js';\nimport type { ActivityDataMap, ActivityType, ValidationResult } from '../types/activity.js';\n\nexport { FeedbackSchema } from './feedback.js';\nexport {\n  BlankConfigSchema,\n  FillInTheBlanksDataSchema,\n  TextMatchPolicySchema,\n} from './fill-in-the-blanks.js';\nexport {\n  GapSelectBankSchema,\n  GapSelectChoiceSchema,\n  GapSelectDataSchema,\n  GapSelectGapSchema,\n} from './gap-select.js';\nexport type { RedactedStimulus } from './item-group.js';\nexport {\n  ItemGroupSchema,\n  RedactedItemGroupSchema,\n  RedactedStimulusSchema,\n  StimulusSchema,\n  validateItemGroup,\n} from './item-group.js';\nexport {\n  fillInTheBlanksJsonSchema,\n  gapSelectJsonSchema,\n  itemGroupJsonSchema,\n  jsonSchemaFor,\n  multipleChoiceJsonSchema,\n  stimulusJsonSchema,\n  writtenResponseJsonSchema,\n} from './json-schema.js';\nexport {\n  MediaPlaybackSchema,\n  MediaSchema,\n  MediaUrlSchema,\n  NativeControlHintSchema,\n  RedactedMediaSchema,\n} from './media.js';\nexport {\n  MultipleChoiceDataSchema,\n  MultipleChoiceOptionMediaSchema,\n  MultipleChoiceOptionSchema,\n} from './multiple-choice.js';\nexport type {\n  RedactedActivity,\n  RedactedBlankConfig,\n  RedactedFillInTheBlanksData,\n  RedactedGapSelectBank,\n  RedactedGapSelectChoice,\n  RedactedGapSelectData,\n  RedactedGapSelectGap,\n  RedactedMultipleChoiceData,\n  RedactedMultipleChoiceOption,\n  RedactedMultipleChoiceOptionMedia,\n  RedactedWrittenResponseData,\n} from './redacted.js';\nexport {\n  RedactedBlankConfigSchema,\n  RedactedFillInTheBlanksDataSchema,\n  RedactedGapSelectBankSchema,\n  RedactedGapSelectChoiceSchema,\n  RedactedGapSelectDataSchema,\n  RedactedGapSelectGapSchema,\n  RedactedMultipleChoiceDataSchema,\n  RedactedMultipleChoiceOptionMediaSchema,\n  RedactedMultipleChoiceOptionSchema,\n  RedactedWrittenResponseDataSchema,\n} from './redacted.js';\nexport {\n  WrittenResponseDataSchema,\n  WrittenResponseRubricCriterionSchema,\n  WrittenResponseRubricSchema,\n} from './written-response.js';\n\n/**\n * Validates raw activity data against the schema registered for the given\n * activity type (built-in or consumer-registered via `registerActivityType`).\n *\n * Unknown keys are PRESERVED, not stripped: every built-in schema is loose,\n * so consumer sidecar fields and forward-version fields survive validation\n * verbatim in the returned `data`.\n *\n * @returns `{ success: true, data }` with the typed, validated data, or\n *          `{ success: false, errors }` with one entry per failed constraint.\n * @throws UnknownActivityTypeError when `type` has no registered descriptor.\n */\nexport function validateActivity<T extends ActivityType>(\n  type: T,\n  data: unknown,\n): ValidationResult<ActivityDataMap[T]> {\n  const descriptor = getActivityTypeDescriptor(type);\n  if (descriptor === undefined) {\n    throw new UnknownActivityTypeError(String(type));\n  }\n\n  const result = descriptor.schema.safeParse(data);\n\n  if (result.success) {\n    return { success: true, data: result.data as ActivityDataMap[T] };\n  }\n\n  return {\n    success: false,\n    errors: result.error.issues.map((issue) => ({\n      path: issue.path.map(String),\n      message: issue.message,\n      code: issue.code,\n    })),\n  };\n}\n"]}