@intellectif/lk-core 1.3.0 → 1.4.0

package/dist/{ai-B222dtHH.d.cts → ai-CnmLPMzd.d.ts}

@@ -1491,6 +1491,220 @@ interface DraftContext {
   newId: () => string;
 }
 //#endregion
+//#region src/types/item-group.d.ts
+/** What a stimulus primarily is. Drives validation and layout, never scoring. */
+type StimulusKind = 'text' | 'audio' | 'video' | 'image' | 'mixed';
+/**
+ * Shared material that several items refer to: a reading passage, a
+ * recording, a chart. Modelled as CONTENT — it lives inside the item group
+ * that carries it — so it works in a lesson quiz, a sequence and an exam
+ * section alike, and needs no blueprint to exist.
+ *
+ * Learner-visible by definition: the point of a stimulus is that the learner
+ * reads or hears it. The one exception is `transcript`, an author asset that
+ * `redactItemGroup` removes.
+ */
+interface Stimulus {
+  id: string;
+  kind: StimulusKind;
+  /** Optional heading (a passage title). */
+  title?: string;
+  /**
+   * Plain-text body: the passage itself, or short instructions above media.
+   * Required for `text` and `mixed`.
+   */
+  body?: string;
+  /**
+   * Optional sanitised rich-HTML sidecar of `body`. Requires `body`, which is
+   * the accessible fallback rendered when no sanitiser is supplied.
+   */
+  bodyHtml?: string;
+  /** The recording, video or image. Required for `audio`, `video`, `image` and `mixed`. */
+  media?: ActivityMedia;
+  /**
+   * Author-only transcript of `media` — for item generation and grading,
+   * never shown to the learner. Removed by `redactItemGroup`.
+   */
+  transcript?: string;
+  /** BCP 47 language tag of the material, when it differs from the items'. */
+  locale?: string;
+  /** Source credit, shown to the learner after the material. */
+  attribution?: string;
+}
+/**
+ * A quiz inside an interactive video: one moment of the video, and the
+ * questions shown there. The video pauses when playback reaches `at`, and the
+ * questions are shown one at a time, in `itemIds` order.
+ */
+interface TimelineCue {
+  /** Unique within the timeline. Names the quiz in events, the contents panel and drafts. */
+  id: string;
+  /**
+   * Seconds from the start of the video: finite and 0 or more. The SDK never
+   * reads the video, so it cannot check this against the duration: a quiz at
+   * or past the end opens when the video ends.
+   */
+  at: number;
+  /**
+   * `id`s of items in this group, in the order the quiz shows them. Non-empty.
+   * Every item of the group belongs to exactly one quiz.
+   */
+  itemIds: string[];
+  /** Optional heading shown above the questions. At most 120 characters. */
+  title?: string;
+  /**
+   * Every question must be answered (practice) or submitted (exam) before
+   * playback may pass `at`. Default false.
+   */
+  required?: boolean;
+}
+/** A titled section of the video. */
+interface TimelineChapter {
+  /** Seconds from the start: finite, 0 or more, strictly increasing across the list. */
+  at: number;
+  /** Non-empty after trimming; at most 120 characters. */
+  title: string;
+}
+/**
+ * The arrangement that turns an item group with a video stimulus into an
+ * interactive video: when each quiz opens, the video's chapters, and how far
+ * ahead a learner may seek.
+ *
+ * It lives on the container rather than inside `stimulus` because it describes
+ * how THESE questions are arranged over the material, not the material itself.
+ */
+interface MediaTimeline {
+  cues: TimelineCue[];
+  chapters?: TimelineChapter[];
+  /**
+   * `free` (default): seek anywhere. `no-skip-ahead`: rewind freely, never past
+   * the furthest point reached. Either way, playback never passes a `required`
+   * quiz that is not finished.
+   */
+  navigation?: 'free' | 'no-skip-ahead';
+}
+/**
+ * Where a learner stands in an interactive video, stored by the host so the
+ * video can resume. Kept apart from `AttemptState`, which holds answers by slot
+ * and drops fields it does not know. Read it back through
+ * `readMediaProgress`, never directly.
+ */
+interface MediaProgress {
+  progressVersion: '1.0';
+  /** Seconds: where playback last stood. */
+  at: number;
+  /**
+   * Seconds: the furthest point reached. Decides how far `no-skip-ahead` lets
+   * the learner seek, and how much of the transcript it shows.
+   */
+  furthest: number;
+}
+/**
+ * One stimulus serving several items. Two rules, both taken from observed
+ * failures: a group is SHUFFLE-ATOMIC (shuffling a sequence moves the group
+ * as one block — interleaving two passages' questions is the defect), and its
+ * stimulus is presented persistently alongside every item, never behind a
+ * toggle the learner must reopen per question.
+ *
+ * Generic over the item type so one shape describes a group of full activity
+ * data (authoring, server) and a group of `redact()` projections (client)
+ * without a cast at every boundary.
+ */
+interface ItemGroup<TItem = ActivityData> {
+  schemaVersion: '1.0';
+  type: 'item-group';
+  id: string;
+  title?: string;
+  /**
+   * Stable identity for this entry's slots, independent of where it sits in
+   * the array. See {@link SequenceSlot.slotId}: without one, inserting a
+   * question above this group re-maps every slot id beneath it, and stored
+   * grades quietly start naming different questions.
+   */
+  slotKey?: string;
+  stimulus: Stimulus;
+  /**
+   * The items, in authored order. Non-empty; ids unique within the group; no
+   * nested groups.
+   *
+   * An item may declare its own `slotKey`, for the same reason an entry can:
+   * it pins the item's identity within the group (`"reading.q1"` rather than
+   * `"reading.0"`), so inserting a question into a published group does not
+   * re-map the ones after it.
+   */
+  items: (TItem & {
+    slotKey?: string;
+  })[];
+  /**
+   * `none` (default) keeps authored order; `within-group` shuffles the items
+   * among themselves under the sequence seed. Either way the group stays one
+   * contiguous block.
+   */
+  shuffle?: 'none' | 'within-group';
+  /**
+   * Makes the group an interactive video: the stimulus must be a video, every
+   * item must be one of `INTERACTIVE_VIDEO_ITEM_TYPES`, and every item belongs
+   * to exactly one quiz. Items are then presented in quiz order, never
+   * shuffled. An older lk-core that does not know this field presents the same
+   * items as an ordinary video testlet, with the same slots and grades.
+   */
+  timeline?: MediaTimeline;
+}
+/**
+ * What a sequence is made of: loose activities and item groups, in authored
+ * order.
+ *
+ * A plain activity may carry `slotKey` here even though no activity SCHEMA
+ * declares one, because a slot key describes an item's PLACE in a paper, not
+ * its content — the same question keeps its own id in every paper it appears
+ * in. Putting it on the entry rather than on the activity is what lets it be
+ * authored without every activity type having to know about assessment
+ * assembly. See {@link SequenceSlot.slotId}.
+ */
+type SequenceEntry<TItem = ActivityData> = (TItem & {
+  slotKey?: string;
+}) | ItemGroup<TItem>;
+/** The group a presented slot belongs to. */
+interface SequenceSlotGroup {
+  id: string;
+  title?: string;
+  stimulus: Stimulus;
+  /** 0-based position of this slot within the group's PRESENTED order. */
+  position: number;
+  /** Number of slots in the group. */
+  size: number;
+  /** The group's timeline, when the group is an interactive video. */
+  timeline?: MediaTimeline;
+  /** The quiz this slot's item sits in, when the group is an interactive video. */
+  cue?: TimelineCue;
+}
+/** One presented position in a flattened sequence. */
+interface SequenceSlot<TItem = ActivityData> {
+  /**
+   * Identity of the slot within the sequence definition — unique, and stable
+   * under shuffling. Feed it to `composeAssessmentScore` as `slotId`.
+   *
+   * By default it is derived from the AUTHORED position (`"2"` for the third
+   * top-level entry; `"2.1"` for the second item of that entry when it is a
+   * group), so the same activity can appear in two entries and still be two
+   * slots.
+   *
+   * **A positional id is only valid against one version of the entries
+   * array.** Insert a question at the top of a published paper and every id
+   * below it shifts: rows stored as `"3"` now name what used to be entry 2,
+   * and a re-grade or a review render pairs each response with the wrong
+   * question — silently, because the ids still look valid. For any content
+   * whose slot ids you persist, give the entries an explicit `slotKey`; it is
+   * used verbatim here and survives insertion, deletion and re-ordering.
+   */
+  slotId: string;
+  /** 0-based PRESENTED position, after shuffling. */
+  index: number;
+  activity: TItem;
+  /** Present when the slot comes from an item group. */
+  group?: SequenceSlotGroup;
+}
+//#endregion
 //#region src/types/ai.d.ts
 /**
  * What an author allows AI to do for one item. Absent, or a feature left out,
@@ -1629,6 +1843,46 @@ interface AiDictationFacts extends AiFactsBase {
  * learner saw it, what they answered, and — part by part — the SDK's verdict.
  */
 type AiItemFacts = AiMultipleChoiceFacts | AiFillInTheBlanksFacts | AiGapSelectFacts | AiDictationFacts;
+/**
+ * The item group a question sits in, as a renderer holds it: an `ItemGroup`,
+ * a redacted one, a sequence slot's `group`, or a host's own object with the
+ * same two fields. Structural, and read defensively, like
+ * {@link AiActivityInput}: a group whose material cannot be read gives none.
+ */
+interface AiGroupInput {
+  readonly title?: unknown;
+  readonly stimulus?: unknown;
+}
+/**
+ * What a model is told about the material of the group a question sits in:
+ * what the learner reads and sees beside the question — a passage, or the
+ * instructions a run of questions shares. Never a media address, and never
+ * the author-only transcript: the same facts whether the group is whole or
+ * redacted.
+ */
+interface AiMaterialFacts {
+  /** What the material primarily is. */
+  kind: StimulusKind;
+  /** The material's heading, or the group's title when it has none. */
+  title?: string;
+  /**
+   * The text beside the questions, as plain text: the passage, or the
+   * instructions above a recording or image. Cut past `AI_MATERIAL_MAX_LENGTH`
+   * code points, at a word boundary where there is one.
+   */
+  text?: string;
+  /** Present when `text` was cut: the model is given only its start. */
+  truncated?: true;
+  /** The recording, video or image, without its address. An image's `alt` says what it shows. */
+  media?: {
+    type: ActivityMedia['type'];
+    alt?: string;
+  };
+  /** The source credit the learner sees after the material. */
+  attribution?: string;
+  /** The language of the material, when the author gave one. */
+  locale?: string;
+}
 /**
  * Asks for an explanation of a graded answer. Sent after the SDK has graded
  * it, so `grade` is always present, and an explanation that contradicts
@@ -1638,6 +1892,8 @@ interface AiExplanationRequest {
   feature: 'explanation';
   facts: AiItemFacts;
   grade: AiGrade;
+  /** The material of the group the question sits in; absent outside a group. */
+  material?: AiMaterialFacts;
   /** The language to answer in: the learner's interface language, when known. */
   learnerLocale?: string;
 }
@@ -1653,6 +1909,8 @@ interface AiHintRequest {
   hintNumber: number;
   /** The hints already shown for this item, oldest first. */
   previousHints: string[];
+  /** The material of the group the question sits in; absent outside a group. */
+  material?: AiMaterialFacts;
   learnerLocale?: string;
 }
 /** What produced an AI text, for the record a host keeps. */
@@ -1735,6 +1993,11 @@ interface AiWritingFeedbackRequest {
   draftNumber: number;
   /** The text of the feedback already shown on earlier drafts, oldest first. */
   previousFeedback: string[];
+  /**
+   * The material of the group the task sits in — the text a summary is of —
+   * absent outside a group.
+   */
+  material?: AiMaterialFacts;
   /** The language to write in: the learner's interface language, when known. */
   learnerLocale?: string;
 }
@@ -2150,5 +2413,5 @@ interface AiVideoDraft {
   findings: ItemFinding[];
 }
 //#endregion
-export { DraftComplete as $, WrittenResponseLearnerResponse as $t, AiGapSelectFacts as A, ItemOutcome as At, AiRefusal as B, ReadAloudData as Bt, AiDraftsCall as C, GapSelectBank as Ct, AiFeature as D, GapSelectLearnerResponse as Dt, AiExplanationRequest as E, GapSelectGap as Et, AiMultipleChoiceFacts as F, MultipleChoiceData as Ft, AiVerdict as G, RecordingBounds as Gt, AiSoundFact as H, ReadAloudDimensionWeight as Ht, AiOptionFact as I, MultipleChoiceLearnerResponse as It, AiWritingCorrection as J, ScoringOutcome as Jt, AiVideoDraft as K, RecordingRef as Kt, AiProvenance as L, MultipleChoiceOption as Lt, AiGrade as M, LearnerResponseMap as Mt, AiHintRequest as N, MediaPlaybackPolicy as Nt, AiFillInTheBlanksFacts as O, InteractionEvent as Ot, AiItemFacts as P, MediaTrack as Pt, AiWritingFeedbackResult as Q, WrittenResponseData as Qt, AiReadingFacts as R, MultipleChoiceOptionMedia as Rt, AiDrafts as S, matchText as Sn, FillInTheBlanksLearnerResponse as St, AiDraftsRun as T, GapSelectData as Tt, AiSupportedActivityType as U, ReadAloudLearnerResponse as Ut, AiRubricCriterionFact as V, ReadAloudDimension as Vt, AiTextResult as W, ReadAloudSlowMedia as Wt, AiWritingFeedback as X, ValidationError as Xt, AiWritingFacts as Y, ScoringResult as Yt, AiWritingFeedbackRequest as Z, ValidationResult as Zt, AiDraftCaption as _, GradingState as _n, DictationEquivalence as _t, AiCoachingRequest as a, XAPIContextActivities as an, ItemFinding as at, AiDraftSource as b, TextMatchResult as bn, DictationTolerance as bt, AiCriterionJudgement as c, XAPIResult as cn, ActivityDataMap as ct, AiCritiqueFinding as d, XAPIVerbObject as dn, ActivityResult as dt, WrittenResponseRubric as en, DraftContext as et, AiCritiqueFindingResult as f, CriterionScore as fn, ActivityType as ft, AiDictationFacts as g, GraderUsage as gn, DictationData as gt, AiCritiqueResult as h, GraderKind as hn, DeferredScoringPartial as ht, AiCoaching as i, XAPIContext as in, DraftValidationResult as it, AiGeneratedDraft as j, LearnerResponse as jt, AiGapFact as k, InteractionKind as kt, AiCritique as l, XAPIScore as ln, ActivityFeedback as lt, AiCritiqueRequest as m, Grader as mn, DeferredReason as mt, AiActivityInput as n, XAPIActor as nn, DraftNotComplete as nt, AiCoachingResult as o, XAPIError as on, ItemFindingSeverity as ot, AiCritiqueKind as p, GradeRecord as pn, BlankConfig as pt, AiWordFact as q, ScoringDetail as qt, AiBlankFact as r, XAPIConfig as rn, DraftSeverity as rt, AiCoachingWord as s, XAPIObject as sn, ActivityData as st, ActivityAiPermissions as t, WrittenResponseRubricCriterion as tn, DraftIssue as tt, AiCritiqueField as u, XAPIStatement as un, ActivityMedia as ut, AiDraftProblem as v, InlineCorrection as vn, DictationLearnerResponse as vt, AiDraftsRequest as w, GapSelectChoice as wt, AiDraftType as x, levenshteinDistance as xn, FillInTheBlanksData as xt, AiDraftSettings as y, TextMatchPolicy as yn, DictationSlowMedia as yt, AiReadingWordFact as z, NativeControlHint as zt };
-//# sourceMappingURL=ai-B222dtHH.d.cts.map
+export { AiWritingFeedbackRequest as $, ReadAloudDimension as $t, AiGapSelectFacts as A, InlineCorrection as An, DictationLearnerResponse as At, AiReadingFacts as B, InteractionEvent as Bt, AiDraftsCall as C, XAPIVerbObject as Cn, ActivityResult as Ct, AiFeature as D, GraderKind as Dn, DeferredScoringPartial as Dt, AiExplanationRequest as E, Grader as En, DeferredReason as Et, AiItemFacts as F, GapSelectBank as Ft, AiSupportedActivityType as G, MediaPlaybackPolicy as Gt, AiRefusal as H, ItemOutcome as Ht, AiMaterialFacts as I, GapSelectChoice as It, AiVideoDraft as J, MultipleChoiceLearnerResponse as Jt, AiTextResult as K, MediaTrack as Kt, AiMultipleChoiceFacts as L, GapSelectData as Lt, AiGrade as M, TextMatchResult as Mn, DictationTolerance as Mt, AiGroupInput as N, levenshteinDistance as Nn, FillInTheBlanksData as Nt, AiFillInTheBlanksFacts as O, GraderUsage as On, DictationData as Ot, AiHintRequest as P, matchText as Pn, FillInTheBlanksLearnerResponse as Pt, AiWritingFeedback as Q, ReadAloudData as Qt, AiOptionFact as R, GapSelectGap as Rt, AiDrafts as S, XAPIStatement as Sn, ActivityMedia as St, AiDraftsRun as T, GradeRecord as Tn, BlankConfig as Tt, AiRubricCriterionFact as U, LearnerResponse as Ut, AiReadingWordFact as V, InteractionKind as Vt, AiSoundFact as W, LearnerResponseMap as Wt, AiWritingCorrection as X, MultipleChoiceOptionMedia as Xt, AiWordFact as Y, MultipleChoiceOption as Yt, AiWritingFacts as Z, NativeControlHint as Zt, AiDraftCaption as _, XAPIContextActivities as _n, ItemFinding as _t, AiCoachingRequest as a, ScoringDetail as an, SequenceSlot as at, AiDraftSource as b, XAPIResult as bn, ActivityDataMap as bt, AiCriterionJudgement as c, ValidationError as cn, StimulusKind as ct, AiCritiqueFinding as d, WrittenResponseLearnerResponse as dn, DraftComplete as dt, ReadAloudDimensionWeight as en, AiWritingFeedbackResult as et, AiCritiqueFindingResult as f, WrittenResponseRubric as fn, DraftContext as ft, AiDictationFacts as g, XAPIContext as gn, DraftValidationResult as gt, AiCritiqueResult as h, XAPIConfig as hn, DraftSeverity as ht, AiCoaching as i, RecordingRef as in, SequenceEntry as it, AiGeneratedDraft as j, TextMatchPolicy as jn, DictationSlowMedia as jt, AiGapFact as k, GradingState as kn, DictationEquivalence as kt, AiCritique as l, ValidationResult as ln, TimelineChapter as lt, AiCritiqueRequest as m, XAPIActor as mn, DraftNotComplete as mt, AiActivityInput as n, ReadAloudSlowMedia as nn, MediaProgress as nt, AiCoachingResult as o, ScoringOutcome as on, SequenceSlotGroup as ot, AiCritiqueKind as p, WrittenResponseRubricCriterion as pn, DraftIssue as pt, AiVerdict as q, MultipleChoiceData as qt, AiBlankFact as r, RecordingBounds as rn, MediaTimeline as rt, AiCoachingWord as s, ScoringResult as sn, Stimulus as st, ActivityAiPermissions as t, ReadAloudLearnerResponse as tn, ItemGroup as tt, AiCritiqueField as u, WrittenResponseData as un, TimelineCue as ut, AiDraftProblem as v, XAPIError as vn, ItemFindingSeverity as vt, AiDraftsRequest as w, CriterionScore as wn, ActivityType as wt, AiDraftType as x, XAPIScore as xn, ActivityFeedback as xt, AiDraftSettings as y, XAPIObject as yn, ActivityData as yt, AiProvenance as z, GapSelectLearnerResponse as zt };
+//# sourceMappingURL=ai-CnmLPMzd.d.ts.map

package/dist/ai-CnmLPMzd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-CnmLPMzd.d.ts","names":[],"sources":["../src/scoring/text-match.ts","../src/types/grading.ts","../src/types/xapi.ts","../src/types/activity.ts","../src/types/authoring.ts","../src/types/item-group.ts","../src/types/ai.ts"],"mappings":";;;;;;;;;UAQiB;;EAEf;;EAEA;;;;;;;EAOA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;EAKA;;;;;;;;;;;;UAae;EACf;EACA;;;;;;iBAmDc,oBAAoB,WAAW,WAAW;;;;;;;;;;;iBAoC1C,UACd,eACA,sCACA,SAAQ,kBACP;;;;;;;;KCrHS;;;;;;;;;KAUA;;UAGK;EACf,MAAM;;EAEN;;EAEA;;EAEA;;;UAIe;EACf;EACA;EACA;;;UAIe;;EAEf;;;;;;EAMA;;;;;;;;;;;;;;;;EAgBA;;EAEA;;EAEA;;;;;;EAMA;;EAEA;;;UAIe;;EAEf;;EAEA;EACA;;EAEA;IAAU;IAAe;;;EAEzB;;;;;;;;;;;;;UAce;EACf;EACA;EACA;;EAEA;;EAEA,WAAW;;;;;;EAMX,UAAU;;EAEV,cAAc;;EAEd;;EAEA;;EAEA;;EAEA;EACA,SAAS;EACT,QAAQ;;EAER;;;;;;;;UC1Ie;EACf;;EAEA;EACA;;IAEE,OAAO;;IAEP,cAAc;;IAEd;;IAEA;;IAEA;;IAEA,UAAU;MAAQ;MAAY,cAAc;;IAC5C,aAAa;;;;;;;UAQA;EACf;;EAEA;;EAEA;;EAEA;;IAEE;;IAEA;;;;UAKa;;EAEf;;EAEA,SAAS;;;UAIM;;EAEf;;EAEA;;EAEA;;EAEA;;;UAIe;EACf,QAAQ;;EAER;;EAEA;;EAEA;;EAEA;EACA,aAAa;;;UAIE;;EAEf,SAAS;;EAET,WAAW;;EAEX,WAAW;;EAEX,QAAQ;;;UAIO;;EAEf;;EAEA;;EAEA,oBAAoB;EACpB,aAAa;;;UAIE;;EAEf;EACA,OAAO;EACP,MAAM;EACN,QAAQ;EACR,SAAS;EACT,UAAU;;EAEV;EACA;;;;;;UAOe;;EAEf;;EAEA;IAAQ;IAAe;IAAkB;;IAAuB;IAAgB;;;;;;;;;;;;;;;;;EAgBhF,uBAAuB;EACvB,OAAO;;EAEP,WAAW,KAAK;;;UAID;;EAEf,WAAW;;EAEX;;EAEA;;EAEA;;;;;;;;;;;;;;;;;;;UCtIe;EACf,mBAAmB;EACnB,sBAAsB;EACtB,oBAAoB;EACpB,cAAc;EACd,WAAW;EACX,cAAc;;;;;;KAOJ,qBAAqB;;KAGrB,eAAe,gBAAgB;;UAG1B;EACf;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;UAOe;;EAEf;;;;;EAKA;;EAEA;;EAEA;;;;;;;EAOA,SAAS;;EAET;;;;;;EAMA,WAAW;;;;;;;;;;KAWD;;;;;;;;;;;;UAaK;;;;;;EAMf;;;;;;;;;;;EAWA;;EAEA;;EAEA;;EAEA,qBAAqB;;;;;;;UAQN;;EAEf;;EAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAkCe;;EAEf;;EAEA;;EAEA;;EAEA;;UAGe;;EAEf;;;;;;;;;EASA;;EAEA;;EAEA;;EAEA,QAAQ;;;UAIO;EACf;EACA;;EAEA;;EAEA;;EAEA;;;;;;;;EAQA;;EAEA;;EAEA,SAAS;;EAET;;EAEA,QAAQ;;EAER,WAAW;;EAEX;;;;;;;;;;EAUA;;EAEA;;EAEA;;EAEA;;EAEA,KAAK;;;UAIU;;EAEf;;EAEA;;;;;;;EAOA;;;;;;;EAOA;;;;;;;;EAQA,QAAQ;;EAER;;EAEA;;;;UAKe;;EAEf;;EAEA;;;;;;;;;;;UAYe;;EAEf;;EAEA,SAAS;;;;;;;;;;UAWM;;EAEf;;EAEA,UAAU;;EAEV;;EAEA;;EAEA;;;;;;;;;;;;;;;UAgBe;EACf;EACA;;EAEA;;EAEA;;EAEA;;;;;;;EAOA;;EAEA,MAAM;;EAEN,QAAQ;;EAER;;;;;;;;;;;;EAYA;;;;;;;;EAQA;;EAEA,QAAQ;;EAER,WAAW;;EAEX;;EAEA;;EAEA;;EAEA;;EAEA,KAAK;;UAGU;EACf;EACA;;EAEA;;EAEA;;EAEA;;;;;;EAMA;;EAEA,QAAQ;;EAER;;EAEA,QAAQ;;EAER,WAAW;;EAEX;;EAEA;;EAEA;;EAEA;;EAEA,KAAK;;;UAIU;;EAEf;;EAEA;;EAEA;;;UAIe;;EAEf;;EAEA,UAAU;;;;;;;;;;;;UAaK;EACf;EACA;;EAEA;;EAEA;;EAEA;;;;;;EAMA;;EAEA;;EAEA;;EAEA,SAAS;;EAET;;EAEA,QAAQ;;EAER,WAAW;;EAEX;;EAEA;;EAEA;;EAEA;;EAEA,KAAK;;;;;;;;;UAUU;EACf;;EAEA;;EAEA;;;;;;;;;;UAWe;;EAEf;;EAEA;;;UAIe;;EAEf,eAAe;;;;;;;;;;;;;;;;UAiBA;EACf;EACA;;EAEA;;;;;EAKA;;;;;;EAMA;;;;;;;;EAQA;;;;;;;EAOA,QAAQ;;EAER,YAAY;;;;;;;EAOZ;IAAU;;;EAEV,YAAY;;EAEZ,WAAW;;EAEX;;EAEA;;EAEA;;EAEA;;EAEA,KAAK;;;KAIK;;UAGK;EACf,MAAM;;;;;EAKN;;;;;;;UAQe;;EAEf;;EAEA;;EAEA;;;;;;;;UASe;EACf;;EAEA;;EAEA;;;;;;;;;;;UAYe;EACf;EACA;;EAEA;;EAEA;;EAEA;;;;;;EAMA;;;;;EAKA;;EAEA,QAAQ;;EAER,YAAY;;EAEZ,WAAW;;;;;;;EAOX;IAAW,YAAY;;;EAEvB;;EAEA,WAAW;;EAEX;;EAEA;;EAEA,KAAK;;;;;;UAOU;EACf,mBAAmB;EACnB,sBAAsB;EACtB,oBAAoB;EACpB,cAAc;EACd,WAAW;EACX,cAAc;;;KAIJ,kBAAkB,yBAAyB;;UAGtC;EACf;;EAEA;;;;;;;;EAQA;;;UAIe;EACf;;EAEA,SAAS;;;;;;;;EAQT;;;;;;;;;;;UAYe;EACf;;EAEA,YAAY;;;;;;;;EAQZ;;;UAIe;EACf;;EAEA;;EAEA;;;;;;;;;;UAWe;EACf;;EAEA;;;;;EAKA;;;;;;;UAQe;EACf;;EAEA;EACA;;;;;;UAOe;EACf;;EAEA,WAAW;;EAEX;;;;;;;;;;KAWU;;UAGK;;EAEf;;;;;;;;;;;;EAYA,SAAS;;EAET;;EAEA;;;;;EAKA;;;;;;;;;EASA;;;UAIe;;EAEf;;EAEA;;EAEA;;;;;;EAMA;;EAEA,SAAS;;;;;;;;UASM;;EAEf;;EAEA;GACC;;;;;;;;;;;;;;;;;;;KAoBS;;;;;;;KAQA;EAEN;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;EAGT;;EAEA,QAAQ;;EAER;;EAEA,UAAU;;;;;;EAMV,gBAAgB;;EAGhB;;;;;;EAMA,OAAO;;EAEP;EACA;EACA;;EAEA;;EAGA;;EAEA;;EAEA;;;;;EAKA;;;UAIW;;EAEf;;EAEA;;EAEA;;;;;;;KAQU,iBAAiB;EACvB;EAAe,MAAM;;EACrB;EAAgB,QAAQ;;;UAGb;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA,eAAe;;;;;;;KAQL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAyGK;;EAEf,MAAM;;EAEN;;EAEA;;EAEA,SAAS;;;;;;;;;;;;;;KCzmCC;;;;;UAMK,mBAAmB;EAClC,UAAU;;;UAIK,cAAc;EAC7B;;EAEA,MAAM;;EAEN,QAAQ;;;;;;;UAQO;EACf;EACA,QAAQ;;;;;;;;;;KAWE,sBAAsB,KAAK,cAAc,KAAK;;;;;;;;;;;;KAa9C;;;;;;UAOK,oBAAoB;EACnC,UAAU;;;UAIK;;;;;;;EAOf;;;;;KC9EU;;;;;;;;;;;UAYK;EACf;EACA,MAAM;;EAEN;;;;;EAKA;;;;;EAKA;;EAEA,QAAQ;;;;;EAKR;;EAEA;;EAEA;;;;;;;UAQe;;EAEf;;;;;;EAMA;;;;;EAKA;;EAEA;;;;;EAKA;;;UAIe;;EAEf;;EAEA;;;;;;;;;;UAWe;EACf,MAAM;EACN,WAAW;;;;;;EAMX;;;;;;;;UASe;EACf;;EAEA;;;;;EAKA;;;;;;;;;;;;;UAce,UAAU,QAAQ;EACjC;EACA;EACA;EACA;;;;;;;EAOA;EACA,UAAU;;;;;;;;;;EAUV,QAAQ;IAAU;;;;;;;EAMlB;;;;;;;;EAQA,WAAW;;;;;;;;;;;;;KAcD,cAAc,QAAQ,iBAAiB;EAAU;KAAsB,UAAU;;UAG5E;EACf;EACA;EACA,UAAU;;EAEV;;EAEA;;EAEA,WAAW;;EAEX,MAAM;;;UAIS,aAAa,QAAQ;;;;;;;;;;;;;;;;;;EAkBpC;;EAEA;EACA,UAAU;;EAEV,QAAQ;;;;;;;;;;;;;UCjMO;;;;;;EAMf;;EAEA;;;;;;;;UASe;WACN;WACA;WACA;WACA;WACA;WACA;;;KAIC;;KAGA;;;;;UAUK;EACf;EACA;EACA;EACA,UAAU;;;KAIA;UAEF;EACR;EACA;;EAEA;;;UAIe;EACf;EACA;EACA;;EAEA;;EAEA;;UAGe,8BAA8B;EAC7C;EACA;EACA;EACA,SAAS;;;UAIM;EACf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;UAGe,+BAA+B;EAC9C;;EAEA;EACA,QAAQ;;;UAIO;EACf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;UAGe,yBAAyB;EACxC;;EAEA;EACA,MAAM;;;UAIS;;EAEf;;EAEA;EACA;;UAGe,yBAAyB;EACxC;;EAEA;;EAEA;;EAEA,OAAO;;;;;;KAOG,cACR,wBACA,yBACA,mBACA;;;;;;;UAQa;WACN;WACA;;;;;;;;;UAUM;;EAEf,MAAM;;EAEN;;;;;;EAMA;;EAEA;;EAEA;IAAU,MAAM;IAAuB;;;EAEvC;;EAEA;;;;;;;UAQe;EACf;EACA,OAAO;EACP,OAAO;;EAEP,WAAW;;EAEX;;;;;;;UAQe;EACf;EACA,OAAO;;EAEP;;EAEA;;EAEA,WAAW;EACX;;;UAIe;;EAEf;;EAEA;;EAEA;;;;;;;UAQe;EACf;;EAEA,UAAU;EACV,aAAa;;;;;;;;;;;EAWb,QAAQ;;;;;;;;;;KAWE;;UAaK;EACf;EACA;EACA;;;;;;UAOe;EACf;EACA;EACA;;EAEA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;;EAEA,QAAQ;;EAER;;;;;;UAOe;EACf;EACA,OAAO;;EAEP;;EAEA;;;;;EAKA,WAAW;;EAEX;;;;;;;;UASe;EACf;EACA;EACA;;EAEA;EACA;IAAU;IAAe;;;;;;;KAOf,uBAAuB,KAAK;EAA8B;;;;;;UAMrD;;EAEf;EACA,cAAc;EACd,WAAW;EACX,aAAa;EACb,QAAQ;;;;;UAMO;EACf;;;;;EAKA,aAAa;;EAEb,UAAU;;;;;;;;;;;EAWV;EACA,aAAa;EACb,QAAQ;;;UAMO;;EAEf;;EAEA;;EAEA;IAAY;IAAgB;;;;UAIb;;EAEf;;EAEA;;EAEA;EACA;;EAEA;;EAEA,SAAS;;;;;;;UAQM;EACf;EACA;EACA;;EAEA;EACA;EACA;;EAEA;;EAEA;;EAEA;IAAU;IAAmB;IAAkB;IAAuB;;EACtE,OAAO;;;;;;UAOQ;EACf;EACA,OAAO;;EAEP;IAAU;IAAe;IAAkB;;;EAE3C;;;UAIe;;EAEf;;EAEA;;;;;EAKA;IAAU;IAAkB;;;;UAIb;;EAEf;EACA,QAAQ;EACR,aAAa;EACb,QAAQ;;;UAIO;EACf;;;;;EAKA,QAAQ;IAAmB;;EAC3B,aAAa;EACb,QAAQ;;;;;;;;;;;;;;;;;KAoBE;;UAYK;EACf;EACA;;;;;;;UAQe;EACf;EACA;IACE;;IAEA,MAAM,SAAS;;IAEf,QAAQ;;;;;IAKR;MAAY;MAAgB;MAAc;;;IAE1C;;;EAGF;;;UAIe;;EAEf;EACA,MAAM;;EAEN;;EAEA;;;UAIe;EACf,UAAU;EACV,aAAa;EACb,QAAQ;;;;;;;UAQO,0BAA0B;EACzC;EACA;;;UAIe;EACf,UAAU;EACV,aAAa;EACb,QAAQ;;;;;;KASE;;;;;;KAaA;EACN;EAAgC;;EAChC;EAAkB;IAAQ;IAAe;IAAa;;;;UAG3C;EACf;EACA;EACA;EACA;;;UAIe;EACf;EACA;EACA;EACA;;;;;;;;;KAUU,kBAAkB,QAAQ,OAAO,aAAa,SAAS;;;;;;UAOlD;EACf;EACA;;;;;;IAME,eAAe;IACf;MACM;MAAgC;;MAChC;MAAkB,UAAU;;;IAElC;;IAEA;;IAEA;;IAEA;;;;;;;;;EASF,OAAO,SAAS;;EAEhB,WAAW;;;;;;EAMX;IACE;IACA,OAAO,SAAS;IAChB,UAAU;;;;UAKG;;EAEf;EACA,MAAM;;EAEN,OAAO;;EAEP,YAAY;;EAEZ,UAAU;;;;;;EAMV;;;;;;EAMA;IAAS;IAAe;;;EAExB,WAAW,SAAS;;;UAIL;;EAEf,QAAQ;;EAER,UAAU;EACV,aAAa;EACb,QAAQ;;;KAIE;EACN;EAAU,aAAa;EAAc,QAAQ;;EAC7C;EAAW,UAAU;EAAW;;;UAGrB;;EAEf,QAAQ;;EAER,UAAU;;EAEV,OAAO;;;;;;;;UASQ;;EAEf,OAAO;;EAEP,YAAY;;EAEZ,UAAU"}

package/dist/ai-check.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_ai_writing = require("./ai-writing-DCVkv4Zj.cjs");
+const require_ai_writing = require("./ai-writing-G6tnCGzw.cjs");
 const require_scoring = require("./scoring-B2_HEhMT.cjs");
 //#region src/ai-check/cases.ts
 /**
@@ -14,7 +14,10 @@ const require_scoring = require("./scoring-B2_HEhMT.cjs");
 * - a passage with more than one blank, so a hint can be about the wrong one;
 * - a short essay whose mistakes a model must quote exactly as the learner
 *   wrote them — straight apostrophes a model likes to curl, a mistake made
-*   twice — so a correction of words nobody wrote is caught.
+*   twice — so a correction of words nobody wrote is caught;
+* - questions in item groups: a reading passage that prints a question's
+*   answer, which a hint must point to without quoting, and a run of blanks
+*   whose instructions only the group states.
 */
 const capital = {
 	schemaVersion: "1.0",
@@ -95,6 +98,86 @@ const listening = {
 	title: "Listen and type",
 	transcript: "The train leaves at half past nine."
 };
+/**
+* A reading group: a passage, a question it answers word for word, and a
+* summary of it. The question's answer is printed in the passage, so a hint
+* that quotes the passage where it answers is refused.
+*/
+const TIDES = "Along most coasts the tide comes in twice a day. It is pulled by the moon: as the Earth turns, the ocean nearest the moon bulges towards it, and so does the ocean on the far side. The highest tides, called spring tides, come when the sun and the moon line up.";
+const springTides = {
+	schemaVersion: "1.0",
+	type: "multiple-choice",
+	id: "ai-check-tides",
+	title: "Spring tides",
+	question: "When do the highest tides come?",
+	mode: "single",
+	scoringStrategy: "all-or-nothing",
+	options: [
+		{
+			id: "line-up",
+			text: "When the sun and the moon line up",
+			isCorrect: true
+		},
+		{
+			id: "full-moon",
+			text: "Only at full moon",
+			isCorrect: false
+		},
+		{
+			id: "winter",
+			text: "In winter",
+			isCorrect: false
+		}
+	]
+};
+const tidesSummary = {
+	schemaVersion: "1.0",
+	type: "written-response",
+	id: "ai-check-tides-summary",
+	title: "Summary",
+	prompt: "Summarise the text in one or two sentences.",
+	minWords: 10,
+	maxWords: 60,
+	languageTarget: "en-B1"
+};
+const tides = {
+	schemaVersion: "1.0",
+	type: "item-group",
+	id: "ai-check-tides-group",
+	title: "Part 2 — Reading",
+	stimulus: {
+		id: "ai-check-tides-text",
+		kind: "text",
+		title: "Tides",
+		body: TIDES
+	},
+	items: [springTides, tidesSummary]
+};
+/** A part whose questions share instructions the questions themselves never state. */
+const formation = {
+	schemaVersion: "1.0",
+	type: "fill-in-the-blanks",
+	id: "ai-check-formation",
+	title: "Word formation",
+	passage: "She smiled {{a}} when she heard the news. (HAPPY)",
+	blanks: [{
+		id: "a",
+		acceptedAnswers: ["happily"]
+	}],
+	scoringStrategy: "all-or-nothing"
+};
+const formationPart = {
+	schemaVersion: "1.0",
+	type: "item-group",
+	id: "ai-check-formation-part",
+	title: "Part 1 — Word formation",
+	stimulus: {
+		id: "ai-check-formation-instructions",
+		kind: "text",
+		body: "Use the word in capitals at the end of each sentence to form a word that fits the gap."
+	},
+	items: [formation]
+};
 const weekend = {
 	schemaVersion: "1.0",
 	type: "written-response",
@@ -364,10 +447,11 @@ const READ_ALOUD_SETTINGS = {
 	}] }
 };
 /** Builds a case, failing loudly rather than shipping a case with no request. */
-function explanationCase(id, about, data, response) {
+function explanationCase(id, about, data, response, group) {
 	const request = require_ai_writing.aiExplanationRequest({
 		data,
-		response
+		response,
+		...group ? { group } : {}
 	});
 	if (request === null) throw new Error(`ai-check: no explanation request for "${id}"`);
 	return {
@@ -377,11 +461,12 @@ function explanationCase(id, about, data, response) {
 		request
 	};
 }
-function hintCase(id, about, data, response, previousHints = []) {
+function hintCase(id, about, data, response, previousHints = [], group) {
 	const request = require_ai_writing.aiHintRequest({
 		data,
 		response,
-		previousHints
+		previousHints,
+		...group ? { group } : {}
 	});
 	if (request === null) throw new Error(`ai-check: no hint request for "${id}"`);
 	return {
@@ -391,11 +476,12 @@ function hintCase(id, about, data, response, previousHints = []) {
 		request
 	};
 }
-function writingCase(id, about, text, previousFeedback = [], learnerLocale) {
+function writingCase(id, about, text, previousFeedback = [], learnerLocale, task = { data: weekend }) {
 	const request = require_ai_writing.aiWritingFeedbackRequest({
-		data: weekend,
+		data: task.data,
 		response: drafted(text),
 		previousFeedback,
+		...task.group ? { group: task.group } : {},
 		...learnerLocale !== void 0 ? { learnerLocale } : {}
 	});
 	if (request === null) throw new Error(`ai-check: no writing feedback request for "${id}"`);
@@ -478,6 +564,7 @@ function aiCheckCases() {
 		})),
 		explanationCase("dictation-near", "Typed the sentence with two words wrong", listening, wrote("The train leaves at half past five")),
 		explanationCase("dictation-correct", "Typed the sentence correctly", listening, wrote("The train leaves at half past nine.")),
+		explanationCase("mc-reading-wrong", "Chose 'Only at full moon', on a question about its group's passage", springTides, chose(["full-moon"]), tides),
 		hintCase("mc-hint-1", "Has not answered yet", capital, chose([])),
 		hintCase("mc-hint-2", "Asked again after choosing Seville", capital, chose(["seville"]), ["Think about where the government sits."]),
 		hintCase("fib-hint-1", "Both blanks empty", introduction, typed({})),
@@ -487,10 +574,16 @@ function aiCheckCases() {
 		}), ["Look again at the first blank."]),
 		hintCase("gap-hint-1", "Neither gap chosen, in Spanish", landscape, picked({})),
 		hintCase("gap-hint-2", "Asked again with the first gap wrong", landscape, picked({ g1: "campo" }), ["Piensa en la forma del terreno."]),
+		hintCase("mc-reading-hint", "Has not answered a question whose answer its group's passage prints", springTides, chose([]), [], tides),
+		hintCase("fib-formation-hint", "A word-formation blank, under the instructions its group gives", formation, typed({}), [], formationPart),
 		writingCase("writing-mistakes", "A first draft with tense, article and agreement mistakes", "Last weekend I go to the market and buyed a apple. My friends was there too, so we don't go home early. Then I go to the cinema."),
 		writingCase("writing-clean", "A first draft with no mistakes to correct", "Last weekend I went to the market and bought an apple. My friends were there too, so we stayed until the evening. Then we went to the cinema."),
 		writingCase("writing-revised", "A second draft that fixed some mistakes", "Last weekend I went to the market and bought a apple. My friends was there too, so we didn't go home early.", ["Check your past tenses: \"go\" and \"buyed\" should be past forms."]),
 		writingCase("writing-feedback-in-spanish", "A first draft, with feedback asked for in Spanish", "Last weekend I visit my grandmother. She cook a big lunch and we eat together in the garden.", [], "es"),
+		writingCase("writing-summary", "A summary of its group's passage that gets the spring tides wrong", "The tide comes in twice a day because the moon pulls the ocean. The highest tides come only at full moon.", [], void 0, {
+			data: tidesSummary,
+			group: tides
+		}),
 		coachingCase("coaching-slips", "A reading with a mispronounced \"th\" and a word left out", { assessment: forecast(true) }),
 		coachingCase("coaching-clean", "A reading the engine marked correct throughout", { assessment: forecast(false) }),
 		coachingCase("coaching-from-grade", "The same slips, from a stored grade: marks without sounds", { fromGradeOnly: true }),